@xopcai/xopc 0.0.218 → 0.0.219

package/dist/packages/gateway-contract/src/user-message-display.js

@@ -0,0 +1,55 @@
+//#region packages/gateway-contract/src/user-message-display.ts
+const ENVELOPE_TIMESTAMP_PREFIX_RE = /^\[\d{4}-\d{2}-\d{2} \d{2}:\d{2}[^\]]*\]\s*/u;
+const USER_CONTEXT_TAGS = [
+	"user-profile",
+	"active-focuses",
+	"collaboration-contract",
+	"user-context"
+];
+function stripLeadingTaggedBlock(text, tag) {
+	const opening = `<${tag}>`;
+	if (!text.startsWith(opening)) return null;
+	const closing = `</${tag}>`;
+	const closingIndex = text.indexOf(closing, opening.length);
+	if (closingIndex < 0) return null;
+	return text.slice(closingIndex + closing.length).trimStart();
+}
+function beginsWithGeneratedTurnPayload(text) {
+	return ENVELOPE_TIMESTAMP_PREFIX_RE.test(text) || text.startsWith("<source_contexts>") || USER_CONTEXT_TAGS.some((tag) => text.startsWith(`<${tag}>`));
+}
+/** Remove frozen source snapshots while preserving the wrapped user-authored message. */
+function stripSourceContextsEnvelope(text) {
+	if (!text.includes("<source_contexts>")) return text;
+	const withoutContexts = text.replace(/^\s*<source_contexts>[\s\S]*?<\/source_contexts>\s*/u, "").trimStart();
+	return withoutContexts.match(/^<user_message>\r?\n([\s\S]*)\r?\n<\/user_message>\s*$/u)?.[1] ?? withoutContexts;
+}
+/**
+* Restore a model-facing user message to its client-facing text.
+* Generated profile/memory blocks require the runtime timestamp anchor, which
+* keeps equivalent user-authored XML visible.
+*/
+function stripRuntimeUserMessageEnvelope(text) {
+	let remaining = text;
+	const taskStripped = stripLeadingTaggedBlock(remaining.trimStart(), "xopc_task_execution");
+	if (taskStripped !== null && beginsWithGeneratedTurnPayload(taskStripped)) remaining = taskStripped;
+	remaining = stripSourceContextsEnvelope(remaining);
+	const beforeUserContext = remaining;
+	let removedUserContext = false;
+	remaining = remaining.trimStart();
+	while (true) {
+		const tag = USER_CONTEXT_TAGS.find((candidate) => remaining.startsWith(`<${candidate}>`));
+		if (!tag) break;
+		const next = stripLeadingTaggedBlock(remaining, tag);
+		if (next === null) {
+			remaining = beforeUserContext;
+			removedUserContext = false;
+			break;
+		}
+		remaining = next;
+		removedUserContext = true;
+	}
+	if (removedUserContext && !ENVELOPE_TIMESTAMP_PREFIX_RE.test(remaining)) remaining = beforeUserContext;
+	return remaining.replace(ENVELOPE_TIMESTAMP_PREFIX_RE, "");
+}
+//#endregion
+export { stripRuntimeUserMessageEnvelope };

package/dist/src/agent/agent-manager.js

@@ -6,15 +6,15 @@ import { getSessionConfig } from "../storage/sqlite/config-repository.js";
 import "../storage/sqlite/index.js";
 import { checkBoundary } from "../agent-runtime/boundary-guard.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
 import { init_agent_scope, resolveAgentProfileDir } from "./agent-scope.js";
+import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
-import { CredentialResolver, init_credentials } from "../auth/credentials.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
+import { CredentialResolver, init_credentials } from "../auth/credentials.js";
 import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
-import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { extractTextContent } from "./context/workspace.js";
 import { buildExecutionScopeContextForPrompt } from "./context/execution-scope.js";
 import { clearBootstrapSnapshot } from "./bootstrap/bootstrap-cache.js";
@@ -149,7 +149,8 @@ var AgentManager = class {
 		});
 	}
 	isUserContextEnabledForSession(sessionKey) {
-		return Boolean(this.config.config?.userContext.enabled && this.config.config.userContext.understanding.enabled && getSessionConfig(sessionKey)?.userContextMode !== "off");
+		const mode = getSessionConfig(sessionKey)?.userContextMode;
+		return Boolean(this.config.config?.userContext.enabled && this.config.config.userContext.understanding.enabled && (mode === void 0 || mode === "enabled"));
 	}
 	computeBaseWorkspacePath() {
 		const cfg = this.config.config;

package/dist/src/agent/background-review/prompts.d.ts

@@ -1,2 +1,2 @@
-export declare const MEMORY_REVIEW_USER_PROMPT = "Review the conversation above and identify durable user-understanding candidates.\n\nFocus on:\n1. Has the user revealed things about themselves \u2014 persona, desires, preferences, or personal details worth remembering?\n2. Has the user expressed expectations about how you should behave, their work style, emotional-support preferences, boundaries, or how they want you to communicate?\n3. Has the user explicitly corrected a prior assumption? Prefer the correction and do not preserve the contradicted interpretation.\n\nReturn JSON only, with this shape:\n{\"candidates\":[{\"kind\":\"preference\",\"content\":\"...\",\"confidence\":0.8,\"importance\":0.7,\"durability\":\"durable\",\"sensitivity\":\"normal\",\"disclosurePolicy\":\"referenceable\",\"tags\":[\"background-review\"]}]}\n\nAllowed kinds: preference, boundary, relationship, routine, current_state, long_term_goal, project_context, task_lesson, derived_insight.\nOnly include facts supported by the conversation and likely to matter in a future session. A temporary mood or one-off reaction is current context, not durable identity; omit it unless the user describes a recurring pattern that will matter later. Never include passwords, tokens, credentials, or speculative diagnoses. Use {\"candidates\":[]} when nothing qualifies.\n\nWrite each understanding as concise, neutral profile copy that can be shown directly to the person described, not as an internal note about \"the user\". Prefer a subject-omitted predicate or noun phrase. For example, write \u201C\u503E\u5411\u4F7F\u7528 pnpm \u4F5C\u4E3A\u5305\u7BA1\u7406\u5668\u201D or \u201Cxopc \u9879\u76EE\u7684\u6838\u5FC3\u5F00\u53D1\u8005\u201D, not \u201C\u7528\u6237\u503E\u5411\u4E8E\u4F7F\u7528 pnpm\u201D or \u201C\u7528\u6237\u662F xopc \u9879\u76EE\u7684\u5F00\u53D1\u8005\u201D; write \u201CPrefers pnpm as the package manager\u201D or \u201CCore maintainer of xopc\u201D, not \u201CThe user prefers pnpm\u201D or \u201CThe user is a maintainer of xopc\u201D. Do not begin with generic subject labels or pronouns such as \u201C\u7528\u6237\u201D, \u201C\u8BE5\u7528\u6237\u201D, \u201C\u6B64\u7528\u6237\u201D, \u201C\u4F60\u201D, \u201C\u6211\u201D, \u201Cthe user\u201D, \u201Cuser\u201D, \u201Cyou\u201D, or \u201CI\u201D.\n\nDo not turn a request about the current task into user understanding. Exclude requested outputs, follow-up instructions, project-note edits, investigations, and other one-off work. Every candidate must be a complete standalone profile statement or enduring pattern; never return a clause fragment beginning with a connector such as \"and\", \"also\", \"\u5E76\u4E14\", \"\u4EE5\u53CA\", or \"\u7684\u4E8B\u9879\". Use long_term_goal only when the person states an enduring personal goal, not when they ask the assistant to create, update, investigate, summarize, or track something.";
+export declare const MEMORY_REVIEW_USER_PROMPT = "Review the conversation above and identify durable user-understanding candidates.\n\nFocus on:\n1. Has the user revealed things about themselves \u2014 persona, desires, preferences, or personal details worth remembering?\n2. Has the user expressed expectations about how you should behave, their work style, emotional-support preferences, boundaries, or how they want you to communicate?\n3. Has the user explicitly corrected a prior assumption? Prefer the correction and do not preserve the contradicted interpretation.\n\nReturn JSON only, with this shape:\n{\"candidates\":[{\"kind\":\"preference\",\"content\":\"...\",\"confidence\":0.8,\"importance\":0.7,\"durability\":\"durable\",\"sensitivity\":\"normal\",\"disclosurePolicy\":\"referenceable\",\"evidenceRefs\":[\"entry-id\"]}]}\n\nAllowed kinds: preference, boundary, relationship, routine, current_state, long_term_goal, project_context, task_lesson, derived_insight.\nEvery reviewed message is prefixed with an evidence_ref. Every candidate must list the exact one or more evidence_ref values that support it. Omit a candidate when no exact message supports it. Only include facts supported by the conversation and likely to matter in a future session. A temporary mood or one-off reaction is current context, not durable identity; omit it unless the user describes a recurring pattern that will matter later. Never include passwords, tokens, credentials, or speculative diagnoses. Use {\"candidates\":[]} when nothing qualifies.\n\nWrite each understanding as concise, neutral profile copy that can be shown directly to the person described, not as an internal note about \"the user\". Prefer a subject-omitted predicate or noun phrase. For example, write \u201C\u503E\u5411\u4F7F\u7528 pnpm \u4F5C\u4E3A\u5305\u7BA1\u7406\u5668\u201D or \u201Cxopc \u9879\u76EE\u7684\u6838\u5FC3\u5F00\u53D1\u8005\u201D, not \u201C\u7528\u6237\u503E\u5411\u4E8E\u4F7F\u7528 pnpm\u201D or \u201C\u7528\u6237\u662F xopc \u9879\u76EE\u7684\u5F00\u53D1\u8005\u201D; write \u201CPrefers pnpm as the package manager\u201D or \u201CCore maintainer of xopc\u201D, not \u201CThe user prefers pnpm\u201D or \u201CThe user is a maintainer of xopc\u201D. Do not begin with generic subject labels or pronouns such as \u201C\u7528\u6237\u201D, \u201C\u8BE5\u7528\u6237\u201D, \u201C\u6B64\u7528\u6237\u201D, \u201C\u4F60\u201D, \u201C\u6211\u201D, \u201Cthe user\u201D, \u201Cuser\u201D, \u201Cyou\u201D, or \u201CI\u201D.\n\nDo not turn a request about the current task into user understanding. Exclude requested outputs, follow-up instructions, project-note edits, investigations, and other one-off work. Every candidate must be a complete standalone profile statement or enduring pattern; never return a clause fragment beginning with a connector such as \"and\", \"also\", \"\u5E76\u4E14\", \"\u4EE5\u53CA\", or \"\u7684\u4E8B\u9879\". Use long_term_goal only when the person states an enduring personal goal, not when they ask the assistant to create, update, investigate, summarize, or track something.";
 export declare const UNDERSTANDING_REVIEW_SYSTEM_PROMPT = "You are the user-understanding synthesis stage for the same session. You do not chat with the user and cannot write storage directly. Extract only evidence-backed, durable candidates and return strict JSON matching the requested schema.";

package/dist/src/agent/background-review/prompts.js

@@ -8,10 +8,10 @@ Focus on:
 3. Has the user explicitly corrected a prior assumption? Prefer the correction and do not preserve the contradicted interpretation.
 
 Return JSON only, with this shape:
-{"candidates":[{"kind":"preference","content":"...","confidence":0.8,"importance":0.7,"durability":"durable","sensitivity":"normal","disclosurePolicy":"referenceable","tags":["background-review"]}]}
+{"candidates":[{"kind":"preference","content":"...","confidence":0.8,"importance":0.7,"durability":"durable","sensitivity":"normal","disclosurePolicy":"referenceable","evidenceRefs":["entry-id"]}]}
 
 Allowed kinds: preference, boundary, relationship, routine, current_state, long_term_goal, project_context, task_lesson, derived_insight.
-Only include facts supported by the conversation and likely to matter in a future session. A temporary mood or one-off reaction is current context, not durable identity; omit it unless the user describes a recurring pattern that will matter later. Never include passwords, tokens, credentials, or speculative diagnoses. Use {"candidates":[]} when nothing qualifies.
+Every reviewed message is prefixed with an evidence_ref. Every candidate must list the exact one or more evidence_ref values that support it. Omit a candidate when no exact message supports it. Only include facts supported by the conversation and likely to matter in a future session. A temporary mood or one-off reaction is current context, not durable identity; omit it unless the user describes a recurring pattern that will matter later. Never include passwords, tokens, credentials, or speculative diagnoses. Use {"candidates":[]} when nothing qualifies.
 
 ${USER_FACING_UNDERSTANDING_WRITING_GUIDANCE}
 

package/dist/src/agent/background-review/run-background-review.js

@@ -1,13 +1,18 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { UNDERSTANDING_KINDS } from "../../user-context/domain.js";
+import { finishContextExtractionRun } from "../../storage/sqlite/context-extraction-repository.js";
+import { createContextEvidence } from "../../storage/sqlite/user-context-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
+import { loadCompactionSourceSnapshot } from "../../storage/sqlite/transcript-repository.js";
 import "../../storage/sqlite/index.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { getApiKeySync, init_providers } from "../../providers/index.js";
 import { createExtensionAwareStreamFn } from "../../providers/extension-stream-bridge.js";
 import { extractTextContent } from "../context/workspace.js";
+import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";
+import { claimRegisteredExtraction, extractionInputHash } from "../../user-context/extraction/registry.js";
 import { isDurableUnderstandingCandidate } from "../../user-context/understandingQuality.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed } from "../orchestration/llm-turn-retry.js";
 import { MEMORY_REVIEW_USER_PROMPT, UNDERSTANDING_REVIEW_SYSTEM_PROMPT } from "./prompts.js";
@@ -17,9 +22,45 @@ init_sync_provider_auth();
 init_providers();
 init_logger();
 const log = createLogger("BackgroundReview");
-function cloneMessageTail(messages, max) {
-	const tail = messages.length <= max ? messages : messages.slice(-max);
-	return JSON.parse(JSON.stringify(tail));
+function isReviewMessage(value) {
+	if (!value || typeof value !== "object") return false;
+	const role = value.role;
+	return role === "user" || role === "assistant";
+}
+function tagMessage(message, entryId) {
+	const copy = JSON.parse(JSON.stringify(message));
+	const tag = `[evidence_ref:${entryId}]\n`;
+	const messageContent = readAgentMessageContent(copy);
+	if (typeof messageContent === "string") return {
+		...copy,
+		content: `${tag}${messageContent}`
+	};
+	if (Array.isArray(messageContent)) {
+		const content = [...messageContent];
+		const first = content[0];
+		if (first?.type === "text") content[0] = {
+			...first,
+			text: `${tag}${first.text ?? ""}`
+		};
+		else content.unshift({
+			type: "text",
+			text: tag
+		});
+		return {
+			...copy,
+			content
+		};
+	}
+	return copy;
+}
+function loadEvidenceMessages(sessionKey, max) {
+	const snapshot = loadCompactionSourceSnapshot(sessionKey);
+	if (!snapshot) return [];
+	return snapshot.entries.filter((entry) => isReviewMessage(entry.row)).slice(-max).map((entry) => ({
+		entryId: entry.entryId,
+		createdAt: entry.createdAt,
+		message: entry.row
+	}));
 }
 const ALLOWED_UNDERSTANDING_KINDS = new Set(UNDERSTANDING_KINDS);
 const ALLOWED_SENSITIVITIES = new Set([
@@ -36,7 +77,7 @@ function lastAssistantText(agent) {
 	}
 	return "";
 }
-function parseUnderstandingCandidates(raw) {
+function parseBackgroundCandidates(raw) {
 	const fenced = /```(?:json)?\s*([\s\S]*?)```/i.exec(raw)?.[1];
 	const start = raw.indexOf("{");
 	const end = raw.lastIndexOf("}");
@@ -57,6 +98,7 @@ function parseUnderstandingCandidates(raw) {
 			const durability = item.durability === "ephemeral" || item.durability === "recurring" ? item.durability : "durable";
 			const sensitivity = ALLOWED_SENSITIVITIES.has(item.sensitivity) ? item.sensitivity : "personal";
 			const disclosurePolicy = item.disclosurePolicy === "silent" || item.disclosurePolicy === "ask_before_reference" ? item.disclosurePolicy : "referenceable";
+			const evidenceRefs = Array.isArray(item.evidenceRefs) ? [...new Set(item.evidenceRefs.filter((value) => typeof value === "string" && value.trim().length > 0))] : [];
 			output.push({
 				kind,
 				content: item.content.trim(),
@@ -65,7 +107,8 @@ function parseUnderstandingCandidates(raw) {
 				explicitness: "inferred",
 				durability,
 				sensitivity,
-				disclosurePolicy
+				disclosurePolicy,
+				evidenceRefs
 			});
 		}
 		return output;
@@ -73,8 +116,25 @@ function parseUnderstandingCandidates(raw) {
 		return [];
 	}
 }
+function parseUnderstandingCandidates(raw) {
+	return parseBackgroundCandidates(raw).map(({ evidenceRefs: _evidenceRefs, ...candidate }) => candidate);
+}
 async function runUnderstandingReview(params) {
 	const { sessionKey, mainAgent, settings, memoryManager, getConfig } = params;
+	const evidenceMessages = loadEvidenceMessages(sessionKey, settings.maxHistoryMessages);
+	if (!evidenceMessages.length) {
+		log.debug({ sessionKey }, "User-understanding review skipped because no persisted evidence was available");
+		return;
+	}
+	const lastEvidence = evidenceMessages[evidenceMessages.length - 1];
+	const extraction = claimRegisteredExtraction({
+		extractorId: "transcript-synthesis",
+		sourceRef: `session:${sessionKey}:window:${evidenceMessages[0].entryId}:${lastEvidence.entryId}`,
+		contentForHash: evidenceMessages.map((entry) => entry.entryId).join("\n"),
+		processingPolicy: "remote_allowed",
+		destination: "remote_model"
+	});
+	if (!extraction.shouldExecute) return;
 	const reviewAgent = new Agent({
 		initialState: {
 			systemPrompt: UNDERSTANDING_REVIEW_SYSTEM_PROMPT,
@@ -86,7 +146,7 @@ async function runUnderstandingReview(params) {
 		streamFn: createExtensionAwareStreamFn(),
 		getApiKey: (provider) => resolveProviderApiKeySync(provider) ?? getApiKeySync(provider) ?? ""
 	});
-	reviewAgent.state.messages = cloneMessageTail(mainAgent.state.messages, settings.maxHistoryMessages);
+	reviewAgent.state.messages = evidenceMessages.map((entry) => tagMessage(entry.message, entry.entryId));
 	const timeoutMs = Math.min(settings.maxDurationMs, resolveAgentTurnTimeoutMs(getConfig()));
 	try {
 		await runAgentTurnWithTimeout(reviewAgent, async () => {
@@ -104,20 +164,88 @@ async function runUnderstandingReview(params) {
 		}, "User-understanding review failed or timed out");
 		reviewAgent.abort();
 		await reviewAgent.waitForIdle().catch(() => {});
+		finishContextExtractionRun({
+			runId: extraction.run.id,
+			status: "failed",
+			errorCode: "model_failed"
+		});
 		return;
 	}
-	if (isAssistantTurnAborted(reviewAgent) || isAssistantTurnFailed(reviewAgent)) return;
-	const candidates = parseUnderstandingCandidates(lastAssistantText(reviewAgent));
-	const projectId = getSessionMetadata(sessionKey)?.projectId;
-	await memoryManager.applyUnderstandingCandidates(candidates, {
-		sessionKey,
-		...projectId ? { projectId } : {},
-		sourceText: "Background review of the current session transcript",
-		reviewSource: "background"
-	});
+	if (isAssistantTurnAborted(reviewAgent) || isAssistantTurnFailed(reviewAgent)) {
+		finishContextExtractionRun({
+			runId: extraction.run.id,
+			status: "failed",
+			errorCode: "model_failed"
+		});
+		return;
+	}
+	const candidates = parseBackgroundCandidates(lastAssistantText(reviewAgent));
+	let applied = 0;
+	try {
+		const evidenceByRef = new Map(evidenceMessages.map((entry) => [entry.entryId, entry]));
+		const projectId = getSessionMetadata(sessionKey)?.projectId;
+		const outputs = [];
+		for (const { evidenceRefs, ...candidate } of candidates) {
+			const referenced = evidenceRefs.flatMap((ref) => {
+				const entry = evidenceByRef.get(ref);
+				return entry ? [entry] : [];
+			});
+			if (!referenced.length) {
+				outputs.push({
+					candidateKey: `${candidate.kind}:${candidate.content}`,
+					outcome: "rejected"
+				});
+				continue;
+			}
+			const evidenceIds = referenced.map((entry) => createContextEvidence({
+				sourceType: "conversation",
+				sourceRef: `session:${sessionKey}:entry:${entry.entryId}`,
+				sourceRunId: extraction.run.id,
+				sessionId: sessionKey,
+				messageId: entry.entryId,
+				contentHash: extractionInputHash(JSON.stringify(entry.message)),
+				retentionPolicy: "derived_only",
+				processingPolicy: "remote_allowed",
+				extractorId: "transcript-synthesis",
+				extractorVersion: "1",
+				trustLevel: "owner",
+				observedAt: entry.createdAt
+			}).id);
+			const result = await memoryManager.applyUnderstandingCandidates([candidate], {
+				sessionKey,
+				...projectId ? { projectId } : {},
+				evidenceIds,
+				reviewSource: "background",
+				extractionRunId: extraction.run.id
+			});
+			outputs.push(...(result.writeOutputs ?? []).map((output) => ({
+				candidateKey: output.candidateKey,
+				...output.objectId ? {
+					objectType: "understanding",
+					objectId: output.objectId
+				} : {},
+				...output.versionId ? { versionId: output.versionId } : {},
+				outcome: output.outcome
+			})));
+			applied += 1;
+		}
+		finishContextExtractionRun({
+			runId: extraction.run.id,
+			status: "completed",
+			outputs
+		});
+	} catch (error) {
+		finishContextExtractionRun({
+			runId: extraction.run.id,
+			status: "failed",
+			errorCode: "write_failed"
+		});
+		throw error;
+	}
 	log.debug({
 		sessionKey,
-		candidateCount: candidates.length
+		candidateCount: candidates.length,
+		applied
 	}, "User-understanding review completed");
 }
 async function runBackgroundReviewTurn(params) {

package/dist/src/agent/embedded/model-runtime.js

@@ -1,6 +1,6 @@
 import { init_paths, resolveModelsJsonPath } from "../../config/paths.js";
-import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
+import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
 import { XopcModelCredentialStore, init_model_credential_store } from "../../auth/model-credential-store.js";
 import { init_register_bundled_oauth_flows, registerBundledOAuthFlows } from "../../providers/register-bundled-oauth-flows.js";
 import { init_register_runtime_providers, registerRuntimeProviders } from "../../providers/register-runtime-providers.js";

package/dist/src/agent/embedded/run-for-session.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_providers, resolveModel } from "../../providers/index.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
 import { resolveAgentTurnTimeoutMs } from "../orchestration/run-agent-turn-with-timeout.js";
 import { resolvePromptCachePolicy } from "../../providers/prompt-cache-plan.js";
 import { evaluateContextBudget } from "../memory/context-budget.js";

package/dist/src/agent/image/tool-model-config.js

@@ -1,7 +1,7 @@
 import { getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "../../config/schema.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { getDefaultModelSync, getModelsByProvider, init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
 import { resolveEffectiveAgentManifestForAgent } from "../../config/agent-profile.js";
+import { getDefaultModelSync, getModelsByProvider, init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
 import { resolveAgentModelFallbackValues, resolveAgentModelPrimaryValue } from "../../config/model-input.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";

package/dist/src/agent/inbound/turn-dispatcher.d.ts

@@ -25,7 +25,7 @@ import type { SessionStore } from '../../session/store.js';
 import type { SessionContext, SessionHydrator, SessionStateBag } from '../session/index.js';
 import type { InboundAttachmentInput, MediaRef } from '../../channels/attachments/inbound-persist.js';
 import { type ProcessDirectStreamEvent } from '../service/process-direct-streaming.js';
-import type { AgentSourceContextResolver } from '../source-context/types.js';
+import type { AgentSourceContext, AgentSourceContextResolver } from '../source-context/types.js';
 export interface TurnDispatcherConfig {
     log: ContextualLogger;
     agentManager: AgentManager;
@@ -62,6 +62,7 @@ export interface ProcessDirectOptions {
     signal?: AbortSignal;
     runId?: string;
     deadlineAtMs?: number;
+    sourceContexts?: AgentSourceContext[];
 }
 export declare class TurnDispatcher {
     private readonly cfg;
@@ -73,6 +74,7 @@ export declare class TurnDispatcher {
     processDirectStreaming(content: string, sessionKey: string, origin: TurnOrigin, attachments?: DirectAttachment[], thinking?: string, options?: {
         signal?: AbortSignal;
         runId?: string;
+        sourceContexts?: AgentSourceContext[];
     }): AsyncGenerator<ProcessDirectStreamEvent, void, unknown>;
     /** Push an out-of-band event into the live webchat stream for a session. */
     enqueueWebchatStreamEvent(sessionKey: string, event: {

package/dist/src/agent/inbound/turn-dispatcher.js

@@ -33,7 +33,8 @@ var TurnDispatcher = class {
 			attachments,
 			thinking,
 			signal: options?.signal,
-			runId: options?.runId
+			runId: options?.runId,
+			sourceContexts: options?.sourceContexts
 		});
 	}
 	/** Push an out-of-band event into the live webchat stream for a session. */

package/dist/src/agent/ipc/inbox.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { init_paths, resolveAgentDir } from "../../config/paths.js";
+import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { join } from "path";
 import { existsSync, watch } from "fs";
 import { mkdir, readFile, readdir, rename } from "fs/promises";

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

@@ -2,7 +2,7 @@ import type { AgentMessage } from '@earendil-works/pi-agent-core';
 export type UserContextRejectionReason = 'expired' | 'not_yet_valid' | 'sensitive' | 'requires_consent' | 'needs_review' | 'scope_mismatch' | 'disabled' | 'conflict' | 'low_score' | 'budget';
 export interface PlannedUserContextItem {
     recordId: string;
-    objectType: 'profile' | 'rule' | 'understanding';
+    objectType: 'profile' | 'rule' | 'focus' | 'understanding';
     versionId?: string;
     content: string;
     score: number;

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

@@ -29,7 +29,6 @@ export declare class MemoryManager {
     private pluginProvidersLoaded;
     private readonly understanding;
     private readonly memoryRuntime?;
-    private readonly lastTurnSourceItem;
     private readonly sessionContexts;
     constructor(options?: MemoryManagerOptions);
     addProvider(provider: MemoryProvider): void;
@@ -60,9 +59,11 @@ export declare class MemoryManager {
         projectId?: string;
         sourceItemId?: string;
         sourceItemIds?: string[];
+        evidenceIds?: string[];
         sourceText?: string;
         source?: MemoryRecord['source'];
         reviewSource?: 'turn' | 'background';
+        extractionRunId?: string;
     }): Promise<import('./understanding/types.js').UnderstandingReviewResult>;
     getExternalToolEntries(): Array<{
         providerId: string;

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

@@ -17,7 +17,6 @@ var MemoryManager = class {
 	pluginProvidersLoaded = false;
 	understanding;
 	memoryRuntime;
-	lastTurnSourceItem = /* @__PURE__ */ new Map();
 	sessionContexts = /* @__PURE__ */ new Map();
 	constructor(options = {}) {
 		this.routing = {
@@ -88,7 +87,7 @@ var MemoryManager = class {
 	}
 	async captureTurnUnderstanding(userContent, assistantContent, options) {
 		const sessionContext = options?.sessionId ? this.sessionContexts.get(options.sessionId) : void 0;
-		const review = await this.understanding.reviewTurn({
+		return await this.understanding.reviewTurn({
 			userContent,
 			assistantContent,
 			sessionKey: options?.sessionId,
@@ -97,8 +96,6 @@ var MemoryManager = class {
 			projectId: options?.projectId,
 			correctionTargetRecordIds: options?.correctionTargetRecordIds
 		});
-		if (options?.sessionId && review.sourceItemId) this.lastTurnSourceItem.set(options.sessionId, review.sourceItemId);
-		return review;
 	}
 	async syncProvidersForTurn(userContent, assistantContent, options) {
 		const event = {
@@ -131,7 +128,7 @@ var MemoryManager = class {
 	}
 	async applyUnderstandingCandidates(candidates, context = {}) {
 		const sessionContext = context.sessionKey ? this.sessionContexts.get(context.sessionKey) : void 0;
-		const sourceItemId = context.sourceItemId ?? (context.sessionKey ? this.lastTurnSourceItem.get(context.sessionKey) : void 0);
+		const sourceItemId = context.sourceItemId;
 		const result = await this.understanding.applyCandidates(candidates, {
 			...context,
 			workspaceId: context.workspaceId ?? sessionContext?.workspace ?? sessionContext?.agentWorkspace,
@@ -346,7 +343,6 @@ var MemoryManager = class {
 		}
 	}
 	async shutdownAll() {
-		this.lastTurnSourceItem.clear();
 		this.sessionContexts.clear();
 		for (const p of [...this.providers].reverse()) try {
 			await p.shutdown();

package/dist/src/agent/memory/understanding/service.d.ts

@@ -25,5 +25,6 @@ export declare class UserUnderstandingService {
         evidenceIds?: string[];
         reviewSource?: 'turn' | 'background';
         supersedesRecordIds?: string[];
+        extractionRunId?: string;
     }): Promise<Omit<UnderstandingReviewResult, 'sourceItemId'>>;
 }