@xopcai/xopc 0.0.103 → 0.0.105

package/dist/src/cli/commands/setup-shared/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/cli/commands/setup-shared/runner.ts"],"sourcesContent":["import { ZodError } from 'zod';\n\nimport { loadConfig, saveConfig } from '../../../config/index.js';\nimport { ConfigSchema, type Config } from '../../../config/schema.js';\nimport { diffConfigPaths } from '../../../config/diff.js';\n\nimport { emitOutcome } from './output.js';\nimport { isPromptCancelled } from './prompts.js';\nimport {\n  SETUP_EXIT,\n  type SetupAction,\n  type SetupError,\n  type SetupOutcome,\n  type SetupRunOptions,\n} from './types.js';\n\n/** Thrown by a {@link SetupMutator.mutate} to fail the run with a clean message. */\nexport class SetupValidationError extends Error {\n  readonly errors: SetupError[];\n\n  constructor(errors: SetupError[] | SetupError | string) {\n    const list: SetupError[] = Array.isArray(errors)\n      ? errors\n      : typeof errors === 'string'\n        ? [{ message: errors }]\n        : [errors];\n    super(list.map((e) => (e.path ? `[${e.path}] ${e.message}` : e.message)).join('; '));\n    this.name = 'SetupValidationError';\n    this.errors = list;\n  }\n}\n\nexport interface SetupMutator {\n  /** Logical domain — `providers`, `channels.telegram`, etc. */\n  domain: string;\n  /** Target id within the domain (provider id, account id, …). */\n  target?: string;\n  /** What the operation is conceptually doing. */\n  action: SetupAction;\n  /** Mutates `config` in place (or returns a replacement) and returns it. */\n  mutate(config: Config): Config | Promise<Config>;\n  /** Optional masked value to surface in the outcome (for agents / UI). */\n  resultValue?(config: Config): unknown;\n  /** Optional human-readable notes appended to the outcome. */\n  notes?(config: Config): string[];\n}\n\nexport interface RunSetupArgs {\n  configPath: string;\n  mutator: SetupMutator;\n  options: SetupRunOptions;\n}\n\nfunction zodErrorToSetupErrors(err: ZodError): SetupError[] {\n  return err.issues.map((issue) => ({\n    path: issue.path.join('.') || undefined,\n    message: issue.message,\n  }));\n}\n\n/**\n * Headless setup pipeline — load → clone → mutate → validate(zod) → diff →\n * (write | dry-run) → outcome. Returns the {@link SetupOutcome} without any\n * I/O side effects (no stdout, no `process.exitCode`).\n *\n * Used by CLI setup commands via {@link runSetup}. Keep this side-effect-free\n * so it stays safe to call from tests and other programmatic callers.\n *\n * Custom errors thrown by the mutator surface as `errors[]` on the outcome:\n *   - `SetupValidationError` — explicit `{path?, message}[]` entries\n *   - `ExitPromptError` (from `@inquirer/prompts`) — surfaced as \"Cancelled by user\"\n *   - any other `Error` — the message is used verbatim\n */\nexport async function runSetupHeadless(args: RunSetupArgs): Promise<SetupOutcome> {\n  const { configPath, mutator, options } = args;\n\n  let before: Config;\n  try {\n    before = loadConfig(configPath);\n  } catch (error) {\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors: [{ message: `Failed to load config: ${(error as Error).message}` }],\n    };\n  }\n\n  // `loadConfig` parses through the schema once, but the schema isn't fully\n  // idempotent — re-parsing a result can fill in deeper defaults that the\n  // first pass left undefined. To avoid false-positive diffs against those\n  // defaults, normalize both sides through one extra parse cycle.\n  const baselineParsed = ConfigSchema.safeParse(structuredClone(before));\n  const baseline: Config = baselineParsed.success ? baselineParsed.data : before;\n\n  const cloneBefore = structuredClone(before);\n  let mutated: Config;\n  try {\n    mutated = await mutator.mutate(cloneBefore);\n  } catch (error) {\n    if (isPromptCancelled(error)) {\n      return {\n        ok: false,\n        action: mutator.action,\n        domain: mutator.domain,\n        target: mutator.target,\n        changedPaths: [],\n        dryRun: options.dryRun,\n        errors: [{ message: 'Cancelled by user' }],\n      };\n    }\n    const errors =\n      error instanceof SetupValidationError\n        ? error.errors\n        : [{ message: (error as Error).message }];\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors,\n    };\n  }\n\n  // Validate the full config (catches invariants beyond the mutator's scope).\n  const parsed = ConfigSchema.safeParse(mutated);\n  if (!parsed.success) {\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors: zodErrorToSetupErrors(parsed.error),\n    };\n  }\n  const validated = parsed.data;\n\n  const changedPaths = diffConfigPaths(baseline, validated);\n  const action: SetupAction = changedPaths.length === 0 ? 'noop' : mutator.action;\n\n  if (changedPaths.length > 0 && !options.dryRun) {\n    try {\n      await saveConfig(validated, configPath);\n    } catch (error) {\n      return {\n        ok: false,\n        action: mutator.action,\n        domain: mutator.domain,\n        target: mutator.target,\n        changedPaths,\n        dryRun: false,\n        errors: [{ message: `Failed to save config: ${(error as Error).message}` }],\n      };\n    }\n  }\n\n  return {\n    ok: true,\n    action,\n    domain: mutator.domain,\n    target: mutator.target,\n    changedPaths,\n    dryRun: options.dryRun,\n    value: mutator.resultValue?.(validated),\n    notes: mutator.notes?.(validated),\n  };\n}\n\n/**\n * CLI wrapper around {@link runSetupHeadless}: emits the outcome to stdout\n * (text or single-line JSON) and sets `process.exitCode` to the standard\n * setup exit codes (0 ok / 1 error / 2 cancelled).\n *\n * Use this from CLI command actions; use {@link runSetupHeadless} from any\n * non-CLI caller (HTTP routes, library code, tests).\n */\nexport async function runSetup(args: RunSetupArgs): Promise<SetupOutcome> {\n  const outcome = await runSetupHeadless(args);\n  emitOutcome(outcome, args.options.json);\n  if (outcome.ok) {\n    process.exitCode = SETUP_EXIT.OK;\n  } else if (outcome.errors?.some((e) => /cancelled/i.test(e.message))) {\n    process.exitCode = SETUP_EXIT.CANCELLED;\n  } else {\n    process.exitCode = SETUP_EXIT.ERROR;\n  }\n  return outcome;\n}\n"],"mappings":";;;;;;;;aAGsE;;AActE,IAAa,uBAAb,cAA0C,MAAM;CAC9C;CAEA,YAAY,QAA4C;EACtD,MAAM,OAAqB,MAAM,QAAQ,OAAO,GAC5C,SACA,OAAO,WAAW,WAChB,CAAC,EAAE,SAAS,QAAQ,CAAC,GACrB,CAAC,OAAO;AACd,QAAM,KAAK,KAAK,MAAO,EAAE,OAAO,IAAI,EAAE,KAAK,IAAI,EAAE,YAAY,EAAE,QAAS,CAAC,KAAK,KAAK,CAAC;AACpF,OAAK,OAAO;AACZ,OAAK,SAAS;;;AAyBlB,SAAS,sBAAsB,KAA6B;AAC1D,QAAO,IAAI,OAAO,KAAK,WAAW;EAChC,MAAM,MAAM,KAAK,KAAK,IAAI,IAAI,KAAA;EAC9B,SAAS,MAAM;EAChB,EAAE;;;;;;;;;;;;;;;AAgBL,eAAsB,iBAAiB,MAA2C;CAChF,MAAM,EAAE,YAAY,SAAS,YAAY;CAEzC,IAAI;AACJ,KAAI;AACF,WAAS,WAAW,WAAW;UACxB,OAAO;AACd,SAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,cAAc,EAAE;GAChB,QAAQ,QAAQ;GAChB,QAAQ,CAAC,EAAE,SAAS,0BAA2B,MAAgB,WAAW,CAAC;GAC5E;;CAOH,MAAM,iBAAiB,aAAa,UAAU,gBAAgB,OAAO,CAAC;CACtE,MAAM,WAAmB,eAAe,UAAU,eAAe,OAAO;CAExE,MAAM,cAAc,gBAAgB,OAAO;CAC3C,IAAI;AACJ,KAAI;AACF,YAAU,MAAM,QAAQ,OAAO,YAAY;UACpC,OAAO;AACd,MAAI,kBAAkB,MAAM,CAC1B,QAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,cAAc,EAAE;GAChB,QAAQ,QAAQ;GAChB,QAAQ,CAAC,EAAE,SAAS,qBAAqB,CAAC;GAC3C;EAEH,MAAM,SACJ,iBAAiB,uBACb,MAAM,SACN,CAAC,EAAE,SAAU,MAAgB,SAAS,CAAC;AAC7C,SAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,cAAc,EAAE;GAChB,QAAQ,QAAQ;GAChB;GACD;;CAIH,MAAM,SAAS,aAAa,UAAU,QAAQ;AAC9C,KAAI,CAAC,OAAO,QACV,QAAO;EACL,IAAI;EACJ,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB,cAAc,EAAE;EAChB,QAAQ,QAAQ;EAChB,QAAQ,sBAAsB,OAAO,MAAM;EAC5C;CAEH,MAAM,YAAY,OAAO;CAEzB,MAAM,eAAe,gBAAgB,UAAU,UAAU;CACzD,MAAM,SAAsB,aAAa,WAAW,IAAI,SAAS,QAAQ;AAEzE,KAAI,aAAa,SAAS,KAAK,CAAC,QAAQ,OACtC,KAAI;AACF,QAAM,WAAW,WAAW,WAAW;UAChC,OAAO;AACd,SAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB;GACA,QAAQ;GACR,QAAQ,CAAC,EAAE,SAAS,0BAA2B,MAAgB,WAAW,CAAC;GAC5E;;AAIL,QAAO;EACL,IAAI;EACJ;EACA,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB;EACA,QAAQ,QAAQ;EAChB,OAAO,QAAQ,cAAc,UAAU;EACvC,OAAO,QAAQ,QAAQ,UAAU;EAClC;;;;;;;;;;AAWH,eAAsB,SAAS,MAA2C;CACxE,MAAM,UAAU,MAAM,iBAAiB,KAAK;AAC5C,aAAY,SAAS,KAAK,QAAQ,KAAK;AACvC,KAAI,QAAQ,GACV,SAAQ,WAAW,WAAW;UACrB,QAAQ,QAAQ,MAAM,MAAM,aAAa,KAAK,EAAE,QAAQ,CAAC,CAClE,SAAQ,WAAW,WAAW;KAE9B,SAAQ,WAAW,WAAW;AAEhC,QAAO"}
+{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/cli/commands/setup-shared/runner.ts"],"sourcesContent":["import { ZodError } from 'zod';\n\nimport { loadConfig, saveConfig } from '../../../config/index.js';\nimport { ConfigSchema, type Config } from '../../../config/schema.js';\nimport { diffConfigPaths } from '../../../config/diff.js';\n\nimport { emitOutcome } from './output.js';\nimport { isPromptCancelled } from './prompts.js';\nimport {\n  SETUP_EXIT,\n  type SetupAction,\n  type SetupError,\n  type SetupOutcome,\n  type SetupRunOptions,\n} from './types.js';\n\n/** Thrown by a {@link SetupMutator.mutate} to fail the run with a clean message. */\nexport class SetupValidationError extends Error {\n  readonly errors: SetupError[];\n\n  constructor(errors: SetupError[] | SetupError | string) {\n    const list: SetupError[] = Array.isArray(errors)\n      ? errors\n      : typeof errors === 'string'\n        ? [{ message: errors }]\n        : [errors];\n    super(list.map((e) => (e.path ? `[${e.path}] ${e.message}` : e.message)).join('; '));\n    this.name = 'SetupValidationError';\n    this.errors = list;\n  }\n}\n\nexport interface SetupMutator {\n  /** Logical domain — `providers`, `channels.<id>`, etc. */\n  domain: string;\n  /** Target id within the domain (provider id, account id, …). */\n  target?: string;\n  /** What the operation is conceptually doing. */\n  action: SetupAction;\n  /** Mutates `config` in place (or returns a replacement) and returns it. */\n  mutate(config: Config): Config | Promise<Config>;\n  /** Optional masked value to surface in the outcome (for agents / UI). */\n  resultValue?(config: Config): unknown;\n  /** Optional human-readable notes appended to the outcome. */\n  notes?(config: Config): string[];\n}\n\nexport interface RunSetupArgs {\n  configPath: string;\n  mutator: SetupMutator;\n  options: SetupRunOptions;\n}\n\nfunction zodErrorToSetupErrors(err: ZodError): SetupError[] {\n  return err.issues.map((issue) => ({\n    path: issue.path.join('.') || undefined,\n    message: issue.message,\n  }));\n}\n\n/**\n * Headless setup pipeline — load → clone → mutate → validate(zod) → diff →\n * (write | dry-run) → outcome. Returns the {@link SetupOutcome} without any\n * I/O side effects (no stdout, no `process.exitCode`).\n *\n * Used by CLI setup commands via {@link runSetup}. Keep this side-effect-free\n * so it stays safe to call from tests and other programmatic callers.\n *\n * Custom errors thrown by the mutator surface as `errors[]` on the outcome:\n *   - `SetupValidationError` — explicit `{path?, message}[]` entries\n *   - `ExitPromptError` (from `@inquirer/prompts`) — surfaced as \"Cancelled by user\"\n *   - any other `Error` — the message is used verbatim\n */\nexport async function runSetupHeadless(args: RunSetupArgs): Promise<SetupOutcome> {\n  const { configPath, mutator, options } = args;\n\n  let before: Config;\n  try {\n    before = loadConfig(configPath);\n  } catch (error) {\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors: [{ message: `Failed to load config: ${(error as Error).message}` }],\n    };\n  }\n\n  // `loadConfig` parses through the schema once, but the schema isn't fully\n  // idempotent — re-parsing a result can fill in deeper defaults that the\n  // first pass left undefined. To avoid false-positive diffs against those\n  // defaults, normalize both sides through one extra parse cycle.\n  const baselineParsed = ConfigSchema.safeParse(structuredClone(before));\n  const baseline: Config = baselineParsed.success ? baselineParsed.data : before;\n\n  const cloneBefore = structuredClone(before);\n  let mutated: Config;\n  try {\n    mutated = await mutator.mutate(cloneBefore);\n  } catch (error) {\n    if (isPromptCancelled(error)) {\n      return {\n        ok: false,\n        action: mutator.action,\n        domain: mutator.domain,\n        target: mutator.target,\n        changedPaths: [],\n        dryRun: options.dryRun,\n        errors: [{ message: 'Cancelled by user' }],\n      };\n    }\n    const errors =\n      error instanceof SetupValidationError\n        ? error.errors\n        : [{ message: (error as Error).message }];\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors,\n    };\n  }\n\n  // Validate the full config (catches invariants beyond the mutator's scope).\n  const parsed = ConfigSchema.safeParse(mutated);\n  if (!parsed.success) {\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors: zodErrorToSetupErrors(parsed.error),\n    };\n  }\n  const validated = parsed.data;\n\n  const changedPaths = diffConfigPaths(baseline, validated);\n  const action: SetupAction = changedPaths.length === 0 ? 'noop' : mutator.action;\n\n  if (changedPaths.length > 0 && !options.dryRun) {\n    try {\n      await saveConfig(validated, configPath);\n    } catch (error) {\n      return {\n        ok: false,\n        action: mutator.action,\n        domain: mutator.domain,\n        target: mutator.target,\n        changedPaths,\n        dryRun: false,\n        errors: [{ message: `Failed to save config: ${(error as Error).message}` }],\n      };\n    }\n  }\n\n  return {\n    ok: true,\n    action,\n    domain: mutator.domain,\n    target: mutator.target,\n    changedPaths,\n    dryRun: options.dryRun,\n    value: mutator.resultValue?.(validated),\n    notes: mutator.notes?.(validated),\n  };\n}\n\n/**\n * CLI wrapper around {@link runSetupHeadless}: emits the outcome to stdout\n * (text or single-line JSON) and sets `process.exitCode` to the standard\n * setup exit codes (0 ok / 1 error / 2 cancelled).\n *\n * Use this from CLI command actions; use {@link runSetupHeadless} from any\n * non-CLI caller (HTTP routes, library code, tests).\n */\nexport async function runSetup(args: RunSetupArgs): Promise<SetupOutcome> {\n  const outcome = await runSetupHeadless(args);\n  emitOutcome(outcome, args.options.json);\n  if (outcome.ok) {\n    process.exitCode = SETUP_EXIT.OK;\n  } else if (outcome.errors?.some((e) => /cancelled/i.test(e.message))) {\n    process.exitCode = SETUP_EXIT.CANCELLED;\n  } else {\n    process.exitCode = SETUP_EXIT.ERROR;\n  }\n  return outcome;\n}\n"],"mappings":";;;;;;;;aAGsE;;AActE,IAAa,uBAAb,cAA0C,MAAM;CAC9C;CAEA,YAAY,QAA4C;EACtD,MAAM,OAAqB,MAAM,QAAQ,OAAO,GAC5C,SACA,OAAO,WAAW,WAChB,CAAC,EAAE,SAAS,QAAQ,CAAC,GACrB,CAAC,OAAO;AACd,QAAM,KAAK,KAAK,MAAO,EAAE,OAAO,IAAI,EAAE,KAAK,IAAI,EAAE,YAAY,EAAE,QAAS,CAAC,KAAK,KAAK,CAAC;AACpF,OAAK,OAAO;AACZ,OAAK,SAAS;;;AAyBlB,SAAS,sBAAsB,KAA6B;AAC1D,QAAO,IAAI,OAAO,KAAK,WAAW;EAChC,MAAM,MAAM,KAAK,KAAK,IAAI,IAAI,KAAA;EAC9B,SAAS,MAAM;EAChB,EAAE;;;;;;;;;;;;;;;AAgBL,eAAsB,iBAAiB,MAA2C;CAChF,MAAM,EAAE,YAAY,SAAS,YAAY;CAEzC,IAAI;AACJ,KAAI;AACF,WAAS,WAAW,WAAW;UACxB,OAAO;AACd,SAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,cAAc,EAAE;GAChB,QAAQ,QAAQ;GAChB,QAAQ,CAAC,EAAE,SAAS,0BAA2B,MAAgB,WAAW,CAAC;GAC5E;;CAOH,MAAM,iBAAiB,aAAa,UAAU,gBAAgB,OAAO,CAAC;CACtE,MAAM,WAAmB,eAAe,UAAU,eAAe,OAAO;CAExE,MAAM,cAAc,gBAAgB,OAAO;CAC3C,IAAI;AACJ,KAAI;AACF,YAAU,MAAM,QAAQ,OAAO,YAAY;UACpC,OAAO;AACd,MAAI,kBAAkB,MAAM,CAC1B,QAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,cAAc,EAAE;GAChB,QAAQ,QAAQ;GAChB,QAAQ,CAAC,EAAE,SAAS,qBAAqB,CAAC;GAC3C;EAEH,MAAM,SACJ,iBAAiB,uBACb,MAAM,SACN,CAAC,EAAE,SAAU,MAAgB,SAAS,CAAC;AAC7C,SAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,cAAc,EAAE;GAChB,QAAQ,QAAQ;GAChB;GACD;;CAIH,MAAM,SAAS,aAAa,UAAU,QAAQ;AAC9C,KAAI,CAAC,OAAO,QACV,QAAO;EACL,IAAI;EACJ,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB,cAAc,EAAE;EAChB,QAAQ,QAAQ;EAChB,QAAQ,sBAAsB,OAAO,MAAM;EAC5C;CAEH,MAAM,YAAY,OAAO;CAEzB,MAAM,eAAe,gBAAgB,UAAU,UAAU;CACzD,MAAM,SAAsB,aAAa,WAAW,IAAI,SAAS,QAAQ;AAEzE,KAAI,aAAa,SAAS,KAAK,CAAC,QAAQ,OACtC,KAAI;AACF,QAAM,WAAW,WAAW,WAAW;UAChC,OAAO;AACd,SAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB;GACA,QAAQ;GACR,QAAQ,CAAC,EAAE,SAAS,0BAA2B,MAAgB,WAAW,CAAC;GAC5E;;AAIL,QAAO;EACL,IAAI;EACJ;EACA,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB;EACA,QAAQ,QAAQ;EAChB,OAAO,QAAQ,cAAc,UAAU;EACvC,OAAO,QAAQ,QAAQ,UAAU;EAClC;;;;;;;;;;AAWH,eAAsB,SAAS,MAA2C;CACxE,MAAM,UAAU,MAAM,iBAAiB,KAAK;AAC5C,aAAY,SAAS,KAAK,QAAQ,KAAK;AACvC,KAAI,QAAQ,GACV,SAAQ,WAAW,WAAW;UACrB,QAAQ,QAAQ,MAAM,MAAM,aAAa,KAAK,EAAE,QAAQ,CAAC,CAClE,SAAQ,WAAW,WAAW;KAE9B,SAAQ,WAAW,WAAW;AAEhC,QAAO"}

package/dist/src/cli/commands/setup-shared/types.d.ts

@@ -14,7 +14,7 @@ export interface SetupError {
 export interface SetupOutcome {
     ok: boolean;
     action: SetupAction;
-    /** Logical domain — `providers`, `channels.telegram`, etc. */
+    /** Logical domain — `providers`, `channels.<id>`, etc. */
     domain: string;
     /** Specific target id within the domain (provider id, account id, etc.). */
     target?: string;

package/dist/src/cli/commands/setup-shared/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../../../src/cli/commands/setup-shared/types.ts"],"sourcesContent":["/**\n * Shared types for `xopc <domain>` setup-style commands (providers / channels / ...).\n *\n * Every setup command runs the same load → mutate → validate → diff → write\n * pipeline, and emits the same structured outcome so agents (M2 skills) and the\n * WebUI (M3) can consume results uniformly.\n */\n\nexport type SetupAction = 'add' | 'set' | 'remove' | 'noop';\n\nexport interface SetupError {\n  /** Dot path of the offending field, when known (e.g. `providers.openai.apiKey`). */\n  path?: string;\n  message: string;\n}\n\nexport interface SetupOutcome {\n  ok: boolean;\n  action: SetupAction;\n  /** Logical domain — `providers`, `channels.telegram`, etc. */\n  domain: string;\n  /** Specific target id within the domain (provider id, account id, etc.). */\n  target?: string;\n  /** Config dot paths that differ between before and after. */\n  changedPaths: string[];\n  /** True when run with `--dry-run`. Nothing was written. */\n  dryRun: boolean;\n  /** Validation / I/O errors. Empty when ok. */\n  errors?: SetupError[];\n  /** Resulting (masked) value of the mutated entry, for agent / UI display. */\n  value?: unknown;\n  /** Human-readable summary lines for text output. */\n  notes?: string[];\n}\n\nexport interface SetupRunOptions {\n  /** When true, validate + diff but do not write. */\n  dryRun: boolean;\n  /** When true, emit a single JSON line on stdout and stay silent otherwise. */\n  json: boolean;\n}\n\n/**\n * Standardized exit codes for setup-style commands. Set on `process.exitCode`\n * (don't call `process.exit` directly so JSON output flushes cleanly).\n */\nexport const SETUP_EXIT = {\n  OK: 0,\n  ERROR: 1,\n  CANCELLED: 2,\n} as const;\n"],"mappings":";;;;;AA8CA,MAAa,aAAa;CACxB,IAAI;CACJ,OAAO;CACP,WAAW;CACZ"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../../../src/cli/commands/setup-shared/types.ts"],"sourcesContent":["/**\n * Shared types for `xopc <domain>` setup-style commands (providers / channels / ...).\n *\n * Every setup command runs the same load → mutate → validate → diff → write\n * pipeline, and emits the same structured outcome so agents (M2 skills) and the\n * WebUI (M3) can consume results uniformly.\n */\n\nexport type SetupAction = 'add' | 'set' | 'remove' | 'noop';\n\nexport interface SetupError {\n  /** Dot path of the offending field, when known (e.g. `providers.openai.apiKey`). */\n  path?: string;\n  message: string;\n}\n\nexport interface SetupOutcome {\n  ok: boolean;\n  action: SetupAction;\n  /** Logical domain — `providers`, `channels.<id>`, etc. */\n  domain: string;\n  /** Specific target id within the domain (provider id, account id, etc.). */\n  target?: string;\n  /** Config dot paths that differ between before and after. */\n  changedPaths: string[];\n  /** True when run with `--dry-run`. Nothing was written. */\n  dryRun: boolean;\n  /** Validation / I/O errors. Empty when ok. */\n  errors?: SetupError[];\n  /** Resulting (masked) value of the mutated entry, for agent / UI display. */\n  value?: unknown;\n  /** Human-readable summary lines for text output. */\n  notes?: string[];\n}\n\nexport interface SetupRunOptions {\n  /** When true, validate + diff but do not write. */\n  dryRun: boolean;\n  /** When true, emit a single JSON line on stdout and stay silent otherwise. */\n  json: boolean;\n}\n\n/**\n * Standardized exit codes for setup-style commands. Set on `process.exitCode`\n * (don't call `process.exit` directly so JSON output flushes cleanly).\n */\nexport const SETUP_EXIT = {\n  OK: 0,\n  ERROR: 1,\n  CANCELLED: 2,\n} as const;\n"],"mappings":";;;;;AA8CA,MAAa,aAAa;CACxB,IAAI;CACJ,OAAO;CACP,WAAW;CACZ"}

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

@@ -3,19 +3,26 @@ import { Command } from "commander";
 //#region src/cli/commands/tui.ts
 function createTuiCommand(_ctx) {
 	return new Command("tui").description("Interactive terminal UI (pi-tui)").addHelpText("after", formatExamples([
-		"xopc tui                                    # Connect to local gateway (default)",
-		"xopc tui --local                            # Embedded mode, no gateway needed",
+		"xopc tui                                    # Embedded mode (default)",
+		"xopc tui --gateway                          # Force gateway mode",
+		"xopc tui --local                            # Embedded mode (default)",
 		"xopc tui --url http://host:3120 --token xxx # Connect to remote gateway",
-		"xopc tui -s telegram:dm:123456              # Resume a session",
+		"xopc tui -s agent:main:tui-...              # Resume a session",
 		"xopc tui -m \"Summarize my inbox\"            # Send a message on launch"
-	])).option("--url <url>", "Gateway URL (default: http://localhost:3120)").option("--token <token>", "Gateway bearer token").option("-s, --session <key>", "Session key to resume").option("-m, --message <text>", "Send a message on launch").option("--local", "Run in embedded mode (no gateway required)").option("--theme <name>", "Theme: auto, dark, light, or custom name from ~/.xopc/themes/").option("--thinking <level>", "Thinking level override").action(async (options) => {
+	])).option("--url <url>", "Gateway URL (default: http://localhost:3120)").option("--token <token>", "Gateway bearer token").option("-s, --session <key>", "Session key to resume (omitted: start a fresh TUI session)").option("-m, --message <text>", "Send a message on launch").option("--workdir <dir>", "Workspace directory for the new TUI session").option("--no-cwd", "Do not use the launch directory as the new TUI session workspace").option("--local", "Run in embedded mode (no gateway required)").option("--gateway", "Force gateway mode even without explicit --url or --token").option("--theme <name>", "Theme: auto, dark, light, or custom name from ~/.xopc/themes/").option("--thinking <level>", "Thinking level override").action(async (options) => {
 		const { runTui } = await import("../../tui/tui.js");
+		const useLocal = options.local === true;
+		const useGateway = options.gateway === true || typeof options.url === "string" || typeof options.token === "string";
+		if (useLocal && useGateway) console.log("`--local` and gateway flags both set. Using local mode.");
+		const localMode = useLocal || !useGateway;
 		await runTui({
 			url: typeof options.url === "string" ? options.url : void 0,
 			token: typeof options.token === "string" ? options.token : void 0,
 			session: typeof options.session === "string" ? options.session : void 0,
 			message: typeof options.message === "string" ? options.message : void 0,
-			local: options.local === true,
+			workdir: typeof options.workdir === "string" ? options.workdir : void 0,
+			useStartupCwd: options.cwd !== false,
+			local: localMode,
 			thinking: typeof options.thinking === "string" ? options.thinking : void 0,
 			theme: typeof options.theme === "string" ? options.theme : void 0
 		});
@@ -31,6 +38,7 @@ register({
 		examples: [
 			"xopc tui",
 			"xopc tui --local",
+			"xopc tui --gateway",
 			"xopc tui --url http://host:3120"
 		]
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"tui.js","names":[],"sources":["../../../../src/cli/commands/tui.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { register, formatExamples, type CLIContext } from '../registry.js';\n\nfunction createTuiCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('tui')\n    .description('Interactive terminal UI (pi-tui)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc tui                                    # Connect to local gateway (default)',\n        'xopc tui --local                            # Embedded mode, no gateway needed',\n        'xopc tui --url http://host:3120 --token xxx # Connect to remote gateway',\n        'xopc tui -s telegram:dm:123456              # Resume a session',\n        'xopc tui -m \"Summarize my inbox\"            # Send a message on launch',\n      ]),\n    )\n    .option('--url <url>', 'Gateway URL (default: http://localhost:3120)')\n    .option('--token <token>', 'Gateway bearer token')\n    .option('-s, --session <key>', 'Session key to resume')\n    .option('-m, --message <text>', 'Send a message on launch')\n    .option('--local', 'Run in embedded mode (no gateway required)')\n    .option('--theme <name>', 'Theme: auto, dark, light, or custom name from ~/.xopc/themes/')\n    .option('--thinking <level>', 'Thinking level override')\n    .action(async (options: Record<string, string | boolean | undefined>) => {\n      const { runTui } = await import('../../tui/tui.js');\n      await runTui({\n        url: typeof options.url === 'string' ? options.url : undefined,\n        token: typeof options.token === 'string' ? options.token : undefined,\n        session: typeof options.session === 'string' ? options.session : undefined,\n        message: typeof options.message === 'string' ? options.message : undefined,\n        local: options.local === true,\n        thinking: typeof options.thinking === 'string' ? options.thinking : undefined,\n        theme: typeof options.theme === 'string' ? options.theme : undefined,\n      });\n    });\n\n  return cmd;\n}\n\nregister({\n  id: 'tui',\n  name: 'tui',\n  description: 'Interactive terminal UI (pi-tui)',\n  factory: createTuiCommand,\n  metadata: {\n    category: 'runtime',\n    examples: [\n      'xopc tui',\n      'xopc tui --local',\n      'xopc tui --url http://host:3120',\n    ],\n  },\n});\n"],"mappings":";;;AAIA,SAAS,iBAAiB,MAA2B;AAiCnD,QAhCY,IAAI,QAAQ,MAAM,CAC3B,YAAY,mCAAmC,CAC/C,YACC,SACA,eAAe;EACb;EACA;EACA;EACA;EACA;EACD,CAAC,CACH,CACA,OAAO,eAAe,+CAA+C,CACrE,OAAO,mBAAmB,uBAAuB,CACjD,OAAO,uBAAuB,wBAAwB,CACtD,OAAO,wBAAwB,2BAA2B,CAC1D,OAAO,WAAW,6CAA6C,CAC/D,OAAO,kBAAkB,gEAAgE,CACzF,OAAO,sBAAsB,0BAA0B,CACvD,OAAO,OAAO,YAA0D;EACvE,MAAM,EAAE,WAAW,MAAM,OAAO;AAChC,QAAM,OAAO;GACX,KAAK,OAAO,QAAQ,QAAQ,WAAW,QAAQ,MAAM,KAAA;GACrD,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,KAAA;GAC3D,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,OAAO,QAAQ,UAAU;GACzB,UAAU,OAAO,QAAQ,aAAa,WAAW,QAAQ,WAAW,KAAA;GACpE,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,KAAA;GAC5D,CAAC;GAGI;;AAGZ,SAAS;CACP,IAAI;CACJ,MAAM;CACN,aAAa;CACb,SAAS;CACT,UAAU;EACR,UAAU;EACV,UAAU;GACR;GACA;GACA;GACD;EACF;CACF,CAAC"}
+{"version":3,"file":"tui.js","names":[],"sources":["../../../../src/cli/commands/tui.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { register, formatExamples, type CLIContext } from '../registry.js';\n\nfunction createTuiCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('tui')\n    .description('Interactive terminal UI (pi-tui)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc tui                                    # Embedded mode (default)',\n        'xopc tui --gateway                          # Force gateway mode',\n        'xopc tui --local                            # Embedded mode (default)',\n        'xopc tui --url http://host:3120 --token xxx # Connect to remote gateway',\n        'xopc tui -s agent:main:tui-...              # Resume a session',\n        'xopc tui -m \"Summarize my inbox\"            # Send a message on launch',\n      ]),\n    )\n    .option('--url <url>', 'Gateway URL (default: http://localhost:3120)')\n    .option('--token <token>', 'Gateway bearer token')\n    .option('-s, --session <key>', 'Session key to resume (omitted: start a fresh TUI session)')\n    .option('-m, --message <text>', 'Send a message on launch')\n    .option('--workdir <dir>', 'Workspace directory for the new TUI session')\n    .option('--no-cwd', 'Do not use the launch directory as the new TUI session workspace')\n    .option('--local', 'Run in embedded mode (no gateway required)')\n    .option('--gateway', 'Force gateway mode even without explicit --url or --token')\n    .option('--theme <name>', 'Theme: auto, dark, light, or custom name from ~/.xopc/themes/')\n    .option('--thinking <level>', 'Thinking level override')\n    .action(async (options: Record<string, string | boolean | undefined>) => {\n      const { runTui } = await import('../../tui/tui.js');\n      const useLocal = options.local === true;\n      const useGateway =\n        options.gateway === true ||\n        typeof options.url === 'string' ||\n        typeof options.token === 'string';\n      if (useLocal && useGateway) {\n        console.log('`--local` and gateway flags both set. Using local mode.');\n      }\n      const localMode = useLocal || !useGateway;\n      await runTui({\n        url: typeof options.url === 'string' ? options.url : undefined,\n        token: typeof options.token === 'string' ? options.token : undefined,\n        session: typeof options.session === 'string' ? options.session : undefined,\n        message: typeof options.message === 'string' ? options.message : undefined,\n        workdir: typeof options.workdir === 'string' ? options.workdir : undefined,\n        useStartupCwd: options.cwd !== false,\n        local: localMode,\n        thinking: typeof options.thinking === 'string' ? options.thinking : undefined,\n        theme: typeof options.theme === 'string' ? options.theme : undefined,\n      });\n    });\n\n  return cmd;\n}\n\nregister({\n  id: 'tui',\n  name: 'tui',\n  description: 'Interactive terminal UI (pi-tui)',\n  factory: createTuiCommand,\n  metadata: {\n    category: 'runtime',\n    examples: [\n      'xopc tui',\n      'xopc tui --local',\n      'xopc tui --gateway',\n      'xopc tui --url http://host:3120',\n    ],\n  },\n});\n"],"mappings":";;;AAIA,SAAS,iBAAiB,MAA2B;AAgDnD,QA/CY,IAAI,QAAQ,MAAM,CAC3B,YAAY,mCAAmC,CAC/C,YACC,SACA,eAAe;EACb;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,CACH,CACA,OAAO,eAAe,+CAA+C,CACrE,OAAO,mBAAmB,uBAAuB,CACjD,OAAO,uBAAuB,6DAA6D,CAC3F,OAAO,wBAAwB,2BAA2B,CAC1D,OAAO,mBAAmB,8CAA8C,CACxE,OAAO,YAAY,mEAAmE,CACtF,OAAO,WAAW,6CAA6C,CAC/D,OAAO,aAAa,4DAA4D,CAChF,OAAO,kBAAkB,gEAAgE,CACzF,OAAO,sBAAsB,0BAA0B,CACvD,OAAO,OAAO,YAA0D;EACvE,MAAM,EAAE,WAAW,MAAM,OAAO;EAChC,MAAM,WAAW,QAAQ,UAAU;EACnC,MAAM,aACJ,QAAQ,YAAY,QACpB,OAAO,QAAQ,QAAQ,YACvB,OAAO,QAAQ,UAAU;AAC3B,MAAI,YAAY,WACd,SAAQ,IAAI,0DAA0D;EAExE,MAAM,YAAY,YAAY,CAAC;AAC/B,QAAM,OAAO;GACX,KAAK,OAAO,QAAQ,QAAQ,WAAW,QAAQ,MAAM,KAAA;GACrD,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,KAAA;GAC3D,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,eAAe,QAAQ,QAAQ;GAC/B,OAAO;GACP,UAAU,OAAO,QAAQ,aAAa,WAAW,QAAQ,WAAW,KAAA;GACpE,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,KAAA;GAC5D,CAAC;GAGI;;AAGZ,SAAS;CACP,IAAI;CACJ,MAAM;CACN,aAAa;CACb,SAAS;CACT,UAAU;EACR,UAAU;EACV,UAAU;GACR;GACA;GACA;GACA;GACD;EACF;CACF,CAAC"}

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

@@ -1,11 +1,11 @@
 import { loadConfig } from "../config/loader.js";
 import { collectConfiguredChannelIds } from "../extensions/activation-context.js";
-import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import { ExtensionLoader } from "../extensions/loader.js";
 import "../extensions/index.js";
 import { MessageBus } from "../infra/bus/queue.js";
 import "../infra/bus/index.js";
 import { createDefaultContext } from "./registry.js";
+import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
 import { registerExtensionCliProgram } from "../extensions/sdk/channel-helpers.js";
 import { join } from "path";

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

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

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

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

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

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

package/dist/src/config/agent-profile.d.ts

@@ -22,7 +22,7 @@ export interface EffectiveAgentProfile {
     reasoningDefault?: ReasoningLevel;
     verboseDefault?: VerboseLevel;
     systemPromptOverride?: string;
-    /** When set, only these skill names appear in `<available_skills>`. */
+    /** Skill names visible in `<available_skills>`; undefined means all enabled skills, empty means none. */
     skillsAllowlist?: string[];
     tools: EffectiveAgentTools;
     params: Record<string, unknown>;

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

@@ -35,6 +35,10 @@ function mergeDisableLists(a, b) {
 	}
 	return out;
 }
+function resolveSkillsAllowlist(defaultsSkills, entrySkills) {
+	if (entrySkills !== void 0) return [...entrySkills];
+	if (defaultsSkills !== void 0) return [...defaultsSkills];
+}
 /**
 * Agent id used for config lookup from a session key (subagent keys → default agent).
 */
@@ -54,7 +58,7 @@ function resolveEffectiveAgentProfile(config, agentId) {
 	const list = config.agents?.list;
 	const entry = Array.isArray(list) ? list.find((a) => a && a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase()) : void 0;
 	const resolvedWorkspacePath = resolveAgentWorkspaceDir(config, agentId);
-	const { primary: primaryFromMerged, fallbacks: fallbacksFromMerged } = primaryAndFallbacksFromModelConfig(mergeModelConfig(defaults?.model, entry?.model));
+	const { primary: primaryFromMerged, fallbacks: fallbacksFromMerged } = primaryAndFallbacksFromModelConfig(mergeModelConfig(defaults?.models?.chat, entry?.models?.chat));
 	const globalDefault = getAgentDefaultModelRef(config);
 	const primaryModelRef = primaryFromMerged?.trim() || globalDefault;
 	const disable = mergeDisableLists(defaults?.tools?.disable, entry?.tools?.disable);
@@ -71,7 +75,7 @@ function resolveEffectiveAgentProfile(config, agentId) {
 		reasoningDefault: entry?.reasoningDefault ?? defaults?.reasoningDefault,
 		verboseDefault: entry?.verboseDefault ?? defaults?.verboseDefault,
 		systemPromptOverride: entry?.systemPromptOverride?.trim() ? entry.systemPromptOverride : defaults?.systemPromptOverride?.trim() ? defaults.systemPromptOverride : void 0,
-		skillsAllowlist: entry?.skills?.length ? [...entry.skills] : defaults?.skills?.length ? [...defaults.skills] : void 0,
+		skillsAllowlist: resolveSkillsAllowlist(defaults?.skills, entry?.skills),
 		tools: { disable },
 		params
 	};

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

@@ -1 +1 @@
-{"version":3,"file":"agent-profile.js","names":[],"sources":["../../../src/config/agent-profile.ts"],"sourcesContent":["/**\n * Effective agent profile: merges `agents.defaults` with `agents.list` entry.\n * Subagent session keys fall back to the configured default agent id for profile lookup.\n */\n\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';\nimport type { Config } from './schema.js';\nimport type { AgentModelConfig } from './schema.js';\nimport { getAgentDefaultModelRef } from './schema.js';\nimport { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';\nimport { getDefaultAgentId, agentExists } from '../routing/resolve-route.js';\nimport { parseSessionKey } from '../routing/session-key.js';\n\nexport { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';\n\nexport type { AgentModelConfig };\n\nexport interface EffectiveAgentTools {\n  /** Tool names to exclude (merged: union of defaults + list entry disables). */\n  disable: Set<string>;\n}\n\nexport interface EffectiveAgentProfile {\n  agentId: string;\n  /** Resolved absolute Markdown workspace path (tool cwd, attachments, daily memory/, …). */\n  resolvedWorkspacePath: string;\n  /** Primary model ref (provider/model); may be empty → runtime default. */\n  primaryModelRef: string | undefined;\n  fallbacks: string[];\n  thinkingDefault?: ThinkLevel;\n  reasoningDefault?: ReasoningLevel;\n  verboseDefault?: VerboseLevel;\n  systemPromptOverride?: string;\n  /** When set, only these skill names appear in `<available_skills>`. */\n  skillsAllowlist?: string[];\n  tools: EffectiveAgentTools;\n  params: Record<string, unknown>;\n}\n\nfunction mergeModelConfig(\n  base: AgentModelConfig | undefined,\n  override: AgentModelConfig | undefined,\n): AgentModelConfig | undefined {\n  if (override === undefined) return base;\n  if (base === undefined) return override;\n  return {\n    primary: override.primary ?? base.primary,\n    fallbacks: override.fallbacks ?? base.fallbacks,\n  };\n}\n\nfunction primaryAndFallbacksFromModelConfig(\n  raw: AgentModelConfig | undefined,\n): { primary?: string; fallbacks: string[] } {\n  const primary = raw?.primary?.trim();\n  const fallbacks = Array.isArray(raw?.fallbacks)\n    ? raw.fallbacks.map((s) => s.trim()).filter(Boolean)\n    : [];\n  return { primary: primary || undefined, fallbacks };\n}\n\nfunction mergeDisableLists(a?: string[], b?: string[]): Set<string> {\n  const out = new Set<string>();\n  for (const x of a ?? []) {\n    const s = String(x).trim();\n    if (s) {\n      out.add(s);\n    }\n  }\n  for (const x of b ?? []) {\n    const s = String(x).trim();\n    if (s) {\n      out.add(s);\n    }\n  }\n  return out;\n}\n\n/**\n * Agent id used for config lookup from a session key (subagent keys → default agent).\n */\nexport function extractProfileAgentId(sessionKey: string | undefined | null, config: Config): string {\n  const parsed = parseSessionKey(sessionKey ?? '');\n  if (!parsed) {\n    return getDefaultAgentId(config);\n  }\n  const aid = parsed.agentId;\n  if (aid === 'subagent' || aid.startsWith('subagent:')) {\n    return getDefaultAgentId(config);\n  }\n  if (!agentExists(aid, config)) {\n    return getDefaultAgentId(config);\n  }\n  return aid.toLowerCase();\n}\n\n/**\n * Merge `agents.defaults` with the matching `agents.list` entry.\n */\nexport function resolveEffectiveAgentProfile(config: Config, agentId: string): EffectiveAgentProfile {\n  const defaults = config.agents?.defaults;\n  const list = config.agents?.list;\n  const entry = Array.isArray(list)\n    ? list.find((a) => a && a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase())\n    : undefined;\n\n  const resolvedWorkspacePath = resolveAgentWorkspaceDir(config, agentId);\n\n  const mergedModel = mergeModelConfig(defaults?.model, entry?.model);\n  const { primary: primaryFromMerged, fallbacks: fallbacksFromMerged } = primaryAndFallbacksFromModelConfig(mergedModel);\n  const globalDefault = getAgentDefaultModelRef(config);\n  const primaryModelRef = primaryFromMerged?.trim() || globalDefault;\n\n  const disable = mergeDisableLists(\n    defaults?.tools?.disable as string[] | undefined,\n    entry?.tools?.disable as string[] | undefined,\n  );\n\n  const params: Record<string, unknown> = {\n    ...(defaults?.params as Record<string, unknown> | undefined),\n    ...(entry?.params as Record<string, unknown> | undefined),\n  };\n\n  return {\n    agentId: agentId.toLowerCase(),\n    resolvedWorkspacePath,\n    primaryModelRef,\n    fallbacks: fallbacksFromMerged,\n    thinkingDefault: entry?.thinkingDefault ?? defaults?.thinkingDefault,\n    reasoningDefault: entry?.reasoningDefault ?? defaults?.reasoningDefault,\n    verboseDefault: entry?.verboseDefault ?? defaults?.verboseDefault,\n    systemPromptOverride: entry?.systemPromptOverride?.trim()\n      ? entry.systemPromptOverride\n      : defaults?.systemPromptOverride?.trim()\n        ? defaults.systemPromptOverride\n        : undefined,\n    skillsAllowlist: entry?.skills?.length ? [...entry.skills] : defaults?.skills?.length ? [...defaults.skills] : undefined,\n    tools: { disable },\n    params,\n  };\n}\n\nexport function resolveEffectiveAgentProfileForSession(\n  config: Config,\n  sessionKey: string | undefined | null,\n): EffectiveAgentProfile {\n  const id = extractProfileAgentId(sessionKey, config);\n  return resolveEffectiveAgentProfile(config, id);\n}\n"],"mappings":";;;;;aAQsD;kBACa;oBACU;kBACjB;AA4B5D,SAAS,iBACP,MACA,UAC8B;AAC9B,KAAI,aAAa,KAAA,EAAW,QAAO;AACnC,KAAI,SAAS,KAAA,EAAW,QAAO;AAC/B,QAAO;EACL,SAAS,SAAS,WAAW,KAAK;EAClC,WAAW,SAAS,aAAa,KAAK;EACvC;;AAGH,SAAS,mCACP,KAC2C;CAC3C,MAAM,UAAU,KAAK,SAAS,MAAM;CACpC,MAAM,YAAY,MAAM,QAAQ,KAAK,UAAU,GAC3C,IAAI,UAAU,KAAK,MAAM,EAAE,MAAM,CAAC,CAAC,OAAO,QAAQ,GAClD,EAAE;AACN,QAAO;EAAE,SAAS,WAAW,KAAA;EAAW;EAAW;;AAGrD,SAAS,kBAAkB,GAAc,GAA2B;CAClE,MAAM,sBAAM,IAAI,KAAa;AAC7B,MAAK,MAAM,KAAK,KAAK,EAAE,EAAE;EACvB,MAAM,IAAI,OAAO,EAAE,CAAC,MAAM;AAC1B,MAAI,EACF,KAAI,IAAI,EAAE;;AAGd,MAAK,MAAM,KAAK,KAAK,EAAE,EAAE;EACvB,MAAM,IAAI,OAAO,EAAE,CAAC,MAAM;AAC1B,MAAI,EACF,KAAI,IAAI,EAAE;;AAGd,QAAO;;;;;AAMT,SAAgB,sBAAsB,YAAuC,QAAwB;CACnG,MAAM,SAAS,gBAAgB,cAAc,GAAG;AAChD,KAAI,CAAC,OACH,QAAO,kBAAkB,OAAO;CAElC,MAAM,MAAM,OAAO;AACnB,KAAI,QAAQ,cAAc,IAAI,WAAW,YAAY,CACnD,QAAO,kBAAkB,OAAO;AAElC,KAAI,CAAC,YAAY,KAAK,OAAO,CAC3B,QAAO,kBAAkB,OAAO;AAElC,QAAO,IAAI,aAAa;;;;;AAM1B,SAAgB,6BAA6B,QAAgB,SAAwC;CACnG,MAAM,WAAW,OAAO,QAAQ;CAChC,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,QAAQ,MAAM,QAAQ,KAAK,GAC7B,KAAK,MAAM,MAAM,KAAK,EAAE,YAAY,SAAS,EAAE,GAAG,aAAa,KAAK,QAAQ,aAAa,CAAC,GAC1F,KAAA;CAEJ,MAAM,wBAAwB,yBAAyB,QAAQ,QAAQ;CAGvE,MAAM,EAAE,SAAS,mBAAmB,WAAW,wBAAwB,mCADnD,iBAAiB,UAAU,OAAO,OAAO,MACwD,CAAC;CACtH,MAAM,gBAAgB,wBAAwB,OAAO;CACrD,MAAM,kBAAkB,mBAAmB,MAAM,IAAI;CAErD,MAAM,UAAU,kBACd,UAAU,OAAO,SACjB,OAAO,OAAO,QACf;CAED,MAAM,SAAkC;EACtC,GAAI,UAAU;EACd,GAAI,OAAO;EACZ;AAED,QAAO;EACL,SAAS,QAAQ,aAAa;EAC9B;EACA;EACA,WAAW;EACX,iBAAiB,OAAO,mBAAmB,UAAU;EACrD,kBAAkB,OAAO,oBAAoB,UAAU;EACvD,gBAAgB,OAAO,kBAAkB,UAAU;EACnD,sBAAsB,OAAO,sBAAsB,MAAM,GACrD,MAAM,uBACN,UAAU,sBAAsB,MAAM,GACpC,SAAS,uBACT,KAAA;EACN,iBAAiB,OAAO,QAAQ,SAAS,CAAC,GAAG,MAAM,OAAO,GAAG,UAAU,QAAQ,SAAS,CAAC,GAAG,SAAS,OAAO,GAAG,KAAA;EAC/G,OAAO,EAAE,SAAS;EAClB;EACD;;AAGH,SAAgB,uCACd,QACA,YACuB;AAEvB,QAAO,6BAA6B,QADzB,sBAAsB,YAAY,OACC,CAAC"}
+{"version":3,"file":"agent-profile.js","names":[],"sources":["../../../src/config/agent-profile.ts"],"sourcesContent":["/**\n * Effective agent profile: merges `agents.defaults` with `agents.list` entry.\n * Subagent session keys fall back to the configured default agent id for profile lookup.\n */\n\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';\nimport type { Config } from './schema.js';\nimport type { AgentModelConfig } from './schema.js';\nimport { getAgentDefaultModelRef } from './schema.js';\nimport { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';\nimport { getDefaultAgentId, agentExists } from '../routing/resolve-route.js';\nimport { parseSessionKey } from '../routing/session-key.js';\n\nexport { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';\n\nexport type { AgentModelConfig };\n\nexport interface EffectiveAgentTools {\n  /** Tool names to exclude (merged: union of defaults + list entry disables). */\n  disable: Set<string>;\n}\n\nexport interface EffectiveAgentProfile {\n  agentId: string;\n  /** Resolved absolute Markdown workspace path (tool cwd, attachments, daily memory/, …). */\n  resolvedWorkspacePath: string;\n  /** Primary model ref (provider/model); may be empty → runtime default. */\n  primaryModelRef: string | undefined;\n  fallbacks: string[];\n  thinkingDefault?: ThinkLevel;\n  reasoningDefault?: ReasoningLevel;\n  verboseDefault?: VerboseLevel;\n  systemPromptOverride?: string;\n  /** Skill names visible in `<available_skills>`; undefined means all enabled skills, empty means none. */\n  skillsAllowlist?: string[];\n  tools: EffectiveAgentTools;\n  params: Record<string, unknown>;\n}\n\nfunction mergeModelConfig(\n  base: AgentModelConfig | undefined,\n  override: AgentModelConfig | undefined,\n): AgentModelConfig | undefined {\n  if (override === undefined) return base;\n  if (base === undefined) return override;\n  return {\n    primary: override.primary ?? base.primary,\n    fallbacks: override.fallbacks ?? base.fallbacks,\n  };\n}\n\nfunction primaryAndFallbacksFromModelConfig(\n  raw: AgentModelConfig | undefined,\n): { primary?: string; fallbacks: string[] } {\n  const primary = raw?.primary?.trim();\n  const fallbacks = Array.isArray(raw?.fallbacks)\n    ? raw.fallbacks.map((s) => s.trim()).filter(Boolean)\n    : [];\n  return { primary: primary || undefined, fallbacks };\n}\n\nfunction mergeDisableLists(a?: string[], b?: string[]): Set<string> {\n  const out = new Set<string>();\n  for (const x of a ?? []) {\n    const s = String(x).trim();\n    if (s) {\n      out.add(s);\n    }\n  }\n  for (const x of b ?? []) {\n    const s = String(x).trim();\n    if (s) {\n      out.add(s);\n    }\n  }\n  return out;\n}\n\nfunction resolveSkillsAllowlist(defaultsSkills: string[] | undefined, entrySkills: string[] | undefined): string[] | undefined {\n  if (entrySkills !== undefined) {\n    return [...entrySkills];\n  }\n  if (defaultsSkills !== undefined) {\n    return [...defaultsSkills];\n  }\n  return undefined;\n}\n\n/**\n * Agent id used for config lookup from a session key (subagent keys → default agent).\n */\nexport function extractProfileAgentId(sessionKey: string | undefined | null, config: Config): string {\n  const parsed = parseSessionKey(sessionKey ?? '');\n  if (!parsed) {\n    return getDefaultAgentId(config);\n  }\n  const aid = parsed.agentId;\n  if (aid === 'subagent' || aid.startsWith('subagent:')) {\n    return getDefaultAgentId(config);\n  }\n  if (!agentExists(aid, config)) {\n    return getDefaultAgentId(config);\n  }\n  return aid.toLowerCase();\n}\n\n/**\n * Merge `agents.defaults` with the matching `agents.list` entry.\n */\nexport function resolveEffectiveAgentProfile(config: Config, agentId: string): EffectiveAgentProfile {\n  const defaults = config.agents?.defaults;\n  const list = config.agents?.list;\n  const entry = Array.isArray(list)\n    ? list.find((a) => a && a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase())\n    : undefined;\n\n  const resolvedWorkspacePath = resolveAgentWorkspaceDir(config, agentId);\n\n  const mergedModel = mergeModelConfig(defaults?.models?.chat, entry?.models?.chat);\n  const { primary: primaryFromMerged, fallbacks: fallbacksFromMerged } = primaryAndFallbacksFromModelConfig(mergedModel);\n  const globalDefault = getAgentDefaultModelRef(config);\n  const primaryModelRef = primaryFromMerged?.trim() || globalDefault;\n\n  const disable = mergeDisableLists(\n    defaults?.tools?.disable as string[] | undefined,\n    entry?.tools?.disable as string[] | undefined,\n  );\n\n  const params: Record<string, unknown> = {\n    ...(defaults?.params as Record<string, unknown> | undefined),\n    ...(entry?.params as Record<string, unknown> | undefined),\n  };\n\n  return {\n    agentId: agentId.toLowerCase(),\n    resolvedWorkspacePath,\n    primaryModelRef,\n    fallbacks: fallbacksFromMerged,\n    thinkingDefault: entry?.thinkingDefault ?? defaults?.thinkingDefault,\n    reasoningDefault: entry?.reasoningDefault ?? defaults?.reasoningDefault,\n    verboseDefault: entry?.verboseDefault ?? defaults?.verboseDefault,\n    systemPromptOverride: entry?.systemPromptOverride?.trim()\n      ? entry.systemPromptOverride\n      : defaults?.systemPromptOverride?.trim()\n        ? defaults.systemPromptOverride\n        : undefined,\n    skillsAllowlist: resolveSkillsAllowlist(defaults?.skills, entry?.skills),\n    tools: { disable },\n    params,\n  };\n}\n\nexport function resolveEffectiveAgentProfileForSession(\n  config: Config,\n  sessionKey: string | undefined | null,\n): EffectiveAgentProfile {\n  const id = extractProfileAgentId(sessionKey, config);\n  return resolveEffectiveAgentProfile(config, id);\n}\n"],"mappings":";;;;;aAQsD;kBACa;oBACU;kBACjB;AA4B5D,SAAS,iBACP,MACA,UAC8B;AAC9B,KAAI,aAAa,KAAA,EAAW,QAAO;AACnC,KAAI,SAAS,KAAA,EAAW,QAAO;AAC/B,QAAO;EACL,SAAS,SAAS,WAAW,KAAK;EAClC,WAAW,SAAS,aAAa,KAAK;EACvC;;AAGH,SAAS,mCACP,KAC2C;CAC3C,MAAM,UAAU,KAAK,SAAS,MAAM;CACpC,MAAM,YAAY,MAAM,QAAQ,KAAK,UAAU,GAC3C,IAAI,UAAU,KAAK,MAAM,EAAE,MAAM,CAAC,CAAC,OAAO,QAAQ,GAClD,EAAE;AACN,QAAO;EAAE,SAAS,WAAW,KAAA;EAAW;EAAW;;AAGrD,SAAS,kBAAkB,GAAc,GAA2B;CAClE,MAAM,sBAAM,IAAI,KAAa;AAC7B,MAAK,MAAM,KAAK,KAAK,EAAE,EAAE;EACvB,MAAM,IAAI,OAAO,EAAE,CAAC,MAAM;AAC1B,MAAI,EACF,KAAI,IAAI,EAAE;;AAGd,MAAK,MAAM,KAAK,KAAK,EAAE,EAAE;EACvB,MAAM,IAAI,OAAO,EAAE,CAAC,MAAM;AAC1B,MAAI,EACF,KAAI,IAAI,EAAE;;AAGd,QAAO;;AAGT,SAAS,uBAAuB,gBAAsC,aAAyD;AAC7H,KAAI,gBAAgB,KAAA,EAClB,QAAO,CAAC,GAAG,YAAY;AAEzB,KAAI,mBAAmB,KAAA,EACrB,QAAO,CAAC,GAAG,eAAe;;;;;AAQ9B,SAAgB,sBAAsB,YAAuC,QAAwB;CACnG,MAAM,SAAS,gBAAgB,cAAc,GAAG;AAChD,KAAI,CAAC,OACH,QAAO,kBAAkB,OAAO;CAElC,MAAM,MAAM,OAAO;AACnB,KAAI,QAAQ,cAAc,IAAI,WAAW,YAAY,CACnD,QAAO,kBAAkB,OAAO;AAElC,KAAI,CAAC,YAAY,KAAK,OAAO,CAC3B,QAAO,kBAAkB,OAAO;AAElC,QAAO,IAAI,aAAa;;;;;AAM1B,SAAgB,6BAA6B,QAAgB,SAAwC;CACnG,MAAM,WAAW,OAAO,QAAQ;CAChC,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,QAAQ,MAAM,QAAQ,KAAK,GAC7B,KAAK,MAAM,MAAM,KAAK,EAAE,YAAY,SAAS,EAAE,GAAG,aAAa,KAAK,QAAQ,aAAa,CAAC,GAC1F,KAAA;CAEJ,MAAM,wBAAwB,yBAAyB,QAAQ,QAAQ;CAGvE,MAAM,EAAE,SAAS,mBAAmB,WAAW,wBAAwB,mCADnD,iBAAiB,UAAU,QAAQ,MAAM,OAAO,QAAQ,KACyC,CAAC;CACtH,MAAM,gBAAgB,wBAAwB,OAAO;CACrD,MAAM,kBAAkB,mBAAmB,MAAM,IAAI;CAErD,MAAM,UAAU,kBACd,UAAU,OAAO,SACjB,OAAO,OAAO,QACf;CAED,MAAM,SAAkC;EACtC,GAAI,UAAU;EACd,GAAI,OAAO;EACZ;AAED,QAAO;EACL,SAAS,QAAQ,aAAa;EAC9B;EACA;EACA,WAAW;EACX,iBAAiB,OAAO,mBAAmB,UAAU;EACrD,kBAAkB,OAAO,oBAAoB,UAAU;EACvD,gBAAgB,OAAO,kBAAkB,UAAU;EACnD,sBAAsB,OAAO,sBAAsB,MAAM,GACrD,MAAM,uBACN,UAAU,sBAAsB,MAAM,GACpC,SAAS,uBACT,KAAA;EACN,iBAAiB,uBAAuB,UAAU,QAAQ,OAAO,OAAO;EACxE,OAAO,EAAE,SAAS;EAClB;EACD;;AAGH,SAAgB,uCACd,QACA,YACuB;AAEvB,QAAO,6BAA6B,QADzB,sBAAsB,YAAY,OACC,CAAC"}

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

@@ -1,9 +1,9 @@
 /**
- * Named model roles from `agents.defaults.models`.
+ * Named model roles from `agents.defaults.models.roles` plus per-agent overrides.
  */
 import type { AgentTypedModel, Config } from './schema.js';
 export type { AgentTypedModel };
-export declare function resolveEffectiveTypedModels(config: Config, _agentId: string): Map<string, AgentTypedModel>;
+export declare function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel>;
 /** Resolve a typed model id to `provider/model`, or undefined when not configured. */
 export declare function resolveTypedModelRef(config: Config, agentId: string, typeId: string): string | undefined;
 /**

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

@@ -1,9 +1,20 @@
+import { init_agent_scope, listAgentEntries, normalizeAgentId } from "../agent/agent-scope.js";
 import { init_schema, parseModelRef } from "./schema.js";
 //#region src/config/agent-typed-models.ts
 init_schema();
-function resolveEffectiveTypedModels(config, _agentId) {
+init_agent_scope();
+function rolesToEntries(roles) {
+	return Object.entries(roles ?? {}).map(([id, role]) => ({
+		id,
+		...role
+	}));
+}
+function resolveEffectiveTypedModels(config, agentId) {
 	const out = /* @__PURE__ */ new Map();
-	for (const modelRole of config.agents?.defaults?.models ?? []) out.set(modelRole.id, modelRole);
+	for (const modelRole of rolesToEntries(config.agents?.defaults?.models?.roles)) out.set(modelRole.id, modelRole);
+	const id = normalizeAgentId(agentId);
+	const entry = listAgentEntries(config).find((candidate) => candidate.enabled !== false && normalizeAgentId(candidate.id) === id);
+	for (const modelRole of rolesToEntries(entry?.models?.roles)) out.set(modelRole.id, modelRole);
 	return out;
 }
 /** Resolve a typed model id to `provider/model`, or undefined when not configured. */

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

@@ -1 +1 @@
-{"version":3,"file":"agent-typed-models.js","names":[],"sources":["../../../src/config/agent-typed-models.ts"],"sourcesContent":["/**\n * Named model roles from `agents.defaults.models`.\n */\n\nimport type { AgentTypedModel, Config } from './schema.js';\nimport { parseModelRef } from './schema.js';\n\nexport type { AgentTypedModel };\n\nexport function resolveEffectiveTypedModels(config: Config, _agentId: string): Map<string, AgentTypedModel> {\n  const out = new Map<string, AgentTypedModel>();\n  for (const modelRole of config.agents?.defaults?.models ?? []) {\n    out.set(modelRole.id, modelRole);\n  }\n  return out;\n}\n\n/** Resolve a typed model id to `provider/model`, or undefined when not configured. */\nexport function resolveTypedModelRef(\n  config: Config,\n  agentId: string,\n  typeId: string,\n): string | undefined {\n  const entry = resolveEffectiveTypedModels(config, agentId).get(typeId);\n  const ref = entry?.model?.trim();\n  return ref || undefined;\n}\n\nfunction parseModelRefInput(ref: string): { directRef?: string; typeId?: string } {\n  const trimmed = ref.trim();\n  if (!trimmed) {\n    return {};\n  }\n  if (trimmed.includes('/')) {\n    return { directRef: trimmed };\n  }\n  const typeId = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n  return typeId ? { typeId } : {};\n}\n\n/**\n * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.\n * Throws when the ref is invalid or the typed id is unknown.\n */\nexport function resolveModelRef(config: Config, agentId: string, ref: string): string {\n  const { directRef, typeId } = parseModelRefInput(ref);\n  if (directRef) {\n    if (!parseModelRef(directRef)) {\n      throw new Error(`model ref must be provider/model format (got '${directRef}')`);\n    }\n    return directRef;\n  }\n  if (typeId) {\n    const resolved = resolveTypedModelRef(config, agentId, typeId);\n    if (resolved) {\n      return resolved;\n    }\n    const available = [...resolveEffectiveTypedModels(config, agentId).keys()];\n    const hint =\n      available.length > 0 ? ` (available: ${available.join(', ')})` : ' (none configured)';\n    throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);\n  }\n  throw new Error('model ref must not be empty');\n}\n"],"mappings":";;aAK4C;AAI5C,SAAgB,4BAA4B,QAAgB,UAAgD;CAC1G,MAAM,sBAAM,IAAI,KAA8B;AAC9C,MAAK,MAAM,aAAa,OAAO,QAAQ,UAAU,UAAU,EAAE,CAC3D,KAAI,IAAI,UAAU,IAAI,UAAU;AAElC,QAAO;;;AAIT,SAAgB,qBACd,QACA,SACA,QACoB;AAGpB,QAFc,4BAA4B,QAAQ,QAAQ,CAAC,IAAI,OAC9C,EAAE,OAAO,MAAM,IAClB,KAAA;;AAGhB,SAAS,mBAAmB,KAAsD;CAChF,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO,EAAE;AAEX,KAAI,QAAQ,SAAS,IAAI,CACvB,QAAO,EAAE,WAAW,SAAS;CAE/B,MAAM,SAAS,QAAQ,WAAW,IAAI,GAAG,QAAQ,MAAM,EAAE,CAAC,MAAM,GAAG;AACnE,QAAO,SAAS,EAAE,QAAQ,GAAG,EAAE;;;;;;AAOjC,SAAgB,gBAAgB,QAAgB,SAAiB,KAAqB;CACpF,MAAM,EAAE,WAAW,WAAW,mBAAmB,IAAI;AACrD,KAAI,WAAW;AACb,MAAI,CAAC,cAAc,UAAU,CAC3B,OAAM,IAAI,MAAM,iDAAiD,UAAU,IAAI;AAEjF,SAAO;;AAET,KAAI,QAAQ;EACV,MAAM,WAAW,qBAAqB,QAAQ,SAAS,OAAO;AAC9D,MAAI,SACF,QAAO;EAET,MAAM,YAAY,CAAC,GAAG,4BAA4B,QAAQ,QAAQ,CAAC,MAAM,CAAC;EAC1E,MAAM,OACJ,UAAU,SAAS,IAAI,gBAAgB,UAAU,KAAK,KAAK,CAAC,KAAK;AACnE,QAAM,IAAI,MAAM,2BAA2B,OAAO,eAAe,QAAQ,GAAG,OAAO;;AAErF,OAAM,IAAI,MAAM,8BAA8B"}
+{"version":3,"file":"agent-typed-models.js","names":[],"sources":["../../../src/config/agent-typed-models.ts"],"sourcesContent":["/**\n * Named model roles from `agents.defaults.models.roles` plus per-agent overrides.\n */\n\nimport type { AgentTypedModel, Config } from './schema.js';\nimport { parseModelRef } from './schema.js';\nimport { listAgentEntries, normalizeAgentId } from '../agent/agent-scope.js';\n\nexport type { AgentTypedModel };\n\nfunction rolesToEntries(\n  roles: Record<string, { model: string; description?: string }> | undefined,\n): AgentTypedModel[] {\n  return Object.entries(roles ?? {}).map(([id, role]) => ({\n    id,\n    ...role,\n  }));\n}\n\nexport function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel> {\n  const out = new Map<string, AgentTypedModel>();\n  for (const modelRole of rolesToEntries(config.agents?.defaults?.models?.roles)) {\n    out.set(modelRole.id, modelRole);\n  }\n  const id = normalizeAgentId(agentId);\n  const entry = listAgentEntries(config).find(\n    (candidate) => candidate.enabled !== false && normalizeAgentId(candidate.id) === id,\n  );\n  for (const modelRole of rolesToEntries(entry?.models?.roles)) {\n    out.set(modelRole.id, modelRole);\n  }\n  return out;\n}\n\n/** Resolve a typed model id to `provider/model`, or undefined when not configured. */\nexport function resolveTypedModelRef(\n  config: Config,\n  agentId: string,\n  typeId: string,\n): string | undefined {\n  const entry = resolveEffectiveTypedModels(config, agentId).get(typeId);\n  const ref = entry?.model?.trim();\n  return ref || undefined;\n}\n\nfunction parseModelRefInput(ref: string): { directRef?: string; typeId?: string } {\n  const trimmed = ref.trim();\n  if (!trimmed) {\n    return {};\n  }\n  if (trimmed.includes('/')) {\n    return { directRef: trimmed };\n  }\n  const typeId = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n  return typeId ? { typeId } : {};\n}\n\n/**\n * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.\n * Throws when the ref is invalid or the typed id is unknown.\n */\nexport function resolveModelRef(config: Config, agentId: string, ref: string): string {\n  const { directRef, typeId } = parseModelRefInput(ref);\n  if (directRef) {\n    if (!parseModelRef(directRef)) {\n      throw new Error(`model ref must be provider/model format (got '${directRef}')`);\n    }\n    return directRef;\n  }\n  if (typeId) {\n    const resolved = resolveTypedModelRef(config, agentId, typeId);\n    if (resolved) {\n      return resolved;\n    }\n    const available = [...resolveEffectiveTypedModels(config, agentId).keys()];\n    const hint =\n      available.length > 0 ? ` (available: ${available.join(', ')})` : ' (none configured)';\n    throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);\n  }\n  throw new Error('model ref must not be empty');\n}\n"],"mappings":";;;aAK4C;kBACiC;AAI7E,SAAS,eACP,OACmB;AACnB,QAAO,OAAO,QAAQ,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,WAAW;EACtD;EACA,GAAG;EACJ,EAAE;;AAGL,SAAgB,4BAA4B,QAAgB,SAA+C;CACzG,MAAM,sBAAM,IAAI,KAA8B;AAC9C,MAAK,MAAM,aAAa,eAAe,OAAO,QAAQ,UAAU,QAAQ,MAAM,CAC5E,KAAI,IAAI,UAAU,IAAI,UAAU;CAElC,MAAM,KAAK,iBAAiB,QAAQ;CACpC,MAAM,QAAQ,iBAAiB,OAAO,CAAC,MACpC,cAAc,UAAU,YAAY,SAAS,iBAAiB,UAAU,GAAG,KAAK,GAClF;AACD,MAAK,MAAM,aAAa,eAAe,OAAO,QAAQ,MAAM,CAC1D,KAAI,IAAI,UAAU,IAAI,UAAU;AAElC,QAAO;;;AAIT,SAAgB,qBACd,QACA,SACA,QACoB;AAGpB,QAFc,4BAA4B,QAAQ,QAAQ,CAAC,IAAI,OAC9C,EAAE,OAAO,MAAM,IAClB,KAAA;;AAGhB,SAAS,mBAAmB,KAAsD;CAChF,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO,EAAE;AAEX,KAAI,QAAQ,SAAS,IAAI,CACvB,QAAO,EAAE,WAAW,SAAS;CAE/B,MAAM,SAAS,QAAQ,WAAW,IAAI,GAAG,QAAQ,MAAM,EAAE,CAAC,MAAM,GAAG;AACnE,QAAO,SAAS,EAAE,QAAQ,GAAG,EAAE;;;;;;AAOjC,SAAgB,gBAAgB,QAAgB,SAAiB,KAAqB;CACpF,MAAM,EAAE,WAAW,WAAW,mBAAmB,IAAI;AACrD,KAAI,WAAW;AACb,MAAI,CAAC,cAAc,UAAU,CAC3B,OAAM,IAAI,MAAM,iDAAiD,UAAU,IAAI;AAEjF,SAAO;;AAET,KAAI,QAAQ;EACV,MAAM,WAAW,qBAAqB,QAAQ,SAAS,OAAO;AAC9D,MAAI,SACF,QAAO;EAET,MAAM,YAAY,CAAC,GAAG,4BAA4B,QAAQ,QAAQ,CAAC,MAAM,CAAC;EAC1E,MAAM,OACJ,UAAU,SAAS,IAAI,gBAAgB,UAAU,KAAK,KAAK,CAAC,KAAK;AACnE,QAAM,IAAI,MAAM,2BAA2B,OAAO,eAAe,QAAQ,GAAG,OAAO;;AAErF,OAAM,IAAI,MAAM,8BAA8B"}

package/dist/src/config/index.js

@@ -5,8 +5,8 @@ import { resolveAgentDir as resolveAgentDir$1, resolveAgentHomeDir as resolveAge
 import { FILENAMES, WORKSPACE_FILES, existsSync, init_paths, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentHomeDir, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath } from "./paths.js";
 import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema } from "../../extensions/telegram/src/config-schema.js";
 import { WeixinAccountConfigSchema, WeixinConfigSchema } from "../../extensions/weixin/src/config-schema.js";
-import { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentTypedModelSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
-import { init_loader, loadConfig, registerChannelConfigValidator, saveConfig } from "./loader.js";
+import { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
+import { init_loader, loadConfig, 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";
@@ -27,6 +27,6 @@ init_workspace_path();
 init_models_json();
 init_resolve_config_value();
 //#endregion
-export { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentTypedModelSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigHotReloader, ConfigSchema, CronConfigSchema, CustomModelSchema, ENV_VARS, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelOverrideSchema, ModelsDevConfigSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProfileManager, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VercelGatewayRoutingSchema, WORKSPACE_FILES, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, XOPC_DB_FILENAME, applyConfigOverrides, buildReloadPlan, canonicalizeConfiguredMcpServer, clearConfigValueCache, createProfile, deleteProfile, diffConfigPaths, existsSync, expandWorkspacePathString, extractProfileAgentId, formatThinkingLevels, getAgentDefaultModelRef, getAllowedCommands, getCacheStats, getConfigOverrides, getCurrentProfile, getDefaultModelValues, resolveModelsJsonPath as getModelsJsonPath, getProfileManager, getProfileNameFromDir, getSwitchCommand, getWorkspacePath, isKnownCliMcpTypeAlias, listAgentProfileMarkdownDirs, listAgentWorkspaceDirs, listProfiles, listThinkingLevels, loadConfig, loadModelsJson, matchReloadRule, modelsJsonExists, normalizeConfiguredMcpServers, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, normalizeWorkspaceDir, parseModelRef, registerChannelConfigValidator, resetConfigOverrides, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveConfigValue, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveDefaultAgentWorkspaceDir, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHeaders, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveProfileStateDir, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceRoot, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, resolveXopcDatabasePath, resolveXopcMcpTransportAlias, saveConfig, saveModelsJson, setConfigOverride, testApiKeyResolution, thinkLevelToNumber, unsetConfigOverride, validateModelsConfig };
+export { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigHotReloader, ConfigSchema, CronConfigSchema, CustomModelSchema, ENV_VARS, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelOverrideSchema, ModelsDevConfigSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProfileManager, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VercelGatewayRoutingSchema, WORKSPACE_FILES, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, XOPC_DB_FILENAME, applyConfigOverrides, buildReloadPlan, canonicalizeConfiguredMcpServer, clearConfigValueCache, createProfile, deleteProfile, diffConfigPaths, existsSync, expandWorkspacePathString, extractProfileAgentId, formatThinkingLevels, getAgentDefaultModelRef, getAllowedCommands, getCacheStats, getConfigOverrides, getCurrentProfile, getDefaultModelValues, resolveModelsJsonPath as getModelsJsonPath, getProfileManager, getProfileNameFromDir, getSwitchCommand, getWorkspacePath, isKnownCliMcpTypeAlias, listAgentProfileMarkdownDirs, listAgentWorkspaceDirs, listProfiles, listThinkingLevels, loadConfig, loadModelsJson, matchReloadRule, modelsJsonExists, normalizeConfiguredMcpServers, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, normalizeWorkspaceDir, parseModelRef, resetConfigOverrides, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveConfigValue, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveDefaultAgentWorkspaceDir, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHeaders, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveProfileStateDir, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceRoot, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, resolveXopcDatabasePath, resolveXopcMcpTransportAlias, saveConfig, saveModelsJson, setConfigOverride, testApiKeyResolution, thinkLevelToNumber, unsetConfigOverride, validateModelsConfig };
 
 //# sourceMappingURL=index.js.map

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

@@ -1,7 +1,7 @@
 /**
  * Model-related configuration (documentation only):
  *
- * - Main config: `ConfigSchema` (agents.defaults.model, gateway, channels, etc.).
+ * - Main config: `ConfigSchema` (agents.defaults.models, gateway, channels, etc.).
  * - LLM API keys: `CredentialResolver` / auth profiles (Gateway PATCH /api/config `providers`, CLI onboard).
  * - Overrides and custom providers: `~/.xopc/models.json`.
  */

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

@@ -1,5 +1,4 @@
 import { type Config } from './schema.js';
-export declare function registerChannelConfigValidator(fn: (cfg: Config) => void): void;
 /**
  * Load configuration from file
  * @param configPath Optional custom config path, defaults to XOPC_CONFIG_PATH or ~/.xopc/xopc.json

package/dist/src/config/loader.js

@@ -4,16 +4,11 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveConfigPath } from "./paths.js";
 import { ConfigSchema, init_schema } from "./schema.js";
+import { assertChannelPluginConfigs, init_validate_channel_configs } from "./validate-channel-configs.js";
 import { dirname } from "path";
 import { existsSync, mkdirSync, promises, readFileSync } from "fs";
 import { config } from "dotenv";
 //#region src/config/loader.ts
-function registerChannelConfigValidator(fn) {
-	channelConfigValidator = fn;
-}
-function assertChannelPluginConfigs(cfg) {
-	channelConfigValidator?.(cfg);
-}
 /**
 * Rotate config backups before writing new config.
 * Creates a backup chain: xopc.json.bak, xopc.json.bak.1, xopc.json.bak.2, etc.
@@ -78,18 +73,18 @@ async function saveConfig(config, configPath) {
 	}
 	await writeTextAtomic(path, content);
 }
-var log, channelConfigValidator, CONFIG_BACKUP_COUNT;
+var log, CONFIG_BACKUP_COUNT;
 var init_loader = __esmMin((() => {
 	init_write_file_atomic();
 	init_schema();
 	init_paths();
 	init_logger();
+	init_validate_channel_configs();
 	log = createLogger("ConfigLoader");
-	channelConfigValidator = null;
 	CONFIG_BACKUP_COUNT = 10;
 }));
 //#endregion
 init_loader();
-export { init_loader, loadConfig, registerChannelConfigValidator, resolveConfigPath, saveConfig };
+export { init_loader, loadConfig, resolveConfigPath, saveConfig };
 
 //# sourceMappingURL=loader.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"loader.js","names":["fsPromises"],"sources":["../../../src/config/loader.ts"],"sourcesContent":["import { readFileSync, existsSync, mkdirSync, promises as fsPromises } from 'fs';\nimport { dirname } from 'path';\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { type Config, ConfigSchema } from './schema.js';\nimport { resolveConfigPath } from './paths.js';\nimport { config } from 'dotenv';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('ConfigLoader');\n\n/**\n * Optional channel config validator injected at startup to avoid a circular\n * dependency: loader → validate-channel-configs → bundled-channel-plugins →\n * telegram/command-handler → providers → sync-provider-auth → loader.\n *\n * Call {@link registerChannelConfigValidator} once during application startup\n * (after all channel plugins are loaded) to enable validation.\n */\nlet channelConfigValidator: ((cfg: Config) => void) | null = null;\n\nexport function registerChannelConfigValidator(fn: (cfg: Config) => void): void {\n  channelConfigValidator = fn;\n}\n\nfunction assertChannelPluginConfigs(cfg: Config): void {\n  channelConfigValidator?.(cfg);\n}\n\n/** Number of backup files to keep */\nconst CONFIG_BACKUP_COUNT = 10;\n\n/**\n * Rotate config backups before writing new config.\n * Creates a backup chain: xopc.json.bak, xopc.json.bak.1, xopc.json.bak.2, etc.\n */\nasync function rotateConfigBackups(configPath: string): Promise<void> {\n  if (CONFIG_BACKUP_COUNT <= 1) {\n    return;\n  }\n\n  const backupBase = `${configPath}.bak`;\n  const maxIndex = CONFIG_BACKUP_COUNT - 1;\n\n  // Delete oldest backup\n  try {\n    await fsPromises.unlink(`${backupBase}.${maxIndex}`);\n  } catch {\n    // best-effort: file may not exist\n  }\n\n  // Rotate existing backups: .bak.2 -> .bak.3, .bak.1 -> .bak.2, etc.\n  for (let index = maxIndex - 1; index >= 1; index--) {\n    try {\n      await fsPromises.rename(`${backupBase}.${index}`, `${backupBase}.${index + 1}`);\n    } catch {\n      // best-effort: file may not exist\n    }\n  }\n\n  // Move .bak to .bak.1\n  try {\n    await fsPromises.rename(backupBase, `${backupBase}.1`);\n  } catch {\n    // best-effort: file may not exist\n  }\n}\n\n/**\n * Load configuration from file\n * @param configPath Optional custom config path, defaults to XOPC_CONFIG_PATH or ~/.xopc/xopc.json\n */\nexport function loadConfig(configPath?: string): Config {\n  // dotenv ≥17 logs to stdout on every `config()` unless quiet; `loadConfig` runs from many call sites.\n  config({ quiet: true });\n\n  const path = configPath || process.env.XOPC_CONFIG_PATH || resolveConfigPath();\n\n  if (existsSync(path)) {\n    try {\n      const content = readFileSync(path, 'utf-8');\n      const json = JSON.parse(content);\n      const cfg = ConfigSchema.parse(json);\n      assertChannelPluginConfigs(cfg);\n      return cfg;\n    } catch (error) {\n      log.error({ err: error, path }, `Failed to load config`);\n      const cfg = ConfigSchema.parse(undefined);\n      assertChannelPluginConfigs(cfg);\n      return cfg;\n    }\n  }\n\n  const cfg = ConfigSchema.parse(undefined);\n  assertChannelPluginConfigs(cfg);\n  return cfg;\n}\n\n/**\n * Save configuration to file\n * @param config Configuration object to save\n * @param configPath Optional custom config path\n */\nexport async function saveConfig(config: Config, configPath?: string): Promise<void> {\n  const path = configPath || process.env.XOPC_CONFIG_PATH || resolveConfigPath();\n\n  const dir = dirname(path);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const validated = ConfigSchema.parse(config);\n  assertChannelPluginConfigs(validated);\n  const content = JSON.stringify(validated, null, 2);\n\n  // Backup existing config before writing\n  if (existsSync(path)) {\n    await rotateConfigBackups(path);\n    try {\n      // Copy current config to .bak as the latest backup\n      await fsPromises.copyFile(path, `${path}.bak`);\n    } catch {\n      // best-effort: backup copy may fail\n    }\n  }\n\n  await writeTextAtomic(path, content);\n}\n\nexport { resolveConfigPath } from './paths.js';\n"],"mappings":";;;;;;;;;;AAoBA,SAAgB,+BAA+B,IAAiC;AAC9E,0BAAyB;;AAG3B,SAAS,2BAA2B,KAAmB;AACrD,0BAAyB,IAAI;;;;;;AAU/B,eAAe,oBAAoB,YAAmC;AACpE,KAAI,uBAAuB,EACzB;CAGF,MAAM,aAAa,GAAG,WAAW;CACjC,MAAM,WAAW,sBAAsB;AAGvC,KAAI;AACF,QAAMA,SAAW,OAAO,GAAG,WAAW,GAAG,WAAW;SAC9C;AAKR,MAAK,IAAI,QAAQ,WAAW,GAAG,SAAS,GAAG,QACzC,KAAI;AACF,QAAMA,SAAW,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,IAAI;SACzE;AAMV,KAAI;AACF,QAAMA,SAAW,OAAO,YAAY,GAAG,WAAW,IAAI;SAChD;;;;;;AASV,SAAgB,WAAW,YAA6B;AAEtD,QAAO,EAAE,OAAO,MAAM,CAAC;CAEvB,MAAM,OAAO,cAAc,QAAQ,IAAI,oBAAoB,mBAAmB;AAE9E,KAAI,WAAW,KAAK,CAClB,KAAI;EACF,MAAM,UAAU,aAAa,MAAM,QAAQ;EAC3C,MAAM,OAAO,KAAK,MAAM,QAAQ;EAChC,MAAM,MAAM,aAAa,MAAM,KAAK;AACpC,6BAA2B,IAAI;AAC/B,SAAO;UACA,OAAO;AACd,MAAI,MAAM;GAAE,KAAK;GAAO;GAAM,EAAE,wBAAwB;EACxD,MAAM,MAAM,aAAa,MAAM,KAAA,EAAU;AACzC,6BAA2B,IAAI;AAC/B,SAAO;;CAIX,MAAM,MAAM,aAAa,MAAM,KAAA,EAAU;AACzC,4BAA2B,IAAI;AAC/B,QAAO;;;;;;;AAQT,eAAsB,WAAW,QAAgB,YAAoC;CACnF,MAAM,OAAO,cAAc,QAAQ,IAAI,oBAAoB,mBAAmB;CAE9E,MAAM,MAAM,QAAQ,KAAK;AACzB,KAAI,CAAC,WAAW,IAAI,CAClB,WAAU,KAAK,EAAE,WAAW,MAAM,CAAC;CAGrC,MAAM,YAAY,aAAa,MAAM,OAAO;AAC5C,4BAA2B,UAAU;CACrC,MAAM,UAAU,KAAK,UAAU,WAAW,MAAM,EAAE;AAGlD,KAAI,WAAW,KAAK,EAAE;AACpB,QAAM,oBAAoB,KAAK;AAC/B,MAAI;AAEF,SAAMA,SAAW,SAAS,MAAM,GAAG,KAAK,MAAM;UACxC;;AAKV,OAAM,gBAAgB,MAAM,QAAQ;;;;yBA3H0B;cACR;aACT;cAEG;AAE5C,OAAM,aAAa,eAAe;AAUpC,0BAAyD;AAWvD,uBAAsB"}
+{"version":3,"file":"loader.js","names":["fsPromises"],"sources":["../../../src/config/loader.ts"],"sourcesContent":["import { readFileSync, existsSync, mkdirSync, promises as fsPromises } from 'fs';\nimport { dirname } from 'path';\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { type Config, ConfigSchema } from './schema.js';\nimport { resolveConfigPath } from './paths.js';\nimport { config } from 'dotenv';\nimport { createLogger } from '../utils/logger.js';\nimport { assertChannelPluginConfigs } from './validate-channel-configs.js';\n\nconst log = createLogger('ConfigLoader');\n\n/** Number of backup files to keep */\nconst CONFIG_BACKUP_COUNT = 10;\n\n/**\n * Rotate config backups before writing new config.\n * Creates a backup chain: xopc.json.bak, xopc.json.bak.1, xopc.json.bak.2, etc.\n */\nasync function rotateConfigBackups(configPath: string): Promise<void> {\n  if (CONFIG_BACKUP_COUNT <= 1) {\n    return;\n  }\n\n  const backupBase = `${configPath}.bak`;\n  const maxIndex = CONFIG_BACKUP_COUNT - 1;\n\n  // Delete oldest backup\n  try {\n    await fsPromises.unlink(`${backupBase}.${maxIndex}`);\n  } catch {\n    // best-effort: file may not exist\n  }\n\n  // Rotate existing backups: .bak.2 -> .bak.3, .bak.1 -> .bak.2, etc.\n  for (let index = maxIndex - 1; index >= 1; index--) {\n    try {\n      await fsPromises.rename(`${backupBase}.${index}`, `${backupBase}.${index + 1}`);\n    } catch {\n      // best-effort: file may not exist\n    }\n  }\n\n  // Move .bak to .bak.1\n  try {\n    await fsPromises.rename(backupBase, `${backupBase}.1`);\n  } catch {\n    // best-effort: file may not exist\n  }\n}\n\n/**\n * Load configuration from file\n * @param configPath Optional custom config path, defaults to XOPC_CONFIG_PATH or ~/.xopc/xopc.json\n */\nexport function loadConfig(configPath?: string): Config {\n  // dotenv ≥17 logs to stdout on every `config()` unless quiet; `loadConfig` runs from many call sites.\n  config({ quiet: true });\n\n  const path = configPath || process.env.XOPC_CONFIG_PATH || resolveConfigPath();\n\n  if (existsSync(path)) {\n    try {\n      const content = readFileSync(path, 'utf-8');\n      const json = JSON.parse(content);\n      const cfg = ConfigSchema.parse(json);\n      assertChannelPluginConfigs(cfg);\n      return cfg;\n    } catch (error) {\n      log.error({ err: error, path }, `Failed to load config`);\n      const cfg = ConfigSchema.parse(undefined);\n      assertChannelPluginConfigs(cfg);\n      return cfg;\n    }\n  }\n\n  const cfg = ConfigSchema.parse(undefined);\n  assertChannelPluginConfigs(cfg);\n  return cfg;\n}\n\n/**\n * Save configuration to file\n * @param config Configuration object to save\n * @param configPath Optional custom config path\n */\nexport async function saveConfig(config: Config, configPath?: string): Promise<void> {\n  const path = configPath || process.env.XOPC_CONFIG_PATH || resolveConfigPath();\n\n  const dir = dirname(path);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const validated = ConfigSchema.parse(config);\n  assertChannelPluginConfigs(validated);\n  const content = JSON.stringify(validated, null, 2);\n\n  // Backup existing config before writing\n  if (existsSync(path)) {\n    await rotateConfigBackups(path);\n    try {\n      // Copy current config to .bak as the latest backup\n      await fsPromises.copyFile(path, `${path}.bak`);\n    } catch {\n      // best-effort: backup copy may fail\n    }\n  }\n\n  await writeTextAtomic(path, content);\n}\n\nexport { resolveConfigPath } from './paths.js';\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,eAAe,oBAAoB,YAAmC;AACpE,KAAI,uBAAuB,EACzB;CAGF,MAAM,aAAa,GAAG,WAAW;CACjC,MAAM,WAAW,sBAAsB;AAGvC,KAAI;AACF,QAAMA,SAAW,OAAO,GAAG,WAAW,GAAG,WAAW;SAC9C;AAKR,MAAK,IAAI,QAAQ,WAAW,GAAG,SAAS,GAAG,QACzC,KAAI;AACF,QAAMA,SAAW,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,IAAI;SACzE;AAMV,KAAI;AACF,QAAMA,SAAW,OAAO,YAAY,GAAG,WAAW,IAAI;SAChD;;;;;;AASV,SAAgB,WAAW,YAA6B;AAEtD,QAAO,EAAE,OAAO,MAAM,CAAC;CAEvB,MAAM,OAAO,cAAc,QAAQ,IAAI,oBAAoB,mBAAmB;AAE9E,KAAI,WAAW,KAAK,CAClB,KAAI;EACF,MAAM,UAAU,aAAa,MAAM,QAAQ;EAC3C,MAAM,OAAO,KAAK,MAAM,QAAQ;EAChC,MAAM,MAAM,aAAa,MAAM,KAAK;AACpC,6BAA2B,IAAI;AAC/B,SAAO;UACA,OAAO;AACd,MAAI,MAAM;GAAE,KAAK;GAAO;GAAM,EAAE,wBAAwB;EACxD,MAAM,MAAM,aAAa,MAAM,KAAA,EAAU;AACzC,6BAA2B,IAAI;AAC/B,SAAO;;CAIX,MAAM,MAAM,aAAa,MAAM,KAAA,EAAU;AACzC,4BAA2B,IAAI;AAC/B,QAAO;;;;;;;AAQT,eAAsB,WAAW,QAAgB,YAAoC;CACnF,MAAM,OAAO,cAAc,QAAQ,IAAI,oBAAoB,mBAAmB;CAE9E,MAAM,MAAM,QAAQ,KAAK;AACzB,KAAI,CAAC,WAAW,IAAI,CAClB,WAAU,KAAK,EAAE,WAAW,MAAM,CAAC;CAGrC,MAAM,YAAY,aAAa,MAAM,OAAO;AAC5C,4BAA2B,UAAU;CACrC,MAAM,UAAU,KAAK,UAAU,WAAW,MAAM,EAAE;AAGlD,KAAI,WAAW,KAAK,EAAE;AACpB,QAAM,oBAAoB,KAAK;AAC/B,MAAI;AAEF,SAAMA,SAAW,SAAS,MAAM,GAAG,KAAK,MAAM;UACxC;;AAKV,OAAM,gBAAgB,MAAM,QAAQ;;;;yBA1G0B;cACR;aACT;cAEG;gCACyB;AAErE,OAAM,aAAa,eAAe;AAGlC,uBAAsB"}

package/dist/src/config/models-json.d.ts

@@ -88,8 +88,8 @@ export declare const CustomModelSchema: z.ZodObject<{
     }>>;
     reasoning: z.ZodOptional<z.ZodBoolean>;
     input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        text: "text";
         image: "image";
+        text: "text";
     }>>>;
     contextWindow: z.ZodOptional<z.ZodNumber>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -133,8 +133,8 @@ export declare const ModelOverrideSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodBoolean>;
     input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        text: "text";
         image: "image";
+        text: "text";
     }>>>;
     contextWindow: z.ZodOptional<z.ZodNumber>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -206,8 +206,8 @@ export declare const ProviderConfigSchema: z.ZodObject<{
         }>>;
         reasoning: z.ZodOptional<z.ZodBoolean>;
         input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            text: "text";
             image: "image";
+            text: "text";
         }>>>;
         contextWindow: z.ZodOptional<z.ZodNumber>;
         maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -251,8 +251,8 @@ export declare const ProviderConfigSchema: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         reasoning: z.ZodOptional<z.ZodBoolean>;
         input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            text: "text";
             image: "image";
+            text: "text";
         }>>>;
         contextWindow: z.ZodOptional<z.ZodNumber>;
         maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -326,8 +326,8 @@ export declare const ModelsJsonSchema: z.ZodObject<{
             }>>;
             reasoning: z.ZodOptional<z.ZodBoolean>;
             input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                text: "text";
                 image: "image";
+                text: "text";
             }>>>;
             contextWindow: z.ZodOptional<z.ZodNumber>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -371,8 +371,8 @@ export declare const ModelsJsonSchema: z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             reasoning: z.ZodOptional<z.ZodBoolean>;
             input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                text: "text";
                 image: "image";
+                text: "text";
             }>>>;
             contextWindow: z.ZodOptional<z.ZodNumber>;
             maxTokens: z.ZodOptional<z.ZodNumber>;

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

@@ -183,6 +183,7 @@ export declare function resolveSkillsCachePath(config: Config, agentId: string):
  * Resolve the bundled extensions directory (shipped with xopc).
  *
  * Layout-dependent candidates (first existing wins):
+ * - `XOPC_BUNDLED_EXTENSIONS_ROOT` (Electron packaged gateway override)
  * - `dist/src/config` → `dist/extensions` (npm / gateway)
  * - `src/config` → `extensions/` (dev, tsx)
  * - `out/server` → `dist/extensions` (Electron esbuild bundle)