@xopcai/xopc 0.0.248 → 0.0.249

package/dist/gateway/static/root/index.html

@@ -11,7 +11,7 @@
     <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png?v=20260713-1" />
     <link rel="manifest" href="/site.webmanifest?v=20260713-1" />
     <title>XOPC — Keep what matters moving.</title>
-    <script type="module" crossorigin src="/assets/index-D5TQQpeb.js"></script>
+    <script type="module" crossorigin src="/assets/index-aBs0EfQB.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-aKtaBQYM.js">
     <link rel="modulepreload" crossorigin href="/assets/preload-helper-zJ_50EbN.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-BOUWij0V.js">
@@ -25,13 +25,13 @@
     <link rel="modulepreload" crossorigin href="/assets/download-Dk-ZjtO6.js">
     <link rel="modulepreload" crossorigin href="/assets/plus-Q2yW6OE7.js">
     <link rel="modulepreload" crossorigin href="/assets/x-B_N4OPjy.js">
-    <link rel="modulepreload" crossorigin href="/assets/messages-CHNYp8EQ.js">
-    <link rel="modulepreload" crossorigin href="/assets/locale-store-BJFLQY8O.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-W5P19VTF.js">
+    <link rel="modulepreload" crossorigin href="/assets/locale-store-zEL8bkwx.js">
     <link rel="modulepreload" crossorigin href="/assets/cn-JdwAhgNB.js">
     <link rel="modulepreload" crossorigin href="/assets/schemas-BHS7bo06.js">
     <link rel="modulepreload" crossorigin href="/assets/product-delivery-CV4pDOtG.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-to-clipboard-HOJ79TWv.js">
-    <link rel="modulepreload" crossorigin href="/assets/markdown-view-DTF9v1gg.js">
+    <link rel="modulepreload" crossorigin href="/assets/markdown-view-DGRN-8wP.js">
     <link rel="modulepreload" crossorigin href="/assets/dist-DLmwHyAh.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-swr-BIWyz7Rc.js">
     <link rel="modulepreload" crossorigin href="/assets/check-DUBLcKHA.js">
@@ -40,39 +40,23 @@
     <link rel="modulepreload" crossorigin href="/assets/settings-shell-layer-context-DCp6ykjQ.js">
     <link rel="modulepreload" crossorigin href="/assets/popover-select-C-Hj-nXR.js">
     <link rel="modulepreload" crossorigin href="/assets/circle-check-C23XjkUj.js">
-    <link rel="modulepreload" crossorigin href="/assets/cloud-C4-yfnnk.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-Dv6d4Dvw.js">
-    <link rel="modulepreload" crossorigin href="/assets/ellipsis-0k4rZLoy.js">
     <link rel="modulepreload" crossorigin href="/assets/external-link-DjqjBmc3.js">
-    <link rel="modulepreload" crossorigin href="/assets/eye-off-DEAzt3g1.js">
-    <link rel="modulepreload" crossorigin href="/assets/eye-CABVeTq0.js">
-    <link rel="modulepreload" crossorigin href="/assets/folder-open-CyzJ19I9.js">
     <link rel="modulepreload" crossorigin href="/assets/globe-DSSGFWFn.js">
-    <link rel="modulepreload" crossorigin href="/assets/link-2-D_ZKYUW7.js">
     <link rel="modulepreload" crossorigin href="/assets/loader-circle-CifKLtgG.js">
-    <link rel="modulepreload" crossorigin href="/assets/message-square-plus-XP0tGdlV.js">
-    <link rel="modulepreload" crossorigin href="/assets/minimize-2-DtOGrlpo.js">
-    <link rel="modulepreload" crossorigin href="/assets/pencil-DmIY3Oa-.js">
-    <link rel="modulepreload" crossorigin href="/assets/rotate-cw-LIg3Am9S.js">
-    <link rel="modulepreload" crossorigin href="/assets/search-DA7gz22f.js">
     <link rel="modulepreload" crossorigin href="/assets/middleware-Pd0e8Igk.js">
     <link rel="modulepreload" crossorigin href="/assets/files-D6vf3S30.js">
     <link rel="modulepreload" crossorigin href="/assets/tool-activity-R8V9l6nk.js">
     <link rel="modulepreload" crossorigin href="/assets/button-CtTvuElV.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-CzBzglzQ.js">
-    <link rel="modulepreload" crossorigin href="/assets/registry-api-CIsNlSBi.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-CuaM3b4c.js">
+    <link rel="modulepreload" crossorigin href="/assets/registry-api-Cg92zSod.js">
     <link rel="modulepreload" crossorigin href="/assets/config-reload-event-Bjh2zoKp.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-DXuXtU1w.js">
-    <link rel="modulepreload" crossorigin href="/assets/models-hub-cache-nCfkBN8M.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-BGdHwT4e.js">
     <link rel="modulepreload" crossorigin href="/assets/electron-env-DH5wF8X8.js">
-    <link rel="modulepreload" crossorigin href="/assets/oauth-api-8lP_qJpq.js">
-    <link rel="modulepreload" crossorigin href="/assets/form-field-width-DJw_jULe.js">
-    <link rel="modulepreload" crossorigin href="/assets/interaction-BmQogeqz.js">
-    <link rel="modulepreload" crossorigin href="/assets/is-masked-secret-DOkL5b_X.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-store-etpmyV7S.js">
-    <link rel="modulepreload" crossorigin href="/assets/theme-store-O597U8q_.js">
+    <link rel="modulepreload" crossorigin href="/assets/activity-store-B759R_qf.js">
+    <link rel="modulepreload" crossorigin href="/assets/theme-store-ZVClZKQ0.js">
     <link rel="stylesheet" crossorigin href="/assets/markdown-view-Y68dCxuc.css">
-    <link rel="stylesheet" crossorigin href="/assets/index-DReBaaTX.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-DGeGmj4k.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/package.js

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.0.248";
+var version = "0.0.249";
 //#endregion
 export { version };

package/dist/src/agent/agent-instance-gateway.d.ts

@@ -44,9 +44,9 @@ export interface AgentInstanceGateway {
     /** Last assistant text from the in-memory agent (empty when no agent / no assistant yet). */
     getLastAssistantContent(sessionKey: string): string | null;
     /** Build the bounded, policy-filtered context used for this model turn. */
-    prepareUserTurnContext(userMessage: AgentMessage, sessionKey: string, turnId: string): Promise<import('./memory/context/types.js').UserContextPlan>;
+    prepareUserTurnContext(userMessage: AgentMessage, sessionKey: string, turnId: string): Promise<import('./context/coordinator.js').ExecutionContextPlan>;
     /** Post-turn: sync external memory providers, queue next prefetch. */
-    afterAgentTurn(sessionKey: string, userPlainText: string, turnId: string): Promise<import('./memory/understanding/types.js').UnderstandingReviewResult | undefined>;
+    afterAgentTurn(sessionKey: string, userPlainText: string, turnId: string): Promise<import('../user-model/capture/index.js').UserModelCaptureResult | undefined>;
     /** Bump the per-session "turns since memory review" counter. */
     beginBackgroundReviewUserTurn(sessionKey: string): void;
     /** Fire-and-forget review (memory + skill nudges) once the main turn finishes. */

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

@@ -22,7 +22,7 @@ import type { SessionContext } from './session/session-context.js';
 import type { Skill, SkillDiagnostic, SkillMarkdownPreviewPayload, SkillRuntimeStatus } from './skills/types.js';
 import { type SkillHubLockEntry } from './skills/hub-lock.js';
 import type { MemoryManager } from './memory/manager.js';
-import type { UserContextPlan } from './memory/context/types.js';
+import { type ExecutionContextPlan } from './context/coordinator.js';
 import { type AgentTurnPolicy } from './orchestration/agent-turn-policy.js';
 export interface SkillCatalogEntry {
     directoryId: string;
@@ -151,7 +151,7 @@ export declare class AgentManager implements AgentInstanceGateway {
     private credentialCache;
     private credentialResolver;
     private workspaceRuntimes;
-    private userContext;
+    private executionContext;
     private backgroundReview;
     private skillFilesystemWatcher;
     private skillDiskRefreshInProgress;
@@ -196,12 +196,12 @@ export declare class AgentManager implements AgentInstanceGateway {
     getMemoryManager(): MemoryManager;
     getMemoryManagerForSession(sessionKey: string): MemoryManager;
     /** Build the bounded, policy-filtered context used for this model turn. */
-    prepareUserTurnContext(userMessage: AgentMessage, sessionKey: string, turnId: string): Promise<UserContextPlan>;
+    prepareUserTurnContext(userMessage: AgentMessage, sessionKey: string, turnId: string): Promise<ExecutionContextPlan>;
     /**
      * After a completed turn: sync external providers and queue next-turn prefetch.
      * Delegates to {@link UserContextCoordinator}.
      */
-    afterAgentTurn(sessionKey: string, userPlainText: string, turnId: string): Promise<import('./memory/understanding/types.js').UnderstandingReviewResult | undefined>;
+    afterAgentTurn(sessionKey: string, userPlainText: string, turnId: string): Promise<import('../user-model/capture/index.js').UserModelCaptureResult | undefined>;
     /**
      * Call once per user turn before the main embedded agent turn.
      * Delegates to {@link BackgroundReviewCoordinator}.

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

@@ -36,9 +36,10 @@ import { sortToolsForPromptCache } from "./tools/cache-stability.js";
 import { AgentToolsFactory } from "./tools/factory.js";
 import "./mcp/bundle-mcp-tools.js";
 import { isMemorySubsystemEnabled } from "./memory/memory-config.js";
-import { UserContextCoordinator } from "./memory/user-context-coordinator.js";
+import { evaluateToolGate } from "./context/execution-context.js";
+import { ExecutionContextCoordinator } from "./context/coordinator.js";
 import { WorkspaceRuntimeRegistry } from "./workspace-runtime/registry.js";
-import { runTurnUnderstandingReview } from "./background-review/run-background-review.js";
+import { runTurnUserModelCapture } from "./background-review/run-background-review.js";
 import { BackgroundReviewCoordinator } from "./background-review/coordinator.js";
 import { maybeRequestChannelExecApproval } from "../channels/exec-approval-runtime.js";
 import { SkillFilesystemWatcher } from "./skills/filesystem-watcher.js";
@@ -105,7 +106,7 @@ var AgentManager = class {
 	credentialCache = /* @__PURE__ */ new Map();
 	credentialResolver;
 	workspaceRuntimes;
-	userContext;
+	executionContext;
 	backgroundReview;
 	skillFilesystemWatcher;
 	skillDiskRefreshInProgress = false;
@@ -130,13 +131,11 @@ var AgentManager = class {
 				this.skillFilesystemWatcher.watchWorkspace(resolvedPath);
 			}
 		});
-		this.userContext = new UserContextCoordinator({
+		this.executionContext = new ExecutionContextCoordinator({
 			getConfig: () => this.config.config,
 			isEnabledForSession: (sessionKey) => this.isUserContextEnabledForSession(sessionKey),
 			getWorkspaceIdForSession: (sk) => this.getResolvedWorkspaceForSession(sk),
-			getProjectIdForSession: (sk) => getSessionMetadata(sk)?.projectId,
-			getMemoryManagerForSession: (sk) => this.getMemoryManagerForSession(sk),
-			getLastAssistantContent: (sk) => this.getLastAssistantContent(sk)
+			getProjectIdForSession: (sk) => getSessionMetadata(sk)?.projectId
 		});
 		this.backgroundReview = new BackgroundReviewCoordinator({ getConfig: () => this.mergedConfig() });
 		this.toolsFactory = new AgentToolsFactory(this.buildToolsFactoryDeps());
@@ -152,7 +151,7 @@ var AgentManager = class {
 	}
 	isUserContextEnabledForSession(sessionKey) {
 		const mode = getSessionConfig(sessionKey)?.userContextMode;
-		return Boolean(this.config.config?.userContext.enabled && this.config.config.userContext.understanding.enabled && (mode === void 0 || mode === "enabled"));
+		return Boolean(this.config.config?.userContext.enabled && this.config.config.userContext.userModel.enabled && (mode === void 0 || mode === "enabled"));
 	}
 	computeBaseWorkspacePath() {
 		const cfg = this.config.config;
@@ -289,25 +288,24 @@ var AgentManager = class {
 	}
 	/** Build the bounded, policy-filtered context used for this model turn. */
 	prepareUserTurnContext(userMessage, sessionKey, turnId) {
-		return this.userContext.prepare(userMessage, sessionKey, turnId);
+		return this.executionContext.prepare(userMessage, sessionKey, turnId);
 	}
 	/**
 	* After a completed turn: sync external providers and queue next-turn prefetch.
 	* Delegates to {@link UserContextCoordinator}.
 	*/
 	async afterAgentTurn(sessionKey, userPlainText, turnId) {
-		await this.userContext.afterTurn(sessionKey, userPlainText);
 		if (!this.isUserContextEnabledForSession(sessionKey)) return void 0;
 		const parsed = parseSessionKey(sessionKey);
 		if (parsed && parsed.peerKind !== "direct") return void 0;
 		const instance = this.agents.get(sessionKey);
 		if (!instance) return void 0;
-		return runTurnUnderstandingReview({
+		return runTurnUserModelCapture({
 			sessionKey,
 			turnId,
 			userText: userPlainText,
 			mainAgent: instance.agent,
-			memoryManager: this.getMemoryManagerForSession(sessionKey),
+			workspaceId: this.getResolvedWorkspaceForSession(sessionKey),
 			getConfig: () => this.mergedConfig()
 		});
 	}
@@ -330,7 +328,7 @@ var AgentManager = class {
 			sessionKey,
 			agent: inst.agent,
 			lastAssistantText: this.getLastAssistantContent(sessionKey),
-			workspaceRuntime: this.getWorkspaceRuntimeForSession(sessionKey)
+			workspaceId: this.getResolvedWorkspaceForSession(sessionKey)
 		});
 	}
 	/**
@@ -792,7 +790,7 @@ var AgentManager = class {
 			instance.agent.abort();
 			evictEmbeddedSessionRunner(sessionKey, "agent_removed");
 			this.agents.delete(sessionKey);
-			this.userContext.forgetSession(sessionKey);
+			this.executionContext.forgetSession(sessionKey);
 			clearBootstrapSnapshot(sessionKey);
 			this.config.getModelManager?.().clearSessionProfileDefault(sessionKey);
 			log.info({
@@ -872,7 +870,7 @@ var AgentManager = class {
 		for (const instance of this.agents.values()) instance.agent.abort();
 		this.agents.clear();
 		this.runtimeListeners.clear();
-		this.userContext.clear();
+		this.executionContext.clear();
 		this.sessionWorkspaceOverrides.clear();
 		this.workspaceRuntimes.clearAll();
 		log.debug("All agent instances disposed");
@@ -976,6 +974,23 @@ var AgentManager = class {
 			},
 			authorizeToolCall: async ({ toolCall, args }) => {
 				const toolName = toolCall.name;
+				const operation = {
+					message: "external_send",
+					send_media: "external_send",
+					exec_command: "command_execute",
+					write_file: "filesystem_write",
+					apply_patch: "filesystem_write",
+					xopc_tool_execute: "external_tool"
+				}[toolName] ?? toolName;
+				const executionGate = this.executionContext.getCurrent(sessionKey);
+				if (executionGate) {
+					const decision = evaluateToolGate(executionGate, operation);
+					if (!decision.allowed) return {
+						block: true,
+						terminate: true,
+						reason: decision.reason ?? "Blocked by collaboration rule."
+					};
+				}
 				const policy = this.resolveToolPolicy(profile, toolName, args);
 				const detail = JSON.stringify(args ?? {});
 				if (policy?.mode === "ask") {
@@ -1039,6 +1054,7 @@ var AgentManager = class {
 		const request = this.config.gatewayClarify?.requestClarification;
 		if (!request) return false;
 		return await request(sessionKey, {
+			kind: "approval",
 			question: `Allow ${toolName} to run once?\n${detail.slice(0, 500)}`,
 			choices: ["Allow once", "Deny"],
 			default: "Deny"

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

@@ -10,7 +10,6 @@
  */
 import type { Agent } from '@earendil-works/pi-agent-core';
 import type { Config } from '../../config/schema.js';
-import type { WorkspaceRuntime } from '../workspace-runtime/registry.js';
 export interface BackgroundReviewCoordinatorOptions {
     /** Effective config snapshot used to look up review-cadence settings. */
     getConfig: () => Config | undefined;
@@ -20,7 +19,7 @@ export interface ScheduleReviewContext {
     agent: Agent;
     /** Last assistant text — review is skipped when empty. */
     lastAssistantText: string | null;
-    workspaceRuntime: WorkspaceRuntime;
+    workspaceId: string;
 }
 export declare class BackgroundReviewCoordinator {
     private readonly opts;
@@ -34,7 +33,7 @@ export declare class BackgroundReviewCoordinator {
     /**
      * Fire-and-forget review after the main user turn. Decides whether to run a
      * understanding sweep based on the counter state + last assistant text,
-     * and delegates the actual review to {@link runBackgroundReviewTurn}.
+     * and delegates the actual review to {@link runBackgroundUserModelReview}.
      */
     scheduleAfterUserTurn(ctx: ScheduleReviewContext): void;
     /** Tear down state for a session (called by `AgentManager.removeAgent`). */
@@ -42,6 +41,5 @@ export declare class BackgroundReviewCoordinator {
     /** Clear every counter (`AgentManager.dispose` / hot reload). */
     clear(): void;
     private ensureState;
-    private resolveReviewInterval;
     private runReviewIfNeeded;
 }

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

@@ -1,11 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { summarizeUserUnderstandingQuality } from "../../storage/sqlite/user-context-quality-repository.js";
-import "../../storage/sqlite/index.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed } from "../orchestration/llm-turn-retry.js";
-import { resolveAdaptiveUnderstandingCadence } from "../memory/understanding/quality.js";
 import { resolveBackgroundReviewSettings } from "./settings.js";
-import { runBackgroundReviewTurn } from "./run-background-review.js";
+import { runBackgroundUserModelReview } from "./run-background-review.js";
 //#region src/agent/background-review/coordinator.ts
 init_logger();
 const log = createLogger("BackgroundReviewCoordinator");
@@ -23,7 +20,7 @@ var BackgroundReviewCoordinator = class {
 		const cfg = resolveBackgroundReviewSettings(this.opts.getConfig());
 		if (!cfg.enabled) return;
 		const state = this.ensureState(sessionKey);
-		const intervalTurns = this.resolveReviewInterval(cfg, state);
+		const intervalTurns = cfg.reviewIntervalTurns;
 		state.turnsSinceReview += 1;
 		if (state.turnsSinceReview >= intervalTurns) {
 			state.pendingReview = true;
@@ -33,7 +30,7 @@ var BackgroundReviewCoordinator = class {
 	/**
 	* Fire-and-forget review after the main user turn. Decides whether to run a
 	* understanding sweep based on the counter state + last assistant text,
-	* and delegates the actual review to {@link runBackgroundReviewTurn}.
+	* and delegates the actual review to {@link runBackgroundUserModelReview}.
 	*/
 	scheduleAfterUserTurn(ctx) {
 		this.runReviewIfNeeded(ctx).catch((err) => {
@@ -61,28 +58,6 @@ var BackgroundReviewCoordinator = class {
 		this.states.set(sessionKey, state);
 		return state;
 	}
-	resolveReviewInterval(settings, state) {
-		if (!settings.adaptiveCadence) return settings.reviewIntervalTurns;
-		const now = Date.now();
-		if (state.adaptiveIntervalTurns != null && (state.adaptiveIntervalExpiresAt ?? 0) > now) return state.adaptiveIntervalTurns;
-		try {
-			const metrics = summarizeUserUnderstandingQuality({
-				windowDays: 30,
-				nowMs: now
-			});
-			const decision = resolveAdaptiveUnderstandingCadence(settings.reviewIntervalTurns, metrics);
-			state.adaptiveIntervalTurns = decision.effectiveIntervalTurns;
-			state.adaptiveIntervalExpiresAt = now + 5 * 6e4;
-			if (decision.slowed) log.debug({
-				baseIntervalTurns: decision.baseIntervalTurns,
-				effectiveIntervalTurns: decision.effectiveIntervalTurns,
-				reasons: decision.reasons
-			}, "User-understanding review cadence slowed by quality signals");
-			return decision.effectiveIntervalTurns;
-		} catch {
-			return settings.reviewIntervalTurns;
-		}
-	}
 	async runReviewIfNeeded(ctx) {
 		const state = this.states.get(ctx.sessionKey);
 		if (!state) return;
@@ -93,11 +68,11 @@ var BackgroundReviewCoordinator = class {
 		const shouldReview = state.pendingReview;
 		state.pendingReview = false;
 		if (!shouldReview) return;
-		await runBackgroundReviewTurn({
+		await runBackgroundUserModelReview({
 			sessionKey: ctx.sessionKey,
 			mainAgent: ctx.agent,
 			settings,
-			memoryManager: ctx.workspaceRuntime.memoryManager,
+			workspaceId: ctx.workspaceId,
 			getConfig: () => this.opts.getConfig()
 		});
 	}

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

@@ -1,6 +1,8 @@
-export declare const UNDERSTANDING_INTERPRETER_SYSTEM_PROMPT = "You are xopc's user-understanding interpreter. You do not chat with the user and cannot write storage. Distinguish memory commands, memory questions, corrections, forgetting, durable user assertions, and ordinary task requests. Return strict JSON only. Never treat assistant text as evidence of a fact about the user.";
-export declare function buildUnderstandingInterpreterPrompt(options: {
+export declare const USER_MODEL_INTERPRETER_SYSTEM_PROMPT = "You are xopc's user-model interpreter. You do not chat with the user and cannot write storage. Distinguish explicit memory commands, corrections, forgetting, durable user assertions, and ordinary task requests. Return strict JSON only. Assistant text is never evidence about the user.";
+export declare function buildUserModelInterpreterPrompt(options: {
     mode: 'turn' | 'transcript';
+    evidenceTimestamp: string;
+    timezone: string;
     availableTargets?: Array<{
         id: string;
         statement: string;

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

@@ -1,34 +1,39 @@
-import { USER_FACING_UNDERSTANDING_WRITING_GUIDANCE } from "../../user-context/understanding-writing.js";
 //#region src/agent/background-review/prompts.ts
-const UNDERSTANDING_INTERPRETER_SYSTEM_PROMPT = `You are xopc's user-understanding interpreter. You do not chat with the user and cannot write storage. Distinguish memory commands, memory questions, corrections, forgetting, durable user assertions, and ordinary task requests. Return strict JSON only. Never treat assistant text as evidence of a fact about the user.`;
-function buildUnderstandingInterpreterPrompt(options) {
-	const targets = options.availableTargets?.length ? `\nOnly these understanding IDs may be targeted for confirm, correction, or forgetting:\n${options.availableTargets.map((item) => `- ${item.id}: ${item.statement}`).join("\n")}` : "\nNo existing understanding IDs are available to target.";
+const USER_MODEL_INTERPRETER_SYSTEM_PROMPT = `You are xopc's user-model interpreter. You do not chat with the user and cannot write storage. Distinguish explicit memory commands, corrections, forgetting, durable user assertions, and ordinary task requests. Return strict JSON only. Assistant text is never evidence about the user.`;
+function buildUserModelInterpreterPrompt(options) {
+	const targets = options.availableTargets?.length ? `\nThese assertion IDs may be targeted for confirm, correction, or forgetting:\n${options.availableTargets.map((item) => `- ${item.id}: ${item.statement}`).join("\n")}` : "\nNo existing assertion IDs are available to target.";
 	return `Interpret the evidence-tagged conversation above for ${options.mode === "turn" ? "the latest user turn" : "durable transcript synthesis"}.
 
-Return exactly this JSON shape:
-{"intent":"none","candidates":[],"targetUnderstandingIds":[],"abstentionReason":"..."}
+Evidence time: ${options.evidenceTimestamp}
+User timezone: ${options.timezone}
 
-Allowed intents: memory_create, memory_query, memory_confirm, memory_correct, memory_forget, user_assertion, task_request, none.
+Return exactly this top-level shape:
+{"intent":"none","candidates":[],"targetAssertionIds":[],"abstentionReason":"..."}
 
 Candidate shape:
-{"factKey":"communication:concise","statement":"...","kind":"preference","explicitness":"observed","durability":"durable","scopeHint":"global","confidence":0.8,"importance":0.7,"sensitivity":"normal","disclosurePolicy":"referenceable","evidence":[{"ref":"entry-id","quote":"exact quote from that user message"}],"selfContained":true,"unresolvedReferences":[]}
+{"subject":{"type":"user","id":"self"},"predicate":"preference.response.detail","cardinality":"single","scope":{"type":"global"},"kind":"preference","value":"concise","normalizedValue":"concise","statement":"The user prefers concise answers.","authority":"user_observed","confidence":0.9,"declaredImportance":0.8,"inferredImportance":0.6,"consequence":"medium","actionability":1,"volatility":"stable","sensitivity":"normal","disclosurePolicy":"referenceable","applicability":{"operation":"response"},"temporalResolution":"exact","evidence":[{"ref":"entry-id","quote":"exact quote"}],"selfContained":true,"unresolvedReferences":[]}
 
-Allowed kinds: preference, boundary, relationship, routine, current_state, long_term_goal, project_context, task_lesson, derived_insight.
+Allowed intents: remember, query, confirm, correct, forget, user_assertion, task, none.
+Allowed subject types: user, person, goal, project, topic.
+Allowed kinds: identity, preference, value, routine, capability, relationship, current_state, derived_insight.
+Allowed scopes: global without id; agent, workspace, project, or session with the exact supplied id.
 
 Rules:
-- A question such as “Do you remember this goal?” is memory_query and creates no candidate.
-- A request to create, summarize, update, investigate, or track a goal is task_request, not a user goal.
-- Every candidate needs an exact quote from one or more user messages. Assistant messages may resolve context but never count as evidence.
-- Extract zero to eight independent candidates; do not collapse multiple facts into one.
-- factKey must be a stable language-neutral lowercase identifier using letters, digits, colons, or hyphens. Equivalent facts in different languages must use the same factKey.
-- Set selfContained=false and list unresolvedReferences for unresolved words such as this, that, it, 这个, 那个, or 它.
+- A question about what is remembered uses query and creates no candidate.
+- A request to create, summarize, update, investigate, or track work uses task, not a user assertion.
+- Every candidate needs an exact quote from a user message. Assistant messages can resolve context but are never evidence.
+- Extract zero to eight independent candidates. Each candidate represents one stable predicate and one value.
+- predicate is a stable language-neutral lowercase identifier. The value is excluded from predicate identity.
+- Preserve importance stated by the user in declaredImportance; estimate inferredImportance separately.
+- Use current_state or event volatility only with a bounded validTo. If relative time cannot be resolved, use temporalResolution=unresolved and omit resolved time fields.
+- Resolve relative time using the evidence time and timezone. Put ISO 8601 timestamps with offsets in validFrom, validTo, and reviewAt.
+- For an explicit correction, set correctionOfAssertionId on the replacement candidate.
+- Set selfContained=false and list unresolvedReferences for unresolved pronouns or references.
 - Omit temporary reactions and one-off task instructions.
 - Never include passwords, credentials, regulated identifiers, or speculative diagnoses.
-- For transcript mode, use explicitness=inferred unless the latest user message is itself an explicit memory command or correction.
+- In transcript mode, use system_inferred unless a quoted user message is itself an explicit memory command.
 - If evidence is insufficient, return candidates=[] and explain abstentionReason.
-
-${USER_FACING_UNDERSTANDING_WRITING_GUIDANCE}
 ${targets}`;
 }
 //#endregion
-export { UNDERSTANDING_INTERPRETER_SYSTEM_PROMPT, buildUnderstandingInterpreterPrompt };
+export { USER_MODEL_INTERPRETER_SYSTEM_PROMPT, buildUserModelInterpreterPrompt };

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

@@ -1,19 +1,18 @@
 import { Agent } from '@earendil-works/pi-agent-core';
 import type { Config } from '../../config/schema.js';
-import type { MemoryManager } from '../memory/manager.js';
-import type { UnderstandingReviewResult } from '../memory/understanding/types.js';
+import { type UserModelCaptureResult } from '../../user-model/capture/index.js';
 import type { BackgroundReviewSettings } from './settings.js';
-export interface RunBackgroundReviewParams {
+export interface RunUserModelReviewParams {
     sessionKey: string;
     mainAgent: Agent;
     settings: BackgroundReviewSettings;
-    memoryManager: MemoryManager;
+    workspaceId: string;
     getConfig: () => Config | undefined;
 }
-export interface RunTurnUnderstandingParams extends Omit<RunBackgroundReviewParams, 'settings'> {
+export interface RunTurnUserModelCaptureParams extends Omit<RunUserModelReviewParams, 'settings'> {
     turnId: string;
     userText: string;
     maxHistoryMessages?: number;
 }
-export declare function runTurnUnderstandingReview(params: RunTurnUnderstandingParams): Promise<UnderstandingReviewResult>;
-export declare function runBackgroundReviewTurn(params: RunBackgroundReviewParams): Promise<void>;
+export declare function runTurnUserModelCapture(params: RunTurnUserModelCaptureParams): Promise<UserModelCaptureResult>;
+export declare function runBackgroundUserModelReview(params: RunUserModelReviewParams): Promise<void>;