@remnic/core 1.1.31 → 9.3.516

package/dist/{access-service-CkZyb35d.d.ts → access-service-CZfksQuS.d.ts}

@@ -1,11 +1,12 @@
 import { StorageManager } from './storage.js';
+import { a as Peer, b as PeerProfile } from './types-B1VHaf2w.js';
 import { RecallExplainJsonPayload } from './recall-explain-renderer.js';
 import { PluginConfig, DaySummaryResult, RecallPlanMode, RecallDisclosure, MemoryFile, MemoryLifecycleEvent, EntityFile, MemoryStatus, DreamsStatusResult, DreamsPhase, DreamsRunResult } from './types.js';
 import { AnomalyDetectorResult } from './recall-audit-anomaly.js';
 import { ExplicitCaptureInput } from './explicit-capture.js';
 import { BudgetDecision } from './cross-namespace-budget.js';
 import { readMemoryGovernanceRunArtifact } from './maintenance/memory-governance.js';
-import { O as Orchestrator, c as IntentDebugSnapshot, G as GraphRecallSnapshot, P as PatternReinforcementResult } from './orchestrator-DuWl9Hwx.js';
+import { O as Orchestrator, I as IntentDebugSnapshot, G as GraphRecallSnapshot, P as PatternReinforcementResult } from './orchestrator-Co9nxRLF.js';
 import { LiveConnectorsRunSummary } from './live-connectors-runner.js';
 import { LastRecallSnapshot } from './recall-state.js';
 import { GraphSnapshotRequest, GraphSnapshotResponse } from './graph-snapshot.js';
@@ -14,7 +15,7 @@ import { RecallXraySnapshot } from './recall-xray.js';
 import { L as LcmMessagePartInput, M as MessagePartSourceFormat } from './index-DJ9QWMw-.js';
 import { LocalLlmClient } from './local-llm.js';
 import { FallbackLlmClient } from './fallback-llm.js';
-import { a as SemanticDedupLookup } from './semantic-VwGI14Ok.js';
+import { a as SemanticDedupLookup } from './semantic-SLAa_prH.js';
 import { MemoryOutcomeKind, RecordMemoryOutcomeResult } from './memory-worth-outcomes.js';
 import { ImportCapsuleOptions, ImportCapsuleResult } from './transfer/capsule-import.js';
 import { ExportCapsuleOptions, ExportCapsuleResult } from './transfer/capsule-export.js';
@@ -22,131 +23,6 @@ import { CapsuleListEntry } from './capsule-cli.js';
 import { OfflineSyncFileState, OfflineSyncSnapshot, OfflineSyncFileRecord, OfflineSyncFileContentChunk, OfflineSyncApplyFileContentChunkResult, OfflineSyncApplyChangesetResult } from './offline-sync.js';
 import { ActionConfidenceInput, ActionConfidenceResult } from './action-confidence.js';
 
-/**
- * Peer registry types — issue #679 PR 1/5.
- *
- * Generalizes the singular identity-anchor model to a multi-peer registry.
- * Every party Remnic interacts with — humans, agents, integrations, and
- * "self" — is represented as a `Peer` with an evolving cognitive profile.
- *
- * This module defines pure types only. Storage primitives live in
- * `./storage.ts`. Reasoner integration, recall injection, CLI/HTTP/MCP
- * surfaces, and migration of existing identity-anchor data ship in later
- * PRs (2/5 — 5/5).
- */
-/**
- * Kind of peer.
- *
- * - `self`     — the current Remnic operator (replaces singular identity-anchor).
- * - `human`    — another human collaborator distinct from self.
- * - `agent`    — another AI agent (Claude Code, Codex, Hermes, etc.).
- * - `integration` — non-conversational integration (cron, webhook, importer).
- */
-type PeerKind = "self" | "human" | "agent" | "integration";
-/**
- * Stable, slow-changing facts about a peer.
- *
- * `id` matches `^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$`, 1-64 chars,
- * with no leading/trailing/consecutive dots or dashes. Stored on disk under
- * `peers/{id}/identity.md` as YAML frontmatter + markdown body.
- */
-interface Peer {
-    /** Stable, opaque identifier. See PEER_ID_PATTERN. */
-    readonly id: string;
-    /** Kind of peer. Drives default profile schema and recall posture. */
-    readonly kind: PeerKind;
-    /** Human-readable display name. Distinct from `id`; mutable. */
-    readonly displayName: string;
-    /** ISO-8601 timestamp of first registration. */
-    readonly createdAt: string;
-    /** ISO-8601 timestamp of most recent update to identity. */
-    readonly updatedAt: string;
-    /** Optional free-form markdown body for the identity kernel. */
-    readonly notes?: string;
-}
-/**
- * Evolving cognitive profile for a peer.
- *
- * Updated by the async profile reasoner (PR 2/5) from observable session
- * signals. Every field carries provenance back to its originating session
- * and signal. This PR only defines the shape — population is deferred.
- */
-interface PeerProfile {
-    /** Peer this profile belongs to. */
-    readonly peerId: string;
-    /** ISO-8601 timestamp of most recent profile mutation. */
-    readonly updatedAt: string;
-    /**
-     * Arbitrary key/value profile fields. Values are markdown strings.
-     * Keys are stable section identifiers (e.g. `communication_style`,
-     * `recurring_concerns`). The reasoner is responsible for choosing
-     * keys; this PR does not constrain them beyond requiring strings.
-     */
-    readonly fields: Record<string, string>;
-    /**
-     * Per-field provenance. Maps field key → list of provenance entries.
-     * A field may have multiple sources (the reasoner accumulates evidence
-     * across sessions before promoting a field).
-     */
-    readonly provenance: Record<string, ReadonlyArray<PeerProfileFieldProvenance>>;
-}
-/**
- * Provenance for a single profile-field mutation.
- *
- * Reasoner output (PR 2/5) attaches one of these every time it touches a
- * field, so the user can audit exactly why a profile claim exists.
- */
-interface PeerProfileFieldProvenance {
-    /** ISO-8601 timestamp the field was set/updated by this signal. */
-    readonly observedAt: string;
-    /** Originating session id (or other source identifier). */
-    readonly sourceSessionId?: string;
-    /** Short label for the signal type (e.g. "explicit_preference"). */
-    readonly signal: string;
-    /** Optional free-form note explaining the inference. */
-    readonly note?: string;
-}
-/**
- * One row of the append-only interaction log for a peer.
- *
- * Stored on disk under `peers/{id}/interactions.log.md` as a sequence of
- * markdown bullet entries with a leading ISO-8601 timestamp. Append-only
- * by contract — the reasoner reads this log to derive profile updates.
- */
-interface PeerInteractionLogEntry {
-    /** ISO-8601 timestamp the interaction occurred. */
-    readonly timestamp: string;
-    /** Originating session id, if any. */
-    readonly sessionId?: string;
-    /** Short kind label (e.g. "message", "tool_call", "preference_set"). */
-    readonly kind: string;
-    /** Free-form markdown summary of the interaction. */
-    readonly summary: string;
-}
-/**
- * Regex enforced on `Peer.id`. Exported so callers can mirror validation
- * before constructing a `Peer`.
- *
- * Rules:
- *   - 1-64 characters total
- *   - First and last character must be `[A-Za-z0-9]`
- *   - Interior may contain `.`, `_`, `-` in addition to alphanumerics
- *   - No leading or trailing dot/dash/underscore
- *   - No consecutive separators (`..`, `--`, `__`, `.-`, etc.)
- *
- * Cursor Medium: previously the regex allowed `a..b` even though the
- * docs claimed otherwise — a separate JS-side check enforced the rule
- * but the standalone PATTERN was wrong for any external consumer
- * relying on it. Tighten the regex itself so PEER_ID_PATTERN is the
- * single source of truth: an alphanumeric, optionally followed by
- * groups of (one separator + one-or-more alphanumerics), with the
- * final group ending on an alphanumeric. Negative lookahead-free so
- * it works in any JS engine.
- */
-declare const PEER_ID_PATTERN: RegExp;
-/** Maximum length for `Peer.id`. */
-declare const PEER_ID_MAX_LENGTH = 64;
-
 interface ConsoleBufferState {
     /** Number of turns currently held in the default buffer slot. */
     turnsCount: number;
@@ -819,6 +695,7 @@ interface EngramAccessObserveResponse {
 interface EngramAccessLcmSearchRequest {
     query: string;
     sessionKey?: string;
+    sessionPrefix?: string;
     namespace?: string;
     limit?: number;
     authenticatedPrincipal?: string;
@@ -1577,8 +1454,12 @@ declare class EngramAccessService {
         namespace?: string;
         principal?: string;
     }): Promise<EngramAccessCapsuleListResponse>;
-    offlineSyncSnapshot(options?: EngramAccessOfflineSyncSnapshotRequest): Promise<EngramAccessOfflineSyncSnapshotResponse>;
-    offlineSyncSnapshotStream(options?: Omit<EngramAccessOfflineSyncSnapshotRequest, "baseCapturedAt" | "baseFiles">): Promise<EngramAccessOfflineSyncSnapshotStreamResponse>;
+    offlineSyncSnapshot(options?: EngramAccessOfflineSyncSnapshotRequest & {
+        signal?: AbortSignal;
+    }): Promise<EngramAccessOfflineSyncSnapshotResponse>;
+    offlineSyncSnapshotStream(options?: Omit<EngramAccessOfflineSyncSnapshotRequest, "baseCapturedAt" | "baseFiles"> & {
+        signal?: AbortSignal;
+    }): Promise<EngramAccessOfflineSyncSnapshotStreamResponse>;
     offlineSyncFiles(options: EngramAccessOfflineSyncFilesRequest): Promise<EngramAccessOfflineSyncFilesResponse>;
     offlineSyncFileContent(options: EngramAccessOfflineSyncFileContentRequest): Promise<EngramAccessOfflineSyncFileContentResponse>;
     offlineSyncApplyFileContent(options: EngramAccessOfflineSyncApplyFileContentRequest): Promise<EngramAccessOfflineSyncApplyFileContentResponse>;
@@ -1606,4 +1487,4 @@ declare class EngramAccessService {
     }): Promise<DreamsRunResult>;
 }
 
-export { type EngramAccessOfflineSyncSnapshotResponse as $, type EngramAccessLcmCompactionFlushResponse as A, type EngramAccessLcmCompactionRecordRequest as B, type EngramAccessLcmCompactionRecordResponse as C, type EngramAccessLcmSearchRequest as D, EngramAccessService as E, type EngramAccessLcmSearchResponse as F, type EngramAccessLcmStatusResponse as G, type EngramAccessMaintenanceResponse as H, type EngramAccessMemoryBrowseRequest as I, type EngramAccessMemoryBrowseResponse as J, type EngramAccessMemoryRecord as K, type EngramAccessMemoryResponse as L, type EngramAccessMemoryStoreRequest as M, type EngramAccessMemorySummary as N, type EngramAccessObserveMessage as O, type PeerInteractionLogEntry as P, type EngramAccessObserveRequest as Q, type EngramAccessObserveResponse as R, type EngramAccessOfflineSyncApplyFileContentRequest as S, type EngramAccessOfflineSyncApplyFileContentResponse as T, type EngramAccessOfflineSyncApplyRequest as U, type EngramAccessOfflineSyncApplyResponse as V, type EngramAccessOfflineSyncFileContentRequest as W, type EngramAccessOfflineSyncFileContentResponse as X, type EngramAccessOfflineSyncFilesRequest as Y, type EngramAccessOfflineSyncFilesResponse as Z, type EngramAccessOfflineSyncSnapshotRequest as _, type EngramAccessRecallResponse as a, type EngramAccessOfflineSyncSnapshotStreamResponse as a0, type EngramAccessQualityResponse as a1, type EngramAccessRecallExplainRequest as a2, type EngramAccessRecallExplainResponse as a3, type EngramAccessRecallRequest as a4, type EngramAccessReviewDispositionRequest as a5, type EngramAccessReviewDispositionResponse as a6, type EngramAccessReviewQueueResponse as a7, type EngramAccessSetCodingContextRequest as a8, type EngramAccessSuggestionSubmitRequest as a9, type EngramAccessTimelineResponse as aa, type EngramAccessTrustZoneBrowseRequest as ab, type EngramAccessTrustZoneBrowseResponse as ac, type EngramAccessTrustZoneDemoSeedRequest as ad, type EngramAccessTrustZoneDemoSeedResponse as ae, type EngramAccessTrustZonePromoteRequest as af, type EngramAccessTrustZonePromoteResponse as ag, type EngramAccessTrustZoneRecordSummary as ah, type EngramAccessTrustZoneStatusResponse as ai, type EngramAccessWriteEnvelope as aj, type EngramAccessWriteResponse as ak, shapeMemorySummary as al, type Peer as b, type PeerProfile as c, EngramAccessInputError as d, PEER_ID_MAX_LENGTH as e, PEER_ID_PATTERN as f, type PeerKind as g, type PeerProfileFieldProvenance as h, type ProcedureStatsConfigSnapshot as i, type ProcedureStatsRecent as j, type ProcedureStatsReport as k, type ProcedureStatusCounts as l, computeProcedureStats as m, formatProcedureStatsText as n, ENGRAM_ACCESS_WRITE_SCHEMA_VERSION as o, type EngramAccessActionConfidenceRequest as p, type EngramAccessActionConfidenceResponse as q, type EngramAccessBriefingRequest as r, type EngramAccessBriefingResponse as s, type EngramAccessCapsuleListResponse as t, type EngramAccessDaySummaryRequest as u, type EngramAccessEntityListResponse as v, type EngramAccessEntityResponse as w, type EngramAccessEntitySummary as x, type EngramAccessHealthResponse as y, type EngramAccessLcmCompactionFlushRequest as z };
+export { type EngramAccessReviewDispositionResponse as $, type EngramAccessMemoryBrowseRequest as A, type EngramAccessMemoryBrowseResponse as B, type EngramAccessMemoryRecord as C, type EngramAccessMemoryResponse as D, EngramAccessService as E, type EngramAccessMemoryStoreRequest as F, type EngramAccessMemorySummary as G, type EngramAccessObserveMessage as H, type EngramAccessObserveRequest as I, type EngramAccessObserveResponse as J, type EngramAccessOfflineSyncApplyFileContentRequest as K, type EngramAccessOfflineSyncApplyFileContentResponse as L, type EngramAccessOfflineSyncApplyRequest as M, type EngramAccessOfflineSyncApplyResponse as N, type EngramAccessOfflineSyncFileContentRequest as O, type ProcedureStatsConfigSnapshot as P, type EngramAccessOfflineSyncFileContentResponse as Q, type EngramAccessOfflineSyncFilesRequest as R, type EngramAccessOfflineSyncFilesResponse as S, type EngramAccessOfflineSyncSnapshotRequest as T, type EngramAccessOfflineSyncSnapshotResponse as U, type EngramAccessOfflineSyncSnapshotStreamResponse as V, type EngramAccessQualityResponse as W, type EngramAccessRecallExplainRequest as X, type EngramAccessRecallExplainResponse as Y, type EngramAccessRecallRequest as Z, type EngramAccessReviewDispositionRequest as _, type EngramAccessRecallResponse as a, type EngramAccessReviewQueueResponse as a0, type EngramAccessSetCodingContextRequest as a1, type EngramAccessSuggestionSubmitRequest as a2, type EngramAccessTimelineResponse as a3, type EngramAccessTrustZoneBrowseRequest as a4, type EngramAccessTrustZoneBrowseResponse as a5, type EngramAccessTrustZoneDemoSeedRequest as a6, type EngramAccessTrustZoneDemoSeedResponse as a7, type EngramAccessTrustZonePromoteRequest as a8, type EngramAccessTrustZonePromoteResponse as a9, type EngramAccessTrustZoneRecordSummary as aa, type EngramAccessTrustZoneStatusResponse as ab, type EngramAccessWriteEnvelope as ac, type EngramAccessWriteResponse as ad, shapeMemorySummary as ae, EngramAccessInputError as b, type ProcedureStatsRecent as c, type ProcedureStatsReport as d, type ProcedureStatusCounts as e, computeProcedureStats as f, formatProcedureStatsText as g, ENGRAM_ACCESS_WRITE_SCHEMA_VERSION as h, type EngramAccessActionConfidenceRequest as i, type EngramAccessActionConfidenceResponse as j, type EngramAccessBriefingRequest as k, type EngramAccessBriefingResponse as l, type EngramAccessCapsuleListResponse as m, type EngramAccessDaySummaryRequest as n, type EngramAccessEntityListResponse as o, type EngramAccessEntityResponse as p, type EngramAccessEntitySummary as q, type EngramAccessHealthResponse as r, type EngramAccessLcmCompactionFlushRequest as s, type EngramAccessLcmCompactionFlushResponse as t, type EngramAccessLcmCompactionRecordRequest as u, type EngramAccessLcmCompactionRecordResponse as v, type EngramAccessLcmSearchRequest as w, type EngramAccessLcmSearchResponse as x, type EngramAccessLcmStatusResponse as y, type EngramAccessMaintenanceResponse as z };

package/dist/access-service.d.ts

@@ -1,12 +1,13 @@
 import './storage.js';
-export { o as ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, p as EngramAccessActionConfidenceRequest, q as EngramAccessActionConfidenceResponse, r as EngramAccessBriefingRequest, s as EngramAccessBriefingResponse, t as EngramAccessCapsuleListResponse, u as EngramAccessDaySummaryRequest, v as EngramAccessEntityListResponse, w as EngramAccessEntityResponse, x as EngramAccessEntitySummary, y as EngramAccessHealthResponse, d as EngramAccessInputError, z as EngramAccessLcmCompactionFlushRequest, A as EngramAccessLcmCompactionFlushResponse, B as EngramAccessLcmCompactionRecordRequest, C as EngramAccessLcmCompactionRecordResponse, D as EngramAccessLcmSearchRequest, F as EngramAccessLcmSearchResponse, G as EngramAccessLcmStatusResponse, H as EngramAccessMaintenanceResponse, I as EngramAccessMemoryBrowseRequest, J as EngramAccessMemoryBrowseResponse, K as EngramAccessMemoryRecord, L as EngramAccessMemoryResponse, M as EngramAccessMemoryStoreRequest, N as EngramAccessMemorySummary, O as EngramAccessObserveMessage, Q as EngramAccessObserveRequest, R as EngramAccessObserveResponse, S as EngramAccessOfflineSyncApplyFileContentRequest, T as EngramAccessOfflineSyncApplyFileContentResponse, U as EngramAccessOfflineSyncApplyRequest, V as EngramAccessOfflineSyncApplyResponse, W as EngramAccessOfflineSyncFileContentRequest, X as EngramAccessOfflineSyncFileContentResponse, Y as EngramAccessOfflineSyncFilesRequest, Z as EngramAccessOfflineSyncFilesResponse, _ as EngramAccessOfflineSyncSnapshotRequest, $ as EngramAccessOfflineSyncSnapshotResponse, a0 as EngramAccessOfflineSyncSnapshotStreamResponse, a1 as EngramAccessQualityResponse, a2 as EngramAccessRecallExplainRequest, a3 as EngramAccessRecallExplainResponse, a4 as EngramAccessRecallRequest, a as EngramAccessRecallResponse, a5 as EngramAccessReviewDispositionRequest, a6 as EngramAccessReviewDispositionResponse, a7 as EngramAccessReviewQueueResponse, E as EngramAccessService, a8 as EngramAccessSetCodingContextRequest, a9 as EngramAccessSuggestionSubmitRequest, aa as EngramAccessTimelineResponse, ab as EngramAccessTrustZoneBrowseRequest, ac as EngramAccessTrustZoneBrowseResponse, ad as EngramAccessTrustZoneDemoSeedRequest, ae as EngramAccessTrustZoneDemoSeedResponse, af as EngramAccessTrustZonePromoteRequest, ag as EngramAccessTrustZonePromoteResponse, ah as EngramAccessTrustZoneRecordSummary, ai as EngramAccessTrustZoneStatusResponse, aj as EngramAccessWriteEnvelope, ak as EngramAccessWriteResponse, al as shapeMemorySummary } from './access-service-CkZyb35d.js';
+import './types-B1VHaf2w.js';
+export { h as ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, i as EngramAccessActionConfidenceRequest, j as EngramAccessActionConfidenceResponse, k as EngramAccessBriefingRequest, l as EngramAccessBriefingResponse, m as EngramAccessCapsuleListResponse, n as EngramAccessDaySummaryRequest, o as EngramAccessEntityListResponse, p as EngramAccessEntityResponse, q as EngramAccessEntitySummary, r as EngramAccessHealthResponse, b as EngramAccessInputError, s as EngramAccessLcmCompactionFlushRequest, t as EngramAccessLcmCompactionFlushResponse, u as EngramAccessLcmCompactionRecordRequest, v as EngramAccessLcmCompactionRecordResponse, w as EngramAccessLcmSearchRequest, x as EngramAccessLcmSearchResponse, y as EngramAccessLcmStatusResponse, z as EngramAccessMaintenanceResponse, A as EngramAccessMemoryBrowseRequest, B as EngramAccessMemoryBrowseResponse, C as EngramAccessMemoryRecord, D as EngramAccessMemoryResponse, F as EngramAccessMemoryStoreRequest, G as EngramAccessMemorySummary, H as EngramAccessObserveMessage, I as EngramAccessObserveRequest, J as EngramAccessObserveResponse, K as EngramAccessOfflineSyncApplyFileContentRequest, L as EngramAccessOfflineSyncApplyFileContentResponse, M as EngramAccessOfflineSyncApplyRequest, N as EngramAccessOfflineSyncApplyResponse, O as EngramAccessOfflineSyncFileContentRequest, Q as EngramAccessOfflineSyncFileContentResponse, R as EngramAccessOfflineSyncFilesRequest, S as EngramAccessOfflineSyncFilesResponse, T as EngramAccessOfflineSyncSnapshotRequest, U as EngramAccessOfflineSyncSnapshotResponse, V as EngramAccessOfflineSyncSnapshotStreamResponse, W as EngramAccessQualityResponse, X as EngramAccessRecallExplainRequest, Y as EngramAccessRecallExplainResponse, Z as EngramAccessRecallRequest, a as EngramAccessRecallResponse, _ as EngramAccessReviewDispositionRequest, $ as EngramAccessReviewDispositionResponse, a0 as EngramAccessReviewQueueResponse, E as EngramAccessService, a1 as EngramAccessSetCodingContextRequest, a2 as EngramAccessSuggestionSubmitRequest, a3 as EngramAccessTimelineResponse, a4 as EngramAccessTrustZoneBrowseRequest, a5 as EngramAccessTrustZoneBrowseResponse, a6 as EngramAccessTrustZoneDemoSeedRequest, a7 as EngramAccessTrustZoneDemoSeedResponse, a8 as EngramAccessTrustZonePromoteRequest, a9 as EngramAccessTrustZonePromoteResponse, aa as EngramAccessTrustZoneRecordSummary, ab as EngramAccessTrustZoneStatusResponse, ac as EngramAccessWriteEnvelope, ad as EngramAccessWriteResponse, ae as shapeMemorySummary } from './access-service-CZfksQuS.js';
 import './recall-explain-renderer.js';
 import './types.js';
 import './recall-audit-anomaly.js';
 import './explicit-capture.js';
 import './cross-namespace-budget.js';
 import './maintenance/memory-governance.js';
-import './orchestrator-DuWl9Hwx.js';
+import './orchestrator-Co9nxRLF.js';
 import './live-connectors-runner.js';
 import './recall-state.js';
 import './graph-snapshot.js';
@@ -15,7 +16,7 @@ import './recall-xray.js';
 import './index-DJ9QWMw-.js';
 import './local-llm.js';
 import './fallback-llm.js';
-import './semantic-VwGI14Ok.js';
+import './semantic-SLAa_prH.js';
 import './memory-worth-outcomes.js';
 import './transfer/capsule-import.js';
 import './transfer/capsule-export.js';
@@ -27,6 +28,7 @@ import './consolidation-operator.js';
 import './memory-projection-store.js';
 import './runtime/better-sqlite.js';
 import 'better-sqlite3';
+import './types-BliCnURB.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './recall-audit.js';
@@ -36,6 +38,7 @@ import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
 import './model-registry.js';
+import './resolve-provider-secret.js';
 import './framework-CyHYDcri.js';
 import './relevance.js';
 import './negative.js';
@@ -52,7 +55,7 @@ import './connectors/codex-materialize.js';
 import './logger.js';
 import './conversation-index/backend.js';
 import './conversation-index/chunker.js';
-import './faiss-adapter-CzPghc4C.js';
+import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
 import './shared-context/manager.js';
 import 'zod';

package/dist/access-service.js

@@ -3,74 +3,74 @@ import {
   EngramAccessInputError,
   EngramAccessService,
   shapeMemorySummary
-} from "./chunk-ZAVUCJ4H.js";
-import "./chunk-ZKSK55RC.js";
-import "./chunk-WELDCG6C.js";
-import "./chunk-ZYVPLJ4T.js";
+} from "./chunk-5V456VRV.js";
+import "./chunk-ETUPBUHB.js";
+import "./chunk-L227SKTB.js";
+import "./chunk-DHGSZ3UD.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-H7XKCNR6.js";
-import "./chunk-FBYESMQ2.js";
+import "./chunk-3C5RPJAX.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-FDU6HUUL.js";
-import "./chunk-QDZ2RLEC.js";
-import "./chunk-MGKYQQYF.js";
-import "./chunk-GL6I6MEQ.js";
-import "./chunk-3APJ5EVB.js";
-import "./chunk-5UM2VJ6D.js";
-import "./chunk-76FLAAUC.js";
+import "./chunk-EDQVAMQI.js";
+import "./chunk-472U7RDF.js";
+import "./chunk-7Q3RCKAQ.js";
+import "./chunk-WSGF57U2.js";
+import "./chunk-XKIQZXUB.js";
+import "./chunk-UEY3VB6W.js";
+import "./chunk-2AN2L4NL.js";
 import "./chunk-EIR5VLIH.js";
-import "./chunk-PCUKNJAZ.js";
-import "./chunk-RRF5UOBJ.js";
-import "./chunk-NBNN5GOB.js";
+import "./chunk-JKV57BTN.js";
+import "./chunk-EI6V5UXY.js";
+import "./chunk-QY7YA7OL.js";
 import "./chunk-NNVTUXEB.js";
 import "./chunk-QDW3E4RD.js";
-import "./chunk-25MQ7IHJ.js";
-import "./chunk-GDFS42HT.js";
-import "./chunk-U3PN77QT.js";
-import "./chunk-RK2Y4XOM.js";
+import "./chunk-EUML3N6B.js";
+import "./chunk-CHCA44C3.js";
+import "./chunk-4JRRISLU.js";
 import "./chunk-2LSZVONP.js";
-import "./chunk-WIICJPET.js";
-import "./chunk-SIC6U3GZ.js";
-import "./chunk-VBJ7V5SK.js";
+import "./chunk-DEUNUKTD.js";
+import "./chunk-YHV3KRKS.js";
+import "./chunk-UIPDNLXA.js";
 import "./chunk-5UZXUTVO.js";
-import "./chunk-NN2DKE4T.js";
-import "./chunk-Q7P4WJDP.js";
+import "./chunk-4H5ZJHEN.js";
+import "./chunk-M5T4Q2ZU.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-3KW65B36.js";
+import "./chunk-KILOTVIF.js";
 import "./chunk-3HPAPHUK.js";
-import "./chunk-PFV5C235.js";
+import "./chunk-CPPS65WS.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-FAAFWE4G.js";
-import "./chunk-QRNI5JBH.js";
+import "./chunk-ALEPI75L.js";
 import "./chunk-ZY2MNJR6.js";
-import "./chunk-MY6TPVXW.js";
+import "./chunk-LMPHTYJC.js";
 import "./chunk-DT5TVLJE.js";
-import "./chunk-UWVJF25J.js";
+import "./chunk-HWVTS5NO.js";
+import "./chunk-U3PN77QT.js";
 import "./chunk-4DJQYKMN.js";
-import "./chunk-XIG5PDM7.js";
+import "./chunk-EYIEWJNI.js";
+import "./chunk-JUC24CTX.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-2ODBA7MQ.js";
-import "./chunk-DGXUHMOV.js";
+import "./chunk-A2IYSXDQ.js";
 import "./chunk-LPSF4OQH.js";
 import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
-import "./chunk-XKECPATV.js";
-import "./chunk-QA2ZAPBU.js";
-import "./chunk-WEHSQBFR.js";
-import "./chunk-KNKUID7G.js";
+import "./chunk-VFUEZZBS.js";
+import "./chunk-IPLYGWQF.js";
 import "./chunk-J4EB7DNW.js";
+import "./chunk-WEHSQBFR.js";
+import "./chunk-X7Y7WX73.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
-import "./chunk-U7EJOMFC.js";
-import "./chunk-I6K5FBRQ.js";
-import "./chunk-AGZQD76C.js";
-import "./chunk-MXFBBHJU.js";
+import "./chunk-ZEY4KYRQ.js";
+import "./chunk-UI3NYK34.js";
+import "./chunk-GCGJW34D.js";
+import "./chunk-KJMYHC7K.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-AH2JUU6X.js";

package/dist/action-confidence.d.ts

@@ -1,5 +1,6 @@
 import { RetrievedMemoryCorrectionState, RetrievedMemorySafety } from './memory-provenance.js';
 import './types.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 import './user-model.js';
 

package/dist/active-memory-bridge.d.ts

@@ -1,4 +1,5 @@
 import { PluginConfig, MemoryFile } from './types.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 
 interface ActiveMemoryMetadata {

package/dist/active-memory-bridge.js

@@ -1,9 +1,10 @@
 import {
   getMemoryForActiveMemory,
   recallForActiveMemory
-} from "./chunk-2WWLHTZY.js";
+} from "./chunk-IC4GELZE.js";
 import "./chunk-6MKAMLQL.js";
-import "./chunk-UWVJF25J.js";
+import "./chunk-HWVTS5NO.js";
+import "./chunk-U3PN77QT.js";
 import "./chunk-PZ5AY32C.js";
 export {
   getMemoryForActiveMemory,

package/dist/active-recall.d.ts

@@ -1,4 +1,5 @@
 import { ActiveRecallChatType, ActiveRecallQueryMode, ActiveRecallPromptStyle, ActiveRecallThinking, ActiveRecallModelFallbackPolicy } from './types.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 
 interface ActiveRecallTurn {

package/dist/active-recall.js

@@ -4,11 +4,12 @@ import {
 } from "./chunk-6MKAMLQL.js";
 import {
   DEFAULT_REASONING_MODEL
-} from "./chunk-MZH6EHNR.js";
+} from "./chunk-7H6CFEBJ.js";
 import "./chunk-PHK3HARR.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-4DJQYKMN.js";
-import "./chunk-XIG5PDM7.js";
+import "./chunk-EYIEWJNI.js";
+import "./chunk-JUC24CTX.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 
@@ -288,13 +289,17 @@ function createActiveRecallEngine(deps, config) {
         transcriptPath: null
       };
       if (config.persistTranscripts) {
-        result.transcriptPath = await appendActiveRecallTranscript(
-          config.transcriptDir,
-          input,
-          config,
-          result,
-          queryBundle
-        );
+        try {
+          result.transcriptPath = await appendActiveRecallTranscript(
+            config.transcriptDir,
+            input,
+            config,
+            result,
+            queryBundle
+          );
+        } catch {
+          result.transcriptPath = null;
+        }
       }
       if (cacheEnabled) {
         const completedAt = now();

package/dist/active-recall.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/active-recall.ts"],"sourcesContent":["import { appendFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { DEFAULT_REASONING_MODEL } from \"./config.js\";\nimport { collapseWhitespace, truncateCodePointSafe } from \"./whitespace.js\";\nimport type {\n  ActiveRecallChatType,\n  ActiveRecallModelFallbackPolicy,\n  ActiveRecallPromptStyle,\n  ActiveRecallQueryMode,\n  ActiveRecallThinking,\n} from \"./types.js\";\n\nexport interface ActiveRecallTurn {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface ActiveRecallInput {\n  sessionKey: string;\n  agentId: string;\n  chatType: ActiveRecallChatType;\n  recentTurns: ActiveRecallTurn[];\n  currentMessage: string;\n}\n\nexport interface ActiveRecallConfig {\n  enabled: boolean;\n  agents: string[] | null;\n  allowedChatTypes: ActiveRecallChatType[];\n  queryMode: ActiveRecallQueryMode;\n  promptStyle: ActiveRecallPromptStyle;\n  customInstruction: string | null;\n  promptAppend: string | null;\n  maxSummaryChars: number;\n  recentUserTurns: number;\n  recentAssistantTurns: number;\n  recentUserChars: number;\n  recentAssistantChars: number;\n  thinking: ActiveRecallThinking;\n  timeoutMs: number;\n  cacheTtlMs: number;\n  persistTranscripts: boolean;\n  transcriptDir: string;\n  entityGraphDepth: number;\n  includeCausalTrajectories: boolean;\n  includeDaySummary: boolean;\n  attachRecallExplain: boolean;\n  modelOverride: string | null;\n  modelFallbackPolicy: ActiveRecallModelFallbackPolicy;\n}\n\nexport interface ActiveRecallResult {\n  summary: string | null;\n  citations: Array<{ memoryId: string; relevance: number }>;\n  latencyMs: number;\n  cacheHit: boolean;\n  modelUsed: string;\n  transcriptPath: string | null;\n}\n\nexport interface ActiveRecallDependencies {\n  recall(query: string, sessionKey: string): Promise<string | null>;\n  getLastRecallSnapshot?(sessionKey: string): { memoryIds?: string[] } | null;\n  walkEntityGraph?(params: {\n    sessionKey: string;\n    query: string;\n    depth: number;\n  }): Promise<string[]>;\n  loadCausalTrajectories?(params: {\n    sessionKey: string;\n    query: string;\n  }): Promise<string[]>;\n  loadDaySummary?(sessionKey: string): Promise<string | null>;\n  explainLastRecall?(sessionKey: string): Promise<string | null>;\n  generateSummary?(params: {\n    prompt: string;\n    sessionKey: string;\n    agentId: string;\n    model: string;\n    timeoutMs: number;\n    thinking: ActiveRecallThinking;\n    fallbackPolicy: ActiveRecallModelFallbackPolicy;\n  }): Promise<{ text: string | null; modelUsed?: string; cacheHit?: boolean }>;\n  now?: () => number;\n}\n\ninterface CachedRecallResult {\n  expiresAt: number;\n  value: ActiveRecallResult;\n}\n\ninterface ActiveRecallTurnWithIndex {\n  index: number;\n  role: ActiveRecallTurn[\"role\"];\n  content: string;\n}\n\nconst ACTIVE_RECALL_CACHE_MAX_ENTRIES = 256;\n\nconst NONE_SET = new Set([\n  \"\",\n  \"none\",\n  \"no_reply\",\n  \"nothing useful\",\n  \"no relevant memory\",\n  \"timeout\",\n  \"[]\",\n  \"{}\",\n  \"null\",\n  \"n/a\",\n]);\n\nconst STYLE_INSTRUCTIONS: Record<ActiveRecallPromptStyle, string> = {\n  balanced: \"Summarize the most relevant memory context in a compact, neutral way.\",\n  strict: \"Only include memory that is directly supported by the retrieved context.\",\n  contextual: \"Prefer concise context that helps the next reply stay grounded in recent work.\",\n  \"recall-heavy\": \"Bias toward richer recall coverage when multiple retrieved items reinforce each other.\",\n  \"precision-heavy\": \"Bias toward precision. Omit anything uncertain or weakly supported.\",\n  \"preference-only\": \"Only surface user preference or operating-style memory when present.\",\n};\n\nfunction cloneRecallResult(value: ActiveRecallResult): ActiveRecallResult {\n  return {\n    ...value,\n    citations: [...value.citations],\n  };\n}\n\nfunction buildCacheKey(input: ActiveRecallInput, config: ActiveRecallConfig, queryBundle: string): string {\n  return JSON.stringify({\n    sessionKey: input.sessionKey,\n    agentId: input.agentId,\n    queryMode: config.queryMode,\n    promptStyle: config.promptStyle,\n    customInstruction: config.customInstruction,\n    promptAppend: config.promptAppend,\n    maxSummaryChars: config.maxSummaryChars,\n    entityGraphDepth: config.entityGraphDepth,\n    includeCausalTrajectories: config.includeCausalTrajectories,\n    includeDaySummary: config.includeDaySummary,\n    attachRecallExplain: config.attachRecallExplain,\n    modelOverride: config.modelOverride,\n    modelFallbackPolicy: config.modelFallbackPolicy,\n    thinking: config.thinking,\n    queryBundle,\n  });\n}\n\nfunction pruneExpiredCache(\n  cache: Map<string, CachedRecallResult>,\n  currentTime: number,\n): void {\n  for (const [key, entry] of cache.entries()) {\n    if (entry.expiresAt <= currentTime) {\n      cache.delete(key);\n    }\n  }\n}\n\nfunction enforceCacheLimit(cache: Map<string, CachedRecallResult>): void {\n  while (cache.size > ACTIVE_RECALL_CACHE_MAX_ENTRIES) {\n    const oldestKey = cache.keys().next().value;\n    if (typeof oldestKey !== \"string\") {\n      break;\n    }\n    cache.delete(oldestKey);\n  }\n}\n\nfunction cropTurns(\n  turns: ActiveRecallTurn[],\n  role: \"user\" | \"assistant\",\n  maxTurns: number,\n  maxChars: number,\n): ActiveRecallTurnWithIndex[] {\n  if (maxTurns <= 0) {\n    return [];\n  }\n\n  const selected: ActiveRecallTurnWithIndex[] = [];\n  for (let index = turns.length - 1; index >= 0 && selected.length < maxTurns; index -= 1) {\n    const turn = turns[index];\n    if (turn?.role === role) {\n      selected.push({\n        index,\n        role: turn.role,\n        content: collapseWhitespace(truncateCodePointSafe(turn.content, maxChars)),\n      });\n    }\n  }\n\n  return selected.reverse();\n}\n\nfunction mergeChronologicalTurns(\n  userTurns: ActiveRecallTurnWithIndex[],\n  assistantTurns: ActiveRecallTurnWithIndex[],\n): ActiveRecallTurnWithIndex[] {\n  return [...userTurns, ...assistantTurns]\n    .sort((left, right) => left.index - right.index)\n    .filter((value) => value.content.length > 0);\n}\n\nexport function buildActiveRecallQueryBundle(\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n): string {\n  if (config.queryMode === \"message\") {\n    return collapseWhitespace(input.currentMessage);\n  }\n\n  const userTurns = cropTurns(\n    input.recentTurns,\n    \"user\",\n    config.recentUserTurns,\n    config.recentUserChars,\n  );\n  const assistantTurns = cropTurns(\n    input.recentTurns,\n    \"assistant\",\n    config.recentAssistantTurns,\n    config.recentAssistantChars,\n  );\n  const mergedTurns = mergeChronologicalTurns(userTurns, assistantTurns);\n\n  const parts = [\n    ...mergedTurns.map((turn) => `${turn.role}: ${turn.content}`),\n  ];\n\n  if (config.queryMode === \"full\") {\n    return [...parts, `current: ${collapseWhitespace(input.currentMessage)}`]\n      .filter((value) => value.trim().length > 0)\n      .join(\"\\n\");\n  }\n\n  return [`current: ${collapseWhitespace(input.currentMessage)}`, ...parts]\n    .filter((value) => value.trim().length > 0)\n    .join(\"\\n\");\n}\n\nexport function normalizeActiveRecallSummary(value: string | null, maxChars: number): string | null {\n  if (value == null) return null;\n  const compact = collapseWhitespace(value);\n  if (NONE_SET.has(compact.toLowerCase())) return null;\n  return truncateCodePointSafe(compact, maxChars);\n}\n\nfunction sanitizeTranscriptPathSegment(value: string): string {\n  const normalized = collapseWhitespace(value);\n  return encodeURIComponent(normalized.length > 0 ? normalized : \"unknown\").replaceAll(\n    \".\",\n    \"%2E\",\n  );\n}\n\nexport function buildActiveRecallPrompt(params: {\n  config: ActiveRecallConfig;\n  queryBundle: string;\n  recallContext: string | null;\n  graphContext: string[];\n  causalContext: string[];\n  daySummary: string | null;\n  recallExplain: string | null;\n}): string {\n  const sections = [\n    params.config.customInstruction?.trim() || STYLE_INSTRUCTIONS[params.config.promptStyle],\n    `Query bundle:\\n${params.queryBundle}`,\n    params.recallContext ? `Retrieved memory:\\n${params.recallContext}` : null,\n    params.graphContext.length > 0 ? `Entity graph:\\n${params.graphContext.join(\"\\n\")}` : null,\n    params.causalContext.length > 0 ? `Causal trajectories:\\n${params.causalContext.join(\"\\n\")}` : null,\n    params.daySummary ? `Day summary:\\n${params.daySummary}` : null,\n    params.recallExplain ? `Recall explain:\\n${params.recallExplain}` : null,\n    params.config.promptAppend?.trim() || null,\n    \"Return either NONE or a compact summary grounded only in the supplied context.\",\n  ];\n  return sections.filter((value): value is string => !!value && value.trim().length > 0).join(\"\\n\\n\");\n}\n\nasync function appendActiveRecallTranscript(\n  transcriptRoot: string,\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n  result: ActiveRecallResult,\n  queryBundle: string,\n): Promise<string> {\n  const date = new Date().toISOString().slice(0, 10);\n  const filePath = path.join(\n    transcriptRoot,\n    \"agents\",\n    sanitizeTranscriptPathSegment(input.agentId),\n    date,\n    `${sanitizeTranscriptPathSegment(input.sessionKey)}.jsonl`,\n  );\n  await mkdir(path.dirname(filePath), { recursive: true });\n  await appendFile(\n    filePath,\n    `${JSON.stringify({\n      ts: new Date().toISOString(),\n      sessionKey: input.sessionKey,\n      agentId: input.agentId,\n      queryMode: config.queryMode,\n      promptStyle: config.promptStyle,\n      queryBundle,\n      summary: result.summary,\n      citations: result.citations,\n      latencyMs: result.latencyMs,\n      cacheHit: result.cacheHit,\n      modelUsed: result.modelUsed,\n    })}\\n`,\n    \"utf8\",\n  );\n  return filePath;\n}\n\nexport function createActiveRecallEngine(\n  deps: ActiveRecallDependencies,\n  config: ActiveRecallConfig,\n) {\n  const cache = new Map<string, CachedRecallResult>();\n  const now = deps.now ?? (() => Date.now());\n\n  return {\n    async run(input: ActiveRecallInput): Promise<ActiveRecallResult> {\n      if (!config.enabled) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"disabled\",\n          transcriptPath: null,\n        };\n      }\n      if (config.agents && !config.agents.includes(input.agentId)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n      if (!config.allowedChatTypes.includes(input.chatType)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n\n      const queryBundle = buildActiveRecallQueryBundle(input, config);\n      const cacheKey = buildCacheKey(input, config, queryBundle);\n      const currentTime = now();\n      const cacheEnabled = config.cacheTtlMs > 0;\n      if (cacheEnabled) {\n        pruneExpiredCache(cache, currentTime);\n      }\n      const cached = cache.get(cacheKey);\n      if (cacheEnabled && cached) {\n        return {\n          ...cloneRecallResult(cached.value),\n          latencyMs: Math.max(0, now() - currentTime),\n          cacheHit: true,\n        };\n      }\n\n      const start = currentTime;\n      const recallContext = await deps.recall(queryBundle, input.sessionKey);\n      const graphContext =\n        config.entityGraphDepth > 0 && deps.walkEntityGraph\n          ? await deps.walkEntityGraph({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n              depth: config.entityGraphDepth,\n            })\n          : [];\n      const causalContext =\n        config.includeCausalTrajectories && deps.loadCausalTrajectories\n          ? await deps.loadCausalTrajectories({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n            })\n          : [];\n      const daySummary =\n        config.includeDaySummary && deps.loadDaySummary\n          ? await deps.loadDaySummary(input.sessionKey)\n          : null;\n      const recallExplain =\n        config.attachRecallExplain && deps.explainLastRecall\n          ? await deps.explainLastRecall(input.sessionKey)\n          : null;\n      const prompt = buildActiveRecallPrompt({\n        config,\n        queryBundle,\n        recallContext,\n        graphContext,\n        causalContext,\n        daySummary,\n        recallExplain,\n      });\n\n      const generated = deps.generateSummary\n        ? await deps.generateSummary({\n            prompt,\n            sessionKey: input.sessionKey,\n            agentId: input.agentId,\n            model: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            timeoutMs: config.timeoutMs,\n            thinking: config.thinking,\n            fallbackPolicy: config.modelFallbackPolicy,\n          })\n        : {\n            text: recallContext,\n            modelUsed: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            cacheHit: false,\n          };\n      const summary = normalizeActiveRecallSummary(\n        generated.text,\n        config.maxSummaryChars,\n      );\n      const snapshot = deps.getLastRecallSnapshot?.(input.sessionKey);\n      const citations = (snapshot?.memoryIds ?? []).map((memoryId, index) => ({\n        memoryId,\n        relevance: Number((1 / (index + 1)).toFixed(3)),\n      }));\n      const result: ActiveRecallResult = {\n        summary,\n        citations,\n        latencyMs: Math.max(0, now() - start),\n        cacheHit: generated.cacheHit === true,\n        modelUsed: generated.modelUsed ?? config.modelOverride ?? DEFAULT_REASONING_MODEL,\n        transcriptPath: null,\n      };\n      if (config.persistTranscripts) {\n        result.transcriptPath = await appendActiveRecallTranscript(\n          config.transcriptDir,\n          input,\n          config,\n          result,\n          queryBundle,\n        );\n      }\n\n      if (cacheEnabled) {\n        const completedAt = now();\n        cache.set(cacheKey, {\n          expiresAt: completedAt + config.cacheTtlMs,\n          value: cloneRecallResult(result),\n        });\n        enforceCacheLimit(cache);\n      }\n      return result;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAAA,SAAS,YAAY,aAAa;AAClC,OAAO,UAAU;AAgGjB,IAAM,kCAAkC;AAExC,IAAM,WAAW,oBAAI,IAAI;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,IAAM,qBAA8D;AAAA,EAClE,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,mBAAmB;AACrB;AAEA,SAAS,kBAAkB,OAA+C;AACxE,SAAO;AAAA,IACL,GAAG;AAAA,IACH,WAAW,CAAC,GAAG,MAAM,SAAS;AAAA,EAChC;AACF;AAEA,SAAS,cAAc,OAA0B,QAA4B,aAA6B;AACxG,SAAO,KAAK,UAAU;AAAA,IACpB,YAAY,MAAM;AAAA,IAClB,SAAS,MAAM;AAAA,IACf,WAAW,OAAO;AAAA,IAClB,aAAa,OAAO;AAAA,IACpB,mBAAmB,OAAO;AAAA,IAC1B,cAAc,OAAO;AAAA,IACrB,iBAAiB,OAAO;AAAA,IACxB,kBAAkB,OAAO;AAAA,IACzB,2BAA2B,OAAO;AAAA,IAClC,mBAAmB,OAAO;AAAA,IAC1B,qBAAqB,OAAO;AAAA,IAC5B,eAAe,OAAO;AAAA,IACtB,qBAAqB,OAAO;AAAA,IAC5B,UAAU,OAAO;AAAA,IACjB;AAAA,EACF,CAAC;AACH;AAEA,SAAS,kBACP,OACA,aACM;AACN,aAAW,CAAC,KAAK,KAAK,KAAK,MAAM,QAAQ,GAAG;AAC1C,QAAI,MAAM,aAAa,aAAa;AAClC,YAAM,OAAO,GAAG;AAAA,IAClB;AAAA,EACF;AACF;AAEA,SAAS,kBAAkB,OAA8C;AACvE,SAAO,MAAM,OAAO,iCAAiC;AACnD,UAAM,YAAY,MAAM,KAAK,EAAE,KAAK,EAAE;AACtC,QAAI,OAAO,cAAc,UAAU;AACjC;AAAA,IACF;AACA,UAAM,OAAO,SAAS;AAAA,EACxB;AACF;AAEA,SAAS,UACP,OACA,MACA,UACA,UAC6B;AAC7B,MAAI,YAAY,GAAG;AACjB,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,WAAwC,CAAC;AAC/C,WAAS,QAAQ,MAAM,SAAS,GAAG,SAAS,KAAK,SAAS,SAAS,UAAU,SAAS,GAAG;AACvF,UAAM,OAAO,MAAM,KAAK;AACxB,QAAI,MAAM,SAAS,MAAM;AACvB,eAAS,KAAK;AAAA,QACZ;AAAA,QACA,MAAM,KAAK;AAAA,QACX,SAAS,mBAAmB,sBAAsB,KAAK,SAAS,QAAQ,CAAC;AAAA,MAC3E,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO,SAAS,QAAQ;AAC1B;AAEA,SAAS,wBACP,WACA,gBAC6B;AAC7B,SAAO,CAAC,GAAG,WAAW,GAAG,cAAc,EACpC,KAAK,CAAC,MAAM,UAAU,KAAK,QAAQ,MAAM,KAAK,EAC9C,OAAO,CAAC,UAAU,MAAM,QAAQ,SAAS,CAAC;AAC/C;AAEO,SAAS,6BACd,OACA,QACQ;AACR,MAAI,OAAO,cAAc,WAAW;AAClC,WAAO,mBAAmB,MAAM,cAAc;AAAA,EAChD;AAEA,QAAM,YAAY;AAAA,IAChB,MAAM;AAAA,IACN;AAAA,IACA,OAAO;AAAA,IACP,OAAO;AAAA,EACT;AACA,QAAM,iBAAiB;AAAA,IACrB,MAAM;AAAA,IACN;AAAA,IACA,OAAO;AAAA,IACP,OAAO;AAAA,EACT;AACA,QAAM,cAAc,wBAAwB,WAAW,cAAc;AAErE,QAAM,QAAQ;AAAA,IACZ,GAAG,YAAY,IAAI,CAAC,SAAS,GAAG,KAAK,IAAI,KAAK,KAAK,OAAO,EAAE;AAAA,EAC9D;AAEA,MAAI,OAAO,cAAc,QAAQ;AAC/B,WAAO,CAAC,GAAG,OAAO,YAAY,mBAAmB,MAAM,cAAc,CAAC,EAAE,EACrE,OAAO,CAAC,UAAU,MAAM,KAAK,EAAE,SAAS,CAAC,EACzC,KAAK,IAAI;AAAA,EACd;AAEA,SAAO,CAAC,YAAY,mBAAmB,MAAM,cAAc,CAAC,IAAI,GAAG,KAAK,EACrE,OAAO,CAAC,UAAU,MAAM,KAAK,EAAE,SAAS,CAAC,EACzC,KAAK,IAAI;AACd;AAEO,SAAS,6BAA6B,OAAsB,UAAiC;AAClG,MAAI,SAAS,KAAM,QAAO;AAC1B,QAAM,UAAU,mBAAmB,KAAK;AACxC,MAAI,SAAS,IAAI,QAAQ,YAAY,CAAC,EAAG,QAAO;AAChD,SAAO,sBAAsB,SAAS,QAAQ;AAChD;AAEA,SAAS,8BAA8B,OAAuB;AAC5D,QAAM,aAAa,mBAAmB,KAAK;AAC3C,SAAO,mBAAmB,WAAW,SAAS,IAAI,aAAa,SAAS,EAAE;AAAA,IACxE;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,wBAAwB,QAQ7B;AACT,QAAM,WAAW;AAAA,IACf,OAAO,OAAO,mBAAmB,KAAK,KAAK,mBAAmB,OAAO,OAAO,WAAW;AAAA,IACvF;AAAA,EAAkB,OAAO,WAAW;AAAA,IACpC,OAAO,gBAAgB;AAAA,EAAsB,OAAO,aAAa,KAAK;AAAA,IACtE,OAAO,aAAa,SAAS,IAAI;AAAA,EAAkB,OAAO,aAAa,KAAK,IAAI,CAAC,KAAK;AAAA,IACtF,OAAO,cAAc,SAAS,IAAI;AAAA,EAAyB,OAAO,cAAc,KAAK,IAAI,CAAC,KAAK;AAAA,IAC/F,OAAO,aAAa;AAAA,EAAiB,OAAO,UAAU,KAAK;AAAA,IAC3D,OAAO,gBAAgB;AAAA,EAAoB,OAAO,aAAa,KAAK;AAAA,IACpE,OAAO,OAAO,cAAc,KAAK,KAAK;AAAA,IACtC;AAAA,EACF;AACA,SAAO,SAAS,OAAO,CAAC,UAA2B,CAAC,CAAC,SAAS,MAAM,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,MAAM;AACpG;AAEA,eAAe,6BACb,gBACA,OACA,QACA,QACA,aACiB;AACjB,QAAM,QAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE;AACjD,QAAM,WAAW,KAAK;AAAA,IACpB;AAAA,IACA;AAAA,IACA,8BAA8B,MAAM,OAAO;AAAA,IAC3C;AAAA,IACA,GAAG,8BAA8B,MAAM,UAAU,CAAC;AAAA,EACpD;AACA,QAAM,MAAM,KAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AACvD,QAAM;AAAA,IACJ;AAAA,IACA,GAAG,KAAK,UAAU;AAAA,MAChB,KAAI,oBAAI,KAAK,GAAE,YAAY;AAAA,MAC3B,YAAY,MAAM;AAAA,MAClB,SAAS,MAAM;AAAA,MACf,WAAW,OAAO;AAAA,MAClB,aAAa,OAAO;AAAA,MACpB;AAAA,MACA,SAAS,OAAO;AAAA,MAChB,WAAW,OAAO;AAAA,MAClB,WAAW,OAAO;AAAA,MAClB,UAAU,OAAO;AAAA,MACjB,WAAW,OAAO;AAAA,IACpB,CAAC,CAAC;AAAA;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,yBACd,MACA,QACA;AACA,QAAM,QAAQ,oBAAI,IAAgC;AAClD,QAAM,MAAM,KAAK,QAAQ,MAAM,KAAK,IAAI;AAExC,SAAO;AAAA,IACL,MAAM,IAAI,OAAuD;AAC/D,UAAI,CAAC,OAAO,SAAS;AACnB,eAAO;AAAA,UACL,SAAS;AAAA,UACT,WAAW,CAAC;AAAA,UACZ,WAAW;AAAA,UACX,UAAU;AAAA,UACV,WAAW,OAAO,iBAAiB;AAAA,UACnC,gBAAgB;AAAA,QAClB;AAAA,MACF;AACA,UAAI,OAAO,UAAU,CAAC,OAAO,OAAO,SAAS,MAAM,OAAO,GAAG;AAC3D,eAAO;AAAA,UACL,SAAS;AAAA,UACT,WAAW,CAAC;AAAA,UACZ,WAAW;AAAA,UACX,UAAU;AAAA,UACV,WAAW,OAAO,iBAAiB;AAAA,UACnC,gBAAgB;AAAA,QAClB;AAAA,MACF;AACA,UAAI,CAAC,OAAO,iBAAiB,SAAS,MAAM,QAAQ,GAAG;AACrD,eAAO;AAAA,UACL,SAAS;AAAA,UACT,WAAW,CAAC;AAAA,UACZ,WAAW;AAAA,UACX,UAAU;AAAA,UACV,WAAW,OAAO,iBAAiB;AAAA,UACnC,gBAAgB;AAAA,QAClB;AAAA,MACF;AAEA,YAAM,cAAc,6BAA6B,OAAO,MAAM;AAC9D,YAAM,WAAW,cAAc,OAAO,QAAQ,WAAW;AACzD,YAAM,cAAc,IAAI;AACxB,YAAM,eAAe,OAAO,aAAa;AACzC,UAAI,cAAc;AAChB,0BAAkB,OAAO,WAAW;AAAA,MACtC;AACA,YAAM,SAAS,MAAM,IAAI,QAAQ;AACjC,UAAI,gBAAgB,QAAQ;AAC1B,eAAO;AAAA,UACL,GAAG,kBAAkB,OAAO,KAAK;AAAA,UACjC,WAAW,KAAK,IAAI,GAAG,IAAI,IAAI,WAAW;AAAA,UAC1C,UAAU;AAAA,QACZ;AAAA,MACF;AAEA,YAAM,QAAQ;AACd,YAAM,gBAAgB,MAAM,KAAK,OAAO,aAAa,MAAM,UAAU;AACrE,YAAM,eACJ,OAAO,mBAAmB,KAAK,KAAK,kBAChC,MAAM,KAAK,gBAAgB;AAAA,QACzB,YAAY,MAAM;AAAA,QAClB,OAAO;AAAA,QACP,OAAO,OAAO;AAAA,MAChB,CAAC,IACD,CAAC;AACP,YAAM,gBACJ,OAAO,6BAA6B,KAAK,yBACrC,MAAM,KAAK,uBAAuB;AAAA,QAChC,YAAY,MAAM;AAAA,QAClB,OAAO;AAAA,MACT,CAAC,IACD,CAAC;AACP,YAAM,aACJ,OAAO,qBAAqB,KAAK,iBAC7B,MAAM,KAAK,eAAe,MAAM,UAAU,IAC1C;AACN,YAAM,gBACJ,OAAO,uBAAuB,KAAK,oBAC/B,MAAM,KAAK,kBAAkB,MAAM,UAAU,IAC7C;AACN,YAAM,SAAS,wBAAwB;AAAA,QACrC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,YAAM,YAAY,KAAK,kBACnB,MAAM,KAAK,gBAAgB;AAAA,QACzB;AAAA,QACA,YAAY,MAAM;AAAA,QAClB,SAAS,MAAM;AAAA,QACf,OAAO,OAAO,iBAAiB;AAAA,QAC/B,WAAW,OAAO;AAAA,QAClB,UAAU,OAAO;AAAA,QACjB,gBAAgB,OAAO;AAAA,MACzB,CAAC,IACD;AAAA,QACE,MAAM;AAAA,QACN,WAAW,OAAO,iBAAiB;AAAA,QACnC,UAAU;AAAA,MACZ;AACJ,YAAM,UAAU;AAAA,QACd,UAAU;AAAA,QACV,OAAO;AAAA,MACT;AACA,YAAM,WAAW,KAAK,wBAAwB,MAAM,UAAU;AAC9D,YAAM,aAAa,UAAU,aAAa,CAAC,GAAG,IAAI,CAAC,UAAU,WAAW;AAAA,QACtE;AAAA,QACA,WAAW,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,CAAC;AAAA,MAChD,EAAE;AACF,YAAM,SAA6B;AAAA,QACjC;AAAA,QACA;AAAA,QACA,WAAW,KAAK,IAAI,GAAG,IAAI,IAAI,KAAK;AAAA,QACpC,UAAU,UAAU,aAAa;AAAA,QACjC,WAAW,UAAU,aAAa,OAAO,iBAAiB;AAAA,QAC1D,gBAAgB;AAAA,MAClB;AACA,UAAI,OAAO,oBAAoB;AAC7B,eAAO,iBAAiB,MAAM;AAAA,UAC5B,OAAO;AAAA,UACP;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAEA,UAAI,cAAc;AAChB,cAAM,cAAc,IAAI;AACxB,cAAM,IAAI,UAAU;AAAA,UAClB,WAAW,cAAc,OAAO;AAAA,UAChC,OAAO,kBAAkB,MAAM;AAAA,QACjC,CAAC;AACD,0BAAkB,KAAK;AAAA,MACzB;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/active-recall.ts"],"sourcesContent":["import { appendFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { DEFAULT_REASONING_MODEL } from \"./config.js\";\nimport { collapseWhitespace, truncateCodePointSafe } from \"./whitespace.js\";\nimport type {\n  ActiveRecallChatType,\n  ActiveRecallModelFallbackPolicy,\n  ActiveRecallPromptStyle,\n  ActiveRecallQueryMode,\n  ActiveRecallThinking,\n} from \"./types.js\";\n\nexport interface ActiveRecallTurn {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface ActiveRecallInput {\n  sessionKey: string;\n  agentId: string;\n  chatType: ActiveRecallChatType;\n  recentTurns: ActiveRecallTurn[];\n  currentMessage: string;\n}\n\nexport interface ActiveRecallConfig {\n  enabled: boolean;\n  agents: string[] | null;\n  allowedChatTypes: ActiveRecallChatType[];\n  queryMode: ActiveRecallQueryMode;\n  promptStyle: ActiveRecallPromptStyle;\n  customInstruction: string | null;\n  promptAppend: string | null;\n  maxSummaryChars: number;\n  recentUserTurns: number;\n  recentAssistantTurns: number;\n  recentUserChars: number;\n  recentAssistantChars: number;\n  thinking: ActiveRecallThinking;\n  timeoutMs: number;\n  cacheTtlMs: number;\n  persistTranscripts: boolean;\n  transcriptDir: string;\n  entityGraphDepth: number;\n  includeCausalTrajectories: boolean;\n  includeDaySummary: boolean;\n  attachRecallExplain: boolean;\n  modelOverride: string | null;\n  modelFallbackPolicy: ActiveRecallModelFallbackPolicy;\n}\n\nexport interface ActiveRecallResult {\n  summary: string | null;\n  citations: Array<{ memoryId: string; relevance: number }>;\n  latencyMs: number;\n  cacheHit: boolean;\n  modelUsed: string;\n  transcriptPath: string | null;\n}\n\nexport interface ActiveRecallDependencies {\n  recall(query: string, sessionKey: string): Promise<string | null>;\n  getLastRecallSnapshot?(sessionKey: string): { memoryIds?: string[] } | null;\n  walkEntityGraph?(params: {\n    sessionKey: string;\n    query: string;\n    depth: number;\n  }): Promise<string[]>;\n  loadCausalTrajectories?(params: {\n    sessionKey: string;\n    query: string;\n  }): Promise<string[]>;\n  loadDaySummary?(sessionKey: string): Promise<string | null>;\n  explainLastRecall?(sessionKey: string): Promise<string | null>;\n  generateSummary?(params: {\n    prompt: string;\n    sessionKey: string;\n    agentId: string;\n    model: string;\n    timeoutMs: number;\n    thinking: ActiveRecallThinking;\n    fallbackPolicy: ActiveRecallModelFallbackPolicy;\n  }): Promise<{ text: string | null; modelUsed?: string; cacheHit?: boolean }>;\n  now?: () => number;\n}\n\ninterface CachedRecallResult {\n  expiresAt: number;\n  value: ActiveRecallResult;\n}\n\ninterface ActiveRecallTurnWithIndex {\n  index: number;\n  role: ActiveRecallTurn[\"role\"];\n  content: string;\n}\n\nconst ACTIVE_RECALL_CACHE_MAX_ENTRIES = 256;\n\nconst NONE_SET = new Set([\n  \"\",\n  \"none\",\n  \"no_reply\",\n  \"nothing useful\",\n  \"no relevant memory\",\n  \"timeout\",\n  \"[]\",\n  \"{}\",\n  \"null\",\n  \"n/a\",\n]);\n\nconst STYLE_INSTRUCTIONS: Record<ActiveRecallPromptStyle, string> = {\n  balanced: \"Summarize the most relevant memory context in a compact, neutral way.\",\n  strict: \"Only include memory that is directly supported by the retrieved context.\",\n  contextual: \"Prefer concise context that helps the next reply stay grounded in recent work.\",\n  \"recall-heavy\": \"Bias toward richer recall coverage when multiple retrieved items reinforce each other.\",\n  \"precision-heavy\": \"Bias toward precision. Omit anything uncertain or weakly supported.\",\n  \"preference-only\": \"Only surface user preference or operating-style memory when present.\",\n};\n\nfunction cloneRecallResult(value: ActiveRecallResult): ActiveRecallResult {\n  return {\n    ...value,\n    citations: [...value.citations],\n  };\n}\n\nfunction buildCacheKey(input: ActiveRecallInput, config: ActiveRecallConfig, queryBundle: string): string {\n  return JSON.stringify({\n    sessionKey: input.sessionKey,\n    agentId: input.agentId,\n    queryMode: config.queryMode,\n    promptStyle: config.promptStyle,\n    customInstruction: config.customInstruction,\n    promptAppend: config.promptAppend,\n    maxSummaryChars: config.maxSummaryChars,\n    entityGraphDepth: config.entityGraphDepth,\n    includeCausalTrajectories: config.includeCausalTrajectories,\n    includeDaySummary: config.includeDaySummary,\n    attachRecallExplain: config.attachRecallExplain,\n    modelOverride: config.modelOverride,\n    modelFallbackPolicy: config.modelFallbackPolicy,\n    thinking: config.thinking,\n    queryBundle,\n  });\n}\n\nfunction pruneExpiredCache(\n  cache: Map<string, CachedRecallResult>,\n  currentTime: number,\n): void {\n  for (const [key, entry] of cache.entries()) {\n    if (entry.expiresAt <= currentTime) {\n      cache.delete(key);\n    }\n  }\n}\n\nfunction enforceCacheLimit(cache: Map<string, CachedRecallResult>): void {\n  while (cache.size > ACTIVE_RECALL_CACHE_MAX_ENTRIES) {\n    const oldestKey = cache.keys().next().value;\n    if (typeof oldestKey !== \"string\") {\n      break;\n    }\n    cache.delete(oldestKey);\n  }\n}\n\nfunction cropTurns(\n  turns: ActiveRecallTurn[],\n  role: \"user\" | \"assistant\",\n  maxTurns: number,\n  maxChars: number,\n): ActiveRecallTurnWithIndex[] {\n  if (maxTurns <= 0) {\n    return [];\n  }\n\n  const selected: ActiveRecallTurnWithIndex[] = [];\n  for (let index = turns.length - 1; index >= 0 && selected.length < maxTurns; index -= 1) {\n    const turn = turns[index];\n    if (turn?.role === role) {\n      selected.push({\n        index,\n        role: turn.role,\n        content: collapseWhitespace(truncateCodePointSafe(turn.content, maxChars)),\n      });\n    }\n  }\n\n  return selected.reverse();\n}\n\nfunction mergeChronologicalTurns(\n  userTurns: ActiveRecallTurnWithIndex[],\n  assistantTurns: ActiveRecallTurnWithIndex[],\n): ActiveRecallTurnWithIndex[] {\n  return [...userTurns, ...assistantTurns]\n    .sort((left, right) => left.index - right.index)\n    .filter((value) => value.content.length > 0);\n}\n\nexport function buildActiveRecallQueryBundle(\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n): string {\n  if (config.queryMode === \"message\") {\n    return collapseWhitespace(input.currentMessage);\n  }\n\n  const userTurns = cropTurns(\n    input.recentTurns,\n    \"user\",\n    config.recentUserTurns,\n    config.recentUserChars,\n  );\n  const assistantTurns = cropTurns(\n    input.recentTurns,\n    \"assistant\",\n    config.recentAssistantTurns,\n    config.recentAssistantChars,\n  );\n  const mergedTurns = mergeChronologicalTurns(userTurns, assistantTurns);\n\n  const parts = [\n    ...mergedTurns.map((turn) => `${turn.role}: ${turn.content}`),\n  ];\n\n  if (config.queryMode === \"full\") {\n    return [...parts, `current: ${collapseWhitespace(input.currentMessage)}`]\n      .filter((value) => value.trim().length > 0)\n      .join(\"\\n\");\n  }\n\n  return [`current: ${collapseWhitespace(input.currentMessage)}`, ...parts]\n    .filter((value) => value.trim().length > 0)\n    .join(\"\\n\");\n}\n\nexport function normalizeActiveRecallSummary(value: string | null, maxChars: number): string | null {\n  if (value == null) return null;\n  const compact = collapseWhitespace(value);\n  if (NONE_SET.has(compact.toLowerCase())) return null;\n  return truncateCodePointSafe(compact, maxChars);\n}\n\nfunction sanitizeTranscriptPathSegment(value: string): string {\n  const normalized = collapseWhitespace(value);\n  return encodeURIComponent(normalized.length > 0 ? normalized : \"unknown\").replaceAll(\n    \".\",\n    \"%2E\",\n  );\n}\n\nexport function buildActiveRecallPrompt(params: {\n  config: ActiveRecallConfig;\n  queryBundle: string;\n  recallContext: string | null;\n  graphContext: string[];\n  causalContext: string[];\n  daySummary: string | null;\n  recallExplain: string | null;\n}): string {\n  const sections = [\n    params.config.customInstruction?.trim() || STYLE_INSTRUCTIONS[params.config.promptStyle],\n    `Query bundle:\\n${params.queryBundle}`,\n    params.recallContext ? `Retrieved memory:\\n${params.recallContext}` : null,\n    params.graphContext.length > 0 ? `Entity graph:\\n${params.graphContext.join(\"\\n\")}` : null,\n    params.causalContext.length > 0 ? `Causal trajectories:\\n${params.causalContext.join(\"\\n\")}` : null,\n    params.daySummary ? `Day summary:\\n${params.daySummary}` : null,\n    params.recallExplain ? `Recall explain:\\n${params.recallExplain}` : null,\n    params.config.promptAppend?.trim() || null,\n    \"Return either NONE or a compact summary grounded only in the supplied context.\",\n  ];\n  return sections.filter((value): value is string => !!value && value.trim().length > 0).join(\"\\n\\n\");\n}\n\nasync function appendActiveRecallTranscript(\n  transcriptRoot: string,\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n  result: ActiveRecallResult,\n  queryBundle: string,\n): Promise<string> {\n  const date = new Date().toISOString().slice(0, 10);\n  const filePath = path.join(\n    transcriptRoot,\n    \"agents\",\n    sanitizeTranscriptPathSegment(input.agentId),\n    date,\n    `${sanitizeTranscriptPathSegment(input.sessionKey)}.jsonl`,\n  );\n  await mkdir(path.dirname(filePath), { recursive: true });\n  await appendFile(\n    filePath,\n    `${JSON.stringify({\n      ts: new Date().toISOString(),\n      sessionKey: input.sessionKey,\n      agentId: input.agentId,\n      queryMode: config.queryMode,\n      promptStyle: config.promptStyle,\n      queryBundle,\n      summary: result.summary,\n      citations: result.citations,\n      latencyMs: result.latencyMs,\n      cacheHit: result.cacheHit,\n      modelUsed: result.modelUsed,\n    })}\\n`,\n    \"utf8\",\n  );\n  return filePath;\n}\n\nexport function createActiveRecallEngine(\n  deps: ActiveRecallDependencies,\n  config: ActiveRecallConfig,\n) {\n  const cache = new Map<string, CachedRecallResult>();\n  const now = deps.now ?? (() => Date.now());\n\n  return {\n    async run(input: ActiveRecallInput): Promise<ActiveRecallResult> {\n      if (!config.enabled) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"disabled\",\n          transcriptPath: null,\n        };\n      }\n      if (config.agents && !config.agents.includes(input.agentId)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n      if (!config.allowedChatTypes.includes(input.chatType)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n\n      const queryBundle = buildActiveRecallQueryBundle(input, config);\n      const cacheKey = buildCacheKey(input, config, queryBundle);\n      const currentTime = now();\n      const cacheEnabled = config.cacheTtlMs > 0;\n      if (cacheEnabled) {\n        pruneExpiredCache(cache, currentTime);\n      }\n      const cached = cache.get(cacheKey);\n      if (cacheEnabled && cached) {\n        return {\n          ...cloneRecallResult(cached.value),\n          latencyMs: Math.max(0, now() - currentTime),\n          cacheHit: true,\n        };\n      }\n\n      const start = currentTime;\n      const recallContext = await deps.recall(queryBundle, input.sessionKey);\n      const graphContext =\n        config.entityGraphDepth > 0 && deps.walkEntityGraph\n          ? await deps.walkEntityGraph({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n              depth: config.entityGraphDepth,\n            })\n          : [];\n      const causalContext =\n        config.includeCausalTrajectories && deps.loadCausalTrajectories\n          ? await deps.loadCausalTrajectories({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n            })\n          : [];\n      const daySummary =\n        config.includeDaySummary && deps.loadDaySummary\n          ? await deps.loadDaySummary(input.sessionKey)\n          : null;\n      const recallExplain =\n        config.attachRecallExplain && deps.explainLastRecall\n          ? await deps.explainLastRecall(input.sessionKey)\n          : null;\n      const prompt = buildActiveRecallPrompt({\n        config,\n        queryBundle,\n        recallContext,\n        graphContext,\n        causalContext,\n        daySummary,\n        recallExplain,\n      });\n\n      const generated = deps.generateSummary\n        ? await deps.generateSummary({\n            prompt,\n            sessionKey: input.sessionKey,\n            agentId: input.agentId,\n            model: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            timeoutMs: config.timeoutMs,\n            thinking: config.thinking,\n            fallbackPolicy: config.modelFallbackPolicy,\n          })\n        : {\n            text: recallContext,\n            modelUsed: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            cacheHit: false,\n          };\n      const summary = normalizeActiveRecallSummary(\n        generated.text,\n        config.maxSummaryChars,\n      );\n      const snapshot = deps.getLastRecallSnapshot?.(input.sessionKey);\n      const citations = (snapshot?.memoryIds ?? []).map((memoryId, index) => ({\n        memoryId,\n        relevance: Number((1 / (index + 1)).toFixed(3)),\n      }));\n      const result: ActiveRecallResult = {\n        summary,\n        citations,\n        latencyMs: Math.max(0, now() - start),\n        cacheHit: generated.cacheHit === true,\n        modelUsed: generated.modelUsed ?? config.modelOverride ?? DEFAULT_REASONING_MODEL,\n        transcriptPath: null,\n      };\n      if (config.persistTranscripts) {\n        try {\n          result.transcriptPath = await appendActiveRecallTranscript(\n            config.transcriptDir,\n            input,\n            config,\n            result,\n            queryBundle,\n          );\n        } catch {\n          result.transcriptPath = null;\n        }\n      }\n\n      if (cacheEnabled) {\n        const completedAt = now();\n        cache.set(cacheKey, {\n          expiresAt: completedAt + config.cacheTtlMs,\n          value: cloneRecallResult(result),\n        });\n        enforceCacheLimit(cache);\n      }\n      return result;\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/claude-code.d.ts

@@ -11,9 +11,13 @@ import { EngramAdapter, AdapterContext, ResolvedIdentity } from './types.js';
  * For HTTP REST (non-MCP) requests, detection relies on User-Agent or
  * user-configured X-Engram-Client-Id header in .claude.json headers.
  *
- * Namespace/principal can be set by configuring custom headers in
+ * Namespace can be set by configuring custom headers in
  * .claude.json or .mcp.json:
- *   "headers": { "X-Engram-Namespace": "my-project", "X-Engram-Principal": "my-team" }
+ *   "headers": { "X-Engram-Namespace": "my-project" }
+ *
+ * Principal overrides are intentionally handled only by the HTTP server's
+ * trustPrincipalHeader gate. Adapters must not independently trust
+ * X-Engram-Principal.
  */
 declare class ClaudeCodeAdapter implements EngramAdapter {
     readonly id = "claude-code";

package/dist/adapters/claude-code.js

@@ -1,7 +1,7 @@
 import {
   ClaudeCodeAdapter
-} from "../chunk-6LVVDPJ4.js";
-import "../chunk-FAJ7FZYM.js";
+} from "../chunk-J64TK33U.js";
+import "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {
   ClaudeCodeAdapter

package/dist/adapters/codex.d.ts

@@ -11,7 +11,11 @@ import { EngramAdapter, AdapterContext, ResolvedIdentity } from './types.js';
  * http_headers in ~/.codex/config.toml:
  *   [mcp_servers.engram]
  *   url = "http://localhost:4318/mcp"
- *   http_headers = { "X-Engram-Namespace" = "my-project", "X-Engram-Principal" = "codex-agent" }
+ *   http_headers = { "X-Engram-Namespace" = "my-project" }
+ *
+ * Principal overrides are intentionally handled only by the HTTP server's
+ * trustPrincipalHeader gate. Adapters must not independently trust
+ * X-Engram-Principal.
  *
  * Codex also sends a custom "sandbox_state" RPC notification after
  * init with sandbox policy info (read-only/writable paths).

package/dist/adapters/codex.js

@@ -1,7 +1,7 @@
 import {
   CodexAdapter
-} from "../chunk-7MNMYOFP.js";
-import "../chunk-FAJ7FZYM.js";
+} from "../chunk-RSUYKGGZ.js";
+import "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {
   CodexAdapter

package/dist/adapters/hermes.js

@@ -1,7 +1,7 @@
 import {
   HermesAdapter
-} from "../chunk-FKFMOY3N.js";
-import "../chunk-FAJ7FZYM.js";
+} from "../chunk-42NQ7AVG.js";
+import "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {
   HermesAdapter