Examples

Copy Markdown View Source

These examples cover two surfaces:

  • three provider-agnostic live examples on ASM's common API
  • one offline inference-endpoint publication proof
  • nine provider-focused examples covering SDK-native surfaces, Cursor's core and SDK provider paths, and Antigravity's core provider path

Nothing runs by default. The live CLI examples require --provider.

Included Examples

  • live_query.exs: one-off ASM.query/3
  • live_stream.exs: ASM.start_session/1, ASM.stream/3, ASM.Stream.final_result/1, ASM.stop_session/1
  • live_session_lifecycle.exs: ASM.start_session/1, ASM.session_info/1, ASM.health/1, ASM.stream/3, ASM.query/3, ASM.cost/1, ASM.stop_session/1
  • inference_endpoint_http.exs: offline ASM.InferenceEndpoint.ensure_endpoint/3 publication, OpenAI-compatible HTTP completion/streaming call, and lease release
  • provider_amp_sdk_stream.exs: direct AmpSdk.execute/2
  • provider_antigravity_core_stream.exs: Antigravity CLI through ASM's core cli_subprocess_core lane
  • provider_claude_control_client.exs: ASM.Extensions.ProviderSDK.Claude control-client bridge
  • provider_codex_app_server.exs: ASM.Extensions.ProviderSDK.Codex app-server bridge
  • provider_cursor_core_stream.exs: Cursor Agent CLI through ASM's core cli_subprocess_core lane
  • provider_cursor_sdk_stream.exs: Cursor Agent CLI through ASM's SDK lane backed by cursor_cli_sdk
  • promotion_path/README.md: promotion-path hub for ASM core lane, SDK-backed lane, SDK-direct ownership links, and inference ASM adapter examples
  • live_codex_app_server_session.exs: promoted ASM SDK lane with a live Codex app-server session
  • live_codex_app_server_dynamic_tools.exs: live Codex app-server dynamic tool request projected as ASM host-tool events and fulfilled by a host executor
  • live_codex_app_server_resume.exs: live Codex app-server checkpoint and exact provider-thread resume through ASM continuation metadata
  • run_all.sh: runs the full example set for one or more selected providers

Default Behavior

If you omit --provider, the live CLI examples print usage and exit without touching a live CLI.

That is deliberate. The live examples never silently pick a provider for you.

inference_endpoint_http.exs is the exception. It defaults to the Amp provider profile and runs against a local fake backend so the publication seam stays deterministic and offline. Its default model is amp-1.

Permission Defaults

All ASM examples in this directory default to permission_mode: :bypass unless you override it with --permission-mode or ASM_PERMISSION_MODE.

--danger-full-access is the example-level alias for --permission-mode bypass. It keeps the public ASM contract normalized as permission_mode while exposing an obvious remote-tooling knob for hosts where provider-native sandboxed shell execution is not usable.

At startup, each example prints:

  • the normalized ASM permission mode
  • the provider-native permission term
  • the provider-native CLI flag, when one exists

Examples:

  • Claude: :bypass -> :bypass_permissions -> --permission-mode bypassPermissions
  • Codex: :bypass -> :yolo -> --dangerously-bypass-approvals-and-sandbox
  • Amp: :bypass -> :dangerously_allow_all -> --dangerously-allow-all
  • Cursor: :bypass -> :bypass -> --force
  • Antigravity: :bypass -> :bypass -> --dangerously-skip-permissions

Common Ollama Surface

The ASM common Ollama flags are available on the example CLI:

  • --ollama
  • --ollama-model <name>
  • --ollama-base-url <url>
  • --ollama-http
  • --ollama-timeout-ms <ms>

That surface is intentionally partial.

Supported:

  • Claude
  • Codex

Unsupported:

  • Amp
  • Cursor
  • Antigravity

run_all.sh rejects --ollama* flags immediately for unsupported providers.

Provider semantics differ slightly:

  • Claude keeps the canonical Claude model slot. Use --model for the Claude family name such as haiku, and --ollama-model for the actual Ollama model id.
  • Codex uses the direct Ollama model id. --ollama-model is the effective model selection knob for the common Ollama surface.

For Codex, gpt-oss:20b remains the default validated Ollama example model, but the common surface also accepts other installed Ollama models such as llama3.2. Those non-default models may run with upstream fallback metadata and can behave less reliably under the full Codex agent prompt/tool stack. The common prompt-based smoke examples only enforce exact sentinel assertions for validated-default Codex/Ollama targets, so non-default Codex/Ollama models remain accepted routes but are reported as exploratory rather than guaranteed smoke-test targets.

Run One Example

mix run --no-start examples/live_query.exs -- --provider claude
mix run --no-start examples/live_stream.exs -- --provider antigravity
mix run --no-start examples/live_session_lifecycle.exs -- --provider codex --model gpt-5.6-sol
mix run --no-start examples/inference_endpoint_http.exs -- --provider amp --stream
mix run --no-start examples/live_query.exs -- --provider claude --ollama --model haiku --ollama-model llama3.2
mix run --no-start examples/live_query.exs -- --provider codex --ollama --ollama-model gpt-oss:20b
mix run --no-start examples/live_query.exs -- --provider amp --lane sdk --sdk-root ../amp_sdk
mix run --no-start examples/live_query.exs -- --provider cursor
mix run --no-start examples/live_query.exs -- --provider antigravity
mix run --no-start examples/live_query.exs -- --provider antigravity --lane sdk --sdk-root ../antigravity_cli_sdk
mix run --no-start examples/provider_antigravity_core_stream.exs -- --provider antigravity
mix run --no-start examples/provider_cursor_core_stream.exs -- --provider cursor
mix run --no-start examples/provider_cursor_sdk_stream.exs -- --provider cursor --lane sdk
mix run --no-start examples/live_query.exs -- --provider codex --ssh-host example.internal
mix run --no-start examples/live_query.exs -- --provider codex --ssh-host example.internal --danger-full-access
mix run --no-start examples/live_query.exs -- --provider claude --ssh-host builder@example.internal --ssh-port 2222
mix run --no-start examples/provider_codex_app_server.exs -- --provider codex --ollama --ollama-model gpt-oss:20b
mix run --no-start examples/live_codex_app_server_session.exs -- --provider codex --lane sdk
mix run --no-start examples/live_codex_app_server_dynamic_tools.exs -- --provider codex --lane sdk
mix run --no-start examples/live_codex_app_server_resume.exs -- --provider codex --lane sdk

Shared flags:

  • --lane <core|auto|sdk> for common-surface examples
  • --prompt <text>
  • --model <name>
  • --stream for inference_endpoint_http.exs
  • --cli-path <path|command>
  • --permission-mode <mode>
  • --danger-full-access
  • --cwd <path>
  • --sdk-root <path>
  • --ssh-host <host>
  • --ssh-user <user>
  • --ssh-port <port>
  • --ssh-identity-file <path>

When you pass --ssh-host, the examples also add noninteractive SSH transport defaults (BatchMode=yes, ConnectTimeout=10) so unattended runs fail fast instead of blocking on password or connection prompts.

Run All Examples

./examples/run_all.sh --provider claude
./examples/run_all.sh --provider codex --model gpt-5.6-sol
./examples/run_all.sh --provider claude --ollama --model haiku --ollama-model llama3.2
./examples/run_all.sh --provider codex --ollama --ollama-model gpt-oss:20b
./examples/run_all.sh --provider claude --provider codex --ollama --ollama-model llama3.2
./examples/run_all.sh --provider amp --lane sdk --sdk-root ../amp_sdk
./examples/run_all.sh --provider cursor
./examples/run_all.sh --provider antigravity
./examples/run_all.sh --provider antigravity --lane sdk --sdk-root ../antigravity_cli_sdk
./examples/run_all.sh --provider codex --ssh-host example.internal
./examples/run_all.sh --provider codex --ssh-host example.internal --danger-full-access
./examples/run_all.sh --provider claude --provider codex --ssh-host builder@example.internal --ssh-port 2222

run_all.sh forwards extra flags to every selected example.

When you pass --ssh-host, the examples switch to execution_surface: :ssh_exec for the selected provider while keeping the default local subprocess route unchanged when you omit the SSH flags.

When you also pass --danger-full-access, the examples keep the same transport surface and switch only the normalized ASM permission mode to :bypass. ASM then projects the provider-native permissive runtime flag for the selected provider.

These example execution_surface and execution_environment forms are the current ASM-facing mapped carriers around the frozen Wave 1 lower packet, especially ProcessExecutionIntent.v1, JsonRpcExecutionIntent.v1, and AttachGrant.v1. Their detailed minimal-lane payload interiors remain provisional until Wave 3 prove-out.

See guides/execution-plane-alignment.md for the ownership and carriage rule.

If gpt-oss:20b is installed locally in Ollama, the Codex examples above are the primary validated route. You can still substitute another installed model such as llama3.2, but that path is less tightly validated by the example smoke checks and now skips exact-output assertions on the Codex side by default.

The three common examples are self-checking:

  • live_query.exs must return exactly LIVE_QUERY_OK
  • live_stream.exs must return exactly LIVE_STREAM_OK
  • live_session_lifecycle.exs must return exactly LIVE_SESSION_STREAM_OK and LIVE_SESSION_QUERY_OK

Provider-native examples validate their own provider-specific success conditions as well.

The Codex app-server examples require the Codex SDK lane. They force lane: :sdk for the actual run, advertise app_server: true, and use the current working directory as the Codex workspace unless you pass --cwd. live_codex_app_server_dynamic_tools.exs also passes %ASM.HostTool.Spec{} values plus a host tools executor map, then requires :host_tool_requested and :host_tool_completed events before it exits green. live_codex_app_server_resume.exs records the first turn's provider thread id from result/checkpoint metadata and sends the second turn with continuation: %{strategy: :exact, provider_session_id: thread_id}.

Environment

  • CLAUDE_CLI_PATH, ASM_CLAUDE_MODEL
  • CODEX_PATH, ASM_CODEX_MODEL
  • AMP_CLI_PATH, ASM_AMP_MODEL
  • ANTIGRAVITY_CLI_PATH, ASM_ANTIGRAVITY_MODEL
  • ASM_PERMISSION_MODE
  • CLAUDE_AGENT_SDK_ROOT, CODEX_SDK_ROOT, AMP_SDK_ROOT, ANTIGRAVITY_CLI_SDK_ROOT

The examples preflight the selected CLI before they start a session and print an install hint if it is missing.

Recovery-Oriented Examples

The standard example runner already includes the session-focused paths relevant to the emergency hardening work:

  • examples/live_session_lifecycle.exs

Those examples exercise the same provider-session history and resume seams now exposed through ASM.SessionControl.