@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/drivers/mcp/actor.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MCP tool-call actor. Catalog is projection only — not an execute door.
+ * Start meant effect: stamp regenerateable, parse args, `client.request`.
+ * Approval is the orchestrator hook — this run does not vote.
+ *
+ * `Client.callTool` validates outputSchema on the client and throws, discarding
+ * content that already arrived. Call via `request` so the payload survives.
+ * Arrival-manifold documents the same footgun.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { ExpectationActor, type PEWDriverConnection } from "@inhuman.tools/plexus-expectations/driver";
+import { ToolCallExpectation } from "../../models/session/index.js";
+export type RawMcpToolResult = {
+    readonly ok: boolean;
+    /** Door text when the call failed. Success carries `value`, not a painted string. */
+    readonly text?: string;
+    readonly raw?: unknown;
+    /** Structured content, a single text block's string, or the content array. */
+    readonly value?: unknown;
+};
+export type McpClientConnection = PEWDriverConnection<ToolCallExpectation> & {
+    readonly client: Client | null;
+    stderrTail(): string;
+};
+export declare class McpToolCallActor extends ExpectationActor<ToolCallExpectation> {
+    readonly driverConnection: McpClientConnection;
+    constructor(expectation: ToolCallExpectation, driverConnection: McpClientConnection);
+    protected run(): Promise<void>;
+}
+export declare function mcpCallResult(res: unknown): RawMcpToolResult;
+//# sourceMappingURL=actor.d.ts.map

package/dist/drivers/mcp/actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../../../src/drivers/mcp/actor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEvG,OAAO,EAAE,mBAAmB,EAAwB,MAAM,+BAA+B,CAAC;AAI1F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,qFAAqF;IACrF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,GAAG;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,IAAI,MAAM,CAAC;CACtB,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,gBAAgB,CAAC,mBAAmB,CAAC;aAGrD,gBAAgB,EAAE,mBAAmB;IAFzD,YACE,WAAW,EAAE,mBAAmB,EACd,gBAAgB,EAAE,mBAAmB,EAGxD;IAED,UAAgB,GAAG,kBAuDlB;CACF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAM5D"}

package/dist/drivers/mcp/actor.js

@@ -0,0 +1,112 @@
+import { CallToolResultSchema } from "@modelcontextprotocol/sdk/types.js";
+import { ExpectationActor } from "@inhuman.tools/plexus-expectations/driver";
+import { parseArgs } from "../toolkit/actor.js";
+import { requireCatalog, sessionCatalog } from "../toolkit/tool-table.js";
+export class McpToolCallActor extends ExpectationActor {
+    driverConnection;
+    constructor(expectation, driverConnection) {
+        super(expectation, driverConnection);
+        this.driverConnection = driverConnection;
+    }
+    async run() {
+        const { toolCallId, name } = this.expectation;
+        this.invariant(toolCallId, "tool_call snapshot missing toolCallId");
+        const catalog = requireCatalog(sessionCatalog(this.expectation.plexus?.root), name);
+        const entry = catalog.catalogEntry(name);
+        this.invariant(entry?.source.kind === "connection", `${name}: not a connection-sourced tool`);
+        // v1: read only — effect includes shell
+        this.expectation.regenerateable = entry.class === "read";
+        if (this.signal.aborted)
+            return;
+        const args = parseArgs(this.expectation.argsJson || "{}");
+        if (args === null) {
+            this.complete({
+                ok: false,
+                text: `${name}: arguments were not valid JSON — ${(this.expectation.argsJson || "").slice(0, 200)}`,
+            });
+            return;
+        }
+        if (this.signal.aborted)
+            return;
+        const client = this.driverConnection.client;
+        this.invariant(client !== null, "mcp connection not loaded");
+        const signal = this.signal;
+        let result;
+        if (signal.aborted) {
+            result = { ok: false, text: "mcp: aborted" };
+        }
+        else {
+            try {
+                const res = await client.request({
+                    method: "tools/call",
+                    params: { name: entry.source.serverToolName, arguments: (args ?? {}) },
+                }, CallToolResultSchema, { signal });
+                result = mcpCallResult(res);
+            }
+            catch (error) {
+                result = signal.aborted
+                    ? { ok: false, text: "mcp: aborted" }
+                    : { ok: false, text: `mcp: ${error instanceof Error ? error.message : String(error)}` };
+            }
+        }
+        if (this.signal.aborted)
+            return;
+        if (!result.ok) {
+            const tail = this.driverConnection.stderrTail();
+            const text = result.text ?? "mcp: tool reported failure";
+            this.complete({
+                ok: false,
+                text: tail && !text.includes("--- stderr ---") ? `${text}\n--- stderr ---\n${tail}` : text,
+                value: result.value,
+            });
+            return;
+        }
+        this.complete({ ok: true, value: result.value });
+    }
+}
+export function mcpCallResult(res) {
+    const value = callResultValue(res);
+    if (isErrorResult(res)) {
+        return { ok: false, text: diagnosticText(res, value), raw: res, value };
+    }
+    return { ok: true, raw: res, value };
+}
+function isErrorResult(res) {
+    return res != null && typeof res === "object" && "isError" in res && res.isError === true;
+}
+function callResultValue(res) {
+    if (res == null || typeof res !== "object")
+        return res;
+    if ("structuredContent" in res) {
+        const structured = res.structuredContent;
+        if (structured !== undefined)
+            return structured;
+    }
+    if ("content" in res) {
+        const content = res.content;
+        if (Array.isArray(content) && content.length === 1) {
+            const block = content[0];
+            if (block != null && typeof block === "object" && "type" in block && block.type === "text") {
+                return String(block.text ?? "");
+            }
+        }
+        return content;
+    }
+    return res;
+}
+function diagnosticText(res, value) {
+    if (typeof value === "string" && value !== "")
+        return value;
+    if (res != null && typeof res === "object" && "content" in res) {
+        const content = res.content;
+        if (Array.isArray(content)) {
+            const texts = content
+                .filter((block) => block != null && typeof block === "object" && block.type === "text")
+                .map((block) => String(block.text ?? ""));
+            if (texts.some((text) => text !== ""))
+                return texts.join("\n");
+        }
+    }
+    return "mcp: tool reported failure";
+}
+//# sourceMappingURL=actor.js.map

package/dist/drivers/mcp/actor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.js","sourceRoot":"","sources":["../../../src/drivers/mcp/actor.ts"],"names":[],"mappings":"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"}

package/dist/drivers/mcp/adopt.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP adopt: parse a dropped http(s) URL or stdio command.
+ * HTTP remainder that 401s with Protected Resource Metadata parks the same
+ * PKCE `harness/open-url` as connect/login. Otherwise an optional token.
+ */
+import { type AdoptCallback, type DriverAdoptBags } from "../adopt.js";
+export type McpAdoptArgs = {
+    name?: string;
+    settings?: Record<string, unknown>;
+    input?: string;
+};
+export type McpAdoptBags = DriverAdoptBags & {
+    readonly driver: "mcp-http" | "mcp-stdio";
+};
+export declare function isHttpMcpEndpoint(input: string): boolean;
+export declare function parseMcpEndpoint(input: string): {
+    readonly driver: "mcp-http" | "mcp-stdio";
+    readonly settings: Record<string, unknown>;
+};
+export declare function adoptMcp(args: McpAdoptArgs, callback: AdoptCallback): Promise<McpAdoptBags>;
+//# sourceMappingURL=adopt.d.ts.map

package/dist/drivers/mcp/adopt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../../src/drivers/mcp/adopt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAGtF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG;IAC3C,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;CAC3C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOxD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAC/C,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,CAcA;AAuBD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAwCjG"}

package/dist/drivers/mcp/adopt.js

@@ -0,0 +1,88 @@
+/**
+ * MCP adopt: parse a dropped http(s) URL or stdio command.
+ * HTTP remainder that 401s with Protected Resource Metadata parks the same
+ * PKCE `harness/open-url` as connect/login. Otherwise an optional token.
+ */
+import { asAdoptString } from "../adopt.js";
+import { collectMcpHttpOAuth, offersMcpOAuth } from "./oauth.js";
+export function isHttpMcpEndpoint(input) {
+    try {
+        const url = new URL(input.trim());
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+export function parseMcpEndpoint(input) {
+    const trimmed = input.trim();
+    if (isHttpMcpEndpoint(trimmed)) {
+        return { driver: "mcp-http", settings: { url: trimmed } };
+    }
+    const parts = trimmed.split(/\s+/).filter((part) => part !== "");
+    const command = parts[0];
+    if (command === undefined) {
+        throw new Error("mcp adopt: URL or command is required");
+    }
+    return {
+        driver: "mcp-stdio",
+        settings: { command, ...(parts.length > 1 ? { args: parts.slice(1) } : {}) },
+    };
+}
+function nameFromHttp(url) {
+    try {
+        const host = new URL(url).hostname;
+        if (host.startsWith("mcp.") && host.slice(4).includes("."))
+            return host.slice(4);
+        return host === "" ? "mcp-http" : host;
+    }
+    catch {
+        return "mcp-http";
+    }
+}
+function nameFromCommand(command) {
+    const base = command.split(/[/\\]/).pop() ?? command;
+    const stem = base.replace(/\.(js|mjs|cjs|exe)$/i, "");
+    return stem === "" ? "mcp-stdio" : stem;
+}
+function isGenericMcpName(name) {
+    const n = name.trim().toLowerCase();
+    return n === "" || n === "add mcp" || n === "mcp" || n === "mcp-http" || n === "mcp-stdio";
+}
+export async function adoptMcp(args, callback) {
+    const settings = { ...(args.settings ?? {}) };
+    const fromSettings = asAdoptString(settings.url) !== "" || asAdoptString(settings.command) !== "";
+    let endpoint = asAdoptString(args.input);
+    if (!fromSettings && endpoint === "") {
+        const { input } = await callback("UI", '(harness/input :name "MCP URL or command" :description "https://… or a stdio command")');
+        endpoint = asAdoptString(input);
+    }
+    const parsed = fromSettings
+        ? asAdoptString(settings.url) !== ""
+            ? { driver: "mcp-http", settings }
+            : { driver: "mcp-stdio", settings }
+        : parseMcpEndpoint(endpoint);
+    const nextSettings = fromSettings ? settings : { ...settings, ...parsed.settings };
+    const driver = parsed.driver;
+    const secrets = {};
+    if (driver === "mcp-http" && !fromSettings) {
+        const mcpUrl = asAdoptString(nextSettings.url);
+        if (await offersMcpOAuth(mcpUrl)) {
+            Object.assign(secrets, await collectMcpHttpOAuth(mcpUrl, (body) => callback("UI", body)));
+        }
+        else {
+            const { input: token } = await callback("UI", '(harness/input :name "Token" :description "Optional. Empty to skip; Authenticate later for OAuth." :secret #t)');
+            const key = asAdoptString(token);
+            if (key !== "")
+                secrets.token = key;
+        }
+    }
+    const given = (args.name ?? "").trim();
+    const name = isGenericMcpName(given)
+        ? driver === "mcp-http"
+            ? nameFromHttp(asAdoptString(nextSettings.url))
+            : nameFromCommand(asAdoptString(nextSettings.command))
+        : given;
+    return { driver, name, settings: nextSettings, secrets };
+}
+//# sourceMappingURL=adopt.js.map

package/dist/drivers/mcp/adopt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../../src/drivers/mcp/adopt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAA4C,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYjE,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAI5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC;IAC5D,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;KAC7E,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACnC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IACtD,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,WAAW,CAAC;AAC7F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB,EAAE,QAAuB;IACxE,MAAM,QAAQ,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;IAC9C,MAAM,YAAY,GAChB,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/E,IAAI,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,YAAY,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAC9B,IAAI,EACJ,wFAAwF,CACzF,CAAC;QACF,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,GAAG,YAAY;QACzB,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE;YAClC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAmB,EAAE,QAAQ,EAAE;YAC3C,CAAC,CAAC,EAAE,MAAM,EAAE,WAAoB,EAAE,QAAQ,EAAE;QAC9C,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACnF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,MAAM,KAAK,UAAU,IAAI,CAAC,YAAY,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,MAAM,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,mBAAmB,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5F,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CACrC,IAAI,EACJ,gHAAgH,CACjH,CAAC;YACF,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,GAAG,KAAK,EAAE;gBAAE,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC;QACtC,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC;QAClC,CAAC,CAAC,MAAM,KAAK,UAAU;YACrB,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAC/C,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC,CAAC,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AAC3D,CAAC"}

package/dist/drivers/mcp/config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * MCP transport connection settings + secrets. Two yaml bags, two schemas.
+ * Transport is the driver (`mcp-stdio` / `mcp-http`), not a setting.
+ */
+import { z } from "zod";
+export declare const mcpSecretsSchema: z.ZodObject<{
+    token: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const mcpStdioConfigurationSchema: z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    envForward: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+export type McpStdioConnectionConfig = z.output<typeof mcpStdioConfigurationSchema>;
+export declare const mcpHttpConfigurationSchema: z.ZodObject<{
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$loose>;
+export type McpHttpConnectionConfig = z.output<typeof mcpHttpConfigurationSchema>;
+/** DriverSpec.can claim. Not the driver name (`mcp-stdio` / `mcp-http`). */
+export declare function isMcpDriver(can: readonly string[]): boolean;
+export declare function isMcpEnabled(config: {
+    readonly enabled?: boolean;
+} | Record<string, unknown>): boolean;
+export declare function bearerHeaders(secrets: {
+    get(field: string): unknown;
+}, extra?: Readonly<Record<string, string>>): Record<string, string>;
+//# sourceMappingURL=config.d.ts.map

package/dist/drivers/mcp/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/drivers/mcp/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;iBAKb,CAAC;AAEjB,eAAO,MAAM,2BAA2B;;;;;;iBAexB,CAAC;AAEjB,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEpF,eAAO,MAAM,0BAA0B;;;;iBAYvB,CAAC;AAEjB,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAElF,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE3D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEtG;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE;IAAE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EACxC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB"}

package/dist/drivers/mcp/config.js

@@ -0,0 +1,50 @@
+/**
+ * MCP transport connection settings + secrets. Two yaml bags, two schemas.
+ * Transport is the driver (`mcp-stdio` / `mcp-http`), not a setting.
+ */
+import { z } from "zod";
+export const mcpSecretsSchema = z
+    .object({
+    token: z.string({ error: "token must be a string" }).optional(),
+    apiKey: z.string({ error: "apiKey must be a string" }).optional(),
+})
+    .passthrough();
+export const mcpStdioConfigurationSchema = z
+    .object({
+    command: z
+        .string({ error: "command must be a non-empty string" })
+        .trim()
+        .min(1, "command must be a non-empty string"),
+    args: z.array(z.string(), { error: "args must be a string array" }).optional(),
+    /** Harness base (kernel / install) directory. Not SessionRoot.path. */
+    cwd: z.string({ error: "cwd must be a string" }).optional(),
+    enabled: z.boolean({ error: "enabled must be a boolean" }).optional().default(true),
+    envForward: z.array(z.string(), { error: "envForward must be a string array" }).optional(),
+}, { error: "config must be an object" })
+    .passthrough();
+export const mcpHttpConfigurationSchema = z
+    .object({
+    url: z
+        .string({ error: "url must be a non-empty string" })
+        .trim()
+        .min(1, "url must be a non-empty string"),
+    headers: z.record(z.string(), z.string(), { error: "headers must be a string record" }).optional(),
+    enabled: z.boolean({ error: "enabled must be a boolean" }).optional().default(true),
+}, { error: "config must be an object" })
+    .passthrough();
+/** DriverSpec.can claim. Not the driver name (`mcp-stdio` / `mcp-http`). */
+export function isMcpDriver(can) {
+    return can.includes("mcp");
+}
+export function isMcpEnabled(config) {
+    return config.enabled !== false;
+}
+export function bearerHeaders(secrets, extra) {
+    const headers = { ...(extra ?? {}) };
+    const token = secrets.get("token") ?? secrets.get("apiKey");
+    if (typeof token === "string" && token !== "" && headers.Authorization === undefined) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+    return headers;
+}
+//# sourceMappingURL=config.js.map

package/dist/drivers/mcp/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/drivers/mcp/config.ts"],"names":[],"mappings":"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"}

package/dist/drivers/mcp/http-driver.d.ts

@@ -0,0 +1,23 @@
+import { McpDriverConnection, type McpListedTool } from "./mcp-connection.js";
+import { type McpHttpConnectionConfig } from "./config.js";
+export declare class McpHttpDriverConnection extends McpDriverConnection<McpHttpConnectionConfig> {
+    #private;
+    static configurationSchema: import("zod").ZodObject<{
+        url: import("zod").ZodString;
+        headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        enabled: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+    }, import("zod/v4/core").$loose>;
+    static secretsSchema: import("zod").ZodObject<{
+        token: import("zod").ZodOptional<import("zod").ZodString>;
+        apiKey: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$loose>;
+    static configurationLabel: string;
+    accessor state: {
+        tools: McpListedTool[];
+        auth: string | undefined;
+    };
+    bootstrap(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export default McpHttpDriverConnection;
+//# sourceMappingURL=http-driver.d.ts.map

package/dist/drivers/mcp/http-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-driver.d.ts","sourceRoot":"","sources":["../../../src/drivers/mcp/http-driver.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAGrB,qBAAa,uBAAwB,SAAQ,mBAAmB,CAAC,uBAAuB,CAAC;;IACvF,OAAgB,mBAAmB;;;;qCAA8B;IACjE,OAAgB,aAAa;;;qCAAoB;IACjD,OAAgB,kBAAkB,SAAc;IAChD,SAAsC,KAAK;QACzC,KAAK,EAAQ,aAAa,EAAE;QAC5B,IAAI,EAAe,MAAM,GAAG,SAAS;MACrC;IAIa,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA2CxC;IAEc,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAsBpD;CACF;eAEc,uBAAuB"}

package/dist/drivers/mcp/http-driver.js

@@ -0,0 +1,147 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+/**
+ * The class is the driver; an instance is one live MCP Streamable HTTP connection.
+ * Load writes tools onto state. Work is handle → resolve → actor.
+ * Bearer token lives on this.secrets (secrets.json), not on catalog tools.
+ */
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { observable } from "mobx";
+import { McpDriverConnection } from "./mcp-connection.js";
+import { bearerHeaders, isMcpEnabled, mcpHttpConfigurationSchema, mcpSecretsSchema, } from "./config.js";
+import { isMcpAuthChallenge } from "./oauth.js";
+let McpHttpDriverConnection = (() => {
+    var _a;
+    let _classSuper = McpDriverConnection;
+    let _state_decorators;
+    let _state_initializers = [];
+    let _state_extraInitializers = [];
+    return class McpHttpDriverConnection extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(this, null, _state_decorators, { kind: "accessor", name: "state", static: false, private: false, access: { has: obj => "state" in obj, get: obj => obj.state, set: (obj, value) => { obj.state = value; } }, metadata: _metadata }, _state_initializers, _state_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        static configurationSchema = mcpHttpConfigurationSchema;
+        static secretsSchema = mcpSecretsSchema;
+        static configurationLabel = "mcp-http";
+        #state_accessor_storage = __runInitializers(this, _state_initializers, {
+            tools: [],
+            auth: undefined,
+        });
+        get state() { return this.#state_accessor_storage; }
+        set state(value) { this.#state_accessor_storage = value; }
+        #transport = (__runInitializers(this, _state_extraInitializers), null);
+        async bootstrap() {
+            if (!isMcpEnabled(this.settings)) {
+                this.state.tools = [];
+                this.state.auth = undefined;
+                return;
+            }
+            const headers = bearerHeaders(this.secrets, this.settings.headers);
+            const transport = new StreamableHTTPClientTransport(new URL(this.settings.url), {
+                requestInit: Object.keys(headers).length > 0 ? { headers } : undefined,
+            });
+            const prevOnClose = transport.onclose;
+            transport.onclose = () => {
+                try {
+                    prevOnClose?.();
+                }
+                catch {
+                    /* ignore */
+                }
+                if (this.#transport === transport) {
+                    this.client = null;
+                    this.#transport = null;
+                    if (this.bootstrapDone)
+                        this.failReady(new Error("mcp-http: transport closed"));
+                }
+            };
+            let client;
+            try {
+                client = await this.connectMcpClient(transport);
+                this.#transport = transport;
+            }
+            catch (error) {
+                try {
+                    await transport.close();
+                }
+                catch {
+                    /* ignore */
+                }
+                if (isMcpAuthChallenge(error, this.secrets, this.settings)) {
+                    this.state.auth = "needs-auth";
+                    this.state.tools = [];
+                    return;
+                }
+                const msg = error instanceof Error ? error.message : String(error);
+                throw new Error(`mcp: connect failed: ${msg}`);
+            }
+            this.state.auth = undefined;
+            this.state.tools = [...(await this.requestMcpListTools(client))];
+        }
+        async [(_state_decorators = [(_a = observable).shallow.bind(_a)], Symbol.asyncDispose)]() {
+            const client = this.client;
+            const transport = this.#transport;
+            this.client = null;
+            this.#transport = null;
+            if (transport) {
+                try {
+                    transport.onclose = undefined;
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            try {
+                if (client && typeof client.close === "function")
+                    await client.close();
+            }
+            catch {
+                /* ignore */
+            }
+            try {
+                if (transport && typeof transport.close === "function")
+                    await transport.close();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    };
+})();
+export { McpHttpDriverConnection };
+export default McpHttpDriverConnection;
+//# sourceMappingURL=http-driver.js.map

package/dist/drivers/mcp/http-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-driver.js","sourceRoot":"","sources":["../../../src/drivers/mcp/http-driver.ts"],"names":[],"mappings":"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"}

package/dist/drivers/mcp/index.d.ts

@@ -0,0 +1,8 @@
+export { default as McpStdioDriverConnection } from "./stdio-driver.js";
+export { default as McpHttpDriverConnection } from "./http-driver.js";
+export * from "./actor.js";
+export * from "./mcp-connection.js";
+export * from "./config.js";
+export * from "./stdio-env.js";
+export * from "./adopt.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/drivers/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/drivers/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACtE,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/drivers/mcp/index.js

@@ -0,0 +1,8 @@
+export { default as McpStdioDriverConnection } from "./stdio-driver.js";
+export { default as McpHttpDriverConnection } from "./http-driver.js";
+export * from "./actor.js";
+export * from "./mcp-connection.js";
+export * from "./config.js";
+export * from "./stdio-env.js";
+export * from "./adopt.js";
+//# sourceMappingURL=index.js.map

package/dist/drivers/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/drivers/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACtE,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/drivers/mcp/mcp-connection.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared MCP connection: instance state reports tools; the class (driver)
+ * state does not. Transport subclasses spawn or dial; this class owns the
+ * SDK client connect + listTools.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import { PEWDriverConnection } from "@inhuman.tools/plexus-expectations/driver";
+import { ToolCallExpectation } from "../../models/session/index.js";
+import { McpToolCallActor } from "./actor.js";
+export type McpListedTool = {
+    readonly serverToolName: string;
+    readonly description?: string;
+    readonly parameters: Record<string, unknown>;
+    readonly class?: string;
+};
+export declare abstract class McpDriverConnection<C extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>> extends PEWDriverConnection<ToolCallExpectation, C> {
+    accessor state: {
+        tools: McpListedTool[];
+    };
+    client: Client | null;
+    stderrTail(): string;
+    protected resolve(expectation: ToolCallExpectation): McpToolCallActor;
+    protected connectMcpClient(transport: Transport): Promise<Client>;
+    protected requestMcpListTools(client: Client): Promise<readonly McpListedTool[]>;
+}
+//# sourceMappingURL=mcp-connection.d.ts.map

package/dist/drivers/mcp/mcp-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-connection.d.ts","sourceRoot":"","sources":["../../../src/drivers/mcp/mcp-connection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,8BAAsB,mBAAmB,CACvC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAC/E,SAAQ,mBAAmB,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACnD,SAAsC,KAAK;QACzC,KAAK,EAAQ,aAAa,EAAE;MAC5B;IAEF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE7B,UAAU,IAAI,MAAM,CAEnB;IAED,UAAmB,OAAO,CAAC,WAAW,EAAE,mBAAmB,oBAE1D;IAED,UAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAKtE;IAED,UAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAWrF;CACF"}