@xopcai/xopc 0.0.321 → 0.0.324

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

@@ -1,9 +1,10 @@
 import { requireXopcDatabase } from "../../storage/sqlite/connection.js";
-import "../../storage/sqlite/index.js";
+import { init_sqlite } from "../../storage/sqlite/index.js";
 import { formatExamples, register } from "../registry.js";
 import { exportCtxHistory } from "../../history/ctx/exporter.js";
 import { Command } from "commander";
 //#region src/cli/commands/history.ts
+init_sqlite();
 async function runCtxExport(options) {
 	try {
 		const { db } = requireXopcDatabase();

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

@@ -6,8 +6,8 @@ import { Command } from "commander";
 function createImageCommand(_ctx) {
 	const cmd = new Command("image").description("Inspect image provider availability").addHelpText("after", formatExamples(["xopc image providers   # List available image generation providers", "xopc image status      # Explain current image behavior"]));
 	cmd.command("status").description("Show image runtime status").action(() => {
-		console.log("Image understanding and generation inherit from agents.defaults.models.");
-		console.log("An agent may override either route in agents.list[].models.");
+		console.log("Image understanding and generation inherit from the global Agent defaults.");
+		console.log("An Agent may override either route in its capability settings.");
 	});
 	cmd.command("providers").description("List image generation providers").option("--json", "Output as JSON").action((opts) => {
 		const providers = listImageGenerationProvidersSummary();

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

@@ -3,17 +3,16 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { resolveAgentWorkspaceDir } from "../../agent/agent-scope.js";
 import { WORKSPACE_FILES, init_paths, resolveAgentDir, resolveAgentHomeDir, resolveAgentProfileDir, resolveConfigPath } from "../../config/paths.js";
-import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
+import { loadConfig, saveConfig } from "../../config/loader.js";
 import { ensureStarterAgentsInitialized } from "../../agent/starter-agents.js";
 import { formatExamples, register } from "../registry.js";
 import { join } from "path";
-import { existsSync, readFileSync } from "fs";
+import { existsSync } from "fs";
 import { mkdir, writeFile } from "fs/promises";
 import { Command } from "commander";
 //#region src/cli/commands/init.ts
 init_logger();
 init_paths();
-init_loader();
 const log = createLogger("InitCommand");
 /**
 * Initialize xopc state directory structure
@@ -32,14 +31,13 @@ async function initCommand(options = {}) {
 	await mkdir(stateDir, { recursive: true });
 	const configPath = resolveConfigPath();
 	const configExists = existsSync(configPath);
-	const diskTui = readDiskTuiDefaultState(configPath);
-	const starterResult = ensureStarterAgentsInitialized(loadConfig(configPath));
-	const cfg = starterResult.config;
-	await mkdir(resolveAgentHomeDir(cfg, agentId), { recursive: true });
-	await mkdir(resolveAgentProfileDir(cfg, agentId), { recursive: true });
-	await mkdir(resolveAgentDir(cfg, agentId), { recursive: true });
-	await mkdir(resolveAgentWorkspaceDir(cfg, agentId), { recursive: true });
-	if (!configExists || options.force || diskTui.readable && (starterResult.changed || !diskTui.hasDefaultAgent)) {
+	ensureStarterAgentsInitialized();
+	const cfg = loadConfig(configPath);
+	await mkdir(resolveAgentHomeDir(agentId), { recursive: true });
+	await mkdir(resolveAgentProfileDir(agentId), { recursive: true });
+	await mkdir(resolveAgentDir(agentId), { recursive: true });
+	await mkdir(resolveAgentWorkspaceDir(agentId), { recursive: true });
+	if (!configExists || options.force) {
 		await saveConfig(cfg, configPath);
 		log.info({ configPath }, "Saved configuration");
 	}
@@ -49,29 +47,12 @@ async function initCommand(options = {}) {
 		agentId
 	}, "xopc Agent OS initialized successfully");
 }
-function readDiskTuiDefaultState(configPath) {
-	if (!existsSync(configPath)) return {
-		readable: true,
-		hasDefaultAgent: false
-	};
-	try {
-		return {
-			readable: true,
-			hasDefaultAgent: typeof JSON.parse(readFileSync(configPath, "utf-8")).tui?.defaultAgent === "string"
-		};
-	} catch {
-		return {
-			readable: false,
-			hasDefaultAgent: false
-		};
-	}
-}
 /**
 * Create default workspace files for an agent
 */
 async function createWorkspaceFiles(cfg, agentId) {
-	const workspaceDir = resolveAgentWorkspaceDir(cfg, agentId);
-	const profileDir = resolveAgentProfileDir(cfg, agentId);
+	const workspaceDir = resolveAgentWorkspaceDir(agentId);
+	const profileDir = resolveAgentProfileDir(agentId);
 	await mkdir(workspaceDir, { recursive: true });
 	await mkdir(profileDir, { recursive: true });
 	const soulPath = join(profileDir, WORKSPACE_FILES.SOUL);

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

@@ -1,11 +1,10 @@
-import { init_loader, loadConfig } from "../../config/loader.js";
+import { loadConfig } from "../../config/loader.js";
 import { register } from "../registry.js";
 import { createGatewayHttpClientFromConfig } from "../../mcp/gateway-http-client.js";
 import { createCapabilityMcpServer } from "../../mcp/capability-server.js";
 import { Command } from "commander";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 //#region src/cli/commands/mcp.ts
-init_loader();
 function createMcpCommand(ctx) {
 	const command = new Command("mcp").description("Expose selected Gateway capabilities over MCP");
 	command.command("capabilities").description("Run an opt-in stdio MCP proxy for an explicit capability allowlist").requiredOption("--allow-capability <ids...>", "Exact capability IDs; no wildcards").action(async (options) => {

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

@@ -1,7 +1,9 @@
+import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.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 { loadConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";
 import "../../config/index.js";
@@ -14,6 +16,7 @@ import { Command } from "commander";
 //#region src/cli/commands/models.ts
 init_credentials();
 init_schema();
+init_repository();
 init_providers();
 const IMAGE_GENERATION_IDS = new Set([
 	"gpt-image-2",
@@ -43,14 +46,15 @@ const VISION_IDS = new Set([
 	"qwen-vl-max",
 	"qwen2.5-vl-72b-instruct"
 ]);
-function currentModelRef(config) {
-	return getAgentDefaultModelRef(config);
+function currentModelRef(_config) {
+	return getAgentDefaultModelRef();
 }
-function setDefaultModel(config, modelRef) {
-	const prep = prepareUpdateGlobalDefaults(config, { defaults: {
-		...config.agents.defaults,
+function setDefaultModel(modelRef) {
+	const defaults = new AgentCatalogRepository().getSettings().defaults;
+	const prep = prepareUpdateGlobalDefaults({ defaults: {
+		...defaults,
 		models: {
-			...config.agents.defaults.models,
+			...defaults.models,
 			chat: {
 				primary: modelRef,
 				fallbacks: []
@@ -58,7 +62,7 @@ function setDefaultModel(config, modelRef) {
 		}
 	} });
 	if (prep.ok === false) throw new Error(prep.error);
-	return prep.data.nextConfig;
+	if (prep.data.changed) new AgentCatalogService().updateDefaults(prep.data.defaults);
 }
 function modelRef(provider, id) {
 	return `${provider}/${id}`;
@@ -137,11 +141,9 @@ async function runModelsStatus(options) {
 	}
 }
 async function runModelsSet(model) {
-	const ctx = getContextWithOpts();
-	const config = loadConfig(ctx.configPath);
 	const resolved = resolveModel(model);
 	const ref = modelRef(resolved.provider, resolved.id);
-	await saveConfig(setDefaultModel(config, ref), ctx.configPath);
+	setDefaultModel(ref);
 	console.log(`✅ Default model set: ${ref}`);
 }
 async function runAuthList(options) {

package/dist/src/cli/commands/onboard/channels/registry.js

@@ -1,10 +1,9 @@
-import { buildExtensionMetadataSnapshot, init_extension_metadata_snapshot, resolveExtensionLoaderOptionsFromConfig } from "../../../../extensions/extension-metadata-snapshot.js";
 import { listChannelPlugins } from "../../../../channels/plugins/registry.js";
 import { ExtensionLoader } from "../../../../extensions/loader.js";
+import { buildExtensionMetadataSnapshot, resolveExtensionLoaderOptionsFromConfig } from "../../../../extensions/extension-metadata-snapshot.js";
 import { channelSetupWizardToConfigurator } from "./wizard-to-configurator.js";
 import { channelOnboardToConfigurator } from "./onboard-to-configurator.js";
 //#region src/cli/commands/onboard/channels/registry.ts
-init_extension_metadata_snapshot();
 function sortByMetaOrder(plugins) {
 	return [...plugins].sort((a, b) => {
 		const oa = a.meta.order ?? 999;

package/dist/src/cli/commands/onboard/gateway.js

@@ -1,10 +1,9 @@
-import { GatewayLockError, acquireGatewayLock, init_lock } from "../../../gateway/lock.js";
+import { GatewayLockError, acquireGatewayLock } from "../../../gateway/lock.js";
 import { confirm } from "@inquirer/prompts";
 //#region src/cli/commands/onboard/gateway.ts
 /**
 * Gateway Configuration and Startup for Onboarding
 */
-init_lock();
 function isInteractive() {
 	return process.stdin.isTTY && process.stdout.isTTY;
 }

package/dist/src/cli/commands/onboard/model.d.ts

@@ -4,6 +4,6 @@
 import type { Config } from '../../../config/schema.js';
 import { type XopcCloudCatalogCoordinator } from '../../../providers/xopc-cloud-catalog-coordinator.js';
 import type { CLIContext } from '../../registry.js';
-export declare function setPrimaryModel(config: Config, workspacePath: string, modelRef: string): Config;
+export declare function setPrimaryModel(config: Config, workspacePath: string, modelRef: string): Promise<Config>;
 export declare function refreshOnboardModelCatalogIfNeeded(provider: string, hasCatalogModels: boolean, coordinator?: Pick<XopcCloudCatalogCoordinator, 'refresh'>): Promise<void>;
 export declare function setupModel(existingConfig: Config | null, ctx: CLIContext): Promise<Config>;

package/dist/src/cli/commands/onboard/model.js

@@ -1,5 +1,7 @@
-import { getAgentDefaultModelRef, init_schema } from "../../../config/schema.js";
+import { AgentCatalogRepository, init_repository } from "../../../agent-catalog/repository.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
+import { AgentCatalogService } from "../../../agent-catalog/service.js";
+import { getAgentDefaultModelRef, init_schema } from "../../../config/schema.js";
 import { init_models_json, loadModelsJson, saveModelsJson } from "../../../config/models-json.js";
 import { getApiKeyFromEnv } from "../../../providers/env-keys.js";
 import { getModelRegistry } from "../../../providers/model-registry.js";
@@ -12,6 +14,7 @@ import { getDomesticProviderBaseUrl, getDomesticProviderPreset, getDomesticProvi
 import { getProviderHint, getRecommendedModelsForProvider, sortModelsForPicker, sortProvidersForPicker } from "../../../providers/presentation.js";
 import { colors } from "../../utils/colors.js";
 import { listProfilesForProvider } from "../../../auth/profiles/profiles.js";
+import "../../../auth/profiles/index.js";
 import { getOAuthProvider } from "../../utils/oauth-providers.js";
 import { runCliOAuthLogin } from "../../utils/oauth-login.js";
 import { confirm, input, select } from "@inquirer/prompts";
@@ -23,28 +26,13 @@ init_credentials();
 init_models_json();
 init_schema();
 init_providers();
-function setPrimaryModel(config, workspacePath, modelRef) {
-	const id = config.agents.default ?? config.agents.list[0]?.id ?? "main";
-	const index = config.agents.list.findIndex((entry) => entry.id === id);
-	let nextConfig = config;
-	if (index >= 0) {
-		const agent = config.agents.list[index];
-		const nextList = [...config.agents.list];
-		nextList[index] = {
-			...agent,
-			workspace: workspacePath
-		};
-		nextConfig = {
-			...config,
-			agents: {
-				...config.agents,
-				list: nextList
-			}
-		};
-	}
-	const currentModels = nextConfig.agents.defaults.models;
-	const prep = prepareUpdateGlobalDefaults(nextConfig, { defaults: {
-		...nextConfig.agents.defaults,
+init_repository();
+async function setPrimaryModel(config, workspacePath, modelRef) {
+	const repository = new AgentCatalogRepository();
+	const catalog = repository.snapshot();
+	const currentModels = catalog.defaults.models;
+	const prep = prepareUpdateGlobalDefaults({ defaults: {
+		...catalog.defaults,
 		models: {
 			...currentModels,
 			chat: {
@@ -54,7 +42,11 @@ function setPrimaryModel(config, workspacePath, modelRef) {
 		}
 	} });
 	if (prep.ok === false) throw new Error(prep.error);
-	return prep.data.nextConfig;
+	const service = new AgentCatalogService(repository);
+	if (prep.data.changed) service.updateDefaults(prep.data.defaults);
+	const agent = repository.get(catalog.defaultAgentId);
+	if (agent && agent.workspace !== workspacePath) await service.update(catalog.defaultAgentId, { workspace: workspacePath });
+	return config;
 }
 function formatRecommended(provider) {
 	const labels = getRecommendedModelsForProvider(provider, 3).map((m) => m.name || m.id);
@@ -438,7 +430,7 @@ async function ensureProviderCredential(provider, providerName) {
 async function setupModel(existingConfig, ctx) {
 	console.log("\n🤖 Step: AI Model\n");
 	const config = existingConfig || {};
-	const currentModel = getAgentDefaultModelRef(config);
+	const currentModel = getAgentDefaultModelRef();
 	if (currentModel) {
 		console.log("Current model:", currentModel);
 		if (await confirm({

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

@@ -1,7 +1,8 @@
 import { init_paths_state, resolveStateDir } from "../../config/paths-state.js";
+import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
 import { ConfigSchema, init_schema } from "../../config/schema.js";
-import { saveConfig } from "../../config/loader.js";
 import { resolveGatewayLocalClientHost } from "../../config/gateway-bind.js";
+import { saveConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import "../../config/index.js";
 import { provisionEagerRuntimes } from "../../runtime-tools/bootstrap.js";
@@ -13,6 +14,7 @@ import { setupChannels } from "./onboard/channels/index.js";
 import { select } from "@inquirer/prompts";
 import { Command } from "commander";
 //#region src/cli/commands/onboard.ts
+init_repository();
 init_schema();
 init_paths_state();
 function isInteractive() {
@@ -24,7 +26,7 @@ function printGitHubStarHint() {
 }
 async function setupNonInteractive(_configPath, existingConfig) {
 	console.log("\n🤖 AI Model Configuration (Non-Interactive Mode)\n");
-	console.log("Current agent overrides:", JSON.stringify(existingConfig.agents?.list ?? [], null, 2));
+	console.log("Current Agent overrides:", JSON.stringify(new AgentCatalogRepository().snapshot().agents, null, 2));
 	console.log("\n💡 To configure in interactive mode, run: xopc onboard");
 	console.log("💡 Or set up manually in:", _configPath);
 	return existingConfig;

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

@@ -4,6 +4,7 @@ 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 "../../auth/profiles/index.js";
 import { Command } from "commander";
 //#region src/cli/commands/platform.ts
 async function readStdin() {

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

@@ -1,16 +1,16 @@
 import { closeXopcDatabase, isXopcDatabaseOpen, openXopcDatabase } from "../../storage/sqlite/connection.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
-import "../../storage/sqlite/index.js";
-import { init_loader, loadConfig } from "../../config/loader.js";
+import { init_sqlite } from "../../storage/sqlite/index.js";
 import { ProjectService } from "../../projects/project-service.js";
 import { isValidProjectAgentId, normalizeProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
 import "../../tasks/index.js";
+import { loadConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import { Command } from "commander";
 //#region src/cli/commands/project.ts
-init_loader();
+init_sqlite();
 function parseStatus(raw) {
 	return raw === "active" || raw === "paused" || raw === "archived" ? raw : void 0;
 }

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

@@ -3,6 +3,7 @@ import { PROVIDER_META, getAllProviders, getSortedProviders, init_providers } fr
 import { formatExamples, register } from "../registry.js";
 import { colors } from "../utils/colors.js";
 import { getProfile, listAllProfiles, listProfilesForProvider, removeAuthProfile, upsertAuthProfile } from "../../auth/profiles/profiles.js";
+import "../../auth/profiles/index.js";
 import { SETUP_EXIT } from "./setup-shared/types.js";
 import { emitTask } from "./setup-shared/output.js";
 import { isPromptCancelled, promptSecret } from "./setup-shared/prompts.js";

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

@@ -1,11 +1,10 @@
 import { init_paths_state, resolveStateDir } from "../../config/paths-state.js";
-import { init_loader, loadConfig } from "../../config/loader.js";
 import { ManagedRuntimeManager } from "../../runtime-tools/manager.js";
+import { loadConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import { pruneRuntimeTools } from "../../runtime-tools/prune.js";
 import { Command } from "commander";
 //#region src/cli/commands/runtime.ts
-init_loader();
 init_paths_state();
 const RUNTIMES = [
 	"node",

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

@@ -1,5 +1,5 @@
 import { init_paths, resolveConfigPath } from "../../config/paths.js";
-import { init_loader, loadConfig } from "../../config/loader.js";
+import { loadConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import { colors } from "../utils/colors.js";
 import { SETUP_EXIT } from "./setup-shared/types.js";
@@ -15,7 +15,6 @@ import { Command } from "commander";
 * Backed by `cfg.tools.web.search.providers[]` per `SearchProviderEntrySchema`.
 * Adds entries idempotently keyed by `type` (brave / tavily / bing / searxng).
 */
-init_loader();
 init_paths();
 const SEARCH_TYPES = [
 	"brave",

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

@@ -1,6 +1,5 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths, resolveBundledSkillsDir, resolveSkillsLockPath } from "../../config/paths.js";
-import { init_loader, loadConfig } from "../../config/loader.js";
 import { findInstallSpec, hasBinary, installSkill } from "../../agent/skills/installer.js";
 import { createSkillConfigManager, isSkillEnabled } from "../../agent/skills/config.js";
 import { formatScanSummary, scanSkillDirectory } from "../../agent/skills/scanner.js";
@@ -8,6 +7,7 @@ import { createSkillLoader } from "../../agent/skills/index.js";
 import { loadSkillsLock } from "../../agent/skills/hub-lock.js";
 import { pullSkillFromSource, updateSkillFromLock } from "../../agent/skills/hub-pull.js";
 import { ProjectTrustStore } from "../../project-trust/trust-store.js";
+import { loadConfig } from "../../config/loader.js";
 import { register } from "../registry.js";
 import { createSkillsTestCommand } from "./skills-test.js";
 import { Command } from "commander";
@@ -18,7 +18,6 @@ import { Command } from "commander";
 * Manage skills: list, install, enable/disable, configure, test
 */
 init_paths();
-init_loader();
 function loadWorkspaceSkillCatalog(workspaceDir, options = {}) {
 	const trustStore = options.trustStore ?? new ProjectTrustStore();
 	const loader = createSkillLoader({ isWorkspaceTrusted: (resolvedPath) => trustStore.get(resolvedPath) === true });

package/dist/src/cli/commands/tui-runner.js

@@ -1,8 +1,9 @@
+import { detectMigrations } from "../../migrations/runner.js";
+import { bootstrapApplicationStateSync } from "../../bootstrap/application-state.js";
 import { createGatewayCredential } from "../../gateway/credential.js";
-import { detectMigrations, runBootstrapMigrationsSync } from "../../migrations/runner.js";
 //#region src/cli/commands/tui-runner.ts
 function prepareTuiStartup(configPath) {
-	runBootstrapMigrationsSync(configPath);
+	bootstrapApplicationStateSync(configPath);
 	const pendingMigrations = detectMigrations(configPath);
 	if (pendingMigrations.length > 0) console.warn(`xopc has ${pendingMigrations.length} pending migration(s). Run \`xopc doctor --fix\` or open Settings → App management.`);
 }

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

@@ -1,10 +1,8 @@
-import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
-import { setTuiDefaultAgentConfig } from "../../commands/agents.config.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { formatExamples, register } from "../registry.js";
 import { prepareTuiStartup, runTuiFromCliOptions } from "./tui-runner.js";
 import { Command } from "commander";
 //#region src/cli/commands/tui.ts
-init_loader();
 function createTuiCommand(ctx) {
 	return new Command("tui").description("Interactive terminal UI (pi-tui)").addHelpText("after", formatExamples([
 		"xopc                                        # Open embedded TUI (default command)",
@@ -19,13 +17,13 @@ function createTuiCommand(ctx) {
 	])).option("--url <url>", "Gateway URL (default: http://localhost:3120)").option("--token <token>", "Gateway bearer token").option("--password-env <name>", "Environment variable holding the gateway password").option("-s, --session <key>", "Session key to resume (omitted: start a fresh TUI session)").option("--agent <id>", "Agent id for a fresh TUI session").option("--set-default-agent <id>", "Persist default agent for new TUI sessions and exit").option("-m, --message <text>", "Send a message on launch").option("--workdir <dir>", "Workspace directory for the new TUI session").option("--no-cwd", "Do not use the launch directory as the new TUI session workspace").option("--local", "Run in embedded mode (no gateway required)").option("--gateway", "Force gateway mode even without an explicit URL or credential").option("--theme <name>", "Theme: auto, dark, light, or custom name from ~/.xopc/themes/").option("--thinking <level>", "Thinking level override").action(async (options) => {
 		prepareTuiStartup(ctx.configPath);
 		if (typeof options.setDefaultAgent === "string") {
-			const result = setTuiDefaultAgentConfig(loadConfig(ctx.configPath), options.setDefaultAgent);
-			if (result.ok === false) {
-				console.error(`Error: ${result.message}`);
+			try {
+				new AgentCatalogService().setSurfaceDefault("tui", options.setDefaultAgent);
+			} catch (error) {
+				console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
 				process.exit(1);
 			}
-			await saveConfig(result.config, ctx.configPath);
-			console.log(`TUI default agent set to "${result.agentId}".`);
+			console.log(`TUI default Agent set to "${options.setDefaultAgent.trim().toLowerCase()}".`);
 			return;
 		}
 		await runTuiFromCliOptions(options);

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

@@ -1,12 +1,12 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_connection, isXopcDatabaseOpen, openXopcDatabase } from "../../storage/sqlite/connection.js";
-import { loadConfig, saveConfig } from "../../config/loader.js";
 import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
 import { ensureFrpcBinary } from "../../tunnel/frpc-binary.js";
 import { resolveTunnelBrokerUrl, resolveTunnelRegistrationSecret } from "../../tunnel/env.js";
 import { loadTunnelState } from "../../tunnel/tunnel-state.js";
 import { getTunnelService } from "../../tunnel/tunnel-service.js";
+import { loadConfig, saveConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import "../../config/index.js";
 import { resolveGatewayAuth } from "../../gateway/auth.js";

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

@@ -1,5 +1,5 @@
 import { init_paths, resolveConfigPath } from "../../config/paths.js";
-import { init_loader, loadConfig } from "../../config/loader.js";
+import { loadConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import { colors } from "../utils/colors.js";
 import { emitTask } from "./setup-shared/output.js";
@@ -14,7 +14,6 @@ import { Command } from "commander";
 * runner so every action emits the same `SetupTask` JSON consumed by M2
 * skills and the M3 WebUI.
 */
-init_loader();
 init_paths();
 const TTS_PROVIDERS = [
 	"openai",

package/dist/src/cli/extension-cli-register.js

@@ -1,7 +1,7 @@
-import { loadConfig } from "../config/loader.js";
 import { collectConfiguredChannelIds } from "../extensions/activation-context.js";
 import { ExtensionLoader } from "../extensions/loader.js";
 import "../extensions/index.js";
+import { loadConfig } from "../config/loader.js";
 import { MessageBus } from "../infra/bus/queue.js";
 import "../infra/bus/index.js";
 import { createDefaultContext } from "./registry.js";

package/dist/src/cli/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { version } from "../../package.js";
+import { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
 import { isHelpOrVersionInvocation } from "./argv.js";
 import { ROOT_COMMAND_DESCRIPTION } from "./command-manifest.js";
 import { loadAllCommands, resolveCommandName, tryLoadCommand } from "./command-loaders.js";
@@ -20,12 +21,13 @@ function argvWithDefaultCommand(argv, defaultCommand = "tui") {
 function isExtensionsDevCommand(command) {
 	return command.name() === "dev" && command.parent?.name() === "extensions";
 }
-function buildProgram() {
+function buildProgram(ctx) {
 	const program = new Command().name("xopc").description(ROOT_COMMAND_DESCRIPTION).version(version).option("--verbose", "Enable verbose logging", false).option("--config <path>", "Config file path").option("--workspace <path>", "Workspace directory");
 	program.hook("preAction", (thisCommand) => {
 		const next = thisCommand.opts();
 		for (const k of Object.keys(parsedOpts)) delete parsedOpts[k];
 		Object.assign(parsedOpts, next);
+		bootstrapApplicationStateSync(ctx.configPath);
 	});
 	program.hook("postAction", async (_hookOwner, actionCommand) => {
 		const cmd = actionCommand ?? program;
@@ -42,8 +44,8 @@ function buildProgram() {
 	return program;
 }
 async function runCli(argv = process.argv) {
-	const program = buildProgram();
 	const ctx = getContextWithOpts(argv);
+	const program = buildProgram(ctx);
 	const argvToParse = argvWithDefaultCommand(argv.filter((arg, index) => {
 		if (arg !== "--") return true;
 		return index < 2;

package/dist/src/cli/utils/gateway-client.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveConfigPath } from "../../config/paths.js";
-import { loadConfig } from "../../config/loader.js";
 import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
+import { loadConfig } from "../../config/loader.js";
 import "../../config/index.js";
 import { createGatewayCredential, gatewayCredentialAuthorization } from "../../gateway/credential.js";
 import { assertSecureGatewayHttpUrl } from "../../gateway/ws-security.js";

package/dist/src/cli/utils/init-workspace-core.js

@@ -1,13 +1,15 @@
+import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { ConfigSchema, init_schema } from "../../config/schema.js";
-import { assertConfigRewriteSafeForRunningGateway, init_loader, saveConfig } from "../../config/loader.js";
+import { assertConfigRewriteSafeForRunningGateway, saveConfig } from "../../config/loader.js";
 import { ensureStarterAgentsInitialized } from "../../agent/starter-agents.js";
-import { runBootstrapMigrationsSync } from "../../migrations/runner.js";
+import { bootstrapApplicationStateSync } from "../../bootstrap/application-state.js";
 import { dirname } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { randomBytes } from "node:crypto";
 //#region src/cli/utils/init-workspace-core.ts
 init_schema();
-init_loader();
+init_repository();
 async function assertChannelPluginsIfNeeded(cfg, assert) {
 	if (assert) await assert(cfg);
 }
@@ -33,7 +35,7 @@ async function initWorkspaceCore(options) {
 	const persistedWorkspaceRoot = persistWorkspacePath ? workspacePath : void 0;
 	mkdirSync(dirname(configPath), { recursive: true });
 	const configExisted = existsSync(configPath);
-	if (configExisted) runBootstrapMigrationsSync(configPath, { stateDir: dirname(configPath) });
+	bootstrapApplicationStateSync(configPath);
 	const workspaceExisted = existsSync(workspacePath);
 	let config;
 	if (configExisted) config = await readDiskConfig(configPath, assertChannelPlugins);
@@ -46,17 +48,14 @@ async function initWorkspaceCore(options) {
 	const workspaceCreated = !workspaceExisted;
 	const token = config.gateway?.auth?.mode === "token" && typeof config.gateway?.auth?.token === "string" && config.gateway.auth.token.length > 0 ? config.gateway.auth.token : randomBytes(24).toString("hex");
 	const port = configExisted ? config.gateway?.port ?? gatewayPortDefaulted : options.gatewayPort !== void 0 ? gatewayPortDefaulted : config.gateway?.port ?? 18790;
-	const defaultAgentId = config.agents.default ?? config.agents.list[0]?.id ?? "main";
-	const agentsList = persistedWorkspaceRoot === void 0 ? config.agents.list : config.agents.list.map((agent) => agent.id === defaultAgentId ? {
-		...agent,
-		workspace: persistedWorkspaceRoot
-	} : agent);
+	if (persistedWorkspaceRoot !== void 0) {
+		const repository = new AgentCatalogRepository();
+		const defaultAgentId = repository.getSettings().defaultAgentId;
+		const agent = repository.get(defaultAgentId);
+		if (agent && agent.workspace !== persistedWorkspaceRoot) await new AgentCatalogService(repository).update(defaultAgentId, { workspace: persistedWorkspaceRoot });
+	}
 	const nextConfig = {
 		...config,
-		agents: {
-			...config.agents,
-			list: agentsList
-		},
 		gateway: {
 			...config.gateway,
 			port,
@@ -67,10 +66,10 @@ async function initWorkspaceCore(options) {
 			}
 		}
 	};
-	const starterResult = ensureStarterAgentsInitialized(ConfigSchema.parse(nextConfig));
-	const nextFinal = ConfigSchema.parse(starterResult.config);
+	ensureStarterAgentsInitialized();
+	const nextFinal = ConfigSchema.parse(nextConfig);
 	await assertChannelPluginsIfNeeded(nextFinal, assertChannelPlugins);
-	let needsWrite = configCreated || starterResult.changed;
+	let needsWrite = configCreated;
 	if (!needsWrite) needsWrite = await serializeConfig(await readDiskConfig(configPath, assertChannelPlugins), assertChannelPlugins) !== await serializeConfig(nextFinal, assertChannelPlugins);
 	if (needsWrite) if (assertChannelPlugins) await saveConfig(nextFinal, configPath);
 	else {

package/dist/src/cli/utils/session.js

@@ -1,11 +1,10 @@
-import { init_loader, loadConfig } from "../../config/loader.js";
 import { SessionIndex } from "../../session/manager.js";
 import "../../session/index.js";
+import { loadConfig } from "../../config/loader.js";
 //#region src/cli/utils/session.ts
 /**
 * Session management utilities for CLI commands
 */
-init_loader();
 /**
 * Get initialized SessionManager instance
 * Eliminates repeated initialization boilerplate

package/dist/src/computer/model-config.d.ts

@@ -1,3 +1,3 @@
-import type { Config } from '../config/schema.js';
-/** Validate only changed bindings, so a withdrawn model cannot block unrelated settings. */
-export declare function validateComputerModelChanges(next: Config, previous: Config): void;
+import type { AgentModelsDefaults } from '../agent-config/index.js';
+/** Validate only a changed route, so a withdrawn model cannot block unrelated settings. */
+export declare function validateComputerModelChange(next: AgentModelsDefaults['computerUse'] | null | undefined, previous: AgentModelsDefaults['computerUse'] | null | undefined): void;