#Golem SDK for MoonBit

#Overview

#Quick Start

#0. Set up your project from the template

#moon.mod.json

• Change "name" from "golemcloud/golem_sdk_example1" to your module name (e.g. "myorg/my_app")
• Update "description", "repository", and other metadata fields

#golem.yaml

• Change app: from golem-sdk-example1 to your application name (e.g. my-app)
• Under components:, rename the component key from golem:moonbit-examples: to your component name (e.g. myorg:my-agent:)

#Component package directory

• Rename the golem_moonbit_examples/ directory to your component name in snake_case (e.g. my_agent/)
• The directory name must match the {{ component_name | to_snake_case }} value used in golem.yaml's build commands

#Agent source files

• Delete or modify the example agent files (counter.mbt, task_manager.mbt, multimodal_agent.mbt, rpc_example.mbt)
• The generated files (golem_reexports.mbt, golem_agents.mbt, golem_derive.mbt, golem_clients.mbt) will be regenerated by golem build
• Add your own agents with #derive.agent structs
• Make sure you have an empty fn main {} somewhere in the package

#golem_moonbit_examples/moon.pkg (now your renamed directory)

• The import and link sections are auto-managed by the reexports codegen tool — no manual changes needed; they will be regenerated on first golem build

#1. Define an agent

///|
#deriveagent
struct Counter {
  name : String
  mut value : UInt64
}

///|
/// Creates a new counter with the given name
fn Counter::new(name : String) -> Counter {
  { name, value: 0 }
}

///|
/// Increments the counter
pub fn Counter::increment(self : Self) -> Unit {
  self.value  1
}

///|
/// Returns the current value
pub fn Counter::get_value(self : Self) -> UInt64 {
  self.value
}

#2. Use custom data types

///|
#derivegolem_schema
pub(all) enum Priority {
  Low
  Medium
  High
} derive(Eq)

///|
#derivegolem_schema
pub(all) struct TaskInfo {
  title : String
  priority : Priority
  description : String?
}

#3. Build and deploy

#Features

• Agent registry — register multiple agent types in a single component via #derive.agent
• Custom data types — #derive.golem_schema implements every nexessary trait to use custom data types on the public interface of your agents
• Agent-to-agent RPC — auto-generated client stubs (CounterClient) with awaited, fire-and-forget, and scheduled invocations
• Multimodal input — accept mixed text, binary, and custom modality data via #derive.multimodal and Multimodal[T]
• Unstructured data — UnstructuredText and UnstructuredBinary types with optional language/MIME restrictions
• Logging — structured logging via @logging.with_name("my-agent") with level filtering
• Tracing — span-based tracing via @context.with_span(...) with attributes
• Host API - exports Golem's host API

#Packages

#Code Generation

• golem_reexports.mbt — re-exports WASM entry points from the SDK
• golem_agents.mbt — agent registration, constructor deserialization, method dispatch
• golem_derive.mbt — serialization impls for #derive.golem_schema types
• golem_clients.mbt — RPC client stubs for agent-to-agent calls

#Requirements

• MoonBit toolchain (moon)
• Golem CLI (golem) version 1.4.x+
• wasm-tools for component model linking
• golemcloud/golem_sdk_tools for code generation

#Documentation

• Golem Documentation
• MoonBit Documentation
• Example Project

#License