zora-agent 0.9.4 → 0.9.6

package/dist/hooks/hook-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-types.js","sourceRoot":"","sources":["../../src/hooks/hook-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,aAAa;IACb,mBAAmB;IACnB,kBAAkB;IAClB,WAAW;CACH,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hooks barrel exports — ORCH-12
+ */
+export * from './hook-types.js';
+export * from './hook-runner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,6 @@
+/**
+ * Hooks barrel exports — ORCH-12
+ */
+export * from './hook-types.js';
+export * from './hook-runner.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/memory/context-compressor.d.ts

@@ -0,0 +1,108 @@
+/**
+ * ContextCompressor — Rolling context compression with three tiers.
+ *
+ * Manages a rolling window of conversation history:
+ *   - Working tier: Recent raw messages (full fidelity)
+ *   - Session tier: Compressed observations from older messages
+ *   - Cross-session tier: Key facts from prior sessions
+ *
+ * Background compression ensures the agent never blocks.
+ * Append-only session observations maximize prompt cache hits.
+ */
+import type { AgentEvent, CompressionConfig } from '../types.js';
+import { type CompressFn } from './observer-worker.js';
+import { ObservationStore } from './observation-store.js';
+export interface CompressionStats {
+    workingTokens: number;
+    sessionTokens: number;
+    crossSessionTokens: number;
+    compressionsPending: number;
+    totalMessagesIngested: number;
+    totalCompressions: number;
+}
+export interface BuiltContext {
+    /** Compressed session-tier observations (append-only text block) */
+    sessionObservations: string;
+    /** Cross-session context (key facts from prior sessions) */
+    crossSessionContext: string;
+    /** Recent raw messages (working tier) */
+    workingMessages: AgentEvent[];
+    /** Current stats */
+    stats: CompressionStats;
+}
+export declare class ContextCompressor {
+    private readonly _config;
+    private readonly _observer;
+    private readonly _store;
+    /** Working tier: recent raw messages */
+    private _workingMessages;
+    /** Running token count for working tier */
+    private _workingTokens;
+    /** Global message index (total messages ingested) */
+    private _messageIndex;
+    /** Session-tier observations (text blocks, append-only) */
+    private _sessionObservations;
+    private _sessionTokens;
+    /** Cross-session context (loaded once at start) */
+    private _crossSessionContext;
+    private _crossSessionTokens;
+    /** Pending background compressions (tracked for synchronous settlement check) */
+    private _pendingCompressions;
+    private _totalCompressions;
+    /** Session ID for this compressor instance */
+    private readonly _sessionId;
+    /** Async buffer: pre-computed observations ready to activate */
+    private _precomputedBlock;
+    private _precomputePromise;
+    private _precomputeThreshold;
+    /** Track session tier size when precompute started to detect staleness */
+    private _precomputeSessionObsCount;
+    constructor(config: CompressionConfig, store: ObservationStore, compressFn: CompressFn, sessionId?: string);
+    /**
+     * Load existing observations for this session (e.g., after restart).
+     */
+    loadExisting(): Promise<void>;
+    /**
+     * Ingest a new event from the execution stream.
+     * Non-blocking — just appends and updates token count.
+     */
+    ingest(event: AgentEvent): void;
+    /**
+     * Check thresholds and trigger background compression if needed.
+     * Call this periodically (e.g., every N events or on a timer).
+     *
+     * If async_buffer is enabled, also manages pre-computation.
+     */
+    tick(): Promise<void>;
+    /**
+     * Build the current context for the next API call.
+     * Always returns immediately with the latest available state.
+     */
+    buildContext(): BuiltContext;
+    /**
+     * Flush: wait for all pending compressions to complete.
+     * Call this on session end.
+     */
+    flush(): Promise<void>;
+    /** Get the session ID for this compressor instance. */
+    get sessionId(): string;
+    /** Get current stats without building full context. */
+    get stats(): CompressionStats;
+    /** Track a promise for settlement so tick() can clean it up synchronously. */
+    private _trackPromise;
+    /**
+     * Compress the oldest chunk of working messages into a session observation.
+     */
+    private _compressChunk;
+    /**
+     * Start pre-computing observations in the background (async buffering).
+     * The pre-computed block is held until the threshold is actually hit.
+     */
+    private _startPrecompute;
+    /**
+     * Activate a pre-computed observation block.
+     * Removes the corresponding messages from the working tier.
+     */
+    private _activatePrecomputed;
+}
+//# sourceMappingURL=context-compressor.d.ts.map

package/dist/memory/context-compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/context-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAyB,MAAM,wBAAwB,CAAC;AAKjF,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,oBAAoB;IACpB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAE1C,wCAAwC;IACxC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,2CAA2C;IAC3C,OAAO,CAAC,cAAc,CAAK;IAC3B,qDAAqD;IACrD,OAAO,CAAC,aAAa,CAAK;IAE1B,2DAA2D;IAC3D,OAAO,CAAC,oBAAoB,CAAgB;IAC5C,OAAO,CAAC,cAAc,CAAK;IAE3B,mDAAmD;IACnD,OAAO,CAAC,oBAAoB,CAAM;IAClC,OAAO,CAAC,mBAAmB,CAAK;IAEhC,iFAAiF;IACjF,OAAO,CAAC,oBAAoB,CAAsD;IAClF,OAAO,CAAC,kBAAkB,CAAK;IAE/B,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,gEAAgE;IAChE,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,oBAAoB,CAAS;IACrC,0EAA0E;IAC1E,OAAO,CAAC,0BAA0B,CAAK;gBAGrC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,UAAU,EACtB,SAAS,CAAC,EAAE,MAAM;IAUpB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBnC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAM/B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC3B;;;OAGG;IACH,YAAY,IAAI,YAAY;IAgB5B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B,uDAAuD;IACvD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,uDAAuD;IACvD,IAAI,KAAK,IAAI,gBAAgB,CAS5B;IAID,8EAA8E;IAC9E,OAAO,CAAC,aAAa;IAMrB;;OAEG;YACW,cAAc;IAwD5B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;CAyD7B"}

package/dist/memory/context-compressor.js

@@ -0,0 +1,307 @@
+/**
+ * ContextCompressor — Rolling context compression with three tiers.
+ *
+ * Manages a rolling window of conversation history:
+ *   - Working tier: Recent raw messages (full fidelity)
+ *   - Session tier: Compressed observations from older messages
+ *   - Cross-session tier: Key facts from prior sessions
+ *
+ * Background compression ensures the agent never blocks.
+ * Append-only session observations maximize prompt cache hits.
+ */
+import { estimateEventTokens, estimateTokens } from './token-estimator.js';
+import { ObserverWorker } from './observer-worker.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('context-compressor');
+export class ContextCompressor {
+    _config;
+    _observer;
+    _store;
+    /** Working tier: recent raw messages */
+    _workingMessages = [];
+    /** Running token count for working tier */
+    _workingTokens = 0;
+    /** Global message index (total messages ingested) */
+    _messageIndex = 0;
+    /** Session-tier observations (text blocks, append-only) */
+    _sessionObservations = [];
+    _sessionTokens = 0;
+    /** Cross-session context (loaded once at start) */
+    _crossSessionContext = '';
+    _crossSessionTokens = 0;
+    /** Pending background compressions (tracked for synchronous settlement check) */
+    _pendingCompressions = [];
+    _totalCompressions = 0;
+    /** Session ID for this compressor instance */
+    _sessionId;
+    /** Async buffer: pre-computed observations ready to activate */
+    _precomputedBlock = null;
+    _precomputePromise = null;
+    _precomputeThreshold;
+    /** Track session tier size when precompute started to detect staleness */
+    _precomputeSessionObsCount = 0;
+    constructor(config, store, compressFn, sessionId) {
+        this._config = config;
+        this._store = store;
+        this._observer = new ObserverWorker(compressFn);
+        this._sessionId = sessionId ?? `session_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+        // Start pre-computing when working tier reaches 70% of threshold
+        this._precomputeThreshold = Math.floor(config.working_tier_max_tokens * 0.7);
+    }
+    /**
+     * Load existing observations for this session (e.g., after restart).
+     */
+    async loadExisting() {
+        const sessionBlocks = await this._store.loadSession(this._sessionId);
+        for (const block of sessionBlocks) {
+            this._sessionObservations.push(block.observations);
+            this._sessionTokens += block.estimatedTokens;
+        }
+        this._crossSessionContext = await this._store.buildCrossSessionContext();
+        this._crossSessionTokens = estimateTokens(this._crossSessionContext);
+        log.info({
+            sessionId: this._sessionId,
+            sessionBlocks: sessionBlocks.length,
+            sessionTokens: this._sessionTokens,
+            crossSessionTokens: this._crossSessionTokens,
+        }, 'Loaded existing observations');
+    }
+    /**
+     * Ingest a new event from the execution stream.
+     * Non-blocking — just appends and updates token count.
+     */
+    ingest(event) {
+        this._workingMessages.push(event);
+        this._workingTokens += estimateEventTokens(event);
+        this._messageIndex++;
+    }
+    /**
+     * Check thresholds and trigger background compression if needed.
+     * Call this periodically (e.g., every N events or on a timer).
+     *
+     * If async_buffer is enabled, also manages pre-computation.
+     */
+    async tick() {
+        // Clean up completed compressions
+        this._pendingCompressions = this._pendingCompressions.filter(t => !t.settled);
+        // Safety valve: if working tier exceeds blockAfter, do synchronous compression
+        const blockAfter = this._config.block_after_tokens ?? (this._config.working_tier_max_tokens * 2);
+        if (this._workingTokens > blockAfter) {
+            log.warn({ workingTokens: this._workingTokens, blockAfter }, 'Working tier exceeded blockAfter threshold — forcing synchronous compression');
+            await this._compressChunk();
+            return;
+        }
+        // Normal threshold: trigger background compression
+        if (this._workingTokens > this._config.working_tier_max_tokens) {
+            // Check if we have a pre-computed block ready
+            if (this._precomputedBlock) {
+                this._activatePrecomputed();
+            }
+            else {
+                // Fire and forget background compression
+                this._trackPromise(this._compressChunk());
+            }
+            return;
+        }
+        // Async buffer: start pre-computing when approaching threshold
+        if (this._config.async_buffer &&
+            this._workingTokens > this._precomputeThreshold &&
+            !this._precomputePromise &&
+            !this._precomputedBlock &&
+            this._workingMessages.length >= this._config.chunk_size) {
+            this._startPrecompute();
+        }
+    }
+    /**
+     * Build the current context for the next API call.
+     * Always returns immediately with the latest available state.
+     */
+    buildContext() {
+        return {
+            sessionObservations: this._sessionObservations.join('\n\n'),
+            crossSessionContext: this._crossSessionContext,
+            workingMessages: [...this._workingMessages],
+            stats: {
+                workingTokens: this._workingTokens,
+                sessionTokens: this._sessionTokens,
+                crossSessionTokens: this._crossSessionTokens,
+                compressionsPending: this._pendingCompressions.filter(t => !t.settled).length,
+                totalMessagesIngested: this._messageIndex,
+                totalCompressions: this._totalCompressions,
+            },
+        };
+    }
+    /**
+     * Flush: wait for all pending compressions to complete.
+     * Call this on session end.
+     */
+    async flush() {
+        // Wait for any pre-computation
+        if (this._precomputePromise) {
+            await this._precomputePromise;
+            if (this._precomputedBlock) {
+                this._activatePrecomputed();
+            }
+        }
+        // Wait for pending compressions (including activation persists) before final compress
+        await Promise.allSettled(this._pendingCompressions.map(t => t.promise));
+        // Compress any remaining working messages that exceed a minimum
+        if (this._workingMessages.length > 5) {
+            await this._compressChunk();
+        }
+        // Final wait for any compression just triggered above
+        await Promise.allSettled(this._pendingCompressions.filter(t => !t.settled).map(t => t.promise));
+        this._pendingCompressions = [];
+        log.info({
+            sessionId: this._sessionId,
+            totalCompressions: this._totalCompressions,
+            sessionTokens: this._sessionTokens,
+            remainingWorking: this._workingMessages.length,
+        }, 'Context compressor flushed');
+    }
+    /** Get the session ID for this compressor instance. */
+    get sessionId() {
+        return this._sessionId;
+    }
+    /** Get current stats without building full context. */
+    get stats() {
+        return {
+            workingTokens: this._workingTokens,
+            sessionTokens: this._sessionTokens,
+            crossSessionTokens: this._crossSessionTokens,
+            compressionsPending: this._pendingCompressions.filter(t => !t.settled).length,
+            totalMessagesIngested: this._messageIndex,
+            totalCompressions: this._totalCompressions,
+        };
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    /** Track a promise for settlement so tick() can clean it up synchronously. */
+    _trackPromise(p) {
+        const tracked = { promise: p, settled: false };
+        p.finally(() => { tracked.settled = true; });
+        this._pendingCompressions.push(tracked);
+    }
+    /**
+     * Compress the oldest chunk of working messages into a session observation.
+     */
+    async _compressChunk() {
+        const chunkSize = Math.min(this._config.chunk_size, this._workingMessages.length);
+        if (chunkSize === 0)
+            return;
+        // Dequeue the oldest chunk
+        const chunk = this._workingMessages.splice(0, chunkSize);
+        const startIndex = this._messageIndex - this._workingMessages.length - chunk.length;
+        // Recalculate working tier tokens
+        this._workingTokens = 0;
+        for (const msg of this._workingMessages) {
+            this._workingTokens += estimateEventTokens(msg);
+        }
+        const existingObs = this._sessionObservations.join('\n\n');
+        try {
+            const block = await this._observer.compress(chunk, startIndex, existingObs, this._sessionId);
+            // Persist first, then update in-memory state
+            await this._store.append(block);
+            // Only update in-memory state after successful persist
+            this._sessionObservations.push(block.observations);
+            this._sessionTokens += block.estimatedTokens;
+            this._totalCompressions++;
+            log.info({
+                chunkSize: chunk.length,
+                observationTokens: block.estimatedTokens,
+                sessionTokens: this._sessionTokens,
+                workingTokens: this._workingTokens,
+            }, 'Chunk compressed');
+            // Check if session tier needs condensation
+            if (this._sessionTokens > this._config.session_tier_max_tokens) {
+                log.info({ sessionTokens: this._sessionTokens, max: this._config.session_tier_max_tokens }, 'Session tier exceeds threshold — reflector pass needed');
+                // Reflector integration is handled by the orchestrator (OM-05/OM-07)
+            }
+        }
+        catch (err) {
+            // On failure, put the chunk back at the front of working messages
+            this._workingMessages = chunk.concat(this._workingMessages);
+            this._workingTokens = 0;
+            for (const msg of this._workingMessages) {
+                this._workingTokens += estimateEventTokens(msg);
+            }
+            log.error({ err }, 'Compression failed, chunk returned to working tier');
+        }
+    }
+    /**
+     * Start pre-computing observations in the background (async buffering).
+     * The pre-computed block is held until the threshold is actually hit.
+     */
+    _startPrecompute() {
+        const chunkSize = Math.min(this._config.chunk_size, this._workingMessages.length);
+        if (chunkSize === 0)
+            return;
+        // Snapshot the messages to pre-compute (don't remove from working tier yet)
+        const chunk = this._workingMessages.slice(0, chunkSize);
+        const startIndex = this._messageIndex - this._workingMessages.length;
+        const existingObs = this._sessionObservations.join('\n\n');
+        // Snapshot session tier size to detect race condition with _compressChunk
+        this._precomputeSessionObsCount = this._sessionObservations.length;
+        this._precomputePromise = (async () => {
+            try {
+                this._precomputedBlock = await this._observer.compress(chunk, startIndex, existingObs, this._sessionId);
+                log.info({ tokens: this._precomputedBlock.estimatedTokens }, 'Pre-computed observation block ready');
+            }
+            catch (err) {
+                log.warn({ err }, 'Pre-computation failed (will compress normally when threshold hits)');
+                this._precomputedBlock = null;
+            }
+            finally {
+                this._precomputePromise = null;
+            }
+        })();
+    }
+    /**
+     * Activate a pre-computed observation block.
+     * Removes the corresponding messages from the working tier.
+     */
+    _activatePrecomputed() {
+        const block = this._precomputedBlock;
+        if (!block)
+            return;
+        // Check for staleness: if session tier changed since precompute started, discard
+        if (this._sessionObservations.length !== this._precomputeSessionObsCount) {
+            log.warn({
+                expectedCount: this._precomputeSessionObsCount,
+                actualCount: this._sessionObservations.length,
+            }, 'Pre-computed block is stale (session tier changed), discarding');
+            this._precomputedBlock = null;
+            return;
+        }
+        const [start, end] = block.sourceMessageRange;
+        const chunkSize = end - start;
+        // Remove the pre-computed messages from working tier (capture for rollback)
+        const splicedMessages = this._workingMessages.splice(0, Math.min(chunkSize, this._workingMessages.length));
+        this._workingTokens = 0;
+        for (const msg of this._workingMessages) {
+            this._workingTokens += estimateEventTokens(msg);
+        }
+        // Persist first, then update in-memory state (keeps disk and memory consistent)
+        this._trackPromise(this._store.append(block).then(() => {
+            // Only update in-memory state after successful persist
+            this._sessionObservations.push(block.observations);
+            this._sessionTokens += block.estimatedTokens;
+            this._totalCompressions++;
+            log.info({
+                chunkSize,
+                observationTokens: block.estimatedTokens,
+                sessionTokens: this._sessionTokens,
+                workingTokens: this._workingTokens,
+            }, 'Pre-computed block activated');
+        }).catch(err => {
+            // Persist failed — roll back the working tier splice so messages aren't lost
+            log.error({ err }, 'Failed to persist pre-computed observation block, rolling back');
+            this._workingMessages = splicedMessages.concat(this._workingMessages);
+            this._workingTokens = 0;
+            for (const msg of this._workingMessages) {
+                this._workingTokens += estimateEventTokens(msg);
+            }
+        }));
+        this._precomputedBlock = null;
+    }
+}
+//# sourceMappingURL=context-compressor.js.map

package/dist/memory/context-compressor.js.map

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

package/dist/memory/index.d.ts

@@ -4,4 +4,5 @@ export * from './structured-memory.js';
 export * from './salience-scorer.js';
 export * from './extraction-pipeline.js';
 export * from './category-organizer.js';
+export * from './validation-pipeline.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC"}

package/dist/memory/index.js

@@ -4,4 +4,5 @@ export * from './structured-memory.js';
 export * from './salience-scorer.js';
 export * from './extraction-pipeline.js';
 export * from './category-organizer.js';
+export * from './validation-pipeline.js';
 //# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC"}

package/dist/memory/memory-manager.d.ts

@@ -6,10 +6,22 @@
  *   - Tier 2: Rolling context (Daily Notes)
  *   - Tier 3: Structured items, salience, categories
  *   - Aggregates fragments into TaskContext.memoryContext
+ *
+ * Integrity (MEM-18):
+ *   - SHA-256 baselines on MEMORY.md to detect tampering
+ *   - Baselines stored in .memory-integrity.json alongside the memory dir
+ *   - Mismatch logs a warning (non-fatal — user may legitimately edit)
  */
 import type { MemoryConfig } from '../types.js';
 import { StructuredMemory } from './structured-memory.js';
 import type { MemoryItem, CategorySummary, SalienceScore } from './memory-types.js';
+/** Lightweight stats about the memory system — no item reads. */
+export interface MemoryIndex {
+    itemCount: number;
+    categoryNames: string[];
+    mostRecentDailyNote: string | null;
+    dailyNoteCount: number;
+}
 export declare class MemoryManager {
     private readonly _config;
     private readonly _baseDir;
@@ -21,22 +33,70 @@ export declare class MemoryManager {
      * Initializes memory directories (Tiers 1-3).
      */
     init(): Promise<void>;
+    /** Cached memory index — invalidated on writes. */
+    private _indexCache;
+    /**
+     * Returns a lightweight index of memory contents — no item reads.
+     * Tells the LLM what's available without dumping everything into context.
+     * Cached after first build; invalidated by write operations.
+     */
+    getMemoryIndex(): Promise<MemoryIndex>;
+    /**
+     * Loads a lightweight context string for the system prompt.
+     * Instead of dumping all memory, provides a summary index that tells the LLM
+     * to use tools for on-demand retrieval.
+     */
+    loadContext(_days?: number): Promise<string[]>;
+    /**
+     * Full context load (backward compat). Reads ALL items, daily notes, categories.
+     * Use only when progressive loading is not suitable (e.g., export, migration).
+     */
+    loadFullContext(days?: number): Promise<string[]>;
+    /**
+     * Targeted memory recall — searches items by query using BM25 + salience.
+     * This is what the LLM calls via the memory_search tool, but exposed as
+     * a method for direct use by the Orchestrator.
+     */
+    recallMemory(query: string, limit?: number): Promise<{
+        items: MemoryItem[];
+        scores: SalienceScore[];
+    }>;
     /**
-     * Loads context for a new task based on tiers.
+     * Reads only the requested number of recent daily notes.
+     * Exposed for the recall_context tool.
      */
-    loadContext(days?: number): Promise<string[]>;
+    recallDailyNotes(days?: number): Promise<string[]>;
+    /**
+     * Archives daily notes older than threshold to memory/daily/archive/.
+     * Appends a summary header to MEMORY.md noting the archived date range.
+     * Archived notes remain on disk in the archive/ subdirectory for manual
+     * review but are excluded from the active daily notes directory.
+     *
+     * If a reflectFn is provided, it will be called with the combined content
+     * of notes being archived. This enables extracting structured memory items
+     * from daily notes before they are moved to the archive.
+     *
+     * @param thresholdDays Notes older than this are archived (default: 7)
+     * @param reflectFn Optional function to extract memory from notes before archiving
+     * @returns Number of notes archived
+     */
+    consolidateDailyNotes(thresholdDays?: number, reflectFn?: (notesContent: string) => Promise<void>): Promise<number>;
+    /** Invalidate the cached memory index (call after writes). */
+    invalidateIndex(): void;
     /**
      * Appends an entry to today's daily note.
      */
     appendDailyNote(text: string): Promise<void>;
     /**
      * Searches structured memory items by query, ranked by salience.
+     * Uses MiniSearch BM25+ scores composed with salience factors.
      */
     searchMemory(query: string, limit?: number): Promise<SalienceScore[]>;
     /**
-     * Deletes a structured memory item by ID.
+     * Soft-deletes a structured memory item by ID.
+     * Moves the item to an archive directory before removing.
      */
-    forgetItem(id: string): Promise<boolean>;
+    forgetItem(id: string, reason?: string): Promise<boolean>;
     /**
      * Returns all category summaries.
      */
@@ -45,6 +105,10 @@ export declare class MemoryManager {
      * Exposes the underlying StructuredMemory for direct access.
      */
     get structuredMemory(): StructuredMemory;
+    /**
+     * Returns the resolved path to the long-term memory file (MEMORY.md).
+     */
+    getLongTermPath(): string;
     private _resolvePath;
     private _getLongTermPath;
     private _getDailyNotesPath;
@@ -52,5 +116,25 @@ export declare class MemoryManager {
     private _getCategoriesPath;
     private _readLongTerm;
     private _readDailyNotes;
+    /** Path to the integrity baseline file alongside the memory directory. */
+    private _getIntegrityPath;
+    /** Compute SHA-256 hash of the given content. */
+    private _computeHash;
+    /**
+     * Saves a SHA-256 baseline for the current MEMORY.md content.
+     * Called after any write to MEMORY.md.
+     */
+    _saveIntegrityHash(): Promise<void>;
+    /**
+     * Verifies the current MEMORY.md content against the stored hash baseline.
+     * Logs a warning on mismatch but does not throw (the file may have been
+     * legitimately edited by the user).
+     */
+    private _verifyIntegrityHash;
+    /**
+     * Refreshes the integrity baseline for MEMORY.md.
+     * Call this after legitimate external edits to acknowledge the new content.
+     */
+    refreshIntegrityBaseline(): Promise<void>;
 }
 //# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory/memory-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,kBAAkB,CAAoB;gBAG5C,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,MAAyC,EAClD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC;IAYxD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;OAEG;IACG,WAAW,CAAC,IAAI,GAAE,MAAkC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA6C9E;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAK3E;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIjD;;OAEG;IACH,IAAI,gBAAgB,IAAI,gBAAgB,CAEvC;IAED,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,kBAAkB;YAOZ,aAAa;YAWb,eAAe;CAwB9B"}
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"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"}