@dungle-scrubs/hippo 0.1.0

package/dist/tools/recall-memories.js.map

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

package/dist/tools/recall-memory-block.d.ts

@@ -0,0 +1,21 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { DbStatements } from "../db.js";
+declare const Params: import("@sinclair/typebox").TObject<{
+    key: import("@sinclair/typebox").TString;
+}>;
+/** Options for creating the recall_memory_block tool. */
+export interface RecallMemoryBlockToolOptions {
+    readonly agentId: string;
+    readonly stmts: DbStatements;
+}
+/**
+ * Create the recall_memory_block tool.
+ *
+ * Returns the contents of a named memory block, or null if it doesn't exist.
+ *
+ * @param opts - Tool options
+ * @returns AgentTool instance
+ */
+export declare function createRecallMemoryBlockTool(opts: RecallMemoryBlockToolOptions): AgentTool<typeof Params>;
+export {};
+//# sourceMappingURL=recall-memory-block.d.ts.map

package/dist/tools/recall-memory-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-memory-block.d.ts","sourceRoot":"","sources":["../../src/tools/recall-memory-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,QAAA,MAAM,MAAM;;EAIV,CAAC;AAEH,yDAAyD;AACzD,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,4BAA4B,GAChC,SAAS,CAAC,OAAO,MAAM,CAAC,CAsB1B"}

package/dist/tools/recall-memory-block.js

@@ -0,0 +1,36 @@
+import { Type } from "@mariozechner/pi-ai";
+const Params = Type.Object({
+    key: Type.String({
+        description: "Block name to retrieve (e.g. 'persona', 'human', 'objectives')",
+    }),
+});
+/**
+ * Create the recall_memory_block tool.
+ *
+ * Returns the contents of a named memory block, or null if it doesn't exist.
+ *
+ * @param opts - Tool options
+ * @returns AgentTool instance
+ */
+export function createRecallMemoryBlockTool(opts) {
+    return {
+        description: "Retrieve the contents of a named memory block. Returns null if the block doesn't exist.",
+        execute: async (_toolCallId, params) => {
+            const row = opts.stmts.getBlockByKey.get(opts.agentId, params.key);
+            const result = {
+                content: [
+                    {
+                        text: row ? row.value : "null",
+                        type: "text",
+                    },
+                ],
+                details: { value: row?.value ?? null },
+            };
+            return result;
+        },
+        label: "Recall Memory Block",
+        name: "recall_memory_block",
+        parameters: Params,
+    };
+}
+//# sourceMappingURL=recall-memory-block.js.map

package/dist/tools/recall-memory-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-memory-block.js","sourceRoot":"","sources":["../../src/tools/recall-memory-block.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAI3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1B,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC;QAChB,WAAW,EAAE,gEAAgE;KAC7E,CAAC;CACF,CAAC,CAAC;AAQH;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CAC1C,IAAkC;IAElC,OAAO;QACN,WAAW,EACV,yFAAyF;QAC1F,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAA4B,CAAC;YAE9F,MAAM,MAAM,GAA8C;gBACzD,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;wBAC9B,IAAI,EAAE,MAAM;qBACZ;iBACD;gBACD,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,IAAI,EAAE;aACtC,CAAC;YACF,OAAO,MAAM,CAAC;QACf,CAAC;QACD,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,qBAAqB;QAC3B,UAAU,EAAE,MAAM;KAClB,CAAC;AACH,CAAC"}

package/dist/tools/remember-facts.d.ts

@@ -0,0 +1,30 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { Database } from "better-sqlite3";
+import { type DbStatements } from "../db.js";
+import type { EmbedFn, LlmClient } from "../types.js";
+declare const Params: import("@sinclair/typebox").TObject<{
+    text: import("@sinclair/typebox").TString;
+}>;
+/** Options for creating the remember_facts tool. */
+export interface RememberFactsToolOptions {
+    readonly agentId: string;
+    readonly db: Database;
+    readonly embed: EmbedFn;
+    readonly llm: LlmClient;
+    /** Max existing facts to load for conflict resolution (default: 10,000). */
+    readonly maxSearchFacts?: number;
+    /** Max input text length in characters (default: 10,000). */
+    readonly maxTextLength?: number;
+    readonly stmts: DbStatements;
+}
+/**
+ * Create the remember_facts tool.
+ *
+ * Full pipeline: extract → embed → conflict check → insert/replace/strengthen.
+ *
+ * @param opts - Tool options
+ * @returns AgentTool instance
+ */
+export declare function createRememberFactsTool(opts: RememberFactsToolOptions): AgentTool<typeof Params>;
+export {};
+//# sourceMappingURL=remember-facts.d.ts.map

package/dist/tools/remember-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember-facts.d.ts","sourceRoot":"","sources":["../../src/tools/remember-facts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,UAAU,CAAC;AAI9D,OAAO,KAAK,EAEX,OAAO,EACP,SAAS,EAGT,MAAM,aAAa,CAAC;AAgBrB,QAAA,MAAM,MAAM;;EAIV,CAAC;AAEH,oDAAoD;AACpD,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG,SAAS,CAAC,OAAO,MAAM,CAAC,CAkEhG"}

package/dist/tools/remember-facts.js

@@ -0,0 +1,235 @@
+import { Type } from "@mariozechner/pi-ai";
+import { getActiveChunks } from "../db.js";
+import { classifyConflict, extractFacts } from "../extractor.js";
+import { chunkEmbedding, cosineSimilarity, embeddingToBuffer } from "../similarity.js";
+import { updatedIntensity } from "../strength.js";
+import { ulid } from "../ulid.js";
+/** Similarity thresholds for auto-classification. */
+const DUPLICATE_THRESHOLD = 0.93;
+const AMBIGUOUS_THRESHOLD = 0.78;
+/** Top N existing chunks to compare against. */
+const TOP_K_CANDIDATES = 5;
+/** Default max existing facts to load for conflict resolution. */
+const DEFAULT_MAX_SEARCH_FACTS = 10_000;
+/** Maximum input text length in characters (default 10KB). */
+const MAX_TEXT_LENGTH = 10_000;
+const Params = Type.Object({
+    text: Type.String({
+        description: "Text containing facts to extract and remember",
+    }),
+});
+/**
+ * Create the remember_facts tool.
+ *
+ * Full pipeline: extract → embed → conflict check → insert/replace/strengthen.
+ *
+ * @param opts - Tool options
+ * @returns AgentTool instance
+ */
+export function createRememberFactsTool(opts) {
+    return {
+        description: "Extract discrete facts from text, rate their intensity, check for conflicts with existing knowledge, and store. Handles duplicates, supersession, and new facts.",
+        execute: async (_toolCallId, params, signal) => {
+            const maxLen = opts.maxTextLength ?? MAX_TEXT_LENGTH;
+            if (params.text.length > maxLen) {
+                throw new Error(`Input text too long (${params.text.length} chars, max ${maxLen}). Summarize or chunk the text first.`);
+            }
+            const extracted = await extractFacts(params.text, opts.llm, signal);
+            if (extracted.length === 0) {
+                const result = {
+                    content: [{ text: "No facts extracted.", type: "text" }],
+                    details: { facts: [] },
+                };
+                return result;
+            }
+            const actions = [];
+            // No transaction wrapper — intentional. Each fact is independently meaningful,
+            // so partial insertion on mid-batch failure is acceptable. The alternative
+            // (all-or-nothing) would discard successfully processed facts on a transient
+            // embed/LLM error, which is worse for the user.
+            //
+            // Load facts once — processFact maintains this array across iterations
+            // for intra-batch visibility (e.g., dedup between extracted facts).
+            const maxFacts = opts.maxSearchFacts ?? DEFAULT_MAX_SEARCH_FACTS;
+            const existingFacts = getActiveChunks(opts.stmts, opts.agentId, "fact", maxFacts);
+            for (const { fact, intensity } of extracted) {
+                const action = await processFact(fact, intensity, existingFacts, opts, signal);
+                actions.push(action);
+            }
+            const summary = actions
+                .map((a) => {
+                switch (a.action) {
+                    case "inserted":
+                        return `New: "${a.content}" (intensity: ${a.intensity.toFixed(2)})`;
+                    case "reinforced":
+                        return `Reinforced: "${a.content}" (${a.oldIntensity.toFixed(2)} → ${a.newIntensity.toFixed(2)})`;
+                    case "superseded":
+                        return `Superseded: "${a.oldContent}" → "${a.content}"`;
+                    default: {
+                        const _exhaustive = a;
+                        return _exhaustive;
+                    }
+                }
+            })
+                .join("\n");
+            const result = {
+                content: [{ text: `Processed ${actions.length} facts:\n${summary}`, type: "text" }],
+                details: { facts: actions },
+            };
+            return result;
+        },
+        label: "Remember Facts",
+        name: "remember_facts",
+        parameters: Params,
+    };
+}
+/**
+ * Process a single extracted fact through the conflict resolution pipeline.
+ *
+ * Mutates `existingFacts` to reflect inserts, reinforcements, and supersessions
+ * so subsequent facts in the same batch see up-to-date state without re-querying.
+ *
+ * @param fact - Extracted fact text
+ * @param intensity - Rated intensity [0, 1]
+ * @param existingFacts - Mutable array of active fact chunks (updated in place)
+ * @param opts - Tool options
+ * @param signal - Optional abort signal
+ * @returns Action taken for this fact
+ */
+async function processFact(fact, intensity, existingFacts, opts, signal) {
+    const now = new Date().toISOString();
+    const embedding = await opts.embed(fact, signal);
+    const embeddingBuf = embeddingToBuffer(embedding);
+    // Find top candidates by similarity
+    const candidates = findTopCandidates(embedding, existingFacts, TOP_K_CANDIDATES);
+    // Check best candidate for conflict
+    const best = candidates[0];
+    if (!best || best.similarity < AMBIGUOUS_THRESHOLD) {
+        // NEW — no similar existing fact
+        const chunk = {
+            access_count: 0,
+            agent_id: opts.agentId,
+            content: fact,
+            content_hash: null,
+            created_at: now,
+            embedding: embeddingBuf,
+            encounter_count: 1,
+            id: ulid(),
+            kind: "fact",
+            last_accessed_at: now,
+            metadata: null,
+            running_intensity: intensity,
+            superseded_by: null,
+        };
+        opts.stmts.insertChunk.run(chunk);
+        existingFacts.push(chunk);
+        return { action: "inserted", content: fact, intensity };
+    }
+    // Determine classification
+    let classification;
+    if (best.similarity > DUPLICATE_THRESHOLD) {
+        classification = "DUPLICATE";
+    }
+    else {
+        // Ambiguous band — ask LLM
+        classification = await classifyConflict(fact, best.chunk.content, opts.llm, signal);
+    }
+    switch (classification) {
+        case "DUPLICATE": {
+            const newIntensity = updatedIntensity(best.chunk.running_intensity, best.chunk.encounter_count, intensity);
+            opts.stmts.reinforceChunk.run({
+                id: best.chunk.id,
+                last_accessed_at: now,
+                running_intensity: newIntensity,
+            });
+            // Update in-memory entry so subsequent facts see current values
+            const idx = existingFacts.indexOf(best.chunk);
+            if (idx !== -1) {
+                existingFacts[idx] = {
+                    ...best.chunk,
+                    access_count: best.chunk.access_count + 1,
+                    encounter_count: best.chunk.encounter_count + 1,
+                    last_accessed_at: now,
+                    running_intensity: newIntensity,
+                };
+            }
+            return {
+                action: "reinforced",
+                content: best.chunk.content,
+                newIntensity,
+                oldIntensity: best.chunk.running_intensity,
+            };
+        }
+        case "SUPERSEDES": {
+            const newId = ulid();
+            const chunk = {
+                access_count: 0,
+                agent_id: opts.agentId,
+                content: fact,
+                content_hash: null,
+                created_at: now,
+                embedding: embeddingBuf,
+                encounter_count: 1,
+                id: newId,
+                kind: "fact",
+                last_accessed_at: now,
+                metadata: null,
+                running_intensity: intensity,
+                superseded_by: null,
+            };
+            // Atomic: insert replacement then mark old as superseded.
+            // If either fails, neither commits — no dangling superseded_by refs.
+            opts.db.transaction(() => {
+                opts.stmts.insertChunk.run(chunk);
+                opts.stmts.supersedeChunk.run(newId, best.chunk.id);
+            })();
+            // Update in-memory array after successful commit
+            const idx = existingFacts.indexOf(best.chunk);
+            if (idx !== -1)
+                existingFacts.splice(idx, 1);
+            existingFacts.push(chunk);
+            return {
+                action: "superseded",
+                content: fact,
+                oldContent: best.chunk.content,
+            };
+        }
+        case "DISTINCT": {
+            const chunk = {
+                access_count: 0,
+                agent_id: opts.agentId,
+                content: fact,
+                content_hash: null,
+                created_at: now,
+                embedding: embeddingBuf,
+                encounter_count: 1,
+                id: ulid(),
+                kind: "fact",
+                last_accessed_at: now,
+                metadata: null,
+                running_intensity: intensity,
+                superseded_by: null,
+            };
+            opts.stmts.insertChunk.run(chunk);
+            existingFacts.push(chunk);
+            return { action: "inserted", content: fact, intensity };
+        }
+    }
+}
+/**
+ * Find the top K most similar existing chunks to a query embedding.
+ *
+ * @param queryEmbedding - The new fact's embedding
+ * @param existingChunks - All active chunks to search
+ * @param topK - Number of candidates to return
+ * @returns Sorted candidates (highest similarity first)
+ */
+function findTopCandidates(queryEmbedding, existingChunks, topK) {
+    const scored = existingChunks.map((chunk) => ({
+        chunk,
+        similarity: cosineSimilarity(queryEmbedding, chunkEmbedding(chunk)),
+    }));
+    scored.sort((a, b) => b.similarity - a.similarity);
+    return scored.slice(0, topK);
+}
+//# sourceMappingURL=remember-facts.js.map

package/dist/tools/remember-facts.js.map

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

package/dist/tools/replace-memory-block.d.ts

@@ -0,0 +1,25 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { DbStatements } from "../db.js";
+declare const Params: import("@sinclair/typebox").TObject<{
+    key: import("@sinclair/typebox").TString;
+    newText: import("@sinclair/typebox").TString;
+    oldText: import("@sinclair/typebox").TString;
+}>;
+/** Options for creating the replace_memory_block tool. */
+export interface ReplaceMemoryBlockToolOptions {
+    readonly agentId: string;
+    readonly stmts: DbStatements;
+}
+/**
+ * Create the replace_memory_block tool.
+ *
+ * Performs find/replace on a named memory block. Replaces all occurrences.
+ * Returns a structured error (not a throw) if the block doesn't exist or
+ * the search text isn't found.
+ *
+ * @param opts - Tool options
+ * @returns AgentTool instance
+ */
+export declare function createReplaceMemoryBlockTool(opts: ReplaceMemoryBlockToolOptions): AgentTool<typeof Params>;
+export {};
+//# sourceMappingURL=replace-memory-block.d.ts.map

package/dist/tools/replace-memory-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-memory-block.d.ts","sourceRoot":"","sources":["../../src/tools/replace-memory-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,QAAA,MAAM,MAAM;;;;EAIV,CAAC;AAEH,0DAA0D;AAC1D,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC3C,IAAI,EAAE,6BAA6B,GACjC,SAAS,CAAC,OAAO,MAAM,CAAC,CA0D1B"}

package/dist/tools/replace-memory-block.js

@@ -0,0 +1,69 @@
+import { Type } from "@mariozechner/pi-ai";
+const Params = Type.Object({
+    key: Type.String({ description: "Block name (e.g. 'persona', 'human')" }),
+    newText: Type.String({ description: "Replacement text" }),
+    oldText: Type.String({ description: "Text to find and replace" }),
+});
+/**
+ * Create the replace_memory_block tool.
+ *
+ * Performs find/replace on a named memory block. Replaces all occurrences.
+ * Returns a structured error (not a throw) if the block doesn't exist or
+ * the search text isn't found.
+ *
+ * @param opts - Tool options
+ * @returns AgentTool instance
+ */
+export function createReplaceMemoryBlockTool(opts) {
+    return {
+        description: "Find and replace text in a named memory block. Replaces all occurrences. Returns error if block doesn't exist or text not found.",
+        execute: async (_toolCallId, params) => {
+            if (params.oldText.length === 0) {
+                const result = {
+                    content: [{ text: "Error: oldText must not be empty", type: "text" }],
+                    details: { error: "empty_old_text" },
+                };
+                return result;
+            }
+            const row = opts.stmts.getBlockByKey.get(opts.agentId, params.key);
+            if (!row) {
+                const result = {
+                    content: [{ text: `Error: block "${params.key}" does not exist`, type: "text" }],
+                    details: { error: "block_not_found" },
+                };
+                return result;
+            }
+            if (!row.value.includes(params.oldText)) {
+                const result = {
+                    content: [
+                        {
+                            text: `Error: text not found in block "${params.key}"`,
+                            type: "text",
+                        },
+                    ],
+                    details: { error: "text_not_found" },
+                };
+                return result;
+            }
+            const newValue = row.value.replaceAll(params.oldText, params.newText);
+            const now = new Date().toISOString();
+            opts.stmts.upsertBlock.run({
+                agent_id: opts.agentId,
+                key: params.key,
+                updated_at: now,
+                value: newValue,
+            });
+            const result = {
+                content: [{ text: `Updated block "${params.key}"`, type: "text" }],
+                details: {
+                    replacements: row.value.split(params.oldText).length - 1,
+                },
+            };
+            return result;
+        },
+        label: "Replace Memory Block",
+        name: "replace_memory_block",
+        parameters: Params,
+    };
+}
+//# sourceMappingURL=replace-memory-block.js.map

package/dist/tools/replace-memory-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-memory-block.js","sourceRoot":"","sources":["../../src/tools/replace-memory-block.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAI3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1B,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;IACzE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IACzD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;CACjE,CAAC,CAAC;AAQH;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC3C,IAAmC;IAEnC,OAAO;QACN,WAAW,EACV,kIAAkI;QACnI,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE;YACtC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAuC;oBAClD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,kCAAkC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBACrE,OAAO,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE;iBACpC,CAAC;gBACF,OAAO,MAAM,CAAC;YACf,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAA4B,CAAC;YAE9F,IAAI,CAAC,GAAG,EAAE,CAAC;gBACV,MAAM,MAAM,GAAuC;oBAClD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,MAAM,CAAC,GAAG,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBAChF,OAAO,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE;iBACrC,CAAC;gBACF,OAAO,MAAM,CAAC;YACf,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzC,MAAM,MAAM,GAAuC;oBAClD,OAAO,EAAE;wBACR;4BACC,IAAI,EAAE,mCAAmC,MAAM,CAAC,GAAG,GAAG;4BACtD,IAAI,EAAE,MAAM;yBACZ;qBACD;oBACD,OAAO,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE;iBACpC,CAAC;gBACF,OAAO,MAAM,CAAC;YACf,CAAC;YAED,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAErC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC;gBAC1B,QAAQ,EAAE,IAAI,CAAC,OAAO;gBACtB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,UAAU,EAAE,GAAG;gBACf,KAAK,EAAE,QAAQ;aACf,CAAC,CAAC;YAEH,MAAM,MAAM,GAA8C;gBACzD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,MAAM,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBAClE,OAAO,EAAE;oBACR,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;iBACxD;aACD,CAAC;YACF,OAAO,MAAM,CAAC;QACf,CAAC;QACD,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,MAAM;KAClB,CAAC;AACH,CAAC"}

package/dist/tools/store-memory.d.ts

@@ -0,0 +1,27 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { DbStatements } from "../db.js";
+import type { EmbedFn } from "../types.js";
+declare const Params: import("@sinclair/typebox").TObject<{
+    content: import("@sinclair/typebox").TString;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+/** Options for creating the store_memory tool. */
+export interface StoreMemoryToolOptions {
+    readonly agentId: string;
+    readonly embed: EmbedFn;
+    /** Max content length in characters (default: 50,000). */
+    readonly maxContentLength?: number;
+    readonly stmts: DbStatements;
+}
+/**
+ * Create the store_memory tool.
+ *
+ * Embeds content, deduplicates by content hash, and inserts or strengthens.
+ * Verbatim duplicates are strengthened (encounter_count + 1), not re-inserted.
+ *
+ * @param opts - Tool options
+ * @returns AgentTool instance
+ */
+export declare function createStoreMemoryTool(opts: StoreMemoryToolOptions): AgentTool<typeof Params>;
+export {};
+//# sourceMappingURL=store-memory.d.ts.map

package/dist/tools/store-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-memory.d.ts","sourceRoot":"","sources":["../../src/tools/store-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,aAAa,CAAC;AAMlD,QAAA,MAAM,MAAM;;;EAOV,CAAC;AAEH,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC7B;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,SAAS,CAAC,OAAO,MAAM,CAAC,CAgH5F"}

package/dist/tools/store-memory.js

@@ -0,0 +1,129 @@
+import { Type } from "@mariozechner/pi-ai";
+import { contentHash } from "../hash.js";
+import { embeddingToBuffer } from "../similarity.js";
+import { updatedIntensity } from "../strength.js";
+import { ulid } from "../ulid.js";
+/** Maximum content length in characters (default 50KB). */
+const MAX_CONTENT_LENGTH = 50_000;
+const Params = Type.Object({
+    content: Type.String({ description: "Content to store as a memory" }),
+    metadata: Type.Optional(Type.String({
+        description: 'Optional JSON metadata (e.g. {"source": "pdf", "tags": ["auth"]})',
+    })),
+});
+/**
+ * Check if an error is a SQLite UNIQUE constraint violation.
+ *
+ * @param err - Unknown error value
+ * @returns True if this is a UNIQUE constraint error
+ */
+function isSqliteConstraintUnique(err) {
+    return (err instanceof Error &&
+        "code" in err &&
+        err.code === "SQLITE_CONSTRAINT_UNIQUE");
+}
+/**
+ * Create the store_memory tool.
+ *
+ * Embeds content, deduplicates by content hash, and inserts or strengthens.
+ * Verbatim duplicates are strengthened (encounter_count + 1), not re-inserted.
+ *
+ * @param opts - Tool options
+ * @returns AgentTool instance
+ */
+export function createStoreMemoryTool(opts) {
+    return {
+        description: "Store a raw memory (document chunk, experience, decision). Deduplicates by content hash — identical content strengthens the existing memory.",
+        execute: async (_toolCallId, params, signal) => {
+            const maxLen = opts.maxContentLength ?? MAX_CONTENT_LENGTH;
+            if (params.content.length > maxLen) {
+                throw new Error(`Content too long (${params.content.length} chars, max ${maxLen}). Chunk the content before storing.`);
+            }
+            if (params.metadata !== undefined) {
+                try {
+                    JSON.parse(params.metadata);
+                }
+                catch {
+                    throw new Error(`Invalid JSON in metadata parameter: ${params.metadata.slice(0, 100)}`);
+                }
+            }
+            const now = new Date().toISOString();
+            const hash = contentHash(params.content);
+            // Check for verbatim duplicate using the content_hash index
+            const existing = opts.stmts.getMemoryByHash.get(opts.agentId, hash);
+            if (existing) {
+                // Strengthen existing memory — treat re-encounter at default intensity (0.5)
+                const newIntensity = updatedIntensity(existing.running_intensity, existing.encounter_count, 0.5);
+                opts.stmts.reinforceChunk.run({
+                    id: existing.id,
+                    last_accessed_at: now,
+                    running_intensity: newIntensity,
+                });
+                const result = {
+                    content: [
+                        {
+                            text: `Memory already exists (strengthened, encounters: ${existing.encounter_count + 1})`,
+                            type: "text",
+                        },
+                    ],
+                    details: { action: "strengthened" },
+                };
+                return result;
+            }
+            // New memory — embed and insert
+            const embedding = await opts.embed(params.content, signal);
+            try {
+                opts.stmts.insertChunk.run({
+                    access_count: 0,
+                    agent_id: opts.agentId,
+                    content: params.content,
+                    content_hash: hash,
+                    created_at: now,
+                    embedding: embeddingToBuffer(embedding),
+                    encounter_count: 1,
+                    id: ulid(),
+                    kind: "memory",
+                    last_accessed_at: now,
+                    metadata: params.metadata ?? null,
+                    running_intensity: 0.5,
+                });
+            }
+            catch (err) {
+                // TOCTOU: another call inserted the same content between our hash check
+                // and this insert (the await embed() yields the event loop). Fall back to strengthen.
+                if (isSqliteConstraintUnique(err)) {
+                    const race = opts.stmts.getMemoryByHash.get(opts.agentId, hash);
+                    if (race) {
+                        const newIntensity = updatedIntensity(race.running_intensity, race.encounter_count, 0.5);
+                        opts.stmts.reinforceChunk.run({
+                            id: race.id,
+                            last_accessed_at: now,
+                            running_intensity: newIntensity,
+                        });
+                        const result = {
+                            content: [
+                                {
+                                    text: `Memory already exists (strengthened, encounters: ${race.encounter_count + 1})`,
+                                    type: "text",
+                                },
+                            ],
+                            details: { action: "strengthened" },
+                        };
+                        return result;
+                    }
+                }
+                throw err;
+            }
+            const preview = params.content.length > 80 ? `${params.content.slice(0, 80)}...` : params.content;
+            const result = {
+                content: [{ text: `Stored memory: "${preview}"`, type: "text" }],
+                details: { action: "stored" },
+            };
+            return result;
+        },
+        label: "Store Memory",
+        name: "store_memory",
+        parameters: Params,
+    };
+}
+//# sourceMappingURL=store-memory.js.map

package/dist/tools/store-memory.js.map

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