@xopcai/xopc 0.0.254 → 0.0.256

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/create-share-tool.js

@@ -6,6 +6,7 @@ import { mergeWithDefaults } from "../../share/site-share-config.js";
 import { getShareStore } from "../../share/share-store.js";
 import { getSiteShareStore } from "../../share/site-share-store.js";
 import { resolveShareUrl, resolveSiteShareUrl } from "../../share/share-url.js";
+import { publishHostedStaticSite } from "../../share/hosted-static-site-publish.js";
 import { resolveReverseProxyPublicUrl } from "../../gateway/public-url.js";
 import { audienceDefaults, decideShareKind, makeDescription, makeTitle, probeShareTarget, rememberStagedSite, stageSingleHtmlAsSite } from "../../share/share-auto.js";
 import { scheduleThumbnail } from "../../share/share-thumbnail.js";
@@ -110,6 +111,44 @@ function createCreateShareTool(deps) {
 					const siteStore = getSiteShareStore(siteCfg);
 					let sitePath = relPath;
 					let stagedDir = null;
+					const titleOut = makeTitle(probe.kind === "directory" ? relPath.split("/").pop() || relPath : probe.absolutePath.split(/[\\/]/).pop() || relPath, p.title);
+					if (resolveSiteShareUrl({
+						...urlCtx,
+						token: "reachability-check",
+						subdomainLabel: "reachability-check",
+						publicHostSuffix: siteCfg.publicHostSuffix
+					}).reachability !== "public") {
+						const { binding } = await publishHostedStaticSite({
+							workspaceRoot: workspace,
+							path: sitePath,
+							title: titleOut,
+							description: p.description,
+							spaFallback: true,
+							ttlMs,
+							maxViews: maxViews ?? null,
+							agentId: deps.getAgentId?.()
+						});
+						return successResult(locale, {
+							kind: "site",
+							delivery: "hosted",
+							shareUrl: binding.shareUrl,
+							thumbnailUrl: "",
+							reachability: "public",
+							reachabilityHint: null,
+							title: binding.title,
+							description: makeDescription({
+								audience,
+								expiresAt: binding.expiresAt,
+								override: p.description
+							}),
+							expiresAt: binding.expiresAt,
+							maxViews: binding.maxViews,
+							routing: {
+								reason: decision.reason,
+								hint: decision.hint
+							}
+						});
+					}
 					if (probe.kind === "file") {
 						const staged = await stageSingleHtmlAsSite(workspace, probe.absolutePath);
 						sitePath = staged.relativePath;
@@ -142,7 +181,6 @@ function createCreateShareTool(deps) {
 						internalBaseUrl: shareCfg.thumbnail.internalGatewayUrl ?? `http://127.0.0.1:${gatewayPort}`
 					});
 					siteStore.setThumbnailStatus(siteRec.id, "pending");
-					const titleOut = makeTitle(probe.kind === "directory" ? relPath.split("/").pop() || relPath : probe.absolutePath.split(/[\\/]/).pop() || relPath, p.title);
 					const descOut = makeDescription({
 						audience,
 						expiresAt: siteRec.expiresAt,

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/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/cli/commands/tunnel.js

@@ -2,12 +2,12 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { loadConfig, saveConfig } from "../../config/loader.js";
 import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
-import { loadTunnelState } from "../../tunnel/tunnel-state.js";
-import { formatExamples, register } from "../registry.js";
-import "../../config/index.js";
 import { ensureFrpcBinary } from "../../tunnel/frpc-binary.js";
 import { resolveTunnelBrokerUrl, resolveTunnelRegistrationSecret } from "../../tunnel/env.js";
+import { loadTunnelState } from "../../tunnel/tunnel-state.js";
 import { getTunnelService } from "../../tunnel/tunnel-service.js";
+import { formatExamples, register } from "../registry.js";
+import "../../config/index.js";
 import { TUNNEL_RISK_SUMMARY_LINES, TunnelConsentError, assertTunnelMayStart, hasValidTunnelConsent } from "../../tunnel/consent.js";
 import { resolveFrpSubdomainHost } from "../../tunnel/frp-subdomain-host.js";
 import { applyTunnelConsentToConfig, mergeTunnelConfigPatch, setTunnelEnabledInConfig } from "../../tunnel/tunnel-config.js";

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",

package/dist/src/gateway/agent-builtin-tools.d.ts

@@ -174,6 +174,12 @@ export declare const GATEWAY_BUILTIN_TOOLS: readonly [{
         readonly en: "Read a typed user assertion.";
         readonly zh: "读取一条结构化用户事实。";
     };
+}, {
+    readonly id: "user_context_update";
+    readonly description: {
+        readonly en: "Apply an explicit user correction to an existing assertion.";
+        readonly zh: "根据用户明确表达修正已有用户理解。";
+    };
 }, {
     readonly id: "knowledge_search";
     readonly description: {
@@ -265,4 +271,4 @@ export declare const GATEWAY_BUILTIN_TOOLS: readonly [{
         readonly zh: "使用已验证的参数执行选定的外部工具。";
     };
 }];
-export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "workflow" | "find" | "image" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "todo" | "clarify" | "web_extract" | "image_generate" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "xopc_tool_search" | "xopc_tool_describe" | "xopc_tool_execute" | "user_context_search" | "user_context_get" | "knowledge_search" | "knowledge_get" | "knowledge_write" | "send_message" | "send_media" | "read_media" | "create_share" | "session_status" | "memory_maintenance" | "tool_manual" | "delegate_task" | "skill_install" | "text_to_speech" | "execute_code" | "create_desktop_pet")[];
+export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "workflow" | "find" | "image" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "todo" | "clarify" | "web_extract" | "image_generate" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "xopc_tool_search" | "xopc_tool_describe" | "xopc_tool_execute" | "user_context_search" | "user_context_get" | "user_context_update" | "knowledge_search" | "knowledge_get" | "knowledge_write" | "send_message" | "send_media" | "read_media" | "create_share" | "session_status" | "memory_maintenance" | "tool_manual" | "delegate_task" | "skill_install" | "text_to_speech" | "execute_code" | "create_desktop_pet")[];

package/dist/src/gateway/agent-builtin-tools.js

@@ -199,6 +199,13 @@ const GATEWAY_BUILTIN_TOOLS = [
 			zh: "读取一条结构化用户事实。"
 		}
 	},
+	{
+		id: "user_context_update",
+		description: {
+			en: "Apply an explicit user correction to an existing assertion.",
+			zh: "根据用户明确表达修正已有用户理解。"
+		}
+	},
 	{
 		id: "knowledge_search",
 		description: {

package/dist/src/gateway/device-routes.js

@@ -1,6 +1,6 @@
+import { getTunnelService } from "../tunnel/tunnel-service.js";
 import { resolveReverseProxyPublicUrl } from "./public-url.js";
 import { getTailscaleExposureState } from "./tailscale-lifecycle.js";
-import { getTunnelService } from "../tunnel/tunnel-service.js";
 import crypto from "node:crypto";
 //#region src/gateway/device-routes.ts
 function secureUrl(value) {

package/dist/src/gateway/hono/lib/config-payload.js

@@ -8,10 +8,10 @@ import { getProviderRegistry, init_plugin_registry } from "../../../providers/pl
 import { getAllProviders, init_providers, isProviderConfigured } from "../../../providers/index.js";
 import { normalizeConfiguredMcpServers } from "../../../config/mcp-config-normalize.js";
 import { resolveShareConfig } from "../../../share/share-config.js";
+import { maskTunnelSecretForWeb } from "../../../tunnel/env.js";
 import { resolveSessionConfigForWeb, resolveUpdateConfigForWeb } from "../../../config/web-patch.js";
 import { GENERIC_MASKED_SECRET, maskSecretLength } from "./mask-secret-length.js";
 import { safeToolsWebForGet } from "../../config-tools-web.js";
-import { maskTunnelSecretForWeb } from "../../../tunnel/env.js";
 import { buildSafeProvidersConfigForWeb } from "./safe-providers-config.js";
 import { maskRealtimeVoiceConfigForWeb, maskSttConfigForWeb, maskTtsConfigForWeb } from "./safe-voice-config.js";
 //#region src/gateway/hono/lib/config-payload.ts