@ikenga/contract 0.3.0 → 0.5.0

package/dist/engine.d.ts

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 export interface SessionOpts {
     cwd?: string;
     systemPrompt?: string;
@@ -43,11 +44,254 @@ export interface McpServerSpec {
     args?: string[];
     env?: Record<string, string>;
 }
+/**
+ * Capability flags every engine adapter advertises. This is the canonical
+ * shape consumed by both the shell-side ChatAdapter layer and any pkg that
+ * needs to reason about adapter features (wizard, settings UI, telemetry).
+ *
+ * Fields are intentionally a *superset* of what any single adapter
+ * supports — an adapter sets the ones it implements to `true` and the
+ * rest to `false`. Adding a new flag is a non-breaking schema change so
+ * long as adapters default it to `false` until they implement it.
+ */
+export declare const AgentCapabilitiesSchema: z.ZodObject<{
+    /** Streams partial responses as they arrive (vs. all-at-once). */
+    streaming: z.ZodBoolean;
+    /** Invokes external tools / function calls during a turn. */
+    toolUse: z.ZodBoolean;
+    /** Emits an extended-thinking / reasoning channel separate from output. */
+    thinking: z.ZodBoolean;
+    /** Produces structured artifacts (code blocks, files, images) the host renders. */
+    artifacts: z.ZodBoolean;
+    /** Accepts file attachments as part of an input. */
+    fileAttachments: z.ZodBoolean;
+    /** Accepts image input (vision). */
+    imageInput: z.ZodBoolean;
+    /** Recognises a `/slash` command vocabulary. */
+    slashCommands: z.ZodBoolean;
+    /** Lets the user switch models mid-thread. */
+    modelSwitching: z.ZodBoolean;
+    /** Uses prompt-caching for repeated context (Anthropic-specific today). */
+    promptCaching: z.ZodBoolean;
+    /** Runs agentic tools (recursive sub-agents, long-running loops). */
+    agenticTools: z.ZodBoolean;
+    /** Speaks MCP — can register and route through MCP servers. */
+    mcp: z.ZodBoolean;
+    /** Can resume a prior session by id. */
+    sessionResume: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    mcp: boolean;
+    streaming: boolean;
+    toolUse: boolean;
+    thinking: boolean;
+    artifacts: boolean;
+    fileAttachments: boolean;
+    imageInput: boolean;
+    slashCommands: boolean;
+    modelSwitching: boolean;
+    promptCaching: boolean;
+    agenticTools: boolean;
+    sessionResume: boolean;
+}, {
+    mcp: boolean;
+    streaming: boolean;
+    toolUse: boolean;
+    thinking: boolean;
+    artifacts: boolean;
+    fileAttachments: boolean;
+    imageInput: boolean;
+    slashCommands: boolean;
+    modelSwitching: boolean;
+    promptCaching: boolean;
+    agenticTools: boolean;
+    sessionResume: boolean;
+}>;
+export type AgentCapabilities = z.infer<typeof AgentCapabilitiesSchema>;
+/**
+ * Per-adapter onboarding requirements surfaced in the first-run wizard.
+ * The wizard composes these instead of hardcoding per-agent forms —
+ * every engine pkg owns its own setup story.
+ */
+export declare const EngineOnboardingSchema: z.ZodObject<{
+    /** Stronghold-vault keys this adapter needs at runtime (e.g. `ANTHROPIC_API_KEY`). */
+    requiredVaultKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Plain env-vars the adapter expects on the host shell. */
+    requiredEnvVars: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * CLI command the user can run to authenticate. The wizard surfaces this
+     * as a copy-to-clipboard hint — it never shells out on the user's behalf.
+     */
+    authCommand: z.ZodOptional<z.ZodString>;
+    /** Docs URL for setting up this adapter. */
+    docsUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    requiredVaultKeys: string[];
+    requiredEnvVars: string[];
+    authCommand?: string | undefined;
+    docsUrl?: string | undefined;
+}, {
+    requiredVaultKeys?: string[] | undefined;
+    requiredEnvVars?: string[] | undefined;
+    authCommand?: string | undefined;
+    docsUrl?: string | undefined;
+}>;
+export type EngineOnboarding = z.infer<typeof EngineOnboardingSchema>;
+/**
+ * Manifest block declared by engine-* pkgs. Read by the shell's
+ * `AdapterLoader` at pkg-discovery time; consumed by the wizard to compose
+ * adapter-specific onboarding hints.
+ */
+export declare const EngineProvidesSchema: z.ZodObject<{
+    /**
+     * Stable id — matches the detection-side agent id (e.g. `claude-code`,
+     * `codex`, `aider`, `noop`). The wizard's `selected_agent_id` is matched
+     * against this field at adapter-resolve time.
+     */
+    agentId: z.ZodString;
+    /** Display name; overrides any detection-side display if both present. */
+    display: z.ZodOptional<z.ZodString>;
+    /** Snapshot of what this adapter implements. */
+    capabilities: z.ZodObject<{
+        /** Streams partial responses as they arrive (vs. all-at-once). */
+        streaming: z.ZodBoolean;
+        /** Invokes external tools / function calls during a turn. */
+        toolUse: z.ZodBoolean;
+        /** Emits an extended-thinking / reasoning channel separate from output. */
+        thinking: z.ZodBoolean;
+        /** Produces structured artifacts (code blocks, files, images) the host renders. */
+        artifacts: z.ZodBoolean;
+        /** Accepts file attachments as part of an input. */
+        fileAttachments: z.ZodBoolean;
+        /** Accepts image input (vision). */
+        imageInput: z.ZodBoolean;
+        /** Recognises a `/slash` command vocabulary. */
+        slashCommands: z.ZodBoolean;
+        /** Lets the user switch models mid-thread. */
+        modelSwitching: z.ZodBoolean;
+        /** Uses prompt-caching for repeated context (Anthropic-specific today). */
+        promptCaching: z.ZodBoolean;
+        /** Runs agentic tools (recursive sub-agents, long-running loops). */
+        agenticTools: z.ZodBoolean;
+        /** Speaks MCP — can register and route through MCP servers. */
+        mcp: z.ZodBoolean;
+        /** Can resume a prior session by id. */
+        sessionResume: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        mcp: boolean;
+        streaming: boolean;
+        toolUse: boolean;
+        thinking: boolean;
+        artifacts: boolean;
+        fileAttachments: boolean;
+        imageInput: boolean;
+        slashCommands: boolean;
+        modelSwitching: boolean;
+        promptCaching: boolean;
+        agenticTools: boolean;
+        sessionResume: boolean;
+    }, {
+        mcp: boolean;
+        streaming: boolean;
+        toolUse: boolean;
+        thinking: boolean;
+        artifacts: boolean;
+        fileAttachments: boolean;
+        imageInput: boolean;
+        slashCommands: boolean;
+        modelSwitching: boolean;
+        promptCaching: boolean;
+        agenticTools: boolean;
+        sessionResume: boolean;
+    }>;
+    /** Onboarding requirements composed by the wizard. */
+    onboarding: z.ZodDefault<z.ZodObject<{
+        /** Stronghold-vault keys this adapter needs at runtime (e.g. `ANTHROPIC_API_KEY`). */
+        requiredVaultKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Plain env-vars the adapter expects on the host shell. */
+        requiredEnvVars: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * CLI command the user can run to authenticate. The wizard surfaces this
+         * as a copy-to-clipboard hint — it never shells out on the user's behalf.
+         */
+        authCommand: z.ZodOptional<z.ZodString>;
+        /** Docs URL for setting up this adapter. */
+        docsUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        requiredVaultKeys: string[];
+        requiredEnvVars: string[];
+        authCommand?: string | undefined;
+        docsUrl?: string | undefined;
+    }, {
+        requiredVaultKeys?: string[] | undefined;
+        requiredEnvVars?: string[] | undefined;
+        authCommand?: string | undefined;
+        docsUrl?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    capabilities: {
+        mcp: boolean;
+        streaming: boolean;
+        toolUse: boolean;
+        thinking: boolean;
+        artifacts: boolean;
+        fileAttachments: boolean;
+        imageInput: boolean;
+        slashCommands: boolean;
+        modelSwitching: boolean;
+        promptCaching: boolean;
+        agenticTools: boolean;
+        sessionResume: boolean;
+    };
+    agentId: string;
+    onboarding: {
+        requiredVaultKeys: string[];
+        requiredEnvVars: string[];
+        authCommand?: string | undefined;
+        docsUrl?: string | undefined;
+    };
+    display?: string | undefined;
+}, {
+    capabilities: {
+        mcp: boolean;
+        streaming: boolean;
+        toolUse: boolean;
+        thinking: boolean;
+        artifacts: boolean;
+        fileAttachments: boolean;
+        imageInput: boolean;
+        slashCommands: boolean;
+        modelSwitching: boolean;
+        promptCaching: boolean;
+        agenticTools: boolean;
+        sessionResume: boolean;
+    };
+    agentId: string;
+    display?: string | undefined;
+    onboarding?: {
+        requiredVaultKeys?: string[] | undefined;
+        requiredEnvVars?: string[] | undefined;
+        authCommand?: string | undefined;
+        docsUrl?: string | undefined;
+    } | undefined;
+}>;
+export type EngineProvides = z.infer<typeof EngineProvidesSchema>;
 export interface Engine {
     /** Stable identifier — matches the pkg id of the engine adapter. */
     readonly id: string;
     /** Human-readable adapter version. */
     readonly version: string;
+    /**
+     * Static metadata copied from the loading manifest's `engine` block.
+     * Required: every adapter must surface its agentId / display / capabilities
+     * / onboarding so the shell and wizard can introspect without re-parsing
+     * the manifest.
+     */
+    readonly metadata: {
+        agentId: string;
+        display: string;
+        capabilities: AgentCapabilities;
+        onboarding: EngineOnboarding;
+    };
     /** 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`. */
@@ -62,4 +306,269 @@ export interface Engine {
         reason?: string;
     }>;
 }
+/**
+ * Loader the shell uses to bring engine-* pkgs online at boot, tear them
+ * down on removal, and gracefully fall back when the user's
+ * `selected_agent_id` has no installed adapter.
+ *
+ * Implementation lives shell-side (post-Phase-7); this interface lets
+ * the contract pin the shape so engine pkgs and the shell agree on the
+ * load lifecycle.
+ */
+export interface AdapterLoader {
+    /**
+     * Load + register the engine for a given pkg manifest. The manifest must
+     * carry an `engine` block (see `EngineProvidesSchema`); the loader
+     * resolves the adapter implementation and threads the manifest's
+     * metadata into the returned `Engine.metadata`.
+     */
+    load(manifest: {
+        id: string;
+        engine: EngineProvides;
+    }): Promise<Engine>;
+    /** Unload — used on pkg removal. After this resolves the agentId is unregistered. */
+    unload(agentId: string): Promise<void>;
+    /**
+     * Fallback returned when the requested agentId has no registered loader.
+     * Implementations MUST return a working `engine-noop` (or equivalent
+     * inert) adapter so the chat surface never dead-ends.
+     */
+    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

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACpH;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,MAAM;IACrB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,6EAA6E;IAC7E,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD,sEAAsE;IACtE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAEpE,kEAAkE;IAClE,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,gCAAgC;IAChC,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,qEAAqE;IACrE,WAAW,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/engine.js

@@ -3,5 +3,83 @@
 //   - engine-codex        (future)
 //   - engine-aider        (future)
 //   - engine-noop         (testing / shell-without-AI mode)
-export {};
+import { z } from 'zod';
+// ---------- Capabilities (single source of truth) ----------
+/**
+ * Capability flags every engine adapter advertises. This is the canonical
+ * shape consumed by both the shell-side ChatAdapter layer and any pkg that
+ * needs to reason about adapter features (wizard, settings UI, telemetry).
+ *
+ * Fields are intentionally a *superset* of what any single adapter
+ * supports — an adapter sets the ones it implements to `true` and the
+ * rest to `false`. Adding a new flag is a non-breaking schema change so
+ * long as adapters default it to `false` until they implement it.
+ */
+export const AgentCapabilitiesSchema = z.object({
+    /** Streams partial responses as they arrive (vs. all-at-once). */
+    streaming: z.boolean(),
+    /** Invokes external tools / function calls during a turn. */
+    toolUse: z.boolean(),
+    /** Emits an extended-thinking / reasoning channel separate from output. */
+    thinking: z.boolean(),
+    /** Produces structured artifacts (code blocks, files, images) the host renders. */
+    artifacts: z.boolean(),
+    /** Accepts file attachments as part of an input. */
+    fileAttachments: z.boolean(),
+    /** Accepts image input (vision). */
+    imageInput: z.boolean(),
+    /** Recognises a `/slash` command vocabulary. */
+    slashCommands: z.boolean(),
+    /** Lets the user switch models mid-thread. */
+    modelSwitching: z.boolean(),
+    /** Uses prompt-caching for repeated context (Anthropic-specific today). */
+    promptCaching: z.boolean(),
+    /** Runs agentic tools (recursive sub-agents, long-running loops). */
+    agenticTools: z.boolean(),
+    /** Speaks MCP — can register and route through MCP servers. */
+    mcp: z.boolean(),
+    /** Can resume a prior session by id. */
+    sessionResume: z.boolean(),
+});
+// ---------- Engine pkg manifest "engine" block ----------
+/**
+ * Per-adapter onboarding requirements surfaced in the first-run wizard.
+ * The wizard composes these instead of hardcoding per-agent forms —
+ * every engine pkg owns its own setup story.
+ */
+export const EngineOnboardingSchema = z.object({
+    /** Stronghold-vault keys this adapter needs at runtime (e.g. `ANTHROPIC_API_KEY`). */
+    requiredVaultKeys: z.array(z.string()).default([]),
+    /** Plain env-vars the adapter expects on the host shell. */
+    requiredEnvVars: z.array(z.string()).default([]),
+    /**
+     * CLI command the user can run to authenticate. The wizard surfaces this
+     * as a copy-to-clipboard hint — it never shells out on the user's behalf.
+     */
+    authCommand: z.string().optional(),
+    /** Docs URL for setting up this adapter. */
+    docsUrl: z.string().url().optional(),
+});
+/**
+ * Manifest block declared by engine-* pkgs. Read by the shell's
+ * `AdapterLoader` at pkg-discovery time; consumed by the wizard to compose
+ * adapter-specific onboarding hints.
+ */
+export const EngineProvidesSchema = z.object({
+    /**
+     * Stable id — matches the detection-side agent id (e.g. `claude-code`,
+     * `codex`, `aider`, `noop`). The wizard's `selected_agent_id` is matched
+     * against this field at adapter-resolve time.
+     */
+    agentId: z.string().min(1),
+    /** Display name; overrides any detection-side display if both present. */
+    display: z.string().optional(),
+    /** Snapshot of what this adapter implements. */
+    capabilities: AgentCapabilitiesSchema,
+    /** Onboarding requirements composed by the wizard. */
+    onboarding: EngineOnboardingSchema.default({
+        requiredVaultKeys: [],
+        requiredEnvVars: [],
+    }),
+});
 //# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,wDAAwD;AACxD,mCAAmC;AACnC,mCAAmC;AACnC,4DAA4D"}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,wDAAwD;AACxD,mCAAmC;AACnC,mCAAmC;AACnC,4DAA4D;AAE5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+BxB,8DAA8D;AAE9D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,kEAAkE;IAClE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,6DAA6D;IAC7D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,mFAAmF;IACnF,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,oDAAoD;IACpD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;IAC5B,oCAAoC;IACpC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,8CAA8C;IAC9C,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3B,2EAA2E;IAC3E,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,qEAAqE;IACrE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;IACzB,+DAA+D;IAC/D,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE;IAChB,wCAAwC;IACxC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;CAC3B,CAAC,CAAC;AAGH,2DAA2D;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,sFAAsF;IACtF,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,4DAA4D;IAC5D,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,4CAA4C;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,gDAAgD;IAChD,YAAY,EAAE,uBAAuB;IACrC,sDAAsD;IACtD,UAAU,EAAE,sBAAsB,CAAC,OAAO,CAAC;QACzC,iBAAiB,EAAE,EAAE;QACrB,eAAe,EAAE,EAAE;KACpB,CAAC;CACH,CAAC,CAAC"}

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './engine.js';
 export * from './scopes.js';
 export * from './iyke.js';
 export * from './artifact.js';
+export * from './registry.js';
 /** This package's own version. */
-export declare const CONTRACT_PACKAGE_VERSION: "0.3.0";
+export declare const CONTRACT_PACKAGE_VERSION: "0.5.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAE9B,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC"}

package/dist/index.js

@@ -4,6 +4,7 @@ export * from './engine.js';
 export * from './scopes.js';
 export * from './iyke.js';
 export * from './artifact.js';
+export * from './registry.js';
 /** This package's own version. */
-export const CONTRACT_PACKAGE_VERSION = '0.3.0';
+export const CONTRACT_PACKAGE_VERSION = '0.5.0';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAE9B,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAgB,CAAC"}