golem-add-agent-moonbit

Create a new file src/<agent_name>.mbt, define a struct annotated with #derive.agent, add a constructor fn AgentName::new(...), and expose behavior with pub fn methods. Run golem build to verify the component compiles.

Return domain errors as values using Result[T, E] with a custom error enum annotated with #derive.golem_schema. Uncaught exceptions are treated as crashes, triggering retries and eventually failing the agent instead of returning an error to the caller.

Yes, custom structs and enums can be used as parameter or return types if they are annotated with #derive.golem_schema. This gives them the schema support required by the Golem runtime.

These files, along with golem_derive.mbt, are auto-generated by golem build. Manual edits are overwritten on the next build, so all agent logic must live in your own source files.

Constructor parameters form the agent identity, so two agents with the same parameters are the same agent. Agents are created implicitly on first invocation, with no separate creation step, and invocations run sequentially in a single thread.