@aiden-ade/sandbox-agent 0.1.59 → 0.1.60

package/dist/mcp-readiness.js

@@ -0,0 +1,202 @@
+import { validateAlanMcpReadinessContract } from "@alan-ai/shared/agent";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport, StreamableHTTPError, } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { ensureAlanMcpRegistered } from "./mcp-registration.js";
+const DEFAULT_TIMEOUT_MS = 3_000;
+const RETRY_DELAY_MS = 100;
+/**
+ * Staged rollout gate. `observe` is the default so the direct probe collects
+ * telemetry without gating run start; `enforce` is opted into per deployment
+ * once the observed failure rate is understood. Config write/readback failures
+ * block in every mode — only the direct probe is staged.
+ */
+function readinessModeFromEnv() {
+    const value = process.env.ALAN_MCP_READINESS_MODE?.trim().toLowerCase();
+    return value === "off" || value === "enforce" ? value : "observe";
+}
+function timeoutFromEnv() {
+    const configured = Number(process.env.ALAN_MCP_READINESS_TIMEOUT_MS);
+    return Number.isFinite(configured) && configured > 0 ? configured : DEFAULT_TIMEOUT_MS;
+}
+async function defaultClientFactory(input) {
+    const client = new Client({ name: "alan-agent-readiness", version: "1.0.0" });
+    const transport = new StreamableHTTPClientTransport(new URL(input.registration.url), {
+        requestInit: { headers: input.registration.headers },
+    });
+    await client.connect(transport, { signal: input.signal });
+    return client;
+}
+function failureFromError(error, paths) {
+    const status = error instanceof StreamableHTTPError
+        ? error.code
+        : error && typeof error === "object" && "code" in error
+            ? Number(error.code)
+            : undefined;
+    if (status === 401 || status === 403) {
+        return {
+            ok: false,
+            code: "app.mcp.auth_invalid",
+            stage: "connect",
+            message: "Alan could not authenticate the tool connection for this run.",
+            retryable: false,
+            paths,
+        };
+    }
+    if (status === 408 ||
+        status === 429 ||
+        (typeof status === "number" && status >= 500) ||
+        (error instanceof Error &&
+            (error.name === "AbortError" ||
+                error.name === "TimeoutError" ||
+                /timed?\s*out|timeout|econnreset|econnrefused|enotfound|fetch failed/i.test(error.message)))) {
+        return {
+            ok: false,
+            code: "app.mcp.endpoint_unavailable",
+            stage: "connect",
+            message: "Alan's tool service is temporarily unavailable for this run.",
+            retryable: true,
+            paths,
+        };
+    }
+    return {
+        ok: false,
+        code: "app.mcp.protocol_invalid",
+        stage: "protocol",
+        message: "Alan's tool service returned an invalid MCP response.",
+        retryable: false,
+        paths,
+    };
+}
+async function waitBeforeRetry() {
+    await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
+}
+export async function probeAlanMcpReadiness(registration, options = {}) {
+    const paths = options.paths ?? [];
+    const timeoutMs = options.timeoutMs ?? timeoutFromEnv();
+    const clientFactory = options.clientFactory ?? defaultClientFactory;
+    const startedAt = Date.now();
+    for (let attempt = 1; attempt <= 2; attempt++) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), timeoutMs);
+        let client;
+        try {
+            client = await clientFactory({ registration, signal: controller.signal });
+            const listed = await client.listTools(undefined, { signal: controller.signal });
+            const toolNames = new Set((listed.tools ?? []).map((tool) => tool.name));
+            const missingTools = (registration.requiredTools ?? []).filter((toolName) => !toolNames.has(toolName));
+            if (missingTools.length > 0) {
+                return {
+                    ok: false,
+                    code: "app.mcp.tools_missing",
+                    stage: "tools",
+                    message: `Alan's tool service is missing required tools: ${missingTools.join(", ")}.`,
+                    retryable: false,
+                    paths,
+                    missingTools,
+                };
+            }
+            return {
+                ok: true,
+                paths,
+                verification: "enforced",
+                durationMs: Date.now() - startedAt,
+                toolCount: toolNames.size,
+            };
+        }
+        catch (error) {
+            const failure = failureFromError(error, paths);
+            if (!failure.retryable || attempt === 2)
+                return failure;
+            await waitBeforeRetry();
+        }
+        finally {
+            clearTimeout(timeout);
+            await Promise.resolve(client?.close()).catch(() => undefined);
+        }
+    }
+    return {
+        ok: false,
+        code: "app.mcp.endpoint_unavailable",
+        stage: "connect",
+        message: "Alan's tool service is temporarily unavailable for this run.",
+        retryable: true,
+        paths,
+    };
+}
+export async function prepareAlanMcpForRun(backendKind, registration, options = {}) {
+    const contract = validateAlanMcpReadinessContract(registration);
+    if (contract.status === "invalid") {
+        return {
+            ok: false,
+            code: "app.mcp.config_invalid",
+            stage: "config",
+            message: "Alan tools readiness metadata is missing or incompatible. Start a new run and try again.",
+            retryable: false,
+            paths: [],
+        };
+    }
+    const registered = await ensureAlanMcpRegistered(backendKind, registration, options.home);
+    if (!registered.ok) {
+        return {
+            ok: false,
+            code: "app.mcp.config_invalid",
+            stage: "config",
+            message: registered.error ??
+                "Alan tools configuration is missing or incompatible. Repair Alan tools, then retry.",
+            retryable: false,
+            paths: registered.paths,
+        };
+    }
+    // An older API minted this credential before the readiness contract existed,
+    // so there is no required-tool list to probe against. The registration is
+    // still run-scoped; skip verification rather than fail a compatible run.
+    if (contract.status === "absent") {
+        return {
+            ok: true,
+            paths: registered.paths,
+            verification: "legacy",
+            providerLoadStatus: registered.providerLoadStatus,
+        };
+    }
+    const mode = options.mode ?? readinessModeFromEnv();
+    if (mode === "off") {
+        return {
+            ok: true,
+            paths: registered.paths,
+            verification: "off",
+            providerLoadStatus: registered.providerLoadStatus,
+        };
+    }
+    // Observe mode must not pay the probe's latency on the run-start critical
+    // path. Registration is already file-first for exactly this reason, and a
+    // probe that cannot block a run has no business delaying one — so fire it
+    // detached and let `onObservedResult` report whatever it finds.
+    if (mode === "observe") {
+        void probeAlanMcpReadiness(registration, {
+            paths: registered.paths,
+            clientFactory: options.clientFactory,
+            timeoutMs: options.timeoutMs,
+        })
+            .then((result) => {
+            if (!result.ok)
+                options.onObservedResult?.(result);
+        })
+            .catch(() => undefined);
+        return {
+            ok: true,
+            paths: registered.paths,
+            verification: "observed",
+            providerLoadStatus: registered.providerLoadStatus,
+        };
+    }
+    // Enforce mode is the only path that blocks on the probe.
+    const probed = await probeAlanMcpReadiness(registration, {
+        paths: registered.paths,
+        clientFactory: options.clientFactory,
+        timeoutMs: options.timeoutMs,
+    });
+    if (!probed.ok)
+        return probed;
+    return { ...probed, providerLoadStatus: registered.providerLoadStatus };
+}
+//# sourceMappingURL=mcp-readiness.js.map

package/dist/mcp-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-readiness.js","sourceRoot":"","sources":["../src/mcp-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,oDAAoD,CAAC;AAE5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAkDhE,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACjC,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B;;;;;GAKG;AACH,SAAS,oBAAoB;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxE,OAAO,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACpE,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC;AACzF,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,KAGnC;IACC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE;QACnF,WAAW,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE;KACrD,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,KAAe;IACvD,MAAM,MAAM,GACV,KAAK,YAAY,mBAAmB;QAClC,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK;YACrD,CAAC,CAAC,MAAM,CAAE,KAA4B,CAAC,IAAI,CAAC;YAC5C,CAAC,CAAC,SAAS,CAAC;IAClB,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACrC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,sBAAsB;YAC5B,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,+DAA+D;YACxE,SAAS,EAAE,KAAK;YAChB,KAAK;SACN,CAAC;IACJ,CAAC;IACD,IACE,MAAM,KAAK,GAAG;QACd,MAAM,KAAK,GAAG;QACd,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,CAAC;QAC7C,CAAC,KAAK,YAAY,KAAK;YACrB,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY;gBAC1B,KAAK,CAAC,IAAI,KAAK,cAAc;gBAC7B,sEAAsE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAChG,CAAC;QACD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,8BAA8B;YACpC,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,8DAA8D;YACvE,SAAS,EAAE,IAAI;YACf,KAAK;SACN,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,uDAAuD;QAChE,SAAS,EAAE,KAAK;QAChB,KAAK;KACN,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAAiC,EACjC,UAII,EAAE;IAEN,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,cAAc,EAAE,CAAC;IACxD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,oBAAoB,CAAC;IACpE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,MAAsC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAChF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACzE,MAAM,YAAY,GAAG,CAAC,YAAY,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,MAAM,CAC5D,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CACvC,CAAC;YACF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,IAAI,EAAE,uBAAuB;oBAC7B,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,kDAAkD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACrF,SAAS,EAAE,KAAK;oBAChB,KAAK;oBACL,YAAY;iBACb,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,KAAK;gBACL,YAAY,EAAE,UAAU;gBACxB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,SAAS,EAAE,SAAS,CAAC,IAAI;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC/C,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC;YACxD,MAAM,eAAe,EAAE,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,8BAA8B;QACpC,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,8DAA8D;QACvE,SAAS,EAAE,IAAI;QACf,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,YAAiC,EACjC,UAUI,EAAE;IAEN,MAAM,QAAQ,GAAG,gCAAgC,CAAC,YAAY,CAAC,CAAC;IAChE,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,wBAAwB;YAC9B,KAAK,EAAE,QAAQ;YACf,OAAO,EACL,0FAA0F;YAC5F,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,wBAAwB;YAC9B,KAAK,EAAE,QAAQ;YACf,OAAO,EACL,UAAU,CAAC,KAAK;gBAChB,qFAAqF;YACvF,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,0EAA0E;IAC1E,yEAAyE;IACzE,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO;YACL,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,YAAY,EAAE,QAAQ;YACtB,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;SAClD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,oBAAoB,EAAE,CAAC;IACpD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,YAAY,EAAE,KAAK;YACnB,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;SAClD,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,0EAA0E;IAC1E,0EAA0E;IAC1E,gEAAgE;IAChE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,KAAK,qBAAqB,CAAC,YAAY,EAAE;YACvC,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC;aACC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1B,OAAO;YACL,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,YAAY,EAAE,UAAU;YACxB,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;SAClD,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE;QACvD,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO,EAAE,GAAG,MAAM,EAAE,kBAAkB,EAAE,UAAU,CAAC,kBAAkB,EAAE,CAAC;AAC1E,CAAC"}

package/dist/mcp-registration.d.ts

@@ -0,0 +1,75 @@
+import { type McpCliInspectionIssue } from "@alan-ai/agent-core";
+import { type AlanMcpRegistration } from "@alan-ai/shared/agent";
+export interface McpConfigRepairIssue {
+    code: "mcp_config_repair_required";
+    message: string;
+}
+export type McpPreflightIssue = McpCliInspectionIssue | McpConfigRepairIssue;
+export interface McpRegistrationVerification {
+    method: "cli" | "file";
+    command?: string;
+    providerVersion?: string;
+}
+export type ProviderMcpLoadStatus = "verified" | "failed" | "unsupported" | "indeterminate";
+export interface McpCliInspectorResult {
+    ok: boolean;
+    issue?: McpCliInspectionIssue;
+    verification: McpRegistrationVerification;
+}
+export type McpCliInspector = (backendKind: string, expectedUrl: string, home: string) => McpCliInspectorResult | Promise<McpCliInspectorResult>;
+export interface McpRegistrationResult {
+    ok: boolean;
+    paths: string[];
+    error?: string;
+    issue?: McpPreflightIssue;
+    verification?: McpRegistrationVerification;
+    providerLoadStatus?: ProviderMcpLoadStatus;
+}
+export interface McpRegistrationCheck {
+    ok: boolean;
+    missing: string[];
+    invalid: string[];
+    error?: string;
+    issue?: McpPreflightIssue;
+    verification?: McpRegistrationVerification;
+    providerLoadStatus?: ProviderMcpLoadStatus;
+}
+/** Test-only: clear the successful-inspect cache between cases. */
+export declare function __resetMcpInspectCache(): void;
+export declare const inspectAlanMcpThroughProviderCli: McpCliInspector;
+/**
+ * Ensure the Alan MCP server is registered in the config files the given CLI
+ * backend reads, BEFORE the CLI is spawned. This is the sandbox agent's own
+ * responsibility on every run — provision-time injection alone goes stale.
+ * Current APIs provide a run-lifecycle broker reference; older APIs may still
+ * provide direct headers, so this renderer intentionally supports both during
+ * rollout.
+ *
+ * Files whose top-level JSON carries other CLI state (e.g. ~/.claude.json) are
+ * merged on the MCP key rather than clobbered.
+ */
+export declare function ensureAlanMcpRegistered(backendKind: string, registration: AlanMcpRegistration, home?: string, inspectCli?: McpCliInspector): Promise<McpRegistrationResult>;
+/**
+ * When a run arrives WITHOUT per-run MCP config (older API), verify that the
+ * provision-time registration actually exists for this backend so a missing
+ * config surfaces as a loud warning instead of a silently toolless agent.
+ */
+export declare function verifyAlanMcpRegistered(backendKind: string, home?: string, inspectCli?: McpCliInspector): Promise<McpRegistrationCheck>;
+export interface McpUnregisterResult {
+    removedPaths: string[];
+    errors: string[];
+}
+/**
+ * Remove the per-run Alan MCP entry from the CLI config files a backend reads.
+ * Symmetric counterpart to {@link ensureAlanMcpRegistered}: registration writes
+ * a run-scoped `x-alan-run-reference` into shared config (e.g. `~/.claude.json`),
+ * so once no run needs it the entry MUST be removed — otherwise the now-inactive
+ * reference lingers and every later local CLI session fails to connect with
+ * `401 Inactive MCP run reference`. Best-effort and never throws: a failure to
+ * clean one file is logged via the returned `errors` and the next run's
+ * registration overwrites the entry regardless.
+ */
+export declare function unregisterAlanMcp(backendKind: string, home?: string): Promise<McpUnregisterResult>;
+/** Parse the complete effective Alan registration from a provider config file. */
+export declare function readAlanMcpRegistration(path: string): AlanMcpRegistration | null;
+//# sourceMappingURL=mcp-registration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registration.d.ts","sourceRoot":"","sources":["../src/mcp-registration.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,mBAAmB,EAMzB,MAAM,uBAAuB,CAAC;AAQ/B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;AAE7E,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAC;AAE5F,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,YAAY,EAAE,2BAA2B,CAAC;CAC3C;AAED,MAAM,MAAM,eAAe,GAAG,CAC5B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,KACT,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,2BAA2B,CAAC;IAC3C,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,2BAA2B,CAAC;IAC3C,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;CAC5C;AA8BD,mEAAmE;AACnE,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,eAAO,MAAM,gCAAgC,EAAE,eA0H9C,CAAC;AA+GF;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,mBAAmB,EACjC,IAAI,GAAE,MAAkB,EACxB,UAAU,GAAE,eAAkD,GAC7D,OAAO,CAAC,qBAAqB,CAAC,CAiFhC;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,MAAkB,EACxB,UAAU,GAAE,eAAkD,GAC7D,OAAO,CAAC,oBAAoB,CAAC,CAoF/B;AAgBD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,MAAkB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CA4B9B;AAwDD,kFAAkF;AAClF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAqDhF"}