@xopcai/xopc 0.0.321 → 0.0.324

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

@@ -5,17 +5,20 @@ import { currentOperationId, init_operation_context } from "../infra/operation-c
 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 { init_paths, resolveExtensionsDir } from "../config/paths.js";
 import { LocalAppStore } from "./store.js";
 import { slugifyProjectName } from "../projects/project-store.js";
-import { CapabilityError } from "../capabilities/runtime/errors.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";
+import { hashLocalAppDirectory, localAppFileHashes, shouldCopyLocalAppPath } from "./artifact-files.js";
 import { LOCAL_APP_RUNTIME_ENTRY, LOCAL_APP_RUNTIME_SOURCE } from "./runtime-entry.js";
 import { readLocalAppPermissions, scaffoldLocalApp } from "./scaffold.js";
+import { LocalAppSnapshotStore } from "./snapshot-store.js";
 import { withLocalAppReleaseLock } from "./release-lock.js";
-import { basename, join, relative, resolve, sep } from "node:path";
+import { join, resolve, sep } from "node:path";
 import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 //#region src/local-apps/service.ts
@@ -25,7 +28,6 @@ init_logger();
 init_transaction();
 init_operation_context();
 const log = createLogger("LocalApps");
-const RELEASE_COPY_EXCLUDED_NAMES = new Set([".git", "node_modules"]);
 const UI_ONLY_PERMISSIONS = new Set([
 	"theme",
 	"storage",
@@ -85,40 +87,6 @@ function removeExtensionActivation(config, extensionId) {
 		}
 	};
 }
-function shouldCopyReleasePath(source) {
-	return !RELEASE_COPY_EXCLUDED_NAMES.has(basename(source));
-}
-function hashDirectory(root) {
-	const hash = createHash("sha256");
-	const visit = (dir) => {
-		const entries = readdirSync(dir, { withFileTypes: true }).filter((entry) => !RELEASE_COPY_EXCLUDED_NAMES.has(entry.name)).toSorted((a, b) => a.name.localeCompare(b.name));
-		for (const entry of entries) {
-			const path = join(dir, entry.name);
-			const rel = relative(root, path);
-			hash.update(rel);
-			if (entry.isDirectory()) visit(path);
-			else if (entry.isFile()) hash.update(readFileSync(path));
-			else throw new Error(`Unsupported release entry: ${rel}`);
-		}
-	};
-	visit(root);
-	return hash.digest("hex");
-}
-function fileHashes(root) {
-	const hashes = /* @__PURE__ */ new Map();
-	const visit = (dir) => {
-		const entries = readdirSync(dir, { withFileTypes: true }).filter((entry) => !RELEASE_COPY_EXCLUDED_NAMES.has(entry.name)).toSorted((a, b) => a.name.localeCompare(b.name));
-		for (const entry of entries) {
-			const path = join(dir, entry.name);
-			const rel = relative(root, path);
-			if (entry.isDirectory()) visit(path);
-			else if (entry.isFile()) hashes.set(rel, createHash("sha256").update(readFileSync(path)).digest("hex"));
-			else throw new Error(`Unsupported release entry: ${rel}`);
-		}
-	};
-	visit(root);
-	return hashes;
-}
 function changedFiles(current, active) {
 	const paths = new Set([...current.keys(), ...active.keys()]);
 	const changes = [];
@@ -169,9 +137,11 @@ function validateLocalAppPackage(root, extensionId) {
 	const html = readFileSync(join(root, manifest.ui.main), "utf8");
 	if (/<script\b(?![^>]*\bsrc=)[^>]*>/i.test(html)) throw new Error("Inline scripts are blocked in local app previews");
 	if (/(?:src|href)\s*=\s*["']https?:\/\//i.test(html)) throw new Error("Remote scripts, styles, and frames are blocked in Phase 1 local apps");
+	const acceptance = readLocalAppAcceptanceConfig(root);
 	return {
 		manifestJson,
-		acceptanceScenarios: readLocalAppAcceptanceConfig(root).scenarios.map((scenario) => ({
+		entryPath: manifest.ui.main,
+		acceptanceScenarios: acceptance.scenarios.map((scenario) => ({
 			id: scenario.id,
 			name: scenario.name,
 			stepCount: scenario.steps.length
@@ -179,9 +149,10 @@ function validateLocalAppPackage(root, extensionId) {
 	};
 }
 var LocalAppService = class {
-	constructor(options, store = new LocalAppStore()) {
+	constructor(options, store = new LocalAppStore(), snapshots = new LocalAppSnapshotStore()) {
 		this.options = options;
 		this.store = store;
+		this.snapshots = snapshots;
 	}
 	recoveryRoot() {
 		return join(resolveStateDir(), "local-apps", "pending-releases");
@@ -208,13 +179,13 @@ var LocalAppService = class {
 				const release = app.activeReleaseId ? this.store.getRelease(id, app.activeReleaseId) : null;
 				if (!release || resolve(release.artifactPath) !== resolve(this.releaseRoot(id), `v${release.version}`)) throw new Error(`Local app recovery release is unavailable: ${id}`);
 				validateLocalAppPackage(release.artifactPath, app.extensionId);
-				if (hashDirectory(release.artifactPath) !== release.sourceHash) throw new Error(`Local app recovery integrity check failed: ${id}`);
+				if (hashLocalAppDirectory(release.artifactPath) !== release.sourceHash) throw new Error(`Local app recovery integrity check failed: ${id}`);
 				const staging = mkdtempSync(join(extensionsDir, ".local-app-recover-"));
 				try {
 					const replacement = join(staging, app.extensionId);
 					cpSync(release.artifactPath, replacement, {
 						recursive: true,
-						filter: shouldCopyReleasePath
+						filter: shouldCopyLocalAppPath
 					});
 					rmSync(target, {
 						recursive: true,
@@ -266,7 +237,7 @@ var LocalAppService = class {
 		if (!app || !token) return null;
 		return {
 			...app,
-			previewUrl: `/api/local-apps/preview/${token}/ui/index.html`,
+			draftPreviewUrl: `/api/local-apps/preview/${token}/draft/ui/index.html`,
 			permissions: readLocalAppPermissions(app.workspaceRoot),
 			releases: this.store.listReleases(id).map(({ artifactPath: _artifactPath, manifestJson: _manifestJson, ...release }) => release),
 			acceptanceRuns: this.store.listAcceptanceRuns(id)
@@ -322,6 +293,16 @@ var LocalAppService = class {
 		});
 	}
 	create(input) {
+		return this.createInternal(input);
+	}
+	createFromPreview(input) {
+		return this.createInternal(input, {
+			markup: input.markup,
+			styles: input.styles,
+			script: input.script
+		});
+	}
+	createInternal(input, uiSource) {
 		const name = requireText(input.name, "App name");
 		const idea = requireText(input.idea, "App idea");
 		const suffix = randomBytes(4).toString("hex");
@@ -329,13 +310,23 @@ var LocalAppService = class {
 		const workspaceRoot = join(this.options.workspaceRoot, "local-apps", extensionId);
 		const previewToken = randomBytes(24).toString("base64url");
 		mkdirSync(workspaceRoot, { recursive: true });
-		scaffoldLocalApp({
-			workspaceRoot,
-			extensionId,
-			name,
-			idea,
-			description: input.description?.trim() || void 0
-		});
+		try {
+			scaffoldLocalApp({
+				workspaceRoot,
+				extensionId,
+				name,
+				idea,
+				description: input.description?.trim() || void 0,
+				uiSource
+			});
+			validateLocalAppPackage(workspaceRoot, extensionId);
+		} catch (error) {
+			rmSync(workspaceRoot, {
+				recursive: true,
+				force: true
+			});
+			throw error;
+		}
 		const project = this.options.projects.create({
 			name,
 			slug: extensionId,
@@ -361,7 +352,7 @@ var LocalAppService = class {
 		});
 		return this.get(app.id);
 	}
-	resolvePreview(previewToken) {
+	resolveDraftPreview(previewToken) {
 		const app = this.store.findByPreviewToken(previewToken);
 		if (!app) return null;
 		return {
@@ -370,34 +361,42 @@ var LocalAppService = class {
 			uiRoot: app.workspaceRoot
 		};
 	}
-	validate(id) {
-		const app = this.store.get(id);
-		if (!app) throw new Error("Local app not found");
+	resolveSnapshotPreview(previewToken, sourceHash) {
+		const app = this.store.findByPreviewToken(previewToken);
+		if (!app) return null;
+		const uiRoot = this.snapshots.packageRoot(app.id, sourceHash);
+		return uiRoot ? {
+			app,
+			previewToken,
+			uiRoot
+		} : null;
+	}
+	validateRoot(app, root, knownSourceHash, checkedAt = Date.now()) {
 		const issues = [];
 		let manifestJson;
 		let acceptanceScenarios = [];
-		let sourceHash;
+		let sourceHash = knownSourceHash;
 		let currentFiles = /* @__PURE__ */ new Map();
 		try {
-			({manifestJson, acceptanceScenarios} = validateLocalAppPackage(app.workspaceRoot, app.extensionId));
-			currentFiles = fileHashes(app.workspaceRoot);
-			sourceHash = hashDirectory(app.workspaceRoot);
+			currentFiles = localAppFileHashes(root);
+			sourceHash ??= hashLocalAppDirectory(root);
+			({manifestJson, acceptanceScenarios} = validateLocalAppPackage(root, app.extensionId));
 		} catch (error) {
 			issues.push({
 				code: "package_validation_failed",
 				severity: "error",
-				message: error instanceof Error ? error.message : String(error)
+				message: (error instanceof Error ? error.message : String(error)).slice(0, 500)
 			});
 		}
 		const activeRelease = app.activeReleaseId ? this.store.getRelease(app.id, app.activeReleaseId) : null;
 		let files = [];
 		if (activeRelease?.artifactPath && existsSync(activeRelease.artifactPath) && currentFiles.size) try {
-			files = changedFiles(currentFiles, fileHashes(activeRelease.artifactPath));
+			files = changedFiles(currentFiles, localAppFileHashes(activeRelease.artifactPath));
 		} catch (error) {
 			issues.push({
 				code: "release_comparison_failed",
 				severity: "warning",
-				message: error instanceof Error ? error.message : String(error)
+				message: (error instanceof Error ? error.message : String(error)).slice(0, 500)
 			});
 		}
 		else if (!activeRelease && currentFiles.size) files = [...currentFiles.keys()].toSorted().map((path) => ({
@@ -408,7 +407,7 @@ var LocalAppService = class {
 		const activePermissions = permissionsFromManifestJson(activeRelease?.manifestJson);
 		return {
 			status: issues.some((issue) => issue.severity === "error") ? "failed" : "healthy",
-			checkedAt: Date.now(),
+			checkedAt,
 			sourceHash,
 			hasDraftChanges: activeRelease ? sourceHash !== activeRelease.sourceHash : true,
 			changedFiles: files.slice(0, 50),
@@ -423,6 +422,49 @@ var LocalAppService = class {
 			issues
 		};
 	}
+	validate(id) {
+		const app = this.store.get(id);
+		if (!app) throw new Error("Local app not found");
+		return this.validateRoot(app, app.workspaceRoot);
+	}
+	materializeSnapshot(id) {
+		const app = this.store.get(id);
+		const token = app ? this.store.getPreviewToken(id) : null;
+		if (!app || !token) throw new Error("Local app not found");
+		const stored = this.snapshots.materialize(app.id, app.workspaceRoot, (packageRoot, sourceHash, createdAt) => {
+			const validation = this.validateRoot(app, packageRoot, sourceHash, createdAt);
+			const packageResult = validation.status === "healthy" ? validateLocalAppPackage(packageRoot, app.extensionId) : null;
+			return {
+				appId: app.id,
+				sourceHash,
+				status: packageResult ? "ready" : "invalid",
+				createdAt,
+				...packageResult ? { entryPath: packageResult.entryPath } : {},
+				validation
+			};
+		});
+		return this.withSnapshotPreviewUrl(stored, token);
+	}
+	getSnapshot(id, sourceHash) {
+		const app = this.store.get(id);
+		const token = app ? this.store.getPreviewToken(id) : null;
+		if (!app || !token) return null;
+		const snapshot = this.snapshots.get(app.id, sourceHash);
+		return snapshot ? this.withSnapshotPreviewUrl(snapshot, token) : null;
+	}
+	withSnapshotPreviewUrl(snapshot, token) {
+		if (snapshot.status !== "ready" || !snapshot.entryPath) return snapshot;
+		const entryPath = snapshot.entryPath.split("/").map(encodeURIComponent).join("/");
+		return {
+			...snapshot,
+			previewUrl: `/api/local-apps/preview/${token}/snapshots/${snapshot.sourceHash}/${entryPath}`
+		};
+	}
+	getFixGuidance(id, input) {
+		const app = this.store.get(id);
+		if (!app) throw new CapabilityError("NOT_FOUND", "Local app not found");
+		return buildLocalAppFixGuidance(app, this.validate(id), input);
+	}
 	recordAcceptance(id, input) {
 		const app = this.store.get(id);
 		if (!app) throw new Error("Local app not found");
@@ -507,7 +549,7 @@ var LocalAppService = class {
 		try {
 			cpSync(input.artifactPath, staged, {
 				recursive: true,
-				filter: shouldCopyReleasePath
+				filter: shouldCopyLocalAppPath
 			});
 			if (existsSync(target)) {
 				renameSync(target, backup);
@@ -559,10 +601,10 @@ var LocalAppService = class {
 		try {
 			cpSync(app.workspaceRoot, stagedArtifact, {
 				recursive: true,
-				filter: shouldCopyReleasePath
+				filter: shouldCopyLocalAppPath
 			});
 			const { manifestJson } = validateLocalAppPackage(stagedArtifact, app.extensionId);
-			const sourceHash = hashDirectory(stagedArtifact);
+			const sourceHash = hashLocalAppDirectory(stagedArtifact);
 			if (this.store.getLatestAcceptanceForSource(app.id, sourceHash)?.status !== "passed") throw new Error("The current draft has not passed automatic acceptance");
 			renameSync(stagedArtifact, artifactPath);
 			artifactCreated = true;
@@ -612,7 +654,7 @@ var LocalAppService = class {
 		const release = this.store.getRelease(id, releaseId);
 		if (!release || !release.artifactPath || !existsSync(release.artifactPath)) throw new Error("Local app release artifact is unavailable");
 		validateLocalAppPackage(release.artifactPath, app.extensionId);
-		if (hashDirectory(release.artifactPath) !== release.sourceHash) throw new Error("Release artifact integrity check failed; rollback was not applied");
+		if (hashLocalAppDirectory(release.artifactPath) !== release.sourceHash) throw new Error("Release artifact integrity check failed; rollback was not applied");
 		await this.activateArtifact({
 			app,
 			artifactPath: release.artifactPath,

package/dist/src/local-apps/snapshot-store.d.ts

@@ -0,0 +1,8 @@
+import { type LocalAppPreviewSnapshot } from '@xopcai/gateway-contract';
+export declare class LocalAppSnapshotStore {
+    private appRoot;
+    private snapshotRoot;
+    get(appId: string, sourceHash: string): LocalAppPreviewSnapshot | null;
+    packageRoot(appId: string, sourceHash: string): string | null;
+    materialize(appId: string, sourceRoot: string, build: (packageRoot: string, sourceHash: string, createdAt: number) => LocalAppPreviewSnapshot): LocalAppPreviewSnapshot;
+}

package/dist/src/local-apps/snapshot-store.js

@@ -0,0 +1,68 @@
+import { resolveStateDir } from "../config/paths-state.js";
+import { LocalAppPreviewSnapshotSchema, LocalAppSourceHashSchema } from "../../packages/gateway-contract/src/local-apps.js";
+import { init_src } from "../../packages/gateway-contract/src/index.js";
+import { init_paths } from "../config/paths.js";
+import { hashLocalAppDirectory, shouldCopyLocalAppPath } from "./artifact-files.js";
+import { join } from "node:path";
+import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+//#region src/local-apps/snapshot-store.ts
+init_src();
+init_paths();
+function assertAppId(appId) {
+	if (!/^[a-zA-Z0-9-]+$/.test(appId)) throw new Error("Invalid local app id");
+}
+var LocalAppSnapshotStore = class {
+	appRoot(appId) {
+		assertAppId(appId);
+		return join(resolveStateDir(), "local-apps", "snapshots", appId);
+	}
+	snapshotRoot(appId, sourceHash) {
+		LocalAppSourceHashSchema.parse(sourceHash);
+		return join(this.appRoot(appId), sourceHash);
+	}
+	get(appId, sourceHash) {
+		const root = this.snapshotRoot(appId, sourceHash);
+		const metadataPath = join(root, "snapshot.json");
+		const packageRoot = join(root, "package");
+		if (!existsSync(metadataPath) || !existsSync(packageRoot)) return null;
+		const snapshot = LocalAppPreviewSnapshotSchema.parse(JSON.parse(readFileSync(metadataPath, "utf8")));
+		if (snapshot.appId !== appId || snapshot.sourceHash !== sourceHash) throw new Error("Local app snapshot metadata does not match its path");
+		return snapshot;
+	}
+	packageRoot(appId, sourceHash) {
+		return this.get(appId, sourceHash)?.status === "ready" ? join(this.snapshotRoot(appId, sourceHash), "package") : null;
+	}
+	materialize(appId, sourceRoot, build) {
+		const appRoot = this.appRoot(appId);
+		mkdirSync(appRoot, { recursive: true });
+		const stagingRoot = mkdtempSync(join(appRoot, ".snapshot-"));
+		const stagedPackage = join(stagingRoot, "package");
+		try {
+			cpSync(sourceRoot, stagedPackage, {
+				recursive: true,
+				filter: shouldCopyLocalAppPath
+			});
+			const sourceHash = hashLocalAppDirectory(stagedPackage);
+			const existing = this.get(appId, sourceHash);
+			if (existing) return existing;
+			const snapshot = LocalAppPreviewSnapshotSchema.parse(build(stagedPackage, sourceHash, Date.now()));
+			writeFileSync(join(stagingRoot, "snapshot.json"), `${JSON.stringify(snapshot)}\n`, { mode: 384 });
+			const target = this.snapshotRoot(appId, sourceHash);
+			try {
+				renameSync(stagingRoot, target);
+			} catch (error) {
+				const raced = this.get(appId, sourceHash);
+				if (raced) return raced;
+				throw error;
+			}
+			return snapshot;
+		} finally {
+			if (existsSync(stagingRoot)) rmSync(stagingRoot, {
+				recursive: true,
+				force: true
+			});
+		}
+	}
+};
+//#endregion
+export { LocalAppSnapshotStore };

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

@@ -1,7 +1,8 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 import { randomUUID } from "node:crypto";
 //#region src/local-apps/store.ts
+init_sqlite();
 function fromRow(row) {
 	return {
 		id: row.app_id,

package/dist/src/local-apps/types.d.ts

@@ -1,40 +1,7 @@
-export type LocalAppStatus = 'preview_ready' | 'installed' | 'degraded';
-export type LocalAppInstallationState = 'not_installed' | 'installed';
-export type LocalAppReleaseHealth = 'healthy' | 'failed';
-export interface LocalAppRelease {
-    id: string;
-    appId: string;
-    version: number;
-    sourceHash: string;
-    healthStatus: LocalAppReleaseHealth;
-    createdAt: number;
-    activatedAt?: number;
-    isActive: boolean;
-}
-export interface LocalApp {
-    id: string;
-    extensionId: string;
-    projectId: string;
-    name: string;
-    description?: string;
-    idea: string;
-    status: LocalAppStatus;
-    workspaceRoot: string;
-    draftVersion: number;
-    activeVersion?: number;
-    activeReleaseId?: string;
-    installationState: LocalAppInstallationState;
-    enabled: boolean;
-    createdAt: number;
-    updatedAt: number;
-    installedAt?: number;
-}
-export interface LocalAppDetail extends LocalApp {
-    previewUrl: string;
-    permissions: string[];
-    releases: LocalAppRelease[];
-    acceptanceRuns: LocalAppAcceptanceRun[];
-}
+import type { LocalAppAcceptanceInput, LocalAppAcceptanceRun, LocalAppAcceptanceScenarioSummary, LocalAppChangedFile, LocalAppDetail, LocalAppDiagnostic, LocalAppDiagnosticPhase, LocalAppFixGuidance, LocalAppFixGuidanceInput, LocalAppInstallationState, LocalAppRecord, LocalAppRelease, LocalAppReleaseHealth, LocalAppStatus, LocalAppValidationIssue, LocalAppValidationResult } from '@xopcai/gateway-contract';
+export type LocalApp = LocalAppRecord;
+export type RecordLocalAppAcceptanceInput = LocalAppAcceptanceInput;
+export type { LocalAppAcceptanceRun, LocalAppAcceptanceScenarioSummary, LocalAppChangedFile, LocalAppDetail, LocalAppDiagnostic, LocalAppDiagnosticPhase, LocalAppFixGuidance, LocalAppFixGuidanceInput, LocalAppInstallationState, LocalAppRelease, LocalAppReleaseHealth, LocalAppStatus, LocalAppValidationIssue, LocalAppValidationResult, };
 export interface LocalAppUiGrant {
     granted: boolean;
     extensionId: string;
@@ -43,56 +10,6 @@ export interface LocalAppUiGrant {
     permissions: string[];
     grantedAt?: number;
 }
-export interface LocalAppAcceptanceCheck {
-    id: 'document' | 'content' | 'interaction' | 'criteria';
-    status: 'passed' | 'failed' | 'skipped';
-    message: string;
-}
-export interface LocalAppAcceptanceRun {
-    id: string;
-    appId: string;
-    sourceHash: string;
-    status: 'passed' | 'failed';
-    checks: LocalAppAcceptanceCheck[];
-    interactiveCount: number;
-    createdAt: number;
-}
-export interface RecordLocalAppAcceptanceInput {
-    sourceHash: string;
-    status: 'passed' | 'failed';
-    checks: LocalAppAcceptanceCheck[];
-    interactiveCount: number;
-}
-export interface LocalAppValidationIssue {
-    code: string;
-    severity: 'error' | 'warning';
-    message: string;
-}
-export interface LocalAppChangedFile {
-    path: string;
-    status: 'added' | 'modified' | 'deleted';
-}
-export interface LocalAppAcceptanceScenarioSummary {
-    id: string;
-    name: string;
-    stepCount: number;
-}
-export interface LocalAppValidationResult {
-    status: 'healthy' | 'failed';
-    checkedAt: number;
-    sourceHash?: string;
-    hasDraftChanges: boolean;
-    changedFiles: LocalAppChangedFile[];
-    changedFileCount: number;
-    permissions: string[];
-    permissionDelta: {
-        added: string[];
-        removed: string[];
-    };
-    acceptanceScenarioCount: number;
-    acceptanceScenarios: LocalAppAcceptanceScenarioSummary[];
-    issues: LocalAppValidationIssue[];
-}
 export interface CreateLocalAppInput {
     name: string;
     idea: string;

package/dist/src/mcp/channel-bridge.js

@@ -1,13 +1,12 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_loader, loadConfig } from "../config/loader.js";
+import { loadConfig } from "../config/loader.js";
 import { createGatewayHttpClientFromConfig, resolveGatewayHttpBaseUrl } from "./gateway-http-client.js";
 import { RealtimeClient } from "../../packages/realtime-client/src/index.js";
 import { toConversation } from "./channel-shared.js";
 import { createRequire } from "node:module";
 import crypto from "node:crypto";
 //#region src/mcp/channel-bridge.ts
-init_loader();
 init_logger();
 const log = createLogger("Mcp:Bridge");
 const { WebSocket } = createRequire(import.meta.url)("ws");

package/dist/src/mcp/channel-server.js

@@ -1,12 +1,11 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
-import { init_loader, loadConfig } from "../config/loader.js";
+import { loadConfig } from "../config/loader.js";
 import { ClaudePermissionRequestSchema } from "./channel-shared.js";
 import { XopcChannelBridge } from "./channel-bridge.js";
 import { getChannelMcpCapabilities, registerChannelMcpTools } from "./channel-tools.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 //#region src/mcp/channel-server.ts
-init_loader();
 init_package_version();
 async function createXopcChannelMcpServer(opts = {}) {
 	const cfg = opts.config ?? loadConfig();

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

@@ -2,13 +2,12 @@ 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 { init_loader, 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
 init_src();
-init_loader();
 init_logger();
 const log = createLogger("Mcp:GatewayClient");
 var GatewayHttpError = class extends Error {

package/dist/src/media/session-references.js

@@ -1,8 +1,9 @@
 import { getSqliteDatabase } from "../storage/sqlite/transaction.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 import { tryParseMediaUri } from "./uri.js";
 import { deleteMediaBuffer } from "./store.js";
 //#region src/media/session-references.ts
+init_sqlite();
 function collectFromValue(value, out, seen) {
 	if (!value) return;
 	if (typeof value === "string") {

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

@@ -1,8 +1,9 @@
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import "../user-model/domain.js";
+import { init_domain } from "../user-model/domain.js";
 import { randomUUID } from "node:crypto";
 //#region src/memory-maintenance/service.ts
 init_transaction();
+init_domain();
 const ALGORITHM_VERSION = "user-model-maintenance-v2";
 function emptyMetrics() {
 	return {

package/dist/src/migrations/memory-config.js

@@ -1,7 +1,6 @@
-import { init_lock, isGatewayConfigLockedByAnotherProcessSync } from "../gateway/lock.js";
+import { isGatewayConfigLockedByAnotherProcessSync } from "../gateway/lock.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/migrations/memory-config.ts
-init_lock();
 const id = "automatic-memory-config";
 function normalizeKnowledgeMemoryConfigInput(input) {
 	if (!input || typeof input !== "object" || Array.isArray(input)) return input;

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

@@ -1,5 +1,5 @@
 import { getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "../storage/sqlite/note-agent-context-repository.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 import { resolveImageModelConfigForTool } from "../agent/image/tool-model-config.js";
 import { describeImagesWithFallback } from "../agent/image/understanding/runtime.js";
 import { extractDocumentText } from "../document-understanding/extract.js";
@@ -10,6 +10,7 @@ import "../voice/stt/index.js";
 import { extname } from "node:path";
 import { readFile } from "node:fs/promises";
 //#region src/notes/agent-context.ts
+init_sqlite();
 const MAX_NOTE_MARKDOWN_CHARS = 4e4;
 const MAX_TEXT_ATTACHMENT_CHARS = 2e4;
 const MAX_TOTAL_CONTEXT_CHARS = 8e4;

package/dist/src/notes/attachment-ref.js

@@ -1,7 +1,5 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 //#region src/notes/attachment-ref.ts
-/** Canonical persisted reference: xopc-attachment://notes/{noteId}/{attachmentId} */
-const NOTE_ATTACHMENT_SCHEME = "xopc-attachment";
-const CANONICAL_REF = /^xopc-attachment:\/\/notes\/([^/]+)\/([^/?#]+)$/i;
 function buildNoteAttachmentRef(noteId, attachmentId) {
 	return `${NOTE_ATTACHMENT_SCHEME}://notes/${encodeURIComponent(noteId)}/${encodeURIComponent(attachmentId)}`;
 }
@@ -21,5 +19,11 @@ function parseNoteAttachmentTarget(target, expectedNoteId) {
 function attachmentIdFromTarget(target, noteId) {
 	return parseNoteAttachmentTarget(target, noteId)?.attachmentId;
 }
+var NOTE_ATTACHMENT_SCHEME, CANONICAL_REF;
+var init_attachment_ref = __esmMin((() => {
+	NOTE_ATTACHMENT_SCHEME = "xopc-attachment";
+	CANONICAL_REF = /^xopc-attachment:\/\/notes\/([^/]+)\/([^/?#]+)$/i;
+}));
 //#endregion
-export { NOTE_ATTACHMENT_SCHEME, attachmentIdFromTarget, buildNoteAttachmentRef, parseNoteAttachmentTarget };
+init_attachment_ref();
+export { NOTE_ATTACHMENT_SCHEME, attachmentIdFromTarget, buildNoteAttachmentRef, init_attachment_ref, parseNoteAttachmentTarget };

package/dist/src/notes/note-attachment-sync.js

@@ -1,5 +1,6 @@
-import { parseNoteMarkdown } from "./note-markdown.js";
+import { init_note_markdown, parseNoteMarkdown } from "./note-markdown.js";
 //#region src/notes/note-attachment-sync.ts
+init_note_markdown();
 function collectReferencedAttachmentIds(note) {
 	return new Set(parseNoteMarkdown(note.markdown, note.id).attachments.map((item) => item.attachmentId));
 }