@xopcai/xopc 0.0.336 → 0.0.338

package/dist/src/agent/source-context/user-assertion-context.js

@@ -0,0 +1,30 @@
+import { getAssertionSlot, getUserAssertion, listUserAssertionSources } from "../../user-model/repository.js";
+import { canUseAssertion } from "../../user-model/usage-policy.js";
+import "../../user-model/index.js";
+//#region src/agent/source-context/user-assertion-context.ts
+function buildUserAssertionAgentContext(assertionId, expectedVersion, agentId) {
+	const assertion = getUserAssertion(assertionId);
+	const slot = assertion ? getAssertionSlot(assertion.slotId) : void 0;
+	if (!assertion || !slot || slot.scope.type !== "global" || expectedVersion && expectedVersion !== String(assertion.recordedAt) || !canUseAssertion(assertion, Date.now(), {
+		use: "answer",
+		agentId
+	})) return null;
+	const sources = listUserAssertionSources([assertion.id]).get(assertion.id) ?? [];
+	return {
+		kind: "user_assertion",
+		sourceId: assertion.id,
+		version: String(assertion.recordedAt),
+		title: assertion.statement,
+		text: JSON.stringify({
+			id: assertion.id,
+			statement: assertion.statement,
+			predicate: slot.predicate,
+			scope: slot.scope,
+			status: assertion.status,
+			authority: assertion.authority,
+			sources
+		}, null, 2)
+	};
+}
+//#endregion
+export { buildUserAssertionAgentContext };

package/dist/src/cli/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { version } from "../../package.js";
-import { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
 import { isHelpOrVersionInvocation } from "./argv.js";
 import { ROOT_COMMAND_DESCRIPTION } from "./command-manifest.js";
 import { loadAllCommands, resolveCommandName, tryLoadCommand } from "./command-loaders.js";
 import { getContextWithOpts, parsedOpts } from "./context.js";
+import { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
 import { Command } from "commander";
 //#region src/cli/index.ts
 /** Command wiring and `program.parse`; executable entry is `bin.ts` (log preset before logger init). */

package/dist/src/gateway/hono/routes/session-input-handler.d.ts

@@ -73,7 +73,7 @@ export declare function submitSessionInput(c: Context, deps: AuthenticatedRouteD
                 }[];
                 contextSnapshots?: {
                     refId?: string;
-                    kind: import("../../../agent/source-context/types.js").SessionSourceBinding["kind"] | "task" | "file" | "session" | "mcp_resource" | "browser_tab" | "browser_page" | "app_context";
+                    kind: import("../../../agent/source-context/types.js").SessionSourceBinding["kind"] | "task" | "file" | "session" | "mcp_resource" | "browser_tab" | "browser_page" | "app_context" | "user_assertion";
                     sourceId: string;
                     version: string;
                     title: string;
@@ -217,7 +217,7 @@ export declare function replaceLatestSessionTurn(c: Context, deps: Authenticated
                 }[];
                 contextSnapshots?: {
                     refId?: string;
-                    kind: import("../../../agent/source-context/types.js").SessionSourceBinding["kind"] | "task" | "file" | "session" | "mcp_resource" | "browser_tab" | "browser_page" | "app_context";
+                    kind: import("../../../agent/source-context/types.js").SessionSourceBinding["kind"] | "task" | "file" | "session" | "mcp_resource" | "browser_tab" | "browser_page" | "app_context" | "user_assertion";
                     sourceId: string;
                     version: string;
                     title: string;

package/dist/src/gateway/hono/routes/sessions.js

@@ -358,6 +358,13 @@ function registerSessionsRoutes(authenticated, deps) {
 	});
 	authenticated.get("/api/sessions/:key/agent-config", async (c) => {
 		const key = c.req.param("key");
+		if (!await service.sessions.getSession(key)) return c.json({
+			ok: false,
+			error: {
+				code: "NOT_FOUND",
+				message: "Session not found"
+			}
+		}, 404);
 		const payload = await service.sessions.getFixedAgentConfig(key);
 		return c.json({
 			ok: true,

package/dist/src/gateway/hono/routes/user-model.js

@@ -116,6 +116,19 @@ const RULE_STATUSES = new Set([
 	"disabled",
 	"archived"
 ]);
+const MOBILE_PROFILE_PREDICATES = new Set([
+	"identity.call_name",
+	"identity.role",
+	"identity.pronouns",
+	"preference.timezone",
+	"preference.locale"
+]);
+const MOBILE_ASSERTION_FILTERS = new Set([
+	"all",
+	"explicit",
+	"learned",
+	"review"
+]);
 function assertionView(assertion, sources = listUserAssertionSources([assertion.id]).get(assertion.id) ?? []) {
 	const slot = getAssertionSlot(assertion.slotId);
 	if (!slot) throw new Error(`Assertion slot not found: ${assertion.slotId}`);
@@ -131,6 +144,70 @@ function assertionView(assertion, sources = listUserAssertionSources([assertion.
 		})
 	};
 }
+function mobileAssertionView(assertion, sources = listUserAssertionSources([assertion.id]).get(assertion.id) ?? []) {
+	const view = assertionView(assertion, sources);
+	return {
+		id: view.id,
+		predicate: view.predicate,
+		statement: view.statement,
+		kind: view.kind,
+		status: view.status,
+		authority: view.authority,
+		usable: view.usable,
+		confidence: view.confidence,
+		volatility: view.volatility,
+		layer: view.layer,
+		independentSourceCount: view.independentSourceCount,
+		observedAt: view.observedAt,
+		recordedAt: view.recordedAt,
+		...view.validTo === void 0 ? {} : { validTo: view.validTo },
+		scope: view.scope,
+		sources: view.sources
+	};
+}
+function isMobileAssertion(item, filter) {
+	if (item.scope.type !== "global" || MOBILE_PROFILE_PREDICATES.has(item.predicate)) return false;
+	if (filter === "review") return item.status === "needs_review" || item.status === "conflicted";
+	if (!item.usable) return false;
+	if (filter === "explicit") return item.authority === "user_explicit";
+	if (filter === "learned") return item.authority !== "user_explicit";
+	return true;
+}
+function normalizeMobileSearch(value, maxLength) {
+	const normalized = (value ?? "").normalize("NFKC").trim().toLocaleLowerCase();
+	return maxLength === void 0 ? normalized : normalized.slice(0, maxLength);
+}
+function matchesMobileSearch(item, query) {
+	if (!query) return true;
+	const statusAliases = item.status === "needs_review" || item.status === "conflicted" ? "needs review review 待确认 需要确认" : item.status;
+	const authorityAliases = item.authority === "user_explicit" ? "explicit user said 你明确说过 用户明确" : "learned inferred 逐渐学到 系统推断";
+	return normalizeMobileSearch([
+		item.statement,
+		item.predicate,
+		item.kind,
+		statusAliases,
+		authorityAliases,
+		item.scope.type,
+		item.scope.id ?? "",
+		...item.sources.flatMap((source) => [
+			source.label ?? "",
+			source.kind,
+			source.category ?? ""
+		])
+	].join(" ")).includes(query);
+}
+function encodeMobileCursor(item) {
+	return Buffer.from(JSON.stringify([item.recordedAt, item.id])).toString("base64url");
+}
+function decodeMobileCursor(value) {
+	if (!value) return void 0;
+	try {
+		const parsed = JSON.parse(Buffer.from(value, "base64url").toString("utf8"));
+		return Array.isArray(parsed) && typeof parsed[0] === "number" && typeof parsed[1] === "string" ? [parsed[0], parsed[1]] : void 0;
+	} catch {
+		return;
+	}
+}
 function registerUserModelRoutes(authenticated, deps) {
 	const write = deps.strictRateLimitMiddleware;
 	authenticated.get("/api/user-model", (c) => {
@@ -184,6 +261,78 @@ function registerUserModelRoutes(authenticated, deps) {
 			}
 		});
 	});
+	authenticated.get("/api/user-model/mobile-summary", (c) => {
+		const rawAssertions = listUserAssertions({
+			statuses: [
+				"active",
+				"candidate",
+				"needs_review",
+				"conflicted",
+				"stale"
+			],
+			limit: 2e3
+		});
+		const sourceMap = listUserAssertionSources(rawAssertions.map((item) => item.id));
+		const items = rawAssertions.map((item) => mobileAssertionView(item, sourceMap.get(item.id) ?? []));
+		const visible = items.filter((item) => isMobileAssertion(item, "all"));
+		const review = items.filter((item) => isMobileAssertion(item, "review"));
+		const profile = getUserProfileSnapshot();
+		const goals = listUserGoals();
+		const now = Date.now();
+		const primary = listPriorityWindows().filter((item) => item.status === "active" && item.rank === "primary" && item.validTo >= now).sort((left, right) => (right.declaredImportance ?? right.urgency) - (left.declaredImportance ?? left.urgency))[0];
+		const primaryGoal = primary?.targetType === "goal" ? goals.find((goal) => goal.id === primary.targetId) : void 0;
+		const primaryTitle = primaryGoal?.title ?? (primary && !/^[0-9a-f]{8}-[0-9a-f-]{20,}$/i.test(primary.targetId) ? primary.targetId : void 0);
+		const mobileGoals = goals.filter((goal) => goal.status === "active" || goal.status === "paused" || goal.status === "proposed").sort((left, right) => {
+			if (left.id === primaryGoal?.id) return -1;
+			if (right.id === primaryGoal?.id) return 1;
+			if (left.status === "active" && right.status !== "active") return -1;
+			if (right.status === "active" && left.status !== "active") return 1;
+			return (left.targetAt ?? Number.MAX_SAFE_INTEGER) - (right.targetAt ?? Number.MAX_SAFE_INTEGER) || right.updatedAt - left.updatedAt;
+		}).slice(0, 5).map((goal) => ({
+			id: goal.id,
+			title: goal.title,
+			desiredOutcome: goal.desiredOutcome,
+			status: goal.status,
+			...goal.targetAt === void 0 ? {} : { targetAt: goal.targetAt },
+			updatedAt: goal.updatedAt,
+			isPrimary: goal.id === primaryGoal?.id
+		}));
+		const result = {
+			profile: {
+				callName: profile.callName ?? "",
+				role: profile.role ?? "",
+				pronouns: profile.pronouns ?? "",
+				timezone: profile.timezone ?? "",
+				locale: profile.locale ?? ""
+			},
+			suggestedCallName: profile.callName || machineCallName(),
+			counts: {
+				total: visible.length,
+				explicit: visible.filter((item) => item.authority === "user_explicit").length,
+				learned: visible.filter((item) => item.authority !== "user_explicit").length,
+				review: review.length,
+				workMemory: listKnowledgeItems({
+					statuses: ["active"],
+					recordClass: "memory",
+					limit: 2e3
+				}).length
+			},
+			...primary && primaryTitle ? { primaryFocus: {
+				id: primary.id,
+				title: primaryTitle,
+				...primaryGoal?.desiredOutcome ? { desiredOutcome: primaryGoal.desiredOutcome } : {},
+				validTo: primary.validTo
+			} } : {},
+			goals: mobileGoals,
+			recent: [...visible].sort((left, right) => right.recordedAt - left.recordedAt).slice(0, 3),
+			rules: listCollaborationRules().filter((rule) => rule.status === "active").slice(0, 3).map((rule) => ({
+				id: rule.id,
+				statement: rule.statement,
+				category: rule.category
+			}))
+		};
+		return c.json(result);
+	});
 	authenticated.patch("/api/user-model/profile", write, async (c) => {
 		const input = await body(c);
 		if (!input) return c.json({ error: "A profile patch is required" }, 400);
@@ -224,6 +373,34 @@ function registerUserModelRoutes(authenticated, deps) {
 		}
 	});
 	authenticated.get("/api/user-model/assertions", (c) => {
+		if (c.req.query("view") === "mobile") {
+			const filter = c.req.query("filter") ?? "all";
+			if (!MOBILE_ASSERTION_FILTERS.has(filter)) return c.json({ error: "Invalid mobile assertion filter" }, 400);
+			const requestedLimit = Number(c.req.query("limit") ?? 20);
+			const limit = Number.isFinite(requestedLimit) ? Math.max(1, Math.min(50, Math.trunc(requestedLimit))) : 20;
+			const query = normalizeMobileSearch(c.req.query("q"), 100);
+			const cursorValue = c.req.query("cursor");
+			const cursor = decodeMobileCursor(cursorValue);
+			if (cursorValue && !cursor) return c.json({ error: "Invalid cursor" }, 400);
+			const assertions = listUserAssertions({
+				statuses: [
+					"active",
+					"candidate",
+					"needs_review",
+					"conflicted",
+					"stale"
+				],
+				limit: 2e3
+			});
+			const sourceMap = listUserAssertionSources(assertions.map((item) => item.id));
+			const filtered = assertions.map((item) => mobileAssertionView(item, sourceMap.get(item.id) ?? [])).filter((item) => isMobileAssertion(item, filter)).filter((item) => matchesMobileSearch(item, query)).sort((left, right) => right.recordedAt - left.recordedAt || right.id.localeCompare(left.id)).filter((item) => !cursor || item.recordedAt < cursor[0] || item.recordedAt === cursor[0] && item.id.localeCompare(cursor[1]) < 0);
+			const items = filtered.slice(0, limit);
+			const result = {
+				items,
+				...filtered.length > limit && items.length ? { nextCursor: encodeMobileCursor(items[items.length - 1]) } : {}
+			};
+			return c.json(result);
+		}
 		const requested = c.req.query("status")?.split(",").filter(Boolean);
 		if (requested?.some((status) => !ASSERTION_STATUSES.has(status))) return c.json({ error: "Invalid assertion status" }, 400);
 		const assertions = listUserAssertions({
@@ -363,6 +540,31 @@ function registerUserModelRoutes(authenticated, deps) {
 		const goal = setUserGoalStatus(c.req.param("id"), status);
 		return goal ? c.json({ goal }) : c.json({ error: "Goal not found" }, 404);
 	});
+	authenticated.patch("/api/user-model/goals/:id", write, async (c) => {
+		const input = await body(c);
+		const current = listUserGoals().find((goal) => goal.id === c.req.param("id"));
+		if (!current) return c.json({ error: "Goal not found" }, 404);
+		if (!input) return c.json({ error: "A goal patch is required" }, 400);
+		const title = Object.hasOwn(input, "title") ? input.title : current.title;
+		const desiredOutcome = Object.hasOwn(input, "desiredOutcome") ? input.desiredOutcome : current.desiredOutcome;
+		const rawTargetAt = Object.hasOwn(input, "targetAt") ? input.targetAt : current.targetAt;
+		const status = Object.hasOwn(input, "status") ? input.status : current.status;
+		if (typeof title !== "string" || typeof desiredOutcome !== "string" || rawTargetAt !== void 0 && rawTargetAt !== null && typeof rawTargetAt !== "number" || typeof status !== "string" || !GOAL_STATUSES.has(status)) return c.json({ error: "Goal patch fields have invalid types" }, 400);
+		const targetAt = typeof rawTargetAt === "number" ? rawTargetAt : rawTargetAt === null ? null : void 0;
+		try {
+			const goal = runSqliteWriteTransaction(() => {
+				const updated = updateUserGoal(current.id, {
+					title,
+					desiredOutcome,
+					...targetAt === void 0 ? {} : { targetAt }
+				});
+				return status === current.status ? updated : setUserGoalStatus(current.id, status);
+			});
+			return c.json({ goal });
+		} catch (error) {
+			return c.json({ error: errorMessage(error) }, 400);
+		}
+	});
 	authenticated.get("/api/user-model/rules", (c) => c.json({ rules: listCollaborationRules() }));
 	authenticated.post("/api/user-model/rules", write, async (c) => {
 		const input = await body(c);

package/dist/src/gateway/run-loop.js

@@ -1,7 +1,7 @@
 import { acquireGatewayLock } from "./lock.js";
 import { loadConfig } from "../config/loader.js";
-import { runBootstrapMigrationsSync } from "../migrations/runner.js";
 import "../config/index.js";
+import { runBootstrapMigrationsSync } from "../migrations/runner.js";
 import { isRestartEnabled } from "../config/commands.flags.js";
 import { restartGatewayProcessWithFreshPid } from "./respawn.js";
 import { consumeGatewayRestartIntentSync, consumeGatewaySigusr1RestartAuthorization, isGatewaySigusr1RestartExternallyAllowed, resetGatewayRestartStateForInProcessRestart, scheduleGatewaySigusr1Restart, setGatewaySigusr1RestartPolicy } from "../infra/restart.js";

package/dist/src/gateway/security/gateway-scopes.js

@@ -35,6 +35,9 @@ function requiredGatewayScope(method, path) {
 	if (path === "/api/voice/selection" || path === "/api/voice/catalog/refresh") return "voice.configure";
 	if (path.startsWith("/api/voice") || path.startsWith("/api/media") || path.startsWith("/api/clarifications")) return "sessions.write";
 	if (path.startsWith("/api/commands") || path.startsWith("/api/skills")) return methodScope(method, "agents.read", "gateway.admin");
+	if (path === "/api/user-model/refresh" || path.startsWith("/api/user-model/refresh/")) return "gateway.admin";
+	if (path === "/api/user-model" || path.startsWith("/api/user-model/")) return methodScope(method, "workspace.read", "workspace.write");
+	if (path === "/api/knowledge-memory" || path.startsWith("/api/knowledge-memory/")) return methodScope(method, "workspace.read", "workspace.write");
 	if (path === "/api/discussions" || path.startsWith("/api/discussions/") || path === "/api/discussion-capture/settings" || path.startsWith("/api/workspace") || path.startsWith("/api/files") || path.startsWith("/api/projects") || path.startsWith("/api/notes") || path.startsWith("/api/shares")) return methodScope(method, "workspace.read", "workspace.write");
 	return "gateway.admin";
 }

package/dist/src/gateway/service/session-input-coordinator.js

@@ -26,7 +26,7 @@ function sameAppContext(input, existing) {
 	return isDeepStrictEqual(identity(input.sourceContexts), identity(existing.contextSnapshots));
 }
 function contextRefsMatchFrozenSnapshot(requested, frozen) {
-	const editable = frozen?.filter((ref) => ref.kind === "note" || ref.kind === "task" || ref.kind === "file" || ref.kind === "session" || ref.kind === "browser_tab" || ref.kind === "mcp_resource") ?? [];
+	const editable = frozen?.filter((ref) => ref.kind === "note" || ref.kind === "task" || ref.kind === "file" || ref.kind === "session" || ref.kind === "browser_tab" || ref.kind === "mcp_resource" || ref.kind === "user_assertion") ?? [];
 	if (requested.length !== editable.length) return false;
 	return requested.every((ref, index) => {
 		const snapshot = editable[index];

package/dist/src/gateway/service.js

@@ -65,7 +65,6 @@ import { MessageBus, MessageBusShutdownError } from "../infra/bus/queue.js";
 import "../infra/bus/index.js";
 import { collectMediaUrisFromMessages, deleteMediaUris } from "../media/session-references.js";
 import { AgentService } from "../agent/service.js";
-import { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
 import { setPairingBroadcastSink } from "../channels/pairing/pairing-events.js";
 import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
 import { ChannelManager } from "../channels/manager.js";
@@ -73,6 +72,7 @@ import { ChatPreviewService } from "../chat-previews/service.js";
 import "../chat-previews/index.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
+import { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
 import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
 import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
 import "../knowledge/index.js";
@@ -98,6 +98,7 @@ import { buildFileAgentContext } from "../agent/source-context/file-context.js";
 import { buildSessionAgentContext } from "../agent/source-context/session-context.js";
 import { buildMcpResourceAgentContext } from "../agent/source-context/mcp-resource-context.js";
 import { buildBrowserTabAgentContext } from "../agent/source-context/browser-tab.js";
+import { buildUserAssertionAgentContext } from "../agent/source-context/user-assertion-context.js";
 import { WorkDiscoveryService } from "../work-discovery/service.js";
 import { buildVoiceMemoryContext } from "../voice/realtime/memory-context.js";
 import { buildVoicePersonaContext } from "../voice/realtime/persona-context.js";
@@ -504,6 +505,10 @@ var GatewayService = class {
 			getConfig: () => this.config,
 			resolveTurnContext: async (ref, conversationId) => {
 				if (ref.kind === "task") return buildTaskAgentContext(new TaskRepository().get(ref.sourceId), ref.expectedVersion);
+				if (ref.kind === "user_assertion") {
+					const metadata = await this.sessionIndex.getSessionMetadata(conversationId);
+					return buildUserAssertionAgentContext(ref.sourceId, ref.expectedVersion, metadata?.agentId);
+				}
 				if (ref.kind === "file") {
 					const files = getGatewayFileSpaceService(this);
 					const space = await files.forContext("session", conversationId).catch(() => null);

package/dist/src/user-model/goals.d.ts

@@ -50,7 +50,7 @@ export declare function setUserGoalStatus(id: string, status: UserGoalStatus, no
 export declare function updateUserGoal(id: string, input: {
     title: string;
     desiredOutcome: string;
-    targetAt?: number;
+    targetAt?: number | null;
 }, now?: number): UserGoal | undefined;
 export declare function listPriorityWindows(principalId?: string): UserPriorityWindow[];
 export declare function createPriorityWindow(input: {

package/dist/src/user-model/goals.js

@@ -65,8 +65,9 @@ function updateUserGoal(id, input, now = Date.now()) {
 		db.prepare(`INSERT INTO user_goal_revisions (
       revision_id, goal_id, title, desired_outcome, created_by, change_reason, created_at
     ) VALUES (?, ?, ?, ?, 'user', 'Goal edited by user.', ?)`).run(revisionId, id, title, desiredOutcome, now);
+		const targetAt = input.targetAt === void 0 ? current.targetAt ?? null : input.targetAt;
 		db.prepare(`UPDATE user_goals SET current_revision_id = ?, target_at = ?, updated_at = ?
-      WHERE goal_id = ?`).run(revisionId, input.targetAt ?? current.targetAt ?? null, now, id);
+      WHERE goal_id = ?`).run(revisionId, targetAt, now, id);
 	});
 	return listUserGoals().find((goal) => goal.id === id);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.336",
+  "version": "0.0.338",
   "description": "Local-first personal AI for the one-person company, with durable context, tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -159,11 +159,11 @@
     "vitest": "4.1.5",
     "vue": "^3.5.35",
     "@xopcai/browser-control-contract": "0.1.0",
-    "@xopcai/endpoint-tools-client": "0.0.0",
     "@xopcai/computer-control-contract": "0.1.0",
+    "@xopcai/endpoint-tools-client": "0.0.0",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
-    "@xopcai/realtime-client": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
+    "@xopcai/realtime-client": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0"
   },
   "scripts": {