amp_sdk

# Amp Provider Behavior Manifest

Provider-native Amp behavior must be proven here before this SDK translates it.
This manifest is SDK-owned evidence; it is not proof that ASM can expose the
feature as common behavior across providers.

| Feature | Evidence type | CLI version/source revision | Fixture | Live smoke | Known unsupported semantics | Date verified |
| --- | --- | --- | --- | --- | --- | --- |
| Amp streaming argument rendering for mode, visibility, thread continuation, thinking, labels, MCP config, and UI suppression flags | source inspection note and SDK render tests | current Amp CLI contract as represented by SDK options | `test/amp_sdk/runtime_cli_render_test.exs`; `test/amp_sdk/stream_test.exs` | `examples/promotion_path/sdk_direct_amp.exs` | Amp-native CLI flags; ASM must not accept these as generic provider options without all-four proof | 2026-04-29 |
| Amp settings payload for permissions and skills | source inspection note and SDK settings tests | current Amp CLI settings-file contract | `test/amp_sdk/runtime_cli_render_test.exs`; `test/amp_sdk/stream_test.exs`; `guides/permissions.md` | `examples/promotion_path/sdk_direct_amp.exs` | Amp-native permissions/skills only; does not establish common ASM host-tool, approval, skill, or no-tool semantics | 2026-04-29 |
| Amp thread, task, skill, permission, MCP, review, and usage management commands | source inspection note and SDK management tests | current Amp CLI contract | `test/amp_sdk/missing_features_test.exs`; `test/amp_sdk/env_test.exs`; management module tests | Existing management examples | Provider-native management surfaces; ASM must not normalize these without all-four proof | 2026-04-29 |
| Shared `execution_surface` normalization for local and SSH placement | source inspection note and SDK runtime tests | current `cli_subprocess_core` dependency | `test/amp_sdk/runtime/cli_test.exs`; `test/amp_sdk/runtime_cli_render_test.exs` | `examples/promotion_path/sdk_direct_amp.exs` for local keyword input; live SSH tests remain opt-in | Placement only; execution surface metadata must not become provider-native Amp configuration | 2026-04-29 |
| Governed launch authority for command, session, and non-auth management execution | SDK governed launch tests and shared core authority enforcement | current `cli_subprocess_core` dependency | `test/amp_sdk/governed_launch_test.exs` | Not a standalone live-smoke path; governed live proof is owned by later authority phases | Normal CLI discovery, native login state, `AMP_*` env keys, settings files, permissions config, MCP config, MCP OAuth state, cwd overrides, and execution-surface overrides are standalone direct-use behavior only | 2026-05-03 |
| Common completion-only intent | Core 0.4 capability manifest plus SDK fail-closed tests | Amp CLI unavailable in the release environment | `test/amp_sdk/runtime/cli_test.exs`; `test/amp_sdk/stream_execute_test.exs` | Not available: no installed and authenticated Amp CLI | `completion_only: true` is rejected before CLI resolution; ordinary Amp execution remains supported | 2026-07-27 |
| Common structured-output intent | Core 0.4 capability manifest plus SDK fail-closed tests | Amp CLI unavailable in the release environment | `test/amp_sdk/runtime/cli_test.exs`; `test/amp_sdk/stream_execute_test.exs` | Not available: no installed and authenticated Amp CLI | Non-`nil` `output_schema` is rejected before CLI resolution; the SDK does not infer an object from text | 2026-07-27 |
| Owner-safe merged settings materialization | Core 0.4 ephemeral-file contract and SDK lifecycle tests | `cli_subprocess_core 0.4.0` | `test/amp_sdk/runtime/cli_test.exs`; `test/amp_sdk/stream_test.exs`; `test/amp_sdk/stream_cleanup_test.exs` | Deterministic local stub only | One exclusive OS-temp file, mode `0600`, is removed after normal teardown or untrappable owner death | 2026-07-27 |
| Total run deadline and finite transport orphan-reap timeout | SDK stream and profile transport tests | `cli_subprocess_core 0.4.0` | `test/amp_sdk/options_test.exs`; `test/amp_sdk/runtime/cli_test.exs`; `test/amp_sdk/stream_execute_test.exs` | Deterministic local chatty stub only | Idle timeout and total deadline remain distinct; total deadline never rearms | 2026-07-27 |
| Lossless terminal result projection | Core Amp parser fixture plus SDK projection test | `cli_subprocess_core 0.4.0` | `test/amp_sdk/runtime/cli_test.exs`; `test/amp_sdk/types_test.exs` | Deterministic fixture only | Preserves status, stop reason, output, object, metadata, raw envelope, timing, usage, cost, denials, and provider session id | 2026-07-27 |