@smithers-orchestrator/agents 0.22.0 → 0.24.0

package/src/index.d.ts

@@ -1,11 +1,101 @@
-import { openai } from '@ai-sdk/openai';
 import * as ai from 'ai';
 import { ToolLoopAgent, ToolSet, ToolLoopAgentSettings } from 'ai';
-import { anthropic } from '@ai-sdk/anthropic';
 import { Effect } from 'effect';
 import { SmithersError } from '@smithers-orchestrator/errors/SmithersError';
+import { openai } from '@ai-sdk/openai';
+import { anthropic } from '@ai-sdk/anthropic';
 import * as zod_v4_core from 'zod/v4/core';
 
+type CliAgentCapabilityAdapterId$1 = "claude" | "amp" | "antigravity" | "codex" | "forge" | "gemini" | "kimi" | "opencode" | "pi" | "vibe";
+
+type CliAgentSurfaceOptionMapping$1 = {
+    option: string;
+    flag?: string;
+    env?: string;
+    notes?: string;
+};
+type CliAgentUnsupportedFlag$1 = {
+    flag: string;
+    replacement?: string;
+    reason: string;
+};
+type CliAgentSurfaceResumeContract$1 = {
+    kind: "flag" | "subcommand" | "env" | "none";
+    emitted: string[];
+    notes: string;
+};
+type CliAgentSurfaceManifestEntry$2 = {
+    id: CliAgentCapabilityAdapterId$1;
+    displayName: string;
+    binary: string;
+    packageExport: string;
+    defaultOutputFormat: "text" | "json" | "stream-json" | "rpc";
+    docsUrls: string[];
+    emittedFlags: string[];
+    supportedFlags: string[];
+    unsupportedFlags: CliAgentUnsupportedFlag$1[];
+    optionMappings: CliAgentSurfaceOptionMapping$1[];
+    resume: CliAgentSurfaceResumeContract$1;
+};
+
+type AgentToolDescriptor$1 = {
+    description?: string;
+    source?: "builtin" | "mcp" | "extension" | "skill" | "runtime";
+};
+
+type AgentCapabilityRegistry$6 = {
+    version: 1;
+    engine: "claude-code" | "codex" | "antigravity" | "gemini" | "kimi" | "pi" | "amp" | "forge" | "opencode" | "vibe";
+    runtimeTools: Record<string, AgentToolDescriptor$1>;
+    mcp: {
+        bootstrap: "inline-config" | "project-config" | "allow-list" | "unsupported";
+        supportsProjectScope: boolean;
+        supportsUserScope: boolean;
+    };
+    skills: {
+        supportsSkills: boolean;
+        installMode?: "files" | "dir" | "plugin";
+        smithersSkillIds: string[];
+    };
+    humanInteraction: {
+        supportsUiRequests: boolean;
+        methods: string[];
+    };
+    builtIns: string[];
+};
+
+/**
+ * @param {AgentCapabilityRegistry | null | undefined} registry
+ * @returns {string}
+ */
+declare function hashCapabilityRegistry(registry: AgentCapabilityRegistry$5 | null | undefined): string;
+type AgentCapabilityRegistry$5 = AgentCapabilityRegistry$6;
+
+type AgentCapabilityRegistry$4 = AgentCapabilityRegistry$6;
+
+type CliAgentCapabilityReportEntry$2 = {
+    id: CliAgentCapabilityAdapterId$1;
+    binary: string;
+    fingerprint: string;
+    capabilities: AgentCapabilityRegistry$4;
+    surface: CliAgentSurfaceManifestEntry$2;
+};
+
+type CliAgentCapabilityIssue$1 = {
+    code: string;
+    message: string;
+    severity: "error" | "warning";
+};
+type CliAgentCapabilityDoctorEntry$1 = CliAgentCapabilityReportEntry$2 & {
+    ok: boolean;
+    issues: CliAgentCapabilityIssue$1[];
+};
+type CliAgentCapabilityDoctorReport$3 = {
+    ok: boolean;
+    issueCount: number;
+    agents: CliAgentCapabilityDoctorEntry$1[];
+};
+
 type SmithersToolSurface$2 = "raw" | "semantic";
 
 type SmithersListedTool$2 = {
@@ -30,6 +120,12 @@ type SmithersAgentContract$3 = {
     docsGuidance: string;
 };
 
+type RunCommandResult = {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+};
+
 type PiExtensionUiResponse$1 = {
     type: "extension_ui_response";
     id: string;
@@ -47,7 +143,52 @@ type PiExtensionUiRequest$1 = {
     [key: string]: unknown;
 };
 
-type BaseCliAgentOptions$1 = {
+type CodexConfigOverrides = Record<string, string | number | boolean | object | null> | string[];
+
+type AgentCliActionKind = "turn" | "command" | "tool" | "file_change" | "web_search" | "todo_list" | "reasoning" | "warning" | "note";
+
+type AgentCliActionPhase = "started" | "updated" | "completed";
+type AgentCliEventLevel = "debug" | "info" | "warning" | "error";
+type AgentCliStartedEvent = {
+    type: "started";
+    engine: string;
+    title: string;
+    resume?: string;
+    detail?: Record<string, unknown>;
+};
+type AgentCliActionEvent = {
+    type: "action";
+    engine: string;
+    phase: AgentCliActionPhase;
+    entryType?: "thought" | "message";
+    action: {
+        id: string;
+        kind: AgentCliActionKind;
+        title: string;
+        detail?: Record<string, unknown>;
+    };
+    message?: string;
+    ok?: boolean;
+    level?: AgentCliEventLevel;
+};
+type AgentCliCompletedEvent = {
+    type: "completed";
+    engine: string;
+    ok: boolean;
+    answer?: string;
+    error?: string;
+    resume?: string;
+    usage?: Record<string, unknown>;
+};
+type AgentCliEvent$1 = AgentCliStartedEvent | AgentCliActionEvent | AgentCliCompletedEvent;
+
+type CliOutputInterpreter$a = {
+    onStdoutLine?: (line: string) => AgentCliEvent$1[] | AgentCliEvent$1 | null | undefined;
+    onStderrLine?: (line: string) => AgentCliEvent$1[] | AgentCliEvent$1 | null | undefined;
+    onExit?: (result: RunCommandResult) => AgentCliEvent$1[] | AgentCliEvent$1 | null | undefined;
+};
+
+type BaseCliAgentOptions$2 = {
     id?: string;
     model?: string;
     systemPrompt?: string;
@@ -61,7 +202,141 @@ type BaseCliAgentOptions$1 = {
     extraArgs?: string[];
 };
 
-type PiAgentOptions$2 = BaseCliAgentOptions$1 & {
+/**
+ * Loosely-typed generation options. The AI SDK passes a dynamic shape here
+ * (GenerateTextOptions / StreamTextOptions and provider-specific extensions)
+ * so we keep this permissive but avoid raw `any`.
+ */
+type AgentGenerateOptions$4 = {
+    prompt?: unknown;
+    messages?: unknown;
+    timeout?: unknown;
+    abortSignal?: AbortSignal;
+    rootDir?: string;
+    resumeSession?: string;
+    maxOutputBytes?: number;
+    onStdout?: (text: string) => void;
+    onStderr?: (text: string) => void;
+    onEvent?: (event: AgentCliEvent$1) => unknown;
+    retry?: unknown;
+    isRetry?: unknown;
+    retryAttempt?: unknown;
+    schemaRetry?: unknown;
+    [key: string]: unknown;
+};
+
+declare class BaseCliAgent {
+    /**
+   * @param {BaseCliAgentOptions} opts
+   */
+    constructor(opts: BaseCliAgentOptions$1);
+    version: string;
+    tools: {};
+    capabilities: any;
+    id: string;
+    model: string | undefined;
+    systemPrompt: string | undefined;
+    cwd: string | undefined;
+    env: Record<string, string> | undefined;
+    yolo: boolean;
+    timeoutMs: number | undefined;
+    idleTimeoutMs: number | undefined;
+    maxOutputBytes: number | undefined;
+    extraArgs: string[] | undefined;
+    /**
+   * @param {AgentGenerateOptions | undefined} options
+   * @param {AgentInvocationOperation} operation
+   * @returns {Effect.Effect<GenerateTextResult<Record<string, never>, unknown>, SmithersError>}
+   */
+    runGenerateEffect(options: AgentGenerateOptions$3 | undefined, operation: AgentInvocationOperation): Effect.Effect<GenerateTextResult$3<Record<string, never>, unknown>, SmithersError>;
+    /**
+   * @param {AgentGenerateOptions} [options]
+   * @returns {Promise<GenerateTextResult<Record<string, never>, unknown>>}
+   */
+    generate(options?: AgentGenerateOptions$3): Promise<GenerateTextResult$3<Record<string, never>, unknown>>;
+    /**
+   * @param {AgentGenerateOptions} [options]
+   * @returns {Promise<StreamTextResult<Record<string, never>, unknown>>}
+   */
+    stream(options?: AgentGenerateOptions$3): Promise<StreamTextResult<Record<string, never>, unknown>>;
+    /**
+   * @returns {CliOutputInterpreter | undefined}
+   */
+    createOutputInterpreter(): CliOutputInterpreter$9 | undefined;
+}
+type AgentGenerateOptions$3 = AgentGenerateOptions$4;
+type BaseCliAgentOptions$1 = BaseCliAgentOptions$2;
+type CliOutputInterpreter$9 = CliOutputInterpreter$a;
+type GenerateTextResult$3 = ai.GenerateTextResult<any, any>;
+type StreamTextResult = ai.StreamTextResult<any, any>;
+type AgentInvocationOperation = "generate" | "stream";
+
+type BaseCliAgentOptions = BaseCliAgentOptions$2;
+type CliOutputInterpreter$8 = CliOutputInterpreter$a;
+
+type OpenCodeAgentOptions$1 = BaseCliAgentOptions & {
+    /** Model identifier (e.g., "anthropic/claude-opus-4-20250514", "openai/gpt-5.4") */
+    model?: string;
+    /** OpenCode agent name (maps to --agent flag, selects predefined agent config) */
+    agentName?: string;
+    /** Files to attach to the prompt via -f flags */
+    attachFiles?: string[];
+    /** Continue a previous session */
+    continueSession?: boolean;
+    /** Resume a specific session by ID */
+    sessionId?: string;
+    /** Provider-specific model variant/reasoning effort level */
+    variant?: string;
+};
+declare class OpenCodeAgent extends BaseCliAgent {
+    private readonly opts;
+    readonly capabilities: AgentCapabilityRegistry$4;
+    readonly cliEngine: "opencode";
+    constructor(opts?: OpenCodeAgentOptions$1);
+    createOutputInterpreter(): CliOutputInterpreter$8;
+    buildCommand(params: {
+        prompt: string;
+        systemPrompt?: string;
+        cwd: string;
+        options: any;
+    }): Promise<{
+        command: string;
+        args: string[];
+        outputFormat: "stream-json";
+        env?: Record<string, string>;
+        stdoutBannerPatterns: RegExp[];
+        stdoutErrorPatterns: RegExp[];
+    }>;
+}
+
+type VibeAgentOptions$1 = BaseCliAgentOptions$2 & {
+    agent?: string;
+    maxTurns?: number;
+    maxPrice?: number;
+    maxTokens?: number;
+    enabledTools?: string[];
+    sessionId?: string;
+    continueSession?: boolean;
+};
+declare class VibeAgent extends BaseCliAgent {
+    private readonly opts;
+    readonly capabilities: AgentCapabilityRegistry$4;
+    readonly cliEngine: "vibe";
+    constructor(opts?: VibeAgentOptions$1);
+    createOutputInterpreter(): CliOutputInterpreter$8;
+    buildCommand(params: {
+        prompt: string;
+        systemPrompt?: string;
+        cwd: string;
+        options: any;
+    }): Promise<{
+        command: string;
+        args: string[];
+        outputFormat: "stream-json";
+    }>;
+}
+
+type PiAgentOptions$2 = BaseCliAgentOptions$2 & {
     provider?: string;
     model?: string;
     apiKey?: string;
@@ -101,6 +376,38 @@ type SdkAgentOptions<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, MODEL = a
     model: string | MODEL;
 };
 
+/**
+ * Options for {@link HermesAgent}.
+ *
+ * Hermes (Nous Research) exposes an OpenAI-compatible HTTP API
+ * (`/v1/chat/completions`), so a Hermes agent is reached the same way as any
+ * OpenAI-compatible endpoint: point `baseURL` at the Hermes server. These mirror
+ * the string-model form of `OpenAIAgentOptions`.
+ */
+type HermesAgentOptions$2<CALL_OPTIONS = never, TOOLS extends ToolSet = {}> = Omit<SdkAgentOptions<CALL_OPTIONS, TOOLS, ReturnType<typeof openai>>, "model"> & {
+    /**
+     * Model name exposed by your Hermes server. Defaults to `"hermes"`; override
+     * with whatever model id the server advertises.
+     */
+    model?: string;
+    /**
+     * Base URL of the Hermes OpenAI-compatible API, e.g. `http://127.0.0.1:5123/v1`.
+     * Falls back to the `HERMES_BASE_URL` environment variable.
+     */
+    baseURL?: string;
+    /**
+     * API key sent to the Hermes server. Falls back to `HERMES_API_KEY`, then
+     * `"hermes"` (local servers commonly ignore the value).
+     */
+    apiKey?: string;
+    /**
+     * Enable AI SDK native structured output. Off by default because a local
+     * Hermes server may not honor JSON-schema response formats — leaving it off
+     * makes Smithers fall back to prompt-based JSON extraction.
+     */
+    nativeStructuredOutput?: boolean;
+};
+
 type OpenAIAgentCommonOptions<CALL_OPTIONS, TOOLS extends ToolSet> = Omit<SdkAgentOptions<CALL_OPTIONS, TOOLS, ReturnType<typeof openai>>, "model"> & {
     /**
      * Disable AI SDK native structured output and let Smithers use prompt-based JSON extraction.
@@ -108,7 +415,6 @@ type OpenAIAgentCommonOptions<CALL_OPTIONS, TOOLS extends ToolSet> = Omit<SdkAge
      */
     nativeStructuredOutput?: boolean;
 };
-
 type OpenAIAgentStringModelOptions = {
     model: string;
     /**
@@ -120,52 +426,15 @@ type OpenAIAgentStringModelOptions = {
      */
     apiKey?: string;
 };
-
 type OpenAIAgentPrebuiltModelOptions = {
     model: ReturnType<typeof openai>;
     baseURL?: never;
     apiKey?: never;
 };
-
 type OpenAIAgentOptions$2<CALL_OPTIONS = never, TOOLS extends ToolSet = {}> = OpenAIAgentCommonOptions<CALL_OPTIONS, TOOLS> & (OpenAIAgentStringModelOptions | OpenAIAgentPrebuiltModelOptions);
 
 type AnthropicAgentOptions$2<CALL_OPTIONS = never, TOOLS extends ToolSet = {}> = SdkAgentOptions<CALL_OPTIONS, TOOLS, ReturnType<typeof anthropic>>;
 
-type AgentToolDescriptor$1 = {
-    description?: string;
-    source?: "builtin" | "mcp" | "extension" | "skill" | "runtime";
-};
-
-type AgentCapabilityRegistry$3 = {
-    version: 1;
-    engine: "claude-code" | "codex" | "antigravity" | "gemini" | "kimi" | "pi" | "amp" | "forge" | "opencode";
-    runtimeTools: Record<string, AgentToolDescriptor$1>;
-    mcp: {
-        bootstrap: "inline-config" | "project-config" | "allow-list" | "unsupported";
-        supportsProjectScope: boolean;
-        supportsUserScope: boolean;
-    };
-    skills: {
-        supportsSkills: boolean;
-        installMode?: "files" | "dir" | "plugin";
-        smithersSkillIds: string[];
-    };
-    humanInteraction: {
-        supportsUiRequests: boolean;
-        methods: string[];
-    };
-    builtIns: string[];
-};
-
-/**
- * @param {AgentCapabilityRegistry | null | undefined} registry
- * @returns {string}
- */
-declare function hashCapabilityRegistry(registry: AgentCapabilityRegistry$2 | null | undefined): string;
-type AgentCapabilityRegistry$2 = AgentCapabilityRegistry$3;
-
-type AgentCapabilityRegistry$1 = AgentCapabilityRegistry$3;
-
 /**
  * Represents an entity capable of generating responses or actions based on prompts.
  * This is typically an AI agent interface.
@@ -176,7 +445,7 @@ type AgentLike$1 = {
     /** Available tools the agent can use */
     tools?: Record<string, unknown>;
     /** Optional structured capability registry for cache and diagnostics */
-    capabilities?: AgentCapabilityRegistry$1;
+    capabilities?: AgentCapabilityRegistry$4;
     /** True when the agent consumes outputSchema through a native structured-output API. */
     supportsNativeStructuredOutput?: boolean;
     /**
@@ -192,129 +461,11 @@ type AgentLike$1 = {
      * @param args.outputSchema - Optional Zod schema defining the expected structured output format
      * @returns A promise resolving to the generated output
      */
-    generate: (args?: AgentGenerateOptions) => Promise<unknown>;
-};
-
-type RunCommandResult = {
-    stdout: string;
-    stderr: string;
-    exitCode: number | null;
-};
-
-type CodexConfigOverrides = Record<string, string | number | boolean | object | null> | string[];
-
-type AgentCliActionKind = "turn" | "command" | "tool" | "file_change" | "web_search" | "todo_list" | "reasoning" | "warning" | "note";
-
-type AgentCliActionPhase = "started" | "updated" | "completed";
-type AgentCliEventLevel = "debug" | "info" | "warning" | "error";
-type AgentCliStartedEvent = {
-    type: "started";
-    engine: string;
-    title: string;
-    resume?: string;
-    detail?: Record<string, unknown>;
-};
-type AgentCliActionEvent = {
-    type: "action";
-    engine: string;
-    phase: AgentCliActionPhase;
-    entryType?: "thought" | "message";
-    action: {
-        id: string;
-        kind: AgentCliActionKind;
-        title: string;
-        detail?: Record<string, unknown>;
-    };
-    message?: string;
-    ok?: boolean;
-    level?: AgentCliEventLevel;
-};
-type AgentCliCompletedEvent = {
-    type: "completed";
-    engine: string;
-    ok: boolean;
-    answer?: string;
-    error?: string;
-    resume?: string;
-    usage?: Record<string, unknown>;
-};
-type AgentCliEvent$2 = AgentCliStartedEvent | AgentCliActionEvent | AgentCliCompletedEvent;
-
-type CliOutputInterpreter$8 = {
-    onStdoutLine?: (line: string) => AgentCliEvent$2[] | AgentCliEvent$2 | null | undefined;
-    onStderrLine?: (line: string) => AgentCliEvent$2[] | AgentCliEvent$2 | null | undefined;
-    onExit?: (result: RunCommandResult) => AgentCliEvent$2[] | AgentCliEvent$2 | null | undefined;
-};
-
-declare class BaseCliAgent {
-    /**
-   * @param {BaseCliAgentOptions} opts
-   */
-    constructor(opts: BaseCliAgentOptions);
-    version: string;
-    tools: {};
-    capabilities: any;
-    id: string;
-    model: string | undefined;
-    systemPrompt: string | undefined;
-    cwd: string | undefined;
-    env: Record<string, string> | undefined;
-    yolo: boolean;
-    timeoutMs: number | undefined;
-    idleTimeoutMs: number | undefined;
-    maxOutputBytes: number | undefined;
-    extraArgs: string[] | undefined;
-    /**
-   * @param {AgentGenerateOptions | undefined} options
-   * @param {AgentInvocationOperation} operation
-   * @returns {Effect.Effect<GenerateTextResult<Record<string, never>, unknown>, SmithersError>}
-   */
-    runGenerateEffect(options: AgentGenerateOptions | undefined, operation: AgentInvocationOperation): Effect.Effect<GenerateTextResult$3<Record<string, never>, unknown>, SmithersError>;
-    /**
-   * @param {AgentGenerateOptions} [options]
-   * @returns {Promise<GenerateTextResult<Record<string, never>, unknown>>}
-   */
-    generate(options?: AgentGenerateOptions): Promise<GenerateTextResult$3<Record<string, never>, unknown>>;
-    /**
-   * @param {AgentGenerateOptions} [options]
-   * @returns {Promise<StreamTextResult<Record<string, never>, unknown>>}
-   */
-    stream(options?: AgentGenerateOptions): Promise<StreamTextResult<Record<string, never>, unknown>>;
-    /**
-   * @returns {CliOutputInterpreter | undefined}
-   */
-    createOutputInterpreter(): CliOutputInterpreter$7 | undefined;
-}
-type AgentCliEvent$1 = AgentCliEvent$2;
-type BaseCliAgentOptions = BaseCliAgentOptions$1;
-type CliOutputInterpreter$7 = CliOutputInterpreter$8;
-type GenerateTextResult$3 = ai.GenerateTextResult<any, any>;
-type StreamTextResult = ai.StreamTextResult<any, any>;
-type AgentInvocationOperation = "generate" | "stream";
-/**
- * Loosely-typed generation options. The AI SDK passes a dynamic shape here
- * (GenerateTextOptions / StreamTextOptions and provider-specific extensions)
- * so we keep this permissive but avoid raw `any`.
- */
-type AgentGenerateOptions = {
-    prompt?: unknown;
-    messages?: unknown;
-    timeout?: unknown;
-    abortSignal?: AbortSignal;
-    rootDir?: string;
-    resumeSession?: string;
-    maxOutputBytes?: number;
-    onStdout?: (text: string) => void;
-    onStderr?: (text: string) => void;
-    onEvent?: (event: AgentCliEvent$1) => unknown;
-    retry?: unknown;
-    isRetry?: unknown;
-    retryAttempt?: unknown;
-    schemaRetry?: unknown;
-    [key: string]: unknown;
+    generate: (args?: AgentGenerateOptions$4) => Promise<unknown>;
 };
 
 /** @typedef {import("ai").AgentCallParameters} AgentCallParameters */
+/** @typedef {import("./BaseCliAgent/AgentGenerateOptions.ts").AgentGenerateOptions} AgentGenerateOptions */
 /**
  * @template [CALL_OPTIONS=never], [TOOLS=import("ai").ToolSet]
  * @typedef {import("./AnthropicAgentOptions.ts").AnthropicAgentOptions<CALL_OPTIONS, TOOLS>} AnthropicAgentOptions
@@ -330,16 +481,19 @@ declare class AnthropicAgent extends ToolLoopAgent<never, any, never> {
    */
     constructor(opts: AnthropicAgentOptions$1<CALL_OPTIONS, TOOLS>);
     hijackEngine: string;
+    supportsNativeStructuredOutput: boolean;
     /**
    * @param {AgentGenerateOptions} [args]
    * @returns {Promise<GenerateTextResult<TOOLS, never>>}
    */
-    generate(args?: AgentGenerateOptions): Promise<GenerateTextResult$2<TOOLS, never>>;
+    generate(args?: AgentGenerateOptions$2): Promise<GenerateTextResult$2<TOOLS, never>>;
 }
+type AgentGenerateOptions$2 = AgentGenerateOptions$4;
 type AnthropicAgentOptions$1<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = AnthropicAgentOptions$2<CALL_OPTIONS, TOOLS>;
 type GenerateTextResult$2 = ai.GenerateTextResult<any, any>;
 
 /** @typedef {import("ai").AgentCallParameters} AgentCallParameters */
+/** @typedef {import("./BaseCliAgent/AgentGenerateOptions.ts").AgentGenerateOptions} AgentGenerateOptions */
 /**
  * @template CALL_OPTIONS, TOOLS
  * @typedef {AgentCallParameters<CALL_OPTIONS, TOOLS> & { onStdout?: (text: string) => void; onStderr?: (text: string) => void; onEvent?: (event: unknown) => Promise<void> | void; outputSchema?: import("zod").ZodTypeAny; resumeSession?: string; }} ExtendedGenerateArgs
@@ -355,141 +509,41 @@ declare class OpenAIAgent extends ToolLoopAgent<never, any, never> {
    */
     constructor(opts: OpenAIAgentOptions$1<CALL_OPTIONS, TOOLS>);
     hijackEngine: string;
+    supportsNativeStructuredOutput: boolean;
     /**
    * @param {AgentGenerateOptions} [args]
    * @returns {Promise<GenerateTextResult<TOOLS, never>>}
    */
-    generate(args?: AgentGenerateOptions): Promise<GenerateTextResult$1<TOOLS, never>>;
+    generate(args?: AgentGenerateOptions$1): Promise<GenerateTextResult$1<TOOLS, never>>;
 }
+type AgentGenerateOptions$1 = AgentGenerateOptions$4;
 type GenerateTextResult$1 = ai.GenerateTextResult<any, any>;
 type OpenAIAgentOptions$1<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = OpenAIAgentOptions$2<CALL_OPTIONS, TOOLS>;
 
-type HermesAgentOptions$2<CALL_OPTIONS = never, TOOLS extends ToolSet = {}> = Omit<SdkAgentOptions<CALL_OPTIONS, TOOLS, ReturnType<typeof openai>>, "model"> & {
-    model?: string;
-    baseURL?: string;
-    apiKey?: string;
-    nativeStructuredOutput?: boolean;
-};
-/**
- * Hermes (Nous Research) agent, reached over its OpenAI-compatible HTTP API.
- */
-declare class HermesAgent extends OpenAIAgent {
-    constructor(opts?: HermesAgentOptions$2);
-}
-
 /**
- * Configuration options for the AmpAgent.
+ * @template [CALL_OPTIONS=never], [TOOLS=import("ai").ToolSet]
+ * @typedef {import("./HermesAgentOptions.ts").HermesAgentOptions<CALL_OPTIONS, TOOLS>} HermesAgentOptions
  */
-type AmpAgentOptions$1 = BaseCliAgentOptions$1 & {
-    /** Visibility setting for the new thread (e.g., private, public) */
-    visibility?: "private" | "public" | "workspace" | "group";
-    /** Path to a specific MCP configuration file */
-    mcpConfig?: string;
-    /** Path to a specific settings file */
-    settingsFile?: string;
-    /** Logging severity level */
-    logLevel?: "error" | "warn" | "info" | "debug" | "audit";
-    /** File path to write logs to */
-    logFile?: string;
-    /**
-     * If true, dangerously allows all commands without asking for permission.
-     * Equivalent to yolo mode but explicit.
-     */
-    dangerouslyAllowAll?: boolean;
-    /** Whether to enable IDE integrations (disabled by default in AmpAgent) */
-    ide?: boolean;
-    /** Whether to enable JetBrains IDE integration */
-    jetbrains?: boolean;
-};
-
-/** @typedef {import("./BaseCliAgent/CliOutputInterpreter.ts").CliOutputInterpreter} CliOutputInterpreter */
 /**
- * Agent implementation that wraps the 'amp' CLI executable.
- * It translates generation requests into CLI arguments and executes the process.
+ * Hermes (Nous Research) agent, reached over its OpenAI-compatible HTTP API.
+ *
+ * A thin wrapper over {@link OpenAIAgent}: it points the OpenAI-compatible
+ * provider at the Hermes server (`baseURL` / `HERMES_BASE_URL`) and disables AI
+ * SDK native structured output by default, since a local Hermes server may not
+ * honor JSON-schema response formats. Everything else — tool loops, streaming,
+ * prompt-based structured output — comes from the shared OpenAI path.
+ *
+ * @template [CALL_OPTIONS=never], [TOOLS=import("ai").ToolSet]
  */
-declare class AmpAgent extends BaseCliAgent {
+declare class HermesAgent<CALL_OPTIONS = never, TOOLS = ai.ToolSet> extends OpenAIAgent {
     /**
-     * Initializes a new AmpAgent with the given options.
-     *
-     * @param {AmpAgentOptions} [opts] - Configuration options for the agent
+     * @param {HermesAgentOptions<CALL_OPTIONS, TOOLS>} [opts]
      */
-    constructor(opts?: AmpAgentOptions);
-    opts: AmpAgentOptions$1;
-    capabilities: AgentCapabilityRegistry$3;
-    cliEngine: string;
-    /**
-   * @returns {CliOutputInterpreter}
-   */
-    createOutputInterpreter(): CliOutputInterpreter$6;
-    /**
-   * @param {{ prompt: string; systemPrompt?: string; cwd: string; options: any; }} params
-   */
-    buildCommand(params: {
-        prompt: string;
-        systemPrompt?: string;
-        cwd: string;
-        options: any;
-    }): Promise<{
-        command: string;
-        args: string[];
-        outputFormat: string;
-    }>;
-}
-type AmpAgentOptions = AmpAgentOptions$1;
-type CliOutputInterpreter$6 = CliOutputInterpreter$8;
-
-type AntigravityAgentOptions$1 = BaseCliAgentOptions$1 & {
-    debug?: boolean;
-    model?: string;
-    sandbox?: boolean;
-    yolo?: boolean;
-    dangerouslySkipPermissions?: boolean;
-    allowedMcpServerNames?: string[];
-    allowedTools?: string[];
-    extensions?: string[];
-    listExtensions?: boolean;
-    resume?: string;
-    listSessions?: boolean;
-    deleteSession?: string;
-    includeDirectories?: string[];
-    screenReader?: boolean;
-    outputFormat?: "text" | "json" | "stream-json";
-    binary?: string;
-    configDir?: string;
-    geminiDir?: string;
-    apiKey?: string;
-};
-declare function createAntigravityCapabilityRegistry(opts?: AntigravityAgentOptions): AgentCapabilityRegistry$3;
-declare class AntigravityAgent extends BaseCliAgent {
-    /**
-   * @param {AntigravityAgentOptions} [opts]
-   */
-    constructor(opts?: AntigravityAgentOptions);
-    opts: AntigravityAgentOptions$1;
-    capabilities: AgentCapabilityRegistry$3;
-    cliEngine: string;
-    /**
-   * @returns {CliOutputInterpreter}
-   */
-    createOutputInterpreter(): CliOutputInterpreter$6;
-    /**
-   * @param {{ prompt: string; systemPrompt?: string; cwd: string; options: any; }} params
-   */
-    buildCommand(params: {
-        prompt: string;
-        systemPrompt?: string;
-        cwd: string;
-        options: any;
-    }): Promise<{
-        command: string;
-        args: string[];
-        outputFormat: "text" | "json" | "stream-json";
-        env: Record<string, string> | undefined;
-    }>;
+    constructor(opts?: HermesAgentOptions$1<CALL_OPTIONS, TOOLS>);
 }
-type AntigravityAgentOptions = AntigravityAgentOptions$1;
+type HermesAgentOptions$1<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = HermesAgentOptions$2<CALL_OPTIONS, TOOLS>;
 
-type ClaudeCodeAgentOptions$1 = BaseCliAgentOptions$1 & {
+type ClaudeCodeAgentOptions$1 = BaseCliAgentOptions$2 & {
     addDir?: string[];
     agent?: string;
     agents?: Record<string, {
@@ -499,6 +553,22 @@ type ClaudeCodeAgentOptions$1 = BaseCliAgentOptions$1 & {
     allowDangerouslySkipPermissions?: boolean;
     allowedTools?: string[];
     appendSystemPrompt?: string;
+    /**
+     * Path to an isolated Claude Code config directory. Sets `CLAUDE_CONFIG_DIR`
+     * on the spawned process so this invocation uses the credentials stored at
+     * `<configDir>/.credentials.json` (instead of the user's default `~/.claude/`).
+     *
+     * Use this to run multiple Claude Code subscriptions side-by-side. Set up
+     * the directory by running `CLAUDE_CONFIG_DIR=<path> claude` once and
+     * completing `/login` interactively.
+     */
+    configDir?: string;
+    /**
+     * Anthropic API key for billing this invocation against the API instead of
+     * a Claude Pro/Max subscription. When set, ClaudeCodeAgent stops unsetting
+     * `ANTHROPIC_API_KEY` (which it normally clears so subscription auth wins).
+     */
+    apiKey?: string;
     betas?: string[];
     chrome?: boolean;
     continue?: boolean;
@@ -541,12 +611,12 @@ declare class ClaudeCodeAgent extends BaseCliAgent {
    */
     constructor(opts?: ClaudeCodeAgentOptions);
     opts: ClaudeCodeAgentOptions$1;
-    capabilities: AgentCapabilityRegistry$3;
+    capabilities: AgentCapabilityRegistry$6;
     cliEngine: string;
     /**
    * @returns {CliOutputInterpreter}
    */
-    createOutputInterpreter(): CliOutputInterpreter$5;
+    createOutputInterpreter(): CliOutputInterpreter$7;
     /**
    * @param {{ prompt: string; systemPrompt?: string; cwd: string; options: any; }} params
    */
@@ -559,12 +629,16 @@ declare class ClaudeCodeAgent extends BaseCliAgent {
         command: string;
         args: string[];
         outputFormat: "stream-json" | "text" | "json";
+        env: {
+            CLAUDE_CONFIG_DIR: string;
+            ANTHROPIC_API_KEY: string;
+        } | undefined;
     }>;
 }
 type ClaudeCodeAgentOptions = ClaudeCodeAgentOptions$1;
-type CliOutputInterpreter$5 = CliOutputInterpreter$8;
+type CliOutputInterpreter$7 = CliOutputInterpreter$a;
 
-type CodexAgentOptions$1 = BaseCliAgentOptions$1 & {
+type CodexAgentOptions$1 = BaseCliAgentOptions$2 & {
     config?: CodexConfigOverrides;
     enable?: string[];
     disable?: string[];
@@ -606,12 +680,12 @@ declare class CodexAgent extends BaseCliAgent {
    */
     constructor(opts?: CodexAgentOptions);
     opts: CodexAgentOptions$1;
-    capabilities: AgentCapabilityRegistry$3;
+    capabilities: AgentCapabilityRegistry$6;
     cliEngine: string;
     /**
    * @returns {CliOutputInterpreter}
    */
-    createOutputInterpreter(): CliOutputInterpreter$4;
+    createOutputInterpreter(): CliOutputInterpreter$6;
     /**
    * @param {{ prompt: string; systemPrompt?: string; cwd: string; options: any; }} params
    */
@@ -622,18 +696,27 @@ declare class CodexAgent extends BaseCliAgent {
         options: any;
     }): Promise<{
         command: string;
-        args: any[];
+        args: string[];
         stdin: string;
         outputFile: string;
         outputFormat: string;
+        env: {
+            CODEX_HOME: string;
+            OPENAI_API_KEY: string;
+        } | undefined;
         stdoutBannerPatterns: RegExp[];
         cleanup: () => Promise<void>;
     }>;
 }
-type CliOutputInterpreter$4 = CliOutputInterpreter$8;
+type CliOutputInterpreter$6 = CliOutputInterpreter$a;
 type CodexAgentOptions = CodexAgentOptions$1;
 
-type GeminiAgentOptions$1 = BaseCliAgentOptions$1 & {
+/**
+ * @deprecated Use AntigravityAgentOptions with the Antigravity CLI (`agy`) for
+ * new Google CLI integrations. GeminiAgentOptions remains for legacy and
+ * enterprise Gemini CLI setups.
+ */
+type GeminiAgentOptions$1 = BaseCliAgentOptions$2 & {
     debug?: boolean;
     model?: string;
     sandbox?: boolean;
@@ -650,20 +733,36 @@ type GeminiAgentOptions$1 = BaseCliAgentOptions$1 & {
     includeDirectories?: string[];
     screenReader?: boolean;
     outputFormat?: "text" | "json" | "stream-json";
+    /**
+     * Path to an isolated Gemini CLI config directory. Sets `GEMINI_DIR` on the
+     * spawned process so this invocation uses the credentials stored at
+     * `<configDir>/oauth_creds.json` (instead of the user's default
+     * `~/.gemini/`). Use this to run multiple Gemini accounts side-by-side.
+     */
+    configDir?: string;
+    /**
+     * Gemini API key. Sets `GEMINI_API_KEY` on the spawned process for
+     * API-billed invocations.
+     */
+    apiKey?: string;
 };
 
+/**
+ * @deprecated Use AntigravityAgent for new Google CLI integrations. GeminiAgent
+ * remains for legacy and enterprise Gemini CLI setups.
+ */
 declare class GeminiAgent extends BaseCliAgent {
     /**
    * @param {GeminiAgentOptions} [opts]
    */
     constructor(opts?: GeminiAgentOptions);
     opts: GeminiAgentOptions$1;
-    capabilities: AgentCapabilityRegistry$3;
+    capabilities: AgentCapabilityRegistry$6;
     cliEngine: string;
     /**
    * @returns {CliOutputInterpreter}
    */
-    createOutputInterpreter(): CliOutputInterpreter$3;
+    createOutputInterpreter(): CliOutputInterpreter$5;
     /**
    * @param {{ prompt: string; systemPrompt?: string; cwd: string; options: any; }} params
    */
@@ -676,9 +775,13 @@ declare class GeminiAgent extends BaseCliAgent {
         command: string;
         args: string[];
         outputFormat: "stream-json" | "text" | "json";
+        env: {
+            GEMINI_DIR: string;
+            GEMINI_API_KEY: string;
+        } | undefined;
     }>;
 }
-type CliOutputInterpreter$3 = CliOutputInterpreter$8;
+type CliOutputInterpreter$5 = CliOutputInterpreter$a;
 type GeminiAgentOptions = GeminiAgentOptions$1;
 
 declare class PiAgent extends BaseCliAgent {
@@ -687,7 +790,7 @@ declare class PiAgent extends BaseCliAgent {
    */
     constructor(opts?: PiAgentOptions$1);
     opts: PiAgentOptions$2;
-    capabilities: AgentCapabilityRegistry$3;
+    capabilities: AgentCapabilityRegistry$6;
     cliEngine: string;
     issuedSessionRef: any;
     /**
@@ -708,7 +811,7 @@ declare class PiAgent extends BaseCliAgent {
     /**
    * @returns {CliOutputInterpreter}
    */
-    createOutputInterpreter(): CliOutputInterpreter$2;
+    createOutputInterpreter(): CliOutputInterpreter$4;
     /**
    * @param {PiGenerateOptions} [options]
    * @returns {Promise<GenerateTextResult>}
@@ -732,8 +835,8 @@ declare class PiAgent extends BaseCliAgent {
         cleanup?: () => Promise<void>;
     }>;
 }
-type CliOutputInterpreter$2 = CliOutputInterpreter$8;
-type AgentCliEvent = AgentCliEvent$2;
+type CliOutputInterpreter$4 = CliOutputInterpreter$a;
+type AgentCliEvent = AgentCliEvent$1;
 type GenerateTextResult = ai.GenerateTextResult<Record<string, never>, unknown>;
 type PiAgentOptions$1 = PiAgentOptions$2;
 type PiMode = "text" | "json" | "stream-json" | "rpc";
@@ -751,7 +854,7 @@ type PiGenerateOptions = {
     [key: string]: unknown;
 };
 
-type KimiAgentOptions$1 = BaseCliAgentOptions$1 & {
+type KimiAgentOptions$1 = BaseCliAgentOptions$2 & {
     workDir?: string;
     session?: string;
     continue?: boolean;
@@ -769,6 +872,14 @@ type KimiAgentOptions$1 = BaseCliAgentOptions$1 & {
     maxRalphIterations?: number;
     verbose?: boolean;
     debug?: boolean;
+    /**
+     * Path to an isolated Kimi share directory. Sets `KIMI_SHARE_DIR` on the
+     * spawned process so this invocation reads/writes credentials at
+     * `<configDir>/credentials` (instead of the user's default `~/.kimi/`).
+     * Equivalent to passing `env: { KIMI_SHARE_DIR: <path> }` but uniform with
+     * the other agents' `configDir` option.
+     */
+    configDir?: string;
 };
 
 declare class KimiAgent extends BaseCliAgent {
@@ -777,13 +888,13 @@ declare class KimiAgent extends BaseCliAgent {
    */
     constructor(opts?: KimiAgentOptions);
     opts: KimiAgentOptions$1;
-    capabilities: AgentCapabilityRegistry$3;
+    capabilities: AgentCapabilityRegistry$6;
     cliEngine: string;
     issuedSessionId: any;
     /**
    * @returns {CliOutputInterpreter}
    */
-    createOutputInterpreter(): CliOutputInterpreter$1;
+    createOutputInterpreter(): CliOutputInterpreter$3;
     /**
    * @param {{ prompt: string; systemPrompt?: string; cwd: string; options: any; }} params
    */
@@ -802,13 +913,251 @@ declare class KimiAgent extends BaseCliAgent {
         cleanup: (() => Promise<void>) | undefined;
         stdoutBannerPatterns: RegExp[];
         stdoutErrorPatterns: RegExp[];
+        benignStderrPatterns: RegExp[];
         errorOnBannerOnly: boolean;
     }>;
 }
-type CliOutputInterpreter$1 = CliOutputInterpreter$8;
+type CliOutputInterpreter$3 = CliOutputInterpreter$a;
 type KimiAgentOptions = KimiAgentOptions$1;
 
-type ForgeAgentOptions$1 = BaseCliAgentOptions$1 & {
+/**
+ * @param {CreateSmithersAgentContractOptions} options
+ * @returns {SmithersAgentContract}
+ */
+declare function createSmithersAgentContract(options: CreateSmithersAgentContractOptions): SmithersAgentContract$2;
+type SmithersListedTool$1 = SmithersListedTool$2;
+type SmithersToolSurface$1 = SmithersToolSurface$2;
+type CreateSmithersAgentContractOptions = {
+    toolSurface?: SmithersToolSurface$1;
+    serverName?: string;
+    tools: SmithersListedTool$1[];
+};
+type SmithersAgentContract$2 = SmithersAgentContract$3;
+
+/**
+ * @param {SmithersAgentContract} contract
+ * @param {RenderGuidanceOptions} [options]
+ */
+declare function renderSmithersAgentPromptGuidance(contract: SmithersAgentContract$1, options?: RenderGuidanceOptions): string;
+type RenderGuidanceOptions = {
+    available?: boolean;
+    toolNamePrefix?: string;
+};
+type SmithersAgentContract$1 = SmithersAgentContract$3;
+
+/**
+ * Convert a Zod schema to an OpenAI-safe JSON Schema object.
+ *
+ * Usage:
+ * ```ts
+ * import { zodToOpenAISchema } from "./zodToOpenAISchema";
+ * const jsonSchema = zodToOpenAISchema(myZodSchema);
+ * ```
+ */
+declare function zodToOpenAISchema(zodSchema: any): Promise<zod_v4_core.ZodStandardJSONSchemaPayload<any>>;
+
+/**
+ * Sanitize a JSON Schema for OpenAI's structured-output API.
+ *
+ * OpenAI's `response_format` imposes constraints beyond standard JSON Schema:
+ *
+ * 1. Every object node **must** include `"type": "object"`.
+ * 2. Structured output object nodes must set `additionalProperties: false`.
+ *
+ * Zod v4's `toJSONSchema()` can violate these rules when loose/passthrough
+ * objects are used. Codex rejects those schemas unless they are strict.
+ *
+ * This function fixes these issues in-place so any agent (Codex, future
+ * OpenAI-backed agents, etc.) can safely use a JSON Schema for OpenAI.
+ */
+declare function sanitizeForOpenAI(node: any): void;
+
+/**
+ * Configuration options for the AmpAgent.
+ */
+type AmpAgentOptions$1 = BaseCliAgentOptions$2 & {
+    /** Visibility setting for the new thread (e.g., private, public) */
+    visibility?: "private" | "public" | "workspace" | "group";
+    /** Path to a specific MCP configuration file */
+    mcpConfig?: string;
+    /** Path to a specific settings file */
+    settingsFile?: string;
+    /** Logging severity level */
+    logLevel?: "error" | "warn" | "info" | "debug" | "audit";
+    /** File path to write logs to */
+    logFile?: string;
+    /**
+     * If true, dangerously allows all commands without asking for permission.
+     * Equivalent to yolo mode but explicit.
+     */
+    dangerouslyAllowAll?: boolean;
+    /** Whether to enable IDE integrations (disabled by default in AmpAgent) */
+    ide?: boolean;
+    /** Whether to enable JetBrains IDE integration */
+    jetbrains?: boolean;
+};
+
+/** @typedef {import("./capability-registry/AgentCapabilityRegistry.ts").AgentCapabilityRegistry} AgentCapabilityRegistry */
+/** @typedef {import("./BaseCliAgent/CliOutputInterpreter.ts").CliOutputInterpreter} CliOutputInterpreter */
+/**
+ * @returns {AgentCapabilityRegistry}
+ */
+declare function createAmpCapabilityRegistry(): AgentCapabilityRegistry$3;
+/**
+ * Agent implementation that wraps the 'amp' CLI executable.
+ * It translates generation requests into CLI arguments and executes the process.
+ */
+declare class AmpAgent extends BaseCliAgent {
+    /**
+     * Initializes a new AmpAgent with the given options.
+     *
+     * @param {AmpAgentOptions} [opts] - Configuration options for the agent
+     */
+    constructor(opts?: AmpAgentOptions);
+    opts: AmpAgentOptions$1;
+    /** @type {AgentCapabilityRegistry} */
+    capabilities: AgentCapabilityRegistry$3;
+    cliEngine: string;
+    /**
+   * @returns {CliOutputInterpreter}
+   */
+    createOutputInterpreter(): CliOutputInterpreter$2;
+    /**
+   * @param {{ prompt: string; systemPrompt?: string; cwd: string; options: any; }} params
+   */
+    buildCommand(params: {
+        prompt: string;
+        systemPrompt?: string;
+        cwd: string;
+        options: any;
+    }): Promise<{
+        command: string;
+        args: string[];
+        outputFormat: string;
+    }>;
+}
+type AgentCapabilityRegistry$3 = AgentCapabilityRegistry$6;
+type CliOutputInterpreter$2 = CliOutputInterpreter$a;
+type AmpAgentOptions = AmpAgentOptions$1;
+
+type AntigravityAgentOptions$1 = BaseCliAgentOptions$2 & {
+    model?: string;
+    sandbox?: boolean;
+    yolo?: boolean;
+    dangerouslySkipPermissions?: boolean;
+    allowedMcpServerNames?: string[];
+    allowedTools?: string[];
+    /**
+     * @deprecated Antigravity renamed extensions to plugins and manages them via
+     * `agy plugin`; launch-time extension flags are rejected at runtime.
+     */
+    extensions?: string[];
+    /**
+     * @deprecated Use `agy plugin list` outside Smithers. This option is rejected
+     * at runtime because current `agy` builds no longer accept it during launch.
+     */
+    listExtensions?: boolean;
+    /**
+     * Native Antigravity conversation id. Smithers emits `--conversation`.
+     */
+    conversation?: string;
+    /**
+     * Continue the latest Antigravity conversation. Smithers emits `--continue`.
+     */
+    continue?: boolean;
+    /**
+     * @deprecated Use `conversation`; Smithers still maps this to
+     * `--conversation` for compatibility.
+     */
+    resume?: string;
+    /**
+     * @deprecated Conversation listing is interactive via `/resume`; this option
+     * is rejected at runtime.
+     */
+    listSessions?: boolean;
+    /**
+     * @deprecated Conversation deletion is not a supported non-interactive
+     * launch flag; this option is rejected at runtime.
+     */
+    deleteSession?: string;
+    includeDirectories?: string[];
+    /**
+     * @deprecated Current `agy` builds do not expose `--screen-reader`; this
+     * option is rejected at runtime.
+     */
+    screenReader?: boolean;
+    /**
+     * @deprecated Current `agy` builds do not expose `--output-format`; Smithers
+     * reads Antigravity stdout as text.
+     */
+    outputFormat?: "text" | "json" | "stream-json";
+    /**
+     * @deprecated Current `agy` builds do not expose `--debug`; this option is
+     * rejected at runtime.
+     */
+    debug?: boolean;
+    /**
+     * Antigravity CLI binary to execute. The official CLI currently installs
+     * `agy`; this exists for test harnesses and future binary renames.
+     */
+    binary?: string;
+    /**
+     * Path to an isolated Google CLI config root. Smithers passes it as
+     * `--gemini_dir` and `GEMINI_DIR` so Antigravity reads/writes
+     * `<configDir>/antigravity-cli/...` instead of the user's default
+     * `~/.gemini/antigravity-cli/...`.
+     */
+    configDir?: string;
+    /**
+     * Explicit alias for `configDir` when matching the Antigravity CLI flag name.
+     */
+    geminiDir?: string;
+    /**
+     * Google API key for API-billed invocations when supported by the CLI.
+     */
+    apiKey?: string;
+};
+
+/**
+ * @param {AntigravityAgentOptions} [opts]
+ * @returns {AgentCapabilityRegistry}
+ */
+declare function createAntigravityCapabilityRegistry(opts?: AntigravityAgentOptions): AgentCapabilityRegistry$2;
+declare class AntigravityAgent extends BaseCliAgent {
+    /**
+   * @param {AntigravityAgentOptions} [opts]
+   */
+    constructor(opts?: AntigravityAgentOptions);
+    opts: AntigravityAgentOptions$1;
+    capabilities: AgentCapabilityRegistry$6;
+    cliEngine: string;
+    /**
+   * @returns {CliOutputInterpreter}
+   */
+    createOutputInterpreter(): CliOutputInterpreter$1;
+    /**
+   * @param {{ prompt: string; systemPrompt?: string; cwd: string; options: any; }} params
+   */
+    buildCommand(params: {
+        prompt: string;
+        systemPrompt?: string;
+        cwd: string;
+        options: any;
+    }): Promise<{
+        command: string;
+        args: string[];
+        outputFormat: string;
+        env: {
+            GEMINI_DIR: string | undefined;
+            GEMINI_API_KEY: string;
+        } | undefined;
+    }>;
+}
+type AgentCapabilityRegistry$2 = AgentCapabilityRegistry$6;
+type CliOutputInterpreter$1 = CliOutputInterpreter$a;
+type AntigravityAgentOptions = AntigravityAgentOptions$1;
+
+type ForgeAgentOptions$1 = BaseCliAgentOptions$2 & {
     directory?: string;
     provider?: string;
     agent?: string;
@@ -821,16 +1170,22 @@ type ForgeAgentOptions$1 = BaseCliAgentOptions$1 & {
     conversation?: string;
 };
 
+/** @typedef {import("./capability-registry/AgentCapabilityRegistry.ts").AgentCapabilityRegistry} AgentCapabilityRegistry */
 /** @typedef {import("./BaseCliAgent/BaseCliAgentOptions.ts").BaseCliAgentOptions} BaseCliAgentOptions */
 /** @typedef {import("./BaseCliAgent/CliOutputInterpreter.ts").CliOutputInterpreter} CliOutputInterpreter */
 /** @typedef {import("./ForgeAgentOptions.ts").ForgeAgentOptions} ForgeAgentOptions */
+/**
+ * @returns {AgentCapabilityRegistry}
+ */
+declare function createForgeCapabilityRegistry(): AgentCapabilityRegistry$1;
 declare class ForgeAgent extends BaseCliAgent {
     /**
    * @param {ForgeAgentOptions} [opts]
    */
     constructor(opts?: ForgeAgentOptions);
     opts: ForgeAgentOptions$1;
-    capabilities: AgentCapabilityRegistry$3;
+    /** @type {AgentCapabilityRegistry} */
+    capabilities: AgentCapabilityRegistry$1;
     cliEngine: string;
     issuedConversationId: any;
     /**
@@ -851,114 +1206,80 @@ declare class ForgeAgent extends BaseCliAgent {
         outputFormat: string;
     }>;
 }
-type CliOutputInterpreter = CliOutputInterpreter$8;
+type AgentCapabilityRegistry$1 = AgentCapabilityRegistry$6;
+type CliOutputInterpreter = CliOutputInterpreter$a;
 type ForgeAgentOptions = ForgeAgentOptions$1;
 
-type OpenCodeAgentOptions$1 = BaseCliAgentOptions$1 & {
-    /** Model identifier (e.g., "anthropic/claude-opus-4-20250514", "openai/gpt-5.4") */
-    model?: string;
-    /** OpenCode agent name (maps to --agent flag, selects predefined agent config) */
-    agentName?: string;
-    /** Files to attach to the prompt via -f flags */
-    attachFiles?: string[];
-    /** Continue a previous session */
-    continueSession?: boolean;
-    /** Resume a specific session by ID */
-    sessionId?: string;
-    /** Provider-specific model variant/reasoning effort level */
-    variant?: string;
-};
-
-declare class OpenCodeAgent extends BaseCliAgent {
-    constructor(opts?: OpenCodeAgentOptions);
-    opts: OpenCodeAgentOptions$1;
-    capabilities: AgentCapabilityRegistry$3;
-    cliEngine: "opencode";
-    createOutputInterpreter(): CliOutputInterpreter;
-    buildCommand(params: {
-        prompt: string;
-        systemPrompt?: string;
-        cwd: string;
-        options: any;
-    }): Promise<{
-        command: string;
-        args: string[];
-        outputFormat: "stream-json";
-        env?: Record<string, string>;
-        stdoutBannerPatterns: RegExp[];
-        stdoutErrorPatterns: RegExp[];
-    }>;
-}
+/**
+ * @returns {AgentCapabilityRegistry}
+ */
+declare function createVibeCapabilityRegistry(opts?: VibeAgentOptions$1): AgentCapabilityRegistry$6;
+type VibeAgentOptions = VibeAgentOptions$1;
 
 /**
- * @param {CreateSmithersAgentContractOptions} options
- * @returns {SmithersAgentContract}
+ * @returns {CliAgentCapabilityReportEntry[]}
  */
-declare function createSmithersAgentContract(options: CreateSmithersAgentContractOptions): SmithersAgentContract$2;
-type SmithersListedTool$1 = SmithersListedTool$2;
-type SmithersToolSurface$1 = SmithersToolSurface$2;
-type CreateSmithersAgentContractOptions = {
-    toolSurface?: SmithersToolSurface$1;
-    serverName?: string;
-    tools: SmithersListedTool$1[];
-};
-type SmithersAgentContract$2 = SmithersAgentContract$3;
+declare function getCliAgentCapabilityReport(): CliAgentCapabilityReportEntry$1[];
+type CliAgentCapabilityReportEntry$1 = CliAgentCapabilityReportEntry$2;
 
 /**
- * @param {SmithersAgentContract} contract
- * @param {RenderGuidanceOptions} [options]
+ * @returns {CliAgentCapabilityDoctorReport}
  */
-declare function renderSmithersAgentPromptGuidance(contract: SmithersAgentContract$1, options?: RenderGuidanceOptions): string;
-type RenderGuidanceOptions = {
-    available?: boolean;
-    toolNamePrefix?: string;
-};
-type SmithersAgentContract$1 = SmithersAgentContract$3;
+declare function getCliAgentCapabilityDoctorReport(): CliAgentCapabilityDoctorReport$2;
+type CliAgentCapabilityDoctorReport$2 = CliAgentCapabilityDoctorReport$3;
 
+/** @typedef {import("./CliAgentCapabilityDoctorReport.ts").CliAgentCapabilityDoctorReport} CliAgentCapabilityDoctorReport */
 /**
- * Convert a Zod schema to an OpenAI-safe JSON Schema object.
- *
- * Usage:
- * ```ts
- * import { zodToOpenAISchema } from "./zodToOpenAISchema";
- * const jsonSchema = zodToOpenAISchema(myZodSchema);
- * ```
+ * @param {CliAgentCapabilityDoctorReport} report
+ * @returns {string}
  */
-declare function zodToOpenAISchema(zodSchema: any): Promise<zod_v4_core.ZodStandardJSONSchemaPayload<any>>;
+declare function formatCliAgentCapabilityDoctorReport(report: CliAgentCapabilityDoctorReport$1): string;
+type CliAgentCapabilityDoctorReport$1 = CliAgentCapabilityDoctorReport$3;
 
 /**
- * Sanitize a JSON Schema for OpenAI's structured-output API.
- *
- * OpenAI's `response_format` imposes constraints beyond standard JSON Schema:
- *
- * 1. Every object node **must** include `"type": "object"`.
- * 2. `additionalProperties` must be a boolean or a valid sub-schema with a
- *    `type` key -- bare `{}` is rejected.
- * 3. `additionalProperties: true` is accepted but tells the model it can
- *    return extra keys -- set to `false` if you want strict conformance.
- *
- * Zod v4's `toJSONSchema()` can violate (1) when `z.looseObject()` is used:
- * it emits `{ additionalProperties: true }` without `"type": "object"`.
+ * @param {string} id
+ * @returns {CliAgentSurfaceManifestEntry | undefined}
+ */
+declare function getCliAgentSurfaceManifestEntry(id: string): CliAgentSurfaceManifestEntry$1 | undefined;
+/**
+ * @returns {CliAgentSurfaceManifestEntry[]}
+ */
+declare function listCliAgentSurfaceManifests(): CliAgentSurfaceManifestEntry$1[];
+/** @typedef {import("./CliAgentSurfaceTypes.ts").CliAgentSurfaceManifestEntry} CliAgentSurfaceManifestEntry */
+/**
+ * Compatibility contract for CLI-backed agents. Keep this list focused on the
+ * command surface Smithers emits directly; user-supplied extraArgs remain an
+ * escape hatch and are intentionally not modeled here.
  *
- * This function fixes these issues in-place so any agent (Codex, future
- * OpenAI-backed agents, etc.) can safely use a JSON Schema for OpenAI.
+ * @type {readonly CliAgentSurfaceManifestEntry[]}
  */
-declare function sanitizeForOpenAI(node: any): void;
+declare const CLI_AGENT_SURFACE_MANIFEST: readonly CliAgentSurfaceManifestEntry$1[];
+type CliAgentSurfaceManifestEntry$1 = CliAgentSurfaceManifestEntry$2;
 
-type AgentCapabilityRegistry = AgentCapabilityRegistry$3;
+type AgentCapabilityRegistry = AgentCapabilityRegistry$6;
+type AgentGenerateOptions = AgentGenerateOptions$4;
 type AgentLike = AgentLike$1;
 type AgentToolDescriptor = AgentToolDescriptor$1;
 type AnthropicAgentOptions<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = AnthropicAgentOptions$2<CALL_OPTIONS, TOOLS>;
-type OpenCodeAgentOptions = OpenCodeAgentOptions$1;
 type OpenAIAgentOptions<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = OpenAIAgentOptions$2<CALL_OPTIONS, TOOLS>;
 type HermesAgentOptions<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = HermesAgentOptions$2<CALL_OPTIONS, TOOLS>;
 type PiAgentOptions = PiAgentOptions$2;
 type PiExtensionUiRequest = PiExtensionUiRequest$1;
 type PiExtensionUiResponse = PiExtensionUiResponse$1;
+type OpenCodeAgentOptions = OpenCodeAgentOptions$1;
 type SmithersAgentContract = SmithersAgentContract$3;
 type SmithersAgentContractTool = SmithersAgentContractTool$1;
 type SmithersAgentToolCategory = SmithersAgentToolCategory$1;
 type SmithersListedTool = SmithersListedTool$2;
 type SmithersToolSurface = SmithersToolSurface$2;
+type CliAgentCapabilityAdapterId = CliAgentCapabilityAdapterId$1;
+type CliAgentCapabilityDoctorEntry = CliAgentCapabilityDoctorEntry$1;
+type CliAgentCapabilityDoctorReport = CliAgentCapabilityDoctorReport$3;
+type CliAgentCapabilityIssue = CliAgentCapabilityIssue$1;
+type CliAgentCapabilityReportEntry = CliAgentCapabilityReportEntry$2;
+type CliAgentSurfaceManifestEntry = CliAgentSurfaceManifestEntry$2;
+type CliAgentSurfaceOptionMapping = CliAgentSurfaceOptionMapping$1;
+type CliAgentSurfaceResumeContract = CliAgentSurfaceResumeContract$1;
+type CliAgentUnsupportedFlag = CliAgentUnsupportedFlag$1;
 
-export { type AgentCapabilityRegistry, type AgentGenerateOptions, type AgentLike, type AgentToolDescriptor, AmpAgent, AnthropicAgent, type AnthropicAgentOptions, AntigravityAgent, BaseCliAgent, ClaudeCodeAgent, CodexAgent, ForgeAgent, GeminiAgent, HermesAgent, type HermesAgentOptions, KimiAgent, OpenAIAgent, type OpenAIAgentOptions, OpenCodeAgent, type OpenCodeAgentOptions, PiAgent, type PiAgentOptions, type PiExtensionUiRequest, type PiExtensionUiResponse, type SmithersAgentContract, type SmithersAgentContractTool, type SmithersAgentToolCategory, type SmithersListedTool, type SmithersToolSurface, createAntigravityCapabilityRegistry, createSmithersAgentContract, hashCapabilityRegistry, renderSmithersAgentPromptGuidance, sanitizeForOpenAI, zodToOpenAISchema };
+export { type AgentCapabilityRegistry, type AgentGenerateOptions, type AgentLike, type AgentToolDescriptor, AmpAgent, AnthropicAgent, type AnthropicAgentOptions, AntigravityAgent, BaseCliAgent, CLI_AGENT_SURFACE_MANIFEST, ClaudeCodeAgent, type CliAgentCapabilityAdapterId, type CliAgentCapabilityDoctorEntry, type CliAgentCapabilityDoctorReport, type CliAgentCapabilityIssue, type CliAgentCapabilityReportEntry, type CliAgentSurfaceManifestEntry, type CliAgentSurfaceOptionMapping, type CliAgentSurfaceResumeContract, type CliAgentUnsupportedFlag, CodexAgent, ForgeAgent, GeminiAgent, HermesAgent, type HermesAgentOptions, KimiAgent, OpenAIAgent, type OpenAIAgentOptions, OpenCodeAgent, type OpenCodeAgentOptions, PiAgent, type PiAgentOptions, type PiExtensionUiRequest, type PiExtensionUiResponse, type SmithersAgentContract, type SmithersAgentContractTool, type SmithersAgentToolCategory, type SmithersListedTool, type SmithersToolSurface, VibeAgent, type VibeAgentOptions, createAmpCapabilityRegistry, createAntigravityCapabilityRegistry, createForgeCapabilityRegistry, createSmithersAgentContract, createVibeCapabilityRegistry, formatCliAgentCapabilityDoctorReport, getCliAgentCapabilityDoctorReport, getCliAgentCapabilityReport, getCliAgentSurfaceManifestEntry, hashCapabilityRegistry, listCliAgentSurfaceManifests, renderSmithersAgentPromptGuidance, sanitizeForOpenAI, zodToOpenAISchema };