@xopcai/xopc 0.0.6 → 0.0.8

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

@@ -0,0 +1,71 @@
+import { PACKAGE_VERSION, init_package_version } from "../../../../package-version.js";
+//#region src/cli/commands/doctor/checks/version-check.ts
+init_package_version();
+const REGISTRY_URL = "https://registry.npmjs.org/@xopcai/xopc/latest";
+const TIMEOUT_MS = 5e3;
+/** Simple semver: 1 if a > b, -1 if a < b, 0 if equal. */
+function compareSemver(a, b) {
+	const pa = a.split(".").map((x) => parseInt(x, 10) || 0);
+	const pb = b.split(".").map((x) => parseInt(x, 10) || 0);
+	const n = Math.max(pa.length, pb.length);
+	for (let i = 0; i < n; i++) {
+		const da = pa[i] ?? 0;
+		const db = pb[i] ?? 0;
+		if (da > db) return 1;
+		if (da < db) return -1;
+	}
+	return 0;
+}
+async function fetchLatestVersion() {
+	const controller = new AbortController();
+	const t = setTimeout(() => controller.abort(), TIMEOUT_MS);
+	try {
+		const res = await fetch(REGISTRY_URL, {
+			signal: controller.signal,
+			headers: { accept: "application/json" }
+		});
+		if (!res.ok) return null;
+		const data = await res.json();
+		return typeof data.version === "string" ? data.version : null;
+	} catch {
+		return null;
+	} finally {
+		clearTimeout(t);
+	}
+}
+async function checkVersionUpdate(_ctx) {
+	const local = PACKAGE_VERSION.trim() || "0.0.0";
+	const latest = await fetchLatestVersion();
+	if (!latest) return {
+		id: "version-check",
+		label: "Version",
+		status: "skip",
+		message: "Could not query npm for the latest version (offline or registry error).",
+		hints: []
+	};
+	if (compareSemver(latest, local) > 0) return {
+		id: "version-check",
+		label: "Version",
+		status: "warn",
+		message: `Running v${local}; npm latest is v${latest}.`,
+		hints: ["Upgrade: pnpm add -g @xopcai/xopc@latest", "Or: npm i -g @xopcai/xopc@latest"]
+	};
+	if (compareSemver(local, latest) > 0) return {
+		id: "version-check",
+		label: "Version",
+		status: "pass",
+		message: `Running v${local} (ahead of npm registry v${latest}; local/dev build is OK).`,
+		hints: []
+	};
+	return {
+		id: "version-check",
+		label: "Version",
+		status: "pass",
+		message: `Running v${local} (matches npm latest).`,
+		hints: []
+	};
+}
+//#endregion
+export { checkVersionUpdate };
+
+//# sourceMappingURL=version-check.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/version-check.ts"],"sourcesContent":["import { PACKAGE_VERSION } from '../../../../package-version.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nconst REGISTRY_URL = 'https://registry.npmjs.org/@xopcai/xopc/latest';\nconst TIMEOUT_MS = 5000;\n\n/** Simple semver: 1 if a > b, -1 if a < b, 0 if equal. */\nfunction compareSemver(a: string, b: string): number {\n  const pa = a.split('.').map((x) => parseInt(x, 10) || 0);\n  const pb = b.split('.').map((x) => parseInt(x, 10) || 0);\n  const n = Math.max(pa.length, pb.length);\n  for (let i = 0; i < n; i++) {\n    const da = pa[i] ?? 0;\n    const db = pb[i] ?? 0;\n    if (da > db) return 1;\n    if (da < db) return -1;\n  }\n  return 0;\n}\n\nasync function fetchLatestVersion(): Promise<string | null> {\n  const controller = new AbortController();\n  const t = setTimeout(() => controller.abort(), TIMEOUT_MS);\n  try {\n    const res = await fetch(REGISTRY_URL, {\n      signal: controller.signal,\n      headers: { accept: 'application/json' },\n    });\n    if (!res.ok) return null;\n    const data = (await res.json()) as { version?: string };\n    return typeof data.version === 'string' ? data.version : null;\n  } catch {\n    return null;\n  } finally {\n    clearTimeout(t);\n  }\n}\n\nexport async function checkVersionUpdate(_ctx: DoctorContext): Promise<CheckResult> {\n  const local = PACKAGE_VERSION.trim() || '0.0.0';\n  const latest = await fetchLatestVersion();\n  if (!latest) {\n    return {\n      id: 'version-check',\n      label: 'Version',\n      status: 'skip',\n      message: 'Could not query npm for the latest version (offline or registry error).',\n      hints: [],\n    };\n  }\n\n  if (compareSemver(latest, local) > 0) {\n    return {\n      id: 'version-check',\n      label: 'Version',\n      status: 'warn',\n      message: `Running v${local}; npm latest is v${latest}.`,\n      hints: ['Upgrade: pnpm add -g @xopcai/xopc@latest', 'Or: npm i -g @xopcai/xopc@latest'],\n    };\n  }\n\n  if (compareSemver(local, latest) > 0) {\n    return {\n      id: 'version-check',\n      label: 'Version',\n      status: 'pass',\n      message: `Running v${local} (ahead of npm registry v${latest}; local/dev build is OK).`,\n      hints: [],\n    };\n  }\n\n  return {\n    id: 'version-check',\n    label: 'Version',\n    status: 'pass',\n    message: `Running v${local} (matches npm latest).`,\n    hints: [],\n  };\n}\n"],"mappings":";;sBAAiE;AAGjE,MAAM,eAAe;AACrB,MAAM,aAAa;;AAGnB,SAAS,cAAc,GAAW,GAAmB;CACnD,MAAM,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,MAAM,SAAS,GAAG,GAAG,IAAI,EAAE;CACxD,MAAM,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,MAAM,SAAS,GAAG,GAAG,IAAI,EAAE;CACxD,MAAM,IAAI,KAAK,IAAI,GAAG,QAAQ,GAAG,OAAO;AACxC,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,KAAK,GAAG,MAAM;EACpB,MAAM,KAAK,GAAG,MAAM;AACpB,MAAI,KAAK,GAAI,QAAO;AACpB,MAAI,KAAK,GAAI,QAAO;;AAEtB,QAAO;;AAGT,eAAe,qBAA6C;CAC1D,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,IAAI,iBAAiB,WAAW,OAAO,EAAE,WAAW;AAC1D,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,cAAc;GACpC,QAAQ,WAAW;GACnB,SAAS,EAAE,QAAQ,oBAAoB;GACxC,CAAC;AACF,MAAI,CAAC,IAAI,GAAI,QAAO;EACpB,MAAM,OAAQ,MAAM,IAAI,MAAM;AAC9B,SAAO,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU;SACnD;AACN,SAAO;WACC;AACR,eAAa,EAAE;;;AAInB,eAAsB,mBAAmB,MAA2C;CAClF,MAAM,QAAQ,gBAAgB,MAAM,IAAI;CACxC,MAAM,SAAS,MAAM,oBAAoB;AACzC,KAAI,CAAC,OACH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;AAGH,KAAI,cAAc,QAAQ,MAAM,GAAG,EACjC,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,YAAY,MAAM,mBAAmB,OAAO;EACrD,OAAO,CAAC,4CAA4C,mCAAmC;EACxF;AAGH,KAAI,cAAc,OAAO,OAAO,GAAG,EACjC,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,YAAY,MAAM,2BAA2B,OAAO;EAC7D,OAAO,EAAE;EACV;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,YAAY,MAAM;EAC3B,OAAO,EAAE;EACV"}

package/dist/src/cli/commands/doctor/checks/workspace-status.d.ts

@@ -0,0 +1,2 @@
+import type { CheckResult, DoctorContext } from '../types.js';
+export declare function checkWorkspaceStatus(ctx: DoctorContext): Promise<CheckResult>;

package/dist/src/cli/commands/doctor/checks/workspace-status.js

@@ -0,0 +1,73 @@
+import { init_agent_scope, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../../../../agent/agent-scope.js";
+import { WORKSPACE_FILES, init_paths } from "../../../../config/paths.js";
+import { init_loader, loadConfig } from "../../../../config/loader.js";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+//#region src/cli/commands/doctor/checks/workspace-status.ts
+init_agent_scope();
+init_loader();
+init_paths();
+async function checkWorkspaceStatus(ctx) {
+	if (!existsSync(ctx.configPath)) return {
+		id: "workspace-status",
+		label: "Workspace",
+		status: "skip",
+		message: "No config file; skipped.",
+		hints: []
+	};
+	let config;
+	try {
+		config = loadConfig(ctx.configPath);
+	} catch {
+		return {
+			id: "workspace-status",
+			label: "Workspace",
+			status: "skip",
+			message: "Config could not be loaded; skipped.",
+			hints: []
+		};
+	}
+	const agentId = resolveDefaultAgentId(config);
+	const root = resolveAgentWorkspaceDir(config, agentId);
+	const hints = [];
+	if (!existsSync(root)) return {
+		id: "workspace-status",
+		label: "Workspace",
+		status: "warn",
+		message: "Agent workspace directory is missing.",
+		hints: [root, "Run: xopc onboard"]
+	};
+	const soul = join(root, WORKSPACE_FILES.SOUL);
+	const identity = join(root, WORKSPACE_FILES.IDENTITY);
+	const missing = [];
+	if (!existsSync(soul)) missing.push(WORKSPACE_FILES.SOUL);
+	if (!existsSync(identity)) missing.push(WORKSPACE_FILES.IDENTITY);
+	if (missing.length > 0) return {
+		id: "workspace-status",
+		label: "Workspace",
+		status: "warn",
+		message: `Essential workspace files missing: ${missing.join(", ")}.`,
+		hints: [root, "Run: xopc onboard"]
+	};
+	if (!existsSync(join(root, WORKSPACE_FILES.USER))) hints.push(`${WORKSPACE_FILES.USER} is optional; add a user profile for better context.`);
+	if (!existsSync(join(root, WORKSPACE_FILES.TOOLS))) hints.push(`${WORKSPACE_FILES.TOOLS} is optional; add tool notes if you use many tools.`);
+	if (!existsSync(join(root, ".git"))) hints.push("No .git in workspace; version control is recommended for backup and history.");
+	if (hints.length > 0) return {
+		id: "workspace-status",
+		label: "Workspace",
+		status: "pass",
+		message: "Essential workspace files are present.",
+		hints
+	};
+	return {
+		id: "workspace-status",
+		label: "Workspace",
+		status: "pass",
+		message: "Workspace directory and essential files look good.",
+		hints: [root]
+	};
+}
+//#endregion
+export { checkWorkspaceStatus };
+
+//# sourceMappingURL=workspace-status.js.map

package/dist/src/cli/commands/doctor/checks/workspace-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-status.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/workspace-status.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { resolveDefaultAgentId, resolveAgentWorkspaceDir } from '../../../../agent/agent-scope.js';\nimport { loadConfig } from '../../../../config/loader.js';\nimport { WORKSPACE_FILES } from '../../../../config/paths.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nexport async function checkWorkspaceStatus(ctx: DoctorContext): Promise<CheckResult> {\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'workspace-status',\n      label: 'Workspace',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let config;\n  try {\n    config = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'workspace-status',\n      label: 'Workspace',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  const agentId = resolveDefaultAgentId(config);\n  const root = resolveAgentWorkspaceDir(config, agentId);\n  const hints: string[] = [];\n\n  if (!existsSync(root)) {\n    return {\n      id: 'workspace-status',\n      label: 'Workspace',\n      status: 'warn',\n      message: 'Agent workspace directory is missing.',\n      hints: [root, 'Run: xopc onboard'],\n    };\n  }\n\n  const soul = join(root, WORKSPACE_FILES.SOUL);\n  const identity = join(root, WORKSPACE_FILES.IDENTITY);\n  const missing: string[] = [];\n  if (!existsSync(soul)) missing.push(WORKSPACE_FILES.SOUL);\n  if (!existsSync(identity)) missing.push(WORKSPACE_FILES.IDENTITY);\n\n  if (missing.length > 0) {\n    return {\n      id: 'workspace-status',\n      label: 'Workspace',\n      status: 'warn',\n      message: `Essential workspace files missing: ${missing.join(', ')}.`,\n      hints: [root, 'Run: xopc onboard'],\n    };\n  }\n\n  if (!existsSync(join(root, WORKSPACE_FILES.USER))) {\n    hints.push(`${WORKSPACE_FILES.USER} is optional; add a user profile for better context.`);\n  }\n  if (!existsSync(join(root, WORKSPACE_FILES.TOOLS))) {\n    hints.push(`${WORKSPACE_FILES.TOOLS} is optional; add tool notes if you use many tools.`);\n  }\n\n  if (!existsSync(join(root, '.git'))) {\n    hints.push('No .git in workspace; version control is recommended for backup and history.');\n  }\n\n  if (hints.length > 0) {\n    return {\n      id: 'workspace-status',\n      label: 'Workspace',\n      status: 'pass',\n      message: 'Essential workspace files are present.',\n      hints,\n    };\n  }\n\n  return {\n    id: 'workspace-status',\n    label: 'Workspace',\n    status: 'pass',\n    message: 'Workspace directory and essential files look good.',\n    hints: [root],\n  };\n}\n"],"mappings":";;;;;;kBAGmG;aACzC;YACI;AAG9D,eAAsB,qBAAqB,KAA0C;AACnF,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,IAAI;AACJ,KAAI;AACF,WAAS,WAAW,IAAI,WAAW;SAC7B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;CAGH,MAAM,UAAU,sBAAsB,OAAO;CAC7C,MAAM,OAAO,yBAAyB,QAAQ,QAAQ;CACtD,MAAM,QAAkB,EAAE;AAE1B,KAAI,CAAC,WAAW,KAAK,CACnB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,MAAM,oBAAoB;EACnC;CAGH,MAAM,OAAO,KAAK,MAAM,gBAAgB,KAAK;CAC7C,MAAM,WAAW,KAAK,MAAM,gBAAgB,SAAS;CACrD,MAAM,UAAoB,EAAE;AAC5B,KAAI,CAAC,WAAW,KAAK,CAAE,SAAQ,KAAK,gBAAgB,KAAK;AACzD,KAAI,CAAC,WAAW,SAAS,CAAE,SAAQ,KAAK,gBAAgB,SAAS;AAEjE,KAAI,QAAQ,SAAS,EACnB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,sCAAsC,QAAQ,KAAK,KAAK,CAAC;EAClE,OAAO,CAAC,MAAM,oBAAoB;EACnC;AAGH,KAAI,CAAC,WAAW,KAAK,MAAM,gBAAgB,KAAK,CAAC,CAC/C,OAAM,KAAK,GAAG,gBAAgB,KAAK,sDAAsD;AAE3F,KAAI,CAAC,WAAW,KAAK,MAAM,gBAAgB,MAAM,CAAC,CAChD,OAAM,KAAK,GAAG,gBAAgB,MAAM,qDAAqD;AAG3F,KAAI,CAAC,WAAW,KAAK,MAAM,OAAO,CAAC,CACjC,OAAM,KAAK,+EAA+E;AAG5F,KAAI,MAAM,SAAS,EACjB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT;EACD;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,KAAK;EACd"}

package/dist/src/cli/commands/doctor/flow.d.ts

@@ -0,0 +1,9 @@
+import type { CheckResult, DoctorContext } from './types.js';
+/**
+ * Headless data collection — used by both CLI and gateway API.
+ */
+export declare function collectDoctorResults(ctx: DoctorContext): Promise<CheckResult[]>;
+/**
+ * CLI entry point — collect and print.
+ */
+export declare function runDoctor(ctx: DoctorContext): Promise<CheckResult[]>;

package/dist/src/cli/commands/doctor/flow.js

@@ -0,0 +1,51 @@
+import { printJsonResults, printResults } from "./format.js";
+import { checkNodeVersion } from "./checks/node-version.js";
+import { checkConfigHealth } from "./checks/config-health.js";
+import { checkStateIntegrity } from "./checks/state-integrity.js";
+import { checkProviderAuth } from "./checks/provider-auth.js";
+import { checkChannelConfig } from "./checks/channel-config.js";
+import { checkGatewayHealth } from "./checks/gateway-health.js";
+import { checkSessionIntegrity } from "./checks/session-integrity.js";
+import { checkGatewayService } from "./checks/gateway-service.js";
+import { checkSecurityAudit } from "./checks/security-audit.js";
+import { checkWorkspaceStatus } from "./checks/workspace-status.js";
+import { checkCronHealth } from "./checks/cron-health.js";
+import { checkVersionUpdate } from "./checks/version-check.js";
+import { checkChannelPlugins } from "./checks/channel-plugins.js";
+//#region src/cli/commands/doctor/flow.ts
+const DOCTOR_CHECKS = [
+	checkVersionUpdate,
+	checkNodeVersion,
+	checkConfigHealth,
+	checkStateIntegrity,
+	checkProviderAuth,
+	checkChannelConfig,
+	checkSecurityAudit,
+	checkWorkspaceStatus,
+	checkGatewayService,
+	checkGatewayHealth,
+	checkCronHealth,
+	checkSessionIntegrity
+];
+/**
+* Headless data collection — used by both CLI and gateway API.
+*/
+async function collectDoctorResults(ctx) {
+	const results = [];
+	for (const check of DOCTOR_CHECKS) results.push(await check(ctx));
+	results.push(...await checkChannelPlugins(ctx));
+	return results;
+}
+/**
+* CLI entry point — collect and print.
+*/
+async function runDoctor(ctx) {
+	const results = await collectDoctorResults(ctx);
+	if (ctx.options.json) printJsonResults(results);
+	else printResults(results);
+	return results;
+}
+//#endregion
+export { collectDoctorResults, runDoctor };
+
+//# sourceMappingURL=flow.js.map

package/dist/src/cli/commands/doctor/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","names":[],"sources":["../../../../../src/cli/commands/doctor/flow.ts"],"sourcesContent":["import { printJsonResults, printResults } from './format.js';\nimport type { CheckResult, DoctorCheck, DoctorContext } from './types.js';\nimport { checkNodeVersion } from './checks/node-version.js';\nimport { checkConfigHealth } from './checks/config-health.js';\nimport { checkStateIntegrity } from './checks/state-integrity.js';\nimport { checkProviderAuth } from './checks/provider-auth.js';\nimport { checkChannelConfig } from './checks/channel-config.js';\nimport { checkGatewayHealth } from './checks/gateway-health.js';\nimport { checkSessionIntegrity } from './checks/session-integrity.js';\nimport { checkGatewayService } from './checks/gateway-service.js';\nimport { checkSecurityAudit } from './checks/security-audit.js';\nimport { checkWorkspaceStatus } from './checks/workspace-status.js';\nimport { checkCronHealth } from './checks/cron-health.js';\nimport { checkVersionUpdate } from './checks/version-check.js';\nimport { checkChannelPlugins } from './checks/channel-plugins.js';\n\nconst DOCTOR_CHECKS: DoctorCheck[] = [\n  checkVersionUpdate,\n  checkNodeVersion,\n  checkConfigHealth,\n  checkStateIntegrity,\n  checkProviderAuth,\n  checkChannelConfig,\n  checkSecurityAudit,\n  checkWorkspaceStatus,\n  checkGatewayService,\n  checkGatewayHealth,\n  checkCronHealth,\n  checkSessionIntegrity,\n];\n\n/**\n * Headless data collection — used by both CLI and gateway API.\n */\nexport async function collectDoctorResults(ctx: DoctorContext): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  for (const check of DOCTOR_CHECKS) {\n    results.push(await check(ctx));\n  }\n\n  results.push(...(await checkChannelPlugins(ctx)));\n\n  return results;\n}\n\n/**\n * CLI entry point — collect and print.\n */\nexport async function runDoctor(ctx: DoctorContext): Promise<CheckResult[]> {\n  const results = await collectDoctorResults(ctx);\n\n  if (ctx.options.json) {\n    printJsonResults(results);\n  } else {\n    printResults(results);\n  }\n\n  return results;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,MAAM,gBAA+B;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;AAKD,eAAsB,qBAAqB,KAA4C;CACrF,MAAM,UAAyB,EAAE;AAEjC,MAAK,MAAM,SAAS,cAClB,SAAQ,KAAK,MAAM,MAAM,IAAI,CAAC;AAGhC,SAAQ,KAAK,GAAI,MAAM,oBAAoB,IAAI,CAAE;AAEjD,QAAO;;;;;AAMT,eAAsB,UAAU,KAA4C;CAC1E,MAAM,UAAU,MAAM,qBAAqB,IAAI;AAE/C,KAAI,IAAI,QAAQ,KACd,kBAAiB,QAAQ;KAEzB,cAAa,QAAQ;AAGvB,QAAO"}

package/dist/src/cli/commands/doctor/format.d.ts

@@ -0,0 +1,6 @@
+import type { CheckResult } from './types.js';
+export declare function formatCheckLine(result: CheckResult): string;
+export declare function formatHints(hints: string[]): string[];
+export declare function printSummary(results: CheckResult[]): void;
+export declare function printResults(results: CheckResult[]): void;
+export declare function printJsonResults(results: CheckResult[]): void;

package/dist/src/cli/commands/doctor/format.js

@@ -0,0 +1,61 @@
+import { colors } from "../../utils/colors.js";
+//#region src/cli/commands/doctor/format.ts
+const STATUS_ICONS = {
+	pass: "✓",
+	warn: "⚠",
+	fail: "✗",
+	skip: "–"
+};
+function statusColor(status, text) {
+	switch (status) {
+		case "pass": return colors.green(text);
+		case "warn": return colors.yellow(text);
+		case "fail": return colors.red(text);
+		default: return colors.gray(text);
+	}
+}
+function formatCheckLine(result) {
+	const icon = STATUS_ICONS[result.status];
+	const fixed = result.fixed ? " " + colors.cyan("[fixed]") : "";
+	return `  ${statusColor(result.status, icon)} ${result.label}: ${result.message}${fixed}`;
+}
+function formatHints(hints) {
+	return hints.map((h) => `    ${colors.gray("→")} ${h}`);
+}
+function printSummary(results) {
+	const passed = results.filter((r) => r.status === "pass").length;
+	const warnings = results.filter((r) => r.status === "warn").length;
+	const failed = results.filter((r) => r.status === "fail").length;
+	const skipped = results.filter((r) => r.status === "skip").length;
+	console.log("");
+	console.log(colors.bold(`${passed} passed, ${warnings} warnings, ${failed} failed` + (skipped ? `, ${skipped} skipped` : "")));
+}
+function printResults(results) {
+	console.log("");
+	console.log(colors.bold("xopc doctor"));
+	console.log("");
+	for (const r of results) {
+		console.log(formatCheckLine(r));
+		for (const line of formatHints(r.hints)) console.log(line);
+	}
+	printSummary(results);
+	console.log("");
+}
+function printJsonResults(results) {
+	const payload = {
+		ok: results.every((r) => r.status !== "fail"),
+		checks: results.map((r) => ({
+			id: r.id,
+			label: r.label,
+			status: r.status,
+			message: r.message,
+			hints: r.hints,
+			fixed: r.fixed ?? false
+		}))
+	};
+	console.log(JSON.stringify(payload, null, 2));
+}
+//#endregion
+export { formatCheckLine, formatHints, printJsonResults, printResults, printSummary };
+
+//# sourceMappingURL=format.js.map

package/dist/src/cli/commands/doctor/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","names":[],"sources":["../../../../../src/cli/commands/doctor/format.ts"],"sourcesContent":["import { colors } from '../../utils/colors.js';\nimport type { CheckResult, CheckStatus } from './types.js';\n\nconst STATUS_ICONS: Record<CheckStatus, string> = {\n  pass: '✓',\n  warn: '⚠',\n  fail: '✗',\n  skip: '–',\n};\n\nfunction statusColor(status: CheckStatus, text: string): string {\n  switch (status) {\n    case 'pass':\n      return colors.green(text);\n    case 'warn':\n      return colors.yellow(text);\n    case 'fail':\n      return colors.red(text);\n    default:\n      return colors.gray(text);\n  }\n}\n\nexport function formatCheckLine(result: CheckResult): string {\n  const icon = STATUS_ICONS[result.status];\n  const fixed = result.fixed ? ' ' + colors.cyan('[fixed]') : '';\n  return `  ${statusColor(result.status, icon)} ${result.label}: ${result.message}${fixed}`;\n}\n\nexport function formatHints(hints: string[]): string[] {\n  return hints.map((h) => `    ${colors.gray('→')} ${h}`);\n}\n\nexport function printSummary(results: CheckResult[]): void {\n  const passed = results.filter((r) => r.status === 'pass').length;\n  const warnings = results.filter((r) => r.status === 'warn').length;\n  const failed = results.filter((r) => r.status === 'fail').length;\n  const skipped = results.filter((r) => r.status === 'skip').length;\n  console.log('');\n  console.log(\n    colors.bold(\n      `${passed} passed, ${warnings} warnings, ${failed} failed` +\n        (skipped ? `, ${skipped} skipped` : ''),\n    ),\n  );\n}\n\nexport function printResults(results: CheckResult[]): void {\n  console.log('');\n  console.log(colors.bold('xopc doctor'));\n  console.log('');\n  for (const r of results) {\n    console.log(formatCheckLine(r));\n    for (const line of formatHints(r.hints)) {\n      console.log(line);\n    }\n  }\n  printSummary(results);\n  console.log('');\n}\n\nexport function printJsonResults(results: CheckResult[]): void {\n  const ok = results.every((r) => r.status !== 'fail');\n  const payload = {\n    ok,\n    checks: results.map((r) => ({\n      id: r.id,\n      label: r.label,\n      status: r.status,\n      message: r.message,\n      hints: r.hints,\n      fixed: r.fixed ?? false,\n    })),\n  };\n  console.log(JSON.stringify(payload, null, 2));\n}\n"],"mappings":";;AAGA,MAAM,eAA4C;CAChD,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACP;AAED,SAAS,YAAY,QAAqB,MAAsB;AAC9D,SAAQ,QAAR;EACE,KAAK,OACH,QAAO,OAAO,MAAM,KAAK;EAC3B,KAAK,OACH,QAAO,OAAO,OAAO,KAAK;EAC5B,KAAK,OACH,QAAO,OAAO,IAAI,KAAK;EACzB,QACE,QAAO,OAAO,KAAK,KAAK;;;AAI9B,SAAgB,gBAAgB,QAA6B;CAC3D,MAAM,OAAO,aAAa,OAAO;CACjC,MAAM,QAAQ,OAAO,QAAQ,MAAM,OAAO,KAAK,UAAU,GAAG;AAC5D,QAAO,KAAK,YAAY,OAAO,QAAQ,KAAK,CAAC,GAAG,OAAO,MAAM,IAAI,OAAO,UAAU;;AAGpF,SAAgB,YAAY,OAA2B;AACrD,QAAO,MAAM,KAAK,MAAM,OAAO,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI;;AAGzD,SAAgB,aAAa,SAA8B;CACzD,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,OAAO,CAAC;CAC1D,MAAM,WAAW,QAAQ,QAAQ,MAAM,EAAE,WAAW,OAAO,CAAC;CAC5D,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,OAAO,CAAC;CAC1D,MAAM,UAAU,QAAQ,QAAQ,MAAM,EAAE,WAAW,OAAO,CAAC;AAC3D,SAAQ,IAAI,GAAG;AACf,SAAQ,IACN,OAAO,KACL,GAAG,OAAO,WAAW,SAAS,aAAa,OAAO,YAC/C,UAAU,KAAK,QAAQ,YAAY,IACvC,CACF;;AAGH,SAAgB,aAAa,SAA8B;AACzD,SAAQ,IAAI,GAAG;AACf,SAAQ,IAAI,OAAO,KAAK,cAAc,CAAC;AACvC,SAAQ,IAAI,GAAG;AACf,MAAK,MAAM,KAAK,SAAS;AACvB,UAAQ,IAAI,gBAAgB,EAAE,CAAC;AAC/B,OAAK,MAAM,QAAQ,YAAY,EAAE,MAAM,CACrC,SAAQ,IAAI,KAAK;;AAGrB,cAAa,QAAQ;AACrB,SAAQ,IAAI,GAAG;;AAGjB,SAAgB,iBAAiB,SAA8B;CAE7D,MAAM,UAAU;EACd,IAFS,QAAQ,OAAO,MAAM,EAAE,WAAW,OAAO;EAGlD,QAAQ,QAAQ,KAAK,OAAO;GAC1B,IAAI,EAAE;GACN,OAAO,EAAE;GACT,QAAQ,EAAE;GACV,SAAS,EAAE;GACX,OAAO,EAAE;GACT,OAAO,EAAE,SAAS;GACnB,EAAE;EACJ;AACD,SAAQ,IAAI,KAAK,UAAU,SAAS,MAAM,EAAE,CAAC"}

package/dist/src/cli/commands/doctor/index.js

@@ -0,0 +1,44 @@
+import { init_paths_state, resolveStateDir } from "../../../config/paths-state.js";
+import { formatExamples, register } from "../../registry.js";
+import { runDoctor } from "./flow.js";
+import { Command } from "commander";
+//#region src/cli/commands/doctor/index.ts
+init_paths_state();
+function createDoctorCommand(ctx) {
+	return new Command("doctor").description("Check xopc installation health and diagnose common issues").option("--fix", "Automatically apply safe fixes", false).option("--json", "Output results as JSON", false).option("--deep", "Run deeper / slower checks (e.g. session scan)", false).addHelpText("after", formatExamples([
+		"xopc doctor",
+		"xopc doctor --json",
+		"xopc doctor --deep",
+		"xopc doctor --fix"
+	])).action(async (opts) => {
+		const configPath = ctx.configPath;
+		if ((await runDoctor({
+			configPath,
+			stateDir: resolveStateDir(),
+			options: {
+				fix: Boolean(opts.fix),
+				json: Boolean(opts.json),
+				deep: Boolean(opts.deep)
+			}
+		})).some((r) => r.status === "fail")) process.exitCode = 1;
+	});
+}
+register({
+	id: "doctor",
+	name: "doctor",
+	description: "Check xopc installation health and diagnose common issues",
+	factory: createDoctorCommand,
+	metadata: {
+		category: "maintenance",
+		examples: [
+			"xopc doctor",
+			"xopc doctor --json",
+			"xopc doctor --deep",
+			"xopc doctor --fix"
+		]
+	}
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/cli/commands/doctor/index.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { register, formatExamples, type CLIContext } from '../../registry.js';\nimport { resolveStateDir } from '../../../config/paths-state.js';\nimport { runDoctor } from './flow.js';\nimport type { DoctorOptions } from './types.js';\n\nfunction createDoctorCommand(ctx: CLIContext): Command {\n  return new Command('doctor')\n    .description('Check xopc installation health and diagnose common issues')\n    .option('--fix', 'Automatically apply safe fixes', false)\n    .option('--json', 'Output results as JSON', false)\n    .option('--deep', 'Run deeper / slower checks (e.g. session scan)', false)\n    .addHelpText(\n      'after',\n      formatExamples(['xopc doctor', 'xopc doctor --json', 'xopc doctor --deep', 'xopc doctor --fix']),\n    )\n    .action(async (opts: DoctorOptions) => {\n      const configPath = ctx.configPath;\n      const stateDir = resolveStateDir();\n      const results = await runDoctor({\n        configPath,\n        stateDir,\n        options: {\n          fix: Boolean(opts.fix),\n          json: Boolean(opts.json),\n          deep: Boolean(opts.deep),\n        },\n      });\n      const failed = results.some((r) => r.status === 'fail');\n      if (failed) {\n        process.exitCode = 1;\n      }\n    });\n}\n\nregister({\n  id: 'doctor',\n  name: 'doctor',\n  description: 'Check xopc installation health and diagnose common issues',\n  factory: createDoctorCommand,\n  metadata: {\n    category: 'maintenance',\n    examples: ['xopc doctor', 'xopc doctor --json', 'xopc doctor --deep', 'xopc doctor --fix'],\n  },\n});\n"],"mappings":";;;;;kBAEiE;AAIjE,SAAS,oBAAoB,KAA0B;AACrD,QAAO,IAAI,QAAQ,SAAS,CACzB,YAAY,4DAA4D,CACxE,OAAO,SAAS,kCAAkC,MAAM,CACxD,OAAO,UAAU,0BAA0B,MAAM,CACjD,OAAO,UAAU,kDAAkD,MAAM,CACzE,YACC,SACA,eAAe;EAAC;EAAe;EAAsB;EAAsB;EAAoB,CAAC,CACjG,CACA,OAAO,OAAO,SAAwB;EACrC,MAAM,aAAa,IAAI;AAYvB,OAVgB,MAAM,UAAU;GAC9B;GACA,UAHe,iBAAiB;GAIhC,SAAS;IACP,KAAK,QAAQ,KAAK,IAAI;IACtB,MAAM,QAAQ,KAAK,KAAK;IACxB,MAAM,QAAQ,KAAK,KAAK;IACzB;GACF,CAAC,EACqB,MAAM,MAAM,EAAE,WAAW,OAAO,CAErD,SAAQ,WAAW;GAErB;;AAGN,SAAS;CACP,IAAI;CACJ,MAAM;CACN,aAAa;CACb,SAAS;CACT,UAAU;EACR,UAAU;EACV,UAAU;GAAC;GAAe;GAAsB;GAAsB;GAAoB;EAC3F;CACF,CAAC"}

package/dist/src/cli/commands/doctor/types.d.ts

@@ -0,0 +1,20 @@
+export type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
+export interface CheckResult {
+    id: string;
+    label: string;
+    status: CheckStatus;
+    message: string;
+    hints: string[];
+    fixed?: boolean;
+}
+export interface DoctorOptions {
+    fix: boolean;
+    json: boolean;
+    deep: boolean;
+}
+export interface DoctorContext {
+    configPath: string;
+    stateDir: string;
+    options: DoctorOptions;
+}
+export type DoctorCheck = (ctx: DoctorContext) => Promise<CheckResult>;

package/dist/src/cli/commands/doctor/types.js

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

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

@@ -1,7 +1,7 @@
-import { createLogger } from "../../utils/logger/index.js";
-import { init_logger } from "../../utils/logger.js";
 import { resolveStateDir } from "../../config/paths-state.js";
 import { resolveAgentBootstrapDir, resolveAgentWorkspaceDir } from "../../agent/agent-scope.js";
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
 import { WORKSPACE_FILES, init_paths, resolveAgentDir, resolveAgentHomeDir, resolveAgentMetadataPath, resolveBinDir, resolveConfigPath, resolveCredentialsDir, resolveCronDir, resolveExtensionsDir, resolveInboxDir, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogsDir, resolveSessionsDir, resolveSkillsDir, resolveToolsDir, resolveWorkspaceStateDir, resolveWorkspaceStatePath } from "../../config/paths.js";
 import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
 import { join } from "path";

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

@@ -7,6 +7,7 @@ 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';
@@ -14,7 +15,6 @@ import './commands/extension.js';
 import './commands/auth.js';
 import './commands/skills.js';
 import './commands/logs.js';
-import './commands/acp.js';
 export declare let parsedOpts: {
     config?: string;
     workspace?: string;

package/dist/src/cli/index.js

@@ -11,6 +11,7 @@ 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";
@@ -18,7 +19,6 @@ import "./commands/extension.js";
 import "./commands/auth.js";
 import "./commands/skills.js";
 import "./commands/logs.js";
-import "./commands/acp.js";
 import { registerAgentsCli } from "./commands/agents.js";
 import { Command } from "commander";
 //#region src/cli/index.ts

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 './commands/extension.js';\nimport './commands/auth.js';\nimport './commands/skills.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);\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"}

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.js

@@ -4,10 +4,10 @@ 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 { 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 { 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 { extractProfileAgentId, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.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 { init_loader, loadConfig, registerChannelConfigValidator, saveConfig } from "./loader.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 { formatThinkingLevels, listThinkingLevels, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, thinkLevelToNumber } from "../agent/transcript/thinking-types.js";
@@ -24,6 +24,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, 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 };
 
 //# sourceMappingURL=index.js.map

package/dist/src/config/loader.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { ConfigSchema, init_schema } from "./schema.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 { dirname } from "path";
 import { existsSync, mkdirSync, promises, readFileSync } from "fs";

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/models-json.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_paths, resolveModelsJsonPath } from "./paths.js";
+import { z } from "zod";
 import { dirname } from "path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { z } from "zod";
 //#region src/config/models-json.ts
 /**
 * Models.json configuration types and schema