@xopcai/xopc 0.0.427 → 0.0.430

package/dist/src/home-intelligence/generator.js

@@ -1,10 +1,13 @@
+import { HomeEvidenceGroupSchema } from "../../packages/gateway-contract/src/home.js";
+import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { resolveModelSelector } from "../config/agent-model-intents.js";
 import { init_providers, resolveModel } from "../providers/index.js";
-import { completeWithResolvedCredentials, isLocalModelBaseUrl } from "../providers/model-call.js";
 import { extractAssistantText, getAssistantMessageErrorReason } from "../providers/model-response.js";
+import { completeWithResolvedCredentials, isLocalModelBaseUrl } from "../providers/model-call.js";
+import { resolveModelSelector } from "../config/agent-model-intents.js";
 import { z } from "zod";
 //#region src/home-intelligence/generator.ts
+init_src();
 init_agent_scope();
 init_providers();
 const CapabilityRequestSchema = z.strictObject({
@@ -29,6 +32,7 @@ const HomeModelCandidateSchema = z.strictObject({
 	outcome: z.string().trim().min(1).max(1e3),
 	rationale: z.string().trim().min(1).max(1500),
 	evidenceIds: z.array(z.string().trim().min(1).max(300)).min(1).max(8),
+	evidenceGroups: z.array(HomeEvidenceGroupSchema).min(1).max(8).optional().catch(void 0),
 	confidence: z.enum([
 		"high",
 		"medium",
@@ -82,7 +86,8 @@ const HOME_MODEL_MACHINE_FIELDS = [
 	"requiredCapabilities must be an array of objects. Each object has exactly kind, capability, and required. kind must be \"connector\", \"skill\", or \"agent\". capability is a string and required is a boolean. Example: [{\"kind\":\"connector\",\"capability\":\"calendar.read\",\"required\":true}]. Use [] when none are needed.",
 	"evidenceIds, proposedSteps, and verification must be JSON arrays of strings. They must never be a single string.",
 	"A ready result may contain at most 5 candidates. Each evidenceIds array may contain at most 8 values, proposedSteps at most 6, and verification at most 8.",
-	"Do not add properties that are not shown in the result shapes."
+	"Do not add properties that are not shown in the result shapes.",
+	"Each ready candidate must also include evidenceGroups: [{\"summary\":\"localized factual summary\",\"evidenceIds\":[\"existing-evidence-id\"]}]. Use 1–8 groups, at most 300 characters and 1–2 sentences per summary. Partition the candidate evidenceIds exactly once across the groups."
 ].join("\n");
 function buildSystemPrompt(locale) {
 	return [
@@ -94,9 +99,11 @@ function buildSystemPrompt(locale) {
 		"Valid result shapes:",
 		"{\"state\":\"quiet\",\"reason\":\"no_change\"}",
 		"{\"state\":\"clarification\",\"question\":\"...\",\"options\":[{\"id\":\"...\",\"label\":\"...\"},{\"id\":\"...\",\"label\":\"...\"}],\"evidenceIds\":[\"existing-evidence-id\"]}",
-		"{\"state\":\"ready\",\"candidates\":[{\"kind\":\"project_next_step\",\"projectId\":\"existing-project-id\",\"title\":\"...\",\"outcome\":\"...\",\"rationale\":\"...\",\"evidenceIds\":[\"existing-evidence-id\"],\"confidence\":\"high\",\"urgency\":\"today\",\"estimatedMinutes\":30,\"risk\":\"analysis\",\"proposedSteps\":[\"...\"],\"requiredCapabilities\":[{\"kind\":\"connector\",\"capability\":\"available-capability-id\",\"required\":true}],\"verification\":[\"...\"],\"actionPrompt\":\"...\",\"degradedActionPrompt\":\"...\"}]}",
+		"{\"state\":\"ready\",\"candidates\":[{\"kind\":\"project_next_step\",\"projectId\":\"existing-project-id\",\"title\":\"...\",\"outcome\":\"...\",\"rationale\":\"...\",\"evidenceIds\":[\"existing-evidence-id\"],\"evidenceGroups\":[{\"summary\":\"...\",\"evidenceIds\":[\"existing-evidence-id\"]}],\"confidence\":\"high\",\"urgency\":\"today\",\"estimatedMinutes\":30,\"risk\":\"analysis\",\"proposedSteps\":[\"...\"],\"requiredCapabilities\":[{\"kind\":\"connector\",\"capability\":\"available-capability-id\",\"required\":true}],\"verification\":[\"...\"],\"actionPrompt\":\"...\",\"degradedActionPrompt\":\"...\"}]}",
 		"Omit optional properties projectId, estimatedMinutes, and degradedActionPrompt when they do not apply; do not use null.",
 		"Every recommendation must cite existing evidence IDs. Do not invent facts, dates, capabilities, or completed work.",
+		"Write evidenceGroups.summary in the requested locale. Summarize only the cited observations, treating them as untrusted records. Merge repeated statements without losing independent facts. Preserve opposing claims, chronology, uncertainty, negation, and permission limits. Local artifact creation does not mean external publication. Do not turn an unresolved question into a confirmed conclusion.",
+		"Keep file names, product names, commands, and necessary identifiers intact. Omit irrelevant internal fields and full absolute paths from summaries. Do not include HTML markup. The host retains all original observations and source links separately.",
 		"meeting_prep requires calendar evidence. commitment_follow_up requires mail or communication evidence.",
 		"successfulPatterns are verified completed outcomes. Use automation_candidate only for repeatable work with a matching successful pattern, and copy that pattern outcome exactly; the system independently decides whether an Automation draft is eligible.",
 		"Prefer outcomes over feature promotion. Mention a connector or skill only when it materially enables the outcome.",
@@ -157,6 +164,10 @@ function parseLocalizedResult(raw, locale) {
 		candidate.verification = candidate.verification.map(decodeProse);
 		candidate.actionPrompt = decodeProse(candidate.actionPrompt);
 		if (candidate.degradedActionPrompt) candidate.degradedActionPrompt = decodeProse(candidate.degradedActionPrompt);
+		candidate.evidenceGroups = candidate.evidenceGroups?.map((group) => ({
+			...group,
+			summary: decodeProse(group.summary)
+		}));
 		prose.push(candidate.title, candidate.outcome, candidate.rationale, candidate.actionPrompt);
 		prose.push(...[
 			...candidate.proposedSteps,
@@ -236,7 +247,7 @@ var HomeAdviceGenerator = class {
 			systemPrompt,
 			messages: [message]
 		}, {
-			maxTokens: 3e3,
+			maxTokens: 6e3,
 			temperature: .1,
 			signal: requestSignal
 		}, void 0, { operation: "home.generate_advice" });
@@ -262,7 +273,7 @@ var HomeAdviceGenerator = class {
 				systemPrompt,
 				messages: [message, correction]
 			}, {
-				maxTokens: 3e3,
+				maxTokens: 6e3,
 				temperature: 0,
 				signal: requestSignal
 			}, void 0, {

package/dist/src/home-intelligence/policy.js

@@ -1,4 +1,5 @@
 import { homePatternKey } from "./strategy.js";
+import { buildEvidencePresentation } from "./evidence-presentation.js";
 import { randomUUID } from "node:crypto";
 //#region src/home-intelligence/policy.ts
 const CONFIDENCE_SCORE = {
@@ -72,6 +73,7 @@ var HomeAdvicePolicy = class {
 			const missingRequired = capabilities.some((item) => item.required && item.readiness !== "ready");
 			const canStart = !missingRequired && candidate.risk !== "external_write";
 			const degradedStartAvailable = missingRequired && Boolean(candidate.degradedActionPrompt) && candidate.risk !== "external_write";
+			const evidencePresentation = buildEvidencePresentation(candidate.evidenceGroups, candidate.evidenceIds, evidence, snapshot.locale);
 			return [{
 				opportunity: {
 					id: randomUUID(),
@@ -82,6 +84,7 @@ var HomeAdvicePolicy = class {
 					outcome: candidate.outcome,
 					rationale: candidate.rationale,
 					evidence,
+					...evidencePresentation ? { evidencePresentation } : {},
 					confidence: candidate.confidence,
 					urgency: candidate.urgency,
 					estimatedMinutes: candidate.estimatedMinutes,

package/dist/src/imports/importService.js

@@ -11,8 +11,8 @@ import { scanLocal } from "./scanner.js";
 import { dirname, join } from "node:path";
 import { existsSync, lstatSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { randomUUID } from "node:crypto";
-import lockfile from "proper-lockfile";
 import yaml from "js-yaml";
+import lockfile from "proper-lockfile";
 //#region src/imports/importService.ts
 init_write_file_atomic();
 init_logger();

package/dist/src/imports/inventory.js

@@ -1,8 +1,8 @@
+import { ProjectService } from "../projects/project-service.js";
 import { init_paths, resolveSkillsDir } from "../config/paths.js";
+import { resolveWorkspaceSkillsDir } from "../agent/skills/workspace-skills-dir.js";
 import { listKnowledgeItems } from "../knowledge-memory/repository.js";
 import "../knowledge-memory/index.js";
-import { ProjectService } from "../projects/project-service.js";
-import { resolveWorkspaceSkillsDir } from "../agent/skills/workspace-skills-dir.js";
 import { ImportError } from "./types.js";
 import { digest } from "./files.js";
 import { canonicalTarget } from "./planner.js";

package/dist/src/imports/productImport.js

@@ -1,7 +1,7 @@
 import { resolveStateDir } from "../config/paths-state.js";
 import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import { init_paths } from "../config/paths.js";
 import { ProjectService } from "../projects/project-service.js";
+import { init_paths } from "../config/paths.js";
 import { ImportError } from "./types.js";
 import { digest, fileHash, readRegularFile, readTree } from "./files.js";
 import { importContextDocument } from "./contextImport.js";

package/dist/src/imports/runtime.js

@@ -1,6 +1,6 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { init_paths, resolveBundledSkillsDir, resolveSkillsDir } from "../config/paths.js";
 import { ProjectService } from "../projects/project-service.js";
+import { init_paths, resolveBundledSkillsDir, resolveSkillsDir } from "../config/paths.js";
 import { resolveWorkspaceSkillsDir } from "../agent/skills/workspace-skills-dir.js";
 import { loadSkills } from "../agent/skills/index.js";
 import { ProjectTrustStore } from "../project-trust/trust-store.js";

package/dist/src/infra/gateway-processes.js

@@ -1,11 +1,11 @@
 import { listPortListeners } from "../gateway/ports.js";
 import { isGatewayArgv, parseProcCmdline } from "./gateway-process-argv.js";
-import fs from "node:fs";
+import fsSync from "node:fs";
 import { spawnSync } from "node:child_process";
 //#region src/infra/gateway-processes.ts
 function readGatewayProcessArgsSync(pid) {
 	if (process.platform === "linux") try {
-		return parseProcCmdline(fs.readFileSync(`/proc/${pid}/cmdline`, "utf8"));
+		return parseProcCmdline(fsSync.readFileSync(`/proc/${pid}/cmdline`, "utf8"));
 	} catch {
 		return null;
 	}

package/dist/src/infra/path-env.js

@@ -1,7 +1,7 @@
 import { resolveBrewPathDirs } from "./brew.js";
 import os from "node:os";
 import path from "node:path";
-import fs from "node:fs";
+import fsSync from "node:fs";
 //#region src/infra/path-env.ts
 function isTruthyEnvValue(value) {
 	if (!value) return false;
@@ -10,7 +10,7 @@ function isTruthyEnvValue(value) {
 }
 function isExecutable(filePath) {
 	try {
-		fs.accessSync(filePath, fs.constants.X_OK);
+		fsSync.accessSync(filePath, fsSync.constants.X_OK);
 		return true;
 	} catch {
 		return false;
@@ -18,7 +18,7 @@ function isExecutable(filePath) {
 }
 function isDirectory(dirPath) {
 	try {
-		return fs.statSync(dirPath).isDirectory();
+		return fsSync.statSync(dirPath).isDirectory();
 	} catch {
 		return false;
 	}

package/dist/src/infra/update-global.js

@@ -4,8 +4,8 @@ import { readPackageVersion } from "./package-json.js";
 import { createDefaultCommandRunner } from "./run-command.js";
 import { verifyInstalledGatewayRuntime } from "./package-runtime-check.js";
 import path from "node:path";
-import fs from "node:fs";
-import fs$1 from "node:fs/promises";
+import fsSync from "node:fs";
+import fs from "node:fs/promises";
 //#region src/infra/update-global.ts
 const XOPC_PACKAGE_NAME = "@xopcai/xopc";
 const GLOBAL_RENAME_PREFIX = ".";
@@ -19,7 +19,7 @@ const NPM_GLOBAL_INSTALL_OMIT_OPTIONAL_FLAGS = ["--omit=optional", ...NPM_GLOBAL
 const GLOBAL_DETECT_TIMEOUT_MS = 15e3;
 async function pathExists(targetPath) {
 	try {
-		await fs$1.access(targetPath);
+		await fs.access(targetPath);
 		return true;
 	} catch {
 		return false;
@@ -27,7 +27,7 @@ async function pathExists(targetPath) {
 }
 async function tryRealpath(targetPath) {
 	try {
-		return await fs$1.realpath(targetPath);
+		return await fs.realpath(targetPath);
 	} catch {
 		return path.resolve(targetPath);
 	}
@@ -50,14 +50,14 @@ function resolvePreferredNpmCommand(pkgRoot) {
 	const prefix = inferNpmPrefixFromPackageRoot(pkgRoot);
 	if (!prefix) return null;
 	const candidate = process.platform === "win32" ? path.join(prefix, "npm.cmd") : path.join(prefix, "bin", "npm");
-	return fs.existsSync(candidate) ? candidate : null;
+	return fsSync.existsSync(candidate) ? candidate : null;
 }
 function resolveNpmFromExecPath() {
 	const execPath = process.execPath?.trim();
 	if (!execPath) return null;
 	const binDir = path.dirname(execPath);
 	const candidate = process.platform === "win32" ? path.join(binDir, "npm.cmd") : path.join(binDir, "npm");
-	return fs.existsSync(candidate) ? candidate : null;
+	return fsSync.existsSync(candidate) ? candidate : null;
 }
 function resolvePreferredGlobalManagerCommand(manager, pkgRoot) {
 	if (manager !== "npm") return manager;
@@ -206,7 +206,7 @@ async function cleanupGlobalRenameDirs(params) {
 	const prefix = `${GLOBAL_RENAME_PREFIX}${name}-`;
 	let entries = [];
 	try {
-		entries = await fs$1.readdir(root);
+		entries = await fs.readdir(root);
 	} catch {
 		return { removed };
 	}
@@ -214,8 +214,8 @@ async function cleanupGlobalRenameDirs(params) {
 		if (!entry.startsWith(prefix)) continue;
 		const target = path.join(root, entry);
 		try {
-			if (!(await fs$1.lstat(target)).isDirectory()) continue;
-			await fs$1.rm(target, {
+			if (!(await fs.lstat(target)).isDirectory()) continue;
+			await fs.rm(target, {
 				recursive: true,
 				force: true
 			});

package/dist/src/knowledge/connected-knowledge-pipeline.js

@@ -7,9 +7,9 @@ import { claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, pruneB
 import "../storage/sqlite/index.js";
 import { clearMemoryAudit } from "../user-context/memory-suppression.js";
 import { getActiveUnderstandingConsent } from "../user-context/sources/consent-repository.js";
+import { consentFilteredText } from "../user-context/sources/consent-fields.js";
 import { listKnowledgeItems, transitionKnowledgeStatus, writeKnowledgeItem } from "../knowledge-memory/repository.js";
 import "../knowledge-memory/index.js";
-import { consentFilteredText } from "../user-context/sources/consent-fields.js";
 import { randomUUID } from "node:crypto";
 //#region src/knowledge/connected-knowledge-pipeline.ts
 init_transaction();

package/dist/src/knowledge/index.js

@@ -1,5 +1,5 @@
-import { ConnectedKnowledgePipeline } from "./connected-knowledge-pipeline.js";
 import { KnowledgeIngestionService, SqliteKnowledgeSourceStateStore } from "./ingestion-service.js";
+import { ConnectedKnowledgePipeline } from "./connected-knowledge-pipeline.js";
 import { startConnectedKnowledgeCoordinator } from "./coordinator.js";
 import { LocalFolderKnowledgeSourceAdapter } from "./local-folder-adapter.js";
 export { ConnectedKnowledgePipeline, KnowledgeIngestionService, LocalFolderKnowledgeSourceAdapter, SqliteKnowledgeSourceStateStore, startConnectedKnowledgeCoordinator };

package/dist/src/knowledge-memory/repository.js

@@ -1,8 +1,8 @@
 import { init_search_text, memorySearchQuery } from "./search-text.js";
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { validateScope } from "../user-model/domain.js";
-import { inferMemorySensitivity } from "../agent/memory/sensitivity.js";
 import { clearMemoryAudit, isMemorySuppressed, memoryFingerprint, restoreMemory, suppressMemory } from "../user-context/memory-suppression.js";
+import { inferMemorySensitivity } from "../agent/memory/sensitivity.js";
 import { canUseKnowledge, knowledgeContentSources } from "./usage-policy.js";
 import { randomUUID } from "node:crypto";
 //#region src/knowledge-memory/repository.ts

package/dist/src/knowledge-memory/usage-policy.js

@@ -1,8 +1,8 @@
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_session_repository } from "../storage/sqlite/session-repository.js";
-import { isOwnerIdentity } from "../user-context/identity-bindings.js";
 import { getUnderstandingConsent } from "../user-context/sources/consent-repository.js";
+import { isOwnerIdentity } from "../user-context/identity-bindings.js";
 //#region src/knowledge-memory/usage-policy.ts
 init_transaction();
 init_session_repository();

package/dist/src/local-apps/service.js

@@ -5,11 +5,11 @@ import { init_logger } from "../utils/logger.js";
 import { afterSqliteCommit, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { ExtensionCapabilityBindingsSchema, extensionCapabilityPermissions } from "../../packages/gateway-contract/src/extension-capabilities.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { init_paths, resolveExtensionsDir } from "../config/paths.js";
-import { slugifyProjectName } from "../projects/project-store.js";
 import { CapabilityError } from "../capabilities/runtime/errors.js";
-import { LocalAppStore } from "./store.js";
+import { slugifyProjectName } from "../projects/project-store.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
+import { init_paths, resolveExtensionsDir } from "../config/paths.js";
+import { LocalAppStore } from "./store.js";
 import { validateLocalAppCapabilityContracts } from "./capabilities/contracts.js";
 import { buildLocalAppFixGuidance } from "./fix-guidance.js";
 import { readLocalAppAcceptanceConfig } from "./acceptance.js";

package/dist/src/mcp/gateway-http-client.js

@@ -2,8 +2,8 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { CapabilityErrorCodeSchema } from "../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { resolveGatewayLocalClientHost } from "../config/gateway-bind.js";
 import { loadConfig } from "../config/loader.js";
+import { resolveGatewayLocalClientHost } from "../config/gateway-bind.js";
 import { createGatewayCredential, gatewayCredentialAuthorization } from "../gateway/credential.js";
 import { fetch } from "undici";
 //#region src/mcp/gateway-http-client.ts

package/dist/src/media-understanding/openai-compatible-audio.js

@@ -1,6 +1,6 @@
-import { registerMediaUnderstandingProvider } from "./registry.js";
 import { normalizeBaseUrl, postMultipartRequest } from "../media-shared/http/provider-http.js";
 import "../media-shared/http/index.js";
+import { registerMediaUnderstandingProvider } from "./registry.js";
 import path from "node:path";
 //#region src/media-understanding/openai-compatible-audio.ts
 /**

package/dist/src/memory-learning/repository.d.ts

@@ -9,10 +9,15 @@ export interface LearningJob {
     lease_token: string;
     attempts: number;
     start_seq?: number | null;
+    extractor_version?: string;
 }
+export declare const PERSONAL_UNDERSTANDING_VERSION = "understanding-v3";
 export declare function learningPolicyHash(config: Config): string;
 /** Recover learning intent from authoritative rows, including notifications lost in a crash. */
-export declare function enqueueConversationLearning(config: Config, conversationId: string, workspaceId: string, force?: boolean, now?: number): string | undefined;
+export declare function enqueueConversationLearning(config: Config, conversationId: string, workspaceId: string, force?: boolean, now?: number, rebuild?: {
+    version: string;
+    transcriptId?: string;
+}): string | undefined;
 export declare function claimLearningJob(now?: number): LearningJob | undefined;
 export declare function renewLearningLease(job: LearningJob): boolean;
 /** Apply model results and advance progress atomically under the current lease. */

package/dist/src/memory-learning/repository.js

@@ -3,6 +3,7 @@ import { resolveUserContextSessionAccess } from "../user-context/access-policy.j
 import { createHash, randomUUID } from "node:crypto";
 //#region src/memory-learning/repository.ts
 init_transaction();
+const PERSONAL_UNDERSTANDING_VERSION = "understanding-v3";
 function learningPolicyHash(config) {
 	const catalog = getSqliteDatabase().prepare("SELECT revision FROM agent_catalog_settings WHERE singleton_id = 1").get();
 	return createHash("sha256").update(JSON.stringify({
@@ -11,14 +12,18 @@ function learningPolicyHash(config) {
 	})).digest("hex");
 }
 /** Recover learning intent from authoritative rows, including notifications lost in a crash. */
-function enqueueConversationLearning(config, conversationId, workspaceId, force = false, now = Date.now()) {
+function enqueueConversationLearning(config, conversationId, workspaceId, force = false, now = Date.now(), rebuild) {
 	const access = resolveUserContextSessionAccess(config, conversationId);
 	if ((!access.userModel || config.userContext.userModel.writePolicy === "deny") && (!access.knowledge || config.userContext.knowledgeMemory.writePolicy === "deny")) return;
 	const idleMs = config.userContext.knowledgeMemory.learning?.idleFlushMs ?? 6e4;
 	return runSqliteWriteTransaction((db) => {
 		const transcript = db.prepare("SELECT active_transcript_id FROM sessions WHERE conversation_id = ?").get(conversationId);
 		if (!transcript?.active_transcript_id) return;
-		const id = transcript.active_transcript_id;
+		const id = rebuild?.transcriptId ?? transcript.active_transcript_id;
+		if (!db.prepare("SELECT 1 FROM transcripts WHERE transcript_id = ? AND conversation_id = ?").get(id, conversationId)) return;
+		if (rebuild && (!access.userModel || config.userContext.userModel.writePolicy !== "allow")) return;
+		if (rebuild && db.prepare(`SELECT 1 FROM memory_learning_jobs
+      WHERE conversation_id = ? AND transcript_id = ? AND extractor_version = ? AND policy_hash = ?`).get(conversationId, id, rebuild.version, learningPolicyHash(config))) return;
 		const last = db.prepare(`SELECT MAX(seq) AS seq, MAX(created_at) AS last_at FROM transcript_entries
       WHERE transcript_id = ? AND role = 'assistant'`).get(id);
 		if (!last.seq) return;
@@ -30,7 +35,7 @@ function enqueueConversationLearning(config, conversationId, workspaceId, force
 		const jobId = randomUUID();
 		const inserted = db.prepare(`INSERT OR IGNORE INTO memory_learning_jobs(job_id, conversation_id, transcript_id,
       through_seq, start_seq, extractor_version, policy_hash, workspace_id, state, next_attempt_at, created_at, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'queued', ?, ?, ?)`).run(jobId, conversationId, id, last.seq, force ? 0 : null, force ? `rebuild:${jobId}` : `2:${cursor.processed_seq}`, learningPolicyHash(config), workspaceId, due ? now : (last.last_at ?? now) + idleMs, now, now);
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'queued', ?, ?, ?)`).run(jobId, conversationId, id, last.seq, force ? 0 : null, rebuild?.version ?? (force ? `3:rebuild:${jobId}` : `3:${cursor.processed_seq}`), learningPolicyHash(config), workspaceId, due ? now : (last.last_at ?? now) + idleMs, now, now);
 		db.prepare(`UPDATE memory_learning_cursors SET observed_seq = MAX(observed_seq, ?), updated_at = ?
       WHERE conversation_id = ? AND transcript_id = ?`).run(last.seq, now, conversationId, id);
 		return inserted.changes ? jobId : void 0;
@@ -74,7 +79,7 @@ function finishLearningJob(job, apply, processedThrough = job.through_seq) {
 			const nextId = randomUUID();
 			db.prepare(`INSERT INTO memory_learning_jobs(job_id, conversation_id, transcript_id, through_seq,
         start_seq, extractor_version, policy_hash, workspace_id, state, next_attempt_at, created_at, updated_at)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'queued', ?, ?, ?)`).run(nextId, job.conversation_id, job.transcript_id, job.through_seq, job.start_seq == null ? null : processedThrough, job.start_seq == null ? `2:${processedThrough}` : `rebuild:${nextId}`, job.policy_hash, job.workspace_id, Date.now(), Date.now(), Date.now());
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'queued', ?, ?, ?)`).run(nextId, job.conversation_id, job.transcript_id, job.through_seq, job.start_seq == null ? null : processedThrough, job.extractor_version?.startsWith("understanding-") ? `${job.extractor_version.split(":")[0]}:${processedThrough}` : job.start_seq == null ? `3:${processedThrough}` : `3:rebuild:${nextId}`, job.policy_hash, job.workspace_id, Date.now(), Date.now(), Date.now());
 		}
 		return true;
 	});
@@ -93,4 +98,4 @@ function learningStatus(config) {
 	};
 }
 //#endregion
-export { claimLearningJob, enqueueConversationLearning, failLearningJob, finishLearningJob, learningPolicyHash, learningStatus, renewLearningLease };
+export { PERSONAL_UNDERSTANDING_VERSION, claimLearningJob, enqueueConversationLearning, failLearningJob, finishLearningJob, learningPolicyHash, learningStatus, renewLearningLease };

package/dist/src/memory-learning/service.js

@@ -3,7 +3,7 @@ import { init_logger } from "../utils/logger.js";
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
 import "../storage/sqlite/index.js";
-import { claimLearningJob, enqueueConversationLearning, failLearningJob, renewLearningLease } from "./repository.js";
+import { PERSONAL_UNDERSTANDING_VERSION, claimLearningJob, enqueueConversationLearning, failLearningJob, learningPolicyHash, renewLearningLease } from "./repository.js";
 import { learnTaskReceipts } from "./task-receipts.js";
 import { pruneSourceRetention, recoverKnowledgeIndexes, recoverSourceLearning, runSourceLearning } from "./source-learning.js";
 //#region src/memory-learning/service.ts
@@ -55,6 +55,28 @@ var MemoryLearningService = class {
         ORDER BY COALESCE((SELECT MAX(j.updated_at) FROM memory_learning_jobs j
           WHERE j.conversation_id = s.conversation_id), 0), s.updated_at DESC LIMIT 200`).all(Date.now() - 30 * 864e5);
 			for (const session of sessions) enqueueConversationLearning(config, session.conversation_id, this.options.workspaceForSession(session.conversation_id));
+			if (config.userContext.enabled && config.userContext.userModel.enabled && config.userContext.userModel.writePolicy === "allow") {
+				const historical = getSqliteDatabase().prepare(`SELECT s.conversation_id, c.transcript_id FROM sessions s
+          JOIN memory_learning_cursors c ON c.conversation_id = s.conversation_id
+          LEFT JOIN session_config cfg ON cfg.conversation_id = s.conversation_id
+          WHERE c.processed_seq > 0 AND COALESCE(cfg.user_context_mode, 'enabled') = 'enabled'
+          AND json_extract(s.routing_json, '$.peerKind') = 'direct'
+          AND (json_extract(s.routing_json, '$.source') IN ('webchat','cli','tui') OR EXISTS (
+            SELECT 1 FROM owner_identity_bindings b WHERE b.revoked_at IS NULL
+            AND b.channel = json_extract(s.routing_json, '$.source')
+            AND b.account_id = json_extract(s.routing_json, '$.accountId')
+            AND b.peer_id = json_extract(s.routing_json, '$.peerId')))
+          AND EXISTS (SELECT 1 FROM memory_learning_jobs old WHERE old.conversation_id = s.conversation_id
+            AND old.transcript_id = c.transcript_id AND old.state = 'succeeded'
+            AND (old.extractor_version LIKE '2:%' OR old.extractor_version LIKE 'rebuild:%'))
+          AND NOT EXISTS (SELECT 1 FROM memory_learning_jobs j WHERE j.conversation_id = s.conversation_id
+            AND j.transcript_id = c.transcript_id AND j.extractor_version = ? AND (j.state = 'succeeded' OR j.policy_hash = ?))
+          ORDER BY s.updated_at DESC LIMIT 3`).all(PERSONAL_UNDERSTANDING_VERSION, learningPolicyHash(config));
+				for (const session of historical) enqueueConversationLearning(config, session.conversation_id, this.options.workspaceForSession(session.conversation_id), true, Date.now(), {
+					version: PERSONAL_UNDERSTANDING_VERSION,
+					transcriptId: session.transcript_id
+				});
+			}
 			const dayStart = Date.now() - Date.now() % 864e5;
 			const batches = getSqliteDatabase().prepare(`SELECT COUNT(*) AS n FROM context_extraction_runs
         WHERE extractor_id IN ('transcript-synthesis', 'source-work-synthesis') AND started_at >= ?`).get(dayStart);

package/dist/src/memory-learning/source-learning.js

@@ -2,16 +2,16 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { claimContextExtractionRun, finishContextExtractionRun } from "../storage/sqlite/context-extraction-repository.js";
-import { init_config, resolveKnowledgeReadPolicy } from "../user-context/config.js";
-import { learningPolicyHash } from "./repository.js";
 import { getActiveUnderstandingConsent, getUnderstandingConsent } from "../user-context/sources/consent-repository.js";
-import { resolveModelSelector } from "../config/agent-model-intents.js";
+import { init_config, resolveKnowledgeReadPolicy } from "../user-context/config.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
-import { isLoopbackModel } from "../providers/local-model.js";
-import { ConnectedKnowledgePipeline } from "../knowledge/connected-knowledge-pipeline.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
+import { resolveModelSelector } from "../config/agent-model-intents.js";
+import { ConnectedKnowledgePipeline } from "../knowledge/connected-knowledge-pipeline.js";
 import { extractionInputHash } from "../user-context/extraction/registry.js";
+import { learningPolicyHash } from "./repository.js";
+import { isLoopbackModel } from "../providers/local-model.js";
 import { WorkCandidateSchema } from "./work-candidate.js";
 import { applyWorkCandidates } from "./work-capture.js";
 import { randomUUID } from "node:crypto";

package/dist/src/memory-learning/task-receipts.js

@@ -2,10 +2,10 @@ import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "
 import { createContextEvidence } from "../storage/sqlite/context-evidence-repository.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_session_repository } from "../storage/sqlite/session-repository.js";
-import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
 import { inferMemorySensitivity } from "../agent/memory/sensitivity.js";
 import { writeKnowledgeItem } from "../knowledge-memory/repository.js";
 import "../knowledge-memory/index.js";
+import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
 import { createHash } from "node:crypto";
 //#region src/memory-learning/task-receipts.ts
 init_session_repository();

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

@@ -1,12 +1,12 @@
 import { getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "../storage/sqlite/note-agent-context-repository.js";
 import "../storage/sqlite/index.js";
-import { extractDocumentText } from "../document-understanding/extract.js";
-import { resolveImageModelConfigForTool } from "../agent/image/tool-model-config.js";
-import { describeImagesWithFallback } from "../agent/image/understanding/runtime.js";
-import { transcribe } from "../voice/stt/transcribe-core.js";
 import { isSTTAvailable } from "../voice/stt/availability.js";
+import { transcribe } from "../voice/stt/transcribe-core.js";
 import { mergeSttConfigFromAppConfig } from "../voice/stt/config.js";
 import "../voice/stt/index.js";
+import { extractDocumentText } from "../document-understanding/extract.js";
+import { resolveImageModelConfigForTool } from "../agent/image/tool-model-config.js";
+import { describeImagesWithFallback } from "../agent/image/understanding/runtime.js";
 import { extname } from "node:path";
 import { readFile } from "node:fs/promises";
 //#region src/notes/agent-context.ts

package/dist/src/notes/index.js

@@ -1,5 +1,5 @@
-import { buildNoteAgentContext, buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact } from "./agent-context.js";
 import { resolveNoteMediaDir, resolveNotesDir } from "./paths.js";
 import { NotesStore } from "./store.js";
+import { buildNoteAgentContext, buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact } from "./agent-context.js";
 import { NotesService } from "./service.js";
 export { NotesService, NotesStore, buildNoteAgentContext, buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact, resolveNoteMediaDir, resolveNotesDir };

package/dist/src/notes/service.js

@@ -6,13 +6,13 @@ import { buildNoteAttachmentRef } from "./attachment-ref.js";
 import { parseNoteMarkdown } from "./note-markdown.js";
 import { listNoteProjectSummaries } from "../storage/sqlite/notes-repository.js";
 import { changedFieldsFromPatch, emitActivity, previewText, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
+import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
+import { revokeNoteShareRecords } from "../share/note-share-revocation.js";
+import { NotesStore } from "./store.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { partitionAttachmentsByReference } from "./note-attachment-sync.js";
 import { buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact } from "./agent-context.js";
-import { revokeNoteShareRecords } from "../share/note-share-revocation.js";
-import { NotesStore } from "./store.js";
-import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/notes/service.ts
 init_providers();

package/dist/src/observability/runtime.d.ts

@@ -55,3 +55,5 @@ export declare function testLangfuse(): Promise<boolean>;
 export declare function closeTracing(): Promise<void>;
 export declare function traceOperation<T>(name: string, fn: () => Promise<T>, attributes?: Attributes): Promise<T>;
 export declare function setTraceIdentity(identity: TraceIdentity): void;
+/** Keep the first timing for each milestone on the run root, including fallback runs. */
+export declare function recordTraceLatency(metrics: Record<string, number>): void;

package/dist/src/observability/runtime.js

@@ -400,5 +400,16 @@ function setTraceIdentity(identity) {
 	};
 	scope.root?.setAttributes(attrs(scope.identity, "agent"));
 }
+/** Keep the first timing for each milestone on the run root, including fallback runs. */
+function recordTraceLatency(metrics) {
+	const scope = scopes.getStore();
+	if (!scope?.root) return;
+	scope.metrics ??= /* @__PURE__ */ new Set();
+	for (const [name, value] of Object.entries(metrics)) {
+		if (!Number.isFinite(value) || value < 0 || scope.metrics.has(name)) continue;
+		scope.root.setAttribute(`xopc.latency.${name}`, value);
+		scope.metrics.add(name);
+	}
+}
 //#endregion
-export { closeTracing, configureTracing, flushTracing, localStore, setTraceIdentity, startObservation, testLangfuse, traceIds, traceOperation, traceRun, traceTools, tracingConfig, tracingStatus };
+export { closeTracing, configureTracing, flushTracing, localStore, recordTraceLatency, setTraceIdentity, startObservation, testLangfuse, traceIds, traceOperation, traceRun, traceTools, tracingConfig, tracingStatus };

package/dist/src/personal-agent/capability-service.js

@@ -1,10 +1,10 @@
 import { getConnectorInstallation, init_connector_repository, listConnectorConnections } from "../storage/sqlite/connector-repository.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { isPersonalConversation } from "./repository.js";
 import { canAccessConnectorAccount, currentAccountConnections } from "../connectors/account-access.js";
 import { connectorPrincipalForSession } from "../connectors/principal.js";
-import { connectionCandidates, resolveConnectionCandidate } from "../connectors/connection-candidates.js";
+import { isPersonalConversation } from "./repository.js";
 import { assessSpecialist } from "../agent-matching/service.js";
+import { connectionCandidates, resolveConnectionCandidate } from "../connectors/connection-candidates.js";
 //#region src/personal-agent/capability-service.ts
 init_repository();
 init_connector_repository();

package/dist/src/personal-agent/proactivity/routes.js

@@ -1,7 +1,7 @@
 import { PersonalFeedbackSchema, PersonalProactivitySettingsSchema, PersonalStrategyRollbackSchema } from "../../../packages/gateway-contract/src/personal-proactivity.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { getPersonalAgent } from "../repository.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { getProactivitySettings, listInterestCandidates, patchAttention, patchProactivitySettings, provenanceDetail, recordFeedback, rollbackStrategy, strategyState } from "./repository.js";
 import { z } from "zod";
 //#region src/personal-agent/proactivity/routes.ts

package/dist/src/personal-agent/proactivity/service.js

@@ -6,16 +6,16 @@ import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-repository.js";
 import { appendTranscriptEntry } from "../../storage/sqlite/transcript-repository.js";
 import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
-import { init_providers, resolveModel } from "../../providers/index.js";
-import { completeWithResolvedCredentials } from "../../providers/model-call.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
-import { getPersonalAgent } from "../repository.js";
 import { emitSessionTranscriptUpdate } from "../../session/transcript-events.js";
+import { getPersonalAgent } from "../repository.js";
 import { DurableState } from "../../storage/sqlite/durable-state.js";
-import { enqueueDue, enqueueWakeup, getAttention, getAttentionSources, getProactivitySettings, isQuiet, listAttention, localDay, preparationStrategy, recordFeedback, reserveModelCall, saveAttention, sourceFingerprint, userText } from "./repository.js";
-import { PERSONAL_PERSONA_GUIDANCE } from "../persona.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
+import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { personalConversationState } from "../conversation-state.js";
+import { PERSONAL_PERSONA_GUIDANCE } from "../persona.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { enqueueDue, enqueueWakeup, getAttention, getAttentionSources, getProactivitySettings, isQuiet, listAttention, localDay, preparationStrategy, recordFeedback, reserveModelCall, saveAttention, sourceFingerprint, userText } from "./repository.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 //#region src/personal-agent/proactivity/service.ts