@inhuman.tools/harness 0.0.0-stage → 0.2.0

package/dist/providers/mcp/persist.d.ts

@@ -0,0 +1,21 @@
+import type { ConnectionSpec } from "@inhuman.tools/plexus-expectations";
+/** Kernel config slice this package mutates. Product catalog shape stays in composition. */
+export type McpPersistedConnection = {
+    settings: Record<string, unknown>;
+};
+export type McpPersistedConfig = {
+    connections: Record<string, McpPersistedConnection | undefined>;
+};
+export declare function alwaysAllowOf(settings: unknown): readonly string[];
+export declare function parseAlwaysAllow(raw: unknown): readonly string[];
+export declare function mcpSessionPersistAllows(connectionKey: string, serverToolName: string, allowlist: Readonly<Record<string, string>>, blocklist?: Readonly<Record<string, string>>): boolean;
+export declare function mcpSessionPersistDenies(connectionKey: string, serverToolName: string, blocklist: Readonly<Record<string, string>>): boolean;
+export declare function hydrateMcpAlwaysAllows(allowlist: Record<string, string>, connections: Readonly<Record<string, ConnectionSpec | undefined>>): void;
+export declare function mcpAlwaysRowsFromList(list: Readonly<Record<string, string>>): readonly {
+    connectionKey: string;
+    serverToolName: string;
+}[];
+export declare function addConnectionAlwaysAllow(config: McpPersistedConfig, connectionKey: string, serverToolName: string): void;
+/** Append `!serverToolName` to connection `tools`. Only-excludes imply `*`. */
+export declare function addConnectionToolExclude(config: McpPersistedConfig, connectionKey: string, serverToolName: string): void;
+//# sourceMappingURL=persist.d.ts.map

package/dist/providers/mcp/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/providers/mcp/persist.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMzE,4FAA4F;AAC5F,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,SAAS,CAAC,CAAC;CACjE,CAAC;AAEF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAGlE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAGhE;AAED,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC3C,SAAS,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC/C,OAAO,CAIT;AAED,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC1C,OAAO,CAET;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC,GAChE,IAAI,CAQN;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACrC,SAAS;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAAE,CAQ9D;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,IAAI,CAMN;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,IAAI,CAON"}

package/dist/providers/mcp/persist.js

@@ -0,0 +1,76 @@
+/**
+ * MCP persist. Session remember is `SessionRoot.toolAllowlist` /
+ * `toolBlocklist` (`connection:tool` → `session` | `always`). Disk
+ * Always-read is connection `alwaysAllow` via kernel
+ * `connect/always-allow`. Disk forever-deny is connection `tools`
+ * `!name` via kernel `connect/exclude-tool`. A grant is not a
+ * license without the read floor. Blocklist is hide + deny, not a
+ * silent ask→deny.
+ */
+import { mcpReadFloorAllows, mcpToolListHas, mcpToolRefKey, parseMcpPersistScope, parseMcpToolRefKey, } from "@inhuman.tools/harness-model";
+import { isMcpDriver } from "./config.js";
+import { readField } from "./json.js";
+import { parseMcpToolRules } from "./tool-filter.js";
+export function alwaysAllowOf(settings) {
+    if (settings == null || typeof settings !== "object")
+        return [];
+    return parseAlwaysAllow(readField(settings, "alwaysAllow"));
+}
+export function parseAlwaysAllow(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw.filter((row) => typeof row === "string" && row.trim() !== "");
+}
+export function mcpSessionPersistAllows(connectionKey, serverToolName, allowlist, blocklist = {}) {
+    if (mcpToolListHas(blocklist, connectionKey, serverToolName))
+        return false;
+    if (!mcpReadFloorAllows(serverToolName))
+        return false;
+    return parseMcpPersistScope(allowlist[mcpToolRefKey(connectionKey, serverToolName)]) !== undefined;
+}
+export function mcpSessionPersistDenies(connectionKey, serverToolName, blocklist) {
+    return mcpToolListHas(blocklist, connectionKey, serverToolName);
+}
+export function hydrateMcpAlwaysAllows(allowlist, connections) {
+    for (const [id, spec] of Object.entries(connections)) {
+        if (spec == null || !isMcpDriver(spec.driver.abilityClaim))
+            continue;
+        for (const name of alwaysAllowOf(spec.configuration)) {
+            const key = mcpToolRefKey(id, name);
+            if ((allowlist[key] ?? "") === "")
+                allowlist[key] = "always";
+        }
+    }
+}
+export function mcpAlwaysRowsFromList(list) {
+    const out = [];
+    for (const [key, value] of Object.entries(list)) {
+        if (value !== "always")
+            continue;
+        const row = parseMcpToolRefKey(key);
+        if (row !== undefined)
+            out.push(row);
+    }
+    return out;
+}
+export function addConnectionAlwaysAllow(config, connectionKey, serverToolName) {
+    const conn = config.connections[connectionKey];
+    if (conn === undefined)
+        return;
+    const existing = parseAlwaysAllow(conn.settings.alwaysAllow);
+    if (existing.includes(serverToolName))
+        return;
+    conn.settings.alwaysAllow = [...existing, serverToolName];
+}
+/** Append `!serverToolName` to connection `tools`. Only-excludes imply `*`. */
+export function addConnectionToolExclude(config, connectionKey, serverToolName) {
+    const conn = config.connections[connectionKey];
+    if (conn === undefined)
+        return;
+    const existing = parseMcpToolRules(conn.settings.tools) ?? [];
+    const exclude = `!${serverToolName}`;
+    if (existing.some((row) => row.trim() === exclude))
+        return;
+    conn.settings.tools = [...existing, exclude];
+}
+//# sourceMappingURL=persist.js.map

package/dist/providers/mcp/persist.js.map

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

package/dist/providers/mcp/quote.d.ts

@@ -0,0 +1,4 @@
+/** Scheme string literal for parked UI. Same quoting as the connection adopt host. */
+export declare function schemeQuote(value: string): string;
+export declare function asAdoptString(value: unknown): string;
+//# sourceMappingURL=quote.d.ts.map

package/dist/providers/mcp/quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../../../src/providers/mcp/quote.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/dist/providers/mcp/quote.js

@@ -0,0 +1,8 @@
+/** Scheme string literal for parked UI. Same quoting as the connection adopt host. */
+export function schemeQuote(value) {
+    return `"${value.replaceAll("\\", "\\\\").replaceAll('"', String.raw `\"`)}"`;
+}
+export function asAdoptString(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+//# sourceMappingURL=quote.js.map

package/dist/providers/mcp/quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.js","sourceRoot":"","sources":["../../../src/providers/mcp/quote.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAA,IAAI,CAAC,GAAG,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/providers/mcp/registration.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP driver-provider registration. Product composition adds this to the
+ * roster. Not a plugin manifest and not a neighboring vendor.
+ */
+import { type RegisteredProvider } from "@inhuman.tools/harness-provider-sdk";
+export declare const MCP_PROVIDER_ID = "mcp";
+export declare const MCP_STDIO_DRIVER = "mcp-stdio";
+export declare const MCP_HTTP_DRIVER = "mcp-http";
+export declare const mcpProvider: RegisteredProvider;
+//# sourceMappingURL=registration.d.ts.map

package/dist/providers/mcp/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../src/providers/mcp/registration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,qCAAqC,CAAC;AAK7C,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAC5C,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,eAAO,MAAM,WAAW,EAAE,kBAqBxB,CAAC"}

package/dist/providers/mcp/registration.js

@@ -0,0 +1,33 @@
+/**
+ * MCP driver-provider registration. Product composition adds this to the
+ * roster. Not a plugin manifest and not a neighboring vendor.
+ */
+import { parseProviderRegistration, PROVIDER_SDK_CONTRACT, } from "@inhuman.tools/harness-provider-sdk";
+import { McpHttpDriverConnection } from "./http-driver.js";
+import { McpStdioDriverConnection } from "./stdio-driver.js";
+export const MCP_PROVIDER_ID = "mcp";
+export const MCP_STDIO_DRIVER = "mcp-stdio";
+export const MCP_HTTP_DRIVER = "mcp-http";
+export const mcpProvider = parseProviderRegistration({
+    id: MCP_PROVIDER_ID,
+    name: "MCP",
+    description: "Model Context Protocol HTTP and stdio drivers",
+    contract: PROVIDER_SDK_CONTRACT,
+    drivers: [
+        {
+            name: MCP_STDIO_DRIVER,
+            description: "MCP stdio",
+            abilityClaim: ["mcp"],
+            multiplicity: "add-as-secondary",
+            connection: McpStdioDriverConnection,
+        },
+        {
+            name: MCP_HTTP_DRIVER,
+            description: "MCP Streamable HTTP",
+            abilityClaim: ["mcp"],
+            multiplicity: "add-as-secondary",
+            connection: McpHttpDriverConnection,
+        },
+    ],
+});
+//# sourceMappingURL=registration.js.map

package/dist/providers/mcp/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../../src/providers/mcp/registration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GAEtB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAuB,yBAAyB,CAAC;IACvE,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,+CAA+C;IAC5D,QAAQ,EAAE,qBAAqB;IAC/B,OAAO,EAAE;QACP;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,WAAW;YACxB,YAAY,EAAE,CAAC,KAAK,CAAC;YACrB,YAAY,EAAE,kBAAkB;YAChC,UAAU,EAAE,wBAAwB;SACrC;QACD;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,qBAAqB;YAClC,YAAY,EAAE,CAAC,KAAK,CAAC;YACrB,YAAY,EAAE,kBAAkB;YAChC,UAAU,EAAE,uBAAuB;SACpC;KACF;CACF,CAAC,CAAC"}

package/dist/providers/mcp/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Official MCP registry search.
+ * `GET /v0.1/servers` matches the server name, not the description.
+ * The install string is the first streamable HTTP or SSE remote, otherwise
+ * the first package command. Adopt that string as `input`, so each copy
+ * keeps its own login.
+ */
+export type RegistryServer = {
+    readonly name: string;
+    readonly title: string;
+    readonly description: string;
+    readonly install: string;
+};
+export type RegistryFetch = (url: URL, init?: RequestInit) => Promise<Response>;
+export type RegistrySearchOptions = {
+    readonly limit?: number;
+    readonly signal?: AbortSignal;
+    readonly fetch?: RegistryFetch;
+};
+/** Latest official-registry rows whose name contains `query`. An empty query matches nothing. */
+export declare function searchOfficialRegistry(query: string, options?: RegistrySearchOptions): Promise<RegistryServer[]>;
+/** Rows from one registry payload. A row without a name is skipped. */
+export declare function serversFromRegistry(body: unknown): RegistryServer[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/mcp/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/providers/mcp/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEhF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CAChC,CAAC;AAEF,iGAAiG;AACjG,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,EAAE,CAAC,CAyB3B;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,EAAE,CAUnE"}

package/dist/providers/mcp/registry.js

@@ -0,0 +1,209 @@
+/**
+ * Official MCP registry search.
+ * `GET /v0.1/servers` matches the server name, not the description.
+ * The install string is the first streamable HTTP or SSE remote, otherwise
+ * the first package command. Adopt that string as `input`, so each copy
+ * keeps its own login.
+ */
+const REGISTRY_SERVERS = "https://registry.modelcontextprotocol.io/v0.1/servers";
+/** Latest official-registry rows whose name contains `query`. An empty query matches nothing. */
+export async function searchOfficialRegistry(query, options = {}) {
+    const search = query.trim();
+    if (search === "")
+        return [];
+    const url = new URL(REGISTRY_SERVERS);
+    url.searchParams.set("search", search);
+    url.searchParams.set("version", "latest");
+    url.searchParams.set("limit", String(boundedLimit(options.limit)));
+    const timeout = AbortSignal.timeout(15_000);
+    const signal = options.signal === undefined ? timeout : AbortSignal.any([options.signal, timeout]);
+    const load = options.fetch ?? fetch;
+    let response;
+    try {
+        response = await load(url, { signal, headers: { accept: "application/json" } });
+    }
+    catch (error) {
+        if (options.signal?.aborted === true)
+            throw error;
+        throw new Error("The registry didn’t answer.");
+    }
+    if (!response.ok)
+        throw new Error(`The registry didn’t answer (${response.status}).`);
+    let body;
+    try {
+        body = JSON.parse(await response.text());
+    }
+    catch {
+        throw new Error("The registry didn’t answer.");
+    }
+    return serversFromRegistry(body);
+}
+/** Rows from one registry payload. A row without a name is skipped. */
+export function serversFromRegistry(body) {
+    const servers = field(body, "servers");
+    if (!Array.isArray(servers))
+        return [];
+    const hits = [];
+    for (const row of servers) {
+        const wrapped = field(row, "server");
+        const hit = readServer(wrapped === undefined ? row : wrapped);
+        if (hit !== undefined)
+            hits.push(hit);
+    }
+    return hits;
+}
+function readServer(server) {
+    const name = text(field(server, "name"));
+    if (name === "")
+        return undefined;
+    const description = text(field(server, "description")).replaceAll(/\s+/g, " ");
+    return {
+        name,
+        title: displayTitle(name, text(field(server, "title"))),
+        description,
+        install: installOf(server),
+    };
+}
+function displayTitle(name, title) {
+    if (title !== "")
+        return title;
+    const slash = name.lastIndexOf("/");
+    const leaf = (slash !== -1 ? name.slice(slash + 1) : name).trim();
+    return leaf === "" ? name : leaf;
+}
+function installOf(server) {
+    const remote = remoteInstall(field(server, "remotes"));
+    if (remote !== "")
+        return remote;
+    const packages = field(server, "packages");
+    if (!Array.isArray(packages))
+        return "";
+    for (const pkg of packages) {
+        const command = packageInstall(pkg);
+        if (command !== "")
+            return command;
+    }
+    return "";
+}
+function remoteInstall(remotes) {
+    if (!Array.isArray(remotes))
+        return "";
+    let best = "";
+    let bestRank = 3;
+    for (const remote of remotes) {
+        const url = text(field(remote, "url"));
+        if (!isHttp(url))
+            continue;
+        const rank = remoteRank(text(field(remote, "type")));
+        if (rank < bestRank) {
+            best = url;
+            bestRank = rank;
+        }
+    }
+    return best;
+}
+function remoteRank(type) {
+    if (type === "streamable-http")
+        return 0;
+    if (type === "sse")
+        return 1;
+    return 2;
+}
+function packageInstall(pkg) {
+    const binary = packageBinary(pkg);
+    const identifier = text(field(pkg, "identifier"));
+    if (binary === "" || identifier === "" || /\s/.test(identifier))
+        return "";
+    const version = text(field(pkg, "version"));
+    const pinned = pin(binary, identifier, version);
+    const runtime = argumentTokens(field(pkg, "runtimeArguments"));
+    const args = argumentTokens(field(pkg, "packageArguments"));
+    if (binary === "docker") {
+        const prefix = runtime.length > 0 ? runtime : ["run", "-i", "--rm"];
+        return joinCommand("docker", prefix, pinned, args);
+    }
+    if (binary === "npx") {
+        const prefix = runtime.includes("-y") || runtime.includes("--yes") ? runtime : ["-y", ...runtime];
+        return joinCommand("npx", prefix, pinned, args);
+    }
+    return joinCommand(binary, runtime, pinned, args);
+}
+function packageBinary(pkg) {
+    const hint = text(field(pkg, "runtimeHint"));
+    if (hint === "npx" || hint === "uvx" || hint === "docker" || hint === "dnx")
+        return hint;
+    const type = text(field(pkg, "registryType"));
+    if (type === "npm")
+        return "npx";
+    if (type === "pypi")
+        return "uvx";
+    if (type === "oci")
+        return "docker";
+    return "";
+}
+function pin(binary, identifier, version) {
+    if (version === "" || /\s/.test(version) || alreadyPinned(binary, identifier, version))
+        return identifier;
+    if (binary === "docker")
+        return `${identifier}:${version}`;
+    return `${identifier}@${version}`;
+}
+function alreadyPinned(binary, identifier, version) {
+    if (binary === "npx" || binary === "uvx" || binary === "dnx")
+        return identifier.endsWith(`@${version}`);
+    if (binary === "docker")
+        return identifier.endsWith(`:${version}`);
+    return true;
+}
+function argumentTokens(value) {
+    if (!Array.isArray(value))
+        return [];
+    const tokens = [];
+    for (const item of value) {
+        const raw = text(field(item, "value"));
+        if (raw === "" || /\s/.test(raw) || raw.includes("{"))
+            continue;
+        if (text(field(item, "type")) === "named") {
+            const name = text(field(item, "name"));
+            if (name === "" || /\s/.test(name))
+                continue;
+            const flag = name.startsWith("-") ? name : `--${name}`;
+            tokens.push(flag, raw);
+            continue;
+        }
+        tokens.push(raw);
+    }
+    return tokens;
+}
+function joinCommand(binary, prefix, pinned, args) {
+    return [binary, ...prefix, pinned, ...args].join(" ");
+}
+function boundedLimit(limit) {
+    if (limit === undefined || !Number.isInteger(limit))
+        return 15;
+    if (limit < 1)
+        return 1;
+    if (limit > 20)
+        return 20;
+    return limit;
+}
+function isHttp(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+function field(value, key) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return undefined;
+    if (!Object.hasOwn(value, key))
+        return undefined;
+    return Object.getOwnPropertyDescriptor(value, key)?.value;
+}
+function text(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/mcp/registry.js.map

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

package/dist/providers/mcp/schemas/mcp.d.ts

@@ -0,0 +1,50 @@
+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 mcpToolRulesSchema: z.ZodOptional<z.ZodArray<z.ZodString>>;
+export declare const mcpAlwaysAllowSchema: z.ZodOptional<z.ZodArray<z.ZodString>>;
+export declare const mcpToolSeveritySchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+    effect: "effect";
+    view: "view";
+    "irreversible-effect": "irreversible-effect";
+}>>>;
+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>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    toolSeverity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        effect: "effect";
+        view: "view";
+        "irreversible-effect": "irreversible-effect";
+    }>>>;
+    alwaysAllow: 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>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    toolSeverity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        effect: "effect";
+        view: "view";
+        "irreversible-effect": "irreversible-effect";
+    }>>>;
+    alwaysAllow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+export type McpHttpConnectionConfig = z.output<typeof mcpHttpConfigurationSchema>;
+/** One tool as a connection reports it on `spec.live.tools`. */
+export type McpListedTool = {
+    readonly serverToolName: string;
+    readonly description?: string;
+    readonly parameters: Record<string, unknown>;
+    readonly class?: string;
+};
+export declare function parseListedTool(item: unknown): McpListedTool | undefined;
+export declare function parseListedTools(raw: unknown): McpListedTool[];
+//# sourceMappingURL=mcp.d.ts.map

package/dist/providers/mcp/schemas/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../../src/providers/mcp/schemas/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,gBAAgB;;;iBAKb,CAAC;AAEjB,eAAO,MAAM,kBAAkB,wCAIlB,CAAC;AAEd,eAAO,MAAM,oBAAoB,wCAIpB,CAAC;AAEd,eAAO,MAAM,qBAAqB;;;;IAQrB,CAAC;AAEd,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAmBxB,CAAC;AAEjB,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEpF,eAAO,MAAM,0BAA0B;;;;;;;;;;;iBAgBvB,CAAC;AAEjB,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAElF,gEAAgE;AAChE,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,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAgBxE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,EAAE,CAQ9D"}

package/dist/providers/mcp/schemas/mcp.js

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { asRecord, readField } from "../json.js";
+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 mcpToolRulesSchema = z
+    .array(z.string({ error: "tools entries must be strings" }), {
+    error: "tools must be a string array",
+})
+    .optional();
+export const mcpAlwaysAllowSchema = z
+    .array(z.string({ error: "alwaysAllow entries must be strings" }), {
+    error: "alwaysAllow must be a string array",
+})
+    .optional();
+export const mcpToolSeveritySchema = z
+    .record(z.string(), z.enum(["view", "effect", "irreversible-effect"], {
+    error: "toolSeverity values must be view, effect, or irreversible-effect",
+}), { error: "toolSeverity must be an object" })
+    .optional();
+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(),
+    tools: mcpToolRulesSchema,
+    toolSeverity: mcpToolSeveritySchema,
+    /** Durable Always-as-read names. Not a license without the read floor. */
+    alwaysAllow: mcpAlwaysAllowSchema,
+}, { 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),
+    tools: mcpToolRulesSchema,
+    toolSeverity: mcpToolSeveritySchema,
+    alwaysAllow: mcpAlwaysAllowSchema,
+}, { error: "config must be an object" })
+    .passthrough();
+export function parseListedTool(item) {
+    if (typeof item !== "object" || item === null)
+        return undefined;
+    const serverToolName = readField(item, "serverToolName");
+    if (typeof serverToolName !== "string" || serverToolName === "")
+        return undefined;
+    const parameters = asRecord(readField(item, "parameters")) ?? {
+        type: "object",
+        properties: {},
+    };
+    const description = readField(item, "description");
+    const cls = readField(item, "class");
+    return {
+        serverToolName,
+        parameters,
+        ...(typeof description === "string" ? { description } : {}),
+        ...(typeof cls === "string" ? { class: cls } : {}),
+    };
+}
+export function parseListedTools(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        const tool = parseListedTool(item);
+        if (tool != null)
+            out.push(tool);
+    }
+    return out;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/providers/mcp/schemas/mcp.js.map

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

package/dist/providers/mcp/stdio-driver.d.ts

@@ -0,0 +1,31 @@
+import type { McpToolExpectation } from "@inhuman.tools/harness-model";
+import { McpStdioToolActor } from "./actor.js";
+import { McpDriverConnection } from "./mcp-connection.js";
+import { type McpStdioConnectionConfig } from "./schemas/mcp.js";
+export declare class McpStdioDriverConnection extends McpDriverConnection<McpStdioConnectionConfig> {
+    #private;
+    static configurationSchema: import("zod").ZodObject<{
+        command: import("zod").ZodString;
+        args: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        cwd: import("zod").ZodOptional<import("zod").ZodString>;
+        enabled: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+        envForward: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        tools: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        toolSeverity: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodEnum<{
+            effect: "effect";
+            view: "view";
+            "irreversible-effect": "irreversible-effect";
+        }>>>;
+        alwaysAllow: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }, 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;
+    protected createToolActor(expectation: McpToolExpectation): McpStdioToolActor;
+    stderrTail(): string;
+    bootstrap(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=stdio-driver.d.ts.map

package/dist/providers/mcp/stdio-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-driver.d.ts","sourceRoot":"","sources":["../../../src/providers/mcp/stdio-driver.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAiD,KAAK,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAGhH,qBAAa,wBAAyB,SAAQ,mBAAmB,CAAC,wBAAwB,CAAC;;IACzF,OAAgB,mBAAmB;;;;;;;;;;;;;qCAA+B;IAClE,OAAgB,aAAa;;;qCAAoB;IACjD,OAAgB,kBAAkB,SAAe;cAE9B,eAAe,CAAC,WAAW,EAAE,kBAAkB,GAAG,iBAAiB;IAQ7E,UAAU,IAAI,MAAM;IAId,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAuE1B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CA2BtD"}