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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Makkr Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# @pattern-js/mod-buddy
+
+Buddy — the workflow assistant inside
+[Pattern](https://github.com/makkr-studio/pattern)'s admin, and the Pattern
+**control plane**: ten restricted `pattern_*` tool workflows (list/search the
+catalog and docs, read workflows and runs, validate, propose, save drafts,
+deploy-with-approval) consumed three ways —
+
+- **the editor dock**: Buddy drafts workflows, self-repairs against the
+  validator, debugs failed runs from traces, and applies proposals to your
+  open canvas; you keep Save and Deploy,
+- **`POST /mcp/pattern`**: the same tools for external MCP clients, gated by
+  scoped API tokens (author vs deploy split),
+- **`pattern mcp`**: stdio for local dev — Claude Code or Cursor becomes a
+  Pattern author.
+
+Knowledge is lexical over the live handbook by default and silently upgrades
+to hybrid semantic retrieval when `@pattern-js/mod-vectors` + an embedding
+alias are installed. Threads persist via `@pattern-js/mod-store` when
+present. Buddy's own turn pipeline is a Pattern workflow — open it on the
+canvas.
+
+Full chapter: your app's `/docs` → **Buddy** (or
+[the handbook source](./docs/index.md)).

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/** @pattern-js/mod-buddy — public surface (Buddy + the Pattern control plane). */
+export { buddyMod, type BuddyOptions } from "./mod.js";
+export { default } from "./mod.js";
+export { CONTROL_PLANE_TOOLS, patternMcpServerWorkflow, toolWorkflows } from "./tools.js";
+export { KnowledgeService, knowledgeSearchOp, DOCS_COLLECTION, type KnowledgeResult } from "./knowledge.js";
+export { turnPipelineWorkflow, buddyRoutes, turnOps } from "./turn.js";
+export { BUDDY_INSTRUCTIONS, contextBlock } from "./prompts.js";
+export { THREADS, loadThread, saveThread, clearThread } from "./threads.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5G,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/** @pattern-js/mod-buddy — public surface (Buddy + the Pattern control plane). */
+export { buddyMod } from "./mod.js";
+export { default } from "./mod.js";
+export { CONTROL_PLANE_TOOLS, patternMcpServerWorkflow, toolWorkflows } from "./tools.js";
+export { KnowledgeService, knowledgeSearchOp, DOCS_COLLECTION } from "./knowledge.js";
+export { turnPipelineWorkflow, buddyRoutes, turnOps } from "./turn.js";
+export { BUDDY_INSTRUCTIONS, contextBlock } from "./prompts.js";
+export { THREADS, loadThread, saveThread, clearThread } from "./threads.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,QAAQ,EAAqB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAwB,MAAM,gBAAgB,CAAC;AAC5G,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/knowledge.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @pattern-js/mod-buddy — Buddy's knowledge retrieval.
+ *
+ * One op, `buddy.knowledge.search`, behind one output shape
+ * `{ results: [{ title, path, snippet, score }] }`. The BASELINE engine is
+ * lexical over the live handbook (mod-docs' DocsContent: page titles,
+ * headings, page bodies) plus the op catalog — first-class, not a fallback:
+ * this corpus is structured docs and exact op names, where lexical genuinely
+ * shines. When mod-vectors + an embedding alias are present the same op
+ * silently upgrades to semantic retrieval (0.4 phase 7); the output shape
+ * never changes, so nothing downstream cares which engine answered.
+ */
+import { type Engine, type OpContext, type OpDefinition } from "@pattern-js/core";
+export interface KnowledgeResult {
+    title: string;
+    /** `guide/<chapter>/<file>` for handbook pages, `op/<type>` for catalog hits. */
+    path: string;
+    snippet: string;
+    score: number;
+}
+export declare const DOCS_COLLECTION = "buddy.docs";
+export declare class KnowledgeService {
+    private readonly getEngine;
+    private readonly content;
+    /** True once the boot indexer has the docs corpus in vectors — search upgrades itself. */
+    private semanticReady;
+    constructor(getEngine: () => Engine | undefined);
+    /** Whether searches currently run semantically (the status probe reports it). */
+    isSemantic(): boolean;
+    /**
+     * Boot indexer (fire-and-forget from ready(), never blocks boot): when
+     * mod-vectors AND an embedding alias are present, chunk every handbook page
+     * into the "buddy.docs" collection. Content-hashing in vectors.upsert makes
+     * re-runs after upgrades cost only the diff. Any failure leaves the lexical
+     * baseline in charge — one warn, no drama.
+     */
+    indexDocs(ctx: OpContext): Promise<void>;
+    /** Semantic path: hybrid retrieval over the indexed handbook + lexical op-catalog hits. */
+    private searchSemantic;
+    search(query: string, k?: number, ctx?: OpContext): Promise<KnowledgeResult[]>;
+}
+/** `buddy.knowledge.search` — retrieval for Buddy and the pattern_search_docs tool. */
+export declare function knowledgeSearchOp(service: () => KnowledgeService): OpDefinition;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../src/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAY,KAAK,MAAM,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG5F,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAOD,eAAO,MAAM,eAAe,eAAe,CAAC;AAqE5C,qBAAa,gBAAgB;IAKf,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,0FAA0F;IAC1F,OAAO,CAAC,aAAa,CAAS;gBAED,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS;IAIhE,iFAAiF;IACjF,UAAU,IAAI,OAAO;IAIrB;;;;;;OAMG;IACG,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC9C,2FAA2F;YAC7E,cAAc;IA4BtB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAI,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAkDhF;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,gBAAgB,GAAG,YAAY,CAgB/E"}

package/dist/knowledge.js

@@ -0,0 +1,227 @@
+/**
+ * @pattern-js/mod-buddy — Buddy's knowledge retrieval.
+ *
+ * One op, `buddy.knowledge.search`, behind one output shape
+ * `{ results: [{ title, path, snippet, score }] }`. The BASELINE engine is
+ * lexical over the live handbook (mod-docs' DocsContent: page titles,
+ * headings, page bodies) plus the op catalog — first-class, not a fallback:
+ * this corpus is structured docs and exact op names, where lexical genuinely
+ * shines. When mod-vectors + an embedding alias are present the same op
+ * silently upgrades to semantic retrieval (0.4 phase 7); the output shape
+ * never changes, so nothing downstream cares which engine answered.
+ */
+import { value, z } from "@pattern-js/core";
+import { DocsContent, resolveOptions } from "@pattern-js/mod-docs";
+/* ── duck-typed views of mod-vectors + mod-ai (NEVER imported) ───────────── */
+const VECTORS_SERVICE = "vectorsService";
+const AI_CONFIG_SERVICE = "aiConfig";
+export const DOCS_COLLECTION = "buddy.docs";
+function vectorsOf(services) {
+    const svc = services[VECTORS_SERVICE];
+    return svc && typeof svc.query === "function" ? svc : null;
+}
+/** The embedding alias Buddy indexes with: "buddy" when it embeds, else the first embedding alias. */
+function embeddingAlias(services) {
+    const config = services[AI_CONFIG_SERVICE];
+    if (!config || typeof config.aliases !== "function")
+        return null;
+    const embedding = config.aliases().filter((a) => a.modality === "embedding");
+    return embedding.find((a) => a.name === "buddy")?.name ?? embedding[0]?.name ?? null;
+}
+const tokenize = (s) => s
+    .toLowerCase()
+    .split(/[^a-z0-9.]+/)
+    .filter((t) => t.length > 1);
+/** Overlap score of query tokens against a text (whole-token 2, substring 1). */
+function overlap(queryTokens, text) {
+    const hay = text.toLowerCase();
+    const hayTokens = new Set(tokenize(hay));
+    let score = 0;
+    for (const q of queryTokens) {
+        if (hayTokens.has(q))
+            score += 2;
+        else if (hay.includes(q))
+            score += 1;
+    }
+    return score;
+}
+/** A ±2-line window around the best-matching line of a markdown body. */
+function snippetAround(markdown, queryTokens) {
+    const lines = markdown.split("\n").filter((l) => l.trim().length > 0);
+    let bestIdx = 0;
+    let bestScore = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const s = overlap(queryTokens, lines[i]);
+        if (s > bestScore) {
+            bestScore = s;
+            bestIdx = i;
+        }
+    }
+    return lines
+        .slice(Math.max(0, bestIdx - 1), bestIdx + 3)
+        .join(" ")
+        .slice(0, 500);
+}
+export class KnowledgeService {
+    getEngine;
+    content;
+    /** True once the boot indexer has the docs corpus in vectors — search upgrades itself. */
+    semanticReady = false;
+    constructor(getEngine) {
+        this.getEngine = getEngine;
+        this.content = new DocsContent(getEngine, resolveOptions({}));
+    }
+    /** Whether searches currently run semantically (the status probe reports it). */
+    isSemantic() {
+        return this.semanticReady;
+    }
+    /**
+     * Boot indexer (fire-and-forget from ready(), never blocks boot): when
+     * mod-vectors AND an embedding alias are present, chunk every handbook page
+     * into the "buddy.docs" collection. Content-hashing in vectors.upsert makes
+     * re-runs after upgrades cost only the diff. Any failure leaves the lexical
+     * baseline in charge — one warn, no drama.
+     */
+    async indexDocs(ctx) {
+        const vectors = vectorsOf(ctx.services);
+        const alias = embeddingAlias(ctx.services);
+        if (!vectors || !alias)
+            return;
+        try {
+            await vectors.ensureCollection({ name: DOCS_COLLECTION, alias, metric: "cosine", filterables: ["kind", "chapter"] });
+            const items = [];
+            for (const page of await this.content.searchIndex()) {
+                const md = await this.content.page(page.chapter, page.file).catch(() => null);
+                if (!md?.markdown.trim())
+                    continue;
+                // Coarse paragraph packing (~1500 chars) — pages are structured prose,
+                // this keeps chunks self-contained without a tokenizer.
+                const paragraphs = md.markdown.split("\n\n");
+                let buf = "";
+                let i = 0;
+                const flush = () => {
+                    if (!buf.trim())
+                        return;
+                    items.push({
+                        id: `guide/${page.chapter}/${page.file}#${i++}`,
+                        text: buf,
+                        meta: { kind: "guide", chapter: page.chapter, title: page.title, path: `guide/${page.chapter}/${page.file}` },
+                    });
+                    buf = "";
+                };
+                for (const p of paragraphs) {
+                    if (buf.length + p.length > 1500)
+                        flush();
+                    buf = buf ? `${buf}\n\n${p}` : p;
+                }
+                flush();
+            }
+            if (!items.length)
+                return;
+            const res = await vectors.upsert(DOCS_COLLECTION, items, ctx);
+            this.semanticReady = true;
+            if (res.embedded > 0) {
+                console.log(`[pattern/mod-buddy] knowledge index ready — ${res.embedded} chunk(s) embedded via alias "${alias}"`);
+            }
+        }
+        catch (err) {
+            console.warn(`[pattern/mod-buddy] semantic indexing unavailable (lexical search stays on): ${err.message}`);
+        }
+    }
+    /** Semantic path: hybrid retrieval over the indexed handbook + lexical op-catalog hits. */
+    async searchSemantic(query, k, ctx) {
+        const vectors = vectorsOf(ctx.services);
+        const engine = this.getEngine();
+        if (!vectors || !engine || !this.semanticReady)
+            return null;
+        try {
+            const matches = await vectors.query(DOCS_COLLECTION, { text: query, k, mode: "hybrid" }, ctx);
+            const guide = matches.map((m) => ({
+                title: String(m.meta?.title ?? m.id),
+                path: String(m.meta?.path ?? m.id),
+                snippet: (m.text ?? "").slice(0, 500),
+                score: m.score,
+            }));
+            // Ops aren't vector-indexed (exact names are lexical's home turf) — blend
+            // the top catalog hits in after the guide results.
+            const queryTokens = tokenize(query);
+            const ops = engine.ops
+                .list()
+                .map((op) => ({ op, score: overlap(queryTokens, `${op.type} ${op.description ?? ""}`) }))
+                .filter((s) => s.score > 0)
+                .sort((a, b) => b.score - a.score)
+                .slice(0, Math.max(2, Math.floor(k / 3)))
+                .map(({ op, score }) => ({ title: op.type, path: `op/${op.type}`, snippet: op.description ?? "", score }));
+            return [...guide, ...ops].slice(0, k + ops.length);
+        }
+        catch {
+            return null; // embedding hiccup → the lexical baseline answers
+        }
+    }
+    async search(query, k = 6, ctx) {
+        if (ctx) {
+            const semantic = await this.searchSemantic(query, k, ctx);
+            if (semantic)
+                return semantic;
+        }
+        const engine = this.getEngine();
+        if (!engine)
+            return [];
+        const queryTokens = tokenize(query);
+        if (!queryTokens.length)
+            return [];
+        // Rank the whole corpus on cheap metadata first (titles, headings, op
+        // descriptions) — then load ONLY the winning pages' markdown for snippets.
+        const scored = [];
+        for (const page of await this.content.searchIndex().catch(() => [])) {
+            const meta = `${page.title} ${page.headings.join(" ")} ${page.chapter} ${page.file}`;
+            const score = overlap(queryTokens, meta);
+            if (score > 0) {
+                scored.push({
+                    title: page.title,
+                    path: `guide/${page.chapter}/${page.file}`,
+                    score,
+                    page: { chapter: page.chapter, file: page.file },
+                });
+            }
+        }
+        for (const op of engine.ops.list()) {
+            const score = overlap(queryTokens, `${op.type} ${op.description ?? ""}`);
+            if (score > 0) {
+                scored.push({ title: op.type, path: `op/${op.type}`, score: score + (queryTokens.includes(op.type.toLowerCase()) ? 4 : 0) });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        const top = scored.slice(0, Math.max(1, Math.min(k, 20)));
+        return Promise.all(top.map(async (hit) => {
+            let snippet = "";
+            if (hit.page) {
+                const page = await this.content.page(hit.page.chapter, hit.page.file).catch(() => null);
+                snippet = page ? snippetAround(page.markdown, queryTokens) : "";
+            }
+            else {
+                const type = hit.path.slice("op/".length);
+                snippet = engine.ops.get(type)?.description ?? "";
+            }
+            return { title: hit.title, path: hit.path, snippet, score: hit.score };
+        }));
+    }
+}
+/** `buddy.knowledge.search` — retrieval for Buddy and the pattern_search_docs tool. */
+export function knowledgeSearchOp(service) {
+    return {
+        type: "buddy.knowledge.search",
+        title: "buddy.knowledge.search",
+        description: "Search Buddy's knowledge (the live handbook + op catalog). Inputs { query, k? } → { results: [{ title, path, snippet, score }] }. " +
+            "Lexical by default; upgrades to semantic retrieval when mod-vectors + an embedding alias are installed.",
+        reusable: false,
+        inputs: { query: value(z.string()), k: value(z.number().optional()) },
+        outputs: { results: value() },
+        execute: async (ctx) => {
+            const query = String((await ctx.input.value("query")) ?? "");
+            const k = ctx.input.has("k") ? Number((await ctx.input.value("k")) ?? 6) : 6;
+            return { results: await service().search(query, Number.isFinite(k) && k > 0 ? k : 6, ctx) };
+        },
+    };
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/knowledge.js.map

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

package/dist/mod.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @pattern-js/mod-buddy — the mod.
+ *
+ * Ships the control-plane capability layer (the ten restricted `pattern_*`
+ * tool workflows + the token-gated /mcp/pattern route) and Buddy's knowledge
+ * op. The chat dock, turn pipeline and thread persistence arrive with the
+ * buddy backend (`buddy.turn`); this half is useful on its own — point
+ * Claude Code at /mcp/pattern (or run `pattern mcp`) and your editor's agent
+ * becomes a Pattern author.
+ *
+ * mod-vectors is NEVER imported: knowledge probes `ctx.services` at runtime
+ * and upgrades itself when a vector engine + embedding alias are present.
+ */
+import { type PatternMod } from "@pattern-js/core";
+export interface BuddyOptions {
+    /** Where the Pattern MCP server listens (default "/mcp/pattern"). */
+    mcpPath?: string;
+    /** Skip the boot-time knowledge indexing (tests). */
+    indexOnBoot?: boolean;
+}
+export declare function buddyMod(options?: BuddyOptions): PatternMod;
+/** A ready-to-use buddy mod with defaults (for `loadMods`/`engine.use`). */
+declare const _default: PatternMod;
+export default _default;
+//# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK3F,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAYD,wBAAgB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,UAAU,CAmC/D;AAED,4EAA4E;;AAC5E,wBAA0B"}

package/dist/mod.js

@@ -0,0 +1,70 @@
+/**
+ * @pattern-js/mod-buddy — the mod.
+ *
+ * Ships the control-plane capability layer (the ten restricted `pattern_*`
+ * tool workflows + the token-gated /mcp/pattern route) and Buddy's knowledge
+ * op. The chat dock, turn pipeline and thread persistence arrive with the
+ * buddy backend (`buddy.turn`); this half is useful on its own — point
+ * Claude Code at /mcp/pattern (or run `pattern mcp`) and your editor's agent
+ * becomes a Pattern author.
+ *
+ * mod-vectors is NEVER imported: knowledge probes `ctx.services` at runtime
+ * and upgrades itself when a vector engine + embedding alias are present.
+ */
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { localFs, provideFilesystem } from "@pattern-js/runtime-node";
+import { defineMod } from "@pattern-js/core";
+import { KnowledgeService, knowledgeSearchOp } from "./knowledge.js";
+import { patternMcpServerWorkflow, toolWorkflows } from "./tools.js";
+import { buddyRoutes, turnOps, turnPipelineWorkflow } from "./turn.js";
+/** The packaged docs/ chapter (registered when the docs dir ships with the package). */
+function packagedDocs(engine) {
+    try {
+        const dir = fileURLToPath(new URL("../docs", import.meta.url));
+        if (existsSync(dir))
+            provideFilesystem(engine, "buddy-docs", localFs(dir));
+    }
+    catch {
+        /* packaged without docs — the contribution is simply skipped */
+    }
+}
+export function buddyMod(options = {}) {
+    let engineRef;
+    const knowledge = new KnowledgeService(() => engineRef);
+    return defineMod({
+        name: "@pattern-js/mod-buddy",
+        docs: { filesystem: "buddy-docs", title: "Buddy", order: 52 },
+        ops: [knowledgeSearchOp(() => knowledge), ...turnOps(() => knowledge)],
+        workflows: [...toolWorkflows(), patternMcpServerWorkflow(options.mcpPath), turnPipelineWorkflow(), ...buddyRoutes()],
+        // The dock detects Buddy through this command (EditorPage checks the
+        // aggregated ui manifest) — it also gives ⌘K a way in.
+        frontend: {
+            commands: [{ id: "buddy.open", label: "Open Buddy", group: "Buddy", icon: "wand", path: "/x/workflows" }],
+        },
+        setup: (engine) => {
+            engineRef = engine;
+            packagedDocs(engine);
+        },
+        ready: async (engine) => {
+            if (options.indexOnBoot === false)
+                return;
+            // Fire-and-forget semantic indexing: never blocks boot, never fails it.
+            // A minimal ctx-shaped bag is enough — the vectors service only reads
+            // `services` (provider/vault duck-typing) and `env` on this path.
+            const ctx = {
+                services: {
+                    vectorsService: engine.service("vectorsService"),
+                    aiProviderService: engine.service("aiProviderService"),
+                    aiConfig: engine.service("aiConfig"),
+                    vaultService: engine.service("vaultService"),
+                },
+                env: process.env,
+            };
+            setTimeout(() => void knowledge.indexDocs(ctx).catch(() => { }), 2_000);
+        },
+    });
+}
+/** A ready-to-use buddy mod with defaults (for `loadMods`/`engine.use`). */
+export default buddyMod();
+//# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,SAAS,EAAgD,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AASvE,wFAAwF;AACxF,SAAS,YAAY,CAAC,MAAc;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,UAAwB,EAAE;IACjD,IAAI,SAA6B,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAExD,OAAO,SAAS,CAAC;QACf,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7D,GAAG,EAAE,CAAC,iBAAiB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACtE,SAAS,EAAE,CAAC,GAAG,aAAa,EAAE,EAAE,wBAAwB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,oBAAoB,EAAE,EAAE,GAAG,WAAW,EAAE,CAAC;QACpH,qEAAqE;QACrE,uDAAuD;QACvD,QAAQ,EAAE;YACR,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;SAC1G;QACD,KAAK,EAAE,CAAC,MAAc,EAAE,EAAE;YACxB,SAAS,GAAG,MAAM,CAAC;YACnB,YAAY,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE;YAC9B,IAAI,OAAO,CAAC,WAAW,KAAK,KAAK;gBAAE,OAAO;YAC1C,wEAAwE;YACxE,sEAAsE;YACtE,kEAAkE;YAClE,MAAM,GAAG,GAAG;gBACV,QAAQ,EAAE;oBACR,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC;oBAChD,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC;oBACtD,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;oBACpC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;iBAC7C;gBACD,GAAG,EAAE,OAAO,CAAC,GAAG;aACO,CAAC;YAC1B,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzE,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,4EAA4E;AAC5E,eAAe,QAAQ,EAAE,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @pattern-js/mod-buddy — Buddy's system prompt.
+ *
+ * The prompt is the product here: it teaches the WorkflowDoc shape, the port
+ * discipline, and — most importantly — the LOOP: ground yourself in the docs,
+ * read real op schemas, validate BEFORE proposing, and let the human own
+ * save/deploy. Context (the open workflow, a failing run) is appended per
+ * turn by buddy.turn.begin.
+ */
+export declare const BUDDY_INSTRUCTIONS = "You are Buddy, the workflow assistant living inside a Pattern app's admin. You help the person build, understand, and debug Pattern workflows. Be warm, direct, and concrete; keep prose short and put substance in tool calls.\n\n## What a workflow is\n\nA workflow document is JSON: { \"id\": string, \"nodes\": [...], \"edges\": [...] }.\n- A node is { \"id\": string, \"op\": string, \"config\"?: object, \"comment\"?: string }. Node ids are short slugs, unique within the workflow.\n- An edge is { \"from\": { \"node\", \"port\" }, \"to\": { \"node\", \"port\" } } \u2014 dataflow from an output port to an input port.\n- Every workflow starts at a TRIGGER (boundary.http.request, boundary.schedule, boundary.event, boundary.tool, boundary.manual, ...) and normally ends at the trigger's paired OUT-GATE (boundary.http.response, boundary.tool.return, boundary.return, ...). The trigger must reach the out-gate through edges.\n- Ports are typed and come in kinds: value (one datum), stream (chunks), control (pulses). Value outputs wire to value inputs; every node also has implicit control ports \"in\"/\"out\" \u2014 a control edge threads reachability when no data flows.\n- config holds registration-time settings (paths, collection names, templates); inputs are per-run data. When both exist, a wired input overrides config.\n\n## How to work\n\n1. GROUND first: pattern_search_docs for the house pattern, pattern_list_ops to see what exists, pattern_get_op for the EXACT ports and config schema of every op you plan to use. Never guess an op type or port name \u2014 look it up.\n2. Build the doc, then pattern_validate_workflow. Fix EVERY issue it reports (issues carry nodeId + code) and validate again. Do not show the human an invalid doc.\n3. Propose with pattern_propose_workflow ({ doc, summary }): the doc appears as an Apply card in the editor \u2014 the human applies it to their canvas, reviews, and owns Save. Prefer proposing over saving; use pattern_save_workflow_draft only when asked to save.\n4. NEVER deploy unless the human explicitly asks; pattern_deploy_workflow requires their approval anyway.\n5. Debugging: pattern_list_runs (filter status \"error\"), then pattern_get_run \u2014 spans carry per-node status, timings, error messages and sampled I/O. Explain the failure by pointing at the node and the evidence, then propose the fix.\n6. When editing an existing workflow, pattern_get_workflow first and keep everything you don't need to change \u2014 node ids, ui positions, comments. Propose the FULL updated doc, never a fragment.\n\n## House rules for docs you produce\n\n- Secrets never appear as values: config references env (\"$env\" / ${VAR}) or vault-sourced refs.\n- HTTP routes that reach privileged data must set requireAuth on the trigger.\n- Give nodes honest ids (\"fetch\", \"summarize\", \"reply\") and use \"comment\" to explain non-obvious steps.\n- Lay nodes out left-to-right in execution order: ui { x, y } roughly 280 apart on x.\n- One workflow does one job; compose bigger behavior from several workflows and events.";
+/** Per-turn context appended to the instructions (the open canvas, a run under debug). */
+export declare function contextBlock(input: {
+    slug?: string;
+    doc?: unknown;
+    runId?: string;
+}): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,kBAAkB,qgGA0ByD,CAAC;AAEzF,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAe5F"}

package/dist/prompts.js

@@ -0,0 +1,59 @@
+/**
+ * @pattern-js/mod-buddy — Buddy's system prompt.
+ *
+ * The prompt is the product here: it teaches the WorkflowDoc shape, the port
+ * discipline, and — most importantly — the LOOP: ground yourself in the docs,
+ * read real op schemas, validate BEFORE proposing, and let the human own
+ * save/deploy. Context (the open workflow, a failing run) is appended per
+ * turn by buddy.turn.begin.
+ */
+export const BUDDY_INSTRUCTIONS = `You are Buddy, the workflow assistant living inside a Pattern app's admin. You help the person build, understand, and debug Pattern workflows. Be warm, direct, and concrete; keep prose short and put substance in tool calls.
+
+## What a workflow is
+
+A workflow document is JSON: { "id": string, "nodes": [...], "edges": [...] }.
+- A node is { "id": string, "op": string, "config"?: object, "comment"?: string }. Node ids are short slugs, unique within the workflow.
+- An edge is { "from": { "node", "port" }, "to": { "node", "port" } } — dataflow from an output port to an input port.
+- Every workflow starts at a TRIGGER (boundary.http.request, boundary.schedule, boundary.event, boundary.tool, boundary.manual, ...) and normally ends at the trigger's paired OUT-GATE (boundary.http.response, boundary.tool.return, boundary.return, ...). The trigger must reach the out-gate through edges.
+- Ports are typed and come in kinds: value (one datum), stream (chunks), control (pulses). Value outputs wire to value inputs; every node also has implicit control ports "in"/"out" — a control edge threads reachability when no data flows.
+- config holds registration-time settings (paths, collection names, templates); inputs are per-run data. When both exist, a wired input overrides config.
+
+## How to work
+
+1. GROUND first: pattern_search_docs for the house pattern, pattern_list_ops to see what exists, pattern_get_op for the EXACT ports and config schema of every op you plan to use. Never guess an op type or port name — look it up.
+2. Build the doc, then pattern_validate_workflow. Fix EVERY issue it reports (issues carry nodeId + code) and validate again. Do not show the human an invalid doc.
+3. Propose with pattern_propose_workflow ({ doc, summary }): the doc appears as an Apply card in the editor — the human applies it to their canvas, reviews, and owns Save. Prefer proposing over saving; use pattern_save_workflow_draft only when asked to save.
+4. NEVER deploy unless the human explicitly asks; pattern_deploy_workflow requires their approval anyway.
+5. Debugging: pattern_list_runs (filter status "error"), then pattern_get_run — spans carry per-node status, timings, error messages and sampled I/O. Explain the failure by pointing at the node and the evidence, then propose the fix.
+6. When editing an existing workflow, pattern_get_workflow first and keep everything you don't need to change — node ids, ui positions, comments. Propose the FULL updated doc, never a fragment.
+
+## House rules for docs you produce
+
+- Secrets never appear as values: config references env ("$env" / \${VAR}) or vault-sourced refs.
+- HTTP routes that reach privileged data must set requireAuth on the trigger.
+- Give nodes honest ids ("fetch", "summarize", "reply") and use "comment" to explain non-obvious steps.
+- Lay nodes out left-to-right in execution order: ui { x, y } roughly 280 apart on x.
+- One workflow does one job; compose bigger behavior from several workflows and events.`;
+/** Per-turn context appended to the instructions (the open canvas, a run under debug). */
+export function contextBlock(input) {
+    const parts = [];
+    if (input.slug)
+        parts.push(`The editor has workflow "${input.slug}" open.`);
+    if (input.doc) {
+        let json = "";
+        try {
+            json = JSON.stringify(input.doc);
+        }
+        catch {
+            json = "";
+        }
+        if (json.length > 12_000)
+            json = `${json.slice(0, 12_000)}… (truncated — pattern_get_workflow for the stored version)`;
+        if (json)
+            parts.push(`Current canvas document (may have unsaved edits):\n${json}`);
+    }
+    if (input.runId)
+        parts.push(`The person is looking at run "${input.runId}" — pattern_get_run it before answering.`);
+    return parts.length ? `\n\n## Current context\n\n${parts.join("\n\n")}` : "";
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;wFA0BsD,CAAC;AAEzF,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,KAAuD;IAClF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,4BAA4B,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC;IAC5E,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM;YAAE,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,6DAA6D,CAAC;QACvH,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,sDAAsD,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,iCAAiC,KAAK,CAAC,KAAK,0CAA0C,CAAC,CAAC;IACpH,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,6BAA6B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/threads.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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).
+ */
+import type { OpContext, Principal } from "@pattern-js/core";
+export declare const THREADS = "buddy.threads";
+export interface ThreadDoc {
+    slug: string;
+    ownerId: string;
+    messages: unknown[];
+    updatedAt: number;
+}
+export declare function ownerOf(principal: Principal): string;
+/** The thread's messages (empty when no store / no thread yet). */
+export declare function loadThread(ctx: OpContext, slug: string): Promise<unknown[]>;
+/** Replace the thread's messages with the turn's updated history (CAS-retried). */
+export declare function saveThread(ctx: OpContext, slug: string, messages: unknown[]): Promise<boolean>;
+export declare function clearThread(ctx: OpContext, slug: string): Promise<boolean>;
+/** Whether persistence is available (the dock's status probe reports it). */
+export declare function hasThreadStore(services: Record<string, unknown>): boolean;
+//# sourceMappingURL=threads.d.ts.map

package/dist/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../src/threads.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAoBvC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,wBAAgB,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAEpD;AAYD,mEAAmE;AACnE,wBAAsB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAOjF;AAED,mFAAmF;AACnF,wBAAsB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAcpG;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhF;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEzE"}