@hasna/mementos 0.14.39 → 0.14.41

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

@@ -0,0 +1,7 @@
+export * from "./base.js";
+export * from "./anthropic.js";
+export * from "./openai.js";
+export * from "./cerebras.js";
+export * from "./grok.js";
+export * from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/lib/providers/openai-compat.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared base for all OpenAI-compatible providers.
+ * Used by: OpenAI, Cerebras, Grok/xAI.
+ * Handles: API calls, exponential backoff on 429, shared JSON parsing.
+ */
+import { BaseProvider, type ProviderConfig, type MemoryExtractionContext, type ExtractedMemory, type EntityExtractionResult } from "./base.js";
+export declare abstract class OpenAICompatProvider extends BaseProvider {
+    protected abstract readonly baseUrl: string;
+    protected abstract readonly authHeader: string;
+    constructor(config: ProviderConfig);
+    extractMemories(text: string, context: MemoryExtractionContext): Promise<ExtractedMemory[]>;
+    extractEntities(text: string): Promise<EntityExtractionResult>;
+    scoreImportance(content: string, _context: MemoryExtractionContext): Promise<number>;
+    /** Call with exponential backoff on 429 (rate limit), max 3 retries */
+    private callWithRetry;
+    private callAPI;
+}
+//# sourceMappingURL=openai-compat.d.ts.map

package/dist/lib/providers/openai-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compat.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/openai-compat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAK5B,MAAM,WAAW,CAAC;AAEnB,8BAAsB,oBAAqB,SAAQ,YAAY;IAC7D,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEnC,MAAM,EAAE,cAAc;IAI5B,eAAe,CACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,eAAe,EAAE,CAAC;IAkBvB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAoB9D,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,MAAM,CAAC;IAalB,uEAAuE;YACzD,aAAa;YAsBb,OAAO;CA0CtB"}

package/dist/lib/providers/openai.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OpenAI provider.
+ * Default model: gpt-4.1-nano (ultra cheap, fast).
+ * Premium: gpt-4.1-mini, gpt-4.1.
+ * Env var: OPENAI_API_KEY.
+ */
+import { OpenAICompatProvider } from "./openai-compat.js";
+import type { ProviderConfig, ProviderName } from "./base.js";
+export declare const OPENAI_MODELS: {
+    readonly default: "gpt-4.1-nano";
+    readonly mini: "gpt-4.1-mini";
+    readonly full: "gpt-4.1";
+};
+export declare class OpenAIProvider extends OpenAICompatProvider {
+    readonly name: ProviderName;
+    protected readonly baseUrl = "https://api.openai.com/v1";
+    protected readonly authHeader = "Authorization";
+    constructor(config?: Partial<ProviderConfig>);
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/lib/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9D,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,qBAAa,cAAe,SAAQ,oBAAoB;IACtD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAY;IACvC,SAAS,CAAC,QAAQ,CAAC,OAAO,+BAA+B;IACzD,SAAS,CAAC,QAAQ,CAAC,UAAU,mBAAmB;gBAEpC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;CAS7C"}

package/dist/lib/providers/registry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Provider registry — resolves API keys, manages fallback chain,
+ * health checks. Works with zero config (just needs one env var set).
+ * Default: Anthropic Haiku → Cerebras → OpenAI.
+ */
+import { type AutoMemoryConfig, type LLMProvider, type ProviderName } from "./base.js";
+declare class ProviderRegistry {
+    private config;
+    private _instances;
+    /** Update runtime config without restart */
+    configure(partial: Partial<AutoMemoryConfig>): void;
+    getConfig(): Readonly<AutoMemoryConfig>;
+    /** Get primary provider, or null if no API key available */
+    getPrimary(): LLMProvider | null;
+    /** Get fallback chain — all available providers excluding primary */
+    getFallbacks(): LLMProvider[];
+    /**
+     * Get the best available provider.
+     * Returns primary if available, otherwise first available fallback.
+     * Returns null only if no providers have API keys configured.
+     */
+    getAvailable(): LLMProvider | null;
+    /**
+     * Get a specific provider by name.
+     * Returns null if no API key is configured for that provider.
+     */
+    getProvider(name: ProviderName): LLMProvider | null;
+    /** Check which providers have API keys configured */
+    health(): Record<ProviderName, {
+        available: boolean;
+        model: string;
+    }>;
+    private createProvider;
+}
+/** Singleton registry — shared across the whole process */
+export declare const providerRegistry: ProviderRegistry;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,WAAW,CAAC;AAInB,cAAM,gBAAgB;IACpB,OAAO,CAAC,MAAM,CAAuD;IACrE,OAAO,CAAC,UAAU,CAAwC;IAE1D,4CAA4C;IAC5C,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAMnD,SAAS,IAAI,QAAQ,CAAC,gBAAgB,CAAC;IAIvC,4DAA4D;IAC5D,UAAU,IAAI,WAAW,GAAG,IAAI;IAIhC,qEAAqE;IACrE,YAAY,IAAI,WAAW,EAAE;IAQ7B;;;;OAIG;IACH,YAAY,IAAI,WAAW,GAAG,IAAI;IAOlC;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,IAAI;IAcnD,qDAAqD;IACrD,MAAM,IAAI,MAAM,CAAC,YAAY,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAarE,OAAO,CAAC,cAAc;CAiBvB;AAED,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/lib/quality.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Memory quality auto-scoring.
+ * Heuristic scoring based on specificity, actionability, freshness, consistency.
+ */
+import type { Memory } from "../types/index.js";
+export interface QualityScore {
+    total: number;
+    specificity: number;
+    actionability: number;
+    freshness: number;
+}
+/**
+ * Compute a quality score for a memory.
+ */
+export declare function computeQualityScore(memory: Memory): QualityScore;
+//# sourceMappingURL=quality.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/lib/quality.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAQD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAwBhE"}

package/dist/lib/redact.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Detect and redact secrets from text.
+ * Returns the text with secrets replaced by [REDACTED].
+ */
+export declare function redactSecrets(text: string): string;
+/**
+ * Check if text contains any detectable secrets.
+ */
+export declare function containsSecrets(text: string): boolean;
+//# sourceMappingURL=redact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/lib/redact.ts"],"names":[],"mappings":"AAsCA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrD"}

package/dist/lib/reflection.d.ts

@@ -0,0 +1,83 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { Memory } from "../types/index.js";
+export declare const DEFAULT_REFLECTION_PROVIDER = "anthropic";
+export declare const DEFAULT_REFLECTION_MODEL = "claude-fable-5";
+export type ReflectionTarget = "session" | "task" | "range";
+export type ReflectionLessonKind = "worked" | "failed" | "do_differently";
+export interface ReflectionLessonInput {
+    lesson: string;
+    evidence?: string[];
+    importance?: number;
+}
+export interface ReflectionCriticResult {
+    summary: string;
+    whatWorked: ReflectionLessonInput[];
+    whatFailed: ReflectionLessonInput[];
+    doDifferently: ReflectionLessonInput[];
+}
+export interface ReflectionTrajectory {
+    on: ReflectionTarget;
+    source?: string;
+    since?: string;
+    until?: string;
+    memories: Memory[];
+    toolEvents: Array<Record<string, unknown>>;
+    text: string;
+}
+export type ReflectionCritic = (trajectory: ReflectionTrajectory) => Promise<ReflectionCriticResult>;
+export interface ReflectionRun {
+    id: string;
+    on_type: ReflectionTarget;
+    source: string | null;
+    project_id: string | null;
+    agent_id: string | null;
+    dry_run: boolean;
+    provider: string | null;
+    model: string | null;
+    status: "pending" | "running" | "completed" | "failed";
+    trajectory_memory_ids: string[];
+    summary: string | null;
+    error: string | null;
+    started_at: string;
+    completed_at: string | null;
+}
+export interface ReflectionLesson {
+    kind: ReflectionLessonKind;
+    lesson: string;
+    evidence: string[];
+    importance: number;
+    memory_id: string | null;
+}
+export interface ReflectionOptions {
+    on: ReflectionTarget;
+    source?: string;
+    dryRun?: boolean;
+    projectId?: string;
+    agentId?: string;
+    since?: string;
+    until?: string;
+    provider?: string;
+    model?: string;
+    maxTokens?: number;
+    critic?: ReflectionCritic;
+    db?: Database;
+}
+export interface ReflectionResult {
+    run: ReflectionRun;
+    dryRun: boolean;
+    trajectory: {
+        memoryIds: string[];
+        toolEventCount: number;
+        text: string;
+    };
+    lessons: ReflectionLesson[];
+    createdMemories: Memory[];
+}
+export declare function heuristicReflectionCritic(trajectory: ReflectionTrajectory): ReflectionCriticResult;
+export declare function createAISDKReflectionCritic(options?: {
+    provider?: string;
+    model?: string;
+    maxTokens?: number;
+}): ReflectionCritic;
+export declare function reflectOnTrajectory(options: ReflectionOptions): Promise<ReflectionResult>;
+//# sourceMappingURL=reflection.d.ts.map

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

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

package/dist/lib/remote-sync.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Remote sync — push/pull memories to/from a remote mementos-serve instance.
+ *
+ * The remote must be running `mementos-serve`. Point at it via:
+ *   MEMENTOS_REMOTE_URL=http://apple01:19428
+ * or pass the URL directly to push/pull functions.
+ */
+declare const DEFAULT_PORT = 19428;
+export interface RemoteSyncOptions {
+    remoteUrl?: string;
+    scope?: "global" | "shared" | "private" | "working";
+    agentId?: string;
+    projectId?: string;
+    since?: string;
+    limit?: number;
+    overwrite?: boolean;
+}
+export interface RemoteSyncResult {
+    pushed?: number;
+    pulled?: number;
+    errors: string[];
+    remote_url: string;
+}
+/**
+ * Push local memories to a remote mementos-serve instance.
+ * Uses POST /api/memories/import on the remote.
+ */
+export declare function pushToRemote(opts?: RemoteSyncOptions): Promise<RemoteSyncResult>;
+/**
+ * Pull memories from a remote mementos-serve instance into local DB.
+ * Uses POST /api/memories/export on the remote.
+ */
+export declare function pullFromRemote(opts?: RemoteSyncOptions): Promise<RemoteSyncResult>;
+/**
+ * Bidirectional sync: push local then pull remote.
+ * On key conflict, newer timestamp wins.
+ */
+export declare function syncWithRemote(opts?: RemoteSyncOptions): Promise<RemoteSyncResult>;
+/**
+ * Check if a remote mementos-serve is reachable.
+ */
+export declare function pingRemote(url?: string): Promise<{
+    ok: boolean;
+    url: string;
+    status?: number;
+    error?: string;
+}>;
+export { DEFAULT_PORT };
+//# sourceMappingURL=remote-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote-sync.d.ts","sourceRoot":"","sources":["../../src/lib/remote-sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,QAAA,MAAM,YAAY,QAAQ,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAqBD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4B1F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyB5F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU5F;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAUrH;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/lib/retention.d.ts

@@ -0,0 +1,17 @@
+import type { SqliteAdapter as Database } from "../storage.js";
+import type { MementosConfig } from "../types/index.js";
+export declare function enforceQuotas(config: MementosConfig, db?: Database): number;
+export declare function archiveStale(staleDays: number, db?: Database): number;
+export declare function archiveUnused(days: number, db?: Database): number;
+export declare function deprioritizeStale(days: number, db?: Database): number;
+export declare function runCleanup(config: MementosConfig, db?: Database): {
+    expired: number;
+    evicted: number;
+    archived: number;
+    unused_archived: number;
+    deprioritized: number;
+};
+export declare function enforceMemoryBounds(projectId?: string, db?: Database): {
+    archived: number;
+};
+//# sourceMappingURL=retention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/lib/retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAUrE,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CA0C3E;AAMD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAwBrE;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAoBjE;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CA2BrE;AAMD,wBAAgB,UAAU,CACxB,MAAM,EAAE,cAAc,EACtB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAgBxG;AAOD,wBAAgB,mBAAmB,CACjC,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAuEtB"}

package/dist/lib/search.d.ts

@@ -0,0 +1,52 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { Memory, MemoryFilter, MemorySearchResult } from "../types/index.js";
+/**
+ * Search memories by query string with relevance scoring.
+ *
+ * Uses FTS5 full-text search when available, falling back to LIKE queries.
+ * Searches across key, value, summary, and tags. Results are scored,
+ * weighted by importance, filtered, and sorted by score DESC then
+ * importance DESC.
+ */
+export declare function searchMemories(query: string, filter?: MemoryFilter, db?: Database): MemorySearchResult[];
+/**
+ * Search memories using FTS5 BM25 ranking explicitly.
+ * Returns results ranked by BM25 score (key weight 10, value weight 5, summary weight 3).
+ */
+export declare function searchWithBm25(query: string, filter?: MemoryFilter, db?: Database): MemorySearchResult[];
+export interface HybridSearchResult {
+    memory: Memory;
+    score: number;
+    keyword_rank: number | null;
+    semantic_rank: number | null;
+    match_type: MemorySearchResult["match_type"];
+    highlights?: {
+        field: string;
+        snippet: string;
+    }[];
+}
+/**
+ * Hybrid search: runs keyword search (FTS5+fuzzy) and semantic search in parallel,
+ * then fuses results using Reciprocal Rank Fusion (RRF).
+ *
+ * This combines the precision of keyword matching with the recall of semantic similarity.
+ */
+export declare function hybridSearch(query: string, options?: {
+    filter?: MemoryFilter;
+    semantic_threshold?: number;
+    semantic_weight?: number;
+    keyword_weight?: number;
+    limit?: number;
+    k?: number;
+}, db?: Database): Promise<HybridSearchResult[]>;
+export declare function logSearchQuery(query: string, resultCount: number, agentId?: string, projectId?: string, db?: Database): void;
+export declare function getSearchHistory(limit?: number, projectId?: string, db?: Database): {
+    query: string;
+    result_count: number;
+    created_at: string;
+}[];
+export declare function getPopularSearches(limit?: number, projectId?: string, db?: Database): {
+    query: string;
+    count: number;
+}[];
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AA+nBlF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,YAAY,EACrB,EAAE,CAAC,EAAE,QAAQ,GACZ,kBAAkB,EAAE,CAiEtB;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,YAAY,EACrB,EAAE,CAAC,EAAE,QAAQ,GACZ,kBAAkB,EAAE,CAwDtB;AAMD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnD;AAgBD;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;CACP,EACN,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAiE/B;AAMD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,CAWN;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,MAAW,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,CAU/D;AAED,wBAAgB,kBAAkB,CAChC,KAAK,GAAE,MAAW,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAUpC"}

package/dist/lib/session-auto-resolve.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Auto-resolve agent_id and project_id from session metadata.
+ * When a session is ingested without explicit agent/project context,
+ * try to detect them from available metadata fields.
+ */
+import type { SqliteAdapter as Database } from "../storage.js";
+export interface AutoResolveResult {
+    agentId: string | null;
+    projectId: string | null;
+    confidence: "high" | "low" | "none";
+    method: string;
+}
+/**
+ * Attempt to resolve agent_id and project_id from metadata fields.
+ *
+ * Strategy:
+ * 1. If metadata.agentName matches an existing agent → agentId = agent.id, confidence=high
+ * 2. If metadata.workingDir matches a registered project path → projectId = project.id, confidence=high
+ * 3. If metadata.gitRemote contains a repo name that matches a project name → confidence=low
+ * 4. Otherwise confidence=none
+ */
+export declare function autoResolveAgentProject(metadata: {
+    workingDir?: string;
+    agentName?: string;
+    gitRemote?: string;
+    sessionSource?: string;
+}, db?: Database): AutoResolveResult;
+//# sourceMappingURL=session-auto-resolve.d.ts.map

package/dist/lib/session-auto-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-auto-resolve.d.ts","sourceRoot":"","sources":["../../src/lib/session-auto-resolve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQ/D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,EACD,EAAE,CAAC,EAAE,QAAQ,GACZ,iBAAiB,CAsFnB"}

package/dist/lib/session-processor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Session transcript processor.
+ * Takes a full session transcript, chunks it, calls LLM to extract memories,
+ * saves extracted memories tagged with session_id + source.
+ * All failures are silently caught — never throws.
+ */
+import type { SqliteAdapter as Database } from "../storage.js";
+export interface ChunkResult {
+    chunkIndex: number;
+    memoriesExtracted: number;
+}
+export interface ProcessingResult {
+    jobId: string;
+    chunksProcessed: number;
+    memoriesExtracted: number;
+    errors: string[];
+}
+/**
+ * Split a transcript into chunks with overlap.
+ */
+export declare function chunkTranscript(transcript: string, chunkSize?: number, overlap?: number): string[];
+/**
+ * Extract memories from a single chunk using the available LLM provider.
+ * Returns the count of memories saved.
+ */
+export declare function extractMemoriesFromChunk(chunk: string, context: {
+    sessionId: string;
+    agentId?: string;
+    projectId?: string;
+    source?: string;
+}, db?: Database): Promise<number>;
+/**
+ * Process a session memory job end-to-end.
+ * Fetches the job, marks it processing, chunks transcript, extracts memories.
+ * Updates job status to completed or failed.
+ */
+export declare function processSessionJob(jobId: string, db?: Database): Promise<ProcessingResult>;
+//# sourceMappingURL=session-processor.d.ts.map

package/dist/lib/session-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-processor.d.ts","sourceRoot":"","sources":["../../src/lib/session-processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAe/D,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAaD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,SAAS,SAAO,EAChB,OAAO,SAAM,GACZ,MAAM,EAAE,CAeV;AAMD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,MAAM,CAAC,CAyHjB;AAMD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,gBAAgB,CAAC,CAqH3B"}

package/dist/lib/session-queue.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Background queue for session memory job processing.
+ * Polls for pending jobs every 5 seconds, processes one at a time (concurrency=1).
+ * Fire-and-forget: enqueueSessionJob() returns immediately, processing happens async.
+ */
+export interface SessionQueueStats {
+    pending: number;
+    processing: number;
+    completed: number;
+    failed: number;
+}
+/**
+ * Enqueue a job ID for processing. Fire-and-forget.
+ * The background worker will pick it up within the next polling interval.
+ */
+export declare function enqueueSessionJob(jobId: string): void;
+/**
+ * Get in-memory queue stats.
+ * Note: pending/completed/failed counts come from DB when a full scan is needed;
+ * this returns a lightweight in-memory snapshot.
+ */
+export declare function getSessionQueueStats(): SessionQueueStats;
+/**
+ * Start the background polling worker.
+ * Idempotent — safe to call multiple times (only starts once).
+ */
+export declare function startSessionQueueWorker(): void;
+//# sourceMappingURL=session-queue.d.ts.map

package/dist/lib/session-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-queue.d.ts","sourceRoot":"","sources":["../../src/lib/session-queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAeD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CA6BxD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAQ9C"}

package/dist/lib/session-registry.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Session Registry — shared registry of active Claude Code sessions.
+ * Designed to be reusable across the open-* ecosystem (mementos, todos, conversations).
+ *
+ * Uses a shared SQLite DB at ~/.open-sessions-registry.db.
+ * Each MCP server registers on connect, heartbeats, and can query peers.
+ * PID identifies the Claude Code process — all MCPs in same session share a PID.
+ */
+export interface SessionInfo {
+    id: string;
+    pid: number;
+    cwd: string;
+    git_root: string | null;
+    agent_name: string | null;
+    project_name: string | null;
+    tty: string | null;
+    mcp_server: string;
+    metadata: Record<string, unknown>;
+    registered_at: string;
+    last_seen_at: string;
+}
+export interface SessionFilter {
+    project_name?: string;
+    git_root?: string;
+    mcp_server?: string;
+    agent_name?: string;
+    exclude_pid?: number;
+}
+export declare function registerSession(opts: {
+    mcp_server: string;
+    agent_name?: string;
+    project_name?: string;
+    cwd?: string;
+    git_root?: string;
+    tty?: string;
+    metadata?: Record<string, unknown>;
+}): SessionInfo;
+export declare function heartbeatSession(id: string): void;
+export declare function unregisterSession(id: string): void;
+export declare function getSession(id: string): SessionInfo | null;
+export declare function listSessions(filter?: SessionFilter): SessionInfo[];
+export declare function getSessionByAgent(agentName: string): SessionInfo | null;
+export declare function getSessionsByProject(projectName: string): SessionInfo[];
+export declare function cleanStaleSessions(): number;
+export declare function updateSessionAgent(mcpServer: string, agentName: string): void;
+export declare function closeRegistry(): void;
+//# sourceMappingURL=session-registry.d.ts.map

package/dist/lib/session-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.d.ts","sourceRoot":"","sources":["../../src/lib/session-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAwFD,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,WAAW,CA8Cd;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGjD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAIzD;AAED,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,WAAW,EAAE,CAsClE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGvE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAEvE;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAW3C;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAO7E;AAMD,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}

package/dist/lib/session-start-briefing.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Session Start Briefing — pushes a project memory briefing when a new session begins.
+ * Includes: synthesized profile, top memories, last session summary, flagged items.
+ */
+export declare function pushSessionBriefing(options: {
+    project_id?: string;
+    project_name?: string;
+    agent_id?: string;
+}): Promise<boolean>;
+//# sourceMappingURL=session-start-briefing.d.ts.map

package/dist/lib/session-start-briefing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start-briefing.d.ts","sourceRoot":"","sources":["../../src/lib/session-start-briefing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CA2FnB"}

package/dist/lib/session-watcher.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Session Watcher — watches the active Claude Code session JSONL file
+ * for new messages. Enables proactive memory injection by detecting
+ * what the agent is working on in real-time.
+ */
+export interface SessionMessage {
+    role: "user" | "assistant" | "tool";
+    content: string | {
+        type: string;
+        text?: string;
+        name?: string;
+        input?: Record<string, unknown>;
+    }[];
+    tool_use?: {
+        name: string;
+        input: Record<string, unknown>;
+    }[];
+    timestamp: string;
+}
+export type MessageCallback = (message: SessionMessage) => void;
+export declare function startSessionWatcher(cwd: string, callback: MessageCallback): {
+    sessionFile: string | null;
+};
+export declare function stopSessionWatcher(): void;
+export declare function getWatcherStatus(): {
+    active: boolean;
+    watching_file: string | null;
+    last_offset: number;
+};
+//# sourceMappingURL=session-watcher.d.ts.map

package/dist/lib/session-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-watcher.d.ts","sourceRoot":"","sources":["../../src/lib/session-watcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAC;IACpG,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAC;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AA+EhE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAiC1G;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAYzC;AAED,wBAAgB,gBAAgB,IAAI;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB,CAMA"}

package/dist/lib/storage-sync.d.ts

@@ -0,0 +1,44 @@
+import { type DbAdapter, type SyncMeta } from "../storage.js";
+export interface MemoryStorageSyncMeta {
+    table_name: string;
+    direction: "push" | "pull";
+    last_synced_at: string | null;
+    last_synced_row_count: number;
+}
+export interface MemoryStorageSyncStats {
+    table: string;
+    total_rows: number;
+    synced_rows: number;
+    skipped_rows: number;
+    conflicts: number;
+    errors: string[];
+    first_sync: boolean;
+}
+export interface MementosStorageSyncResult {
+    direction: "push" | "pull";
+    mode: string;
+    current_machine_id: string | null;
+    tables: MemoryStorageSyncStats[];
+    total_synced: number;
+    total_conflicts: number;
+    errors: string[];
+}
+export interface MementosStorageStatus {
+    mode: string;
+    enabled: boolean;
+    db_path: string;
+    current_machine_id: string | null;
+    generic_sync_meta: SyncMeta[];
+    memory_sync_meta: MemoryStorageSyncMeta[];
+}
+interface RunStorageSyncOptions {
+    tables?: string[];
+    local?: DbAdapter;
+    remote?: DbAdapter;
+    current_machine_id?: string | null;
+}
+export declare function pushStorageChanges(options?: RunStorageSyncOptions): MementosStorageSyncResult;
+export declare function pullStorageChanges(options?: RunStorageSyncOptions): MementosStorageSyncResult;
+export declare function getStorageSyncStatus(options?: Pick<RunStorageSyncOptions, "local" | "current_machine_id">): MementosStorageStatus;
+export {};
+//# sourceMappingURL=storage-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-sync.d.ts","sourceRoot":"","sources":["../../src/lib/storage-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,QAAQ,EAYd,MAAM,eAAe,CAAC;AAgBvB,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,QAAQ,EAAE,CAAC;IAC9B,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;CAC3C;AAED,UAAU,qBAAqB;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AA8lBD,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,qBAA0B,GAClC,yBAAyB,CAE3B;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,qBAA0B,GAClC,yBAAyB,CAE3B;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,oBAAoB,CAAM,GACxE,qBAAqB,CAoBvB"}

package/dist/lib/sync.d.ts

@@ -0,0 +1,10 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { ConflictResolution, SyncDirection, SyncResult } from "../types/index.js";
+export declare function syncMemories(agentName: string, direction?: SyncDirection, options?: {
+    agent_id?: string;
+    project_id?: string;
+    conflict_resolution?: ConflictResolution;
+    db?: Database;
+}): SyncResult;
+export declare const defaultSyncAgents: string[];
+//# sourceMappingURL=sync.d.ts.map