keyring-agent-core 0.2.0 → 0.2.2

package/dist/memory/KnowledgeBase.js

@@ -1,139 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.KnowledgeBase = void 0;
-const KB_MATCH_PROMPT = `You are a strict FAQ matcher. Given a user query and a list of FAQ entries, determine which FAQ entries the user is SPECIFICALLY asking about.
-
-RULES:
-- Only match when the user's question is CLEARLY about the same topic as the FAQ entry.
-- Do NOT match loosely related topics. For example, if the user asks about "ETH price" and a FAQ is about "What is staking?", that is NOT a match — they are different topics.
-- Match by MEANING, not exact words. The user may ask in any language or use synonyms.
-- Return a JSON array of objects: [{"index": <0-based index>, "score": <0.0 to 1.0>}]
-- score >= 0.8 = the user is asking essentially the same question as the FAQ
-- score 0.6-0.8 = the FAQ directly addresses the user's question
-- score < 0.6 = NOT a match, do NOT include
-- If no entries match, return an empty array: []
-- When in doubt, do NOT match. Precision is more important than recall.
-- Return ONLY the JSON array, no other text.
-
-FAQ ENTRIES:
-`;
-/**
- * Knowledge base with LLM-powered semantic matching.
- * Supports cross-language queries and synonym understanding.
- *
- * Suitable for small KBs (≲ 50 entries) — every search sends the full FAQ
- * list to the LLM. For larger KBs use `UpstashKnowledgeBase` (vector search).
- */
-class KnowledgeBase {
-    entries = [];
-    llm = null;
-    constructor(entries) {
-        if (entries)
-            this.entries = entries;
-    }
-    /** Attach an LLM provider for semantic matching. */
-    setLLM(llm) {
-        this.llm = llm;
-    }
-    /** Replace all entries. */
-    setEntries(entries) {
-        this.entries = entries;
-    }
-    /** Add entries without replacing existing ones. */
-    addEntries(entries) {
-        this.entries.push(...entries);
-    }
-    /** Snapshot of current entries (defensive copy). */
-    getEntries() {
-        return this.entries.slice();
-    }
-    /** Get total entry count. */
-    get size() {
-        return this.entries.length;
-    }
-    /**
-     * Search for entries relevant to the user query using LLM semantic matching.
-     * Falls back to basic token matching if LLM is not available.
-     */
-    async search(query, maxResults = 3) {
-        if (this.entries.length === 0)
-            return [];
-        if (this.llm) {
-            return this.llmSearch(query, maxResults);
-        }
-        // Fallback: basic token matching (same language only)
-        return this.tokenSearch(query, maxResults, 0.25);
-    }
-    /** LLM-based semantic search — handles any language + synonyms. */
-    async llmSearch(query, maxResults) {
-        // Build FAQ list for the prompt (only questions, to keep it short)
-        const faqList = this.entries.map((e, i) => `[${i}] ${e.question}`).join('\n');
-        const messages = [
-            {
-                role: 'user',
-                content: KB_MATCH_PROMPT + faqList + `\n\nUSER QUERY: ${query}`,
-                timestamp: 0,
-            },
-        ];
-        try {
-            const response = await this.llm.chat(messages);
-            const text = response.text.trim();
-            // Extract JSON array from response
-            const jsonMatch = text.match(/\[[\s\S]*\]/);
-            if (!jsonMatch)
-                return [];
-            const matches = JSON.parse(jsonMatch[0]);
-            const results = [];
-            for (const m of matches) {
-                if (m.index >= 0 && m.index < this.entries.length && m.score >= 0.6) {
-                    results.push({ entry: this.entries[m.index], score: m.score });
-                }
-            }
-            results.sort((a, b) => b.score - a.score);
-            return results.slice(0, maxResults);
-        }
-        catch {
-            // If LLM fails, fall back to token search
-            return this.tokenSearch(query, maxResults, 0.25);
-        }
-    }
-    /** Basic token-overlap search (fallback). */
-    tokenSearch(query, maxResults, threshold) {
-        const queryTokens = this.tokenize(query);
-        if (queryTokens.size === 0)
-            return [];
-        const scored = [];
-        for (const entry of this.entries) {
-            const entryTokens = this.tokenize(entry.question);
-            const score = this.jaccardSimilarity(queryTokens, entryTokens);
-            if (score >= threshold) {
-                scored.push({ entry, score });
-            }
-        }
-        scored.sort((a, b) => b.score - a.score);
-        return scored.slice(0, maxResults);
-    }
-    /** Tokenize text into a set of normalized words. */
-    tokenize(text) {
-        const words = text
-            .toLowerCase()
-            .replace(/[^\p{L}\p{N}\s]/gu, ' ')
-            .split(/\s+/)
-            .filter((w) => w.length > 1);
-        return new Set(words);
-    }
-    /** Jaccard similarity: |A ∩ B| / |A ∪ B| */
-    jaccardSimilarity(a, b) {
-        if (a.size === 0 || b.size === 0)
-            return 0;
-        let intersection = 0;
-        for (const token of a) {
-            if (b.has(token))
-                intersection++;
-        }
-        const union = a.size + b.size - intersection;
-        return union === 0 ? 0 : intersection / union;
-    }
-}
-exports.KnowledgeBase = KnowledgeBase;
-//# sourceMappingURL=KnowledgeBase.js.map

package/dist/memory/KnowledgeBase.js.map

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

package/dist/memory/Summarizer.d.ts

@@ -1,12 +0,0 @@
-import type { LLMProvider, ChatMessage } from '../types';
-/**
- * Uses the LLM to produce a compact summary of a conversation,
- * so old messages can be replaced with the summary to save tokens.
- */
-export declare class Summarizer {
-    private llm;
-    constructor(llm: LLMProvider);
-    /** Summarise an array of messages into a short paragraph. */
-    summarize(messages: ChatMessage[]): Promise<string>;
-}
-//# sourceMappingURL=Summarizer.d.ts.map

package/dist/memory/Summarizer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Summarizer.d.ts","sourceRoot":"","sources":["../../src/memory/Summarizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAc;gBAEb,GAAG,EAAE,WAAW;IAI5B,6DAA6D;IACvD,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA0B1D"}

package/dist/memory/Summarizer.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Summarizer = void 0;
-/**
- * Uses the LLM to produce a compact summary of a conversation,
- * so old messages can be replaced with the summary to save tokens.
- */
-class Summarizer {
-    llm;
-    constructor(llm) {
-        this.llm = llm;
-    }
-    /** Summarise an array of messages into a short paragraph. */
-    async summarize(messages) {
-        // Only summarize user/assistant turns — skip system and tool messages
-        const turns = messages.filter((m) => m.role === 'user' || m.role === 'assistant');
-        if (turns.length === 0)
-            return '';
-        const formatted = turns.map((m) => `${m.role === 'user' ? 'User' : 'Assistant'}: ${m.content}`).join('\n');
-        const prompt = [
-            {
-                role: 'system',
-                content: 'You are a conversation summarizer. Produce a concise summary of the conversation below. ' +
-                    'Keep key facts, decisions, and context that would be needed to continue the conversation. ' +
-                    'Reply with only the summary, no extra commentary. Respond in the same language as the conversation.',
-                timestamp: 0,
-            },
-            {
-                role: 'user',
-                content: `Summarise this conversation:\n\n${formatted}`,
-                timestamp: Date.now(),
-            },
-        ];
-        const response = await this.llm.chat(prompt);
-        return response.text;
-    }
-}
-exports.Summarizer = Summarizer;
-//# sourceMappingURL=Summarizer.js.map

package/dist/memory/Summarizer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Summarizer.js","sourceRoot":"","sources":["../../src/memory/Summarizer.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,UAAU;IACb,GAAG,CAAc;IAEzB,YAAY,GAAgB;QAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,SAAS,CAAC,QAAuB;QACrC,sEAAsE;QACtE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QAClF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAElC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3G,MAAM,MAAM,GAAkB;YAC5B;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EACL,0FAA0F;oBAC1F,4FAA4F;oBAC5F,qGAAqG;gBACvG,SAAS,EAAE,CAAC;aACb;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,mCAAmC,SAAS,EAAE;gBACvD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AAlCD,gCAkCC"}

package/dist/memory/UpstashKnowledgeBase.d.ts

@@ -1,124 +0,0 @@
-import type { KBSearchResult, KnowledgeBaseEntry, KnowledgeBaseProvider } from '../types';
-/**
- * What gets sent to the embedding model on upsert.
- *
- * - `'question'` (default, recommended for FAQ): only the `question` is
- *   embedded. User queries look like questions, so question↔question
- *   similarity gives the highest, most reliable scores.
- * - `'question-and-answer'`: embed `question + "\n\n" + answer`. Useful when
- *   answers contain dense keyword material a user might literally search
- *   for (error codes, product names, transaction hashes). Trade-off: long
- *   answers dilute the embedding and lower scores for genuine matches.
- */
-export type UpstashEmbedStrategy = 'question' | 'question-and-answer';
-/**
- * Score fusion algorithm for hybrid (dense + sparse) indexes.
- *
- * - `'DBSF'` (default here): Distribution-Based Score Fusion. Each component
- *   score is z-score-normalized against the batch's own mean ± 3σ and then
- *   summed across components. The final score is NOT clamped to [0, 1]:
- *   strong outliers can produce ≈ 1.2–1.6, "near-mean" hits sit close to 0,
- *   and weak hits can go negative. Practical reading on a 2-component hybrid
- *   index: ≳ 1.0 = strong match, ~0.6–1.0 = decent, ~0 = noise.
- * - `'RRF'`: Reciprocal Rank Fusion (Upstash's default). Score is
- *   `Σ 1/(k+rank)` with k=60, so on a 2-component hybrid index the BEST
- *   possible match scores ≈ 0.033. Set this only if you intentionally want
- *   rank-based fusion — and remember to drop `minScore` to ≈ 0.015–0.02.
- *
- * Ignored on dense-only / sparse-only indexes (the underlying score is then
- * a plain cosine similarity in [0, 1]).
- */
-export type UpstashFusionAlgorithm = 'DBSF' | 'RRF';
-export interface UpstashKnowledgeBaseConfig {
-    /**
-     * Upstash Vector REST URL. If omitted, falls back to
-     * `process.env.UPSTASH_VECTOR_REST_URL`.
-     */
-    url?: string;
-    /**
-     * Upstash Vector REST token. If omitted, falls back to
-     * `process.env.UPSTASH_VECTOR_REST_TOKEN`.
-     */
-    token?: string;
-    /**
-     * Optional namespace for multi-tenant isolation. Use one namespace per
-     * tenant / language / domain so a query never crosses boundaries.
-     */
-    namespace?: string;
-    /**
-     * Minimum score for a match to be returned. Below this threshold the result
-     * is dropped. Defaults to 1.3 — kept low so router/synthesiser still gets
-     * context-quality hits; the stricter "answer-from-KB" cut is a separate
-     * threshold on the AgentCore side.
-     *
-     * Score range depends on `fusionAlgorithm`:
-     *   - DBSF (default): unbounded; ≳ 1.3 = strong, 0.6–1.0 = decent, ~0 = noise.
-     *   - RRF: ≤ ~0.033 on a 2-component hybrid index.
-     *   - Dense-only index: cosine in [0, 1].
-     */
-    minScore?: number;
-    /** Default top-K when caller doesn't specify. Defaults to 3. */
-    defaultTopK?: number;
-    /** What to embed at upsert time. Default `'question'`. */
-    embedStrategy?: UpstashEmbedStrategy;
-    /**
-     * Fusion algorithm for hybrid indexes. Default `'DBSF'` so scores look
-     * like cosine similarity (0..1). Use `'RRF'` if you specifically need
-     * Upstash's default rank-based fusion (and lower `minScore` accordingly).
-     */
-    fusionAlgorithm?: UpstashFusionAlgorithm;
-    /** Enable debug logging. */
-    debug?: boolean;
-}
-/** Optional fields a caller can attach when ingesting. */
-export interface UpstashKBUpsertEntry extends KnowledgeBaseEntry {
-    /** Stable identifier. If omitted, derived from a sha256 hash of the question. */
-    id?: string;
-    /** Extra metadata to store alongside the entry (tags, source, lang…). */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Knowledge base backed by Upstash Vector.
- *
- * The Upstash index must be created with a built-in embedding model
- * (e.g. `BAAI/bge-m3`) so that uploading raw `data` strings — instead of
- * pre-computed vectors — embeds them server-side. This class assumes that
- * setup; callers who need client-side embeddings should subclass and
- * override the upsert/query payloads.
- *
- * @see https://upstash.com/docs/vector/features/embeddingmodels
- */
-export declare class UpstashKnowledgeBase implements KnowledgeBaseProvider {
-    private readonly index;
-    private readonly namespace?;
-    private readonly minScore;
-    private readonly defaultTopK;
-    private readonly embedStrategy;
-    private readonly fusionAlgorithm;
-    private readonly debug;
-    constructor(config?: UpstashKnowledgeBaseConfig);
-    search(query: string, maxResults?: number): Promise<KBSearchResult[]>;
-    /**
-     * Upsert one or more entries. Idempotent — same `id` overwrites the
-     * existing record. When `id` is omitted, a stable hash of the question
-     * is used so re-running ingestion does not duplicate entries.
-     *
-     * The text sent to the embedding model is determined by `embedStrategy`
-     * (default `'question'` — recommended for FAQ where user queries match
-     * questions, not full Q+A documents).
-     */
-    upsert(entries: UpstashKBUpsertEntry[]): Promise<{
-        count: number;
-    }>;
-    private buildEmbedText;
-    /** Delete entries by id. */
-    delete(ids: string[]): Promise<{
-        deleted: number;
-    }>;
-    /** Wipe the namespace (or whole index if no namespace). Destructive. */
-    reset(): Promise<void>;
-    /** Total vectors in the namespace (best-effort — Upstash returns index-wide totals). */
-    size(): Promise<number>;
-    private deriveId;
-}
-//# sourceMappingURL=UpstashKnowledgeBase.d.ts.map

package/dist/memory/UpstashKnowledgeBase.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"UpstashKnowledgeBase.d.ts","sourceRoot":"","sources":["../../src/memory/UpstashKnowledgeBase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAM1F;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,qBAAqB,CAAC;AAEtE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,KAAK,CAAC;AAEpD,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC;;;;OAIG;IACH,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AASD,0DAA0D;AAC1D,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,iFAAiF;IACjF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,MAAM,GAAE,0BAA+B;IAqB7C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAiD3E;;;;;;;;OAQG;IACG,MAAM,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA4BzE,OAAO,CAAC,cAAc;IAOtB,4BAA4B;IACtB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAOzD,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,wFAAwF;IAClF,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;YAWf,QAAQ;CAQvB"}

package/dist/memory/UpstashKnowledgeBase.js

@@ -1,152 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UpstashKnowledgeBase = void 0;
-const vector_1 = require("@upstash/vector");
-const DEFAULT_UPSTASH_URL = 'https://perfect-octopus-59684-us1-vector.upstash.io';
-const DEFAULT_UPSTASH_TOKEN = 'ABkFMHBlcmZlY3Qtb2N0b3B1cy01OTY4NC11czFhZG1pbk56WXdOV0k0T0RndFpUaGtOeTAwWWpjMkxXRmtNRFV0WW1WaU9UaGtOMlV5T0ROaQ==';
-/**
- * Knowledge base backed by Upstash Vector.
- *
- * The Upstash index must be created with a built-in embedding model
- * (e.g. `BAAI/bge-m3`) so that uploading raw `data` strings — instead of
- * pre-computed vectors — embeds them server-side. This class assumes that
- * setup; callers who need client-side embeddings should subclass and
- * override the upsert/query payloads.
- *
- * @see https://upstash.com/docs/vector/features/embeddingmodels
- */
-class UpstashKnowledgeBase {
-    index;
-    namespace;
-    minScore;
-    defaultTopK;
-    embedStrategy;
-    fusionAlgorithm;
-    debug;
-    constructor(config = {}) {
-        const url = config.url ??
-            (typeof process !== 'undefined' ? process.env.UPSTASH_VECTOR_REST_URL : undefined) ??
-            DEFAULT_UPSTASH_URL;
-        const token = config.token ??
-            (typeof process !== 'undefined' ? process.env.UPSTASH_VECTOR_REST_TOKEN : undefined) ??
-            DEFAULT_UPSTASH_TOKEN;
-        this.index = new vector_1.Index({ url, token });
-        this.namespace = config.namespace;
-        this.minScore = config.minScore ?? 1.3;
-        this.defaultTopK = config.defaultTopK ?? 3;
-        this.embedStrategy = config.embedStrategy ?? 'question';
-        this.fusionAlgorithm = config.fusionAlgorithm === 'RRF' ? vector_1.FusionAlgorithm.RRF : vector_1.FusionAlgorithm.DBSF;
-        this.debug = config.debug ?? false;
-    }
-    // ---- Search (KnowledgeBaseProvider) ----
-    async search(query, maxResults) {
-        const topK = maxResults ?? this.defaultTopK;
-        if (!query.trim())
-            return [];
-        const target = this.namespace ? this.index.namespace(this.namespace) : this.index;
-        let raw;
-        try {
-            raw = await target.query({
-                data: query,
-                topK,
-                includeMetadata: true,
-                fusionAlgorithm: this.fusionAlgorithm,
-            });
-        }
-        catch (err) {
-            if (this.debug) {
-                console.warn('[UpstashKnowledgeBase] query failed:', err);
-            }
-            return [];
-        }
-        const results = [];
-        for (const hit of raw) {
-            if (hit.score < this.minScore)
-                continue;
-            const meta = hit.metadata;
-            if (!meta?.question || !meta?.answer)
-                continue;
-            results.push({
-                entry: { question: meta.question, answer: meta.answer },
-                score: hit.score,
-            });
-        }
-        if (this.debug) {
-            console.log(`[UpstashKnowledgeBase] query="${query}" → ${results.length}/${raw.length} hit(s) above ${this.minScore}` +
-                (results[0] ? ` (top: ${results[0].score.toFixed(3)})` : ''));
-        }
-        return results;
-    }
-    // ---- Ingestion ----
-    /**
-     * Upsert one or more entries. Idempotent — same `id` overwrites the
-     * existing record. When `id` is omitted, a stable hash of the question
-     * is used so re-running ingestion does not duplicate entries.
-     *
-     * The text sent to the embedding model is determined by `embedStrategy`
-     * (default `'question'` — recommended for FAQ where user queries match
-     * questions, not full Q+A documents).
-     */
-    async upsert(entries) {
-        if (entries.length === 0)
-            return { count: 0 };
-        const target = this.namespace ? this.index.namespace(this.namespace) : this.index;
-        const payload = await Promise.all(entries.map(async (e) => ({
-            id: e.id ?? (await this.deriveId(e.question)),
-            data: this.buildEmbedText(e),
-            metadata: {
-                question: e.question,
-                answer: e.answer,
-                ...(e.metadata ?? {}),
-            },
-        })));
-        await target.upsert(payload);
-        if (this.debug) {
-            console.log(`[UpstashKnowledgeBase] upserted ${payload.length} entr${payload.length === 1 ? 'y' : 'ies'} (strategy=${this.embedStrategy})`);
-        }
-        return { count: payload.length };
-    }
-    buildEmbedText(entry) {
-        if (this.embedStrategy === 'question-and-answer') {
-            return `${entry.question}\n\n${entry.answer}`;
-        }
-        return entry.question;
-    }
-    /** Delete entries by id. */
-    async delete(ids) {
-        if (ids.length === 0)
-            return { deleted: 0 };
-        const target = this.namespace ? this.index.namespace(this.namespace) : this.index;
-        const res = await target.delete(ids);
-        return { deleted: res.deleted };
-    }
-    /** Wipe the namespace (or whole index if no namespace). Destructive. */
-    async reset() {
-        if (this.namespace) {
-            await this.index.reset({ namespace: this.namespace });
-        }
-        else {
-            await this.index.reset();
-        }
-    }
-    /** Total vectors in the namespace (best-effort — Upstash returns index-wide totals). */
-    async size() {
-        const info = await this.index.info();
-        if (this.namespace) {
-            const ns = info.namespaces?.[this.namespace];
-            return ns?.vectorCount ?? 0;
-        }
-        return info.vectorCount ?? 0;
-    }
-    // ---- Internals ----
-    async deriveId(question) {
-        const data = new TextEncoder().encode(question.trim().toLowerCase());
-        const buf = await globalThis.crypto.subtle.digest('SHA-256', data);
-        return Array.from(new Uint8Array(buf))
-            .map((b) => b.toString(16).padStart(2, '0'))
-            .join('')
-            .slice(0, 32);
-    }
-}
-exports.UpstashKnowledgeBase = UpstashKnowledgeBase;
-//# sourceMappingURL=UpstashKnowledgeBase.js.map

package/dist/memory/UpstashKnowledgeBase.js.map

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

package/dist/memory/historyUtils.d.ts

@@ -1,58 +0,0 @@
-import type { ChatMessage } from '../types';
-/**
- * Strip tool-related messages (assistant-with-toolCalls, role:'tool' results,
- * and internal bridge assistant messages) from a history slice. Use this when
- * feeding history to an LLM call that does NOT declare tool schemas — otherwise
- * Gemini sees `functionResponse` parts without matching `functionDeclarations`
- * and errors out.
- *
- * Also strips `_intermediate` assistant messages: these are the bridging turns
- * that `persistToolMessages` injects after each subagent tool exchange to
- * satisfy Gemini's turn-order rule. They must not appear in synthesiser or
- * direct-LLM history because the final synthesised answer is added separately
- * via `finaliseAnswer`, and having both would create duplicate model turns.
- */
-export declare function stripToolMessages(messages: ChatMessage[]): ChatMessage[];
-/**
- * Keep only tool messages whose tool name is owned by the current subagent.
- * Drops the paired assistant-with-toolCalls message as well, so the remaining
- * history stays internally consistent (no orphan functionResponse parts).
- *
- * Any dropped tool data is replaced with a short text observation so the
- * subagent still has a hint that prior data existed.
- */
-export declare function filterToolMessagesForSubagent(messages: ChatMessage[], ownedToolNames: Set<string>): ChatMessage[];
-/**
- * Return the last N messages from the slice, but never split a
- * [assistant-with-toolCalls, tool, tool, ...] group. If the slice would start
- * with an orphan `role:'tool'` message, walk back until we include its
- * parent assistant message (or drop the orphan entirely).
- */
-export declare function sliceRecentKeepingToolPairs(messages: ChatMessage[], n: number): ChatMessage[];
-/**
- * Trim a history array down to at most `keepLast` messages WITHOUT splitting
- * a tool-call group. Used by `compactHistory` so the working window never
- * ends up with an orphan `functionResponse`.
- */
-export declare function trimPreservingToolPairs(messages: ChatMessage[], keepLast: number): ChatMessage[];
-/**
- * Return the `subagents` tag from the most recent user-facing assistant
- * message (i.e. not the intermediate assistant-with-toolCalls messages).
- * Used by QueryRewriter + Router to resolve follow-ups like "more", "tiếp",
- * "yes" against the domain that handled the previous turn.
- */
-export declare function getLastAssistantSubagents(messages: ChatMessage[]): string[];
-/**
- * Extract a plain-text summary of key data from recent tool results so the
- * QueryRewriter can resolve follow-up references (e.g. "details of this tx",
- * "next page") WITHOUT receiving raw role:'tool' messages that would cause
- * Gemini functionResponse errors.
- *
- * Scans the last `maxToolMessages` tool messages and extracts:
- *  - Transaction hashes from wallet history / transfers
- *  - Pagination cursors
- * Returns a compact string to inject as a hint into the QueryRewriter prompt,
- * or an empty string if nothing relevant is found.
- */
-export declare function extractRecentToolDataHint(messages: ChatMessage[], maxToolMessages?: number): string;
-//# sourceMappingURL=historyUtils.d.ts.map

package/dist/memory/historyUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"historyUtils.d.ts","sourceRoot":"","sources":["../../src/memory/historyUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAIxE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,WAAW,EAAE,CA0CjH;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAwB7F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAEhG;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAS3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,eAAe,SAAI,GAAG,MAAM,CAgD9F"}