@project-ava-supernova/core 0.2.71

package/dist/tools/docs-lookup.js

@@ -0,0 +1,174 @@
+import { getPages } from '../docs/corpus.js';
+import { SECTION_LABELS, SECTION_ORDER } from '../docs/types.js';
+import { commonSurfaces } from '../docs/data/capabilities.js';
+import { searchDocs } from '../docs/product-knowledge.js';
+// Friendly names for the surface-availability note, so Ava can say where a
+// capability-gated feature actually works.
+const SURFACE_NAME = {
+    ext: 'the VS Code extension', ide: 'the desktop IDE', companion: 'the companion app',
+    cli: 'the CLI', web: 'the website',
+};
+/**
+ * Searches Ava's own documentation. Reads the SAME canonical corpus the web,
+ * extension, and IDE render (packages/core/src/docs/content) so the tool can
+ * never drift from what users actually see — there is one source of truth.
+ *
+ * The previous implementation searched a parallel hand-maintained text file
+ * (ava-docs.ts) that had gone stale (old tool counts, retired model names).
+ * That file is gone; this tool flattens the structured DocPages to searchable
+ * text at call time.
+ */
+export class DocsLookupTool {
+    name = 'docs_lookup';
+    description = 'Search Ava\'s own documentation (her product knowledge) to answer questions about features, setup, and troubleshooting — returns focused, cited excerpts';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'docs_lookup',
+        description: 'Search Ava\'s own documentation to answer user questions about features, setup, configuration, ' +
+            'troubleshooting, models, tools, modes, permissions, memory, keyboard shortcuts, billing, and more. ' +
+            'Use this when a user asks "how do I...", "what is...", "how does... work", or needs help with any ' +
+            'Ava feature. Returns focused, cited excerpts from the relevant pages — answer grounded in them and ' +
+            'name the source page so the user can verify.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'What to search for. Can be a topic name (e.g. "models", "memory", "permissions") ' +
+                        'or a natural question (e.g. "how do I add an API key", "what models are available").',
+                },
+                topic: {
+                    type: 'string',
+                    enum: [...SECTION_ORDER],
+                    description: 'Optional: return every page in a documentation section. One of: ' +
+                        SECTION_ORDER.join(', ') + '. If provided, the section\'s full content is returned.',
+                },
+            },
+            required: [],
+        },
+    };
+    async execute(args, context) {
+        const query = args.query?.trim().toLowerCase();
+        const topic = args.topic?.trim().toLowerCase();
+        const surface = context.surface;
+        const pages = getPages();
+        // Direct section lookup — return every page in that section.
+        if (topic) {
+            const inSection = pages.filter(p => p.section === topic);
+            if (inSection.length > 0) {
+                const heading = `# ${SECTION_LABELS[topic] ?? topic}\n\n`;
+                return { success: true, output: heading + inSection.map(p => this.pageToText(p, surface)).join('\n\n---\n\n') };
+            }
+            return {
+                success: false,
+                output: `Section "${topic}" not found. Available sections: ${SECTION_ORDER.join(', ')}`,
+            };
+        }
+        // No query and no topic — list the sections and their pages.
+        if (!query) {
+            const list = SECTION_ORDER.map(s => {
+                const titles = pages.filter(p => p.section === s).map(p => p.title);
+                return `- **${s}** (${SECTION_LABELS[s]}) — ${titles.join(', ')}`;
+            }).join('\n');
+            return {
+                success: true,
+                output: `# Available Documentation\n\n${list}\n\nUse \`topic\` for a whole section, or \`query\` to search across all docs.`,
+            };
+        }
+        // Search: grounded, block-level TF-IDF retrieval with citations. Returns the
+        // most relevant blocks (not whole pages), grouped by source page and
+        // attributed, so Ava can answer grounded and say where it came from.
+        const hits = searchDocs(query, 10);
+        if (hits.length === 0) {
+            return {
+                success: true,
+                output: `No documentation found matching "${query}". Sections: ${SECTION_ORDER.join(', ')}`,
+            };
+        }
+        // Keep only clearly-relevant hits — drop the tangential tail below 35% of the
+        // top score so the grounding stays focused.
+        const floor = hits[0].score * 0.35;
+        const relevant = hits.filter(h => h.score >= floor);
+        return { success: true, output: this.renderHits(relevant, surface) };
+    }
+    /** A surface-availability footnote for capability-gated features, so Ava can
+     *  say where a feature works and whether it's usable on the current surface. */
+    availabilityNote(page, surface) {
+        return this.availabilityNoteFor(page.requires, surface);
+    }
+    /** Availability footnote from a page's required capabilities — so Ava can say
+     *  where a feature works and whether it's usable on the current surface. */
+    availabilityNoteFor(requires, surface) {
+        if (!requires || requires.length === 0)
+            return '';
+        const surfaces = commonSurfaces(requires);
+        if (surfaces.length === 0)
+            return '';
+        const names = surfaces.map(s => SURFACE_NAME[s] ?? s).join(', ');
+        let note = `\n\n_Availability: this feature works in ${names}._`;
+        if (surface && surface !== 'web' && !surfaces.includes(surface)) {
+            note += ` _It is not available on your current surface (${SURFACE_NAME[surface] ?? surface})._`;
+        }
+        return note;
+    }
+    /** Render retrieved blocks grouped by their source page, each cited so Ava can
+     *  attribute the answer. Focused evidence, not whole pages. */
+    renderHits(hits, surface) {
+        const byPage = new Map();
+        for (const h of hits) {
+            let g = byPage.get(h.pageId);
+            if (!g) {
+                g = { title: h.pageTitle, section: h.section, requires: h.requires, status: h.status, blocks: [] };
+                byPage.set(h.pageId, g);
+            }
+            if (!g.blocks.includes(h.text))
+                g.blocks.push(h.text);
+        }
+        const out = [];
+        for (const g of byPage.values()) {
+            const cite = `_Source: ${SECTION_LABELS[g.section]} → ${g.title}_`;
+            out.push(`## ${g.title}\n\n${g.blocks.join('\n\n')}\n\n${cite}${this.statusNote(g.status)}${this.availabilityNoteFor(g.requires, surface)}`);
+            if (out.length >= 5)
+                break; // cap distinct source pages for a focused answer
+        }
+        return out.join('\n\n---\n\n');
+    }
+    /** Shipping-status note so Ava never presents an unshipped feature as usable
+     *  right now. Shipped (the default) is silent — the prose already implies it. */
+    statusNote(status) {
+        if (status === 'preview')
+            return '\n\n_Status: in preview — limited/gated rollout, not yet generally available._';
+        if (status === 'planned')
+            return '\n\n_Status: on the roadmap — not shipped yet._';
+        return '';
+    }
+    /** Flatten a DocPage's blocks into plain searchable/printable text. Includes
+     *  the optional `deeper` ("Show me the details") layer — that's where the
+     *  technical depth now lives, so it must be searchable and returnable too. */
+    pageToText(page, surface) {
+        const lines = [`## ${page.title}`];
+        for (const b of page.body)
+            lines.push(this.blockToText(b));
+        if (page.deeper && page.deeper.length > 0) {
+            lines.push('### Details');
+            for (const b of page.deeper)
+                lines.push(this.blockToText(b));
+        }
+        return lines.filter(Boolean).join('\n\n') + this.availabilityNote(page, surface);
+    }
+    blockToText(b) {
+        switch (b.type) {
+            case 'paragraph': return b.text;
+            case 'heading': return `${'#'.repeat(b.level)} ${b.text}`;
+            case 'list': return b.items.map((i, n) => (b.ordered ? `${n + 1}. ${i}` : `- ${i}`)).join('\n');
+            case 'code': return '```' + (b.language ?? '') + '\n' + b.text + '\n```';
+            case 'callout': return `> ${b.variant.toUpperCase()}: ${b.text}`;
+            case 'link': return `${b.text}: ${b.href}`;
+            case 'table': return [b.headers.join(' | '), ...b.rows.map(r => r.join(' | '))].join('\n');
+            case 'facts': return `(live ${b.kind} table — rendered in-app from current data)`;
+            default: return '';
+        }
+    }
+}
+//# sourceMappingURL=docs-lookup.js.map

package/dist/tools/docs-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-lookup.js","sourceRoot":"","sources":["../../src/tools/docs-lookup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAA8D,MAAM,kBAAkB,CAAC;AAC7H,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAe,MAAM,8BAA8B,CAAC;AAEvE,2EAA2E;AAC3E,2CAA2C;AAC3C,MAAM,YAAY,GAA2B;IAC3C,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,iBAAiB,EAAE,SAAS,EAAE,mBAAmB;IACpF,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa;CACnC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAAG,0JAA0J,CAAC;IACzK,SAAS,GAAkB,MAAM,CAAC;IAClC,oBAAoB,GAAG,KAAK,CAAC;IAE7B,MAAM,GAAmB;QAChC,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,iGAAiG;YACjG,qGAAqG;YACrG,oGAAoG;YACpG,qGAAqG;YACrG,8CAA8C;QAChD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,mFAAmF;wBACnF,sFAAsF;iBACzF;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC;oBACxB,WAAW,EACT,kEAAkE;wBAClE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,yDAAyD;iBACvF;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,OAA6B;QACxE,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QAEzB,6DAA6D;QAC7D,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;YACzD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,KAAK,cAAc,CAAC,KAAgB,CAAC,IAAI,KAAK,MAAM,CAAC;gBACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YAClH,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,YAAY,KAAK,oCAAoC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACxF,CAAC;QACJ,CAAC;QAED,6DAA6D;QAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;gBACjC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACpE,OAAO,OAAO,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,gCAAgC,IAAI,gFAAgF;aAC7H,CAAC;QACJ,CAAC;QAED,6EAA6E;QAC7E,qEAAqE;QACrE,qEAAqE;QACrE,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,oCAAoC,KAAK,gBAAgB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC5F,CAAC;QACJ,CAAC;QACD,8EAA8E;QAC9E,4CAA4C;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;IACvE,CAAC;IAED;oFACgF;IACxE,gBAAgB,CAAC,IAAa,EAAE,OAAgB;QACtD,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;gFAC4E;IACpE,mBAAmB,CAAC,QAAkC,EAAE,OAAgB;QAC9E,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,IAAI,GAAG,4CAA4C,KAAK,IAAI,CAAC;QACjE,IAAI,OAAO,IAAI,OAAO,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAgB,CAAC,EAAE,CAAC;YACzE,IAAI,IAAI,kDAAkD,YAAY,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,CAAC;QAClG,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;mEAC+D;IACvD,UAAU,CAAC,IAAc,EAAE,OAAgB;QACjD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqH,CAAC;QAC5I,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC7B,IAAI,CAAC,CAAC,EAAE,CAAC;gBAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAAC,CAAC;YACxI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,YAAY,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,GAAG,CAAC;YACnE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7I,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;gBAAE,MAAM,CAAC,iDAAiD;QAC/E,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED;qFACiF;IACzE,UAAU,CAAC,MAA0C;QAC3D,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,gFAAgF,CAAC;QAClH,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,iDAAiD,CAAC;QACnF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;kFAE8E;IACtE,UAAU,CAAC,IAAa,EAAE,OAAgB;QAChD,MAAM,KAAK,GAAa,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAEO,WAAW,CAAC,CAAW;QAC7B,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;YAChC,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1D,KAAK,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChG,KAAK,MAAM,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC;YACzE,KAAK,SAAS,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YACjE,KAAK,MAAM,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3C,KAAK,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3F,KAAK,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,IAAI,6CAA6C,CAAC;YAClF,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

package/dist/tools/document-author.d.ts

@@ -0,0 +1,40 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * Author prose documents with Markdown as the canonical, editable source.
+ *
+ * The `.md` is the document; `.docx`/`.pdf` are exports produced by `build`.
+ * Editing is non-destructive and surgical — `edit_section` replaces exactly one
+ * section by delegating to `file_edit` (same diff, audit, and rollback as any
+ * code edit), so the rest of the document is never touched. This replaces the
+ * old destructive `.docx` recreate-from-text path.
+ */
+export declare class DocumentAuthorTool implements Tool {
+    readonly name = "document_author";
+    readonly description = "Author and edit prose documents (Markdown source \u2192 branded Word/PDF). Non-destructive, section-surgical.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    private create;
+    private fromTemplate;
+    private listTemplates;
+    private saveTemplate;
+    private setHouseStyle;
+    private build;
+    private read;
+    private outline;
+    private editSection;
+    private insertSection;
+    private ensureFrontMatter;
+    /** Inject the saved house-style brand into a document's front-matter, unless
+     *  it already declares its own brand. No front-matter → left untouched. */
+    private injectBrand;
+    private today;
+    private slug;
+    private normalizeDomain;
+    private deriveOut;
+    private trackRead;
+    private mutation;
+}
+//# sourceMappingURL=document-author.d.ts.map

package/dist/tools/document-author.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-author.d.ts","sourceRoot":"","sources":["../../src/tools/document-author.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAoB5D;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,YAAW,IAAI;IAC7C,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,mHAA8G;IAClI,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,QAAQ;IAErC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAoC7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;YAkBlF,MAAM;YAyBN,YAAY;YAiCZ,aAAa;YAgBb,YAAY;YAkCZ,aAAa;YAeb,KAAK;YAuCL,IAAI;YAkCJ,OAAO;YAYP,WAAW;YA0BX,aAAa;IA8B3B,OAAO,CAAC,iBAAiB;IAUzB;+EAC2E;IAC3E,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,QAAQ;CAajB"}