@framers/agentos 0.1.200 → 0.1.202

package/dist/memory/archive/SqlStorageMemoryArchive.js

@@ -0,0 +1,243 @@
+/**
+ * @fileoverview Default IMemoryArchive implementation backed by StorageAdapter.
+ *
+ * Uses the same `@framers/sql-storage-adapter` contract as `SqliteBrain`,
+ * `GraphRAGEngine`, and every other agentos persistence layer. Supports all
+ * sql-storage-adapter backends: better-sqlite3, sql.js, IndexedDB, Capacitor
+ * SQLite, and PostgreSQL.
+ *
+ * Two usage modes:
+ * 1. **Shared adapter** — pass the brain's `StorageAdapter`. Archive tables
+ *    live in the same database. Soul exports bundle one file.
+ * 2. **Standalone adapter** — pass a separate adapter. Archive tables live
+ *    in their own database or schema.
+ *
+ * @module agentos/memory/archive/SqlStorageMemoryArchive
+ * @see {@link IMemoryArchive} for the contract definition.
+ * @see {@link ../../retrieval/store/SqliteBrain} for the shared-adapter pattern.
+ */
+import { sha256 } from '../core/util/crossPlatformCrypto.js';
+// ---------------------------------------------------------------------------
+// DDL — exported for SqliteBrain to include in _initSchema()
+// ---------------------------------------------------------------------------
+/**
+ * DDL for the archived_traces table.
+ * @internal
+ */
+export const DDL_ARCHIVED_TRACES = `
+CREATE TABLE IF NOT EXISTS archived_traces (
+  trace_id         TEXT    PRIMARY KEY,
+  agent_id         TEXT    NOT NULL,
+  verbatim_content TEXT    NOT NULL,
+  content_hash     TEXT    NOT NULL,
+  trace_type       TEXT    NOT NULL,
+  emotional_context TEXT   NOT NULL DEFAULT '{}',
+  entities         TEXT    NOT NULL DEFAULT '[]',
+  tags             TEXT    NOT NULL DEFAULT '[]',
+  created_at       INTEGER NOT NULL,
+  archived_at      INTEGER NOT NULL,
+  archive_reason   TEXT    NOT NULL,
+  byte_size        INTEGER NOT NULL DEFAULT 0
+);
+`;
+/**
+ * Index on agent_id + archived_at for retention sweeps.
+ * @internal
+ */
+export const DDL_ARCHIVED_TRACES_IDX_AGENT_TIME = `
+CREATE INDEX IF NOT EXISTS idx_archived_traces_agent_time
+  ON archived_traces (agent_id, archived_at);
+`;
+/**
+ * Index on archive_reason for analytics queries.
+ * @internal
+ */
+export const DDL_ARCHIVED_TRACES_IDX_REASON = `
+CREATE INDEX IF NOT EXISTS idx_archived_traces_reason
+  ON archived_traces (archive_reason);
+`;
+/**
+ * DDL for the archive_access_log table (rehydration tracking).
+ * @internal
+ */
+export const DDL_ARCHIVE_ACCESS_LOG = `
+CREATE TABLE IF NOT EXISTS archive_access_log (
+  trace_id        TEXT    NOT NULL,
+  accessed_at     INTEGER NOT NULL,
+  request_context TEXT,
+  PRIMARY KEY (trace_id, accessed_at)
+);
+`;
+/**
+ * Index for recency queries on the access log.
+ * @internal
+ */
+export const DDL_ARCHIVE_ACCESS_LOG_IDX = `
+CREATE INDEX IF NOT EXISTS idx_archive_access_recency
+  ON archive_access_log (trace_id, accessed_at DESC);
+`;
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * Default `IMemoryArchive` implementation using `@framers/sql-storage-adapter`.
+ *
+ * @example Shared adapter with SqliteBrain
+ * ```ts
+ * const brain = await SqliteBrain.open('/path/to/brain.sqlite');
+ * const archive = new SqlStorageMemoryArchive(brain.adapter, brain.features);
+ * await archive.initialize();
+ * ```
+ *
+ * @example Standalone Postgres adapter
+ * ```ts
+ * const pgAdapter = await resolveStorageAdapter({
+ *   postgres: { connectionString: process.env.DATABASE_URL },
+ * });
+ * const features = createStorageFeatures(pgAdapter);
+ * const archive = new SqlStorageMemoryArchive(pgAdapter, features);
+ * await archive.initialize();
+ * ```
+ */
+export class SqlStorageMemoryArchive {
+    /**
+     * Create an archive backed by the given storage adapter.
+     *
+     * @param adapter - An initialized `StorageAdapter` instance. Can be shared
+     *   with `SqliteBrain` (same DB) or standalone (own DB).
+     * @param features - Platform-aware feature bundle for dialect-portable SQL.
+     */
+    constructor(adapter, features) {
+        this.adapter = adapter;
+        this.features = features;
+    }
+    /**
+     * Create the `archived_traces` and `archive_access_log` tables.
+     * Uses `CREATE TABLE/INDEX IF NOT EXISTS` — safe to call repeatedly.
+     */
+    async initialize() {
+        await this.adapter.exec(DDL_ARCHIVED_TRACES);
+        await this.adapter.exec(DDL_ARCHIVED_TRACES_IDX_AGENT_TIME);
+        await this.adapter.exec(DDL_ARCHIVED_TRACES_IDX_REASON);
+        await this.adapter.exec(DDL_ARCHIVE_ACCESS_LOG);
+        await this.adapter.exec(DDL_ARCHIVE_ACCESS_LOG_IDX);
+    }
+    /**
+     * Persist the verbatim trace content and identifying metadata.
+     *
+     * Idempotent: a second `store()` call with the same `traceId` is a no-op
+     * and returns `{ success: true, bytesWritten: 0 }`.
+     *
+     * @param trace - The archived trace record to persist.
+     * @returns Write result with success flag and bytes written.
+     */
+    async store(trace) {
+        // Idempotent: skip if already stored
+        const existing = await this.adapter.get('SELECT trace_id FROM archived_traces WHERE trace_id = ?', [trace.traceId]);
+        if (existing) {
+            return { success: true, traceId: trace.traceId, bytesWritten: 0 };
+        }
+        const byteSize = new TextEncoder().encode(trace.verbatimContent).byteLength;
+        await this.adapter.run(`INSERT INTO archived_traces
+        (trace_id, agent_id, verbatim_content, content_hash, trace_type,
+         emotional_context, entities, tags, created_at, archived_at,
+         archive_reason, byte_size)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            trace.traceId,
+            trace.agentId,
+            trace.verbatimContent,
+            trace.contentHash,
+            trace.traceType,
+            JSON.stringify(trace.emotionalContext),
+            JSON.stringify(trace.entities),
+            JSON.stringify(trace.tags),
+            trace.createdAt,
+            trace.archivedAt,
+            trace.archiveReason,
+            byteSize,
+        ]);
+        return { success: true, traceId: trace.traceId, bytesWritten: byteSize };
+    }
+    /**
+     * Return the verbatim content for a trace id, or `null` if not archived.
+     *
+     * Verifies content integrity via SHA-256 hash comparison. Returns `null`
+     * (rather than throwing) on hash mismatch. Writes a row to the access log
+     * on successful rehydration.
+     *
+     * @param traceId - The trace id to rehydrate.
+     * @param requestContext - Optional caller hint for audit.
+     * @returns The rehydrated trace data, or `null`.
+     */
+    async rehydrate(traceId, requestContext) {
+        const row = await this.adapter.get('SELECT verbatim_content, content_hash, archived_at, archive_reason FROM archived_traces WHERE trace_id = ?', [traceId]);
+        if (!row)
+            return null;
+        // Integrity check: verify hash matches stored content
+        const computedHash = await sha256(row.verbatim_content);
+        if (computedHash !== row.content_hash) {
+            return null;
+        }
+        // Write access log entry for retention awareness
+        await this.adapter.run('INSERT INTO archive_access_log (trace_id, accessed_at, request_context) VALUES (?, ?, ?)', [traceId, Date.now(), requestContext ?? null]);
+        return {
+            traceId,
+            verbatimContent: row.verbatim_content,
+            contentHash: row.content_hash,
+            archivedAt: row.archived_at,
+            archiveReason: row.archive_reason,
+        };
+    }
+    /**
+     * Remove archived content and its access log entries for a trace id.
+     * No-op if the trace id is not found.
+     *
+     * @param traceId - The trace id to remove from the archive.
+     */
+    async drop(traceId) {
+        await this.adapter.run('DELETE FROM archived_traces WHERE trace_id = ?', [traceId]);
+        await this.adapter.run('DELETE FROM archive_access_log WHERE trace_id = ?', [traceId]);
+    }
+    /**
+     * Return archived trace metadata matching optional filters.
+     *
+     * @param options - Optional filters for agent, age, and result limit.
+     * @returns Array of archive list entries (metadata only, no content).
+     */
+    async list(options) {
+        const conditions = [];
+        const params = [];
+        if (options?.agentId) {
+            conditions.push('agent_id = ?');
+            params.push(options.agentId);
+        }
+        if (options?.olderThanMs) {
+            const cutoff = Date.now() - options.olderThanMs;
+            conditions.push('archived_at < ?');
+            params.push(cutoff);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = options?.limit ? `LIMIT ${options.limit}` : '';
+        const rows = await this.adapter.all(`SELECT trace_id, agent_id, archived_at, archive_reason, byte_size
+       FROM archived_traces ${where}
+       ORDER BY archived_at ASC ${limit}`, params);
+        return rows.map((r) => ({
+            traceId: r.trace_id,
+            agentId: r.agent_id,
+            archivedAt: r.archived_at,
+            archiveReason: r.archive_reason,
+            byteSize: r.byte_size,
+        }));
+    }
+    /**
+     * Return the most recent access timestamp for a trace id.
+     *
+     * @param traceId - The trace id to check.
+     * @returns Unix ms of the most recent rehydration, or `null` if never rehydrated.
+     */
+    async lastAccessedAt(traceId) {
+        const row = await this.adapter.get('SELECT accessed_at FROM archive_access_log WHERE trace_id = ? ORDER BY accessed_at DESC LIMIT 1', [traceId]);
+        return row?.accessed_at ?? null;
+    }
+}
+//# sourceMappingURL=SqlStorageMemoryArchive.js.map

package/dist/memory/archive/SqlStorageMemoryArchive.js.map

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

package/dist/memory/archive/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Memory archive module — cold storage for verbatim memory content.
+ *
+ * @module agentos/memory/archive
+ */
+export type { IMemoryArchive, ArchivedTrace, RehydratedTrace, ArchiveWriteResult, ArchiveListEntry, ArchiveReason, MemoryArchiveRetentionConfig, } from './IMemoryArchive.js';
+export { SqlStorageMemoryArchive } from './SqlStorageMemoryArchive.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/archive/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/archive/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/memory/archive/index.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Memory archive module — cold storage for verbatim memory content.
+ *
+ * @module agentos/memory/archive
+ */
+export { SqlStorageMemoryArchive } from './SqlStorageMemoryArchive.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/archive/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory/archive/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/memory/core/config.d.ts

@@ -224,6 +224,17 @@ export interface CognitiveMemoryConfig {
      * @default undefined (no reranking)
      */
     rerankerService?: import('../../rag/reranking/RerankerService.js').RerankerService;
+    /**
+     * Optional memory archive for write-ahead verbatim preservation.
+     *
+     * When provided, TemporalGist preserves the original content in cold
+     * storage before overwriting with the gist. Enables on-demand rehydration
+     * via `CognitiveMemoryManager.rehydrate()`.
+     *
+     * @default undefined (no archive — gist is destructive)
+     * @see {@link IMemoryArchive} — the archive contract
+     */
+    archive?: import('../archive/IMemoryArchive.js').IMemoryArchive;
 }
 export declare const DEFAULT_ENCODING_CONFIG: EncodingConfig;
 export declare const DEFAULT_DECAY_CONFIG: DecayConfig;

package/dist/memory/core/config.d.ts.map

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

package/dist/memory/core/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/memory/core/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2GH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwE;IACvG,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,GAAG;IAChB,mBAAmB,EAAE,GAAG;IACxB,mBAAmB,EAAE,GAAG;CACzB,CAAC;AAyKF,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,YAAY,EAAE,GAAG;IACjB,kBAAkB,EAAE,GAAG;IACvB,2BAA2B,EAAE,GAAG;IAChC,4BAA4B,EAAE,GAAG;IACjC,eAAe,EAAE,OAAS;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,QAAU;IAC7B,qBAAqB,EAAE,GAAG;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAA2B;IAC/D,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,IAAI;CACvB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/memory/core/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2GH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwE;IACvG,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,GAAG;IAChB,mBAAmB,EAAE,GAAG;IACxB,mBAAmB,EAAE,GAAG;CACzB,CAAC;AAqLF,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,YAAY,EAAE,GAAG;IACjB,kBAAkB,EAAE,GAAG;IACvB,2BAA2B,EAAE,GAAG;IAChC,4BAA4B,EAAE,GAAG;IACjC,eAAe,EAAE,OAAS;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,QAAU;IAC7B,qBAAqB,EAAE,GAAG;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAA2B;IAC/D,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,IAAI;CACvB,CAAC"}

package/dist/memory/io/extension/MemoryToolsExtension.d.ts

@@ -36,6 +36,12 @@ export interface MemoryToolsExtensionOptions {
      * @default '1.0.0'
      */
     version?: string;
+    /**
+     * Include the `rehydrate_memory` tool for inflating gisted/archived traces.
+     * Requires an `IMemoryArchive` to be provided via the archive option.
+     * Defaults to `false`.
+     */
+    includeRehydrate?: boolean;
 }
 /**
  * Convert a standalone `Memory` facade's built-in tool set into extension

package/dist/memory/io/extension/MemoryToolsExtension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryToolsExtension.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/extension/MemoryToolsExtension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAqBD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EACnC,OAAO,CAAC,EAAE,IAAI,CAAC,2BAA2B,EAAE,gBAAgB,GAAG,UAAU,CAAC,GACzE,cAAc,EAAE,CAIlB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EACnC,OAAO,CAAC,EAAE,2BAA2B,GACpC,aAAa,CAMf"}
+{"version":3,"file":"MemoryToolsExtension.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/extension/MemoryToolsExtension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAqBD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EACnC,OAAO,CAAC,EAAE,IAAI,CAAC,2BAA2B,EAAE,gBAAgB,GAAG,UAAU,CAAC,GACzE,cAAc,EAAE,CAIlB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EACnC,OAAO,CAAC,EAAE,2BAA2B,GACpC,aAAa,CAMf"}

package/dist/memory/io/extension/MemoryToolsExtension.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryToolsExtension.js","sourceRoot":"","sources":["../../../../src/memory/io/extension/MemoryToolsExtension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,mBAAmB,GAEpB,MAAM,8BAA8B,CAAC;AAgCtC,SAAS,gBAAgB,CAAC,IAAW,EAAE,QAAiB;IACtD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,IAAI;QACb,IAAI,EAAE,mBAAmB;QACzB,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE;YACR,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,MAAM,EAAE,mBAAmB;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;SACpC;QACD,YAAY,EAAE,KAAK,IAAI,EAAE;YACvB,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACxC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAmC,EACnC,OAA0E;IAE1E,OAAO,MAAM;SACV,WAAW,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;SACxD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAmC,EACnC,OAAqC;IAErC,OAAO;QACL,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,sBAAsB;QAC7C,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO;QACpC,WAAW,EAAE,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC;KAC1D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"MemoryToolsExtension.js","sourceRoot":"","sources":["../../../../src/memory/io/extension/MemoryToolsExtension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,mBAAmB,GAEpB,MAAM,8BAA8B,CAAC;AAuCtC,SAAS,gBAAgB,CAAC,IAAW,EAAE,QAAiB;IACtD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,IAAI;QACb,IAAI,EAAE,mBAAmB;QACzB,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE;YACR,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,MAAM,EAAE,mBAAmB;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;SACpC;QACD,YAAY,EAAE,KAAK,IAAI,EAAE;YACvB,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACxC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAmC,EACnC,OAA0E;IAE1E,OAAO,MAAM;SACV,WAAW,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;SACxD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAmC,EACnC,OAAqC;IAErC,OAAO;QACL,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,sBAAsB;QAC7C,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO;QACpC,WAAW,EAAE,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/memory/io/tools/RehydrateMemoryTool.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview RehydrateMemoryTool — lets an agent inflate a gisted memory trace.
+ *
+ * Exposes `rehydrate_memory` as an opt-in agent tool. When a gisted memory
+ * appears in the assembled context and the summary lacks detail, the LLM can
+ * call this tool to retrieve the original verbatim content from the archive.
+ *
+ * Registration is opt-in: consumers pass `{ includeRehydrate: true }` to the
+ * `MemoryToolsExtension`. The default tool surface is unchanged for agents
+ * that don't adopt the archive.
+ *
+ * @module memory/tools/RehydrateMemoryTool
+ * @see {@link IMemoryArchive} for the underlying archive contract.
+ */
+import type { ITool, ToolExecutionResult, ToolExecutionContext, JSONSchemaObject } from '../../../core/tools/ITool.js';
+import type { IMemoryArchive } from '../../archive/IMemoryArchive.js';
+/**
+ * Input arguments for {@link RehydrateMemoryTool}.
+ *
+ * @property traceId - ID of the trace to rehydrate.
+ */
+export interface RehydrateMemoryInput extends Record<string, any> {
+    traceId: string;
+}
+/**
+ * Output returned by {@link RehydrateMemoryTool}.
+ *
+ * @property verbatimContent - The original verbatim content, or `null` if
+ *   the trace is not archived or integrity verification failed.
+ * @property archivedAt - Unix ms when the trace was archived, or `null`.
+ */
+export interface RehydrateMemoryOutput {
+    verbatimContent: string | null;
+    archivedAt: number | null;
+}
+/**
+ * ITool implementation that retrieves the original verbatim content of a
+ * gisted or archived memory trace from the agent's memory archive.
+ *
+ * **Usage:**
+ * ```ts
+ * const tool = new RehydrateMemoryTool(archive);
+ * const result = await tool.execute({ traceId: 'mt_abc123' }, context);
+ * // result.output.verbatimContent → 'The dragon attacked...' or null
+ * ```
+ */
+export declare class RehydrateMemoryTool implements ITool<RehydrateMemoryInput, RehydrateMemoryOutput> {
+    private readonly archive;
+    /** Globally unique tool identifier. */
+    readonly id = "rehydrate-memory-v1";
+    /** LLM-facing tool name. */
+    readonly name = "rehydrate_memory";
+    /** Human-readable display name. */
+    readonly displayName = "Rehydrate Memory";
+    /** LLM-facing description. */
+    readonly description: string;
+    /** Logical category for discovery and grouping. */
+    readonly category = "memory";
+    /** This tool reads from the archive and writes an access-log entry. */
+    readonly hasSideEffects = true;
+    /** JSON schema for input validation and LLM tool-call construction. */
+    readonly inputSchema: JSONSchemaObject;
+    /**
+     * @param archive - The agent's IMemoryArchive instance.
+     */
+    constructor(archive: IMemoryArchive);
+    /**
+     * Retrieve the original verbatim content for a gisted/archived trace.
+     *
+     * Delegates to `IMemoryArchive.rehydrate()`, which performs integrity
+     * verification and writes an access-log entry. Returns `null` for both
+     * verbatimContent and archivedAt if the trace is not found or integrity
+     * verification fails.
+     *
+     * @param args     - Rehydrate input (traceId).
+     * @param _context - Tool execution context (not used by this tool).
+     * @returns The rehydrated content or nulls, wrapped in ToolExecutionResult.
+     */
+    execute(args: RehydrateMemoryInput, _context: ToolExecutionContext): Promise<ToolExecutionResult<RehydrateMemoryOutput>>;
+}
+//# sourceMappingURL=RehydrateMemoryTool.d.ts.map

package/dist/memory/io/tools/RehydrateMemoryTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RehydrateMemoryTool.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/tools/RehydrateMemoryTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACvH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAMtE;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAMD;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,YAAW,KAAK,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IAoChF,OAAO,CAAC,QAAQ,CAAC,OAAO;IAnCpC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,yBAAyB;IAEpC,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,sBAAsB;IAEnC,mCAAmC;IACnC,QAAQ,CAAC,WAAW,sBAAsB;IAE1C,8BAA8B;IAC9B,QAAQ,CAAC,WAAW,SAEwD;IAE5E,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,YAAY;IAE7B,uEAAuE;IACvE,QAAQ,CAAC,cAAc,QAAQ;IAE/B,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CASpC;IAEF;;OAEG;gBAC0B,OAAO,EAAE,cAAc;IAMpD;;;;;;;;;;;OAWG;IACG,OAAO,CACX,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;CAiBvD"}

package/dist/memory/io/tools/RehydrateMemoryTool.js

@@ -0,0 +1,94 @@
+/**
+ * @fileoverview RehydrateMemoryTool — lets an agent inflate a gisted memory trace.
+ *
+ * Exposes `rehydrate_memory` as an opt-in agent tool. When a gisted memory
+ * appears in the assembled context and the summary lacks detail, the LLM can
+ * call this tool to retrieve the original verbatim content from the archive.
+ *
+ * Registration is opt-in: consumers pass `{ includeRehydrate: true }` to the
+ * `MemoryToolsExtension`. The default tool surface is unchanged for agents
+ * that don't adopt the archive.
+ *
+ * @module memory/tools/RehydrateMemoryTool
+ * @see {@link IMemoryArchive} for the underlying archive contract.
+ */
+// ---------------------------------------------------------------------------
+// RehydrateMemoryTool
+// ---------------------------------------------------------------------------
+/**
+ * ITool implementation that retrieves the original verbatim content of a
+ * gisted or archived memory trace from the agent's memory archive.
+ *
+ * **Usage:**
+ * ```ts
+ * const tool = new RehydrateMemoryTool(archive);
+ * const result = await tool.execute({ traceId: 'mt_abc123' }, context);
+ * // result.output.verbatimContent → 'The dragon attacked...' or null
+ * ```
+ */
+export class RehydrateMemoryTool {
+    /**
+     * @param archive - The agent's IMemoryArchive instance.
+     */
+    constructor(archive) {
+        this.archive = archive;
+        /** Globally unique tool identifier. */
+        this.id = 'rehydrate-memory-v1';
+        /** LLM-facing tool name. */
+        this.name = 'rehydrate_memory';
+        /** Human-readable display name. */
+        this.displayName = 'Rehydrate Memory';
+        /** LLM-facing description. */
+        this.description = "Look up the full original content of a memory whose summary you've seen. " +
+            'Use this when a gisted memory is relevant and the summary lacks detail.';
+        /** Logical category for discovery and grouping. */
+        this.category = 'memory';
+        /** This tool reads from the archive and writes an access-log entry. */
+        this.hasSideEffects = true;
+        /** JSON schema for input validation and LLM tool-call construction. */
+        this.inputSchema = {
+            type: 'object',
+            properties: {
+                traceId: {
+                    type: 'string',
+                    description: 'The unique ID of the memory trace to rehydrate.',
+                },
+            },
+            required: ['traceId'],
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // execute
+    // ---------------------------------------------------------------------------
+    /**
+     * Retrieve the original verbatim content for a gisted/archived trace.
+     *
+     * Delegates to `IMemoryArchive.rehydrate()`, which performs integrity
+     * verification and writes an access-log entry. Returns `null` for both
+     * verbatimContent and archivedAt if the trace is not found or integrity
+     * verification fails.
+     *
+     * @param args     - Rehydrate input (traceId).
+     * @param _context - Tool execution context (not used by this tool).
+     * @returns The rehydrated content or nulls, wrapped in ToolExecutionResult.
+     */
+    async execute(args, _context) {
+        try {
+            const result = await this.archive.rehydrate(args.traceId, 'rehydrate_memory_tool');
+            return {
+                success: true,
+                output: {
+                    verbatimContent: result?.verbatimContent ?? null,
+                    archivedAt: result?.archivedAt ?? null,
+                },
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=RehydrateMemoryTool.js.map

package/dist/memory/io/tools/RehydrateMemoryTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RehydrateMemoryTool.js","sourceRoot":"","sources":["../../../../src/memory/io/tools/RehydrateMemoryTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA8BH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,OAAO,mBAAmB;IAiC9B;;OAEG;IACH,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;QAnCpD,uCAAuC;QAC9B,OAAE,GAAG,qBAAqB,CAAC;QAEpC,4BAA4B;QACnB,SAAI,GAAG,kBAAkB,CAAC;QAEnC,mCAAmC;QAC1B,gBAAW,GAAG,kBAAkB,CAAC;QAE1C,8BAA8B;QACrB,gBAAW,GAClB,2EAA2E;YAC3E,yEAAyE,CAAC;QAE5E,mDAAmD;QAC1C,aAAQ,GAAG,QAAQ,CAAC;QAE7B,uEAAuE;QAC9D,mBAAc,GAAG,IAAI,CAAC;QAE/B,uEAAuE;QAC9D,gBAAW,GAAqB;YACvC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iDAAiD;iBAC/D;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB,CAAC;IAKqD,CAAC;IAExD,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAE9E;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,CACX,IAA0B,EAC1B,QAA8B;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;YACnF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,eAAe,EAAE,MAAM,EAAE,eAAe,IAAI,IAAI;oBAChD,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,IAAI;iBACvC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/memory/io/tools/index.d.ts

@@ -29,4 +29,7 @@ export { MemorySearchTool } from './MemorySearchTool.js';
 export type { MemorySearchInput, MemorySearchOutput, MemorySearchResult } from './MemorySearchTool.js';
 export { MemoryReflectTool } from './MemoryReflectTool.js';
 export type { MemoryReflectInput } from './MemoryReflectTool.js';
+/** Opt-in tool for rehydrating gisted/archived memory traces. */
+export { RehydrateMemoryTool } from './RehydrateMemoryTool.js';
+export type { RehydrateMemoryInput, RehydrateMemoryOutput } from './RehydrateMemoryTool.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/memory/io/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEvG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEvG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,iEAAiE;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/memory/io/tools/index.js

@@ -23,4 +23,6 @@ export { MemoryDeleteTool } from './MemoryDeleteTool.js';
 export { MemoryMergeTool } from './MemoryMergeTool.js';
 export { MemorySearchTool } from './MemorySearchTool.js';
 export { MemoryReflectTool } from './MemoryReflectTool.js';
+/** Opt-in tool for rehydrating gisted/archived memory traces. */
+export { RehydrateMemoryTool } from './RehydrateMemoryTool.js';
 //# sourceMappingURL=index.js.map

package/dist/memory/io/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/io/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/io/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,iEAAiE;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/memory/mechanisms/consolidation/TemporalGist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TemporalGist.d.ts","sourceRoot":"","sources":["../../../../src/memory/mechanisms/consolidation/TemporalGist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAqB,MAAM,aAAa,CAAC;AAsCjF;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,0BAA0B,EAClC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAmEjB"}
+{"version":3,"file":"TemporalGist.d.ts","sourceRoot":"","sources":["../../../../src/memory/mechanisms/consolidation/TemporalGist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAqB,MAAM,aAAa,CAAC;AAsCjF;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,0BAA0B,EAClC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAyFjB"}

package/dist/memory/mechanisms/consolidation/TemporalGist.js

@@ -81,6 +81,27 @@ export async function applyTemporalGist(traces, config, llmFn) {
             continue;
         // Store original content hash for audit
         const originalHash = await sha256(trace.content);
+        // Write-ahead archive: preserve verbatim content before gist overwrites it.
+        // Archive failure is fatal for this trace's gist cycle — the trace keeps
+        // its verbatim content and the next cycle will retry.
+        if (config.archive) {
+            const writeResult = await config.archive.store({
+                traceId: trace.id,
+                agentId: config.archiveAgentId ?? 'unknown',
+                verbatimContent: trace.content,
+                contentHash: originalHash,
+                traceType: trace.type,
+                emotionalContext: trace.emotionalContext,
+                entities: trace.entities,
+                tags: trace.tags,
+                createdAt: trace.createdAt,
+                archivedAt: Date.now(),
+                archiveReason: 'temporal_gist',
+            });
+            if (!writeResult.success) {
+                continue;
+            }
+        }
         // Extract gist
         let gist;
         if (llmFn) {

package/dist/memory/mechanisms/consolidation/TemporalGist.js.map

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

package/dist/memory/mechanisms/types.d.ts

@@ -181,6 +181,10 @@ export interface ResolvedTemporalGistConfig {
     minRetrievalCount: number;
     preserveEntities: boolean;
     preserveEmotionalContext: boolean;
+    /** Optional archive for write-ahead verbatim preservation before gisting. */
+    archive?: import('../archive/IMemoryArchive.js').IMemoryArchive;
+    /** Agent ID for archive records. Required when archive is set. */
+    archiveAgentId?: string;
 }
 export interface ResolvedSchemaEncodingConfig {
     enabled: boolean;