@untangle-code/cli 0.0.0-stage → 0.1.1

package/dist/mcp/server.js

@@ -0,0 +1,257 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import * as z from "zod/v4";
+import { CLI_VERSION } from "../cli/version.js";
+import { DefaultUntangleMcpRuntime } from "./default-runtime.js";
+import { mcpFailure } from "./envelope.js";
+import { canonicalPotentialPath, canonicalizeToolPathsInsideWorkspace, InvalidWorkspacePathError, PathOutsideWorkspaceError, } from "./path-sandbox.js";
+import { UNTANGLE_MCP_TOOLS } from "./tools.js";
+import { UNTANGLE_MCP_TOOL_NAMES, } from "./types.js";
+const warningSchema = z
+    .object({
+    code: z.string(),
+    message: z.string(),
+    details: z.record(z.string(), z.json()).optional(),
+})
+    .strict();
+const toolErrorSchema = z
+    .object({
+    code: z.string(),
+    message: z.string(),
+    retryable: z.boolean(),
+    details: z.record(z.string(), z.json()).optional(),
+})
+    .strict();
+const indexStateSchema = z
+    .object({
+    generationId: z.string(),
+    status: z.string(),
+    stale: z.boolean(),
+})
+    .strict();
+const toolNameSchema = z.enum(UNTANGLE_MCP_TOOL_NAMES);
+const successDataSchemas = new Map(UNTANGLE_MCP_TOOLS.map((definition) => [definition.name, definition.successDataSchema]));
+const knownSuccessEnvelopeSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    ok: z.literal(true),
+    operation: toolNameSchema,
+    workspaceId: z.string().optional(),
+    data: z.unknown(),
+    warnings: z.array(warningSchema),
+    indexState: indexStateSchema.optional(),
+})
+    .strict()
+    .superRefine((envelope, context) => {
+    const schema = successDataSchemas.get(envelope.operation);
+    const parsed = schema?.safeParse(envelope.data);
+    if (parsed?.success === true)
+        return;
+    context.addIssue({
+        code: "custom",
+        path: ["data"],
+        message: `Data does not match the success contract for ${envelope.operation}.`,
+    });
+});
+/** The wire contract from spec.md section 21.2. */
+export const toolResponseEnvelopeSchema = z.discriminatedUnion("ok", [
+    knownSuccessEnvelopeSchema,
+    z
+        .object({
+        schemaVersion: z.literal(1),
+        ok: z.literal(false),
+        operation: toolNameSchema,
+        workspaceId: z.string().optional(),
+        warnings: z.array(warningSchema),
+        error: toolErrorSchema,
+        indexState: indexStateSchema.optional(),
+    })
+        .strict(),
+]);
+/**
+ * Creates one transport-neutral server instance. The public CLI package owns
+ * this runtime so programmatic and binary consumers cannot drift apart.
+ */
+export function createUntangleMcpServer(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const env = options.env ?? process.env;
+    const runtime = options.runtime ?? new DefaultUntangleMcpRuntime();
+    const configuredRoots = options.workspaceRoots ?? [];
+    const workspaceRoots = uniqueCanonicalRoots(configuredRoots.length === 0 ? [cwd] : configuredRoots);
+    const server = new McpServer({ name: "untangle", version: CLI_VERSION }, { capabilities: { tools: {} } });
+    for (const definition of UNTANGLE_MCP_TOOLS) {
+        const outputSchema = outputEnvelopeSchema(definition);
+        server.registerTool(definition.name, {
+            description: definition.description,
+            // The SDK normally turns validation failures into a text-only tool
+            // error before our handler runs. Advertise the exact schema, but let
+            // this boundary validate manually so EVERY tool result still carries
+            // the normative §21.2 envelope.
+            inputSchema: advertiseSchemaWithoutPrevalidation(definition.inputSchema),
+            outputSchema,
+        }, async (input, requestContext) => {
+            return executeMcpToolInvocation(definition, input, {
+                cwd,
+                env,
+                runtime,
+                workspaceRoots,
+                signal: requestContext.mcpReq.signal,
+            });
+        });
+    }
+    return server;
+}
+/**
+ * One testable invocation boundary. Keeping cancellation here means an
+ * already-aborted request never reaches a storage adapter or mutating use case.
+ */
+export async function executeMcpToolInvocation(definition, input, options) {
+    let envelope;
+    try {
+        if (options.signal.aborted) {
+            envelope = mcpFailure(definition.name, "CANCELLED", "The MCP operation was cancelled.", false);
+            return toCallToolResult(definition, envelope);
+        }
+        const parsed = definition.inputSchema.safeParse(input);
+        if (!parsed.success) {
+            envelope = mcpFailure(definition.name, "INVALID_ARGUMENT", `Invalid arguments for MCP tool "${definition.name}".`, false, { details: { issues: publicZodIssues(parsed.error) } });
+            return toCallToolResult(definition, envelope);
+        }
+        const canonicalInput = canonicalizeToolPathsInsideWorkspace(parsed.data, definition.pathFields, {
+            cwd: options.cwd,
+            workspaceRoots: options.workspaceRoots,
+        });
+        if (options.signal.aborted) {
+            envelope = mcpFailure(definition.name, "CANCELLED", "The MCP operation was cancelled.", false);
+            return toCallToolResult(definition, envelope);
+        }
+        envelope = await options.runtime.invoke(definition.name, canonicalInput, {
+            cwd: options.cwd,
+            env: options.env,
+            signal: options.signal,
+        });
+        if (options.signal.aborted) {
+            envelope = mcpFailure(definition.name, "CANCELLED", "The MCP operation was cancelled.", false);
+        }
+    }
+    catch (error) {
+        envelope = options.signal.aborted
+            ? mcpFailure(definition.name, "CANCELLED", "The MCP operation was cancelled.", false)
+            : serverFailure(definition.name, error);
+    }
+    return toCallToolResult(definition, envelope);
+}
+/**
+ * Keeps the advertised JSON Schema byte-for-byte equivalent to the Zod
+ * schema while deferring validation to our envelope-producing handler.
+ */
+function advertiseSchemaWithoutPrevalidation(schema) {
+    const standard = schema["~standard"];
+    return {
+        "~standard": {
+            ...standard,
+            validate: (value) => ({ value }),
+        },
+    };
+}
+function outputEnvelopeSchema(definition) {
+    return z.discriminatedUnion("ok", [
+        z
+            .object({
+            schemaVersion: z.literal(1),
+            ok: z.literal(true),
+            operation: z.literal(definition.name),
+            workspaceId: z.string().optional(),
+            data: definition.successDataSchema,
+            warnings: z.array(warningSchema),
+            indexState: indexStateSchema.optional(),
+        })
+            .strict(),
+        z
+            .object({
+            schemaVersion: z.literal(1),
+            ok: z.literal(false),
+            operation: z.literal(definition.name),
+            workspaceId: z.string().optional(),
+            warnings: z.array(warningSchema),
+            error: toolErrorSchema,
+            indexState: indexStateSchema.optional(),
+        })
+            .strict(),
+    ]);
+}
+function publicZodIssues(error) {
+    return error.issues.slice(0, 32).map((issue) => ({
+        code: issue.code,
+        path: issue.path.map(String).join("."),
+        message: issue.message,
+    }));
+}
+function toCallToolResult(definition, value) {
+    const operation = definition.name;
+    let envelope;
+    try {
+        const parsed = toolResponseEnvelopeSchema.safeParse(value);
+        if (!parsed.success || parsed.data.operation !== operation) {
+            envelope = invalidRuntimeEnvelope(operation, parsed.success ? "operation mismatch" : "schema mismatch");
+        }
+        else if (parsed.data.ok) {
+            const data = definition.successDataSchema.safeParse(parsed.data.data);
+            envelope = data.success
+                ? { ...parsed.data, data: data.data }
+                : invalidRuntimeEnvelope(operation, "success data schema mismatch");
+        }
+        else {
+            envelope = parsed.data;
+        }
+        const structuredContent = jsonObject(envelope);
+        return {
+            content: [{ type: "text", text: JSON.stringify(structuredContent) }],
+            structuredContent,
+            isError: !envelope.ok,
+        };
+    }
+    catch {
+        envelope = invalidRuntimeEnvelope(operation, "response was not JSON serializable");
+        const structuredContent = jsonObject(envelope);
+        return {
+            content: [{ type: "text", text: JSON.stringify(structuredContent) }],
+            structuredContent,
+            isError: true,
+        };
+    }
+}
+function invalidRuntimeEnvelope(operation, reason) {
+    return mcpFailure(operation, "INVALID_INTERNAL_OUTPUT", `The MCP runtime returned an invalid response envelope (${reason}).`, false);
+}
+function serverFailure(operation, error) {
+    if (error instanceof PathOutsideWorkspaceError) {
+        return mcpFailure(operation, "PATH_OUTSIDE_WORKSPACE", error.message, false, {
+            details: { requestedPath: error.requestedPath },
+        });
+    }
+    if (error instanceof InvalidWorkspacePathError) {
+        return mcpFailure(operation, "INVALID_ARGUMENT", error.message, false, {
+            details: { requestedPath: error.requestedPath },
+        });
+    }
+    if (error instanceof Error && error.name === "AbortError") {
+        return mcpFailure(operation, "CANCELLED", "The MCP operation was cancelled.", false);
+    }
+    return mcpFailure(operation, "INTERNAL_ERROR", error instanceof Error ? error.message : String(error), false);
+}
+function uniqueCanonicalRoots(roots) {
+    return [...new Set(roots.map(canonicalPotentialPath))];
+}
+/** Makes the JSON boundary explicit and rejects accidental non-JSON values. */
+function jsonObject(value) {
+    const serialized = JSON.stringify(value);
+    if (serialized === undefined) {
+        throw new TypeError("The MCP response is not JSON serializable.");
+    }
+    const parsed = JSON.parse(serialized);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new TypeError("The MCP response envelope must be a JSON object.");
+    }
+    return parsed;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/stdio.d.ts

@@ -0,0 +1,20 @@
+import { StdioServerTransport, type StdioServerHandle } from "@modelcontextprotocol/server/stdio";
+import { type CreateUntangleMcpServerOptions } from "./server.js";
+export interface ServeUntangleMcpStdioOptions extends CreateUntangleMcpServerOptions {
+    readonly onerror?: (error: Error) => void;
+    /** Injection seam for lifecycle tests and non-process stdio bindings. */
+    readonly transport?: StdioServerTransport;
+}
+export type UntangleStdioCloseOutcome = {
+    readonly reason: "closed";
+} | {
+    readonly reason: "error";
+    readonly error: Error;
+};
+export interface UntangleStdioServerHandle extends StdioServerHandle {
+    /** Settles when the owned wire transport actually closes. */
+    readonly closed: Promise<UntangleStdioCloseOutcome>;
+}
+/** Starts the dual-era MCP stdio binding. stdout remains JSON-RPC only. */
+export declare function serveUntangleMcpStdio(options?: ServeUntangleMcpStdioOptions): UntangleStdioServerHandle;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/mcp/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,EACpB,KAAK,iBAAiB,EACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAA2B,KAAK,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAE3F,MAAM,WAAW,4BAA6B,SAAQ,8BAA8B;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC1C,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAC3C;AAED,MAAM,MAAM,yBAAyB,GACnC;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEtF,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACrD;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,yBAAyB,CAkE3B"}

package/dist/mcp/stdio.js

@@ -0,0 +1,71 @@
+import { serveStdio, StdioServerTransport, } from "@modelcontextprotocol/server/stdio";
+import { createUntangleMcpServer } from "./server.js";
+/** Starts the dual-era MCP stdio binding. stdout remains JSON-RPC only. */
+export function serveUntangleMcpStdio(options = {}) {
+    const transport = options.transport ?? new StdioServerTransport();
+    let pendingTransportError;
+    let closingFromHandle = false;
+    let settleClosed;
+    let didSettle = false;
+    const closed = new Promise((resolve) => {
+        settleClosed = (outcome) => {
+            if (didSettle)
+                return;
+            didSettle = true;
+            resolve(outcome);
+        };
+    });
+    // The upstream handle exposes close(), but not the wire's close event. A
+    // fatal buffer/stdout failure calls transport.close() while stdin may stay
+    // open; intercepting that actual close gives the CLI a lifecycle signal.
+    // Recoverable protocol errors only call onerror and therefore do not end
+    // this promise.
+    const closeTransport = transport.close.bind(transport);
+    const startTransport = transport.start.bind(transport);
+    transport.start = async () => {
+        try {
+            await startTransport();
+        }
+        catch (error) {
+            settleClosed({
+                reason: "error",
+                error: error instanceof Error ? error : new Error(String(error)),
+            });
+            throw error;
+        }
+    };
+    transport.close = async () => {
+        const fatalError = closingFromHandle ? undefined : pendingTransportError;
+        try {
+            await closeTransport();
+        }
+        finally {
+            settleClosed(fatalError === undefined ? { reason: "closed" } : { reason: "error", error: fatalError });
+        }
+    };
+    const handle = serveStdio(() => createUntangleMcpServer(options), {
+        legacy: "serve",
+        transport,
+        onerror: (error) => {
+            pendingTransportError = error;
+            queueMicrotask(() => {
+                if (pendingTransportError === error)
+                    pendingTransportError = undefined;
+            });
+            options.onerror?.(error);
+        },
+    });
+    return {
+        closed,
+        async close() {
+            closingFromHandle = true;
+            try {
+                await handle.close();
+            }
+            finally {
+                settleClosed({ reason: "closed" });
+            }
+        },
+    };
+}
+//# sourceMappingURL=stdio.js.map

package/dist/mcp/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,oBAAoB,GAErB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,uBAAuB,EAAuC,MAAM,aAAa,CAAC;AAgB3F,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CACnC,UAAwC,EAAE;IAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,oBAAoB,EAAE,CAAC;IAClE,IAAI,qBAAwC,CAAC;IAC7C,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAC9B,IAAI,YAA2D,CAAC;IAChE,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,MAAM,GAAG,IAAI,OAAO,CAA4B,CAAC,OAAO,EAAE,EAAE;QAChE,YAAY,GAAG,CAAC,OAAO,EAAE,EAAE;YACzB,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,yEAAyE;IACzE,gBAAgB;IAChB,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvD,SAAS,CAAC,KAAK,GAAG,KAAK,IAAmB,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,cAAc,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC;gBACX,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACjE,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IACF,SAAS,CAAC,KAAK,GAAG,KAAK,IAAmB,EAAE;QAC1C,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC;QACzE,IAAI,CAAC;YACH,MAAM,cAAc,EAAE,CAAC;QACzB,CAAC;gBAAS,CAAC;YACT,YAAY,CACV,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CACzF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE;QAChE,MAAM,EAAE,OAAO;QACf,SAAS;QACT,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,qBAAqB,GAAG,KAAK,CAAC;YAC9B,cAAc,CAAC,GAAG,EAAE;gBAClB,IAAI,qBAAqB,KAAK,KAAK;oBAAE,qBAAqB,GAAG,SAAS,CAAC;YACzE,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,KAAK,CAAC,KAAK;YACT,iBAAiB,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}