@automatalabs/acp-agents 1.3.0 → 3.0.0

package/dist/agent/types.d.ts

@@ -1,6 +1,7 @@
-import type { PromptResponse, SessionConfigOption, SessionModeState, StopReason, ToolCallContent, ToolCallLocation, ToolCallStatus, ToolKind, Usage } from "@agentclientprotocol/sdk";
-import type { AgentHistoryEntry, AgentUsage, McpServerConfig, PromptImage, WorkflowError } from "@automatalabs/shared-types";
-import type { TSchema } from "typebox";
+import type { ContentBlock, PromptResponse, SessionConfigOption, SessionModeState, StopReason, ToolCallContent, ToolCallLocation, ToolCallStatus, ToolKind, Usage } from "@agentclientprotocol/sdk";
+import type { AgentHistoryEntry, AgentUsage, McpServerConfig, PromptImage, SystemPromptOptions, WorkflowError } from "@automatalabs/shared-types";
+import type { ContentBlock as McpContentBlock } from "@modelcontextprotocol/sdk/types.js";
+import type { Static, TSchema } from "typebox";
 import type { AuthStore } from "../auth/auth-store.js";
 import type { ClientHandlers } from "../client-handlers.js";
 import type { HarnessConfigReport, HarnessModelsView } from "../config-catalog.js";
@@ -9,62 +10,137 @@ import type { ElicitationResolver, PermissionResolver, ToolPolicy } from "../per
 import type { ProviderStore } from "../provider-store.js";
 import type { CustomBackendConfig } from "../registry.js";
 export type { SessionConfigOption, SessionModeState };
+/** What a function tool's `execute` receives next to its validated input. */
+export interface AcpAgentToolContext {
+    /** The ACP session id of the agent that called the tool. */
+    readonly sessionId: string;
+    /** The agent's resolved backend id. */
+    readonly backendId: string;
+    /** The agent's `label`, when set. */
+    readonly label?: string;
+    /** The ACP `tool_call` id the backend surfaced for this call, when the SDK could correlate it:
+     *  the latest not-yet-settled `tool_call` of the turn in flight whose standard `name` (or
+     *  `title`) is the tool's name or ends in `__<name>` (pi's `mcp__agent_tools__<name>` alias).
+     *  Best-effort — undefined when the backend surfaced none before calling. */
+    readonly toolCallId?: string;
+    /** Aborts when the agent's constructor `signal` fires, when the turn in flight is cancelled
+     *  (`cancel()`, a per-call `signal`, an early `stream()` exit), when the agent closes or its
+     *  process dies, and when the backend drops the HTTP request before the result was written. */
+    readonly signal: AbortSignal;
+}
+/** What `execute` may return: a string (one text block), MCP content blocks, or a complete
+ *  `{ content, isError? }` result — `isError: true` is passed through to the agent as-is. The
+ *  blocks are MCP's `ContentBlock` (`@modelcontextprotocol/sdk/types.js`: `text`, `image`,
+ *  `audio`, `resource_link`, `resource`) — the `tools/call` result shape the agent receives on the
+ *  wire — and NOT the ACP `ContentBlock` every other content on the AcpAgent surface uses
+ *  (`prompt()` input, `AcpAgentMessage.content`, the update events). A `{ type: "text", text }`
+ *  block is valid in both. */
+export type AcpAgentToolResult = string | McpContentBlock[] | {
+    readonly content: McpContentBlock[];
+    readonly isError?: boolean;
+};
+/**
+ * One client-side function tool (`AcpAgentOptions.tools`). The SDK serves it to the agent as an
+ * MCP tool on the per-agent local tool host (`agent_tools`): `name` and `description` are
+ * advertised verbatim, `inputSchema` (typebox, like the `schema` option) is advertised as its
+ * JSON Schema, and every `tools/call` is validated against it (typebox Convert + Check) before
+ * `execute` runs with the converted input. A validation failure or a thrown `execute` is returned
+ * to the agent as an `isError: true` result carrying the message, never a transport error. Use
+ * `defineTool()` to infer the input type from the schema.
+ */
+export interface AcpAgentToolDefinition<TInput extends TSchema = TSchema> {
+    /** `^[A-Za-z0-9_-]{1,64}$`, unique across the agent's tools (INVALID_ARGUMENT in the constructor). */
+    name: string;
+    description: string;
+    /** A typebox OBJECT schema (`Type.Object(...)`, JSON `type: "object"`): MCP `tools/call`
+     *  arguments are an object, so any other top-level type is INVALID_ARGUMENT in the constructor. */
+    inputSchema: TInput;
+    execute(input: Static<TInput>, ctx: AcpAgentToolContext): Promise<AcpAgentToolResult> | AcpAgentToolResult;
+}
 export interface AcpAgentOptions {
     /** ABSOLUTE path that exists and is a directory. Validated synchronously in the constructor and
-     *  the statics BEFORE any process spawns (SCRIPT_VALIDATION_ERROR otherwise). Sent as the
+     *  the statics BEFORE any process spawns (INVALID_ARGUMENT otherwise). Sent as the
      *  session/new|fork|resume|load `cwd`. */
     cwd: string;
     /** Model routing spec with the runner's grammar (`resolveModelRoute`): the first `/`-segment
      *  routes to a registered custom backend (wins) or a built-in; the remainder is the backend's
      *  model id VERBATIM and is sent as `session/set_config_option { configId: "model" }` right after
      *  the session opens. An unrouted spec (no known first segment) goes WHOLE to the default backend
-     *  (`AGENTPRISM_DEFAULT_BACKEND`, else `claude`). Omitted = default backend, no model selection. */
+     *  (`AGENTPRISM_DEFAULT_BACKEND`, else `claude`). Omitted = default backend, no model selection.
+     *  This is the model the agent STARTS on: `agent.setModel(spec)` and a per-turn
+     *  `prompt(…, { model })` switch it mid-session (same backend only); `agent.model` follows. */
     model?: string;
-    /** Session mode. Explicit ids are strict (unadvertised → SCRIPT_VALIDATION_ERROR at open).
+    /** Session mode. Explicit ids are strict (unadvertised → INVALID_ARGUMENT at open).
      *  Omitted = the backend's `defaultModeId` when advertised (claude `auto`, codex `agent`,
      *  opencode `build`; pi/custom none). */
     mode?: string;
     /** Applied verbatim via `session/set_config_option` in ascending option-id order after model
-     *  selection. `"model"` is reserved (SCRIPT_VALIDATION_ERROR in the constructor). Ids not in the
-     *  advertised catalog fail at open with SCRIPT_VALIDATION_ERROR listing the advertised ids. */
+     *  selection. `"model"` is reserved (INVALID_ARGUMENT in the constructor). Ids not in the
+     *  advertised catalog fail at open with INVALID_ARGUMENT listing the advertised ids. */
     configOptions?: Record<string, string | boolean>;
     /** Session-level structured-output contract (typebox). Claude: `_meta.claudeCode.options.outputFormat`
      *  at session/new|resume|load|fork; Codex: `_meta.outputSchema` on every turn; OpenCode/pi/custom:
      *  the client-hosted `StructuredOutput` HTTP MCP tool injected into `mcpServers` when the agent
      *  advertises `mcpCapabilities.http`, plus the in-prompt contract. Each turn reports
-     *  `structured` / `structuredError`; there is no repair ladder. */
+     *  `structured` / `structuredError`; a repair ladder runs only when `schemaRetries` asks for one. */
     schema?: TSchema;
+    /** Opt-in structured repair ladder: how many EXTRA turns `prompt()` may spend re-prompting the
+     *  same session when a schema is active and the turn ended (`end_turn`) with `structured` absent
+     *  — an integer ≥ 0 (INVALID_ARGUMENT otherwise), default 0 = exactly one turn per `prompt()`.
+     *  A repair turn sends the runner's repair prompt (`repairPromptText`: the StructuredOutput-tool
+     *  variant when the tool is active, else the JSON variant, with the previous attempt's
+     *  `structuredError` appended) with the same turn `_meta`; the native channel (Claude session
+     *  `outputFormat`, Codex per-turn `outputSchema`, the client-hosted tool) stays authoritative.
+     *  Every repair turn is a real turn: events fire, `stream()` yields them, `usage` accumulates.
+     *  The resolved `AcpAgentTurn` is the FINAL attempt's plus `structuredAttempts`. A turn that ended
+     *  `cancelled` / `refusal` / `max_tokens` / `max_turn_requests` is never repaired. Overridable
+     *  per turn (`AcpAgentPromptOptions.schemaRetries`); inherited by forks. */
+    schemaRetries?: number;
     /** Client-provided MCP servers (stdio/http/sse/acp). Capability-gated by the connection exactly
      *  like the runner. */
     mcpServers?: McpServerConfig[];
-    /** Headless permission auto-policy: allow/deny lists + `defaultOutcome` (default "allow"). */
-    tools?: ToolPolicy;
-    /** Session-scoped async permission resolver; wins over `tools` unless the request matches an
-     *  explicit list (same precedence as the runner: resolver > policy). */
+    /** Client-side function tools, served to the agent over HTTP MCP from a per-agent local host
+     *  injected into `mcpServers` as `agent_tools` (`agent_tools_2`, … when a caller's server holds
+     *  the name) on `session/new|resume|load|fork` and an id-only fork's reattach. Names are
+     *  validated in the constructor (INVALID_ARGUMENT before any spawn); an agent that does not
+     *  advertise `mcpCapabilities.http` fails the open with INVALID_ARGUMENT — tools are never
+     *  silently dropped. Inherited by forks (each runs its own host); the host closes with the
+     *  agent. An empty array is the same as omitting the option. */
+    tools?: AcpAgentToolDefinition[];
+    /** Headless permission auto-policy: allow/deny lists + `defaultOutcome` (default "allow").
+     *  Consulted only when no `onPermissionRequest` resolver is installed. */
+    permissions?: ToolPolicy;
+    /** Session-scoped async permission resolver. When present it answers EVERY permission request
+     *  (the runner's default precedence); `permissions` is the headless fallback without one. */
     onPermissionRequest?: PermissionResolver;
     /** Elicitation responder; its presence is what advertises `elicitation` at initialize. */
     onElicitation?: ElicitationResolver;
     /** Generic session/new `_meta` passthrough. Layered UNDER backend-computed keys (shallow, like
      *  the runner) and, when `raw !== false`, OVER `backend.rawMessagesMeta()`. */
     meta?: Record<string, unknown>;
-    /** Codex-only session instructions → bare `_meta.baseInstructions` / `_meta.developerInstructions`. */
-    instructions?: {
-        base?: string;
-        developer?: string;
-    };
+    /** Backend-neutral system prompt instructions: `replace` swaps the backend's built-in system
+     *  prompt, `append` adds to it. Validated in the constructor (and `fork()` / the statics) against
+     *  the routed backend's `Backend.systemPrompt` support BEFORE any process spawns — a field the
+     *  backend cannot carry is INVALID_ARGUMENT, never a silent no-op (Codex and Claude and pi
+     *  carry both; OpenCode and custom backends carry neither). Sent on `session/new|resume|load|fork`
+     *  and the reattach of an id-only fork in the backend's dialect: Codex `_meta.baseInstructions`
+     *  / `_meta.developerInstructions`, Claude `_meta.systemPrompt` (string, or `{ append }`), pi
+     *  `_meta.systemPrompt` `{ replace?, append? }`. Wins over the same key in `meta`. Inherited by
+     *  forks (overridable). */
+    systemPrompt?: SystemPromptOptions;
     /** Human label stamped on every event context and every WorkflowError `agentLabel`; never on
      *  the wire. */
     label?: string;
     /** Custom backend registry merged over `AGENTPRISM_BACKENDS` exactly like
      *  `createAcpRunner({ backends })`. Read once in the constructor; malformed →
-     *  SCRIPT_VALIDATION_ERROR. Forks inherit it and cannot override it. */
+     *  INVALID_ARGUMENT. Forks inherit it and cannot override it. */
     backends?: Record<string, CustomBackendConfig>;
     /** Agent-lifetime abort: rejects queued work with `signal.reason`, cancels an in-flight turn,
      *  then closes. Not inherited by forks. */
     signal?: AbortSignal;
-    /** Default true: the session log is retained across turns so `history`/`text` are cumulative
-     *  and a fork can seed its child. `false` maps to `retainSessionLog: false` (history/text hold
-     *  only the latest turn). */
+    /** Default true: the session log is retained across turns so `history`/`text`/`messages` are
+     *  cumulative and a fork can seed its child. `false` maps to `retainSessionLog: false`
+     *  (history/text/messages hold only the latest turn). */
     retainHistory?: boolean;
     /** Default true: ask the backend to emit its vendor notifications (`_claude/sdkMessage` on
      *  Claude) so they reach `on("raw_message")` and `turn.raw`. `false` skips
@@ -86,17 +162,27 @@ export interface AcpAgentPromptOptions {
     /** Turn `_meta` passthrough, merged UNDER the backend's turn meta (backend keys win direct
      *  collisions, exactly like the runner's `mergeTurnMeta`). */
     meta?: Record<string, unknown>;
+    /** Switch the model BEFORE this turn, inside the FIFO (first, ahead of `configOptions` and
+     *  `mode` — open's order); STICKY for the session and reflected in `agent.model`. Same
+     *  validation as `setModel()`: the fork rule (the spec must route to this agent's backend and
+     *  poolKey, `"<backendId>/<model id>"`; a backend-only spec is rejected) → INVALID_ARGUMENT
+     *  before anything is sent; then `session/set_config_option { configId: "model" }` with the
+     *  routed remainder verbatim, a wire rejection mapping through the normal error path. */
+    model?: string;
     /** Applied via `session/set_config_option` BEFORE this turn, inside the FIFO; STICKY for the
      *  session. Same validation as the constructor option. */
     configOptions?: Record<string, string | boolean>;
     /** Applied via `session/set_mode` before this turn, inside the FIFO; sticky; strict. */
     mode?: string;
     /** Per-turn schema override. Allowed ONLY when the backend carries the schema on the turn and
-     *  does not embed it in the prompt (today: Codex). Otherwise SCRIPT_VALIDATION_ERROR naming the
+     *  does not embed it in the prompt (today: Codex). Otherwise INVALID_ARGUMENT naming the
      *  backend and pointing at the constructor `schema` option. */
     schema?: TSchema;
+    /** Per-turn repair budget (integer ≥ 0; INVALID_ARGUMENT otherwise, before anything is sent);
+     *  wins over the constructor's `schemaRetries` for this `prompt()` only. */
+    schemaRetries?: number;
     /** Per-call abort: queued, or started but not yet on the wire (the lazy open, the per-turn
-     *  `configOptions`/`mode`) → rejects with the reason without sending; in flight →
+     *  `model`/`configOptions`/`mode`) → rejects with the reason without sending; in flight →
      *  `session/cancel`, then rejects with the reason. The one way to stop a turn `cancel()` cannot
      *  reach: `cancel()` targets only a turn whose `session/prompt` is on the wire. */
     signal?: AbortSignal;
@@ -111,7 +197,7 @@ export interface AcpAgentCloseOptions {
     keep?: boolean;
 }
 /** Everything a fork may override. The backend is fixed by the parent: a `model` override must
- *  route to the same backend (poolKey-equal) or SCRIPT_VALIDATION_ERROR. `backends`, `authStore`,
+ *  route to the same backend (poolKey-equal) or INVALID_ARGUMENT. `backends`, `authStore`,
  *  `providerStore`, `clientHandlers` are inherited and not overridable. `label` defaults to
  *  `<parent label>/fork-<n>` (or `fork-<n>`); `signal` is never inherited. `cwd` defaults to the
  *  parent's; a different cwd is rejected on `cwd: "source-only"` backends (`FORK_SESSION_TRAITS`). */
@@ -161,6 +247,39 @@ export interface AcpAgentToolCall {
     /** Shallow merge of every `_meta` seen for this id. */
     readonly meta?: Record<string, unknown>;
 }
+/**
+ * One message of the transcript, folded from the session/update stream (`turn.messages` for a
+ * turn, `agent.messages` for the retained log). The assistant-message boundary is EXACTLY the
+ * `text` fold's: text chunks concatenate into one message until a `tool_call`, `tool_call_update`,
+ * `agent_thought_chunk`, `plan*` or `user_message_chunk` event (or a changed ACP `messageId`)
+ * marks a boundary, and the next text chunk opens a new message — so `turn.text` is the
+ * text-bearing assistant messages of the turn joined by `"\n\n"`. Tool calls attach to the
+ * assistant message in progress (a turn that starts with a tool call has a leading message with
+ * no text); thoughts lead and attach to the assistant message that receives the next assistant
+ * content (a trailing thought is a message of its own); a run of `user_message_chunk`s is one
+ * user message.
+ */
+export interface AcpAgentMessage {
+    readonly role: "user" | "assistant";
+    /** The ordered blocks of this message. Consecutive text chunks fold into one text block (the
+     *  first chunk's fields, the concatenated text); other blocks are kept as sent. The verbatim
+     *  chunks stay in `updates`. */
+    readonly content: ContentBlock[];
+    /** Assistant only: the tool calls this message issued, folded by `toolCallId` (first-seen
+     *  order; a later `tool_call_update` updates the call where it lives). Empty for user messages. */
+    readonly toolCalls: readonly AcpAgentToolCall[];
+    /** Assistant only: the `agent_thought_chunk` blocks folded into this message, consecutive text
+     *  chunks folded like `content`. A thought is held until the next assistant content and attaches
+     *  to the message that content lands on: a text chunk (or a non-text block) after a thought
+     *  OPENS a new message — a thought is a boundary — and the thought goes with it; a tool call
+     *  attaches to the assistant message in progress, which may already hold text, so `text →
+     *  thought → tool_call` puts the thought on the message with that text (opening a message when
+     *  none is in progress). A thought followed by a user message or by the end of the turn is an
+     *  assistant message of its own with no `content`. Empty for user messages. */
+    readonly thoughts: ContentBlock[];
+    /** The `receivedAt` of the first update folded into this message. */
+    readonly receivedAt: number;
+}
 export interface AcpAgentTurnUsage {
     /** THIS turn's tokens: `response.usage` mapped to `AgentUsage` (every installed adapter reports
      *  the turn, not the session — `PROMPT_USAGE_SCOPES`); `cost` = the clamped delta of the
@@ -185,15 +304,23 @@ export interface AcpAgentTurn {
     readonly updates: ReadonlyArray<AcpAgentUpdateRecord>;
     /** Every `raw_message` of this turn (Claude `_claude/sdkMessage`). */
     readonly raw: ReadonlyArray<AcpAgentRawRecord>;
-    /** tool_call ⊕ tool_call_update folded by toolCallId, first-seen order. */
+    /** tool_call ⊕ tool_call_update folded by toolCallId, first-seen order (the flattening of
+     *  `messages[*].toolCalls`). */
     readonly toolCalls: ReadonlyArray<AcpAgentToolCall>;
+    /** This turn's messages, folded from `updates` (`AcpAgentMessage`): the per-message view of
+     *  the same chunks `text` folds, with each message's tool calls and thoughts attached. */
+    readonly messages: ReadonlyArray<AcpAgentMessage>;
     readonly permissions: ReadonlyArray<AcpPermissionEvent>;
     readonly elicitations: ReadonlyArray<AcpElicitationEvent>;
     readonly usage: AcpAgentTurnUsage;
     /** Validated (typebox Convert + Check) when a schema was active for the turn. */
     readonly structured?: unknown;
-    /** Why `structured` is absent although a schema was active. */
+    /** Why `structured` is absent although a schema was active (the LAST attempt's failure when
+     *  the repair ladder ran). */
     readonly structuredError?: string;
+    /** When a schema was active: the turns this `prompt()` spent — 1 plus the repair turns the
+     *  `schemaRetries` ladder actually ran (1 under the default budget of 0). Absent without a schema. */
+    readonly structuredAttempts?: number;
     /** This turn's accumulator entries (copies). Per CHUNK, not per message: one `assistant`/`text`
      *  entry per streamed `agent_message_chunk` and one `tool`/`toolCall` entry per `tool_call`, so
      *  `history.length` is not a message count — `text` is the folded, per-message view. */
@@ -202,8 +329,8 @@ export interface AcpAgentTurn {
 /** A `prompt()` rejection for a turn the agent walled with a typed session failure (codex-acp's
  *  negotiated extension): the runner's mapped `WorkflowError` (`mapTypedSessionFailure`, so codes,
  *  `recoverable` and `details` keep their tested contract) carrying the COMPLETE turn — verbatim
- *  `response` incl. `_meta`, `usage`, `updates`, `raw`, `toolCalls`, `history` — so nothing is
- *  stripped. Narrow with `isAcpAgentTurnError`. */
+ *  `response` incl. `_meta`, `usage`, `updates`, `raw`, `toolCalls`, `messages`, `history` — so
+ *  nothing is stripped. Narrow with `isAcpAgentTurnError`. */
 export type AcpAgentTurnError = WorkflowError & {
     readonly turn: AcpAgentTurn;
 };
@@ -212,6 +339,33 @@ export type AcpAgentTurnError = WorkflowError & {
 export type AcpAgentEventMap = AcpRunnerEventMap;
 export type AcpAgentEventName = keyof AcpAgentEventMap;
 export type AcpAgentEventListener<K extends AcpAgentEventName> = (event: AcpAgentEventMap[K]) => void;
+/** The event names `stream()` yields: every bus event except the `session_update` catch-all (an
+ *  update is yielded once, under its `sessionUpdate` kind). */
+export type AcpAgentStreamEventName = Exclude<AcpAgentEventName, "session_update">;
+/**
+ * One item of `agent.stream()`: a bus event of this turn tagged with its name as `type` (the
+ * payload is the same object `on(name)` delivers — an ACP update variant plus the event context,
+ * or a permission / elicitation / raw_message / steering / session_open / session_close /
+ * backend_error payload), or the terminal `{ type: "turn", turn }` carrying the `AcpAgentTurn`
+ * `prompt()` would have resolved. Narrow on `type`.
+ */
+export type AcpAgentStreamEvent = {
+    [K in AcpAgentStreamEventName]: {
+        readonly type: K;
+    } & AcpAgentEventMap[K];
+}[AcpAgentStreamEventName] | {
+    readonly type: "turn";
+    readonly turn: AcpAgentTurn;
+};
+/** What `stream()` returns: an async iterable that is its own iterator, with `return()` and
+ *  `throw()` always present (leaving early is part of the contract — both cancel the turn and
+ *  resolve once it settled; `throw(error)` then rethrows `error`). */
+export interface AcpAgentStream extends AsyncIterableIterator<AcpAgentStreamEvent> {
+    next(): Promise<IteratorResult<AcpAgentStreamEvent, undefined>>;
+    return(): Promise<IteratorResult<AcpAgentStreamEvent, undefined>>;
+    throw(error?: unknown): Promise<IteratorResult<AcpAgentStreamEvent, undefined>>;
+    [Symbol.asyncIterator](): AcpAgentStream;
+}
 /** `idle` (constructed, nothing spawned) → `opening` → `ready` ⇄ `busy` (a queued op is executing)
  *  → `closed` (set the instant `close()` is called, the constructor signal aborts, or the process
  *  dies). */

package/dist/agent/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"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"}

package/dist/backend.d.ts

@@ -1,6 +1,7 @@
 import type { TSchema } from "typebox";
-import type { ProviderUsageLimitContext } from "@automatalabs/shared-types";
+import type { ProviderUsageLimitContext, SystemPromptOptions } from "@automatalabs/shared-types";
 import type { AuthProfile } from "./auth/auth-profile.js";
+import type { SystemPromptSupport } from "./protocol-coverage.js";
 /** Compatibility type path; the registry table is the only authored built-in identity source. */
 export type { BuiltinBackendId } from "./backends/builtins.js";
 /** A backend id: one of the built-ins, or the registered name of a custom ACP backend
@@ -26,10 +27,11 @@ export interface StructuredSource {
 /** Per-session inputs a backend may fold into its `session/new` `_meta`, beyond the schema.
  *  Additive/optional; a backend that doesn't understand a field ignores it. */
 export interface SessionMetaInputs {
-    /** CODEX-ONLY: replaces Codex's base system prompt (`thread/start.baseInstructions`). */
-    baseInstructions?: string;
-    /** CODEX-ONLY: developer-role instructions (`thread/start.developerInstructions`). */
-    developerInstructions?: string;
+    /** Backend-neutral system prompt instructions, already validated against `Backend.systemPrompt`
+     *  (`assertSystemPromptSupported`): the backend maps `replace`/`append` onto its own
+     *  `_meta` dialect — Codex `baseInstructions`/`developerInstructions`, Claude and pi
+     *  `systemPrompt`. A backend that declares no support never sees a defined value. */
+    systemPrompt?: SystemPromptOptions;
     /** Engine run correlation id. Backends may use it to suppress autonomous session work. */
     runId?: string;
     /** Human-readable occurrence label associated with `runId`; never sent unless a backend uses it. */
@@ -66,6 +68,12 @@ export interface Backend {
      *  initialized agent strictly advertises HTTP MCP support. Native schema channels leave this
      *  unset; custom ACP backends opt in unless their registry entry disables it. */
     readonly injectStructuredOutputTool?: boolean;
+    /** Which halves of `SystemPromptOptions` this backend can carry on its session `_meta`
+     *  (`SYSTEM_PROMPT_SUPPORT` for the built-ins). Undefined = neither: a `systemPrompt` for such a
+     *  backend is rejected before a session opens — SCRIPT_VALIDATION_ERROR from the runner and
+     *  `InteractiveSession`, INVALID_ARGUMENT from the AcpAgent SDK — so instructions are never
+     *  silently dropped. */
+    readonly systemPrompt?: SystemPromptSupport;
     /** OPTIONAL `initialize.clientCapabilities._meta` this backend adds: the namespaced vendor
      *  extensions THIS CLIENT implements for that agent, so the agent may turn them on. Backend-scoped
      *  on purpose — advertising a capability to an agent that does not implement it is noise, and

package/dist/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,iGAAiG;AACjG,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D;sFACsF;AACtF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,8FAA8F;IAC9F,eAAe,IAAI,MAAM,CAAC;IAC1B;;;4FAGwF;IACxF,gBAAgB,IAAI,MAAM,CAAC;IAC3B,uGAAuG;IACvG,mBAAmB,IAAI,OAAO,CAAC;CAChC;AAED;+EAC+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8FAA8F;AAC9F,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gFAAgF;AAChF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,yBAAyB,CAAC;CACpC,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB;;uEAEmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;0EAGsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;kGAI8F;IAC9F,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC;;qFAEiF;IACjF,QAAQ,CAAC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAC9C;;;;;;;4CAOwC;IACxC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE;;;;6EAIyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;mGAC+F;IAC/F,qBAAqB,CAAC,CACpB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,2BAA2B,GAAG,SAAS,CAAC;IAC3C,0DAA0D;IAC1D,WAAW,IAAI,WAAW,CAAC;IAC3B;;sEAEkE;IAClE,mBAAmB,CAAC,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACtF;;;mGAG+F;IAC/F,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1G;;;;kCAI8B;IAC9B,eAAe,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD;;iDAE6C;IAC7C,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7E,oGAAoG;IACpG,gBAAgB,CAAC,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;CACtD;AAED,6FAA6F;AAC7F,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAE7D"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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"}

package/dist/backends/claude.d.ts

@@ -11,6 +11,10 @@ export declare class ClaudeBackend implements Backend {
     classifyProviderError(error: unknown, metadata?: ProviderErrorMetadata): ProviderErrorClassification | undefined;
     spawnConfig(): SpawnConfig;
     sessionMetaDefaults(inputs?: SessionMetaInputs): Record<string, unknown> | undefined;
+    /** claude-agent-acp reads `_meta.systemPrompt` at session creation (new, resume, load, and the
+     *  reattach an id-only fork needs): a string replaces the prompt, `{ append }` extends the
+     *  `claude_code` preset. */
+    readonly systemPrompt: import("../protocol-coverage.js").SystemPromptSupport;
     sessionMeta(schema: TSchema | undefined, inputs?: SessionMetaInputs): Record<string, unknown> | undefined;
     promptMeta(): Record<string, unknown> | undefined;
     rawMessagesMeta(): Record<string, unknown> | undefined;

package/dist/backends/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/backends/claude.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EACV,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EACjB,MAAM,eAAe,CAAC;AASvB,+FAA+F;AAC/F,eAAO,MAAM,iBAAiB,EAAE,WAK/B,CAAC;AAEF,qBAAa,aAAc,YAAW,OAAO;IAI/B,QAAQ,CAAC,WAAW,EAAE,WAAW;IAH7C,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,QAAQ,CAAC,aAAa,EAAG,MAAM,CAAU;gBAEpB,WAAW,GAAE,WAA+B;IAEjE,qBAAqB,CACnB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,2BAA2B,GAAG,SAAS;IAa1C,WAAW,IAAI,WAAW;IAgB1B,mBAAmB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAMpF,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAuBzG,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAKjD,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAMtD,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;CAGpD;AAQD,eAAO,MAAM,uBAAuB,0DA2BlC,CAAC"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/backends/claude.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAOvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EACV,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EACjB,MAAM,eAAe,CAAC;AASvB,+FAA+F;AAC/F,eAAO,MAAM,iBAAiB,EAAE,WAK/B,CAAC;AAEF,qBAAa,aAAc,YAAW,OAAO;IAI/B,QAAQ,CAAC,WAAW,EAAE,WAAW;IAH7C,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,QAAQ,CAAC,aAAa,EAAG,MAAM,CAAU;gBAEpB,WAAW,GAAE,WAA+B;IAEjE,qBAAqB,CACnB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,2BAA2B,GAAG,SAAS;IAa1C,WAAW,IAAI,WAAW;IAgB1B,mBAAmB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAMpF;;gCAE4B;IAC5B,QAAQ,CAAC,YAAY,wDAAiC;IAEtD,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAwBzG,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAKjD,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAMtD,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;CAGpD;AAsBD,eAAO,MAAM,uBAAuB,0DA2BlC,CAAC"}

package/dist/backends/claude.js

@@ -5,8 +5,9 @@
 // The parsed object lands on SDKResultSuccess.structured_output, observable ONLY off the raw
 // `_claude/sdkMessage` extension notification (the runner's ACP client captures it).
 import { createRequire } from "node:module";
+import { META_KEYS, } from "@automatalabs/shared-types";
 import { splitArgs } from "../backend.js";
-import { BUILTIN_PROTOCOL_COVERAGE } from "../protocol-coverage.js";
+import { BUILTIN_PROTOCOL_COVERAGE, systemPromptSupport } from "../protocol-coverage.js";
 import { toAnthropicJsonSchema } from "../schema-strict.js";
 import { defineBuiltinBackend } from "./define.js";
 const require = createRequire(import.meta.url);
@@ -59,28 +60,33 @@ export class ClaudeBackend {
             return undefined;
         return { claudeCode: { options: { title } } };
     }
+    /** claude-agent-acp reads `_meta.systemPrompt` at session creation (new, resume, load, and the
+     *  reattach an id-only fork needs): a string replaces the prompt, `{ append }` extends the
+     *  `claude_code` preset. */
+    systemPrompt = systemPromptSupport("claude");
     sessionMeta(schema, inputs) {
-        // Claude has no analog to Codex's base/developer instruction overrides. For engine runs, set
-        // the SDK session title up front: claude-agent-acp >=0.71 otherwise launches an unobserved
-        // background small-model title-generation call after the first turn. Interactive sessions
-        // have no runId and retain the adapter's generated-title behavior.
-        if (!schema)
-            return undefined;
-        // Anthropic structured outputs accept only a JSON-Schema subset (additionalProperties:false
-        // required on every object; numeric/string/array constraints rejected). Normalize the wire
-        // copy so the native constraint always engages — an incompatible schema would fail the SDK
-        // constraint and silently degrade the run to unconstrained text + the repair ladder.
-        const title = workflowSessionTitle(inputs);
-        const meta = {
-            claudeCode: {
+        const meta = {};
+        if (schema) {
+            // Anthropic structured outputs accept only a JSON-Schema subset (additionalProperties:false
+            // required on every object; numeric/string/array constraints rejected). Normalize the wire
+            // copy so the native constraint always engages — an incompatible schema would fail the SDK
+            // constraint and silently degrade the run to unconstrained text + the repair ladder.
+            // For engine runs, set the SDK session title up front: claude-agent-acp >=0.71 otherwise
+            // launches an unobserved background small-model title-generation call after the first
+            // turn. Interactive sessions have no runId and retain the adapter's generated-title behavior.
+            const title = workflowSessionTitle(inputs);
+            meta.claudeCode = {
                 options: {
                     ...(title ? { title } : {}),
                     outputFormat: { type: "json_schema", schema: toAnthropicJsonSchema(schema) },
                 },
                 emitRawSDKMessages: true,
-            },
-        };
-        return meta;
+            };
+        }
+        const systemPrompt = claudeSystemPromptMeta(inputs?.systemPrompt);
+        if (systemPrompt !== undefined)
+            meta[META_KEYS.systemPrompt] = systemPrompt;
+        return Object.keys(meta).length > 0 ? meta : undefined;
     }
     promptMeta() {
         // Claude's schema is session-scoped (read at session/new); nothing on the turn.
@@ -95,6 +101,23 @@ export class ClaudeBackend {
         return source.rawStructuredOutput();
     }
 }
+/** Fold the neutral instructions into claude-agent-acp's single `systemPrompt` slot. The adapter
+ *  takes EITHER a full replacement string OR preset options (`{ append }` on the `claude_code`
+ *  preset) — there is no "custom base plus append" form — so `replace` + `append` together become
+ *  one replacement string: the replaced prompt followed by the appended text, joined by a blank
+ *  line (exactly what the caller asked for; the seam documents the join). */
+function claudeSystemPromptMeta(options) {
+    if (!options)
+        return undefined;
+    const { replace, append } = options;
+    if (replace !== undefined && append !== undefined)
+        return `${replace}\n\n${append}`;
+    if (replace !== undefined)
+        return replace;
+    if (append !== undefined)
+        return { append };
+    return undefined;
+}
 function workflowSessionTitle(inputs) {
     if (!inputs?.runId)
         return undefined;

package/dist/backends/codex.d.ts

@@ -20,6 +20,11 @@ export declare class CodexBackend implements Backend {
      *  channel's own equivalents are mapped by `mapTypedSessionFailure`. */
     classifyProviderError(error: unknown, metadata?: ProviderErrorMetadata): ProviderErrorClassification | undefined;
     spawnConfig(): SpawnConfig;
+    /** The fork reads bare `_meta.baseInstructions` (replaces Codex's base system prompt) and
+     *  `_meta.developerInstructions` (developer-role instructions on top of it) at session/new,
+     *  resume, load, AND fork — a Codex fork is live (no reattach), so the `session/fork` request's
+     *  own `_meta` is the only delivery and the adapter threads it into thread/fork. */
+    readonly systemPrompt: import("../protocol-coverage.js").SystemPromptSupport;
     sessionMeta(_schema: TSchema | undefined, inputs?: SessionMetaInputs): Record<string, unknown> | undefined;
     promptMeta(schema: TSchema | undefined): Record<string, unknown> | undefined;
     nativeStructured(source: StructuredSource): unknown;

package/dist/backends/codex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/backends/codex.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EACV,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAUvB,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,EAAE,WAe9B,CAAC;AAEF,qBAAa,YAAa,YAAW,OAAO;IAI9B,QAAQ,CAAC,WAAW,EAAE,WAAW;IAH7C,QAAQ,CAAC,EAAE,EAAG,OAAO,CAAU;IAC/B,QAAQ,CAAC,aAAa,EAAG,OAAO,CAAU;gBAErB,WAAW,GAAE,WAA8B;IAEhE;;;qGAGiG;IACjG,QAAQ,CAAC,oBAAoB,oCAA2C;IAExE;;;;4EAIwE;IACxE,qBAAqB,CACnB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,2BAA2B,GAAG,SAAS;IAW1C,WAAW,IAAI,WAAW;IAe1B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAY1G,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAK5E,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;CAMpD;AAED,eAAO,MAAM,sBAAsB,yDAwBjC,CAAC"}
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/backends/codex.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EACV,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAUvB,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,EAAE,WAe9B,CAAC;AAEF,qBAAa,YAAa,YAAW,OAAO;IAI9B,QAAQ,CAAC,WAAW,EAAE,WAAW;IAH7C,QAAQ,CAAC,EAAE,EAAG,OAAO,CAAU;IAC/B,QAAQ,CAAC,aAAa,EAAG,OAAO,CAAU;gBAErB,WAAW,GAAE,WAA8B;IAEhE;;;qGAGiG;IACjG,QAAQ,CAAC,oBAAoB,oCAA2C;IAExE;;;;4EAIwE;IACxE,qBAAqB,CACnB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,2BAA2B,GAAG,SAAS;IAW1C,WAAW,IAAI,WAAW;IAe1B;;;wFAGoF;IACpF,QAAQ,CAAC,YAAY,wDAAgC;IAErD,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAa1G,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAK5E,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;CAMpD;AAED,eAAO,MAAM,sBAAsB,yDAwBjC,CAAC"}

package/dist/backends/codex.js

@@ -11,7 +11,7 @@
 import { createRequire } from "node:module";
 import { CODEX_META_KEYS, META_KEYS } from "@automatalabs/shared-types";
 import { splitArgs } from "../backend.js";
-import { BUILTIN_PROTOCOL_COVERAGE } from "../protocol-coverage.js";
+import { BUILTIN_PROTOCOL_COVERAGE, systemPromptSupport } from "../protocol-coverage.js";
 import { toStrictJsonSchema } from "../schema-strict.js";
 import { parseFinalJson } from "../structured-output.js";
 import { TYPED_SESSION_FAILURE_CLIENT_CAPABILITY } from "../typed-failures.js";
@@ -75,17 +75,23 @@ export class CodexBackend {
         const bin = env.AGENTPRISM_CODEX_ACP_BIN ?? require.resolve("@automatalabs/codex-acp");
         return { command: process.execPath, args: [bin], env };
     }
+    /** The fork reads bare `_meta.baseInstructions` (replaces Codex's base system prompt) and
+     *  `_meta.developerInstructions` (developer-role instructions on top of it) at session/new,
+     *  resume, load, AND fork — a Codex fork is live (no reattach), so the `session/fork` request's
+     *  own `_meta` is the only delivery and the adapter threads it into thread/fork. */
+    systemPrompt = systemPromptSupport("codex");
     sessionMeta(_schema, inputs) {
         // Codex carries the SCHEMA on the turn (see promptMeta), so nothing schema-related rides
-        // session/new. But the optional base/developer instruction overrides ARE session-scoped: the
-        // @automatalabs/codex-acp fork reads these bare `_meta` keys and threads them into
-        // thread/start.{baseInstructions,developerInstructions}. Emit them only when set so an
-        // unconfigured run sends no `_meta` at all (preserving the "Codex default" path).
+        // session/new. The neutral system-prompt instructions ARE session-scoped: the
+        // @automatalabs/codex-acp fork reads the bare `_meta` keys and threads them into
+        // thread/{start,resume,fork}.{baseInstructions,developerInstructions}. Emit them only when set so
+        // an unconfigured run sends no `_meta` at all (preserving the "Codex default" path).
         const meta = {};
-        if (inputs?.baseInstructions !== undefined)
-            meta[CODEX_META_KEYS.baseInstructions] = inputs.baseInstructions;
-        if (inputs?.developerInstructions !== undefined)
-            meta[CODEX_META_KEYS.developerInstructions] = inputs.developerInstructions;
+        const systemPrompt = inputs?.systemPrompt;
+        if (systemPrompt?.replace !== undefined)
+            meta[CODEX_META_KEYS.baseInstructions] = systemPrompt.replace;
+        if (systemPrompt?.append !== undefined)
+            meta[CODEX_META_KEYS.developerInstructions] = systemPrompt.append;
         return Object.keys(meta).length > 0 ? meta : undefined;
     }
     promptMeta(schema) {

package/dist/backends/custom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/backends/custom.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,qBAAa,gBAAiB,YAAW,OAAO;IAWlC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;mGAC+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;oFAEgF;IAChF,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAC;gBAEhB,MAAM,EAAE,iBAAiB;IAWtD,WAAW,IAAI,WAAW;IAS1B,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAQ1D,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAM9E,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAQ5E,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;CAKpD"}
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/backends/custom.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,qBAAa,gBAAiB,YAAW,OAAO;IAWlC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;mGAC+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;oFAEgF;IAChF,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAC;gBAEhB,MAAM,EAAE,iBAAiB;IAWtD,WAAW,IAAI,WAAW;IAS1B,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAQ1D,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAM9E,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAQ5E,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;CAKpD"}

package/dist/backends/custom.js

@@ -11,8 +11,9 @@
 //   - config-level `_meta`: the registry entry's static `sessionMeta` rides every session/new
 //                  (per-call RunOptions.meta merges over it in the ACP client; backend-computed
 //                  keys and the runId stamp win over both).
-// SessionMetaInputs (Codex base/developer instruction overrides) are IGNORED — they are a
-// codex-acp vendor contract; a custom agent's knobs travel through the generic meta channels.
+// The neutral `systemPrompt` instructions are NOT carried (`Backend.systemPrompt` undefined): ACP
+// has no standard system-prompt key, so the validators refuse them for a custom backend up front
+// and a custom agent's own knobs travel through the generic meta channels instead.
 import { createHash } from "node:crypto";
 import { META_KEYS } from "@automatalabs/shared-types";
 import { toJsonSchema } from "../schema-strict.js";

package/dist/backends/opencode.d.ts

@@ -12,6 +12,10 @@ export declare class OpenCodeBackend implements Backend {
     readonly injectStructuredOutputTool = true;
     classifyProviderError(error: unknown, metadata?: ProviderErrorMetadata): ProviderErrorClassification | undefined;
     spawnConfig(): SpawnConfig;
+    /** `opencode acp` reads no session `_meta` (its ACP service consults `_meta` only for
+     *  terminal-auth at initialize); system prompts live in OpenCode's own config and agent
+     *  definitions. Declared unsupported so a `systemPrompt` is refused, never dropped. */
+    readonly systemPrompt: import("../protocol-coverage.js").SystemPromptSupport;
     sessionMeta(): Record<string, unknown> | undefined;
     promptMeta(schema: TSchema | undefined): Record<string, unknown> | undefined;
     nativeStructured(source: StructuredSource): unknown;