@xopcai/xopc 0.0.251 → 0.0.252

package/dist/src/cli/commands/browser-cli-helpers.js

@@ -1,152 +1,19 @@
 import { init_loader, loadConfig } from "../../config/loader.js";
-import { loadPlaywrightCoreModule } from "../../browser/providers/playwright-doctor.js";
-import { BrowserManager } from "../../browser/manager.js";
-import { resolveBrowserBackendFromConfig } from "../../browser/backend-from-config.js";
-import { createBrowserActionRegistry } from "../../browser/actions/registry.js";
-import { runBrowserPipeline, validateBrowserPipeline } from "../../browser/pipeline/runner.js";
-import "../../browser/index.js";
-import { readFile } from "node:fs/promises";
+import { checkBrowserReadiness } from "../../browser/readiness.js";
 //#region src/cli/commands/browser-cli-helpers.ts
 init_loader();
-let _manager = null;
-/** When set, `xopc browser open --headless` overrides config for this CLI invocation. */
-let browserCliHeadlessOverride;
-async function getManager() {
-	if (_manager) return _manager;
+async function doctorCli() {
 	const config = await loadConfig();
-	_manager = new BrowserManager({
-		getHeadless: () => {
-			if (typeof browserCliHeadlessOverride === "boolean") return browserCliHeadlessOverride;
-			return false;
-		},
-		getBackend: () => resolveBrowserBackendFromConfig(config)
-	});
-	return _manager;
-}
-async function getActionContext() {
-	const manager = await getManager();
-	await manager.ensureConnected();
-	return {
-		page: manager.getExtensionProvider() ? null : await manager.getPage("cli"),
-		manager,
-		config: await loadConfig(),
-		taskId: "cli"
-	};
-}
-async function executeBrowserCliAction(action, args) {
-	const prevOverride = browserCliHeadlessOverride;
-	if (typeof args.headless === "boolean") browserCliHeadlessOverride = args.headless;
-	try {
-		const registry = createBrowserActionRegistry();
-		const ctx = await getActionContext();
-		const result = await registry.execute(action, ctx, args);
-		if (result.ok) {
-			if (result.text) console.log(result.text);
-			if (result.data && !result.text) console.log(JSON.stringify(result.data, null, 2));
-		} else {
-			console.error(`[${result.error?.code}] ${result.error?.message}`);
-			process.exitCode = 1;
-		}
-		if (action === "close") {
-			await _manager?.shutdown();
-			_manager = null;
-		}
-	} finally {
-		browserCliHeadlessOverride = prevOverride;
-	}
-}
-async function validatePipelineCli(file) {
-	let yamlSource;
-	try {
-		yamlSource = await readFile(file, "utf8");
-	} catch (e) {
-		const msg = e instanceof Error ? e.message : String(e);
-		console.error(`Failed to read pipeline source: ${msg}`);
-		process.exitCode = 1;
-		return;
-	}
-	const registry = createBrowserActionRegistry();
-	const result = validateBrowserPipeline(yamlSource, registry);
-	if (result.ok) console.log(`✓ Pipeline "${result.document.name}" is valid (${result.document.pipeline.length} steps).`);
-	else {
-		console.error("✗ Pipeline validation failed:");
-		for (const err of result.errors) console.error(`  ${err.path}: ${err.message}`);
-		process.exitCode = 1;
-	}
-}
-async function runPipelineCli(file, args) {
-	let yamlSource;
-	try {
-		yamlSource = await readFile(file, "utf8");
-	} catch (e) {
-		const msg = e instanceof Error ? e.message : String(e);
-		console.error(`Failed to read pipeline source: ${msg}`);
-		process.exitCode = 1;
+	const readiness = await checkBrowserReadiness(config);
+	console.log("Browser Control v2");
+	console.log(`Driver: ${config.browser.driver.kind}`);
+	if (!readiness) {
+		console.log("Status: ready");
 		return;
 	}
-	const registry = createBrowserActionRegistry();
-	const ctx = await getActionContext();
-	const result = await runBrowserPipeline(yamlSource, args, ctx, registry);
-	if (result.ok) {
-		if (result.text) console.log(result.text);
-		if (result.data && !result.text) console.log(JSON.stringify(result.data, null, 2));
-	} else {
-		console.error(`Pipeline failed: [${result.error?.code}] ${result.error?.message}`);
-		if (result.diagnostics?.snapshot) console.error(`Snapshot:\n${result.diagnostics.snapshot.slice(0, 2e3)}`);
-		process.exitCode = 1;
-	}
-	await _manager?.shutdown();
-	_manager = null;
-}
-async function doctorCli() {
-	console.log("Browser Doctor");
-	console.log("──────────────");
-	try {
-		const pw = await loadPlaywrightCoreModule();
-		const chromium = pw.chromium ?? pw.default?.chromium;
-		if (chromium) {
-			console.log("✓ playwright-core installed");
-			const execPath = chromium.executablePath?.();
-			if (execPath) console.log(`  Chromium path: ${execPath}`);
-			else console.log("  ⚠ No default Chromium path detected. Run: npx playwright install chromium");
-		} else console.log("✗ playwright-core chromium not available");
-	} catch {
-		console.log("✗ playwright-core not installed");
-	}
-	try {
-		await loadConfig();
-		console.log(`\nConfig:`);
-		console.log(`  enabled: true`);
-		console.log(`  headless: false`);
-		console.log(`  backend: extension`);
-		console.log(`  provider: local`);
-		{
-			const port = 19820;
-			const host = "127.0.0.1";
-			console.log(`\nExtension Bridge:`);
-			console.log(`  endpoint: ws://${host}:${port}/browser-ext`);
-			try {
-				const { browserExtDoctor } = await import("../../browser/providers/browser-ext-install.js");
-				const artifacts = await browserExtDoctor();
-				console.log(`  artifacts: ${artifacts.installed ? "✓ installed" : "✗ not installed"}`);
-				if (artifacts.extensionDir) console.log(`  path: ${artifacts.extensionDir}`);
-				if (artifacts.needsRefresh) console.log(`  refresh: ⚠ bundled update available`);
-			} catch {
-				console.log(`  artifacts: ⚠ could not check`);
-			}
-			try {
-				const data = await (await fetch(`http://${host}:${port}/`)).json();
-				if (data.ok) {
-					console.log(`  server: ✓ running`);
-					console.log(`  extension: ${data.connected ? "✓ connected" : "⚠ waiting for connection"}`);
-				}
-			} catch {
-				console.log(`  server: ✗ not running (start xopc with backend: 'extension' to enable)`);
-			}
-		}
-	} catch {
-		console.log("\n⚠ Could not load config");
-	}
+	console.error(`Status: ${readiness.hint.reason}`);
+	if (readiness.hint.detail) console.error(`Detail: ${readiness.hint.detail}`);
+	process.exitCode = 1;
 }
 //#endregion
-export { doctorCli, executeBrowserCliAction, runPipelineCli, validatePipelineCli };
+export { doctorCli };

package/dist/src/cli/commands/browser.d.ts

@@ -1,6 +1 @@
-/**
- * CLI: `xopc browser` — browser automation commands.
- *
- * Shares the same action registry and pipeline runner as the `browser_use` AgentTool.
- */
 export {};

package/dist/src/cli/commands/browser.js

@@ -1,170 +1,29 @@
 import { register } from "../registry.js";
 import { Command } from "commander";
 //#region src/cli/commands/browser.ts
-/**
-* CLI: `xopc browser` — browser automation commands.
-*
-* Shares the same action registry and pipeline runner as the `browser_use` AgentTool.
-*/
 function createBrowserCommand(_ctx) {
-	const cmd = new Command("browser").description("Browser automation commands (uses Playwright)");
-	cmd.command("open <url>").description("Open a URL in the browser").option("--headless", "Run without a visible window (default: use config; default config is headed)").action(async (url, opts) => {
-		const { executeBrowserCliAction } = await import("./browser-cli-helpers.js");
-		await executeBrowserCliAction("open", {
-			url,
-			...opts
-		});
-	});
-	cmd.command("state").description("Get current page state (URL, title, ARIA snapshot)").option("--selector <selector>", "CSS selector to scope snapshot").action(async (opts) => {
-		const { executeBrowserCliAction } = await import("./browser-cli-helpers.js");
-		await executeBrowserCliAction("state", opts);
-	});
-	cmd.command("click").description("Click an element").option("--selector <selector>", "CSS selector").option("--text <text>", "Visible text").option("--role <role>", "ARIA role:name (e.g. button:Submit)").action(async (opts) => {
-		const { executeBrowserCliAction } = await import("./browser-cli-helpers.js");
-		await executeBrowserCliAction("click", opts);
-	});
-	cmd.command("type").description("Type text into an input").option("--selector <selector>", "CSS selector").option("--label <label>", "Label text").requiredOption("--text <text>", "Text to type").option("--enter", "Press Enter after typing").action(async (opts) => {
-		const { executeBrowserCliAction } = await import("./browser-cli-helpers.js");
-		await executeBrowserCliAction("type", {
-			...opts,
-			pressEnter: opts.enter
-		});
-	});
-	cmd.command("screenshot [path]").description("Take a screenshot").option("--selector <selector>", "CSS selector").option("--full-page", "Full page screenshot").action(async (path, opts) => {
-		const { executeBrowserCliAction } = await import("./browser-cli-helpers.js");
-		await executeBrowserCliAction("screenshot", {
-			path: path ?? "./screenshot.png",
-			...opts,
-			full_page: opts.fullPage
-		});
-	});
-	cmd.command("validate <file>").description("Validate a Browser Recipe v1 YAML file without executing").action(async (file) => {
-		const { validatePipelineCli } = await import("./browser-cli-helpers.js");
-		await validatePipelineCli(file);
-	});
-	cmd.command("run <file>").description("Run a Browser Recipe v1 YAML file").option("--arg <args...>", "Recipe args (key=<JSON value>)").action(async (file, opts) => {
-		const { runPipelineCli } = await import("./browser-cli-helpers.js");
-		const args = {};
-		if (opts.arg) for (const a of opts.arg) {
-			const eq = a.indexOf("=");
-			if (eq <= 0) throw new Error(`Invalid --arg: ${a}`);
-			args[a.slice(0, eq)] = JSON.parse(a.slice(eq + 1));
-		}
-		await runPipelineCli(file, args);
-	});
-	cmd.command("doctor").description("Check browser environment (Playwright, Chromium)").action(async () => {
+	const command = new Command("browser").description("Browser Control v2 diagnostics and extension setup");
+	command.command("doctor").description("Check the configured browser driver").action(async () => {
 		const { doctorCli } = await import("./browser-cli-helpers.js");
 		await doctorCli();
 	});
-	cmd.command("close").description("Close the browser session").action(async () => {
-		const { executeBrowserCliAction } = await import("./browser-cli-helpers.js");
-		await executeBrowserCliAction("close", {});
-	});
-	const cloakCmd = cmd.command("cloakbrowser").description("CloakBrowser anti-fingerprint browser management");
-	cloakCmd.command("doctor").description("Check CloakBrowser installation status and version").action(async () => {
-		const { cloakBrowserDoctor } = await import("../../browser/providers/cloakbrowser.js");
-		const result = await cloakBrowserDoctor();
-		console.log("\n  CloakBrowser Status\n");
-		console.log(`  Installed:   ${result.installed ? "✓ yes" : "✗ no"}`);
-		console.log(`  Platform:    ${result.platform}`);
-		console.log(`  Version:     ${result.version ?? "(not installed)"}`);
-		console.log(`  Binary:      ${result.binaryPath ?? "(not found)"}`);
-		console.log(`  Cache dir:   ${result.cacheDir}`);
-		console.log("");
-		if (!result.installed) console.log("  Run \"xopc browser cloakbrowser install\" to download CloakBrowser.\n");
-	});
-	cloakCmd.command("install").description("Download and install CloakBrowser binary").option("--cache-dir <dir>", "Custom cache directory for the binary").action(async (opts) => {
-		console.log("\n  Downloading CloakBrowser...\n");
-		try {
-			const { launchCloakBrowser, cleanupCloakBrowser } = await import("../../browser/providers/cloakbrowser.js");
-			const result = await launchCloakBrowser({
-				headless: true,
-				temporaryProfile: true,
-				keepOpen: false,
-				cacheDir: opts.cacheDir
-			});
-			await result.browser.close().catch(() => {});
-			await cleanupCloakBrowser(result.childProcess, result.temporaryProfileDir);
-			console.log("  ✓ CloakBrowser installed successfully.\n");
-		} catch (e) {
-			const msg = e instanceof Error ? e.message : String(e);
-			console.error(`  ✗ Installation failed: ${msg}\n`);
-			process.exitCode = 1;
-		}
-	});
-	const extensionCmd = cmd.command("extension").description("xopc Chrome extension (browser bridge) management");
-	extensionCmd.command("doctor").description("Check bundled extension install status").option("--cache-dir <dir>", "Custom bin cache directory").action(async (opts) => {
+	const extension = command.command("extension").description("Chrome extension setup");
+	extension.command("doctor").description("Check extension artifacts").action(async () => {
 		const { browserExtDoctor } = await import("../../browser/providers/browser-ext-install.js");
-		const result = await browserExtDoctor({ cacheDir: opts.cacheDir });
-		console.log("\n  Chrome Extension Artifacts\n");
-		console.log(`  Bundled:     ${result.bundledAvailable ? "✓ yes" : "✗ no"}`);
-		console.log(`  Installed:   ${result.installed ? "✓ yes" : "✗ no"}`);
-		console.log(`  xopc ver:    ${result.xopcVersion}`);
-		console.log(`  Installed:   ${result.installedVersion ?? "(none)"}`);
-		console.log(`  Manifest:    ${result.manifestVersion ?? "(none)"}`);
-		console.log(`  Directory:   ${result.extensionDir ?? "(not installed)"}`);
-		console.log(`  Cache dir:   ${result.cacheDir}`);
-		console.log(`  Refresh:     ${result.needsRefresh ? "needed" : "up to date"}`);
-		if (result.needsChromeReload) console.log("  ⚠ Chrome reload required (extension runtime version mismatch)");
-		console.log("");
-		if (!result.installed) console.log("  Run \"xopc browser extension install\" to copy bundled artifacts.\n");
-	});
-	extensionCmd.command("install").description("Copy bundled Chrome extension to the local bin directory").option("--cache-dir <dir>", "Custom bin cache directory").option("--force", "Force reinstall even when up to date").action(async (opts) => {
-		console.log("\n  Installing Chrome extension artifacts...\n");
-		try {
-			const { ensureBrowserExtensionArtifacts } = await import("../../browser/providers/browser-ext-install.js");
-			const result = await ensureBrowserExtensionArtifacts({
-				cacheDir: opts.cacheDir,
-				force: opts.force
-			});
-			console.log(`  ✓ ${result.copied ? "Installed" : "Already up to date"}`);
-			console.log(`  Directory: ${result.extensionDir}\n`);
-			console.log("  Next steps:");
-			console.log("  1. Open chrome://extensions");
-			console.log("  2. Enable Developer mode");
-			console.log("  3. Load unpacked → select the directory above");
-			console.log("  4. Run \"xopc browser extension open\" to open Chrome and reveal the folder\n");
-		} catch (e) {
-			const msg = e instanceof Error ? e.message : String(e);
-			console.error(`  ✗ Installation failed: ${msg}\n`);
-			process.exitCode = 1;
-		}
+		console.log(JSON.stringify(await browserExtDoctor(), null, 2));
 	});
-	extensionCmd.command("open").description("Open chrome://extensions and reveal the extension folder").option("--cache-dir <dir>", "Custom bin cache directory").action(async (opts) => {
-		try {
-			const { openBrowserExtensionInstallUi } = await import("../../browser/providers/browser-ext-install.js");
-			const { extensionDir } = await openBrowserExtensionInstallUi({
-				action: "both",
-				cacheDir: opts.cacheDir
-			});
-			console.log(`Opened Chrome extensions page and folder:\n  ${extensionDir}`);
-		} catch (e) {
-			const msg = e instanceof Error ? e.message : String(e);
-			console.error(`  ✗ ${msg}\n`);
-			process.exitCode = 1;
-		}
+	extension.command("install").description("Install extension artifacts").action(async () => {
+		const { ensureBrowserExtensionArtifacts } = await import("../../browser/providers/browser-ext-install.js");
+		console.log(JSON.stringify(await ensureBrowserExtensionArtifacts(), null, 2));
 	});
-	return cmd;
+	return command;
 }
 register({
 	id: "browser",
 	name: "browser",
-	description: "Browser automation commands",
+	description: "Browser Control v2 diagnostics and extension setup",
 	factory: createBrowserCommand,
-	metadata: {
-		category: "utility",
-		examples: [
-			"xopc browser open https://example.com",
-			"xopc browser validate ./flow.yaml",
-			"xopc browser run ./flow.yaml",
-			"xopc browser doctor",
-			"xopc browser cloakbrowser doctor",
-			"xopc browser cloakbrowser install",
-			"xopc browser extension doctor",
-			"xopc browser extension install",
-			"xopc browser extension open"
-		]
-	}
+	metadata: { category: "utility" }
 });
 //#endregion
 export {};

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v152).`,
+		message: `SQLite schema v${status.dbVersion} (current release v153).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/doctor/checks/node-version.js

@@ -1,29 +1,45 @@
 //#region src/cli/commands/doctor/checks/node-version.ts
-function parseNodeMajorVersion() {
-	const match = process.version.match(/^v(\d+)/);
-	return match ? parseInt(match[1], 10) : 0;
+const MINIMUM_NODE_VERSION = [
+	22,
+	22,
+	3
+];
+function parseNodeVersion() {
+	const match = process.version.match(/^v(\d+)\.(\d+)\.(\d+)/);
+	return match ? [
+		Number.parseInt(match[1], 10),
+		Number.parseInt(match[2], 10),
+		Number.parseInt(match[3], 10)
+	] : void 0;
+}
+function meetsMinimumVersion(version) {
+	for (const [index, minimum] of MINIMUM_NODE_VERSION.entries()) {
+		if (version[index] > minimum) return true;
+		if (version[index] < minimum) return false;
+	}
+	return true;
 }
 async function checkNodeVersion(_ctx) {
-	const major = parseNodeMajorVersion();
-	if (major === 0) return {
+	const version = parseNodeVersion();
+	if (!version) return {
 		id: "node-version",
 		label: "Host Node.js",
 		status: "warn",
 		message: "Could not parse Node.js version.",
 		hints: [`process.version=${process.version}`]
 	};
-	if (major < 22) return {
+	if (!meetsMinimumVersion(version)) return {
 		id: "node-version",
 		label: "Host Node.js",
 		status: "fail",
-		message: `Node ${major} is below the required minimum (22).`,
-		hints: ["Install Node.js 22+ from https://nodejs.org/"]
+		message: `Node.js ${process.version} is below the required minimum (22.22.3).`,
+		hints: ["Install Node.js 22.22.3+ from https://nodejs.org/"]
 	};
 	return {
 		id: "node-version",
 		label: "Host Node.js",
 		status: "pass",
-		message: `Node.js ${process.version} meets the project requirement (>= 22).`,
+		message: `Node.js ${process.version} meets the project requirement (>= 22.22.3).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/doctor/checks/provider-auth.js

@@ -1,6 +1,6 @@
 import { getAgentDefaultModelRef, init_schema, parseModelRef } from "../../../../config/schema.js";
-import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "../../../../providers/env-keys.js";
 import { init_loader, loadConfig } from "../../../../config/loader.js";
+import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "../../../../providers/env-keys.js";
 import { existsSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/provider-auth.ts
 init_loader();

package/dist/src/cli/commands/models.js

@@ -1,6 +1,6 @@
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
 import { loadConfig, saveConfig } from "../../config/loader.js";
+import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
 import { getAllModels, getAvailableModels, getConfiguredProviders, getProviderAuthState, getProviderDisplayName, init_providers, isProviderConfigured, providerSupportsApiKey, providerSupportsOAuth, resolveModel } from "../../providers/index.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";

package/dist/src/cli/commands/platform.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/cli/commands/platform.js

@@ -0,0 +1,111 @@
+import { loadConfig, saveConfig } from "../../config/loader.js";
+import { formatExamples, register } from "../registry.js";
+import "../../config/index.js";
+import { PLATFORM_RUNTIME_PROFILE, PLATFORM_RUNTIME_PROVIDER, PlatformRuntimeClient, discoverPlatform } from "../../platform/client.js";
+import "../../platform/index.js";
+import { getProfile, upsertAuthProfile } from "../../auth/profiles/profiles.js";
+import { Command } from "commander";
+//#region src/cli/commands/platform.ts
+async function readStdin() {
+	const chunks = [];
+	for await (const chunk of process.stdin) chunks.push(chunk);
+	return Buffer.concat(chunks).toString("utf8").trim();
+}
+async function readRuntimeToken(value, fromStdin) {
+	if (value?.trim()) return value.trim();
+	if (fromStdin) return readStdin();
+	if (process.stdin.isTTY) {
+		const { password } = await import("@inquirer/prompts");
+		return (await password({
+			message: "Platform runtime token",
+			mask: "*"
+		})).trim();
+	}
+	throw new Error("Provide a runtime token, pass --stdin, or run interactively.");
+}
+function runtimeToken() {
+	const fromEnv = process.env.XOPC_PLATFORM_RUNTIME_TOKEN?.trim();
+	if (fromEnv) return fromEnv;
+	const credential = getProfile(PLATFORM_RUNTIME_PROFILE);
+	if (credential?.type === "token" && credential.provider === "xopc-platform-runtime") return credential.token;
+	throw new Error("Runtime token is not configured. Run `xopc platform runtime token set`.");
+}
+function connectedConfig(ctx) {
+	const config = loadConfig(ctx.configPath);
+	if (config.platform.mode !== "connected") throw new Error("XOPC is in standalone mode. Run `xopc platform connect <url>`.");
+	return {
+		config,
+		platform: config.platform
+	};
+}
+function createPlatformCommand(ctx) {
+	const command = new Command("platform").description("Connect to XOPC Cloud or an enterprise platform").addHelpText("after", formatExamples([
+		"xopc platform connect https://console.xopc.ai",
+		"xopc platform status --refresh",
+		"xopc platform runtime token set --stdin",
+		"xopc platform runtime heartbeat"
+	]));
+	command.command("connect").argument("<url>", "Platform base URL").option("--workspace <id>", "Default workspace ID").action(async (url, options) => {
+		const discovery = await discoverPlatform(url);
+		const config = loadConfig(ctx.configPath);
+		config.platform = {
+			mode: "connected",
+			url: new URL(url).toString().replace(/\/+$/, ""),
+			workspaceId: options.workspace,
+			discovery
+		};
+		await saveConfig(config, ctx.configPath);
+		console.log(`Connected to ${discovery.displayName} (${discovery.deploymentMode}, ${discovery.region})`);
+	});
+	command.command("disconnect").description("Return to standalone mode").action(async () => {
+		const config = loadConfig(ctx.configPath);
+		config.platform = { mode: "standalone" };
+		await saveConfig(config, ctx.configPath);
+		console.log("XOPC is now in standalone mode.");
+	});
+	command.command("status").option("--refresh", "Refresh discovery before printing status").option("--json", "Output JSON").action(async (options) => {
+		const config = loadConfig(ctx.configPath);
+		if (config.platform.mode === "standalone") {
+			console.log(options.json ? JSON.stringify(config.platform) : "Mode: standalone");
+			return;
+		}
+		if (options.refresh) {
+			config.platform.discovery = await discoverPlatform(config.platform.url);
+			await saveConfig(config, ctx.configPath);
+		}
+		if (options.json) console.log(JSON.stringify(config.platform, null, 2));
+		else console.log(`Mode: connected\nPlatform: ${config.platform.discovery.displayName}\nURL: ${config.platform.url}`);
+	});
+	const runtime = command.command("runtime").description("Manage this XOPC runtime connection");
+	runtime.command("token").description("Store the one-time runtime registration token").command("set").argument("[token]").option("--stdin", "Read token from standard input").action(async (value, options) => {
+		const runtimeTokenValue = await readRuntimeToken(value, options.stdin ?? false);
+		if (!/^xopc_rt_[A-Za-z0-9_-]{43}$/.test(runtimeTokenValue)) throw new Error("Invalid platform runtime token.");
+		upsertAuthProfile({
+			profileId: PLATFORM_RUNTIME_PROFILE,
+			credential: {
+				type: "token",
+				provider: PLATFORM_RUNTIME_PROVIDER,
+				token: runtimeTokenValue
+			}
+		});
+		console.log("Platform runtime token stored in the credential store.");
+	});
+	runtime.command("heartbeat").description("Verify the outbound runtime connection and fetch current policy snapshots").option("--json", "Output JSON").action(async (options) => {
+		const { platform } = connectedConfig(ctx);
+		const result = await new PlatformRuntimeClient(platform.discovery, runtimeToken()).heartbeat({ capabilities: { engine: "xopc" } });
+		console.log(options.json ? JSON.stringify(result, null, 2) : "Runtime heartbeat accepted.");
+	});
+	return command;
+}
+register({
+	id: "platform",
+	name: "platform",
+	description: "Connect to XOPC Cloud or an enterprise platform",
+	factory: createPlatformCommand,
+	metadata: {
+		category: "runtime",
+		examples: ["xopc platform status"]
+	}
+});
+//#endregion
+export {};

package/dist/src/config/index.js

@@ -2,15 +2,15 @@ import { ENV_VARS, XOPC_DB_FILENAME, resolveHomeDir, resolveStateDir, resolveXop
 import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema } from "../../extensions/telegram/src/config-schema.js";
 import { WeixinAccountConfigSchema, WeixinConfigSchema } from "../../extensions/weixin/src/config-schema.js";
 import { AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, BrowserConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, ConnectorsConfigSchema, ExperimentalConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GatewayWebchatConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpOAuthConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelCatalogConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, RuntimeToolsConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TuiConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VoiceConfigSchema, VoiceRefinementConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultImageGenerationModelConfig, getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
-import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_config_value, resolveConfigValue, resolveHeaders, testApiKeyResolution } from "./resolve-config-value.js";
+import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
 import { expandWorkspacePathString, init_workspace_path, normalizeWorkspaceDir, resolveWorkspaceRoot } from "./workspace-path.js";
 import { resolveDefaultAgentWorkspaceDir } from "./workspace-defaults.js";
 import { resolveAgentDir as resolveAgentDir$1, resolveAgentHomeDir as resolveAgentHomeDir$1, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
+import { extractProfileAgentId, resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
 import { FILENAMES, WORKSPACE_FILES, existsSync, hasBundledExtensionManifest, init_paths, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentHomeDir, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveCredentialsDir, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveMcpOAuthPath, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath } from "./paths.js";
-import { CustomModelSchema, ImageGenerationCapabilitiesSchema, ImageGenerationModelSchema, ImageGenerationProviderSchema, ModelOverrideSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProviderConfigSchema, VercelGatewayRoutingSchema, getDefaultModelValues, init_models_json, loadModelsJson, modelsJsonExists, saveModelsJson, validateModelsConfig } from "./models-json.js";
 import { init_loader, loadConfig, saveConfig } from "./loader.js";
-import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
-import { extractProfileAgentId, resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
+import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_config_value, resolveConfigValue, resolveHeaders, testApiKeyResolution } from "./resolve-config-value.js";
+import { CustomModelSchema, ImageGenerationCapabilitiesSchema, ImageGenerationModelSchema, ImageGenerationProviderSchema, ModelOverrideSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProviderConfigSchema, VercelGatewayRoutingSchema, getDefaultModelValues, init_models_json, loadModelsJson, modelsJsonExists, saveModelsJson, validateModelsConfig } from "./models-json.js";
 import { canonicalizeConfiguredMcpServer, isKnownCliMcpTypeAlias, normalizeConfiguredMcpServers, resolveXopcMcpTransportAlias } from "./mcp-config-normalize.js";
 import { formatThinkingLevels, listThinkingLevels, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, thinkLevelToNumber } from "../agent/transcript/thinking-types.js";
 import { getWorkspacePath } from "./workspace-path-helpers.js";

package/dist/src/config/loader.js

@@ -2,13 +2,18 @@ import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { ConfigSchema, init_schema } from "./schema.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { init_paths, resolveConfigPath } from "./paths.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { assertChannelPluginConfigs, init_validate_channel_configs } from "./validate-channel-configs.js";
+import { init_resolution, setActivePlatformDiscovery } from "../platform/resolution.js";
 import { dirname } from "path";
 import { existsSync, mkdirSync, promises, readFileSync } from "fs";
 import { config } from "dotenv";
 //#region src/config/loader.ts
+function activateConfig(configValue) {
+	setActivePlatformDiscovery(configValue.platform.mode === "connected" ? configValue.platform.discovery : void 0);
+	return configValue;
+}
 /**
 * Rotate config backups before writing new config.
 * Creates a backup chain: xopc.json.bak, xopc.json.bak.1, xopc.json.bak.2, etc.
@@ -39,7 +44,7 @@ function loadConfig(configPath) {
 		const json = JSON.parse(content);
 		const cfg = ConfigSchema.parse(json);
 		assertChannelPluginConfigs(cfg);
-		return cfg;
+		return activateConfig(cfg);
 	} catch (error) {
 		log.error({
 			err: error,
@@ -47,11 +52,11 @@ function loadConfig(configPath) {
 		}, `Failed to load config`);
 		const cfg = ConfigSchema.parse(void 0);
 		assertChannelPluginConfigs(cfg);
-		return cfg;
+		return activateConfig(cfg);
 	}
 	const cfg = ConfigSchema.parse(void 0);
 	assertChannelPluginConfigs(cfg);
-	return cfg;
+	return activateConfig(cfg);
 }
 /**
 * Save configuration to file
@@ -80,6 +85,7 @@ var init_loader = __esmMin((() => {
 	init_paths();
 	init_logger();
 	init_validate_channel_configs();
+	init_resolution();
 	log = createLogger("ConfigLoader");
 	CONFIG_BACKUP_COUNT = 10;
 }));

package/dist/src/config/models-json.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
 import { init_paths, resolveModelsJsonPath } from "./paths.js";
+import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
 import { existsSync, readFileSync } from "fs";
 import { z } from "zod";
 //#region src/config/models-json.ts