@adammcarter/use-cases 0.1.0

package/packages/core/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@adammcarter/use-cases-core",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Core domain library for @adammcarter/use-cases.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adammcarter/use-cases.git",
+    "directory": "packages/core"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "private": true,
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --pretty false",
+    "prepublishOnly": "tsc -b && node scripts/copy-schemas.mjs"
+  },
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "unified": "^11.0.5",
+    "yaml": "^2.9.0"
+  }
+}

package/packages/mcp/README.md

@@ -0,0 +1,48 @@
+# @adammcarter/use-cases-mcp
+
+Local stdio [Model Context Protocol](https://modelcontextprotocol.io) server for
+**use-cases** — exposing the full workflow (matrix, freshness,
+evidence, showcase, host applicability, and more) to coding agents without a GUI.
+
+## Install
+
+This is an internal workspace package — it is **not published separately**. It
+ships bundled inside the
+[`use-cases`](https://www.npmjs.com/package/use-cases) package:
+
+```bash
+npm i -g use-cases
+```
+
+That provides the `uc-mcp` binary (and its `use-cases-mcp` long-form alias).
+
+## Usage
+
+Configure your MCP client to launch the server over stdio:
+
+```json
+{
+  "mcpServers": {
+    "use-cases": {
+      "command": "npx",
+      "args": ["-y", "@adammcarter/use-cases-mcp"]
+    }
+  }
+}
+```
+
+## Security model
+
+The server ships a conservative default safety policy: mutations are gated, there
+is no generic shell tool, signing/`prove` is not exposed, and the workspace root
+is locked. MCP **tool names** and their input/output schemas are versioned public
+contracts.
+
+See the
+[MCP reference](https://github.com/adammcarter/use-cases/blob/main/docs/mcp.md)
+and the
+[stability & versioning policy](https://github.com/adammcarter/use-cases/blob/main/docs/reference/stability.md).
+
+## License
+
+[MIT](https://github.com/adammcarter/use-cases/blob/main/LICENSE)

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

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+type JsonRpcRequest = {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    method?: string;
+    params?: unknown;
+};
+type JsonRpcResponse = {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+};
+export declare function handleMcpMessage(message: JsonRpcRequest): JsonRpcResponse | null;
+export declare function startStdioServer(): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA6BA,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,GAAG,IAAI,CAkHhF;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAiCvC"}

package/packages/mcp/dist/index.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { createInterface } from "node:readline";
+import { stdin, stdout } from "node:process";
+import { fileURLToPath } from "node:url";
+import { callMcpTool, mcpTools } from "./tools.js";
+import { listMcpResources, readMcpResource } from "./resources.js";
+import { getMcpPrompt, mcpPrompts } from "./prompts.js";
+const { getVersionInfo } = await loadUcmCore();
+async function loadUcmCore() {
+    try {
+        return await import("@adammcarter/use-cases-core");
+    }
+    catch (error) {
+        if (!isMissingCorePackage(error)) {
+            throw error;
+        }
+        const bundledCoreSpecifier = "../../core/dist/index.js";
+        return await import(bundledCoreSpecifier);
+    }
+}
+function isMissingCorePackage(error) {
+    return error instanceof Error && "code" in error && error.code === "ERR_MODULE_NOT_FOUND" && error.message.includes("@adammcarter/use-cases-core");
+}
+export function handleMcpMessage(message) {
+    if (message.method === "notifications/initialized") {
+        return null;
+    }
+    const id = message.id ?? null;
+    if (message.method === "initialize") {
+        return {
+            jsonrpc: "2.0",
+            id,
+            result: {
+                protocolVersion: "2025-11-25",
+                capabilities: {
+                    tools: {},
+                    resources: {},
+                    prompts: {}
+                },
+                serverInfo: getVersionInfo()
+            }
+        };
+    }
+    if (message.method === "tools/list") {
+        return {
+            jsonrpc: "2.0",
+            id,
+            result: {
+                tools: mcpTools
+            }
+        };
+    }
+    if (message.method === "tools/call") {
+        const params = isRecord(message.params) ? message.params : {};
+        const name = typeof params.name === "string" ? params.name : "";
+        const args = isRecord(params.arguments) ? params.arguments : {};
+        const envelope = callMcpTool(name, args);
+        return {
+            jsonrpc: "2.0",
+            id,
+            result: {
+                content: [{ type: "text", text: JSON.stringify(envelope) }],
+                structuredContent: envelope,
+                isError: false
+            }
+        };
+    }
+    if (message.method === "resources/list") {
+        return {
+            jsonrpc: "2.0",
+            id,
+            result: {
+                resources: listMcpResources()
+            }
+        };
+    }
+    if (message.method === "resources/read") {
+        const params = isRecord(message.params) ? message.params : {};
+        const uri = typeof params.uri === "string" ? params.uri : "";
+        const outcome = readMcpResource(uri);
+        if (outcome.ok) {
+            return {
+                jsonrpc: "2.0",
+                id,
+                result: { contents: outcome.contents }
+            };
+        }
+        return {
+            jsonrpc: "2.0",
+            id,
+            error: { code: outcome.code, message: outcome.message }
+        };
+    }
+    if (message.method === "prompts/list") {
+        return {
+            jsonrpc: "2.0",
+            id,
+            result: {
+                prompts: mcpPrompts
+            }
+        };
+    }
+    if (message.method === "prompts/get") {
+        const params = isRecord(message.params) ? message.params : {};
+        const name = typeof params.name === "string" ? params.name : "";
+        const args = isRecord(params.arguments) ? params.arguments : {};
+        const outcome = getMcpPrompt(name, args);
+        if (outcome.ok) {
+            return {
+                jsonrpc: "2.0",
+                id,
+                result: outcome.result
+            };
+        }
+        return {
+            jsonrpc: "2.0",
+            id,
+            error: { code: outcome.code, message: outcome.message }
+        };
+    }
+    return {
+        jsonrpc: "2.0",
+        id,
+        error: {
+            code: -32601,
+            message: `Method not found: ${message.method ?? "<missing>"}`
+        }
+    };
+}
+export function startStdioServer() {
+    const lines = createInterface({
+        input: stdin,
+        crlfDelay: Infinity,
+        terminal: false
+    });
+    lines.on("line", (line) => {
+        if (!line.trim()) {
+            return;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            const response = {
+                jsonrpc: "2.0",
+                id: null,
+                error: {
+                    code: -32700,
+                    message: "Parse error"
+                }
+            };
+            stdout.write(`${JSON.stringify(response)}\n`);
+            return;
+        }
+        const response = handleMcpMessage(parsed);
+        if (response) {
+            stdout.write(`${JSON.stringify(response)}\n`);
+        }
+    });
+}
+function isEntrypoint() {
+    if (!process.argv[1]) {
+        return false;
+    }
+    try {
+        return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntrypoint()) {
+    startStdioServer();
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=index.js.map

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

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

package/packages/mcp/dist/prompts.d.ts

@@ -0,0 +1,32 @@
+export type McpPromptArgument = {
+    name: string;
+    description: string;
+    required: boolean;
+};
+export type McpPromptDescriptor = {
+    name: string;
+    description: string;
+    arguments: McpPromptArgument[];
+};
+export type McpPromptMessage = {
+    role: "user" | "assistant";
+    content: {
+        type: "text";
+        text: string;
+    };
+};
+export type McpPromptResult = {
+    description: string;
+    messages: McpPromptMessage[];
+};
+export declare const mcpPrompts: McpPromptDescriptor[];
+export type GetPromptOutcome = {
+    ok: true;
+    result: McpPromptResult;
+} | {
+    ok: false;
+    code: number;
+    message: string;
+};
+export declare function getMcpPrompt(name: string, args: Record<string, unknown>): GetPromptOutcome;
+//# sourceMappingURL=prompts.d.ts.map

package/packages/mcp/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AA2LF,eAAO,MAAM,UAAU,EAAE,mBAAmB,EAE3C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAiB1F"}

package/packages/mcp/dist/prompts.js

@@ -0,0 +1,199 @@
+// MCP prompts: guided agent workflows as text templates (MCP 2025-11-25).
+//
+// Prompts are PURE TEXT. They never execute commands, run verifiers, or mint
+// proofs — they explain the real `uc` CLI workflow so an agent can drive it
+// through the host. Every command + flag named here is verified against
+// packages/cli (matrix / init / bind / verify / scan / recover / keygen / prove /
+// validate-ledger / evidence). The headline is the KEYLESS DAILY LOOP:
+// bind -> verify -> scan shows local_status VERIFIED_LOCAL, with NO keys and NO
+// CI. Signing (keygen + prove, or recover --signing-key-env) is the OPT-IN upgrade
+// to signed FRESH for release/audit; `prove` is deliberately absent from the MCP
+// tool surface and only ever runs in trusted CI.
+function arg(name, description, required = false) {
+    return { name, description, required };
+}
+function userMessage(text) {
+    return { role: "user", content: { type: "text", text } };
+}
+// `repo` placeholder used in example commands; falls back to a readable token.
+function repoOf(args) {
+    const value = args.repo;
+    return value && value.length > 0 ? value : "<repo>";
+}
+function rowOf(args) {
+    const value = args.row;
+    return value && value.length > 0 ? value : "<row-id>";
+}
+const promptDefinitions = [
+    {
+        name: "uc/adopt-repo",
+        description: "Bring a repository under Use-Case Matrix governance the keyless way: author the workspace, bind rows to code, verify, and confirm VERIFIED_LOCAL — then add signed CI proofs only when you need a release gate.",
+        arguments: [arg("repo", "Absolute path to the repository/workspace root.")],
+        build: (args) => {
+            const repo = repoOf(args);
+            return {
+                description: "Step-by-step adoption of the use-case matrix — keyless daily loop first, signing opt-in.",
+                messages: [
+                    userMessage([
+                        "Goal: adopt Use Cases in this repository so every shippable behaviour is a matrix row bound to code and confirmed still-covered by the KEYLESS daily loop — no keys, no CI. Signing is an opt-in upgrade you add later, only when you want a cryptographic release gate.",
+                        "",
+                        `Fastest start: \`uc init --repo ${repo}\` scaffolds the workspace (a use-cases.yml config + a use-cases/ directory with one example row). To adopt by hand instead — e.g. onto an existing repo — author the same two things:`,
+                        `1. A workspace config \`use-cases.yml\` at the repo root (declares data_root, use_cases_dir, component_id, and optional verifiers/release_gate).`,
+                        "2. A `use-cases/` directory of use-case YAML files, one row per behaviour.",
+                        "",
+                        "THE KEYLESS DAILY LOOP — no keys, no CI:",
+                        `- Validate the matrix:    uc matrix validate --repo ${repo} --json`,
+                        `- List/inspect rows:      uc matrix list --repo ${repo} --json`,
+                        `- Bind a row to code:     uc bind --repo ${repo} --row <row-id> --file <path> --mode explicit --start-line <n> --end-line <m> --json`,
+                        `                          (or --mode swift-func --line <n> for a Swift function body)`,
+                        `- Verify locally:         uc verify --repo ${repo} --all --json`,
+                        "                          (with no --out this writes the UNSIGNED results ledger to <data-root>/.use-cases/verification-results.jsonl, which scan auto-discovers)",
+                        `- Scan freshness:         uc scan --repo ${repo} --json`,
+                        "                          each verified row reports local_status: VERIFIED_LOCAL (status stays UNPROVEN — that is a healthy keyless row). `uc scan --gate` exits non-zero if a required row is below the bar (>= VERIFIED_LOCAL by default).",
+                        "",
+                        "OPT-IN UPGRADE — signed proofs (FRESH) for a release/audit gate, in trusted CI only:",
+                        `- Generate a keypair:     uc keygen --out <dir-outside-repo> --ci github   (private key is a CI secret — never in the repo)`,
+                        `- Mint proofs (CI):       uc prove --repo ${repo} --all --verification-results <results> --append --trusted-ci --signing-key-env <ENV> --json`,
+                        `- Gate the ledger:        uc validate-ledger --repo ${repo} --json`,
+                        `- Release gate:           uc scan --repo ${repo} --policy-mode release --gate --json`,
+                        "",
+                        "`prove` mints signed proofs and must run only in trusted CI; it is intentionally not exposed over MCP. Everyday agent work stays keyless. Use the read-only MCP resources (uc://matrix, uc://freshness, uc://ledger, uc://bindings) to inspect state at any point."
+                    ].join("\n"))
+                ]
+            };
+        }
+    },
+    {
+        name: "uc/bind-row",
+        description: "Bind one matrix row to the code that implements it, verify it, and confirm the keyless VERIFIED_LOCAL green — no keys, no CI.",
+        arguments: [
+            arg("row", "The row id to bind (e.g. auth.login).", true),
+            arg("file", "Path to the source file that implements the row."),
+            arg("repo", "Absolute path to the repository/workspace root.")
+        ],
+        build: (args) => {
+            const repo = repoOf(args);
+            const row = rowOf(args);
+            const file = args.file && args.file.length > 0 ? args.file : "<path/to/source>";
+            return {
+                description: `Bind row ${row} to its implementation and take it to VERIFIED_LOCAL.`,
+                messages: [
+                    userMessage([
+                        `Goal: bind matrix row \`${row}\` to the code that implements it and confirm it is green the keyless way — bind -> verify -> VERIFIED_LOCAL, with no keys and no CI.`,
+                        "",
+                        "1. Confirm the row exists in the matrix:",
+                        `   uc matrix list --repo ${repo} --json   (look for ${row})`,
+                        "",
+                        "2. Place a binding marker in the source and register it. For an explicit line span (--mode explicit REQUIRES both --start-line and --end-line):",
+                        `   uc bind --repo ${repo} --row ${row} --file ${file} --mode explicit --start-line <n> --end-line <m> --json`,
+                        "   For a Swift function body (span inferred from the function line):",
+                        `   uc bind --repo ${repo} --row ${row} --file ${file} --mode swift-func --line <n> --json`,
+                        "   Add --suffix <name> to register more than one binding slug for the same row; add --register-existing to register a marker already present in the source.",
+                        "",
+                        "3. Run the row's verifier (with no --out this writes the UNSIGNED results ledger scan auto-discovers):",
+                        `   uc verify --repo ${repo} --row ${row} --json`,
+                        "",
+                        "4. Confirm the keyless green:",
+                        `   uc scan --repo ${repo} --json`,
+                        `   The row should report local_status: VERIFIED_LOCAL (status stays UNPROVEN — a healthy keyless row: a binding + a passing local verify, no signed proof yet).`,
+                        "",
+                        "Binding only edits source + the append-only registry, and verify only writes an UNSIGNED local ledger. Neither mints a proof — signing to FRESH is the opt-in upgrade that runs in trusted CI (`uc prove`), which is not available over MCP."
+                    ].join("\n"))
+                ]
+            };
+        }
+    },
+    {
+        name: "uc/recover-suspect-row",
+        description: "Drive a drifted / unproven row back to green in one command — keyless VERIFIED_LOCAL by default, signed FRESH as an opt-in upgrade.",
+        arguments: [
+            arg("row", "The drifted row id to recover (e.g. auth.login).", true),
+            arg("repo", "Absolute path to the repository/workspace root.")
+        ],
+        build: (args) => {
+            const repo = repoOf(args);
+            const row = rowOf(args);
+            return {
+                description: `Recover row ${row} back to green (VERIFIED_LOCAL keyless-first; FRESH opt-in).`,
+                messages: [
+                    userMessage([
+                        `Goal: get row \`${row}\` back to green. Keyless-first: the everyday target is local_status: VERIFIED_LOCAL (no keys, no CI). Re-proving to signed FRESH is the opt-in upgrade for a release/audit gate.`,
+                        "",
+                        "Why a row drifts off green:",
+                        "- STALE_LOCAL (keyless): a local verify result exists but the bound code or the test has changed since — the keyless analogue of SUSPECT.",
+                        "- UNVERIFIED_LOCAL: the row is bound but has never been verified locally.",
+                        "- SUSPECT / UNPROVEN (signed tier): a signed proof is stale (code/binding/verifier changed) or absent.",
+                        "",
+                        "1. Inspect the current state and the exact reason:",
+                        `   uc scan --repo ${repo} --json   (read rows[].status, rows[].local_status and rows[].reasons for ${row})`,
+                        "",
+                        "2. If the binding moved (code edited/relocated), re-bind so the marker tracks the new span:",
+                        `   uc bind --repo ${repo} --row ${row} --file <path> --mode explicit --start-line <n> --end-line <m> --json`,
+                        "",
+                        "3. Recover in one command — re-verify and report the new state:",
+                        `   uc recover --repo ${repo} --row ${row} --json`,
+                        "   This re-runs the row's verifier (the same run as `uc verify`), writes the unsigned results ledger, re-scans, and reports the resulting local_status/status. The row returns to VERIFIED_LOCAL. `uc recover` NEVER fakes green: if the verifier genuinely fails it exits non-zero and names the failing row — fix the code or the test, then re-run.",
+                        `   To inspect a raw verifier run on its own, use \`uc verify --repo ${repo} --row ${row} --json\`.`,
+                        "",
+                        "4. OPT-IN — also re-prove to signed FRESH (release/audit only, trusted CI):",
+                        `   uc recover --repo ${repo} --row ${row} --signing-key-env UCM_CI_SIGNING_KEY --public-key <path> --json`,
+                        "   Supplying --signing-key-env additionally mints a signed proof (trusted-CI). Signing runs only in trusted CI and is intentionally not exposed over MCP; do not attempt to sign from an ordinary agent session.",
+                        "",
+                        "5. Confirm the row is green again:",
+                        `   uc scan --repo ${repo} --json   (expect local_status: VERIFIED_LOCAL, or status: FRESH if you re-proved)`,
+                        `   uc validate-ledger --repo ${repo} --json   (signed tier only)`
+                    ].join("\n"))
+                ]
+            };
+        }
+    },
+    {
+        name: "uc/release-review",
+        description: "Before a release, confirm every required_for_release row is FRESH and the ledger is intact.",
+        arguments: [arg("repo", "Absolute path to the repository/workspace root.")],
+        build: (args) => {
+            const repo = repoOf(args);
+            return {
+                description: "Release gate review for required_for_release rows.",
+                messages: [
+                    userMessage([
+                        "Goal: confirm the matrix is release-ready — every row marked required_for_release is FRESH and the proof ledger is intact.",
+                        "",
+                        "1. Run the release-mode scan with the gate (release policy blocks any required row that is not FRESH, and any INVALID row; --gate turns that into a non-zero exit for CI):",
+                        `   uc scan --repo ${repo} --policy-mode release --gate --json`,
+                        "   Read guard_ok plus rows[]: every row with required_for_release=true must have status FRESH and policy_block=false. (Outside release, the gate bar is >= VERIFIED_LOCAL — the keyless green.)",
+                        "",
+                        "2. Cross-check matrix + evidence health:",
+                        `   uc matrix status --repo ${repo} --json`,
+                        "",
+                        "3. Validate ledger/registry integrity (append-only discipline, signatures, hash chain):",
+                        `   uc validate-ledger --repo ${repo} --json`,
+                        "",
+                        "If any required row is SUSPECT/UNPROVEN/UNBOUND/INVALID, recover it (see the uc/recover-suspect-row prompt) before releasing.",
+                        "These are read-only checks — you can also inspect uc://freshness, uc://ledger, and uc://matrix/status over MCP without running anything."
+                    ].join("\n"))
+                ]
+            };
+        }
+    }
+];
+export const mcpPrompts = promptDefinitions.map(({ build: _build, ...descriptor }) => descriptor);
+export function getMcpPrompt(name, args) {
+    const definition = promptDefinitions.find((candidate) => candidate.name === name);
+    if (!definition) {
+        return { ok: false, code: -32602, message: `Unknown prompt: ${name}` };
+    }
+    const stringArgs = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (typeof value === "string") {
+            stringArgs[key] = value;
+        }
+    }
+    for (const required of definition.arguments.filter((entry) => entry.required)) {
+        if (!stringArgs[required.name]) {
+            return { ok: false, code: -32602, message: `Prompt '${name}' requires argument '${required.name}'.` };
+        }
+    }
+    return { ok: true, result: definition.build(stringArgs) };
+}
+//# sourceMappingURL=prompts.js.map

package/packages/mcp/dist/prompts.js.map

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

package/packages/mcp/dist/resources.d.ts

@@ -0,0 +1,22 @@
+export type McpResourceDescriptor = {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+};
+export declare const mcpResources: McpResourceDescriptor[];
+export type ReadResourceOutcome = {
+    ok: true;
+    contents: Array<{
+        uri: string;
+        mimeType: string;
+        text: string;
+    }>;
+} | {
+    ok: false;
+    code: number;
+    message: string;
+};
+export declare function listMcpResources(): McpResourceDescriptor[];
+export declare function readMcpResource(uri: string): ReadResourceOutcome;
+//# sourceMappingURL=resources.d.ts.map

package/packages/mcp/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAsDA,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,qBAAqB,EAiD/C,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAC9E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,wBAAgB,gBAAgB,IAAI,qBAAqB,EAAE,CAE1D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CA4ChE"}