@centerseedwu/naru-agent 0.2.0

package/dist/intent/llm-classifier.d.ts

@@ -0,0 +1,22 @@
+import { type LanguageModel } from "ai";
+import type { BaseIntentClassifier } from "./base.js";
+import type { IntentResult } from "../types.js";
+/**
+ * Fast LLM-based intent classifier using 2-char codes:
+ * YY = needs knowledge + needs tools
+ * YN = needs knowledge, no tools
+ * NY = no knowledge, needs tools
+ * NN = neither
+ */
+export declare class LLMIntentClassifier implements BaseIntentClassifier {
+    private model;
+    private examples;
+    private maxTokens;
+    constructor(config: {
+        model: LanguageModel;
+        examples?: Array<[string, string]>;
+        maxTokens?: number;
+    });
+    classify(message: string): Promise<IntentResult>;
+}
+//# sourceMappingURL=llm-classifier.d.ts.map

package/dist/intent/llm-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-classifier.d.ts","sourceRoot":"","sources":["../../src/intent/llm-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE;QAClB,KAAK,EAAE,aAAa,CAAC;QACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACnC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAMK,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAgCvD"}

package/dist/intent/llm-classifier.js

@@ -0,0 +1,49 @@
+import { generateText } from "ai";
+/**
+ * Fast LLM-based intent classifier using 2-char codes:
+ * YY = needs knowledge + needs tools
+ * YN = needs knowledge, no tools
+ * NY = no knowledge, needs tools
+ * NN = neither
+ */
+export class LLMIntentClassifier {
+    model;
+    examples;
+    maxTokens;
+    constructor(config) {
+        this.model = config.model;
+        this.examples = config.examples ?? [];
+        this.maxTokens = config.maxTokens ?? 30;
+    }
+    async classify(message) {
+        const examplesStr = this.examples
+            .map(([msg, code]) => `User: ${msg}\nCode: ${code}`)
+            .join("\n");
+        const system = [
+            "Classify user intent with a 2-character code.",
+            "First char: Y if the query needs knowledge/RAG retrieval, N if not.",
+            "Second char: Y if the query needs tool calls, N if not.",
+            "Reply ONLY with the 2-char code (YY, YN, NY, or NN).",
+            examplesStr ? `\nExamples:\n${examplesStr}` : "",
+        ].join("\n");
+        try {
+            const result = await generateText({
+                model: this.model,
+                system,
+                prompt: message,
+                maxOutputTokens: this.maxTokens,
+            });
+            const raw = result.text.trim().toUpperCase().slice(0, 2);
+            return {
+                needsKnowledge: raw[0] !== "N",
+                needsTools: raw[1] !== "N",
+                raw,
+            };
+        }
+        catch {
+            // Default: enable everything
+            return { needsKnowledge: true, needsTools: true, raw: "YY" };
+        }
+    }
+}
+//# sourceMappingURL=llm-classifier.js.map

package/dist/intent/llm-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-classifier.js","sourceRoot":"","sources":["../../src/intent/llm-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,MAAM,IAAI,CAAC;AAItD;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IACtB,KAAK,CAAgB;IACrB,QAAQ,CAA0B;IAClC,SAAS,CAAS;IAE1B,YAAY,MAIX;QACC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ;aAC9B,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,SAAS,GAAG,WAAW,IAAI,EAAE,CAAC;aACnD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,MAAM,GAAG;YACb,+CAA+C;YAC/C,qEAAqE;YACrE,yDAAyD;YACzD,sDAAsD;YACtD,WAAW,CAAC,CAAC,CAAC,gBAAgB,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;SACjD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;gBAChC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM;gBACN,MAAM,EAAE,OAAO;gBACf,eAAe,EAAE,IAAI,CAAC,SAAS;aAChC,CAAC,CAAC;YAEH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACzD,OAAO;gBACL,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG;gBAC9B,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG;gBAC1B,GAAG;aACJ,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;YAC7B,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QAC/D,CAAC;IACH,CAAC;CACF"}

package/dist/intent/tool-calling-classifier.d.ts

@@ -0,0 +1,16 @@
+import { type LanguageModel } from "ai";
+import type { BaseToolCallingClassifier, ToolCallingResult } from "./base.js";
+import type { BaseTool } from "../tools/base.js";
+/**
+ * Uses a lightweight LLM to decide which tools to call, then executes them.
+ */
+export declare class LLMToolCallingClassifier implements BaseToolCallingClassifier {
+    private model;
+    private systemPrompt;
+    constructor(config: {
+        model: LanguageModel;
+        systemPrompt?: string;
+    });
+    classify(message: string, tools: BaseTool[]): Promise<ToolCallingResult>;
+}
+//# sourceMappingURL=tool-calling-classifier.d.ts.map

package/dist/intent/tool-calling-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-calling-classifier.d.ts","sourceRoot":"","sources":["../../src/intent/tool-calling-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AACnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD;;GAEG;AACH,qBAAa,wBAAyB,YAAW,yBAAyB;IACxE,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE;QAClB,KAAK,EAAE,aAAa,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAOK,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EAAE,GAChB,OAAO,CAAC,iBAAiB,CAAC;CA4C9B"}

package/dist/intent/tool-calling-classifier.js

@@ -0,0 +1,56 @@
+import { generateText, stepCountIs } from "ai";
+import { toVercelTools } from "../tools/vercel-adapter.js";
+/**
+ * Uses a lightweight LLM to decide which tools to call, then executes them.
+ */
+export class LLMToolCallingClassifier {
+    model;
+    systemPrompt;
+    constructor(config) {
+        this.model = config.model;
+        this.systemPrompt =
+            config.systemPrompt ??
+                "You are a tool-calling assistant. Use the available tools to answer the user's question. Only call tools that are relevant.";
+    }
+    async classify(message, tools) {
+        if (tools.length === 0) {
+            return { toolResults: [], usage: {}, rawResponse: "" };
+        }
+        const vercelTools = toVercelTools(tools);
+        const result = await generateText({
+            model: this.model,
+            system: this.systemPrompt,
+            prompt: message,
+            tools: vercelTools,
+            stopWhen: stepCountIs(1),
+        });
+        const toolResults = [];
+        // Extract tool call results from steps
+        for (const step of result.steps ?? []) {
+            for (const tc of step.toolCalls ?? []) {
+                toolResults.push({
+                    tool: tc.toolName,
+                    args: tc.input ?? {},
+                    result: "",
+                });
+            }
+            // Match tool results by index
+            const stepToolResults = step.toolResults ?? [];
+            for (let i = 0; i < stepToolResults.length && i < toolResults.length; i++) {
+                toolResults[toolResults.length - (stepToolResults.length - i)] = {
+                    ...toolResults[toolResults.length - (stepToolResults.length - i)],
+                    result: String(stepToolResults[i].result),
+                };
+            }
+        }
+        return {
+            toolResults,
+            usage: {
+                promptTokens: result.usage?.inputTokens ?? 0,
+                completionTokens: result.usage?.outputTokens ?? 0,
+            },
+            rawResponse: result.text,
+        };
+    }
+}
+//# sourceMappingURL=tool-calling-classifier.js.map

package/dist/intent/tool-calling-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-calling-classifier.js","sourceRoot":"","sources":["../../src/intent/tool-calling-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAsB,MAAM,IAAI,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAC3B,KAAK,CAAgB;IACrB,YAAY,CAAS;IAE7B,YAAY,MAGX;QACC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,YAAY;YACf,MAAM,CAAC,YAAY;gBACnB,6HAA6H,CAAC;IAClI,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,OAAe,EACf,KAAiB;QAEjB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QACzD,CAAC;QAED,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;YAChC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,YAAY;YACzB,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,WAAW;YAClB,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;SACzB,CAAC,CAAC;QAEH,MAAM,WAAW,GAAqC,EAAE,CAAC;QACzD,uCAAuC;QACvC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YACtC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;gBACtC,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,EAAE,CAAC,QAAQ;oBACjB,IAAI,EAAG,EAAoD,CAAC,KAAK,IAAI,EAAE;oBACvE,MAAM,EAAE,EAAE;iBACX,CAAC,CAAC;YACL,CAAC;YACD,8BAA8B;YAC9B,MAAM,eAAe,GAAI,IAAgE,CAAC,WAAW,IAAI,EAAE,CAAC;YAC5G,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1E,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG;oBAC/D,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;oBACjE,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;iBAC1C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,WAAW;YACX,KAAK,EAAE;gBACL,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC;gBAC5C,gBAAgB,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;aAClD;YACD,WAAW,EAAE,MAAM,CAAC,IAAI;SACzB,CAAC;IACJ,CAAC;CACF"}

package/dist/knowledge/base.d.ts

@@ -0,0 +1,14 @@
+export interface KnowledgeResult {
+    text: string;
+    score: number;
+    metadata: Record<string, unknown>;
+}
+export interface BaseKnowledgeStore {
+    search(query: string, topK?: number): Promise<KnowledgeResult[]>;
+    formatContext(results: KnowledgeResult[], minScore?: number): string;
+}
+/**
+ * Default formatContext implementation.
+ */
+export declare function formatKnowledgeContext(results: KnowledgeResult[], minScore?: number): string;
+//# sourceMappingURL=base.d.ts.map

package/dist/knowledge/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/knowledge/base.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEjE,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EAAE,EAC1B,QAAQ,SAAM,GACb,MAAM,CAIR"}

package/dist/knowledge/base.js

@@ -0,0 +1,10 @@
+/**
+ * Default formatContext implementation.
+ */
+export function formatKnowledgeContext(results, minScore = 0.3) {
+    const filtered = results.filter((r) => r.score >= minScore);
+    if (filtered.length === 0)
+        return "";
+    return filtered.map((r) => r.text).join("\n\n---\n\n");
+}
+//# sourceMappingURL=base.js.map

package/dist/knowledge/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/knowledge/base.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAA0B,EAC1B,QAAQ,GAAG,GAAG;IAEd,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC;IAC5D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzD,CAAC"}

package/dist/knowledge/chroma-store.d.ts

@@ -0,0 +1,25 @@
+import type { BaseKnowledgeStore, KnowledgeResult } from "./base.js";
+export interface ChromaKnowledgeStoreConfig {
+    collectionName?: string;
+    chromaUrl?: string;
+    embeddingFunction?: any;
+}
+/**
+ * Knowledge store backed by ChromaDB.
+ * Requires `chromadb` as a peer dependency.
+ * Uses lazy initialization — the collection is created on first use.
+ */
+export declare class ChromaKnowledgeStore implements BaseKnowledgeStore {
+    private client;
+    private collectionPromise;
+    private collectionName;
+    private chromaUrl;
+    private embeddingFunction;
+    constructor(config?: ChromaKnowledgeStoreConfig);
+    private getCollection;
+    ingest(text: string, metadata?: Record<string, unknown>): Promise<void>;
+    batchIngest(texts: string[], metadataList?: Array<Record<string, unknown>>): Promise<void>;
+    search(query: string, topK?: number): Promise<KnowledgeResult[]>;
+    formatContext(results: KnowledgeResult[], minScore?: number): string;
+}
+//# sourceMappingURL=chroma-store.d.ts.map

package/dist/knowledge/chroma-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chroma-store.d.ts","sourceRoot":"","sources":["../../src/knowledge/chroma-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGrE,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iBAAiB,CAAC,EAAE,GAAG,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,kBAAkB;IAE7D,OAAO,CAAC,MAAM,CAAa;IAE3B,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,iBAAiB,CAAM;gBAEnB,MAAM,GAAE,0BAA+B;IAOnD,OAAO,CAAC,aAAa;IAgBf,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,WAAW,CACf,KAAK,EAAE,MAAM,EAAE,EACf,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC;IAWV,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAmBjE,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,SAAM,GAAG,MAAM;CAGlE"}

package/dist/knowledge/chroma-store.js

@@ -0,0 +1,70 @@
+import { formatKnowledgeContext } from "./base.js";
+/**
+ * Knowledge store backed by ChromaDB.
+ * Requires `chromadb` as a peer dependency.
+ * Uses lazy initialization — the collection is created on first use.
+ */
+export class ChromaKnowledgeStore {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    client = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    collectionPromise = null;
+    collectionName;
+    chromaUrl;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    embeddingFunction;
+    constructor(config = {}) {
+        this.chromaUrl = config.chromaUrl ?? "http://localhost:8000";
+        this.collectionName = config.collectionName ?? "knowledge";
+        this.embeddingFunction = config.embeddingFunction;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getCollection() {
+        if (!this.collectionPromise) {
+            this.collectionPromise = (async () => {
+                const { ChromaClient } = await import("chromadb");
+                this.client = new ChromaClient({ path: this.chromaUrl });
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const opts = { name: this.collectionName };
+                if (this.embeddingFunction) {
+                    opts.embeddingFunction = this.embeddingFunction;
+                }
+                return this.client.getOrCreateCollection(opts);
+            })();
+        }
+        return this.collectionPromise;
+    }
+    async ingest(text, metadata) {
+        await this.batchIngest([text], metadata ? [metadata] : undefined);
+    }
+    async batchIngest(texts, metadataList) {
+        const collection = await this.getCollection();
+        const ids = texts.map(() => crypto.randomUUID());
+        await collection.add({
+            ids,
+            documents: texts,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            metadatas: metadataList,
+        });
+    }
+    async search(query, topK = 3) {
+        const collection = await this.getCollection();
+        const results = await collection.query({
+            queryTexts: [query],
+            nResults: topK,
+        });
+        const documents = results.documents?.[0] ?? [];
+        const distances = results.distances?.[0] ?? [];
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const metadatas = results.metadatas?.[0] ?? [];
+        return documents.map((doc, i) => ({
+            text: doc ?? "",
+            score: 1 - (distances[i] ?? 1),
+            metadata: metadatas[i] ?? {},
+        }));
+    }
+    formatContext(results, minScore = 0.3) {
+        return formatKnowledgeContext(results, minScore);
+    }
+}
+//# sourceMappingURL=chroma-store.js.map

package/dist/knowledge/chroma-store.js.map

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

package/dist/knowledge/contextualizer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Contextual Retrieval: enrich chunks with situational context at ingest time.
+ *
+ * Anthropic research shows this reduces retrieval failure by 49-67%.
+ * Cost: runs once at ingestion; zero overhead at query time.
+ */
+import { type LanguageModel } from "ai";
+export interface ChunkContextualizerConfig {
+    model: LanguageModel;
+}
+export declare class ChunkContextualizer {
+    private readonly model;
+    constructor(config: ChunkContextualizerConfig);
+    contextualize(chunk: string, fullDocument: string): Promise<string>;
+    contextualizeMany(chunks: string[], fullDocument: string, concurrency?: number): Promise<string[]>;
+}
+//# sourceMappingURL=contextualizer.d.ts.map

package/dist/knowledge/contextualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextualizer.d.ts","sourceRoot":"","sources":["../../src/knowledge/contextualizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAEtD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,aAAa,CAAC;CACtB;AAcD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBAE1B,MAAM,EAAE,yBAAyB;IAIvC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAanE,iBAAiB,CACrB,MAAM,EAAE,MAAM,EAAE,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,SAAI,GACd,OAAO,CAAC,MAAM,EAAE,CAAC;CAmBrB"}

package/dist/knowledge/contextualizer.js

@@ -0,0 +1,47 @@
+/**
+ * Contextual Retrieval: enrich chunks with situational context at ingest time.
+ *
+ * Anthropic research shows this reduces retrieval failure by 49-67%.
+ * Cost: runs once at ingestion; zero overhead at query time.
+ */
+import { generateText } from "ai";
+const PROMPT_TEMPLATE = `<document>
+{document}
+</document>
+
+以下是要定位的 chunk：
+<chunk>
+{chunk}
+</chunk>
+
+請用一到三句話說明這個 chunk 在整份文件中的位置和背景脈絡，\
+目的是改善向量搜索的準確度。只輸出這段說明，不要其他內容。`;
+export class ChunkContextualizer {
+    model;
+    constructor(config) {
+        this.model = config.model;
+    }
+    async contextualize(chunk, fullDocument) {
+        const prompt = PROMPT_TEMPLATE
+            .replace("{document}", fullDocument.replaceAll("{chunk}", "\\{chunk\\}"))
+            .replace("{chunk}", chunk);
+        const { text } = await generateText({
+            model: this.model,
+            messages: [{ role: "user", content: prompt }],
+        });
+        return `${text.trim()}\n${chunk}`;
+    }
+    async contextualizeMany(chunks, fullDocument, concurrency = 5) {
+        const results = new Array(chunks.length);
+        let nextIndex = 0;
+        const worker = async () => {
+            while (nextIndex < chunks.length) {
+                const i = nextIndex++;
+                results[i] = await this.contextualize(chunks[i], fullDocument);
+            }
+        };
+        await Promise.all(Array.from({ length: Math.min(concurrency, chunks.length) }, () => worker()));
+        return results;
+    }
+}
+//# sourceMappingURL=contextualizer.js.map

package/dist/knowledge/contextualizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextualizer.js","sourceRoot":"","sources":["../../src/knowledge/contextualizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAsB,MAAM,IAAI,CAAC;AAMtD,MAAM,eAAe,GAAG;;;;;;;;;;8BAUM,CAAC;AAE/B,MAAM,OAAO,mBAAmB;IACb,KAAK,CAAgB;IAEtC,YAAY,MAAiC;QAC3C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAa,EAAE,YAAoB;QACrD,MAAM,MAAM,GAAG,eAAe;aAC3B,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,UAAU,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;aACxE,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAE7B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,YAAY,CAAC;YAClC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC9C,CAAC,CAAC;QAEH,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,MAAgB,EAChB,YAAoB,EACpB,WAAW,GAAG,CAAC;QAEf,MAAM,OAAO,GAAa,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;YACxB,OAAO,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBACjC,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;gBACtB,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YACjE,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CACR,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAChD,GAAG,EAAE,CAAC,MAAM,EAAE,CACf,CACF,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/knowledge/graph-store.d.ts

@@ -0,0 +1,22 @@
+import type { BaseKnowledgeStore, KnowledgeResult } from "./base.js";
+import { type LanguageModel } from "ai";
+/**
+ * Knowledge graph store using graphology. Requires `graphology` as optional dependency.
+ */
+export declare class GraphKnowledgeStore implements BaseKnowledgeStore {
+    private graph;
+    private model;
+    private graphLib;
+    constructor(config: {
+        model: LanguageModel;
+    });
+    private ensureGraph;
+    ingestText(text: string): Promise<{
+        entities: number;
+        relations: number;
+    }>;
+    search(query: string, topK?: number): Promise<KnowledgeResult[]>;
+    formatContext(results: KnowledgeResult[], minScore?: number): string;
+    getGraph(): unknown;
+}
+//# sourceMappingURL=graph-store.d.ts.map

package/dist/knowledge/graph-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-store.d.ts","sourceRoot":"","sources":["../../src/knowledge/graph-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAsBxD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,kBAAkB;IAE5D,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAyB;gBAE7B,MAAM,EAAE;QAAE,KAAK,EAAE,aAAa,CAAA;KAAE;YAK9B,WAAW;IAQnB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAmC1E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA2DjE,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,SAAM,GAAG,MAAM;IAIjE,QAAQ,IAAI,OAAO;CAGpB"}

package/dist/knowledge/graph-store.js

@@ -0,0 +1,116 @@
+import { formatKnowledgeContext } from "./base.js";
+import { generateObject } from "ai";
+import { z } from "zod";
+const EntityRelationSchema = z.object({
+    entities: z.array(z.object({
+        name: z.string(),
+        type: z.string(),
+        description: z.string().optional(),
+    })),
+    relations: z.array(z.object({
+        source: z.string(),
+        target: z.string(),
+        relation: z.string(),
+    })),
+});
+/**
+ * Knowledge graph store using graphology. Requires `graphology` as optional dependency.
+ */
+export class GraphKnowledgeStore {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    graph = null;
+    model;
+    graphLib = null;
+    constructor(config) {
+        this.model = config.model;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async ensureGraph() {
+        if (this.graph)
+            return this.graph;
+        const graphology = await import("graphology");
+        this.graphLib = graphology;
+        this.graph = new graphology.default();
+        return this.graph;
+    }
+    async ingestText(text) {
+        const graph = await this.ensureGraph();
+        const { object } = await generateObject({
+            model: this.model,
+            schema: EntityRelationSchema,
+            prompt: `Extract entities and relationships from this text. Focus on key concepts, people, organizations, and their relationships.\n\n${text}`,
+        });
+        for (const entity of object.entities) {
+            const key = entity.name.toLowerCase();
+            if (!graph.hasNode(key)) {
+                graph.addNode(key, {
+                    label: entity.name,
+                    type: entity.type,
+                    description: entity.description ?? "",
+                });
+            }
+        }
+        for (const rel of object.relations) {
+            const src = rel.source.toLowerCase();
+            const tgt = rel.target.toLowerCase();
+            if (graph.hasNode(src) && graph.hasNode(tgt)) {
+                try {
+                    graph.addEdge(src, tgt, { relation: rel.relation });
+                }
+                catch {
+                    // edge may already exist
+                }
+            }
+        }
+        return { entities: object.entities.length, relations: object.relations.length };
+    }
+    async search(query, topK = 3) {
+        const graph = await this.ensureGraph();
+        const queryLower = query.toLowerCase();
+        const results = [];
+        // Find matching nodes
+        const matchedNodes = [];
+        graph.forEachNode((node, attrs) => {
+            const label = attrs.label ?? node;
+            if (queryLower.includes(node) ||
+                queryLower.includes(label.toLowerCase())) {
+                matchedNodes.push(node);
+            }
+        });
+        // Expand neighbors for matched nodes
+        for (const node of matchedNodes.slice(0, topK)) {
+            const attrs = graph.getNodeAttributes(node);
+            const neighbors = [];
+            graph.forEachNeighbor(node, (neighbor) => {
+                const nAttrs = graph.getNodeAttributes(neighbor);
+                neighbors.push(nAttrs.label ?? neighbor);
+            });
+            const edges = [];
+            graph.forEachEdge(node, (_edge, edgeAttrs, src, tgt) => {
+                const srcLabel = graph.getNodeAttributes(src).label ?? src;
+                const tgtLabel = graph.getNodeAttributes(tgt).label ?? tgt;
+                edges.push(`${srcLabel} -[${edgeAttrs.relation}]-> ${tgtLabel}`);
+            });
+            const text = [
+                `Entity: ${attrs.label} (${attrs.type})`,
+                attrs.description ? `Description: ${attrs.description}` : "",
+                edges.length > 0 ? `Relations:\n${edges.join("\n")}` : "",
+            ]
+                .filter(Boolean)
+                .join("\n");
+            results.push({
+                text,
+                score: 1.0,
+                metadata: { nodeId: node, type: attrs.type },
+            });
+        }
+        return results.slice(0, topK);
+    }
+    formatContext(results, minScore = 0.3) {
+        return formatKnowledgeContext(results, minScore);
+    }
+    getGraph() {
+        return this.graph;
+    }
+}
+//# sourceMappingURL=graph-store.js.map

package/dist/knowledge/graph-store.js.map

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

package/dist/knowledge/hybrid-store.d.ts

@@ -0,0 +1,16 @@
+import type { BaseKnowledgeStore, KnowledgeResult } from "./base.js";
+/**
+ * Multi-source knowledge store that merges results from multiple stores
+ * with weighted scoring.
+ */
+export declare class HybridKnowledgeStore implements BaseKnowledgeStore {
+    private stores;
+    private weights;
+    constructor(config: {
+        stores: BaseKnowledgeStore[];
+        weights?: number[];
+    });
+    search(query: string, topK?: number): Promise<KnowledgeResult[]>;
+    formatContext(results: KnowledgeResult[], minScore?: number): string;
+}
+//# sourceMappingURL=hybrid-store.d.ts.map

package/dist/knowledge/hybrid-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-store.d.ts","sourceRoot":"","sources":["../../src/knowledge/hybrid-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGrE;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAW;gBAEd,MAAM,EAAE;QAClB,MAAM,EAAE,kBAAkB,EAAE,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB;IAMK,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+BjE,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,SAAM,GAAG,MAAM;CAGlE"}

package/dist/knowledge/hybrid-store.js

@@ -0,0 +1,39 @@
+import { formatKnowledgeContext } from "./base.js";
+/**
+ * Multi-source knowledge store that merges results from multiple stores
+ * with weighted scoring.
+ */
+export class HybridKnowledgeStore {
+    stores;
+    weights;
+    constructor(config) {
+        this.stores = config.stores;
+        this.weights =
+            config.weights ?? config.stores.map(() => 1 / config.stores.length);
+    }
+    async search(query, topK = 3) {
+        const allResults = await Promise.allSettled(this.stores.map((store, i) => store.search(query, topK).then((results) => results.map((r) => ({
+            ...r,
+            score: r.score * this.weights[i],
+        })))));
+        const merged = [];
+        const seen = new Set();
+        for (const result of allResults) {
+            if (result.status === "fulfilled") {
+                for (const r of result.value) {
+                    // Deduplicate by text content
+                    const key = r.text.slice(0, 100);
+                    if (!seen.has(key)) {
+                        seen.add(key);
+                        merged.push(r);
+                    }
+                }
+            }
+        }
+        return merged.sort((a, b) => b.score - a.score).slice(0, topK);
+    }
+    formatContext(results, minScore = 0.3) {
+        return formatKnowledgeContext(results, minScore);
+    }
+}
+//# sourceMappingURL=hybrid-store.js.map

package/dist/knowledge/hybrid-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-store.js","sourceRoot":"","sources":["../../src/knowledge/hybrid-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACvB,MAAM,CAAuB;IAC7B,OAAO,CAAW;IAE1B,YAAY,MAGX;QACC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,OAAO;YACV,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,IAAI,GAAG,CAAC;QAClC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,UAAU,CACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAC3B,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CACzC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClB,GAAG,CAAC;YACJ,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;SACjC,CAAC,CAAC,CACJ,CACF,CACF,CAAC;QAEF,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YAChC,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAC7B,8BAA8B;oBAC9B,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;oBACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;wBACd,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBACjB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC;IAED,aAAa,CAAC,OAA0B,EAAE,QAAQ,GAAG,GAAG;QACtD,OAAO,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/knowledge/in-memory-store.d.ts

@@ -0,0 +1,27 @@
+import type { BaseKnowledgeStore, KnowledgeResult } from "./base.js";
+import type { EmbedFn } from "../types.js";
+/**
+ * In-memory vector knowledge store for development and testing.
+ * Uses cosine similarity for search — no external dependencies.
+ *
+ * @deprecated Use {@link ChromaKnowledgeStore} for production workloads.
+ */
+export declare class InMemoryKnowledgeStore implements BaseKnowledgeStore {
+    private docs;
+    private embedFn;
+    constructor(config: {
+        embedFn: EmbedFn;
+    });
+    /**
+     * Ingest a list of text documents. Computes embeddings in batch.
+     */
+    batchIngest(texts: string[], metadataList?: Array<Record<string, unknown>>): Promise<void>;
+    /**
+     * Ingest a single document.
+     */
+    ingest(text: string, metadata?: Record<string, unknown>): Promise<void>;
+    search(query: string, topK?: number): Promise<KnowledgeResult[]>;
+    formatContext(results: KnowledgeResult[], minScore?: number): string;
+    get size(): number;
+}
+//# sourceMappingURL=in-memory-store.d.ts.map

package/dist/knowledge/in-memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../../src/knowledge/in-memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAQ3C;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE;IAIxC;;OAEG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EAAE,EACf,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAejE,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,SAAM,GAAG,MAAM;IAIjE,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}