@hasna/mementos 0.14.33 → 0.14.35

package/dist/lib/tool-memory-synthesizer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tool Memory Synthesizer — periodic LLM consolidation of tool experience.
+ * For tools with 10+ events, synthesizes aggregated insights into a single
+ * high-importance guide memory. Archives individual low-importance tool memories.
+ * ReMe ToolSummarizer equivalent, but runs periodically rather than per-call.
+ */
+interface SynthesisResult {
+    tool_name: string;
+    guide: string;
+    when_to_use: string;
+    lessons_consolidated: number;
+}
+export declare function synthesizeToolMemory(tool_name: string, options?: {
+    project_id?: string;
+    agent_id?: string;
+    min_events?: number;
+}): Promise<SynthesisResult | null>;
+/**
+ * Synthesize guides for all tools with enough events.
+ * Intended to be called periodically (e.g., by ALMA scheduler).
+ */
+export declare function synthesizeAllToolMemories(options?: {
+    project_id?: string;
+    agent_id?: string;
+    min_events?: number;
+}): Promise<SynthesisResult[]>;
+export {};
+//# sourceMappingURL=tool-memory-synthesizer.d.ts.map

package/dist/lib/tool-memory-synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-memory-synthesizer.d.ts","sourceRoot":"","sources":["../../src/lib/tool-memory-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAoFjC;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,eAAe,EAAE,CAAC,CAY5B"}

package/dist/lib/topic-clusterer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Topic Clusterer — groups memories into named topics for hints display.
+ * LLM-powered with cheap heuristic fallback.
+ */
+import type { Memory } from "../types/index.js";
+export interface TopicCluster {
+    name: string;
+    memory_ids: string[];
+    keywords: string[];
+}
+/**
+ * Heuristic clustering (no LLM needed) — groups by category + tag overlap.
+ * Fast, cheap, always available.
+ */
+export declare function clusterByHeuristic(memories: Memory[]): TopicCluster[];
+/**
+ * LLM clustering — sends memories to Haiku for semantic grouping.
+ * Falls back to heuristic if no API key.
+ */
+export declare function clusterByLLM(memories: Memory[]): Promise<TopicCluster[]>;
+//# sourceMappingURL=topic-clusterer.d.ts.map

package/dist/lib/topic-clusterer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-clusterer.d.ts","sourceRoot":"","sources":["../../src/lib/topic-clusterer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CA2BrE;AAkFD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CA4CzB"}

package/dist/lib/when-to-use-generator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Auto-generates when_to_use activation contexts for memories using LLM.
+ * Fires async (non-blocking) after memory save via PostMemorySave hook.
+ * Enable with MEMENTOS_AUTO_WHEN_TO_USE=true environment variable.
+ */
+export declare function generateWhenToUse(key: string, value: string, category: string, tags: string[]): Promise<string | null>;
+/**
+ * PostMemorySave hook: auto-generate when_to_use if missing.
+ * Non-blocking — fires after save, updates memory async.
+ */
+export declare function autoGenerateWhenToUse(ctx: {
+    memory: {
+        id: string;
+        key: string;
+        value: string;
+        category: string;
+        tags: string[];
+        when_to_use?: string | null;
+    };
+    wasUpdated: boolean;
+}): Promise<void>;
+//# sourceMappingURL=when-to-use-generator.d.ts.map

package/dist/lib/when-to-use-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"when-to-use-generator.d.ts","sourceRoot":"","sources":["../../src/lib/when-to-use-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgCxB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE;IAC/C,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClH,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhB"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env bun
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Exported so other modules can push channel notifications via the underlying Server. */
+export declare let mcpServer: McpServer | null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiFpE,0FAA0F;AAC1F,eAAO,IAAI,SAAS,EAAE,SAAS,GAAG,IAAW,CAAC"}