@xopcai/xopc 0.0.96 → 0.0.97

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

@@ -1,5 +1,3 @@
-import { init_agent_scope, resolveAgentProfileDir, resolveDefaultAgentId } from "../../agent/agent-scope.js";
-import { WORKSPACE_FILES, init_paths } from "../../config/paths.js";
 import { ConfigSchema, init_schema } from "../../config/schema.js";
 import { saveConfig } from "../../config/loader.js";
 import { resolveGatewayLocalClientHost } from "../../config/gateway-bind.js";
@@ -12,12 +10,9 @@ import { initWorkspace } from "../utils/init-workspace.js";
 import { setupModel } from "./onboard/model.js";
 import { getChannelConfigurators } from "./onboard/channels/registry.js";
 import { setupChannels } from "./onboard/channels/index.js";
-import { join } from "path";
 import { select } from "@inquirer/prompts";
 import { Command } from "commander";
 //#region src/cli/commands/onboard.ts
-init_agent_scope();
-init_paths();
 init_schema();
 function isInteractive() {
 	return process.stdin.isTTY && process.stdout.isTTY;
@@ -105,11 +100,9 @@ async function runOnboard(options, ctx) {
 		if (gatewayConfigured) {
 			console.log("  1. Choose how to launch below (gateway or terminal UI)");
 			console.log("  2. Or chat with: xopc agent -i");
-			console.log("  3. Optional: read BOOTSTRAP.md in your workspace for workspace tips");
 		} else {
 			console.log("  1. Chat in the terminal: xopc agent -i");
 			console.log("  2. Optional: add the Web console: xopc onboard --gateway");
-			console.log("  3. Optional: read BOOTSTRAP.md in your workspace");
 		}
 		console.log("");
 	} else if (doGateway && gatewayConfigured) {
@@ -127,7 +120,6 @@ async function runOnboard(options, ctx) {
 	console.log("\n📁 Files:");
 	console.log("  Config:", configPath);
 	console.log("  Workspace:", workspacePath);
-	if (runFullWizard) console.log("  BOOTSTRAP.md (origin story):", join(resolveAgentProfileDir(config, resolveDefaultAgentId(config)), WORKSPACE_FILES.BOOTSTRAP));
 	if (isInteractive() && didConfigurableSteps) await promptLaunchAfterOnboard(config, ctx, { doChannels });
 	process.exit(0);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"onboard.js","names":["runModelSetup","runChannelOnboard"],"sources":["../../../../src/cli/commands/onboard.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { join } from 'path';\nimport { select } from '@inquirer/prompts';\nimport { saveConfig } from '../../config/index.js';\nimport { register, formatExamples } from '../registry.js';\nimport type { CLIContext } from '../registry.js';\nimport type { Config } from '../../config/schema.js';\nimport { setupModel as runModelSetup } from './onboard/model.js';\nimport { colors } from '../utils/colors.js';\nimport { setupChannels as runChannelOnboard, getChannelConfigurators } from './onboard/channels/index.js';\nimport { seedMainAgentProfileMarkdown } from '../../agent/context/workspace-seed.js';\nimport { resolveDefaultAgentId, resolveAgentProfileDir } from '../../agent/agent-scope.js';\nimport { WORKSPACE_FILES } from '../../config/paths.js';\nimport { resolveGatewayLocalClientHost } from '../../config/gateway-bind.js';\nimport { initWorkspace } from '../utils/init-workspace.js';\nimport { ConfigSchema } from '../../config/schema.js';\nimport { isWeixinOnboardConfigured } from '../../../extensions/weixin/src/adapters/onboard-cli.js';\n\nfunction isInteractive(): boolean {\n  return process.stdin.isTTY && process.stdout.isTTY;\n}\n\nasync function setupNonInteractive(_configPath: string, existingConfig: Config): Promise<Config> {\n  console.log('\\n🤖 AI Model Configuration (Non-Interactive Mode)\\n');\n  console.log('Current config:', JSON.stringify(existingConfig.agents?.defaults?.model, null, 2));\n  console.log('\\n💡 To configure in interactive mode, run: xopc onboard');\n  console.log('💡 Or set up manually in:', _configPath);\n  return existingConfig;\n}\n\nfunction createOnboardCommand(ctx: CLIContext): Command {\n  const cmd = new Command('onboard')\n    .description('Interactive setup wizard for xopc (gateway uses schema defaults)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc onboard              # Full interactive setup',\n        'xopc onboard --model      # Configure LLM model only',\n        'xopc onboard --channels   # Configure channels (incl. Weixin QR)',\n        'xopc onboard --gateway    # Apply default gateway settings (quiet)',\n      ])\n    )\n    .option('--model', 'Configure LLM provider and model')\n    .option('--channels', 'Configure messaging channels')\n    .option('--gateway', 'Configure gateway WebUI')\n    .option('--all', 'Configure everything (default)')\n    .action(async (options) => {\n      try {\n        await runOnboard(options, ctx);\n      } catch (error: unknown) {\n        const err = error as { name?: string; code?: string };\n        if (err?.name === 'ExitPromptError' || err?.code === 'EXIT_PROMPT') {\n          console.log('\\n\\n👋 Setup cancelled.');\n          process.exit(0);\n        }\n        throw error;\n      }\n    });\n\n  return cmd;\n}\n\ntype OnboardOptions = {\n  model?: boolean;\n  channels?: boolean;\n  gateway?: boolean;\n  all?: boolean;\n};\n\nasync function runOnboard(\n  options: OnboardOptions,\n  ctx: CLIContext\n): Promise<void> {\n  console.log(colors.cyan('\\n🚀 Welcome to xopc setup!\\n'));\n  console.log('═'.repeat(50));\n\n  const workspacePath = ctx.workspacePath;\n  const configPath = ctx.configPath;\n\n  const initResult = await initWorkspace({ configPath, workspacePath });\n  let config = initResult.config;\n\n  // Determine what to configure based on options\n  const doModel = options.model || options.all || (!options.channels && !options.gateway);\n  const doChannels = options.channels || options.all || (!options.model && !options.gateway);\n  const doGateway = options.gateway || options.all || (!options.model && !options.channels);\n  const runFullWizard = !options.model && !options.channels && !options.gateway;\n  /** Any setup step besides the unified launch prompt ran in interactive flow. */\n  const didConfigurableSteps = doModel || doChannels || doGateway;\n\n  if (!isInteractive()) {\n    // Non-interactive mode\n    if (doModel) {\n      config = await setupNonInteractive(configPath, config);\n    }\n    if (doChannels) {\n      console.log('\\n💬 Channels Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure channels, edit the config file manually.');\n    }\n    if (doGateway) {\n      console.log('\\n🌐 Gateway Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure gateway, edit the config file manually.');\n    }\n  } else {\n    // Interactive mode\n    if (doModel) {\n      config = await runModelSetup(config, ctx);\n    }\n\n    if (doChannels) {\n      const channelIds = getChannelConfigurators().map(c => c.id);\n      console.log(colors.gray(`\\nChannel onboarding: ${channelIds.join(', ')}\\n`));\n      config = await runChannelOnboard(config);\n    }\n\n    if (doGateway) {\n      config = await setupGateway(config);\n    }\n  }\n\n  // Save config once at the end\n  await saveConfig(config as Config, configPath);\n\n  seedMainAgentProfileMarkdown(config as Config);\n\n  console.log('\\n' + '═'.repeat(50));\n  console.log('\\n🎉 Setup Complete!\\n');\n\n  const gatewayAuth = (config as any)?.gateway?.auth;\n  const gatewayConfigured =\n    gatewayAuth?.mode === 'token' &&\n    typeof gatewayAuth?.token === 'string' &&\n    gatewayAuth.token.length > 0;\n  const port = (config as Config)?.gateway?.port ?? 18790;\n  const displayHost = resolveGatewayLocalClientHost(config as Config);\n  const gwToken = gatewayConfigured ? (gatewayAuth.token as string) : undefined;\n\n  const showGatewaySummary = Boolean(gatewayConfigured && gwToken && (doGateway || runFullWizard));\n\n  if (showGatewaySummary && gwToken) {\n    const webuiUrl = `http://${displayHost}:${port}?token=${gwToken}`;\n    console.log('🌐 Web console (browser) — start here');\n    console.log(`   Open: http://${displayHost}:${port}`);\n    console.log(`   Token: ${gwToken.slice(0, 8)}...${gwToken.slice(-8)}`);\n    console.log('   Bookmark link (token is saved in the browser when you open it):');\n    console.log(`   ${webuiUrl}`);\n    console.log('');\n  }\n\n  if (runFullWizard) {\n    console.log('🚀 Next steps:');\n    if (gatewayConfigured) {\n      console.log('  1. Choose how to launch below (gateway or terminal UI)');\n      console.log('  2. Or chat with: xopc agent -i');\n      console.log('  3. Optional: read BOOTSTRAP.md in your workspace for workspace tips');\n    } else {\n      console.log('  1. Chat in the terminal: xopc agent -i');\n      console.log('  2. Optional: add the Web console: xopc onboard --gateway');\n      console.log('  3. Optional: read BOOTSTRAP.md in your workspace');\n    }\n    console.log('');\n  } else if (doGateway && gatewayConfigured) {\n    console.log('🚀 Next step:');\n    console.log('  Start the gateway if it is not running, then open the Web console URL above.');\n    console.log('');\n  }\n\n  console.log('📝 Usage:');\n  console.log('  xopc agent -m \"Hello\"    # Chat with AI');\n  console.log('  xopc agent -i            # Interactive mode');\n  console.log('  xopc models list         # List models');\n  console.log('  xopc config validate     # Validate xopc.json');\n  console.log('  xopc auth list           # View authentication');\n  console.log('  xopc init                # Full state dirs (if upgrading or missing data)');\n\n  console.log('\\n📁 Files:');\n  console.log('  Config:', configPath);\n  console.log('  Workspace:', workspacePath);\n  if (runFullWizard) {\n    console.log(\n      '  BOOTSTRAP.md (origin story):',\n      join(resolveAgentProfileDir(config as Config, resolveDefaultAgentId(config as Config)), WORKSPACE_FILES.BOOTSTRAP),\n    );\n  }\n\n  if (isInteractive() && didConfigurableSteps) {\n    await promptLaunchAfterOnboard(config as Config, ctx, { doChannels });\n  }\n\n  process.exit(0);\n}\n\nasync function startGatewayAsService(config: Config, ctx: CLIContext): Promise<void> {\n  const { startGatewayNow } = await import('./onboard/gateway.js');\n  await startGatewayNow(config, ctx);\n}\n\nasync function promptLaunchAfterOnboard(\n  config: Config,\n  ctx: CLIContext,\n  flags: { doChannels: boolean },\n): Promise<void> {\n  console.log('');\n  const choice = await select<'tui' | 'gateway' | 'none'>({\n    message: 'How do you want to launch xopc now?',\n    choices: [\n      {\n        value: 'tui',\n        name: 'Terminal UI (embedded)',\n        description: 'xopc tui --local — no gateway process required',\n      },\n      {\n        value: 'gateway',\n        name: 'Gateway WebUI (OS service)',\n        description: 'Install and start the HTTP gateway for the browser console',\n      },\n      {\n        value: 'none',\n        name: 'Exit — I will start manually',\n        description: 'Finish setup without starting a runtime',\n      },\n    ],\n    default: 'tui',\n  });\n\n  if (choice === 'gateway') {\n    await startGatewayAsService(config, ctx);\n    return;\n  }\n\n  if (choice === 'tui') {\n    if (flags.doChannels && !isWeixinOnboardConfigured(config)) {\n      console.log(\n        colors.gray(\n          '\\n💡 Weixin is not logged in yet. When ready run: xopc channels login --channel weixin\\n',\n        ),\n      );\n    }\n    const { runTui } = await import('../../tui/tui.js');\n    await runTui({ local: true });\n    return;\n  }\n\n  console.log('\\n⏭️  You can start later:');\n  console.log('   xopc gateway service install');\n  console.log('   xopc gateway');\n  console.log('   xopc tui --local');\n}\n\nasync function setupGateway(config: Config): Promise<Config> {\n  console.log(colors.cyan('\\n🌐 Gateway WebUI\\n'));\n  console.log(\n    colors.gray(\n      'Applying defaults from config schema (127.0.0.1:18790, token auth; token generated if missing).\\n',\n    ),\n  );\n\n  const gw = config.gateway ?? {};\n  const { randomBytes } = await import('node:crypto');\n  const authMode = gw.auth?.mode === 'none' ? ('none' as const) : ('token' as const);\n  const token =\n    authMode === 'token'\n      ? typeof gw.auth?.token === 'string' && gw.auth.token.length > 0\n        ? gw.auth.token\n        : randomBytes(24).toString('hex')\n      : undefined;\n\n  const merged: Config = {\n    ...config,\n    gateway: {\n      ...gw,\n      bind: gw.bind ?? 'loopback',\n      port: gw.port ?? 18790,\n      auth:\n        authMode === 'none'\n          ? { mode: 'none' as const }\n          : { mode: 'token' as const, token: token! },\n    },\n  };\n\n  const parsed = ConfigSchema.parse(merged);\n  console.log('✅ Gateway defaults applied.\\n');\n  return parsed;\n}\n\nregister({\n  id: 'onboard',\n  name: 'onboard',\n  description: 'Interactive setup wizard',\n  factory: createOnboardCommand,\n  metadata: {\n    category: 'setup',\n    examples: ['xopc onboard', 'xopc onboard --model', 'xopc onboard --channels'],\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"onboard.js","names":["runModelSetup","runChannelOnboard"],"sources":["../../../../src/cli/commands/onboard.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { select } from '@inquirer/prompts';\nimport { saveConfig } from '../../config/index.js';\nimport { register, formatExamples } from '../registry.js';\nimport type { CLIContext } from '../registry.js';\nimport type { Config } from '../../config/schema.js';\nimport { setupModel as runModelSetup } from './onboard/model.js';\nimport { colors } from '../utils/colors.js';\nimport { setupChannels as runChannelOnboard, getChannelConfigurators } from './onboard/channels/index.js';\nimport { seedMainAgentProfileMarkdown } from '../../agent/context/workspace-seed.js';\nimport { resolveGatewayLocalClientHost } from '../../config/gateway-bind.js';\nimport { initWorkspace } from '../utils/init-workspace.js';\nimport { ConfigSchema } from '../../config/schema.js';\nimport { isWeixinOnboardConfigured } from '../../../extensions/weixin/src/adapters/onboard-cli.js';\n\nfunction isInteractive(): boolean {\n  return process.stdin.isTTY && process.stdout.isTTY;\n}\n\nasync function setupNonInteractive(_configPath: string, existingConfig: Config): Promise<Config> {\n  console.log('\\n🤖 AI Model Configuration (Non-Interactive Mode)\\n');\n  console.log('Current config:', JSON.stringify(existingConfig.agents?.defaults?.model, null, 2));\n  console.log('\\n💡 To configure in interactive mode, run: xopc onboard');\n  console.log('💡 Or set up manually in:', _configPath);\n  return existingConfig;\n}\n\nfunction createOnboardCommand(ctx: CLIContext): Command {\n  const cmd = new Command('onboard')\n    .description('Interactive setup wizard for xopc (gateway uses schema defaults)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc onboard              # Full interactive setup',\n        'xopc onboard --model      # Configure LLM model only',\n        'xopc onboard --channels   # Configure channels (incl. Weixin QR)',\n        'xopc onboard --gateway    # Apply default gateway settings (quiet)',\n      ])\n    )\n    .option('--model', 'Configure LLM provider and model')\n    .option('--channels', 'Configure messaging channels')\n    .option('--gateway', 'Configure gateway WebUI')\n    .option('--all', 'Configure everything (default)')\n    .action(async (options) => {\n      try {\n        await runOnboard(options, ctx);\n      } catch (error: unknown) {\n        const err = error as { name?: string; code?: string };\n        if (err?.name === 'ExitPromptError' || err?.code === 'EXIT_PROMPT') {\n          console.log('\\n\\n👋 Setup cancelled.');\n          process.exit(0);\n        }\n        throw error;\n      }\n    });\n\n  return cmd;\n}\n\ntype OnboardOptions = {\n  model?: boolean;\n  channels?: boolean;\n  gateway?: boolean;\n  all?: boolean;\n};\n\nasync function runOnboard(\n  options: OnboardOptions,\n  ctx: CLIContext\n): Promise<void> {\n  console.log(colors.cyan('\\n🚀 Welcome to xopc setup!\\n'));\n  console.log('═'.repeat(50));\n\n  const workspacePath = ctx.workspacePath;\n  const configPath = ctx.configPath;\n\n  const initResult = await initWorkspace({ configPath, workspacePath });\n  let config = initResult.config;\n\n  // Determine what to configure based on options\n  const doModel = options.model || options.all || (!options.channels && !options.gateway);\n  const doChannels = options.channels || options.all || (!options.model && !options.gateway);\n  const doGateway = options.gateway || options.all || (!options.model && !options.channels);\n  const runFullWizard = !options.model && !options.channels && !options.gateway;\n  /** Any setup step besides the unified launch prompt ran in interactive flow. */\n  const didConfigurableSteps = doModel || doChannels || doGateway;\n\n  if (!isInteractive()) {\n    // Non-interactive mode\n    if (doModel) {\n      config = await setupNonInteractive(configPath, config);\n    }\n    if (doChannels) {\n      console.log('\\n💬 Channels Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure channels, edit the config file manually.');\n    }\n    if (doGateway) {\n      console.log('\\n🌐 Gateway Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure gateway, edit the config file manually.');\n    }\n  } else {\n    // Interactive mode\n    if (doModel) {\n      config = await runModelSetup(config, ctx);\n    }\n\n    if (doChannels) {\n      const channelIds = getChannelConfigurators().map(c => c.id);\n      console.log(colors.gray(`\\nChannel onboarding: ${channelIds.join(', ')}\\n`));\n      config = await runChannelOnboard(config);\n    }\n\n    if (doGateway) {\n      config = await setupGateway(config);\n    }\n  }\n\n  // Save config once at the end\n  await saveConfig(config as Config, configPath);\n\n  seedMainAgentProfileMarkdown(config as Config);\n\n  console.log('\\n' + '═'.repeat(50));\n  console.log('\\n🎉 Setup Complete!\\n');\n\n  const gatewayAuth = (config as any)?.gateway?.auth;\n  const gatewayConfigured =\n    gatewayAuth?.mode === 'token' &&\n    typeof gatewayAuth?.token === 'string' &&\n    gatewayAuth.token.length > 0;\n  const port = (config as Config)?.gateway?.port ?? 18790;\n  const displayHost = resolveGatewayLocalClientHost(config as Config);\n  const gwToken = gatewayConfigured ? (gatewayAuth.token as string) : undefined;\n\n  const showGatewaySummary = Boolean(gatewayConfigured && gwToken && (doGateway || runFullWizard));\n\n  if (showGatewaySummary && gwToken) {\n    const webuiUrl = `http://${displayHost}:${port}?token=${gwToken}`;\n    console.log('🌐 Web console (browser) — start here');\n    console.log(`   Open: http://${displayHost}:${port}`);\n    console.log(`   Token: ${gwToken.slice(0, 8)}...${gwToken.slice(-8)}`);\n    console.log('   Bookmark link (token is saved in the browser when you open it):');\n    console.log(`   ${webuiUrl}`);\n    console.log('');\n  }\n\n  if (runFullWizard) {\n    console.log('🚀 Next steps:');\n    if (gatewayConfigured) {\n      console.log('  1. Choose how to launch below (gateway or terminal UI)');\n      console.log('  2. Or chat with: xopc agent -i');\n    } else {\n      console.log('  1. Chat in the terminal: xopc agent -i');\n      console.log('  2. Optional: add the Web console: xopc onboard --gateway');\n    }\n    console.log('');\n  } else if (doGateway && gatewayConfigured) {\n    console.log('🚀 Next step:');\n    console.log('  Start the gateway if it is not running, then open the Web console URL above.');\n    console.log('');\n  }\n\n  console.log('📝 Usage:');\n  console.log('  xopc agent -m \"Hello\"    # Chat with AI');\n  console.log('  xopc agent -i            # Interactive mode');\n  console.log('  xopc models list         # List models');\n  console.log('  xopc config validate     # Validate xopc.json');\n  console.log('  xopc auth list           # View authentication');\n  console.log('  xopc init                # Full state dirs (if upgrading or missing data)');\n\n  console.log('\\n📁 Files:');\n  console.log('  Config:', configPath);\n  console.log('  Workspace:', workspacePath);\n\n  if (isInteractive() && didConfigurableSteps) {\n    await promptLaunchAfterOnboard(config as Config, ctx, { doChannels });\n  }\n\n  process.exit(0);\n}\n\nasync function startGatewayAsService(config: Config, ctx: CLIContext): Promise<void> {\n  const { startGatewayNow } = await import('./onboard/gateway.js');\n  await startGatewayNow(config, ctx);\n}\n\nasync function promptLaunchAfterOnboard(\n  config: Config,\n  ctx: CLIContext,\n  flags: { doChannels: boolean },\n): Promise<void> {\n  console.log('');\n  const choice = await select<'tui' | 'gateway' | 'none'>({\n    message: 'How do you want to launch xopc now?',\n    choices: [\n      {\n        value: 'tui',\n        name: 'Terminal UI (embedded)',\n        description: 'xopc tui --local — no gateway process required',\n      },\n      {\n        value: 'gateway',\n        name: 'Gateway WebUI (OS service)',\n        description: 'Install and start the HTTP gateway for the browser console',\n      },\n      {\n        value: 'none',\n        name: 'Exit — I will start manually',\n        description: 'Finish setup without starting a runtime',\n      },\n    ],\n    default: 'tui',\n  });\n\n  if (choice === 'gateway') {\n    await startGatewayAsService(config, ctx);\n    return;\n  }\n\n  if (choice === 'tui') {\n    if (flags.doChannels && !isWeixinOnboardConfigured(config)) {\n      console.log(\n        colors.gray(\n          '\\n💡 Weixin is not logged in yet. When ready run: xopc channels login --channel weixin\\n',\n        ),\n      );\n    }\n    const { runTui } = await import('../../tui/tui.js');\n    await runTui({ local: true });\n    return;\n  }\n\n  console.log('\\n⏭️  You can start later:');\n  console.log('   xopc gateway service install');\n  console.log('   xopc gateway');\n  console.log('   xopc tui --local');\n}\n\nasync function setupGateway(config: Config): Promise<Config> {\n  console.log(colors.cyan('\\n🌐 Gateway WebUI\\n'));\n  console.log(\n    colors.gray(\n      'Applying defaults from config schema (127.0.0.1:18790, token auth; token generated if missing).\\n',\n    ),\n  );\n\n  const gw = config.gateway ?? {};\n  const { randomBytes } = await import('node:crypto');\n  const authMode = gw.auth?.mode === 'none' ? ('none' as const) : ('token' as const);\n  const token =\n    authMode === 'token'\n      ? typeof gw.auth?.token === 'string' && gw.auth.token.length > 0\n        ? gw.auth.token\n        : randomBytes(24).toString('hex')\n      : undefined;\n\n  const merged: Config = {\n    ...config,\n    gateway: {\n      ...gw,\n      bind: gw.bind ?? 'loopback',\n      port: gw.port ?? 18790,\n      auth:\n        authMode === 'none'\n          ? { mode: 'none' as const }\n          : { mode: 'token' as const, token: token! },\n    },\n  };\n\n  const parsed = ConfigSchema.parse(merged);\n  console.log('✅ Gateway defaults applied.\\n');\n  return parsed;\n}\n\nregister({\n  id: 'onboard',\n  name: 'onboard',\n  description: 'Interactive setup wizard',\n  factory: createOnboardCommand,\n  metadata: {\n    category: 'setup',\n    examples: ['xopc onboard', 'xopc onboard --model', 'xopc onboard --channels'],\n  },\n});\n"],"mappings":"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"}

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

@@ -2,18 +2,11 @@
  * Workspace template files for onboarding.
  * Templates are stored in docs/reference/templates/ and loaded at runtime.
  */
-/** All template file names (for loading / caching). */
-export declare const TEMPLATE_FILES: readonly ["SOUL.md", "IDENTITY.md", "USER.md", "TOOLS.md", "AGENTS.md", "HEARTBEAT.md", "MEMORY.md", "BOOTSTRAP.md"];
+/** 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 type TemplateFile = (typeof TEMPLATE_FILES)[number];
-/**
- * Profile Markdown templates (system-prompt stack, excluding BOOTSTRAP.md).
- * Seeded by seedAgentProfileMarkdownFiles / seedMainAgentProfileMarkdown.
- */
+/** Alias for profile Markdown templates used by seed helpers. */
 export declare const PROFILE_MARKDOWN_TEMPLATE_FILES: readonly TemplateFile[];
-/**
- * Onboarding guide template (seeded into the Markdown workspace root as `BOOTSTRAP.md`).
- */
-export declare const WORKSPACE_TEMPLATE_FILES: readonly TemplateFile[];
 /**
  * Load a template file. Caches results for repeated access.
  */

package/dist/src/cli/templates.js

@@ -7,22 +7,8 @@ import { fileURLToPath } from "url";
 * Templates are stored in docs/reference/templates/ and loaded at runtime.
 */
 const __dirname = dirname(fileURLToPath(import.meta.url));
-/** All template file names (for loading / caching). */
+/** Profile Markdown template file names (seeded into `agents/<id>/profile/`). */
 const TEMPLATE_FILES = [
-	"SOUL.md",
-	"IDENTITY.md",
-	"USER.md",
-	"TOOLS.md",
-	"AGENTS.md",
-	"HEARTBEAT.md",
-	"MEMORY.md",
-	"BOOTSTRAP.md"
-];
-/**
-* Profile Markdown templates (system-prompt stack, excluding BOOTSTRAP.md).
-* Seeded by seedAgentProfileMarkdownFiles / seedMainAgentProfileMarkdown.
-*/
-const PROFILE_MARKDOWN_TEMPLATE_FILES = [
 	"SOUL.md",
 	"IDENTITY.md",
 	"USER.md",
@@ -31,10 +17,8 @@ const PROFILE_MARKDOWN_TEMPLATE_FILES = [
 	"HEARTBEAT.md",
 	"MEMORY.md"
 ];
-/**
-* Onboarding guide template (seeded into the Markdown workspace root as `BOOTSTRAP.md`).
-*/
-const WORKSPACE_TEMPLATE_FILES = ["BOOTSTRAP.md"];
+/** Alias for profile Markdown templates used by seed helpers. */
+const PROFILE_MARKDOWN_TEMPLATE_FILES = [...TEMPLATE_FILES];
 /** Template content cache */
 const templateCache = /* @__PURE__ */ new Map();
 /**
@@ -81,18 +65,6 @@ function clearTemplateCache() {
 /** Minimal fallback templates in case files are missing */
 function getFallbackTemplate(name) {
 	return {
-		"BOOTSTRAP.md": `# BOOTSTRAP.md - Hello, World
-
-_You just woke up. Time to figure out who you are._
-
-Start with something like:
-
-> "Hey. I just came online. Who am I? Who are you?"
-
-Then figure out together your name, nature, vibe, and emoji.
-
-Delete this file when done.
-`,
 		"AGENTS.md": `# AGENTS.md - Your Workspace
 
 This folder is home. Treat it that way.
@@ -190,6 +162,6 @@ _Your curated memories._
 	}[name] || `# ${name}\n\n(Template content missing)\n`;
 }
 //#endregion
-export { PROFILE_MARKDOWN_TEMPLATE_FILES, TEMPLATE_FILES, WORKSPACE_TEMPLATE_FILES, clearTemplateCache, getFallbackTemplate, loadAllTemplates, loadTemplate };
+export { PROFILE_MARKDOWN_TEMPLATE_FILES, TEMPLATE_FILES, clearTemplateCache, getFallbackTemplate, loadAllTemplates, loadTemplate };
 
 //# sourceMappingURL=templates.js.map

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/** All template file names (for loading / caching). */\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  'BOOTSTRAP.md',\n] as const;\n\nexport type TemplateFile = (typeof TEMPLATE_FILES)[number];\n\n/**\n * Profile Markdown templates (system-prompt stack, excluding BOOTSTRAP.md).\n * Seeded by seedAgentProfileMarkdownFiles / seedMainAgentProfileMarkdown.\n */\nexport const PROFILE_MARKDOWN_TEMPLATE_FILES: readonly TemplateFile[] = [\n  'SOUL.md',\n  'IDENTITY.md',\n  'USER.md',\n  'TOOLS.md',\n  'AGENTS.md',\n  'HEARTBEAT.md',\n  'MEMORY.md',\n];\n\n/**\n * Onboarding guide template (seeded into the Markdown workspace root as `BOOTSTRAP.md`).\n */\nexport const WORKSPACE_TEMPLATE_FILES: readonly TemplateFile[] = ['BOOTSTRAP.md'];\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    'BOOTSTRAP.md': `# BOOTSTRAP.md - Hello, World\n\n_You just woke up. Time to figure out who you are._\n\nStart with something like:\n\n> \"Hey. I just came online. Who am I? Who are you?\"\n\nThen figure out together your name, nature, vibe, and emoji.\n\nDelete this file when done.\n`,\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;CACA;CACD;;;;;AAQD,MAAa,kCAA2D;CACtE;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;AAKD,MAAa,2BAAoD,CAAC,eAAe;;AAGjF,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;AA8G9D,QAAO;EA5GL,gBAAgB;;;;;;;;;;;;EAYhB,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  '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"}

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

@@ -28,7 +28,6 @@ export declare const WORKSPACE_FILES: {
     readonly TOOLS: "TOOLS.md";
     readonly HEARTBEAT: "HEARTBEAT.md";
     readonly MEMORY: "MEMORY.md";
-    readonly BOOTSTRAP: "BOOTSTRAP.md";
 };
 /**
  * Resolve the main config file path

package/dist/src/config/paths.js

@@ -334,8 +334,7 @@ var init_paths = __esmMin((() => {
 		AGENTS: "AGENTS.md",
 		TOOLS: "TOOLS.md",
 		HEARTBEAT: "HEARTBEAT.md",
-		MEMORY: "MEMORY.md",
-		BOOTSTRAP: "BOOTSTRAP.md"
+		MEMORY: "MEMORY.md"
 	};
 }));
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"paths.js","names":["resolveAgentDirScoped","resolveAgentHomeScoped","resolveAgentProfileDirScoped","resolveAgentProfileMarkdownPathScoped"],"sources":["../../../src/config/paths.ts"],"sourcesContent":["import { join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { dirname } from 'path';\nimport { existsSync } from 'fs';\n\nimport type { Config } from './schema.js';\nimport {\n  resolveAgentDir as resolveAgentDirScoped,\n  resolveAgentHomeDir as resolveAgentHomeScoped,\n  resolveAgentProfileDir as resolveAgentProfileDirScoped,\n  resolveAgentProfileMarkdownPath as resolveAgentProfileMarkdownPathScoped,\n  resolveAgentWorkspaceDir,\n} from '../agent/agent-scope.js';\nimport { ENV_VARS, resolveStateDir } from './paths-state.js';\n\nexport { ENV_VARS, resolveHomeDir, resolveStateDir, resolveXopcDatabasePath, XOPC_DB_FILENAME } from './paths-state.js';\nexport { resolveDefaultAgentWorkspaceDir } from './workspace-defaults.js';\nexport {\n  resolveAgentWorkspaceDir,\n  resolveAgentDir as resolveAgentDirFromConfig,\n  resolveAgentHomeDir as resolveAgentHomeDirFromConfig,\n} from '../agent/agent-scope.js';\n\n// ============================================\n// File Names\n// ============================================\nexport const FILENAMES = {\n  CONFIG: 'xopc.json',\n  MODELS_JSON: 'models.json',\n  AGENT_JSON: 'agent.json',\n  /** Primary SQLite state database (`~/.xopc/xopc.db`). */\n  XOPC_DB: 'xopc.db',\n  EXTENSIONS_LOCK: 'extensions-lock.json',\n  CREDENTIALS_PROFILES: 'auth-profiles.json',\n  CRON_JOBS: 'jobs.json',\n  WORKSPACE_STATE: 'workspace.json',\n  SKILLS_CACHE: 'skills-cache.json',\n  /** Hub / CLI install provenance for ~/.xopc/skills/<id>. */\n  SKILLS_LOCK: 'skills-lock.json',\n  PID: 'pid',\n  STATUS: 'status.json',\n  SOCKET: 'agent.sock',\n} as const;\n\n// ============================================\n// Workspace Files\n// ============================================\nexport const WORKSPACE_FILES = {\n  SOUL: 'SOUL.md',\n  IDENTITY: 'IDENTITY.md',\n  USER: 'USER.md',\n  AGENTS: 'AGENTS.md',\n  TOOLS: 'TOOLS.md',\n  HEARTBEAT: 'HEARTBEAT.md',\n  MEMORY: 'MEMORY.md',\n  BOOTSTRAP: 'BOOTSTRAP.md',\n} as const;\n\n// ============================================\n// Path Resolution Functions\n// ============================================\n\n/**\n * Resolve the main config file path\n */\nexport function resolveConfigPath(): string {\n  return process.env[ENV_VARS.CONFIG_PATH] ?? join(resolveStateDir(), FILENAMES.CONFIG);\n}\n\n/**\n * Resolve the credentials directory\n */\nexport function resolveCredentialsDir(): string {\n  return process.env[ENV_VARS.CREDENTIALS_DIR] ?? join(resolveStateDir(), 'credentials');\n}\n\n/**\n * Resolve the global auth-profiles.json path\n */\nexport function resolveAuthProfilesPath(): string {\n  return join(resolveCredentialsDir(), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve OAuth token file path for a provider\n */\nexport function resolveOAuthPath(provider: string): string {\n  return join(resolveCredentialsDir(), 'oauth', `${provider}.json`);\n}\n\n/**\n * Internal agent state dir: `stateDir/agents/<id>/agent/`\n * (credentials, inbox IPC, pid, agent.json — not the Markdown workspace).\n */\nexport function resolveAgentDir(config: Config, agentId: string): string {\n  return resolveAgentDirScoped(config, agentId);\n}\n\n/**\n * Per-agent home: `stateDir/agents/<id>/` (sessions + `agent/`).\n */\nexport function resolveAgentHomeDir(config: Config, agentId: string): string {\n  return resolveAgentHomeScoped(config, agentId);\n}\n\n/** Agent profile Markdown root: `stateDir/agents/<id>/profile/`. */\nexport function resolveAgentProfileDir(config: Config, agentId: string): string {\n  return resolveAgentProfileDirScoped(config, agentId);\n}\n\n/** Single file under {@link resolveAgentProfileDir} (basename only). */\nexport function resolveAgentProfileMarkdownPath(config: Config, agentId: string, filename: string): string {\n  return resolveAgentProfileMarkdownPathScoped(config, agentId, filename);\n}\n\n/**\n * Resolve a profile system Markdown path (SOUL.md, …) under the agent `profile/` directory.\n */\nexport function resolveWorkspaceFile(config: Config, filename: string, agentId: string): string {\n  return join(resolveAgentProfileDirScoped(config, agentId), filename);\n}\n\n/**\n * OpenClaw-aligned: per-agent auth-profiles.json directly under agent dir (no credentials subdirectory).\n */\nexport function resolveAgentAuthProfilesPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve the inbox directory for an agent\n */\nexport function resolveInboxDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'inbox');\n}\n\n/**\n * Resolve the pending inbox directory\n */\nexport function resolveInboxPendingDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'pending');\n}\n\n/**\n * Resolve the processed inbox directory\n */\nexport function resolveInboxProcessedDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'processed');\n}\n\n/**\n * Resolve a specific inbox message path\n */\nexport function resolveInboxMessagePath(\n  config: Config,\n  messageId: string,\n  pending: boolean,\n  agentId: string,\n): string {\n  const dir = pending ? resolveInboxPendingDir(config, agentId) : resolveInboxProcessedDir(config, agentId);\n  return join(dir, `${messageId}.json`);\n}\n\n/**\n * Resolve the pid file path\n */\nexport function resolvePidPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.PID);\n}\n\n/**\n * Resolve the status.json path\n */\nexport function resolveStatusPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.STATUS);\n}\n\n/**\n * Resolve the Unix socket path\n */\nexport function resolveSocketPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.SOCKET);\n}\n\n/**\n * Resolve the extensions directory (global)\n */\nexport function resolveExtensionsDir(): string {\n  return join(resolveStateDir(), 'extensions');\n}\n\n/**\n * Resolve the extensions lockfile path\n */\nexport function resolveExtensionsLockPath(): string {\n  return join(resolveExtensionsDir(), FILENAMES.EXTENSIONS_LOCK);\n}\n\n/**\n * Per-agent extensions directory (`…/agents/<id>/agent/extensions/`) — used for discovery of\n * legacy or manually placed copies. CLI, web store, and `extensions dev` symlink installs use\n * {@link resolveExtensionsDir} (`~/.xopc/extensions`) only.\n */\nexport function resolveWorkspaceExtensionsDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'extensions');\n}\n\n/**\n * Resolve the skills directory (global)\n */\nexport function resolveSkillsDir(): string {\n  return join(resolveStateDir(), 'skills');\n}\n\n/**\n * Resolve a specific skill path\n */\nexport function resolveSkillPath(skillId: string): string {\n  return join(resolveSkillsDir(), skillId, 'SKILL.md');\n}\n\n/**\n * Skills hub lock file (~/.xopc/skills-lock.json): install source + content hash per managed skill id.\n */\nexport function resolveSkillsLockPath(): string {\n  return join(resolveStateDir(), FILENAMES.SKILLS_LOCK);\n}\n\n/**\n * Resolve the cron directory\n */\nexport function resolveCronDir(): string {\n  return join(resolveStateDir(), 'cron');\n}\n\n/**\n * Resolve the cron jobs file path\n */\nexport function resolveCronJobsPath(): string {\n  return join(resolveCronDir(), FILENAMES.CRON_JOBS);\n}\n\n/**\n * Resolve the logs directory\n */\nexport function resolveLogsDir(): string {\n  return process.env[ENV_VARS.LOG_DIR] ?? join(resolveStateDir(), 'logs');\n}\n\n/**\n * Resolve a specific log file path\n */\nexport function resolveLogPath(date: string): string {\n  return join(resolveLogsDir(), `xopc-${date}.log`);\n}\n\n/**\n * Resolve the bin directory\n */\nexport function resolveBinDir(): string {\n  return join(resolveStateDir(), 'bin');\n}\n\n/**\n * Resolve the xopc CLI path\n */\nexport function resolveXopcBinPath(): string {\n  return join(resolveBinDir(), 'xopc');\n}\n\n/**\n * Resolve the tools directory\n */\nexport function resolveToolsDir(): string {\n  return join(resolveStateDir(), 'tools');\n}\n\n/**\n * Resolve the Node.js tools directory\n */\nexport function resolveNodeToolsDir(): string {\n  return join(resolveToolsDir(), 'node');\n}\n\n/**\n * Resolve the current Node.js bin directory\n */\nexport function resolveNodeBinDir(): string {\n  return join(resolveNodeToolsDir(), 'current', 'bin');\n}\n\n/**\n * Resolve the node binary path\n */\nexport function resolveNodeBinPath(): string {\n  return join(resolveNodeBinDir(), 'node');\n}\n\n/**\n * Resolve the npm binary path\n */\nexport function resolveNpmBinPath(): string {\n  return join(resolveNodeBinDir(), 'npm');\n}\n\n/**\n * Resolve the models.json path\n */\nexport function resolveModelsJsonPath(): string {\n  return join(resolveStateDir(), FILENAMES.MODELS_JSON);\n}\n\n/**\n * Resolve the agent metadata file path\n */\nexport function resolveAgentMetadataPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.AGENT_JSON);\n}\n\n/**\n * OpenClaw-aligned: workspace setup state directory (`<workspace>/.xopc/`).\n */\nexport function resolveWorkspaceStateDir(config: Config, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), '.xopc');\n}\n\n/**\n * OpenClaw-aligned: workspace setup state file (`<workspace>/.xopc/workspace.json`).\n */\nexport function resolveWorkspaceStatePath(config: Config, agentId: string): string {\n  return join(resolveWorkspaceStateDir(config, agentId), FILENAMES.WORKSPACE_STATE);\n}\n\n/**\n * Resolve the skills cache file path (internal agent state, under agent dir).\n */\nexport function resolveSkillsCachePath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'state', FILENAMES.SKILLS_CACHE);\n}\n\n/**\n * Resolve the memory directory\n */\nexport function resolveMemoryDir(config: Config, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), 'memory');\n}\n\n/**\n * Resolve a specific memory file path\n */\nexport function resolveMemoryPath(config: Config, date: string, agentId: string): string {\n  return join(resolveMemoryDir(config, agentId), `${date}.md`);\n}\n\n/**\n * Resolve the bundled extensions directory (shipped with xopc).\n *\n * Layout-dependent candidates (first existing wins):\n * - `dist/src/config` → `dist/extensions` (npm / gateway)\n * - `src/config` → `extensions/` (dev, tsx)\n * - `out/server` → `dist/extensions` (Electron esbuild bundle)\n */\nexport function resolveBundledExtensionsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const candidates = [\n      join(srcDir, '..', '..', 'extensions'),\n      join(srcDir, '..', '..', 'dist', 'extensions'),\n      join(srcDir, '..', '..', '..', 'extensions'),\n    ];\n    for (const dir of candidates) {\n      if (existsSync(dir)) {\n        return dir;\n      }\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve the bundled skills directory (shipped with xopc)\n */\nexport function resolveBundledSkillsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    \n    // Production (npm): dist/config/paths.js -> ../../ -> package root -> skills\n    const packageRoot = join(srcDir, '..', '..');\n    const skillsDir = join(packageRoot, 'skills');\n    if (existsSync(skillsDir)) {\n      return skillsDir;\n    }\n    \n    // Development (source): src/config/paths.js -> ../../../ -> package root -> skills\n    const devPackageRoot = join(srcDir, '..', '..', '..');\n    const devSkillsDir = join(devPackageRoot, 'skills');\n    if (existsSync(devSkillsDir)) {\n      return devSkillsDir;\n    }\n    \n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Path to extension-sdk entry (for jiti / extension loader aliases).\n */\nexport function resolveExtensionSdkPath(): string {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const adjacent = join(srcDir, '..', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(adjacent)) {\n      return adjacent;\n    }\n    const fromPackageRoot = join(srcDir, '..', '..', 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(fromPackageRoot)) {\n      return fromPackageRoot;\n    }\n    const cwd = join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(cwd)) {\n      return cwd;\n    }\n    return adjacent;\n  } catch {\n    return join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n  }\n}\n\n// Re-export existsSync for bundled paths\nexport { existsSync };\n"],"mappings":"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"}
+{"version":3,"file":"paths.js","names":["resolveAgentDirScoped","resolveAgentHomeScoped","resolveAgentProfileDirScoped","resolveAgentProfileMarkdownPathScoped"],"sources":["../../../src/config/paths.ts"],"sourcesContent":["import { join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { dirname } from 'path';\nimport { existsSync } from 'fs';\n\nimport type { Config } from './schema.js';\nimport {\n  resolveAgentDir as resolveAgentDirScoped,\n  resolveAgentHomeDir as resolveAgentHomeScoped,\n  resolveAgentProfileDir as resolveAgentProfileDirScoped,\n  resolveAgentProfileMarkdownPath as resolveAgentProfileMarkdownPathScoped,\n  resolveAgentWorkspaceDir,\n} from '../agent/agent-scope.js';\nimport { ENV_VARS, resolveStateDir } from './paths-state.js';\n\nexport { ENV_VARS, resolveHomeDir, resolveStateDir, resolveXopcDatabasePath, XOPC_DB_FILENAME } from './paths-state.js';\nexport { resolveDefaultAgentWorkspaceDir } from './workspace-defaults.js';\nexport {\n  resolveAgentWorkspaceDir,\n  resolveAgentDir as resolveAgentDirFromConfig,\n  resolveAgentHomeDir as resolveAgentHomeDirFromConfig,\n} from '../agent/agent-scope.js';\n\n// ============================================\n// File Names\n// ============================================\nexport const FILENAMES = {\n  CONFIG: 'xopc.json',\n  MODELS_JSON: 'models.json',\n  AGENT_JSON: 'agent.json',\n  /** Primary SQLite state database (`~/.xopc/xopc.db`). */\n  XOPC_DB: 'xopc.db',\n  EXTENSIONS_LOCK: 'extensions-lock.json',\n  CREDENTIALS_PROFILES: 'auth-profiles.json',\n  CRON_JOBS: 'jobs.json',\n  WORKSPACE_STATE: 'workspace.json',\n  SKILLS_CACHE: 'skills-cache.json',\n  /** Hub / CLI install provenance for ~/.xopc/skills/<id>. */\n  SKILLS_LOCK: 'skills-lock.json',\n  PID: 'pid',\n  STATUS: 'status.json',\n  SOCKET: 'agent.sock',\n} as const;\n\n// ============================================\n// Workspace Files\n// ============================================\nexport const WORKSPACE_FILES = {\n  SOUL: 'SOUL.md',\n  IDENTITY: 'IDENTITY.md',\n  USER: 'USER.md',\n  AGENTS: 'AGENTS.md',\n  TOOLS: 'TOOLS.md',\n  HEARTBEAT: 'HEARTBEAT.md',\n  MEMORY: 'MEMORY.md',\n} as const;\n\n// ============================================\n// Path Resolution Functions\n// ============================================\n\n/**\n * Resolve the main config file path\n */\nexport function resolveConfigPath(): string {\n  return process.env[ENV_VARS.CONFIG_PATH] ?? join(resolveStateDir(), FILENAMES.CONFIG);\n}\n\n/**\n * Resolve the credentials directory\n */\nexport function resolveCredentialsDir(): string {\n  return process.env[ENV_VARS.CREDENTIALS_DIR] ?? join(resolveStateDir(), 'credentials');\n}\n\n/**\n * Resolve the global auth-profiles.json path\n */\nexport function resolveAuthProfilesPath(): string {\n  return join(resolveCredentialsDir(), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve OAuth token file path for a provider\n */\nexport function resolveOAuthPath(provider: string): string {\n  return join(resolveCredentialsDir(), 'oauth', `${provider}.json`);\n}\n\n/**\n * Internal agent state dir: `stateDir/agents/<id>/agent/`\n * (credentials, inbox IPC, pid, agent.json — not the Markdown workspace).\n */\nexport function resolveAgentDir(config: Config, agentId: string): string {\n  return resolveAgentDirScoped(config, agentId);\n}\n\n/**\n * Per-agent home: `stateDir/agents/<id>/` (sessions + `agent/`).\n */\nexport function resolveAgentHomeDir(config: Config, agentId: string): string {\n  return resolveAgentHomeScoped(config, agentId);\n}\n\n/** Agent profile Markdown root: `stateDir/agents/<id>/profile/`. */\nexport function resolveAgentProfileDir(config: Config, agentId: string): string {\n  return resolveAgentProfileDirScoped(config, agentId);\n}\n\n/** Single file under {@link resolveAgentProfileDir} (basename only). */\nexport function resolveAgentProfileMarkdownPath(config: Config, agentId: string, filename: string): string {\n  return resolveAgentProfileMarkdownPathScoped(config, agentId, filename);\n}\n\n/**\n * Resolve a profile system Markdown path (SOUL.md, …) under the agent `profile/` directory.\n */\nexport function resolveWorkspaceFile(config: Config, filename: string, agentId: string): string {\n  return join(resolveAgentProfileDirScoped(config, agentId), filename);\n}\n\n/**\n * OpenClaw-aligned: per-agent auth-profiles.json directly under agent dir (no credentials subdirectory).\n */\nexport function resolveAgentAuthProfilesPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve the inbox directory for an agent\n */\nexport function resolveInboxDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'inbox');\n}\n\n/**\n * Resolve the pending inbox directory\n */\nexport function resolveInboxPendingDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'pending');\n}\n\n/**\n * Resolve the processed inbox directory\n */\nexport function resolveInboxProcessedDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'processed');\n}\n\n/**\n * Resolve a specific inbox message path\n */\nexport function resolveInboxMessagePath(\n  config: Config,\n  messageId: string,\n  pending: boolean,\n  agentId: string,\n): string {\n  const dir = pending ? resolveInboxPendingDir(config, agentId) : resolveInboxProcessedDir(config, agentId);\n  return join(dir, `${messageId}.json`);\n}\n\n/**\n * Resolve the pid file path\n */\nexport function resolvePidPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.PID);\n}\n\n/**\n * Resolve the status.json path\n */\nexport function resolveStatusPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.STATUS);\n}\n\n/**\n * Resolve the Unix socket path\n */\nexport function resolveSocketPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.SOCKET);\n}\n\n/**\n * Resolve the extensions directory (global)\n */\nexport function resolveExtensionsDir(): string {\n  return join(resolveStateDir(), 'extensions');\n}\n\n/**\n * Resolve the extensions lockfile path\n */\nexport function resolveExtensionsLockPath(): string {\n  return join(resolveExtensionsDir(), FILENAMES.EXTENSIONS_LOCK);\n}\n\n/**\n * Per-agent extensions directory (`…/agents/<id>/agent/extensions/`) — used for discovery of\n * legacy or manually placed copies. CLI, web store, and `extensions dev` symlink installs use\n * {@link resolveExtensionsDir} (`~/.xopc/extensions`) only.\n */\nexport function resolveWorkspaceExtensionsDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'extensions');\n}\n\n/**\n * Resolve the skills directory (global)\n */\nexport function resolveSkillsDir(): string {\n  return join(resolveStateDir(), 'skills');\n}\n\n/**\n * Resolve a specific skill path\n */\nexport function resolveSkillPath(skillId: string): string {\n  return join(resolveSkillsDir(), skillId, 'SKILL.md');\n}\n\n/**\n * Skills hub lock file (~/.xopc/skills-lock.json): install source + content hash per managed skill id.\n */\nexport function resolveSkillsLockPath(): string {\n  return join(resolveStateDir(), FILENAMES.SKILLS_LOCK);\n}\n\n/**\n * Resolve the cron directory\n */\nexport function resolveCronDir(): string {\n  return join(resolveStateDir(), 'cron');\n}\n\n/**\n * Resolve the cron jobs file path\n */\nexport function resolveCronJobsPath(): string {\n  return join(resolveCronDir(), FILENAMES.CRON_JOBS);\n}\n\n/**\n * Resolve the logs directory\n */\nexport function resolveLogsDir(): string {\n  return process.env[ENV_VARS.LOG_DIR] ?? join(resolveStateDir(), 'logs');\n}\n\n/**\n * Resolve a specific log file path\n */\nexport function resolveLogPath(date: string): string {\n  return join(resolveLogsDir(), `xopc-${date}.log`);\n}\n\n/**\n * Resolve the bin directory\n */\nexport function resolveBinDir(): string {\n  return join(resolveStateDir(), 'bin');\n}\n\n/**\n * Resolve the xopc CLI path\n */\nexport function resolveXopcBinPath(): string {\n  return join(resolveBinDir(), 'xopc');\n}\n\n/**\n * Resolve the tools directory\n */\nexport function resolveToolsDir(): string {\n  return join(resolveStateDir(), 'tools');\n}\n\n/**\n * Resolve the Node.js tools directory\n */\nexport function resolveNodeToolsDir(): string {\n  return join(resolveToolsDir(), 'node');\n}\n\n/**\n * Resolve the current Node.js bin directory\n */\nexport function resolveNodeBinDir(): string {\n  return join(resolveNodeToolsDir(), 'current', 'bin');\n}\n\n/**\n * Resolve the node binary path\n */\nexport function resolveNodeBinPath(): string {\n  return join(resolveNodeBinDir(), 'node');\n}\n\n/**\n * Resolve the npm binary path\n */\nexport function resolveNpmBinPath(): string {\n  return join(resolveNodeBinDir(), 'npm');\n}\n\n/**\n * Resolve the models.json path\n */\nexport function resolveModelsJsonPath(): string {\n  return join(resolveStateDir(), FILENAMES.MODELS_JSON);\n}\n\n/**\n * Resolve the agent metadata file path\n */\nexport function resolveAgentMetadataPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.AGENT_JSON);\n}\n\n/**\n * OpenClaw-aligned: workspace setup state directory (`<workspace>/.xopc/`).\n */\nexport function resolveWorkspaceStateDir(config: Config, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), '.xopc');\n}\n\n/**\n * OpenClaw-aligned: workspace setup state file (`<workspace>/.xopc/workspace.json`).\n */\nexport function resolveWorkspaceStatePath(config: Config, agentId: string): string {\n  return join(resolveWorkspaceStateDir(config, agentId), FILENAMES.WORKSPACE_STATE);\n}\n\n/**\n * Resolve the skills cache file path (internal agent state, under agent dir).\n */\nexport function resolveSkillsCachePath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'state', FILENAMES.SKILLS_CACHE);\n}\n\n/**\n * Resolve the memory directory\n */\nexport function resolveMemoryDir(config: Config, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), 'memory');\n}\n\n/**\n * Resolve a specific memory file path\n */\nexport function resolveMemoryPath(config: Config, date: string, agentId: string): string {\n  return join(resolveMemoryDir(config, agentId), `${date}.md`);\n}\n\n/**\n * Resolve the bundled extensions directory (shipped with xopc).\n *\n * Layout-dependent candidates (first existing wins):\n * - `dist/src/config` → `dist/extensions` (npm / gateway)\n * - `src/config` → `extensions/` (dev, tsx)\n * - `out/server` → `dist/extensions` (Electron esbuild bundle)\n */\nexport function resolveBundledExtensionsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const candidates = [\n      join(srcDir, '..', '..', 'extensions'),\n      join(srcDir, '..', '..', 'dist', 'extensions'),\n      join(srcDir, '..', '..', '..', 'extensions'),\n    ];\n    for (const dir of candidates) {\n      if (existsSync(dir)) {\n        return dir;\n      }\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve the bundled skills directory (shipped with xopc)\n */\nexport function resolveBundledSkillsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    \n    // Production (npm): dist/config/paths.js -> ../../ -> package root -> skills\n    const packageRoot = join(srcDir, '..', '..');\n    const skillsDir = join(packageRoot, 'skills');\n    if (existsSync(skillsDir)) {\n      return skillsDir;\n    }\n    \n    // Development (source): src/config/paths.js -> ../../../ -> package root -> skills\n    const devPackageRoot = join(srcDir, '..', '..', '..');\n    const devSkillsDir = join(devPackageRoot, 'skills');\n    if (existsSync(devSkillsDir)) {\n      return devSkillsDir;\n    }\n    \n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Path to extension-sdk entry (for jiti / extension loader aliases).\n */\nexport function resolveExtensionSdkPath(): string {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const adjacent = join(srcDir, '..', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(adjacent)) {\n      return adjacent;\n    }\n    const fromPackageRoot = join(srcDir, '..', '..', 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(fromPackageRoot)) {\n      return fromPackageRoot;\n    }\n    const cwd = join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(cwd)) {\n      return cwd;\n    }\n    return adjacent;\n  } catch {\n    return join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n  }\n}\n\n// Re-export existsSync for bundled paths\nexport { existsSync };\n"],"mappings":"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"}

package/dist/src/config/schema.js

@@ -116,7 +116,7 @@ var init_schema = __esmMin((() => {
 			"always"
 		]).optional(),
 		/**
-		* Controls when bootstrap content (including BOOTSTRAP.md) is injected into the system prompt:
+		* Controls when profile bootstrap context is injected into the system prompt:
 		* - `always`: inject on every /new and /reset (default, backward-compatible)
 		* - `continuation-skip`: inject on the first turn, skip on continuation turns
 		* - `never`: never inject bootstrap content