@mcoda/agents 0.1.13 → 0.1.14

package/README.md

@@ -9,7 +9,7 @@ Agent registry, adapter wiring, and invocation helpers for mcoda.
 ## What it provides
 - AgentService for resolving agents, prompts, capabilities, and secrets.
 - Adapter interfaces (AgentAdapter, InvocationRequest/InvocationResult).
-- Built-in adapters for OpenAI, Codex, Gemini, Ollama, Zhipu, local models, and QA.
+- Built-in adapters for OpenAI, Claude, Codex, Gemini, Ollama, Zhipu, local models, and QA.
 
 ## Example
 ```ts

package/dist/AgentService/AgentService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentService.d.ts","sourceRoot":"","sources":["../../src/AgentService/AgentService.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAW7C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AA4KhG,qBAAa,YAAY;IACX,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,gBAAgB;WAE7B,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAKtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAUhD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAIrE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAInD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAIpD,kBAAkB;YAMlB,kBAAkB;IA6BhC,OAAO,CAAC,kBAAkB;IA+BpB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyCzE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBlD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyB9E,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;YAyC5F,mBAAmB;YAkBnB,uBAAuB;YAwBvB,mBAAmB;CAYlC"}
+{"version":3,"file":"AgentService.d.ts","sourceRoot":"","sources":["../../src/AgentService/AgentService.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAY7C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AA6KhG,qBAAa,YAAY;IACX,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,gBAAgB;WAE7B,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAKtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAUhD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAIrE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAInD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAIpD,kBAAkB;YAMlB,kBAAkB;IA6BhC,OAAO,CAAC,kBAAkB;IA+BpB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA4CzE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBlD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyB9E,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;YAyC5F,mBAAmB;YAkBnB,uBAAuB;YAwBvB,mBAAmB;CAYlC"}

package/dist/AgentService/AgentService.js

@@ -13,13 +13,15 @@ import { OpenAiAdapter } from "../adapters/openai/OpenAiAdapter.js";
 import { OpenAiCliAdapter } from "../adapters/openai/OpenAiCliAdapter.js";
 import { ZhipuApiAdapter } from "../adapters/zhipu/ZhipuApiAdapter.js";
 import { QaAdapter } from "../adapters/qa/QaAdapter.js";
-const CLI_BASED_ADAPTERS = new Set(["codex-cli", "gemini-cli", "openai-cli", "ollama-cli", "codali-cli"]);
+import { ClaudeAdapter } from "../adapters/claude/ClaudeAdapter.js";
+const CLI_BASED_ADAPTERS = new Set(["codex-cli", "gemini-cli", "openai-cli", "ollama-cli", "codali-cli", "claude-cli"]);
 const LOCAL_ADAPTERS = new Set(["local-model"]);
 const SUPPORTED_ADAPTERS = new Set([
     "openai-api",
     "codex-cli",
     "gemini-cli",
     "openai-cli",
+    "claude-cli",
     "zhipu-api",
     "local-model",
     "qa-cli",
@@ -288,6 +290,9 @@ export class AgentService {
         if (adapterType === "openai-cli") {
             return new OpenAiCliAdapter(configWithAdapter);
         }
+        if (adapterType === "claude-cli") {
+            return new ClaudeAdapter(configWithAdapter);
+        }
         if (adapterType === "local-model" || LOCAL_ADAPTERS.has(adapterType)) {
             return new LocalAdapter(configWithAdapter);
         }

package/dist/adapters/claude/ClaudeAdapter.d.ts

@@ -0,0 +1,11 @@
+import { AgentHealth } from "@mcoda/shared";
+import { AdapterConfig, AgentAdapter, InvocationRequest, InvocationResult } from "../AdapterTypes.js";
+export declare class ClaudeAdapter implements AgentAdapter {
+    private config;
+    constructor(config: AdapterConfig);
+    getCapabilities(): Promise<string[]>;
+    healthCheck(): Promise<AgentHealth>;
+    invoke(request: InvocationRequest): Promise<InvocationResult>;
+    invokeStream(request: InvocationRequest): AsyncGenerator<InvocationResult, void, unknown>;
+}
+//# sourceMappingURL=ClaudeAdapter.d.ts.map

package/dist/adapters/claude/ClaudeAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude/ClaudeAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtG,qBAAa,aAAc,YAAW,YAAY;IACpC,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEnC,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIpC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAYnC,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkB5D,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAAC,gBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC;CAmBjG"}

package/dist/adapters/claude/ClaudeAdapter.js

@@ -0,0 +1,56 @@
+import { claudeHealthy, runClaudeExec, runClaudeExecStream } from "./ClaudeCliRunner.js";
+export class ClaudeAdapter {
+    constructor(config) {
+        this.config = config;
+    }
+    async getCapabilities() {
+        return this.config.capabilities;
+    }
+    async healthCheck() {
+        const started = Date.now();
+        const health = claudeHealthy();
+        return {
+            agentId: this.config.agent.id,
+            status: health.ok ? "healthy" : "unreachable",
+            lastCheckedAt: new Date().toISOString(),
+            latencyMs: Date.now() - started,
+            details: { adapter: "claude-cli", ...(health.details ?? {}) },
+        };
+    }
+    async invoke(request) {
+        const cliDetails = claudeHealthy(true).details;
+        const result = runClaudeExec(request.input, this.config.model);
+        return {
+            output: result.output,
+            adapter: this.config.adapter ?? "claude-cli",
+            model: this.config.model,
+            metadata: {
+                mode: "cli",
+                capabilities: this.config.capabilities,
+                adapterType: this.config.adapter ?? "claude-cli",
+                authMode: "cli",
+                cli: cliDetails,
+                raw: result.raw,
+            },
+        };
+    }
+    async *invokeStream(request) {
+        const cliDetails = claudeHealthy(true).details;
+        for await (const chunk of runClaudeExecStream(request.input, this.config.model)) {
+            yield {
+                output: chunk.output,
+                adapter: this.config.adapter ?? "claude-cli",
+                model: this.config.model,
+                metadata: {
+                    mode: "cli",
+                    capabilities: this.config.capabilities,
+                    adapterType: this.config.adapter ?? "claude-cli",
+                    authMode: "cli",
+                    cli: cliDetails,
+                    raw: chunk.raw,
+                    streaming: true,
+                },
+            };
+        }
+    }
+}

package/dist/adapters/claude/ClaudeCliRunner.d.ts

@@ -0,0 +1,13 @@
+export declare const claudeHealthy: (throwOnError?: boolean) => {
+    ok: boolean;
+    details?: Record<string, unknown>;
+};
+export declare const runClaudeExec: (prompt: string, model?: string) => {
+    output: string;
+    raw: string;
+};
+export declare function runClaudeExecStream(prompt: string, model?: string): AsyncGenerator<{
+    output: string;
+    raw: string;
+}, void, unknown>;
+//# sourceMappingURL=ClaudeCliRunner.d.ts.map

package/dist/adapters/claude/ClaudeCliRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeCliRunner.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude/ClaudeCliRunner.ts"],"names":[],"mappings":"AAsCA,eAAO,MAAM,aAAa,GAAI,sBAAoB,KAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAuCpG,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,QAAQ,MAAM,KAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAgC3F,CAAC;AAEF,wBAAuB,mBAAmB,CACxC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,cAAc,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAqChE"}

package/dist/adapters/claude/ClaudeCliRunner.js

@@ -0,0 +1,138 @@
+import { spawn, spawnSync } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+const CLAUDE_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
+const CLAUDE_BIN_ENV = "MCODA_CLAUDE_CLI_BIN";
+const CLAUDE_STUB_ENV = "MCODA_CLAUDE_STUB";
+const GLOBAL_STUB_ENV = "MCODA_CLI_STUB";
+const SKIP_CLI_CHECKS_ENV = "MCODA_SKIP_CLI_CHECKS";
+const resolveString = (value) => {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+};
+const candidateBinaries = () => {
+    const override = resolveString(process.env[CLAUDE_BIN_ENV]);
+    if (override)
+        return [override];
+    return ["claude", path.join(os.homedir(), ".local", "bin", "claude")];
+};
+const isStubEnabled = () => {
+    return process.env[CLAUDE_STUB_ENV] === "1" || process.env[GLOBAL_STUB_ENV] === "1";
+};
+const buildArgs = (model) => {
+    const args = ["--print", "--output-format", "text"];
+    if (model)
+        args.push("--model", model);
+    return args;
+};
+const resolveBinaryForRun = (details) => {
+    const explicit = resolveString(details?.binary);
+    if (explicit)
+        return explicit;
+    return candidateBinaries()[0];
+};
+export const claudeHealthy = (throwOnError = false) => {
+    if (isStubEnabled()) {
+        return { ok: true, details: { stub: true } };
+    }
+    if (process.env[SKIP_CLI_CHECKS_ENV] === "1") {
+        return { ok: true, details: { skipped: true, binary: candidateBinaries()[0] } };
+    }
+    let lastFailure;
+    for (const binary of candidateBinaries()) {
+        const result = spawnSync(binary, ["--version"], {
+            encoding: "utf8",
+            maxBuffer: CLAUDE_MAX_BUFFER_BYTES,
+        });
+        if (!result.error && result.status === 0) {
+            return {
+                ok: true,
+                details: {
+                    binary,
+                    version: result.stdout?.toString().trim(),
+                },
+            };
+        }
+        lastFailure = {
+            binary,
+            reason: result.error ? "missing_cli" : "cli_error",
+            exitCode: result.status,
+            stderr: result.stderr?.toString(),
+            error: result.error?.message,
+        };
+    }
+    if (throwOnError) {
+        const reason = String(lastFailure?.reason ?? "missing_cli");
+        const error = new Error(`AUTH_ERROR: claude CLI unavailable (${reason})`);
+        error.details = lastFailure;
+        throw error;
+    }
+    return { ok: false, details: lastFailure };
+};
+export const runClaudeExec = (prompt, model) => {
+    if (isStubEnabled()) {
+        const output = `claude-stub:${prompt}`;
+        return { output, raw: output };
+    }
+    const health = claudeHealthy(true);
+    const binary = resolveBinaryForRun(health.details);
+    const result = spawnSync(binary, buildArgs(model), {
+        input: prompt,
+        encoding: "utf8",
+        maxBuffer: CLAUDE_MAX_BUFFER_BYTES,
+    });
+    const stderr = result.stderr?.toString().trim();
+    const stdout = result.stdout?.toString() ?? "";
+    const diagnostic = stderr || stdout.trim();
+    if (result.error || result.status !== 0) {
+        const details = {
+            reason: "cli_error",
+            binary,
+            exitCode: result.status,
+            stderr,
+            stdout,
+            error: result.error?.message,
+        };
+        const reason = result.error?.message ?? `exit ${result.status}`;
+        const error = new Error(`AUTH_ERROR: claude CLI failed (${reason})${diagnostic ? `: ${diagnostic}` : ""}`);
+        error.details = details;
+        throw error;
+    }
+    return { output: stdout.trim(), raw: stdout };
+};
+export async function* runClaudeExecStream(prompt, model) {
+    if (isStubEnabled()) {
+        const output = `claude-stub:${prompt}\n`;
+        yield { output, raw: output };
+        return;
+    }
+    const health = claudeHealthy(true);
+    const binary = resolveBinaryForRun(health.details);
+    const child = spawn(binary, buildArgs(model), { stdio: ["pipe", "pipe", "pipe"] });
+    child.stdin.write(prompt);
+    child.stdin.end();
+    let stderr = "";
+    child.stderr?.setEncoding("utf8");
+    child.stderr?.on("data", (chunk) => {
+        stderr += chunk.toString();
+    });
+    const closePromise = new Promise((resolve, reject) => {
+        child.on("error", (err) => reject(err));
+        child.on("close", (code) => resolve(code ?? 0));
+    });
+    const stream = child.stdout;
+    stream?.setEncoding("utf8");
+    for await (const chunk of stream ?? []) {
+        if (!chunk)
+            continue;
+        yield { output: chunk, raw: chunk };
+    }
+    const exitCode = await closePromise;
+    if (exitCode !== 0) {
+        const error = new Error(`AUTH_ERROR: claude CLI failed (exit ${exitCode}): ${stderr || "no output"}`);
+        error.details = { reason: "cli_error", binary, exitCode, stderr };
+        throw error;
+    }
+}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from "./AgentService/AgentService.js";
 export * from "./adapters/AdapterTypes.js";
 export * from "./adapters/openai/OpenAiAdapter.js";
 export * from "./adapters/openai/OpenAiCliAdapter.js";
+export * from "./adapters/claude/ClaudeAdapter.js";
 export * from "./adapters/codex/CodexAdapter.js";
 export * from "./adapters/gemini/GeminiAdapter.js";
 export * from "./adapters/local/LocalAdapter.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAClE,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAClE,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -2,6 +2,7 @@ export * from "./AgentService/AgentService.js";
 export * from "./adapters/AdapterTypes.js";
 export * from "./adapters/openai/OpenAiAdapter.js";
 export * from "./adapters/openai/OpenAiCliAdapter.js";
+export * from "./adapters/claude/ClaudeAdapter.js";
 export * from "./adapters/codex/CodexAdapter.js";
 export * from "./adapters/gemini/GeminiAdapter.js";
 export * from "./adapters/local/LocalAdapter.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcoda/agents",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "Agent registry and capabilities for mcoda.",
   "type": "module",
   "main": "dist/index.js",
@@ -30,8 +30,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@mcoda/shared": "0.1.13",
-    "@mcoda/db": "0.1.13"
+    "@mcoda/shared": "0.1.14",
+    "@mcoda/db": "0.1.14"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",