@remnic/core 9.3.613 → 9.3.615

package/dist/access-schema.d.ts

@@ -111,8 +111,8 @@ declare const recallRequestSchema: z.ZodObject<{
     mode?: "no_recall" | "minimal" | "full" | "graph_mode" | "auto" | undefined;
     cwd?: string | undefined;
     includeLowConfidence?: boolean | undefined;
-    disclosure?: "chunk" | "section" | "raw" | undefined;
     idempotencyKey?: string | undefined;
+    disclosure?: "chunk" | "section" | "raw" | undefined;
     asOf?: string | undefined;
     includeDebug?: boolean | undefined;
     codingContext?: {
@@ -132,8 +132,8 @@ declare const recallRequestSchema: z.ZodObject<{
     mode?: "no_recall" | "minimal" | "full" | "graph_mode" | "auto" | undefined;
     cwd?: string | undefined;
     includeLowConfidence?: boolean | undefined;
-    disclosure?: "chunk" | "section" | "raw" | undefined;
     idempotencyKey?: string | undefined;
+    disclosure?: "chunk" | "section" | "raw" | undefined;
     asOf?: string | undefined;
     includeDebug?: boolean | undefined;
     codingContext?: {
@@ -241,20 +241,20 @@ declare const observeRequestSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             kind: "text" | "tool_call" | "tool_result" | "patch" | "file_read" | "file_write" | "step_start" | "step_finish" | "snapshot" | "retry";
             payload: Record<string, unknown>;
-            tool_name?: string | null | undefined;
+            ordinal?: number | null | undefined;
             toolName?: string | null | undefined;
+            tool_name?: string | null | undefined;
             filePath?: string | null | undefined;
-            ordinal?: number | null | undefined;
             file_path?: string | null | undefined;
             createdAt?: string | null | undefined;
             created_at?: string | null | undefined;
         }, {
             kind: "text" | "tool_call" | "tool_result" | "patch" | "file_read" | "file_write" | "step_start" | "step_finish" | "snapshot" | "retry";
             payload: Record<string, unknown>;
-            tool_name?: string | null | undefined;
+            ordinal?: number | null | undefined;
             toolName?: string | null | undefined;
+            tool_name?: string | null | undefined;
             filePath?: string | null | undefined;
-            ordinal?: number | null | undefined;
             file_path?: string | null | undefined;
             createdAt?: string | null | undefined;
             created_at?: string | null | undefined;
@@ -265,10 +265,10 @@ declare const observeRequestSchema: z.ZodObject<{
         parts?: {
             kind: "text" | "tool_call" | "tool_result" | "patch" | "file_read" | "file_write" | "step_start" | "step_finish" | "snapshot" | "retry";
             payload: Record<string, unknown>;
-            tool_name?: string | null | undefined;
+            ordinal?: number | null | undefined;
             toolName?: string | null | undefined;
+            tool_name?: string | null | undefined;
             filePath?: string | null | undefined;
-            ordinal?: number | null | undefined;
             file_path?: string | null | undefined;
             createdAt?: string | null | undefined;
             created_at?: string | null | undefined;
@@ -281,10 +281,10 @@ declare const observeRequestSchema: z.ZodObject<{
         parts?: {
             kind: "text" | "tool_call" | "tool_result" | "patch" | "file_read" | "file_write" | "step_start" | "step_finish" | "snapshot" | "retry";
             payload: Record<string, unknown>;
-            tool_name?: string | null | undefined;
+            ordinal?: number | null | undefined;
             toolName?: string | null | undefined;
+            tool_name?: string | null | undefined;
             filePath?: string | null | undefined;
-            ordinal?: number | null | undefined;
             file_path?: string | null | undefined;
             createdAt?: string | null | undefined;
             created_at?: string | null | undefined;
@@ -309,10 +309,10 @@ declare const observeRequestSchema: z.ZodObject<{
         parts?: {
             kind: "text" | "tool_call" | "tool_result" | "patch" | "file_read" | "file_write" | "step_start" | "step_finish" | "snapshot" | "retry";
             payload: Record<string, unknown>;
-            tool_name?: string | null | undefined;
+            ordinal?: number | null | undefined;
             toolName?: string | null | undefined;
+            tool_name?: string | null | undefined;
             filePath?: string | null | undefined;
-            ordinal?: number | null | undefined;
             file_path?: string | null | undefined;
             createdAt?: string | null | undefined;
             created_at?: string | null | undefined;
@@ -332,10 +332,10 @@ declare const observeRequestSchema: z.ZodObject<{
         parts?: {
             kind: "text" | "tool_call" | "tool_result" | "patch" | "file_read" | "file_write" | "step_start" | "step_finish" | "snapshot" | "retry";
             payload: Record<string, unknown>;
-            tool_name?: string | null | undefined;
+            ordinal?: number | null | undefined;
             toolName?: string | null | undefined;
+            tool_name?: string | null | undefined;
             filePath?: string | null | undefined;
-            ordinal?: number | null | undefined;
             file_path?: string | null | undefined;
             createdAt?: string | null | undefined;
             created_at?: string | null | undefined;
@@ -361,6 +361,8 @@ declare const memoryStoreRequestSchema: z.ZodObject<{
     entityRef: z.ZodOptional<z.ZodString>;
     ttl: z.ZodOptional<z.ZodString>;
     sourceReason: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    projectTag: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     content: string;
     schemaVersion?: number | undefined;
@@ -373,7 +375,9 @@ declare const memoryStoreRequestSchema: z.ZodObject<{
     entityRef?: string | undefined;
     ttl?: string | undefined;
     sourceReason?: string | undefined;
+    cwd?: string | undefined;
     idempotencyKey?: string | undefined;
+    projectTag?: string | undefined;
 }, {
     content: string;
     schemaVersion?: number | undefined;
@@ -386,7 +390,9 @@ declare const memoryStoreRequestSchema: z.ZodObject<{
     entityRef?: string | undefined;
     ttl?: string | undefined;
     sourceReason?: string | undefined;
+    cwd?: string | undefined;
     idempotencyKey?: string | undefined;
+    projectTag?: string | undefined;
 }>;
 declare const suggestionSubmitRequestSchema: z.ZodObject<{
     schemaVersion: z.ZodOptional<z.ZodNumber>;
@@ -401,6 +407,8 @@ declare const suggestionSubmitRequestSchema: z.ZodObject<{
     entityRef: z.ZodOptional<z.ZodString>;
     ttl: z.ZodOptional<z.ZodString>;
     sourceReason: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    projectTag: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     content: string;
     schemaVersion?: number | undefined;
@@ -413,7 +421,9 @@ declare const suggestionSubmitRequestSchema: z.ZodObject<{
     entityRef?: string | undefined;
     ttl?: string | undefined;
     sourceReason?: string | undefined;
+    cwd?: string | undefined;
     idempotencyKey?: string | undefined;
+    projectTag?: string | undefined;
 }, {
     content: string;
     schemaVersion?: number | undefined;
@@ -426,7 +436,9 @@ declare const suggestionSubmitRequestSchema: z.ZodObject<{
     entityRef?: string | undefined;
     ttl?: string | undefined;
     sourceReason?: string | undefined;
+    cwd?: string | undefined;
     idempotencyKey?: string | undefined;
+    projectTag?: string | undefined;
 }>;
 declare const reviewDispositionRequestSchema: z.ZodObject<{
     memoryId: z.ZodString;

package/dist/access-schema.js

@@ -25,10 +25,10 @@ import {
   trustZoneDemoSeedRequestSchema,
   trustZonePromoteRequestSchema,
   validateRequest
-} from "./chunk-PPPZY2EU.js";
-import "./chunk-KQAFEZQX.js";
+} from "./chunk-WD2W4234.js";
+import "./chunk-VDX2J7OX.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-X7Y7WX73.js";
+import "./chunk-DQEMWVMT.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";

package/dist/{access-service-D2J9dh_9.d.ts → access-service-CBNEKjzN.d.ts}

@@ -6,7 +6,7 @@ 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, I as IntentDebugSnapshot, G as GraphRecallSnapshot, P as PatternReinforcementResult } from './orchestrator-DTRQG75J.js';
+import { O as Orchestrator, I as IntentDebugSnapshot, G as GraphRecallSnapshot, P as PatternReinforcementResult } from './orchestrator-CqWOjfgl.js';
 import { LiveConnectorsRunSummary } from './live-connectors-runner.js';
 import { LastRecallSnapshot } from './recall-state.js';
 import { GraphSnapshotRequest, GraphSnapshotResponse } from './graph-snapshot.js';
@@ -644,9 +644,18 @@ interface EngramAccessWriteEnvelope {
      */
     authenticatedPrincipal?: string;
 }
-interface EngramAccessMemoryStoreRequest extends EngramAccessWriteEnvelope, ExplicitCaptureInput {
+/**
+ * Optional git/project context for project-scoped writes (#1434). When no
+ * explicit `namespace` is supplied, these route the write to the same project
+ * namespace recall/observe resolve from `cwd`/`projectTag` (rule 42 symmetry).
+ */
+interface CodingScopedWriteInput {
+    cwd?: string;
+    projectTag?: string;
 }
-interface EngramAccessSuggestionSubmitRequest extends EngramAccessWriteEnvelope, ExplicitCaptureInput {
+interface EngramAccessMemoryStoreRequest extends EngramAccessWriteEnvelope, ExplicitCaptureInput, CodingScopedWriteInput {
+}
+interface EngramAccessSuggestionSubmitRequest extends EngramAccessWriteEnvelope, ExplicitCaptureInput, CodingScopedWriteInput {
 }
 interface EngramAccessWriteResponse {
     schemaVersion: 1;
@@ -774,6 +783,47 @@ declare class EngramAccessService {
     private resolveRecallNamespace;
     private resolveRequestPrincipal;
     private resolveWritableNamespace;
+    /**
+     * Resolve a coding context from `cwd`/`projectTag` WITHOUT persisting it to
+     * any session — the read-only half of `maybeAttachCodingContext`. Returns
+     * null when project scoping is off or nothing resolves. `projectTag` takes
+     * priority over `cwd` (matching `maybeAttachCodingContext`).
+     */
+    private resolveCodingContextFromOptions;
+    /**
+     * Resolve the write namespace for explicit-write tools (memory_store /
+     * suggestion_submit), project-scoping the write the same way recall does so a
+     * memory stored with a client-injected `cwd`/`projectTag` is discoverable by
+     * project-scoped recall (#1434, rule 42).
+     *
+     * Precedence:
+     *  - An explicit `namespace` always wins and is authorized strictly via
+     *    `resolveWritableNamespace` → `canWriteNamespace`. A coding-overlay
+     *    namespace string (`<base>-project-*`) is NOT a writable target via the
+     *    explicit field — project scoping is requested with `cwd`/`projectTag`,
+     *    never by naming the derived namespace — so there is no way to bypass the
+     *    policy allow-list by guessing/forging an overlay name (Codex review).
+     *  - With NO coding overlay, the write stays on `config.defaultNamespace` —
+     *    exactly the pre-#1434 behavior, so an unqualified write is NOT silently
+     *    moved to a principal self namespace (Codex review).
+     *  - WITH a coding overlay, the base is the principal self namespace
+     *    (`defaultNamespaceForPrincipal`, write-checked) — the SAME base recall,
+     *    observe, and the orchestrator buffer-flush write path overlay onto
+     *    (rule 42 / Cursor) — so a project-scoped store lands exactly where
+     *    project-scoped recall searches. The overlay namespace is always REBUILT
+     *    from the authenticated principal's base, never accepted as a caller
+     *    string, so a caller can never reach another principal's subtree.
+     *
+     * Read-only: this NEVER mutates session coding context, so the idempotency
+     * peeks and dryRun preflights that call it stay side-effect free (Codex
+     * review). It prefers the per-call `cwd`/`projectTag` (the project explicitly
+     * identified for this write), else the session's existing context. The HTTP
+     * surface lets the peek and the write each resolve independently; the peek's
+     * namespace only gates rate-limiting (memory_store/suggestion_submit run their
+     * own idempotency check), so a benign session-context change between the two
+     * never fails a write — there is no namespace to "pin".
+     */
+    private resolveCodingScopedWriteNamespace;
     private objectiveStateStoreLocationForNamespace;
     private resolveReadableNamespace;
     private buildRecallDebug;
@@ -831,6 +881,17 @@ declare class EngramAccessService {
      * being in a repo is a normal runtime state.
      */
     private maybeAttachCodingContext;
+    /**
+     * Seed the session's coding binding AFTER a committed, project-scoped explicit
+     * write (memory_store / suggestion_submit), mirroring the recall path's
+     * `maybeAttachCodingContext` so a later bare recall/write on the same session
+     * is scoped to the same project. Called only from the post-persist path, so it
+     * never fires on dryRun, replay/conflict, or quota-rejected requests. Skips
+     * when an explicit `namespace` was supplied — that write bypassed the coding
+     * overlay, so binding the session to a project it never wrote to would make
+     * later bare recalls miss (Codex review).
+     */
+    private attachCodingContextAfterScopedWrite;
     recall(request: EngramAccessRecallRequest): Promise<EngramAccessRecallResponse>;
     private executeRecall;
     recallExplain(request?: EngramAccessRecallExplainRequest): Promise<EngramAccessRecallExplainResponse>;
@@ -889,9 +950,13 @@ declare class EngramAccessService {
         recall?: EngramAccessRecallResponse;
     }>;
     private xrayQueue;
-    memoryStore(request: EngramAccessMemoryStoreRequest): Promise<EngramAccessWriteResponse>;
+    memoryStore(request: EngramAccessMemoryStoreRequest, hooks?: {
+        enforceWriteQuota?: () => void | Promise<void>;
+    }): Promise<EngramAccessWriteResponse>;
     peekMemoryStoreIdempotency(request: EngramAccessMemoryStoreRequest): Promise<EngramAccessIdempotencyStatus>;
-    suggestionSubmit(request: EngramAccessSuggestionSubmitRequest): Promise<EngramAccessWriteResponse>;
+    suggestionSubmit(request: EngramAccessSuggestionSubmitRequest, hooks?: {
+        enforceWriteQuota?: () => void | Promise<void>;
+    }): Promise<EngramAccessWriteResponse>;
     peekSuggestionSubmitIdempotency(request: EngramAccessSuggestionSubmitRequest): Promise<EngramAccessIdempotencyStatus>;
     private validateWriteCandidate;
     memoryGet(memoryId: string, namespace?: string, principal?: string): Promise<EngramAccessMemoryResponse>;
@@ -1489,4 +1554,4 @@ declare class EngramAccessService {
     }): Promise<DreamsRunResult>;
 }
 
-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 };
+export { type EngramAccessReviewDispositionRequest as $, type EngramAccessMemoryBrowseRequest as A, type EngramAccessMemoryBrowseResponse as B, type CodingScopedWriteInput as C, type EngramAccessMemoryRecord as D, EngramAccessService as E, type EngramAccessMemoryResponse as F, type EngramAccessMemoryStoreRequest as G, type EngramAccessMemorySummary as H, type EngramAccessObserveMessage as I, type EngramAccessObserveRequest as J, type EngramAccessObserveResponse as K, type EngramAccessOfflineSyncApplyFileContentRequest as L, type EngramAccessOfflineSyncApplyFileContentResponse as M, type EngramAccessOfflineSyncApplyRequest as N, type EngramAccessOfflineSyncApplyResponse as O, type ProcedureStatsConfigSnapshot as P, type EngramAccessOfflineSyncFileContentRequest as Q, type EngramAccessOfflineSyncFileContentResponse as R, type EngramAccessOfflineSyncFilesRequest as S, type EngramAccessOfflineSyncFilesResponse as T, type EngramAccessOfflineSyncSnapshotRequest as U, type EngramAccessOfflineSyncSnapshotResponse as V, type EngramAccessOfflineSyncSnapshotStreamResponse as W, type EngramAccessQualityResponse as X, type EngramAccessRecallExplainRequest as Y, type EngramAccessRecallExplainResponse as Z, type EngramAccessRecallRequest as _, type EngramAccessRecallResponse as a, type EngramAccessReviewDispositionResponse as a0, type EngramAccessReviewQueueResponse as a1, type EngramAccessSetCodingContextRequest as a2, type EngramAccessSuggestionSubmitRequest as a3, type EngramAccessTimelineResponse as a4, type EngramAccessTrustZoneBrowseRequest as a5, type EngramAccessTrustZoneBrowseResponse as a6, type EngramAccessTrustZoneDemoSeedRequest as a7, type EngramAccessTrustZoneDemoSeedResponse as a8, type EngramAccessTrustZonePromoteRequest as a9, type EngramAccessTrustZonePromoteResponse as aa, type EngramAccessTrustZoneRecordSummary as ab, type EngramAccessTrustZoneStatusResponse as ac, type EngramAccessWriteEnvelope as ad, type EngramAccessWriteResponse as ae, shapeMemorySummary as af, 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,13 +1,13 @@
 import './storage.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-D2J9dh_9.js';
+export { C as CodingScopedWriteInput, 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, D as EngramAccessMemoryRecord, F as EngramAccessMemoryResponse, G as EngramAccessMemoryStoreRequest, H as EngramAccessMemorySummary, I as EngramAccessObserveMessage, J as EngramAccessObserveRequest, K as EngramAccessObserveResponse, L as EngramAccessOfflineSyncApplyFileContentRequest, M as EngramAccessOfflineSyncApplyFileContentResponse, N as EngramAccessOfflineSyncApplyRequest, O as EngramAccessOfflineSyncApplyResponse, Q as EngramAccessOfflineSyncFileContentRequest, R as EngramAccessOfflineSyncFileContentResponse, S as EngramAccessOfflineSyncFilesRequest, T as EngramAccessOfflineSyncFilesResponse, U as EngramAccessOfflineSyncSnapshotRequest, V as EngramAccessOfflineSyncSnapshotResponse, W as EngramAccessOfflineSyncSnapshotStreamResponse, X as EngramAccessQualityResponse, Y as EngramAccessRecallExplainRequest, Z as EngramAccessRecallExplainResponse, _ as EngramAccessRecallRequest, a as EngramAccessRecallResponse, $ as EngramAccessReviewDispositionRequest, a0 as EngramAccessReviewDispositionResponse, a1 as EngramAccessReviewQueueResponse, E as EngramAccessService, a2 as EngramAccessSetCodingContextRequest, a3 as EngramAccessSuggestionSubmitRequest, a4 as EngramAccessTimelineResponse, a5 as EngramAccessTrustZoneBrowseRequest, a6 as EngramAccessTrustZoneBrowseResponse, a7 as EngramAccessTrustZoneDemoSeedRequest, a8 as EngramAccessTrustZoneDemoSeedResponse, a9 as EngramAccessTrustZonePromoteRequest, aa as EngramAccessTrustZonePromoteResponse, ab as EngramAccessTrustZoneRecordSummary, ac as EngramAccessTrustZoneStatusResponse, ad as EngramAccessWriteEnvelope, ae as EngramAccessWriteResponse, af as shapeMemorySummary } from './access-service-CBNEKjzN.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-DTRQG75J.js';
+import './orchestrator-CqWOjfgl.js';
 import './live-connectors-runner.js';
 import './recall-state.js';
 import './graph-snapshot.js';

package/dist/access-service.js

@@ -3,20 +3,20 @@ import {
   EngramAccessInputError,
   EngramAccessService,
   shapeMemorySummary
-} from "./chunk-2QANQKSQ.js";
-import "./chunk-ETUPBUHB.js";
-import "./chunk-L227SKTB.js";
-import "./chunk-DHGSZ3UD.js";
-import "./chunk-BT7NVCML.js";
-import "./chunk-OXJBNGBK.js";
+} from "./chunk-ZK32E74R.js";
+import "./chunk-GDASG7NC.js";
+import "./chunk-GDB4J2H3.js";
+import "./chunk-DGNQRNLL.js";
+import "./chunk-PSUB67YB.js";
 import "./chunk-SOBJ6NEY.js";
+import "./chunk-BT7NVCML.js";
 import "./chunk-H7XKCNR6.js";
-import "./chunk-OI27U2HT.js";
+import "./chunk-5BTCT236.js";
 import "./chunk-EDQVAMQI.js";
 import "./chunk-JGSKJHF7.js";
-import "./chunk-FXKPZ3H6.js";
-import "./chunk-WSGF57U2.js";
-import "./chunk-XKIQZXUB.js";
+import "./chunk-BPSGLMQ4.js";
+import "./chunk-JQDZQ4TB.js";
+import "./chunk-CI7RKSRE.js";
 import "./chunk-UEY3VB6W.js";
 import "./chunk-EIR5VLIH.js";
 import "./chunk-7V2SGZ3H.js";
@@ -24,16 +24,16 @@ import "./chunk-EI6V5UXY.js";
 import "./chunk-QY7YA7OL.js";
 import "./chunk-NNVTUXEB.js";
 import "./chunk-QDW3E4RD.js";
-import "./chunk-EUML3N6B.js";
-import "./chunk-CHCA44C3.js";
+import "./chunk-IMA6GU4Y.js";
+import "./chunk-ODPLEWB6.js";
 import "./chunk-XL7FK7PJ.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
-import "./chunk-QDDHYAKV.js";
-import "./chunk-YFS5OEKO.js";
+import "./chunk-AZDOWD2L.js";
+import "./chunk-7MLB4NCL.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-4H5ZJHEN.js";
-import "./chunk-KGK2QKWL.js";
+import "./chunk-4R4KTDIE.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-KILOTVIF.js";
@@ -60,9 +60,9 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-VFUEZZBS.js";
-import "./chunk-KQAFEZQX.js";
+import "./chunk-VDX2J7OX.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-X7Y7WX73.js";
+import "./chunk-DQEMWVMT.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";

package/dist/active-recall.js

@@ -4,7 +4,7 @@ import {
 } from "./chunk-6MKAMLQL.js";
 import {
   DEFAULT_REASONING_MODEL
-} from "./chunk-NZPF2SYV.js";
+} from "./chunk-T7N6KQGS.js";
 import "./chunk-PHK3HARR.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-4DJQYKMN.js";
@@ -230,11 +230,26 @@ function createActiveRecallEngine(deps, config) {
       }
       const cached = cache.get(cacheKey);
       if (cacheEnabled && cached) {
-        return {
+        const result2 = {
           ...cloneRecallResult(cached.value),
           latencyMs: Math.max(0, now() - currentTime),
           cacheHit: true
         };
+        result2.transcriptPath = null;
+        if (config.persistTranscripts) {
+          try {
+            result2.transcriptPath = await appendActiveRecallTranscript(
+              config.transcriptDir,
+              input,
+              config,
+              result2,
+              queryBundle
+            );
+          } catch {
+            result2.transcriptPath = null;
+          }
+        }
+        return result2;
       }
       const start = currentTime;
       const recallContext = await deps.recall(queryBundle, input.sessionKey);
@@ -303,9 +318,11 @@ function createActiveRecallEngine(deps, config) {
       }
       if (cacheEnabled) {
         const completedAt = now();
+        const cachedValue = cloneRecallResult(result);
+        cachedValue.transcriptPath = null;
         cache.set(cacheKey, {
           expiresAt: completedAt + config.cacheTtlMs,
-          value: cloneRecallResult(result)
+          value: cachedValue
         });
         enforceCacheLimit(cache);
       }

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        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":[]}
+{"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        const result: ActiveRecallResult = {\n          ...cloneRecallResult(cached.value),\n          latencyMs: Math.max(0, now() - currentTime),\n          cacheHit: true,\n        };\n        result.transcriptPath = null;\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        return result;\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        const cachedValue = cloneRecallResult(result);\n        cachedValue.transcriptPath = null;\n        cache.set(cacheKey, {\n          expiresAt: completedAt + config.cacheTtlMs,\n          value: cachedValue,\n        });\n        enforceCacheLimit(cache);\n      }\n      return result;\n    },\n  };\n}\n"],"mappings":"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","names":["result"]}

package/dist/adapters/index.js

@@ -1,7 +1,10 @@
 import "../chunk-SEDEKFYQ.js";
 import {
   AdapterRegistry
-} from "../chunk-AU7Q3LSC.js";
+} from "../chunk-2QSZNTDO.js";
+import {
+  CodexAdapter
+} from "../chunk-RSUYKGGZ.js";
 import {
   HermesAdapter
 } from "../chunk-42NQ7AVG.js";
@@ -11,9 +14,6 @@ import {
 import {
   ClaudeCodeAdapter
 } from "../chunk-J64TK33U.js";
-import {
-  CodexAdapter
-} from "../chunk-RSUYKGGZ.js";
 import "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/adapters/registry.js

@@ -1,10 +1,10 @@
 import {
   AdapterRegistry
-} from "../chunk-AU7Q3LSC.js";
+} from "../chunk-2QSZNTDO.js";
+import "../chunk-RSUYKGGZ.js";
 import "../chunk-42NQ7AVG.js";
 import "../chunk-TMSXWOBZ.js";
 import "../chunk-J64TK33U.js";
-import "../chunk-RSUYKGGZ.js";
 import "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/behavior-learner.js

@@ -51,13 +51,12 @@ function aggregateSignalPressure(signals) {
   return Math.max(-1, Math.min(1, net / signals.length));
 }
 function selectRecentSignals(input) {
-  if (input.learningWindowDays <= 0) return [...input.signals];
   const nowMs = (input.now ?? /* @__PURE__ */ new Date()).getTime();
-  const minTs = nowMs - input.learningWindowDays * 864e5;
+  const minTs = input.learningWindowDays <= 0 ? Number.NEGATIVE_INFINITY : nowMs - input.learningWindowDays * 864e5;
   return input.signals.filter((signal) => {
     const ts = Date.parse(signal.timestamp);
     if (!Number.isFinite(ts)) return false;
-    return ts >= minTs;
+    return ts >= minTs && ts <= nowMs;
   });
 }
 function parameterDirection(parameter, pressure) {