@smithers-orchestrator/agents 0.16.9 → 0.18.0

package/src/index.d.ts

@@ -4,7 +4,6 @@ import { ToolLoopAgent, ToolSet, ToolLoopAgentSettings } from 'ai';
 import { anthropic } from '@ai-sdk/anthropic';
 import { Effect } from 'effect';
 import { SmithersError } from '@smithers-orchestrator/errors/SmithersError';
-import * as zod from 'zod';
 import * as zod_v4_core from 'zod/v4/core';
 
 type SmithersToolSurface$2 = "raw" | "semantic";
@@ -113,7 +112,7 @@ type AgentToolDescriptor$1 = {
 
 type AgentCapabilityRegistry$3 = {
     version: 1;
-    engine: "claude-code" | "codex" | "gemini" | "kimi" | "pi" | "amp" | "forge";
+    engine: "claude-code" | "codex" | "gemini" | "kimi" | "pi" | "amp" | "forge" | "opencode";
     runtimeTools: Record<string, AgentToolDescriptor$1>;
     mcp: {
         bootstrap: "inline-config" | "project-config" | "allow-list" | "unsupported";
@@ -152,6 +151,8 @@ type AgentLike$1 = {
     tools?: Record<string, unknown>;
     /** Optional structured capability registry for cache and diagnostics */
     capabilities?: AgentCapabilityRegistry$1;
+    /** True when the agent consumes outputSchema through a native structured-output API. */
+    supportsNativeStructuredOutput?: boolean;
     /**
      * Generates a response or action based on the provided arguments.
      *
@@ -165,7 +166,7 @@ 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: unknown) => Promise<unknown>;
+    generate: (args?: AgentGenerateOptions) => Promise<unknown>;
 };
 
 type RunCommandResult = {
@@ -238,11 +239,11 @@ declare class BaseCliAgent {
     maxOutputBytes: number | undefined;
     extraArgs: string[] | undefined;
     /**
-   * @param {AgentGenerateOptions} [options]
+   * @param {AgentGenerateOptions | undefined} options
    * @param {AgentInvocationOperation} operation
    * @returns {Effect.Effect<GenerateTextResult<Record<string, never>, unknown>, SmithersError>}
    */
-    runGenerateEffect(options?: AgentGenerateOptions, operation: AgentInvocationOperation): Effect.Effect<GenerateTextResult$3<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>>}
@@ -304,20 +305,12 @@ declare class AnthropicAgent extends ToolLoopAgent<never, any, never> {
     constructor(opts: AnthropicAgentOptions$1<CALL_OPTIONS, TOOLS>);
     hijackEngine: string;
     /**
-   * @param {ExtendedGenerateArgs<CALL_OPTIONS, TOOLS>} args
+   * @param {AgentGenerateOptions} [args]
    * @returns {Promise<GenerateTextResult<TOOLS, never>>}
    */
-    generate(args: ExtendedGenerateArgs$1<CALL_OPTIONS, TOOLS>): Promise<GenerateTextResult$2<TOOLS, never>>;
+    generate(args?: AgentGenerateOptions): Promise<GenerateTextResult$2<TOOLS, never>>;
 }
-type AgentCallParameters$1 = any;
 type AnthropicAgentOptions$1<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = AnthropicAgentOptions$2<CALL_OPTIONS, TOOLS>;
-type ExtendedGenerateArgs$1<CALL_OPTIONS, TOOLS> = AgentCallParameters$1<CALL_OPTIONS, TOOLS> & {
-    onStdout?: (text: string) => void;
-    onStderr?: (text: string) => void;
-    onEvent?: (event: unknown) => Promise<void> | void;
-    outputSchema?: zod.ZodTypeAny;
-    resumeSession?: string;
-};
 type GenerateTextResult$2 = ai.GenerateTextResult<any, any>;
 
 /** @typedef {import("ai").AgentCallParameters} AgentCallParameters */
@@ -337,19 +330,11 @@ declare class OpenAIAgent extends ToolLoopAgent<never, any, never> {
     constructor(opts: OpenAIAgentOptions$1<CALL_OPTIONS, TOOLS>);
     hijackEngine: string;
     /**
-   * @param {ExtendedGenerateArgs<CALL_OPTIONS, TOOLS>} args
+   * @param {AgentGenerateOptions} [args]
    * @returns {Promise<GenerateTextResult<TOOLS, never>>}
    */
-    generate(args: ExtendedGenerateArgs<CALL_OPTIONS, TOOLS>): Promise<GenerateTextResult$1<TOOLS, never>>;
+    generate(args?: AgentGenerateOptions): Promise<GenerateTextResult$1<TOOLS, never>>;
 }
-type AgentCallParameters = any;
-type ExtendedGenerateArgs<CALL_OPTIONS, TOOLS> = AgentCallParameters<CALL_OPTIONS, TOOLS> & {
-    onStdout?: (text: string) => void;
-    onStderr?: (text: string) => void;
-    onEvent?: (event: unknown) => Promise<void> | void;
-    outputSchema?: zod.ZodTypeAny;
-    resumeSession?: string;
-};
 type GenerateTextResult$1 = ai.GenerateTextResult<any, any>;
 type OpenAIAgentOptions$1<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = OpenAIAgentOptions$2<CALL_OPTIONS, TOOLS>;
 
@@ -391,25 +376,7 @@ declare class AmpAgent extends BaseCliAgent {
      */
     constructor(opts?: AmpAgentOptions);
     opts: AmpAgentOptions$1;
-    capabilities: {
-        version: number;
-        engine: string;
-        runtimeTools: {};
-        mcp: {
-            bootstrap: string;
-            supportsProjectScope: boolean;
-            supportsUserScope: boolean;
-        };
-        skills: {
-            supportsSkills: boolean;
-            smithersSkillIds: never[];
-        };
-        humanInteraction: {
-            supportsUiRequests: boolean;
-            methods: never[];
-        };
-        builtIns: string[];
-    };
+    capabilities: AgentCapabilityRegistry$3;
     cliEngine: string;
     /**
    * @returns {CliOutputInterpreter}
@@ -526,6 +493,21 @@ type CodexAgentOptions$1 = BaseCliAgentOptions$1 & {
     color?: "always" | "never" | "auto";
     json?: boolean;
     outputLastMessage?: string;
+    /**
+     * Path to an isolated Codex CLI config directory. Sets `CODEX_HOME` on the
+     * spawned process so this invocation uses the credentials stored at
+     * `<configDir>/auth.json` (instead of the user's default `~/.codex/`).
+     *
+     * Use this to run multiple Codex / ChatGPT subscriptions side-by-side. Set
+     * up the directory by running `CODEX_HOME=<path> codex login` once.
+     */
+    configDir?: string;
+    /**
+     * OpenAI API key for billing this invocation against the API instead of a
+     * ChatGPT Plus/Pro subscription. Sets `OPENAI_API_KEY` on the spawned
+     * process.
+     */
+    apiKey?: string;
 };
 
 declare class CodexAgent extends BaseCliAgent {
@@ -758,25 +740,7 @@ declare class ForgeAgent extends BaseCliAgent {
    */
     constructor(opts?: ForgeAgentOptions);
     opts: ForgeAgentOptions$1;
-    capabilities: {
-        version: number;
-        engine: string;
-        runtimeTools: {};
-        mcp: {
-            bootstrap: string;
-            supportsProjectScope: boolean;
-            supportsUserScope: boolean;
-        };
-        skills: {
-            supportsSkills: boolean;
-            smithersSkillIds: never[];
-        };
-        humanInteraction: {
-            supportsUiRequests: boolean;
-            methods: never[];
-        };
-        builtIns: string[];
-    };
+    capabilities: AgentCapabilityRegistry$3;
     cliEngine: string;
     issuedConversationId: any;
     /**
@@ -800,6 +764,42 @@ declare class ForgeAgent extends BaseCliAgent {
 type CliOutputInterpreter = CliOutputInterpreter$8;
 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[];
+    }>;
+}
+
 /**
  * @param {CreateSmithersAgentContractOptions} options
  * @returns {SmithersAgentContract}
@@ -859,6 +859,7 @@ type AgentCapabilityRegistry = AgentCapabilityRegistry$3;
 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 PiAgentOptions = PiAgentOptions$2;
 type PiExtensionUiRequest = PiExtensionUiRequest$1;
@@ -869,4 +870,4 @@ type SmithersAgentToolCategory = SmithersAgentToolCategory$1;
 type SmithersListedTool = SmithersListedTool$2;
 type SmithersToolSurface = SmithersToolSurface$2;
 
-export { type AgentCapabilityRegistry, type AgentLike, type AgentToolDescriptor, AmpAgent, AnthropicAgent, type AnthropicAgentOptions, BaseCliAgent, ClaudeCodeAgent, CodexAgent, ForgeAgent, GeminiAgent, KimiAgent, OpenAIAgent, type OpenAIAgentOptions, PiAgent, type PiAgentOptions, type PiExtensionUiRequest, type PiExtensionUiResponse, type SmithersAgentContract, type SmithersAgentContractTool, type SmithersAgentToolCategory, type SmithersListedTool, type SmithersToolSurface, createSmithersAgentContract, hashCapabilityRegistry, renderSmithersAgentPromptGuidance, sanitizeForOpenAI, zodToOpenAISchema };
+export { type AgentCapabilityRegistry, type AgentGenerateOptions, type AgentLike, type AgentToolDescriptor, AmpAgent, AnthropicAgent, type AnthropicAgentOptions, BaseCliAgent, ClaudeCodeAgent, CodexAgent, ForgeAgent, GeminiAgent, KimiAgent, OpenAIAgent, type OpenAIAgentOptions, OpenCodeAgent, type OpenCodeAgentOptions, PiAgent, type PiAgentOptions, type PiExtensionUiRequest, type PiExtensionUiResponse, type SmithersAgentContract, type SmithersAgentContractTool, type SmithersAgentToolCategory, type SmithersListedTool, type SmithersToolSurface, createSmithersAgentContract, hashCapabilityRegistry, renderSmithersAgentPromptGuidance, sanitizeForOpenAI, zodToOpenAISchema };

package/src/index.js

@@ -1,5 +1,6 @@
 // @smithers-type-exports-begin
 /** @typedef {import("./capability-registry/AgentCapabilityRegistry.ts").AgentCapabilityRegistry} AgentCapabilityRegistry */
+/** @typedef {import("./BaseCliAgent/AgentGenerateOptions.ts").AgentGenerateOptions} AgentGenerateOptions */
 /** @typedef {import("./AgentLike.ts").AgentLike} AgentLike */
 /** @typedef {import("./capability-registry/AgentToolDescriptor.ts").AgentToolDescriptor} AgentToolDescriptor */
 /**
@@ -15,6 +16,7 @@
 /** @typedef {import("./PiAgentOptions.ts").PiAgentOptions} PiAgentOptions */
 /** @typedef {import("./BaseCliAgent/PiExtensionUiRequest.ts").PiExtensionUiRequest} PiExtensionUiRequest */
 /** @typedef {import("./BaseCliAgent/PiExtensionUiResponse.ts").PiExtensionUiResponse} PiExtensionUiResponse */
+/** @typedef {import("./OpenCodeAgent.ts").OpenCodeAgentOptions} OpenCodeAgentOptions */
 /** @typedef {import("./agent-contract/SmithersAgentContract.ts").SmithersAgentContract} SmithersAgentContract */
 /** @typedef {import("./agent-contract/SmithersAgentContractTool.ts").SmithersAgentContractTool} SmithersAgentContractTool */
 /** @typedef {import("./agent-contract/SmithersAgentToolCategory.ts").SmithersAgentToolCategory} SmithersAgentToolCategory */
@@ -33,6 +35,7 @@ export { GeminiAgent } from "./GeminiAgent.js";
 export { PiAgent } from "./PiAgent.js";
 export { KimiAgent } from "./KimiAgent.js";
 export { ForgeAgent } from "./ForgeAgent.js";
+export { OpenCodeAgent } from "./OpenCodeAgent.js";
 export { createSmithersAgentContract } from "./agent-contract/createSmithersAgentContract.js";
 export { renderSmithersAgentPromptGuidance } from "./agent-contract/renderSmithersAgentPromptGuidance.js";
 export { zodToOpenAISchema } from "./zodToOpenAISchema.js";