@xopcai/xopc 0.0.142 → 0.0.143

package/dist/src/agent/goals/post-turn.js

@@ -102,8 +102,9 @@ async function handlePersistentGoalPostTurn(opts) {
 		uiLocale: resolveGoalUiLocale(state)
 	});
 	const completionReadiness = goalService.getCompletionReadiness(goal.id);
-	if (decision.verdict === "done" && completionReadiness && !completionReadiness.ready && decision.newState) {
-		const reason = `Completion evidence still needed: ${completionReadiness.missingEvidence.join("; ")}`;
+	const executionGaps = completionReadiness ? [...completionReadiness.missingEvidence, ...completionReadiness.pendingOutcome] : [];
+	if (decision.verdict === "done" && executionGaps.length > 0 && decision.newState) {
+		const reason = `Completion evidence or outcome still needed: ${executionGaps.join("; ")}`;
 		decision = {
 			...decision,
 			newState: {
@@ -113,11 +114,11 @@ async function handlePersistentGoalPostTurn(opts) {
 				lastReason: reason
 			},
 			shouldContinue: true,
-			continuationPrompt: `Before declaring the goal complete, collect this evidence:\n${completionReadiness.missingEvidence.map((item) => `- ${item}`).join("\n")}`,
+			continuationPrompt: `Before declaring the goal complete, address these gaps:\n${executionGaps.map((item) => `- ${item}`).join("\n")}`,
 			verdict: "continue",
 			reason,
 			message: reason,
-			missingEvidence: completionReadiness.missingEvidence
+			missingEvidence: executionGaps
 		};
 	}
 	if (decision.newState) {

package/dist/src/agent/goals/post-turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"post-turn.js","names":[],"sources":["../../../../src/agent/goals/post-turn.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config, GoalsConfig } from '../../config/schema.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../../config/agent-profile.js';\nimport { GoalService } from '../../goals/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport { evaluateAfterTurnHermesLike } from './evaluate-turn.js';\nimport { resolveGoalUiLocale } from './goal-locale.js';\nimport type { PersistentGoalApis } from './persistent-goal-apis.js';\nimport type { PersistentGoalState } from './state.js';\n\nconst log = createLogger('PersistentGoal');\nconst goalService = new GoalService();\n\nfunction buildHistoryExcerpt(messages: AgentMessage[], maxChars: number): string {\n  if (maxChars <= 0) return '';\n  try {\n    const raw = JSON.stringify(messages);\n    if (raw.length <= maxChars) return raw;\n    return raw.slice(-maxChars);\n  } catch {\n    return '';\n  }\n}\n\nfunction buildGoalContextText(goal: NonNullable<ReturnType<GoalService['get']>>): string {\n  const lines = [`Title: ${goal.contract?.objective || goal.title}`];\n  if (goal.contract?.scopeBoundary) {\n    lines.push(`Scope boundary:\\n${goal.contract.scopeBoundary}`);\n  }\n  if (goal.contract?.evidencePlan.length) {\n    lines.push(`Expected completion evidence:\\n${goal.contract.evidencePlan.map((item) => `- ${item}`).join('\\n')}`);\n  }\n  if (goal.contextMessage?.text.trim()) {\n    lines.push(`Context:\\n${goal.contextMessage.text.trim()}`);\n  }\n  if (goal.contextMessage?.attachments.length) {\n    lines.push(\n      [\n        'Attachments:',\n        ...goal.contextMessage.attachments.map((attachment) =>\n          `- ${attachment.name} (${attachment.mimeType}, ${attachment.size} bytes) ${attachment.uri}`,\n        ),\n      ].join('\\n'),\n    );\n  }\n  return lines.join('\\n\\n');\n}\n\nfunction resolveJudgeModelRef(\n  config: Config | undefined,\n  sessionKey: string,\n  storedJudge?: string,\n  runtimeSessionModelRef?: string,\n): string | undefined {\n  const fromCfg = config?.goals?.judgeModelRef?.trim();\n  if (fromCfg) return fromCfg;\n  if (storedJudge?.trim()) return storedJudge.trim();\n  if (config) {\n    const profile = resolveEffectiveAgentProfileForSession(config, sessionKey);\n    if (profile.primaryModelRef?.trim()) return profile.primaryModelRef.trim();\n  }\n  if (runtimeSessionModelRef?.trim()) return runtimeSessionModelRef.trim();\n  if (config) return getAgentDefaultModelRef(config);\n  return undefined;\n}\n\nexport function shouldRunInitialChecklistDecomposition(input: {\n  checklistLength: number;\n  turnsUsed: number;\n  checklistDecomposePolicy?: GoalsConfig['checklistDecomposePolicy'];\n}): boolean {\n  if (input.checklistLength === 0) return true;\n  return input.checklistDecomposePolicy === 'supplement_existing' && input.turnsUsed === 0;\n}\n\nasync function appendAssistantLine(apis: PersistentGoalApis, sessionKey: string, text: string): Promise<void> {\n  await apis.appendAssistantReceipt(sessionKey, text);\n}\n\nexport async function handlePersistentGoalPostTurn(opts: {\n  apis: PersistentGoalApis;\n  sessionKey: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn: boolean;\n  config: Config | undefined;\n  /** Active session model (overrides, per-agent defaults) when goals/global defaults are unset. */\n  runtimeSessionModelRef?: string;\n  signal?: AbortSignal;\n  /** Hermes-style: verdict line also sent as a normal outbound message (non-webchat). */\n  publishVerdictToChannel?: (text: string) => Promise<void>;\n  onGoalStatusUpdated?: (payload: {\n    goalId: string;\n    sessionKey: string;\n    previousStatus: string;\n    status: string;\n    goal: import('../../goals/types.js').GoalWithDetails;\n  }) => void;\n}): Promise<void> {\n  const {\n    apis,\n    sessionKey,\n    assistantPlainText,\n    aborted,\n    streamError,\n    skipPersistentGoalPostTurn,\n    config,\n    runtimeSessionModelRef,\n    signal,\n    publishVerdictToChannel,\n    onGoalStatusUpdated,\n  } = opts;\n\n  if (skipPersistentGoalPostTurn) return;\n  if (aborted || streamError) return;\n\n  const meta = await apis.getSessionMetadata(sessionKey);\n  if (!meta) return;\n\n  const goal = goalService.getActiveForSession(sessionKey);\n  if (!goal || goal.status !== 'active') return;\n\n  const goalsCfg = config?.goals;\n  const shouldDecomposeChecklist = shouldRunInitialChecklistDecomposition({\n    checklistLength: goal.checklist.length,\n    turnsUsed: goal.turnsUsed,\n    checklistDecomposePolicy: goalsCfg?.checklistDecomposePolicy,\n  });\n  const state: PersistentGoalState = {\n    goal: buildGoalContextText(goal),\n    status: 'active',\n    turnsUsed: goal.turnsUsed,\n    maxTurns: goal.maxTurns,\n    createdAt: goal.createdAt,\n    lastTurnAt: goal.updatedAt,\n    lastReason: goal.blockedReason,\n    judgeModelRef: goal.judgeModelRef,\n    decomposed: shouldDecomposeChecklist ? undefined : true,\n    uiLocale: goal.uiLocale,\n    checklist: goal.checklist.map((it) => ({\n      text: it.text,\n      status: it.status,\n      addedBy: it.addedBy,\n      addedAt: it.addedAt,\n      completedAt: it.completedAt,\n      evidence: it.evidenceSummary,\n    })),\n  };\n\n  const judgeRef = resolveJudgeModelRef(config, sessionKey, state.judgeModelRef, runtimeSessionModelRef);\n  if (!judgeRef) {\n    log.warn({ sessionKey }, 'Persistent goal: no judge model ref; skipping post-turn');\n    return;\n  }\n\n  const historyCap = goalsCfg?.checklistHistoryChars ?? 24_000;\n  let historyExcerpt = '';\n  try {\n    const msgs = await apis.loadMessages(sessionKey);\n    historyExcerpt = buildHistoryExcerpt(msgs, historyCap);\n  } catch (err) {\n    log.debug(\n      { err, sessionKey },\n      `Persistent goal: could not load messages for judge context: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n\n  let decision = await evaluateAfterTurnHermesLike(state, assistantPlainText, judgeRef, signal, {\n    goalsSlice: goalsCfg,\n    historyExcerpt,\n    goalContextExcerpt: buildGoalContextText(goal),\n    uiLocale: resolveGoalUiLocale(state),\n  });\n\n  const completionReadiness = goalService.getCompletionReadiness(goal.id);\n  if (decision.verdict === 'done' && completionReadiness && !completionReadiness.ready && decision.newState) {\n    const reason = `Completion evidence still needed: ${completionReadiness.missingEvidence.join('; ')}`;\n    decision = {\n      ...decision,\n      newState: {\n        ...decision.newState,\n        status: 'active',\n        lastVerdict: 'continue',\n        lastReason: reason,\n      },\n      shouldContinue: true,\n      continuationPrompt: `Before declaring the goal complete, collect this evidence:\\n${completionReadiness.missingEvidence.map((item) => `- ${item}`).join('\\n')}`,\n      verdict: 'continue',\n      reason,\n      message: reason,\n      missingEvidence: completionReadiness.missingEvidence,\n    };\n  }\n\n  if (decision.newState) {\n    const ns = decision.newState;\n    const completedChecklistItemIds = decision.completedChecklistItemIndexes\n      ?.map((index) => goal.checklist[index]?.id)\n      .filter((id): id is string => typeof id === 'string' && id.length > 0);\n    try {\n      const updatedGoal = goalService.syncPostTurnState({\n        goalId: goal.id,\n        sessionKey,\n        source: 'chat',\n        status: ns.status === 'done'\n          ? 'done'\n          : decision.verdict === 'blocked'\n            ? 'blocked'\n            : decision.verdict === 'needs_input'\n              ? 'needs_input'\n              : ns.status === 'paused'\n                ? 'paused'\n                : 'active',\n        turnsUsed: ns.turnsUsed,\n        maxTurns: ns.maxTurns,\n        reason: ns.pausedReason ?? decision.reason,\n        nextAction: decision.continuationPrompt ?? undefined,\n        assistantPreview: assistantPlainText,\n        verdict: decision.verdict === 'done'\n          ? 'done'\n          : decision.verdict === 'decompose'\n            ? 'decompose'\n            : decision.verdict === 'blocked'\n              ? 'blocked'\n              : decision.verdict === 'needs_input'\n                ? 'needs_input'\n                : 'continue',\n        confidence: decision.confidence,\n        missingEvidence: decision.missingEvidence,\n        userQuestion: decision.userQuestion,\n        completedChecklistItemIds,\n        checklist: ns.checklist?.map((it) => ({\n          text: it.text,\n          status: it.status,\n          addedBy: it.addedBy,\n          addedAt: it.addedAt,\n          completedAt: it.completedAt,\n          evidenceSummary: it.evidence,\n        })),\n      });\n      if (updatedGoal && updatedGoal.status !== goal.status) {\n        onGoalStatusUpdated?.({\n          goalId: goal.id,\n          sessionKey,\n          previousStatus: goal.status,\n          status: updatedGoal.status,\n          goal: updatedGoal,\n        });\n      }\n    } catch (err) {\n      log.warn(\n        { err, sessionKey, goalId: goal.id },\n        `Persistent goal: SQLite goal update failed: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n  }\n\n  if (decision.message) {\n    if (publishVerdictToChannel) {\n      try {\n        await publishVerdictToChannel(decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: channel verdict send failed: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    } else {\n      try {\n        await appendAssistantLine(apis, sessionKey, decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: failed to append status message: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    }\n  }\n\n  if (decision.shouldContinue && decision.continuationPrompt) {\n    apis.scheduleContinuation(sessionKey, decision.continuationPrompt);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"post-turn.js","names":[],"sources":["../../../../src/agent/goals/post-turn.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config, GoalsConfig } from '../../config/schema.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../../config/agent-profile.js';\nimport { GoalService } from '../../goals/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport { evaluateAfterTurnHermesLike } from './evaluate-turn.js';\nimport { resolveGoalUiLocale } from './goal-locale.js';\nimport type { PersistentGoalApis } from './persistent-goal-apis.js';\nimport type { PersistentGoalState } from './state.js';\n\nconst log = createLogger('PersistentGoal');\nconst goalService = new GoalService();\n\nfunction buildHistoryExcerpt(messages: AgentMessage[], maxChars: number): string {\n  if (maxChars <= 0) return '';\n  try {\n    const raw = JSON.stringify(messages);\n    if (raw.length <= maxChars) return raw;\n    return raw.slice(-maxChars);\n  } catch {\n    return '';\n  }\n}\n\nfunction buildGoalContextText(goal: NonNullable<ReturnType<GoalService['get']>>): string {\n  const lines = [`Title: ${goal.contract?.objective || goal.title}`];\n  if (goal.contract?.scopeBoundary) {\n    lines.push(`Scope boundary:\\n${goal.contract.scopeBoundary}`);\n  }\n  if (goal.contract?.evidencePlan.length) {\n    lines.push(`Expected completion evidence:\\n${goal.contract.evidencePlan.map((item) => `- ${item}`).join('\\n')}`);\n  }\n  if (goal.contextMessage?.text.trim()) {\n    lines.push(`Context:\\n${goal.contextMessage.text.trim()}`);\n  }\n  if (goal.contextMessage?.attachments.length) {\n    lines.push(\n      [\n        'Attachments:',\n        ...goal.contextMessage.attachments.map((attachment) =>\n          `- ${attachment.name} (${attachment.mimeType}, ${attachment.size} bytes) ${attachment.uri}`,\n        ),\n      ].join('\\n'),\n    );\n  }\n  return lines.join('\\n\\n');\n}\n\nfunction resolveJudgeModelRef(\n  config: Config | undefined,\n  sessionKey: string,\n  storedJudge?: string,\n  runtimeSessionModelRef?: string,\n): string | undefined {\n  const fromCfg = config?.goals?.judgeModelRef?.trim();\n  if (fromCfg) return fromCfg;\n  if (storedJudge?.trim()) return storedJudge.trim();\n  if (config) {\n    const profile = resolveEffectiveAgentProfileForSession(config, sessionKey);\n    if (profile.primaryModelRef?.trim()) return profile.primaryModelRef.trim();\n  }\n  if (runtimeSessionModelRef?.trim()) return runtimeSessionModelRef.trim();\n  if (config) return getAgentDefaultModelRef(config);\n  return undefined;\n}\n\nexport function shouldRunInitialChecklistDecomposition(input: {\n  checklistLength: number;\n  turnsUsed: number;\n  checklistDecomposePolicy?: GoalsConfig['checklistDecomposePolicy'];\n}): boolean {\n  if (input.checklistLength === 0) return true;\n  return input.checklistDecomposePolicy === 'supplement_existing' && input.turnsUsed === 0;\n}\n\nasync function appendAssistantLine(apis: PersistentGoalApis, sessionKey: string, text: string): Promise<void> {\n  await apis.appendAssistantReceipt(sessionKey, text);\n}\n\nexport async function handlePersistentGoalPostTurn(opts: {\n  apis: PersistentGoalApis;\n  sessionKey: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn: boolean;\n  config: Config | undefined;\n  /** Active session model (overrides, per-agent defaults) when goals/global defaults are unset. */\n  runtimeSessionModelRef?: string;\n  signal?: AbortSignal;\n  /** Hermes-style: verdict line also sent as a normal outbound message (non-webchat). */\n  publishVerdictToChannel?: (text: string) => Promise<void>;\n  onGoalStatusUpdated?: (payload: {\n    goalId: string;\n    sessionKey: string;\n    previousStatus: string;\n    status: string;\n    goal: import('../../goals/types.js').GoalWithDetails;\n  }) => void;\n}): Promise<void> {\n  const {\n    apis,\n    sessionKey,\n    assistantPlainText,\n    aborted,\n    streamError,\n    skipPersistentGoalPostTurn,\n    config,\n    runtimeSessionModelRef,\n    signal,\n    publishVerdictToChannel,\n    onGoalStatusUpdated,\n  } = opts;\n\n  if (skipPersistentGoalPostTurn) return;\n  if (aborted || streamError) return;\n\n  const meta = await apis.getSessionMetadata(sessionKey);\n  if (!meta) return;\n\n  const goal = goalService.getActiveForSession(sessionKey);\n  if (!goal || goal.status !== 'active') return;\n\n  const goalsCfg = config?.goals;\n  const shouldDecomposeChecklist = shouldRunInitialChecklistDecomposition({\n    checklistLength: goal.checklist.length,\n    turnsUsed: goal.turnsUsed,\n    checklistDecomposePolicy: goalsCfg?.checklistDecomposePolicy,\n  });\n  const state: PersistentGoalState = {\n    goal: buildGoalContextText(goal),\n    status: 'active',\n    turnsUsed: goal.turnsUsed,\n    maxTurns: goal.maxTurns,\n    createdAt: goal.createdAt,\n    lastTurnAt: goal.updatedAt,\n    lastReason: goal.blockedReason,\n    judgeModelRef: goal.judgeModelRef,\n    decomposed: shouldDecomposeChecklist ? undefined : true,\n    uiLocale: goal.uiLocale,\n    checklist: goal.checklist.map((it) => ({\n      text: it.text,\n      status: it.status,\n      addedBy: it.addedBy,\n      addedAt: it.addedAt,\n      completedAt: it.completedAt,\n      evidence: it.evidenceSummary,\n    })),\n  };\n\n  const judgeRef = resolveJudgeModelRef(config, sessionKey, state.judgeModelRef, runtimeSessionModelRef);\n  if (!judgeRef) {\n    log.warn({ sessionKey }, 'Persistent goal: no judge model ref; skipping post-turn');\n    return;\n  }\n\n  const historyCap = goalsCfg?.checklistHistoryChars ?? 24_000;\n  let historyExcerpt = '';\n  try {\n    const msgs = await apis.loadMessages(sessionKey);\n    historyExcerpt = buildHistoryExcerpt(msgs, historyCap);\n  } catch (err) {\n    log.debug(\n      { err, sessionKey },\n      `Persistent goal: could not load messages for judge context: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n\n  let decision = await evaluateAfterTurnHermesLike(state, assistantPlainText, judgeRef, signal, {\n    goalsSlice: goalsCfg,\n    historyExcerpt,\n    goalContextExcerpt: buildGoalContextText(goal),\n    uiLocale: resolveGoalUiLocale(state),\n  });\n\n  const completionReadiness = goalService.getCompletionReadiness(goal.id);\n  const executionGaps = completionReadiness\n    ? [...completionReadiness.missingEvidence, ...completionReadiness.pendingOutcome]\n    : [];\n  if (decision.verdict === 'done' && executionGaps.length > 0 && decision.newState) {\n    const reason = `Completion evidence or outcome still needed: ${executionGaps.join('; ')}`;\n    decision = {\n      ...decision,\n      newState: {\n        ...decision.newState,\n        status: 'active',\n        lastVerdict: 'continue',\n        lastReason: reason,\n      },\n      shouldContinue: true,\n      continuationPrompt: `Before declaring the goal complete, address these gaps:\\n${executionGaps.map((item) => `- ${item}`).join('\\n')}`,\n      verdict: 'continue',\n      reason,\n      message: reason,\n      missingEvidence: executionGaps,\n    };\n  }\n\n  if (decision.newState) {\n    const ns = decision.newState;\n    const completedChecklistItemIds = decision.completedChecklistItemIndexes\n      ?.map((index) => goal.checklist[index]?.id)\n      .filter((id): id is string => typeof id === 'string' && id.length > 0);\n    try {\n      const updatedGoal = goalService.syncPostTurnState({\n        goalId: goal.id,\n        sessionKey,\n        source: 'chat',\n        status: ns.status === 'done'\n          ? 'done'\n          : decision.verdict === 'blocked'\n            ? 'blocked'\n            : decision.verdict === 'needs_input'\n              ? 'needs_input'\n              : ns.status === 'paused'\n                ? 'paused'\n                : 'active',\n        turnsUsed: ns.turnsUsed,\n        maxTurns: ns.maxTurns,\n        reason: ns.pausedReason ?? decision.reason,\n        nextAction: decision.continuationPrompt ?? undefined,\n        assistantPreview: assistantPlainText,\n        verdict: decision.verdict === 'done'\n          ? 'done'\n          : decision.verdict === 'decompose'\n            ? 'decompose'\n            : decision.verdict === 'blocked'\n              ? 'blocked'\n              : decision.verdict === 'needs_input'\n                ? 'needs_input'\n                : 'continue',\n        confidence: decision.confidence,\n        missingEvidence: decision.missingEvidence,\n        userQuestion: decision.userQuestion,\n        completedChecklistItemIds,\n        checklist: ns.checklist?.map((it) => ({\n          text: it.text,\n          status: it.status,\n          addedBy: it.addedBy,\n          addedAt: it.addedAt,\n          completedAt: it.completedAt,\n          evidenceSummary: it.evidence,\n        })),\n      });\n      if (updatedGoal && updatedGoal.status !== goal.status) {\n        onGoalStatusUpdated?.({\n          goalId: goal.id,\n          sessionKey,\n          previousStatus: goal.status,\n          status: updatedGoal.status,\n          goal: updatedGoal,\n        });\n      }\n    } catch (err) {\n      log.warn(\n        { err, sessionKey, goalId: goal.id },\n        `Persistent goal: SQLite goal update failed: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n  }\n\n  if (decision.message) {\n    if (publishVerdictToChannel) {\n      try {\n        await publishVerdictToChannel(decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: channel verdict send failed: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    } else {\n      try {\n        await appendAssistantLine(apis, sessionKey, decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: failed to append status message: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    }\n  }\n\n  if (decision.shouldContinue && decision.continuationPrompt) {\n    apis.scheduleContinuation(sessionKey, decision.continuationPrompt);\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/mcp/mcp-transport.js

@@ -64,7 +64,10 @@ function resolveMcpTransport(serverName, rawServer) {
 		};
 	}
 	if (resolved.transportType === "streamable-http") return {
-		transport: new StreamableHTTPClientTransport(new URL(resolved.url), { requestInit: resolved.headers ? { headers: resolved.headers } : void 0 }),
+		transport: new StreamableHTTPClientTransport(new URL(resolved.url), {
+			requestInit: resolved.headers ? { headers: resolved.headers } : void 0,
+			fetch: fetchWithUndici
+		}),
 		description: resolved.description,
 		transportType: "streamable-http",
 		connectionTimeoutMs: resolved.connectionTimeoutMs

package/dist/src/agent/mcp/mcp-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-transport.js","names":["undiciFetch"],"sources":["../../../../src/agent/mcp/mcp-transport.ts"],"sourcesContent":["import {\n  SSEClientTransport,\n  type SSEClientTransportOptions,\n} from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { FetchLike, Transport } from \"@modelcontextprotocol/sdk/shared/transport.js\";\nimport { fetch as undiciFetch } from \"undici\";\nimport { createLogger } from \"../../utils/logger.js\";\nconst log = createLogger(\"Mcp:Transport\");\nimport { normalizeOptionalString } from \"../../utils/string-coerce.js\";\nimport { XopcStdioClientTransport } from \"./mcp-stdio-transport.js\";\nimport { resolveMcpTransportConfig } from \"./mcp-transport-config.js\";\n\nexport type ResolvedMcpTransport = {\n  transport: Transport;\n  description: string;\n  transportType: \"stdio\" | \"sse\" | \"streamable-http\";\n  connectionTimeoutMs: number;\n  detachStderr?: () => void;\n};\n\nfunction attachStderrLogging(serverName: string, transport: XopcStdioClientTransport) {\n  const stderr = transport.stderr;\n  if (!stderr || typeof stderr.on !== \"function\") {\n    return undefined;\n  }\n  const onData = (chunk: Buffer | string) => {\n    const message =\n      normalizeOptionalString(typeof chunk === \"string\" ? chunk : String(chunk)) ?? \"\";\n    if (!message) {\n      return;\n    }\n    for (const line of message.split(/\\r?\\n/)) {\n      const trimmed = line.trim();\n      if (trimmed) {\n        log.debug(`bundle-mcp:${serverName}: ${trimmed}`);\n      }\n    }\n  };\n  stderr.on(\"data\", onData);\n  return () => {\n    if (typeof stderr.off === \"function\") {\n      stderr.off(\"data\", onData);\n    } else if (typeof stderr.removeListener === \"function\") {\n      stderr.removeListener(\"data\", onData);\n    }\n  };\n}\n\ntype SseEventSourceFetch = NonNullable<\n  NonNullable<SSEClientTransportOptions[\"eventSourceInit\"]>[\"fetch\"]\n>;\n\nconst fetchWithUndici: FetchLike = async (url, init) =>\n  (await undiciFetch(url, init as unknown as Parameters<typeof undiciFetch>[1])) as unknown as Response;\n\nfunction buildSseEventSourceFetch(headers: Record<string, string>): SseEventSourceFetch {\n  return (url: string | URL, init?: RequestInit) => {\n    const sdkHeaders: Record<string, string> = {};\n    if (init?.headers) {\n      if (init.headers instanceof Headers) {\n        init.headers.forEach((value, key) => {\n          sdkHeaders[key] = value;\n        });\n      } else {\n        Object.assign(sdkHeaders, init.headers);\n      }\n    }\n    return fetchWithUndici(url, {\n      ...(init as RequestInit),\n      headers: { ...sdkHeaders, ...headers },\n    }) as ReturnType<SseEventSourceFetch>;\n  };\n}\n\nexport function resolveMcpTransport(\n  serverName: string,\n  rawServer: unknown,\n): ResolvedMcpTransport | null {\n  const resolved = resolveMcpTransportConfig(serverName, rawServer);\n  if (!resolved) {\n    return null;\n  }\n  if (resolved.kind === \"stdio\") {\n    const transport = new XopcStdioClientTransport({\n      command: resolved.command,\n      args: resolved.args,\n      env: resolved.env,\n      cwd: resolved.cwd,\n      stderr: \"pipe\",\n    });\n    return {\n      transport,\n      description: resolved.description,\n      transportType: \"stdio\",\n      connectionTimeoutMs: resolved.connectionTimeoutMs,\n      detachStderr: attachStderrLogging(serverName, transport),\n    };\n  }\n  if (resolved.transportType === \"streamable-http\") {\n    return {\n      transport: new StreamableHTTPClientTransport(new URL(resolved.url), {\n        requestInit: resolved.headers ? { headers: resolved.headers } : undefined,\n      }),\n      description: resolved.description,\n      transportType: \"streamable-http\",\n      connectionTimeoutMs: resolved.connectionTimeoutMs,\n    };\n  }\n  const headers: Record<string, string> = {\n    ...resolved.headers,\n  };\n  const hasHeaders = Object.keys(headers).length > 0;\n  return {\n    transport: new SSEClientTransport(new URL(resolved.url), {\n      requestInit: hasHeaders ? { headers } : undefined,\n      fetch: fetchWithUndici,\n      eventSourceInit: { fetch: buildSseEventSourceFetch(headers) },\n    }),\n    description: resolved.description,\n    transportType: \"sse\",\n    connectionTimeoutMs: resolved.connectionTimeoutMs,\n  };\n}\n"],"mappings":";;;;;;;;;aAOqD;oBAEkB;AADvE,MAAM,MAAM,aAAa,gBAAgB;AAazC,SAAS,oBAAoB,YAAoB,WAAqC;CACpF,MAAM,SAAS,UAAU;AACzB,KAAI,CAAC,UAAU,OAAO,OAAO,OAAO,WAClC;CAEF,MAAM,UAAU,UAA2B;EACzC,MAAM,UACJ,wBAAwB,OAAO,UAAU,WAAW,QAAQ,OAAO,MAAM,CAAC,IAAI;AAChF,MAAI,CAAC,QACH;AAEF,OAAK,MAAM,QAAQ,QAAQ,MAAM,QAAQ,EAAE;GACzC,MAAM,UAAU,KAAK,MAAM;AAC3B,OAAI,QACF,KAAI,MAAM,cAAc,WAAW,IAAI,UAAU;;;AAIvD,QAAO,GAAG,QAAQ,OAAO;AACzB,cAAa;AACX,MAAI,OAAO,OAAO,QAAQ,WACxB,QAAO,IAAI,QAAQ,OAAO;WACjB,OAAO,OAAO,mBAAmB,WAC1C,QAAO,eAAe,QAAQ,OAAO;;;AAS3C,MAAM,kBAA6B,OAAO,KAAK,SAC5C,MAAMA,MAAY,KAAK,KAAqD;AAE/E,SAAS,yBAAyB,SAAsD;AACtF,SAAQ,KAAmB,SAAuB;EAChD,MAAM,aAAqC,EAAE;AAC7C,MAAI,MAAM,QACR,KAAI,KAAK,mBAAmB,QAC1B,MAAK,QAAQ,SAAS,OAAO,QAAQ;AACnC,cAAW,OAAO;IAClB;MAEF,QAAO,OAAO,YAAY,KAAK,QAAQ;AAG3C,SAAO,gBAAgB,KAAK;GAC1B,GAAI;GACJ,SAAS;IAAE,GAAG;IAAY,GAAG;IAAS;GACvC,CAAC;;;AAIN,SAAgB,oBACd,YACA,WAC6B;CAC7B,MAAM,WAAW,0BAA0B,YAAY,UAAU;AACjE,KAAI,CAAC,SACH,QAAO;AAET,KAAI,SAAS,SAAS,SAAS;EAC7B,MAAM,YAAY,IAAI,yBAAyB;GAC7C,SAAS,SAAS;GAClB,MAAM,SAAS;GACf,KAAK,SAAS;GACd,KAAK,SAAS;GACd,QAAQ;GACT,CAAC;AACF,SAAO;GACL;GACA,aAAa,SAAS;GACtB,eAAe;GACf,qBAAqB,SAAS;GAC9B,cAAc,oBAAoB,YAAY,UAAU;GACzD;;AAEH,KAAI,SAAS,kBAAkB,kBAC7B,QAAO;EACL,WAAW,IAAI,8BAA8B,IAAI,IAAI,SAAS,IAAI,EAAE,EAClE,aAAa,SAAS,UAAU,EAAE,SAAS,SAAS,SAAS,GAAG,KAAA,GACjE,CAAC;EACF,aAAa,SAAS;EACtB,eAAe;EACf,qBAAqB,SAAS;EAC/B;CAEH,MAAM,UAAkC,EACtC,GAAG,SAAS,SACb;CACD,MAAM,aAAa,OAAO,KAAK,QAAQ,CAAC,SAAS;AACjD,QAAO;EACL,WAAW,IAAI,mBAAmB,IAAI,IAAI,SAAS,IAAI,EAAE;GACvD,aAAa,aAAa,EAAE,SAAS,GAAG,KAAA;GACxC,OAAO;GACP,iBAAiB,EAAE,OAAO,yBAAyB,QAAQ,EAAE;GAC9D,CAAC;EACF,aAAa,SAAS;EACtB,eAAe;EACf,qBAAqB,SAAS;EAC/B"}
+{"version":3,"file":"mcp-transport.js","names":["undiciFetch"],"sources":["../../../../src/agent/mcp/mcp-transport.ts"],"sourcesContent":["import {\n  SSEClientTransport,\n  type SSEClientTransportOptions,\n} from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { FetchLike, Transport } from \"@modelcontextprotocol/sdk/shared/transport.js\";\nimport { fetch as undiciFetch } from \"undici\";\nimport { createLogger } from \"../../utils/logger.js\";\nconst log = createLogger(\"Mcp:Transport\");\nimport { normalizeOptionalString } from \"../../utils/string-coerce.js\";\nimport { XopcStdioClientTransport } from \"./mcp-stdio-transport.js\";\nimport { resolveMcpTransportConfig } from \"./mcp-transport-config.js\";\n\nexport type ResolvedMcpTransport = {\n  transport: Transport;\n  description: string;\n  transportType: \"stdio\" | \"sse\" | \"streamable-http\";\n  connectionTimeoutMs: number;\n  detachStderr?: () => void;\n};\n\nfunction attachStderrLogging(serverName: string, transport: XopcStdioClientTransport) {\n  const stderr = transport.stderr;\n  if (!stderr || typeof stderr.on !== \"function\") {\n    return undefined;\n  }\n  const onData = (chunk: Buffer | string) => {\n    const message =\n      normalizeOptionalString(typeof chunk === \"string\" ? chunk : String(chunk)) ?? \"\";\n    if (!message) {\n      return;\n    }\n    for (const line of message.split(/\\r?\\n/)) {\n      const trimmed = line.trim();\n      if (trimmed) {\n        log.debug(`bundle-mcp:${serverName}: ${trimmed}`);\n      }\n    }\n  };\n  stderr.on(\"data\", onData);\n  return () => {\n    if (typeof stderr.off === \"function\") {\n      stderr.off(\"data\", onData);\n    } else if (typeof stderr.removeListener === \"function\") {\n      stderr.removeListener(\"data\", onData);\n    }\n  };\n}\n\ntype SseEventSourceFetch = NonNullable<\n  NonNullable<SSEClientTransportOptions[\"eventSourceInit\"]>[\"fetch\"]\n>;\n\nconst fetchWithUndici: FetchLike = async (url, init) =>\n  (await undiciFetch(url, init as unknown as Parameters<typeof undiciFetch>[1])) as unknown as Response;\n\nfunction buildSseEventSourceFetch(headers: Record<string, string>): SseEventSourceFetch {\n  return (url: string | URL, init?: RequestInit) => {\n    const sdkHeaders: Record<string, string> = {};\n    if (init?.headers) {\n      if (init.headers instanceof Headers) {\n        init.headers.forEach((value, key) => {\n          sdkHeaders[key] = value;\n        });\n      } else {\n        Object.assign(sdkHeaders, init.headers);\n      }\n    }\n    return fetchWithUndici(url, {\n      ...(init as RequestInit),\n      headers: { ...sdkHeaders, ...headers },\n    }) as ReturnType<SseEventSourceFetch>;\n  };\n}\n\nexport function resolveMcpTransport(\n  serverName: string,\n  rawServer: unknown,\n): ResolvedMcpTransport | null {\n  const resolved = resolveMcpTransportConfig(serverName, rawServer);\n  if (!resolved) {\n    return null;\n  }\n  if (resolved.kind === \"stdio\") {\n    const transport = new XopcStdioClientTransport({\n      command: resolved.command,\n      args: resolved.args,\n      env: resolved.env,\n      cwd: resolved.cwd,\n      stderr: \"pipe\",\n    });\n    return {\n      transport,\n      description: resolved.description,\n      transportType: \"stdio\",\n      connectionTimeoutMs: resolved.connectionTimeoutMs,\n      detachStderr: attachStderrLogging(serverName, transport),\n    };\n  }\n  if (resolved.transportType === \"streamable-http\") {\n    return {\n      transport: new StreamableHTTPClientTransport(new URL(resolved.url), {\n        requestInit: resolved.headers ? { headers: resolved.headers } : undefined,\n        fetch: fetchWithUndici,\n      }),\n      description: resolved.description,\n      transportType: \"streamable-http\",\n      connectionTimeoutMs: resolved.connectionTimeoutMs,\n    };\n  }\n  const headers: Record<string, string> = {\n    ...resolved.headers,\n  };\n  const hasHeaders = Object.keys(headers).length > 0;\n  return {\n    transport: new SSEClientTransport(new URL(resolved.url), {\n      requestInit: hasHeaders ? { headers } : undefined,\n      fetch: fetchWithUndici,\n      eventSourceInit: { fetch: buildSseEventSourceFetch(headers) },\n    }),\n    description: resolved.description,\n    transportType: \"sse\",\n    connectionTimeoutMs: resolved.connectionTimeoutMs,\n  };\n}\n"],"mappings":";;;;;;;;;aAOqD;oBAEkB;AADvE,MAAM,MAAM,aAAa,gBAAgB;AAazC,SAAS,oBAAoB,YAAoB,WAAqC;CACpF,MAAM,SAAS,UAAU;AACzB,KAAI,CAAC,UAAU,OAAO,OAAO,OAAO,WAClC;CAEF,MAAM,UAAU,UAA2B;EACzC,MAAM,UACJ,wBAAwB,OAAO,UAAU,WAAW,QAAQ,OAAO,MAAM,CAAC,IAAI;AAChF,MAAI,CAAC,QACH;AAEF,OAAK,MAAM,QAAQ,QAAQ,MAAM,QAAQ,EAAE;GACzC,MAAM,UAAU,KAAK,MAAM;AAC3B,OAAI,QACF,KAAI,MAAM,cAAc,WAAW,IAAI,UAAU;;;AAIvD,QAAO,GAAG,QAAQ,OAAO;AACzB,cAAa;AACX,MAAI,OAAO,OAAO,QAAQ,WACxB,QAAO,IAAI,QAAQ,OAAO;WACjB,OAAO,OAAO,mBAAmB,WAC1C,QAAO,eAAe,QAAQ,OAAO;;;AAS3C,MAAM,kBAA6B,OAAO,KAAK,SAC5C,MAAMA,MAAY,KAAK,KAAqD;AAE/E,SAAS,yBAAyB,SAAsD;AACtF,SAAQ,KAAmB,SAAuB;EAChD,MAAM,aAAqC,EAAE;AAC7C,MAAI,MAAM,QACR,KAAI,KAAK,mBAAmB,QAC1B,MAAK,QAAQ,SAAS,OAAO,QAAQ;AACnC,cAAW,OAAO;IAClB;MAEF,QAAO,OAAO,YAAY,KAAK,QAAQ;AAG3C,SAAO,gBAAgB,KAAK;GAC1B,GAAI;GACJ,SAAS;IAAE,GAAG;IAAY,GAAG;IAAS;GACvC,CAAC;;;AAIN,SAAgB,oBACd,YACA,WAC6B;CAC7B,MAAM,WAAW,0BAA0B,YAAY,UAAU;AACjE,KAAI,CAAC,SACH,QAAO;AAET,KAAI,SAAS,SAAS,SAAS;EAC7B,MAAM,YAAY,IAAI,yBAAyB;GAC7C,SAAS,SAAS;GAClB,MAAM,SAAS;GACf,KAAK,SAAS;GACd,KAAK,SAAS;GACd,QAAQ;GACT,CAAC;AACF,SAAO;GACL;GACA,aAAa,SAAS;GACtB,eAAe;GACf,qBAAqB,SAAS;GAC9B,cAAc,oBAAoB,YAAY,UAAU;GACzD;;AAEH,KAAI,SAAS,kBAAkB,kBAC7B,QAAO;EACL,WAAW,IAAI,8BAA8B,IAAI,IAAI,SAAS,IAAI,EAAE;GAClE,aAAa,SAAS,UAAU,EAAE,SAAS,SAAS,SAAS,GAAG,KAAA;GAChE,OAAO;GACR,CAAC;EACF,aAAa,SAAS;EACtB,eAAe;EACf,qBAAqB,SAAS;EAC/B;CAEH,MAAM,UAAkC,EACtC,GAAG,SAAS,SACb;CACD,MAAM,aAAa,OAAO,KAAK,QAAQ,CAAC,SAAS;AACjD,QAAO;EACL,WAAW,IAAI,mBAAmB,IAAI,IAAI,SAAS,IAAI,EAAE;GACvD,aAAa,aAAa,EAAE,SAAS,GAAG,KAAA;GACxC,OAAO;GACP,iBAAiB,EAAE,OAAO,yBAAyB,QAAQ,EAAE;GAC9D,CAAC;EACF,aAAa,SAAS;EACtB,eAAe;EACf,qBAAqB,SAAS;EAC/B"}

package/dist/src/agent/memory/context/planner.d.ts

@@ -8,5 +8,6 @@ export declare class UserContextPlanner {
         sessionKey: string;
         query: string;
         userMessage: AgentMessage;
+        excludedRecordIds?: string[];
     }): Promise<UserContextPlan>;
 }

package/dist/src/agent/memory/context/planner.js

@@ -4,11 +4,21 @@ import { appendMemoryTraceEvent } from "../../../storage/sqlite/memory-records-r
 import "../../../storage/sqlite/index.js";
 import { readAgentMessageContent } from "../agent-message-access.js";
 import { buildUserContextBlock } from "../context-fence.js";
+import { resolveMemoryStability } from "../lifecycle.js";
+import { classifyMemoryContextOrigin } from "../source-origin.js";
 import { randomUUID } from "node:crypto";
 //#region src/agent/memory/context/planner.ts
 init_logger();
 const MAX_CONTEXT_CHARS = 6e3;
 const MAX_RESULTS = 8;
+const BASELINE_KINDS = [
+	"boundary",
+	"preference",
+	"tool_preference",
+	"routine",
+	"user_profile",
+	"personal_logistics"
+];
 const log = createLogger("UserContextPlanner");
 function sectionFor(record) {
 	if (record.kind === "boundary") return "safety";
@@ -20,13 +30,13 @@ function rejectReason(record, now) {
 	if (record.validTo && Date.parse(record.validTo) < now || record.expiresAt && Date.parse(record.expiresAt) < now) return "expired";
 	if (record.sensitivity === "secret" || record.sensitivity === "regulated") return "sensitive";
 	if (record.disclosurePolicy === "ask_before_reference") return "requires_consent";
+	if (record.status === "needs_review" || record.status === "stale" || resolveMemoryStability(record, now).reviewDue) return "needs_review";
 }
 function scoreResult(result, now) {
 	const confidence = result.record.confidence ?? .5;
 	const explicitness = result.record.explicitness === "explicit" ? 1 : result.record.explicitness === "observed" ? .65 : .4;
-	const ageDays = Math.max(0, (now - Date.parse(result.record.updatedAt)) / 864e5);
-	const freshness = Math.exp(-ageDays / 180);
-	return Math.max(0, Math.min(1, result.score * .5 + confidence * .15 + result.record.importance * .2 + explicitness * .1 + freshness * .05));
+	const stability = resolveMemoryStability(result.record, now).score;
+	return Math.max(0, Math.min(1, result.score * .45 + confidence * .1 + result.record.importance * .2 + explicitness * .1 + stability * .15));
 }
 function citationFor(result, requesterAgentId) {
 	const base = result.citation.path ?? `${result.citation.providerId}:${result.citation.recordId}`;
@@ -35,6 +45,12 @@ function citationFor(result, requesterAgentId) {
 	const end = result.citation.lineEnd && result.citation.lineEnd !== result.citation.lineStart ? `-L${result.citation.lineEnd}` : "";
 	return `${ownerPrefix}${base}#L${result.citation.lineStart}${end}`;
 }
+function evidenceLabel(item) {
+	if (item.origin === "told_by_user") return "The user explicitly shared this";
+	if (item.origin === "observed") return "Observed across prior work";
+	if (item.origin === "connected_source") return "A connected source provided this";
+	return "An inference that may be wrong";
+}
 function prependContext(message, block) {
 	if (!block) return message;
 	const prefix = `${block}\n\n`;
@@ -78,21 +94,42 @@ var UserContextPlanner = class {
 			estimatedTokens: 0
 		};
 		const started = Date.now();
-		const results = await params.memoryManager.search({
+		const scope = {
+			agentId: params.agentId,
+			sessionKey: params.sessionKey
+		};
+		const [taskResults, baselineLists] = await Promise.all([params.memoryManager.search({
 			query,
-			scope: {
-				agentId: params.agentId,
-				sessionKey: params.sessionKey
-			},
+			scope,
 			maxResults: MAX_RESULTS,
 			minScore: .15
-		}).catch(() => []);
+		}).catch(() => []), Promise.all(BASELINE_KINDS.map((kind) => params.memoryManager.list({
+			kind,
+			status: "active",
+			scope
+		}).catch(() => [])))]);
+		const taskIds = new Set(taskResults.map((result) => result.record.id));
+		const baselineResults = baselineLists.flat().filter((record) => !taskIds.has(record.id)).filter((record) => record.kind === "boundary" || record.explicitness === "explicit" || record.importance >= .7).map((record) => ({
+			record,
+			score: record.kind === "boundary" ? .7 : .42,
+			snippet: record.content,
+			citation: {
+				providerId: record.source.provider ?? "local",
+				recordId: record.id,
+				path: record.source.path,
+				lineStart: record.source.lineStart,
+				lineEnd: record.source.lineEnd,
+				createdAt: record.createdAt
+			}
+		}));
+		const results = [...taskResults, ...baselineResults];
 		const now = Date.now();
+		const excluded = new Set(params.excludedRecordIds ?? []);
 		const rejected = [];
-		const ranked = results.map((result) => ({
+		const ranked = results.filter((result) => !excluded.has(result.record.id)).map((result) => ({
 			result,
 			score: scoreResult(result, now)
-		})).sort((a, b) => b.score - a.score);
+		})).sort((a, b) => b.score - a.score).filter((entry, index, all) => all.findIndex((candidate) => candidate.result.record.id === entry.result.record.id) === index).slice(0, MAX_RESULTS);
 		const items = [];
 		let usedChars = 0;
 		for (const { result, score } of ranked) {
@@ -118,7 +155,9 @@ var UserContextPlanner = class {
 				content,
 				score,
 				section: sectionFor(result.record),
-				citation: citationFor(result, params.agentId)
+				citation: citationFor(result, params.agentId),
+				origin: classifyMemoryContextOrigin(result.record),
+				stability: resolveMemoryStability(result.record, now).score
 			});
 		}
 		const sections = [];
@@ -128,7 +167,7 @@ var UserContextPlanner = class {
 			["interaction", "Interaction preferences"]
 		]) {
 			const sectionItems = items.filter((item) => item.section === section);
-			if (sectionItems.length > 0) sections.push(`${title}:\n${sectionItems.map((item) => `- ${item.content}\n  Source: ${item.citation}`).join("\n")}`);
+			if (sectionItems.length > 0) sections.push(`${title}:\n${sectionItems.map((item) => `- ${item.content}\n  Evidence: ${evidenceLabel(item)}`).join("\n")}`);
 		}
 		const block = buildUserContextBlock(sections.join("\n\n"));
 		try {
@@ -139,7 +178,14 @@ var UserContextPlanner = class {
 				sessionKey: params.sessionKey,
 				request: {
 					query,
-					rejected
+					rejected,
+					contextItems: items.map((item) => ({
+						recordId: item.recordId,
+						section: item.section,
+						origin: item.origin,
+						stability: item.stability,
+						citation: item.citation
+					}))
 				},
 				resultCount: items.length,
 				selectedRecordIds: items.map((item) => item.recordId),

package/dist/src/agent/memory/context/planner.js.map

@@ -1 +1 @@
-{"version":3,"file":"planner.js","names":[],"sources":["../../../../../src/agent/memory/context/planner.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport { appendMemoryTraceEvent } from '../../../storage/sqlite/index.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport { readAgentMessageContent } from '../agent-message-access.js';\nimport { buildUserContextBlock } from '../context-fence.js';\nimport type { MemoryManager } from '../manager.js';\nimport type { MemoryRecord, MemorySearchResult } from '../types.js';\nimport type {\n  PlannedUserContextItem,\n  UserContextPlan,\n  UserContextRejectionReason,\n} from './types.js';\n\nconst MAX_CONTEXT_CHARS = 6_000;\nconst MAX_RESULTS = 8;\nconst log = createLogger('UserContextPlanner');\n\nfunction sectionFor(record: MemoryRecord): PlannedUserContextItem['section'] {\n  if (record.kind === 'boundary') return 'safety';\n  if (\n    record.kind === 'preference' ||\n    record.kind === 'user_profile' ||\n    record.kind === 'relationship' ||\n    record.kind === 'routine' ||\n    record.kind === 'personal_logistics' ||\n    record.kind === 'tool_preference'\n  ) return 'interaction';\n  return 'task';\n}\n\nfunction rejectReason(record: MemoryRecord, now: number): UserContextRejectionReason | undefined {\n  if (record.validFrom && Date.parse(record.validFrom) > now) return 'not_yet_valid';\n  if (\n    (record.validTo && Date.parse(record.validTo) < now) ||\n    (record.expiresAt && Date.parse(record.expiresAt) < now)\n  ) return 'expired';\n  if (record.sensitivity === 'secret' || record.sensitivity === 'regulated') return 'sensitive';\n  if (record.disclosurePolicy === 'ask_before_reference') return 'requires_consent';\n  return undefined;\n}\n\nfunction scoreResult(result: MemorySearchResult, now: number): number {\n  const confidence = result.record.confidence ?? 0.5;\n  const explicitness = result.record.explicitness === 'explicit'\n    ? 1\n    : result.record.explicitness === 'observed' ? 0.65 : 0.4;\n  const ageDays = Math.max(0, (now - Date.parse(result.record.updatedAt)) / 86_400_000);\n  const freshness = Math.exp(-ageDays / 180);\n  return Math.max(0, Math.min(1,\n    result.score * 0.5 + confidence * 0.15 + result.record.importance * 0.2 + explicitness * 0.1 + freshness * 0.05,\n  ));\n}\n\nfunction citationFor(result: MemorySearchResult, requesterAgentId: string): string {\n  const base = result.citation.path ?? `${result.citation.providerId}:${result.citation.recordId}`;\n  const ownerPrefix = result.record.scope.agentId !== requesterAgentId\n    ? `shared-from-agent:${result.record.scope.agentId} `\n    : '';\n  if (result.citation.lineStart == null) return `${ownerPrefix}${base}`;\n  const end = result.citation.lineEnd && result.citation.lineEnd !== result.citation.lineStart\n    ? `-L${result.citation.lineEnd}`\n    : '';\n  return `${ownerPrefix}${base}#L${result.citation.lineStart}${end}`;\n}\n\nfunction prependContext(message: AgentMessage, block: string): AgentMessage {\n  if (!block) return message;\n  const prefix = `${block}\\n\\n`;\n  const content = readAgentMessageContent(message);\n  if (typeof content === 'string') return { ...message, content: prefix + content } as AgentMessage;\n  if (Array.isArray(content) && content.length > 0) {\n    const first = content[0] as { type?: string; text?: string };\n    if (first.type === 'text' && typeof first.text === 'string') {\n      const copy = [...content];\n      copy[0] = { type: 'text', text: prefix + first.text };\n      return { ...message, content: copy } as AgentMessage;\n    }\n    return { ...message, content: [{ type: 'text' as const, text: prefix }, ...content] } as AgentMessage;\n  }\n  return message;\n}\n\nexport class UserContextPlanner {\n  async plan(params: {\n    memoryManager: MemoryManager;\n    agentId: string;\n    sessionKey: string;\n    query: string;\n    userMessage: AgentMessage;\n  }): Promise<UserContextPlan> {\n    const traceId = randomUUID();\n    const query = params.query.trim();\n    if (!query) {\n      return { traceId, modelMessage: params.userMessage, items: [], rejected: [], estimatedTokens: 0 };\n    }\n    const started = Date.now();\n    const results = await params.memoryManager.search({\n      query,\n      scope: { agentId: params.agentId, sessionKey: params.sessionKey },\n      maxResults: MAX_RESULTS,\n      minScore: 0.15,\n    }).catch(() => []);\n    const now = Date.now();\n    const rejected: UserContextPlan['rejected'] = [];\n    const ranked = results\n      .map((result) => ({ result, score: scoreResult(result, now) }))\n      .sort((a, b) => b.score - a.score);\n    const items: PlannedUserContextItem[] = [];\n    let usedChars = 0;\n    for (const { result, score } of ranked) {\n      const reason = rejectReason(result.record, now) ?? (score < 0.25 ? 'low_score' : undefined);\n      if (reason) {\n        rejected.push({ recordId: result.record.id, reason });\n        continue;\n      }\n      const content = result.snippet.trim();\n      if (usedChars + content.length > MAX_CONTEXT_CHARS) {\n        rejected.push({ recordId: result.record.id, reason: 'budget' });\n        continue;\n      }\n      usedChars += content.length;\n      items.push({\n        recordId: result.record.id,\n        content,\n        score,\n        section: sectionFor(result.record),\n        citation: citationFor(result, params.agentId),\n      });\n    }\n    const sections: string[] = [];\n    for (const [section, title] of [['safety', 'Boundaries'], ['task', 'Relevant facts'], ['interaction', 'Interaction preferences']] as const) {\n      const sectionItems = items.filter((item) => item.section === section);\n      if (sectionItems.length > 0) {\n        sections.push(`${title}:\\n${sectionItems.map((item) => `- ${item.content}\\n  Source: ${item.citation}`).join('\\n')}`);\n      }\n    }\n    const block = buildUserContextBlock(sections.join('\\n\\n'));\n    try {\n      appendMemoryTraceEvent({\n        traceId,\n        phase: 'inject',\n        providerId: 'user-understanding',\n        sessionKey: params.sessionKey,\n        request: { query, rejected },\n        resultCount: items.length,\n        selectedRecordIds: items.map((item) => item.recordId),\n        durationMs: Date.now() - started,\n      });\n    } catch (err) {\n      log.debug({ err, traceId, sessionKey: params.sessionKey }, 'Context plan trace was not persisted');\n    }\n    return {\n      traceId,\n      modelMessage: prependContext(params.userMessage, block),\n      items,\n      rejected,\n      estimatedTokens: Math.ceil(block.length / 4),\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"planner.js","names":[],"sources":["../../../../../src/agent/memory/context/planner.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport { appendMemoryTraceEvent } from '../../../storage/sqlite/index.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport { readAgentMessageContent } from '../agent-message-access.js';\nimport { buildUserContextBlock } from '../context-fence.js';\nimport type { MemoryManager } from '../manager.js';\nimport { resolveMemoryStability } from '../lifecycle.js';\nimport { classifyMemoryContextOrigin } from '../source-origin.js';\nimport type { MemoryRecord, MemorySearchResult } from '../types.js';\nimport type {\n  PlannedUserContextItem,\n  UserContextPlan,\n  UserContextRejectionReason,\n} from './types.js';\n\nconst MAX_CONTEXT_CHARS = 6_000;\nconst MAX_RESULTS = 8;\nconst BASELINE_KINDS = [\n  'boundary',\n  'preference',\n  'tool_preference',\n  'routine',\n  'user_profile',\n  'personal_logistics',\n] as const;\nconst log = createLogger('UserContextPlanner');\n\nfunction sectionFor(record: MemoryRecord): PlannedUserContextItem['section'] {\n  if (record.kind === 'boundary') return 'safety';\n  if (\n    record.kind === 'preference' ||\n    record.kind === 'user_profile' ||\n    record.kind === 'relationship' ||\n    record.kind === 'routine' ||\n    record.kind === 'personal_logistics' ||\n    record.kind === 'tool_preference'\n  ) return 'interaction';\n  return 'task';\n}\n\nfunction rejectReason(record: MemoryRecord, now: number): UserContextRejectionReason | undefined {\n  if (record.validFrom && Date.parse(record.validFrom) > now) return 'not_yet_valid';\n  if (\n    (record.validTo && Date.parse(record.validTo) < now) ||\n    (record.expiresAt && Date.parse(record.expiresAt) < now)\n  ) return 'expired';\n  if (record.sensitivity === 'secret' || record.sensitivity === 'regulated') return 'sensitive';\n  if (record.disclosurePolicy === 'ask_before_reference') return 'requires_consent';\n  if (record.status === 'needs_review' || record.status === 'stale' || resolveMemoryStability(record, now).reviewDue) return 'needs_review';\n  return undefined;\n}\n\nfunction scoreResult(result: MemorySearchResult, now: number): number {\n  const confidence = result.record.confidence ?? 0.5;\n  const explicitness = result.record.explicitness === 'explicit'\n    ? 1\n    : result.record.explicitness === 'observed' ? 0.65 : 0.4;\n  const stability = resolveMemoryStability(result.record, now).score;\n  return Math.max(0, Math.min(1,\n    result.score * 0.45 + confidence * 0.1 + result.record.importance * 0.2 + explicitness * 0.1 + stability * 0.15,\n  ));\n}\n\nfunction citationFor(result: MemorySearchResult, requesterAgentId: string): string {\n  const base = result.citation.path ?? `${result.citation.providerId}:${result.citation.recordId}`;\n  const ownerPrefix = result.record.scope.agentId !== requesterAgentId\n    ? `shared-from-agent:${result.record.scope.agentId} `\n    : '';\n  if (result.citation.lineStart == null) return `${ownerPrefix}${base}`;\n  const end = result.citation.lineEnd && result.citation.lineEnd !== result.citation.lineStart\n    ? `-L${result.citation.lineEnd}`\n    : '';\n  return `${ownerPrefix}${base}#L${result.citation.lineStart}${end}`;\n}\n\nfunction evidenceLabel(item: PlannedUserContextItem): string {\n  if (item.origin === 'told_by_user') return 'The user explicitly shared this';\n  if (item.origin === 'observed') return 'Observed across prior work';\n  if (item.origin === 'connected_source') return 'A connected source provided this';\n  return 'An inference that may be wrong';\n}\n\nfunction prependContext(message: AgentMessage, block: string): AgentMessage {\n  if (!block) return message;\n  const prefix = `${block}\\n\\n`;\n  const content = readAgentMessageContent(message);\n  if (typeof content === 'string') return { ...message, content: prefix + content } as AgentMessage;\n  if (Array.isArray(content) && content.length > 0) {\n    const first = content[0] as { type?: string; text?: string };\n    if (first.type === 'text' && typeof first.text === 'string') {\n      const copy = [...content];\n      copy[0] = { type: 'text', text: prefix + first.text };\n      return { ...message, content: copy } as AgentMessage;\n    }\n    return { ...message, content: [{ type: 'text' as const, text: prefix }, ...content] } as AgentMessage;\n  }\n  return message;\n}\n\nexport class UserContextPlanner {\n  async plan(params: {\n    memoryManager: MemoryManager;\n    agentId: string;\n    sessionKey: string;\n    query: string;\n    userMessage: AgentMessage;\n    excludedRecordIds?: string[];\n  }): Promise<UserContextPlan> {\n    const traceId = randomUUID();\n    const query = params.query.trim();\n    if (!query) {\n      return { traceId, modelMessage: params.userMessage, items: [], rejected: [], estimatedTokens: 0 };\n    }\n    const started = Date.now();\n    const scope = { agentId: params.agentId, sessionKey: params.sessionKey };\n    const [taskResults, baselineLists] = await Promise.all([\n      params.memoryManager.search({\n        query,\n        scope,\n        maxResults: MAX_RESULTS,\n        minScore: 0.15,\n      }).catch(() => []),\n      Promise.all(BASELINE_KINDS.map((kind) => (\n        params.memoryManager.list({ kind, status: 'active', scope }).catch(() => [])\n      ))),\n    ]);\n    const taskIds = new Set(taskResults.map((result) => result.record.id));\n    const baselineResults: MemorySearchResult[] = baselineLists\n      .flat()\n      .filter((record) => !taskIds.has(record.id))\n      .filter((record) => record.kind === 'boundary' || record.explicitness === 'explicit' || record.importance >= 0.7)\n      .map((record) => ({\n        record,\n        score: record.kind === 'boundary' ? 0.7 : 0.42,\n        snippet: record.content,\n        citation: {\n          providerId: record.source.provider ?? 'local',\n          recordId: record.id,\n          path: record.source.path,\n          lineStart: record.source.lineStart,\n          lineEnd: record.source.lineEnd,\n          createdAt: record.createdAt,\n        },\n      }));\n    const results = [...taskResults, ...baselineResults];\n    const now = Date.now();\n    const excluded = new Set(params.excludedRecordIds ?? []);\n    const rejected: UserContextPlan['rejected'] = [];\n    const ranked = results\n      .filter((result) => !excluded.has(result.record.id))\n      .map((result) => ({ result, score: scoreResult(result, now) }))\n      .sort((a, b) => b.score - a.score)\n      .filter((entry, index, all) => all.findIndex((candidate) => candidate.result.record.id === entry.result.record.id) === index)\n      .slice(0, MAX_RESULTS);\n    const items: PlannedUserContextItem[] = [];\n    let usedChars = 0;\n    for (const { result, score } of ranked) {\n      const reason = rejectReason(result.record, now) ?? (score < 0.25 ? 'low_score' : undefined);\n      if (reason) {\n        rejected.push({ recordId: result.record.id, reason });\n        continue;\n      }\n      const content = result.snippet.trim();\n      if (usedChars + content.length > MAX_CONTEXT_CHARS) {\n        rejected.push({ recordId: result.record.id, reason: 'budget' });\n        continue;\n      }\n      usedChars += content.length;\n      items.push({\n        recordId: result.record.id,\n        content,\n        score,\n        section: sectionFor(result.record),\n        citation: citationFor(result, params.agentId),\n        origin: classifyMemoryContextOrigin(result.record),\n        stability: resolveMemoryStability(result.record, now).score,\n      });\n    }\n    const sections: string[] = [];\n    for (const [section, title] of [['safety', 'Boundaries'], ['task', 'Relevant facts'], ['interaction', 'Interaction preferences']] as const) {\n      const sectionItems = items.filter((item) => item.section === section);\n      if (sectionItems.length > 0) {\n        sections.push(`${title}:\\n${sectionItems.map((item) => `- ${item.content}\\n  Evidence: ${evidenceLabel(item)}`).join('\\n')}`);\n      }\n    }\n    const block = buildUserContextBlock(sections.join('\\n\\n'));\n    try {\n      appendMemoryTraceEvent({\n        traceId,\n        phase: 'inject',\n        providerId: 'user-understanding',\n        sessionKey: params.sessionKey,\n        request: {\n          query,\n          rejected,\n          contextItems: items.map((item) => ({\n            recordId: item.recordId,\n            section: item.section,\n            origin: item.origin,\n            stability: item.stability,\n            citation: item.citation,\n          })),\n        },\n        resultCount: items.length,\n        selectedRecordIds: items.map((item) => item.recordId),\n        durationMs: Date.now() - started,\n      });\n    } catch (err) {\n      log.debug({ err, traceId, sessionKey: params.sessionKey }, 'Context plan trace was not persisted');\n    }\n    return {\n      traceId,\n      modelMessage: prependContext(params.userMessage, block),\n      items,\n      rejected,\n      estimatedTokens: Math.ceil(block.length / 4),\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/context/types.d.ts

@@ -1,11 +1,13 @@
 import type { AgentMessage } from '@earendil-works/pi-agent-core';
-export type UserContextRejectionReason = 'expired' | 'not_yet_valid' | 'sensitive' | 'requires_consent' | 'low_score' | 'budget';
+export type UserContextRejectionReason = 'expired' | 'not_yet_valid' | 'sensitive' | 'requires_consent' | 'needs_review' | 'low_score' | 'budget';
 export interface PlannedUserContextItem {
     recordId: string;
     content: string;
     score: number;
     section: 'task' | 'interaction' | 'safety';
     citation: string;
+    origin: 'told_by_user' | 'observed' | 'inferred' | 'connected_source';
+    stability: number;
 }
 export interface UserContextPlan {
     traceId: string;

package/dist/src/agent/memory/lifecycle.d.ts

@@ -0,0 +1,11 @@
+import type { MemoryRecord, MemoryStatus } from './types.js';
+export type MemoryStabilityBand = 'strong' | 'working' | 'fragile';
+export declare function nextMemoryReviewAt(record: Pick<MemoryRecord, 'durability' | 'explicitness'>, fromMs?: number): string;
+export declare function resolveMemoryStability(record: MemoryRecord, nowMs?: number): {
+    score: number;
+    band: MemoryStabilityBand;
+    reviewAt: string;
+    reviewDue: boolean;
+    expired: boolean;
+};
+export declare function effectiveMemoryStatus(record: MemoryRecord, nowMs?: number): MemoryStatus;

package/dist/src/agent/memory/lifecycle.js

@@ -0,0 +1,50 @@
+//#region src/agent/memory/lifecycle.ts
+const DAY_MS = 864e5;
+function clamp01(value) {
+	return Math.max(0, Math.min(1, value));
+}
+function reviewIntervalDays(record) {
+	if (record.durability === "ephemeral") return 14;
+	if (record.durability === "recurring") return record.explicitness === "explicit" ? 120 : 60;
+	if (record.explicitness === "explicit") return 365;
+	if (record.explicitness === "observed") return 180;
+	return 90;
+}
+function nextMemoryReviewAt(record, fromMs = Date.now()) {
+	return new Date(fromMs + reviewIntervalDays(record) * DAY_MS).toISOString();
+}
+function resolveMemoryStability(record, nowMs = Date.now()) {
+	const confidence = clamp01(record.confidence ?? .5);
+	const explicitness = record.explicitness === "explicit" ? 1 : record.explicitness === "observed" ? .7 : .45;
+	const durability = record.durability === "durable" ? 1 : record.durability === "recurring" ? .85 : .55;
+	const evidence = record.evidence ?? [];
+	const evidenceStrength = clamp01((evidence.length > 0 ? evidence.reduce((sum, item) => sum + clamp01(item.confidence ?? confidence), 0) / evidence.length : confidence * .8) * .75 + Math.min(evidence.length, 4) * .0625);
+	const updatedAtMs = Date.parse(record.updatedAt);
+	const ageDays = Number.isFinite(updatedAtMs) ? Math.max(0, (nowMs - updatedAtMs) / DAY_MS) : 0;
+	const halfLifeDays = record.durability === "ephemeral" ? 21 : record.durability === "recurring" ? 120 : 365;
+	const freshnessFloor = record.explicitness === "explicit" ? .72 : record.explicitness === "observed" ? .48 : .28;
+	const freshness = freshnessFloor + (1 - freshnessFloor) * Math.pow(.5, ageDays / halfLifeDays);
+	const raw = confidence * .32 + explicitness * .2 + clamp01(record.importance) * .16 + durability * .14 + evidenceStrength * .18;
+	const score = Math.round(clamp01(raw * freshness) * 1e3) / 1e3;
+	const band = score >= .75 ? "strong" : score >= .5 ? "working" : "fragile";
+	const inferredReviewAt = nextMemoryReviewAt(record, Number.isFinite(updatedAtMs) ? updatedAtMs : nowMs);
+	const reviewAt = record.reviewAfter && Number.isFinite(Date.parse(record.reviewAfter)) ? record.reviewAfter : inferredReviewAt;
+	const expired = Boolean(record.expiresAt && Date.parse(record.expiresAt) <= nowMs || record.validTo && Date.parse(record.validTo) <= nowMs);
+	return {
+		score,
+		band,
+		reviewAt,
+		reviewDue: record.status === "candidate" || record.status === "needs_review" || record.status === "stale" || Date.parse(reviewAt) <= nowMs,
+		expired
+	};
+}
+function effectiveMemoryStatus(record, nowMs = Date.now()) {
+	const lifecycle = resolveMemoryStability(record, nowMs);
+	if (lifecycle.expired && record.status === "active") return "stale";
+	if (lifecycle.reviewDue && record.status === "active") return "needs_review";
+	return record.status ?? "active";
+}
+//#endregion
+export { effectiveMemoryStatus, nextMemoryReviewAt, resolveMemoryStability };
+
+//# sourceMappingURL=lifecycle.js.map

package/dist/src/agent/memory/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","names":[],"sources":["../../../../src/agent/memory/lifecycle.ts"],"sourcesContent":["import type { MemoryRecord, MemoryStatus } from './types.js';\n\nexport type MemoryStabilityBand = 'strong' | 'working' | 'fragile';\n\nconst DAY_MS = 86_400_000;\n\nfunction clamp01(value: number): number {\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction reviewIntervalDays(record: Pick<MemoryRecord, 'durability' | 'explicitness'>): number {\n  if (record.durability === 'ephemeral') return 14;\n  if (record.durability === 'recurring') return record.explicitness === 'explicit' ? 120 : 60;\n  if (record.explicitness === 'explicit') return 365;\n  if (record.explicitness === 'observed') return 180;\n  return 90;\n}\n\nexport function nextMemoryReviewAt(\n  record: Pick<MemoryRecord, 'durability' | 'explicitness'>,\n  fromMs = Date.now(),\n): string {\n  return new Date(fromMs + reviewIntervalDays(record) * DAY_MS).toISOString();\n}\n\nexport function resolveMemoryStability(record: MemoryRecord, nowMs = Date.now()): {\n  score: number;\n  band: MemoryStabilityBand;\n  reviewAt: string;\n  reviewDue: boolean;\n  expired: boolean;\n} {\n  const confidence = clamp01(record.confidence ?? 0.5);\n  const explicitness = record.explicitness === 'explicit' ? 1 : record.explicitness === 'observed' ? 0.7 : 0.45;\n  const durability = record.durability === 'durable' ? 1 : record.durability === 'recurring' ? 0.85 : 0.55;\n  const evidence = record.evidence ?? [];\n  const evidenceConfidence = evidence.length > 0\n    ? evidence.reduce((sum, item) => sum + clamp01(item.confidence ?? confidence), 0) / evidence.length\n    : confidence * 0.8;\n  const evidenceStrength = clamp01(evidenceConfidence * 0.75 + Math.min(evidence.length, 4) * 0.0625);\n  const updatedAtMs = Date.parse(record.updatedAt);\n  const ageDays = Number.isFinite(updatedAtMs) ? Math.max(0, (nowMs - updatedAtMs) / DAY_MS) : 0;\n  const halfLifeDays = record.durability === 'ephemeral' ? 21 : record.durability === 'recurring' ? 120 : 365;\n  const freshnessFloor = record.explicitness === 'explicit' ? 0.72 : record.explicitness === 'observed' ? 0.48 : 0.28;\n  const freshness = freshnessFloor + (1 - freshnessFloor) * Math.pow(0.5, ageDays / halfLifeDays);\n  const raw = confidence * 0.32\n    + explicitness * 0.2\n    + clamp01(record.importance) * 0.16\n    + durability * 0.14\n    + evidenceStrength * 0.18;\n  const score = Math.round(clamp01(raw * freshness) * 1000) / 1000;\n  const band: MemoryStabilityBand = score >= 0.75 ? 'strong' : score >= 0.5 ? 'working' : 'fragile';\n  const inferredReviewAt = nextMemoryReviewAt(record, Number.isFinite(updatedAtMs) ? updatedAtMs : nowMs);\n  const reviewAt = record.reviewAfter && Number.isFinite(Date.parse(record.reviewAfter))\n    ? record.reviewAfter\n    : inferredReviewAt;\n  const expired = Boolean(\n    (record.expiresAt && Date.parse(record.expiresAt) <= nowMs)\n    || (record.validTo && Date.parse(record.validTo) <= nowMs),\n  );\n  const reviewDue = record.status === 'candidate'\n    || record.status === 'needs_review'\n    || record.status === 'stale'\n    || Date.parse(reviewAt) <= nowMs;\n  return { score, band, reviewAt, reviewDue, expired };\n}\n\nexport function effectiveMemoryStatus(record: MemoryRecord, nowMs = Date.now()): MemoryStatus {\n  const lifecycle = resolveMemoryStability(record, nowMs);\n  if (lifecycle.expired && record.status === 'active') return 'stale';\n  if (lifecycle.reviewDue && record.status === 'active') return 'needs_review';\n  return record.status ?? 'active';\n}\n"],"mappings":";AAIA,MAAM,SAAS;AAEf,SAAS,QAAQ,OAAuB;AACtC,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;;AAGxC,SAAS,mBAAmB,QAAmE;AAC7F,KAAI,OAAO,eAAe,YAAa,QAAO;AAC9C,KAAI,OAAO,eAAe,YAAa,QAAO,OAAO,iBAAiB,aAAa,MAAM;AACzF,KAAI,OAAO,iBAAiB,WAAY,QAAO;AAC/C,KAAI,OAAO,iBAAiB,WAAY,QAAO;AAC/C,QAAO;;AAGT,SAAgB,mBACd,QACA,SAAS,KAAK,KAAK,EACX;AACR,QAAO,IAAI,KAAK,SAAS,mBAAmB,OAAO,GAAG,OAAO,CAAC,aAAa;;AAG7E,SAAgB,uBAAuB,QAAsB,QAAQ,KAAK,KAAK,EAM7E;CACA,MAAM,aAAa,QAAQ,OAAO,cAAc,GAAI;CACpD,MAAM,eAAe,OAAO,iBAAiB,aAAa,IAAI,OAAO,iBAAiB,aAAa,KAAM;CACzG,MAAM,aAAa,OAAO,eAAe,YAAY,IAAI,OAAO,eAAe,cAAc,MAAO;CACpG,MAAM,WAAW,OAAO,YAAY,EAAE;CAItC,MAAM,mBAAmB,SAHE,SAAS,SAAS,IACzC,SAAS,QAAQ,KAAK,SAAS,MAAM,QAAQ,KAAK,cAAc,WAAW,EAAE,EAAE,GAAG,SAAS,SAC3F,aAAa,MACqC,MAAO,KAAK,IAAI,SAAS,QAAQ,EAAE,GAAG,MAAO;CACnG,MAAM,cAAc,KAAK,MAAM,OAAO,UAAU;CAChD,MAAM,UAAU,OAAO,SAAS,YAAY,GAAG,KAAK,IAAI,IAAI,QAAQ,eAAe,OAAO,GAAG;CAC7F,MAAM,eAAe,OAAO,eAAe,cAAc,KAAK,OAAO,eAAe,cAAc,MAAM;CACxG,MAAM,iBAAiB,OAAO,iBAAiB,aAAa,MAAO,OAAO,iBAAiB,aAAa,MAAO;CAC/G,MAAM,YAAY,kBAAkB,IAAI,kBAAkB,KAAK,IAAI,IAAK,UAAU,aAAa;CAC/F,MAAM,MAAM,aAAa,MACrB,eAAe,KACf,QAAQ,OAAO,WAAW,GAAG,MAC7B,aAAa,MACb,mBAAmB;CACvB,MAAM,QAAQ,KAAK,MAAM,QAAQ,MAAM,UAAU,GAAG,IAAK,GAAG;CAC5D,MAAM,OAA4B,SAAS,MAAO,WAAW,SAAS,KAAM,YAAY;CACxF,MAAM,mBAAmB,mBAAmB,QAAQ,OAAO,SAAS,YAAY,GAAG,cAAc,MAAM;CACvG,MAAM,WAAW,OAAO,eAAe,OAAO,SAAS,KAAK,MAAM,OAAO,YAAY,CAAC,GAClF,OAAO,cACP;CACJ,MAAM,UAAU,QACb,OAAO,aAAa,KAAK,MAAM,OAAO,UAAU,IAAI,SACjD,OAAO,WAAW,KAAK,MAAM,OAAO,QAAQ,IAAI,MACrD;AAKD,QAAO;EAAE;EAAO;EAAM;EAAU,WAJd,OAAO,WAAW,eAC/B,OAAO,WAAW,kBAClB,OAAO,WAAW,WAClB,KAAK,MAAM,SAAS,IAAI;EACc;EAAS;;AAGtD,SAAgB,sBAAsB,QAAsB,QAAQ,KAAK,KAAK,EAAgB;CAC5F,MAAM,YAAY,uBAAuB,QAAQ,MAAM;AACvD,KAAI,UAAU,WAAW,OAAO,WAAW,SAAU,QAAO;AAC5D,KAAI,UAAU,aAAa,OAAO,WAAW,SAAU,QAAO;AAC9D,QAAO,OAAO,UAAU"}

package/dist/src/agent/memory/source-origin.d.ts

@@ -0,0 +1,3 @@
+import type { MemoryRecord } from './types.js';
+export type MemoryContextOrigin = 'told_by_user' | 'observed' | 'inferred' | 'connected_source';
+export declare function classifyMemoryContextOrigin(record: MemoryRecord): MemoryContextOrigin;

package/dist/src/agent/memory/source-origin.js

@@ -0,0 +1,19 @@
+//#region src/agent/memory/source-origin.ts
+const INTERNAL_MEMORY_PROVIDERS = new Set([
+	"local",
+	"builtin",
+	"user-understanding",
+	"dreaming",
+	"workflow-run"
+]);
+function classifyMemoryContextOrigin(record) {
+	const provider = record.source.provider?.trim().toLowerCase();
+	if (provider && !INTERNAL_MEMORY_PROVIDERS.has(provider)) return "connected_source";
+	if (record.explicitness === "explicit") return "told_by_user";
+	if (record.explicitness === "observed") return "observed";
+	return "inferred";
+}
+//#endregion
+export { classifyMemoryContextOrigin };
+
+//# sourceMappingURL=source-origin.js.map

package/dist/src/agent/memory/source-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-origin.js","names":[],"sources":["../../../../src/agent/memory/source-origin.ts"],"sourcesContent":["import type { MemoryRecord } from './types.js';\n\nexport type MemoryContextOrigin = 'told_by_user' | 'observed' | 'inferred' | 'connected_source';\n\nconst INTERNAL_MEMORY_PROVIDERS = new Set([\n  'local',\n  'builtin',\n  'user-understanding',\n  'dreaming',\n  'workflow-run',\n]);\n\nexport function classifyMemoryContextOrigin(record: MemoryRecord): MemoryContextOrigin {\n  const provider = record.source.provider?.trim().toLowerCase();\n  if (provider && !INTERNAL_MEMORY_PROVIDERS.has(provider)) return 'connected_source';\n  if (record.explicitness === 'explicit') return 'told_by_user';\n  if (record.explicitness === 'observed') return 'observed';\n  return 'inferred';\n}\n"],"mappings":";AAIA,MAAM,4BAA4B,IAAI,IAAI;CACxC;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,4BAA4B,QAA2C;CACrF,MAAM,WAAW,OAAO,OAAO,UAAU,MAAM,CAAC,aAAa;AAC7D,KAAI,YAAY,CAAC,0BAA0B,IAAI,SAAS,CAAE,QAAO;AACjE,KAAI,OAAO,iBAAiB,WAAY,QAAO;AAC/C,KAAI,OAAO,iBAAiB,WAAY,QAAO;AAC/C,QAAO"}

package/dist/src/agent/memory/understanding/service.js

@@ -3,6 +3,7 @@ import { init_logger } from "../../../utils/logger.js";
 import { appendMemoryTraceEvent } from "../../../storage/sqlite/memory-records-repository.js";
 import { attachMemoryEvidence, upsertKnowledgeSourceItems } from "../../../storage/sqlite/knowledge-repository.js";
 import "../../../storage/sqlite/index.js";
+import { nextMemoryReviewAt } from "../lifecycle.js";
 import { extractExplicitUnderstandingCorrectionContent } from "./correction.js";
 import { inferMemorySensitivity, redactSensitiveMemoryText } from "../sensitivity.js";
 import { createHash } from "node:crypto";
@@ -172,6 +173,10 @@ var UserUnderstandingService = class {
 				evidence: [evidence],
 				validFrom: candidate.validFrom,
 				validTo: candidate.validTo,
+				reviewAfter: nextMemoryReviewAt({
+					durability: candidate.durability,
+					explicitness: candidate.explicitness
+				}),
 				supersedesRecordId
 			});
 			if (write.success) {

package/dist/src/agent/memory/understanding/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","names":[],"sources":["../../../../../src/agent/memory/understanding/service.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nimport {\n  appendMemoryTraceEvent,\n  attachMemoryEvidence,\n  upsertKnowledgeSourceItems,\n} from '../../../storage/sqlite/index.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport type {\n  MemoryEvidence,\n  MemoryKind,\n  MemoryRecord,\n  MemorySensitivity,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n} from '../types.js';\nimport { extractExplicitUnderstandingCorrectionContent } from './correction.js';\nimport type { UnderstandingCandidate, UnderstandingReviewResult } from './types.js';\nimport { inferMemorySensitivity, redactSensitiveMemoryText } from '../sensitivity.js';\n\nconst log = createLogger('UserUnderstanding');\nconst MAX_CANDIDATE_CHARS = 600;\n\nconst EXPLICIT_PATTERNS: RegExp[] = [\n  /\\b(?:please\\s+)?remember(?:\\s+that)?\\s+(.+)/i,\n  /\\bkeep\\s+in\\s+mind(?:\\s+that)?\\s+(.+)/i,\n  /(?:请)?记住[：:\\s]*(.+)/,\n  /以后(?:都)?(?:请)?[：:\\s]*(.+)/,\n  /下次(?:请)?[：:\\s]*(.+)/,\n];\n\nfunction normalizeContent(raw: string): string {\n  return raw\n    .replace(/^[\"'“”‘’\\s]+|[\"'“”‘’\\s]+$/g, '')\n    .replace(/\\s+/g, ' ')\n    .trim()\n    .slice(0, MAX_CANDIDATE_CHARS);\n}\n\nfunction inferKind(content: string): MemoryKind {\n  if (/\\b(don't|do not|never|avoid)\\b/i.test(content) || /不要|别再|禁止|底线/.test(content)) {\n    return 'boundary';\n  }\n  if (/\\b(prefer|preference|like)\\b/i.test(content) || /喜欢|偏好|习惯/.test(content)) {\n    return 'preference';\n  }\n  if (/\\b(tool|command|pnpm|npm|git|ripgrep|rg)\\b/i.test(content) || /工具|命令/.test(content)) {\n    return 'tool_preference';\n  }\n  if (/\\b(project|repo|codebase|workspace)\\b/i.test(content) || /项目|仓库|代码库/.test(content)) {\n    return 'project_context';\n  }\n  if (/\\b(goal|plan|commit|deadline)\\b/i.test(content) || /目标|计划|承诺|截止/.test(content)) {\n    return 'commitment';\n  }\n  if (/\\b(next time|lesson|failed|error)\\b/i.test(content) || /下次|教训|失败|错误/.test(content)) {\n    return 'task_lesson';\n  }\n  return 'agent_note';\n}\n\nconst SENSITIVITY_RANK: Record<MemorySensitivity, number> = {\n  normal: 0,\n  personal: 1,\n  regulated: 2,\n  secret: 3,\n};\n\nfunction stricterSensitivity(content: string, declared: MemorySensitivity): MemorySensitivity {\n  const inferred = inferMemorySensitivity(content);\n  return SENSITIVITY_RANK[inferred] > SENSITIVITY_RANK[declared] ? inferred : declared;\n}\n\nfunction canonicalKey(kind: MemoryKind, content: string): string {\n  const normalized = content\n    .toLocaleLowerCase()\n    .replace(/[^\\p{L}\\p{N}]+/gu, ' ')\n    .trim();\n  return `${kind}:${createHash('sha256').update(normalized).digest('hex').slice(0, 20)}`;\n}\n\nexport function extractExplicitUnderstandingCandidates(userContent: string): UnderstandingCandidate[] {\n  const correction = extractExplicitUnderstandingCorrectionContent(userContent);\n  if (correction) {\n    const kind = inferKind(correction);\n    return [{\n      kind,\n      content: correction,\n      canonicalKey: canonicalKey(kind, correction),\n      confidence: 0.95,\n      importance: kind === 'boundary' ? 0.9 : 0.8,\n      explicitness: 'explicit',\n      durability: 'durable',\n      sensitivity: inferMemorySensitivity(correction),\n      disclosurePolicy: kind === 'boundary' ? 'silent' : 'referenceable',\n      tags: ['user-understanding', 'explicit-user-correction'],\n    }];\n  }\n  const lines = userContent.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);\n  for (const line of lines.length > 0 ? lines : [userContent.trim()]) {\n    for (const pattern of EXPLICIT_PATTERNS) {\n      const content = normalizeContent(pattern.exec(line)?.[1] ?? '');\n      if (content.length < 8) continue;\n      const kind = inferKind(content);\n      return [{\n        kind,\n        content,\n        canonicalKey: canonicalKey(kind, content),\n        confidence: 0.92,\n        importance: kind === 'boundary' ? 0.9 : 0.75,\n        explicitness: 'explicit',\n        durability: 'durable',\n        sensitivity: inferMemorySensitivity(content),\n        disclosurePolicy: kind === 'boundary' ? 'silent' : 'referenceable',\n        tags: ['user-understanding', 'explicit-user-request'],\n      }];\n    }\n  }\n  return [];\n}\n\nexport interface UserUnderstandingServiceOptions {\n  write: (request: MemoryWriteRequest) => Promise<MemoryWriteResult>;\n  list: (canonicalKey: string) => Promise<MemoryRecord[]>;\n}\n\nexport class UserUnderstandingService {\n  constructor(private readonly options: UserUnderstandingServiceOptions) {}\n\n  async reviewTurn(params: {\n    agentId?: string;\n    userContent: string;\n    assistantContent: string;\n    sessionKey?: string;\n    correctionTargetRecordIds?: string[];\n  }): Promise<UnderstandingReviewResult> {\n    const candidates = extractExplicitUnderstandingCandidates(params.userContent);\n    const sourceText = `User:\\n${params.userContent.trim()}\\n\\nAssistant:\\n${params.assistantContent.trim()}`;\n    const normalizedText = redactSensitiveMemoryText(sourceText);\n    const contentHash = createHash('sha256').update(sourceText).digest('hex');\n    const stored = upsertKnowledgeSourceItems([{\n      sourceInstanceId: params.sessionKey ? `session:${params.sessionKey}` : 'session:unknown',\n      externalId: contentHash,\n      itemType: 'conversation_turn',\n      authorRole: 'user',\n      occurredAt: new Date().toISOString(),\n      contentHash,\n      normalizedText,\n      metadata: params.sessionKey ? { sessionKey: params.sessionKey } : {},\n      sensitivity: 'personal',\n      retentionClass: 'bounded',\n      synthesisStatus: 'pending',\n    }]);\n    const sourceItemId = stored.items[0]?.id;\n    const result = await this.applyCandidates(candidates, {\n      agentId: params.agentId,\n      sessionKey: params.sessionKey,\n      sourceItemId,\n      sourceText: params.userContent,\n      reviewSource: 'turn',\n      supersedesRecordIds: params.correctionTargetRecordIds,\n    });\n    return { ...result, sourceItemId };\n  }\n\n  async applyCandidates(\n    candidates: UnderstandingCandidate[],\n    context: {\n      agentId?: string;\n      sessionKey?: string;\n      sourceItemId?: string;\n      sourceText?: string;\n      reviewSource?: 'turn' | 'background';\n      supersedesRecordIds?: string[];\n    },\n  ): Promise<Omit<UnderstandingReviewResult, 'sourceItemId'>> {\n    const startedAt = Date.now();\n    let created = 0;\n    let deduplicated = 0;\n    let rejected = 0;\n    const recordIds: string[] = [];\n    for (const candidate of candidates.slice(0, 10)) {\n      const content = normalizeContent(candidate.content);\n      const sensitivity = stricterSensitivity(content, candidate.sensitivity);\n      if (\n        content.length < 4\n        || candidate.confidence < 0.55\n        || sensitivity === 'secret'\n        || sensitivity === 'regulated'\n      ) {\n        rejected += 1;\n        continue;\n      }\n      const evidenceText = context.sourceText\n        ? redactSensitiveMemoryText(context.sourceText).slice(0, MAX_CANDIDATE_CHARS)\n        : undefined;\n      const key = candidate.canonicalKey ?? canonicalKey(candidate.kind, content);\n      const supersedesRecordId = context.supersedesRecordIds\n        && [...new Set(context.supersedesRecordIds)].length === 1\n        ? context.supersedesRecordIds[0]\n        : undefined;\n      const existing = await this.options.list(key);\n      const evidence: MemoryEvidence = {\n        ...(context.sourceItemId ? { sourceItemId: context.sourceItemId } : {}),\n        relation: 'supports',\n        ...(context.sessionKey ? { sessionKey: context.sessionKey } : {}),\n        ...(evidenceText ? { sourceText: evidenceText } : {}),\n        observedAt: new Date().toISOString(),\n        confidence: candidate.confidence,\n      };\n      if (existing[0]) {\n        deduplicated += 1;\n        recordIds.push(existing[0].id);\n        if (context.sourceItemId) {\n          attachMemoryEvidence({\n            recordId: existing[0].id,\n            sourceItemId: context.sourceItemId,\n            relation: 'supports',\n            excerpt: evidenceText,\n            confidence: candidate.confidence,\n          });\n        }\n        continue;\n      }\n      const write = await this.options.write({\n        kind: candidate.kind,\n        content,\n        canonicalKey: key,\n        scope: context.agentId || context.sessionKey\n          ? { agentId: context.agentId, sessionKey: context.sessionKey }\n          : undefined,\n        target: candidate.kind === 'preference' ? 'user' : 'memory',\n        tags: [...new Set(['user-understanding', ...(candidate.tags ?? [])])],\n        source: { provider: 'user-understanding' },\n        confidence: candidate.confidence,\n        status: 'candidate',\n        sensitivity,\n        explicitness: candidate.explicitness,\n        durability: candidate.durability,\n        importance: candidate.importance,\n        disclosurePolicy: candidate.disclosurePolicy,\n        evidence: [evidence],\n        validFrom: candidate.validFrom,\n        validTo: candidate.validTo,\n        supersedesRecordId,\n      });\n      if (write.success) {\n        created += 1;\n        if (write.record) recordIds.push(write.record.id);\n        if (write.record && context.sourceItemId) {\n          attachMemoryEvidence({\n            recordId: write.record.id,\n            sourceItemId: context.sourceItemId,\n            relation: 'supports',\n            excerpt: evidenceText,\n            confidence: candidate.confidence,\n          });\n        }\n      } else {\n        rejected += 1;\n        log.debug({ errorMessage: write.error, canonicalKey: key }, 'Understanding candidate was not stored');\n      }\n    }\n    try {\n      appendMemoryTraceEvent({\n        sessionKey: context.sessionKey,\n        phase: 'understanding',\n        providerId: 'user-understanding',\n        request: {\n          ...(context.agentId ? { agentId: context.agentId } : {}),\n          source: context.reviewSource ?? 'turn',\n          proposed: candidates.length,\n          created,\n          deduplicated,\n          rejected,\n        },\n        resultCount: created,\n        selectedRecordIds: recordIds,\n        durationMs: Date.now() - startedAt,\n      });\n    } catch (err) {\n      log.debug({ err, sessionKey: context.sessionKey }, 'Understanding quality trace append failed');\n    }\n    return { proposed: candidates.length, created, deduplicated, rejected };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"service.js","names":[],"sources":["../../../../../src/agent/memory/understanding/service.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nimport {\n  appendMemoryTraceEvent,\n  attachMemoryEvidence,\n  upsertKnowledgeSourceItems,\n} from '../../../storage/sqlite/index.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport type {\n  MemoryEvidence,\n  MemoryKind,\n  MemoryRecord,\n  MemorySensitivity,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n} from '../types.js';\nimport { nextMemoryReviewAt } from '../lifecycle.js';\nimport { extractExplicitUnderstandingCorrectionContent } from './correction.js';\nimport type { UnderstandingCandidate, UnderstandingReviewResult } from './types.js';\nimport { inferMemorySensitivity, redactSensitiveMemoryText } from '../sensitivity.js';\n\nconst log = createLogger('UserUnderstanding');\nconst MAX_CANDIDATE_CHARS = 600;\n\nconst EXPLICIT_PATTERNS: RegExp[] = [\n  /\\b(?:please\\s+)?remember(?:\\s+that)?\\s+(.+)/i,\n  /\\bkeep\\s+in\\s+mind(?:\\s+that)?\\s+(.+)/i,\n  /(?:请)?记住[：:\\s]*(.+)/,\n  /以后(?:都)?(?:请)?[：:\\s]*(.+)/,\n  /下次(?:请)?[：:\\s]*(.+)/,\n];\n\nfunction normalizeContent(raw: string): string {\n  return raw\n    .replace(/^[\"'“”‘’\\s]+|[\"'“”‘’\\s]+$/g, '')\n    .replace(/\\s+/g, ' ')\n    .trim()\n    .slice(0, MAX_CANDIDATE_CHARS);\n}\n\nfunction inferKind(content: string): MemoryKind {\n  if (/\\b(don't|do not|never|avoid)\\b/i.test(content) || /不要|别再|禁止|底线/.test(content)) {\n    return 'boundary';\n  }\n  if (/\\b(prefer|preference|like)\\b/i.test(content) || /喜欢|偏好|习惯/.test(content)) {\n    return 'preference';\n  }\n  if (/\\b(tool|command|pnpm|npm|git|ripgrep|rg)\\b/i.test(content) || /工具|命令/.test(content)) {\n    return 'tool_preference';\n  }\n  if (/\\b(project|repo|codebase|workspace)\\b/i.test(content) || /项目|仓库|代码库/.test(content)) {\n    return 'project_context';\n  }\n  if (/\\b(goal|plan|commit|deadline)\\b/i.test(content) || /目标|计划|承诺|截止/.test(content)) {\n    return 'commitment';\n  }\n  if (/\\b(next time|lesson|failed|error)\\b/i.test(content) || /下次|教训|失败|错误/.test(content)) {\n    return 'task_lesson';\n  }\n  return 'agent_note';\n}\n\nconst SENSITIVITY_RANK: Record<MemorySensitivity, number> = {\n  normal: 0,\n  personal: 1,\n  regulated: 2,\n  secret: 3,\n};\n\nfunction stricterSensitivity(content: string, declared: MemorySensitivity): MemorySensitivity {\n  const inferred = inferMemorySensitivity(content);\n  return SENSITIVITY_RANK[inferred] > SENSITIVITY_RANK[declared] ? inferred : declared;\n}\n\nfunction canonicalKey(kind: MemoryKind, content: string): string {\n  const normalized = content\n    .toLocaleLowerCase()\n    .replace(/[^\\p{L}\\p{N}]+/gu, ' ')\n    .trim();\n  return `${kind}:${createHash('sha256').update(normalized).digest('hex').slice(0, 20)}`;\n}\n\nexport function extractExplicitUnderstandingCandidates(userContent: string): UnderstandingCandidate[] {\n  const correction = extractExplicitUnderstandingCorrectionContent(userContent);\n  if (correction) {\n    const kind = inferKind(correction);\n    return [{\n      kind,\n      content: correction,\n      canonicalKey: canonicalKey(kind, correction),\n      confidence: 0.95,\n      importance: kind === 'boundary' ? 0.9 : 0.8,\n      explicitness: 'explicit',\n      durability: 'durable',\n      sensitivity: inferMemorySensitivity(correction),\n      disclosurePolicy: kind === 'boundary' ? 'silent' : 'referenceable',\n      tags: ['user-understanding', 'explicit-user-correction'],\n    }];\n  }\n  const lines = userContent.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);\n  for (const line of lines.length > 0 ? lines : [userContent.trim()]) {\n    for (const pattern of EXPLICIT_PATTERNS) {\n      const content = normalizeContent(pattern.exec(line)?.[1] ?? '');\n      if (content.length < 8) continue;\n      const kind = inferKind(content);\n      return [{\n        kind,\n        content,\n        canonicalKey: canonicalKey(kind, content),\n        confidence: 0.92,\n        importance: kind === 'boundary' ? 0.9 : 0.75,\n        explicitness: 'explicit',\n        durability: 'durable',\n        sensitivity: inferMemorySensitivity(content),\n        disclosurePolicy: kind === 'boundary' ? 'silent' : 'referenceable',\n        tags: ['user-understanding', 'explicit-user-request'],\n      }];\n    }\n  }\n  return [];\n}\n\nexport interface UserUnderstandingServiceOptions {\n  write: (request: MemoryWriteRequest) => Promise<MemoryWriteResult>;\n  list: (canonicalKey: string) => Promise<MemoryRecord[]>;\n}\n\nexport class UserUnderstandingService {\n  constructor(private readonly options: UserUnderstandingServiceOptions) {}\n\n  async reviewTurn(params: {\n    agentId?: string;\n    userContent: string;\n    assistantContent: string;\n    sessionKey?: string;\n    correctionTargetRecordIds?: string[];\n  }): Promise<UnderstandingReviewResult> {\n    const candidates = extractExplicitUnderstandingCandidates(params.userContent);\n    const sourceText = `User:\\n${params.userContent.trim()}\\n\\nAssistant:\\n${params.assistantContent.trim()}`;\n    const normalizedText = redactSensitiveMemoryText(sourceText);\n    const contentHash = createHash('sha256').update(sourceText).digest('hex');\n    const stored = upsertKnowledgeSourceItems([{\n      sourceInstanceId: params.sessionKey ? `session:${params.sessionKey}` : 'session:unknown',\n      externalId: contentHash,\n      itemType: 'conversation_turn',\n      authorRole: 'user',\n      occurredAt: new Date().toISOString(),\n      contentHash,\n      normalizedText,\n      metadata: params.sessionKey ? { sessionKey: params.sessionKey } : {},\n      sensitivity: 'personal',\n      retentionClass: 'bounded',\n      synthesisStatus: 'pending',\n    }]);\n    const sourceItemId = stored.items[0]?.id;\n    const result = await this.applyCandidates(candidates, {\n      agentId: params.agentId,\n      sessionKey: params.sessionKey,\n      sourceItemId,\n      sourceText: params.userContent,\n      reviewSource: 'turn',\n      supersedesRecordIds: params.correctionTargetRecordIds,\n    });\n    return { ...result, sourceItemId };\n  }\n\n  async applyCandidates(\n    candidates: UnderstandingCandidate[],\n    context: {\n      agentId?: string;\n      sessionKey?: string;\n      sourceItemId?: string;\n      sourceText?: string;\n      reviewSource?: 'turn' | 'background';\n      supersedesRecordIds?: string[];\n    },\n  ): Promise<Omit<UnderstandingReviewResult, 'sourceItemId'>> {\n    const startedAt = Date.now();\n    let created = 0;\n    let deduplicated = 0;\n    let rejected = 0;\n    const recordIds: string[] = [];\n    for (const candidate of candidates.slice(0, 10)) {\n      const content = normalizeContent(candidate.content);\n      const sensitivity = stricterSensitivity(content, candidate.sensitivity);\n      if (\n        content.length < 4\n        || candidate.confidence < 0.55\n        || sensitivity === 'secret'\n        || sensitivity === 'regulated'\n      ) {\n        rejected += 1;\n        continue;\n      }\n      const evidenceText = context.sourceText\n        ? redactSensitiveMemoryText(context.sourceText).slice(0, MAX_CANDIDATE_CHARS)\n        : undefined;\n      const key = candidate.canonicalKey ?? canonicalKey(candidate.kind, content);\n      const supersedesRecordId = context.supersedesRecordIds\n        && [...new Set(context.supersedesRecordIds)].length === 1\n        ? context.supersedesRecordIds[0]\n        : undefined;\n      const existing = await this.options.list(key);\n      const evidence: MemoryEvidence = {\n        ...(context.sourceItemId ? { sourceItemId: context.sourceItemId } : {}),\n        relation: 'supports',\n        ...(context.sessionKey ? { sessionKey: context.sessionKey } : {}),\n        ...(evidenceText ? { sourceText: evidenceText } : {}),\n        observedAt: new Date().toISOString(),\n        confidence: candidate.confidence,\n      };\n      if (existing[0]) {\n        deduplicated += 1;\n        recordIds.push(existing[0].id);\n        if (context.sourceItemId) {\n          attachMemoryEvidence({\n            recordId: existing[0].id,\n            sourceItemId: context.sourceItemId,\n            relation: 'supports',\n            excerpt: evidenceText,\n            confidence: candidate.confidence,\n          });\n        }\n        continue;\n      }\n      const write = await this.options.write({\n        kind: candidate.kind,\n        content,\n        canonicalKey: key,\n        scope: context.agentId || context.sessionKey\n          ? { agentId: context.agentId, sessionKey: context.sessionKey }\n          : undefined,\n        target: candidate.kind === 'preference' ? 'user' : 'memory',\n        tags: [...new Set(['user-understanding', ...(candidate.tags ?? [])])],\n        source: { provider: 'user-understanding' },\n        confidence: candidate.confidence,\n        status: 'candidate',\n        sensitivity,\n        explicitness: candidate.explicitness,\n        durability: candidate.durability,\n        importance: candidate.importance,\n        disclosurePolicy: candidate.disclosurePolicy,\n        evidence: [evidence],\n        validFrom: candidate.validFrom,\n        validTo: candidate.validTo,\n        reviewAfter: nextMemoryReviewAt({\n          durability: candidate.durability,\n          explicitness: candidate.explicitness,\n        }),\n        supersedesRecordId,\n      });\n      if (write.success) {\n        created += 1;\n        if (write.record) recordIds.push(write.record.id);\n        if (write.record && context.sourceItemId) {\n          attachMemoryEvidence({\n            recordId: write.record.id,\n            sourceItemId: context.sourceItemId,\n            relation: 'supports',\n            excerpt: evidenceText,\n            confidence: candidate.confidence,\n          });\n        }\n      } else {\n        rejected += 1;\n        log.debug({ errorMessage: write.error, canonicalKey: key }, 'Understanding candidate was not stored');\n      }\n    }\n    try {\n      appendMemoryTraceEvent({\n        sessionKey: context.sessionKey,\n        phase: 'understanding',\n        providerId: 'user-understanding',\n        request: {\n          ...(context.agentId ? { agentId: context.agentId } : {}),\n          source: context.reviewSource ?? 'turn',\n          proposed: candidates.length,\n          created,\n          deduplicated,\n          rejected,\n        },\n        resultCount: created,\n        selectedRecordIds: recordIds,\n        durationMs: Date.now() - startedAt,\n      });\n    } catch (err) {\n      log.debug({ err, sessionKey: context.sessionKey }, 'Understanding quality trace append failed');\n    }\n    return { proposed: candidates.length, created, deduplicated, rejected };\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/user-context-coordinator.js

@@ -36,6 +36,7 @@ var UserContextCoordinator = class {
 		if (!this.options.isEnabledForSession(sessionKey)) return empty();
 		const query = extractAgentUserPlainText(userMessage);
 		this.correctionTargets.delete(sessionKey);
+		let excludedRecordIds;
 		if (isExplicitUnderstandingCorrection(query)) try {
 			const trace = setLatestMemoryInjectFeedback({
 				sessionKey,
@@ -46,7 +47,10 @@ var UserContextCoordinator = class {
 					reason: "detected_explicit_user_correction"
 				}
 			});
-			if (trace?.selectedRecordIds.length) this.correctionTargets.set(sessionKey, trace.selectedRecordIds);
+			if (trace?.selectedRecordIds.length) {
+				this.correctionTargets.set(sessionKey, trace.selectedRecordIds);
+				excludedRecordIds = trace.selectedRecordIds;
+			}
 		} catch (err) {
 			log.debug({
 				err,
@@ -61,7 +65,8 @@ var UserContextCoordinator = class {
 			agentId: this.options.getAgentIdForSession(sessionKey),
 			sessionKey,
 			query,
-			userMessage
+			userMessage,
+			excludedRecordIds
 		});
 	}
 	async afterTurn(sessionKey, userPlainText) {