@project-ava-supernova/core 0.2.71

package/dist/docs/i18n.d.ts

@@ -0,0 +1,15 @@
+import type { DocPage } from './types.js';
+/**
+ * Every translatable [key, englishText] pair across the given pages. Used by
+ * the translate script to know what to send to the model. Order is stable.
+ */
+export declare function docTranslatableEntries(pages: DocPage[]): Array<[string, string]>;
+/** Locales we have (or can have) doc translations for. */
+export declare function availableDocLocales(): string[];
+/**
+ * Return the corpus localized to `locale`. English (or an unknown locale)
+ * returns the pages untouched. Otherwise each block's text is swapped for its
+ * translation with per-block English fallback.
+ */
+export declare function localizePages(pages: DocPage[], locale: string | undefined): DocPage[];
+//# sourceMappingURL=i18n.d.ts.map

package/dist/docs/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/docs/i18n.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,YAAY,CAAC;AA4CpD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQhF;AAED,0DAA0D;AAC1D,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,EAAE,CAUrF"}

package/dist/docs/i18n.js

@@ -0,0 +1,88 @@
+// Documentation translation layer.
+//
+// English lives in content/*.ts (source of truth). The other 19 locales are
+// generated translations stored in i18n/translations.ts, keyed by a stable
+// per-block key. Renderers call getPages(locale) and receive the corpus with
+// every translatable text swapped for its translation — falling back to
+// English per-block whenever a translation is missing, so a partial run never
+// shows blank or broken pages.
+//
+// Code blocks and `facts` blocks are never translated (code is code; facts are
+// live data tables rendered from the typed data files).
+import { DOC_TRANSLATIONS } from './i18n/translations.js';
+/** Stable key for a translatable string within a page. */
+function pageKey(pageId) {
+    return `${pageId}#title`;
+}
+/** Every translatable [key, englishText] pair in a block, under a key prefix. */
+function blockEntries(base, b) {
+    switch (b.type) {
+        case 'paragraph': return [[`${base}#p`, b.text]];
+        case 'heading': return [[`${base}#h`, b.text]];
+        case 'list': return b.items.map((it, i) => [`${base}#li${i}`, it]);
+        case 'callout': return [[`${base}#c`, b.text]];
+        case 'link': return [[`${base}#a`, b.text]];
+        case 'table': {
+            const e = [];
+            b.headers.forEach((h, c) => e.push([`${base}#th${c}`, h]));
+            b.rows.forEach((r, ri) => r.forEach((cell, ci) => e.push([`${base}#td${ri}.${ci}`, cell])));
+            return e;
+        }
+        default: return []; // code, facts — never translated
+    }
+}
+/** Apply a translation dict to one block, English fallback per field. */
+function applyBlock(base, b, dict) {
+    const t = (k, fallback) => dict[k] ?? fallback;
+    switch (b.type) {
+        case 'paragraph': return { ...b, text: t(`${base}#p`, b.text) };
+        case 'heading': return { ...b, text: t(`${base}#h`, b.text) };
+        case 'list': return { ...b, items: b.items.map((it, i) => t(`${base}#li${i}`, it)) };
+        case 'callout': return { ...b, text: t(`${base}#c`, b.text) };
+        case 'link': return { ...b, text: t(`${base}#a`, b.text) };
+        case 'table': return {
+            ...b,
+            headers: b.headers.map((h, c) => t(`${base}#th${c}`, h)),
+            rows: b.rows.map((r, ri) => r.map((cell, ci) => t(`${base}#td${ri}.${ci}`, cell))),
+        };
+        default: return b; // code, facts unchanged
+    }
+}
+/**
+ * Every translatable [key, englishText] pair across the given pages. Used by
+ * the translate script to know what to send to the model. Order is stable.
+ */
+export function docTranslatableEntries(pages) {
+    const out = [];
+    for (const p of pages) {
+        out.push([pageKey(p.id), p.title]);
+        p.body.forEach((b, i) => { for (const e of blockEntries(`${p.id}#${i}`, b))
+            out.push(e); });
+        p.deeper?.forEach((b, i) => { for (const e of blockEntries(`${p.id}#deeper#${i}`, b))
+            out.push(e); });
+    }
+    return out;
+}
+/** Locales we have (or can have) doc translations for. */
+export function availableDocLocales() {
+    return Object.keys(DOC_TRANSLATIONS);
+}
+/**
+ * Return the corpus localized to `locale`. English (or an unknown locale)
+ * returns the pages untouched. Otherwise each block's text is swapped for its
+ * translation with per-block English fallback.
+ */
+export function localizePages(pages, locale) {
+    if (!locale || locale === 'en')
+        return pages;
+    const dict = DOC_TRANSLATIONS[locale];
+    if (!dict)
+        return pages;
+    return pages.map(p => ({
+        ...p,
+        title: dict[pageKey(p.id)] ?? p.title,
+        body: p.body.map((b, i) => applyBlock(`${p.id}#${i}`, b, dict)),
+        deeper: p.deeper?.map((b, i) => applyBlock(`${p.id}#deeper#${i}`, b, dict)),
+    }));
+}
+//# sourceMappingURL=i18n.js.map

package/dist/docs/i18n.js.map

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

package/dist/docs/index.d.ts

@@ -0,0 +1,16 @@
+export type { Audience, Surface, Section, TaskId, Capability, DocPage, DocBlock, FactsBlock, SidebarNode } from './types.js';
+export { SECTION_LABELS, SECTION_ORDER } from './types.js';
+export type { RendererAdapter, FactsData, PageExtras } from './adapter.js';
+export { renderPage, renderBlock, pageBadges } from './adapter.js';
+export { filterBySurface, filterByCapability, filterForSurface, filterByAudience, buildSidebar, anchorFor } from './filter.js';
+export { getPages, getPage } from './corpus.js';
+export { docTranslatableEntries, localizePages, availableDocLocales } from './i18n.js';
+export * from './data/tools.js';
+export * from './data/providers.js';
+export * from './data/modes.js';
+export * from './data/personas.js';
+export * from './data/permissions.js';
+export * from './data/shortcuts.js';
+export * from './data/capabilities.js';
+export * from './data/tasks.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7H,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/H,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEvF,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC"}

package/dist/docs/index.js

@@ -0,0 +1,15 @@
+// Public entry point for the docs corpus. Surface renderers import from here.
+export { SECTION_LABELS, SECTION_ORDER } from './types.js';
+export { renderPage, renderBlock, pageBadges } from './adapter.js';
+export { filterBySurface, filterByCapability, filterForSurface, filterByAudience, buildSidebar, anchorFor } from './filter.js';
+export { getPages, getPage } from './corpus.js';
+export { docTranslatableEntries, localizePages, availableDocLocales } from './i18n.js';
+export * from './data/tools.js';
+export * from './data/providers.js';
+export * from './data/modes.js';
+export * from './data/personas.js';
+export * from './data/permissions.js';
+export * from './data/shortcuts.js';
+export * from './data/capabilities.js';
+export * from './data/tasks.js';
+//# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAG9E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/H,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEvF,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC"}

package/dist/docs/product-knowledge.d.ts

@@ -0,0 +1,45 @@
+import type { DocPage, Section, Surface, Capability } from './types.js';
+/** A retrieved documentation block with everything needed to cite it. */
+export interface DocHit {
+    /** Source page id, e.g. 'features.creative-studio'. */
+    pageId: string;
+    /** Human-readable page title — the citation target. */
+    pageTitle: string;
+    section: Section;
+    /** URL fragment for a deep link, e.g. 'features-creative-studio'. */
+    anchor: string;
+    /** Surfaces the source page's feature applies to. */
+    surfaces: Surface[];
+    /** Capabilities gating the page, if any (drives availability notes). */
+    requires?: Capability[];
+    /** Shipping status of the source feature (omitted = shipped). */
+    status?: 'shipped' | 'preview' | 'planned';
+    /** The matched block's plain text. */
+    text: string;
+    /** TF-IDF cosine score (higher = more relevant). */
+    score: number;
+}
+/**
+ * Block-granular TF-IDF index over a set of DocPages. Each translatable block
+ * is one retrievable unit, keyed `pageId#index` (mirrors the i18n scheme), so
+ * every hit carries a stable, citable id.
+ */
+export declare class ProductKnowledgeIndex {
+    private readonly records;
+    private readonly termVectors;
+    private readonly docFreq;
+    private readonly idf;
+    private docCount;
+    constructor(pages: DocPage[]);
+    private add;
+    private tfidf;
+    private cosine;
+    /** Ranked blocks for a query, best first. */
+    search(query: string, limit?: number): DocHit[];
+}
+/** Process-cached index over the canonical English corpus. Rebuilt on process
+ *  start from the compiled-in docs, so it can never drift from the source. */
+export declare function productKnowledgeIndex(): ProductKnowledgeIndex;
+/** Grounded, cited search over Ava's own documentation. */
+export declare function searchDocs(query: string, limit?: number): DocHit[];
+//# sourceMappingURL=product-knowledge.d.ts.map

package/dist/docs/product-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-knowledge.d.ts","sourceRoot":"","sources":["../../src/docs/product-knowledge.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAY,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAElF,yEAAyE;AACzE,MAAM,WAAW,MAAM;IACrB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,iEAAiE;IACjE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAgCD;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAK;gBAET,KAAK,EAAE,OAAO,EAAE;IAsB5B,OAAO,CAAC,GAAG;IAcX,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,MAAM;IAUd,6CAA6C;IAC7C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE;CAiB3C;AAID;8EAC8E;AAC9E,wBAAgB,qBAAqB,IAAI,qBAAqB,CAG7D;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAE7D"}

package/dist/docs/product-knowledge.js

@@ -0,0 +1,147 @@
+// Product-knowledge retrieval — grounded, cited search over the docs corpus.
+// Ava's self-knowledge layer: block-level TF-IDF over the SAME DocPages every
+// surface renders, so answers can't drift from what users see.
+//
+// LIVES IN docs/ ON PURPOSE: docs/ is mirrored into the web + mobile apps by
+// scripts/docs-sync.mjs. So this retriever ships to every standalone surface
+// (web social composer, companion) — not just the core agent. Therefore it is
+// SELF-CONTAINED: a small inline TF-IDF, no import from ../memory (which the
+// mirror doesn't carry). The corpus is ~40 pages / a few-hundred blocks — well
+// under the size where embeddings would earn their infrastructure — so plain
+// TF-IDF (zero-dependency, local, free) is the right, on-brand tool.
+//
+// Freshness by construction: the index is built from getPages() at first use,
+// so it always reflects the compiled-in docs — no separate store to rot.
+import { getPages } from './corpus.js';
+import { anchorFor } from './filter.js';
+const STOPWORDS = new Set([
+    'the', 'a', 'an', 'and', 'or', 'but', 'is', 'are', 'was', 'were', 'be', 'been',
+    'to', 'of', 'in', 'on', 'for', 'with', 'as', 'by', 'at', 'from', 'it', 'its',
+    'this', 'that', 'these', 'those', 'you', 'your', 'i', 'we', 'they', 'he', 'she',
+    'do', 'does', 'did', 'can', 'how', 'what', 'why', 'when', 'where', 'which', 'so',
+]);
+/** Lowercase, split on non-word chars but keep tool-name/path chars, drop stopwords. */
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9\-_./]+/)
+        .filter((t) => t.length > 1 && !STOPWORDS.has(t));
+}
+/** Plain, searchable text for a block. Code + live-facts blocks are skipped. */
+function blockToSearchText(b) {
+    switch (b.type) {
+        case 'paragraph': return b.text;
+        case 'heading': return b.text;
+        case 'list': return b.items.join('. ');
+        case 'callout': return b.text;
+        case 'link': return b.text;
+        case 'table': return [...b.headers, ...b.rows.flat()].join(' ');
+        default: return null; // code, facts
+    }
+}
+/**
+ * Block-granular TF-IDF index over a set of DocPages. Each translatable block
+ * is one retrievable unit, keyed `pageId#index` (mirrors the i18n scheme), so
+ * every hit carries a stable, citable id.
+ */
+export class ProductKnowledgeIndex {
+    records = new Map();
+    termVectors = new Map();
+    docFreq = new Map();
+    idf = new Map();
+    docCount = 0;
+    constructor(pages) {
+        for (const p of pages) {
+            const meta = {
+                pageId: p.id, pageTitle: p.title, section: p.section,
+                anchor: anchorFor(p.id), surfaces: p.surfaces, requires: p.requires,
+                status: p.status,
+            };
+            p.body.forEach((b, i) => {
+                const t = blockToSearchText(b);
+                if (t)
+                    this.add(`${p.id}#${i}`, { ...meta, text: t });
+            });
+            p.deeper?.forEach((b, i) => {
+                const t = blockToSearchText(b);
+                if (t)
+                    this.add(`${p.id}#deeper#${i}`, { ...meta, text: t });
+            });
+        }
+        // IDF, computed once after all docs are added.
+        for (const [term, df] of this.docFreq) {
+            this.idf.set(term, Math.log(1 + this.docCount / (1 + df)));
+        }
+    }
+    add(key, rec) {
+        this.records.set(key, rec);
+        // Prepend the page title so each block reads as a self-contained chunk and
+        // page-name queries surface its blocks.
+        const terms = tokenize(`${rec.pageTitle}. ${rec.text}`);
+        const tf = new Map();
+        for (const term of terms)
+            tf.set(term, (tf.get(term) ?? 0) + 1);
+        // Log-normalized TF.
+        for (const [term, n] of tf)
+            tf.set(term, 1 + Math.log(n));
+        this.termVectors.set(key, tf);
+        for (const term of new Set(terms))
+            this.docFreq.set(term, (this.docFreq.get(term) ?? 0) + 1);
+        this.docCount++;
+    }
+    tfidf(tf) {
+        const v = new Map();
+        for (const [term, w] of tf)
+            v.set(term, w * (this.idf.get(term) ?? 0));
+        return v;
+    }
+    cosine(a, b) {
+        let dot = 0, na = 0, nb = 0;
+        for (const [, w] of a)
+            na += w * w;
+        for (const [, w] of b)
+            nb += w * w;
+        if (na === 0 || nb === 0)
+            return 0;
+        const [small, large] = a.size < b.size ? [a, b] : [b, a];
+        for (const [term, w] of small) {
+            const o = large.get(term);
+            if (o)
+                dot += w * o;
+        }
+        return dot / (Math.sqrt(na) * Math.sqrt(nb));
+    }
+    /** Ranked blocks for a query, best first. */
+    search(query, limit = 6) {
+        const qTerms = tokenize(query);
+        if (qTerms.length === 0)
+            return [];
+        const qtf = new Map();
+        for (const t of qTerms)
+            qtf.set(t, (qtf.get(t) ?? 0) + 1);
+        const qVec = this.tfidf(qtf);
+        const scored = [];
+        for (const [key, tf] of this.termVectors) {
+            const score = this.cosine(qVec, this.tfidf(tf));
+            if (score > 0) {
+                const r = this.records.get(key);
+                scored.push({ ...r, score });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, limit);
+    }
+}
+let cached = null;
+/** Process-cached index over the canonical English corpus. Rebuilt on process
+ *  start from the compiled-in docs, so it can never drift from the source. */
+export function productKnowledgeIndex() {
+    if (!cached)
+        cached = new ProductKnowledgeIndex(getPages('en'));
+    return cached;
+}
+/** Grounded, cited search over Ava's own documentation. */
+export function searchDocs(query, limit = 6) {
+    return productKnowledgeIndex().search(query, limit);
+}
+//# sourceMappingURL=product-knowledge.js.map

package/dist/docs/product-knowledge.js.map

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

package/dist/docs/types.d.ts

@@ -0,0 +1,138 @@
+export type Audience = 'newcomer' | 'power' | 'both';
+/**
+ * A surface is both a doc-rendering target and a product. For 'ext' | 'ide' |
+ * 'companion' | 'cli' the in-app docs describe that product, so capability
+ * filtering applies. 'web' is the public site — a superset that shows every
+ * page with per-surface badges, so capability filtering never hides on web.
+ */
+export type Surface = 'web' | 'ext' | 'ide' | 'companion' | 'cli';
+/**
+ * What you want to do — the task-first front door. Pages are grouped by task;
+ * the section taxonomy below becomes the "go deeper" reference layer.
+ * Canonical list + copy live in `data/tasks.ts`.
+ */
+export type TaskId = 'build' | 'write' | 'learn' | 'create' | 'health' | 'make-it-yours' | 'troubleshoot';
+/**
+ * A product capability that isn't available on every surface (e.g. the IDE has
+ * desktop automation and screenshots; the extension does not). The surface set
+ * for each capability is declared once in `data/capabilities.ts`. A page that
+ * `requires` a capability auto-hides on surfaces that lack it.
+ */
+export type Capability = 'desktop_automation' | 'screenshot' | 'browser' | 'document_authoring' | 'live_doc_preview';
+export type Section = 'start' | 'models' | 'credits' | 'concepts' | 'reference' | 'features' | 'troubleshooting';
+export interface DocPage {
+    /** Stable id used for anchors, sidebar routing, and i18n keys. Dot-namespaced: 'start.install', 'reference.tools'. */
+    id: string;
+    /** Human-readable title shown in the sidebar and page heading. */
+    title: string;
+    /** Which audiences should see this page. ['both'] means always visible. */
+    audience: Audience[];
+    /** Which surfaces render this page. Omit a surface to hide the page there. */
+    surfaces: Surface[];
+    /** Sort order within its section (stable integer spacing recommended). */
+    order: number;
+    /** Top-level section the page belongs to. */
+    section: Section;
+    /**
+     * Outcome group for the task-first front door. Optional during migration —
+     * untagged pages still render under their `section` in the reference layer.
+     */
+    task?: TaskId;
+    /**
+     * Capabilities this page depends on. The page auto-hides on any surface that
+     * lacks them (per `data/capabilities.ts`). 'web' always shows it (badged).
+     */
+    requires?: Capability[];
+    /** Shipping status for Ava's product-knowledge answers. Omitted = shipped (the
+     *  default). 'preview' = built but gated / limited rollout; 'planned' = on the
+     *  roadmap, not built yet. Minimal + local so answers never claim an unshipped
+     *  feature is available. */
+    status?: 'shipped' | 'preview' | 'planned';
+    /** Body blocks parsed from the markdown file. */
+    body: DocBlock[];
+    /**
+     * Optional "Show me the details" depth — power-user blocks rendered behind an
+     * expander beneath `body`, so one page serves newcomers and experts alike.
+     */
+    deeper?: DocBlock[];
+}
+export type DocBlock = {
+    type: 'paragraph';
+    text: string;
+} | {
+    type: 'heading';
+    level: 2 | 3 | 4;
+    text: string;
+    anchor?: string;
+} | {
+    type: 'list';
+    ordered: boolean;
+    items: string[];
+} | {
+    type: 'code';
+    language: string;
+    text: string;
+} | {
+    type: 'callout';
+    variant: 'note' | 'warning' | 'tip';
+    text: string;
+} | {
+    type: 'link';
+    text: string;
+    href: string;
+    external?: boolean;
+} | {
+    type: 'table';
+    headers: string[];
+    rows: string[][];
+} | FactsBlock;
+/**
+ * A fact-table reference. The renderer looks up the canonical data in `packages/core/docs/data/`
+ * and produces a surface-appropriate table/grid/list. Numbers are never in the markdown.
+ */
+export type FactsBlock = {
+    type: 'facts';
+    kind: 'tools';
+    filter?: {
+        category?: string;
+        risk?: string;
+    };
+} | {
+    type: 'facts';
+    kind: 'providers';
+    filter?: {
+        kind?: 'orchestration' | 'managed' | 'byok';
+    };
+} | {
+    type: 'facts';
+    kind: 'modes';
+} | {
+    type: 'facts';
+    kind: 'personas';
+    filter?: {
+        mode?: string;
+    };
+} | {
+    type: 'facts';
+    kind: 'permissions';
+} | {
+    type: 'facts';
+    kind: 'shortcuts';
+    filter?: {
+        surface?: 'extension' | 'ide' | 'cli';
+    };
+};
+export interface SidebarNode {
+    id: string;
+    title: string;
+    section: Section;
+    pages: Array<{
+        id: string;
+        title: string;
+        audience: Audience[];
+        anchor: string;
+    }>;
+}
+export declare const SECTION_LABELS: Record<Section, string>;
+export declare const SECTION_ORDER: Section[];
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/docs/types.js

@@ -0,0 +1,14 @@
+// Shared contract between the corpus and every surface renderer.
+// Markdown front-matter is parsed into DocPage; the body becomes DocBlock[].
+// Each surface (web, extension, IDE) implements its own render pass over these types.
+export const SECTION_LABELS = {
+    start: 'Start here',
+    models: 'Models',
+    credits: 'Credits',
+    concepts: 'Core concepts',
+    reference: 'Reference',
+    features: 'Features',
+    troubleshooting: 'Troubleshooting & support',
+};
+export const SECTION_ORDER = ['start', 'models', 'credits', 'concepts', 'reference', 'features', 'troubleshooting'];
+//# sourceMappingURL=types.js.map

package/dist/docs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/docs/types.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,6EAA6E;AAC7E,sFAAsF;AAkHtF,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,eAAe,EAAE,2BAA2B;CAC7C,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC"}

package/dist/events/event-detector.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Event Detector — Ava's proactive awareness system.
+ *
+ * Scans current state (tasks, journal, memory, errors) and fires events
+ * when conditions are met. Not a cron — runs on-demand during normal usage
+ * (extension activation, briefing, or explicit check).
+ */
+import type { TaskManager } from '../tasks/task-manager.js';
+import type { JournalManager } from '../journal/journal-manager.js';
+import type { MemoryManager } from '../memory/memory-manager.js';
+import type { AvaEvent, AvaEventHandler } from './types.js';
+export declare class EventDetector {
+    private handlers;
+    private state;
+    constructor();
+    /** Register an event handler. */
+    on(handler: AvaEventHandler): void;
+    /** Remove an event handler. */
+    off(handler: AvaEventHandler): void;
+    /**
+     * Run all detectors and fire events.
+     * Call this during briefing, activation, or periodically.
+     */
+    detect(opts: {
+        taskManager?: TaskManager;
+        journalManager?: JournalManager;
+        memoryManager?: MemoryManager;
+    }): Promise<AvaEvent[]>;
+    /** Track an error occurrence (call from agent error handler). */
+    trackError(errorMessage: string): AvaEvent | null;
+    /** Reset error counts (e.g. on new session). */
+    resetErrors(): void;
+    private detectTaskEvents;
+    private detectJournalEvents;
+    private detectMemoryEvents;
+    private todayDate;
+    private offsetDate;
+}
+//# sourceMappingURL=event-detector.d.ts.map

package/dist/events/event-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-detector.d.ts","sourceRoot":"","sources":["../../src/events/event-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAsB,MAAM,YAAY,CAAC;AAGhF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,KAAK,CAAqB;;IAYlC,iCAAiC;IACjC,EAAE,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIlC,+BAA+B;IAC/B,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAInC;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE;QACjB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA4CvB,iEAAiE;IACjE,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAuBjD,gDAAgD;IAChD,WAAW,IAAI,IAAI;YAML,gBAAgB;YA6DhB,mBAAmB;YAiDnB,kBAAkB;IA+BhC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;CAKnB"}