@xopcai/xopc 0.0.255 → 0.0.256

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-PksHo9hS.js"></script>
+    <script type="module" crossorigin src="/assets/index-BWdn9NaX.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">
@@ -20,18 +20,18 @@
     <link rel="modulepreload" crossorigin href="/assets/floating-ui.dom-B7uQOZZW.js">
     <link rel="modulepreload" crossorigin href="/assets/dist-DBS3OB8K.js">
     <link rel="modulepreload" crossorigin href="/assets/dist-CpzYSoz7.js">
-    <link rel="modulepreload" crossorigin href="/assets/chunk-KS7C4IRE-BaASWQor.js">
+    <link rel="modulepreload" crossorigin href="/assets/chunk-KS7C4IRE-Cq1tE_3b.js">
     <link rel="modulepreload" crossorigin href="/assets/createLucideIcon-DPHK1VkS.js">
     <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-DngsF_Kx.js">
-    <link rel="modulepreload" crossorigin href="/assets/locale-store-VsboRLD7.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-BeIiRpmk.js">
+    <link rel="modulepreload" crossorigin href="/assets/locale-store-DJPCr2mb.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-CPXhy6nh.js">
+    <link rel="modulepreload" crossorigin href="/assets/markdown-view-k_PJsY2C.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">
@@ -48,15 +48,15 @@
     <link rel="modulepreload" crossorigin href="/assets/files-BArWTfr7.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-XZnY6621.js">
-    <link rel="modulepreload" crossorigin href="/assets/registry-api-DlTWbXQA.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-Dlyt2VhF.js">
+    <link rel="modulepreload" crossorigin href="/assets/registry-api-Dalzf2w0.js">
     <link rel="modulepreload" crossorigin href="/assets/config-reload-event-Bjh2zoKp.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-02BBC1mK.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-DEKSw3d-.js">
     <link rel="modulepreload" crossorigin href="/assets/electron-env-DH5wF8X8.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-store-DvjK5FEm.js">
-    <link rel="modulepreload" crossorigin href="/assets/theme-store-vdB57bTn.js">
+    <link rel="modulepreload" crossorigin href="/assets/activity-store-DYb6xFC3.js">
+    <link rel="modulepreload" crossorigin href="/assets/theme-store-DYDrhfnD.js">
     <link rel="stylesheet" crossorigin href="/assets/markdown-view-Y68dCxuc.css">
-    <link rel="stylesheet" crossorigin href="/assets/index-DsonmRCH.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-50Kr6L6C.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/package.js

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

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

@@ -6,14 +6,6 @@ const USER_CONTEXT_TAGS = [
 	"collaboration-contract",
 	"user-context"
 ];
-const LEGACY_EXECUTION_CONTEXT_HEADINGS = [
-	"Collaboration rules:",
-	"Relevant user facts:",
-	"Active goals:",
-	"Current priorities:",
-	"Relevant knowledge:"
-];
-const EMBEDDED_TIMESTAMP_PREFIX_RE = /(?:^|\r?\n)(\[\d{4}-\d{2}-\d{2} \d{2}:\d{2}[^\]]*\]\s*)/u;
 function stripLeadingTaggedBlock(text, tag) {
 	const opening = `<${tag}>`;
 	if (!text.startsWith(opening)) return null;
@@ -31,15 +23,6 @@ function stripSourceContextsEnvelope(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;
 }
-/** Remove execution context persisted before it gained a structured envelope. */
-function stripLegacyExecutionContext(text) {
-	const trimmed = text.trimStart();
-	if (!LEGACY_EXECUTION_CONTEXT_HEADINGS.some((heading) => trimmed.startsWith(heading))) return text;
-	const timestamp = trimmed.match(EMBEDDED_TIMESTAMP_PREFIX_RE);
-	if (!timestamp || timestamp.index === void 0) return text;
-	const timestampStart = timestamp.index + timestamp[0].length - timestamp[1].length;
-	return trimmed.slice(timestampStart);
-}
 /**
 * Restore a model-facing user message to its client-facing text.
 * Generated profile/memory blocks require the runtime timestamp anchor, which
@@ -66,7 +49,6 @@ function stripRuntimeUserMessageEnvelope(text) {
 		removedUserContext = true;
 	}
 	if (removedUserContext && !ENVELOPE_TIMESTAMP_PREFIX_RE.test(remaining)) remaining = beforeUserContext;
-	remaining = stripLegacyExecutionContext(remaining);
 	return remaining.replace(ENVELOPE_TIMESTAMP_PREFIX_RE, "");
 }
 //#endregion

package/dist/src/agent/context/execution-context.js

@@ -5,6 +5,7 @@ import "../../knowledge-memory/index.js";
 import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { calculateExecutionValue } from "../../user-model/importance.js";
 import { listUserAssertions } from "../../user-model/repository.js";
+import { isWorkingAssumption } from "../../user-model/usage-policy.js";
 import { getExecutionContextFeedbackScores } from "./audit.js";
 import { buildUserContextBlock } from "../memory/context-fence.js";
 import { randomUUID } from "node:crypto";
@@ -43,24 +44,27 @@ function urgency(assertion, asOf) {
 }
 function rankAssertion(assertion, query, asOf, feedbackScore) {
 	const taskRelevance = retrievalLexicalSimilarity(query, `${assertion.statement} ${assertion.normalizedValue}`);
+	const score = calculateExecutionValue({
+		declaredImportance: assertion.declaredImportance,
+		inferredImportance: assertion.inferredImportance,
+		consequence: assertion.consequence,
+		actionability: assertion.actionability,
+		taskRelevance,
+		urgency: urgency(assertion, asOf)
+	}) + feedbackScore;
+	const reasons = [
+		taskRelevance >= .35 ? "task_relevant" : "",
+		assertion.declaredImportance !== void 0 ? "user_declared_importance" : "",
+		assertion.consequence === "critical" || assertion.consequence === "high" ? "high_consequence" : "",
+		assertion.kind === "identity" || assertion.kind === "preference" ? "stable_personalization" : "",
+		feedbackScore > 0 ? "historically_helpful" : "",
+		feedbackScore < 0 ? "historically_irrelevant" : ""
+	].filter(Boolean);
 	return {
 		assertion,
-		score: calculateExecutionValue({
-			declaredImportance: assertion.declaredImportance,
-			inferredImportance: assertion.inferredImportance,
-			consequence: assertion.consequence,
-			actionability: assertion.actionability,
-			taskRelevance,
-			urgency: urgency(assertion, asOf)
-		}) + feedbackScore,
-		reasons: [
-			taskRelevance >= .35 ? "task_relevant" : "",
-			assertion.declaredImportance !== void 0 ? "user_declared_importance" : "",
-			assertion.consequence === "critical" || assertion.consequence === "high" ? "high_consequence" : "",
-			assertion.kind === "identity" || assertion.kind === "preference" ? "stable_personalization" : "",
-			feedbackScore > 0 ? "historically_helpful" : "",
-			feedbackScore < 0 ? "historically_irrelevant" : ""
-		].filter(Boolean)
+		usage: assertion.status === "active" ? "confirmed" : "working_assumption",
+		score: assertion.status === "candidate" ? score - .05 : score,
+		reasons
 	};
 }
 function ruleEnforcement(conditions) {
@@ -91,6 +95,7 @@ function loadGoals(context, asOf) {
 		title: row.title,
 		desiredOutcome: row.desired_outcome,
 		status: row.status,
+		usage: row.status === "active" ? "confirmed" : "working_assumption",
 		...row.declared_importance === null ? {} : { declaredImportance: row.declared_importance },
 		...row.target_at === null ? {} : { targetAt: row.target_at }
 	}));
@@ -115,10 +120,12 @@ function buildExecutionContext(request) {
 	const asOf = request.asOf ?? Date.now();
 	const includeUserModel = request.includeUserModel !== false;
 	const feedbackScores = getExecutionContextFeedbackScores();
-	const assertions = includeUserModel ? listUserAssertions({
-		statuses: ["active"],
+	const assertionLimit = Math.max(1, Math.min(100, request.maxAssertions ?? 20));
+	const rankedAssertions = includeUserModel ? listUserAssertions({
+		statuses: ["active", "candidate"],
 		limit: 1e3
-	}).filter((item) => scopeVisible(getAssertionScope(item.slotId), request)).filter((item) => applicabilityVisible(item.applicability, request)).filter((item) => (item.validFrom === void 0 || item.validFrom <= asOf) && (item.validTo === void 0 || item.validTo >= asOf)).filter((item) => item.authority !== "external_untrusted").filter((item) => item.sensitivity !== "secret" && item.sensitivity !== "regulated" && item.disclosurePolicy !== "ask_before_reference").map((item) => rankAssertion(item, request.query, asOf, feedbackScores.get(`assertion:${item.id}`) ?? 0)).filter((item) => item.score >= .12 || item.reasons.includes("high_consequence")).sort((left, right) => right.score - left.score).slice(0, Math.max(1, Math.min(100, request.maxAssertions ?? 20))) : [];
+	}).filter((item) => scopeVisible(getAssertionScope(item.slotId), request)).filter((item) => applicabilityVisible(item.applicability, request)).filter((item) => (item.validFrom === void 0 || item.validFrom <= asOf) && (item.validTo === void 0 || item.validTo >= asOf)).filter((item) => item.authority !== "external_untrusted").filter((item) => item.sensitivity !== "secret" && item.sensitivity !== "regulated" && item.disclosurePolicy !== "ask_before_reference").filter((item) => item.status === "active" || isWorkingAssumption(item)).map((item) => rankAssertion(item, request.query, asOf, feedbackScores.get(`assertion:${item.id}`) ?? 0)).filter((item) => item.score >= .12 || item.reasons.includes("high_consequence")).sort((left, right) => right.score - left.score) : [];
+	const assertions = [...rankedAssertions.filter((item) => item.usage === "confirmed"), ...rankedAssertions.filter((item) => item.usage === "working_assumption")].slice(0, assertionLimit);
 	const maxKnowledge = Math.max(0, Math.min(100, request.maxKnowledge ?? 12));
 	const knowledge = request.includeKnowledge === false || maxKnowledge === 0 ? [] : searchKnowledgeItems({
 		query: request.query,
@@ -153,8 +160,14 @@ function getAssertionScope(slotId) {
 function renderExecutionContext(context) {
 	const sections = [];
 	if (context.rules.length) sections.push(`Collaboration rules:\n${context.rules.map((rule) => `- ${rule.statement}`).join("\n")}`);
-	if (context.assertions.length) sections.push(`Relevant user facts:\n${context.assertions.map((item) => `- ${item.assertion.statement}`).join("\n")}`);
-	if (context.goals.length) sections.push(`Active goals:\n${context.goals.map((goal) => `- ${goal.title}: ${goal.desiredOutcome}`).join("\n")}`);
+	const confirmedAssertions = context.assertions.filter((item) => item.usage === "confirmed");
+	const workingAssumptions = context.assertions.filter((item) => item.usage === "working_assumption");
+	if (confirmedAssertions.length) sections.push(`Confirmed user context:\n${confirmedAssertions.map((item) => `- ${item.assertion.statement}`).join("\n")}`);
+	if (workingAssumptions.length) sections.push(`Working assumptions (may be wrong; adapt quietly, never present them as confirmed facts, and accept corrections immediately):\n${workingAssumptions.map((item) => `- ${item.assertion.statement} (confidence ${item.assertion.confidence.toFixed(2)})`).join("\n")}`);
+	const confirmedGoals = context.goals.filter((goal) => goal.usage === "confirmed");
+	const assumedGoals = context.goals.filter((goal) => goal.usage === "working_assumption");
+	if (confirmedGoals.length) sections.push(`Confirmed goals:\n${confirmedGoals.map((goal) => `- ${goal.title}: ${goal.desiredOutcome}`).join("\n")}`);
+	if (assumedGoals.length) sections.push(`Possible goals (not yet confirmed):\n${assumedGoals.map((goal) => `- ${goal.title}: ${goal.desiredOutcome}`).join("\n")}`);
 	if (context.priorities.length) sections.push(`Current priorities:\n${context.priorities.map((item) => `- ${item.rank}: ${item.targetType}/${item.targetId}`).join("\n")}`);
 	if (context.knowledge.length) sections.push(`Relevant knowledge:\n${context.knowledge.map((item) => `- ${item.content}`).join("\n")}`);
 	return sections.join("\n\n");

package/dist/src/agent/context/execution-context.types.d.ts

@@ -10,6 +10,7 @@ export interface ExecutionRule {
 }
 export interface RankedExecutionAssertion {
     assertion: UserAssertion;
+    usage: 'confirmed' | 'working_assumption';
     score: number;
     reasons: string[];
 }
@@ -18,6 +19,7 @@ export interface ExecutionGoal {
     title: string;
     desiredOutcome: string;
     status: string;
+    usage: 'confirmed' | 'working_assumption';
     declaredImportance?: number;
     targetAt?: number;
 }

package/dist/src/agent/inbound/attachment-pipeline.d.ts

@@ -31,6 +31,7 @@ export declare function hydrateUserTurnForLlm(opts: {
     modelRef: string;
 }): Promise<LlmUserTurn>;
 export declare function setPendingTranscriptUserMessage(sessionKey: string, message: TranscriptUserMessage): void;
+export declare function getPendingTranscriptUserText(sessionKey: string): string | undefined;
 export declare function takePendingTranscriptUserMessage(sessionKey: string): TranscriptUserMessage | undefined;
 export declare function clearPendingTranscriptUserMessage(sessionKey: string, message?: TranscriptUserMessage): void;
 export declare function pendingTranscriptReferencesMediaUri(sessionKey: string, uri: string): boolean;

package/dist/src/agent/inbound/attachment-pipeline.js

@@ -144,6 +144,11 @@ function setPendingTranscriptUserMessage(sessionKey, message) {
 	assertTranscriptUserMessage(message);
 	pendingTranscriptBySession.set(sessionKey, message);
 }
+function getPendingTranscriptUserText(sessionKey) {
+	const message = pendingTranscriptBySession.get(sessionKey);
+	if (!message) return void 0;
+	return stripRuntimeUserMessageEnvelope(messageTextForPendingCompare(message)).trim();
+}
 function takePendingTranscriptUserMessage(sessionKey) {
 	const msg = pendingTranscriptBySession.get(sessionKey);
 	pendingTranscriptBySession.delete(sessionKey);
@@ -171,4 +176,4 @@ function transformUserMessageForPersistence(sessionKey, message) {
 	return message;
 }
 //#endregion
-export { assertTranscriptUserMessage, buildTranscriptUserMessage, clearPendingTranscriptUserMessage, hydrateUserTurnForLlm, pendingTranscriptReferencesMediaUri, setPendingTranscriptUserMessage, takePendingTranscriptUserMessage, transformUserMessageForPersistence };
+export { assertTranscriptUserMessage, buildTranscriptUserMessage, clearPendingTranscriptUserMessage, getPendingTranscriptUserText, hydrateUserTurnForLlm, pendingTranscriptReferencesMediaUri, setPendingTranscriptUserMessage, takePendingTranscriptUserMessage, transformUserMessageForPersistence };

package/dist/src/agent/prompt/sections/memory-skills.js

@@ -13,10 +13,11 @@ function buildMemorySection(params) {
 	const lines = [
 		"## Context and memory",
 		"",
-		"Relevant user facts, goals, priorities, collaboration rules, and task knowledge are selected for each turn.",
+		"Confirmed user context, labeled working assumptions, goals, priorities, collaboration rules, and task knowledge are selected for each turn.",
 		"When exact or additional context is needed:"
 	];
 	if (names.has("user_context_search")) lines.push("- Use `user_context_search` for user identity, preferences, routines, and current state.");
+	if (names.has("user_context_update")) lines.push("- When the current user explicitly corrects, confirms, rejects, or asks to forget an existing user assertion, use `user_context_update` immediately and include an exact quote as evidence. Never use it for an inference of your own.");
 	if (names.has("knowledge_search")) lines.push("- Use `knowledge_search` for project facts, decisions, lessons, commitments, and open questions.");
 	if (names.has("session_recall")) lines.push("- Use `session_recall` for exact raw content from the current session.");
 	if (names.has("session_search")) lines.push("- Use `session_search` for other conversations.");

package/dist/src/agent/prompt/sections/tooling.js

@@ -17,6 +17,7 @@ const CORE_TOOL_ORDER = [
 	"publish_artifacts",
 	"user_context_search",
 	"user_context_get",
+	"user_context_update",
 	"knowledge_search",
 	"knowledge_get",
 	"knowledge_write",
@@ -57,6 +58,7 @@ const CORE_TOOL_SUMMARIES = {
 	publish_artifacts: "Publish final generated files as durable chat deliverables",
 	user_context_search: "Search typed user facts, preferences, routines, and current state",
 	user_context_get: "Read one typed user assertion with its scope and authority",
+	user_context_update: "Apply an explicit user confirmation, correction, rejection, or forget request to an existing assertion",
 	knowledge_search: "Search scoped project, workspace, and session knowledge",
 	knowledge_get: "Read one knowledge item returned by search",
 	knowledge_write: "Store a scoped knowledge candidate with provenance",

package/dist/src/agent/tools/delegate-tool.js

@@ -28,6 +28,7 @@ const DELEGATE_BLOCKED_TOOLS = new Set([
 	"session_search",
 	"user_context_search",
 	"user_context_get",
+	"user_context_update",
 	"knowledge_search",
 	"knowledge_get",
 	"knowledge_write",

package/dist/src/agent/tools/factory.js

@@ -19,7 +19,7 @@ import { createListDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
 import { createExecCommandTool } from "./exec-command.js";
 import { createApplyPatchTool } from "./apply-patch.js";
-import { createUserContextGetTool, createUserContextSearchTool } from "./user-context-tool.js";
+import { createUserContextGetTool, createUserContextSearchTool, createUserContextUpdateTool } from "./user-context-tool.js";
 import { createKnowledgeGetTool, createKnowledgeSearchTool, createKnowledgeWriteTool } from "./knowledge-memory-tool.js";
 import { createSessionSearchTool } from "./session-search-tool.js";
 import { createSessionRecallTool } from "./session-recall-tool.js";
@@ -40,6 +40,7 @@ import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
 import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
 import { checkBrowserReadiness } from "../../browser/readiness.js";
 import "../../browser/index.js";
+import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
 import { createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
@@ -324,6 +325,18 @@ var AgentToolsFactory = class AgentToolsFactory {
 				getProjectId: currentProjectId,
 				canRead: () => currentAccess().userModel
 			}),
+			createUserContextUpdateTool({
+				agentId: resolvedAgentId,
+				workspaceId: workspace,
+				getSessionId: currentSessionKey,
+				getProjectId: currentProjectId,
+				canRead: () => currentAccess().userModel,
+				canWrite: () => currentAccess().userModel,
+				getCurrentUserText: () => {
+					const sessionKey = currentSessionKey();
+					return sessionKey ? getPendingTranscriptUserText(sessionKey) : void 0;
+				}
+			}),
 			createKnowledgeSearchTool({
 				agentId: resolvedAgentId,
 				workspaceId: workspace,

package/dist/src/agent/tools/index.d.ts

@@ -5,7 +5,7 @@ export { createWriteFileTool, writeFileTool } from './write.js';
 export { createListDirTool, listDirTool } from './list-dir.js';
 export { createExecCommandTool, type ExecCommandDetails, type ExecCommandUpdateDetails, } from './exec-command.js';
 export { createApplyPatchTool, type AppliedPatchChange, type ApplyPatchDetails, } from './apply-patch.js';
-export { createUserContextSearchTool, createUserContextGetTool, type UserContextToolOptions, } from './user-context-tool.js';
+export { createUserContextSearchTool, createUserContextGetTool, createUserContextUpdateTool, type UserContextToolOptions, } from './user-context-tool.js';
 export { createKnowledgeSearchTool, createKnowledgeGetTool, createKnowledgeWriteTool, type KnowledgeToolOptions, } from './knowledge-memory-tool.js';
 export { createSessionSearchTool } from './session-search-tool.js';
 export { createSessionRecallTool, type SessionRecallToolDeps } from './session-recall-tool.js';

package/dist/src/agent/tools/index.js

@@ -8,7 +8,7 @@ import { createPublishArtifactsTool } from "./publish-artifacts.js";
 import { createExecCommandTool } from "./exec-command.js";
 import { fuzzyFindText, generateDiffString, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings, stripBom } from "./edit-diff.js";
 import { createApplyPatchTool } from "./apply-patch.js";
-import { createUserContextGetTool, createUserContextSearchTool } from "./user-context-tool.js";
+import { createUserContextGetTool, createUserContextSearchTool, createUserContextUpdateTool } from "./user-context-tool.js";
 import { createKnowledgeGetTool, createKnowledgeSearchTool, createKnowledgeWriteTool } from "./knowledge-memory-tool.js";
 import { createSessionSearchTool } from "./session-search-tool.js";
 import { createSessionRecallTool } from "./session-recall-tool.js";
@@ -43,4 +43,4 @@ import { createDesktopPetTool } from "./desktop-pet-tool.js";
 import { createManagedJobTool } from "./managed-job-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
-export { BrowserRuntime, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, createApplyPatchTool, createAutomationTool, createBrowserAutomationTool, createClarifyTool, createCreateShareTool, createDelegateTool, createDesktopPetTool, createExecCommandTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createKnowledgeGetTool, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMemoryMaintenanceTool, createMessageTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, createUserContextSearchTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserRuntime, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, createApplyPatchTool, createAutomationTool, createBrowserAutomationTool, createClarifyTool, createCreateShareTool, createDelegateTool, createDesktopPetTool, createExecCommandTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createKnowledgeGetTool, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMemoryMaintenanceTool, createMessageTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, createUserContextSearchTool, createUserContextUpdateTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };

package/dist/src/agent/tools/user-context-tool.d.ts

@@ -5,6 +5,9 @@ export interface UserContextToolOptions {
     getSessionId: () => string | undefined;
     getProjectId?: () => string | undefined;
     canRead: () => boolean;
+    canWrite?: () => boolean;
+    getCurrentUserText?: () => string | undefined;
 }
 export declare function createUserContextSearchTool(options: UserContextToolOptions): AgentTool;
 export declare function createUserContextGetTool(options: UserContextToolOptions): AgentTool;
+export declare function createUserContextUpdateTool(options: UserContextToolOptions): AgentTool;

package/dist/src/agent/tools/user-context-tool.js

@@ -1,5 +1,6 @@
 import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
-import { getAssertionSlot, getUserAssertion, listUserAssertions } from "../../user-model/repository.js";
+import { getAssertionSlot, getUserAssertion, listUserAssertions, reconcileAssertion, setAssertionStatus } from "../../user-model/repository.js";
+import { isWorkingAssumption } from "../../user-model/usage-policy.js";
 import "../../user-model/index.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/user-context-tool.ts
@@ -11,12 +12,27 @@ const SearchSchema = Type.Object({
 	}))
 });
 const GetSchema = Type.Object({ id: Type.String() });
+const UpdateSchema = Type.Object({
+	id: Type.String(),
+	action: Type.Union([
+		Type.Literal("confirm"),
+		Type.Literal("correct"),
+		Type.Literal("reject"),
+		Type.Literal("forget"),
+		Type.Literal("review")
+	]),
+	replacement: Type.Optional(Type.String({ maxLength: 500 })),
+	userEvidence: Type.String({
+		minLength: 1,
+		maxLength: 500
+	})
+});
 function visible(options, slotId) {
 	const scope = getAssertionSlot(slotId)?.scope;
 	return scope?.type === "global" || scope?.type === "agent" && scope.id === options.agentId || scope?.type === "workspace" && scope.id === options.workspaceId || scope?.type === "project" && scope.id === options.getProjectId?.() || scope?.type === "session" && scope.id === options.getSessionId();
 }
 function referenceable(assertion) {
-	return assertion.status === "active" && assertion.authority !== "external_untrusted" && assertion.sensitivity !== "secret" && assertion.sensitivity !== "regulated" && assertion.disclosurePolicy !== "ask_before_reference";
+	return (assertion.status === "active" || isWorkingAssumption(assertion)) && assertion.authority !== "external_untrusted" && assertion.sensitivity !== "secret" && assertion.sensitivity !== "regulated" && assertion.disclosurePolicy !== "ask_before_reference";
 }
 function createUserContextSearchTool(options) {
 	return {
@@ -34,7 +50,7 @@ function createUserContextSearchTool(options) {
 			};
 			const input = raw;
 			const results = listUserAssertions({
-				statuses: ["active"],
+				statuses: ["active", "candidate"],
 				limit: 1e3
 			}).filter((assertion) => visible(options, assertion.slotId)).filter(referenceable).map((assertion) => ({
 				assertion,
@@ -94,5 +110,132 @@ function createUserContextGetTool(options) {
 		}
 	};
 }
+function createUserContextUpdateTool(options) {
+	return {
+		name: "user_context_update",
+		label: "User Context Update",
+		description: "Confirm, correct, reject, forget, or flag an existing user assertion. Use only when the current user explicitly confirms or requests the change; userEvidence must quote that request.",
+		parameters: UpdateSchema,
+		async execute(_toolCallId, raw) {
+			if (!options.canRead() || !options.canWrite?.()) return {
+				content: [{
+					type: "text",
+					text: "User-context updates are disabled for this session."
+				}],
+				details: { error: "user_context_update_disabled" }
+			};
+			const input = raw;
+			const current = getUserAssertion(input.id);
+			const slot = current ? getAssertionSlot(current.slotId) : void 0;
+			if (!current || !slot || !visible(options, current.slotId)) return {
+				content: [{
+					type: "text",
+					text: `User assertion not found: ${input.id}`
+				}],
+				details: {
+					error: "assertion_not_found",
+					id: input.id
+				}
+			};
+			const evidence = input.userEvidence.trim();
+			if (!evidence) return {
+				content: [{
+					type: "text",
+					text: "A quote from the current user message is required."
+				}],
+				details: { error: "user_evidence_required" }
+			};
+			const currentUserText = options.getCurrentUserText?.();
+			if (options.getCurrentUserText && (!currentUserText || !currentUserText.includes(evidence))) return {
+				content: [{
+					type: "text",
+					text: "userEvidence must be an exact quote from the current user message."
+				}],
+				details: { error: "user_evidence_mismatch" }
+			};
+			try {
+				if (input.action === "correct") {
+					const replacement = input.replacement?.trim();
+					if (!replacement) return {
+						content: [{
+							type: "text",
+							text: "A replacement is required for correction."
+						}],
+						details: { error: "replacement_required" }
+					};
+					const receipt = {
+						action: "corrected",
+						assertion: reconcileAssertion({
+							subject: slot.subject,
+							predicate: slot.predicate,
+							cardinality: slot.cardinality,
+							scope: slot.scope,
+							kind: current.kind,
+							value: replacement,
+							normalizedValue: replacement.toLocaleLowerCase(),
+							statement: replacement,
+							authority: "user_explicit",
+							confidence: 1,
+							...current.declaredImportance === void 0 ? {} : { declaredImportance: current.declaredImportance },
+							inferredImportance: current.inferredImportance,
+							consequence: current.consequence,
+							actionability: current.actionability,
+							volatility: current.volatility,
+							sensitivity: current.sensitivity,
+							disclosurePolicy: current.disclosurePolicy,
+							applicability: current.applicability,
+							observedAt: Date.now(),
+							createdBy: "user",
+							correctionOfAssertionId: current.id
+						}).assertion,
+						previousAssertionId: current.id,
+						userEvidence: evidence
+					};
+					return {
+						content: [{
+							type: "text",
+							text: JSON.stringify(receipt, null, 2)
+						}],
+						details: receipt
+					};
+				}
+				const status = {
+					confirm: "active",
+					reject: "rejected",
+					forget: "archived",
+					review: "needs_review"
+				}[input.action];
+				const assertion = setAssertionStatus(current.id, status, {
+					actor: "user",
+					reason: `User requested ${input.action}: ${evidence}`
+				});
+				const receipt = {
+					action: input.action,
+					assertion,
+					userEvidence: evidence
+				};
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify(receipt, null, 2)
+					}],
+					details: receipt
+				};
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				return {
+					content: [{
+						type: "text",
+						text: message
+					}],
+					details: {
+						error: "user_context_update_failed",
+						message
+					}
+				};
+			}
+		}
+	};
+}
 //#endregion
-export { createUserContextGetTool, createUserContextSearchTool };
+export { createUserContextGetTool, createUserContextSearchTool, createUserContextUpdateTool };

package/dist/src/agent/tools/xopc-use-tool.js

@@ -9,12 +9,12 @@ import "../../storage/sqlite/index.js";
 import { ObjectLinkService } from "../../activity/service.js";
 import "../../activity/index.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { CreateAutomationSchema, UpdateAutomationSchema } from "../../automations/domain/validation.js";
-import "../../automations/index.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
 import { isValidProjectAgentId, normalizeProjectAgentId, resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
+import { CreateAutomationSchema, UpdateAutomationSchema } from "../../automations/domain/validation.js";
+import "../../automations/index.js";
 import { TaskContextRepository } from "../../tasks/task-context-repository.js";
 import { TaskDependencyError, TaskDependencyService } from "../../tasks/task-dependency-service.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";

package/dist/src/agent/workflow/catalog.js

@@ -2,7 +2,7 @@ import { requireXopcDatabase } from "../../storage/sqlite/connection.js";
 import { runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { DurableState } from "../../storage/sqlite/durable-state.js";
 import { buildWorkflowDefinition } from "../../workflows/domain/definition-utils.js";
-import { validateWorkflowGraph } from "../../workflows/domain/validation.js";
+import { validateWorkflowDefinitionInput } from "../../workflows/domain/validation.js";
 import { BUILTIN_WORKFLOWS } from "./builtins/index.js";
 //#region src/agent/workflow/catalog.ts
 const NAME_RE = /^[a-z][a-z0-9_-]*$/;
@@ -26,7 +26,11 @@ function createWorkflowCatalog() {
 	const save = (input) => {
 		const name = input.name.trim();
 		requireValidName(name);
-		const validation = validateWorkflowGraph(input.graph);
+		const validation = validateWorkflowDefinitionInput({
+			name,
+			graph: input.graph,
+			manifest: input.manifest
+		});
 		if (!validation.valid) throw new Error(validation.errors.map((issue) => issue.message).join(" "));
 		requireXopcDatabase();
 		return runSqliteWriteTransaction(() => {

package/dist/src/chat-commands/builtins/workflow.js

@@ -48,7 +48,7 @@ function formatWorkflowListContent(entries) {
 const workflowsCommand = {
 	id: "system.workflows",
 	name: "workflows",
-	description: "List saved workflows (built-in + ~/.xopc/workflows/)",
+	description: "List built-in and saved workflows",
 	category: "system",
 	scope: [
 		"global",

package/dist/src/connectors/connected-source-understanding.js

@@ -57,7 +57,7 @@ function connectedItemsForUnderstanding(items) {
 	});
 }
 function isPortraitCandidate(candidate) {
-	return candidate.category === "preference" || candidate.category === "routine";
+	return candidate.category === "preference" || candidate.category === "routine" || candidate.category === "communication";
 }
 function durableEvidence(candidate, items) {
 	const evidence = [...new Set(candidate.evidenceRefs ?? [])].flatMap((ref) => items.get(ref) ?? []);
@@ -120,7 +120,7 @@ async function deriveConnectedSourceUnderstanding(input) {
 						type: "agent",
 						id: input.agentId
 					},
-					kind: candidate.category,
+					kind: candidate.category === "communication" ? "preference" : candidate.category,
 					value: candidate.statement,
 					normalizedValue: candidate.statement.toLocaleLowerCase(),
 					statement: candidate.statement,
@@ -129,8 +129,8 @@ async function deriveConnectedSourceUnderstanding(input) {
 					inferredImportance: .65,
 					consequence: "medium",
 					actionability: .6,
-					volatility: candidate.category === "routine" ? "slow" : "stable",
-					sensitivity: "personal",
+					volatility: candidate.category === "routine" || candidate.category === "communication" ? "slow" : "stable",
+					sensitivity: "normal",
 					disclosurePolicy: "referenceable",
 					observedAt: evidenceItem.occurredAt ?? evidenceItem.modifiedAt ?? Date.now(),
 					createdBy: "connector",