@xopcai/xopc 0.0.116 → 0.0.118

package/dist/src/cli/registry.js

@@ -5,7 +5,7 @@ init_paths();
 init_workspace_defaults();
 function createDefaultContext(argv = process.argv, opts) {
 	return {
-		configPath: opts?.config || process.env.XOPC_CONFIG || resolveConfigPath(),
+		configPath: opts?.config || process.env.XOPC_CONFIG || process.env.XOPC_CONFIG_PATH || resolveConfigPath(),
 		workspacePath: opts?.workspace || process.env.XOPC_WORKSPACE || resolveDefaultAgentWorkspaceDir(),
 		isVerbose: opts?.verbose ?? (argv.includes("--verbose") || argv.includes("-v")),
 		argv

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

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../../../src/cli/registry.ts"],"sourcesContent":["import type { Command } from 'commander';\nimport { resolveConfigPath } from '../config/paths.js';\nimport { resolveDefaultAgentWorkspaceDir } from '../config/workspace-defaults.js';\n\nexport interface CLIContext {\n  configPath: string;\n  workspacePath: string;\n  isVerbose: boolean;\n  argv: string[];\n}\n\nexport function createDefaultContext(\n  argv: string[] = process.argv,\n  opts?: { config?: string; workspace?: string; verbose?: boolean }\n): CLIContext {\n  return {\n    configPath: opts?.config || process.env.XOPC_CONFIG || resolveConfigPath(),\n    workspacePath: opts?.workspace || process.env.XOPC_WORKSPACE || resolveDefaultAgentWorkspaceDir(),\n    isVerbose: (opts?.verbose ?? (argv.includes('--verbose') || argv.includes('-v'))),\n    argv,\n  };\n}\n\nexport interface CommandMetadata {\n  category?: 'setup' | 'runtime' | 'maintenance' | 'utility';\n  hidden?: boolean;\n  unstable?: boolean;\n  examples?: string[];\n}\n\nexport interface CommandDefinition {\n  id: string;\n  name: string;\n  description: string;\n  factory: (ctx: CLIContext, getCtx?: () => CLIContext) => Command;\n  metadata?: CommandMetadata;\n}\n\nexport class CommandRegistry {\n  private commands: CommandDefinition[] = [];\n  private initialized = false;\n  private suppressLateRegistrationWarnings = false;\n\n  /**\n   * Temporarily silence the \"registered after initialization\" warning. Used by\n   * commands that need to bulk-load other command modules to harvest their\n   * side effects during initialization.\n   */\n  setSuppressLateRegistrationWarnings(value: boolean): void {\n    this.suppressLateRegistrationWarnings = value;\n  }\n\n  register(def: CommandDefinition): void {\n    if (this.initialized && !this.suppressLateRegistrationWarnings) {\n      console.warn(`Warning: Command \"${def.id}\" registered after initialization`);\n    }\n\n    const existing = this.commands.find(c => c.id === def.id);\n    if (existing) {\n      throw new Error(`Command with id \"${def.id}\" already registered (name: ${existing.name})`);\n    }\n\n    const existingName = this.commands.find(c => c.name === def.name);\n    if (existingName) {\n      throw new Error(`Command with name \"${def.name}\" already registered (id: ${existingName.id})`);\n    }\n\n    this.commands.push(def);\n  }\n\n  registerAll(defs: CommandDefinition[]): void {\n    for (const def of defs) {\n      this.register(def);\n    }\n  }\n\n  getCommands(): ReadonlyArray<CommandDefinition> {\n    return this.commands;\n  }\n\n  getCommandsByCategory(category: CommandMetadata['category']): ReadonlyArray<CommandDefinition> {\n    return this.commands.filter(c => c.metadata?.category === category);\n  }\n\n  findById(id: string): CommandDefinition | undefined {\n    return this.commands.find(c => c.id === id);\n  }\n\n  findByName(name: string): CommandDefinition | undefined {\n    return this.commands.find(c => c.name === name);\n  }\n\n  install(program: Command, ctx: CLIContext, getCtx?: () => CLIContext): void {\n    this.initialized = true;\n\n    const categoryOrder = { setup: 0, runtime: 1, maintenance: 2, utility: 3 };\n    const sorted = [...this.commands].sort((a, b) => {\n      const orderA = categoryOrder[a.metadata?.category ?? 'utility'];\n      const orderB = categoryOrder[b.metadata?.category ?? 'utility'];\n      return orderA - orderB;\n    });\n\n    for (const def of sorted) {\n      if (def.metadata?.hidden) continue;\n\n      try {\n        const cmd = def.factory(ctx, getCtx);\n        program.addCommand(cmd);\n      } catch (error) {\n        console.error(`Failed to register command \"${def.id}\":`, error);\n      }\n    }\n  }\n\n  installOne(\n    program: Command,\n    name: string,\n    ctx: CLIContext,\n    getCtx?: () => CLIContext,\n  ): boolean {\n    this.initialized = true;\n    const def = this.findByName(name);\n    if (!def || def.metadata?.hidden) return false;\n    try {\n      const cmd = def.factory(ctx, getCtx);\n      program.addCommand(cmd);\n      return true;\n    } catch (error) {\n      console.error(`Failed to register command \"${def.id}\":`, error);\n      return false;\n    }\n  }\n\n  getStats(): { total: number; byCategory: Record<string, number> } {\n    const byCategory: Record<string, number> = {};\n    for (const cmd of this.commands) {\n      const cat = cmd.metadata?.category ?? 'uncategorized';\n      byCategory[cat] = (byCategory[cat] || 0) + 1;\n    }\n    return { total: this.commands.length, byCategory };\n  }\n}\n\nexport const registry = new CommandRegistry();\n\nexport function register(def: CommandDefinition): void {\n  registry.register(def);\n}\n\nexport function formatExamples(examples: string[]): string {\n  if (examples.length === 0) return '';\n  return '\\nExamples:\\n' + examples.map(e => `  $ ${e}`).join('\\n');\n}\n"],"mappings":"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"}
+{"version":3,"file":"registry.js","names":[],"sources":["../../../src/cli/registry.ts"],"sourcesContent":["import type { Command } from 'commander';\nimport { resolveConfigPath } from '../config/paths.js';\nimport { resolveDefaultAgentWorkspaceDir } from '../config/workspace-defaults.js';\n\nexport interface CLIContext {\n  configPath: string;\n  workspacePath: string;\n  isVerbose: boolean;\n  argv: string[];\n}\n\nexport function createDefaultContext(\n  argv: string[] = process.argv,\n  opts?: { config?: string; workspace?: string; verbose?: boolean }\n): CLIContext {\n  return {\n    configPath: opts?.config || process.env.XOPC_CONFIG || process.env.XOPC_CONFIG_PATH || resolveConfigPath(),\n    workspacePath: opts?.workspace || process.env.XOPC_WORKSPACE || resolveDefaultAgentWorkspaceDir(),\n    isVerbose: (opts?.verbose ?? (argv.includes('--verbose') || argv.includes('-v'))),\n    argv,\n  };\n}\n\nexport interface CommandMetadata {\n  category?: 'setup' | 'runtime' | 'maintenance' | 'utility';\n  hidden?: boolean;\n  unstable?: boolean;\n  examples?: string[];\n}\n\nexport interface CommandDefinition {\n  id: string;\n  name: string;\n  description: string;\n  factory: (ctx: CLIContext, getCtx?: () => CLIContext) => Command;\n  metadata?: CommandMetadata;\n}\n\nexport class CommandRegistry {\n  private commands: CommandDefinition[] = [];\n  private initialized = false;\n  private suppressLateRegistrationWarnings = false;\n\n  /**\n   * Temporarily silence the \"registered after initialization\" warning. Used by\n   * commands that need to bulk-load other command modules to harvest their\n   * side effects during initialization.\n   */\n  setSuppressLateRegistrationWarnings(value: boolean): void {\n    this.suppressLateRegistrationWarnings = value;\n  }\n\n  register(def: CommandDefinition): void {\n    if (this.initialized && !this.suppressLateRegistrationWarnings) {\n      console.warn(`Warning: Command \"${def.id}\" registered after initialization`);\n    }\n\n    const existing = this.commands.find(c => c.id === def.id);\n    if (existing) {\n      throw new Error(`Command with id \"${def.id}\" already registered (name: ${existing.name})`);\n    }\n\n    const existingName = this.commands.find(c => c.name === def.name);\n    if (existingName) {\n      throw new Error(`Command with name \"${def.name}\" already registered (id: ${existingName.id})`);\n    }\n\n    this.commands.push(def);\n  }\n\n  registerAll(defs: CommandDefinition[]): void {\n    for (const def of defs) {\n      this.register(def);\n    }\n  }\n\n  getCommands(): ReadonlyArray<CommandDefinition> {\n    return this.commands;\n  }\n\n  getCommandsByCategory(category: CommandMetadata['category']): ReadonlyArray<CommandDefinition> {\n    return this.commands.filter(c => c.metadata?.category === category);\n  }\n\n  findById(id: string): CommandDefinition | undefined {\n    return this.commands.find(c => c.id === id);\n  }\n\n  findByName(name: string): CommandDefinition | undefined {\n    return this.commands.find(c => c.name === name);\n  }\n\n  install(program: Command, ctx: CLIContext, getCtx?: () => CLIContext): void {\n    this.initialized = true;\n\n    const categoryOrder = { setup: 0, runtime: 1, maintenance: 2, utility: 3 };\n    const sorted = [...this.commands].sort((a, b) => {\n      const orderA = categoryOrder[a.metadata?.category ?? 'utility'];\n      const orderB = categoryOrder[b.metadata?.category ?? 'utility'];\n      return orderA - orderB;\n    });\n\n    for (const def of sorted) {\n      if (def.metadata?.hidden) continue;\n\n      try {\n        const cmd = def.factory(ctx, getCtx);\n        program.addCommand(cmd);\n      } catch (error) {\n        console.error(`Failed to register command \"${def.id}\":`, error);\n      }\n    }\n  }\n\n  installOne(\n    program: Command,\n    name: string,\n    ctx: CLIContext,\n    getCtx?: () => CLIContext,\n  ): boolean {\n    this.initialized = true;\n    const def = this.findByName(name);\n    if (!def || def.metadata?.hidden) return false;\n    try {\n      const cmd = def.factory(ctx, getCtx);\n      program.addCommand(cmd);\n      return true;\n    } catch (error) {\n      console.error(`Failed to register command \"${def.id}\":`, error);\n      return false;\n    }\n  }\n\n  getStats(): { total: number; byCategory: Record<string, number> } {\n    const byCategory: Record<string, number> = {};\n    for (const cmd of this.commands) {\n      const cat = cmd.metadata?.category ?? 'uncategorized';\n      byCategory[cat] = (byCategory[cat] || 0) + 1;\n    }\n    return { total: this.commands.length, byCategory };\n  }\n}\n\nexport const registry = new CommandRegistry();\n\nexport function register(def: CommandDefinition): void {\n  registry.register(def);\n}\n\nexport function formatExamples(examples: string[]): string {\n  if (examples.length === 0) return '';\n  return '\\nExamples:\\n' + examples.map(e => `  $ ${e}`).join('\\n');\n}\n"],"mappings":"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"}

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

@@ -3,7 +3,7 @@
  * Templates are stored in docs/reference/templates/ and loaded at runtime.
  */
 /** Profile Markdown template file names (seeded into `agents/<id>/profile/`). */
-export declare const TEMPLATE_FILES: readonly ["SOUL.md", "IDENTITY.md", "USER.md", "TOOLS.md", "AGENTS.md", "HEARTBEAT.md", "MEMORY.md"];
+export declare const TEMPLATE_FILES: readonly ["SOUL.md", "IDENTITY.md", "TOOLS.md", "AGENTS.md", "HEARTBEAT.md", "MEMORY.md"];
 export type TemplateFile = (typeof TEMPLATE_FILES)[number];
 /** Alias for profile Markdown templates used by seed helpers. */
 export declare const PROFILE_MARKDOWN_TEMPLATE_FILES: readonly TemplateFile[];

package/dist/src/cli/templates.js

@@ -1,5 +1,5 @@
-import { existsSync, readFileSync } from "fs";
 import { dirname, join } from "path";
+import { existsSync, readFileSync } from "fs";
 import { fileURLToPath } from "url";
 //#region src/cli/templates.ts
 /**
@@ -11,7 +11,6 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const TEMPLATE_FILES = [
 	"SOUL.md",
 	"IDENTITY.md",
-	"USER.md",
 	"TOOLS.md",
 	"AGENTS.md",
 	"HEARTBEAT.md",
@@ -71,7 +70,7 @@ This folder is home. Treat it that way.
 
 ## Session Startup
 
-Use runtime-provided startup context first. Bootstrap files (SOUL, USER, MEMORY, etc.) are injected by xopc on /new and /reset.
+Use runtime-provided startup context first. Bootstrap files (global user profile, SOUL, MEMORY, etc.) are injected by xopc on /new and /reset.
 
 Do not manually reread startup files unless the user asks or the provided context is incomplete.
 
@@ -116,15 +115,6 @@ _Fill this in during your first conversation._
 - **Creature:**
 - **Vibe:**
 - **Emoji:**
-`,
-		"USER.md": `# USER.md - About Your Human
-
-_Learn about the person you're helping._
-
-- **Name:**
-- **What to call them:**
-- **Timezone:**
-- **Notes:**
 `,
 		"TOOLS.md": `# TOOLS.md - Local Notes
 

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

@@ -1 +1 @@
-{"version":3,"file":"templates.js","names":[],"sources":["../../../src/cli/templates.ts"],"sourcesContent":["/**\n * Workspace template files for onboarding.\n * Templates are stored in docs/reference/templates/ and loaded at runtime.\n */\n\nimport { readFileSync, existsSync } from 'fs';\nimport { join, dirname } from 'path';\nimport { fileURLToPath } from 'url';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n/** Profile Markdown template file names (seeded into `agents/<id>/profile/`). */\nexport const TEMPLATE_FILES = [\n  'SOUL.md',\n  'IDENTITY.md',\n  'USER.md',\n  'TOOLS.md',\n  'AGENTS.md',\n  'HEARTBEAT.md',\n  'MEMORY.md',\n] as const;\n\nexport type TemplateFile = (typeof TEMPLATE_FILES)[number];\n\n/** Alias for profile Markdown templates used by seed helpers. */\nexport const PROFILE_MARKDOWN_TEMPLATE_FILES: readonly TemplateFile[] = [...TEMPLATE_FILES];\n\n/** Template content cache */\nconst templateCache = new Map<TemplateFile, string>();\n\n/**\n * Get the path to template files.\n * Uses environment or looks in project root.\n */\nfunction getTemplatePath(): string {\n  // Use environment to determine path\n  const envPath = process.env.XOPC_TEMPLATE_PATH;\n  if (envPath && existsSync(envPath)) {\n    return envPath;\n  }\n\n  // Default: look in project root docs/reference/templates\n  // Works for both development (src/cli/) and production (dist/cli/)\n  const projectRoot = join(__dirname, '../../..');\n  const defaultPath = join(projectRoot, 'docs/reference/templates');\n  \n  if (existsSync(defaultPath)) {\n    return defaultPath;\n  }\n\n  // Fallback: return default (will fail gracefully)\n  return defaultPath;\n}\n\n/**\n * Load a template file. Caches results for repeated access.\n */\nexport function loadTemplate(name: TemplateFile): string {\n  // Return cached version if available\n  if (templateCache.has(name)) {\n    return templateCache.get(name)!;\n  }\n\n  const templatePath = join(getTemplatePath(), name);\n  \n  try {\n    if (existsSync(templatePath)) {\n      const content = readFileSync(templatePath, 'utf-8');\n      templateCache.set(name, content);\n      return content;\n    }\n  } catch {\n    // Fall through to fallback\n  }\n\n  // Fallback: return minimal default if template is missing\n  console.warn(`Warning: Template ${name} not found, using fallback`);\n  return getFallbackTemplate(name);\n}\n\n/**\n * Load all templates as a record.\n */\nexport function loadAllTemplates(): Record<TemplateFile, string> {\n  const result = {} as Record<TemplateFile, string>;\n  for (const name of TEMPLATE_FILES) {\n    result[name] = loadTemplate(name);\n  }\n  return result;\n}\n\n/**\n * Clear the template cache (useful for testing).\n */\nexport function clearTemplateCache(): void {\n  templateCache.clear();\n}\n\n/** Minimal fallback templates in case files are missing */\nexport function getFallbackTemplate(name: TemplateFile): string {\n  const fallbacks: Record<TemplateFile, string> = {\n    'AGENTS.md': `# AGENTS.md - Your Workspace\n\nThis folder is home. Treat it that way.\n\n## Session Startup\n\nUse runtime-provided startup context first. Bootstrap files (SOUL, USER, MEMORY, etc.) are injected by xopc on /new and /reset.\n\nDo not manually reread startup files unless the user asks or the provided context is incomplete.\n\n## Red Lines\n\n- Don't exfiltrate private data\n- Don't run destructive commands without asking\n- When in doubt, ask\n\n## Memory\n\n- **Daily notes:** \\`memory/YYYY-MM-DD.md\\`\n- **Long-term:** profile \\`MEMORY.md\\`\n\nWrite what matters. Text > Brain.\n`,\n    'SOUL.md': `# SOUL.md - Who You Are\n\n_You're not a chatbot. You're becoming someone._\n\n## Core Truths\n\n- Be genuinely helpful, not performatively helpful\n- Have opinions\n- Be resourceful before asking\n- Earn trust through competence\n- Remember you're a guest\n\n## Boundaries\n\n- Private things stay private\n- When in doubt, ask before acting externally\n- Never send half-baked replies\n\nThis file is yours to evolve.\n`,\n    'IDENTITY.md': `# IDENTITY.md - Who Am I?\n\n_Fill this in during your first conversation._\n\n- **Name:**\n- **Creature:**\n- **Vibe:**\n- **Emoji:**\n`,\n    'USER.md': `# USER.md - About Your Human\n\n_Learn about the person you're helping._\n\n- **Name:**\n- **What to call them:**\n- **Timezone:**\n- **Notes:**\n`,\n    'TOOLS.md': `# TOOLS.md - Local Notes\n\nEnvironment-specific notes:\n\n- SSH hosts\n- API endpoints\n- Device nicknames\n`,\n    'HEARTBEAT.md': `# HEARTBEAT.md - Periodic Checks\n\nEdit this file to define what you check during heartbeat polls.\n\n## Example Checklist\n\n- [ ] Check email for urgent messages\n- [ ] Check calendar for upcoming events\n\n**Remember:** If nothing needs attention, reply \\`HEARTBEAT_OK\\`.\n`,\n    'MEMORY.md': `# MEMORY.md - Long-Term Memory\n\n_Your curated memories._\n\n## People\n\n## Projects\n\n## Preferences\n\n## Learned Lessons\n\n**Only load in main sessions.**\n`,\n  };\n  \n  return fallbacks[name] || `# ${name}\\n\\n(Template content missing)\\n`;\n}\n"],"mappings":";;;;;;;;AAUA,MAAM,YAAY,QADC,cAAc,OAAO,KAAK,IACT,CAAC;;AAGrC,MAAa,iBAAiB;CAC5B;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;AAKD,MAAa,kCAA2D,CAAC,GAAG,eAAe;;AAG3F,MAAM,gCAAgB,IAAI,KAA2B;;;;;AAMrD,SAAS,kBAA0B;CAEjC,MAAM,UAAU,QAAQ,IAAI;AAC5B,KAAI,WAAW,WAAW,QAAQ,CAChC,QAAO;CAMT,MAAM,cAAc,KADA,KAAK,WAAW,WACA,EAAE,2BAA2B;AAEjE,KAAI,WAAW,YAAY,CACzB,QAAO;AAIT,QAAO;;;;;AAMT,SAAgB,aAAa,MAA4B;AAEvD,KAAI,cAAc,IAAI,KAAK,CACzB,QAAO,cAAc,IAAI,KAAK;CAGhC,MAAM,eAAe,KAAK,iBAAiB,EAAE,KAAK;AAElD,KAAI;AACF,MAAI,WAAW,aAAa,EAAE;GAC5B,MAAM,UAAU,aAAa,cAAc,QAAQ;AACnD,iBAAc,IAAI,MAAM,QAAQ;AAChC,UAAO;;SAEH;AAKR,SAAQ,KAAK,qBAAqB,KAAK,4BAA4B;AACnE,QAAO,oBAAoB,KAAK;;;;;AAMlC,SAAgB,mBAAiD;CAC/D,MAAM,SAAS,EAAE;AACjB,MAAK,MAAM,QAAQ,eACjB,QAAO,QAAQ,aAAa,KAAK;AAEnC,QAAO;;;;;AAMT,SAAgB,qBAA2B;AACzC,eAAc,OAAO;;;AAIvB,SAAgB,oBAAoB,MAA4B;AAkG9D,QAAO;EAhGL,aAAa;;;;;;;;;;;;;;;;;;;;;;;EAuBb,WAAW;;;;;;;;;;;;;;;;;;;;EAoBX,eAAe;;;;;;;;;EASf,WAAW;;;;;;;;;EASX,YAAY;;;;;;;;EAQZ,gBAAgB;;;;;;;;;;;EAWhB,aAAa;;;;;;;;;;;;;;EAgBC,CAAC,SAAS,KAAK,KAAK"}
+{"version":3,"file":"templates.js","names":[],"sources":["../../../src/cli/templates.ts"],"sourcesContent":["/**\n * Workspace template files for onboarding.\n * Templates are stored in docs/reference/templates/ and loaded at runtime.\n */\n\nimport { readFileSync, existsSync } from 'fs';\nimport { join, dirname } from 'path';\nimport { fileURLToPath } from 'url';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n/** Profile Markdown template file names (seeded into `agents/<id>/profile/`). */\nexport const TEMPLATE_FILES = [\n  'SOUL.md',\n  'IDENTITY.md',\n  'TOOLS.md',\n  'AGENTS.md',\n  'HEARTBEAT.md',\n  'MEMORY.md',\n] as const;\n\nexport type TemplateFile = (typeof TEMPLATE_FILES)[number];\n\n/** Alias for profile Markdown templates used by seed helpers. */\nexport const PROFILE_MARKDOWN_TEMPLATE_FILES: readonly TemplateFile[] = [...TEMPLATE_FILES];\n\n/** Template content cache */\nconst templateCache = new Map<TemplateFile, string>();\n\n/**\n * Get the path to template files.\n * Uses environment or looks in project root.\n */\nfunction getTemplatePath(): string {\n  // Use environment to determine path\n  const envPath = process.env.XOPC_TEMPLATE_PATH;\n  if (envPath && existsSync(envPath)) {\n    return envPath;\n  }\n\n  // Default: look in project root docs/reference/templates\n  // Works for both development (src/cli/) and production (dist/cli/)\n  const projectRoot = join(__dirname, '../../..');\n  const defaultPath = join(projectRoot, 'docs/reference/templates');\n  \n  if (existsSync(defaultPath)) {\n    return defaultPath;\n  }\n\n  // Fallback: return default (will fail gracefully)\n  return defaultPath;\n}\n\n/**\n * Load a template file. Caches results for repeated access.\n */\nexport function loadTemplate(name: TemplateFile): string {\n  // Return cached version if available\n  if (templateCache.has(name)) {\n    return templateCache.get(name)!;\n  }\n\n  const templatePath = join(getTemplatePath(), name);\n  \n  try {\n    if (existsSync(templatePath)) {\n      const content = readFileSync(templatePath, 'utf-8');\n      templateCache.set(name, content);\n      return content;\n    }\n  } catch {\n    // Fall through to fallback\n  }\n\n  // Fallback: return minimal default if template is missing\n  console.warn(`Warning: Template ${name} not found, using fallback`);\n  return getFallbackTemplate(name);\n}\n\n/**\n * Load all templates as a record.\n */\nexport function loadAllTemplates(): Record<TemplateFile, string> {\n  const result = {} as Record<TemplateFile, string>;\n  for (const name of TEMPLATE_FILES) {\n    result[name] = loadTemplate(name);\n  }\n  return result;\n}\n\n/**\n * Clear the template cache (useful for testing).\n */\nexport function clearTemplateCache(): void {\n  templateCache.clear();\n}\n\n/** Minimal fallback templates in case files are missing */\nexport function getFallbackTemplate(name: TemplateFile): string {\n  const fallbacks: Record<TemplateFile, string> = {\n    'AGENTS.md': `# AGENTS.md - Your Workspace\n\nThis folder is home. Treat it that way.\n\n## Session Startup\n\nUse runtime-provided startup context first. Bootstrap files (global user profile, SOUL, MEMORY, etc.) are injected by xopc on /new and /reset.\n\nDo not manually reread startup files unless the user asks or the provided context is incomplete.\n\n## Red Lines\n\n- Don't exfiltrate private data\n- Don't run destructive commands without asking\n- When in doubt, ask\n\n## Memory\n\n- **Daily notes:** \\`memory/YYYY-MM-DD.md\\`\n- **Long-term:** profile \\`MEMORY.md\\`\n\nWrite what matters. Text > Brain.\n`,\n    'SOUL.md': `# SOUL.md - Who You Are\n\n_You're not a chatbot. You're becoming someone._\n\n## Core Truths\n\n- Be genuinely helpful, not performatively helpful\n- Have opinions\n- Be resourceful before asking\n- Earn trust through competence\n- Remember you're a guest\n\n## Boundaries\n\n- Private things stay private\n- When in doubt, ask before acting externally\n- Never send half-baked replies\n\nThis file is yours to evolve.\n`,\n    'IDENTITY.md': `# IDENTITY.md - Who Am I?\n\n_Fill this in during your first conversation._\n\n- **Name:**\n- **Creature:**\n- **Vibe:**\n- **Emoji:**\n`,\n    'TOOLS.md': `# TOOLS.md - Local Notes\n\nEnvironment-specific notes:\n\n- SSH hosts\n- API endpoints\n- Device nicknames\n`,\n    'HEARTBEAT.md': `# HEARTBEAT.md - Periodic Checks\n\nEdit this file to define what you check during heartbeat polls.\n\n## Example Checklist\n\n- [ ] Check email for urgent messages\n- [ ] Check calendar for upcoming events\n\n**Remember:** If nothing needs attention, reply \\`HEARTBEAT_OK\\`.\n`,\n    'MEMORY.md': `# MEMORY.md - Long-Term Memory\n\n_Your curated memories._\n\n## People\n\n## Projects\n\n## Preferences\n\n## Learned Lessons\n\n**Only load in main sessions.**\n`,\n  };\n  \n  return fallbacks[name] || `# ${name}\\n\\n(Template content missing)\\n`;\n}\n"],"mappings":";;;;;;;;AAUA,MAAM,YAAY,QADC,cAAc,OAAO,KAAK,IACT,CAAC;;AAGrC,MAAa,iBAAiB;CAC5B;CACA;CACA;CACA;CACA;CACA;CACD;;AAKD,MAAa,kCAA2D,CAAC,GAAG,eAAe;;AAG3F,MAAM,gCAAgB,IAAI,KAA2B;;;;;AAMrD,SAAS,kBAA0B;CAEjC,MAAM,UAAU,QAAQ,IAAI;AAC5B,KAAI,WAAW,WAAW,QAAQ,CAChC,QAAO;CAMT,MAAM,cAAc,KADA,KAAK,WAAW,WACA,EAAE,2BAA2B;AAEjE,KAAI,WAAW,YAAY,CACzB,QAAO;AAIT,QAAO;;;;;AAMT,SAAgB,aAAa,MAA4B;AAEvD,KAAI,cAAc,IAAI,KAAK,CACzB,QAAO,cAAc,IAAI,KAAK;CAGhC,MAAM,eAAe,KAAK,iBAAiB,EAAE,KAAK;AAElD,KAAI;AACF,MAAI,WAAW,aAAa,EAAE;GAC5B,MAAM,UAAU,aAAa,cAAc,QAAQ;AACnD,iBAAc,IAAI,MAAM,QAAQ;AAChC,UAAO;;SAEH;AAKR,SAAQ,KAAK,qBAAqB,KAAK,4BAA4B;AACnE,QAAO,oBAAoB,KAAK;;;;;AAMlC,SAAgB,mBAAiD;CAC/D,MAAM,SAAS,EAAE;AACjB,MAAK,MAAM,QAAQ,eACjB,QAAO,QAAQ,aAAa,KAAK;AAEnC,QAAO;;;;;AAMT,SAAgB,qBAA2B;AACzC,eAAc,OAAO;;;AAIvB,SAAgB,oBAAoB,MAA4B;AAyF9D,QAAO;EAvFL,aAAa;;;;;;;;;;;;;;;;;;;;;;;EAuBb,WAAW;;;;;;;;;;;;;;;;;;;;EAoBX,eAAe;;;;;;;;;EASf,YAAY;;;;;;;;EAQZ,gBAAgB;;;;;;;;;;;EAWhB,aAAa;;;;;;;;;;;;;;EAgBC,CAAC,SAAS,KAAK,KAAK"}

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

@@ -1,6 +1,6 @@
-import { init_paths, resolveConfigPath } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { init_paths, resolveConfigPath } from "../../config/paths.js";
 import { loadConfig } from "../../config/loader.js";
 import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
 import "../../config/index.js";

package/dist/src/cli/utils/init-workspace-core.d.ts

@@ -4,10 +4,7 @@ export interface InitWorkspaceCoreOptions {
     workspacePath: string;
     /** When set with a new config file, overrides schema default port (e.g. Electron). */
     gatewayPort?: number;
-    /**
-     * When true, sets `agents.defaults.workspace` to `dirname(workspacePath)` (parent of the
-     * Markdown root being initialised, e.g. `…/workspace` when `workspacePath` is `…/workspace/main`).
-     */
+    /** When true, sets the default agent manifest workspace root to `workspacePath`. */
     persistWorkspacePath?: boolean;
     /** Optional channel plugin validator (CLI/gateway only; Electron omits). */
     assertChannelPlugins?: (cfg: Config) => void | Promise<void>;

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

@@ -1,9 +1,9 @@
 import { ConfigSchema, init_schema } from "../../config/schema.js";
 import { init_loader, saveConfig } from "../../config/loader.js";
 import { ensureStarterAgentsInitialized } from "../../agent/starter-agents.js";
-import { randomBytes } from "node:crypto";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { randomBytes } from "node:crypto";
 //#region src/cli/utils/init-workspace-core.ts
 init_schema();
 init_loader();
@@ -33,7 +33,7 @@ async function initWorkspaceCore(options) {
 	const gatewayPortDefaulted = options.gatewayPort ?? 18790;
 	const persistWorkspacePath = options.persistWorkspacePath ?? false;
 	const { configPath, workspacePath, assertChannelPlugins } = options;
-	const persistedDefaultsWorkspace = persistWorkspacePath ? dirname(workspacePath) : void 0;
+	const persistedWorkspaceRoot = persistWorkspacePath ? workspacePath : void 0;
 	mkdirSync(dirname(configPath), { recursive: true });
 	const configExisted = existsSync(configPath);
 	const workspaceExisted = existsSync(workspacePath);
@@ -48,15 +48,16 @@ async function initWorkspaceCore(options) {
 	const workspaceCreated = !workspaceExisted;
 	const token = config.gateway?.auth?.mode === "token" && typeof config.gateway?.auth?.token === "string" && config.gateway.auth.token.length > 0 ? config.gateway.auth.token : randomBytes(24).toString("hex");
 	const port = configExisted ? config.gateway?.port ?? gatewayPortDefaulted : options.gatewayPort !== void 0 ? gatewayPortDefaulted : config.gateway?.port ?? 18790;
-	const agentsDefaults = {
-		...config.agents.defaults,
-		...persistedDefaultsWorkspace !== void 0 ? { workspace: persistedDefaultsWorkspace } : {}
-	};
+	const defaultAgentId = config.agents.default ?? config.agents.list[0]?.id ?? "main";
+	const agentsList = persistedWorkspaceRoot === void 0 ? config.agents.list : config.agents.list.map((agent) => agent.id === defaultAgentId ? {
+		...agent,
+		workspace: { root: persistedWorkspaceRoot }
+	} : agent);
 	const nextConfig = {
 		...config,
 		agents: {
 			...config.agents,
-			defaults: agentsDefaults
+			list: agentsList
 		},
 		gateway: {
 			...config.gateway,

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

@@ -1 +1 @@
-{"version":3,"file":"init-workspace-core.js","names":[],"sources":["../../../../src/cli/utils/init-workspace-core.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto';\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname } from 'node:path';\n\nimport type { Config } from '../../config/schema.js';\nimport { ConfigSchema } from '../../config/schema.js';\nimport { saveConfig } from '../../config/loader.js';\nimport { ensureStarterAgentsInitialized } from '../../agent/starter-agents.js';\n\nexport interface InitWorkspaceCoreOptions {\n  configPath: string;\n  workspacePath: string;\n  /** When set with a new config file, overrides schema default port (e.g. Electron). */\n  gatewayPort?: number;\n  /**\n   * When true, sets `agents.defaults.workspace` to `dirname(workspacePath)` (parent of the\n   * Markdown root being initialised, e.g. `…/workspace` when `workspacePath` is `…/workspace/main`).\n   */\n  persistWorkspacePath?: boolean;\n  /** Optional channel plugin validator (CLI/gateway only; Electron omits). */\n  assertChannelPlugins?: (cfg: Config) => void | Promise<void>;\n}\n\nexport interface InitWorkspaceResult {\n  /** Fully-initialised config (matches disk after any write). */\n  config: Config;\n  /** Gateway auth token (always present after init). */\n  token: string;\n  configCreated: boolean;\n  workspaceCreated: boolean;\n}\n\nasync function assertChannelPluginsIfNeeded(\n  cfg: Config,\n  assert?: InitWorkspaceCoreOptions['assertChannelPlugins'],\n): Promise<void> {\n  if (assert) await assert(cfg);\n}\n\nasync function serializeConfig(\n  cfg: Config,\n  assertChannelPlugins?: InitWorkspaceCoreOptions['assertChannelPlugins'],\n): Promise<string> {\n  const validated = ConfigSchema.parse(cfg);\n  await assertChannelPluginsIfNeeded(validated, assertChannelPlugins);\n  return JSON.stringify(validated, null, 2);\n}\n\nasync function tryReadDiskConfig(\n  configPath: string,\n  assertChannelPlugins?: InitWorkspaceCoreOptions['assertChannelPlugins'],\n): Promise<Config | null> {\n  try {\n    const raw = readFileSync(configPath, 'utf-8');\n    const cfg = ConfigSchema.parse(JSON.parse(raw) as unknown);\n    await assertChannelPluginsIfNeeded(cfg, assertChannelPlugins);\n    return cfg;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Workspace + config initialisation without importing bundled channel plugins.\n * Used by Electron main; CLI/gateway should call {@link initWorkspace} instead.\n */\nexport async function initWorkspaceCore(options: InitWorkspaceCoreOptions): Promise<InitWorkspaceResult> {\n  const gatewayPortDefaulted = options.gatewayPort ?? 18790;\n  const persistWorkspacePath = options.persistWorkspacePath ?? false;\n  const { configPath, workspacePath, assertChannelPlugins } = options;\n  const persistedDefaultsWorkspace = persistWorkspacePath ? dirname(workspacePath) : undefined;\n\n  mkdirSync(dirname(configPath), { recursive: true });\n\n  const configExisted = existsSync(configPath);\n  const workspaceExisted = existsSync(workspacePath);\n\n  let config: Config;\n  if (configExisted) {\n    config = (await tryReadDiskConfig(configPath, assertChannelPlugins)) ?? ConfigSchema.parse(undefined);\n  } else {\n    config = ConfigSchema.parse(undefined);\n    await assertChannelPluginsIfNeeded(config, assertChannelPlugins);\n  }\n\n  mkdirSync(workspacePath, { recursive: true });\n\n  const configCreated = !configExisted;\n  const workspaceCreated = !workspaceExisted;\n\n  const hadToken =\n    config.gateway?.auth?.mode === 'token' &&\n    typeof config.gateway?.auth?.token === 'string' &&\n    config.gateway.auth.token.length > 0;\n\n  const token = hadToken ? (config.gateway!.auth!.token as string) : randomBytes(24).toString('hex');\n\n  const port = configExisted\n    ? (config.gateway?.port ?? gatewayPortDefaulted)\n    : options.gatewayPort !== undefined\n      ? gatewayPortDefaulted\n      : (config.gateway?.port ?? 18790);\n\n  const agentsDefaults = {\n    ...config.agents.defaults,\n    ...(persistedDefaultsWorkspace !== undefined ? { workspace: persistedDefaultsWorkspace } : {}),\n  };\n\n  const nextConfig: Config = {\n    ...config,\n    agents: {\n      ...config.agents,\n      defaults: agentsDefaults,\n    },\n    gateway: {\n      ...config.gateway,\n      port,\n      auth: {\n        ...config.gateway?.auth,\n        mode: 'token' as const,\n        token,\n      },\n    },\n  };\n\n  const starterResult = ensureStarterAgentsInitialized(ConfigSchema.parse(nextConfig));\n  const nextFinal = ConfigSchema.parse(starterResult.config);\n  await assertChannelPluginsIfNeeded(nextFinal, assertChannelPlugins);\n\n  let needsWrite = configCreated || starterResult.changed;\n  if (!needsWrite) {\n    const disk = await tryReadDiskConfig(configPath, assertChannelPlugins);\n    if (!disk) {\n      needsWrite = true;\n    } else {\n      needsWrite =\n        (await serializeConfig(disk, assertChannelPlugins)) !==\n        (await serializeConfig(nextFinal, assertChannelPlugins));\n    }\n  }\n\n  if (needsWrite) {\n    if (assertChannelPlugins) {\n      await saveConfig(nextFinal, configPath);\n    } else {\n      writeFileSync(configPath, `${JSON.stringify(nextFinal, null, 2)}\\n`, 'utf8');\n    }\n  }\n\n  return {\n    config: nextFinal,\n    token,\n    configCreated,\n    workspaceCreated,\n  };\n}\n"],"mappings":";;;;;;;aAKsD;aACF;AA0BpD,eAAe,6BACb,KACA,QACe;AACf,KAAI,OAAQ,OAAM,OAAO,IAAI;;AAG/B,eAAe,gBACb,KACA,sBACiB;CACjB,MAAM,YAAY,aAAa,MAAM,IAAI;AACzC,OAAM,6BAA6B,WAAW,qBAAqB;AACnE,QAAO,KAAK,UAAU,WAAW,MAAM,EAAE;;AAG3C,eAAe,kBACb,YACA,sBACwB;AACxB,KAAI;EACF,MAAM,MAAM,aAAa,YAAY,QAAQ;EAC7C,MAAM,MAAM,aAAa,MAAM,KAAK,MAAM,IAAI,CAAY;AAC1D,QAAM,6BAA6B,KAAK,qBAAqB;AAC7D,SAAO;SACD;AACN,SAAO;;;;;;;AAQX,eAAsB,kBAAkB,SAAiE;CACvG,MAAM,uBAAuB,QAAQ,eAAe;CACpD,MAAM,uBAAuB,QAAQ,wBAAwB;CAC7D,MAAM,EAAE,YAAY,eAAe,yBAAyB;CAC5D,MAAM,6BAA6B,uBAAuB,QAAQ,cAAc,GAAG,KAAA;AAEnF,WAAU,QAAQ,WAAW,EAAE,EAAE,WAAW,MAAM,CAAC;CAEnD,MAAM,gBAAgB,WAAW,WAAW;CAC5C,MAAM,mBAAmB,WAAW,cAAc;CAElD,IAAI;AACJ,KAAI,cACF,UAAU,MAAM,kBAAkB,YAAY,qBAAqB,IAAK,aAAa,MAAM,KAAA,EAAU;MAChG;AACL,WAAS,aAAa,MAAM,KAAA,EAAU;AACtC,QAAM,6BAA6B,QAAQ,qBAAqB;;AAGlE,WAAU,eAAe,EAAE,WAAW,MAAM,CAAC;CAE7C,MAAM,gBAAgB,CAAC;CACvB,MAAM,mBAAmB,CAAC;CAO1B,MAAM,QAJJ,OAAO,SAAS,MAAM,SAAS,WAC/B,OAAO,OAAO,SAAS,MAAM,UAAU,YACvC,OAAO,QAAQ,KAAK,MAAM,SAAS,IAEX,OAAO,QAAS,KAAM,QAAmB,YAAY,GAAG,CAAC,SAAS,MAAM;CAElG,MAAM,OAAO,gBACR,OAAO,SAAS,QAAQ,uBACzB,QAAQ,gBAAgB,KAAA,IACtB,uBACC,OAAO,SAAS,QAAQ;CAE/B,MAAM,iBAAiB;EACrB,GAAG,OAAO,OAAO;EACjB,GAAI,+BAA+B,KAAA,IAAY,EAAE,WAAW,4BAA4B,GAAG,EAAE;EAC9F;CAED,MAAM,aAAqB;EACzB,GAAG;EACH,QAAQ;GACN,GAAG,OAAO;GACV,UAAU;GACX;EACD,SAAS;GACP,GAAG,OAAO;GACV;GACA,MAAM;IACJ,GAAG,OAAO,SAAS;IACnB,MAAM;IACN;IACD;GACF;EACF;CAED,MAAM,gBAAgB,+BAA+B,aAAa,MAAM,WAAW,CAAC;CACpF,MAAM,YAAY,aAAa,MAAM,cAAc,OAAO;AAC1D,OAAM,6BAA6B,WAAW,qBAAqB;CAEnE,IAAI,aAAa,iBAAiB,cAAc;AAChD,KAAI,CAAC,YAAY;EACf,MAAM,OAAO,MAAM,kBAAkB,YAAY,qBAAqB;AACtE,MAAI,CAAC,KACH,cAAa;MAEb,cACG,MAAM,gBAAgB,MAAM,qBAAqB,KACjD,MAAM,gBAAgB,WAAW,qBAAqB;;AAI7D,KAAI,WACF,KAAI,qBACF,OAAM,WAAW,WAAW,WAAW;KAEvC,eAAc,YAAY,GAAG,KAAK,UAAU,WAAW,MAAM,EAAE,CAAC,KAAK,OAAO;AAIhF,QAAO;EACL,QAAQ;EACR;EACA;EACA;EACD"}
+{"version":3,"file":"init-workspace-core.js","names":[],"sources":["../../../../src/cli/utils/init-workspace-core.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto';\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname } from 'node:path';\n\nimport type { Config } from '../../config/schema.js';\nimport { ConfigSchema } from '../../config/schema.js';\nimport { saveConfig } from '../../config/loader.js';\nimport { ensureStarterAgentsInitialized } from '../../agent/starter-agents.js';\n\nexport interface InitWorkspaceCoreOptions {\n  configPath: string;\n  workspacePath: string;\n  /** When set with a new config file, overrides schema default port (e.g. Electron). */\n  gatewayPort?: number;\n  /** When true, sets the default agent manifest workspace root to `workspacePath`. */\n  persistWorkspacePath?: boolean;\n  /** Optional channel plugin validator (CLI/gateway only; Electron omits). */\n  assertChannelPlugins?: (cfg: Config) => void | Promise<void>;\n}\n\nexport interface InitWorkspaceResult {\n  /** Fully-initialised config (matches disk after any write). */\n  config: Config;\n  /** Gateway auth token (always present after init). */\n  token: string;\n  configCreated: boolean;\n  workspaceCreated: boolean;\n}\n\nasync function assertChannelPluginsIfNeeded(\n  cfg: Config,\n  assert?: InitWorkspaceCoreOptions['assertChannelPlugins'],\n): Promise<void> {\n  if (assert) await assert(cfg);\n}\n\nasync function serializeConfig(\n  cfg: Config,\n  assertChannelPlugins?: InitWorkspaceCoreOptions['assertChannelPlugins'],\n): Promise<string> {\n  const validated = ConfigSchema.parse(cfg);\n  await assertChannelPluginsIfNeeded(validated, assertChannelPlugins);\n  return JSON.stringify(validated, null, 2);\n}\n\nasync function tryReadDiskConfig(\n  configPath: string,\n  assertChannelPlugins?: InitWorkspaceCoreOptions['assertChannelPlugins'],\n): Promise<Config | null> {\n  try {\n    const raw = readFileSync(configPath, 'utf-8');\n    const cfg = ConfigSchema.parse(JSON.parse(raw) as unknown);\n    await assertChannelPluginsIfNeeded(cfg, assertChannelPlugins);\n    return cfg;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Workspace + config initialisation without importing bundled channel plugins.\n * Used by Electron main; CLI/gateway should call {@link initWorkspace} instead.\n */\nexport async function initWorkspaceCore(options: InitWorkspaceCoreOptions): Promise<InitWorkspaceResult> {\n  const gatewayPortDefaulted = options.gatewayPort ?? 18790;\n  const persistWorkspacePath = options.persistWorkspacePath ?? false;\n  const { configPath, workspacePath, assertChannelPlugins } = options;\n  const persistedWorkspaceRoot = persistWorkspacePath ? workspacePath : undefined;\n\n  mkdirSync(dirname(configPath), { recursive: true });\n\n  const configExisted = existsSync(configPath);\n  const workspaceExisted = existsSync(workspacePath);\n\n  let config: Config;\n  if (configExisted) {\n    config = (await tryReadDiskConfig(configPath, assertChannelPlugins)) ?? ConfigSchema.parse(undefined);\n  } else {\n    config = ConfigSchema.parse(undefined);\n    await assertChannelPluginsIfNeeded(config, assertChannelPlugins);\n  }\n\n  mkdirSync(workspacePath, { recursive: true });\n\n  const configCreated = !configExisted;\n  const workspaceCreated = !workspaceExisted;\n\n  const hadToken =\n    config.gateway?.auth?.mode === 'token' &&\n    typeof config.gateway?.auth?.token === 'string' &&\n    config.gateway.auth.token.length > 0;\n\n  const token = hadToken ? (config.gateway!.auth!.token as string) : randomBytes(24).toString('hex');\n\n  const port = configExisted\n    ? (config.gateway?.port ?? gatewayPortDefaulted)\n    : options.gatewayPort !== undefined\n      ? gatewayPortDefaulted\n      : (config.gateway?.port ?? 18790);\n\n  const defaultAgentId = config.agents.default ?? config.agents.list[0]?.id ?? 'main';\n  const agentsList =\n    persistedWorkspaceRoot === undefined\n      ? config.agents.list\n      : config.agents.list.map((agent) =>\n          agent.id === defaultAgentId ? { ...agent, workspace: { root: persistedWorkspaceRoot } } : agent,\n        );\n\n  const nextConfig: Config = {\n    ...config,\n    agents: {\n      ...config.agents,\n      list: agentsList,\n    },\n    gateway: {\n      ...config.gateway,\n      port,\n      auth: {\n        ...config.gateway?.auth,\n        mode: 'token' as const,\n        token,\n      },\n    },\n  };\n\n  const starterResult = ensureStarterAgentsInitialized(ConfigSchema.parse(nextConfig));\n  const nextFinal = ConfigSchema.parse(starterResult.config);\n  await assertChannelPluginsIfNeeded(nextFinal, assertChannelPlugins);\n\n  let needsWrite = configCreated || starterResult.changed;\n  if (!needsWrite) {\n    const disk = await tryReadDiskConfig(configPath, assertChannelPlugins);\n    if (!disk) {\n      needsWrite = true;\n    } else {\n      needsWrite =\n        (await serializeConfig(disk, assertChannelPlugins)) !==\n        (await serializeConfig(nextFinal, assertChannelPlugins));\n    }\n  }\n\n  if (needsWrite) {\n    if (assertChannelPlugins) {\n      await saveConfig(nextFinal, configPath);\n    } else {\n      writeFileSync(configPath, `${JSON.stringify(nextFinal, null, 2)}\\n`, 'utf8');\n    }\n  }\n\n  return {\n    config: nextFinal,\n    token,\n    configCreated,\n    workspaceCreated,\n  };\n}\n"],"mappings":";;;;;;;aAKsD;aACF;AAuBpD,eAAe,6BACb,KACA,QACe;AACf,KAAI,OAAQ,OAAM,OAAO,IAAI;;AAG/B,eAAe,gBACb,KACA,sBACiB;CACjB,MAAM,YAAY,aAAa,MAAM,IAAI;AACzC,OAAM,6BAA6B,WAAW,qBAAqB;AACnE,QAAO,KAAK,UAAU,WAAW,MAAM,EAAE;;AAG3C,eAAe,kBACb,YACA,sBACwB;AACxB,KAAI;EACF,MAAM,MAAM,aAAa,YAAY,QAAQ;EAC7C,MAAM,MAAM,aAAa,MAAM,KAAK,MAAM,IAAI,CAAY;AAC1D,QAAM,6BAA6B,KAAK,qBAAqB;AAC7D,SAAO;SACD;AACN,SAAO;;;;;;;AAQX,eAAsB,kBAAkB,SAAiE;CACvG,MAAM,uBAAuB,QAAQ,eAAe;CACpD,MAAM,uBAAuB,QAAQ,wBAAwB;CAC7D,MAAM,EAAE,YAAY,eAAe,yBAAyB;CAC5D,MAAM,yBAAyB,uBAAuB,gBAAgB,KAAA;AAEtE,WAAU,QAAQ,WAAW,EAAE,EAAE,WAAW,MAAM,CAAC;CAEnD,MAAM,gBAAgB,WAAW,WAAW;CAC5C,MAAM,mBAAmB,WAAW,cAAc;CAElD,IAAI;AACJ,KAAI,cACF,UAAU,MAAM,kBAAkB,YAAY,qBAAqB,IAAK,aAAa,MAAM,KAAA,EAAU;MAChG;AACL,WAAS,aAAa,MAAM,KAAA,EAAU;AACtC,QAAM,6BAA6B,QAAQ,qBAAqB;;AAGlE,WAAU,eAAe,EAAE,WAAW,MAAM,CAAC;CAE7C,MAAM,gBAAgB,CAAC;CACvB,MAAM,mBAAmB,CAAC;CAO1B,MAAM,QAJJ,OAAO,SAAS,MAAM,SAAS,WAC/B,OAAO,OAAO,SAAS,MAAM,UAAU,YACvC,OAAO,QAAQ,KAAK,MAAM,SAAS,IAEX,OAAO,QAAS,KAAM,QAAmB,YAAY,GAAG,CAAC,SAAS,MAAM;CAElG,MAAM,OAAO,gBACR,OAAO,SAAS,QAAQ,uBACzB,QAAQ,gBAAgB,KAAA,IACtB,uBACC,OAAO,SAAS,QAAQ;CAE/B,MAAM,iBAAiB,OAAO,OAAO,WAAW,OAAO,OAAO,KAAK,IAAI,MAAM;CAC7E,MAAM,aACJ,2BAA2B,KAAA,IACvB,OAAO,OAAO,OACd,OAAO,OAAO,KAAK,KAAK,UACtB,MAAM,OAAO,iBAAiB;EAAE,GAAG;EAAO,WAAW,EAAE,MAAM,wBAAwB;EAAE,GAAG,MAC3F;CAEP,MAAM,aAAqB;EACzB,GAAG;EACH,QAAQ;GACN,GAAG,OAAO;GACV,MAAM;GACP;EACD,SAAS;GACP,GAAG,OAAO;GACV;GACA,MAAM;IACJ,GAAG,OAAO,SAAS;IACnB,MAAM;IACN;IACD;GACF;EACF;CAED,MAAM,gBAAgB,+BAA+B,aAAa,MAAM,WAAW,CAAC;CACpF,MAAM,YAAY,aAAa,MAAM,cAAc,OAAO;AAC1D,OAAM,6BAA6B,WAAW,qBAAqB;CAEnE,IAAI,aAAa,iBAAiB,cAAc;AAChD,KAAI,CAAC,YAAY;EACf,MAAM,OAAO,MAAM,kBAAkB,YAAY,qBAAqB;AACtE,MAAI,CAAC,KACH,cAAa;MAEb,cACG,MAAM,gBAAgB,MAAM,qBAAqB,KACjD,MAAM,gBAAgB,WAAW,qBAAqB;;AAI7D,KAAI,WACF,KAAI,qBACF,OAAM,WAAW,WAAW,WAAW;KAEvC,eAAc,YAAY,GAAG,KAAK,UAAU,WAAW,MAAM,EAAE,CAAC,KAAK,OAAO;AAIhF,QAAO;EACL,QAAQ;EACR;EACA;EACA;EACD"}

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

@@ -9,7 +9,6 @@ export declare function findAgentEntryIndex(list: AgentEntry[], agentId: string)
 export declare function applyAgentConfig(cfg: Config, params: {
     agentId: string;
     workspace?: string;
-    agentDir?: string;
     model?: string;
     models?: AgentEntry['models'];
     skills?: string[];

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

@@ -14,29 +14,78 @@ function applyAgentConfig(cfg, params) {
 	const agentId = normalizeAgentId(params.agentId);
 	const list = listAgentEntries(cfg);
 	const index = findAgentEntryIndex(list, agentId);
+	const nextTools = params.tools;
 	const base = index >= 0 ? list[index] : {
 		id: agentId,
-		enabled: true
+		enabled: true,
+		identity: {
+			name: agentId,
+			role: "Agent",
+			language: "en",
+			tone: "direct"
+		},
+		responsibilities: { primary: ["Help the user complete tasks"] },
+		workspace: { root: `~/.xopc/workspace/${agentId}` },
+		tools: { builtin: {} },
+		skills: { mode: "all" },
+		memory: {
+			mode: "confirmWrite",
+			sources: ["session", "curated"],
+			writePolicy: { curated: "confirm" }
+		},
+		workflows: {},
+		boundaries: {
+			requiresConfirmation: [],
+			forbidden: [],
+			escalation: []
+		}
 	};
 	const nextEntry = {
 		...base,
 		enabled: base.enabled ?? true,
-		...params.workspace ? { workspace: params.workspace } : {},
-		...params.agentDir ? { agentDir: params.agentDir } : {},
+		...params.workspace ? { workspace: { root: params.workspace } } : {},
 		...params.models ? { models: params.models } : {},
 		...params.model ? { models: {
-			...base.models,
-			chat: { primary: params.model }
+			...base.models ?? {},
+			defaultRole: "deep",
+			roles: {
+				...base.models?.roles ?? {},
+				deep: { model: params.model }
+			}
+		} } : {},
+		...params.skills ? { skills: {
+			mode: "allowlist",
+			allow: params.skills
 		} } : {},
-		...params.skills ? { skills: params.skills } : {},
-		...params.tools ? { tools: params.tools } : {}
+		...nextTools ? { tools: nextTools } : {}
 	};
 	const nextList = [...list];
 	if (index >= 0) nextList[index] = nextEntry;
 	else {
 		if (nextList.length === 0 && agentId !== normalizeAgentId(resolveDefaultAgentId(cfg))) nextList.push({
 			id: resolveDefaultAgentId(cfg),
-			enabled: true
+			enabled: true,
+			identity: {
+				name: resolveDefaultAgentId(cfg),
+				role: "Agent",
+				language: "en",
+				tone: "direct"
+			},
+			responsibilities: { primary: ["Help the user complete tasks"] },
+			workspace: { root: `~/.xopc/workspace/${resolveDefaultAgentId(cfg)}` },
+			tools: { builtin: {} },
+			skills: { mode: "all" },
+			memory: {
+				mode: "confirmWrite",
+				sources: ["session", "curated"],
+				writePolicy: { curated: "confirm" }
+			},
+			workflows: {},
+			boundaries: {
+				requiresConfirmation: [],
+				forbidden: [],
+				escalation: []
+			}
 		});
 		nextList.push(nextEntry);
 	}
@@ -51,18 +100,15 @@ function applyAgentConfig(cfg, params) {
 function pruneAgentConfig(cfg, agentId) {
 	const id = normalizeAgentId(agentId);
 	const nextAgentsList = listAgentEntries(cfg).filter((e) => normalizeAgentId(e.id) !== id);
-	const nextAgents = nextAgentsList.length > 0 ? nextAgentsList : void 0;
+	const nextAgents = nextAgentsList.length > 0 ? nextAgentsList : [];
 	const bindings = cfg.bindings ?? [];
 	const filteredBindings = bindings.filter((b) => normalizeAgentId(b.agentId) !== id);
 	return {
 		config: {
 			...cfg,
-			agents: nextAgents ? {
+			agents: {
 				...cfg.agents,
 				list: nextAgents
-			} : {
-				...cfg.agents,
-				list: void 0
 			},
 			bindings: filteredBindings
 		},

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

@@ -1 +1 @@
-{"version":3,"file":"agents.config.js","names":[],"sources":["../../../src/commands/agents.config.ts"],"sourcesContent":["/**\n * Mutate `agents.list` / bindings when adding or removing agents.\n */\n\nimport { rm } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\n\nimport type { Config } from '../config/schema.js';\nimport {\n  listAgentEntries,\n  normalizeAgentId,\n  resolveAgentHomeDir,\n  resolveAgentWorkspaceDir,\n  resolveDefaultAgentId,\n  DEFAULT_AGENT_ID,\n} from '../agent/agent-scope.js';\n\ntype AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];\n\nexport { listAgentEntries };\n\nexport function findAgentEntryIndex(list: AgentEntry[], agentId: string): number {\n  const id = normalizeAgentId(agentId);\n  return list.findIndex((e) => normalizeAgentId(e.id) === id);\n}\n\nexport function applyAgentConfig(\n  cfg: Config,\n  params: {\n    agentId: string;\n    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"}
+{"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    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 nextTools = params.tools;\n  const base = index >= 0 ? list[index] : {\n    id: agentId,\n    enabled: true as const,\n    identity: { name: agentId, role: 'Agent', language: 'en', tone: 'direct' },\n    responsibilities: { primary: ['Help the user complete tasks'] },\n    workspace: { root: `~/.xopc/workspace/${agentId}` },\n    tools: { builtin: {} },\n    skills: { mode: 'all' as const },\n    memory: { mode: 'confirmWrite' as const, sources: ['session' as const, 'curated' as const], writePolicy: { curated: 'confirm' as const } },\n    workflows: {},\n    boundaries: { requiresConfirmation: [], forbidden: [], escalation: [] },\n  };\n  const nextEntry: AgentEntry = {\n    ...base,\n    enabled: base.enabled ?? true,\n    ...(params.workspace ? { workspace: { root: params.workspace } } : {}),\n    ...(params.models ? { models: params.models } : {}),\n    ...(params.model\n      ? {\n          models: {\n            ...(base.models ?? {}),\n            defaultRole: 'deep',\n            roles: { ...(base.models?.roles ?? {}), deep: { model: params.model } },\n          },\n        }\n      : {}),\n    ...(params.skills ? { skills: { mode: 'allowlist' as const, allow: params.skills } } : {}),\n    ...(nextTools ? { tools: nextTools } : {}),\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({\n        id: resolveDefaultAgentId(cfg),\n        enabled: true,\n        identity: { name: resolveDefaultAgentId(cfg), role: 'Agent', language: 'en', tone: 'direct' },\n        responsibilities: { primary: ['Help the user complete tasks'] },\n        workspace: { root: `~/.xopc/workspace/${resolveDefaultAgentId(cfg)}` },\n        tools: { builtin: {} },\n        skills: { mode: 'all' },\n        memory: { mode: 'confirmWrite', sources: ['session', 'curated'], writePolicy: { curated: 'confirm' } },\n        workflows: {},\n        boundaries: { requiresConfirmation: [], forbidden: [], escalation: [] },\n      });\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 : [];\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: { ...cfg.agents, list: nextAgents },\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":"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"}

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

@@ -1,38 +1,26 @@
-/**
- * Effective agent profile: merges `agents.defaults` with `agents.list` entry.
- * Subagent session keys fall back to the configured default agent id for profile lookup.
- */
+import { type EffectiveAgentManifest } from '../agent-manifest/index.js';
 import type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';
 import type { Config } from './schema.js';
-import type { AgentModelConfig } from './schema.js';
 export { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';
-export type { AgentModelConfig };
 export interface EffectiveAgentTools {
-    /** Tool names to exclude (merged: union of defaults + list entry disables). */
-    disable: Set<string>;
+    denied: Set<string>;
 }
 export interface EffectiveAgentProfile {
     agentId: string;
-    /** Resolved absolute Markdown workspace path (tool cwd, attachments, daily memory/, …). */
+    manifest: EffectiveAgentManifest;
     resolvedWorkspacePath: string;
-    /** Primary model ref (provider/model); may be empty → runtime default. */
     primaryModelRef: string | undefined;
     fallbacks: string[];
     thinkingDefault?: ThinkLevel;
     reasoningDefault?: ReasoningLevel;
     verboseDefault?: VerboseLevel;
     systemPromptOverride?: string;
-    /** Skill names visible in `<available_skills>`; undefined means all enabled skills, empty means none. */
     skillsAllowlist?: string[];
     tools: EffectiveAgentTools;
     params: Record<string, unknown>;
 }
-/**
- * Agent id used for config lookup from a session key (subagent keys → default agent).
- */
 export declare function extractProfileAgentId(sessionKey: string | undefined | null, config: Config): string;
-/**
- * Merge `agents.defaults` with the matching `agents.list` entry.
- */
+export declare function resolveEffectiveAgentManifestForAgent(config: Config, agentId: string): EffectiveAgentManifest;
+export declare function resolveEffectiveAgentManifestForSession(config: Config, sessionKey: string | undefined | null): EffectiveAgentManifest;
 export declare function resolveEffectiveAgentProfile(config: Config, agentId: string): EffectiveAgentProfile;
 export declare function resolveEffectiveAgentProfileForSession(config: Config, sessionKey: string | undefined | null): EffectiveAgentProfile;

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

@@ -1,47 +1,16 @@
-import { init_agent_scope, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
-import { getAgentDefaultModelRef, init_schema } from "./schema.js";
+import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
+import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
+import "../agent-manifest/index.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/config/agent-profile.ts
-init_schema();
 init_agent_scope();
 init_resolve_route();
 init_session_key();
-function mergeModelConfig(base, override) {
-	if (override === void 0) return base;
-	if (base === void 0) return override;
-	return {
-		primary: override.primary ?? base.primary,
-		fallbacks: override.fallbacks ?? base.fallbacks
-	};
-}
-function primaryAndFallbacksFromModelConfig(raw) {
-	const primary = raw?.primary?.trim();
-	const fallbacks = Array.isArray(raw?.fallbacks) ? raw.fallbacks.map((s) => s.trim()).filter(Boolean) : [];
-	return {
-		primary: primary || void 0,
-		fallbacks
-	};
+function findAgentManifest(config, agentId) {
+	const id = normalizeAgentId(agentId);
+	return config.agents.list.find((agent) => agent.enabled !== false && normalizeAgentId(agent.id) === id);
 }
-function mergeDisableLists(a, b) {
-	const out = /* @__PURE__ */ new Set();
-	for (const x of a ?? []) {
-		const s = String(x).trim();
-		if (s) out.add(s);
-	}
-	for (const x of b ?? []) {
-		const s = String(x).trim();
-		if (s) out.add(s);
-	}
-	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).
-*/
 function extractProfileAgentId(sessionKey, config) {
 	const parsed = parseSessionKey(sessionKey ?? "");
 	if (!parsed) return getDefaultAgentId(config);
@@ -50,40 +19,39 @@ function extractProfileAgentId(sessionKey, config) {
 	if (!agentExists(aid, config)) return getDefaultAgentId(config);
 	return aid.toLowerCase();
 }
-/**
-* Merge `agents.defaults` with the matching `agents.list` entry.
-*/
+function resolveEffectiveAgentManifestForAgent(config, agentId) {
+	const agent = findAgentManifest(config, agentId) ?? findAgentManifest(config, getDefaultAgentId(config));
+	if (!agent) throw new Error(`No enabled agent manifest found for "${agentId}"`);
+	return resolveEffectiveAgentManifest({
+		agent,
+		presets: config.agents.capabilityPresets,
+		defaultPresetId: config.agents.defaultPreset
+	}).manifest;
+}
+function resolveEffectiveAgentManifestForSession(config, sessionKey) {
+	return resolveEffectiveAgentManifestForAgent(config, extractProfileAgentId(sessionKey, config));
+}
 function resolveEffectiveAgentProfile(config, agentId) {
-	const defaults = config.agents?.defaults;
-	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?.models?.chat, entry?.models?.chat));
-	const globalDefault = getAgentDefaultModelRef(config);
-	const primaryModelRef = primaryFromMerged?.trim() || globalDefault;
-	const disable = mergeDisableLists(defaults?.tools?.disable, entry?.tools?.disable);
-	const params = {
-		...defaults?.params,
-		...entry?.params
-	};
+	const manifest = resolveEffectiveAgentManifestForAgent(config, agentId);
+	const defaultModel = manifest.models.roles[manifest.models.defaultRole]?.model;
+	const deniedTools = Object.entries(manifest.tools.builtin).filter(([, policy]) => policy.mode === "deny").map(([name]) => name);
+	const skillsAllowlist = manifest.skills.mode === "allowlist" ? [...manifest.skills.allow ?? []] : void 0;
 	return {
-		agentId: agentId.toLowerCase(),
-		resolvedWorkspacePath,
-		primaryModelRef,
-		fallbacks: fallbacksFromMerged,
-		thinkingDefault: entry?.thinkingDefault ?? defaults?.thinkingDefault,
-		reasoningDefault: entry?.reasoningDefault ?? defaults?.reasoningDefault,
-		verboseDefault: entry?.verboseDefault ?? defaults?.verboseDefault,
-		systemPromptOverride: entry?.systemPromptOverride?.trim() ? entry.systemPromptOverride : defaults?.systemPromptOverride?.trim() ? defaults.systemPromptOverride : void 0,
-		skillsAllowlist: resolveSkillsAllowlist(defaults?.skills, entry?.skills),
-		tools: { disable },
-		params
+		agentId: manifest.id,
+		manifest,
+		resolvedWorkspacePath: resolveAgentWorkspaceDir(config, manifest.id),
+		primaryModelRef: defaultModel?.trim() || void 0,
+		fallbacks: [],
+		systemPromptOverride: manifest.prompt?.customInstructions,
+		skillsAllowlist,
+		tools: { denied: new Set(deniedTools) },
+		params: {}
 	};
 }
 function resolveEffectiveAgentProfileForSession(config, sessionKey) {
 	return resolveEffectiveAgentProfile(config, extractProfileAgentId(sessionKey, config));
 }
 //#endregion
-export { extractProfileAgentId, resolveAgentWorkspaceDir, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession };
+export { extractProfileAgentId, resolveAgentWorkspaceDir, resolveEffectiveAgentManifestForAgent, resolveEffectiveAgentManifestForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession };
 
 //# sourceMappingURL=agent-profile.js.map

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  /** 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"}
+{"version":3,"file":"agent-profile.js","names":[],"sources":["../../../src/config/agent-profile.ts"],"sourcesContent":["import { resolveEffectiveAgentManifest, type EffectiveAgentManifest } from '../agent-manifest/index.js';\nimport { normalizeAgentId, resolveAgentWorkspaceDir } from '../agent/agent-scope.js';\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';\nimport { agentExists, getDefaultAgentId } from '../routing/resolve-route.js';\nimport { parseSessionKey } from '../routing/session-key.js';\nimport type { Config } from './schema.js';\n\nexport { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';\n\nexport interface EffectiveAgentTools {\n  denied: Set<string>;\n}\n\nexport interface EffectiveAgentProfile {\n  agentId: string;\n  manifest: EffectiveAgentManifest;\n  resolvedWorkspacePath: string;\n  primaryModelRef: string | undefined;\n  fallbacks: string[];\n  thinkingDefault?: ThinkLevel;\n  reasoningDefault?: ReasoningLevel;\n  verboseDefault?: VerboseLevel;\n  systemPromptOverride?: string;\n  skillsAllowlist?: string[];\n  tools: EffectiveAgentTools;\n  params: Record<string, unknown>;\n}\n\nfunction findAgentManifest(config: Config, agentId: string) {\n  const id = normalizeAgentId(agentId);\n  return config.agents.list.find((agent) => agent.enabled !== false && normalizeAgentId(agent.id) === id);\n}\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\nexport function resolveEffectiveAgentManifestForAgent(config: Config, agentId: string): EffectiveAgentManifest {\n  const agent = findAgentManifest(config, agentId) ?? findAgentManifest(config, getDefaultAgentId(config));\n  if (!agent) {\n    throw new Error(`No enabled agent manifest found for \"${agentId}\"`);\n  }\n  return resolveEffectiveAgentManifest({\n    agent,\n    presets: config.agents.capabilityPresets,\n    defaultPresetId: config.agents.defaultPreset,\n  }).manifest;\n}\n\nexport function resolveEffectiveAgentManifestForSession(\n  config: Config,\n  sessionKey: string | undefined | null,\n): EffectiveAgentManifest {\n  return resolveEffectiveAgentManifestForAgent(config, extractProfileAgentId(sessionKey, config));\n}\n\nexport function resolveEffectiveAgentProfile(config: Config, agentId: string): EffectiveAgentProfile {\n  const manifest = resolveEffectiveAgentManifestForAgent(config, agentId);\n  const defaultModel = manifest.models.roles[manifest.models.defaultRole]?.model;\n  const deniedTools = Object.entries(manifest.tools.builtin)\n    .filter(([, policy]) => policy.mode === 'deny')\n    .map(([name]) => name);\n  const skillsAllowlist = manifest.skills.mode === 'allowlist' ? [...(manifest.skills.allow ?? [])] : undefined;\n\n  return {\n    agentId: manifest.id,\n    manifest,\n    resolvedWorkspacePath: resolveAgentWorkspaceDir(config, manifest.id),\n    primaryModelRef: defaultModel?.trim() || undefined,\n    fallbacks: [],\n    systemPromptOverride: manifest.prompt?.customInstructions,\n    skillsAllowlist,\n    tools: { denied: new Set(deniedTools) },\n    params: {},\n  };\n}\n\nexport function resolveEffectiveAgentProfileForSession(\n  config: Config,\n  sessionKey: string | undefined | null,\n): EffectiveAgentProfile {\n  return resolveEffectiveAgentProfile(config, extractProfileAgentId(sessionKey, config));\n}\n"],"mappings":";;;;;;kBACqF;oBAER;kBACjB;AAwB5D,SAAS,kBAAkB,QAAgB,SAAiB;CAC1D,MAAM,KAAK,iBAAiB,QAAQ;AACpC,QAAO,OAAO,OAAO,KAAK,MAAM,UAAU,MAAM,YAAY,SAAS,iBAAiB,MAAM,GAAG,KAAK,GAAG;;AAGzG,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;;AAG1B,SAAgB,sCAAsC,QAAgB,SAAyC;CAC7G,MAAM,QAAQ,kBAAkB,QAAQ,QAAQ,IAAI,kBAAkB,QAAQ,kBAAkB,OAAO,CAAC;AACxG,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,wCAAwC,QAAQ,GAAG;AAErE,QAAO,8BAA8B;EACnC;EACA,SAAS,OAAO,OAAO;EACvB,iBAAiB,OAAO,OAAO;EAChC,CAAC,CAAC;;AAGL,SAAgB,wCACd,QACA,YACwB;AACxB,QAAO,sCAAsC,QAAQ,sBAAsB,YAAY,OAAO,CAAC;;AAGjG,SAAgB,6BAA6B,QAAgB,SAAwC;CACnG,MAAM,WAAW,sCAAsC,QAAQ,QAAQ;CACvE,MAAM,eAAe,SAAS,OAAO,MAAM,SAAS,OAAO,cAAc;CACzE,MAAM,cAAc,OAAO,QAAQ,SAAS,MAAM,QAAQ,CACvD,QAAQ,GAAG,YAAY,OAAO,SAAS,OAAO,CAC9C,KAAK,CAAC,UAAU,KAAK;CACxB,MAAM,kBAAkB,SAAS,OAAO,SAAS,cAAc,CAAC,GAAI,SAAS,OAAO,SAAS,EAAE,CAAE,GAAG,KAAA;AAEpG,QAAO;EACL,SAAS,SAAS;EAClB;EACA,uBAAuB,yBAAyB,QAAQ,SAAS,GAAG;EACpE,iBAAiB,cAAc,MAAM,IAAI,KAAA;EACzC,WAAW,EAAE;EACb,sBAAsB,SAAS,QAAQ;EACvC;EACA,OAAO,EAAE,QAAQ,IAAI,IAAI,YAAY,EAAE;EACvC,QAAQ,EAAE;EACX;;AAGH,SAAgB,uCACd,QACA,YACuB;AACvB,QAAO,6BAA6B,QAAQ,sBAAsB,YAAY,OAAO,CAAC"}

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

@@ -1,5 +1,5 @@
 /**
- * Named model roles from `agents.defaults.models.roles` plus per-agent overrides.
+ * Named model roles from the selected agent manifest.
  */
 import type { AgentTypedModel, Config } from './schema.js';
 export type { AgentTypedModel };