@agentfield/sdk 0.1.140 → 0.1.141-rc.2

package/dist/index.js

@@ -1,9 +1,9 @@
+import fs2, { promises, readFileSync } from 'fs';
+import * as path5 from 'path';
+import path5__default, { resolve, dirname } from 'path';
 import { spawn } from 'child_process';
 import os, { constants } from 'os';
 import { createRequire } from 'module';
-import * as path4 from 'path';
-import path4__default, { resolve, dirname } from 'path';
-import fs, { promises, readFileSync } from 'fs';
 import express from 'express';
 import rateLimit from 'express-rate-limit';
 import crypto2, { randomUUID, createHash } from 'crypto';
@@ -150,6 +150,244 @@ var init_openrouterAttribution = __esm({
   }
 });
 
+// src/harness/availability.ts
+var availability_exports = {};
+__export(availability_exports, {
+  HarnessProviderUnavailable: () => HarnessProviderUnavailable,
+  SUPPORTED_PROVIDER_NAMES: () => SUPPORTED_PROVIDER_NAMES,
+  ensureCliAvailable: () => ensureCliAvailable,
+  findExecutable: () => findExecutable,
+  harnessDoctor: () => harnessDoctor,
+  providerUnavailable: () => providerUnavailable
+});
+function executableExtensions(binary, env) {
+  if (process.platform !== "win32" || path5__default.extname(binary)) {
+    return [""];
+  }
+  const pathExt = env.PATHEXT ?? env.PathExt ?? ".COM;.EXE;.BAT;.CMD";
+  return pathExt.split(";").filter(Boolean).map((extension) => extension.toLowerCase());
+}
+function isExecutableFile(candidate) {
+  try {
+    if (!fs2.statSync(candidate).isFile()) {
+      return false;
+    }
+    fs2.accessSync(candidate, process.platform === "win32" ? fs2.constants.F_OK : fs2.constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function findExecutable(binary, env = process.env) {
+  const extensions = executableExtensions(binary, env);
+  const hasPath = path5__default.isAbsolute(binary) || binary.includes("/") || binary.includes("\\");
+  const directories = hasPath ? [""] : (env.PATH ?? env.Path ?? env.path ?? "").split(path5__default.delimiter).filter(Boolean);
+  for (const directory of directories) {
+    for (const extension of extensions) {
+      const candidate = `${hasPath ? binary : path5__default.join(directory, binary)}${extension}`;
+      if (isExecutableFile(candidate)) {
+        return path5__default.resolve(candidate);
+      }
+    }
+  }
+  return void 0;
+}
+function ensureCliAvailable(provider, binary, resolveBinary = findExecutable, env = process.env) {
+  const resolved = resolveBinary(binary, env);
+  if (resolved) {
+    return resolved;
+  }
+  throw providerUnavailable(provider, binary);
+}
+function providerUnavailable(provider, binary) {
+  const spec = PROVIDER_SPECS[provider];
+  return new HarnessProviderUnavailable(provider, {
+    binary,
+    installCommand: spec?.installCommand ?? "install the configured harness provider binary"
+  });
+}
+function isWindowsBatchFile(command) {
+  return process.platform === "win32" && WINDOWS_BATCH_EXTENSIONS.has(path5__default.extname(command).toLowerCase());
+}
+function quoteCmdToken(value) {
+  return `"${value.replace(/"/g, '""')}"`;
+}
+async function defaultVersionProbe(command) {
+  const { execFile } = await import('child_process');
+  return new Promise((resolve3, reject) => {
+    const batch = isWindowsBatchFile(command[0]);
+    const file = batch ? process.env.ComSpec ?? "cmd.exe" : command[0];
+    const args = batch ? ["/d", "/s", "/c", `"${command.map(quoteCmdToken).join(" ")}"`] : command.slice(1);
+    execFile(
+      file,
+      args,
+      { timeout: 2e3, windowsHide: true, windowsVerbatimArguments: batch },
+      (error, stdout, stderr) => {
+        if (error) {
+          reject(error);
+          return;
+        }
+        const output = String(stdout || stderr).trim();
+        resolve3(output ? output.split(/\r?\n/, 1)[0] : "unknown");
+      }
+    );
+  });
+}
+async function defaultWrapperProbe() {
+  try {
+    await import('@anthropic-ai/claude-agent-sdk');
+    return true;
+  } catch {
+    return false;
+  }
+}
+function authStatus(spec, env) {
+  return spec.authEnvVars.some((name) => Boolean(env[name])) ? "configured" : "unknown";
+}
+async function harnessDoctor(providers, options = {}) {
+  const selected = providers && providers.length > 0 ? [...providers] : [...SUPPORTED_PROVIDER_NAMES];
+  const unknown = selected.filter((provider) => !(provider in PROVIDER_SPECS)).sort();
+  if (unknown.length > 0) {
+    throw new Error(
+      `Unknown harness provider: "${unknown[0]}". Supported providers: ${SUPPORTED_PROVIDER_NAMES.join(", ")}`
+    );
+  }
+  const env = options.env ?? process.env;
+  const resolveBinary = options.resolveBinary ?? findExecutable;
+  const versionProbe = options.versionProbe ?? defaultVersionProbe;
+  const wrapperProbe = options.wrapperProbe ?? defaultWrapperProbe;
+  const reports = [];
+  for (const providerValue of selected) {
+    const provider = providerValue;
+    const spec = PROVIDER_SPECS[provider];
+    if (provider === "claude-code") {
+      const installed = await wrapperProbe(provider);
+      reports.push({
+        provider,
+        binary: null,
+        installed,
+        version: null,
+        auth: authStatus(spec, env),
+        usable: installed,
+        installCommand: spec.installCommand,
+        authEnvVars: [...spec.authEnvVars],
+        issues: installed ? [] : ["wrapper_not_installed"]
+      });
+      continue;
+    }
+    const binaryName = spec.binary;
+    const binary = resolveBinary(binaryName, env) ?? null;
+    const issues = [];
+    let version = null;
+    if (binary === null) {
+      issues.push("binary_not_found");
+    } else {
+      try {
+        const output = (await versionProbe([binary, ...spec.versionArgs])).trim();
+        version = output ? output.split(/\r?\n/, 1)[0] : "unknown";
+      } catch {
+        issues.push("version_probe_failed");
+      }
+    }
+    reports.push({
+      provider,
+      binary,
+      installed: binary !== null,
+      version,
+      auth: authStatus(spec, env),
+      usable: binary !== null && issues.length === 0,
+      installCommand: spec.installCommand,
+      authEnvVars: [...spec.authEnvVars],
+      issues
+    });
+  }
+  return reports;
+}
+var PROVIDER_SPECS, SUPPORTED_PROVIDER_NAMES, HarnessProviderUnavailable, WINDOWS_BATCH_EXTENSIONS;
+var init_availability = __esm({
+  "src/harness/availability.ts"() {
+    PROVIDER_SPECS = {
+      aforge: {
+        binary: "aforge",
+        versionArgs: ["version"],
+        installCommand: "af aforge ensure",
+        authEnvVars: ["OPENROUTER_API_KEY"]
+      },
+      "claude-code": {
+        binary: null,
+        versionArgs: [],
+        installCommand: "npm install @anthropic-ai/claude-agent-sdk",
+        authEnvVars: ["ANTHROPIC_API_KEY"]
+      },
+      codex: {
+        binary: "codex",
+        versionArgs: ["--version"],
+        installCommand: "npm install -g @openai/codex",
+        authEnvVars: ["OPENAI_API_KEY"]
+      },
+      gemini: {
+        binary: "gemini",
+        versionArgs: ["--version"],
+        installCommand: "npm install -g @google/gemini-cli",
+        authEnvVars: ["GEMINI_API_KEY", "GOOGLE_API_KEY"]
+      },
+      omp: {
+        binary: "omp",
+        versionArgs: ["--version"],
+        installCommand: "curl -fsSL https://omp.sh/install | sh",
+        authEnvVars: [
+          "OPENROUTER_API_KEY",
+          "ANTHROPIC_API_KEY",
+          "OPENAI_API_KEY",
+          "GEMINI_API_KEY",
+          "GOOGLE_API_KEY"
+        ]
+      },
+      opencode: {
+        binary: "opencode",
+        versionArgs: ["--version"],
+        installCommand: "curl -fsSL https://opencode.ai/install | bash",
+        authEnvVars: []
+      },
+      pi: {
+        binary: "pi",
+        versionArgs: ["--version"],
+        installCommand: "npm install -g --ignore-scripts @earendil-works/pi-coding-agent",
+        authEnvVars: [
+          "OPENROUTER_API_KEY",
+          "ANTHROPIC_API_KEY",
+          "OPENAI_API_KEY",
+          "GEMINI_API_KEY",
+          "GOOGLE_API_KEY"
+        ]
+      }
+    };
+    SUPPORTED_PROVIDER_NAMES = Object.freeze(
+      Object.keys(PROVIDER_SPECS).sort()
+    );
+    HarnessProviderUnavailable = class extends Error {
+      provider;
+      binary;
+      installCommand;
+      missingAuthEnv;
+      constructor(provider, options) {
+        const missingAuthEnv = [...options.missingAuthEnv ?? []];
+        let message = `Harness provider '${provider}' is unavailable: binary '${options.binary}' was not found. Install it with: ${options.installCommand}`;
+        if (missingAuthEnv.length > 0) {
+          message += `. Configure one of: ${missingAuthEnv.join(", ")}`;
+        }
+        super(message);
+        this.name = "HarnessProviderUnavailable";
+        this.provider = provider;
+        this.binary = options.binary;
+        this.installCommand = options.installCommand;
+        this.missingAuthEnv = missingAuthEnv;
+      }
+    };
+    WINDOWS_BATCH_EXTENSIONS = /* @__PURE__ */ new Set([".bat", ".cmd"]);
+  }
+});
+
 // src/harness/providers/base.ts
 function resolveRoot(options) {
   for (const value of [options.projectDir, options.project_dir, options.cwd]) {
@@ -189,6 +427,10 @@ var init_types = __esm({
   "src/harness/types.ts"() {
   }
 });
+function markProviderCommand(provider, command) {
+  providerCommands.set(command, provider);
+  return command;
+}
 function resolveIdleMs(idleSeconds) {
   let seconds = idleSeconds;
   if (seconds === void 0) {
@@ -198,17 +440,21 @@ function resolveIdleMs(idleSeconds) {
   }
   return seconds > 0 ? seconds * 1e3 : void 0;
 }
-function runCli(cmd, options) {
+async function runCli(cmd, options) {
+  const [bin, ...args] = cmd;
+  const parsedParentDepth = Number.parseInt(process.env.AGENTFIELD_HARNESS_DEPTH ?? "", 10);
+  const parentDepth = Number.isFinite(parsedParentDepth) && parsedParentDepth >= 0 ? parsedParentDepth : 0;
+  const env = {
+    ...process.env,
+    AGENTFIELD_HARNESS_DEPTH: String(parentDepth + 1),
+    ...options?.env
+  };
+  applyOpenRouterAttributionEnv(env);
+  const provider = providerCommands.get(cmd);
+  if (provider) {
+    ensureCliAvailable(provider, bin, void 0, env);
+  }
   return new Promise((resolve3, reject) => {
-    const [bin, ...args] = cmd;
-    const parsedParentDepth = Number.parseInt(process.env.AGENTFIELD_HARNESS_DEPTH ?? "", 10);
-    const parentDepth = Number.isFinite(parsedParentDepth) && parsedParentDepth >= 0 ? parsedParentDepth : 0;
-    const env = {
-      ...process.env,
-      AGENTFIELD_HARNESS_DEPTH: String(parentDepth + 1),
-      ...options?.env
-    };
-    applyOpenRouterAttributionEnv(env);
     const hasInput = options?.inputText !== void 0;
     const proc = spawn(bin, args, {
       env,
@@ -327,11 +573,13 @@ function extractFinalText(events) {
   }
   return result;
 }
-var DEFAULT_IDLE_SECONDS;
+var DEFAULT_IDLE_SECONDS, providerCommands;
 var init_cli = __esm({
   "src/harness/cli.ts"() {
     init_openrouterAttribution();
+    init_availability();
     DEFAULT_IDLE_SECONDS = 120;
+    providerCommands = /* @__PURE__ */ new WeakMap();
   }
 });
 
@@ -443,6 +691,7 @@ var init_aforge = __esm({
     init_base();
     init_types();
     init_cli();
+    init_availability();
     init_modelVariant();
     REASONING_VARIANTS = /* @__PURE__ */ new Set(["off", "low", "medium", "high"]);
     DEFAULT_TIMEOUT_SECONDS = 1800;
@@ -550,7 +799,7 @@ var init_aforge = __esm({
         const effectiveModel = model || env.AFORGE_MODEL || AFORGE_DEFAULT_MODEL;
         const startApi = Date.now();
         try {
-          const { stdout, stderr, exitCode } = await runCli(cmd, {
+          const { stdout, stderr, exitCode } = await runCli(markProviderCommand("aforge", cmd), {
             env,
             cwd: void 0,
             timeout: outerTimeout * 1e3,
@@ -593,14 +842,12 @@ var init_aforge = __esm({
             returnCode: exitCode
           });
         } catch (error) {
+          if (error instanceof HarnessProviderUnavailable) {
+            throw error;
+          }
           const message = error instanceof Error ? error.message : String(error);
           if (message.includes("ENOENT")) {
-            return createRawResult({
-              isError: true,
-              errorMessage: `AForge binary not found at '${this.bin}'. Install it with \`af aforge ensure\`, or set AFORGE_BIN to its path.`,
-              failureType: "crash",
-              metrics: createMetrics({ durationApiMs: Date.now() - startApi })
-            });
+            throw providerUnavailable("aforge", this.bin);
           }
           const timedOut = /timed out|deadline exceeded|no progress/i.test(message);
           return createRawResult({
@@ -637,6 +884,7 @@ var init_claude = __esm({
     init_base();
     init_types();
     init_modelVariant();
+    init_availability();
     ClaudeCodeProvider = class {
       async execute(prompt, options) {
         let sdk;
@@ -644,9 +892,10 @@ var init_claude = __esm({
           const mod = await import('@anthropic-ai/claude-agent-sdk');
           sdk = mod;
         } catch {
-          throw new Error(
-            "@anthropic-ai/claude-agent-sdk is required for the 'claude-code' provider. Install it with: npm install @anthropic-ai/claude-agent-sdk"
-          );
+          throw new HarnessProviderUnavailable("claude-code", {
+            binary: "@anthropic-ai/claude-agent-sdk",
+            installCommand: "npm install @anthropic-ai/claude-agent-sdk"
+          });
         }
         const agentOptions = {};
         const { model: modelValue } = resolveModelAndVariant(options);
@@ -766,6 +1015,7 @@ var init_codex = __esm({
     init_base();
     init_types();
     init_cli();
+    init_availability();
     init_modelVariant();
     CodexProvider = class {
       bin;
@@ -791,7 +1041,7 @@ var init_codex = __esm({
         cmd.push(prompt);
         const startApi = Date.now();
         try {
-          const { stdout, stderr, exitCode } = await runCli(cmd, {
+          const { stdout, stderr, exitCode } = await runCli(markProviderCommand("codex", cmd), {
             env: options.env,
             cwd: root
           });
@@ -819,13 +1069,12 @@ var init_codex = __esm({
             errorMessage: isError ? stderr.trim() : void 0
           });
         } catch (err) {
+          if (err instanceof HarnessProviderUnavailable) {
+            throw err;
+          }
           const msg = err instanceof Error ? err.message : String(err);
           if (msg.includes("ENOENT")) {
-            return createRawResult({
-              isError: true,
-              errorMessage: `Codex binary not found at '${this.bin}'. Install: https://github.com/openai/codex`,
-              metrics: createMetrics({ durationApiMs: Date.now() - startApi })
-            });
+            throw providerUnavailable("codex", this.bin);
           }
           return createRawResult({
             isError: true,
@@ -849,6 +1098,7 @@ var init_gemini = __esm({
     init_base();
     init_types();
     init_cli();
+    init_availability();
     init_modelVariant();
     GeminiProvider = class {
       bin;
@@ -869,7 +1119,7 @@ var init_gemini = __esm({
         cmd.push("-p", prompt);
         const startApi = Date.now();
         try {
-          const { stdout, stderr, exitCode } = await runCli(cmd, {
+          const { stdout, stderr, exitCode } = await runCli(markProviderCommand("gemini", cmd), {
             env: options.env,
             cwd: resolveRoot(options)
           });
@@ -887,13 +1137,12 @@ var init_gemini = __esm({
             errorMessage: isError ? stderr.trim() : void 0
           });
         } catch (err) {
+          if (err instanceof HarnessProviderUnavailable) {
+            throw err;
+          }
           const msg = err instanceof Error ? err.message : String(err);
           if (msg.includes("ENOENT")) {
-            return createRawResult({
-              isError: true,
-              errorMessage: `Gemini binary not found at '${this.bin}'. Install: https://github.com/google-gemini/gemini-cli`,
-              metrics: createMetrics({ durationApiMs: Date.now() - startApi })
-            });
+            throw providerUnavailable("gemini", this.bin);
           }
           return createRawResult({
             isError: true,
@@ -1081,6 +1330,7 @@ var init_opencode = __esm({
     init_base();
     init_types();
     init_cli();
+    init_availability();
     init_modelVariant();
     init_openrouterAttribution();
     ANSI_PATTERN2 = /\x1B\[[0-?]*[ -/]*[@-~]/g;
@@ -1144,7 +1394,7 @@ var init_opencode = __esm({
         cmd.push(effectivePrompt);
         const startApi = Date.now();
         try {
-          const { stdout, stderr, exitCode } = await runCli(cmd, { env });
+          const { stdout, stderr, exitCode } = await runCli(markProviderCommand("opencode", cmd), { env });
           const resultText = stdout.trim() || void 0;
           const cleanStderr = stderr.trim().replace(ANSI_PATTERN2, "");
           let isError = false;
@@ -1173,13 +1423,12 @@ var init_opencode = __esm({
             failureType: isError ? "crash" : "none"
           });
         } catch (err) {
+          if (err instanceof HarnessProviderUnavailable) {
+            throw err;
+          }
           const msg = err instanceof Error ? err.message : String(err);
           if (msg.includes("ENOENT")) {
-            return createRawResult({
-              isError: true,
-              errorMessage: `OpenCode binary not found at '${this.bin}'. Install: https://github.com/opencode-ai/opencode`,
-              metrics: createMetrics({ durationApiMs: Date.now() - startApi })
-            });
+            throw providerUnavailable("opencode", this.bin);
           }
           return createRawResult({
             isError: true,
@@ -1302,6 +1551,7 @@ var init_pi = __esm({
     init_base();
     init_types();
     init_cli();
+    init_availability();
     init_modelVariant();
     READ_ONLY_TOOLS = /* @__PURE__ */ new Set(["read", "grep", "find", "glob", "ls", "lsp"]);
     ANSI_PATTERN3 = /\x1B\[[0-?]*[ -/]*[@-~]/g;
@@ -1354,7 +1604,7 @@ var init_pi = __esm({
         const env = { ...options.env };
         const startApi = Date.now();
         try {
-          const { stdout, stderr, exitCode } = await runCli(cmd, {
+          const { stdout, stderr, exitCode } = await runCli(markProviderCommand(this.flavor, cmd), {
             env,
             cwd: root,
             inputText: prompt,
@@ -1391,11 +1641,17 @@ var init_pi = __esm({
             returnCode: exitCode
           });
         } catch (error) {
+          if (error instanceof HarnessProviderUnavailable) {
+            throw error;
+          }
           const message = error instanceof Error ? error.message : String(error);
           const binaryMissing = message.includes("ENOENT");
+          if (binaryMissing) {
+            throw providerUnavailable(this.flavor, this.bin);
+          }
           return createRawResult({
             isError: true,
-            errorMessage: binaryMissing ? `${this.flavor === "omp" ? "OMP" : "Pi"} binary not found at '${this.bin}'. ${this.flavor === "omp" ? "Install: curl -fsSL https://omp.sh/install | sh" : "Install: npm install -g --ignore-scripts @earendil-works/pi-coding-agent"}` : message,
+            errorMessage: message,
             failureType: /timed out|deadline exceeded|no progress/i.test(message) ? "timeout" : "crash",
             metrics: createMetrics({ durationApiMs: Date.now() - startApi })
           });
@@ -1464,15 +1720,8 @@ async function buildProvider(config) {
 var SUPPORTED_PROVIDERS, DEFAULT_HARNESS_PROVIDER, HARNESS_PROVIDER_ENV_VAR;
 var init_factory = __esm({
   "src/harness/providers/factory.ts"() {
-    SUPPORTED_PROVIDERS = /* @__PURE__ */ new Set([
-      "aforge",
-      "claude-code",
-      "codex",
-      "gemini",
-      "omp",
-      "opencode",
-      "pi"
-    ]);
+    init_availability();
+    SUPPORTED_PROVIDERS = new Set(SUPPORTED_PROVIDER_NAMES);
     DEFAULT_HARNESS_PROVIDER = "aforge";
     HARNESS_PROVIDER_ENV_VAR = "AGENTFIELD_HARNESS_PROVIDER";
   }
@@ -1492,7 +1741,7 @@ function getZod4Converter() {
   }
   const requires = [];
   try {
-    requires.push(createRequire(path4__default.join(process.cwd(), "package.json")));
+    requires.push(createRequire(path5__default.join(process.cwd(), "package.json")));
   } catch {
   }
   requires.push(createRequire(import.meta.url));
@@ -1552,12 +1801,12 @@ function estimateTokens(text2) {
 }
 function writeSchemaFile(schemaJson, cwd) {
   const filePath = getSchemaPath(cwd);
-  fs.mkdirSync(path4__default.dirname(filePath), { recursive: true });
-  const fd = fs.openSync(filePath, "w", 384);
+  fs2.mkdirSync(path5__default.dirname(filePath), { recursive: true });
+  const fd = fs2.openSync(filePath, "w", 384);
   try {
-    fs.writeFileSync(fd, schemaJson, "utf8");
+    fs2.writeFileSync(fd, schemaJson, "utf8");
   } finally {
-    fs.closeSync(fd);
+    fs2.closeSync(fd);
   }
   return filePath;
 }
@@ -1568,10 +1817,10 @@ function validateAgainstSchema(data, schema) {
   return data;
 }
 function getOutputPath(cwd) {
-  return path4__default.join(cwd, OUTPUT_FILENAME);
+  return path5__default.join(cwd, OUTPUT_FILENAME);
 }
 function getSchemaPath(cwd) {
-  return path4__default.join(cwd, SCHEMA_FILENAME);
+  return path5__default.join(cwd, SCHEMA_FILENAME);
 }
 function schemaToJsonSchema(schema) {
   if (isZod4Schema(schema)) {
@@ -1641,7 +1890,7 @@ function cosmeticRepair(raw) {
 }
 function readAndParse(filePath) {
   try {
-    const content = fs.readFileSync(filePath, "utf8");
+    const content = fs2.readFileSync(filePath, "utf8");
     if (content.trim().length === 0) {
       return null;
     }
@@ -1652,7 +1901,7 @@ function readAndParse(filePath) {
 }
 function readRepairAndParse(filePath) {
   try {
-    const content = fs.readFileSync(filePath, "utf8");
+    const content = fs2.readFileSync(filePath, "utf8");
     if (content.trim().length === 0) {
       return null;
     }
@@ -1682,7 +1931,7 @@ function parseAndValidate(filePath, schema) {
 function cleanupTempFiles(cwd) {
   for (const filename of [OUTPUT_FILENAME, SCHEMA_FILENAME]) {
     try {
-      fs.unlinkSync(path4__default.join(cwd, filename));
+      fs2.unlinkSync(path5__default.join(cwd, filename));
     } catch {
     }
   }
@@ -1742,8 +1991,8 @@ var init_runner = __esm({
         const outputRoot = resolveRoot(resolved) ?? ".";
         let outputDir;
         if (schema !== void 0) {
-          fs.mkdirSync(outputRoot, { recursive: true });
-          outputDir = fs.mkdtempSync(path4__default.join(outputRoot, ".agentfield-out-"));
+          fs2.mkdirSync(outputRoot, { recursive: true });
+          outputDir = fs2.mkdtempSync(path5__default.join(outputRoot, ".agentfield-out-"));
         }
         const effectivePrompt = schema === void 0 ? prompt : `${prompt}${buildPromptSuffix(schema, outputDir)}`;
         const startTime = Date.now();
@@ -1768,7 +2017,7 @@ var init_runner = __esm({
         } finally {
           if (schema !== void 0) {
             cleanupTempFiles(outputDir);
-            fs.rmSync(outputDir, { recursive: true, force: true });
+            fs2.rmSync(outputDir, { recursive: true, force: true });
           }
         }
       }
@@ -6523,6 +6772,10 @@ var Agent = class {
     this.recordHarnessUsage(result, options);
     return result;
   }
+  async harnessDoctor(providers) {
+    const { harnessDoctor: harnessDoctor2 } = await Promise.resolve().then(() => (init_availability(), availability_exports));
+    return harnessDoctor2(providers);
+  }
   /**
    * Record a harness run's token/cost usage into the current execution's
    * tracker. Mirrors the Python SDK's `_record_harness_usage`: a no-op when
@@ -7137,22 +7390,22 @@ var Agent = class {
         },
         message: { error: "rate_limit_exceeded", message: "Too many authentication attempts. Try again later." },
         skip: (req) => {
-          const path5 = req.path;
-          if (!path5.startsWith("/reasoners/") && !path5.startsWith("/skills/") && !path5.startsWith("/execute") && !path5.startsWith("/api/v1/reasoners/") && !path5.startsWith("/api/v1/skills/")) {
+          const path6 = req.path;
+          if (!path6.startsWith("/reasoners/") && !path6.startsWith("/skills/") && !path6.startsWith("/execute") && !path6.startsWith("/api/v1/reasoners/") && !path6.startsWith("/api/v1/skills/")) {
             return true;
           }
-          const parts = path5.replace(/^\/+/, "").split("/");
+          const parts = path6.replace(/^\/+/, "").split("/");
           const funcName = parts[parts.length - 1] ?? "";
           return realtimeFunctions.has(funcName);
         }
       });
       this.app.use(authRateLimiter);
       this.app.use(async (req, res, next) => {
-        const path5 = req.path;
-        if (!path5.startsWith("/reasoners/") && !path5.startsWith("/skills/") && !path5.startsWith("/execute") && !path5.startsWith("/api/v1/reasoners/") && !path5.startsWith("/api/v1/skills/")) {
+        const path6 = req.path;
+        if (!path6.startsWith("/reasoners/") && !path6.startsWith("/skills/") && !path6.startsWith("/execute") && !path6.startsWith("/api/v1/reasoners/") && !path6.startsWith("/api/v1/skills/")) {
           return next();
         }
-        const parts = path5.replace(/^\/+/, "").split("/");
+        const parts = path6.replace(/^\/+/, "").split("/");
         const funcName = parts[parts.length - 1] ?? "";
         if (realtimeFunctions.has(funcName)) {
           return next();
@@ -7366,9 +7619,9 @@ var Agent = class {
     return handler(req, res);
   }
   async handleServerlessEvent(event) {
-    const path5 = event?.path ?? event?.rawPath ?? "";
+    const path6 = event?.path ?? event?.rawPath ?? "";
     const action = event?.action ?? "";
-    if (path5 === "/discover" || action === "discover") {
+    if (path6 === "/discover" || action === "discover") {
       return {
         statusCode: 200,
         headers: { "content-type": "application/json" },
@@ -7377,7 +7630,7 @@ var Agent = class {
     }
     const body = this.normalizeEventBody(event);
     const invocation = this.extractInvocationDetails({
-      path: path5,
+      path: path6,
       query: event?.queryStringParameters,
       body,
       reasoner: event?.reasoner,
@@ -7456,9 +7709,9 @@ var Agent = class {
     const input = this.normalizeInputPayload(params.body);
     return { name: name ?? void 0, targetType: typeValue, input };
   }
-  parsePathTarget(path5) {
-    if (!path5) return {};
-    const normalized = path5.split("?")[0];
+  parsePathTarget(path6) {
+    if (!path6) return {};
+    const normalized = path6.split("?")[0];
     const reasonerMatch = normalized.match(/\/reasoners\/([^/]+)/);
     if (reasonerMatch?.[1]) {
       return { name: reasonerMatch[1], targetType: "reasoner" };
@@ -8352,7 +8605,7 @@ var MultimodalResponse = class {
    */
   async saveImage(image, imagePath) {
     const bytes = await this.getImageBytes(image);
-    await promises.mkdir(path4.dirname(imagePath), { recursive: true });
+    await promises.mkdir(path5.dirname(imagePath), { recursive: true });
     await promises.writeFile(imagePath, bytes);
   }
   /**
@@ -8360,7 +8613,7 @@ var MultimodalResponse = class {
    */
   async saveAudio(audio, audioPath) {
     const bytes = await this.getAudioBytes(audio);
-    await promises.mkdir(path4.dirname(audioPath), { recursive: true });
+    await promises.mkdir(path5.dirname(audioPath), { recursive: true });
     await promises.writeFile(audioPath, bytes);
   }
   /**
@@ -8368,7 +8621,7 @@ var MultimodalResponse = class {
    */
   async saveFile(file, filePath) {
     const bytes = await this.getFileBytes(file);
-    await promises.mkdir(path4.dirname(filePath), { recursive: true });
+    await promises.mkdir(path5.dirname(filePath), { recursive: true });
     await promises.writeFile(filePath, bytes);
   }
   /**
@@ -8379,7 +8632,7 @@ var MultimodalResponse = class {
     const savedFiles = {};
     await promises.mkdir(outputDir, { recursive: true });
     if (this._audio) {
-      const audioPath = path4.join(outputDir, `${prefix}_audio.${this._audio.format}`);
+      const audioPath = path5.join(outputDir, `${prefix}_audio.${this._audio.format}`);
       await this.saveAudio(this._audio, audioPath);
       savedFiles["audio"] = audioPath;
     }
@@ -8387,22 +8640,22 @@ var MultimodalResponse = class {
       const image = this._images[i];
       let ext = "png";
       if (image.url) {
-        const urlExt = path4.extname(image.url).slice(1);
+        const urlExt = path5.extname(image.url).slice(1);
         if (urlExt) ext = urlExt;
       }
-      const imagePath = path4.join(outputDir, `${prefix}_image_${i}.${ext}`);
+      const imagePath = path5.join(outputDir, `${prefix}_image_${i}.${ext}`);
       await this.saveImage(image, imagePath);
       savedFiles[`image_${i}`] = imagePath;
     }
     for (let i = 0; i < this._files.length; i++) {
       const file = this._files[i];
       const filename = file.filename || `${prefix}_file_${i}`;
-      const filePath = path4.join(outputDir, filename);
+      const filePath = path5.join(outputDir, filename);
       await this.saveFile(file, filePath);
       savedFiles[`file_${i}`] = filePath;
     }
     if (this._text) {
-      const textPath = path4.join(outputDir, `${prefix}_text.txt`);
+      const textPath = path5.join(outputDir, `${prefix}_text.txt`);
       await promises.writeFile(textPath, this._text, "utf-8");
       savedFiles["text"] = textPath;
     }
@@ -9175,6 +9428,7 @@ function sleep3(ms) {
 
 // src/harness/index.ts
 init_types();
+init_availability();
 init_modelVariant();
 init_factory();
 init_runner();
@@ -9227,6 +9481,6 @@ function loadFixture(source) {
   );
 }
 
-export { ACTIVE_STATUSES, AIClient, Agent, AgentRouter, ApprovalClient, ApprovalResult, Audio, CANONICAL_STATUSES, CostTracker, DEFAULT_HARNESS_PROVIDER, DIDAuthenticator, DidClient, DidInterface, DidManager, ExecutionContext, ExecutionLogger, ExecutionStatus, File, HARNESS_PROVIDER_ENV_VAR, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, HarnessRunner, Image, JWE_ALG, JWE_ENC, KEY_AGREEMENT_TYPE, MODEL_VARIANT_SEP, MediaProviderError, MediaRouter, MemoryClient, MemoryClientBase, MemoryEventClient, MemoryInterface, MultimodalResponse, OpenRouterMediaProvider, PauseClock, PauseManager, PayloadEncryptionError, RateLimitError, RealtimeSession, ReasonerContext, SUPPORTED_PROVIDERS, SUPPORTED_SESSION_TRANSPORTS, SessionTransportError, SkillContext, StatelessRateLimiter, TERMINAL_STATUSES, Text, USAGE_ENVELOPE_KEY, Video, WorkflowReporter, applyTriggerTransform, attachUsageToSyncResult, audioFromBase64, audioFromBuffer, audioFromFile, audioFromUrl, audioMediaType, buildProvider, buildSessionDefinition, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createExecutionLogger, createHarnessResult, createMetrics, createMultimodalResponse, createRawResult, decrypt, decryptToString, deriveProvider, encryptForDid, encryptToJwk, eventTrigger, executeToolCallLoop, extractKeyAgreementJwk, fileFromBase64, fileFromBuffer, fileFromPath, fileFromUrl, generateX25519KeyPair, getCurrentContext, getCurrentSkillContext, guessUrlMimeType, imageFromBase64, imageFromBuffer, imageFromFile, imageFromUrl, installApprovalWebhookRoute, isActive, isExecutionLogBatchPayload, isTerminal, isTriggerEnvelope, loadFixture, normalizeExecutionLogEntry, normalizeSessionTransportValue, normalizeStatus, normalizeTurnDetection, resolveModelAndVariant, resolveProviderName, scheduleTrigger, serializeExecutionLogEntry, simulateSchedule, simulateTrigger, splitModelVariant, text, triggerToPayload, unwrapEnvelope, usageSummaryOrNull, validateSessionTransport, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };
+export { ACTIVE_STATUSES, AIClient, Agent, AgentRouter, ApprovalClient, ApprovalResult, Audio, CANONICAL_STATUSES, CostTracker, DEFAULT_HARNESS_PROVIDER, DIDAuthenticator, DidClient, DidInterface, DidManager, ExecutionContext, ExecutionLogger, ExecutionStatus, File, HARNESS_PROVIDER_ENV_VAR, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, HarnessProviderUnavailable, HarnessRunner, Image, JWE_ALG, JWE_ENC, KEY_AGREEMENT_TYPE, MODEL_VARIANT_SEP, MediaProviderError, MediaRouter, MemoryClient, MemoryClientBase, MemoryEventClient, MemoryInterface, MultimodalResponse, OpenRouterMediaProvider, PauseClock, PauseManager, PayloadEncryptionError, RateLimitError, RealtimeSession, ReasonerContext, SUPPORTED_PROVIDERS, SUPPORTED_PROVIDER_NAMES, SUPPORTED_SESSION_TRANSPORTS, SessionTransportError, SkillContext, StatelessRateLimiter, TERMINAL_STATUSES, Text, USAGE_ENVELOPE_KEY, Video, WorkflowReporter, applyTriggerTransform, attachUsageToSyncResult, audioFromBase64, audioFromBuffer, audioFromFile, audioFromUrl, audioMediaType, buildProvider, buildSessionDefinition, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createExecutionLogger, createHarnessResult, createMetrics, createMultimodalResponse, createRawResult, decrypt, decryptToString, deriveProvider, encryptForDid, encryptToJwk, ensureCliAvailable, eventTrigger, executeToolCallLoop, extractKeyAgreementJwk, fileFromBase64, fileFromBuffer, fileFromPath, fileFromUrl, findExecutable, generateX25519KeyPair, getCurrentContext, getCurrentSkillContext, guessUrlMimeType, harnessDoctor, imageFromBase64, imageFromBuffer, imageFromFile, imageFromUrl, installApprovalWebhookRoute, isActive, isExecutionLogBatchPayload, isTerminal, isTriggerEnvelope, loadFixture, normalizeExecutionLogEntry, normalizeSessionTransportValue, normalizeStatus, normalizeTurnDetection, resolveModelAndVariant, resolveProviderName, scheduleTrigger, serializeExecutionLogEntry, simulateSchedule, simulateTrigger, splitModelVariant, text, triggerToPayload, unwrapEnvelope, usageSummaryOrNull, validateSessionTransport, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map