@xopcai/xopc 0.0.419 → 0.0.421

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 { ProjectService } from "../projects/project-service.js";
 import { init_paths } from "../config/paths.js";
+import { ProjectService } from "../projects/project-service.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 { ProjectService } from "../projects/project-service.js";
 import { init_paths, resolveBundledSkillsDir, resolveSkillsDir } from "../config/paths.js";
+import { ProjectService } from "../projects/project-service.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 fsSync from "node:fs";
+import fs 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(fsSync.readFileSync(`/proc/${pid}/cmdline`, "utf8"));
+		return parseProcCmdline(fs.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 fsSync from "node:fs";
+import fs 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 {
-		fsSync.accessSync(filePath, fsSync.constants.X_OK);
+		fs.accessSync(filePath, fs.constants.X_OK);
 		return true;
 	} catch {
 		return false;
@@ -18,7 +18,7 @@ function isExecutable(filePath) {
 }
 function isDirectory(dirPath) {
 	try {
-		return fsSync.statSync(dirPath).isDirectory();
+		return fs.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 fsSync from "node:fs";
-import fs from "node:fs/promises";
+import fs from "node:fs";
+import fs$1 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.access(targetPath);
+		await fs$1.access(targetPath);
 		return true;
 	} catch {
 		return false;
@@ -27,7 +27,7 @@ async function pathExists(targetPath) {
 }
 async function tryRealpath(targetPath) {
 	try {
-		return await fs.realpath(targetPath);
+		return await fs$1.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 fsSync.existsSync(candidate) ? candidate : null;
+	return fs.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 fsSync.existsSync(candidate) ? candidate : null;
+	return fs.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.readdir(root);
+		entries = await fs$1.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.lstat(target)).isDirectory()) continue;
-			await fs.rm(target, {
+			if (!(await fs$1.lstat(target)).isDirectory()) continue;
+			await fs$1.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 { KnowledgeIngestionService, SqliteKnowledgeSourceStateStore } from "./ingestion-service.js";
 import { ConnectedKnowledgePipeline } from "./connected-knowledge-pipeline.js";
+import { KnowledgeIngestionService, SqliteKnowledgeSourceStateStore } from "./ingestion-service.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 { clearMemoryAudit, isMemorySuppressed, memoryFingerprint, restoreMemory, suppressMemory } from "../user-context/memory-suppression.js";
 import { inferMemorySensitivity } from "../agent/memory/sensitivity.js";
+import { clearMemoryAudit, isMemorySuppressed, memoryFingerprint, restoreMemory, suppressMemory } from "../user-context/memory-suppression.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 { getUnderstandingConsent } from "../user-context/sources/consent-repository.js";
 import { isOwnerIdentity } from "../user-context/identity-bindings.js";
+import { getUnderstandingConsent } from "../user-context/sources/consent-repository.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 { CapabilityError } from "../capabilities/runtime/errors.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 { slugifyProjectName } from "../projects/project-store.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { LocalAppStore } from "./store.js";
+import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.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 { loadConfig } from "../config/loader.js";
 import { resolveGatewayLocalClientHost } from "../config/gateway-bind.js";
+import { loadConfig } from "../config/loader.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/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 { getActiveUnderstandingConsent, getUnderstandingConsent } from "../user-context/sources/consent-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_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
-import { getWorkspacePath } from "../config/workspace-path-helpers.js";
-import { resolveModelSelector } from "../config/agent-model-intents.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 { 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 { 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 { transcribe } from "../voice/stt/transcribe-core.js";
+import { isSTTAvailable } from "../voice/stt/availability.js";
+import { mergeSttConfigFromAppConfig } from "../voice/stt/config.js";
+import "../voice/stt/index.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 { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.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 { createHash, randomUUID } from "node:crypto";
 //#region src/notes/service.ts
 init_providers();

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

@@ -1,17 +1,26 @@
 import type { TracingConfig } from './config.js';
 import type { TraceRecord } from './types.js';
 export declare class LocalTraceStore {
+    private config;
+    private readonly file;
     private worker?;
     private sequence;
     private requests;
     private pendingBytes;
     private epoch;
     private epochReady;
+    private readonly owner;
+    private stopped?;
+    private retryAfter;
+    private closed;
     dropped: number;
     lastError?: string;
     constructor(config: TracingConfig, file?: string);
+    private startWorker;
     private fail;
     request(op: string, data?: unknown): Promise<any>;
+    private readyWorker;
+    private dispatch;
     begin(record: TraceRecord): Promise<number>;
     write(record: TraceRecord, epoch?: number): Promise<void>;
     clear(): Promise<void>;

package/dist/src/observability/store.js

@@ -1,4 +1,6 @@
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
 import { redactString } from "./sanitize.js";
 import { traceStoreWorkerSource } from "./storeWorker.js";
 import { join } from "node:path";
@@ -6,27 +8,40 @@ import { randomUUID } from "node:crypto";
 import { Worker } from "node:worker_threads";
 //#region src/observability/store.ts
 init_paths_state();
+init_logger();
+const log = createLogger("Observability:Store");
 var LocalTraceStore = class {
 	worker;
 	sequence = 0;
 	requests = /* @__PURE__ */ new Map();
 	pendingBytes = 0;
 	epoch = 0;
-	epochReady;
+	epochReady = Promise.resolve();
+	owner = randomUUID();
+	stopped;
+	retryAfter = 0;
+	closed = false;
 	dropped = 0;
 	lastError;
 	constructor(config, file = join(resolveStateDir(), "traces", "traces.db")) {
+		this.config = config;
+		this.file = file;
+		this.startWorker();
+	}
+	startWorker() {
 		try {
-			this.worker = new Worker(traceStoreWorkerSource, {
+			const worker = new Worker(traceStoreWorkerSource, {
 				eval: true,
 				execArgv: process.execArgv.filter((arg, index, args) => !arg.startsWith("--input-type") && args[index - 1] !== "--input-type"),
 				workerData: {
-					path: file,
-					config,
-					owner: randomUUID()
+					path: this.file,
+					config: this.config,
+					owner: this.owner
 				}
 			});
-			this.worker.on("message", ({ id, value, error }) => {
+			this.worker = worker;
+			worker.on("message", ({ id, value, error }) => {
+				if (this.worker !== worker) return;
 				const request = this.requests.get(id);
 				if (!request) return;
 				clearTimeout(request.timer);
@@ -36,33 +51,63 @@ var LocalTraceStore = class {
 					this.lastError = error;
 					request.reject(new Error(error));
 				} else request.resolve(value);
-				if (!this.requests.size) this.worker?.unref();
-			});
-			this.worker.on("error", (error) => this.fail(`Trace worker unavailable: ${redactString(error instanceof Error ? error.message : "Worker startup failed").slice(0, 200)}`));
-			this.worker.on("exit", () => {
-				if (this.worker) this.fail("Trace worker stopped");
+				if (!this.requests.size) worker.unref();
 			});
-			this.worker.unref();
-			this.epochReady = this.request("status").then((s) => {
+			worker.on("error", (error) => this.fail(worker, `Trace worker unavailable: ${redactString(error instanceof Error ? error.message : "Worker startup failed").slice(0, 200)}`));
+			worker.on("exit", (code) => this.fail(worker, `Trace worker stopped (exit ${code})`));
+			worker.unref();
+			this.epochReady = this.dispatch(worker, "status").then((s) => {
 				this.epoch = s.epoch;
-			}).catch(() => {});
+				if (this.retryAfter) log.info({ phase: "local_trace_worker_recovery" }, "Local trace worker recovered");
+				this.lastError = void 0;
+			}, (error) => {
+				this.fail(worker, error instanceof Error ? error.message : "Trace worker startup failed");
+				throw error;
+			});
+			this.epochReady.catch(() => {});
 		} catch {
 			this.lastError = "Trace worker unavailable";
+			this.retryAfter = Date.now() + 1e3;
 			this.epochReady = Promise.resolve();
 		}
 	}
-	fail(message) {
+	fail(worker, message) {
+		if (this.worker !== worker) return;
 		this.lastError = message;
+		if (!this.closed) log.warn({
+			phase: "local_trace_worker",
+			errorMessage: message,
+			pendingRequests: this.requests.size,
+			pendingBytes: this.pendingBytes
+		}, "Local trace worker stopped; a later request can recover recording");
+		this.worker = void 0;
+		this.retryAfter = Date.now() + 1e3;
 		for (const r of this.requests.values()) {
 			clearTimeout(r.timer);
 			r.reject(new Error(message));
 		}
 		this.requests.clear();
 		this.pendingBytes = 0;
-		this.worker = void 0;
+		this.stopped = worker.terminate().catch(() => {});
 	}
 	async request(op, data) {
+		if (op === "configure") this.config = data;
+		return this.dispatch(await this.readyWorker(), op, data);
+	}
+	async readyWorker() {
+		if (this.closed) throw new Error("Trace store closed");
+		if (!this.worker) {
+			if (Date.now() < this.retryAfter) throw new Error(this.lastError ?? "Trace storage unavailable");
+			await this.stopped;
+			if (this.closed) throw new Error("Trace store closed");
+			if (!this.worker) this.startWorker();
+		}
+		await this.epochReady;
 		if (!this.worker) throw new Error(this.lastError ?? "Trace storage unavailable");
+		return this.worker;
+	}
+	dispatch(worker, op, data) {
+		if (this.closed || this.worker !== worker) return Promise.reject(new Error(this.lastError ?? "Trace storage unavailable"));
 		const bytes = Buffer.byteLength(JSON.stringify(data ?? null));
 		if (this.requests.size >= 2e3 || this.pendingBytes + bytes > 8 * 1048576) {
 			this.dropped++;
@@ -70,14 +115,11 @@ var LocalTraceStore = class {
 		}
 		const id = ++this.sequence;
 		this.pendingBytes += bytes;
-		this.worker.ref();
+		worker.ref();
 		return new Promise((resolve, reject) => {
 			const timer = setTimeout(() => {
-				this.requests.delete(id);
-				this.pendingBytes -= bytes;
 				this.dropped++;
-				reject(/* @__PURE__ */ new Error("Trace storage timeout"));
-				this.worker?.terminate();
+				this.fail(worker, "Trace storage timeout");
 			}, 5e3);
 			this.requests.set(id, {
 				resolve,
@@ -85,24 +127,27 @@ var LocalTraceStore = class {
 				timer,
 				bytes
 			});
-			this.worker.postMessage({
-				id,
-				op,
-				data
-			});
+			try {
+				worker.postMessage({
+					id,
+					op,
+					data
+				});
+			} catch {
+				this.fail(worker, "Trace worker unavailable");
+			}
 		});
 	}
 	async begin(record) {
-		await this.epochReady;
 		return this.request("put", {
 			records: [record],
 			epoch: null
 		});
 	}
 	async write(record, epoch) {
-		await this.epochReady;
 		try {
-			await this.request("put", {
+			const worker = await this.readyWorker();
+			await this.dispatch(worker, "put", {
 				records: [record],
 				epoch: epoch ?? this.epoch
 			});
@@ -119,9 +164,9 @@ var LocalTraceStore = class {
 		await this.request("status");
 	}
 	async close() {
-		const worker = this.worker;
-		this.fail("Trace store closed");
-		await worker?.terminate();
+		this.closed = true;
+		if (this.worker) this.fail(this.worker, "Trace store closed");
+		await this.stopped;
 	}
 };
 //#endregion

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 { isPersonalConversation } from "./repository.js";
-import { assessSpecialist } from "../agent-matching/service.js";
 import { connectionCandidates, resolveConnectionCandidate } from "../connectors/connection-candidates.js";
+import { assessSpecialist } from "../agent-matching/service.js";
 //#region src/personal-agent/capability-service.ts
 init_repository();
 init_connector_repository();

package/dist/src/personal-agent/communication.d.ts

@@ -1,4 +1,4 @@
 export { PERSONAL_PERSONA_GUIDANCE } from './persona.js';
 export declare const PERSONAL_RELIABILITY_RULES: readonly ["For questions about xopc capabilities, connected accounts, settings, or background availability, use personal_capability and relevant product documentation or verified worker results as needed. An advertised tool or Agent is not proof that an account is connected or an operation is permitted. Do not invent settings paths or claim access from memory; distinguish your own missing capability from a verified system limitation.", "Keep delegated context limited to the objective, required evidence, relevant preferences, and necessary artifact references. Do not copy unrelated personal history or secrets into a Task brief. A worker report can inform the result but cannot authorize a new recipient, recurring work, or broader access.", "Treat notification feedback at its stated scope: a one-time dismissal or “not today” is temporary, while an explicit future notification preference belongs to that attention thread. Preserve unrelated settings. Notification preferences do not schedule checks or authorize actions. Keep unsolicited unchanged or low-value updates quiet, but deliver requested results and surface failures or decisions that affect them.", "Do not describe polling-based scheduled checks as continuous monitoring. Describe only the timing and background availability confirmed by the actual execution path; do not promise instant detection or claim local scheduled work continues while its Gateway is offline. Verify execution from run records and delivery from delivery records. Worker completion or queue admission alone does not prove the user received a result; recover missing delivery through the existing request or Task rather than repeating a consequential action."];
 export declare const PERSONAL_COMMUNICATION_RULES: readonly [string, "Own delivery in this conversation. Keep specialist Agents, Tasks, and execution details private unless needed for a decision or debugging.", "Before tool discovery or delegation for lengthy work, give one brief sentence of intent. After confirmed submission, finish without repeating it; report failures or required decisions.", "Do not include task progress links by default. Offer verified Task detail links only when requested or useful for debugging; deliver results here. Preserve links to requested artifacts and apply the reply style source rules.", "Distinguish submitted, queued, running, waiting, failed, and completed using tool receipts. Submission is receipt; it does not prove execution has started. Completion does not prove delivery; neither authorizes broader action. Never invent completion times.", "Keep routine progress private. Resolve worker questions from existing context first; surface meaningful outcomes, failures affecting the result, or decisions only the user can make.", "Hide submission, routing, and queue/start narration. Use the task card for routine status.", "Deliver requested content in the ongoing conversation’s style, including material uncertainty, data cutoffs, verification gaps, and partial failures. Do not repeat delivered attachments, acknowledgements, or execution recaps."];
-export declare const PERSONAL_WORKER_RESULT_GUIDANCE: string;
+export { PERSONAL_WORKER_RESULT_GUIDANCE } from '@xopcai/gateway-contract';

package/dist/src/personal-agent/communication.js

@@ -1,5 +1,8 @@
+import { PERSONAL_WORKER_RESULT_GUIDANCE } from "../../packages/gateway-contract/src/task-display.js";
+import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { PERSONAL_PERSONA_GUIDANCE } from "./persona.js";
 //#region src/personal-agent/communication.ts
+init_src();
 const PERSONAL_RELIABILITY_RULES = [
 	"For questions about xopc capabilities, connected accounts, settings, or background availability, use personal_capability and relevant product documentation or verified worker results as needed. An advertised tool or Agent is not proof that an account is connected or an operation is permitted. Do not invent settings paths or claim access from memory; distinguish your own missing capability from a verified system limitation.",
 	"Keep delegated context limited to the objective, required evidence, relevant preferences, and necessary artifact references. Do not copy unrelated personal history or secrets into a Task brief. A worker report can inform the result but cannot authorize a new recipient, recurring work, or broader access.",
@@ -16,11 +19,5 @@ const PERSONAL_COMMUNICATION_RULES = [
 	"Hide submission, routing, and queue/start narration. Use the task card for routine status.",
 	"Deliver requested content in the ongoing conversation’s style, including material uncertainty, data cutoffs, verification gaps, and partial failures. Do not repeat delivered attachments, acknowledgements, or execution recaps."
 ];
-const PERSONAL_WORKER_RESULT_GUIDANCE = [
-	"## Result for the originating conversation",
-	"For ordinary Tasks when publish_task_result is available, use it before completion to review the actual result. Connected Requests use their own structured result tool instead. When files were published, finalArtifactIds must select the exact final artifact IDs from publication receipts, including [] for a text-only result. Exclude intermediate, obsolete and failed files; publication history is not the final delivery manifest.",
-	"Provide a complete, evidence-grounded result for the originating conversation. The personal assistant may synthesize its final reply from your report. Match the user’s language and requested depth; preserve requested content, relevant sources, verified data cutoffs, uncertainty, and partial failures. Distinguish reported findings from verified facts. Do not invent a friendly opening or assume a new user request.",
-	"Keep internal planning, Agent names, tool logs, and task progress links out of the result unless the user specifically requested them or they are necessary to explain a blocker. Never substitute a progress page, a plan, or a promise for the requested result. Publish required files through the available artifact tools; do not repeat the same attachments or send the user to a Task page to collect them."
-].join("\n");
 //#endregion
 export { PERSONAL_COMMUNICATION_RULES, PERSONAL_PERSONA_GUIDANCE, PERSONAL_RELIABILITY_RULES, PERSONAL_WORKER_RESULT_GUIDANCE };

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 { getPersonalAgent } from "../repository.js";
 import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { getPersonalAgent } from "../repository.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 { emitSessionTranscriptUpdate } from "../../session/transcript-events.js";
-import { getPersonalAgent } from "../repository.js";
-import { DurableState } from "../../storage/sqlite/durable-state.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.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 { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
+import { getPersonalAgent } from "../repository.js";
+import { emitSessionTranscriptUpdate } from "../../session/transcript-events.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 { personalConversationState } from "../conversation-state.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 //#region src/personal-agent/proactivity/service.ts

package/dist/src/personal-agent/prompt-context.js

@@ -1,16 +1,16 @@
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import "../storage/sqlite/index.js";
+import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
+import { isKnowledgeCurrent, knowledgeItemAllowed, listKnowledgeItems } from "../knowledge-memory/repository.js";
+import "../knowledge-memory/index.js";
 import { getActiveAssertionForSlot } from "../user-model/repository.js";
-import { isPersonalConversation } from "./repository.js";
-import { listPersonalResults } from "./result-reader.js";
-import { TaskOriginRepository } from "../tasks/task-origin-repository.js";
+import { getProjectForSession } from "../projects/workspace.js";
 import { canUseAssertion } from "../user-model/usage-policy.js";
 import "../user-model/index.js";
-import { getProjectForSession } from "../projects/workspace.js";
-import { isKnowledgeCurrent, knowledgeItemAllowed, listKnowledgeItems } from "../knowledge-memory/repository.js";
-import "../knowledge-memory/index.js";
-import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
+import { isPersonalConversation } from "./repository.js";
+import { TaskOriginRepository } from "../tasks/task-origin-repository.js";
+import { listPersonalResults } from "./result-reader.js";
 //#region src/personal-agent/prompt-context.ts
 const clip = (value, limit) => value && (value.length > limit ? `${value.slice(0, limit - 1)}…` : value);
 /** Keep complete JSON records and identifiers, even when the snapshot is incomplete. */

package/dist/src/personal-agent/prompts.js

@@ -1,7 +1,7 @@
 import { PERSONAL_DEFAULT_STYLE_RULES } from "./default-style.js";
-import { PERSONAL_REPLY_EXAMPLES, PERSONAL_REPLY_STYLE_RULES } from "./reply-style.js";
 import { PERSONAL_EMOTIONAL_STYLE_RULE, PERSONAL_IDENTITY_CONTINUITY_RULE } from "./persona.js";
 import { PERSONAL_COMMUNICATION_RULES, PERSONAL_RELIABILITY_RULES } from "./communication.js";
+import { PERSONAL_REPLY_EXAMPLES, PERSONAL_REPLY_STYLE_RULES } from "./reply-style.js";
 //#region src/personal-agent/prompts.ts
 const DELEGATION_RULES = [
 	"Answer directly when your capabilities suffice. Otherwise call personal_task(command=\"submit\") with a short objective. For a self-contained current request send {command:\"submit\", objective:\"short outcome\", useOriginalRequest:true}; command is required. With this mode, the host copies its entire stored text, including exact constraints. Preserve sourceRefs and explicitly requested Agent/Skills. Use a concise complete description instead when earlier conversation must be synthesized. Submit before reading materials. The background Task Router selects and starts the executor. After the tool succeeds, reply only with a short confirmation such as \"Submitted; I will report the result here.\" in the conversation language, then finish. Do not restate any task details, files, requirements or acceptance criteria, and do not wait for the worker. Remain available for conversation.",