@pattern-js/mod-buddy 0.4.0-main.c8eb671

package/dist/threads.js

@@ -0,0 +1,67 @@
+/**
+ * @pattern-js/mod-buddy — thread persistence.
+ *
+ * One thread per (workflow slug, owner): the dock reloads it on mount, the
+ * turn pipeline replaces its messages with the agent's updated history after
+ * every turn (CAS-retried). mod-store is duck-typed via its well-known
+ * "storeService" key — when absent, Buddy degrades gracefully to stateless
+ * turns (the dock still works; memory just doesn't survive a reload).
+ */
+export const THREADS = "buddy.threads";
+const STORE_SERVICE = "storeService";
+function docsOf(services) {
+    const svc = services[STORE_SERVICE];
+    return svc?.docs && typeof svc.docs.get === "function" ? svc.docs : null;
+}
+export function ownerOf(principal) {
+    return principal.kind === "user" ? principal.id : "anonymous";
+}
+const threadId = (slug, ownerId) => `${ownerId}::${slug}`;
+// Per-store (not per-process): tests boot several engines, each with its own store.
+const ensured = new WeakSet();
+async function ensure(docs) {
+    if (ensured.has(docs))
+        return;
+    await docs.ensureCollection({ name: THREADS, indexes: ["slug", "ownerId"] });
+    ensured.add(docs);
+}
+/** The thread's messages (empty when no store / no thread yet). */
+export async function loadThread(ctx, slug) {
+    const docs = docsOf(ctx.services);
+    if (!docs)
+        return [];
+    await ensure(docs);
+    const row = await docs.get(THREADS, threadId(slug, ownerOf(ctx.principal)));
+    const messages = row?.data?.messages;
+    return Array.isArray(messages) ? messages : [];
+}
+/** Replace the thread's messages with the turn's updated history (CAS-retried). */
+export async function saveThread(ctx, slug, messages) {
+    const docs = docsOf(ctx.services);
+    if (!docs)
+        return false;
+    await ensure(docs);
+    const ownerId = ownerOf(ctx.principal);
+    const id = threadId(slug, ownerId);
+    const data = { slug, ownerId, messages, updatedAt: Date.now() };
+    for (let attempt = 0; attempt < 5; attempt++) {
+        const existing = await docs.get(THREADS, id);
+        const written = await docs.put(THREADS, id, data, existing?.version);
+        if (written)
+            return true;
+    }
+    console.warn(`[pattern/mod-buddy] thread "${id}": CAS save kept losing — dropping this turn's history`);
+    return false;
+}
+export async function clearThread(ctx, slug) {
+    const docs = docsOf(ctx.services);
+    if (!docs)
+        return false;
+    await ensure(docs);
+    return docs.delete(THREADS, threadId(slug, ownerOf(ctx.principal)));
+}
+/** Whether persistence is available (the dock's status probe reports it). */
+export function hasThreadStore(services) {
+    return docsOf(services) !== null;
+}
+//# sourceMappingURL=threads.js.map

package/dist/threads.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @pattern-js/mod-buddy — the pattern_* control-plane tools.
+ *
+ * Ten RESTRICTED `boundary.tool` workflows — the one capability layer both
+ * Buddy (in-admin) and external MCP clients consume. Bodies are ordinary
+ * graphs over the existing admin/docs ops, so every tool call is a
+ * traced, linked sub-run you can open on the canvas, and the admin ops
+ * re-check the caller's granular scope in-op (workflows:read/write,
+ * runs:read/write, deploy). `restricted: true` keeps them out of every
+ * `["*"]` toolset/MCP expansion — they are offered only by name.
+ */
+import type { Workflow } from "@pattern-js/core";
+/** The ten control-plane tools, in reading order of a typical Buddy session. */
+export declare const CONTROL_PLANE_TOOLS: string[];
+export declare function toolWorkflows(): Workflow[];
+/**
+ * The Pattern MCP server route: POST /mcp/pattern, gated by requireAuth
+ * (workflows:read is the entry floor — each tool's admin ops then re-check
+ * their own granular scope against the SAME bearer principal, which flows
+ * through ctx.invoke into the tool sub-runs). Exposes exactly the ten
+ * control-plane tools by name — restricted tools never ride a wildcard.
+ */
+export declare function patternMcpServerWorkflow(path?: string): Workflow;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAmFjD,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,EAAE,MAAM,EAWvC,CAAC;AAEF,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAwI1C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,SAAiB,GAAG,QAAQ,CA6BxE"}

package/dist/tools.js

@@ -0,0 +1,251 @@
+/**
+ * @pattern-js/mod-buddy — the pattern_* control-plane tools.
+ *
+ * Ten RESTRICTED `boundary.tool` workflows — the one capability layer both
+ * Buddy (in-admin) and external MCP clients consume. Bodies are ordinary
+ * graphs over the existing admin/docs ops, so every tool call is a
+ * traced, linked sub-run you can open on the canvas, and the admin ops
+ * re-check the caller's granular scope in-op (workflows:read/write,
+ * runs:read/write, deploy). `restricted: true` keeps them out of every
+ * `["*"]` toolset/MCP expansion — they are offered only by name.
+ */
+/** trigger → (extract) → op → (build) → return, laid out left to right. */
+function toolWorkflow(spec) {
+    const nodes = [
+        {
+            id: "in",
+            op: "boundary.tool",
+            config: {
+                name: spec.name,
+                description: spec.description,
+                params: { type: "object", properties: spec.params, ...(spec.required?.length ? { required: spec.required } : {}) },
+                restricted: true,
+                ...(spec.needsApproval ? { needsApproval: true } : {}),
+            },
+            ui: { x: 60, y: 120, pair: "out" },
+        },
+        { id: "op", op: spec.op, ui: { x: 620, y: 120 } },
+        { id: "out", op: "boundary.tool.return", ui: { x: 1180, y: 120, pair: "in" } },
+    ];
+    const edges = [];
+    if (spec.extract.length) {
+        nodes.splice(1, 0, {
+            id: "args",
+            op: "core.object.extract",
+            config: { keys: spec.extract },
+            comment: "Fan the validated tool args out into the op's input ports.",
+            ui: { x: 340, y: 120 },
+        });
+        edges.push({ from: { node: "in", port: "args" }, to: { node: "args", port: "object" } });
+        for (const key of spec.extract) {
+            edges.push({ from: { node: "args", port: key }, to: { node: "op", port: key } });
+        }
+    }
+    else {
+        // No data flows from the trigger — a control edge threads reachability.
+        edges.push({ from: { node: "in", port: "out" }, to: { node: "op", port: "in" } });
+    }
+    if (typeof spec.out === "string") {
+        edges.push({ from: { node: "op", port: spec.out }, to: { node: "out", port: "result" } });
+    }
+    else {
+        nodes.splice(nodes.length - 1, 0, {
+            id: "combine",
+            op: "core.object.build",
+            config: { keys: spec.out },
+            ui: { x: 900, y: 120 },
+        });
+        for (const port of spec.out) {
+            edges.push({ from: { node: "op", port }, to: { node: "combine", port } });
+        }
+        edges.push({ from: { node: "combine", port: "out" }, to: { node: "out", port: "result" } });
+    }
+    return {
+        id: spec.id,
+        name: `Buddy · ${spec.name}`,
+        description: `${spec.description} (restricted control-plane tool — offered only by explicit name)`,
+        nodes,
+        edges,
+    };
+}
+const docSchema = { type: "object", description: "A full workflow document ({ id, nodes, edges })." };
+/** The ten control-plane tools, in reading order of a typical Buddy session. */
+export const CONTROL_PLANE_TOOLS = [
+    "pattern_list_ops",
+    "pattern_get_op",
+    "pattern_search_docs",
+    "pattern_get_workflow",
+    "pattern_validate_workflow",
+    "pattern_propose_workflow",
+    "pattern_save_workflow_draft",
+    "pattern_deploy_workflow",
+    "pattern_list_runs",
+    "pattern_get_run",
+];
+export function toolWorkflows() {
+    return [
+        toolWorkflow({
+            id: "buddy.tool.list-ops",
+            name: "pattern_list_ops",
+            description: "List every op available in this app (type, ports, category, contributing mod — schemas trimmed). " +
+                "Call pattern_get_op for one op's full config schema and usage prose.",
+            params: {},
+            extract: [],
+            op: "docs.ops.list",
+            out: "ops",
+        }),
+        toolWorkflow({
+            id: "buddy.tool.get-op",
+            name: "pattern_get_op",
+            description: "One op's full definition: ports, config JSON Schema, and the handbook's usage prose.",
+            params: { type: { type: "string", description: 'The op type, e.g. "core.http.fetch".' } },
+            required: ["type"],
+            extract: ["type"],
+            op: "docs.ops.get",
+            out: "op",
+        }),
+        toolWorkflow({
+            id: "buddy.tool.search-docs",
+            name: "pattern_search_docs",
+            description: "Search the Pattern handbook and op catalog. Returns [{ title, path, snippet, score }] — " +
+                "use it before proposing a workflow to ground yourself in the house patterns.",
+            params: {
+                query: { type: "string", description: "What you want to know." },
+                k: { type: "number", description: "Max results (default 6)." },
+            },
+            required: ["query"],
+            extract: ["query", "k"],
+            op: "buddy.knowledge.search",
+            out: "results",
+        }),
+        toolWorkflow({
+            id: "buddy.tool.get-workflow",
+            name: "pattern_get_workflow",
+            description: "A workflow's meta (versions, live pointer, audit) + its live and latest-saved documents.",
+            params: { slug: { type: "string", description: "The workflow slug/id." } },
+            required: ["slug"],
+            extract: ["slug"],
+            op: "admin.workflow.get",
+            out: "workflow",
+        }),
+        toolWorkflow({
+            id: "buddy.tool.validate-workflow",
+            name: "pattern_validate_workflow",
+            description: "Validate a workflow document WITHOUT saving: { ok, issues } with located errors (nodeId + code). " +
+                "Iterate until ok before proposing or saving.",
+            params: { doc: docSchema },
+            required: ["doc"],
+            extract: ["doc"],
+            op: "admin.workflow.validate",
+            out: "result",
+        }),
+        toolWorkflow({
+            id: "buddy.tool.propose-workflow",
+            name: "pattern_propose_workflow",
+            description: "Propose a workflow doc to the human: it is validated here, and — when ok — surfaces as an Apply card " +
+                "in the editor dock (the human applies it to the canvas; nothing is saved or deployed). " +
+                "Include a one-sentence summary of what the workflow does and what changed.",
+            params: {
+                doc: docSchema,
+                summary: { type: "string", description: "One sentence: what this workflow does / what changed." },
+                slug: { type: "string", description: "Target workflow slug when editing an existing one." },
+            },
+            required: ["doc", "summary"],
+            extract: ["doc"],
+            op: "admin.workflow.validate",
+            out: "result",
+        }),
+        toolWorkflow({
+            id: "buddy.tool.save-workflow-draft",
+            name: "pattern_save_workflow_draft",
+            description: "Validate + save a doc as a new immutable DRAFT version (never deploys). Invalid docs are refused — " +
+                "you get { issues } back instead of a version.",
+            params: {
+                slug: { type: "string", description: "The workflow slug to save under." },
+                doc: docSchema,
+                note: { type: "string", description: "Short version note (what changed)." },
+            },
+            required: ["slug", "doc"],
+            extract: ["slug", "doc", "note"],
+            op: "admin.workflow.save",
+            out: ["version", "issues"],
+        }),
+        toolWorkflow({
+            id: "buddy.tool.deploy-workflow",
+            name: "pattern_deploy_workflow",
+            description: "Activate a saved version (route-conflict checked). Requires the deploy scope; agent calls pause for " +
+                "human approval. Pass swap=true to take over conflicting routes.",
+            params: {
+                slug: { type: "string" },
+                version: { type: "string", description: "The version id to activate." },
+                swap: { type: "boolean", description: "Take over route conflicts (default false)." },
+            },
+            required: ["slug", "version"],
+            extract: ["slug", "version", "swap"],
+            op: "admin.workflow.deploy",
+            out: "result",
+            needsApproval: true,
+        }),
+        toolWorkflow({
+            id: "buddy.tool.list-runs",
+            name: "pattern_list_runs",
+            description: "Recent runs from the trace store — filter by workflow slug and/or status (ok | error | canceled).",
+            params: {
+                workflow: { type: "string", description: "Only this workflow's runs." },
+                status: { type: "string", description: "ok | error | canceled" },
+                limit: { type: "number", description: "Max rows (default 50)." },
+            },
+            extract: ["workflow", "status", "limit"],
+            op: "admin.run.list",
+            out: "runs",
+        }),
+        toolWorkflow({
+            id: "buddy.tool.get-run",
+            name: "pattern_get_run",
+            description: "One run's full trace: per-node spans with status, timings, error messages/stacks, and masked I/O " +
+                "samples — everything needed to answer \"why did this run fail?\".",
+            params: { runId: { type: "string" } },
+            required: ["runId"],
+            extract: ["runId"],
+            op: "admin.run.get",
+            out: "run",
+        }),
+    ];
+}
+/**
+ * The Pattern MCP server route: POST /mcp/pattern, gated by requireAuth
+ * (workflows:read is the entry floor — each tool's admin ops then re-check
+ * their own granular scope against the SAME bearer principal, which flows
+ * through ctx.invoke into the tool sub-runs). Exposes exactly the ten
+ * control-plane tools by name — restricted tools never ride a wildcard.
+ */
+export function patternMcpServerWorkflow(path = "/mcp/pattern") {
+    return {
+        id: "buddy.mcp.server",
+        name: `Buddy · Pattern MCP server (POST ${path})`,
+        description: "Exposes the pattern_* control-plane tools to external MCP clients (Claude Code, Cursor, …) over " +
+            "StreamableHTTP JSON-RPC. Gated by API tokens (mint them in admin → Access → API tokens); a token's " +
+            "scopes decide which calls succeed — authoring tokens can draft, only deploy-scoped tokens can ship.",
+        nodes: [
+            {
+                id: "in",
+                op: "boundary.http.request",
+                config: { method: "POST", path, requireAuth: { scopes: ["workflows:read"] } },
+                ui: { x: 60, y: 120, pair: "out" },
+            },
+            {
+                id: "serve",
+                op: "ai.mcp.serve",
+                config: { name: "pattern", tools: CONTROL_PLANE_TOOLS },
+                comment: "The ten pattern_* tools, by explicit name — wildcards never expose restricted tools.",
+                ui: { x: 340, y: 120 },
+            },
+            { id: "out", op: "boundary.http.response", ui: { x: 620, y: 120, pair: "in" } },
+        ],
+        edges: [
+            { from: { node: "in", port: "body" }, to: { node: "serve", port: "request" } },
+            { from: { node: "serve", port: "response" }, to: { node: "out", port: "body" } },
+        ],
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsBH,2EAA2E;AAC3E,SAAS,YAAY,CAAC,IAAc;IAClC,MAAM,KAAK,GAAsB;QAC/B;YACE,EAAE,EAAE,IAAI;YACR,EAAE,EAAE,eAAe;YACnB,MAAM,EAAE;gBACN,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;gBAClH,UAAU,EAAE,IAAI;gBAChB,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD;YACD,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE;SACnC;QACD,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE;QACjD,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,sBAAsB,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;KAC/E,CAAC;IACF,MAAM,KAAK,GAAsB,EAAE,CAAC;IAEpC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE;YACjB,EAAE,EAAE,MAAM;YACV,EAAE,EAAE,qBAAqB;YACzB,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;YAC9B,OAAO,EAAE,4DAA4D;YACrE,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;SACvB,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QACzF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;SAAM,CAAC;QACN,wEAAwE;QACxE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE;YAChC,EAAE,EAAE,SAAS;YACb,EAAE,EAAE,mBAAmB;YACvB,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;YAC1B,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;SACvB,CAAC,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE;QAC5B,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,kEAAkE;QAClG,KAAK;QACL,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;AAEtG,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAa;IAC3C,kBAAkB;IAClB,gBAAgB;IAChB,qBAAqB;IACrB,sBAAsB;IACtB,2BAA2B;IAC3B,0BAA0B;IAC1B,6BAA6B;IAC7B,yBAAyB;IACzB,mBAAmB;IACnB,iBAAiB;CAClB,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,YAAY,CAAC;YACX,EAAE,EAAE,qBAAqB;YACzB,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,mGAAmG;gBACnG,sEAAsE;YACxE,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,EAAE,EAAE,eAAe;YACnB,GAAG,EAAE,KAAK;SACX,CAAC;QACF,YAAY,CAAC;YACX,EAAE,EAAE,mBAAmB;YACvB,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,sFAAsF;YACnG,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE,EAAE;YACzF,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,OAAO,EAAE,CAAC,MAAM,CAAC;YACjB,EAAE,EAAE,cAAc;YAClB,GAAG,EAAE,IAAI;SACV,CAAC;QACF,YAAY,CAAC;YACX,EAAE,EAAE,wBAAwB;YAC5B,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EACT,0FAA0F;gBAC1F,8EAA8E;YAChF,MAAM,EAAE;gBACN,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;gBAChE,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;aAC/D;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC;YACvB,EAAE,EAAE,wBAAwB;YAC5B,GAAG,EAAE,SAAS;SACf,CAAC;QACF,YAAY,CAAC;YACX,EAAE,EAAE,yBAAyB;YAC7B,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,0FAA0F;YACvG,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE,EAAE;YAC1E,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,OAAO,EAAE,CAAC,MAAM,CAAC;YACjB,EAAE,EAAE,oBAAoB;YACxB,GAAG,EAAE,UAAU;SAChB,CAAC;QACF,YAAY,CAAC;YACX,EAAE,EAAE,8BAA8B;YAClC,IAAI,EAAE,2BAA2B;YACjC,WAAW,EACT,mGAAmG;gBACnG,8CAA8C;YAChD,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE;YAC1B,QAAQ,EAAE,CAAC,KAAK,CAAC;YACjB,OAAO,EAAE,CAAC,KAAK,CAAC;YAChB,EAAE,EAAE,yBAAyB;YAC7B,GAAG,EAAE,QAAQ;SACd,CAAC;QACF,YAAY,CAAC;YACX,EAAE,EAAE,6BAA6B;YACjC,IAAI,EAAE,0BAA0B;YAChC,WAAW,EACT,uGAAuG;gBACvG,yFAAyF;gBACzF,4EAA4E;YAC9E,MAAM,EAAE;gBACN,GAAG,EAAE,SAAS;gBACd,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;gBACjG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;aAC5F;YACD,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;YAC5B,OAAO,EAAE,CAAC,KAAK,CAAC;YAChB,EAAE,EAAE,yBAAyB;YAC7B,GAAG,EAAE,QAAQ;SACd,CAAC;QACF,YAAY,CAAC;YACX,EAAE,EAAE,gCAAgC;YACpC,IAAI,EAAE,6BAA6B;YACnC,WAAW,EACT,qGAAqG;gBACrG,+CAA+C;YACjD,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;gBACzE,GAAG,EAAE,SAAS;gBACd,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;aAC5E;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;YACzB,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC;YAChC,EAAE,EAAE,qBAAqB;YACzB,GAAG,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;SAC3B,CAAC;QACF,YAAY,CAAC;YACX,EAAE,EAAE,4BAA4B;YAChC,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EACT,sGAAsG;gBACtG,iEAAiE;YACnE,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;gBACvE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,4CAA4C,EAAE;aACrF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;YAC7B,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC;YACpC,EAAE,EAAE,uBAAuB;YAC3B,GAAG,EAAE,QAAQ;YACb,aAAa,EAAE,IAAI;SACpB,CAAC;QACF,YAAY,CAAC;YACX,EAAE,EAAE,sBAAsB;YAC1B,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,mGAAmG;YAChH,MAAM,EAAE;gBACN,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;gBACvE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBAChE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;aACjE;YACD,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC;YACxC,EAAE,EAAE,gBAAgB;YACpB,GAAG,EAAE,MAAM;SACZ,CAAC;QACF,YAAY,CAAC;YACX,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,mGAAmG;gBACnG,mEAAmE;YACrE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YACrC,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,CAAC,OAAO,CAAC;YAClB,EAAE,EAAE,eAAe;YACnB,GAAG,EAAE,KAAK;SACX,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAI,GAAG,cAAc;IAC5D,OAAO;QACL,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,oCAAoC,IAAI,GAAG;QACjD,WAAW,EACT,kGAAkG;YAClG,qGAAqG;YACrG,qGAAqG;QACvG,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,IAAI;gBACR,EAAE,EAAE,uBAAuB;gBAC3B,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE;gBAC7E,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE;aACnC;YACD;gBACE,EAAE,EAAE,OAAO;gBACX,EAAE,EAAE,cAAc;gBAClB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,EAAE;gBACvD,OAAO,EAAE,sFAAsF;gBAC/F,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;aACvB;YACD,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,wBAAwB,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;SAChF;QACD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;YAC9E,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;SACjF;KACF,CAAC;AACJ,CAAC"}

package/dist/turn.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @pattern-js/mod-buddy — the turn pipeline (Buddy's backend half).
+ *
+ * POST /buddy/api/turn → buddy.turn.begin (thread + instructions + model) →
+ * agents.agent + the ten pattern_* tools → agents.run → SSE out, while
+ * buddy.turn.save persists the updated history back to the thread. The
+ * pipeline is an ordinary editable workflow — Buddy is built from Pattern
+ * workflows, all the way down.
+ *
+ * The dock reads tool calls (incl. proposed docs) straight from the SSE
+ * turn events: `tool.activity` carries the tool's name and args.
+ */
+import { type OpDefinition, type Workflow } from "@pattern-js/core";
+import type { KnowledgeService } from "./knowledge.js";
+/** The dock's boot probe: what Buddy can do in THIS app. */
+export declare function statusOp(knowledge: () => KnowledgeService): OpDefinition;
+export declare function turnOps(knowledge: () => KnowledgeService): OpDefinition[];
+/** POST /buddy/api/turn → SSE turn events (the dock's one streaming call). */
+export declare function turnPipelineWorkflow(): Workflow;
+/** The dock's plumbing routes (thread load/clear, stop, status). */
+export declare function buddyRoutes(): Workflow[];
+//# sourceMappingURL=turn.d.ts.map

package/dist/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../src/turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA2D,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAK7H,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA6HvD,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,gBAAgB,GAAG,YAAY,CAoBxE;AAED,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,gBAAgB,GAAG,YAAY,EAAE,CAEzE;AAMD,8EAA8E;AAC9E,wBAAgB,oBAAoB,IAAI,QAAQ,CA+E/C;AAED,oEAAoE;AACpE,wBAAgB,WAAW,IAAI,QAAQ,EAAE,CAuCxC"}