keyring-agent-core 0.1.0

package/dist/memory/historyUtils.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripToolMessages = stripToolMessages;
+exports.filterToolMessagesForSubagent = filterToolMessagesForSubagent;
+exports.sliceRecentKeepingToolPairs = sliceRecentKeepingToolPairs;
+exports.trimPreservingToolPairs = trimPreservingToolPairs;
+exports.getLastAssistantSubagents = getLastAssistantSubagents;
+exports.extractRecentToolDataHint = extractRecentToolDataHint;
+/**
+ * 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.
+ */
+function stripToolMessages(messages) {
+    return messages.filter((m) => m.role !== 'tool' && !(m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) && !m._intermediate);
+}
+/**
+ * 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.
+ */
+function filterToolMessagesForSubagent(messages, ownedToolNames) {
+    const out = [];
+    for (let i = 0; i < messages.length; i++) {
+        const m = messages[i];
+        if (m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) {
+            const allOwned = m.toolCalls.every((tc) => ownedToolNames.has(tc.toolName));
+            if (allOwned) {
+                out.push(m);
+                continue;
+            }
+            // Drop this assistant message and any immediately following tool results
+            // that belong to its call ids. Replace with a text breadcrumb.
+            const droppedNames = m.toolCalls.map((tc) => tc.toolName).join(', ');
+            out.push({
+                role: 'assistant',
+                content: `(Previously called external tools: ${droppedNames} — results not visible here.)`,
+                timestamp: m.timestamp,
+            });
+            const droppedIds = new Set(m.toolCalls.map((tc) => tc.callId));
+            while (i + 1 < messages.length) {
+                const next = messages[i + 1];
+                if (next.role === 'tool' && next.toolCallId && droppedIds.has(next.toolCallId)) {
+                    i++;
+                }
+                else {
+                    break;
+                }
+            }
+            continue;
+        }
+        if (m.role === 'tool') {
+            if (m.toolName && ownedToolNames.has(m.toolName)) {
+                out.push(m);
+            }
+            // Orphan tool messages (without owned parent) — skip silently
+            continue;
+        }
+        out.push(m);
+    }
+    return out;
+}
+/**
+ * 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).
+ */
+function sliceRecentKeepingToolPairs(messages, n) {
+    if (messages.length <= n)
+        return [...messages];
+    let start = messages.length - n;
+    // Walk back while the message at `start` is a tool result or an assistant
+    // message whose tool results extend forward — we want a clean boundary.
+    while (start > 0) {
+        const m = messages[start];
+        if (m.role === 'tool') {
+            start--;
+            continue;
+        }
+        // Found a clean boundary (user/assistant-without-toolCalls/system)
+        break;
+    }
+    // If we stopped on an assistant-with-toolCalls, that's fine — include it.
+    // If we stopped on a tool (start === 0 and still a tool), drop leading orphans.
+    const sliced = messages.slice(start);
+    let head = 0;
+    while (head < sliced.length && sliced[head].role === 'tool') {
+        head++;
+    }
+    return sliced.slice(head);
+}
+/**
+ * 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`.
+ */
+function trimPreservingToolPairs(messages, keepLast) {
+    return sliceRecentKeepingToolPairs(messages, keepLast);
+}
+/**
+ * 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.
+ */
+function getLastAssistantSubagents(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (m.role !== 'assistant')
+            continue;
+        if (m.toolCalls && m.toolCalls.length > 0)
+            continue; // intermediate, not user-facing
+        if (m.subagents && m.subagents.length > 0)
+            return [...m.subagents];
+        return []; // found a user-facing assistant turn but it wasn't tagged
+    }
+    return [];
+}
+/**
+ * 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.
+ */
+function extractRecentToolDataHint(messages, maxToolMessages = 5) {
+    const toolMsgs = messages.filter((m) => m.role === 'tool').slice(-maxToolMessages);
+    if (toolMsgs.length === 0)
+        return '';
+    const hashes = [];
+    const cursors = [];
+    for (const msg of toolMsgs) {
+        let data;
+        try {
+            data = JSON.parse(msg.content);
+        }
+        catch {
+            continue;
+        }
+        if (typeof data !== 'object' || data === null)
+            continue;
+        const obj = data;
+        // Extract pagination cursor
+        const pag = obj.pagination;
+        if (pag && typeof pag.cursor === 'string' && pag.cursor) {
+            cursors.push({ toolName: msg.toolName ?? 'tool', cursor: pag.cursor });
+        }
+        // Extract transaction hashes from wallet history or transfers
+        const txns = obj.transactions ?? obj.result ?? obj.transfers;
+        if (Array.isArray(txns)) {
+            for (const tx of txns) {
+                if (typeof tx.hash === 'string' && tx.hash.startsWith('0x')) {
+                    hashes.push(tx.hash);
+                }
+                else if (typeof tx.transaction_hash === 'string' && tx.transaction_hash.startsWith('0x')) {
+                    hashes.push(tx.transaction_hash);
+                }
+            }
+        }
+    }
+    if (hashes.length === 0 && cursors.length === 0)
+        return '';
+    const parts = ['[Tool data available from previous calls:]'];
+    if (hashes.length > 0) {
+        parts.push(`Transaction hashes (use EXACT values): ${hashes.slice(0, 10).join(', ')}`);
+    }
+    if (cursors.length > 0) {
+        const last = cursors[cursors.length - 1];
+        parts.push(`Pagination cursor from ${last.toolName}: ${last.cursor}`);
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=historyUtils.js.map

package/dist/memory/historyUtils.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,7 @@
+export { ChatHistory } from './ChatHistory';
+export { KnowledgeBase } from './KnowledgeBase';
+export type { KBSearchResult } from './KnowledgeBase';
+export { UpstashKnowledgeBase } from './UpstashKnowledgeBase';
+export type { UpstashKnowledgeBaseConfig, UpstashKBUpsertEntry, UpstashEmbedStrategy } from './UpstashKnowledgeBase';
+export { Summarizer } from './Summarizer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Summarizer = exports.UpstashKnowledgeBase = exports.KnowledgeBase = exports.ChatHistory = void 0;
+var ChatHistory_1 = require("./ChatHistory");
+Object.defineProperty(exports, "ChatHistory", { enumerable: true, get: function () { return ChatHistory_1.ChatHistory; } });
+var KnowledgeBase_1 = require("./KnowledgeBase");
+Object.defineProperty(exports, "KnowledgeBase", { enumerable: true, get: function () { return KnowledgeBase_1.KnowledgeBase; } });
+var UpstashKnowledgeBase_1 = require("./UpstashKnowledgeBase");
+Object.defineProperty(exports, "UpstashKnowledgeBase", { enumerable: true, get: function () { return UpstashKnowledgeBase_1.UpstashKnowledgeBase; } });
+var Summarizer_1 = require("./Summarizer");
+Object.defineProperty(exports, "Summarizer", { enumerable: true, get: function () { return Summarizer_1.Summarizer; } });
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,2CAA0C;AAAjC,wGAAA,UAAU,OAAA"}

package/dist/memory/ingestKnowledgeBase.d.ts

@@ -0,0 +1,17 @@
+import type { UpstashKnowledgeBaseConfig, UpstashKBUpsertEntry } from './UpstashKnowledgeBase';
+export interface IngestKnowledgeBaseInput {
+    entries?: UpstashKBUpsertEntry[];
+    json?: string;
+}
+export interface IngestKnowledgeBaseResult {
+    count: number;
+}
+/**
+ * One-shot helper: upsert KB entries to Upstash Vector.
+ *
+ * Pass either `entries` directly, or a raw `json` string (array or
+ * `{ entries: [...] }`). Credentials default to the standard
+ * `UPSTASH_VECTOR_REST_*` env vars when not provided in `config`.
+ */
+export declare function ingestKnowledgeBase(input: IngestKnowledgeBaseInput, config?: UpstashKnowledgeBaseConfig): Promise<IngestKnowledgeBaseResult>;
+//# sourceMappingURL=ingestKnowledgeBase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingestKnowledgeBase.d.ts","sourceRoot":"","sources":["../../src/memory/ingestKnowledgeBase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE/F,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAoBD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,EAC/B,MAAM,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAOpC"}

package/dist/memory/ingestKnowledgeBase.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ingestKnowledgeBase = ingestKnowledgeBase;
+const UpstashKnowledgeBase_1 = require("./UpstashKnowledgeBase");
+const parseJson = (raw) => {
+    const data = JSON.parse(raw);
+    const list = Array.isArray(data) ? data : data?.entries;
+    if (!Array.isArray(list)) {
+        throw new Error('JSON must be an array or { entries: [...] }');
+    }
+    return list.map((item, i) => {
+        if (!item ||
+            typeof item.question !== 'string' ||
+            typeof item.answer !== 'string') {
+            throw new Error(`Entry #${i} is missing "question" or "answer"`);
+        }
+        return item;
+    });
+};
+/**
+ * One-shot helper: upsert KB entries to Upstash Vector.
+ *
+ * Pass either `entries` directly, or a raw `json` string (array or
+ * `{ entries: [...] }`). Credentials default to the standard
+ * `UPSTASH_VECTOR_REST_*` env vars when not provided in `config`.
+ */
+async function ingestKnowledgeBase(input, config) {
+    const entries = input.entries ?? (input.json ? parseJson(input.json) : []);
+    if (entries.length === 0) {
+        return { count: 0 };
+    }
+    const kb = new UpstashKnowledgeBase_1.UpstashKnowledgeBase(config);
+    return kb.upsert(entries);
+}
+//# sourceMappingURL=ingestKnowledgeBase.js.map

package/dist/memory/ingestKnowledgeBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestKnowledgeBase.js","sourceRoot":"","sources":["../../src/memory/ingestKnowledgeBase.ts"],"names":[],"mappings":";;AAqCA,kDAUC;AA/CD,iEAA8D;AAY9D,MAAM,SAAS,GAAG,CAAC,GAAW,EAA0B,EAAE;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,CAAS,EAAE,EAAE;QAC3C,IACE,CAAC,IAAI;YACL,OAAQ,IAA6B,CAAC,QAAQ,KAAK,QAAQ;YAC3D,OAAQ,IAA6B,CAAC,MAAM,KAAK,QAAQ,EACzD,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,oCAAoC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAA4B,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;GAMG;AACI,KAAK,UAAU,mBAAmB,CACvC,KAA+B,EAC/B,MAAmC;IAEnC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACtB,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,2CAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC"}