@xopcai/xopc 0.0.142 → 0.0.144

package/dist/src/agent/embedded/xopc-tools-bridge.js

@@ -1,4 +1,6 @@
 //#region src/agent/embedded/xopc-tools-bridge.ts
+const APPLY_PATCH_BEGIN_MARKER = "*** Begin Patch";
+const APPLY_PATCH_END_MARKER = "*** End Patch";
 const TOOL_PROMPT_HINTS = {
 	read_file: {
 		promptSnippet: "Read targeted file contents",
@@ -9,8 +11,14 @@ const TOOL_PROMPT_HINTS = {
 		promptGuidelines: ["Prefer apply_patch for code changes. Use write_file only for non-code artifacts or deliberate full-file rewrites."]
 	},
 	apply_patch: {
-		promptSnippet: "Apply strict multi-file patches for code edits",
-		promptGuidelines: ["Use apply_patch for all source edits. Keep patches small and verify with exec_command."]
+		promptSnippet: "Apply patches using the exact apply_patch envelope",
+		promptGuidelines: [
+			"Use apply_patch for source edits. Keep patches small and verify with exec_command.",
+			"The patch must start exactly with `*** Begin Patch` and end exactly with `*** End Patch`.",
+			"Patch control lines must not end in ` ***`; do not wrap the patch in a Markdown code fence or add prose.",
+			"Use this shape: `*** Begin Patch\\n*** Update File: path\\n@@\\n-old\\n+new\\n*** End Patch`.",
+			"If apply_patch rejects the envelope, regenerate the complete patch from this exact shape instead of repeating it."
+		]
 	},
 	exec_command: {
 		promptSnippet: "Run tests, type checks, builds, package scripts, and safe inspection commands",
@@ -23,6 +31,62 @@ const TOOL_PROMPT_HINTS = {
 	grep: { promptSnippet: "Search file contents for literals, errors, config values, and docs" },
 	find: { promptSnippet: "Find files by glob pattern" }
 };
+function validateApplyPatchEnvelope(params) {
+	if (!params || typeof params !== "object" || Array.isArray(params)) return {
+		code: "invalid_patch_envelope",
+		field: "patch",
+		issue: "missing_patch",
+		expected: APPLY_PATCH_BEGIN_MARKER,
+		retryHint: "Pass a patch string beginning with the exact marker `*** Begin Patch`."
+	};
+	const patch = params.patch;
+	if (typeof patch !== "string") return {
+		code: "invalid_patch_envelope",
+		field: "patch",
+		issue: "missing_patch",
+		expected: APPLY_PATCH_BEGIN_MARKER,
+		retryHint: "Pass a patch string beginning with the exact marker `*** Begin Patch`."
+	};
+	const lines = patch.split(/\r?\n/);
+	const firstLine = lines[0] ?? "";
+	if (firstLine !== APPLY_PATCH_BEGIN_MARKER) return {
+		code: "invalid_patch_envelope",
+		field: "patch",
+		issue: "first_line",
+		expected: APPLY_PATCH_BEGIN_MARKER,
+		received: firstLine,
+		retryHint: "Use `*** Begin Patch` exactly. Do not add trailing ` ***`, prose, or a Markdown code fence."
+	};
+	const malformedControlLine = lines.slice(1, -1).find((line) => line.startsWith("*** ") && line.endsWith(" ***"));
+	if (malformedControlLine) return {
+		code: "invalid_patch_envelope",
+		field: "patch",
+		issue: "control_line",
+		expected: malformedControlLine.slice(0, -4),
+		received: malformedControlLine,
+		retryHint: "Patch control lines must not end in ` ***`. Remove the trailing stars from this control line."
+	};
+	const lastLine = lines.at(-1) ?? "";
+	if (lastLine !== APPLY_PATCH_END_MARKER) return {
+		code: "invalid_patch_envelope",
+		field: "patch",
+		issue: "last_line",
+		expected: APPLY_PATCH_END_MARKER,
+		received: lastLine,
+		retryHint: "End the patch with `*** End Patch` exactly. Do not add trailing ` ***` or prose."
+	};
+	return null;
+}
+function invalidApplyPatchEnvelopeResult(error) {
+	const received = error.received === void 0 ? "" : ` Received: ${JSON.stringify(error.received)}.`;
+	return {
+		content: [{
+			type: "text",
+			text: `apply_patch input rejected (${error.issue}). Expected: ${error.expected}.${received} ${error.retryHint} Use this exact envelope:\n${APPLY_PATCH_BEGIN_MARKER}\n*** Update File: path\n@@\n-old\n+new\n${APPLY_PATCH_END_MARKER}`
+		}],
+		details: error
+	};
+}
 /** Map xopc {@link AgentTool} instances to pi-coding-agent {@link ToolDefinition}s for `createAgentSession`. */
 function xopcToolsToDefinitions(tools) {
 	return tools.map((tool) => {
@@ -35,12 +99,16 @@ function xopcToolsToDefinitions(tools) {
 			...promptHints?.promptGuidelines ? { promptGuidelines: promptHints.promptGuidelines } : {},
 			parameters: tool.parameters,
 			async execute(toolCallId, params, signal, onUpdate) {
+				if (tool.name === "apply_patch") {
+					const envelopeError = validateApplyPatchEnvelope(params);
+					if (envelopeError) return invalidApplyPatchEnvelopeResult(envelopeError);
+				}
 				return tool.execute(toolCallId, params, signal, onUpdate);
 			}
 		};
 	});
 }
 //#endregion
-export { xopcToolsToDefinitions };
+export { validateApplyPatchEnvelope, xopcToolsToDefinitions };
 
 //# sourceMappingURL=xopc-tools-bridge.js.map

package/dist/src/agent/embedded/xopc-tools-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"xopc-tools-bridge.js","names":[],"sources":["../../../../src/agent/embedded/xopc-tools-bridge.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nconst TOOL_PROMPT_HINTS: Record<string, { promptSnippet?: string; promptGuidelines?: string[] }> = {\n  read_file: {\n    promptSnippet: 'Read targeted file contents',\n    promptGuidelines: ['Use read_file to inspect source files before editing.'],\n  },\n  write_file: {\n    promptSnippet: 'Create new files or intentional complete rewrites',\n    promptGuidelines: ['Prefer apply_patch for code changes. Use write_file only for non-code artifacts or deliberate full-file rewrites.'],\n  },\n  apply_patch: {\n    promptSnippet: 'Apply strict multi-file patches for code edits',\n    promptGuidelines: ['Use apply_patch for all source edits. Keep patches small and verify with exec_command.'],\n  },\n  exec_command: {\n    promptSnippet: 'Run tests, type checks, builds, package scripts, and safe inspection commands',\n    promptGuidelines: ['Use exec_command for verification and safe inspection, not routine file editing.'],\n  },\n  update_plan: {\n    promptSnippet: 'Update the visible multi-step coding plan',\n    promptGuidelines: ['Use update_plan for multi-step coding work and keep the active step current.'],\n  },\n  grep: {\n    promptSnippet: 'Search file contents for literals, errors, config values, and docs',\n  },\n  find: {\n    promptSnippet: 'Find files by glob pattern',\n  },\n};\n\n/** Map xopc {@link AgentTool} instances to pi-coding-agent {@link ToolDefinition}s for `createAgentSession`. */\nexport function xopcToolsToDefinitions(tools: AgentTool[]): ToolDefinition[] {\n  return tools.map((tool) => {\n    const promptHints = TOOL_PROMPT_HINTS[tool.name];\n    const def = {\n      name: tool.name,\n      label: tool.label ?? tool.name,\n      description: tool.description ?? tool.name,\n      ...(promptHints?.promptSnippet ? { promptSnippet: promptHints.promptSnippet } : {}),\n      ...(promptHints?.promptGuidelines ? { promptGuidelines: promptHints.promptGuidelines } : {}),\n      parameters: tool.parameters,\n      async execute(\n        toolCallId: string,\n        params: unknown,\n        signal: AbortSignal | undefined,\n        onUpdate: unknown,\n      ) {\n        return (tool as { execute: (...a: never[]) => unknown }).execute(\n          toolCallId as never,\n          params as never,\n          signal as never,\n          onUpdate as never,\n        ) as never;\n      },\n    };\n    return def as unknown as ToolDefinition;\n  });\n}\n"],"mappings":";AAGA,MAAM,oBAA6F;CACjG,WAAW;EACT,eAAe;EACf,kBAAkB,CAAC,wDAAwD;EAC5E;CACD,YAAY;EACV,eAAe;EACf,kBAAkB,CAAC,oHAAoH;EACxI;CACD,aAAa;EACX,eAAe;EACf,kBAAkB,CAAC,yFAAyF;EAC7G;CACD,cAAc;EACZ,eAAe;EACf,kBAAkB,CAAC,mFAAmF;EACvG;CACD,aAAa;EACX,eAAe;EACf,kBAAkB,CAAC,+EAA+E;EACnG;CACD,MAAM,EACJ,eAAe,sEAChB;CACD,MAAM,EACJ,eAAe,8BAChB;CACF;;AAGD,SAAgB,uBAAuB,OAAsC;AAC3E,QAAO,MAAM,KAAK,SAAS;EACzB,MAAM,cAAc,kBAAkB,KAAK;AAsB3C,SAAO;GApBL,MAAM,KAAK;GACX,OAAO,KAAK,SAAS,KAAK;GAC1B,aAAa,KAAK,eAAe,KAAK;GACtC,GAAI,aAAa,gBAAgB,EAAE,eAAe,YAAY,eAAe,GAAG,EAAE;GAClF,GAAI,aAAa,mBAAmB,EAAE,kBAAkB,YAAY,kBAAkB,GAAG,EAAE;GAC3F,YAAY,KAAK;GACjB,MAAM,QACJ,YACA,QACA,QACA,UACA;AACA,WAAQ,KAAiD,QACvD,YACA,QACA,QACA,SACD;;GAGK;GACV"}
+{"version":3,"file":"xopc-tools-bridge.js","names":[],"sources":["../../../../src/agent/embedded/xopc-tools-bridge.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nconst APPLY_PATCH_BEGIN_MARKER = '*** Begin Patch';\nconst APPLY_PATCH_END_MARKER = '*** End Patch';\n\nexport type ApplyPatchEnvelopeError = {\n  code: 'invalid_patch_envelope';\n  field: 'patch';\n  issue: 'missing_patch' | 'first_line' | 'control_line' | 'last_line';\n  expected: string;\n  received?: string;\n  retryHint: string;\n};\n\nconst TOOL_PROMPT_HINTS: Record<string, { promptSnippet?: string; promptGuidelines?: string[] }> = {\n  read_file: {\n    promptSnippet: 'Read targeted file contents',\n    promptGuidelines: ['Use read_file to inspect source files before editing.'],\n  },\n  write_file: {\n    promptSnippet: 'Create new files or intentional complete rewrites',\n    promptGuidelines: ['Prefer apply_patch for code changes. Use write_file only for non-code artifacts or deliberate full-file rewrites.'],\n  },\n  apply_patch: {\n    promptSnippet: 'Apply patches using the exact apply_patch envelope',\n    promptGuidelines: [\n      'Use apply_patch for source edits. Keep patches small and verify with exec_command.',\n      'The patch must start exactly with `*** Begin Patch` and end exactly with `*** End Patch`.',\n      'Patch control lines must not end in ` ***`; do not wrap the patch in a Markdown code fence or add prose.',\n      'Use this shape: `*** Begin Patch\\\\n*** Update File: path\\\\n@@\\\\n-old\\\\n+new\\\\n*** End Patch`.',\n      'If apply_patch rejects the envelope, regenerate the complete patch from this exact shape instead of repeating it.',\n    ],\n  },\n  exec_command: {\n    promptSnippet: 'Run tests, type checks, builds, package scripts, and safe inspection commands',\n    promptGuidelines: ['Use exec_command for verification and safe inspection, not routine file editing.'],\n  },\n  update_plan: {\n    promptSnippet: 'Update the visible multi-step coding plan',\n    promptGuidelines: ['Use update_plan for multi-step coding work and keep the active step current.'],\n  },\n  grep: {\n    promptSnippet: 'Search file contents for literals, errors, config values, and docs',\n  },\n  find: {\n    promptSnippet: 'Find files by glob pattern',\n  },\n};\n\nexport function validateApplyPatchEnvelope(params: unknown): ApplyPatchEnvelopeError | null {\n  if (!params || typeof params !== 'object' || Array.isArray(params)) {\n    return {\n      code: 'invalid_patch_envelope',\n      field: 'patch',\n      issue: 'missing_patch',\n      expected: APPLY_PATCH_BEGIN_MARKER,\n      retryHint: 'Pass a patch string beginning with the exact marker `*** Begin Patch`.',\n    };\n  }\n\n  const patch = (params as { patch?: unknown }).patch;\n  if (typeof patch !== 'string') {\n    return {\n      code: 'invalid_patch_envelope',\n      field: 'patch',\n      issue: 'missing_patch',\n      expected: APPLY_PATCH_BEGIN_MARKER,\n      retryHint: 'Pass a patch string beginning with the exact marker `*** Begin Patch`.',\n    };\n  }\n\n  const lines = patch.split(/\\r?\\n/);\n  const firstLine = lines[0] ?? '';\n  if (firstLine !== APPLY_PATCH_BEGIN_MARKER) {\n    return {\n      code: 'invalid_patch_envelope',\n      field: 'patch',\n      issue: 'first_line',\n      expected: APPLY_PATCH_BEGIN_MARKER,\n      received: firstLine,\n      retryHint: 'Use `*** Begin Patch` exactly. Do not add trailing ` ***`, prose, or a Markdown code fence.',\n    };\n  }\n\n  const malformedControlLine = lines.slice(1, -1).find((line) => line.startsWith('*** ') && line.endsWith(' ***'));\n  if (malformedControlLine) {\n    return {\n      code: 'invalid_patch_envelope',\n      field: 'patch',\n      issue: 'control_line',\n      expected: malformedControlLine.slice(0, -4),\n      received: malformedControlLine,\n      retryHint: 'Patch control lines must not end in ` ***`. Remove the trailing stars from this control line.',\n    };\n  }\n\n  const lastLine = lines.at(-1) ?? '';\n  if (lastLine !== APPLY_PATCH_END_MARKER) {\n    return {\n      code: 'invalid_patch_envelope',\n      field: 'patch',\n      issue: 'last_line',\n      expected: APPLY_PATCH_END_MARKER,\n      received: lastLine,\n      retryHint: 'End the patch with `*** End Patch` exactly. Do not add trailing ` ***` or prose.',\n    };\n  }\n\n  return null;\n}\n\nfunction invalidApplyPatchEnvelopeResult(error: ApplyPatchEnvelopeError) {\n  const received = error.received === undefined ? '' : ` Received: ${JSON.stringify(error.received)}.`;\n  return {\n    content: [{\n      type: 'text' as const,\n      text: `apply_patch input rejected (${error.issue}). Expected: ${error.expected}.${received} ${error.retryHint} Use this exact envelope:\\n${APPLY_PATCH_BEGIN_MARKER}\\n*** Update File: path\\n@@\\n-old\\n+new\\n${APPLY_PATCH_END_MARKER}`,\n    }],\n    details: error,\n  };\n}\n\n/** Map xopc {@link AgentTool} instances to pi-coding-agent {@link ToolDefinition}s for `createAgentSession`. */\nexport function xopcToolsToDefinitions(tools: AgentTool[]): ToolDefinition[] {\n  return tools.map((tool) => {\n    const promptHints = TOOL_PROMPT_HINTS[tool.name];\n    const def = {\n      name: tool.name,\n      label: tool.label ?? tool.name,\n      description: tool.description ?? tool.name,\n      ...(promptHints?.promptSnippet ? { promptSnippet: promptHints.promptSnippet } : {}),\n      ...(promptHints?.promptGuidelines ? { promptGuidelines: promptHints.promptGuidelines } : {}),\n      parameters: tool.parameters,\n      async execute(\n        toolCallId: string,\n        params: unknown,\n        signal: AbortSignal | undefined,\n        onUpdate: unknown,\n      ) {\n        if (tool.name === 'apply_patch') {\n          const envelopeError = validateApplyPatchEnvelope(params);\n          if (envelopeError) {\n            return invalidApplyPatchEnvelopeResult(envelopeError) as never;\n          }\n        }\n\n        return (tool as { execute: (...a: never[]) => unknown }).execute(\n          toolCallId as never,\n          params as never,\n          signal as never,\n          onUpdate as never,\n        ) as never;\n      },\n    };\n    return def as unknown as ToolDefinition;\n  });\n}\n"],"mappings":";AAGA,MAAM,2BAA2B;AACjC,MAAM,yBAAyB;AAW/B,MAAM,oBAA6F;CACjG,WAAW;EACT,eAAe;EACf,kBAAkB,CAAC,wDAAwD;EAC5E;CACD,YAAY;EACV,eAAe;EACf,kBAAkB,CAAC,oHAAoH;EACxI;CACD,aAAa;EACX,eAAe;EACf,kBAAkB;GAChB;GACA;GACA;GACA;GACA;GACD;EACF;CACD,cAAc;EACZ,eAAe;EACf,kBAAkB,CAAC,mFAAmF;EACvG;CACD,aAAa;EACX,eAAe;EACf,kBAAkB,CAAC,+EAA+E;EACnG;CACD,MAAM,EACJ,eAAe,sEAChB;CACD,MAAM,EACJ,eAAe,8BAChB;CACF;AAED,SAAgB,2BAA2B,QAAiD;AAC1F,KAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,CAChE,QAAO;EACL,MAAM;EACN,OAAO;EACP,OAAO;EACP,UAAU;EACV,WAAW;EACZ;CAGH,MAAM,QAAS,OAA+B;AAC9C,KAAI,OAAO,UAAU,SACnB,QAAO;EACL,MAAM;EACN,OAAO;EACP,OAAO;EACP,UAAU;EACV,WAAW;EACZ;CAGH,MAAM,QAAQ,MAAM,MAAM,QAAQ;CAClC,MAAM,YAAY,MAAM,MAAM;AAC9B,KAAI,cAAc,yBAChB,QAAO;EACL,MAAM;EACN,OAAO;EACP,OAAO;EACP,UAAU;EACV,UAAU;EACV,WAAW;EACZ;CAGH,MAAM,uBAAuB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,SAAS,KAAK,WAAW,OAAO,IAAI,KAAK,SAAS,OAAO,CAAC;AAChH,KAAI,qBACF,QAAO;EACL,MAAM;EACN,OAAO;EACP,OAAO;EACP,UAAU,qBAAqB,MAAM,GAAG,GAAG;EAC3C,UAAU;EACV,WAAW;EACZ;CAGH,MAAM,WAAW,MAAM,GAAG,GAAG,IAAI;AACjC,KAAI,aAAa,uBACf,QAAO;EACL,MAAM;EACN,OAAO;EACP,OAAO;EACP,UAAU;EACV,UAAU;EACV,WAAW;EACZ;AAGH,QAAO;;AAGT,SAAS,gCAAgC,OAAgC;CACvE,MAAM,WAAW,MAAM,aAAa,KAAA,IAAY,KAAK,cAAc,KAAK,UAAU,MAAM,SAAS,CAAC;AAClG,QAAO;EACL,SAAS,CAAC;GACR,MAAM;GACN,MAAM,+BAA+B,MAAM,MAAM,eAAe,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,UAAU,6BAA6B,yBAAyB,2CAA2C;GAChN,CAAC;EACF,SAAS;EACV;;;AAIH,SAAgB,uBAAuB,OAAsC;AAC3E,QAAO,MAAM,KAAK,SAAS;EACzB,MAAM,cAAc,kBAAkB,KAAK;AA6B3C,SAAO;GA3BL,MAAM,KAAK;GACX,OAAO,KAAK,SAAS,KAAK;GAC1B,aAAa,KAAK,eAAe,KAAK;GACtC,GAAI,aAAa,gBAAgB,EAAE,eAAe,YAAY,eAAe,GAAG,EAAE;GAClF,GAAI,aAAa,mBAAmB,EAAE,kBAAkB,YAAY,kBAAkB,GAAG,EAAE;GAC3F,YAAY,KAAK;GACjB,MAAM,QACJ,YACA,QACA,QACA,UACA;AACA,QAAI,KAAK,SAAS,eAAe;KAC/B,MAAM,gBAAgB,2BAA2B,OAAO;AACxD,SAAI,cACF,QAAO,gCAAgC,cAAc;;AAIzD,WAAQ,KAAiD,QACvD,YACA,QACA,QACA,SACD;;GAGK;GACV"}

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

@@ -1,7 +1,7 @@
-import { createLogger } from "../../utils/logger/index.js";
-import { init_logger } from "../../utils/logger.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
 import { GoalService } from "../../goals/goal-service.js";
 import { resolveGoalUiLocale } from "./goal-locale.js";
 import { evaluateAfterTurnHermesLike } from "./evaluate-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/ipc/bus.js

@@ -1,6 +1,6 @@
+import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { createResponseMessage, createSignalMessage, createTaskMessage } from "./types.js";
 import { AgentInbox } from "./inbox.js";
 //#region src/agent/ipc/bus.ts

package/dist/src/agent/mcp/bundle-mcp-materialize.js

@@ -1,6 +1,6 @@
+import { init_string_coerce, normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_string_coerce, normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { buildSafeToolName, normalizeReservedToolNames } from "./bundle-mcp-names.js";
 import { setPluginToolMeta } from "./mcp-tool-meta.js";
 import crypto from "node:crypto";

package/dist/src/agent/mcp/bundle-mcp-runtime.js

@@ -1,7 +1,7 @@
+import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { resolveGlobalSingleton } from "../../utils/global-singleton.js";
-import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { sanitizeServerName } from "./bundle-mcp-names.js";
 import { redactSensitiveUrlLikeString } from "../../utils/redact-sensitive-url.js";
 import { loadEmbeddedMcpConfig } from "./embedded-mcp.js";

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

@@ -1,6 +1,6 @@
+import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../../utils/string-coerce.js";
 import { resolveXopcMcpTransportAlias } from "../../config/mcp-config-normalize.js";
 import { sanitizeForLog } from "../../utils/sanitize-log.js";
 import { describeHttpMcpServerLaunchConfig, resolveHttpMcpServerLaunchConfig } from "./mcp-http.js";

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

@@ -1,6 +1,6 @@
+import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { XopcStdioClientTransport } from "./mcp-stdio-transport.js";
 import { resolveMcpTransportConfig } from "./mcp-transport-config.js";
 import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.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":";;;;;;;;;;aAKwD;AAaxD,MAAM,oBAAoB;AAC1B,MAAM,cAAc;AACpB,MAAM,iBAAiB;CACrB;CACA;CACA;CACA;CACA;CACA;CACD;AACD,MAAM,MAAM,aAAa,qBAAqB;AAE9C,SAAS,WAAW,QAAyD;AAC3E,KAAI,OAAO,SAAS,WAAY,QAAO;AACvC,KACE,OAAO,SAAS,gBAChB,OAAO,SAAS,kBAChB,OAAO,SAAS,kBAChB,OAAO,SAAS,aAChB,OAAO,SAAS,wBAChB,OAAO,SAAS,kBAChB,QAAO;AACT,QAAO;;AAGT,SAAS,aAAa,QAAsB,KAAqD;AAC/F,KAAI,OAAO,aAAa,KAAK,MAAM,OAAO,UAAU,GAAG,IAAK,QAAO;AACnE,KACG,OAAO,WAAW,KAAK,MAAM,OAAO,QAAQ,GAAG,OAC/C,OAAO,aAAa,KAAK,MAAM,OAAO,UAAU,GAAG,IACpD,QAAO;AACT,KAAI,OAAO,gBAAgB,YAAY,OAAO,gBAAgB,YAAa,QAAO;AAClF,KAAI,OAAO,qBAAqB,uBAAwB,QAAO;AAC/D,KAAI,OAAO,WAAW,kBAAkB,OAAO,WAAW,WAAW,uBAAuB,QAAQ,IAAI,CAAC,UAAW,QAAO;;AAI7H,SAAS,YAAY,QAA4B,KAAqB;CACpE,MAAM,aAAa,OAAO,OAAO,cAAc;CAC/C,MAAM,eAAe,OAAO,OAAO,iBAAiB,aAChD,IACA,OAAO,OAAO,iBAAiB,aAAa,MAAO;CACvD,MAAM,YAAY,uBAAuB,OAAO,QAAQ,IAAI,CAAC;AAC7D,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAC1B,OAAO,QAAQ,MAAO,aAAa,KAAM,OAAO,OAAO,aAAa,KAAM,eAAe,KAAM,YAAY,IAC5G,CAAC;;AAGJ,SAAS,YAAY,QAA4B,kBAAkC;CACjF,MAAM,OAAO,OAAO,SAAS,QAAQ,GAAG,OAAO,SAAS,WAAW,GAAG,OAAO,SAAS;CACtF,MAAM,cAAc,OAAO,OAAO,MAAM,YAAY,mBAChD,qBAAqB,OAAO,OAAO,MAAM,QAAQ,KACjD;AACJ,KAAI,OAAO,SAAS,aAAa,KAAM,QAAO,GAAG,cAAc;CAC/D,MAAM,MAAM,OAAO,SAAS,WAAW,OAAO,SAAS,YAAY,OAAO,SAAS,YAC/E,KAAK,OAAO,SAAS,YACrB;AACJ,QAAO,GAAG,cAAc,KAAK,IAAI,OAAO,SAAS,YAAY;;AAG/D,SAAS,cAAc,MAAsC;AAC3D,KAAI,KAAK,WAAW,eAAgB,QAAO;AAC3C,KAAI,KAAK,WAAW,WAAY,QAAO;AACvC,KAAI,KAAK,WAAW,mBAAoB,QAAO;AAC/C,QAAO;;AAGT,SAAS,eAAe,SAAuB,OAA6B;AAC1E,KAAI,CAAC,MAAO,QAAO;CACnB,MAAM,SAAS,GAAG,MAAM;CACxB,MAAM,UAAU,wBAAwB,QAAQ;AAChD,KAAI,OAAO,YAAY,SAAU,QAAO;EAAE,GAAG;EAAS,SAAS,SAAS;EAAS;AACjF,KAAI,MAAM,QAAQ,QAAQ,IAAI,QAAQ,SAAS,GAAG;EAChD,MAAM,QAAQ,QAAQ;AACtB,MAAI,MAAM,SAAS,UAAU,OAAO,MAAM,SAAS,UAAU;GAC3D,MAAM,OAAO,CAAC,GAAG,QAAQ;AACzB,QAAK,KAAK;IAAE,MAAM;IAAQ,MAAM,SAAS,MAAM;IAAM;AACrD,UAAO;IAAE,GAAG;IAAS,SAAS;IAAM;;AAEtC,SAAO;GAAE,GAAG;GAAS,SAAS,CAAC;IAAE,MAAM;IAAiB,MAAM;IAAQ,EAAE,GAAG,QAAQ;GAAE;;AAEvF,QAAO;;AAGT,IAAa,qBAAb,MAAgC;CAC9B,MAAM,KAAK,QAOkB;EAC3B,MAAM,UAAU,YAAY;EAC5B,MAAM,QAAQ,OAAO,MAAM,MAAM;AACjC,MAAI,CAAC,MACH,QAAO;GAAE;GAAS,cAAc,OAAO;GAAa,OAAO,EAAE;GAAE,UAAU,EAAE;GAAE,iBAAiB;GAAG;EAEnG,MAAM,UAAU,KAAK,KAAK;EAC1B,MAAM,QAAQ;GAAE,SAAS,OAAO;GAAS,YAAY,OAAO;GAAY;EACxE,MAAM,CAAC,aAAa,iBAAiB,MAAM,QAAQ,IAAI,CACrD,OAAO,cAAc,OAAO;GAC1B;GACA;GACA,YAAY;GACZ,UAAU;GACX,CAAC,CAAC,YAAY,EAAE,CAAC,EAClB,QAAQ,IAAI,eAAe,KAAK,SAC9B,OAAO,cAAc,KAAK;GAAE;GAAM,QAAQ;GAAU;GAAO,CAAC,CAAC,YAAY,EAAE,CAAC,CAC5E,CAAC,CACJ,CAAC;EACF,MAAM,UAAU,IAAI,IAAI,YAAY,KAAK,WAAW,OAAO,OAAO,GAAG,CAAC;EACtE,MAAM,kBAAwC,cAC3C,MAAM,CACN,QAAQ,WAAW,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,CAC3C,QAAQ,WAAW,OAAO,SAAS,cAAc,OAAO,iBAAiB,cAAc,OAAO,cAAc,GAAI,CAChH,KAAK,YAAY;GAChB;GACA,OAAO,OAAO,SAAS,aAAa,KAAM;GAC1C,SAAS,OAAO;GAChB,UAAU;IACR,YAAY,OAAO,OAAO,YAAY;IACtC,UAAU,OAAO;IACjB,MAAM,OAAO,OAAO;IACpB,WAAW,OAAO,OAAO;IACzB,SAAS,OAAO,OAAO;IACvB,WAAW,OAAO;IACnB;GACF,EAAE;EACL,MAAM,UAAU,CAAC,GAAG,aAAa,GAAG,gBAAgB;EACpD,MAAM,MAAM,KAAK,KAAK;EACtB,MAAM,WAAW,IAAI,IAAI,OAAO,qBAAqB,EAAE,CAAC;EACxD,MAAM,WAAwC,EAAE;EAChD,MAAM,SAAS,QACZ,QAAQ,WAAW,CAAC,SAAS,IAAI,OAAO,OAAO,GAAG,CAAC,CACnD,KAAK,YAAY;GAAE;GAAQ,OAAO,YAAY,QAAQ,IAAI;GAAE,EAAE,CAC9D,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,CACjC,QAAQ,OAAO,OAAO,QAAQ,IAAI,WAAW,cAAc,UAAU,OAAO,OAAO,OAAO,MAAM,OAAO,OAAO,GAAG,KAAK,MAAM,CAC5H,MAAM,GAAG,YAAY;EACxB,MAAM,QAAkC,EAAE;EAC1C,IAAI,YAAY;AAChB,OAAK,MAAM,EAAE,QAAQ,WAAW,QAAQ;GACtC,MAAM,SAAS,aAAa,OAAO,QAAQ,IAAI,KAAK,QAAQ,MAAO,cAAc,KAAA;AACjF,OAAI,QAAQ;AACV,aAAS,KAAK;KAAE,UAAU,OAAO,OAAO;KAAI;KAAQ,CAAC;AACrD;;GAEF,MAAM,UAAU,OAAO,QAAQ,MAAM;AACrC,OAAI,YAAY,QAAQ,SAAS,mBAAmB;AAClD,aAAS,KAAK;KAAE,UAAU,OAAO,OAAO;KAAI,QAAQ;KAAU,CAAC;AAC/D;;AAEF,gBAAa,QAAQ;AACrB,SAAM,KAAK;IACT,UAAU,OAAO,OAAO;IACxB;IACA;IACA,SAAS,WAAW,OAAO,OAAO;IAClC,UAAU,YAAY,QAAQ,OAAO,QAAQ;IAC7C,QAAQ,4BAA4B,OAAO,OAAO;IAClD,WAAW,uBAAuB,OAAO,QAAQ,IAAI,CAAC;IACvD,CAAC;;EAEJ,MAAM,WAAqB,EAAE;AAC7B,OAAK,MAAM,CAAC,SAAS,UAAU;GAAC,CAAC,UAAU,aAAa;GAAE,CAAC,QAAQ,iBAAiB;GAAE,CAAC,eAAe,0BAA0B;GAAC,EAAW;GAC1I,MAAM,eAAe,MAAM,QAAQ,SAAS,KAAK,YAAY,QAAQ;AACrE,OAAI,aAAa,SAAS,EACxB,UAAS,KAAK,GAAG,MAAM,KAAK,aAAa,KAAK,SAAS,KAAK,KAAK,QAAQ,gBAAgB,cAAc,KAAK,GAAG,CAAC,KAAK,KAAK,GAAG;;EAGjI,MAAM,QAAQ,sBAAsB,SAAS,KAAK,OAAO,CAAC;AAC1D,MAAI;AACF,0BAAuB;IACrB;IACA,OAAO;IACP,YAAY;IACZ,YAAY,OAAO;IACnB,SAAS;KACP;KACA;KACA,cAAc,MAAM,KAAK,UAAU;MACjC,UAAU,KAAK;MACf,SAAS,KAAK;MACd,QAAQ,KAAK;MACb,WAAW,KAAK;MAChB,UAAU,KAAK;MAChB,EAAE;KACJ;IACD,aAAa,MAAM;IACnB,mBAAmB,MAAM,KAAK,SAAS,KAAK,SAAS;IACrD,YAAY,KAAK,KAAK,GAAG;IAC1B,CAAC;WACK,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK;IAAS,YAAY,OAAO;IAAY,EAAE,uCAAuC;;AAEpG,SAAO;GACL;GACA,cAAc,eAAe,OAAO,aAAa,MAAM;GACvD;GACA;GACA,iBAAiB,KAAK,KAAK,MAAM,SAAS,EAAE;GAC7C"}

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