@xopcai/xopc 0.0.6 → 0.0.11

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

@@ -0,0 +1,171 @@
+import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
+import { loadConfig } from "../../config/loader.js";
+import "../../config/index.js";
+import { formatExamples, register } from "../registry.js";
+import { normalizeUpdateChannel } from "../../infra/update-channels.js";
+import { compareSemver, detectInstallKind, resolveNpmChannelTag, resolvePackageRoot } from "../../infra/update-check.js";
+import { Command } from "commander";
+import { spawn } from "node:child_process";
+//#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([
+		"xopc update",
+		"xopc update --check",
+		"xopc update --channel beta",
+		"xopc update --yes",
+		"xopc update --json"
+	])).action(async (options) => {
+		const fromCli = options.channel;
+		const fromConfig = (() => {
+			try {
+				return loadConfig().update?.channel;
+			} catch {
+				return;
+			}
+		})();
+		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.";
+				if (options.json) console.log(JSON.stringify({
+					status: "skipped",
+					reason: "git-checkout",
+					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 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
+			}));
+			else {
+				console.log(`📦 ${message}`);
+				console.log("Run `xopc update` to install.");
+			}
+			return;
+		}
+		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})?`,
+				default: true
+			})) {
+				console.log("Update cancelled.");
+				return;
+			}
+		}
+		const packageManager = detectGlobalPackageManager();
+		const spec = `@xopcai/xopc@${resolved.version}`;
+		if (!options.json) console.log(`Installing ${spec} via ${packageManager}...`);
+		const exitCode = await runInstallCommand(buildInstallArgs(packageManager, spec));
+		if (exitCode === 0) if (options.json) console.log(JSON.stringify({
+			status: "ok",
+			previousVersion: PACKAGE_VERSION,
+			installedVersion: resolved.version,
+			channel: resolved.tag,
+			packageManager
+		}));
+		else {
+			console.log(`✅ Updated to v${resolved.version}`);
+			console.log("Restart the gateway to use the new version: xopc gateway restart");
+		}
+		else {
+			if (options.json) console.log(JSON.stringify({
+				status: "error",
+				reason: "install-failed",
+				exitCode,
+				packageManager
+			}));
+			else {
+				console.error(`❌ Update failed (exit code ${exitCode})`);
+				console.error(`Try manually: ${packageManager} install -g ${spec}`);
+			}
+			process.exit(1);
+		}
+	});
+}
+/**
+* Detect which package manager was used to install xopc globally.
+* Checks common indicators: npm_config_user_agent, process.env, argv paths.
+*/
+function detectGlobalPackageManager() {
+	if ((process.env.npm_config_user_agent ?? "").startsWith("pnpm/")) return "pnpm";
+	return "npm";
+}
+function buildInstallArgs(manager, spec) {
+	if (manager === "pnpm") return [
+		"pnpm",
+		"add",
+		"-g",
+		spec
+	];
+	return [
+		"npm",
+		"install",
+		"-g",
+		spec,
+		"--no-fund",
+		"--no-audit"
+	];
+}
+function runInstallCommand(argv) {
+	return new Promise((resolve) => {
+		const child = spawn(argv[0], argv.slice(1), {
+			stdio: "inherit",
+			env: process.env
+		});
+		child.on("error", () => resolve(1));
+		child.on("exit", (code) => resolve(code ?? 1));
+	});
+}
+register({
+	id: "update",
+	name: "update",
+	description: "Check for and install xopc updates",
+	factory: createUpdateCommand,
+	metadata: {
+		category: "maintenance",
+		examples: [
+			"xopc update",
+			"xopc update --check",
+			"xopc update --channel beta",
+			"xopc update --yes --json"
+		]
+	}
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=update.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","names":[],"sources":["../../../../src/cli/commands/update.ts"],"sourcesContent":["// src/cli/commands/update.ts\n\nimport { Command } from 'commander';\nimport { spawn } from 'node:child_process';\n\nimport { loadConfig } from '../../config/index.js';\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { register, formatExamples, type CLIContext } from '../registry.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';\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        // Check current install kind\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 = detectGlobalPackageManager();\n        const spec = `@xopcai/xopc@${resolved.version}`;\n\n        if (!options.json) {\n          console.log(`Installing ${spec} via ${packageManager}...`);\n        }\n\n        const installArgs = buildInstallArgs(packageManager, spec);\n        const exitCode = await runInstallCommand(installArgs);\n\n        if (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,\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          if (options.json) {\n            console.log(\n              JSON.stringify({\n                status: 'error',\n                reason: 'install-failed',\n                exitCode,\n                packageManager,\n              }),\n            );\n          } else {\n            console.error(`❌ Update failed (exit code ${exitCode})`);\n            console.error(`Try manually: ${packageManager} install -g ${spec}`);\n          }\n          process.exit(1);\n        }\n      },\n    );\n}\n\n/**\n * Detect which package manager was used to install xopc globally.\n * Checks common indicators: npm_config_user_agent, process.env, argv paths.\n */\nfunction detectGlobalPackageManager(): 'npm' | 'pnpm' {\n  const userAgent = process.env.npm_config_user_agent ?? '';\n  if (userAgent.startsWith('pnpm/')) return 'pnpm';\n  return 'npm';\n}\n\nfunction buildInstallArgs(manager: 'npm' | 'pnpm', spec: string): string[] {\n  if (manager === 'pnpm') {\n    return ['pnpm', 'add', '-g', spec];\n  }\n  return ['npm', 'install', '-g', spec, '--no-fund', '--no-audit'];\n}\n\nfunction runInstallCommand(argv: string[]): Promise<number> {\n  return new Promise((resolve) => {\n    const child = spawn(argv[0], argv.slice(1), {\n      stdio: 'inherit',\n      env: process.env,\n    });\n    child.on('error', () => resolve(1));\n    child.on('exit', (code) => resolve(code ?? 1));\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/index.d.ts

@@ -7,14 +7,14 @@ import './commands/gateway.js';
 import './commands/session.js';
 import './commands/cron.js';
 import './commands/config.js';
+import './commands/doctor/index.js';
 import './commands/image.js';
 import './commands/channels.js';
 import './commands/models.js';
-import './commands/extension.js';
 import './commands/auth.js';
 import './commands/skills.js';
+import './commands/update.js';
 import './commands/logs.js';
-import './commands/acp.js';
 export declare let parsedOpts: {
     config?: string;
     workspace?: string;

package/dist/src/cli/index.js

@@ -11,14 +11,15 @@ import "./commands/gateway.js";
 import "./commands/session.js";
 import "./commands/cron.js";
 import "./commands/config.js";
+import "./commands/doctor/index.js";
 import "./commands/image.js";
 import "./commands/channels.js";
 import "./commands/models.js";
-import "./commands/extension.js";
+import { registerExtensionCommands } from "./commands/extension.js";
 import "./commands/auth.js";
 import "./commands/skills.js";
+import "./commands/update.js";
 import "./commands/logs.js";
-import "./commands/acp.js";
 import { registerAgentsCli } from "./commands/agents.js";
 import { Command } from "commander";
 //#region src/cli/index.ts
@@ -50,6 +51,7 @@ program.hook("postAction", async (thisCommand) => {
 const ctx = getContextWithOpts(process.argv);
 registry.install(program, ctx);
 registerAgentsCli(program);
+registerExtensionCommands(program);
 if (!(!!process.env.VITEST || !!process.env.TEST || !!"production"?.includes("test")) && import.meta.url.startsWith("file:")) {
 	const argv = process.argv.filter((arg, index) => {
 		if (arg !== "--") return true;

package/dist/src/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["pkg.version"],"sources":["../../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { registry, createDefaultContext, type CLIContext } from './registry.js';\nimport pkg from '../../package.json' with { type: 'json' };\nimport { flushAndClose } from '../utils/logger.js'; // Import flushAndClose for graceful shutdown\nimport { registerExtensionCliCommands } from './bootstrap-extensions.js';\n\n// Import order determines display order in help\nimport './commands/setup.js';\nimport './commands/onboard.js';\nimport './commands/agent.js';\nimport './commands/gateway.js';\nimport './commands/session.js';\nimport './commands/cron.js';\nimport './commands/config.js';\nimport './commands/image.js';\nimport './commands/channels.js';\nimport './commands/models.js';\nimport './commands/extension.js';\nimport './commands/auth.js';\nimport './commands/skills.js';\nimport './commands/logs.js';\nimport './commands/acp.js';\nimport { registerAgentsCli } from './commands/agents.js';\n\n// Global parsed options - updated before each command\nexport let parsedOpts: { config?: string; workspace?: string; verbose?: boolean } = {};\n\nexport function getContextWithOpts(argv: string[] = process.argv): CLIContext {\n  return createDefaultContext(argv, parsedOpts);\n}\n\n// Long-running commands that should not auto-exit\nconst LONG_RUNNING_COMMANDS = new Set(['gateway', 'agent']);\n\nconst program = new Command()\n  .name('xopc')\n  .description('Ultra-Lightweight Personal AI Assistant')\n  .version(pkg.version)\n  .option('--verbose', 'Enable verbose logging', false)\n  .option('--config <path>', 'Config file path')\n  .option('--workspace <path>', 'Workspace directory');\n\n// Hook to capture parsed options before each command runs\nprogram.hook('preAction', (thisCommand) => {\n  parsedOpts = thisCommand.opts();\n});\n\n// Hook to ensure process exits after command completion\nprogram.hook('postAction', async (thisCommand) => {\n  // Get the actual subcommand being executed (not the root program name)\n  const args = thisCommand.args;\n  const subCommandName = args.length > 0 ? args[0] : thisCommand.name();\n\n  // Skip long-running commands (gateway foreground, agent interactive mode)\n  if (LONG_RUNNING_COMMANDS.has(subCommandName)) {\n    // For agent command, only skip exit if interactive mode (-i) is used\n    if (subCommandName === 'agent') {\n      const hasInteractiveFlag = process.argv.includes('-i') || process.argv.includes('--interactive');\n      if (!hasInteractiveFlag) {\n        // Agent in non-interactive mode should exit normally\n        await flushAndClose();\n        process.exit(0);\n      }\n    }\n    // Gateway or agent -i: don't exit\n    return;\n  }\n  // For all other commands, flush logs and exit\n  await flushAndClose();\n  process.exit(0);\n});\n\n// Create initial context (will use env vars and defaults)\nconst ctx = getContextWithOpts(process.argv);\nregistry.install(program, ctx);\nregisterAgentsCli(program);\n\n// Only parse if this is the main module being executed directly\n// Skip parsing when imported as module (e.g., in tests)\nconst isTestEnv = !!process.env.VITEST || !!process.env.TEST || !!process.env.NODE_ENV?.includes('test');\nconst isMainModule = !isTestEnv && import.meta.url.startsWith('file:');\n\nif (isMainModule) {\n  // Filter out standalone '--' separator (passed by pnpm run -- <cmd>)\n  // npm removes it automatically, pnpm passes it through\n  const argv = process.argv.filter((arg, index) => {\n    if (arg !== '--') return true;\n    // Only filter '--' if it's the separator between script and command\n    // (i.e., comes after the script name and before actual args)\n    return index < 2; // Keep '--' if it's a script argument (index 0 or 1)\n  });\n  void registerExtensionCliCommands(program).then(() => {\n    program.parse(argv);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;aAImD;AAsBnD,IAAW,aAAyE,EAAE;AAEtF,SAAgB,mBAAmB,OAAiB,QAAQ,MAAkB;AAC5E,QAAO,qBAAqB,MAAM,WAAW;;AAI/C,MAAM,wBAAwB,IAAI,IAAI,CAAC,WAAW,QAAQ,CAAC;AAE3D,MAAM,UAAU,IAAI,SAAS,CAC1B,KAAK,OAAO,CACZ,YAAY,0CAA0C,CACtD,QAAQA,QAAY,CACpB,OAAO,aAAa,0BAA0B,MAAM,CACpD,OAAO,mBAAmB,mBAAmB,CAC7C,OAAO,sBAAsB,sBAAsB;AAGtD,QAAQ,KAAK,cAAc,gBAAgB;AACzC,cAAa,YAAY,MAAM;EAC/B;AAGF,QAAQ,KAAK,cAAc,OAAO,gBAAgB;CAEhD,MAAM,OAAO,YAAY;CACzB,MAAM,iBAAiB,KAAK,SAAS,IAAI,KAAK,KAAK,YAAY,MAAM;AAGrE,KAAI,sBAAsB,IAAI,eAAe,EAAE;AAE7C,MAAI,mBAAmB;OAEjB,EADuB,QAAQ,KAAK,SAAS,KAAK,IAAI,QAAQ,KAAK,SAAS,gBAAgB,GACvE;AAEvB,UAAM,eAAe;AACrB,YAAQ,KAAK,EAAE;;;AAInB;;AAGF,OAAM,eAAe;AACrB,SAAQ,KAAK,EAAE;EACf;AAGF,MAAM,MAAM,mBAAmB,QAAQ,KAAK;AAC5C,SAAS,QAAQ,SAAS,IAAI;AAC9B,kBAAkB,QAAQ;AAO1B,IAFqB,EADH,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAA,cAAuB,SAAS,OAAO,KACrE,OAAO,KAAK,IAAI,WAAW,QAAQ,EAEpD;CAGhB,MAAM,OAAO,QAAQ,KAAK,QAAQ,KAAK,UAAU;AAC/C,MAAI,QAAQ,KAAM,QAAO;AAGzB,SAAO,QAAQ;GACf;AACG,8BAA6B,QAAQ,CAAC,WAAW;AACpD,UAAQ,MAAM,KAAK;GACnB"}
+{"version":3,"file":"index.js","names":["pkg.version"],"sources":["../../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { registry, createDefaultContext, type CLIContext } from './registry.js';\nimport pkg from '../../package.json' with { type: 'json' };\nimport { flushAndClose } from '../utils/logger.js'; // Import flushAndClose for graceful shutdown\nimport { registerExtensionCliCommands } from './bootstrap-extensions.js';\n\n// Import order determines display order in help\nimport './commands/setup.js';\nimport './commands/onboard.js';\nimport './commands/agent.js';\nimport './commands/gateway.js';\nimport './commands/session.js';\nimport './commands/cron.js';\nimport './commands/config.js';\nimport './commands/doctor/index.js';\nimport './commands/image.js';\nimport './commands/channels.js';\nimport './commands/models.js';\nimport { registerExtensionCommands } from './commands/extension.js';\nimport './commands/auth.js';\nimport './commands/skills.js';\nimport './commands/update.js';\nimport './commands/logs.js';\nimport { registerAgentsCli } from './commands/agents.js';\n\n// Global parsed options - updated before each command\nexport let parsedOpts: { config?: string; workspace?: string; verbose?: boolean } = {};\n\nexport function getContextWithOpts(argv: string[] = process.argv): CLIContext {\n  return createDefaultContext(argv, parsedOpts);\n}\n\n// Long-running commands that should not auto-exit\nconst LONG_RUNNING_COMMANDS = new Set(['gateway', 'agent']);\n\nconst program = new Command()\n  .name('xopc')\n  .description('Ultra-Lightweight Personal AI Assistant')\n  .version(pkg.version)\n  .option('--verbose', 'Enable verbose logging', false)\n  .option('--config <path>', 'Config file path')\n  .option('--workspace <path>', 'Workspace directory');\n\n// Hook to capture parsed options before each command runs\nprogram.hook('preAction', (thisCommand) => {\n  parsedOpts = thisCommand.opts();\n});\n\n// Hook to ensure process exits after command completion\nprogram.hook('postAction', async (thisCommand) => {\n  // Get the actual subcommand being executed (not the root program name)\n  const args = thisCommand.args;\n  const subCommandName = args.length > 0 ? args[0] : thisCommand.name();\n\n  // Skip long-running commands (gateway foreground, agent interactive mode)\n  if (LONG_RUNNING_COMMANDS.has(subCommandName)) {\n    // For agent command, only skip exit if interactive mode (-i) is used\n    if (subCommandName === 'agent') {\n      const hasInteractiveFlag = process.argv.includes('-i') || process.argv.includes('--interactive');\n      if (!hasInteractiveFlag) {\n        // Agent in non-interactive mode should exit normally\n        await flushAndClose();\n        process.exit(0);\n      }\n    }\n    // Gateway or agent -i: don't exit\n    return;\n  }\n  // For all other commands, flush logs and exit\n  await flushAndClose();\n  process.exit(0);\n});\n\n// Create initial context (will use env vars and defaults)\nconst ctx = getContextWithOpts(process.argv);\nregistry.install(program, ctx);\nregisterAgentsCli(program);\nregisterExtensionCommands(program);\n\n// Only parse if this is the main module being executed directly\n// Skip parsing when imported as module (e.g., in tests)\nconst isTestEnv = !!process.env.VITEST || !!process.env.TEST || !!process.env.NODE_ENV?.includes('test');\nconst isMainModule = !isTestEnv && import.meta.url.startsWith('file:');\n\nif (isMainModule) {\n  // Filter out standalone '--' separator (passed by pnpm run -- <cmd>)\n  // npm removes it automatically, pnpm passes it through\n  const argv = process.argv.filter((arg, index) => {\n    if (arg !== '--') return true;\n    // Only filter '--' if it's the separator between script and command\n    // (i.e., comes after the script name and before actual args)\n    return index < 2; // Keep '--' if it's a script argument (index 0 or 1)\n  });\n  void registerExtensionCliCommands(program).then(() => {\n    program.parse(argv);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;aAImD;AAuBnD,IAAW,aAAyE,EAAE;AAEtF,SAAgB,mBAAmB,OAAiB,QAAQ,MAAkB;AAC5E,QAAO,qBAAqB,MAAM,WAAW;;AAI/C,MAAM,wBAAwB,IAAI,IAAI,CAAC,WAAW,QAAQ,CAAC;AAE3D,MAAM,UAAU,IAAI,SAAS,CAC1B,KAAK,OAAO,CACZ,YAAY,0CAA0C,CACtD,QAAQA,QAAY,CACpB,OAAO,aAAa,0BAA0B,MAAM,CACpD,OAAO,mBAAmB,mBAAmB,CAC7C,OAAO,sBAAsB,sBAAsB;AAGtD,QAAQ,KAAK,cAAc,gBAAgB;AACzC,cAAa,YAAY,MAAM;EAC/B;AAGF,QAAQ,KAAK,cAAc,OAAO,gBAAgB;CAEhD,MAAM,OAAO,YAAY;CACzB,MAAM,iBAAiB,KAAK,SAAS,IAAI,KAAK,KAAK,YAAY,MAAM;AAGrE,KAAI,sBAAsB,IAAI,eAAe,EAAE;AAE7C,MAAI,mBAAmB;OAEjB,EADuB,QAAQ,KAAK,SAAS,KAAK,IAAI,QAAQ,KAAK,SAAS,gBAAgB,GACvE;AAEvB,UAAM,eAAe;AACrB,YAAQ,KAAK,EAAE;;;AAInB;;AAGF,OAAM,eAAe;AACrB,SAAQ,KAAK,EAAE;EACf;AAGF,MAAM,MAAM,mBAAmB,QAAQ,KAAK;AAC5C,SAAS,QAAQ,SAAS,IAAI;AAC9B,kBAAkB,QAAQ;AAC1B,0BAA0B,QAAQ;AAOlC,IAFqB,EADH,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAA,cAAuB,SAAS,OAAO,KACrE,OAAO,KAAK,IAAI,WAAW,QAAQ,EAEpD;CAGhB,MAAM,OAAO,QAAQ,KAAK,QAAQ,KAAK,UAAU;AAC/C,MAAI,QAAQ,KAAM,QAAO;AAGzB,SAAO,QAAQ;GACf;AACG,8BAA6B,QAAQ,CAAC,WAAW;AACpD,UAAQ,MAAM,KAAK;GACnB"}

package/dist/src/cli/utils/init-workspace.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 { randomBytes } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { randomBytes } from "node:crypto";
 //#region src/cli/utils/init-workspace.ts
 init_schema();
 init_loader();

package/dist/src/config/index.d.ts

@@ -12,6 +12,7 @@ export * from './defaults.js';
 export * from './integration.js';
 export * from './models-json.js';
 export * from './resolve-config-value.js';
+export * from './runtime-overrides.js';
 export type { ThinkLevel, ReasoningLevel, VerboseLevel, ElevatedMode, SessionAgentConfig, } from '../agent/transcript/thinking-types.js';
 export { normalizeThinkLevel, normalizeReasoningLevel, normalizeVerboseLevel, normalizeElevatedMode, listThinkingLevels, formatThinkingLevels, thinkLevelToNumber, } from '../agent/transcript/thinking-types.js';
 export type { ModelApi, ModelCompatConfig, ModelProviderAuthMode, ModelDefinitionConfig, ModelProviderConfig, BedrockDiscoveryConfig, ModelsConfig, } from './types.models.js';

package/dist/src/config/index.js

@@ -2,11 +2,12 @@ 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 { resolveAgentBootstrapDir, resolveAgentDir as resolveAgentDir$1, resolveAgentHomeDir as resolveAgentHomeDir$1, resolveAgentWorkspaceDir, resolveSessionsDir as resolveSessionsDir$1 } from "../agent/agent-scope.js";
+import { FILENAMES, WORKSPACE_FILES, existsSync, init_paths, resolveAgentAuthProfilesPath, resolveAgentCredentialsDir, resolveAgentDir, resolveAgentHomeDir, resolveAgentMetadataPath, 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, resolveSessionTranscriptPathInDir, resolveSessionsArchiveDir, resolveSessionsDir, resolveSessionsIndexPath, 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 { AcpConfigSchema, AcpDispatchConfigSchema, AcpRateLimitConfigSchema, AcpRuntimeConfigSchema, AcpStreamConfigSchema, AgentConfigSchema, AgentDefaultsSchema, AgentModelRefSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayConfigSchema, HeartbeatConfigSchema, ModelsDevConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, getAgentDefaultModelRef, getWorkspacePath, init_schema, parseModelRef } from "./schema.js";
-import { FILENAMES, WORKSPACE_FILES, existsSync, init_paths, resolveAgentAuthProfilesPath, resolveAgentCredentialsDir, resolveAgentDir, resolveAgentHomeDir, resolveAgentMetadataPath, 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, resolveSessionTranscriptPathInDir, resolveSessionsArchiveDir, resolveSessionsDir, resolveSessionsIndexPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath } from "./paths.js";
+import { AgentConfigSchema, AgentDefaultsSchema, AgentModelRefSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayConfigSchema, HeartbeatConfigSchema, ModelsDevConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, getAgentDefaultModelRef, getWorkspacePath, 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";
@@ -24,6 +25,6 @@ init_workspace_path();
 init_models_json();
 init_resolve_config_value();
 //#endregion
-export { AcpConfigSchema, AcpDispatchConfigSchema, AcpRateLimitConfigSchema, AcpRuntimeConfigSchema, AcpStreamConfigSchema, AgentConfigSchema, AgentDefaultsSchema, AgentModelRefSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, ConfigHotReloader, ConfigSchema, CronConfigSchema, CustomModelSchema, ENV_VARS, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayConfigSchema, HeartbeatConfigSchema, ModelOverrideSchema, ModelsDevConfigSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProfileManager, ProviderConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, VercelGatewayRoutingSchema, WORKSPACE_FILES, WebSearchConfigSchema, WebToolsConfigSchema, WeixinAccountConfigSchema, WeixinConfigSchema, buildReloadPlan, clearConfigValueCache, createProfile, deleteProfile, diffConfigPaths, existsSync, expandWorkspacePathString, extractProfileAgentId, formatThinkingLevels, getAgentDefaultModelRef, getAllowedCommands, getCacheStats, getCurrentProfile, getDefaultModelValues, resolveModelsJsonPath as getModelsJsonPath, getProfileManager, getProfileNameFromDir, getSwitchCommand, getWorkspacePath, listAgentBootstrapDirs, listAgentWorkspaceDirs, listProfiles, listThinkingLevels, loadConfig, loadModelsJson, matchReloadRule, modelsJsonExists, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, normalizeWorkspaceDir, parseModelRef, registerChannelConfigValidator, resolveAgentAuthProfilesPath, resolveAgentBootstrapDir, resolveAgentCredentialsDir, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentMetadataPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveConfigValue, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveCronLogPath, resolveCronLogsDir, resolveCronRunsDir, resolveDefaultAgentWorkspaceDir, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHeaders, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveMemoryDir, resolveMemoryPath, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveProfileStateDir, resolveSessionTranscriptPath, resolveSessionTranscriptPathInDir, resolveSessionsArchiveDir, resolveSessionsDir, resolveSessionsDir$1 as resolveSessionsDirFromConfig, resolveSessionsIndexPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceRoot, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, saveConfig, saveModelsJson, testApiKeyResolution, thinkLevelToNumber, validateModelsConfig };
+export { AgentConfigSchema, AgentDefaultsSchema, AgentModelRefSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, ConfigHotReloader, ConfigSchema, CronConfigSchema, CustomModelSchema, ENV_VARS, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayConfigSchema, HeartbeatConfigSchema, ModelOverrideSchema, ModelsDevConfigSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProfileManager, ProviderConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VercelGatewayRoutingSchema, WORKSPACE_FILES, WebSearchConfigSchema, WebToolsConfigSchema, WeixinAccountConfigSchema, WeixinConfigSchema, applyConfigOverrides, buildReloadPlan, clearConfigValueCache, createProfile, deleteProfile, diffConfigPaths, existsSync, expandWorkspacePathString, extractProfileAgentId, formatThinkingLevels, getAgentDefaultModelRef, getAllowedCommands, getCacheStats, getConfigOverrides, getCurrentProfile, getDefaultModelValues, resolveModelsJsonPath as getModelsJsonPath, getProfileManager, getProfileNameFromDir, getSwitchCommand, getWorkspacePath, listAgentBootstrapDirs, listAgentWorkspaceDirs, listProfiles, listThinkingLevels, loadConfig, loadModelsJson, matchReloadRule, modelsJsonExists, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, normalizeWorkspaceDir, parseModelRef, registerChannelConfigValidator, resetConfigOverrides, resolveAgentAuthProfilesPath, resolveAgentBootstrapDir, resolveAgentCredentialsDir, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentMetadataPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveConfigValue, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveCronLogPath, resolveCronLogsDir, resolveCronRunsDir, resolveDefaultAgentWorkspaceDir, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHeaders, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveMemoryDir, resolveMemoryPath, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveProfileStateDir, resolveSessionTranscriptPath, resolveSessionTranscriptPathInDir, resolveSessionsArchiveDir, resolveSessionsDir, resolveSessionsDir$1 as resolveSessionsDirFromConfig, resolveSessionsIndexPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceRoot, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, saveConfig, saveModelsJson, setConfigOverride, testApiKeyResolution, thinkLevelToNumber, unsetConfigOverride, validateModelsConfig };
 
 //# sourceMappingURL=index.js.map

package/dist/src/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/config/index.ts"],"sourcesContent":["export * from './schema.js';\nexport * from './agent-profile.js';\nexport * from './loader.js';\nexport * from './paths.js';\nexport * from './workspace-dirs.js';\nexport { expandWorkspacePathString, normalizeWorkspaceDir, resolveWorkspaceRoot } from './workspace-path.js';\nexport * from './profile.js';\nexport * from './reload.js';\nexport * from './diff.js';\nexport * from './rules.js';\nexport * from './defaults.js';\nexport * from './integration.js';\nexport * from './models-json.js';\nexport * from './resolve-config-value.js';\n\n// Re-export thinking types\nexport type {\n  ThinkLevel,\n  ReasoningLevel,\n  VerboseLevel,\n  ElevatedMode,\n  SessionAgentConfig,\n} from '../agent/transcript/thinking-types.js';\nexport {\n  normalizeThinkLevel,\n  normalizeReasoningLevel,\n  normalizeVerboseLevel,\n  normalizeElevatedMode,\n  listThinkingLevels,\n  formatThinkingLevels,\n  thinkLevelToNumber,\n} from '../agent/transcript/thinking-types.js';\n\n// Re-export types from types.models (avoid conflict with schema.js)\nexport type {\n  ModelApi,\n  ModelCompatConfig,\n  ModelProviderAuthMode,\n  ModelDefinitionConfig,\n  ModelProviderConfig,\n  BedrockDiscoveryConfig,\n  ModelsConfig,\n} from './types.models.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;qBAK6G"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/config/index.ts"],"sourcesContent":["export * from './schema.js';\nexport * from './agent-profile.js';\nexport * from './loader.js';\nexport * from './paths.js';\nexport * from './workspace-dirs.js';\nexport { expandWorkspacePathString, normalizeWorkspaceDir, resolveWorkspaceRoot } from './workspace-path.js';\nexport * from './profile.js';\nexport * from './reload.js';\nexport * from './diff.js';\nexport * from './rules.js';\nexport * from './defaults.js';\nexport * from './integration.js';\nexport * from './models-json.js';\nexport * from './resolve-config-value.js';\nexport * from './runtime-overrides.js';\n\n// Re-export thinking types\nexport type {\n  ThinkLevel,\n  ReasoningLevel,\n  VerboseLevel,\n  ElevatedMode,\n  SessionAgentConfig,\n} from '../agent/transcript/thinking-types.js';\nexport {\n  normalizeThinkLevel,\n  normalizeReasoningLevel,\n  normalizeVerboseLevel,\n  normalizeElevatedMode,\n  listThinkingLevels,\n  formatThinkingLevels,\n  thinkLevelToNumber,\n} from '../agent/transcript/thinking-types.js';\n\n// Re-export types from types.models (avoid conflict with schema.js)\nexport type {\n  ModelApi,\n  ModelCompatConfig,\n  ModelProviderAuthMode,\n  ModelDefinitionConfig,\n  ModelProviderConfig,\n  BedrockDiscoveryConfig,\n  ModelsConfig,\n} from './types.models.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;qBAK6G"}

package/dist/src/config/loader.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { ConfigSchema, init_schema } from "./schema.js";
 import { init_paths, resolveConfigPath } from "./paths.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/models-json.d.ts

@@ -78,11 +78,11 @@ export declare const CustomModelSchema: z.ZodObject<{
     api: z.ZodOptional<z.ZodEnum<{
         "openai-completions": "openai-completions";
         "openai-responses": "openai-responses";
-        "azure-openai-responses": "azure-openai-responses";
-        "openai-codex-responses": "openai-codex-responses";
         "anthropic-messages": "anthropic-messages";
-        "bedrock-converse-stream": "bedrock-converse-stream";
         "google-generative-ai": "google-generative-ai";
+        "azure-openai-responses": "azure-openai-responses";
+        "bedrock-converse-stream": "bedrock-converse-stream";
+        "openai-codex-responses": "openai-codex-responses";
         "google-gemini-cli": "google-gemini-cli";
         "google-vertex": "google-vertex";
     }>>;
@@ -180,11 +180,11 @@ export declare const ProviderConfigSchema: z.ZodObject<{
     api: z.ZodOptional<z.ZodEnum<{
         "openai-completions": "openai-completions";
         "openai-responses": "openai-responses";
-        "azure-openai-responses": "azure-openai-responses";
-        "openai-codex-responses": "openai-codex-responses";
         "anthropic-messages": "anthropic-messages";
-        "bedrock-converse-stream": "bedrock-converse-stream";
         "google-generative-ai": "google-generative-ai";
+        "azure-openai-responses": "azure-openai-responses";
+        "bedrock-converse-stream": "bedrock-converse-stream";
+        "openai-codex-responses": "openai-codex-responses";
         "google-gemini-cli": "google-gemini-cli";
         "google-vertex": "google-vertex";
     }>>;
@@ -196,11 +196,11 @@ export declare const ProviderConfigSchema: z.ZodObject<{
         api: z.ZodOptional<z.ZodEnum<{
             "openai-completions": "openai-completions";
             "openai-responses": "openai-responses";
-            "azure-openai-responses": "azure-openai-responses";
-            "openai-codex-responses": "openai-codex-responses";
             "anthropic-messages": "anthropic-messages";
-            "bedrock-converse-stream": "bedrock-converse-stream";
             "google-generative-ai": "google-generative-ai";
+            "azure-openai-responses": "azure-openai-responses";
+            "bedrock-converse-stream": "bedrock-converse-stream";
+            "openai-codex-responses": "openai-codex-responses";
             "google-gemini-cli": "google-gemini-cli";
             "google-vertex": "google-vertex";
         }>>;
@@ -300,11 +300,11 @@ export declare const ModelsJsonSchema: z.ZodObject<{
         api: z.ZodOptional<z.ZodEnum<{
             "openai-completions": "openai-completions";
             "openai-responses": "openai-responses";
-            "azure-openai-responses": "azure-openai-responses";
-            "openai-codex-responses": "openai-codex-responses";
             "anthropic-messages": "anthropic-messages";
-            "bedrock-converse-stream": "bedrock-converse-stream";
             "google-generative-ai": "google-generative-ai";
+            "azure-openai-responses": "azure-openai-responses";
+            "bedrock-converse-stream": "bedrock-converse-stream";
+            "openai-codex-responses": "openai-codex-responses";
             "google-gemini-cli": "google-gemini-cli";
             "google-vertex": "google-vertex";
         }>>;
@@ -316,11 +316,11 @@ export declare const ModelsJsonSchema: z.ZodObject<{
             api: z.ZodOptional<z.ZodEnum<{
                 "openai-completions": "openai-completions";
                 "openai-responses": "openai-responses";
-                "azure-openai-responses": "azure-openai-responses";
-                "openai-codex-responses": "openai-codex-responses";
                 "anthropic-messages": "anthropic-messages";
-                "bedrock-converse-stream": "bedrock-converse-stream";
                 "google-generative-ai": "google-generative-ai";
+                "azure-openai-responses": "azure-openai-responses";
+                "bedrock-converse-stream": "bedrock-converse-stream";
+                "openai-codex-responses": "openai-codex-responses";
                 "google-gemini-cli": "google-gemini-cli";
                 "google-vertex": "google-vertex";
             }>>;

package/dist/src/config/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","names":["resolveAgentDirScoped","resolveAgentHomeScoped","resolveSessionsDirScoped"],"sources":["../../../src/config/paths.ts"],"sourcesContent":["import { join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { dirname } from 'path';\nimport { existsSync } from 'fs';\n\nimport type { Config } from './schema.js';\nimport {\n  resolveAgentDir as resolveAgentDirScoped,\n  resolveAgentHomeDir as resolveAgentHomeScoped,\n  resolveAgentWorkspaceDir,\n  resolveSessionsDir as resolveSessionsDirScoped,\n} from '../agent/agent-scope.js';\nimport { ENV_VARS, resolveHomeDir, resolveStateDir } from './paths-state.js';\nimport { resolveDefaultAgentWorkspaceDir } from './workspace-defaults.js';\n\nexport { ENV_VARS, resolveHomeDir, resolveStateDir } from './paths-state.js';\nexport { resolveDefaultAgentWorkspaceDir } from './workspace-defaults.js';\nexport {\n  resolveAgentWorkspaceDir,\n  resolveAgentBootstrapDir,\n  resolveAgentDir as resolveAgentDirFromConfig,\n  resolveAgentHomeDir as resolveAgentHomeDirFromConfig,\n  resolveSessionsDir as resolveSessionsDirFromConfig,\n} from '../agent/agent-scope.js';\n\n// ============================================\n// File Names\n// ============================================\nexport const FILENAMES = {\n  CONFIG: 'xopc.json',\n  MODELS_JSON: 'models.json',\n  AGENT_JSON: 'agent.json',\n  SESSIONS_INDEX: 'index.json',\n  EXTENSIONS_LOCK: 'extensions-lock.json',\n  CREDENTIALS_PROFILES: 'auth-profiles.json',\n  CRON_JOBS: 'jobs.json',\n  WORKSPACE_STATE: 'workspace.json',\n  SKILLS_CACHE: 'skills-cache.json',\n  /** Hub / CLI install provenance for ~/.xopc/skills/<id>. */\n  SKILLS_LOCK: 'skills-lock.json',\n  PID: 'pid',\n  STATUS: 'status.json',\n  SOCKET: 'agent.sock',\n} as const;\n\n// ============================================\n// Workspace Files\n// ============================================\nexport const WORKSPACE_FILES = {\n  SOUL: 'SOUL.md',\n  IDENTITY: 'IDENTITY.md',\n  USER: 'USER.md',\n  AGENTS: 'AGENTS.md',\n  TOOLS: 'TOOLS.md',\n  HEARTBEAT: 'HEARTBEAT.md',\n  MEMORY: 'MEMORY.md',\n  CONTEXT: 'CONTEXT.md',\n  SKILLS: 'SKILLS.md',\n  BOOTSTRAP: 'BOOTSTRAP.md',\n} as const;\n\n// ============================================\n// Path Resolution Functions\n// ============================================\n\n/**\n * Resolve the main config file path\n */\nexport function resolveConfigPath(): string {\n  return process.env[ENV_VARS.CONFIG_PATH] ?? join(resolveStateDir(), FILENAMES.CONFIG);\n}\n\n/**\n * Resolve the credentials directory\n */\nexport function resolveCredentialsDir(): string {\n  return process.env[ENV_VARS.CREDENTIALS_DIR] ?? join(resolveStateDir(), 'credentials');\n}\n\n/**\n * Resolve the global auth-profiles.json path\n */\nexport function resolveAuthProfilesPath(): string {\n  return join(resolveCredentialsDir(), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve OAuth token file path for a provider\n */\nexport function resolveOAuthPath(provider: string): string {\n  return join(resolveCredentialsDir(), 'oauth', `${provider}.json`);\n}\n\n/**\n * Internal agent state dir: `stateDir/agents/<id>/agent/`\n * (credentials, inbox IPC, pid, agent.json — not the Markdown workspace).\n */\nexport function resolveAgentDir(config: Config, agentId: string): string {\n  return resolveAgentDirScoped(config, agentId);\n}\n\n/**\n * Per-agent home: `stateDir/agents/<id>/` (sessions + `agent/`).\n */\nexport function resolveAgentHomeDir(config: Config, agentId: string): string {\n  return resolveAgentHomeScoped(config, agentId);\n}\n\n/**\n * Resolve a specific workspace file path\n */\nexport function resolveWorkspaceFile(config: Config, filename: string, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), filename);\n}\n\n/**\n * Resolve the agent's private credentials directory\n */\nexport function resolveAgentCredentialsDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'credentials');\n}\n\n/**\n * Resolve agent's private auth-profiles.json path\n */\nexport function resolveAgentAuthProfilesPath(config: Config, agentId: string): string {\n  return join(resolveAgentCredentialsDir(config, agentId), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Agent session store root. Transcript files are stored in subfolders (users/…, system/heartbeat, …), not as a flat list.\n */\nexport function resolveSessionsDir(config: Config, agentId: string): string {\n  return resolveSessionsDirScoped(config, agentId);\n}\n\n/**\n * Resolve the sessions index file path\n */\nexport function resolveSessionsIndexPath(config: Config, agentId: string): string {\n  return join(resolveSessionsDir(config, agentId), FILENAMES.SESSIONS_INDEX);\n}\n\n/**\n * Resolve the sessions archive directory\n */\nexport function resolveSessionsArchiveDir(config: Config, agentId: string): string {\n  return join(resolveSessionsDir(config, agentId), 'archive');\n}\n\n/**\n * Resolve a session transcript file path, with optional topic sharding.\n * Topic IDs are URL-encoded when they are strings to prevent path traversal.\n */\nexport function resolveSessionTranscriptPath(\n  config: Config,\n  sessionId: string,\n  agentId: string,\n  topicId?: string | number,\n): string {\n  const safeTopicId =\n    typeof topicId === 'string'\n      ? encodeURIComponent(topicId)\n      : typeof topicId === 'number'\n        ? String(topicId)\n        : undefined;\n  const fileName =\n    safeTopicId !== undefined\n      ? `${sessionId}-topic-${safeTopicId}.jsonl`\n      : `${sessionId}.jsonl`;\n  return join(resolveSessionsDir(config, agentId), fileName);\n}\n\n/**\n * Resolve a session transcript path within an explicit sessions directory.\n * Useful when the caller already holds a resolved sessions dir (e.g. from config).\n */\nexport function resolveSessionTranscriptPathInDir(\n  sessionId: string,\n  sessionsDir: string,\n  topicId?: string | number,\n): string {\n  const safeTopicId =\n    typeof topicId === 'string'\n      ? encodeURIComponent(topicId)\n      : typeof topicId === 'number'\n        ? String(topicId)\n        : undefined;\n  const fileName =\n    safeTopicId !== undefined\n      ? `${sessionId}-topic-${safeTopicId}.jsonl`\n      : `${sessionId}.jsonl`;\n  return join(sessionsDir, fileName);\n}\n\n/**\n * Resolve the inbox directory for an agent\n */\nexport function resolveInboxDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'inbox');\n}\n\n/**\n * Resolve the pending inbox directory\n */\nexport function resolveInboxPendingDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'pending');\n}\n\n/**\n * Resolve the processed inbox directory\n */\nexport function resolveInboxProcessedDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'processed');\n}\n\n/**\n * Resolve a specific inbox message path\n */\nexport function resolveInboxMessagePath(\n  config: Config,\n  messageId: string,\n  pending: boolean,\n  agentId: string,\n): string {\n  const dir = pending ? resolveInboxPendingDir(config, agentId) : resolveInboxProcessedDir(config, agentId);\n  return join(dir, `${messageId}.json`);\n}\n\n/**\n * Resolve the pid file path\n */\nexport function resolvePidPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.PID);\n}\n\n/**\n * Resolve the status.json path\n */\nexport function resolveStatusPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.STATUS);\n}\n\n/**\n * Resolve the Unix socket path\n */\nexport function resolveSocketPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.SOCKET);\n}\n\n/**\n * Resolve the extensions directory (global)\n */\nexport function resolveExtensionsDir(): string {\n  return join(resolveStateDir(), 'extensions');\n}\n\n/**\n * Resolve the extensions lockfile path\n */\nexport function resolveExtensionsLockPath(): string {\n  return join(resolveExtensionsDir(), FILENAMES.EXTENSIONS_LOCK);\n}\n\n/**\n * Per-agent extension install directory (`…/agent/extensions/`), not under the markdown workspace.\n */\nexport function resolveWorkspaceExtensionsDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'extensions');\n}\n\n/**\n * Resolve the skills directory (global)\n */\nexport function resolveSkillsDir(): string {\n  return join(resolveStateDir(), 'skills');\n}\n\n/**\n * Resolve a specific skill path\n */\nexport function resolveSkillPath(skillId: string): string {\n  return join(resolveSkillsDir(), skillId, 'SKILL.md');\n}\n\n/**\n * Skills hub lock file (~/.xopc/skills-lock.json): install source + content hash per managed skill id.\n */\nexport function resolveSkillsLockPath(): string {\n  return join(resolveStateDir(), FILENAMES.SKILLS_LOCK);\n}\n\n/**\n * Resolve the cron directory\n */\nexport function resolveCronDir(): string {\n  return join(resolveStateDir(), 'cron');\n}\n\n/**\n * Resolve the cron jobs file path\n */\nexport function resolveCronJobsPath(): string {\n  return join(resolveCronDir(), FILENAMES.CRON_JOBS);\n}\n\n/**\n * Resolve the cron logs directory\n */\nexport function resolveCronLogsDir(): string {\n  return join(resolveCronDir(), 'logs');\n}\n\n/**\n * Directory for persisted cron run history (one JSONL file per job id).\n */\nexport function resolveCronRunsDir(): string {\n  return join(resolveCronDir(), 'runs');\n}\n\n/**\n * Resolve a specific cron log file path\n */\nexport function resolveCronLogPath(date: string): string {\n  return join(resolveCronLogsDir(), `${date}.jsonl`);\n}\n\n/**\n * Resolve the logs directory\n */\nexport function resolveLogsDir(): string {\n  return process.env[ENV_VARS.LOG_DIR] ?? join(resolveStateDir(), 'logs');\n}\n\n/**\n * Resolve a specific log file path\n */\nexport function resolveLogPath(date: string): string {\n  return join(resolveLogsDir(), `xopc-${date}.log`);\n}\n\n/**\n * Resolve the bin directory\n */\nexport function resolveBinDir(): string {\n  return join(resolveStateDir(), 'bin');\n}\n\n/**\n * Resolve the xopc CLI path\n */\nexport function resolveXopcBinPath(): string {\n  return join(resolveBinDir(), 'xopc');\n}\n\n/**\n * Resolve the tools directory\n */\nexport function resolveToolsDir(): string {\n  return join(resolveStateDir(), 'tools');\n}\n\n/**\n * Resolve the Node.js tools directory\n */\nexport function resolveNodeToolsDir(): string {\n  return join(resolveToolsDir(), 'node');\n}\n\n/**\n * Resolve the current Node.js bin directory\n */\nexport function resolveNodeBinDir(): string {\n  return join(resolveNodeToolsDir(), 'current', 'bin');\n}\n\n/**\n * Resolve the node binary path\n */\nexport function resolveNodeBinPath(): string {\n  return join(resolveNodeBinDir(), 'node');\n}\n\n/**\n * Resolve the npm binary path\n */\nexport function resolveNpmBinPath(): string {\n  return join(resolveNodeBinDir(), 'npm');\n}\n\n/**\n * Resolve the models.json path\n */\nexport function resolveModelsJsonPath(): string {\n  return join(resolveStateDir(), FILENAMES.MODELS_JSON);\n}\n\n/**\n * Resolve the agent metadata file path\n */\nexport function resolveAgentMetadataPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.AGENT_JSON);\n}\n\n/**\n * Resolve per-agent machine state directory (`…/agent/state/`), not under the markdown workspace.\n */\nexport function resolveWorkspaceStateDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'state');\n}\n\n/**\n * Resolve the workspace state file path\n */\nexport function resolveWorkspaceStatePath(config: Config, agentId: string): string {\n  return join(resolveWorkspaceStateDir(config, agentId), FILENAMES.WORKSPACE_STATE);\n}\n\n/**\n * Resolve the skills cache file path\n */\nexport function resolveSkillsCachePath(config: Config, agentId: string): string {\n  return join(resolveWorkspaceStateDir(config, agentId), FILENAMES.SKILLS_CACHE);\n}\n\n/**\n * Resolve the memory directory\n */\nexport function resolveMemoryDir(config: Config, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), 'memory');\n}\n\n/**\n * Resolve a specific memory file path\n */\nexport function resolveMemoryPath(config: Config, date: string, agentId: string): string {\n  return join(resolveMemoryDir(config, agentId), `${date}.md`);\n}\n\n/**\n * Resolve the bundled extensions directory (shipped with xopc)\n */\nexport function resolveBundledExtensionsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const bundledDir = join(srcDir, '..', '..', 'extensions');\n    return bundledDir;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve the bundled skills directory (shipped with xopc)\n */\nexport function resolveBundledSkillsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    \n    // Production (npm): dist/config/paths.js -> ../../ -> package root -> skills\n    const packageRoot = join(srcDir, '..', '..');\n    const skillsDir = join(packageRoot, 'skills');\n    if (existsSync(skillsDir)) {\n      return skillsDir;\n    }\n    \n    // Development (source): src/config/paths.js -> ../../../ -> package root -> skills\n    const devPackageRoot = join(srcDir, '..', '..', '..');\n    const devSkillsDir = join(devPackageRoot, 'skills');\n    if (existsSync(devSkillsDir)) {\n      return devSkillsDir;\n    }\n    \n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Path to extension-sdk entry (for jiti / extension loader aliases).\n */\nexport function resolveExtensionSdkPath(): string {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const adjacent = join(srcDir, '..', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(adjacent)) {\n      return adjacent;\n    }\n    const fromPackageRoot = join(srcDir, '..', '..', 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(fromPackageRoot)) {\n      return fromPackageRoot;\n    }\n    const cwd = join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(cwd)) {\n      return cwd;\n    }\n    return adjacent;\n  } catch {\n    return join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n  }\n}\n\n// Re-export existsSync for bundled paths\nexport { existsSync };\n"],"mappings":"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"}
+{"version":3,"file":"paths.js","names":["resolveAgentDirScoped","resolveAgentHomeScoped","resolveSessionsDirScoped"],"sources":["../../../src/config/paths.ts"],"sourcesContent":["import { join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { dirname } from 'path';\nimport { existsSync } from 'fs';\n\nimport type { Config } from './schema.js';\nimport {\n  resolveAgentDir as resolveAgentDirScoped,\n  resolveAgentHomeDir as resolveAgentHomeScoped,\n  resolveAgentWorkspaceDir,\n  resolveSessionsDir as resolveSessionsDirScoped,\n} from '../agent/agent-scope.js';\nimport { ENV_VARS, resolveStateDir } from './paths-state.js';\n\nexport { ENV_VARS, resolveHomeDir, resolveStateDir } from './paths-state.js';\nexport { resolveDefaultAgentWorkspaceDir } from './workspace-defaults.js';\nexport {\n  resolveAgentWorkspaceDir,\n  resolveAgentBootstrapDir,\n  resolveAgentDir as resolveAgentDirFromConfig,\n  resolveAgentHomeDir as resolveAgentHomeDirFromConfig,\n  resolveSessionsDir as resolveSessionsDirFromConfig,\n} from '../agent/agent-scope.js';\n\n// ============================================\n// File Names\n// ============================================\nexport const FILENAMES = {\n  CONFIG: 'xopc.json',\n  MODELS_JSON: 'models.json',\n  AGENT_JSON: 'agent.json',\n  SESSIONS_INDEX: 'index.json',\n  EXTENSIONS_LOCK: 'extensions-lock.json',\n  CREDENTIALS_PROFILES: 'auth-profiles.json',\n  CRON_JOBS: 'jobs.json',\n  WORKSPACE_STATE: 'workspace.json',\n  SKILLS_CACHE: 'skills-cache.json',\n  /** Hub / CLI install provenance for ~/.xopc/skills/<id>. */\n  SKILLS_LOCK: 'skills-lock.json',\n  PID: 'pid',\n  STATUS: 'status.json',\n  SOCKET: 'agent.sock',\n} as const;\n\n// ============================================\n// Workspace Files\n// ============================================\nexport const WORKSPACE_FILES = {\n  SOUL: 'SOUL.md',\n  IDENTITY: 'IDENTITY.md',\n  USER: 'USER.md',\n  AGENTS: 'AGENTS.md',\n  TOOLS: 'TOOLS.md',\n  HEARTBEAT: 'HEARTBEAT.md',\n  MEMORY: 'MEMORY.md',\n  CONTEXT: 'CONTEXT.md',\n  SKILLS: 'SKILLS.md',\n  BOOTSTRAP: 'BOOTSTRAP.md',\n} as const;\n\n// ============================================\n// Path Resolution Functions\n// ============================================\n\n/**\n * Resolve the main config file path\n */\nexport function resolveConfigPath(): string {\n  return process.env[ENV_VARS.CONFIG_PATH] ?? join(resolveStateDir(), FILENAMES.CONFIG);\n}\n\n/**\n * Resolve the credentials directory\n */\nexport function resolveCredentialsDir(): string {\n  return process.env[ENV_VARS.CREDENTIALS_DIR] ?? join(resolveStateDir(), 'credentials');\n}\n\n/**\n * Resolve the global auth-profiles.json path\n */\nexport function resolveAuthProfilesPath(): string {\n  return join(resolveCredentialsDir(), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve OAuth token file path for a provider\n */\nexport function resolveOAuthPath(provider: string): string {\n  return join(resolveCredentialsDir(), 'oauth', `${provider}.json`);\n}\n\n/**\n * Internal agent state dir: `stateDir/agents/<id>/agent/`\n * (credentials, inbox IPC, pid, agent.json — not the Markdown workspace).\n */\nexport function resolveAgentDir(config: Config, agentId: string): string {\n  return resolveAgentDirScoped(config, agentId);\n}\n\n/**\n * Per-agent home: `stateDir/agents/<id>/` (sessions + `agent/`).\n */\nexport function resolveAgentHomeDir(config: Config, agentId: string): string {\n  return resolveAgentHomeScoped(config, agentId);\n}\n\n/**\n * Resolve a specific workspace file path\n */\nexport function resolveWorkspaceFile(config: Config, filename: string, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), filename);\n}\n\n/**\n * Resolve the agent's private credentials directory\n */\nexport function resolveAgentCredentialsDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'credentials');\n}\n\n/**\n * Resolve agent's private auth-profiles.json path\n */\nexport function resolveAgentAuthProfilesPath(config: Config, agentId: string): string {\n  return join(resolveAgentCredentialsDir(config, agentId), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Agent session store root. Transcript files are stored in subfolders (users/…, system/heartbeat, …), not as a flat list.\n */\nexport function resolveSessionsDir(config: Config, agentId: string): string {\n  return resolveSessionsDirScoped(config, agentId);\n}\n\n/**\n * Resolve the sessions index file path\n */\nexport function resolveSessionsIndexPath(config: Config, agentId: string): string {\n  return join(resolveSessionsDir(config, agentId), FILENAMES.SESSIONS_INDEX);\n}\n\n/**\n * Resolve the sessions archive directory\n */\nexport function resolveSessionsArchiveDir(config: Config, agentId: string): string {\n  return join(resolveSessionsDir(config, agentId), 'archive');\n}\n\n/**\n * Resolve a session transcript file path, with optional topic sharding.\n * Topic IDs are URL-encoded when they are strings to prevent path traversal.\n */\nexport function resolveSessionTranscriptPath(\n  config: Config,\n  sessionId: string,\n  agentId: string,\n  topicId?: string | number,\n): string {\n  const safeTopicId =\n    typeof topicId === 'string'\n      ? encodeURIComponent(topicId)\n      : typeof topicId === 'number'\n        ? String(topicId)\n        : undefined;\n  const fileName =\n    safeTopicId !== undefined\n      ? `${sessionId}-topic-${safeTopicId}.jsonl`\n      : `${sessionId}.jsonl`;\n  return join(resolveSessionsDir(config, agentId), fileName);\n}\n\n/**\n * Resolve a session transcript path within an explicit sessions directory.\n * Useful when the caller already holds a resolved sessions dir (e.g. from config).\n */\nexport function resolveSessionTranscriptPathInDir(\n  sessionId: string,\n  sessionsDir: string,\n  topicId?: string | number,\n): string {\n  const safeTopicId =\n    typeof topicId === 'string'\n      ? encodeURIComponent(topicId)\n      : typeof topicId === 'number'\n        ? String(topicId)\n        : undefined;\n  const fileName =\n    safeTopicId !== undefined\n      ? `${sessionId}-topic-${safeTopicId}.jsonl`\n      : `${sessionId}.jsonl`;\n  return join(sessionsDir, fileName);\n}\n\n/**\n * Resolve the inbox directory for an agent\n */\nexport function resolveInboxDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'inbox');\n}\n\n/**\n * Resolve the pending inbox directory\n */\nexport function resolveInboxPendingDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'pending');\n}\n\n/**\n * Resolve the processed inbox directory\n */\nexport function resolveInboxProcessedDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'processed');\n}\n\n/**\n * Resolve a specific inbox message path\n */\nexport function resolveInboxMessagePath(\n  config: Config,\n  messageId: string,\n  pending: boolean,\n  agentId: string,\n): string {\n  const dir = pending ? resolveInboxPendingDir(config, agentId) : resolveInboxProcessedDir(config, agentId);\n  return join(dir, `${messageId}.json`);\n}\n\n/**\n * Resolve the pid file path\n */\nexport function resolvePidPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.PID);\n}\n\n/**\n * Resolve the status.json path\n */\nexport function resolveStatusPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.STATUS);\n}\n\n/**\n * Resolve the Unix socket path\n */\nexport function resolveSocketPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.SOCKET);\n}\n\n/**\n * Resolve the extensions directory (global)\n */\nexport function resolveExtensionsDir(): string {\n  return join(resolveStateDir(), 'extensions');\n}\n\n/**\n * Resolve the extensions lockfile path\n */\nexport function resolveExtensionsLockPath(): string {\n  return join(resolveExtensionsDir(), FILENAMES.EXTENSIONS_LOCK);\n}\n\n/**\n * Per-agent extension install directory (`…/agent/extensions/`), not under the markdown workspace.\n */\nexport function resolveWorkspaceExtensionsDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'extensions');\n}\n\n/**\n * Resolve the skills directory (global)\n */\nexport function resolveSkillsDir(): string {\n  return join(resolveStateDir(), 'skills');\n}\n\n/**\n * Resolve a specific skill path\n */\nexport function resolveSkillPath(skillId: string): string {\n  return join(resolveSkillsDir(), skillId, 'SKILL.md');\n}\n\n/**\n * Skills hub lock file (~/.xopc/skills-lock.json): install source + content hash per managed skill id.\n */\nexport function resolveSkillsLockPath(): string {\n  return join(resolveStateDir(), FILENAMES.SKILLS_LOCK);\n}\n\n/**\n * Resolve the cron directory\n */\nexport function resolveCronDir(): string {\n  return join(resolveStateDir(), 'cron');\n}\n\n/**\n * Resolve the cron jobs file path\n */\nexport function resolveCronJobsPath(): string {\n  return join(resolveCronDir(), FILENAMES.CRON_JOBS);\n}\n\n/**\n * Resolve the cron logs directory\n */\nexport function resolveCronLogsDir(): string {\n  return join(resolveCronDir(), 'logs');\n}\n\n/**\n * Directory for persisted cron run history (one JSONL file per job id).\n */\nexport function resolveCronRunsDir(): string {\n  return join(resolveCronDir(), 'runs');\n}\n\n/**\n * Resolve a specific cron log file path\n */\nexport function resolveCronLogPath(date: string): string {\n  return join(resolveCronLogsDir(), `${date}.jsonl`);\n}\n\n/**\n * Resolve the logs directory\n */\nexport function resolveLogsDir(): string {\n  return process.env[ENV_VARS.LOG_DIR] ?? join(resolveStateDir(), 'logs');\n}\n\n/**\n * Resolve a specific log file path\n */\nexport function resolveLogPath(date: string): string {\n  return join(resolveLogsDir(), `xopc-${date}.log`);\n}\n\n/**\n * Resolve the bin directory\n */\nexport function resolveBinDir(): string {\n  return join(resolveStateDir(), 'bin');\n}\n\n/**\n * Resolve the xopc CLI path\n */\nexport function resolveXopcBinPath(): string {\n  return join(resolveBinDir(), 'xopc');\n}\n\n/**\n * Resolve the tools directory\n */\nexport function resolveToolsDir(): string {\n  return join(resolveStateDir(), 'tools');\n}\n\n/**\n * Resolve the Node.js tools directory\n */\nexport function resolveNodeToolsDir(): string {\n  return join(resolveToolsDir(), 'node');\n}\n\n/**\n * Resolve the current Node.js bin directory\n */\nexport function resolveNodeBinDir(): string {\n  return join(resolveNodeToolsDir(), 'current', 'bin');\n}\n\n/**\n * Resolve the node binary path\n */\nexport function resolveNodeBinPath(): string {\n  return join(resolveNodeBinDir(), 'node');\n}\n\n/**\n * Resolve the npm binary path\n */\nexport function resolveNpmBinPath(): string {\n  return join(resolveNodeBinDir(), 'npm');\n}\n\n/**\n * Resolve the models.json path\n */\nexport function resolveModelsJsonPath(): string {\n  return join(resolveStateDir(), FILENAMES.MODELS_JSON);\n}\n\n/**\n * Resolve the agent metadata file path\n */\nexport function resolveAgentMetadataPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.AGENT_JSON);\n}\n\n/**\n * Resolve per-agent machine state directory (`…/agent/state/`), not under the markdown workspace.\n */\nexport function resolveWorkspaceStateDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'state');\n}\n\n/**\n * Resolve the workspace state file path\n */\nexport function resolveWorkspaceStatePath(config: Config, agentId: string): string {\n  return join(resolveWorkspaceStateDir(config, agentId), FILENAMES.WORKSPACE_STATE);\n}\n\n/**\n * Resolve the skills cache file path\n */\nexport function resolveSkillsCachePath(config: Config, agentId: string): string {\n  return join(resolveWorkspaceStateDir(config, agentId), FILENAMES.SKILLS_CACHE);\n}\n\n/**\n * Resolve the memory directory\n */\nexport function resolveMemoryDir(config: Config, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), 'memory');\n}\n\n/**\n * Resolve a specific memory file path\n */\nexport function resolveMemoryPath(config: Config, date: string, agentId: string): string {\n  return join(resolveMemoryDir(config, agentId), `${date}.md`);\n}\n\n/**\n * Resolve the bundled extensions directory (shipped with xopc)\n */\nexport function resolveBundledExtensionsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const bundledDir = join(srcDir, '..', '..', 'extensions');\n    return bundledDir;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve the bundled skills directory (shipped with xopc)\n */\nexport function resolveBundledSkillsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    \n    // Production (npm): dist/config/paths.js -> ../../ -> package root -> skills\n    const packageRoot = join(srcDir, '..', '..');\n    const skillsDir = join(packageRoot, 'skills');\n    if (existsSync(skillsDir)) {\n      return skillsDir;\n    }\n    \n    // Development (source): src/config/paths.js -> ../../../ -> package root -> skills\n    const devPackageRoot = join(srcDir, '..', '..', '..');\n    const devSkillsDir = join(devPackageRoot, 'skills');\n    if (existsSync(devSkillsDir)) {\n      return devSkillsDir;\n    }\n    \n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Path to extension-sdk entry (for jiti / extension loader aliases).\n */\nexport function resolveExtensionSdkPath(): string {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const adjacent = join(srcDir, '..', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(adjacent)) {\n      return adjacent;\n    }\n    const fromPackageRoot = join(srcDir, '..', '..', 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(fromPackageRoot)) {\n      return fromPackageRoot;\n    }\n    const cwd = join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(cwd)) {\n      return cwd;\n    }\n    return adjacent;\n  } catch {\n    return join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n  }\n}\n\n// Re-export existsSync for bundled paths\nexport { existsSync };\n"],"mappings":"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"}

package/dist/src/config/profile.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { ENV_VARS, init_paths_state, resolveHomeDir } from "./paths-state.js";
+import { mkdir, readdir, rm, stat } from "fs/promises";
 import { join } from "path";
 import { existsSync } from "fs";
-import { mkdir, readdir, rm, stat } from "fs/promises";
 //#region src/config/profile.ts
 init_logger();
 init_paths_state();

package/dist/src/config/runtime-overrides.d.ts

@@ -0,0 +1,8 @@
+type OverrideTree = Record<string, unknown>;
+export declare function getConfigOverrides(): OverrideTree;
+export declare function resetConfigOverrides(): void;
+export declare function setConfigOverride(path: string[], value: unknown): void;
+export declare function unsetConfigOverride(path: string[]): void;
+/** Deep-merge overrides on top of base config (process lifetime only). */
+export declare function applyConfigOverrides<T extends object>(base: T): T;
+export {};

package/dist/src/config/runtime-overrides.js

@@ -0,0 +1,40 @@
+//#region src/config/runtime-overrides.ts
+let overrides = {};
+function getConfigOverrides() {
+	return overrides;
+}
+function resetConfigOverrides() {
+	overrides = {};
+}
+function setConfigOverride(path, value) {
+	let cursor = overrides;
+	for (let i = 0; i < path.length - 1; i++) {
+		const key = path[i];
+		if (typeof cursor[key] !== "object" || cursor[key] === null) cursor[key] = {};
+		cursor = cursor[key];
+	}
+	cursor[path[path.length - 1]] = value;
+}
+function unsetConfigOverride(path) {
+	let cursor = overrides;
+	for (let i = 0; i < path.length - 1; i++) {
+		const next = cursor[path[i]];
+		if (typeof next !== "object" || next === null) return;
+		cursor = next;
+	}
+	delete cursor[path[path.length - 1]];
+}
+/** Deep-merge overrides on top of base config (process lifetime only). */
+function applyConfigOverrides(base) {
+	return deepMerge(base, overrides);
+}
+function deepMerge(base, override) {
+	if (typeof base !== "object" || base === null || typeof override !== "object" || override === null) return override ?? base;
+	const result = { ...base };
+	for (const [key, value] of Object.entries(override)) result[key] = deepMerge(result[key], value);
+	return result;
+}
+//#endregion
+export { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride };
+
+//# sourceMappingURL=runtime-overrides.js.map

package/dist/src/config/runtime-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-overrides.js","names":[],"sources":["../../../src/config/runtime-overrides.ts"],"sourcesContent":["type OverrideTree = Record<string, unknown>;\n\nlet overrides: OverrideTree = {};\n\nexport function getConfigOverrides(): OverrideTree {\n  return overrides;\n}\n\nexport function resetConfigOverrides(): void {\n  overrides = {};\n}\n\nexport function setConfigOverride(path: string[], value: unknown): void {\n  let cursor: OverrideTree = overrides;\n  for (let i = 0; i < path.length - 1; i++) {\n    const key = path[i];\n    if (typeof cursor[key] !== 'object' || cursor[key] === null) cursor[key] = {};\n    cursor = cursor[key] as OverrideTree;\n  }\n  cursor[path[path.length - 1]] = value;\n}\n\nexport function unsetConfigOverride(path: string[]): void {\n  let cursor: OverrideTree = overrides;\n  for (let i = 0; i < path.length - 1; i++) {\n    const next = cursor[path[i]];\n    if (typeof next !== 'object' || next === null) return;\n    cursor = next as OverrideTree;\n  }\n  delete cursor[path[path.length - 1]];\n}\n\n/** Deep-merge overrides on top of base config (process lifetime only). */\nexport function applyConfigOverrides<T extends object>(base: T): T {\n  return deepMerge(base, overrides) as T;\n}\n\nfunction deepMerge(base: unknown, override: unknown): unknown {\n  if (\n    typeof base !== 'object' ||\n    base === null ||\n    typeof override !== 'object' ||\n    override === null\n  ) {\n    return override ?? base;\n  }\n  const result = { ...(base as Record<string, unknown>) };\n  for (const [key, value] of Object.entries(override as Record<string, unknown>)) {\n    result[key] = deepMerge(result[key], value);\n  }\n  return result;\n}\n"],"mappings":";AAEA,IAAI,YAA0B,EAAE;AAEhC,SAAgB,qBAAmC;AACjD,QAAO;;AAGT,SAAgB,uBAA6B;AAC3C,aAAY,EAAE;;AAGhB,SAAgB,kBAAkB,MAAgB,OAAsB;CACtE,IAAI,SAAuB;AAC3B,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,KAAK;EACxC,MAAM,MAAM,KAAK;AACjB,MAAI,OAAO,OAAO,SAAS,YAAY,OAAO,SAAS,KAAM,QAAO,OAAO,EAAE;AAC7E,WAAS,OAAO;;AAElB,QAAO,KAAK,KAAK,SAAS,MAAM;;AAGlC,SAAgB,oBAAoB,MAAsB;CACxD,IAAI,SAAuB;AAC3B,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,KAAK;EACxC,MAAM,OAAO,OAAO,KAAK;AACzB,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM;AAC/C,WAAS;;AAEX,QAAO,OAAO,KAAK,KAAK,SAAS;;;AAInC,SAAgB,qBAAuC,MAAY;AACjE,QAAO,UAAU,MAAM,UAAU;;AAGnC,SAAS,UAAU,MAAe,UAA4B;AAC5D,KACE,OAAO,SAAS,YAChB,SAAS,QACT,OAAO,aAAa,YACpB,aAAa,KAEb,QAAO,YAAY;CAErB,MAAM,SAAS,EAAE,GAAI,MAAkC;AACvD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAoC,CAC5E,QAAO,OAAO,UAAU,OAAO,MAAM,MAAM;AAE7C,QAAO"}