@hasna/mementos 0.8.0 → 0.10.0

package/dist/db/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmCtC,wBAAgB,SAAS,IAAI,MAAM,CAkBlC;AA4WD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAerD;AA+BD,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAef"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmCtC,wBAAgB,SAAS,IAAI,MAAM,CAkBlC;AAsYD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAerD;AA+BD,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAef"}

package/dist/db/session-jobs.d.ts

@@ -0,0 +1,49 @@
+import { Database } from "bun:sqlite";
+export type SessionJobSource = "claude-code" | "codex" | "manual" | "open-sessions";
+export type SessionJobStatus = "pending" | "processing" | "completed" | "failed";
+export interface SessionMemoryJob {
+    id: string;
+    session_id: string;
+    agent_id: string | null;
+    project_id: string | null;
+    source: SessionJobSource;
+    status: SessionJobStatus;
+    transcript: string;
+    chunk_count: number;
+    memories_extracted: number;
+    error: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    started_at: string | null;
+    completed_at: string | null;
+}
+export interface CreateSessionJobInput {
+    session_id: string;
+    transcript: string;
+    source?: SessionJobSource;
+    agent_id?: string;
+    project_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface SessionJobFilter {
+    agent_id?: string;
+    project_id?: string;
+    status?: SessionJobStatus;
+    session_id?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface UpdateSessionJobInput {
+    status?: SessionJobStatus;
+    chunk_count?: number;
+    memories_extracted?: number;
+    error?: string | null;
+    started_at?: string | null;
+    completed_at?: string | null;
+}
+export declare function createSessionJob(input: CreateSessionJobInput, db?: Database): SessionMemoryJob;
+export declare function getSessionJob(id: string, db?: Database): SessionMemoryJob | null;
+export declare function listSessionJobs(filter?: SessionJobFilter, db?: Database): SessionMemoryJob[];
+export declare function updateSessionJob(id: string, updates: UpdateSessionJobInput, db?: Database): SessionMemoryJob | null;
+export declare function getNextPendingJob(db?: Database): SessionMemoryJob | null;
+//# sourceMappingURL=session-jobs.d.ts.map

package/dist/db/session-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-jobs.d.ts","sourceRoot":"","sources":["../../src/db/session-jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAyB,MAAM,YAAY,CAAC;AAG7D,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,eAAe,CAAC;AACpF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AA6BD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,EAC5B,EAAE,CAAC,EAAE,QAAQ,GACZ,gBAAgB,CAwBlB;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,gBAAgB,GAAG,IAAI,CAOhF;AAED,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,gBAAgB,EACzB,EAAE,CAAC,EAAE,QAAQ,GACZ,gBAAgB,EAAE,CAiCpB;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,qBAAqB,EAC9B,EAAE,CAAC,EAAE,QAAQ,GACZ,gBAAgB,GAAG,IAAI,CAwCzB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,gBAAgB,GAAG,IAAI,CASxE"}

package/dist/index.js

@@ -434,7 +434,30 @@ var MIGRATIONS = [
   CREATE INDEX IF NOT EXISTS idx_webhook_hooks_type ON webhook_hooks(type);
   CREATE INDEX IF NOT EXISTS idx_webhook_hooks_enabled ON webhook_hooks(enabled);
   INSERT OR IGNORE INTO _migrations (id) VALUES (10);
+  `,
   `
+CREATE TABLE IF NOT EXISTS session_memory_jobs (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  agent_id TEXT,
+  project_id TEXT,
+  source TEXT NOT NULL DEFAULT 'manual' CHECK(source IN ('claude-code','codex','manual','open-sessions')),
+  status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending','processing','completed','failed')),
+  transcript TEXT NOT NULL,
+  chunk_count INTEGER NOT NULL DEFAULT 0,
+  memories_extracted INTEGER NOT NULL DEFAULT 0,
+  error TEXT,
+  metadata TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  started_at TEXT,
+  completed_at TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_status ON session_memory_jobs(status);
+CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_agent ON session_memory_jobs(agent_id);
+CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_project ON session_memory_jobs(project_id);
+CREATE INDEX IF NOT EXISTS idx_session_memory_jobs_session ON session_memory_jobs(session_id);
+INSERT OR IGNORE INTO _migrations (id) VALUES (13);
+`
 ];
 var _db = null;
 function getDatabase(dbPath) {

package/dist/lib/open-sessions-connector.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Open-sessions connector — bridge between open-sessions REST API and mementos.
+ *
+ * When open-sessions ingests a new session, this connector fetches the session
+ * transcript and submits it to mementos for memory extraction.
+ *
+ * Usage:
+ *   const connector = new OpenSessionsConnector({ openSessionsUrl, mementosUrl });
+ *   await connector.ingestSession(sessionId, { agentId, projectId });
+ *   await connector.syncRecentSessions({ since: "2026-03-17", limit: 10 });
+ */
+export interface OpenSessionsConnectorConfig {
+    /** open-sessions REST API base URL */
+    openSessionsUrl: string;
+    /** mementos REST API base URL */
+    mementosUrl: string;
+    /** Optional auth token for open-sessions */
+    openSessionsToken?: string;
+    /** Default agent ID for extracted memories */
+    defaultAgentId?: string;
+    /** Default project ID for extracted memories */
+    defaultProjectId?: string;
+}
+export interface IngestResult {
+    sessionId: string;
+    jobId: string;
+    status: "queued" | "skipped" | "error";
+    message: string;
+}
+export declare class OpenSessionsConnector {
+    private config;
+    constructor(config: OpenSessionsConnectorConfig);
+    /**
+     * Fetch a session transcript from open-sessions and ingest into mementos.
+     */
+    ingestSession(sessionId: string, options?: {
+        agentId?: string;
+        projectId?: string;
+    }): Promise<IngestResult>;
+    /**
+     * Fetch and ingest multiple recent sessions.
+     */
+    syncRecentSessions(options?: {
+        since?: string;
+        limit?: number;
+        agentId?: string;
+        projectId?: string;
+    }): Promise<IngestResult[]>;
+    private fetchSessionTranscript;
+    private listRecentSessionIds;
+}
+/**
+ * Create a connector from environment variables.
+ *
+ * OPEN_SESSIONS_URL — open-sessions server URL
+ * OPEN_SESSIONS_TOKEN — optional auth token
+ * MEMENTOS_URL — mementos server URL (default: http://localhost:19428)
+ */
+export declare function connectorFromEnv(): OpenSessionsConnector;
+//# sourceMappingURL=open-sessions-connector.d.ts.map

package/dist/lib/open-sessions-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-sessions-connector.d.ts","sourceRoot":"","sources":["../../src/lib/open-sessions-connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,2BAA2B;IAC1C,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA8B;gBAEhC,MAAM,EAAE,2BAA2B;IAI/C;;OAEG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACrD,OAAO,CAAC,YAAY,CAAC;IAwCxB;;OAEG;IACG,kBAAkB,CAAC,OAAO,GAAE;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAelB,sBAAsB;YAiBtB,oBAAoB;CAqBnC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAWxD"}

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 { Database } from "bun:sqlite";
+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,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C,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 { Database } from "bun:sqlite";
+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,QAAQ,EAAE,MAAM,YAAY,CAAC;AAa3C,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,CA+F3B"}

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"}