README
E
AgentCliError
- ::newInvocation::new
T
JsonLine
T
RunResult
V
run

agent-cli-sdk

Shared MoonBit process foundation for JSONL agent CLIs

agent

cli

jsonl

sdk

moonbit

Download zip

Author

totto2727

Version

0.1.1

License

MIT

Repository

github.com/totto2727-org/monorepo

Last updated

3 months ago

Downloads

moonbitlang/async0.20.1

#Agent CLI SDK

agent-cli-sdk provides the shared native process lifecycle for MoonBit SDKs that run agent CLIs and consume JSONL events.

Provider SDKs remain responsible for building CLI arguments and environment variables, decoding provider-specific events, and aggregating turns. This package owns stdin delivery, ordered JSONL parsing, stderr capture, exit status reporting, callback-requested termination, and cancellation-safe child cleanup.

let result = @agent_cli.run(
  @agent_cli.Invocation::new(
    command="agent",
    arguments=["run", "--format", "json"],
    input="Hello",
  ),
  async fn(line) {
    println(line.value.stringify())
    true
  },
)

AgentCliError

source

pub(all) suberror AgentCliError {
  InvalidJson(line~ : String, cause~ : String)
} derive(Eq, @moonbitlang/core/debug.Debug
Debug)

Errors raised while reading the JSONL protocol.

Invocation

source

pub(all) struct Invocation {
  command : String
  arguments : Array[String]
  environment : Map[String, String]
  inherit_environment : Bool
  input : String
}

A complete invocation of a JSONL-emitting agent CLI.

Invocation::new

source

fn Invocation::new(command~ : String, arguments~ : Array[String], input~ : String, environment? : Map[String, String], inherit_environment? : Bool) -> Invocation

Construct an agent CLI invocation.

JsonLine

source

pub(all) struct JsonLine {
  raw : String
  value : Json
} derive(Eq, @moonbitlang/core/debug.Debug
Debug)

One JSONL record with both its original text and parsed JSON value.

RunResult

source

pub(all) enum RunResult {
  Completed
  Stopped
  Failed(code~ : Int, stderr~ : String)
} derive(Eq, @moonbitlang/core/debug.Debug
Debug)

The process-level outcome of an agent CLI invocation.

run

source

async fn run(invocation : Invocation, on_event : async (JsonLine) -> Bool) -> RunResult

Run an agent CLI, write its stdin, and stream parsed JSONL events in order.

Returning false from on_event terminates the child and returns Stopped. A nonzero child exit is returned as Failed; process and callback errors are raised after all child resources have been cleaned up.