@smithers-orchestrator/agents 0.22.0 → 0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smithers-orchestrator/agents",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "AI SDK and CLI agent adapters for Smithers",
   "type": "module",
   "sideEffects": false,
@@ -35,6 +35,11 @@
       "import": "./src/cli-capabilities/index.js",
       "default": "./src/cli-capabilities/index.js"
     },
+    "./mcp/createMcpToolset": {
+      "types": "./src/mcp/createMcpToolset.d.ts",
+      "import": "./src/mcp/createMcpToolset.js",
+      "default": "./src/mcp/createMcpToolset.js"
+    },
     "./*": {
       "types": "./src/index.d.ts",
       "import": "./src/*.js",
@@ -47,12 +52,13 @@
   "dependencies": {
     "@ai-sdk/anthropic": "^3.0.71",
     "@ai-sdk/openai": "^3.0.53",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "ai": "^6.0.168",
     "effect": "^3.21.1",
     "zod": "^4.3.6",
-    "@smithers-orchestrator/driver": "0.22.0",
-    "@smithers-orchestrator/errors": "0.22.0",
-    "@smithers-orchestrator/observability": "0.22.0"
+    "@smithers-orchestrator/driver": "0.24.0",
+    "@smithers-orchestrator/errors": "0.24.0",
+    "@smithers-orchestrator/observability": "0.24.0"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/AmpAgent.js

@@ -6,6 +6,31 @@ import { BaseCliAgent, pushFlag, isRecord, asString, toolKindFromName, createSyn
 /** @typedef {import("./capability-registry/AgentCapabilityRegistry.ts").AgentCapabilityRegistry} AgentCapabilityRegistry */
 /** @typedef {import("./BaseCliAgent/CliOutputInterpreter.ts").CliOutputInterpreter} CliOutputInterpreter */
 
+/**
+ * @returns {AgentCapabilityRegistry}
+ */
+export function createAmpCapabilityRegistry() {
+    return {
+        version: 1,
+        engine: "amp",
+        runtimeTools: {},
+        mcp: {
+            bootstrap: "project-config",
+            supportsProjectScope: true,
+            supportsUserScope: false,
+        },
+        skills: {
+            supportsSkills: false,
+            smithersSkillIds: [],
+        },
+        humanInteraction: {
+            supportsUiRequests: false,
+            methods: [],
+        },
+        builtIns: ["default"],
+    };
+}
+
 /**
  * Agent implementation that wraps the 'amp' CLI executable.
  * It translates generation requests into CLI arguments and executes the process.
@@ -23,25 +48,7 @@ export class AmpAgent extends BaseCliAgent {
     constructor(opts = {}) {
         super(opts);
         this.opts = opts;
-        this.capabilities = {
-            version: 1,
-            engine: "amp",
-            runtimeTools: {},
-            mcp: {
-                bootstrap: "project-config",
-                supportsProjectScope: true,
-                supportsUserScope: false,
-            },
-            skills: {
-                supportsSkills: false,
-                smithersSkillIds: [],
-            },
-            humanInteraction: {
-                supportsUiRequests: false,
-                methods: [],
-            },
-            builtIns: ["default"],
-        };
+        this.capabilities = createAmpCapabilityRegistry();
     }
     /**
    * @returns {CliOutputInterpreter}

package/src/AntigravityAgent.js

@@ -1,9 +1,51 @@
 import { BaseCliAgent, pushFlag, pushList, isRecord, asString, truncate, toolKindFromName, createSyntheticIdGenerator, } from "./BaseCliAgent/index.js";
+import { SmithersError } from "@smithers-orchestrator/errors/SmithersError";
 import { normalizeCapabilityStringList, } from "./capability-registry/index.js";
+import { getCliAgentSurfaceManifestEntry } from "./cli-surface/index.js";
 /** @typedef {import("./capability-registry/AgentCapabilityRegistry.ts").AgentCapabilityRegistry} AgentCapabilityRegistry */
 /** @typedef {import("./BaseCliAgent/CliOutputInterpreter.ts").CliOutputInterpreter} CliOutputInterpreter */
 /** @typedef {import("./AntigravityAgentOptions.ts").AntigravityAgentOptions} AntigravityAgentOptions */
 
+const ANTIGRAVITY_SURFACE = getCliAgentSurfaceManifestEntry("antigravity");
+
+/**
+ * @param {string} option
+ * @param {string} flag
+ * @returns {SmithersError}
+ */
+function unsupportedAntigravityOption(option, flag) {
+    const rule = ANTIGRAVITY_SURFACE?.unsupportedFlags.find((entry) => entry.flag === flag);
+    const replacement = rule?.replacement ? ` Use ${rule.replacement} instead.` : "";
+    const reason = rule?.reason ? ` ${rule.reason}` : "";
+    return new SmithersError("AGENT_CONFIG_INVALID", `AntigravityAgent option "${option}" maps to unsupported agy flag ${flag}.${reason}${replacement}`, {
+        agentEngine: "antigravity",
+        option,
+        flag,
+        replacement: rule?.replacement,
+        failureRetryable: false,
+    });
+}
+
+/**
+ * @param {AntigravityAgentOptions} opts
+ */
+function assertSupportedAntigravityOptions(opts) {
+    if (opts.debug)
+        throw unsupportedAntigravityOption("debug", "--debug");
+    if (opts.screenReader)
+        throw unsupportedAntigravityOption("screenReader", "--screen-reader");
+    if (opts.outputFormat !== undefined)
+        throw unsupportedAntigravityOption("outputFormat", "--output-format");
+    if (opts.listSessions)
+        throw unsupportedAntigravityOption("listSessions", "--list-sessions");
+    if (opts.deleteSession !== undefined)
+        throw unsupportedAntigravityOption("deleteSession", "--delete-session");
+    if (opts.extensions?.length)
+        throw unsupportedAntigravityOption("extensions", "--extensions");
+    if (opts.listExtensions)
+        throw unsupportedAntigravityOption("listExtensions", "--list-extensions");
+}
+
 /**
  * @param {AntigravityAgentOptions} opts
  */
@@ -209,15 +251,13 @@ export class AntigravityAgent extends BaseCliAgent {
    * @param {{ prompt: string; systemPrompt?: string; cwd: string; options: any; }} params
    */
     async buildCommand(params) {
+        assertSupportedAntigravityOptions(this.opts);
         const args = [];
         const yoloEnabled = this.opts.dangerouslySkipPermissions ?? this.opts.yolo ?? this.yolo;
-        const outputFormat = this.opts.outputFormat ??
-            (params.options?.onEvent ? "stream-json" : "json");
         const resumeSession = typeof params.options?.resumeSession === "string"
             ? params.options.resumeSession
-            : this.opts.resume;
-        if (this.opts.debug)
-            args.push("--debug");
+            : this.opts.conversation ?? this.opts.resume;
+        args.push("--cwd", params.cwd);
         pushFlag(args, "--model", this.opts.model ?? this.model);
         if (this.opts.sandbox)
             args.push("--sandbox");
@@ -232,18 +272,11 @@ export class AntigravityAgent extends BaseCliAgent {
                 pushList(args, "--allowed-tools", this.opts.allowedTools);
             }
         }
-        pushList(args, "--extensions", this.opts.extensions);
-        if (this.opts.listExtensions)
-            args.push("--list-extensions");
-        pushFlag(args, "--resume", resumeSession);
-        if (this.opts.listSessions)
-            args.push("--list-sessions");
-        pushFlag(args, "--delete-session", this.opts.deleteSession);
-        pushList(args, "--include-directories", this.opts.includeDirectories);
-        if (this.opts.screenReader)
-            args.push("--screen-reader");
+        if (this.opts.continue)
+            args.push("--continue");
+        pushFlag(args, "--conversation", resumeSession);
+        pushList(args, "--add-dir", this.opts.includeDirectories);
         pushFlag(args, "--gemini_dir", this.opts.geminiDir ?? this.opts.configDir);
-        pushFlag(args, "--output-format", outputFormat);
         if (this.extraArgs?.length)
             args.push(...this.extraArgs);
         const systemPrefix = params.systemPrompt
@@ -253,14 +286,16 @@ export class AntigravityAgent extends BaseCliAgent {
             ? "\n\nREMINDER: Your response MUST be ONLY the required raw JSON object. Do not include prose, markdown, or code fences. The first character must be `{` and the last character must be `}`.\n"
             : "";
         const fullPrompt = `${systemPrefix}${params.prompt ?? ""}${jsonReminder}`;
-        args.push("--prompt", fullPrompt);
+        args.push("-p", fullPrompt);
         const accountEnv = {};
+        if (this.opts.geminiDir ?? this.opts.configDir)
+            accountEnv.GEMINI_DIR = this.opts.geminiDir ?? this.opts.configDir;
         if (this.opts.apiKey)
             accountEnv.GEMINI_API_KEY = this.opts.apiKey;
         return {
             command: this.opts.binary ?? "agy",
             args,
-            outputFormat,
+            outputFormat: "text",
             env: Object.keys(accountEnv).length > 0 ? accountEnv : undefined,
         };
     }

package/src/AntigravityAgentOptions.ts

@@ -1,30 +1,71 @@
 import type { BaseCliAgentOptions } from "./BaseCliAgent/BaseCliAgentOptions";
 
 export type AntigravityAgentOptions = BaseCliAgentOptions & {
-  debug?: boolean;
   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. Passed as `--gemini_dir` so
-   * Antigravity reads/writes `<configDir>/antigravity-cli/...` instead of the
-   * user's default `~/.gemini/antigravity-cli/...`.
+   * 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;
   /**

package/src/BaseCliAgent/AgentGenerateOptions.ts

@@ -20,5 +20,17 @@ export type AgentGenerateOptions = {
   isRetry?: unknown;
   retryAttempt?: unknown;
   schemaRetry?: unknown;
+  /**
+   * Run context for the task this agent invocation belongs to. Surfaced to the
+   * spawned agent process (and its subprocesses) as SMITHERS_RUN_ID / NODE_ID /
+   * ITERATION / ATTEMPT so the agent can address its own run — e.g. to raise a
+   * blocking `smithers ask-human` request.
+   */
+  taskContext?: {
+    runId?: string;
+    nodeId?: string;
+    iteration?: number;
+    attempt?: number;
+  };
   [key: string]: unknown;
 };

package/src/BaseCliAgent/BaseCliAgent.js

@@ -14,6 +14,7 @@ import { extractTextFromJsonValue } from "./extractTextFromJsonValue.js";
 import { createAgentStdoutTextEmitter } from "./createAgentStdoutTextEmitter.js";
 import { buildGenerateResult } from "./buildGenerateResult.js";
 import { runCommandEffect } from "./runCommandEffect.js";
+import { taskContextEnv } from "./taskContextEnv.js";
 /** @typedef {import("./AgentCliEvent.ts").AgentCliEvent} AgentCliEvent */
 
 /** @typedef {import("./AgentGenerateOptions.ts").AgentGenerateOptions} AgentGenerateOptions */
@@ -450,6 +451,27 @@ function buildStreamResult(result) {
         fullStream: fullStream,
     };
 }
+/**
+ * Fallback when truncated stdout lost the per-message usage events: the
+ * interpreter's completed event carries the harness usage summary (#277).
+ * @param {{ usage?: unknown } | null} completedEvent
+ * @returns {CliUsageInfo | undefined}
+ */
+function usageFromCompletedEvent(completedEvent) {
+    const u = completedEvent?.usage;
+    if (!u || typeof u !== "object" || Array.isArray(u))
+        return undefined;
+    const num = (value) => (typeof value === "number" && Number.isFinite(value) ? value : undefined);
+    const usage = {
+        inputTokens: num(u.input_tokens) ?? num(u.inputTokens),
+        outputTokens: num(u.output_tokens) ?? num(u.outputTokens),
+        cacheReadTokens: num(u.cache_read_input_tokens) ?? num(u.cacheReadTokens),
+        cacheWriteTokens: num(u.cache_creation_input_tokens) ?? num(u.cacheWriteTokens),
+        reasoningTokens: num(u.reasoning_tokens) ?? num(u.reasoningTokens),
+        totalTokens: num(u.total_tokens) ?? num(u.totalTokens),
+    };
+    return Object.values(usage).some((value) => value !== undefined) ? usage : undefined;
+}
 /**
  * @param {string} raw
  * @returns {CliUsageInfo | undefined}
@@ -628,7 +650,11 @@ export class BaseCliAgent {
             idleMs: this.idleTimeoutMs,
         });
         const cwd = this.cwd ?? options?.rootDir ?? process.cwd();
-        const env = { ...process.env, ...this.env };
+        const env = {
+            ...process.env,
+            ...this.env,
+            ...taskContextEnv(options?.taskContext),
+        };
         const combinedSystem = combineNonEmpty([
             this.systemPrompt,
             systemFromMessages,
@@ -846,6 +872,10 @@ export class BaseCliAgent {
                     idleTimeoutMs: callTimeouts.idleMs,
                     signal: options?.abortSignal,
                     maxOutputBytes: this.maxOutputBytes ?? options?.maxOutputBytes,
+                    // CLI harnesses emit their final result event at the END of
+                    // the stream; if the capture cap trips, the tail is the part
+                    // that must survive (#277).
+                    truncateKeep: "tail",
                     onStdout: (chunk) => {
                         stdoutEmitter?.push(chunk);
                         handleInterpreterChunk("stdout", chunk);
@@ -858,12 +888,30 @@ export class BaseCliAgent {
                 flushBufferedLines("stdout", true);
                 flushBufferedLines("stderr", true);
                 emitEvents(interpreter?.onExit?.(result));
-                const stdout = commandSpec.outputFile
+                if (result.stdoutTruncated) {
+                    emitEvents({
+                        type: "action",
+                        engine: commandSpec.command,
+                        phase: "completed",
+                        entryType: "thought",
+                        action: {
+                            id: `stdout-truncated-${randomUUID()}`,
+                            kind: "warning",
+                            title: "captured stdout truncated",
+                            detail: {},
+                        },
+                        message: "Captured stdout exceeded maxOutputBytes; kept the stream tail. The streamed interpreter answer is used as the result text.",
+                        ok: true,
+                        level: "warning",
+                    });
+                }
+                const outputFileText = commandSpec.outputFile
                     ? yield* Effect.tryPromise({
                         try: () => fs.readFile(commandSpec.outputFile, "utf8"),
                         catch: (cause) => toSmithersError(cause, "read output file"),
-                    }).pipe(Effect.catchAll(() => Effect.succeed(result.stdout)))
-                    : result.stdout;
+                    }).pipe(Effect.catchAll(() => Effect.succeed(null)))
+                    : null;
+                const stdout = typeof outputFileText === "string" ? outputFileText : result.stdout;
                 if (result.exitCode && result.exitCode !== 0) {
                     const filteredStderr = filterBenignStderr(result.stderr, commandSpec.benignStderrPatterns);
                     if (!(commandSpec.command === "codex" && filteredStderr.length === 0)) {
@@ -929,13 +977,35 @@ export class BaseCliAgent {
                         }
                     }
                 }
-                const extractedText = outputFormat === "json" || outputFormat === "stream-json"
-                    ? (extractTextFromJsonPayload(rawText) ?? rawText)
+                const extractedFromStdout = outputFormat === "json" || outputFormat === "stream-json"
+                    ? extractTextFromJsonPayload(rawText)
                     : rawText;
-                const output = tryParseJson(extractedText);
+                // The interpreter parses the live stream line-by-line BEFORE the
+                // capture cap applies, so its completed answer survives stdout
+                // truncation. Prefer it whenever the captured stdout was
+                // truncated or yields no final message; otherwise keep the
+                // historical extraction so intact runs are unchanged (#277).
+                const streamedAnswer = typeof completedEvent?.answer === "string" && completedEvent.answer.trim().length > 0
+                    ? completedEvent.answer
+                    : undefined;
+                // A dedicated final-message file (e.g. codex --output-last-message)
+                // is the CLI's authoritative output channel: it holds the complete
+                // final message and is immune to the stdout byte cap and to
+                // line-by-line stream interpretation. When it parsed as JSON, trust
+                // it over the truncation/stream fallbacks, which otherwise surface a
+                // short `message` field instead of the full structured object.
+                const outputFileJson = typeof outputFileText === "string" && outputFileText.trim() !== ""
+                    ? tryParseJson(outputFileText)
+                    : null;
+                const extractedText = outputFileJson != null
+                    ? outputFileText
+                    : result.stdoutTruncated || extractedFromStdout == null || extractedFromStdout.trim() === ""
+                        ? (streamedAnswer ?? extractedFromStdout ?? rawText)
+                        : extractedFromStdout;
+                const output = outputFileJson ?? tryParseJson(extractedText);
                 // Extract token usage from raw stdout before text extraction strips it.
                 // Each CLI harness embeds usage differently (NDJSON events, JSON stats, etc.)
-                const cliUsage = extractUsageFromOutput(stdout);
+                const cliUsage = extractUsageFromOutput(stdout) ?? usageFromCompletedEvent(completedEvent);
                 const usage = cliUsage ? {
                     inputTokens: cliUsage.inputTokens,
                     inputTokenDetails: {

package/src/BaseCliAgent/RunCommandResult.ts

@@ -2,4 +2,8 @@ export type RunCommandResult = {
   stdout: string;
   stderr: string;
   exitCode: number | null;
+  /** True when captured stdout exceeded maxOutputBytes and was truncated. */
+  stdoutTruncated?: boolean;
+  /** True when captured stderr exceeded maxOutputBytes and was truncated. */
+  stderrTruncated?: boolean;
 };

package/src/BaseCliAgent/runCommandEffect.js

@@ -1,7 +1,7 @@
 import { Effect } from "effect";
 import { spawnCaptureEffect } from "@smithers-orchestrator/driver/child-process";
 /**
- * @typedef {{ cwd: string; env: Record<string, string>; input?: string; timeoutMs?: number; idleTimeoutMs?: number; signal?: AbortSignal; maxOutputBytes?: number; onStdout?: (chunk: string) => void; onStderr?: (chunk: string) => void; }} RunCommandOptions
+ * @typedef {{ cwd: string; env: Record<string, string>; input?: string; timeoutMs?: number; idleTimeoutMs?: number; signal?: AbortSignal; maxOutputBytes?: number; truncateKeep?: "head" | "tail"; onStdout?: (chunk: string) => void; onStderr?: (chunk: string) => void; }} RunCommandOptions
  */
 /** @typedef {import("./RunCommandResult.ts").RunCommandResult} RunCommandResult */
 /** @typedef {import("@smithers-orchestrator/errors/SmithersError").SmithersError} SmithersError */
@@ -13,7 +13,7 @@ import { spawnCaptureEffect } from "@smithers-orchestrator/driver/child-process"
  * @returns {Effect.Effect<RunCommandResult, SmithersError>}
  */
 export function runCommandEffect(command, args, options) {
-    const { cwd, env, input, timeoutMs, idleTimeoutMs, signal, maxOutputBytes, onStdout, onStderr, } = options;
+    const { cwd, env, input, timeoutMs, idleTimeoutMs, signal, maxOutputBytes, truncateKeep, onStdout, onStderr, } = options;
     return spawnCaptureEffect(command, args, {
         cwd,
         env,
@@ -22,6 +22,7 @@ export function runCommandEffect(command, args, options) {
         timeoutMs,
         idleTimeoutMs,
         maxOutputBytes,
+        truncateKeep,
         onStdout,
         onStderr,
     }).pipe(Effect.annotateLogs({

package/src/BaseCliAgent/taskContextEnv.js

@@ -0,0 +1,31 @@
+/**
+ * Map a task's run context into the `SMITHERS_*` environment variables that a
+ * Smithers-spawned agent — and any subprocess it runs, e.g. `smithers ask-human` —
+ * uses to identify the run/node it belongs to. Undefined/blank fields are omitted
+ * so we never clobber an inherited value with `"undefined"`.
+ *
+ * @param {{ runId?: string, nodeId?: string, iteration?: number, attempt?: number } | null | undefined} taskContext
+ * @returns {Record<string, string>}
+ */
+export function taskContextEnv(taskContext) {
+    if (!taskContext) {
+        return {};
+    }
+    /** @type {Record<string, string>} */
+    const env = {};
+    if (typeof taskContext.runId === "string" && taskContext.runId.length > 0) {
+        env.SMITHERS_RUN_ID = taskContext.runId;
+    }
+    if (typeof taskContext.nodeId === "string" && taskContext.nodeId.length > 0) {
+        env.SMITHERS_NODE_ID = taskContext.nodeId;
+    }
+    if (typeof taskContext.iteration === "number" &&
+        Number.isInteger(taskContext.iteration)) {
+        env.SMITHERS_ITERATION = String(taskContext.iteration);
+    }
+    if (typeof taskContext.attempt === "number" &&
+        Number.isInteger(taskContext.attempt)) {
+        env.SMITHERS_ATTEMPT = String(taskContext.attempt);
+    }
+    return env;
+}

package/src/ClaudeCodeAgent.js

@@ -383,7 +383,7 @@ export class ClaudeCodeAgent extends BaseCliAgent {
             args.push("--chrome");
         if (this.opts.noChrome)
             args.push("--no-chrome");
-        if (this.opts.continue)
+        if (this.opts.continue || params.options?.continueSession)
             args.push("--continue");
         if (this.opts.debug === true) {
             args.push("--debug");
@@ -445,9 +445,27 @@ export class ClaudeCodeAgent extends BaseCliAgent {
             args.push("--verbose");
         if (this.extraArgs?.length)
             args.push(...this.extraArgs);
+        // Durability: inject a PostToolUse hook that calls back into smithers for a
+        // strict Tier 1 snapshot at each file-edit / Bash boundary. Only when the
+        // engine passes a socket path (durability enabled); additive --settings.
+        const durabilitySocket = typeof params.options?.durabilitySocket === "string"
+            ? params.options.durabilitySocket
+            : undefined;
+        if (durabilitySocket) {
+            args.push("--settings", JSON.stringify({
+                hooks: {
+                    PostToolUse: [{
+                        matcher: "Write|Edit|MultiEdit|NotebookEdit|Bash",
+                        hooks: [{ type: "command", command: "smithers snapshot-hook" }],
+                    }],
+                },
+            }));
+        }
         if (params.prompt)
             args.push(params.prompt);
         const accountEnv = {};
+        if (durabilitySocket)
+            accountEnv.SMITHERS_SNAPSHOT_SOCK = durabilitySocket;
         if (this.opts.configDir)
             accountEnv.CLAUDE_CONFIG_DIR = this.opts.configDir;
         if (this.opts.apiKey)

package/src/ForgeAgent.js

@@ -5,6 +5,31 @@ import { randomUUID } from "node:crypto";
 /** @typedef {import("./BaseCliAgent/CliOutputInterpreter.ts").CliOutputInterpreter} CliOutputInterpreter */
 /** @typedef {import("./ForgeAgentOptions.ts").ForgeAgentOptions} ForgeAgentOptions */
 
+/**
+ * @returns {AgentCapabilityRegistry}
+ */
+export function createForgeCapabilityRegistry() {
+    return {
+        version: 1,
+        engine: "forge",
+        runtimeTools: {},
+        mcp: {
+            bootstrap: "unsupported",
+            supportsProjectScope: false,
+            supportsUserScope: false,
+        },
+        skills: {
+            supportsSkills: false,
+            smithersSkillIds: [],
+        },
+        humanInteraction: {
+            supportsUiRequests: false,
+            methods: [],
+        },
+        builtIns: ["default"],
+    };
+}
+
 export class ForgeAgent extends BaseCliAgent {
     opts;
     /** @type {AgentCapabilityRegistry} */
@@ -17,25 +42,7 @@ export class ForgeAgent extends BaseCliAgent {
     constructor(opts = {}) {
         super(opts);
         this.opts = opts;
-        this.capabilities = {
-            version: 1,
-            engine: "forge",
-            runtimeTools: {},
-            mcp: {
-                bootstrap: "unsupported",
-                supportsProjectScope: false,
-                supportsUserScope: false,
-            },
-            skills: {
-                supportsSkills: false,
-                smithersSkillIds: [],
-            },
-            humanInteraction: {
-                supportsUiRequests: false,
-                methods: [],
-            },
-            builtIns: ["default"],
-        };
+        this.capabilities = createForgeCapabilityRegistry();
     }
     /**
    * @returns {CliOutputInterpreter}

package/src/HermesAgent.js

@@ -29,7 +29,7 @@ export class HermesAgent extends OpenAIAgent {
       nativeStructuredOutput = false,
       ...rest
     } = opts;
-    if (baseURL === undefined) {
+    if (baseURL === undefined || baseURL.trim() === "") {
       throw new SmithersError(
         "AGENT_CONFIG_INVALID",
         "HermesAgent requires a baseURL (or the HERMES_BASE_URL env var) pointing at the Hermes OpenAI-compatible API, e.g. http://127.0.0.1:5123/v1.",