@chances-ai/engine 24.0.0

package/dist/mcp/resources.d.ts

@@ -0,0 +1,70 @@
+import type { Tool } from "../tools/index.js";
+import type { McpResource, McpResourceContent } from "./types.js";
+/** A parsed `@<server>:<uri>` mention from user input. */
+export interface ResourceMention {
+    ref: string;
+    server: string;
+    uri: string;
+}
+/** A resource resolved (or attempted) for injection into a turn. */
+export interface McpResolvedResource {
+    ref: string;
+    server: string;
+    uri: string;
+    /** Rendered, capped, redacted content. Present on success. */
+    text?: string;
+    /** Why it couldn't be read (server offline, read error). Mutually exclusive
+     *  with `text`. Absent + absent text ⇒ caller skipped it (non-member). */
+    note?: string;
+}
+/**
+ * (5.4 D4) Extract `@<server>:<uri>` mentions. The `@` must start a token
+ * (`(^|\s)@`) so an email (`a@b.com`) never matches; the body must contain an
+ * internal colon so a bare `@channel` is ignored. We capture the whole
+ * non-whitespace run and then strip trailing PROSE punctuation
+ * (`. , ; : ! ? ) ]`) — NOT `/`, so a directory-style URI ending in `/` is kept
+ * (5.4 R2: the old trailing-`\b` silently truncated `…/tmp/` and `…/a.md.`,
+ * which then missed the exact-cached match). Split on the FIRST colon →
+ * `(server, uri)`. Deduped by `ref`.
+ */
+export declare function extractResourceMentions(text: string): ResourceMention[];
+/**
+ * (5.4 D9′) The narrow host surface the resource tools + mention resolver need.
+ * `readResource` returns the raw content plus the per-server redactor (the host
+ * owns the secret bag); rendering/persistence happens in the tool/resolver which
+ * have the workspace root. Throws `AppError` on unknown server / read failure /
+ * restart race so callers can surface a clean message.
+ */
+export interface McpResourceProvider {
+    /** Cached `resources/list` snapshot, optionally filtered to one server. */
+    resources(server?: string): McpResource[];
+    readResource(server: string, uri: string, signal: AbortSignal): Promise<{
+        contents: McpResourceContent[];
+        redact: (msg: string) => string;
+    }>;
+}
+export interface ResourceToolOptions {
+    /** UTF-8 byte cap for inline resource text (`config.mcp.resourceReadMaxBytes`). */
+    maxBytes: number;
+}
+/**
+ * (5.4 D5/N2) The two GLOBAL resource tools. They are intentionally NOT named
+ * `mcp__<server>__<tool>` (that prefix is reserved for bridged server tools) —
+ * single underscore + an explicit "global; pass {server, uri}" description so
+ * the model doesn't infer a server named `read`.
+ */
+export declare function makeResourceTools(provider: McpResourceProvider, opts: ResourceToolOptions): Tool[];
+/**
+ * (5.4 D4′/M3/S2) Resolve `@<server>:<uri>` mentions in DIRECTLY-TYPED user
+ * input. Only resolves mentions whose `(server, uri)` EXACTLY match the cached
+ * `resources/list` (S2 — a known-server prefix + arbitrary URI must go through
+ * the gated `mcp_read_resource` tool, never an ungated pre-turn read). Non-
+ * members are skipped (left as plain text). Read failures become a `note` and
+ * never throw — a bad @-ref must not abort the turn. NOT called on prompt-command
+ * output (M3 — the engine passes `expandMentions:false` for that).
+ */
+export declare function resolveMcpMentions(provider: McpResourceProvider, prompt: string, signal: AbortSignal, opts: {
+    maxBytes: number;
+    artifactRoot: string;
+}): Promise<McpResolvedResource[]>;
+//# sourceMappingURL=resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,IAAI,EAA2B,MAAM,mBAAmB,CAAC;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGlE,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;8EAC0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAgBvE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAC1C,YAAY,CACV,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC;QAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;QAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAUD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,EAAE,CAsFlG;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAuBhC"}

package/dist/mcp/resources.js

@@ -0,0 +1,170 @@
+import { AppError, ErrorCode } from "@chances-ai/runtime";
+import { formatResourceContents, persistResourceBlob } from "./content.js";
+/**
+ * (5.4 D4) Extract `@<server>:<uri>` mentions. The `@` must start a token
+ * (`(^|\s)@`) so an email (`a@b.com`) never matches; the body must contain an
+ * internal colon so a bare `@channel` is ignored. We capture the whole
+ * non-whitespace run and then strip trailing PROSE punctuation
+ * (`. , ; : ! ? ) ]`) — NOT `/`, so a directory-style URI ending in `/` is kept
+ * (5.4 R2: the old trailing-`\b` silently truncated `…/tmp/` and `…/a.md.`,
+ * which then missed the exact-cached match). Split on the FIRST colon →
+ * `(server, uri)`. Deduped by `ref`.
+ */
+export function extractResourceMentions(text) {
+    const re = /(^|\s)@(\S+)/g;
+    const seen = new Set();
+    const out = [];
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const ref = m[2].replace(/[.,;:!?)\]]+$/, "");
+        if (seen.has(ref))
+            continue;
+        seen.add(ref);
+        const colon = ref.indexOf(":");
+        if (colon <= 0)
+            continue; // no internal colon (or leading colon) → not a mention
+        const server = ref.slice(0, colon);
+        const uri = ref.slice(colon + 1);
+        if (server && uri)
+            out.push({ ref, server, uri });
+    }
+    return out;
+}
+function str(args, key) {
+    if (args && typeof args === "object" && !Array.isArray(args)) {
+        const v = args[key];
+        if (typeof v === "string")
+            return v;
+    }
+    return undefined;
+}
+/**
+ * (5.4 D5/N2) The two GLOBAL resource tools. They are intentionally NOT named
+ * `mcp__<server>__<tool>` (that prefix is reserved for bridged server tools) —
+ * single underscore + an explicit "global; pass {server, uri}" description so
+ * the model doesn't infer a server named `read`.
+ */
+export function makeResourceTools(provider, opts) {
+    const list = {
+        name: "mcp_list_resources",
+        description: "List resources exposed by connected MCP servers (global; optional {server} filter). " +
+            "Returns lines of '<server>:<uri>  <name>  (<mimeType>)'. Read one with mcp_read_resource.",
+        category: "search",
+        parameters: {
+            type: "object",
+            properties: { server: { type: "string", description: "Optional server id filter" } },
+        },
+        summarize: (args) => {
+            const s = str(args, "server");
+            return s ? `list MCP resources (server '${s}')` : "list MCP resources";
+        },
+        async execute(args) {
+            const server = str(args, "server");
+            const resources = provider.resources(server);
+            if (resources.length === 0) {
+                return { ok: true, output: server ? `(no resources on server '${server}')` : "(no MCP resources available)" };
+            }
+            const lines = resources.map((r) => {
+                const name = r.name ? `  ${r.name}` : "";
+                const mime = r.mimeType ? `  (${r.mimeType})` : "";
+                return `${r.server}:${r.uri}${name}${mime}`;
+            });
+            return { ok: true, output: lines.join("\n") };
+        },
+    };
+    const read = {
+        name: "mcp_read_resource",
+        description: "Read one MCP resource (global; pass {server, uri}). Text is returned inline (capped); " +
+            "binary blobs are saved to disk and referenced by path. Discover URIs with mcp_list_resources.",
+        category: "integration",
+        parameters: {
+            type: "object",
+            properties: {
+                server: { type: "string", description: "MCP server id" },
+                uri: { type: "string", description: "Resource URI" },
+            },
+            required: ["server", "uri"],
+        },
+        summarize: (args) => {
+            const server = str(args, "server") ?? "?";
+            const uri = str(args, "uri") ?? "?";
+            return `read resource '${uri}' from MCP server '${server}'`;
+        },
+        // (5.4 D5/M4) Per-server cache scope: approving reads from server A must
+        // not pre-approve server B. The slash lifecycle invalidates
+        // `mcp_read_resource/<server>` on restart/remove/logout.
+        permission(args, ctx) {
+            const server = str(args, "server") ?? "?";
+            return {
+                name: "mcp_read_resource",
+                category: "integration",
+                summary: this.summarize(args, ctx),
+                args,
+                cacheKey: `mcp_read_resource/${server}`,
+            };
+        },
+        async execute(args, ctx) {
+            const server = str(args, "server");
+            const uri = str(args, "uri");
+            if (!server || !uri) {
+                return { ok: false, output: "mcp_read_resource requires { server, uri }" };
+            }
+            try {
+                const { contents, redact } = await provider.readResource(server, uri, ctx.signal);
+                const root = ctx.parentWorkspaceRoot ?? ctx.workspaceRoot;
+                const output = formatResourceContents(contents, {
+                    redact,
+                    maxBytes: opts.maxBytes,
+                    persistBlob: (buf, mime) => persistResourceBlob(root, buf, mime),
+                });
+                return { ok: true, output: output || "(empty resource)" };
+            }
+            catch (e) {
+                if (ctx.signal.aborted)
+                    throw new AppError(ErrorCode.Cancelled, "Operation cancelled");
+                if (e instanceof AppError && e.code === ErrorCode.Cancelled)
+                    throw e;
+                return { ok: false, output: e.message };
+            }
+        },
+    };
+    return [list, read];
+}
+/**
+ * (5.4 D4′/M3/S2) Resolve `@<server>:<uri>` mentions in DIRECTLY-TYPED user
+ * input. Only resolves mentions whose `(server, uri)` EXACTLY match the cached
+ * `resources/list` (S2 — a known-server prefix + arbitrary URI must go through
+ * the gated `mcp_read_resource` tool, never an ungated pre-turn read). Non-
+ * members are skipped (left as plain text). Read failures become a `note` and
+ * never throw — a bad @-ref must not abort the turn. NOT called on prompt-command
+ * output (M3 — the engine passes `expandMentions:false` for that).
+ */
+export async function resolveMcpMentions(provider, prompt, signal, opts) {
+    const mentions = extractResourceMentions(prompt);
+    if (mentions.length === 0)
+        return [];
+    const out = [];
+    for (const mention of mentions) {
+        const member = provider
+            .resources(mention.server)
+            .some((r) => r.server === mention.server && r.uri === mention.uri);
+        if (!member)
+            continue; // S2: only exact cached members; else plain text.
+        try {
+            const { contents, redact } = await provider.readResource(mention.server, mention.uri, signal);
+            const text = formatResourceContents(contents, {
+                redact,
+                maxBytes: opts.maxBytes,
+                persistBlob: (buf, mime) => persistResourceBlob(opts.artifactRoot, buf, mime),
+            });
+            out.push({ ...mention, text: text || "(empty resource)" });
+        }
+        catch (e) {
+            if (signal.aborted)
+                throw new AppError(ErrorCode.Cancelled, "Operation cancelled");
+            out.push({ ...mention, note: `could not read: ${e.message}` });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAqB3E;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,EAAE,GAAG,eAAe,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS,CAAC,uDAAuD;QACjF,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACjC,IAAI,MAAM,IAAI,GAAG;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAwBD,SAAS,GAAG,CAAC,IAAe,EAAE,GAAW;IACvC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,CAAC,GAAI,IAAgC,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAA6B,EAAE,IAAyB;IACxF,MAAM,IAAI,GAAS;QACjB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,sFAAsF;YACtF,2FAA2F;QAC7F,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE,EAAE;SACrF;QACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC9B,OAAO,CAAC,CAAC,CAAC,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC;QACzE,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,4BAA4B,MAAM,IAAI,CAAC,CAAC,CAAC,8BAA8B,EAAE,CAAC;YAChH,CAAC;YACD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAChC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,OAAO,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YAC9C,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,CAAC;KACF,CAAC;IAEF,MAAM,IAAI,GAAS;QACjB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,wFAAwF;YACxF,+FAA+F;QACjG,QAAQ,EAAE,aAAa;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;gBACxD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;aACrD;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;SAC5B;QACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC;YAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC;YACpC,OAAO,kBAAkB,GAAG,sBAAsB,MAAM,GAAG,CAAC;QAC9D,CAAC;QACD,yEAAyE;QACzE,4DAA4D;QAC5D,yDAAyD;QACzD,UAAU,CAAC,IAAI,EAAE,GAAG;YAClB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC;YAC1C,OAAO;gBACL,IAAI,EAAE,mBAAmB;gBACzB,QAAQ,EAAE,aAAa;gBACvB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC;gBAClC,IAAI;gBACJ,QAAQ,EAAE,qBAAqB,MAAM,EAAE;aACxC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;YACrB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7B,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;gBACpB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,4CAA4C,EAAE,CAAC;YAC7E,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;gBAClF,MAAM,IAAI,GAAG,GAAG,CAAC,mBAAmB,IAAI,GAAG,CAAC,aAAa,CAAC;gBAC1D,MAAM,MAAM,GAAG,sBAAsB,CAAC,QAAQ,EAAE;oBAC9C,MAAM;oBACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,WAAW,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC;iBACjE,CAAC,CAAC;gBACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,kBAAkB,EAAE,CAAC;YAC5D,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO;oBAAE,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;gBACvF,IAAI,CAAC,YAAY,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,SAAS;oBAAE,MAAM,CAAC,CAAC;gBACrE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;YACrD,CAAC;QACH,CAAC;KACF,CAAC;IAEF,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAA6B,EAC7B,MAAc,EACd,MAAmB,EACnB,IAAgD;IAEhD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,GAAG,GAA0B,EAAE,CAAC;IACtC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,QAAQ;aACpB,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;aACzB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM;YAAE,SAAS,CAAC,kDAAkD;QACzE,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC9F,MAAM,IAAI,GAAG,sBAAsB,CAAC,QAAQ,EAAE;gBAC5C,MAAM;gBACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,WAAW,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,IAAI,CAAC;aAC9E,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,kBAAkB,EAAE,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;YACnF,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,mBAAoB,CAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Per-server config entry. The two transport flavors we ship in 3.1:
+ *   - `stdio`: spawn a subprocess and exchange JSON-RPC over stdin/stdout.
+ *     Default for most filesystem / cli MCP servers.
+ *   - `http`: hit a streamable-HTTP endpoint. The MCP spec replaces SSE with
+ *     streamable HTTP, so we don't ship SSE separately.
+ *
+ * `enabled: false` keeps the entry in config but skips connection on boot —
+ * useful for temporarily silencing a flaky server without losing its config.
+ */
+export type McpServerConfig = StdioMcpConfig | HttpMcpConfig;
+interface BaseMcpConfig {
+    /** Default true. Disabled servers are listed by `/mcp` but never connect. */
+    enabled?: boolean;
+    /** Per-request timeout in milliseconds; default 30 000. */
+    timeoutMs?: number;
+}
+export interface StdioMcpConfig extends BaseMcpConfig {
+    type: "stdio";
+    command: string;
+    args?: string[];
+    /** Extra env vars merged onto `process.env` when spawning the subprocess. */
+    env?: Record<string, string>;
+    cwd?: string;
+}
+export interface HttpMcpConfig extends BaseMcpConfig {
+    type: "http";
+    url: string;
+    headers?: Record<string, string>;
+    /** (3.7) Optional OAuth configuration. When present, the host wires
+     *  the chances OAuth provider into the SDK's streamable-HTTP
+     *  transport. See `oauth/types.ts` for the discriminated union. */
+    auth?: OAuthMcpAuth;
+}
+/**
+ * (3.7) OAuth configuration for an HTTP-transport MCP server.
+ * Currently `oauth` is the only `kind`; reserved for future variants
+ * like `client_credentials` (M2M) without breaking config schema.
+ */
+export interface OAuthMcpAuth {
+    kind: "oauth";
+    /** Optional explicit auth-server metadata URL. When absent, the SDK
+     *  probes RFC 9728 → RFC 8414 starting from `serverConfig.url`. */
+    authServerMetadataUrl?: string;
+    /** Pre-registered OAuth client ID. When absent, Dynamic Client
+     *  Registration (RFC 7591) runs on first flow. */
+    clientId?: string;
+    /** Pre-registered client secret. Only meaningful with `clientId`. */
+    clientSecret?: string;
+    /** OAuth scopes requested at consent. Empty array = the IdP's default. */
+    scopes?: readonly string[];
+    /** Override loopback callback port. When set, port-fallback is
+     *  DISABLED (oh-my-pi commit `c246d88db` lesson — silent fallback
+     *  breaks exact-URI-match with registered redirect_uri). */
+    callbackPort?: number;
+}
+/**
+ * Per-server lifecycle snapshot. Surfaced through `McpHost.status()` so the
+ * `/mcp` slash command can render a meaningful list — including failed
+ * servers, not just running ones (otherwise users can't tell why a tool
+ * disappeared).
+ */
+export interface McpServerStatus {
+    id: string;
+    state: "starting" | "ready" | "failed" | "disabled" | "disposed";
+    /** Populated when `state === "failed"`. */
+    error?: string;
+    /** Tools discovered after a successful `tools/list`. Undefined when not yet ready. */
+    toolCount?: number;
+    /** Names of tools registered into the engine's ToolRegistry. */
+    toolNames?: readonly string[];
+}
+/** Result of `/mcp test <name>` — a one-shot connect + list + dispose. */
+export interface McpTestResult {
+    ok: boolean;
+    /** When ok: the discovered tool names. Otherwise: the error reason. */
+    output: string;
+}
+/**
+ * (5.4) A resource a server advertises via `resources/list`. We keep the
+ * subset we surface; servers may carry more (annotations, size). `server` is
+ * stamped by the host so a flat resource list across servers stays attributable
+ * (the `@<server>:<uri>` mention + `mcp_read_resource({server, uri})` both need it).
+ */
+export interface McpResource {
+    /** Owning server id — stamped by the host, not the wire. */
+    server: string;
+    uri: string;
+    name?: string;
+    description?: string;
+    mimeType?: string;
+}
+/** One content item from `resources/read`. Text xor blob (base64). */
+export interface McpResourceContent {
+    uri?: string;
+    mimeType?: string;
+    text?: string;
+    /** base64 — persisted to disk by the reader, never inlined into context. */
+    blob?: string;
+}
+/** A declared argument of a server prompt (`prompts/list`). */
+export interface McpPromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+/**
+ * (5.4) A prompt a server advertises via `prompts/list`. `server` is stamped by
+ * the host. Surfaced as the slash command `/<server>:<name>`.
+ */
+export interface McpPrompt {
+    server: string;
+    name: string;
+    description?: string;
+    arguments?: McpPromptArgument[];
+}
+/** One message from `prompts/get` — role + MCP content part(s). */
+export interface McpPromptMessage {
+    role: "user" | "assistant";
+    content: unknown;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/mcp/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":""}

package/dist/memory/frontmatter.d.ts

@@ -0,0 +1,18 @@
+import { type MemoryType } from "./types.js";
+/**
+ * Minimal YAML-frontmatter reader. We intentionally don't pull in a YAML lib —
+ * the schema is fixed (name / description / type, all single-line strings), so
+ * a line-by-line parser is both smaller and safer (no surprise type coercion).
+ */
+export interface ParsedFrontmatter {
+    name: string;
+    description: string;
+    type: MemoryType;
+}
+export interface ParsedMemoryFile {
+    frontmatter: ParsedFrontmatter;
+    body: string;
+}
+export declare function parseMemoryFile(raw: string): ParsedMemoryFile | null;
+export declare function formatMemoryFile(fm: ParsedFrontmatter, body: string): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/memory/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/memory/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAID,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA8BpE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB5E"}

package/dist/memory/frontmatter.js

@@ -0,0 +1,81 @@
+import { isMemoryType } from "./types.js";
+const FRONTMATTER_DELIM = "---";
+export function parseMemoryFile(raw) {
+    const lines = raw.split(/\r?\n/);
+    if (lines[0]?.trim() !== FRONTMATTER_DELIM)
+        return null;
+    let end = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i]?.trim() === FRONTMATTER_DELIM) {
+            end = i;
+            break;
+        }
+    }
+    if (end < 0)
+        return null;
+    const fm = {};
+    for (let i = 1; i < end; i++) {
+        const line = lines[i] ?? "";
+        if (!line.trim() || line.trim().startsWith("#"))
+            continue;
+        const colon = line.indexOf(":");
+        if (colon < 0)
+            continue;
+        const key = line.slice(0, colon).trim();
+        const value = unquote(line.slice(colon + 1).trim());
+        if (key)
+            fm[key] = value;
+    }
+    const name = fm["name"];
+    const description = fm["description"] ?? "";
+    const type = fm["type"];
+    if (!name || !type || !isMemoryType(type))
+        return null;
+    // Strip the leading blank line that follows the closing `---`, and the
+    // trailing newline that POSIX-friendly file writers always append, so callers
+    // get the *content* without round-trip artifacts.
+    const body = lines.slice(end + 1).join("\n").replace(/^\n+/, "").replace(/\n+$/g, "");
+    return { frontmatter: { name, description, type }, body };
+}
+export function formatMemoryFile(fm, body) {
+    // Frontmatter values are single-line — collapse whitespace so a stray newline
+    // in name/description can't break the YAML scalar. Body keeps its newlines.
+    const safeName = singleLine(fm.name);
+    const safeDescription = singleLine(fm.description);
+    const trimmedBody = body.replace(/\r/g, "").replace(/\n+$/g, "");
+    return [
+        FRONTMATTER_DELIM,
+        `name: ${quoteIfNeeded(safeName)}`,
+        `description: ${quoteIfNeeded(safeDescription)}`,
+        `type: ${fm.type}`,
+        FRONTMATTER_DELIM,
+        "",
+        trimmedBody,
+        "",
+    ].join("\n");
+}
+function singleLine(s) {
+    return s.replace(/\s+/g, " ").trim();
+}
+function unquote(s) {
+    if (s.length >= 2 && s.startsWith("'") && s.endsWith("'")) {
+        // YAML single-quoted scalar: `''` is an escaped single quote.
+        return s.slice(1, -1).replace(/''/g, "'");
+    }
+    if (s.length >= 2 && s.startsWith('"') && s.endsWith('"')) {
+        return s.slice(1, -1).replace(/\\"/g, '"').replace(/\\\\/g, "\\");
+    }
+    return s;
+}
+function quoteIfNeeded(s) {
+    // Quote when YAML would otherwise misread the value: a leading special char or
+    // an internal colon. We always emit single-quoted form (only `'` itself needs
+    // escaping) so the unquote path doesn't have to handle YAML's full escape set.
+    if (s === "")
+        return "''";
+    if (/^[\s\-?:,\[\]{}#&*!|>'"%@`]/.test(s) || s.includes(":")) {
+        return `'${s.replace(/'/g, "''")}'`;
+    }
+    return s;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/memory/frontmatter.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,5 @@
+export { MEMORY_TYPES, MEMORY_SCOPES, isMemoryType, isMemoryScope, type MemoryType, type MemoryScope, type MemoryEntry, } from "./types.js";
+export { MemoryStore, slugify, type MemoryStoreOptions, type SaveInput } from "./store.js";
+export { parseMemoryFile, formatMemoryFile, type ParsedFrontmatter, type ParsedMemoryFile } from "./frontmatter.js";
+export { memoryTools } from "./tools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,5 @@
+export { MEMORY_TYPES, MEMORY_SCOPES, isMemoryType, isMemoryScope, } from "./types.js";
+export { MemoryStore, slugify } from "./store.js";
+export { parseMemoryFile, formatMemoryFile } from "./frontmatter.js";
+export { memoryTools } from "./tools.js";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,GAId,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,OAAO,EAA2C,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAiD,MAAM,kBAAkB,CAAC;AACpH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/memory/store.d.ts

@@ -0,0 +1,44 @@
+import { type MemoryEntry, type MemoryScope, type MemoryType } from "./types.js";
+export interface MemoryStoreOptions {
+    workspaceRoot: string;
+    homeDir: string;
+}
+export interface SaveInput {
+    type: MemoryType;
+    name: string;
+    description?: string;
+    body: string;
+}
+/**
+ * Concurrency note (v1): mutations are sync-per-process but not locked across
+ * parallel CLI processes. Two simultaneous saves can interleave such that the
+ * last MEMORY.md index rewrite reflects a stale `list()`. At v1 scale (single
+ * interactive CLI, occasional `-p` invocation) the worst case is a stale
+ * index until the next mutation — not data loss, since each entry file write
+ * is atomic and slugs collision-suffix. A per-scope lock file is queued for
+ * v2 alongside the relevance ranker (when memory becomes hot-path enough to
+ * race on).
+ */
+export declare class MemoryStore {
+    private readonly dirs;
+    constructor(opts: MemoryStoreOptions);
+    /** Resolved on-disk directory for the given scope. Public so tools can show paths. */
+    dirFor(scope: MemoryScope): string;
+    list(scope?: MemoryScope): MemoryEntry[];
+    save(input: SaveInput, scope: MemoryScope): MemoryEntry;
+    /** Returns true if the slug existed and was removed. */
+    delete(slug: string, scope: MemoryScope): boolean;
+    /**
+     * Resolves a slug collision by walking `base`, `base-2`, `base-3`, ... until
+     * we find a slot that's either (a) empty or (b) holds an entry with the same
+     * name+type (in which case overwrite is the intended behavior — same memory
+     * being updated). This prevents two distinct memories whose names normalize
+     * to the same slug from silently clobbering each other.
+     */
+    private uniqueSlugFor;
+    /** System-prompt injection block. Empty string when nothing is saved. */
+    asSystemContext(): string;
+    private rewriteIndex;
+}
+export declare function slugify(s: string): string;
+//# sourceMappingURL=store.d.ts.map

package/dist/memory/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AASpB,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;gBAEvC,IAAI,EAAE,kBAAkB;IAOpC,sFAAsF;IACtF,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAIlC,IAAI,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE;IA2BxC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW;IAcvD,wDAAwD;IACxD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO;IAUjD;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAmBrB,yEAAyE;IACzE,eAAe,IAAI,MAAM;IAUzB,OAAO,CAAC,YAAY;CA+BrB;AA8DD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQzC"}