@hasna/mementos 0.14.39 → 0.14.41

package/dist/lib/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/lib/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,OAAO,KAAK,EACV,kBAAkB,EAElB,aAAa,EACb,UAAU,EACX,MAAM,mBAAmB,CAAC;AA6K3B,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,aAAsB,EACjC,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,kBAAkB,CAAC;IACzC,EAAE,CAAC,EAAE,QAAQ,CAAC;CACV,GACL,UAAU,CAgCZ;AAED,eAAO,MAAM,iBAAiB,UAAgC,CAAC"}

package/dist/lib/synthesis/corpus-builder.d.ts

@@ -0,0 +1,30 @@
+import { SqliteAdapter as Database } from "../../storage.js";
+import type { Memory } from "../../types/index.js";
+export interface MemoryCorpusItem {
+    memory: Memory;
+    recallCount: number;
+    lastRecalled: string | null;
+    searchHits: number;
+    similarMemoryIds: string[];
+}
+export interface AnalysisCorpus {
+    projectId: string | null;
+    totalMemories: number;
+    items: MemoryCorpusItem[];
+    staleMemories: Memory[];
+    duplicateCandidates: Array<{
+        a: Memory;
+        b: Memory;
+        similarity: number;
+    }>;
+    lowImportanceHighRecall: Memory[];
+    highImportanceLowRecall: Memory[];
+    generatedAt: string;
+}
+export declare function buildCorpus(options: {
+    projectId?: string;
+    agentId?: string;
+    limit?: number;
+    db?: Database;
+}): Promise<AnalysisCorpus>;
+//# sourceMappingURL=corpus-builder.d.ts.map

package/dist/lib/synthesis/corpus-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus-builder.d.ts","sourceRoot":"","sources":["../../../src/lib/synthesis/corpus-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AASnD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAyDD,wBAAsB,WAAW,CAAC,OAAO,EAAE;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CA0H1B"}

package/dist/lib/synthesis/executor.d.ts

@@ -0,0 +1,14 @@
+import { SqliteAdapter as Database } from "../../storage.js";
+import { type SynthesisProposal } from "../../db/synthesis.js";
+export interface ExecutionResult {
+    runId: string;
+    executed: number;
+    failed: number;
+    rollbackData: Record<string, unknown>;
+}
+export declare function executeProposals(runId: string, proposals: SynthesisProposal[], db?: Database): Promise<ExecutionResult>;
+export declare function rollbackRun(runId: string, db?: Database): Promise<{
+    rolled_back: number;
+    errors: string[];
+}>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/lib/synthesis/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/lib/synthesis/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAMD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,iBAAiB,EAAE,EAC9B,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,eAAe,CAAC,CAsC1B;AAgND,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAmBpD"}

package/dist/lib/synthesis/index.d.ts

@@ -0,0 +1,37 @@
+import { SqliteAdapter as Database } from "../../storage.js";
+import { type SynthesisProposal, type SynthesisRun } from "../../db/synthesis.js";
+import { type SafetyConfig } from "./validator.js";
+import { type EffectivenessReport } from "./metrics.js";
+export type { SafetyConfig } from "./validator.js";
+export type { EffectivenessReport } from "./metrics.js";
+export type { AnalysisCorpus, MemoryCorpusItem } from "./corpus-builder.js";
+export type { SynthesisAnalysisResult } from "./llm-analyzer.js";
+export type { ValidationResult, SafetyConfig as SafetyConfigType } from "./validator.js";
+export type { ExecutionResult } from "./executor.js";
+export type { SchedulerConfig, SchedulerState } from "./scheduler.js";
+export interface SynthesisOptions {
+    projectId?: string;
+    agentId?: string;
+    provider?: string;
+    maxProposals?: number;
+    dryRun?: boolean;
+    safetyConfig?: Partial<SafetyConfig>;
+    db?: Database;
+}
+export interface SynthesisResult {
+    run: SynthesisRun;
+    proposals: SynthesisProposal[];
+    executed: number;
+    metrics: EffectivenessReport | null;
+    dryRun: boolean;
+}
+export declare function runSynthesis(options?: SynthesisOptions): Promise<SynthesisResult>;
+export declare function rollbackSynthesis(runId: string, db?: Database): Promise<{
+    rolled_back: number;
+    errors: string[];
+}>;
+export declare function getSynthesisStatus(runId?: string, projectId?: string, db?: Database): {
+    lastRun: SynthesisRun | null;
+    recentRuns: SynthesisRun[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/synthesis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/synthesis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAM9E,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,YAAY,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACzF,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMtE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,YAAY,CAAC;IAClB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,MAAM,EAAE,OAAO,CAAC;CACjB;AAMD,wBAAsB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwJ3F;AAMD,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAUpD;AAMD,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,YAAY,EAAE,CAAA;CAAE,CAwB9D"}

package/dist/lib/synthesis/llm-analyzer.d.ts

@@ -0,0 +1,18 @@
+import type { AnalysisCorpus } from "./corpus-builder.js";
+export interface SynthesisAnalysisResult {
+    proposals: Array<{
+        type: "merge" | "archive" | "promote" | "update_value" | "add_tag" | "remove_duplicate";
+        memory_ids: string[];
+        target_memory_id?: string;
+        proposed_changes: Record<string, unknown>;
+        reasoning: string;
+        confidence: number;
+    }>;
+    summary: string;
+    analysisDurationMs: number;
+}
+export declare function analyzeCorpus(corpus: AnalysisCorpus, options?: {
+    provider?: string;
+    maxProposals?: number;
+}): Promise<SynthesisAnalysisResult>;
+//# sourceMappingURL=llm-analyzer.d.ts.map

package/dist/lib/synthesis/llm-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-analyzer.d.ts","sourceRoot":"","sources":["../../../src/lib/synthesis/llm-analyzer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,GAAG,kBAAkB,CAAC;QACxF,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAyFD,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAAC,uBAAuB,CAAC,CA8ClC"}

package/dist/lib/synthesis/metrics.d.ts

@@ -0,0 +1,13 @@
+import { SqliteAdapter as Database } from "../../storage.js";
+import { type SynthesisMetric } from "../../db/synthesis.js";
+import type { AnalysisCorpus } from "./corpus-builder.js";
+export interface EffectivenessReport {
+    runId: string;
+    corpusReduction: number;
+    importanceDrift: number;
+    deduplicationRate: number;
+    estimatedRecallImprovement: number;
+    metrics: SynthesisMetric[];
+}
+export declare function measureEffectiveness(runId: string, preCorpus: AnalysisCorpus, db?: Database): Promise<EffectivenessReport>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/lib/synthesis/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/lib/synthesis/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B,EAAE,MAAM,CAAC;IACnC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAMD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,cAAc,EACzB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,mBAAmB,CAAC,CAmG9B"}

package/dist/lib/synthesis/scheduler.d.ts

@@ -0,0 +1,18 @@
+import { SqliteAdapter as Database } from "../../storage.js";
+import { type SynthesisRun } from "../../db/synthesis.js";
+export interface SchedulerConfig {
+    enabled: boolean;
+    minMemoriesForTrigger: number;
+    minEventsSinceLastRun: number;
+    maxRunIntervalHours: number;
+    minRunIntervalHours: number;
+}
+export interface SchedulerState {
+    lastRunAt: string | null;
+    eventsSinceLastRun: number;
+    shouldTrigger: boolean;
+    reason: string;
+}
+export declare function checkShouldTrigger(projectId: string | null, config?: Partial<SchedulerConfig>, db?: Database): SchedulerState;
+export declare function triggerIfReady(projectId: string | null, agentId: string | null, config?: Partial<SchedulerConfig>, db?: Database): Promise<SynthesisRun | null>;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/lib/synthesis/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/lib/synthesis/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,EACjC,EAAE,CAAC,EAAE,QAAQ,GACZ,cAAc,CAwFhB;AAMD,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,EACjC,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsB9B"}

package/dist/lib/synthesis/validator.d.ts

@@ -0,0 +1,19 @@
+import type { AnalysisCorpus } from "./corpus-builder.js";
+import type { SynthesisAnalysisResult } from "./llm-analyzer.js";
+export interface ValidationResult {
+    valid: boolean;
+    rejectedProposals: Array<{
+        proposalId: string;
+        reason: string;
+    }>;
+    warnings: string[];
+}
+export interface SafetyConfig {
+    maxArchivePercent: number;
+    maxMergePercent: number;
+    minConfidence: number;
+    protectPinned: boolean;
+    protectHighImportance: number;
+}
+export declare function validateProposals(proposals: SynthesisAnalysisResult["proposals"], corpus: AnalysisCorpus, config?: Partial<SafetyConfig>): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/lib/synthesis/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/lib/synthesis/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAMjE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAcD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,uBAAuB,CAAC,WAAW,CAAC,EAC/C,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,gBAAgB,CAyIlB"}

package/dist/lib/task-runner.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Background task processor — polls for pending tasks every minute,
+ * executes them via registered handlers, and updates status.
+ *
+ * Handlers can be registered for specific task types (identified by tags or metadata.type).
+ * A default handler logs and marks failed if no specific handler matches.
+ */
+import type { Task } from "../db/tasks.js";
+export interface TaskHandlerContext {
+    task: Task;
+    updateProgress: (progress: number) => void;
+    addComment: (body: string, agentId?: string) => void;
+}
+export type TaskHandler = (ctx: TaskHandlerContext) => Promise<void>;
+export interface TaskRunnerStats {
+    pending: number;
+    inProgress: number;
+    completed: number;
+    failed: number;
+    cancelled: number;
+    totalProcessed: number;
+}
+/** Register a handler for tasks matching a specific tag or metadata.type. */
+export declare function registerTaskHandler(type: string, handler: TaskHandler): void;
+/** Set the fallback handler for tasks with no matching handler. */
+export declare function setDefaultTaskHandler(handler: TaskHandler): void;
+/**
+ * Start the task runner polling loop.
+ * Idempotent — safe to call multiple times.
+ * @param intervalMs Poll interval in milliseconds (default: 60000 = 1 minute)
+ */
+export declare function startTaskRunner(intervalMs?: number): void;
+/** Process one tick — claim and execute the highest priority pending task. */
+export declare function _tick(): Promise<void>;
+/** Get runtime stats. */
+export declare function getTaskRunnerStats(): TaskRunnerStats;
+//# sourceMappingURL=task-runner.d.ts.map

package/dist/lib/task-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner.d.ts","sourceRoot":"","sources":["../../src/lib/task-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAM3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AASD,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAE5E;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAEhE;AA+BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAczD;AAED,8EAA8E;AAC9E,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAyF3C;AAED,yBAAyB;AACzB,wBAAgB,kBAAkB,IAAI,eAAe,CAmCpD"}

package/dist/lib/tool-lesson-extractor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LLM-based tool lesson extraction from session transcripts.
+ * Analyzes tool call sequences in a session and extracts:
+ * - "Tool X works well for Y with params Z"
+ * - "Tool X fails when Y because Z, use alternative A"
+ * - "For best results with X, set param Y to Z"
+ * - "When X returns error Y, solution is Z"
+ *
+ * Saves both structured tool_events and qualitative memories.
+ */
+interface ExtractedLesson {
+    tool_name: string;
+    lesson: string;
+    when_to_use: string;
+    success: boolean;
+    error_type?: string | null;
+}
+export declare function extractToolLessons(transcript: string, options?: {
+    agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+}): Promise<ExtractedLesson[]>;
+export {};
+//# sourceMappingURL=tool-lesson-extractor.d.ts.map

package/dist/lib/tool-lesson-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-lesson-extractor.d.ts","sourceRoot":"","sources":["../../src/lib/tool-lesson-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwBH,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,eAAe,EAAE,CAAC,CA6E5B"}

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/http.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const MCP_HTTP_SERVICE_NAME = "mementos";
+export declare const DEFAULT_MCP_HTTP_PORT = 8867;
+export declare function isHttpMode(argv?: string[], env?: NodeJS.ProcessEnv): boolean;
+export declare function isStdioMode(argv?: string[], env?: NodeJS.ProcessEnv): boolean;
+export declare function resolveMcpHttpPort(argv?: string[], env?: NodeJS.ProcessEnv): number;
+export type McpHttpServerHandle = {
+    port: number;
+    host: string;
+    close: () => Promise<void>;
+};
+export declare function startMcpHttpServer(buildServer: () => McpServer, options?: {
+    port?: number;
+    host?: string;
+    serviceName?: string;
+}): Promise<McpHttpServerHandle>;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/mcp/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAChD,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,wBAAgB,UAAU,CACxB,IAAI,GAAE,MAAM,EAAiB,EAC7B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAET;AAED,wBAAgB,WAAW,CACzB,IAAI,GAAE,MAAM,EAAiB,EAC7B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAET;AAED,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,MAAM,EAAiB,EAC7B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CASR;AAoBD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,SAAS,EAC5B,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,mBAAmB,CAAC,CAwE9B"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,6 @@
+#!/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;
+export declare function buildServer(): McpServer;
+//# 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;AA6CpE,0FAA0F;AAC1F,eAAO,IAAI,SAAS,EAAE,SAAS,GAAG,IAAW,CAAC;AAqB9C,wBAAgB,WAAW,IAAI,SAAS,CA4EvC"}