@xopcai/xopc 0.0.89 → 0.0.90

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

@@ -2,14 +2,15 @@ import { PACKAGE_VERSION, init_package_version } from "../../package-version.js"
 import { loadConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import "../../config/index.js";
+import { acquireUpdateLock } from "../../infra/update-lock.js";
 import { normalizeUpdateChannel } from "../../infra/update-channels.js";
-import { compareSemver, detectInstallKind, resolveNpmChannelTag, resolvePackageRoot } from "../../infra/update-check.js";
-import { formatGlobalInstallFailure, resolveGlobalInstallSpec, resolveGlobalManager, runGlobalPackageInstall } from "../../infra/update-global.js";
+import { compareSemver, resolveNpmChannelTag } from "../../infra/update-check.js";
+import { formatUpdateApiResult, resolveUpdateInstallSurface, runGatewayUpdateWithPostSteps } from "../../infra/update-runner.js";
 import { Command } from "commander";
 //#region src/cli/commands/update.ts
 init_package_version();
 function createUpdateCommand(_ctx) {
-	return new Command("update").description("Check for and install xopc updates").option("--check", "Only check for updates without installing").option("--yes", "Skip confirmation prompts").option("--channel <channel>", "Update channel: stable, beta, or dev (default: from config, else stable)").option("--json", "Output results as JSON").addHelpText("after", formatExamples([
+	return new Command("update").description("Check for and install xopc updates").option("--check", "Only check for updates without installing").option("--yes", "Skip confirmation prompts").option("--channel <channel>", "Update channel: stable, beta, or dev").option("--json", "Output results as JSON").option("--no-restart", "Skip gateway restart after a successful update").addHelpText("after", formatExamples([
 		"xopc update",
 		"xopc update --check",
 		"xopc update --channel beta",
@@ -25,50 +26,51 @@ function createUpdateCommand(_ctx) {
 			}
 		})();
 		const channel = normalizeUpdateChannel(fromCli ?? fromConfig) ?? "stable";
-		const root = await resolvePackageRoot();
-		if (root) {
-			if (await detectInstallKind(root) === "git") {
-				const message = "Running from a git checkout. Use `git pull` to update instead.";
+		const surface = await resolveUpdateInstallSurface({
+			cwd: process.cwd(),
+			argv1: process.argv[1]
+		});
+		if (options.check) {
+			if (surface.kind === "git") {
+				const message = "Git checkout detected. Run `xopc update` to pull/rebase and build.";
 				if (options.json) console.log(JSON.stringify({
-					status: "skipped",
-					reason: "git-checkout",
+					status: "git-checkout",
+					mode: "git",
 					message
 				}));
 				else console.log(message);
 				return;
 			}
-		}
-		if (!options.json) console.log(`Checking for updates (channel: ${channel})...`);
-		const resolved = await resolveNpmChannelTag({ channel });
-		if (!resolved.version) {
-			const message = "Could not reach npm registry. Check your network connection.";
-			if (options.json) console.log(JSON.stringify({
-				status: "error",
-				reason: "registry-unreachable",
-				message
-			}));
-			else console.error(message);
-			process.exit(1);
-		}
-		const comparison = compareSemver(PACKAGE_VERSION, resolved.version);
-		if (comparison === null || comparison >= 0) {
-			const message = `Already up to date: v${PACKAGE_VERSION} (${resolved.tag}: v${resolved.version})`;
-			if (options.json) console.log(JSON.stringify({
-				status: "up-to-date",
-				currentVersion: PACKAGE_VERSION,
-				latestVersion: resolved.version,
-				channel: resolved.tag
-			}));
-			else console.log(`✅ ${message}`);
-			return;
-		}
-		if (options.check) {
+			const resolved = await resolveNpmChannelTag({ channel });
+			if (!resolved.version) {
+				const message = "Could not reach npm registry. Check your network connection.";
+				if (options.json) console.log(JSON.stringify({
+					status: "error",
+					reason: "registry-unreachable",
+					message
+				}));
+				else console.error(message);
+				process.exit(1);
+			}
+			const comparison = compareSemver(PACKAGE_VERSION, resolved.version);
+			if (comparison === null || comparison >= 0) {
+				const message = `Already up to date: v${PACKAGE_VERSION} (${resolved.tag}: v${resolved.version})`;
+				if (options.json) console.log(JSON.stringify({
+					status: "up-to-date",
+					currentVersion: PACKAGE_VERSION,
+					latestVersion: resolved.version,
+					channel: resolved.tag
+				}));
+				else console.log(`✅ ${message}`);
+				return;
+			}
 			const message = `Update available: v${PACKAGE_VERSION} → v${resolved.version} (${resolved.tag})`;
 			if (options.json) console.log(JSON.stringify({
 				status: "update-available",
 				currentVersion: PACKAGE_VERSION,
 				latestVersion: resolved.version,
-				channel: resolved.tag
+				channel: resolved.tag,
+				installSurface: surface.kind
 			}));
 			else {
 				console.log(`📦 ${message}`);
@@ -79,17 +81,13 @@ function createUpdateCommand(_ctx) {
 		if (!options.yes && !process.env.XOPC_AUTO_UPDATE) {
 			const { confirm } = await import("@inquirer/prompts");
 			if (!await confirm({
-				message: `Update from v${PACKAGE_VERSION} to v${resolved.version} (${resolved.tag})?`,
+				message: surface.kind === "git" ? `Update git checkout via ${channel} channel?` : `Update from v${PACKAGE_VERSION} (${channel})?`,
 				default: true
 			})) {
 				console.log("Update cancelled.");
 				return;
 			}
 		}
-		const packageManager = await resolveGlobalManager({ root });
-		const spec = resolveGlobalInstallSpec({ version: resolved.version });
-		if (!options.json) console.log(`Installing ${spec} via ${packageManager}...`);
-		const { acquireUpdateLock } = await import("../../infra/update-lock.js");
 		const lock = process.env.XOPC_AUTO_UPDATE ? { release: async () => {} } : await acquireUpdateLock("cli");
 		if (!lock) {
 			const message = "Another update is already in progress. Try again later.";
@@ -101,50 +99,59 @@ function createUpdateCommand(_ctx) {
 			else console.error(`❌ ${message}`);
 			process.exit(1);
 		}
-		let installResult;
 		try {
-			installResult = await runGlobalPackageInstall({
-				manager: packageManager,
-				spec,
-				pkgRoot: root,
-				echoToTerminal: !options.json
-			});
-		} finally {
-			await lock.release();
-		}
-		if (installResult.exitCode === 0) if (options.json) console.log(JSON.stringify({
-			status: "ok",
-			previousVersion: PACKAGE_VERSION,
-			installedVersion: resolved.version,
-			channel: resolved.tag,
-			packageManager: installResult.packageManager
-		}));
-		else {
-			console.log(`✅ Updated to v${resolved.version}`);
-			console.log("Restart the gateway to use the new version: xopc gateway restart");
-		}
-		else {
-			const message = formatGlobalInstallFailure({
-				packageManager: installResult.packageManager,
-				spec,
-				exitCode: installResult.exitCode,
-				stderr: installResult.stderr,
-				usedFallback: installResult.usedFallback
+			if (!options.json) console.log(`Running update (channel: ${channel}, surface: ${surface.kind})...`);
+			const result = await runGatewayUpdateWithPostSteps({
+				channel,
+				cwd: process.cwd(),
+				argv1: process.argv[1],
+				shouldRestart: options.restart !== false,
+				progress: options.json ? void 0 : {
+					onStepStart: (step) => {
+						console.log(`→ [${step.index + 1}/${step.total}] ${step.name}`);
+					},
+					onStepComplete: (step) => {
+						if (step.exitCode !== 0 && step.stderrTail) console.error(step.stderrTail);
+					}
+				}
 			});
+			const apiResult = formatUpdateApiResult(result, channel);
+			if (result.status === "ok") {
+				if (options.json) console.log(JSON.stringify(apiResult));
+				else {
+					console.log(`✅ Updated to v${result.after?.version ?? "unknown"} (${result.mode})`);
+					const updatedExt = (result.postUpdate?.extensions?.outcomes ?? []).filter((o) => o.status === "updated");
+					if (updatedExt.length > 0) console.log(`Extensions synced: ${updatedExt.map((o) => o.extensionId).join(", ")}`);
+					const restart = result.postUpdate?.restart;
+					if (restart?.ok && restart.mode !== "skipped") console.log(`Gateway restart: ${restart.message ?? restart.mode}`);
+					else if (!restart?.ok) console.log(restart?.message ?? "Restart the gateway to use the new version: xopc gateway restart");
+				}
+				return;
+			}
+			if (result.status === "skipped") {
+				if (options.json) console.log(JSON.stringify({
+					status: "skipped",
+					reason: result.reason,
+					...apiResult
+				}));
+				else if (result.reason === "up-to-date") console.log(`✅ Already up to date: v${PACKAGE_VERSION}`);
+				else if (result.reason === "dirty") {
+					console.error("❌ Git working tree has uncommitted changes. Commit or stash first.");
+					process.exit(1);
+				} else console.log(`Update skipped: ${result.reason ?? "unknown"}`);
+				return;
+			}
+			const message = typeof apiResult.message === "string" ? apiResult.message : result.reason ?? "Update failed";
 			if (options.json) console.log(JSON.stringify({
 				status: "error",
-				reason: "install-failed",
-				exitCode: installResult.exitCode,
-				packageManager: installResult.packageManager,
-				usedFallback: installResult.usedFallback,
-				stderrTail: installResult.stderr.trim().slice(-4e3) || void 0,
-				message
+				reason: result.reason,
+				message,
+				...apiResult
 			}));
-			else {
-				console.error(`❌ Update failed (exit code ${installResult.exitCode})`);
-				console.error(message);
-			}
+			else console.error(`❌ Update failed: ${message}`);
 			process.exit(1);
+		} finally {
+			await lock.release();
 		}
 	});
 }

package/dist/src/cli/commands/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","names":[],"sources":["../../../../src/cli/commands/update.ts"],"sourcesContent":["// src/cli/commands/update.ts\n\nimport { Command } from 'commander';\n\nimport { loadConfig } from '../../config/index.js';\nimport {\n  formatGlobalInstallFailure,\n  resolveGlobalInstallSpec,\n  resolveGlobalManager,\n  runGlobalPackageInstall,\n} from '../../infra/update-global.js';\nimport { normalizeUpdateChannel, DEFAULT_PACKAGE_CHANNEL } from '../../infra/update-channels.js';\nimport {\n  resolveNpmChannelTag,\n  compareSemver,\n  detectInstallKind,\n  resolvePackageRoot,\n} from '../../infra/update-check.js';\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { register, formatExamples, type CLIContext } from '../registry.js';\n\nfunction createUpdateCommand(_ctx: CLIContext): Command {\n  return new Command('update')\n    .description('Check for and install xopc updates')\n    .option('--check', 'Only check for updates without installing')\n    .option('--yes', 'Skip confirmation prompts')\n    .option('--channel <channel>', 'Update channel: stable, beta, or dev (default: from config, else stable)')\n    .option('--json', 'Output results as JSON')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc update',\n        'xopc update --check',\n        'xopc update --channel beta',\n        'xopc update --yes',\n        'xopc update --json',\n      ]),\n    )\n    .action(\n      async (options: { check?: boolean; yes?: boolean; channel?: string; json?: boolean }) => {\n        const fromCli = options.channel;\n        const fromConfig = (() => {\n          try {\n            return loadConfig().update?.channel;\n          } catch {\n            return undefined;\n          }\n        })();\n        const channel = normalizeUpdateChannel(fromCli ?? fromConfig) ?? DEFAULT_PACKAGE_CHANNEL;\n\n        const root = await resolvePackageRoot();\n        if (root) {\n          const installKind = await detectInstallKind(root);\n          if (installKind === 'git') {\n            const message = 'Running from a git checkout. Use `git pull` to update instead.';\n            if (options.json) {\n              console.log(JSON.stringify({ status: 'skipped', reason: 'git-checkout', message }));\n            } else {\n              console.log(message);\n            }\n            return;\n          }\n        }\n\n        if (!options.json) {\n          console.log(`Checking for updates (channel: ${channel})...`);\n        }\n\n        const resolved = await resolveNpmChannelTag({ channel });\n        if (!resolved.version) {\n          const message = 'Could not reach npm registry. Check your network connection.';\n          if (options.json) {\n            console.log(JSON.stringify({ status: 'error', reason: 'registry-unreachable', message }));\n          } else {\n            console.error(message);\n          }\n          process.exit(1);\n        }\n\n        const comparison = compareSemver(PACKAGE_VERSION, resolved.version);\n        if (comparison === null || comparison >= 0) {\n          const message = `Already up to date: v${PACKAGE_VERSION} (${resolved.tag}: v${resolved.version})`;\n          if (options.json) {\n            console.log(\n              JSON.stringify({\n                status: 'up-to-date',\n                currentVersion: PACKAGE_VERSION,\n                latestVersion: resolved.version,\n                channel: resolved.tag,\n              }),\n            );\n          } else {\n            console.log(`✅ ${message}`);\n          }\n          return;\n        }\n\n        if (options.check) {\n          const message = `Update available: v${PACKAGE_VERSION} → v${resolved.version} (${resolved.tag})`;\n          if (options.json) {\n            console.log(\n              JSON.stringify({\n                status: 'update-available',\n                currentVersion: PACKAGE_VERSION,\n                latestVersion: resolved.version,\n                channel: resolved.tag,\n              }),\n            );\n          } else {\n            console.log(`📦 ${message}`);\n            console.log('Run `xopc update` to install.');\n          }\n          return;\n        }\n\n        if (!options.yes && !process.env.XOPC_AUTO_UPDATE) {\n          const { confirm } = await import('@inquirer/prompts');\n          const shouldUpdate = await confirm({\n            message: `Update from v${PACKAGE_VERSION} to v${resolved.version} (${resolved.tag})?`,\n            default: true,\n          });\n          if (!shouldUpdate) {\n            console.log('Update cancelled.');\n            return;\n          }\n        }\n\n        const packageManager = await resolveGlobalManager({ root });\n        const spec = resolveGlobalInstallSpec({ version: resolved.version });\n\n        if (!options.json) {\n          console.log(`Installing ${spec} via ${packageManager}...`);\n        }\n\n        const { acquireUpdateLock } = await import('../../infra/update-lock.js');\n        const lock = process.env.XOPC_AUTO_UPDATE\n          ? { release: async () => {} }\n          : await acquireUpdateLock('cli');\n        if (!lock) {\n          const message = 'Another update is already in progress. Try again later.';\n          if (options.json) {\n            console.log(JSON.stringify({ status: 'error', reason: 'lock-held', message }));\n          } else {\n            console.error(`❌ ${message}`);\n          }\n          process.exit(1);\n        }\n\n        let installResult: Awaited<ReturnType<typeof runGlobalPackageInstall>>;\n        try {\n          installResult = await runGlobalPackageInstall({\n            manager: packageManager,\n            spec,\n            pkgRoot: root,\n            echoToTerminal: !options.json,\n          });\n        } finally {\n          await lock.release();\n        }\n\n        if (installResult.exitCode === 0) {\n          if (options.json) {\n            console.log(\n              JSON.stringify({\n                status: 'ok',\n                previousVersion: PACKAGE_VERSION,\n                installedVersion: resolved.version,\n                channel: resolved.tag,\n                packageManager: installResult.packageManager,\n              }),\n            );\n          } else {\n            console.log(`✅ Updated to v${resolved.version}`);\n            console.log('Restart the gateway to use the new version: xopc gateway restart');\n          }\n        } else {\n          const message = formatGlobalInstallFailure({\n            packageManager: installResult.packageManager,\n            spec,\n            exitCode: installResult.exitCode,\n            stderr: installResult.stderr,\n            usedFallback: installResult.usedFallback,\n          });\n          if (options.json) {\n            console.log(\n              JSON.stringify({\n                status: 'error',\n                reason: 'install-failed',\n                exitCode: installResult.exitCode,\n                packageManager: installResult.packageManager,\n                usedFallback: installResult.usedFallback,\n                stderrTail: installResult.stderr.trim().slice(-4000) || undefined,\n                message,\n              }),\n            );\n          } else {\n            console.error(`❌ Update failed (exit code ${installResult.exitCode})`);\n            console.error(message);\n          }\n          process.exit(1);\n        }\n      },\n    );\n}\n\nregister({\n  id: 'update',\n  name: 'update',\n  description: 'Check for and install xopc updates',\n  factory: createUpdateCommand,\n  metadata: {\n    category: 'maintenance',\n    examples: [\n      'xopc update',\n      'xopc update --check',\n      'xopc update --channel beta',\n      'xopc update --yes --json',\n    ],\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"update.js","names":[],"sources":["../../../../src/cli/commands/update.ts"],"sourcesContent":["// src/cli/commands/update.ts\n\nimport { Command } from 'commander';\n\nimport { loadConfig } from '../../config/index.js';\nimport { acquireUpdateLock } from '../../infra/update-lock.js';\nimport { normalizeUpdateChannel, DEFAULT_PACKAGE_CHANNEL } from '../../infra/update-channels.js';\nimport {\n  resolveNpmChannelTag,\n  compareSemver,\n} from '../../infra/update-check.js';\nimport {\n  formatUpdateApiResult,\n  resolveUpdateInstallSurface,\n  runGatewayUpdateWithPostSteps,\n} from '../../infra/update-runner.js';\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { register, formatExamples, type CLIContext } from '../registry.js';\n\nfunction createUpdateCommand(_ctx: CLIContext): Command {\n  return new Command('update')\n    .description('Check for and install xopc updates')\n    .option('--check', 'Only check for updates without installing')\n    .option('--yes', 'Skip confirmation prompts')\n    .option('--channel <channel>', 'Update channel: stable, beta, or dev')\n    .option('--json', 'Output results as JSON')\n    .option('--no-restart', 'Skip gateway restart after a successful update')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc update',\n        'xopc update --check',\n        'xopc update --channel beta',\n        'xopc update --yes',\n        'xopc update --json',\n      ]),\n    )\n    .action(\n      async (options: {\n        check?: boolean;\n        yes?: boolean;\n        channel?: string;\n        json?: boolean;\n        restart?: boolean;\n      }) => {\n        const fromCli = options.channel;\n        const fromConfig = (() => {\n          try {\n            return loadConfig().update?.channel;\n          } catch {\n            return undefined;\n          }\n        })();\n        const channel = normalizeUpdateChannel(fromCli ?? fromConfig) ?? DEFAULT_PACKAGE_CHANNEL;\n\n        const surface = await resolveUpdateInstallSurface({\n          cwd: process.cwd(),\n          argv1: process.argv[1],\n        });\n\n        if (options.check) {\n          if (surface.kind === 'git') {\n            const message = 'Git checkout detected. Run `xopc update` to pull/rebase and build.';\n            if (options.json) {\n              console.log(JSON.stringify({ status: 'git-checkout', mode: 'git', message }));\n            } else {\n              console.log(message);\n            }\n            return;\n          }\n\n          const resolved = await resolveNpmChannelTag({ channel });\n          if (!resolved.version) {\n            const message = 'Could not reach npm registry. Check your network connection.';\n            if (options.json) {\n              console.log(JSON.stringify({ status: 'error', reason: 'registry-unreachable', message }));\n            } else {\n              console.error(message);\n            }\n            process.exit(1);\n          }\n\n          const comparison = compareSemver(PACKAGE_VERSION, resolved.version);\n          if (comparison === null || comparison >= 0) {\n            const message = `Already up to date: v${PACKAGE_VERSION} (${resolved.tag}: v${resolved.version})`;\n            if (options.json) {\n              console.log(\n                JSON.stringify({\n                  status: 'up-to-date',\n                  currentVersion: PACKAGE_VERSION,\n                  latestVersion: resolved.version,\n                  channel: resolved.tag,\n                }),\n              );\n            } else {\n              console.log(`✅ ${message}`);\n            }\n            return;\n          }\n\n          const message = `Update available: v${PACKAGE_VERSION} → v${resolved.version} (${resolved.tag})`;\n          if (options.json) {\n            console.log(\n              JSON.stringify({\n                status: 'update-available',\n                currentVersion: PACKAGE_VERSION,\n                latestVersion: resolved.version,\n                channel: resolved.tag,\n                installSurface: surface.kind,\n              }),\n            );\n          } else {\n            console.log(`📦 ${message}`);\n            console.log('Run `xopc update` to install.');\n          }\n          return;\n        }\n\n        if (!options.yes && !process.env.XOPC_AUTO_UPDATE) {\n          const { confirm } = await import('@inquirer/prompts');\n          const label =\n            surface.kind === 'git'\n              ? `Update git checkout via ${channel} channel?`\n              : `Update from v${PACKAGE_VERSION} (${channel})?`;\n          const shouldUpdate = await confirm({ message: label, default: true });\n          if (!shouldUpdate) {\n            console.log('Update cancelled.');\n            return;\n          }\n        }\n\n        const lock = process.env.XOPC_AUTO_UPDATE\n          ? { release: async () => {} }\n          : await acquireUpdateLock('cli');\n        if (!lock) {\n          const message = 'Another update is already in progress. Try again later.';\n          if (options.json) {\n            console.log(JSON.stringify({ status: 'error', reason: 'lock-held', message }));\n          } else {\n            console.error(`❌ ${message}`);\n          }\n          process.exit(1);\n        }\n\n        try {\n          if (!options.json) {\n            console.log(`Running update (channel: ${channel}, surface: ${surface.kind})...`);\n          }\n\n          const result = await runGatewayUpdateWithPostSteps({\n            channel,\n            cwd: process.cwd(),\n            argv1: process.argv[1],\n            shouldRestart: options.restart !== false,\n            progress: options.json\n              ? undefined\n              : {\n                  onStepStart: (step) => {\n                    console.log(`→ [${step.index + 1}/${step.total}] ${step.name}`);\n                  },\n                  onStepComplete: (step) => {\n                    if (step.exitCode !== 0 && step.stderrTail) {\n                      console.error(step.stderrTail);\n                    }\n                  },\n                },\n          });\n\n          const apiResult = formatUpdateApiResult(result, channel);\n          if (result.status === 'ok') {\n            if (options.json) {\n              console.log(JSON.stringify(apiResult));\n            } else {\n              console.log(`✅ Updated to v${result.after?.version ?? 'unknown'} (${result.mode})`);\n              const extOutcomes = result.postUpdate?.extensions?.outcomes ?? [];\n              const updatedExt = extOutcomes.filter((o) => o.status === 'updated');\n              if (updatedExt.length > 0) {\n                console.log(`Extensions synced: ${updatedExt.map((o) => o.extensionId).join(', ')}`);\n              }\n              const restart = result.postUpdate?.restart;\n              if (restart?.ok && restart.mode !== 'skipped') {\n                console.log(`Gateway restart: ${restart.message ?? restart.mode}`);\n              } else if (!restart?.ok) {\n                console.log(\n                  restart?.message ??\n                    'Restart the gateway to use the new version: xopc gateway restart',\n                );\n              }\n            }\n            return;\n          }\n\n          if (result.status === 'skipped') {\n            if (options.json) {\n              console.log(JSON.stringify({ status: 'skipped', reason: result.reason, ...apiResult }));\n            } else if (result.reason === 'up-to-date') {\n              console.log(`✅ Already up to date: v${PACKAGE_VERSION}`);\n            } else if (result.reason === 'dirty') {\n              console.error('❌ Git working tree has uncommitted changes. Commit or stash first.');\n              process.exit(1);\n            } else {\n              console.log(`Update skipped: ${result.reason ?? 'unknown'}`);\n            }\n            return;\n          }\n\n          const message =\n            typeof apiResult.message === 'string'\n              ? apiResult.message\n              : result.reason ?? 'Update failed';\n          if (options.json) {\n            console.log(JSON.stringify({ status: 'error', reason: result.reason, message, ...apiResult }));\n          } else {\n            console.error(`❌ Update failed: ${message}`);\n          }\n          process.exit(1);\n        } finally {\n          await lock.release();\n        }\n      },\n    );\n}\n\nregister({\n  id: 'update',\n  name: 'update',\n  description: 'Check for and install xopc updates',\n  factory: createUpdateCommand,\n  metadata: {\n    category: 'maintenance',\n    examples: [\n      'xopc update',\n      'xopc update --check',\n      'xopc update --channel beta',\n      'xopc update --yes --json',\n    ],\n  },\n});\n"],"mappings":"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"}

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

@@ -1,8 +1,8 @@
 import { ConfigSchema, init_schema } from "../../config/schema.js";
 import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
-import { dirname, join } from "node:path";
-import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { randomBytes } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 //#region src/cli/utils/init-workspace-core.ts
 init_schema();
 init_loader();

package/dist/src/commands/agents.config.d.ts

@@ -2,14 +2,15 @@
  * Mutate `agents.list` / bindings when adding or removing agents.
  */
 import type { Config } from '../config/schema.js';
+import type { LocalizedText } from '../config/localized-text.js';
 import { listAgentEntries } from '../agent/agent-scope.js';
 type AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];
 export { listAgentEntries };
 export declare function findAgentEntryIndex(list: AgentEntry[], agentId: string): number;
 export declare function applyAgentConfig(cfg: Config, params: {
     agentId: string;
-    name?: string;
-    description?: string;
+    name?: LocalizedText;
+    description?: LocalizedText;
     workspace?: string;
     agentDir?: string;
     model?: string;

package/dist/src/commands/agents.config.js

@@ -1,10 +1,12 @@
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentHomeDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { init_localized_text, normalizeLocalizedText } from "../config/localized-text.js";
 import { existsSync } from "node:fs";
 import { rm } from "node:fs/promises";
 //#region src/commands/agents.config.ts
 /**
 * Mutate `agents.list` / bindings when adding or removing agents.
 */
+init_localized_text();
 init_agent_scope();
 function findAgentEntryIndex(list, agentId) {
 	const id = normalizeAgentId(agentId);
@@ -12,7 +14,8 @@ function findAgentEntryIndex(list, agentId) {
 }
 function applyAgentConfig(cfg, params) {
 	const agentId = normalizeAgentId(params.agentId);
-	const name = params.name?.trim();
+	const name = normalizeLocalizedText(params.name);
+	const description = normalizeLocalizedText(params.description);
 	const list = listAgentEntries(cfg);
 	const index = findAgentEntryIndex(list, agentId);
 	const base = index >= 0 ? list[index] : {
@@ -23,7 +26,7 @@ function applyAgentConfig(cfg, params) {
 		...base,
 		enabled: base.enabled ?? true,
 		...name ? { name } : {},
-		...params.description?.trim() ? { description: params.description.trim() } : {},
+		...description ? { description } : {},
 		...params.workspace ? { workspace: params.workspace } : {},
 		...params.agentDir ? { agentDir: params.agentDir } : {},
 		...params.model ? { model: { primary: params.model } } : {}

package/dist/src/commands/agents.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.config.js","names":[],"sources":["../../../src/commands/agents.config.ts"],"sourcesContent":["/**\n * Mutate `agents.list` / bindings when adding or removing agents.\n */\n\nimport { rm } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\n\nimport type { Config } from '../config/schema.js';\nimport {\n  listAgentEntries,\n  normalizeAgentId,\n  resolveAgentHomeDir,\n  resolveAgentWorkspaceDir,\n  resolveDefaultAgentId,\n  DEFAULT_AGENT_ID,\n} from '../agent/agent-scope.js';\n\ntype AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];\n\nexport { listAgentEntries };\n\nexport function findAgentEntryIndex(list: AgentEntry[], agentId: string): number {\n  const id = normalizeAgentId(agentId);\n  return list.findIndex((e) => normalizeAgentId(e.id) === id);\n}\n\nexport function applyAgentConfig(\n  cfg: Config,\n  params: {\n    agentId: string;\n    name?: string;\n    description?: string;\n    workspace?: string;\n    agentDir?: string;\n    model?: string;\n  },\n): Config {\n  const agentId = normalizeAgentId(params.agentId);\n  const name = params.name?.trim();\n  const list = listAgentEntries(cfg);\n  const index = findAgentEntryIndex(list, agentId);\n  const base = index >= 0 ? list[index] : { id: agentId, enabled: true as const };\n  const nextEntry: AgentEntry = {\n    ...base,\n    enabled: base.enabled ?? true,\n    ...(name ? { name } : {}),\n    ...(params.description?.trim() ? { description: params.description.trim() } : {}),\n    ...(params.workspace ? { workspace: params.workspace } : {}),\n    ...(params.agentDir ? { agentDir: params.agentDir } : {}),\n    ...(params.model ? { model: { primary: params.model } } : {}),\n  };\n  const nextList = [...list];\n  if (index >= 0) {\n    nextList[index] = nextEntry;\n  } else {\n    if (nextList.length === 0 && agentId !== normalizeAgentId(resolveDefaultAgentId(cfg))) {\n      nextList.push({ id: resolveDefaultAgentId(cfg), enabled: true });\n    }\n    nextList.push(nextEntry);\n  }\n  return {\n    ...cfg,\n    agents: {\n      ...cfg.agents,\n      list: nextList,\n    },\n  };\n}\n\nexport function pruneAgentConfig(\n  cfg: Config,\n  agentId: string,\n): { config: Config; removedBindings: number } {\n  const id = normalizeAgentId(agentId);\n  const agents = listAgentEntries(cfg);\n  const nextAgentsList = agents.filter((e) => normalizeAgentId(e.id) !== id);\n  const nextAgents = nextAgentsList.length > 0 ? nextAgentsList : undefined;\n\n  const bindings = cfg.bindings ?? [];\n  const filteredBindings = bindings.filter((b) => normalizeAgentId(b.agentId) !== id);\n\n  return {\n    config: {\n      ...cfg,\n      agents: nextAgents ? { ...cfg.agents, list: nextAgents } : { ...cfg.agents, list: undefined },\n      bindings: filteredBindings,\n    },\n    removedBindings: bindings.length - filteredBindings.length,\n  };\n}\n\nexport async function removeAgentDirsFromDisk(cfg: Config, id: string): Promise<void> {\n  const aid = normalizeAgentId(id);\n  if (aid === DEFAULT_AGENT_ID) {\n    throw new Error('Refusing to delete the main agent home on disk from this command.');\n  }\n  const home = resolveAgentHomeDir(cfg, aid);\n  const ws = resolveAgentWorkspaceDir(cfg, aid);\n  if (existsSync(home)) {\n    await rm(home, { recursive: true, force: true });\n  }\n  if (existsSync(ws) && ws !== home) {\n    await rm(ws, { recursive: true, force: true });\n  }\n}\n"],"mappings":";;;;;;;kBAeiC;AAMjC,SAAgB,oBAAoB,MAAoB,SAAyB;CAC/E,MAAM,KAAK,iBAAiB,QAAQ;AACpC,QAAO,KAAK,WAAW,MAAM,iBAAiB,EAAE,GAAG,KAAK,GAAG;;AAG7D,SAAgB,iBACd,KACA,QAQQ;CACR,MAAM,UAAU,iBAAiB,OAAO,QAAQ;CAChD,MAAM,OAAO,OAAO,MAAM,MAAM;CAChC,MAAM,OAAO,iBAAiB,IAAI;CAClC,MAAM,QAAQ,oBAAoB,MAAM,QAAQ;CAChD,MAAM,OAAO,SAAS,IAAI,KAAK,SAAS;EAAE,IAAI;EAAS,SAAS;EAAe;CAC/E,MAAM,YAAwB;EAC5B,GAAG;EACH,SAAS,KAAK,WAAW;EACzB,GAAI,OAAO,EAAE,MAAM,GAAG,EAAE;EACxB,GAAI,OAAO,aAAa,MAAM,GAAG,EAAE,aAAa,OAAO,YAAY,MAAM,EAAE,GAAG,EAAE;EAChF,GAAI,OAAO,YAAY,EAAE,WAAW,OAAO,WAAW,GAAG,EAAE;EAC3D,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;EACxD,GAAI,OAAO,QAAQ,EAAE,OAAO,EAAE,SAAS,OAAO,OAAO,EAAE,GAAG,EAAE;EAC7D;CACD,MAAM,WAAW,CAAC,GAAG,KAAK;AAC1B,KAAI,SAAS,EACX,UAAS,SAAS;MACb;AACL,MAAI,SAAS,WAAW,KAAK,YAAY,iBAAiB,sBAAsB,IAAI,CAAC,CACnF,UAAS,KAAK;GAAE,IAAI,sBAAsB,IAAI;GAAE,SAAS;GAAM,CAAC;AAElE,WAAS,KAAK,UAAU;;AAE1B,QAAO;EACL,GAAG;EACH,QAAQ;GACN,GAAG,IAAI;GACP,MAAM;GACP;EACF;;AAGH,SAAgB,iBACd,KACA,SAC6C;CAC7C,MAAM,KAAK,iBAAiB,QAAQ;CAEpC,MAAM,iBADS,iBAAiB,IACH,CAAC,QAAQ,MAAM,iBAAiB,EAAE,GAAG,KAAK,GAAG;CAC1E,MAAM,aAAa,eAAe,SAAS,IAAI,iBAAiB,KAAA;CAEhE,MAAM,WAAW,IAAI,YAAY,EAAE;CACnC,MAAM,mBAAmB,SAAS,QAAQ,MAAM,iBAAiB,EAAE,QAAQ,KAAK,GAAG;AAEnF,QAAO;EACL,QAAQ;GACN,GAAG;GACH,QAAQ,aAAa;IAAE,GAAG,IAAI;IAAQ,MAAM;IAAY,GAAG;IAAE,GAAG,IAAI;IAAQ,MAAM,KAAA;IAAW;GAC7F,UAAU;GACX;EACD,iBAAiB,SAAS,SAAS,iBAAiB;EACrD;;AAGH,eAAsB,wBAAwB,KAAa,IAA2B;CACpF,MAAM,MAAM,iBAAiB,GAAG;AAChC,KAAI,QAAA,OACF,OAAM,IAAI,MAAM,oEAAoE;CAEtF,MAAM,OAAO,oBAAoB,KAAK,IAAI;CAC1C,MAAM,KAAK,yBAAyB,KAAK,IAAI;AAC7C,KAAI,WAAW,KAAK,CAClB,OAAM,GAAG,MAAM;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC;AAElD,KAAI,WAAW,GAAG,IAAI,OAAO,KAC3B,OAAM,GAAG,IAAI;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC"}
+{"version":3,"file":"agents.config.js","names":[],"sources":["../../../src/commands/agents.config.ts"],"sourcesContent":["/**\n * Mutate `agents.list` / bindings when adding or removing agents.\n */\n\nimport { rm } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\n\nimport type { Config } from '../config/schema.js';\nimport type { LocalizedText } from '../config/localized-text.js';\nimport { normalizeLocalizedText } from '../config/localized-text.js';\nimport {\n  listAgentEntries,\n  normalizeAgentId,\n  resolveAgentHomeDir,\n  resolveAgentWorkspaceDir,\n  resolveDefaultAgentId,\n  DEFAULT_AGENT_ID,\n} from '../agent/agent-scope.js';\n\ntype AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];\n\nexport { listAgentEntries };\n\nexport function findAgentEntryIndex(list: AgentEntry[], agentId: string): number {\n  const id = normalizeAgentId(agentId);\n  return list.findIndex((e) => normalizeAgentId(e.id) === id);\n}\n\nexport function applyAgentConfig(\n  cfg: Config,\n  params: {\n    agentId: string;\n    name?: LocalizedText;\n    description?: LocalizedText;\n    workspace?: string;\n    agentDir?: string;\n    model?: string;\n  },\n): Config {\n  const agentId = normalizeAgentId(params.agentId);\n  const name = normalizeLocalizedText(params.name);\n  const description = normalizeLocalizedText(params.description);\n  const list = listAgentEntries(cfg);\n  const index = findAgentEntryIndex(list, agentId);\n  const base = index >= 0 ? list[index] : { id: agentId, enabled: true as const };\n  const nextEntry: AgentEntry = {\n    ...base,\n    enabled: base.enabled ?? true,\n    ...(name ? { name } : {}),\n    ...(description ? { description } : {}),\n    ...(params.workspace ? { workspace: params.workspace } : {}),\n    ...(params.agentDir ? { agentDir: params.agentDir } : {}),\n    ...(params.model ? { model: { primary: params.model } } : {}),\n  };\n  const nextList = [...list];\n  if (index >= 0) {\n    nextList[index] = nextEntry;\n  } else {\n    if (nextList.length === 0 && agentId !== normalizeAgentId(resolveDefaultAgentId(cfg))) {\n      nextList.push({ id: resolveDefaultAgentId(cfg), enabled: true });\n    }\n    nextList.push(nextEntry);\n  }\n  return {\n    ...cfg,\n    agents: {\n      ...cfg.agents,\n      list: nextList,\n    },\n  };\n}\n\nexport function pruneAgentConfig(\n  cfg: Config,\n  agentId: string,\n): { config: Config; removedBindings: number } {\n  const id = normalizeAgentId(agentId);\n  const agents = listAgentEntries(cfg);\n  const nextAgentsList = agents.filter((e) => normalizeAgentId(e.id) !== id);\n  const nextAgents = nextAgentsList.length > 0 ? nextAgentsList : undefined;\n\n  const bindings = cfg.bindings ?? [];\n  const filteredBindings = bindings.filter((b) => normalizeAgentId(b.agentId) !== id);\n\n  return {\n    config: {\n      ...cfg,\n      agents: nextAgents ? { ...cfg.agents, list: nextAgents } : { ...cfg.agents, list: undefined },\n      bindings: filteredBindings,\n    },\n    removedBindings: bindings.length - filteredBindings.length,\n  };\n}\n\nexport async function removeAgentDirsFromDisk(cfg: Config, id: string): Promise<void> {\n  const aid = normalizeAgentId(id);\n  if (aid === DEFAULT_AGENT_ID) {\n    throw new Error('Refusing to delete the main agent home on disk from this command.');\n  }\n  const home = resolveAgentHomeDir(cfg, aid);\n  const ws = resolveAgentWorkspaceDir(cfg, aid);\n  if (existsSync(home)) {\n    await rm(home, { recursive: true, force: true });\n  }\n  if (existsSync(ws) && ws !== home) {\n    await rm(ws, { recursive: true, force: true });\n  }\n}\n"],"mappings":";;;;;;;;qBASqE;kBAQpC;AAMjC,SAAgB,oBAAoB,MAAoB,SAAyB;CAC/E,MAAM,KAAK,iBAAiB,QAAQ;AACpC,QAAO,KAAK,WAAW,MAAM,iBAAiB,EAAE,GAAG,KAAK,GAAG;;AAG7D,SAAgB,iBACd,KACA,QAQQ;CACR,MAAM,UAAU,iBAAiB,OAAO,QAAQ;CAChD,MAAM,OAAO,uBAAuB,OAAO,KAAK;CAChD,MAAM,cAAc,uBAAuB,OAAO,YAAY;CAC9D,MAAM,OAAO,iBAAiB,IAAI;CAClC,MAAM,QAAQ,oBAAoB,MAAM,QAAQ;CAChD,MAAM,OAAO,SAAS,IAAI,KAAK,SAAS;EAAE,IAAI;EAAS,SAAS;EAAe;CAC/E,MAAM,YAAwB;EAC5B,GAAG;EACH,SAAS,KAAK,WAAW;EACzB,GAAI,OAAO,EAAE,MAAM,GAAG,EAAE;EACxB,GAAI,cAAc,EAAE,aAAa,GAAG,EAAE;EACtC,GAAI,OAAO,YAAY,EAAE,WAAW,OAAO,WAAW,GAAG,EAAE;EAC3D,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;EACxD,GAAI,OAAO,QAAQ,EAAE,OAAO,EAAE,SAAS,OAAO,OAAO,EAAE,GAAG,EAAE;EAC7D;CACD,MAAM,WAAW,CAAC,GAAG,KAAK;AAC1B,KAAI,SAAS,EACX,UAAS,SAAS;MACb;AACL,MAAI,SAAS,WAAW,KAAK,YAAY,iBAAiB,sBAAsB,IAAI,CAAC,CACnF,UAAS,KAAK;GAAE,IAAI,sBAAsB,IAAI;GAAE,SAAS;GAAM,CAAC;AAElE,WAAS,KAAK,UAAU;;AAE1B,QAAO;EACL,GAAG;EACH,QAAQ;GACN,GAAG,IAAI;GACP,MAAM;GACP;EACF;;AAGH,SAAgB,iBACd,KACA,SAC6C;CAC7C,MAAM,KAAK,iBAAiB,QAAQ;CAEpC,MAAM,iBADS,iBAAiB,IACH,CAAC,QAAQ,MAAM,iBAAiB,EAAE,GAAG,KAAK,GAAG;CAC1E,MAAM,aAAa,eAAe,SAAS,IAAI,iBAAiB,KAAA;CAEhE,MAAM,WAAW,IAAI,YAAY,EAAE;CACnC,MAAM,mBAAmB,SAAS,QAAQ,MAAM,iBAAiB,EAAE,QAAQ,KAAK,GAAG;AAEnF,QAAO;EACL,QAAQ;GACN,GAAG;GACH,QAAQ,aAAa;IAAE,GAAG,IAAI;IAAQ,MAAM;IAAY,GAAG;IAAE,GAAG,IAAI;IAAQ,MAAM,KAAA;IAAW;GAC7F,UAAU;GACX;EACD,iBAAiB,SAAS,SAAS,iBAAiB;EACrD;;AAGH,eAAsB,wBAAwB,KAAa,IAA2B;CACpF,MAAM,MAAM,iBAAiB,GAAG;AAChC,KAAI,QAAA,OACF,OAAM,IAAI,MAAM,oEAAoE;CAEtF,MAAM,OAAO,oBAAoB,KAAK,IAAI;CAC1C,MAAM,KAAK,yBAAyB,KAAK,IAAI;AAC7C,KAAI,WAAW,KAAK,CAClB,OAAM,GAAG,MAAM;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC;AAElD,KAAI,WAAW,GAAG,IAAI,OAAO,KAC3B,OAAM,GAAG,IAAI;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC"}

package/dist/src/config/agent-profile.js

@@ -1,5 +1,5 @@
-import { getAgentDefaultModelRef, init_schema } from "./schema.js";
 import { init_agent_scope, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
+import { getAgentDefaultModelRef, init_schema } from "./schema.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/config/agent-profile.ts

package/dist/src/config/agent-typed-models.d.ts

@@ -1,14 +1,9 @@
 /**
- * Named model roles (`agents.defaults.models` / `agents.list[].models`).
- * Merged per agent id for workflow and other callers.
+ * Named model roles from `agents.defaults.models`.
  */
 import type { AgentTypedModel, Config } from './schema.js';
 export type { AgentTypedModel };
-/**
- * Merge defaults + per-agent typed models. Agent entry wins on same `id`.
- */
-export declare function mergeTypedModels(defaults?: AgentTypedModel[], entry?: AgentTypedModel[]): Map<string, AgentTypedModel>;
-export declare function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel>;
+export declare function resolveEffectiveTypedModels(config: Config, _agentId: string): Map<string, AgentTypedModel>;
 /** Resolve a typed model id to `provider/model`, or undefined when not configured. */
 export declare function resolveTypedModelRef(config: Config, agentId: string, typeId: string): string | undefined;
 /**

package/dist/src/config/agent-typed-models.js

@@ -1,22 +1,11 @@
 import { init_schema, parseModelRef } from "./schema.js";
-import { init_agent_scope, listAgentEntries } from "../agent/agent-scope.js";
 //#region src/config/agent-typed-models.ts
-init_agent_scope();
 init_schema();
-/**
-* Merge defaults + per-agent typed models. Agent entry wins on same `id`.
-*/
-function mergeTypedModels(defaults, entry) {
+function resolveEffectiveTypedModels(config, _agentId) {
 	const out = /* @__PURE__ */ new Map();
-	for (const m of defaults ?? []) out.set(m.id, m);
-	for (const m of entry ?? []) out.set(m.id, m);
+	for (const modelRole of config.agents?.defaults?.models ?? []) out.set(modelRole.id, modelRole);
 	return out;
 }
-function resolveEffectiveTypedModels(config, agentId) {
-	const defaults = config.agents?.defaults?.models;
-	const entry = listAgentEntries(config).find((a) => a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase())?.models;
-	return mergeTypedModels(defaults, entry);
-}
 /** Resolve a typed model id to `provider/model`, or undefined when not configured. */
 function resolveTypedModelRef(config, agentId, typeId) {
 	return resolveEffectiveTypedModels(config, agentId).get(typeId)?.model?.trim() || void 0;
@@ -48,6 +37,6 @@ function resolveModelRef(config, agentId, ref) {
 	throw new Error("model ref must not be empty");
 }
 //#endregion
-export { mergeTypedModels, resolveEffectiveTypedModels, resolveModelRef, resolveTypedModelRef };
+export { resolveEffectiveTypedModels, resolveModelRef, resolveTypedModelRef };
 
 //# sourceMappingURL=agent-typed-models.js.map

package/dist/src/config/agent-typed-models.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-typed-models.js","names":[],"sources":["../../../src/config/agent-typed-models.ts"],"sourcesContent":["/**\n * Named model roles (`agents.defaults.models` / `agents.list[].models`).\n * Merged per agent id for workflow and other callers.\n */\n\nimport { listAgentEntries } from '../agent/agent-scope.js';\nimport type { AgentTypedModel, Config } from './schema.js';\nimport { parseModelRef } from './schema.js';\n\nexport type { AgentTypedModel };\n\n/**\n * Merge defaults + per-agent typed models. Agent entry wins on same `id`.\n */\nexport function mergeTypedModels(\n  defaults?: AgentTypedModel[],\n  entry?: AgentTypedModel[],\n): Map<string, AgentTypedModel> {\n  const out = new Map<string, AgentTypedModel>();\n  for (const m of defaults ?? []) {\n    out.set(m.id, m);\n  }\n  for (const m of entry ?? []) {\n    out.set(m.id, m);\n  }\n  return out;\n}\n\nexport function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel> {\n  const defaults = config.agents?.defaults?.models;\n  const entry = listAgentEntries(config).find(\n    (a) => a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase(),\n  )?.models;\n  return mergeTypedModels(defaults, entry);\n}\n\n/** Resolve a typed model id to `provider/model`, or undefined when not configured. */\nexport function resolveTypedModelRef(\n  config: Config,\n  agentId: string,\n  typeId: string,\n): string | undefined {\n  const entry = resolveEffectiveTypedModels(config, agentId).get(typeId);\n  const ref = entry?.model?.trim();\n  return ref || undefined;\n}\n\nfunction parseModelRefInput(ref: string): { directRef?: string; typeId?: string } {\n  const trimmed = ref.trim();\n  if (!trimmed) {\n    return {};\n  }\n  if (trimmed.includes('/')) {\n    return { directRef: trimmed };\n  }\n  const typeId = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n  return typeId ? { typeId } : {};\n}\n\n/**\n * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.\n * Throws when the ref is invalid or the typed id is unknown.\n */\nexport function resolveModelRef(config: Config, agentId: string, ref: string): string {\n  const { directRef, typeId } = parseModelRefInput(ref);\n  if (directRef) {\n    if (!parseModelRef(directRef)) {\n      throw new Error(`model ref must be provider/model format (got '${directRef}')`);\n    }\n    return directRef;\n  }\n  if (typeId) {\n    const resolved = resolveTypedModelRef(config, agentId, typeId);\n    if (resolved) {\n      return resolved;\n    }\n    const available = [...resolveEffectiveTypedModels(config, agentId).keys()];\n    const hint =\n      available.length > 0 ? ` (available: ${available.join(', ')})` : ' (none configured)';\n    throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);\n  }\n  throw new Error('model ref must not be empty');\n}\n"],"mappings":";;;kBAK2D;aAEf;;;;AAO5C,SAAgB,iBACd,UACA,OAC8B;CAC9B,MAAM,sBAAM,IAAI,KAA8B;AAC9C,MAAK,MAAM,KAAK,YAAY,EAAE,CAC5B,KAAI,IAAI,EAAE,IAAI,EAAE;AAElB,MAAK,MAAM,KAAK,SAAS,EAAE,CACzB,KAAI,IAAI,EAAE,IAAI,EAAE;AAElB,QAAO;;AAGT,SAAgB,4BAA4B,QAAgB,SAA+C;CACzG,MAAM,WAAW,OAAO,QAAQ,UAAU;CAC1C,MAAM,QAAQ,iBAAiB,OAAO,CAAC,MACpC,MAAM,EAAE,YAAY,SAAS,EAAE,GAAG,aAAa,KAAK,QAAQ,aAAa,CAC3E,EAAE;AACH,QAAO,iBAAiB,UAAU,MAAM;;;AAI1C,SAAgB,qBACd,QACA,SACA,QACoB;AAGpB,QAFc,4BAA4B,QAAQ,QAAQ,CAAC,IAAI,OAC9C,EAAE,OAAO,MAAM,IAClB,KAAA;;AAGhB,SAAS,mBAAmB,KAAsD;CAChF,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO,EAAE;AAEX,KAAI,QAAQ,SAAS,IAAI,CACvB,QAAO,EAAE,WAAW,SAAS;CAE/B,MAAM,SAAS,QAAQ,WAAW,IAAI,GAAG,QAAQ,MAAM,EAAE,CAAC,MAAM,GAAG;AACnE,QAAO,SAAS,EAAE,QAAQ,GAAG,EAAE;;;;;;AAOjC,SAAgB,gBAAgB,QAAgB,SAAiB,KAAqB;CACpF,MAAM,EAAE,WAAW,WAAW,mBAAmB,IAAI;AACrD,KAAI,WAAW;AACb,MAAI,CAAC,cAAc,UAAU,CAC3B,OAAM,IAAI,MAAM,iDAAiD,UAAU,IAAI;AAEjF,SAAO;;AAET,KAAI,QAAQ;EACV,MAAM,WAAW,qBAAqB,QAAQ,SAAS,OAAO;AAC9D,MAAI,SACF,QAAO;EAET,MAAM,YAAY,CAAC,GAAG,4BAA4B,QAAQ,QAAQ,CAAC,MAAM,CAAC;EAC1E,MAAM,OACJ,UAAU,SAAS,IAAI,gBAAgB,UAAU,KAAK,KAAK,CAAC,KAAK;AACnE,QAAM,IAAI,MAAM,2BAA2B,OAAO,eAAe,QAAQ,GAAG,OAAO;;AAErF,OAAM,IAAI,MAAM,8BAA8B"}
+{"version":3,"file":"agent-typed-models.js","names":[],"sources":["../../../src/config/agent-typed-models.ts"],"sourcesContent":["/**\n * Named model roles from `agents.defaults.models`.\n */\n\nimport type { AgentTypedModel, Config } from './schema.js';\nimport { parseModelRef } from './schema.js';\n\nexport type { AgentTypedModel };\n\nexport function resolveEffectiveTypedModels(config: Config, _agentId: string): Map<string, AgentTypedModel> {\n  const out = new Map<string, AgentTypedModel>();\n  for (const modelRole of config.agents?.defaults?.models ?? []) {\n    out.set(modelRole.id, modelRole);\n  }\n  return out;\n}\n\n/** Resolve a typed model id to `provider/model`, or undefined when not configured. */\nexport function resolveTypedModelRef(\n  config: Config,\n  agentId: string,\n  typeId: string,\n): string | undefined {\n  const entry = resolveEffectiveTypedModels(config, agentId).get(typeId);\n  const ref = entry?.model?.trim();\n  return ref || undefined;\n}\n\nfunction parseModelRefInput(ref: string): { directRef?: string; typeId?: string } {\n  const trimmed = ref.trim();\n  if (!trimmed) {\n    return {};\n  }\n  if (trimmed.includes('/')) {\n    return { directRef: trimmed };\n  }\n  const typeId = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n  return typeId ? { typeId } : {};\n}\n\n/**\n * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.\n * Throws when the ref is invalid or the typed id is unknown.\n */\nexport function resolveModelRef(config: Config, agentId: string, ref: string): string {\n  const { directRef, typeId } = parseModelRefInput(ref);\n  if (directRef) {\n    if (!parseModelRef(directRef)) {\n      throw new Error(`model ref must be provider/model format (got '${directRef}')`);\n    }\n    return directRef;\n  }\n  if (typeId) {\n    const resolved = resolveTypedModelRef(config, agentId, typeId);\n    if (resolved) {\n      return resolved;\n    }\n    const available = [...resolveEffectiveTypedModels(config, agentId).keys()];\n    const hint =\n      available.length > 0 ? ` (available: ${available.join(', ')})` : ' (none configured)';\n    throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);\n  }\n  throw new Error('model ref must not be empty');\n}\n"],"mappings":";;aAK4C;AAI5C,SAAgB,4BAA4B,QAAgB,UAAgD;CAC1G,MAAM,sBAAM,IAAI,KAA8B;AAC9C,MAAK,MAAM,aAAa,OAAO,QAAQ,UAAU,UAAU,EAAE,CAC3D,KAAI,IAAI,UAAU,IAAI,UAAU;AAElC,QAAO;;;AAIT,SAAgB,qBACd,QACA,SACA,QACoB;AAGpB,QAFc,4BAA4B,QAAQ,QAAQ,CAAC,IAAI,OAC9C,EAAE,OAAO,MAAM,IAClB,KAAA;;AAGhB,SAAS,mBAAmB,KAAsD;CAChF,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO,EAAE;AAEX,KAAI,QAAQ,SAAS,IAAI,CACvB,QAAO,EAAE,WAAW,SAAS;CAE/B,MAAM,SAAS,QAAQ,WAAW,IAAI,GAAG,QAAQ,MAAM,EAAE,CAAC,MAAM,GAAG;AACnE,QAAO,SAAS,EAAE,QAAQ,GAAG,EAAE;;;;;;AAOjC,SAAgB,gBAAgB,QAAgB,SAAiB,KAAqB;CACpF,MAAM,EAAE,WAAW,WAAW,mBAAmB,IAAI;AACrD,KAAI,WAAW;AACb,MAAI,CAAC,cAAc,UAAU,CAC3B,OAAM,IAAI,MAAM,iDAAiD,UAAU,IAAI;AAEjF,SAAO;;AAET,KAAI,QAAQ;EACV,MAAM,WAAW,qBAAqB,QAAQ,SAAS,OAAO;AAC9D,MAAI,SACF,QAAO;EAET,MAAM,YAAY,CAAC,GAAG,4BAA4B,QAAQ,QAAQ,CAAC,MAAM,CAAC;EAC1E,MAAM,OACJ,UAAU,SAAS,IAAI,gBAAgB,UAAU,KAAK,KAAK,CAAC,KAAK;AACnE,QAAM,IAAI,MAAM,2BAA2B,OAAO,eAAe,QAAQ,GAAG,OAAO;;AAErF,OAAM,IAAI,MAAM,8BAA8B"}

package/dist/src/config/gateway-bind.js

@@ -1,7 +1,7 @@
 import { getTailnetIPv4Sync } from "../infra/tailscale.js";
 import { isLoopbackHost } from "../gateway/host.js";
-import net from "node:net";
 import { existsSync } from "node:fs";
+import net from "node:net";
 //#region src/config/gateway-bind.ts
 function resolveGatewayBindMode(cfg, bindOverride) {
 	if (bindOverride) return bindOverride;

package/dist/src/config/index.js

@@ -1,15 +1,15 @@
-import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema } from "../../extensions/telegram/src/config-schema.js";
-import { WeixinAccountConfigSchema, WeixinConfigSchema } from "../../extensions/weixin/src/config-schema.js";
-import { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentTypedModelSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
-import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
 import { ENV_VARS, resolveHomeDir, resolveStateDir } from "./paths-state.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, resolveSessionsDir as resolveSessionsDir$1 } from "../agent/agent-scope.js";
-import { extractProfileAgentId, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
 import { resolveSessionFilePath, resolveSessionTranscriptPathInDir } from "../session/parity/transcript-paths.js";
 import { FILENAMES, WORKSPACE_FILES, existsSync, init_paths, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentHomeDir, resolveAgentMetadataPath, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveCronLogPath, resolveCronLogsDir, resolveCronRunsDir, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveMemoryDir, resolveMemoryPath, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveSessionTranscriptPath, resolveSessionsArchiveDir, resolveSessionsDir, resolveSessionsMapPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath } from "./paths.js";
+import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema } from "../../extensions/telegram/src/config-schema.js";
+import { WeixinAccountConfigSchema, WeixinConfigSchema } from "../../extensions/weixin/src/config-schema.js";
+import { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentTypedModelSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
 import { init_loader, loadConfig, registerChannelConfigValidator, saveConfig } from "./loader.js";
+import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
+import { extractProfileAgentId, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
 import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_config_value, resolveConfigValue, resolveHeaders, testApiKeyResolution } from "./resolve-config-value.js";
 import { CustomModelSchema, 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";

package/dist/src/config/loader.js

@@ -1,9 +1,9 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { ConfigSchema, init_schema } from "./schema.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveConfigPath } from "./paths.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { ConfigSchema, init_schema } from "./schema.js";
 import { dirname } from "path";
 import { existsSync, mkdirSync, promises, readFileSync } from "fs";
 import { config } from "dotenv";

package/dist/src/config/localized-text.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export type LocalizedTextMap = Record<string, string>;
+export type LocalizedText = string | LocalizedTextMap;
+export declare const LocalizedTextSchema: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+export declare function normalizeLocalizedText(value: LocalizedText | undefined): LocalizedText | undefined;
+export declare function resolveLocalizedText(value: LocalizedText | undefined, locale: string | undefined, fallbackLocale?: string): string | undefined;

package/dist/src/config/localized-text.js

@@ -0,0 +1,42 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { z } from "zod";
+//#region src/config/localized-text.ts
+function normalizeLocalizedText(value) {
+	if (typeof value === "string") {
+		const trimmed = value.trim();
+		return trimmed ? trimmed : void 0;
+	}
+	if (!value || typeof value !== "object" || Array.isArray(value)) return;
+	const entries = Object.entries(value).map(([locale, text]) => [locale.trim(), String(text).trim()]).filter(([locale, text]) => locale.length > 0 && text.length > 0);
+	if (entries.length === 0) return;
+	return Object.fromEntries(entries);
+}
+function resolveLocalizedText(value, locale, fallbackLocale = "en") {
+	if (typeof value === "string") return value.trim() || void 0;
+	if (!value || typeof value !== "object" || Array.isArray(value)) return;
+	const normalizedLocale = locale?.trim();
+	const candidates = [
+		normalizedLocale,
+		normalizedLocale?.split("-")[0],
+		fallbackLocale,
+		fallbackLocale.split("-")[0]
+	].filter((candidate) => Boolean(candidate));
+	for (const candidate of candidates) {
+		const text = value[candidate]?.trim();
+		if (text) return text;
+	}
+	for (const text of Object.values(value)) {
+		const trimmed = text.trim();
+		if (trimmed) return trimmed;
+	}
+}
+var LOCALE_KEY_PATTERN, LocalizedTextSchema;
+var init_localized_text = __esmMin((() => {
+	LOCALE_KEY_PATTERN = /^[a-z]{2}(?:-[A-Za-z]{2,8})?$/;
+	LocalizedTextSchema = z.union([z.string(), z.record(z.string().regex(LOCALE_KEY_PATTERN), z.string())]);
+}));
+//#endregion
+init_localized_text();
+export { LocalizedTextSchema, init_localized_text, normalizeLocalizedText, resolveLocalizedText };
+
+//# sourceMappingURL=localized-text.js.map

package/dist/src/config/localized-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localized-text.js","names":[],"sources":["../../../src/config/localized-text.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport type LocalizedTextMap = Record<string, string>;\nexport type LocalizedText = string | LocalizedTextMap;\n\nconst LOCALE_KEY_PATTERN = /^[a-z]{2}(?:-[A-Za-z]{2,8})?$/;\n\nexport const LocalizedTextSchema = z.union([\n  z.string(),\n  z.record(z.string().regex(LOCALE_KEY_PATTERN), z.string()),\n]);\n\nexport function normalizeLocalizedText(value: LocalizedText | undefined): LocalizedText | undefined {\n  if (typeof value === 'string') {\n    const trimmed = value.trim();\n    return trimmed ? trimmed : undefined;\n  }\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n  const entries = Object.entries(value)\n    .map(([locale, text]) => [locale.trim(), String(text).trim()] as const)\n    .filter(([locale, text]) => locale.length > 0 && text.length > 0);\n  if (entries.length === 0) {\n    return undefined;\n  }\n  return Object.fromEntries(entries);\n}\n\nexport function resolveLocalizedText(\n  value: LocalizedText | undefined,\n  locale: string | undefined,\n  fallbackLocale = 'en',\n): string | undefined {\n  if (typeof value === 'string') {\n    const trimmed = value.trim();\n    return trimmed || undefined;\n  }\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const normalizedLocale = locale?.trim();\n  const localeBase = normalizedLocale?.split('-')[0];\n  const fallbackBase = fallbackLocale.split('-')[0];\n  const candidates = [\n    normalizedLocale,\n    localeBase,\n    fallbackLocale,\n    fallbackBase,\n  ].filter((candidate): candidate is string => Boolean(candidate));\n\n  for (const candidate of candidates) {\n    const text = value[candidate]?.trim();\n    if (text) {\n      return text;\n    }\n  }\n\n  for (const text of Object.values(value)) {\n    const trimmed = text.trim();\n    if (trimmed) {\n      return trimmed;\n    }\n  }\n  return undefined;\n}\n"],"mappings":";;;AAYA,SAAgB,uBAAuB,OAA6D;AAClG,KAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,UAAU,MAAM,MAAM;AAC5B,SAAO,UAAU,UAAU,KAAA;;AAE7B,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D;CAEF,MAAM,UAAU,OAAO,QAAQ,MAAM,CAClC,KAAK,CAAC,QAAQ,UAAU,CAAC,OAAO,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAU,CACtE,QAAQ,CAAC,QAAQ,UAAU,OAAO,SAAS,KAAK,KAAK,SAAS,EAAE;AACnE,KAAI,QAAQ,WAAW,EACrB;AAEF,QAAO,OAAO,YAAY,QAAQ;;AAGpC,SAAgB,qBACd,OACA,QACA,iBAAiB,MACG;AACpB,KAAI,OAAO,UAAU,SAEnB,QADgB,MAAM,MACR,IAAI,KAAA;AAEpB,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D;CAGF,MAAM,mBAAmB,QAAQ,MAAM;CAGvC,MAAM,aAAa;EACjB;EAHiB,kBAAkB,MAAM,IAAI,CAAC;EAK9C;EAJmB,eAAe,MAAM,IAAI,CAAC;EAM9C,CAAC,QAAQ,cAAmC,QAAQ,UAAU,CAAC;AAEhE,MAAK,MAAM,aAAa,YAAY;EAClC,MAAM,OAAO,MAAM,YAAY,MAAM;AACrC,MAAI,KACF,QAAO;;AAIX,MAAK,MAAM,QAAQ,OAAO,OAAO,MAAM,EAAE;EACvC,MAAM,UAAU,KAAK,MAAM;AAC3B,MAAI,QACF,QAAO;;;;;AAzDP,sBAAqB;AAEd,uBAAsB,EAAE,MAAM,CACzC,EAAE,QAAQ,EACV,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,mBAAmB,EAAE,EAAE,QAAQ,CAAC,CAC3D,CAAC"}