@remnic/core 9.3.671 → 9.3.673

package/dist/access-schema.d.ts

@@ -104,9 +104,9 @@ declare const recallRequestSchema: z.ZodObject<{
     includeLowConfidence: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     query: string;
+    namespace?: string | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
-    namespace?: string | undefined;
     topK?: number | undefined;
     mode?: "auto" | "no_recall" | "minimal" | "full" | "graph_mode" | undefined;
     cwd?: string | undefined;
@@ -125,9 +125,9 @@ declare const recallRequestSchema: z.ZodObject<{
     tagMatch?: "all" | "any" | undefined;
 }, {
     query: string;
+    namespace?: string | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
-    namespace?: string | undefined;
     topK?: number | undefined;
     mode?: "auto" | "no_recall" | "minimal" | "full" | "graph_mode" | undefined;
     cwd?: string | undefined;
@@ -149,11 +149,11 @@ declare const recallExplainRequestSchema: z.ZodObject<{
     sessionKey: z.ZodOptional<z.ZodString>;
     namespace: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
-}, {
     sessionKey?: string | undefined;
+}, {
     namespace?: string | undefined;
+    sessionKey?: string | undefined;
 }>;
 /**
  * Standalone "set coding context" request. Used by the HTTP endpoint
@@ -365,30 +365,30 @@ declare const memoryStoreRequestSchema: z.ZodObject<{
     projectTag: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
     schemaVersion?: number | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
-    confidence?: number | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
     sourceReason?: string | undefined;
     cwd?: string | undefined;
     idempotencyKey?: string | undefined;
     projectTag?: string | undefined;
 }, {
     content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
     schemaVersion?: number | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
-    confidence?: number | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
     sourceReason?: string | undefined;
     cwd?: string | undefined;
     idempotencyKey?: string | undefined;
@@ -411,30 +411,30 @@ declare const suggestionSubmitRequestSchema: z.ZodObject<{
     projectTag: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
     schemaVersion?: number | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
-    confidence?: number | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
     sourceReason?: string | undefined;
     cwd?: string | undefined;
     idempotencyKey?: string | undefined;
     projectTag?: string | undefined;
 }, {
     content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
     schemaVersion?: number | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
-    confidence?: number | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
     sourceReason?: string | undefined;
     cwd?: string | undefined;
     idempotencyKey?: string | undefined;
@@ -468,18 +468,18 @@ declare const trustZonePromoteRequestSchema: z.ZodObject<{
     recordId: string;
     targetZone: "working" | "trusted";
     promotionReason: string;
+    namespace?: string | undefined;
     recordedAt?: string | undefined;
     summary?: string | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
 }, {
     recordId: string;
     targetZone: "working" | "trusted";
     promotionReason: string;
+    namespace?: string | undefined;
     recordedAt?: string | undefined;
     summary?: string | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
 }>;
 declare const trustZoneDemoSeedRequestSchema: z.ZodObject<{
     scenario: z.ZodOptional<z.ZodString>;
@@ -487,14 +487,14 @@ declare const trustZoneDemoSeedRequestSchema: z.ZodObject<{
     dryRun: z.ZodOptional<z.ZodBoolean>;
     namespace: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    namespace?: string | undefined;
     recordedAt?: string | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
     scenario?: string | undefined;
 }, {
+    namespace?: string | undefined;
     recordedAt?: string | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
     scenario?: string | undefined;
 }>;
 declare const lcmSearchRequestSchema: z.ZodObject<{
@@ -505,15 +505,15 @@ declare const lcmSearchRequestSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     query: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
     limit?: number | undefined;
+    sessionKey?: string | undefined;
     sessionPrefix?: string | undefined;
 }, {
     query: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
     limit?: number | undefined;
+    sessionKey?: string | undefined;
     sessionPrefix?: string | undefined;
 }>;
 declare const lcmCompactionFlushRequestSchema: z.ZodObject<{
@@ -548,14 +548,14 @@ declare const daySummaryRequestSchema: z.ZodObject<{
     namespace: z.ZodOptional<z.ZodString>;
     timeZone: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
+    namespace?: string | undefined;
     sessionKey?: string | undefined;
     timeZone?: string | undefined;
-    namespace?: string | undefined;
     memories?: string | undefined;
 }, {
+    namespace?: string | undefined;
     sessionKey?: string | undefined;
     timeZone?: string | undefined;
-    namespace?: string | undefined;
     memories?: string | undefined;
 }>;
 declare const capsuleExportRequestSchema: z.ZodObject<{
@@ -603,11 +603,11 @@ declare const capsuleListRequestSchema: z.ZodObject<{
     namespace: z.ZodOptional<z.ZodString>;
     sessionKey: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
-}, {
     sessionKey?: string | undefined;
+}, {
     namespace?: string | undefined;
+    sessionKey?: string | undefined;
 }>;
 declare const offlineSyncSnapshotRequestSchema: z.ZodObject<{
     namespace: z.ZodOptional<z.ZodString>;
@@ -748,11 +748,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         safety: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodEnum<["safe", "requires-review", "blocked"]>>>, NonNullable<"blocked" | "safe" | "requires-review"> | undefined, "blocked" | "safe" | "requires-review" | null | undefined>;
         safetyReasons: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>, string[] | undefined, string[] | null | undefined>;
     }, "strict", z.ZodTypeAny, {
+        confidence?: number | undefined;
         source?: string | undefined;
         stale?: boolean | undefined;
         created?: string | undefined;
         updated?: string | undefined;
-        confidence?: number | undefined;
         scope?: string | undefined;
         retrievalReason?: string | undefined;
         safety?: NonNullable<"blocked" | "safe" | "requires-review"> | undefined;
@@ -762,11 +762,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         safetyReasons?: string[] | undefined;
         userContextScopes?: string[] | undefined;
     }, {
+        confidence?: number | null | undefined;
         source?: string | null | undefined;
         stale?: boolean | null | undefined;
         created?: string | null | undefined;
         updated?: string | null | undefined;
-        confidence?: number | null | undefined;
         scope?: string | null | undefined;
         retrievalReason?: string | null | undefined;
         safety?: "blocked" | "safe" | "requires-review" | null | undefined;
@@ -776,11 +776,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         safetyReasons?: string[] | null | undefined;
         userContextScopes?: string[] | null | undefined;
     }>, "many">>>, {
+        confidence?: number | undefined;
         source?: string | undefined;
         stale?: boolean | undefined;
         created?: string | undefined;
         updated?: string | undefined;
-        confidence?: number | undefined;
         scope?: string | undefined;
         retrievalReason?: string | undefined;
         safety?: NonNullable<"blocked" | "safe" | "requires-review"> | undefined;
@@ -790,11 +790,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         safetyReasons?: string[] | undefined;
         userContextScopes?: string[] | undefined;
     }[] | undefined, {
+        confidence?: number | null | undefined;
         source?: string | null | undefined;
         stale?: boolean | null | undefined;
         created?: string | null | undefined;
         updated?: string | null | undefined;
-        confidence?: number | null | undefined;
         scope?: string | null | undefined;
         retrievalReason?: string | null | undefined;
         safety?: "blocked" | "safe" | "requires-review" | null | undefined;
@@ -816,11 +816,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         matched?: boolean | undefined;
     }[] | undefined;
     retrievedMemories?: {
+        confidence?: number | undefined;
         source?: string | undefined;
         stale?: boolean | undefined;
         created?: string | undefined;
         updated?: string | undefined;
-        confidence?: number | undefined;
         scope?: string | undefined;
         retrievalReason?: string | undefined;
         safety?: NonNullable<"blocked" | "safe" | "requires-review"> | undefined;
@@ -842,11 +842,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         matched?: boolean | null | undefined;
     }[] | null | undefined;
     retrievedMemories?: {
+        confidence?: number | null | undefined;
         source?: string | null | undefined;
         stale?: boolean | null | undefined;
         created?: string | null | undefined;
         updated?: string | null | undefined;
-        confidence?: number | null | undefined;
         scope?: string | null | undefined;
         retrievalReason?: string | null | undefined;
         safety?: "blocked" | "safe" | "requires-review" | null | undefined;

package/dist/access-schema.js

@@ -25,11 +25,11 @@ import {
   trustZoneDemoSeedRequestSchema,
   trustZonePromoteRequestSchema,
   validateRequest
-} from "./chunk-UDJLF3BO.js";
-import "./chunk-KQAFEZQX.js";
+} from "./chunk-QLRYXOAD.js";
+import "./chunk-IPLYGWQF.js";
+import "./chunk-J4EB7DNW.js";
 import "./chunk-WEHSQBFR.js";
 import "./chunk-X7Y7WX73.js";
-import "./chunk-J4EB7DNW.js";
 import "./chunk-PWWWLD7D.js";
 import "./chunk-UI3NYK34.js";
 import "./chunk-GCGJW34D.js";

package/dist/access-service.js

@@ -3,7 +3,7 @@ import {
   EngramAccessInputError,
   EngramAccessService,
   shapeMemorySummary
-} from "./chunk-TGN4M5MB.js";
+} from "./chunk-ZLINDOBG.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-ARV3AUOM.js";
@@ -17,8 +17,8 @@ import "./chunk-RS25QOKZ.js";
 import "./chunk-JGSKJHF7.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-6VP3YUCS.js";
-import "./chunk-XS2CWEHZ.js";
-import "./chunk-23EBQ27U.js";
+import "./chunk-Q6MIDQEL.js";
+import "./chunk-B55KFEGS.js";
 import "./chunk-OUWAQVDJ.js";
 import "./chunk-DOCTITOP.js";
 import "./chunk-CYEPCZN5.js";
@@ -28,10 +28,10 @@ import "./chunk-AER6MT24.js";
 import "./chunk-RN7MUWON.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
-import "./chunk-CRO4LCQ6.js";
-import "./chunk-7DTASS5T.js";
+import "./chunk-7OGJQP7T.js";
 import "./chunk-E6ZDCOHM.js";
 import "./chunk-OIF36KGD.js";
+import "./chunk-7DTASS5T.js";
 import "./chunk-6RHNCKHG.js";
 import "./chunk-YNQ6DFSV.js";
 import "./chunk-EIR5VLIH.js";
@@ -81,14 +81,14 @@ import "./chunk-2ODBA7MQ.js";
 import "./chunk-PVGDJXVK.js";
 import "./chunk-A2IYSXDQ.js";
 import "./chunk-LPSF4OQH.js";
-import "./chunk-7K5Q6COX.js";
-import "./chunk-LBLXEFWK.js";
+import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
+import "./chunk-LBLXEFWK.js";
 import "./chunk-VFUEZZBS.js";
-import "./chunk-KQAFEZQX.js";
+import "./chunk-IPLYGWQF.js";
+import "./chunk-J4EB7DNW.js";
 import "./chunk-WEHSQBFR.js";
 import "./chunk-X7Y7WX73.js";
-import "./chunk-J4EB7DNW.js";
 import "./chunk-PWWWLD7D.js";
 import "./chunk-UI3NYK34.js";
 import "./chunk-GCGJW34D.js";

package/dist/active-recall.js

@@ -4,10 +4,12 @@ import {
 } from "./chunk-6MKAMLQL.js";
 import {
   DEFAULT_REASONING_MODEL
-} from "./chunk-MLVMBV2C.js";
+} from "./chunk-IUZWBCJX.js";
 import "./chunk-PHK3HARR.js";
 import "./chunk-NDAH7BJ5.js";
 import "./chunk-Z5LAYHGJ.js";
+import "./chunk-QO3AILZN.js";
+import "./chunk-3BQOQYRB.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";

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        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"]}
+{"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/chunk-3BQOQYRB.js

@@ -0,0 +1,33 @@
+import {
+  readEnvVar,
+  resolveHomeDir
+} from "./chunk-JUC24CTX.js";
+
+// src/connectors/paths.ts
+import fs from "fs";
+import path from "path";
+var REGISTRY_DIR_NAME = ".engram-connectors";
+function getConnectorsConfigRoot() {
+  const xdgConfigHome = readEnvVar("XDG_CONFIG_HOME");
+  return xdgConfigHome ? path.join(xdgConfigHome, "engram") : path.join(resolveHomeDir(), ".config", "engram");
+}
+function getRegistryPath() {
+  return path.join(getConnectorsConfigRoot(), REGISTRY_DIR_NAME, "registry.json");
+}
+function getConnectorsDir() {
+  return path.join(getConnectorsConfigRoot(), REGISTRY_DIR_NAME, "connectors");
+}
+function hasLegacyConnectorEntries() {
+  try {
+    return fs.readdirSync(getConnectorsDir()).some((name) => name.endsWith(".json"));
+  } catch {
+    return false;
+  }
+}
+
+export {
+  getRegistryPath,
+  getConnectorsDir,
+  hasLegacyConnectorEntries
+};
+//# sourceMappingURL=chunk-3BQOQYRB.js.map

package/dist/chunk-3BQOQYRB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connectors/paths.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport { readEnvVar, resolveHomeDir } from \"../runtime/env.js\";\n\n/**\n * Connector registry directory name. Kept under the legacy `engram` config\n * root for backward compatibility with existing installs; the rename to a\n * `remnic` path (with a legacy read-fallback) is tracked in #1518.\n */\nexport const REGISTRY_DIR_NAME = \".engram-connectors\";\n\n/**\n * Single source of truth for the connectors config root\n * (`$XDG_CONFIG_HOME/engram` or `~/.config/engram`). Issue #1527 flagged this\n * derivation as previously duplicated across call sites — add new callers\n * here, never re-derive the path inline.\n */\nexport function getConnectorsConfigRoot(): string {\n  const xdgConfigHome = readEnvVar(\"XDG_CONFIG_HOME\");\n  return xdgConfigHome\n    ? path.join(xdgConfigHome, \"engram\")\n    : path.join(resolveHomeDir(), \".config\", \"engram\");\n}\n\n/** Path of the connector registry manifest file. */\nexport function getRegistryPath(): string {\n  return path.join(getConnectorsConfigRoot(), REGISTRY_DIR_NAME, \"registry.json\");\n}\n\n/** Directory holding one `<connector-id>.json` per installed connector. */\nexport function getConnectorsDir(): string {\n  return path.join(getConnectorsConfigRoot(), REGISTRY_DIR_NAME, \"connectors\");\n}\n\n/**\n * Sticky-legacy evidence for `emitLegacyTools` (issue #1550): any persisted\n * connector entry under the legacy engram connectors dir means an existing\n * install whose clients may still address engram_* aliases. Missing or\n * unreadable dir means fresh install — no evidence, no aliases.\n */\nexport function hasLegacyConnectorEntries(): boolean {\n  try {\n    return fs\n      .readdirSync(getConnectorsDir())\n      .some((name) => name.endsWith(\".json\"));\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;;;;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AASV,IAAM,oBAAoB;AAQ1B,SAAS,0BAAkC;AAChD,QAAM,gBAAgB,WAAW,iBAAiB;AAClD,SAAO,gBACH,KAAK,KAAK,eAAe,QAAQ,IACjC,KAAK,KAAK,eAAe,GAAG,WAAW,QAAQ;AACrD;AAGO,SAAS,kBAA0B;AACxC,SAAO,KAAK,KAAK,wBAAwB,GAAG,mBAAmB,eAAe;AAChF;AAGO,SAAS,mBAA2B;AACzC,SAAO,KAAK,KAAK,wBAAwB,GAAG,mBAAmB,YAAY;AAC7E;AAQO,SAAS,4BAAqC;AACnD,MAAI;AACF,WAAO,GACJ,YAAY,iBAAiB,CAAC,EAC9B,KAAK,CAAC,SAAS,KAAK,SAAS,OAAO,CAAC;AAAA,EAC1C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/{chunk-UOBLE67F.js → chunk-3IE22DJ2.js}

@@ -1,3 +1,6 @@
+import {
+  LcmWorkQueue
+} from "./chunk-TPDBFYEG.js";
 import {
   assembleCompressedHistory
 } from "./chunk-KCYE2MZM.js";
@@ -14,9 +17,6 @@ import {
 import {
   LcmDag
 } from "./chunk-7N4KAIGN.js";
-import {
-  LcmWorkQueue
-} from "./chunk-TPDBFYEG.js";
 import {
   log
 } from "./chunk-2ODBA7MQ.js";
@@ -513,4 +513,4 @@ export {
   extractLcmConfig,
   LcmEngine
 };
-//# sourceMappingURL=chunk-UOBLE67F.js.map
+//# sourceMappingURL=chunk-3IE22DJ2.js.map

package/dist/chunk-52LZ42LI.js

@@ -0,0 +1,25 @@
+// src/coding/coding-graph-types.ts
+var CODING_GRAPH_ENGINE_VERSION = "0.1.0-pr1";
+var TIER_1_LANGUAGES = [
+  "typescript",
+  "tsx",
+  "javascript",
+  "python",
+  "go",
+  "rust",
+  "java",
+  "c",
+  "cpp",
+  "csharp",
+  "ruby",
+  "php",
+  "kotlin",
+  "swift",
+  "bash"
+];
+
+export {
+  CODING_GRAPH_ENGINE_VERSION,
+  TIER_1_LANGUAGES
+};
+//# sourceMappingURL=chunk-52LZ42LI.js.map

package/dist/chunk-52LZ42LI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/coding/coding-graph-types.ts"],"sourcesContent":["// Engine contract types for the optional @remnic/coding-graph package.\n//\n// These types are owned by @remnic/core so the base install compiles even\n// when @remnic/coding-graph is not present (it is an optional peer dep —\n// installed only on host machines that opt in to codebase-graph features).\n//\n// @remnic/coding-graph imports these types and implements them; it does\n// not redefine them. This breaks the type-source-direction cycle that\n// would otherwise require core to import coding-graph at compile time\n// (core's tsup DTS phase emits declarations against the package's\n// compiled output, which would fail when the optional package is not\n// installed in CI's base install).\n//\n// Dependency direction:\n//\n//     @remnic/core  ──── owns ───►  CodingGraphEngine (this file)\n//         ▲\n//         │ peer + devDep (workspace)\n//         │\n//     @remnic/coding-graph (implements against these types)\n//\n// Per #1551 PR1 — these are the full contract surface. PR2 fills the\n// extractors; PR3+ lands the walker, determinism, and grammarDir\n// behaviour behind the same `parseFile()` entry point.\n\n// ---------------------------------------------------------------------------\n// Version constant — surfaced through the engine instance so consumers can\n// advertise what they expect. Bumped in lockstep with the package version\n// during active development.\n// ---------------------------------------------------------------------------\nexport const CODING_GRAPH_ENGINE_VERSION = \"0.1.0-pr1\" as const;\n\n// ---------------------------------------------------------------------------\n// Tier-1 language list — declared here so consumers can drive their own\n// tools against the engine without touching the optional package. Order is\n// stable; per-language configuration is the engine's concern.\n// ---------------------------------------------------------------------------\nexport const TIER_1_LANGUAGES = [\n  \"typescript\",\n  \"tsx\",\n  \"javascript\",\n  \"python\",\n  \"go\",\n  \"rust\",\n  \"java\",\n  \"c\",\n  \"cpp\",\n  \"csharp\",\n  \"ruby\",\n  \"php\",\n  \"kotlin\",\n  \"swift\",\n  \"bash\",\n] as const;\n\nexport type CodingGraphLanguage = (typeof TIER_1_LANGUAGES)[number];\n\n// ---------------------------------------------------------------------------\n// Tagged error code — the load-bearing signal for programmatic detection of\n// placeholder / install / load failure states. New codes must be added here\n// so consumers see them via TypeScript.\n// ---------------------------------------------------------------------------\nexport type CodingGraphErrorCode =\n  | \"not_implemented\"\n  | \"module_load_failed\";\n\n// ---------------------------------------------------------------------------\n// Engine interface — the contract coding-graph implements against.\n// ---------------------------------------------------------------------------\nexport interface CodingGraphEngine {\n  /** Engine version reported at construction time. */\n  readonly engineVersion: string;\n  /** Tier-1 languages this build supports (PR2 narrows by grammar availability). */\n  readonly supportedLanguages: readonly CodingGraphLanguage[];\n  /**\n   * Parse a single source file and emit its FileIR.\n   *\n   * PR1 throws `CodingGraphError(\"not_implemented\", …)`. PR2 will return\n   * `ParseResult`; failure paths come back as\n   * `{ ok: false, code: \"parse_failed\", path, message }` (rule 44) rather\n   * than partial / silent IR.\n   */\n  parseFile(input: ParseFileInput): Promise<ParseResult>;\n  /** Engine lifecycle — release any cached parsers/grammars. */\n  dispose(): Promise<void>;\n}\n\n// ---------------------------------------------------------------------------\n// Parse input/output\n// ---------------------------------------------------------------------------\nexport interface ParseFileInput {\n  /** Repository-relative path (forward slashes; no leading `./`). */\n  readonly path: string;\n  /** Raw file bytes; hashing happens inside the engine (rule 23). */\n  readonly content: Uint8Array;\n  /**\n   * Optional override. When omitted the engine sniffs the language from\n   * `path` extensions against its built-in tier-1 list (PR2).\n   */\n  readonly language?: CodingGraphLanguage;\n}\n\nexport type ParseResult =\n  | { readonly ok: true; readonly ir: FileIR }\n  | {\n      readonly ok: false;\n      readonly code: \"parse_failed\";\n      readonly path: string;\n      readonly message: string;\n    };\n\n// ---------------------------------------------------------------------------\n// FileIR — the seam between the parser (optional package) and the graph\n// store (sibling issue #1552). Field types are the minimal viable set per\n// the issue's design section.\n// ---------------------------------------------------------------------------\nexport interface FileIR {\n  readonly path: string;\n  readonly language: CodingGraphLanguage;\n  /** SHA-256 of the raw bytes; rule 23 — every consumer hashes the same form. */\n  readonly contentHash: string;\n  readonly symbols: readonly SymbolIR[];\n  readonly imports: readonly ImportIR[];\n  readonly exports: readonly ExportIR[];\n  readonly callSites: readonly CallSiteIR[];\n  readonly routes: readonly RouteIR[];\n}\n\nexport interface SymbolIR {\n  readonly kind:\n    | \"function\"\n    | \"class\"\n    | \"method\"\n    | \"interface\"\n    | \"enum\"\n    | \"type\"\n    | \"module\";\n  readonly name: string;\n  readonly qualifiedName: string;\n  /** Half-open byte span `[startByte, endByte)`. Rule 35. */\n  readonly span: { readonly startByte: number; readonly endByte: number };\n  readonly parentQualifiedName?: string;\n}\n\nexport interface ImportIR {\n  /** Raw module specifier as written in source. */\n  readonly module: string;\n  readonly importedNames: readonly string[];\n  readonly span: { readonly startByte: number; readonly endByte: number };\n}\n\nexport interface ExportIR {\n  readonly name: string;\n  readonly span: { readonly startByte: number; readonly endByte: number };\n}\n\nexport interface CallSiteIR {\n  readonly calleeNameCandidates: readonly string[];\n  readonly span: { readonly startByte: number; readonly endByte: number };\n}\n\nexport interface RouteIR {\n  /** HTTP verb in upper-case, or framework-native verb (e.g. \"ANY\"). */\n  readonly verb: string;\n  readonly pathTemplate: string;\n  readonly handlerQualifiedName: string;\n  readonly span: { readonly startByte: number; readonly endByte: number };\n}\n\n// ---------------------------------------------------------------------------\n// Factory options\n// ---------------------------------------------------------------------------\n/**\n * Reserved for PR2. Declared now so the public surface is stable; the\n * options object is intentionally empty in PR1.\n */\nexport interface CreateCodingGraphEngineOptions {\n  /** Reserved for PR2: extra grammar directory supplied by the operator. */\n  readonly grammarDir?: never;\n}\n"],"mappings":";AA8BO,IAAM,8BAA8B;AAOpC,IAAM,mBAAmB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}

package/dist/{chunk-CRO4LCQ6.js → chunk-7OGJQP7T.js}

@@ -1,7 +1,3 @@
-import {
-  searchConversationIndex,
-  searchConversationIndexFaissFailOpen
-} from "./chunk-7DTASS5T.js";
 import {
   failOpenFaissHealth
 } from "./chunk-E6ZDCOHM.js";
@@ -9,6 +5,10 @@ import {
   rebuildConversationChunksFailOpen,
   upsertConversationChunksFailOpen
 } from "./chunk-OIF36KGD.js";
+import {
+  searchConversationIndex,
+  searchConversationIndexFaissFailOpen
+} from "./chunk-7DTASS5T.js";
 
 // src/conversation-index/backend.ts
 function createConversationIndexBackend(options) {
@@ -235,4 +235,4 @@ function createFaissBackend(getFaiss) {
 export {
   createConversationIndexBackend
 };
-//# sourceMappingURL=chunk-CRO4LCQ6.js.map
+//# sourceMappingURL=chunk-7OGJQP7T.js.map

package/dist/{chunk-23EBQ27U.js → chunk-B55KFEGS.js}

@@ -18,7 +18,7 @@ import {
 } from "./chunk-RN7MUWON.js";
 import {
   createConversationIndexBackend
-} from "./chunk-CRO4LCQ6.js";
+} from "./chunk-7OGJQP7T.js";
 import {
   FaissConversationIndexAdapter
 } from "./chunk-E6ZDCOHM.js";
@@ -170,4 +170,4 @@ export {
   createConversationSearchBackend,
   createConversationIndexRuntime
 };
-//# sourceMappingURL=chunk-23EBQ27U.js.map
+//# sourceMappingURL=chunk-B55KFEGS.js.map