@ikenga/contract 0.5.1 → 0.6.0

package/dist/engine/acp.d.ts

@@ -0,0 +1,271 @@
+/**
+ * ACP (Agent Client Protocol) shapes. Phase 10: a second, ACP-shaped
+ * contract sits alongside the legacy `Engine` interface in `./adapter.ts`.
+ * The two coexist while Phase 11 retires the legacy adapter. New engines
+ * (in-process Rust ACP, Node ACP sidecars, etc.) target `AcpEngine`;
+ * existing consumers keep the `Engine` shape until they migrate.
+ *
+ * Method names mirror ACP's verbatim so the wire layer and the adapter
+ * layer share vocabulary — `newSession`, `prompt`, `cancel`, `setMode`,
+ * `loadSession`, `forkSession`, `requestPermission`.
+ */
+import type { McpServerSpec } from './adapter.js';
+/** ACP `ProtocolVersion`. Numeric. V1 = 1. */
+export type AcpProtocolVersion = number;
+export interface AcpInitializeRequest {
+    protocolVersion: AcpProtocolVersion;
+    /** Optional `_meta` passthrough; the in-process shell ignores it. */
+    _meta?: Record<string, unknown>;
+}
+export interface AcpPromptCapabilities {
+    image: boolean;
+    audio: boolean;
+    embeddedContext: boolean;
+}
+export interface AcpMcpCapabilities {
+    http: boolean;
+    sse: boolean;
+}
+export interface AcpAgentCapabilities {
+    loadSession: boolean;
+    promptCapabilities: AcpPromptCapabilities;
+    mcpCapabilities: AcpMcpCapabilities;
+}
+export interface AcpInitializeResponse {
+    protocolVersion: AcpProtocolVersion;
+    agentCapabilities: AcpAgentCapabilities;
+    /** Authentication methods the agent supports — opaque structure passed
+     *  through to the wizard. */
+    authMethods?: unknown[];
+    _meta?: Record<string, unknown>;
+}
+export interface AcpTextContentBlock {
+    type: 'text';
+    text: string;
+}
+/** ACP `ContentBlock::Image`. `data` is raw base64 with NO `data:` URI prefix. */
+export interface AcpImageContentBlock {
+    type: 'image';
+    data: string;
+    mimeType: string;
+    uri?: string;
+}
+export type AcpContentBlock = AcpTextContentBlock | AcpImageContentBlock | {
+    type: 'audio';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'resource_link';
+    name: string;
+    uri: string;
+} | {
+    type: 'resource';
+    resource: unknown;
+};
+export interface AcpNewSessionRequest {
+    cwd: string;
+    mcpServers: McpServerSpec[];
+    _meta?: Record<string, unknown>;
+}
+/** The four canonical ACP session modes the Rust ACP server advertises. */
+export type AcpSessionModeId = 'plan' | 'default' | 'auto' | 'bypassPermissions';
+export interface AcpSessionMode {
+    id: AcpSessionModeId;
+    name: string;
+    description?: string;
+    _meta?: Record<string, unknown>;
+}
+export interface AcpSessionModes {
+    currentModeId: AcpSessionModeId;
+    availableModes: AcpSessionMode[];
+    _meta?: Record<string, unknown>;
+}
+export interface AcpNewSessionResponse {
+    sessionId: string;
+    modes?: AcpSessionModes;
+    models?: unknown;
+    configOptions?: unknown[];
+    _meta?: Record<string, unknown>;
+}
+export interface AcpPromptRequest {
+    sessionId: string;
+    prompt: AcpContentBlock[];
+    messageId?: string;
+    _meta?: Record<string, unknown>;
+}
+export type AcpStopReason = 'end_turn' | 'max_tokens' | 'max_turn_requests' | 'refusal' | 'cancelled';
+export interface AcpPromptResponse {
+    stopReason: AcpStopReason;
+    userMessageId?: string;
+    usage?: unknown;
+    _meta?: Record<string, unknown>;
+}
+/** ACP `SessionUpdate` discriminated union. Open-ended on the `string` tail
+ *  so adapter-specific extensions don't break TS consumers. */
+export type AcpSessionUpdate = {
+    sessionUpdate: 'agent_message_chunk';
+    content: AcpContentBlock;
+    messageId?: string;
+} | {
+    sessionUpdate: 'agent_thought_chunk';
+    content: AcpContentBlock;
+    messageId?: string;
+} | {
+    sessionUpdate: 'user_message_chunk';
+    content: AcpContentBlock;
+} | {
+    sessionUpdate: 'tool_call';
+    toolCallId: string;
+    title: string;
+    kind?: string;
+    status?: string;
+    content?: unknown[];
+    rawInput?: unknown;
+    _meta?: Record<string, unknown>;
+} | {
+    sessionUpdate: 'tool_call_update';
+    toolCallId: string;
+    fields: {
+        status?: string;
+        content?: unknown[];
+        rawOutput?: unknown;
+    };
+    _meta?: Record<string, unknown>;
+} | {
+    sessionUpdate: 'current_mode_update';
+    currentModeId: AcpSessionModeId;
+} | {
+    sessionUpdate: 'plan_update';
+    plan: unknown;
+} | {
+    sessionUpdate: string;
+    [k: string]: unknown;
+};
+export interface AcpSessionNotification {
+    sessionId: string;
+    update: AcpSessionUpdate;
+    _meta?: Record<string, unknown>;
+}
+export type AcpPermissionOptionKind = 'allow_once' | 'allow_always' | 'reject_once' | 'reject_always';
+export interface AcpPermissionOption {
+    optionId: string;
+    name: string;
+    kind: AcpPermissionOptionKind;
+}
+export interface AcpToolCallSummary {
+    toolCallId: string;
+    title?: string;
+    kind?: string;
+    status?: string;
+    content?: unknown[];
+    rawInput?: unknown;
+    rawOutput?: unknown;
+}
+export interface AcpRequestPermissionRequest {
+    sessionId: string;
+    toolCall: AcpToolCallSummary;
+    options: AcpPermissionOption[];
+    _meta?: Record<string, unknown>;
+}
+export type AcpRequestPermissionOutcome = {
+    outcome: 'cancelled';
+} | {
+    outcome: 'selected';
+    optionId: string;
+};
+export interface AcpRequestPermissionResponse {
+    outcome: AcpRequestPermissionOutcome;
+    _meta?: Record<string, unknown>;
+}
+/** Wire envelope: pairs a `requestId` with the request body so the client
+ *  reply can address the parked Rust-side oneshot. */
+export interface AcpPermissionRequestEnvelope {
+    requestId: string;
+    request: AcpRequestPermissionRequest;
+}
+export interface AcpLoadSessionResponse {
+    /** Optional mode advertisement so the picker can hydrate without paying
+     *  the cold-spawn cost of `newSession`. */
+    modes?: AcpSessionModes;
+}
+export interface AcpForkResult {
+    newThreadId: string;
+    sourceThreadId: string;
+    branchedFromTurn?: number;
+}
+export interface AcpForkOpts {
+    upToTurn?: number;
+    label?: string;
+}
+export type AcpNotifyKind = 'notification' | 'permissionRequest';
+export interface AcpNotifyPayload {
+    threadId: string;
+    title: string;
+    body: string;
+    kind: AcpNotifyKind;
+}
+/**
+ * ACP-shaped engine adapter. Implementations:
+ *   - `pkgs/engine-claude-code` — wraps the in-process Rust ACP server.
+ *   - future: `pkgs/engine-codex`, `pkgs/engine-aider` — each speaking the
+ *     same wire shapes.
+ *
+ * Method names mirror ACP verbatim (`newSession`, `prompt`, `cancel`,
+ * `setMode`, `loadSession`, `forkSession`, `respondPermission`) so the wire
+ * layer, adapter layer, and host shell share one vocabulary.
+ *
+ * Subscriptions return a synchronous `() => void` unsubscribe — the
+ * implementation may resolve the underlying tauri-listener asynchronously
+ * but the caller can drop the registration immediately on unmount.
+ */
+export interface AcpEngine {
+    initialize(req: AcpInitializeRequest): Promise<AcpInitializeResponse>;
+    /** Mint a new session. The agent may lazily spawn its child on the first
+     *  `prompt` rather than during `newSession` itself. */
+    newSession(req: AcpNewSessionRequest): Promise<AcpNewSessionResponse>;
+    /** Send a turn. Resolves when the turn ends; in-progress events flow via
+     *  `onSessionUpdate`. */
+    prompt(req: AcpPromptRequest): Promise<AcpPromptResponse>;
+    /** Clean interrupt. Preserves the transcript and keeps the child alive
+     *  for the next turn. */
+    cancel(sessionId: string): Promise<void>;
+    /** Switch the session's permission mode. */
+    setMode(sessionId: string, modeId: AcpSessionModeId): Promise<void>;
+    /** Re-attach to an existing session by id. The child stays lazy. */
+    loadSession(sessionId: string): Promise<AcpLoadSessionResponse>;
+    /** Clone a session from a chosen turn. The new thread inherits the source's
+     *  on-disk transcript so the first prompt resumes from the cutoff. */
+    forkSession(sourceSessionId: string, opts?: AcpForkOpts): Promise<AcpForkResult>;
+    /** Subscribe to session updates. Returns a sync unsubscribe. */
+    onSessionUpdate(sessionId: string, callback: (update: AcpSessionUpdate) => void): () => void;
+    /** Subscribe to permission requests for this session. Reply via
+     *  `respondPermission`. Returns a sync unsubscribe. */
+    onPermissionRequest(sessionId: string, callback: (envelope: AcpPermissionRequestEnvelope) => void): () => void;
+    /** Reply to a parked permission request. */
+    respondPermission(requestId: string, response: AcpRequestPermissionResponse): Promise<void>;
+    /** Subscribe to OS-attention notifications. Returns a sync unsubscribe. */
+    onNotify(callback: (payload: AcpNotifyPayload) => void): () => void;
+}
+/** Synchronous unsubscribe handle. */
+export type AcpUnlisten = () => void;
+/**
+ * Tauri-side surface the host shell exposes for the ACP engine. The shell
+ * binds these to its `acp_*` Tauri commands and `acp://*` event listeners.
+ *
+ * Each `on*` returns a Promise of an unsubscribe fn — the engine wraps that
+ * so callers get a sync unsubscribe.
+ */
+export interface AcpHost {
+    initialize(req: AcpInitializeRequest): Promise<AcpInitializeResponse>;
+    newSession(req: AcpNewSessionRequest): Promise<AcpNewSessionResponse>;
+    prompt(req: AcpPromptRequest): Promise<AcpPromptResponse>;
+    cancel(sessionId: string): Promise<void>;
+    setMode(sessionId: string, modeId: AcpSessionModeId): Promise<void>;
+    loadSession(sessionId: string): Promise<AcpLoadSessionResponse>;
+    forkSession(sourceSessionId: string, opts?: AcpForkOpts): Promise<AcpForkResult>;
+    listenSession(sessionId: string, onUpdate: (notification: AcpSessionNotification) => void): Promise<AcpUnlisten>;
+    listenPermissionRequests(sessionId: string, onRequest: (envelope: AcpPermissionRequestEnvelope) => void): Promise<AcpUnlisten>;
+    respondPermission(requestId: string, response: AcpRequestPermissionResponse): Promise<void>;
+    listenNotify(callback: (payload: AcpNotifyPayload) => void): Promise<AcpUnlisten>;
+}
+//# sourceMappingURL=acp.d.ts.map

package/dist/engine/acp.d.ts.map

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

package/dist/engine/acp.js

@@ -0,0 +1,13 @@
+/**
+ * ACP (Agent Client Protocol) shapes. Phase 10: a second, ACP-shaped
+ * contract sits alongside the legacy `Engine` interface in `./adapter.ts`.
+ * The two coexist while Phase 11 retires the legacy adapter. New engines
+ * (in-process Rust ACP, Node ACP sidecars, etc.) target `AcpEngine`;
+ * existing consumers keep the `Engine` shape until they migrate.
+ *
+ * Method names mirror ACP's verbatim so the wire layer and the adapter
+ * layer share vocabulary — `newSession`, `prompt`, `cancel`, `setMode`,
+ * `loadSession`, `forkSession`, `requestPermission`.
+ */
+export {};
+//# sourceMappingURL=acp.js.map

package/dist/engine/acp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.js","sourceRoot":"","sources":["../../src/engine/acp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/{engine.d.ts → engine/adapter.d.ts}

@@ -1,16 +1,36 @@
+/**
+ * Legacy Engine adapter shape. New adapters target `./acp.ts`. Both are
+ * exported through `@ikenga/contract/engine` during the deprecation cycle.
+ *
+ * Engine adapter contract. Implementations:
+ *   - engine-claude-code  (default, ships preinstalled)
+ *   - engine-codex        (future)
+ *   - engine-aider        (future)
+ *   - engine-noop         (testing / shell-without-AI mode)
+ *
+ * @deprecated Phase 11 retires this surface. New adapters target the ACP
+ *   shape in `./acp.ts` (`AcpEngine`, `createAcpEngine`, `AcpHost`).
+ */
 import { z } from 'zod';
+/** @deprecated Use the ACP shape in `./acp.ts`. */
 export interface SessionOpts {
     cwd?: string;
     systemPrompt?: string;
     toolAllowList?: string[];
     /** Caller pkg id, used by the engine for per-pkg billing/audit. */
     callerPkg?: string;
+    /** Model override for the session (adapter-specific). */
+    model?: string;
+    /** Resume a prior session by id (adapter-specific; requires sessionResume cap). */
+    resumeSessionId?: string;
 }
+/** @deprecated Use the ACP shape in `./acp.ts`. */
 export interface Session {
     readonly id: string;
     /** Best-effort cancellation. Resolves once the engine has stopped streaming. */
     cancel(): Promise<void>;
 }
+/** @deprecated Use `AcpSessionUpdate` from `./acp.ts`. */
 export type EngineEvent = {
     type: 'message_delta';
     text: string;
@@ -38,6 +58,11 @@ export type EngineEvent = {
     reason: 'stop' | 'cancel' | 'error';
     error?: string;
 };
+/**
+ * MCP server spec. Shared between the legacy `Engine` surface and the ACP
+ * `newSession` request — not marked `@deprecated` because the ACP shape
+ * reuses it verbatim.
+ */
 export interface McpServerSpec {
     id: string;
     command: string;
@@ -275,6 +300,39 @@ export declare const EngineProvidesSchema: z.ZodObject<{
     } | undefined;
 }>;
 export type EngineProvides = z.infer<typeof EngineProvidesSchema>;
+/**
+ * Static metadata every adapter surfaces via `Engine.metadata`. Mirrors the
+ * manifest's `engine` block so the shell + wizard can introspect without
+ * re-parsing the manifest.
+ */
+export interface EngineMetadata {
+    agentId: string;
+    display: string;
+    capabilities: AgentCapabilities;
+    onboarding: EngineOnboarding;
+}
+/**
+ * Tauri-command surface the host shell exposes to legacy `Engine` adapters.
+ * The shell binds these names to its `claude_chat_*` commands; adapters
+ * never call `invoke()` directly so they remain testable.
+ *
+ * @deprecated Use the ACP shape (`AcpHost` in `./acp.ts`) for new adapters.
+ */
+export interface HostBridge {
+    spawn(opts: {
+        sessionId: string;
+        cwd?: string;
+        systemPrompt?: string;
+        model?: string;
+        resumeSessionId?: string;
+    }): Promise<void>;
+    send(sessionId: string, message: string): Promise<void>;
+    kill(sessionId: string): Promise<void>;
+    listen(sessionId: string): AsyncIterable<EngineEvent>;
+    registerMcp(spec: McpServerSpec): Promise<void>;
+    unregisterMcp(id: string): Promise<void>;
+}
+/** @deprecated Use `AcpEngine` from `./acp.ts`. Legacy shape retired in Phase 11. */
 export interface Engine {
     /** Stable identifier — matches the pkg id of the engine adapter. */
     readonly id: string;
@@ -286,12 +344,7 @@ export interface Engine {
      * / onboarding so the shell and wizard can introspect without re-parsing
      * the manifest.
      */
-    readonly metadata: {
-        agentId: string;
-        display: string;
-        capabilities: AgentCapabilities;
-        onboarding: EngineOnboarding;
-    };
+    readonly metadata: EngineMetadata;
     /** Open a new session. Sessions are cheap; create one per pkg invocation. */
     startSession(opts: SessionOpts): Promise<Session>;
     /** Send input and stream events. The iterable completes on `done`. */
@@ -335,240 +388,4 @@ export interface AdapterLoader {
      */
     fallback(): Engine;
 }
-/** ACP `ProtocolVersion`. Numeric. V1 = 1. */
-export type AcpProtocolVersion = number;
-export interface AcpInitializeRequest {
-    protocolVersion: AcpProtocolVersion;
-    /** Optional `_meta` passthrough; the in-process shell ignores it. */
-    _meta?: Record<string, unknown>;
-}
-export interface AcpPromptCapabilities {
-    image: boolean;
-    audio: boolean;
-    embeddedContext: boolean;
-}
-export interface AcpMcpCapabilities {
-    http: boolean;
-    sse: boolean;
-}
-export interface AcpAgentCapabilities {
-    loadSession: boolean;
-    promptCapabilities: AcpPromptCapabilities;
-    mcpCapabilities: AcpMcpCapabilities;
-}
-export interface AcpInitializeResponse {
-    protocolVersion: AcpProtocolVersion;
-    agentCapabilities: AcpAgentCapabilities;
-    /** Authentication methods the agent supports — opaque structure passed
-     *  through to the wizard. */
-    authMethods?: unknown[];
-    _meta?: Record<string, unknown>;
-}
-export interface AcpTextContentBlock {
-    type: 'text';
-    text: string;
-}
-/** ACP `ContentBlock::Image`. `data` is raw base64 with NO `data:` URI prefix. */
-export interface AcpImageContentBlock {
-    type: 'image';
-    data: string;
-    mimeType: string;
-    uri?: string;
-}
-export type AcpContentBlock = AcpTextContentBlock | AcpImageContentBlock | {
-    type: 'audio';
-    data: string;
-    mimeType: string;
-} | {
-    type: 'resource_link';
-    name: string;
-    uri: string;
-} | {
-    type: 'resource';
-    resource: unknown;
-};
-export interface AcpNewSessionRequest {
-    cwd: string;
-    mcpServers: McpServerSpec[];
-    _meta?: Record<string, unknown>;
-}
-/** The four canonical ACP session modes the Rust ACP server advertises. */
-export type AcpSessionModeId = 'plan' | 'default' | 'auto' | 'bypassPermissions';
-export interface AcpSessionMode {
-    id: AcpSessionModeId;
-    name: string;
-    description?: string;
-    _meta?: Record<string, unknown>;
-}
-export interface AcpSessionModes {
-    currentModeId: AcpSessionModeId;
-    availableModes: AcpSessionMode[];
-    _meta?: Record<string, unknown>;
-}
-export interface AcpNewSessionResponse {
-    sessionId: string;
-    modes?: AcpSessionModes;
-    models?: unknown;
-    configOptions?: unknown[];
-    _meta?: Record<string, unknown>;
-}
-export interface AcpPromptRequest {
-    sessionId: string;
-    prompt: AcpContentBlock[];
-    messageId?: string;
-    _meta?: Record<string, unknown>;
-}
-export type AcpStopReason = 'end_turn' | 'max_tokens' | 'max_turn_requests' | 'refusal' | 'cancelled';
-export interface AcpPromptResponse {
-    stopReason: AcpStopReason;
-    userMessageId?: string;
-    usage?: unknown;
-    _meta?: Record<string, unknown>;
-}
-/** ACP `SessionUpdate` discriminated union. Open-ended on the `string` tail
- *  so adapter-specific extensions don't break TS consumers. */
-export type AcpSessionUpdate = {
-    sessionUpdate: 'agent_message_chunk';
-    content: AcpContentBlock;
-    messageId?: string;
-} | {
-    sessionUpdate: 'agent_thought_chunk';
-    content: AcpContentBlock;
-    messageId?: string;
-} | {
-    sessionUpdate: 'user_message_chunk';
-    content: AcpContentBlock;
-} | {
-    sessionUpdate: 'tool_call';
-    toolCallId: string;
-    title: string;
-    kind?: string;
-    status?: string;
-    content?: unknown[];
-    rawInput?: unknown;
-    _meta?: Record<string, unknown>;
-} | {
-    sessionUpdate: 'tool_call_update';
-    toolCallId: string;
-    fields: {
-        status?: string;
-        content?: unknown[];
-        rawOutput?: unknown;
-    };
-    _meta?: Record<string, unknown>;
-} | {
-    sessionUpdate: 'current_mode_update';
-    currentModeId: AcpSessionModeId;
-} | {
-    sessionUpdate: 'plan_update';
-    plan: unknown;
-} | {
-    sessionUpdate: string;
-    [k: string]: unknown;
-};
-export interface AcpSessionNotification {
-    sessionId: string;
-    update: AcpSessionUpdate;
-    _meta?: Record<string, unknown>;
-}
-export type AcpPermissionOptionKind = 'allow_once' | 'allow_always' | 'reject_once' | 'reject_always';
-export interface AcpPermissionOption {
-    optionId: string;
-    name: string;
-    kind: AcpPermissionOptionKind;
-}
-export interface AcpToolCallSummary {
-    toolCallId: string;
-    title?: string;
-    kind?: string;
-    status?: string;
-    content?: unknown[];
-    rawInput?: unknown;
-    rawOutput?: unknown;
-}
-export interface AcpRequestPermissionRequest {
-    sessionId: string;
-    toolCall: AcpToolCallSummary;
-    options: AcpPermissionOption[];
-    _meta?: Record<string, unknown>;
-}
-export type AcpRequestPermissionOutcome = {
-    outcome: 'cancelled';
-} | {
-    outcome: 'selected';
-    optionId: string;
-};
-export interface AcpRequestPermissionResponse {
-    outcome: AcpRequestPermissionOutcome;
-    _meta?: Record<string, unknown>;
-}
-/** Wire envelope: pairs a `requestId` with the request body so the client
- *  reply can address the parked Rust-side oneshot. */
-export interface AcpPermissionRequestEnvelope {
-    requestId: string;
-    request: AcpRequestPermissionRequest;
-}
-export interface AcpLoadSessionResponse {
-    /** Optional mode advertisement so the picker can hydrate without paying
-     *  the cold-spawn cost of `newSession`. */
-    modes?: AcpSessionModes;
-}
-export interface AcpForkResult {
-    newThreadId: string;
-    sourceThreadId: string;
-    branchedFromTurn?: number;
-}
-export interface AcpForkOpts {
-    upToTurn?: number;
-    label?: string;
-}
-export type AcpNotifyKind = 'notification' | 'permissionRequest';
-export interface AcpNotifyPayload {
-    threadId: string;
-    title: string;
-    body: string;
-    kind: AcpNotifyKind;
-}
-/**
- * ACP-shaped engine adapter. Implementations:
- *   - `pkgs/engine-claude-code` — wraps the in-process Rust ACP server.
- *   - future: `pkgs/engine-codex`, `pkgs/engine-aider` — each speaking the
- *     same wire shapes.
- *
- * Method names mirror ACP verbatim (`newSession`, `prompt`, `cancel`,
- * `setMode`, `loadSession`, `forkSession`, `respondPermission`) so the wire
- * layer, adapter layer, and host shell share one vocabulary.
- *
- * Subscriptions return a synchronous `() => void` unsubscribe — the
- * implementation may resolve the underlying tauri-listener asynchronously
- * but the caller can drop the registration immediately on unmount.
- */
-export interface AcpEngine {
-    initialize(req: AcpInitializeRequest): Promise<AcpInitializeResponse>;
-    /** Mint a new session. The agent may lazily spawn its child on the first
-     *  `prompt` rather than during `newSession` itself. */
-    newSession(req: AcpNewSessionRequest): Promise<AcpNewSessionResponse>;
-    /** Send a turn. Resolves when the turn ends; in-progress events flow via
-     *  `onSessionUpdate`. */
-    prompt(req: AcpPromptRequest): Promise<AcpPromptResponse>;
-    /** Clean interrupt. Preserves the transcript and keeps the child alive
-     *  for the next turn. */
-    cancel(sessionId: string): Promise<void>;
-    /** Switch the session's permission mode. */
-    setMode(sessionId: string, modeId: AcpSessionModeId): Promise<void>;
-    /** Re-attach to an existing session by id. The child stays lazy. */
-    loadSession(sessionId: string): Promise<AcpLoadSessionResponse>;
-    /** Clone a session from a chosen turn. The new thread inherits the source's
-     *  on-disk transcript so the first prompt resumes from the cutoff. */
-    forkSession(sourceSessionId: string, opts?: AcpForkOpts): Promise<AcpForkResult>;
-    /** Subscribe to session updates. Returns a sync unsubscribe. */
-    onSessionUpdate(sessionId: string, callback: (update: AcpSessionUpdate) => void): () => void;
-    /** Subscribe to permission requests for this session. Reply via
-     *  `respondPermission`. Returns a sync unsubscribe. */
-    onPermissionRequest(sessionId: string, callback: (envelope: AcpPermissionRequestEnvelope) => void): () => void;
-    /** Reply to a parked permission request. */
-    respondPermission(requestId: string, response: AcpRequestPermissionResponse): Promise<void>;
-    /** Subscribe to OS-attention notifications. Returns a sync unsubscribe. */
-    onNotify(callback: (payload: AcpNotifyPayload) => void): () => void;
-}
-//# sourceMappingURL=engine.d.ts.map
+//# sourceMappingURL=adapter.d.ts.map

package/dist/engine/adapter.d.ts.map

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

package/dist/{engine.js → engine/adapter.js}

@@ -1,8 +1,16 @@
-// Engine adapter contract. Implementations:
-//   - engine-claude-code  (default, ships preinstalled)
-//   - engine-codex        (future)
-//   - engine-aider        (future)
-//   - engine-noop         (testing / shell-without-AI mode)
+/**
+ * Legacy Engine adapter shape. New adapters target `./acp.ts`. Both are
+ * exported through `@ikenga/contract/engine` during the deprecation cycle.
+ *
+ * Engine adapter contract. Implementations:
+ *   - engine-claude-code  (default, ships preinstalled)
+ *   - engine-codex        (future)
+ *   - engine-aider        (future)
+ *   - engine-noop         (testing / shell-without-AI mode)
+ *
+ * @deprecated Phase 11 retires this surface. New adapters target the ACP
+ *   shape in `./acp.ts` (`AcpEngine`, `createAcpEngine`, `AcpHost`).
+ */
 import { z } from 'zod';
 // ---------- Capabilities (single source of truth) ----------
 /**
@@ -82,4 +90,4 @@ export const EngineProvidesSchema = z.object({
         requiredEnvVars: [],
     }),
 });
-//# sourceMappingURL=engine.js.map
+//# sourceMappingURL=adapter.js.map