@agent-compose/sdk 0.7.0 → 0.8.0

package/dist/directives.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Cloud-session UI directives — the typed marker contract between the
+ * `agentc` CLI running INSIDE a cloud session's sandbox and the server's
+ * cloud executor.
+ *
+ * A converged cloud session drives a coding CLI whose only platform surface
+ * is `agentc` invoked over Bash — it has no typed platform tools, so it
+ * could never produce the transcript parts the dashboard renders as rich
+ * cards (`get_run_changes` → the inline diff reviewer) or acts on
+ * (`navigate_dashboard` → armed-tab navigation). The bridge:
+ *
+ *   1. `agentc navigate|display …` PRINTS one marker line to stdout —
+ *      `[[ac:directive:v1 {"kind":…}]]` — and nothing else happens locally.
+ *   2. The marker rides back to the server inside the streamed tool_result
+ *      (the coding CLI echoes the command's output).
+ *   3. The cloud executor scans TOOL RESULTS (never model text) for
+ *      markers, executes each directive server-side through the SAME
+ *      platform tool executors a platform turn uses (validation, factory
+ *      gating, result shapes all identical), and persists the resulting
+ *      tool_call + tool_result pair into the transcript.
+ *   4. Existing consumers act unchanged: the dashboard's diff-card /
+ *      run-card renderers key on tool names, and navigation stays gated by
+ *      the requesting tab's armed window + client-side URL re-validation.
+ *
+ * The kind set is CLOSED, but no longer purely read-only. `ask` is the ONE
+ * write-bearing directive: it inserts a bounded mentions row as the session
+ * owner (who could ping the same member from the dashboard anyway) and
+ * persists an ask card. Everything else stays read-scope — run lookups,
+ * change-set listing, server-gated file reads (preview / table_file /
+ * file_diff), or the navigate directive (validated URL, acted on
+ * client-side, cannot submit anything). Markers are data in untrusted
+ * output — the parser is hostile-input safe and hard-capped.
+ */
+/** Marker frame. v1 is part of the prefix: unknown future versions parse
+ *  as no-match (fail closed) rather than as a v1 directive. */
+export declare const DIRECTIVE_MARKER_PREFIX = "[[ac:directive:v1 ";
+export declare const DIRECTIVE_MARKER_SUFFIX = "]]";
+/** Max directives honoured per tool result — one command emits one marker;
+ *  anything past this in a single output is echo/noise, not intent. */
+export declare const MAX_DIRECTIVES_PER_OUTPUT = 4;
+export type CloudDirective = 
+/** Take the requesting user's dashboard tab to a relative page. */
+{
+    kind: "navigate";
+    url: string;
+}
+/** Render one run's detail into the transcript (`get_run` shape). */
+ | {
+    kind: "run";
+    runId: string;
+    workflow?: string;
+}
+/** Render one run's change-set — the dashboard's inline diff reviewer
+ *  (`get_run_changes` shape). */
+ | {
+    kind: "run_changes";
+    runId: string;
+    workflow?: string;
+}
+/** Sandboxed inline HTML preview of a drive file, frozen (and size-capped)
+ *  server-side at display time (`display_preview` shape). */
+ | {
+    kind: "preview";
+    path: string;
+}
+/** Sortable table card sourced from a drive .csv/.json file, read and
+ *  capped server-side (`display_table` shape). */
+ | {
+    kind: "table_file";
+    path: string;
+}
+/** File-level revision diff card; selectors resolve against
+ *  `factory_file_revisions` server-side (`display_diff` shape). */
+ | {
+    kind: "file_diff";
+    path: string;
+    from: string;
+    to: string;
+}
+/** Interactive question card gated on a named approver — resolution and
+ *  the mentions ping are server-authoritative (`display_ask` shape). The
+ *  one write-bearing directive (see the module header). */
+ | {
+    kind: "ask";
+    prompt: string;
+    approver: string;
+    options?: Array<{
+        id: string;
+        label: string;
+    }>;
+};
+/** Revision selectors the `file_diff` directive accepts: a literal
+ *  `factory_file_revisions.id`, `head`, `prev`, or `head~N` (N ≤ 999).
+ *  Exported so the CLI validates with the same rule it emits under. */
+export declare const REVISION_SELECTOR_RE: RegExp;
+/** Ask directive bounds — tighter than the promoter-path ask marker, sized
+ *  to fit the 1024-char directive body. */
+export declare const ASK_DIRECTIVE_PROMPT_MAX = 500;
+export declare const ASK_DIRECTIVE_MAX_OPTIONS = 6;
+export declare const ASK_DIRECTIVE_OPTION_ID_MAX = 50;
+export declare const ASK_DIRECTIVE_OPTION_LABEL_MAX = 60;
+export declare const ASK_APPROVER_MIN = 3;
+export declare const ASK_APPROVER_MAX = 320;
+/** One marker line for `agentc` to print. */
+export declare function renderDirectiveMarker(directive: CloudDirective): string;
+/**
+ * Extract every valid v1 directive from one command output. Hostile-input
+ * safe: malformed JSON, unknown kinds, oversized fields, and unterminated
+ * markers are skipped silently; at most MAX_DIRECTIVES_PER_OUTPUT come
+ * back. Never throws.
+ */
+export declare function parseDirectiveMarkers(text: string): CloudDirective[];

package/dist/display.d.ts

@@ -0,0 +1,242 @@
+/**
+ * The display palette (ADR-0040 §7, CLI-first amendment) — the typed marker
+ * contract between `agentc display` and the session executors.
+ *
+ * A native-harness session (Claude Code / codex running in-sandbox, or the
+ * local bridge daemon) has no typed platform tools — its platform surface is
+ * the `agentc` CLI. To keep RENDERING parity with platform sessions, the
+ * model is given an explicit palette of display commands
+ * (`agentc display run|changes|document|plan|image|table|chart|ask …`) whose stdout is a one-line
+ * TYPED MARKER. The executors (server cloud-executor, CLI bridge daemon)
+ * detect these markers in tool results and persist the SAME `MessagePart`
+ * shapes the platform harness's tools produce — so the dashboard renders the
+ * same rich cards (run card, reviewed-changes diff, document tile, plan
+ * checklist) with NO new renderer vocabulary beyond the additive
+ * `display_*` tool names.
+ *
+ * Known agentc invocations are ALSO auto-promoted without an explicit
+ * display call: `agentc run dispatch` → the dispatched-run card (the exact
+ * `dispatch_workflow` part shapes turn.ts persists), `agentc run get` → the
+ * run card, `agentc files read` → the document tile. Claude Code's own
+ * TodoWrite tool additionally forwards as a durable `plan` part (the same
+ * shape the ACP daemon posts), so converged sessions get the plan checklist
+ * for free.
+ *
+ * Everything here is pure and executor-agnostic: the promoter takes the
+ * runtime's tool_use / tool_result events and returns plain part-shaped
+ * objects that are structurally identical to the server's `MessagePart`
+ * union (pinned by tests on both sides). Promotion is strictly a REWRITE of
+ * the pair's shape — it never suppresses data: an unrecognized command,
+ * unparseable arguments, or a missing marker all fall back to the raw pair.
+ */
+export declare const DISPLAY_MARKER_KEY = "acDisplay";
+export declare const DISPLAY_MARKER_VERSION = "v1";
+export type DisplayPlanStatus = "pending" | "in_progress" | "completed";
+export interface DisplayPlanEntry {
+    content: string;
+    status: DisplayPlanStatus;
+}
+/** Plan bounds — mirror the server's BridgePartSchema (entries ≤ 64,
+ *  content ≤ 1000) so a marker-built plan part is always postable. */
+export declare const PLAN_MAX_ENTRIES = 64;
+export declare const PLAN_ENTRY_MAX_CHARS = 1000;
+export type DisplayTableCell = string | number | boolean | null;
+export interface DisplayTableColumn {
+    key: string;
+    label: string;
+}
+export interface DisplayTableData {
+    columns: DisplayTableColumn[];
+    rows: Array<Record<string, DisplayTableCell>>;
+    truncated: boolean;
+}
+export type DisplayChartKind = "bar" | "line";
+export interface DisplayChartPoint {
+    x: string | number;
+    y: number;
+}
+export interface DisplayChartSeries {
+    label: string;
+    points: DisplayChartPoint[];
+}
+export interface DisplayAskOption {
+    id: string;
+    label: string;
+}
+export type DisplayMarker = {
+    kind: "run";
+    runId: string;
+} | {
+    kind: "changes";
+    runId: string;
+    factorySlug?: string;
+    endedAt?: string | null;
+} | {
+    kind: "document";
+    path: string;
+    factorySlug?: string;
+    preview?: string | null;
+} | {
+    kind: "plan";
+    entries: DisplayPlanEntry[];
+} | {
+    kind: "image";
+    path: string;
+    factorySlug?: string;
+} | {
+    kind: "table";
+    columns: DisplayTableColumn[];
+    rows: Array<Record<string, DisplayTableCell>>;
+    truncated: boolean;
+} | {
+    kind: "chart";
+    chartKind: DisplayChartKind;
+    series: DisplayChartSeries[];
+    xLabel?: string;
+    yLabel?: string;
+} | {
+    kind: "ask";
+    askId: string;
+    prompt: string;
+    options?: DisplayAskOption[];
+    freeText: boolean;
+};
+/** Clamp raw plan entries to the marker/part bounds; invalid rows drop. */
+export declare function clampPlanEntries(raw: unknown): DisplayPlanEntry[];
+/** Table bounds — mirror the pinned `display_table` output shape. */
+export declare const TABLE_MAX_COLUMNS = 12;
+export declare const TABLE_MAX_ROWS = 100;
+export declare const TABLE_CELL_MAX_CHARS = 200;
+/**
+ * Clamp raw table input to the marker/part bounds. Accepts an array of flat
+ * objects (columns inferred from the key union, first-seen order) or a
+ * `{ columns, rows }` object. Null when nothing tabular survives — the CLI
+ * hard-errors, the parser treats the marker as not-a-marker.
+ */
+export declare function clampTableData(raw: unknown): DisplayTableData | null;
+/** Chart bounds — mirror the pinned `display_chart` output shape. */
+export declare const CHART_MAX_SERIES = 4;
+export declare const CHART_MAX_POINTS_PER_SERIES = 60;
+export declare const CHART_LABEL_MAX_CHARS = 40;
+/** Clamp raw chart series to the marker/part bounds; invalid series and
+ *  non-finite points drop. Empty result → the CLI hard-errors / the parser
+ *  rejects the marker. */
+export declare function clampChartSeries(raw: unknown): DisplayChartSeries[];
+/** Clamp an axis label to the chart bound; undefined when unusable. */
+export declare function clampChartAxisLabel(raw: unknown): string | undefined;
+/** Ask bounds — mirror the pinned `display_ask` output shape (the
+ *  promoter path; the approver directive has its own tighter caps in
+ *  directives.ts). */
+export declare const ASK_PROMPT_MAX_CHARS = 1000;
+export declare const ASK_MAX_OPTIONS = 8;
+export declare const ASK_OPTION_ID_MAX_CHARS = 100;
+export declare const ASK_OPTION_LABEL_MAX_CHARS = 200;
+/** Normalize + clamp ask options. Accepts `["a","b"]` (id = label) or
+ *  `[{ id, label }]`; invalid entries drop, duplicate ids drop. */
+export declare function clampAskOptions(raw: unknown): DisplayAskOption[];
+/** One-line JSON marker — exactly what `agentc display` prints. */
+export declare function serializeDisplayMarker(marker: DisplayMarker): string;
+/** Parse one line as a display marker; null when it isn't one (or fails
+ *  validation — a malformed marker is not a marker). */
+export declare function parseDisplayMarker(line: string): DisplayMarker | null;
+/** First display marker in a tool result's text output (the CLI prints
+ *  exactly one; scanning lines keeps it robust to surrounding stderr/echo). */
+export declare function findDisplayMarker(text: string): DisplayMarker | null;
+export type AgentcInvocation = {
+    verb: "display-run";
+    runId: string;
+} | {
+    verb: "display-changes";
+    runId: string;
+    factorySlug?: string;
+} | {
+    verb: "display-document";
+    path: string;
+    factorySlug?: string;
+} | {
+    verb: "display-plan";
+} | {
+    verb: "display-image";
+    path: string;
+    factorySlug?: string;
+}
+/** Directive verb — detection only arms the tool_call promotion; the
+ *  result keeps its raw output so the directive marker reaches the cloud
+ *  executor. Same for table `source:"file"`, diff, and ask-with-approver. */
+ | {
+    verb: "display-preview";
+    path: string;
+} | {
+    verb: "display-table";
+    source: "inline" | "file";
+    path?: string;
+} | {
+    verb: "display-chart";
+    chartKind: DisplayChartKind;
+} | {
+    verb: "display-diff";
+    path: string;
+    from: string;
+    to: string;
+} | {
+    verb: "display-ask";
+    prompt: string;
+    approver?: string;
+} | {
+    verb: "run-dispatch";
+    templateName: string;
+    input?: unknown;
+} | {
+    verb: "run-get";
+    runId: string;
+} | {
+    verb: "files-read";
+    path: string;
+    factorySlug?: string;
+};
+/** Minimal shell-word split: whitespace-separated, single/double quotes
+ *  group. Unclosed quotes swallow the rest (matching sh's prompt-for-more
+ *  by simply taking what's there — promotion is best-effort). */
+export declare function shellWords(command: string): string[];
+export declare function detectAgentcInvocation(command: string): AgentcInvocation | null;
+/** Plain part shapes, structurally identical to the server's `MessagePart`
+ *  union (and the bridge POST schema) — pinned by shape-fidelity tests on
+ *  the server side. */
+export type PromotedPart = {
+    type: "tool_call";
+    toolName: string;
+    input: Record<string, unknown>;
+    toolCallId: string;
+} | {
+    type: "tool_result";
+    toolCallId: string;
+    output: unknown;
+    isError: boolean;
+} | {
+    type: "plan";
+    entries: DisplayPlanEntry[];
+};
+export interface DisplayPromoterContext {
+    /** The session's factory id (cloud sessions know it from the session row)
+     *  — stamped onto document/changes parts when the command names no
+     *  `--factory` slug, so the renderer can resolve the drive link. */
+    factoryId?: string;
+}
+export interface DisplayPromoter {
+    /** Promote a tool_use event. Non-null → persist these parts INSTEAD of
+     *  the default mapping (the promoted tool_call reuses the toolUseId, so
+     *  the eventual result still pairs). Null → not a promotable call. */
+    promoteToolUse(msg: {
+        toolName: string;
+        toolInput: unknown;
+        toolUseId: string;
+    }): PromotedPart[] | null;
+    /** Promote the matching tool_result. Non-null → persist these parts
+     *  instead of the default mapping. Null → no promotion pending. */
+    promoteToolResult(msg: {
+        toolUseId: string;
+        output: unknown;
+        isError?: boolean;
+    }): PromotedPart[] | null;
+}
+export declare function createDisplayPromoter(ctx?: DisplayPromoterContext): DisplayPromoter;

package/dist/errors.d.ts

@@ -1,5 +1,28 @@
+/** Stable machine-readable denial codes on membership/capability-gated
+ *  mutations (ADR-0045). Reads never carry a code — a visibility denial is
+ *  a plain 404, indistinguishable from a missing id. */
+export type AuthzErrorCode = "role_read_only" | "owner_required" | "capability_required" | "membership_required" | "last_owner" | "approver_only";
 /** Thrown by AgentComposeClient when the server returns a non-2xx response. */
 export declare class AgentComposeError extends Error {
     readonly status: number;
-    constructor(status: number, message: string);
+    /** Parsed `Retry-After` response header, in milliseconds, when the server
+     *  sent one (rate-limit 429s do). Pollers use it to honor the server's own
+     *  estimate of when the limit window clears instead of guessing. */
+    readonly retryAfterMs?: number;
+    /** Stable error code on gated-mutation 403s (ADR-0045) — one of
+     *  `AuthzErrorCode` when the denial is a membership/capability gate;
+     *  undefined otherwise. */
+    readonly code?: string;
+    /** The missing capability on a `capability_required` denial
+     *  (e.g. "write", "invoke", "see_runs"). */
+    readonly capability?: string;
+    constructor(status: number, message: string, opts?: {
+        retryAfterMs?: number;
+        code?: string;
+        capability?: string;
+    });
 }
+/** Parse a `Retry-After` header into milliseconds. Accepts both RFC 9110
+ *  forms — delta-seconds (`"120"`) and HTTP-date — and returns `undefined`
+ *  for anything unparseable so callers fall back to their own backoff. */
+export declare function parseRetryAfterMs(header: string | null | undefined): number | undefined;

package/dist/index.d.ts

@@ -12,25 +12,31 @@
  */
 export { defineRuntime } from "./types/runtime.js";
 export { defineWorkflow } from "./types/workflow.js";
-export type { WorkflowDefinition } from "./types/workflow.js";
 export { defineSandboxEnvironment } from "./types/sandbox-environment.js";
 export type { SandboxEnvironmentDefinition } from "./types/sandbox-environment.js";
 export type { AgentRuntime, McpServerConfig, ModelExecutionContract, ToolCallGateResult, RuntimeOptions, } from "./types/runtime.js";
-export type { WorkflowFn, WorkflowCtx, WorkflowRun, AgentBudget, WorkflowHooks, SnapshotConfig, BootSnapshot, ReuseSnapshot, IOSchema, OutputSchema, } from "./types/workflow.js";
+export type { WorkflowRun, AgentBudget, WorkflowHooks, SnapshotConfig, BootSnapshot, ReuseSnapshot, IOSchema, OutputSchema, } from "./types/workflow.js";
 export type { ConnectorRequestRules } from "./types/workflow-metadata.js";
 export type { RunSnapshotEntry } from "./client.js";
-export type { WorkflowPlan, WorkflowStepPlan } from "./types/workflow-plan.js";
+export type { WorkflowPlan, WorkflowStepPlan, WorkflowStepDeliverable } from "./types/workflow-plan.js";
 export type { BaseExecutionContext, InvokeChild } from "./types/execution-context.js";
 export { RequestContext, ReservedKeyError, NonSerialisableValueError, AC_RESERVED_PREFIX, AC_TEAM_ID, AC_RUN_ID, AC_WORKFLOW_ID, AC_FACTORY_ID, AC_API_KEY_SCOPES, AC_PARENT_RUN_ID, AC_ABORT_SIGNAL, } from "./request-context/index.js";
 export type { RequestContextReserved, RequestContextWire, } from "./request-context/index.js";
 export { Verdict, runProcessorChain, denyTools, humanApproval, requireScope, redactPattern, createGatePauseProcessor, createAskHumanProcessor, ASK_USER_QUESTION_TOOL, } from "./processors/index.js";
 export type { Processor, ProcessorContext, ProcessorVerdict, ToolCall, GatePausePolicy, GatePauseApproval, GatePauseConnection, } from "./processors/index.js";
 export type { AgentMessage, AgentMessageInit, AgentMessageText, AgentMessageThinking, AgentMessageToolUse, AgentMessageToolResult, AgentMessageDone, AgentMessageError, AgentMessageUsage, AgentStatus, } from "./types/protocol.js";
-export type { SandboxProvider, DesktopSandboxProvider, } from "./types/sandbox.js";
+export type { SandboxProvider, DesktopSandboxProvider, SandboxPtyOpts, SandboxPtyHandle, } from "./types/sandbox.js";
 export { AgentComposeClient } from "./client.js";
-export type { RegisterResult, RegisterWorkflowInput, RuntimeSourceInput, TemplateSourceRef, InvokeWorkflowOptions, InvokeAndWaitOptions, InvokeResult, ListSnapshotsOptions, TemplateRow, ListTemplatesOptions, CreateFactoryInput, UpdateFactoryInput, SecretOptions, SetSecretResult, SecretListEntry, CreateApiKeyInput, StreamRunLogsOptions, TeamMember, Mention, CreateMentionsInput, EventSubjectType, EventRow, ReportEventInput, ListEventsOptions, ListEventsResult, RunLogLine, ListRunLogsOptions, RegisteredRuntime, RunState, RunStatus, FactoryRow, SnapshotListEntry, SnapshotListResponse, ApiKey, ApiKeyCreated, UsageRollupRow, UsageResponse, CancelRunResponse, RequestAgentPauseOptions, RequestAgentPauseResponse, SendAgentMessageOptions, SendAgentMessageResponse, AnswerSteerOptions, ResumePauseOptions, ResumePauseResponse, ResumePauseSuccess, ResumePausePending, ResumePauseActor, } from "./client.js";
+export type { RegisterResult, RegisterWorkflowInput, RuntimeSourceInput, TemplateSourceRef, InvokeWorkflowOptions, InvokeAndWaitOptions, InvokeResult, ListSnapshotsOptions, TemplateRow, ListTemplatesOptions, CreateFactoryInput, UpdateFactoryInput, SecretOptions, SetSecretResult, SecretListEntry, CreateApiKeyInput, StreamRunLogsOptions, TeamMember, Mention, CreateMentionsInput, EventSubjectType, EventRow, ReportEventInput, ListEventsOptions, ListEventsResult, RunLogLine, ListRunLogsOptions, RunListEntry, ListRunsOptions, RunDetail, FundingLane, RunFundingStamp, RunFundingUsageRow, RunFundingResponse, RegisteredRuntime, RunState, RunStatus, FactoryRow, SnapshotListEntry, SnapshotListResponse, ApiKey, ApiKeyCreated, UsageRollupRow, UsageResponse, CancelRunResponse, RequestAgentPauseOptions, RequestAgentPauseResponse, SendAgentMessageOptions, SendAgentMessageResponse, AnswerSteerOptions, ResumePauseOptions, ResumePauseResponse, ResumePauseSuccess, ResumePausePending, ResumePauseActor, ConversationMessagePart, ConversationRow, ConversationMessageRow, ConversationsPage, ConversationDetail, ConversationThread, ConversationPageContext, SendConversationMessageInput, SendConversationMessageResult, ConversationTurnState, ConversationPresenceSnapshot, StreamConversationOptions, AgentListRow, CreateCloudSessionInput, CloudSessionCreated, SessionPreview, PreviewOpened, OpenPreviewInput, SessionForked, SessionFileChange, SessionChangeSet, SessionMergeReportDetail, SessionMergeReport, SessionDiscardReport, ChannelSessionStatus, ChannelSessionRow, ChannelSessionsResponse, SessionChannelMessagePosted, FactoryFileSearchRow, FactoryFolderSearchRow, SearchFactoryFilesOptions, FactoryFileSearchResult, PublicFileLinkState, ConversationMemberRole, ConversationMember, DocumentCapability, TemplateCapability, ScopeGrant, ArtifactScope, RunContext, SetScopeGrantsInput, SetTemplateScopeInput, TemplateDetail, Project, ProjectsPage, ProjectRole, ProjectMember, ProjectObject, ProjectObjectsPage, ProjectSkippedFile, ProjectPreviewFile, ProjectAddPreview, AddProjectObjectInput, AddProjectObjectResult, RefreshProjectObjectResult, ComplianceScopeKind, ComplianceStatus, ComplianceSession, ComplianceAccess, RequestComplianceSessionInput, ListComplianceSessionsOptions, ComplianceSessionsPage, ListComplianceAccessesOptions, ComplianceAccessesPage, } from "./client.js";
 export { parseSseStream } from "./sse.js";
+export { renderDirectiveMarker, parseDirectiveMarkers, DIRECTIVE_MARKER_PREFIX, DIRECTIVE_MARKER_SUFFIX, MAX_DIRECTIVES_PER_OUTPUT, REVISION_SELECTOR_RE, ASK_DIRECTIVE_PROMPT_MAX, ASK_DIRECTIVE_MAX_OPTIONS, ASK_DIRECTIVE_OPTION_ID_MAX, ASK_DIRECTIVE_OPTION_LABEL_MAX, ASK_APPROVER_MIN, ASK_APPROVER_MAX, } from "./directives.js";
+export type { CloudDirective } from "./directives.js";
+export { normalizeConversationStreamEvent } from "./types/conversation-stream.js";
+export type { ConversationStreamEvent, ConversationStreamAuthor, ConversationPartEvent, ConversationPartPartialEvent, ConversationMessageDoneEvent, ConversationErrorEvent, ConversationReactionEvent, ConversationMessageDeletedEvent, ConversationReplayContinueEvent, ConversationTurnStateEvent, ConversationPresenceEvent, ConversationSessionStatusEvent, ConversationPresenceClient, ConversationAgentPresence, } from "./types/conversation-stream.js";
+export { AcpClientPeer, normalizeSessionUpdate, ACP_PROTOCOL_VERSION } from "./runtimes/_acp-client.js";
+export type { AcpAvailableCommand, AcpClientPeerDeps, AcpSessionCaps } from "./runtimes/_acp-client.js";
 export { AgentComposeError } from "./errors.js";
+export type { AuthzErrorCode } from "./errors.js";
 export { formatError } from "./utils/errors.js";
 export { bundleWorkflow, BUNDLER_VERSION, WorkflowSourceValidationError, assertDefaultExportIsDefineWorkflow, } from "./utils/bundler.js";
 export type { BundledWorkflow, WorkflowManifest } from "./utils/bundler.js";
@@ -41,9 +47,10 @@ export { default as claudeRuntime } from "./runtimes/claude.js";
 export { createVercelRuntime, VercelRunner, listVercelRuntimeModels } from "./runtimes/vercel.js";
 export type { VercelRuntimeConfig, VercelRuntimeModel } from "./runtimes/vercel.js";
 export type { GatewayModelId } from "ai";
-export { createCodexRuntime } from "./runtimes/codex.js";
+export { createCodexRuntime, codexSpec } from "./runtimes/codex.js";
 export type { CodexRuntimeConfig } from "./runtimes/codex.js";
 export { default as codexRuntime } from "./runtimes/codex.js";
+export type { CliReasoningEffort } from "./runtimes/_cli-agent.js";
 export { createAmpRuntime } from "./runtimes/amp.js";
 export type { AmpRuntimeConfig } from "./runtimes/amp.js";
 export { default as ampRuntime } from "./runtimes/amp.js";
@@ -56,23 +63,26 @@ export { default as cursorRuntime } from "./runtimes/cursor.js";
 export { createDroidRuntime, droidSpec } from "./runtimes/droid.js";
 export type { DroidRuntimeConfig } from "./runtimes/droid.js";
 export { default as droidRuntime } from "./runtimes/droid.js";
+export { createClaudeCodeRuntime, claudeCodeSpec, CLAUDE_CODE_ACP_ADAPTER, CLAUDE_CODE_THINKING_TOKENS } from "./runtimes/claude-code.js";
+export type { ClaudeCodeRuntimeConfig } from "./runtimes/claude-code.js";
+export { default as claudeCodeRuntime } from "./runtimes/claude-code.js";
 export { bashTool, codingTools, editTool, readTool, writeTool } from "./tools/index.js";
 export type { CodingTool } from "./tools/index.js";
 export type { RunEvent } from "./types/events.js";
-export { createSandbox, reconnectSandbox, killAllSandboxes, killSandboxById, getSandboxQuotas, listOwnedSandboxes, deleteSandboxSnapshot, snapshotResolves, makeSandboxProvider, makeDesktopSandboxProvider, parseSseExecStream, AGENT_COMPOSE_TAG, SANDBOX_VCPUS, DEFAULT_SANDBOX_SIZE, E2B_TEMPLATE_SIZES, isE2bSupportedSize, e2bMachineSpec, e2bBaseTemplate, e2bAgentEnvTemplate, isPlatformE2bTemplateAlias } from "./sandbox.js";
+export { createSandbox, reconnectSandbox, killAllSandboxes, killSandboxById, getSandboxQuotas, listOwnedSandboxes, deleteSandboxSnapshot, snapshotResolves, makeSandboxProvider, makeDesktopSandboxProvider, parseSseExecStream, AGENT_COMPOSE_TAG, SANDBOX_VCPUS, DEFAULT_SANDBOX_SIZE, E2B_TEMPLATE_SIZES, isE2bSupportedSize, e2bMachineSpec, e2bBaseTemplate, e2bAgentEnvTemplate, isPlatformE2bTemplateAlias, E2B_DEVBOX_TEMPLATE, E2B_DEVBOX_SPEC, E2B_DEVBOX_RECIPE_VERSION, e2bDevboxTemplateRef } from "./sandbox.js";
 export { SandboxUnavailableError, SANDBOX_UNAVAILABLE_PREFIX } from "./sandbox-errors.js";
 export type { SandboxCreateOpts, SandboxNetworkPolicy, SandboxNetworkHeaderTransform, SandboxNetworkAllowRule, SandboxNetworkSubnetPolicy, SandboxProviderName, SandboxQuotaResult, OwnedSandboxResult, OwnedSandbox, SandboxSize, ParseSseExecStreamOptions, SandboxCommandRunOptions, SandboxCommandResult, } from "./sandbox.js";
-export type { SandboxResources } from "./types/workflow-metadata.js";
+export type { SandboxResources, DriveMergePolicy } from "./types/workflow-metadata.js";
 export { runWorkflow, WorkflowError, EngineError, classifyError, parseNameVersion } from "./workflows/engine.js";
 export type { WorkflowResult, RunWorkflowOptions, EngineSubsystem } from "./workflows/engine.js";
 export { buildInvokeChild } from "./workflows/invoke-child.js";
 export { defineStep, isWorkflow, runWorkflowSteps, runWorkflowSingleStep, StepValidationError, WorkflowInputValidationError, WorkflowOutputValidationError, } from "./workflow-steps/index.js";
-export type { Step, StepContext, StepRunResult, Workflow, DefineStepOpts, StepWorkflowDefinition, WorkflowBuilder, RunWorkflowStepsOpts, RunWorkflowStepsResult, RunWorkflowSingleStepOpts, RunWorkflowSingleStepResult, StepObservability, SubStepEvent, } from "./workflow-steps/index.js";
+export type { Step, StepContext, StepDeliverable, StepRunResult, Workflow, DefineStepOpts, StepWorkflowDefinition, WorkflowBuilder, RunWorkflowStepsOpts, RunWorkflowStepsResult, RunWorkflowSingleStepOpts, RunWorkflowSingleStepResult, StepObservability, SubStepEvent, } from "./workflow-steps/index.js";
 export { invokeStep, launchStep, reconnectStep, serveStep, parseStepResult, buildStepEnvs, StepExecutionError, STEP_RESULT_PREFIX, STEP_PAUSE_PREFIX, STEP_ENV, RUNNER_BUNDLE_PATH, RUNNER_COMMAND, stepInputPath, requestContextPath, } from "./step-invocation/index.js";
 export { PauseError, PauseExpiredError, PauseSchemaError, PauseRequestError, } from "./pause/errors.js";
 export type { PauseErrorCode } from "./pause/errors.js";
 export type { PauseRequest } from "./pause/pause-core.js";
-export type { WaitForEventRequest } from "./pause/wrappers.js";
+export type { WaitForEventRequest, DecisionRequest } from "./pause/wrappers.js";
 export { requestPauseAndAwait } from "./agent/pause-client.js";
 export type { PauseDecision, RequestPauseOptions } from "./agent/pause-client.js";
 export type { StepRequest, StepResult, StepInvocationError, StepPauseRequest, StepHandler, StepHandlerResult, ServeStepRequest, RunningStep, InvokeStepOptions, } from "./step-invocation/index.js";
@@ -80,7 +90,9 @@ export { agentLoop, parseAgentStatus, DEFAULT_CLAUDE_MODEL } from "./agent/agent
 export type { AgentLifecycleEvent, AgentLoopOpts, AgentLoopResult } from "./agent/agent-loop.js";
 export { agent } from "./agent/run-agent.js";
 export type { AgentOpts } from "./agent/run-agent.js";
-export { AGENT_COMPOSE_MANUAL, buildAgentContextDoc, writeAgentContext } from "./agent/agent-context.js";
-export type { AgentConnectorInfo } from "./agent/agent-context.js";
+export { AGENT_COMPOSE_MANUAL, buildAgentContextDoc, writeAgentContext, buildAddedSessionBrief } from "./agent/agent-context.js";
+export type { AgentConnectorInfo, AddedSessionBriefParams } from "./agent/agent-context.js";
 export { AgentMessageSchema, parseAgentResponse } from "./agent/protocol.js";
 export { importSourceModule, TMP_DIR, LATEST_VERSION } from "./utils/source-loader.js";
+export { DISPLAY_MARKER_KEY, DISPLAY_MARKER_VERSION, PLAN_MAX_ENTRIES, PLAN_ENTRY_MAX_CHARS, TABLE_MAX_COLUMNS, TABLE_MAX_ROWS, TABLE_CELL_MAX_CHARS, CHART_MAX_SERIES, CHART_MAX_POINTS_PER_SERIES, CHART_LABEL_MAX_CHARS, ASK_PROMPT_MAX_CHARS, ASK_MAX_OPTIONS, ASK_OPTION_ID_MAX_CHARS, ASK_OPTION_LABEL_MAX_CHARS, serializeDisplayMarker, parseDisplayMarker, findDisplayMarker, clampPlanEntries, clampTableData, clampChartSeries, clampChartAxisLabel, clampAskOptions, detectAgentcInvocation, shellWords, createDisplayPromoter, } from "./display.js";
+export type { DisplayMarker, DisplayPlanEntry, DisplayPlanStatus, DisplayTableCell, DisplayTableColumn, DisplayTableData, DisplayChartKind, DisplayChartPoint, DisplayChartSeries, DisplayAskOption, AgentcInvocation, PromotedPart, DisplayPromoter, DisplayPromoterContext, } from "./display.js";