@xopcai/xopc 0.0.127 → 0.0.129

package/dist/src/chat-commands/builtins/skill.js

@@ -0,0 +1,132 @@
+import { commandRegistry } from "../registry.js";
+//#region src/chat-commands/builtins/skill.ts
+function tokenizeArgs(input) {
+	const out = [];
+	let current = "";
+	let quote = null;
+	let escaping = false;
+	for (const ch of input) {
+		if (escaping) {
+			current += ch;
+			escaping = false;
+			continue;
+		}
+		if (ch === "\\") {
+			escaping = true;
+			continue;
+		}
+		if (quote) {
+			if (ch === quote) quote = null;
+			else current += ch;
+			continue;
+		}
+		if (ch === "\"" || ch === "'") {
+			quote = ch;
+			continue;
+		}
+		if (/\s/.test(ch)) {
+			if (current) {
+				out.push(current);
+				current = "";
+			}
+			continue;
+		}
+		current += ch;
+	}
+	if (current) out.push(current);
+	return out;
+}
+function usage() {
+	return [
+		"usage: /skill install <source> [--ref <ref>] [--path <dir>] [--id <skillId>] [--workspace|--global] [--force]",
+		"",
+		"source may be a Git URL, GitHub repository URL, https .zip/.tar.gz URL, file:// URL, or local archive/path.",
+		"Default target is the current workspace. Use --global only for personal skills shared by all projects."
+	].join("\n");
+}
+function parseInstallArgs(args) {
+	const tokens = tokenizeArgs(args);
+	const source = tokens.shift();
+	if (!source) throw new Error(usage());
+	const parsed = { source };
+	for (let i = 0; i < tokens.length; i += 1) {
+		const token = tokens[i];
+		const next = () => {
+			const value = tokens[++i];
+			if (!value) throw new Error(`Missing value for ${token}`);
+			return value;
+		};
+		if (token === "--ref") parsed.ref = next();
+		else if (token === "--path") parsed.path = next();
+		else if (token === "--id" || token === "--skill-id") parsed.skillId = next();
+		else if (token === "--workspace") parsed.target = "workspace";
+		else if (token === "--global") parsed.target = "global";
+		else if (token === "--force") parsed.force = true;
+		else if (token === "--strict-scan") parsed.strictScan = true;
+		else throw new Error(`Unknown option: ${token}\n\n${usage()}`);
+	}
+	return parsed;
+}
+const skillCommand = {
+	id: "system.skill",
+	name: "skill",
+	aliases: ["skills"],
+	description: "Install skills from explicit sources. Subcommands: install <source>",
+	category: "tool",
+	scope: ["global", "private"],
+	acceptsArgs: true,
+	examples: ["/skill install https://github.com/org/repo", "/skill install https://example.com/skill.zip --id my-skill --force"],
+	handler: async (ctx, args) => {
+		const trimmed = args.trim();
+		const [subRaw, ...rest] = trimmed ? trimmed.split(/\s+/) : [];
+		const sub = subRaw?.toLowerCase();
+		if (!sub || sub === "help") return {
+			content: usage(),
+			success: true
+		};
+		if (sub !== "install") return {
+			content: `Unknown subcommand "${subRaw}". Available: install.\n\n${usage()}`,
+			success: false
+		};
+		if (!ctx.installSkillFromSource) return {
+			content: "Skill installation is not available in this context.",
+			success: false
+		};
+		let parsed;
+		try {
+			parsed = parseInstallArgs(rest.join(" "));
+		} catch (err) {
+			return {
+				content: err instanceof Error ? err.message : String(err),
+				success: false
+			};
+		}
+		await ctx.setTyping(true);
+		try {
+			const result = await ctx.installSkillFromSource(parsed);
+			return {
+				content: [
+					`Installed skill "${result.skillId}".`,
+					`Target: ${result.target ?? parsed.target ?? "workspace"}`,
+					`Source: ${result.source} (${result.kind})`,
+					`Path: ${result.path}`,
+					`Tree hash: ${result.contentHash.slice(0, 16)}`
+				].join("\n"),
+				success: true,
+				metadata: { skillInstall: result }
+			};
+		} catch (err) {
+			return {
+				content: `Skill install failed: ${err instanceof Error ? err.message : String(err)}`,
+				success: false
+			};
+		}
+	}
+};
+function registerSkillCommand() {
+	commandRegistry.register(skillCommand);
+}
+//#endregion
+export { registerSkillCommand };
+
+//# sourceMappingURL=skill.js.map

package/dist/src/chat-commands/builtins/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","names":[],"sources":["../../../../src/chat-commands/builtins/skill.ts"],"sourcesContent":["import { commandRegistry } from '../registry.js';\nimport type { CommandContext, CommandDefinition } from '../types.js';\n\nfunction tokenizeArgs(input: string): string[] {\n  const out: string[] = [];\n  let current = '';\n  let quote: '\"' | \"'\" | null = null;\n  let escaping = false;\n  for (const ch of input) {\n    if (escaping) {\n      current += ch;\n      escaping = false;\n      continue;\n    }\n    if (ch === '\\\\') {\n      escaping = true;\n      continue;\n    }\n    if (quote) {\n      if (ch === quote) quote = null;\n      else current += ch;\n      continue;\n    }\n    if (ch === '\"' || ch === \"'\") {\n      quote = ch;\n      continue;\n    }\n    if (/\\s/.test(ch)) {\n      if (current) {\n        out.push(current);\n        current = '';\n      }\n      continue;\n    }\n    current += ch;\n  }\n  if (current) out.push(current);\n  return out;\n}\n\nfunction usage(): string {\n  return [\n    'usage: /skill install <source> [--ref <ref>] [--path <dir>] [--id <skillId>] [--workspace|--global] [--force]',\n    '',\n    'source may be a Git URL, GitHub repository URL, https .zip/.tar.gz URL, file:// URL, or local archive/path.',\n    'Default target is the current workspace. Use --global only for personal skills shared by all projects.',\n  ].join('\\n');\n}\n\ntype ParsedInstallArgs = {\n  source: string;\n  ref?: string;\n  path?: string;\n  skillId?: string;\n  target?: 'workspace' | 'global';\n  force?: boolean;\n  strictScan?: boolean;\n};\n\nfunction parseInstallArgs(args: string): ParsedInstallArgs {\n  const tokens = tokenizeArgs(args);\n  const source = tokens.shift();\n  if (!source) throw new Error(usage());\n\n  const parsed: ParsedInstallArgs = { source };\n  for (let i = 0; i < tokens.length; i += 1) {\n    const token = tokens[i];\n    const next = () => {\n      const value = tokens[++i];\n      if (!value) throw new Error(`Missing value for ${token}`);\n      return value;\n    };\n    if (token === '--ref') parsed.ref = next();\n    else if (token === '--path') parsed.path = next();\n    else if (token === '--id' || token === '--skill-id') parsed.skillId = next();\n    else if (token === '--workspace') parsed.target = 'workspace';\n    else if (token === '--global') parsed.target = 'global';\n    else if (token === '--force') parsed.force = true;\n    else if (token === '--strict-scan') parsed.strictScan = true;\n    else throw new Error(`Unknown option: ${token}\\n\\n${usage()}`);\n  }\n  return parsed;\n}\n\nconst skillCommand: CommandDefinition = {\n  id: 'system.skill',\n  name: 'skill',\n  aliases: ['skills'],\n  description: 'Install skills from explicit sources. Subcommands: install <source>',\n  category: 'tool',\n  scope: ['global', 'private'],\n  acceptsArgs: true,\n  examples: [\n    '/skill install https://github.com/org/repo',\n    '/skill install https://example.com/skill.zip --id my-skill --force',\n  ],\n  handler: async (ctx: CommandContext, args: string) => {\n    const trimmed = args.trim();\n    const [subRaw, ...rest] = trimmed ? trimmed.split(/\\s+/) : [];\n    const sub = subRaw?.toLowerCase();\n    if (!sub || sub === 'help') {\n      return { content: usage(), success: true };\n    }\n    if (sub !== 'install') {\n      return {\n        content: `Unknown subcommand \"${subRaw}\". Available: install.\\n\\n${usage()}`,\n        success: false,\n      };\n    }\n    if (!ctx.installSkillFromSource) {\n      return {\n        content: 'Skill installation is not available in this context.',\n        success: false,\n      };\n    }\n\n    let parsed: ParsedInstallArgs;\n    try {\n      parsed = parseInstallArgs(rest.join(' '));\n    } catch (err) {\n      return {\n        content: err instanceof Error ? err.message : String(err),\n        success: false,\n      };\n    }\n\n    await ctx.setTyping(true);\n    try {\n      const result = await ctx.installSkillFromSource(parsed);\n      return {\n        content: [\n          `Installed skill \"${result.skillId}\".`,\n          `Target: ${result.target ?? parsed.target ?? 'workspace'}`,\n          `Source: ${result.source} (${result.kind})`,\n          `Path: ${result.path}`,\n          `Tree hash: ${result.contentHash.slice(0, 16)}`,\n        ].join('\\n'),\n        success: true,\n        metadata: { skillInstall: result },\n      };\n    } catch (err) {\n      return {\n        content: `Skill install failed: ${err instanceof Error ? err.message : String(err)}`,\n        success: false,\n      };\n    }\n  },\n};\n\nexport function registerSkillCommand(): void {\n  commandRegistry.register(skillCommand);\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/context.d.ts

@@ -44,6 +44,8 @@ export interface CommandContextDeps {
     abortCurrentTurn?: () => Promise<void>;
     /** Reload skills from disk and refresh active agent prompts. */
     reloadSkills?: () => Promise<void>;
+    /** Install a managed skill from an explicit source and refresh active agent prompts. */
+    installSkillFromSource?: CommandContext['installSkillFromSource'];
     compactSession?: (sessionKey: string, options?: {
         instructions?: string;
         force?: boolean;
@@ -68,6 +70,7 @@ export declare class CommandContextImpl implements CommandContext {
     readonly config: Config;
     readonly abortCurrentTurn?: () => Promise<void>;
     readonly reloadSkills?: () => Promise<void>;
+    readonly installSkillFromSource?: CommandContext['installSkillFromSource'];
     readonly persistentGoalApis?: PersistentGoalApis;
     readonly workflowRunApis?: CommandContext['workflowRunApis'];
     private deps;

package/dist/src/chat-commands/context.js

@@ -25,6 +25,7 @@ var CommandContextImpl = class {
 	config;
 	abortCurrentTurn;
 	reloadSkills;
+	installSkillFromSource;
 	persistentGoalApis;
 	workflowRunApis;
 	deps;
@@ -51,6 +52,7 @@ var CommandContextImpl = class {
 				await run();
 			};
 		}
+		if (deps.installSkillFromSource) this.installSkillFromSource = deps.installSkillFromSource;
 		this.persistentGoalApis = deps.persistentGoalApis;
 		if (deps.workflowRunService) this.workflowRunApis = {
 			service: deps.workflowRunService,

package/dist/src/chat-commands/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/chat-commands/context.ts"],"sourcesContent":["/**\n * Command Context Implementation\n * \n * Provides the concrete implementation of CommandContext interface,\n * bridging commands to core services (AgentService, SessionStore, etc.)\n */\n\nimport type {\n  CommandContext,\n  ReplyOptions,\n  UIComponent,\n  SessionInfo,\n  ModelInfo,\n  UsageStats,\n  PlatformFeature,\n  MessageSource,\n  CompactSessionResult,\n} from './types.js';\nimport { getSessionDisplayName } from './session-key.js';\nimport type { Config } from '../config/schema.js';\nimport { getAgentDefaultModelRef } from '../config/schema.js';\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { SessionStore, SessionConfigStore } from '../session/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { saveConfig } from '../config/loader.js';\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';\nimport { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { effectiveWorkspacePathForSession } from '../session/session-workspace.js';\nimport { wrapMarkdownExportAsHtml } from '../session/chat-export.js';\nimport type { CompactionResult } from '../agent/memory/compaction.js';\nimport type { PersistentGoalApis } from '../agent/goals/persistent-goal-apis.js';\nimport type { WorkflowRunServiceLike } from '../workflows/service/workflow-run-service.types.js';\nimport { getProjectForSession } from '../projects/workspace.js';\n\nconst log = createLogger('CommandContext');\n\nexport interface CommandContextDeps {\n  sessionKey: string;\n  source: MessageSource;\n  channelId: string;\n  chatId: string;\n  senderId: string;\n  isGroup: boolean;\n  accountId?: string;\n  threadId?: string;\n  config: Config;\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  sessionConfigStore?: SessionConfigStore;\n  /** After persisting session thinking, sync pi-agent in-memory state */\n  applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  // Callbacks for platform-specific operations\n  replyHandler: (text: string, options?: ReplyOptions) => Promise<void>;\n  componentHandler?: (component: UIComponent) => Promise<void>;\n  typingHandler?: (typing: boolean) => Promise<void>;\n  supportedFeatures: PlatformFeature[];\n  /** Called after session files are removed so in-memory agents match disk */\n  invalidateAgentSession?: (sessionKey: string) => void;\n  /** Reset session in place (archive + new session id); optional — falls back to clearSession */\n  resetSession?: (sessionKey: string) => Promise<void>;\n  // Model management (optional, will be injected)\n  getCurrentModel?: () => string;\n  switchModel?: (modelId: string) => Promise<boolean>;\n  listModels?: () => Promise<ModelInfo[]>;\n  getUsage?: () => Promise<UsageStats>;\n  /** Stop current LLM turn and clear channel preview stream (Telegram draft, etc.) */\n  abortCurrentTurn?: () => Promise<void>;\n  /** Reload skills from disk and refresh active agent prompts. */\n  reloadSkills?: () => Promise<void>;\n\n  compactSession?: (\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ) => Promise<CompactionResult>;\n\n  btwQuery?: (sessionKey: string, question: string) => Promise<{ text: string; error?: string }>;\n\n  getSessionContextReport?: (\n    sessionKey: string,\n    mode: 'list' | 'detail' | 'json',\n  ) => Promise<string>;\n\n  persistentGoalApis?: PersistentGoalApis;\n  workflowRunService?: WorkflowRunServiceLike;\n}\n\nexport class CommandContextImpl implements CommandContext {\n  readonly sessionKey: string;\n  readonly source: MessageSource;\n  readonly channelId: string;\n  readonly chatId: string;\n  readonly senderId: string;\n  readonly isGroup: boolean;\n  readonly accountId?: string;\n  readonly threadId?: string;\n  readonly config: Config;\n  readonly abortCurrentTurn?: () => Promise<void>;\n  readonly reloadSkills?: () => Promise<void>;\n  readonly persistentGoalApis?: PersistentGoalApis;\n  readonly workflowRunApis?: CommandContext['workflowRunApis'];\n\n  private deps: CommandContextDeps;\n\n  constructor(deps: CommandContextDeps) {\n    this.sessionKey = deps.sessionKey;\n    this.source = deps.source;\n    this.channelId = deps.channelId;\n    this.chatId = deps.chatId;\n    this.senderId = deps.senderId;\n    this.isGroup = deps.isGroup;\n    this.accountId = deps.accountId;\n    this.threadId = deps.threadId;\n    this.config = deps.config;\n    this.deps = deps;\n\n    if (deps.abortCurrentTurn) {\n      const run = deps.abortCurrentTurn;\n      this.abortCurrentTurn = async () => {\n        await run();\n      };\n    }\n\n    if (deps.reloadSkills) {\n      const run = deps.reloadSkills;\n      this.reloadSkills = async () => {\n        await run();\n      };\n    }\n\n    this.persistentGoalApis = deps.persistentGoalApis;\n    if (deps.workflowRunService) {\n      this.workflowRunApis = {\n        service: deps.workflowRunService,\n        startWorkflowRun: (params) => deps.workflowRunService!.startWorkflowRun(params),\n      };\n    }\n  }\n\n  private outboundMetadata(extra?: Record<string, unknown>): Record<string, unknown> {\n    return {\n      accountId: this.deps.accountId,\n      threadId: this.deps.threadId,\n      ...extra,\n    };\n  }\n\n  // === Reply API ===\n\n  async reply(text: string, options?: ReplyOptions): Promise<void> {\n    await this.deps.replyHandler(text, options);\n  }\n\n  async replyComponent(component: UIComponent): Promise<void> {\n    if (this.deps.componentHandler) {\n      await this.deps.componentHandler(component);\n    } else {\n      // Fallback to text representation\n      await this.reply(this.renderComponentAsText(component));\n    }\n  }\n\n  async setTyping(typing: boolean): Promise<void> {\n    if (this.deps.typingHandler) {\n      await this.deps.typingHandler(typing);\n    }\n  }\n\n  // === Session Management ===\n\n  async getSession(): Promise<AgentMessage[]> {\n    return this.deps.sessionStore.load(this.sessionKey);\n  }\n\n  async resetSession(): Promise<void> {\n    if (this.deps.resetSession) {\n      await this.deps.resetSession(this.sessionKey);\n    } else if (typeof this.deps.sessionStore.reset === 'function') {\n      const outcome = await this.deps.sessionStore.reset(this.sessionKey);\n      if (!outcome) {\n        throw new Error('Session not found');\n      }\n      this.deps.invalidateAgentSession?.(this.sessionKey);\n    } else {\n      await this.clearSession();\n      return;\n    }\n\n    await this.deps.bus.publishOutbound({\n      channel: this.source,\n      chat_id: this.chatId,\n      content: '✅ New session started. Previous transcript archived; model and session overrides kept.',\n      type: 'message',\n      metadata: this.outboundMetadata(),\n    });\n\n    log.info({ sessionKey: this.sessionKey }, 'Session reset');\n  }\n\n  async clearSession(): Promise<void> {\n    // Archive first if has messages\n    const messages = await this.getSession();\n    if (messages.length > 0) {\n      await this.deps.sessionStore.archive(this.sessionKey);\n      log.info({ sessionKey: this.sessionKey, messageCount: messages.length }, 'Session archived');\n    }\n\n    // Delete session\n    await this.deps.sessionStore.deleteSession(this.sessionKey);\n    this.deps.invalidateAgentSession?.(this.sessionKey);\n\n    // Publish outbound message to confirm\n    await this.deps.bus.publishOutbound({\n      channel: this.source,\n      chat_id: this.chatId,\n      content: '✅ Session cleared.',\n      type: 'message',\n      metadata: this.outboundMetadata(),\n    });\n\n    log.info({ sessionKey: this.sessionKey }, 'Session cleared');\n  }\n\n  async archiveSession(): Promise<void> {\n    await this.deps.sessionStore.archive(this.sessionKey);\n    log.info({ sessionKey: this.sessionKey }, 'Session archived');\n  }\n\n  async listSessions(): Promise<SessionInfo[]> {\n    // TODO: Implement listSessions in SessionStore\n    // For now, return current session only\n    const messages = await this.getSession();\n    return [{\n      key: this.sessionKey,\n      name: getSessionDisplayName(this.sessionKey),\n      messageCount: messages.length,\n      createdAt: new Date(),\n      updatedAt: new Date(),\n      isActive: true,\n    }];\n  }\n\n  async switchSession(sessionKey: string): Promise<void> {\n    // This is mainly for CLI/Web UI where you can switch between sessions\n    // For Telegram, each chat has its own session\n    log.info({ from: this.sessionKey, to: sessionKey }, 'Session switch requested');\n    \n    // Note: In the current architecture, switching session means\n    // the next message will use a different sessionKey\n    // The actual switch happens at the adapter level\n  }\n\n  // === Model Management ===\n\n  getCurrentModel(): string {\n    if (this.deps.getCurrentModel) {\n      return this.deps.getCurrentModel();\n    }\n    \n    return getAgentDefaultModelRef(this.config);\n  }\n\n  async listModels(): Promise<ModelInfo[]> {\n    if (this.deps.listModels) {\n      return this.deps.listModels();\n    }\n    \n    // Fallback to empty list\n    return [];\n  }\n\n  async switchModel(modelId: string): Promise<boolean> {\n    if (this.deps.switchModel) {\n      return this.deps.switchModel(modelId);\n    }\n    \n    // No model manager available\n    await this.reply('❌ Model switching not available in this context.');\n    return false;\n  }\n\n  async getUsage(): Promise<UsageStats> {\n    if (this.deps.getUsage) {\n      return this.deps.getUsage();\n    }\n    \n    // Fallback: calculate from session\n    const messages = await this.getSession();\n    let promptTokens = 0;\n    let completionTokens = 0;\n    \n    for (const msg of messages) {\n      if ('usage' in msg && msg.usage) {\n        promptTokens += msg.usage.input || 0;\n        completionTokens += msg.usage.output || 0;\n      }\n    }\n    \n    return {\n      promptTokens,\n      completionTokens,\n      totalTokens: promptTokens + completionTokens,\n      messageCount: messages.length,\n    };\n  }\n\n  // === Platform Features ===\n\n  supports(feature: PlatformFeature): boolean {\n    return this.deps.supportedFeatures.includes(feature);\n  }\n\n  // === Configuration ===\n\n  getConfig(): Config {\n    return this.config;\n  }\n\n  async updateConfig(path: string, value: unknown): Promise<boolean> {\n    try {\n      // Update config object using path\n      const keys = path.split('.');\n      let target: Record<string, unknown> = this.config as Record<string, unknown>;\n      \n      for (let i = 0; i < keys.length - 1; i++) {\n        const key = keys[i];\n        if (!(key in target) || typeof target[key] !== 'object' || target[key] === null) {\n          target[key] = {};\n        }\n        target = target[key] as Record<string, unknown>;\n      }\n      \n      target[keys[keys.length - 1]] = value;\n      \n      // Save to disk\n      await saveConfig(this.config);\n      \n      log.info({ path, value }, 'Config updated via command');\n      return true;\n    } catch (error) {\n      log.error({ err: error, path, value }, 'Failed to update config');\n      return false;\n    }\n  }\n\n  // === Private Helpers ===\n\n  // === Thinking Configuration ===\n\n  /**\n   * Get the session config store (if available)\n   */\n  getSessionConfigStore(): SessionConfigStore | undefined {\n    return this.deps.sessionConfigStore;\n  }\n\n  /**\n   * Get current thinking level (session override or default)\n   */\n  async getThinkingLevel(): Promise<ThinkLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.thinkingLevel) {\n        return sessionConfig.thinkingLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set thinking level for this session\n   */\n  async setThinkingLevel(level: ThinkLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { thinkingLevel: level });\n    }\n    this.deps.applySessionThinkingLevel?.(this.sessionKey, level);\n  }\n\n  syncAgentThinkingLevel(level: ThinkLevel): void {\n    this.deps.applySessionThinkingLevel?.(this.sessionKey, level);\n  }\n\n  async compactSession(options?: { instructions?: string; force?: boolean }): Promise<CompactSessionResult | null> {\n    if (!this.deps.compactSession) {\n      return null;\n    }\n    const r = await this.deps.compactSession(this.sessionKey, options);\n    return {\n      compacted: r.compacted,\n      tokensBefore: r.tokensBefore,\n      tokensAfter: r.tokensAfter,\n      summary: r.summary,\n    };\n  }\n\n  async btwQuery(question: string): Promise<{ text: string; error?: string }> {\n    if (!this.deps.btwQuery) {\n      return { text: '', error: 'Side questions are not available in this environment.' };\n    }\n    return this.deps.btwQuery(this.sessionKey, question);\n  }\n\n  async exportSessionToWorkspace(format: 'markdown' | 'html' | 'json'): Promise<{ path: string }> {\n    const exportFmt = format === 'json' ? 'json' : 'markdown';\n    let body = await this.deps.sessionStore.exportSession(this.sessionKey, exportFmt);\n    if (format === 'html') {\n      body = wrapMarkdownExportAsHtml(`Session ${this.sessionKey}`, body);\n    }\n    const sc = this.deps.sessionConfigStore\n      ? await this.deps.sessionConfigStore.get(this.sessionKey)\n      : null;\n    const root = effectiveWorkspacePathForSession(\n      this.config,\n      this.sessionKey,\n      sc,\n      getProjectForSession(this.sessionKey),\n    );\n    const dir = join(root, 'exports');\n    await mkdir(dir, { recursive: true });\n    const safe = this.sessionKey.replace(/[^a-zA-Z0-9._-]+/g, '_').slice(0, 96);\n    const ext = format === 'json' ? 'json' : format === 'html' ? 'html' : 'md';\n    const name = `session-${safe}-${Date.now()}.${ext}`;\n    const outPath = join(dir, name);\n    await writeFile(outPath, body, 'utf-8');\n    return { path: outPath };\n  }\n\n  async agentContextReport(mode: 'list' | 'detail' | 'json' = 'list'): Promise<string> {\n    if (!this.deps.getSessionContextReport) {\n      return 'Context report is not available in this environment.';\n    }\n    return this.deps.getSessionContextReport(this.sessionKey, mode);\n  }\n\n  /**\n   * Get current reasoning level (session override or default)\n   */\n  async getReasoningLevel(): Promise<ReasoningLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.reasoningLevel) {\n        return sessionConfig.reasoningLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set reasoning level for this session\n   */\n  async setReasoningLevel(level: ReasoningLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { reasoningLevel: level });\n    }\n  }\n\n  /**\n   * Get current verbose level (session override or default)\n   */\n  async getVerboseLevel(): Promise<VerboseLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.verboseLevel) {\n        return sessionConfig.verboseLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set verbose level for this session\n   */\n  async setVerboseLevel(level: VerboseLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { verboseLevel: level });\n    }\n  }\n\n  private renderComponentAsText(component: UIComponent): string {\n    switch (component.type) {\n      case 'buttons':\n        return component.buttons.map(b => `[${b.text}]`).join(' ');\n      \n      case 'select':\n        return component.options.map(o => `- ${o.label}`).join('\\n');\n      \n      case 'model-picker':\n        return component.providers.map(p => \n          `**${p.name}**\\n${p.models.map(m => `  - ${m.name}`).join('\\n')}`\n        ).join('\\n\\n');\n      \n      case 'usage-display':\n        return `📊 Usage Stats:\\n` +\n          `📥 Prompt: ${component.stats.promptTokens.toLocaleString()} tokens\\n` +\n          `📤 Completion: ${component.stats.completionTokens.toLocaleString()} tokens\\n` +\n          `📊 Total: ${component.stats.totalTokens.toLocaleString()} tokens`;\n      \n      case 'session-list':\n        return component.sessions.map(s => \n          `${s.isActive ? '▶️' : '  '} ${s.key} (${s.messageCount} messages)`\n        ).join('\\n');\n      \n      case 'text-input':\n        return component.placeholder || 'Enter text...';\n      \n      default:\n        return '[UI Component]';\n    }\n  }\n}\n\n/**\n * Create a command context from dependencies\n */\nexport function createCommandContext(deps: CommandContextDeps): CommandContext {\n  return new CommandContextImpl(deps);\n}\n"],"mappings":"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"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/chat-commands/context.ts"],"sourcesContent":["/**\n * Command Context Implementation\n * \n * Provides the concrete implementation of CommandContext interface,\n * bridging commands to core services (AgentService, SessionStore, etc.)\n */\n\nimport type {\n  CommandContext,\n  ReplyOptions,\n  UIComponent,\n  SessionInfo,\n  ModelInfo,\n  UsageStats,\n  PlatformFeature,\n  MessageSource,\n  CompactSessionResult,\n} from './types.js';\nimport { getSessionDisplayName } from './session-key.js';\nimport type { Config } from '../config/schema.js';\nimport { getAgentDefaultModelRef } from '../config/schema.js';\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { SessionStore, SessionConfigStore } from '../session/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { saveConfig } from '../config/loader.js';\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';\nimport { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { effectiveWorkspacePathForSession } from '../session/session-workspace.js';\nimport { wrapMarkdownExportAsHtml } from '../session/chat-export.js';\nimport type { CompactionResult } from '../agent/memory/compaction.js';\nimport type { PersistentGoalApis } from '../agent/goals/persistent-goal-apis.js';\nimport type { WorkflowRunServiceLike } from '../workflows/service/workflow-run-service.types.js';\nimport { getProjectForSession } from '../projects/workspace.js';\n\nconst log = createLogger('CommandContext');\n\nexport interface CommandContextDeps {\n  sessionKey: string;\n  source: MessageSource;\n  channelId: string;\n  chatId: string;\n  senderId: string;\n  isGroup: boolean;\n  accountId?: string;\n  threadId?: string;\n  config: Config;\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  sessionConfigStore?: SessionConfigStore;\n  /** After persisting session thinking, sync pi-agent in-memory state */\n  applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  // Callbacks for platform-specific operations\n  replyHandler: (text: string, options?: ReplyOptions) => Promise<void>;\n  componentHandler?: (component: UIComponent) => Promise<void>;\n  typingHandler?: (typing: boolean) => Promise<void>;\n  supportedFeatures: PlatformFeature[];\n  /** Called after session files are removed so in-memory agents match disk */\n  invalidateAgentSession?: (sessionKey: string) => void;\n  /** Reset session in place (archive + new session id); optional — falls back to clearSession */\n  resetSession?: (sessionKey: string) => Promise<void>;\n  // Model management (optional, will be injected)\n  getCurrentModel?: () => string;\n  switchModel?: (modelId: string) => Promise<boolean>;\n  listModels?: () => Promise<ModelInfo[]>;\n  getUsage?: () => Promise<UsageStats>;\n  /** Stop current LLM turn and clear channel preview stream (Telegram draft, etc.) */\n  abortCurrentTurn?: () => Promise<void>;\n  /** Reload skills from disk and refresh active agent prompts. */\n  reloadSkills?: () => Promise<void>;\n  /** Install a managed skill from an explicit source and refresh active agent prompts. */\n  installSkillFromSource?: CommandContext['installSkillFromSource'];\n\n  compactSession?: (\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ) => Promise<CompactionResult>;\n\n  btwQuery?: (sessionKey: string, question: string) => Promise<{ text: string; error?: string }>;\n\n  getSessionContextReport?: (\n    sessionKey: string,\n    mode: 'list' | 'detail' | 'json',\n  ) => Promise<string>;\n\n  persistentGoalApis?: PersistentGoalApis;\n  workflowRunService?: WorkflowRunServiceLike;\n}\n\nexport class CommandContextImpl implements CommandContext {\n  readonly sessionKey: string;\n  readonly source: MessageSource;\n  readonly channelId: string;\n  readonly chatId: string;\n  readonly senderId: string;\n  readonly isGroup: boolean;\n  readonly accountId?: string;\n  readonly threadId?: string;\n  readonly config: Config;\n  readonly abortCurrentTurn?: () => Promise<void>;\n  readonly reloadSkills?: () => Promise<void>;\n  readonly installSkillFromSource?: CommandContext['installSkillFromSource'];\n  readonly persistentGoalApis?: PersistentGoalApis;\n  readonly workflowRunApis?: CommandContext['workflowRunApis'];\n\n  private deps: CommandContextDeps;\n\n  constructor(deps: CommandContextDeps) {\n    this.sessionKey = deps.sessionKey;\n    this.source = deps.source;\n    this.channelId = deps.channelId;\n    this.chatId = deps.chatId;\n    this.senderId = deps.senderId;\n    this.isGroup = deps.isGroup;\n    this.accountId = deps.accountId;\n    this.threadId = deps.threadId;\n    this.config = deps.config;\n    this.deps = deps;\n\n    if (deps.abortCurrentTurn) {\n      const run = deps.abortCurrentTurn;\n      this.abortCurrentTurn = async () => {\n        await run();\n      };\n    }\n\n    if (deps.reloadSkills) {\n      const run = deps.reloadSkills;\n      this.reloadSkills = async () => {\n        await run();\n      };\n    }\n\n    if (deps.installSkillFromSource) {\n      this.installSkillFromSource = deps.installSkillFromSource;\n    }\n\n    this.persistentGoalApis = deps.persistentGoalApis;\n    if (deps.workflowRunService) {\n      this.workflowRunApis = {\n        service: deps.workflowRunService,\n        startWorkflowRun: (params) => deps.workflowRunService!.startWorkflowRun(params),\n      };\n    }\n  }\n\n  private outboundMetadata(extra?: Record<string, unknown>): Record<string, unknown> {\n    return {\n      accountId: this.deps.accountId,\n      threadId: this.deps.threadId,\n      ...extra,\n    };\n  }\n\n  // === Reply API ===\n\n  async reply(text: string, options?: ReplyOptions): Promise<void> {\n    await this.deps.replyHandler(text, options);\n  }\n\n  async replyComponent(component: UIComponent): Promise<void> {\n    if (this.deps.componentHandler) {\n      await this.deps.componentHandler(component);\n    } else {\n      // Fallback to text representation\n      await this.reply(this.renderComponentAsText(component));\n    }\n  }\n\n  async setTyping(typing: boolean): Promise<void> {\n    if (this.deps.typingHandler) {\n      await this.deps.typingHandler(typing);\n    }\n  }\n\n  // === Session Management ===\n\n  async getSession(): Promise<AgentMessage[]> {\n    return this.deps.sessionStore.load(this.sessionKey);\n  }\n\n  async resetSession(): Promise<void> {\n    if (this.deps.resetSession) {\n      await this.deps.resetSession(this.sessionKey);\n    } else if (typeof this.deps.sessionStore.reset === 'function') {\n      const outcome = await this.deps.sessionStore.reset(this.sessionKey);\n      if (!outcome) {\n        throw new Error('Session not found');\n      }\n      this.deps.invalidateAgentSession?.(this.sessionKey);\n    } else {\n      await this.clearSession();\n      return;\n    }\n\n    await this.deps.bus.publishOutbound({\n      channel: this.source,\n      chat_id: this.chatId,\n      content: '✅ New session started. Previous transcript archived; model and session overrides kept.',\n      type: 'message',\n      metadata: this.outboundMetadata(),\n    });\n\n    log.info({ sessionKey: this.sessionKey }, 'Session reset');\n  }\n\n  async clearSession(): Promise<void> {\n    // Archive first if has messages\n    const messages = await this.getSession();\n    if (messages.length > 0) {\n      await this.deps.sessionStore.archive(this.sessionKey);\n      log.info({ sessionKey: this.sessionKey, messageCount: messages.length }, 'Session archived');\n    }\n\n    // Delete session\n    await this.deps.sessionStore.deleteSession(this.sessionKey);\n    this.deps.invalidateAgentSession?.(this.sessionKey);\n\n    // Publish outbound message to confirm\n    await this.deps.bus.publishOutbound({\n      channel: this.source,\n      chat_id: this.chatId,\n      content: '✅ Session cleared.',\n      type: 'message',\n      metadata: this.outboundMetadata(),\n    });\n\n    log.info({ sessionKey: this.sessionKey }, 'Session cleared');\n  }\n\n  async archiveSession(): Promise<void> {\n    await this.deps.sessionStore.archive(this.sessionKey);\n    log.info({ sessionKey: this.sessionKey }, 'Session archived');\n  }\n\n  async listSessions(): Promise<SessionInfo[]> {\n    // TODO: Implement listSessions in SessionStore\n    // For now, return current session only\n    const messages = await this.getSession();\n    return [{\n      key: this.sessionKey,\n      name: getSessionDisplayName(this.sessionKey),\n      messageCount: messages.length,\n      createdAt: new Date(),\n      updatedAt: new Date(),\n      isActive: true,\n    }];\n  }\n\n  async switchSession(sessionKey: string): Promise<void> {\n    // This is mainly for CLI/Web UI where you can switch between sessions\n    // For Telegram, each chat has its own session\n    log.info({ from: this.sessionKey, to: sessionKey }, 'Session switch requested');\n    \n    // Note: In the current architecture, switching session means\n    // the next message will use a different sessionKey\n    // The actual switch happens at the adapter level\n  }\n\n  // === Model Management ===\n\n  getCurrentModel(): string {\n    if (this.deps.getCurrentModel) {\n      return this.deps.getCurrentModel();\n    }\n    \n    return getAgentDefaultModelRef(this.config);\n  }\n\n  async listModels(): Promise<ModelInfo[]> {\n    if (this.deps.listModels) {\n      return this.deps.listModels();\n    }\n    \n    // Fallback to empty list\n    return [];\n  }\n\n  async switchModel(modelId: string): Promise<boolean> {\n    if (this.deps.switchModel) {\n      return this.deps.switchModel(modelId);\n    }\n    \n    // No model manager available\n    await this.reply('❌ Model switching not available in this context.');\n    return false;\n  }\n\n  async getUsage(): Promise<UsageStats> {\n    if (this.deps.getUsage) {\n      return this.deps.getUsage();\n    }\n    \n    // Fallback: calculate from session\n    const messages = await this.getSession();\n    let promptTokens = 0;\n    let completionTokens = 0;\n    \n    for (const msg of messages) {\n      if ('usage' in msg && msg.usage) {\n        promptTokens += msg.usage.input || 0;\n        completionTokens += msg.usage.output || 0;\n      }\n    }\n    \n    return {\n      promptTokens,\n      completionTokens,\n      totalTokens: promptTokens + completionTokens,\n      messageCount: messages.length,\n    };\n  }\n\n  // === Platform Features ===\n\n  supports(feature: PlatformFeature): boolean {\n    return this.deps.supportedFeatures.includes(feature);\n  }\n\n  // === Configuration ===\n\n  getConfig(): Config {\n    return this.config;\n  }\n\n  async updateConfig(path: string, value: unknown): Promise<boolean> {\n    try {\n      // Update config object using path\n      const keys = path.split('.');\n      let target: Record<string, unknown> = this.config as Record<string, unknown>;\n      \n      for (let i = 0; i < keys.length - 1; i++) {\n        const key = keys[i];\n        if (!(key in target) || typeof target[key] !== 'object' || target[key] === null) {\n          target[key] = {};\n        }\n        target = target[key] as Record<string, unknown>;\n      }\n      \n      target[keys[keys.length - 1]] = value;\n      \n      // Save to disk\n      await saveConfig(this.config);\n      \n      log.info({ path, value }, 'Config updated via command');\n      return true;\n    } catch (error) {\n      log.error({ err: error, path, value }, 'Failed to update config');\n      return false;\n    }\n  }\n\n  // === Private Helpers ===\n\n  // === Thinking Configuration ===\n\n  /**\n   * Get the session config store (if available)\n   */\n  getSessionConfigStore(): SessionConfigStore | undefined {\n    return this.deps.sessionConfigStore;\n  }\n\n  /**\n   * Get current thinking level (session override or default)\n   */\n  async getThinkingLevel(): Promise<ThinkLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.thinkingLevel) {\n        return sessionConfig.thinkingLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set thinking level for this session\n   */\n  async setThinkingLevel(level: ThinkLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { thinkingLevel: level });\n    }\n    this.deps.applySessionThinkingLevel?.(this.sessionKey, level);\n  }\n\n  syncAgentThinkingLevel(level: ThinkLevel): void {\n    this.deps.applySessionThinkingLevel?.(this.sessionKey, level);\n  }\n\n  async compactSession(options?: { instructions?: string; force?: boolean }): Promise<CompactSessionResult | null> {\n    if (!this.deps.compactSession) {\n      return null;\n    }\n    const r = await this.deps.compactSession(this.sessionKey, options);\n    return {\n      compacted: r.compacted,\n      tokensBefore: r.tokensBefore,\n      tokensAfter: r.tokensAfter,\n      summary: r.summary,\n    };\n  }\n\n  async btwQuery(question: string): Promise<{ text: string; error?: string }> {\n    if (!this.deps.btwQuery) {\n      return { text: '', error: 'Side questions are not available in this environment.' };\n    }\n    return this.deps.btwQuery(this.sessionKey, question);\n  }\n\n  async exportSessionToWorkspace(format: 'markdown' | 'html' | 'json'): Promise<{ path: string }> {\n    const exportFmt = format === 'json' ? 'json' : 'markdown';\n    let body = await this.deps.sessionStore.exportSession(this.sessionKey, exportFmt);\n    if (format === 'html') {\n      body = wrapMarkdownExportAsHtml(`Session ${this.sessionKey}`, body);\n    }\n    const sc = this.deps.sessionConfigStore\n      ? await this.deps.sessionConfigStore.get(this.sessionKey)\n      : null;\n    const root = effectiveWorkspacePathForSession(\n      this.config,\n      this.sessionKey,\n      sc,\n      getProjectForSession(this.sessionKey),\n    );\n    const dir = join(root, 'exports');\n    await mkdir(dir, { recursive: true });\n    const safe = this.sessionKey.replace(/[^a-zA-Z0-9._-]+/g, '_').slice(0, 96);\n    const ext = format === 'json' ? 'json' : format === 'html' ? 'html' : 'md';\n    const name = `session-${safe}-${Date.now()}.${ext}`;\n    const outPath = join(dir, name);\n    await writeFile(outPath, body, 'utf-8');\n    return { path: outPath };\n  }\n\n  async agentContextReport(mode: 'list' | 'detail' | 'json' = 'list'): Promise<string> {\n    if (!this.deps.getSessionContextReport) {\n      return 'Context report is not available in this environment.';\n    }\n    return this.deps.getSessionContextReport(this.sessionKey, mode);\n  }\n\n  /**\n   * Get current reasoning level (session override or default)\n   */\n  async getReasoningLevel(): Promise<ReasoningLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.reasoningLevel) {\n        return sessionConfig.reasoningLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set reasoning level for this session\n   */\n  async setReasoningLevel(level: ReasoningLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { reasoningLevel: level });\n    }\n  }\n\n  /**\n   * Get current verbose level (session override or default)\n   */\n  async getVerboseLevel(): Promise<VerboseLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.verboseLevel) {\n        return sessionConfig.verboseLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set verbose level for this session\n   */\n  async setVerboseLevel(level: VerboseLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { verboseLevel: level });\n    }\n  }\n\n  private renderComponentAsText(component: UIComponent): string {\n    switch (component.type) {\n      case 'buttons':\n        return component.buttons.map(b => `[${b.text}]`).join(' ');\n      \n      case 'select':\n        return component.options.map(o => `- ${o.label}`).join('\\n');\n      \n      case 'model-picker':\n        return component.providers.map(p => \n          `**${p.name}**\\n${p.models.map(m => `  - ${m.name}`).join('\\n')}`\n        ).join('\\n\\n');\n      \n      case 'usage-display':\n        return `📊 Usage Stats:\\n` +\n          `📥 Prompt: ${component.stats.promptTokens.toLocaleString()} tokens\\n` +\n          `📤 Completion: ${component.stats.completionTokens.toLocaleString()} tokens\\n` +\n          `📊 Total: ${component.stats.totalTokens.toLocaleString()} tokens`;\n      \n      case 'session-list':\n        return component.sessions.map(s => \n          `${s.isActive ? '▶️' : '  '} ${s.key} (${s.messageCount} messages)`\n        ).join('\\n');\n      \n      case 'text-input':\n        return component.placeholder || 'Enter text...';\n      \n      default:\n        return '[UI Component]';\n    }\n  }\n}\n\n/**\n * Create a command context from dependencies\n */\nexport function createCommandContext(deps: CommandContextDeps): CommandContext {\n  return new CommandContextImpl(deps);\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/index.d.ts

@@ -21,6 +21,7 @@ export { registerGoalCommand } from './builtins/goal.js';
 export { registerSubgoalCommand } from './builtins/subgoal.js';
 export { registerWorkflowCommands } from './builtins/workflow.js';
 export { registerReviewCommand } from './builtins/review.js';
+export { registerSkillCommand } from './builtins/skill.js';
 export { registerAgentEditCommand } from './agent-edit.js';
 /**
  * Initialize the command system with all built-in commands

package/dist/src/chat-commands/index.js

@@ -12,6 +12,7 @@ import { registerGoalCommand } from "./builtins/goal.js";
 import { registerSubgoalCommand } from "./builtins/subgoal.js";
 import { registerWorkflowCommands } from "./builtins/workflow.js";
 import { registerReviewCommand } from "./builtins/review.js";
+import { registerSkillCommand } from "./builtins/skill.js";
 import { registerAgentEditCommand } from "./agent-edit.js";
 import { CommandContextImpl, createCommandContext } from "./context.js";
 //#region src/chat-commands/index.ts
@@ -36,9 +37,10 @@ function initializeCommands() {
 	registerSubgoalCommand();
 	registerWorkflowCommands();
 	registerReviewCommand();
+	registerSkillCommand();
 	registerAgentEditCommand();
 }
 //#endregion
-export { CommandContextImpl, CommandRegistry, commandRegistry, createCommandContext, generateSessionKey, getSessionDisplayName, initializeCommands, normalizeTelegramCommandName, parseSlashCommand, registerAgentEditCommand, registerConfigCommand, registerContextCommands, registerGoalCommand, registerModelCommands, registerReviewCommand, registerSessionCommands, registerSubgoalCommand, registerSystemCommands, registerTTSCommands, registerThinkingCommands, registerWorkflowCommands };
+export { CommandContextImpl, CommandRegistry, commandRegistry, createCommandContext, generateSessionKey, getSessionDisplayName, initializeCommands, normalizeTelegramCommandName, parseSlashCommand, registerAgentEditCommand, registerConfigCommand, registerContextCommands, registerGoalCommand, registerModelCommands, registerReviewCommand, registerSessionCommands, registerSkillCommand, registerSubgoalCommand, registerSystemCommands, registerTTSCommands, registerThinkingCommands, registerWorkflowCommands };
 
 //# sourceMappingURL=index.js.map

package/dist/src/chat-commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/chat-commands/index.ts"],"sourcesContent":["/**\n * Unified Command System\n *\n * Provides a platform-agnostic command system that works across\n * Telegram, Feishu, Web UI, CLI, and other channel surfaces.\n */\n\n// Built-in Commands (import first to avoid circular deps)\nimport { registerSessionCommands } from './builtins/session.js';\nimport { registerModelCommands } from './builtins/model.js';\nimport { registerSystemCommands } from './builtins/system.js';\nimport { registerTTSCommands } from './builtins/tts.js';\nimport { registerThinkingCommands } from './builtins/thinking.js';\nimport { registerConfigCommand } from './builtins/config.js';\nimport { registerContextCommands } from './builtins/context.js';\nimport { registerGoalCommand } from './builtins/goal.js';\nimport { registerSubgoalCommand } from './builtins/subgoal.js';\nimport { registerWorkflowCommands } from './builtins/workflow.js';\nimport { registerReviewCommand } from './builtins/review.js';\nimport { registerAgentEditCommand } from './agent-edit.js';\n\n// Types\nexport type {\n  MessageSource,\n  UnifiedMessage,\n  PlatformMetadata,\n  MessageAttachment,\n  CommandDefinition,\n  CommandCategory,\n  CommandScope,\n  CommandHandler,\n  CommandResult,\n  CommandContext,\n  ReplyOptions,\n  UIComponent,\n  ButtonGroup,\n  SelectMenu,\n  ModelPicker,\n  UsageDisplay,\n  SessionList,\n  TextInput,\n  ProviderInfo,\n  ModelInfo,\n  UsageStats,\n  SessionInfo,\n  PlatformFeature,\n  ChannelAdapter,\n  ReplyPayload,\n} from './types.js';\n\n// Session display helpers\nexport { generateSessionKey, getSessionDisplayName, type SessionKeyContext } from './session-key.js';\n\n// Command parsing helpers\nexport { normalizeTelegramCommandName, parseSlashCommand } from './command-parse.js';\n\n// Registry\nexport { CommandRegistry, commandRegistry } from './registry.js';\nexport type { CommandRegistry as CommandRegistryType } from './types.js';\n\n// Context\nexport { CommandContextImpl, createCommandContext } from './context.js';\n\n// Built-in Commands\nexport { registerSessionCommands } from './builtins/session.js';\nexport { registerModelCommands } from './builtins/model.js';\nexport { registerSystemCommands } from './builtins/system.js';\nexport { registerTTSCommands } from './builtins/tts.js';\nexport { registerThinkingCommands } from './builtins/thinking.js';\nexport { registerConfigCommand } from './builtins/config.js';\nexport { registerContextCommands } from './builtins/context.js';\nexport { registerGoalCommand } from './builtins/goal.js';\nexport { registerSubgoalCommand } from './builtins/subgoal.js';\nexport { registerWorkflowCommands } from './builtins/workflow.js';\nexport { registerReviewCommand } from './builtins/review.js';\nexport { registerAgentEditCommand } from './agent-edit.js';\n\n/**\n * Initialize the command system with all built-in commands\n */\nexport function initializeCommands(): void {\n  registerSessionCommands();\n  registerModelCommands();\n  registerSystemCommands();\n  registerConfigCommand();\n  registerContextCommands();\n  registerTTSCommands();\n  registerThinkingCommands();\n  registerGoalCommand();\n  registerSubgoalCommand();\n  registerWorkflowCommands();\n  registerReviewCommand();\n  registerAgentEditCommand();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAgFA,SAAgB,qBAA2B;AACzC,0BAAyB;AACzB,wBAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,0BAAyB;AACzB,sBAAqB;AACrB,2BAA0B;AAC1B,sBAAqB;AACrB,yBAAwB;AACxB,2BAA0B;AAC1B,wBAAuB;AACvB,2BAA0B"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/chat-commands/index.ts"],"sourcesContent":["/**\n * Unified Command System\n *\n * Provides a platform-agnostic command system that works across\n * Telegram, Feishu, Web UI, CLI, and other channel surfaces.\n */\n\n// Built-in Commands (import first to avoid circular deps)\nimport { registerSessionCommands } from './builtins/session.js';\nimport { registerModelCommands } from './builtins/model.js';\nimport { registerSystemCommands } from './builtins/system.js';\nimport { registerTTSCommands } from './builtins/tts.js';\nimport { registerThinkingCommands } from './builtins/thinking.js';\nimport { registerConfigCommand } from './builtins/config.js';\nimport { registerContextCommands } from './builtins/context.js';\nimport { registerGoalCommand } from './builtins/goal.js';\nimport { registerSubgoalCommand } from './builtins/subgoal.js';\nimport { registerWorkflowCommands } from './builtins/workflow.js';\nimport { registerReviewCommand } from './builtins/review.js';\nimport { registerSkillCommand } from './builtins/skill.js';\nimport { registerAgentEditCommand } from './agent-edit.js';\n\n// Types\nexport type {\n  MessageSource,\n  UnifiedMessage,\n  PlatformMetadata,\n  MessageAttachment,\n  CommandDefinition,\n  CommandCategory,\n  CommandScope,\n  CommandHandler,\n  CommandResult,\n  CommandContext,\n  ReplyOptions,\n  UIComponent,\n  ButtonGroup,\n  SelectMenu,\n  ModelPicker,\n  UsageDisplay,\n  SessionList,\n  TextInput,\n  ProviderInfo,\n  ModelInfo,\n  UsageStats,\n  SessionInfo,\n  PlatformFeature,\n  ChannelAdapter,\n  ReplyPayload,\n} from './types.js';\n\n// Session display helpers\nexport { generateSessionKey, getSessionDisplayName, type SessionKeyContext } from './session-key.js';\n\n// Command parsing helpers\nexport { normalizeTelegramCommandName, parseSlashCommand } from './command-parse.js';\n\n// Registry\nexport { CommandRegistry, commandRegistry } from './registry.js';\nexport type { CommandRegistry as CommandRegistryType } from './types.js';\n\n// Context\nexport { CommandContextImpl, createCommandContext } from './context.js';\n\n// Built-in Commands\nexport { registerSessionCommands } from './builtins/session.js';\nexport { registerModelCommands } from './builtins/model.js';\nexport { registerSystemCommands } from './builtins/system.js';\nexport { registerTTSCommands } from './builtins/tts.js';\nexport { registerThinkingCommands } from './builtins/thinking.js';\nexport { registerConfigCommand } from './builtins/config.js';\nexport { registerContextCommands } from './builtins/context.js';\nexport { registerGoalCommand } from './builtins/goal.js';\nexport { registerSubgoalCommand } from './builtins/subgoal.js';\nexport { registerWorkflowCommands } from './builtins/workflow.js';\nexport { registerReviewCommand } from './builtins/review.js';\nexport { registerSkillCommand } from './builtins/skill.js';\nexport { registerAgentEditCommand } from './agent-edit.js';\n\n/**\n * Initialize the command system with all built-in commands\n */\nexport function initializeCommands(): void {\n  registerSessionCommands();\n  registerModelCommands();\n  registerSystemCommands();\n  registerConfigCommand();\n  registerContextCommands();\n  registerTTSCommands();\n  registerThinkingCommands();\n  registerGoalCommand();\n  registerSubgoalCommand();\n  registerWorkflowCommands();\n  registerReviewCommand();\n  registerSkillCommand();\n  registerAgentEditCommand();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAkFA,SAAgB,qBAA2B;AACzC,0BAAyB;AACzB,wBAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,0BAAyB;AACzB,sBAAqB;AACrB,2BAA0B;AAC1B,sBAAqB;AACrB,yBAAwB;AACxB,2BAA0B;AAC1B,wBAAuB;AACvB,uBAAsB;AACtB,2BAA0B"}

package/dist/src/chat-commands/types.d.ts

@@ -157,6 +157,23 @@ export interface CommandContext {
     updateConfig?(path: string, value: unknown): Promise<boolean>;
     /** Reload skills from disk and refresh active agent prompts. */
     reloadSkills?(): Promise<void>;
+    /** Install a managed skill from an explicit source and refresh active agent prompts. */
+    installSkillFromSource?(opts: {
+        source: string;
+        ref?: string;
+        path?: string;
+        skillId?: string;
+        target?: 'workspace' | 'global';
+        force?: boolean;
+        strictScan?: boolean;
+    }): Promise<{
+        skillId: string;
+        path: string;
+        source: string;
+        kind: 'git' | 'archive';
+        contentHash: string;
+        target?: 'workspace' | 'global';
+    }>;
     /** Persist session thinking level and sync in-memory agent (when wired) */
     setThinkingLevel?(level: ThinkLevel): Promise<void>;
     /**

package/dist/src/cli/command-loaders.js

@@ -23,6 +23,7 @@ const REGISTRY_COMMAND_MODULES = {
 	search: () => import("./commands/search.js"),
 	auth: () => import("./commands/auth.js"),
 	skills: () => import("./commands/skills.js"),
+	connectors: () => import("./commands/connectors.js"),
 	browser: () => import("./commands/browser.js"),
 	update: () => import("./commands/update.js"),
 	logs: () => import("./commands/logs.js"),

package/dist/src/cli/command-loaders.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-loaders.js","names":[],"sources":["../../../src/cli/command-loaders.ts"],"sourcesContent":["/**\n * Lazy command loaders.\n *\n * Modules here trigger their `register({...})` side effect on import; the\n * caller then mounts the requested command via `registry.installOne` (or via\n * the explicit registrar functions for non-registry commands).\n *\n * Keeping this map static-but-thunked means `bin.ts` short-circuits and\n * `runCli` can resolve a single subcommand without paying for unrelated\n * command modules.\n */\nimport type { Command } from 'commander';\nimport { resolveCliCatalogCommandPath } from './command-path-policy.js';\nimport { shouldLoadExtensionCliForCommandPath } from './command-startup-policy.js';\nimport { registry, type CLIContext } from './registry.js';\n\nexport type CommandLoader = () => Promise<unknown>;\n\nexport const REGISTRY_COMMAND_MODULES: Record<string, CommandLoader> = {\n  init: () => import('./commands/init.js'),\n  profile: () => import('./commands/profile.js'),\n  setup: () => import('./commands/setup.js'),\n  onboard: () => import('./commands/onboard.js'),\n  agent: () => import('./commands/agent.js'),\n  tui: () => import('./commands/tui.js'),\n  gateway: () => import('./commands/gateway.js'),\n  session: () => import('./commands/session.js'),\n  project: () => import('./commands/project.js'),\n  goal: () => import('./commands/goal.js'),\n  config: () => import('./commands/config.js'),\n  doctor: () => import('./commands/doctor/index.js'),\n  image: () => import('./commands/image.js'),\n  channels: () => import('./commands/channels.js'),\n  models: () => import('./commands/models.js'),\n  providers: () => import('./commands/providers.js'),\n  voice: () => import('./commands/voice.js'),\n  search: () => import('./commands/search.js'),\n  auth: () => import('./commands/auth.js'),\n  skills: () => import('./commands/skills.js'),\n  browser: () => import('./commands/browser.js'),\n  update: () => import('./commands/update.js'),\n  logs: () => import('./commands/logs.js'),\n  tunnel: () => import('./commands/tunnel.js'),\n  tailscale: () => import('./commands/tailscale.js'),\n};\n\nexport interface NonRegistryMatcher {\n  matches: (name: string) => boolean;\n  load: (program: Command) => Promise<void>;\n}\n\nexport const NON_REGISTRY_COMMAND_MATCHERS: NonRegistryMatcher[] = [\n  {\n    matches: (name) => name === 'agents' || name.startsWith('agents:'),\n    load: async (program) => {\n      const { registerAgentsCli } = await import('./commands/agents.js');\n      registerAgentsCli(program);\n    },\n  },\n  {\n    matches: (name) => name === 'extensions',\n    load: async (program) => {\n      const { registerExtensionCommands } = await import('./commands/extension.js');\n      registerExtensionCommands(program);\n      const commandPath = resolveCliCatalogCommandPath(process.argv);\n      if (shouldLoadExtensionCliForCommandPath(commandPath)) {\n        const { registerExtensionCliCommands } = await import('./extension-cli-register.js');\n        await registerExtensionCliCommands(program);\n      }\n    },\n  },\n];\n\nconst FLAGS_WITH_VALUE = new Set(['--config', '--workspace']);\n\n/**\n * Resolve which command module to load based on argv. Skips global flags\n * (`--verbose`/`--config <path>`/`--workspace <path>`) and treats\n * `help <cmd>` as if the user had typed `<cmd>`, so that `xopc help gateway`\n * loads only the gateway module.\n */\nexport function resolveCommandName(argv: string[]): string | undefined {\n  let i = 2;\n  let firstSubcommand: string | undefined;\n  while (i < argv.length) {\n    const arg = argv[i];\n    if (!arg) {\n      i += 1;\n      continue;\n    }\n    if (arg.startsWith('-')) {\n      i += FLAGS_WITH_VALUE.has(arg) ? 2 : 1;\n      continue;\n    }\n    if (firstSubcommand === undefined) {\n      firstSubcommand = arg;\n      if (arg === 'help') {\n        i += 1;\n        continue;\n      }\n      return arg;\n    }\n    return arg;\n  }\n  return firstSubcommand;\n}\n\nexport async function tryLoadCommand(\n  program: Command,\n  ctx: CLIContext,\n  name: string,\n  getCtx?: () => CLIContext,\n): Promise<boolean> {\n  const moduleLoader = REGISTRY_COMMAND_MODULES[name];\n  if (moduleLoader) {\n    await moduleLoader();\n    const installed = registry.installOne(program, name, ctx, getCtx);\n    if (installed && name === 'gateway') {\n      const gatewayCmd = program.commands.find((command) => command.name() === 'gateway');\n      if (gatewayCmd) {\n        const { prepareGatewayCommandForArgv } = await import('./commands/gateway.js');\n        await prepareGatewayCommandForArgv(gatewayCmd, ctx);\n      }\n    }\n    return installed;\n  }\n  const matcher = NON_REGISTRY_COMMAND_MATCHERS.find((m) => m.matches(name));\n  if (matcher) {\n    await matcher.load(program);\n    return true;\n  }\n  return false;\n}\n\nexport async function loadAllCommands(\n  program: Command,\n  ctx: CLIContext,\n  getCtx?: () => CLIContext,\n): Promise<void> {\n  // Sequential to keep registration order deterministic; registry.install\n  // sorts by category and is stable within a category.\n  for (const loader of Object.values(REGISTRY_COMMAND_MODULES)) {\n    await loader();\n  }\n  registry.install(program, ctx, getCtx);\n  for (const matcher of NON_REGISTRY_COMMAND_MATCHERS) {\n    await matcher.load(program);\n  }\n  const gatewayCmd = program.commands.find((command) => command.name() === 'gateway');\n  if (gatewayCmd) {\n    const { prepareGatewayCommandForArgv } = await import('./commands/gateway.js');\n    await prepareGatewayCommandForArgv(gatewayCmd, ctx);\n  }\n}\n"],"mappings":";;;;AAkBA,MAAa,2BAA0D;CACrE,YAAY,OAAO;CACnB,eAAe,OAAO;CACtB,aAAa,OAAO;CACpB,eAAe,OAAO;CACtB,aAAa,OAAO;CACpB,WAAW,OAAO;CAClB,eAAe,OAAO;CACtB,eAAe,OAAO;CACtB,eAAe,OAAO;CACtB,YAAY,OAAO;CACnB,cAAc,OAAO;CACrB,cAAc,OAAO;CACrB,aAAa,OAAO;CACpB,gBAAgB,OAAO;CACvB,cAAc,OAAO;CACrB,iBAAiB,OAAO;CACxB,aAAa,OAAO;CACpB,cAAc,OAAO;CACrB,YAAY,OAAO;CACnB,cAAc,OAAO;CACrB,eAAe,OAAO;CACtB,cAAc,OAAO;CACrB,YAAY,OAAO;CACnB,cAAc,OAAO;CACrB,iBAAiB,OAAO;CACzB;AAOD,MAAa,gCAAsD,CACjE;CACE,UAAU,SAAS,SAAS,YAAY,KAAK,WAAW,UAAU;CAClE,MAAM,OAAO,YAAY;EACvB,MAAM,EAAE,sBAAsB,MAAM,OAAO;AAC3C,oBAAkB,QAAQ;;CAE7B,EACD;CACE,UAAU,SAAS,SAAS;CAC5B,MAAM,OAAO,YAAY;EACvB,MAAM,EAAE,8BAA8B,MAAM,OAAO;AACnD,4BAA0B,QAAQ;AAElC,MAAI,qCADgB,6BAA6B,QAAQ,KACL,CAAC,EAAE;GACrD,MAAM,EAAE,iCAAiC,MAAM,OAAO;AACtD,SAAM,6BAA6B,QAAQ;;;CAGhD,CACF;AAED,MAAM,mBAAmB,IAAI,IAAI,CAAC,YAAY,cAAc,CAAC;;;;;;;AAQ7D,SAAgB,mBAAmB,MAAoC;CACrE,IAAI,IAAI;CACR,IAAI;AACJ,QAAO,IAAI,KAAK,QAAQ;EACtB,MAAM,MAAM,KAAK;AACjB,MAAI,CAAC,KAAK;AACR,QAAK;AACL;;AAEF,MAAI,IAAI,WAAW,IAAI,EAAE;AACvB,QAAK,iBAAiB,IAAI,IAAI,GAAG,IAAI;AACrC;;AAEF,MAAI,oBAAoB,KAAA,GAAW;AACjC,qBAAkB;AAClB,OAAI,QAAQ,QAAQ;AAClB,SAAK;AACL;;AAEF,UAAO;;AAET,SAAO;;AAET,QAAO;;AAGT,eAAsB,eACpB,SACA,KACA,MACA,QACkB;CAClB,MAAM,eAAe,yBAAyB;AAC9C,KAAI,cAAc;AAChB,QAAM,cAAc;EACpB,MAAM,YAAY,SAAS,WAAW,SAAS,MAAM,KAAK,OAAO;AACjE,MAAI,aAAa,SAAS,WAAW;GACnC,MAAM,aAAa,QAAQ,SAAS,MAAM,YAAY,QAAQ,MAAM,KAAK,UAAU;AACnF,OAAI,YAAY;IACd,MAAM,EAAE,iCAAiC,MAAM,OAAO;AACtD,UAAM,6BAA6B,YAAY,IAAI;;;AAGvD,SAAO;;CAET,MAAM,UAAU,8BAA8B,MAAM,MAAM,EAAE,QAAQ,KAAK,CAAC;AAC1E,KAAI,SAAS;AACX,QAAM,QAAQ,KAAK,QAAQ;AAC3B,SAAO;;AAET,QAAO;;AAGT,eAAsB,gBACpB,SACA,KACA,QACe;AAGf,MAAK,MAAM,UAAU,OAAO,OAAO,yBAAyB,CAC1D,OAAM,QAAQ;AAEhB,UAAS,QAAQ,SAAS,KAAK,OAAO;AACtC,MAAK,MAAM,WAAW,8BACpB,OAAM,QAAQ,KAAK,QAAQ;CAE7B,MAAM,aAAa,QAAQ,SAAS,MAAM,YAAY,QAAQ,MAAM,KAAK,UAAU;AACnF,KAAI,YAAY;EACd,MAAM,EAAE,iCAAiC,MAAM,OAAO;AACtD,QAAM,6BAA6B,YAAY,IAAI"}
+{"version":3,"file":"command-loaders.js","names":[],"sources":["../../../src/cli/command-loaders.ts"],"sourcesContent":["/**\n * Lazy command loaders.\n *\n * Modules here trigger their `register({...})` side effect on import; the\n * caller then mounts the requested command via `registry.installOne` (or via\n * the explicit registrar functions for non-registry commands).\n *\n * Keeping this map static-but-thunked means `bin.ts` short-circuits and\n * `runCli` can resolve a single subcommand without paying for unrelated\n * command modules.\n */\nimport type { Command } from 'commander';\nimport { resolveCliCatalogCommandPath } from './command-path-policy.js';\nimport { shouldLoadExtensionCliForCommandPath } from './command-startup-policy.js';\nimport { registry, type CLIContext } from './registry.js';\n\nexport type CommandLoader = () => Promise<unknown>;\n\nexport const REGISTRY_COMMAND_MODULES: Record<string, CommandLoader> = {\n  init: () => import('./commands/init.js'),\n  profile: () => import('./commands/profile.js'),\n  setup: () => import('./commands/setup.js'),\n  onboard: () => import('./commands/onboard.js'),\n  agent: () => import('./commands/agent.js'),\n  tui: () => import('./commands/tui.js'),\n  gateway: () => import('./commands/gateway.js'),\n  session: () => import('./commands/session.js'),\n  project: () => import('./commands/project.js'),\n  goal: () => import('./commands/goal.js'),\n  config: () => import('./commands/config.js'),\n  doctor: () => import('./commands/doctor/index.js'),\n  image: () => import('./commands/image.js'),\n  channels: () => import('./commands/channels.js'),\n  models: () => import('./commands/models.js'),\n  providers: () => import('./commands/providers.js'),\n  voice: () => import('./commands/voice.js'),\n  search: () => import('./commands/search.js'),\n  auth: () => import('./commands/auth.js'),\n  skills: () => import('./commands/skills.js'),\n  connectors: () => import('./commands/connectors.js'),\n  browser: () => import('./commands/browser.js'),\n  update: () => import('./commands/update.js'),\n  logs: () => import('./commands/logs.js'),\n  tunnel: () => import('./commands/tunnel.js'),\n  tailscale: () => import('./commands/tailscale.js'),\n};\n\nexport interface NonRegistryMatcher {\n  matches: (name: string) => boolean;\n  load: (program: Command) => Promise<void>;\n}\n\nexport const NON_REGISTRY_COMMAND_MATCHERS: NonRegistryMatcher[] = [\n  {\n    matches: (name) => name === 'agents' || name.startsWith('agents:'),\n    load: async (program) => {\n      const { registerAgentsCli } = await import('./commands/agents.js');\n      registerAgentsCli(program);\n    },\n  },\n  {\n    matches: (name) => name === 'extensions',\n    load: async (program) => {\n      const { registerExtensionCommands } = await import('./commands/extension.js');\n      registerExtensionCommands(program);\n      const commandPath = resolveCliCatalogCommandPath(process.argv);\n      if (shouldLoadExtensionCliForCommandPath(commandPath)) {\n        const { registerExtensionCliCommands } = await import('./extension-cli-register.js');\n        await registerExtensionCliCommands(program);\n      }\n    },\n  },\n];\n\nconst FLAGS_WITH_VALUE = new Set(['--config', '--workspace']);\n\n/**\n * Resolve which command module to load based on argv. Skips global flags\n * (`--verbose`/`--config <path>`/`--workspace <path>`) and treats\n * `help <cmd>` as if the user had typed `<cmd>`, so that `xopc help gateway`\n * loads only the gateway module.\n */\nexport function resolveCommandName(argv: string[]): string | undefined {\n  let i = 2;\n  let firstSubcommand: string | undefined;\n  while (i < argv.length) {\n    const arg = argv[i];\n    if (!arg) {\n      i += 1;\n      continue;\n    }\n    if (arg.startsWith('-')) {\n      i += FLAGS_WITH_VALUE.has(arg) ? 2 : 1;\n      continue;\n    }\n    if (firstSubcommand === undefined) {\n      firstSubcommand = arg;\n      if (arg === 'help') {\n        i += 1;\n        continue;\n      }\n      return arg;\n    }\n    return arg;\n  }\n  return firstSubcommand;\n}\n\nexport async function tryLoadCommand(\n  program: Command,\n  ctx: CLIContext,\n  name: string,\n  getCtx?: () => CLIContext,\n): Promise<boolean> {\n  const moduleLoader = REGISTRY_COMMAND_MODULES[name];\n  if (moduleLoader) {\n    await moduleLoader();\n    const installed = registry.installOne(program, name, ctx, getCtx);\n    if (installed && name === 'gateway') {\n      const gatewayCmd = program.commands.find((command) => command.name() === 'gateway');\n      if (gatewayCmd) {\n        const { prepareGatewayCommandForArgv } = await import('./commands/gateway.js');\n        await prepareGatewayCommandForArgv(gatewayCmd, ctx);\n      }\n    }\n    return installed;\n  }\n  const matcher = NON_REGISTRY_COMMAND_MATCHERS.find((m) => m.matches(name));\n  if (matcher) {\n    await matcher.load(program);\n    return true;\n  }\n  return false;\n}\n\nexport async function loadAllCommands(\n  program: Command,\n  ctx: CLIContext,\n  getCtx?: () => CLIContext,\n): Promise<void> {\n  // Sequential to keep registration order deterministic; registry.install\n  // sorts by category and is stable within a category.\n  for (const loader of Object.values(REGISTRY_COMMAND_MODULES)) {\n    await loader();\n  }\n  registry.install(program, ctx, getCtx);\n  for (const matcher of NON_REGISTRY_COMMAND_MATCHERS) {\n    await matcher.load(program);\n  }\n  const gatewayCmd = program.commands.find((command) => command.name() === 'gateway');\n  if (gatewayCmd) {\n    const { prepareGatewayCommandForArgv } = await import('./commands/gateway.js');\n    await prepareGatewayCommandForArgv(gatewayCmd, ctx);\n  }\n}\n"],"mappings":";;;;AAkBA,MAAa,2BAA0D;CACrE,YAAY,OAAO;CACnB,eAAe,OAAO;CACtB,aAAa,OAAO;CACpB,eAAe,OAAO;CACtB,aAAa,OAAO;CACpB,WAAW,OAAO;CAClB,eAAe,OAAO;CACtB,eAAe,OAAO;CACtB,eAAe,OAAO;CACtB,YAAY,OAAO;CACnB,cAAc,OAAO;CACrB,cAAc,OAAO;CACrB,aAAa,OAAO;CACpB,gBAAgB,OAAO;CACvB,cAAc,OAAO;CACrB,iBAAiB,OAAO;CACxB,aAAa,OAAO;CACpB,cAAc,OAAO;CACrB,YAAY,OAAO;CACnB,cAAc,OAAO;CACrB,kBAAkB,OAAO;CACzB,eAAe,OAAO;CACtB,cAAc,OAAO;CACrB,YAAY,OAAO;CACnB,cAAc,OAAO;CACrB,iBAAiB,OAAO;CACzB;AAOD,MAAa,gCAAsD,CACjE;CACE,UAAU,SAAS,SAAS,YAAY,KAAK,WAAW,UAAU;CAClE,MAAM,OAAO,YAAY;EACvB,MAAM,EAAE,sBAAsB,MAAM,OAAO;AAC3C,oBAAkB,QAAQ;;CAE7B,EACD;CACE,UAAU,SAAS,SAAS;CAC5B,MAAM,OAAO,YAAY;EACvB,MAAM,EAAE,8BAA8B,MAAM,OAAO;AACnD,4BAA0B,QAAQ;AAElC,MAAI,qCADgB,6BAA6B,QAAQ,KACL,CAAC,EAAE;GACrD,MAAM,EAAE,iCAAiC,MAAM,OAAO;AACtD,SAAM,6BAA6B,QAAQ;;;CAGhD,CACF;AAED,MAAM,mBAAmB,IAAI,IAAI,CAAC,YAAY,cAAc,CAAC;;;;;;;AAQ7D,SAAgB,mBAAmB,MAAoC;CACrE,IAAI,IAAI;CACR,IAAI;AACJ,QAAO,IAAI,KAAK,QAAQ;EACtB,MAAM,MAAM,KAAK;AACjB,MAAI,CAAC,KAAK;AACR,QAAK;AACL;;AAEF,MAAI,IAAI,WAAW,IAAI,EAAE;AACvB,QAAK,iBAAiB,IAAI,IAAI,GAAG,IAAI;AACrC;;AAEF,MAAI,oBAAoB,KAAA,GAAW;AACjC,qBAAkB;AAClB,OAAI,QAAQ,QAAQ;AAClB,SAAK;AACL;;AAEF,UAAO;;AAET,SAAO;;AAET,QAAO;;AAGT,eAAsB,eACpB,SACA,KACA,MACA,QACkB;CAClB,MAAM,eAAe,yBAAyB;AAC9C,KAAI,cAAc;AAChB,QAAM,cAAc;EACpB,MAAM,YAAY,SAAS,WAAW,SAAS,MAAM,KAAK,OAAO;AACjE,MAAI,aAAa,SAAS,WAAW;GACnC,MAAM,aAAa,QAAQ,SAAS,MAAM,YAAY,QAAQ,MAAM,KAAK,UAAU;AACnF,OAAI,YAAY;IACd,MAAM,EAAE,iCAAiC,MAAM,OAAO;AACtD,UAAM,6BAA6B,YAAY,IAAI;;;AAGvD,SAAO;;CAET,MAAM,UAAU,8BAA8B,MAAM,MAAM,EAAE,QAAQ,KAAK,CAAC;AAC1E,KAAI,SAAS;AACX,QAAM,QAAQ,KAAK,QAAQ;AAC3B,SAAO;;AAET,QAAO;;AAGT,eAAsB,gBACpB,SACA,KACA,QACe;AAGf,MAAK,MAAM,UAAU,OAAO,OAAO,yBAAyB,CAC1D,OAAM,QAAQ;AAEhB,UAAS,QAAQ,SAAS,KAAK,OAAO;AACtC,MAAK,MAAM,WAAW,8BACpB,OAAM,QAAQ,KAAK,QAAQ;CAE7B,MAAM,aAAa,QAAQ,SAAS,MAAM,YAAY,QAAQ,MAAM,KAAK,UAAU;AACnF,KAAI,YAAY;EACd,MAAM,EAAE,iCAAiC,MAAM,OAAO;AACtD,QAAM,6BAA6B,YAAY,IAAI"}

package/dist/src/cli/command-manifest.js

@@ -115,6 +115,10 @@ const ROOT_HELP_COMMANDS = [
 		name: "skills",
 		description: "Manage skills"
 	},
+	{
+		name: "connectors",
+		description: "Browse and install verified connector capabilities from xopc-store"
+	},
 	{
 		name: "tailscale",
 		description: "Tailscale status for gateway remote access"

package/dist/src/cli/command-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-manifest.js","names":[],"sources":["../../../src/cli/command-manifest.ts"],"sourcesContent":["export type RootHelpOption = {\n  flags: string;\n  description: string;\n};\n\nexport type RootHelpCommand = {\n  name: string;\n  description: string;\n};\n\nexport const ROOT_COMMAND_DESCRIPTION = 'Ultra-Lightweight Personal AI Assistant. Run `xopc` with no command to open the local TUI.';\n\nexport const ROOT_HELP_OPTIONS: RootHelpOption[] = [\n  { flags: '-V, --version', description: 'output the version number' },\n  { flags: '--verbose', description: 'Enable verbose logging (default: false)' },\n  { flags: '--config <path>', description: 'Config file path' },\n  { flags: '--workspace <path>', description: 'Workspace directory' },\n  { flags: '-h, --help', description: 'display help for command' },\n];\n\nexport const ROOT_HELP_COMMANDS: RootHelpCommand[] = [\n  { name: 'init [options]', description: 'Initialize xopc state directories, config, and agent workspace' },\n  { name: 'setup [options]', description: 'Initialize config file and workspace directory' },\n  { name: 'profile', description: 'Manage xopc state profiles (~/.xopc vs ~/.xopc-<name>)' },\n  { name: 'onboard [options]', description: 'Interactive setup wizard for xopc (gateway uses schema defaults)' },\n  { name: 'channels', description: 'Messaging channel configuration' },\n  { name: 'auth', description: 'Manage authentication credentials' },\n  { name: 'agent [options]', description: 'Chat with the AI agent' },\n  { name: 'tui [options]', description: 'Interactive terminal UI (pi-tui)' },\n  { name: 'tunnel', description: 'Manage FRP remote access tunnel' },\n  { name: 'gateway [options]', description: 'Start the xopc gateway server' },\n  { name: 'session', description: 'Session management commands' },\n  { name: 'project', description: 'Manage long-running projects' },\n  { name: 'doctor [options]', description: 'Check xopc installation health and diagnose common issues' },\n  { name: 'update [options]', description: 'Check for and install xopc updates' },\n  { name: 'logs', description: 'Manage and query logs' },\n  { name: 'goal', description: 'Manage durable goals' },\n  { name: 'config [options]', description: 'View and edit configuration' },\n  { name: 'image', description: 'Inspect image provider availability' },\n  { name: 'models [options]', description: 'List and manage models and model auth' },\n  { name: 'providers', description: 'Manage LLM provider credentials (user-friendly hub over `xopc auth`)' },\n  { name: 'voice', description: 'Configure text-to-speech (TTS) output' },\n  { name: 'search', description: 'Manage web-search providers (brave / tavily / bing / searxng)' },\n  { name: 'skills', description: 'Manage skills' },\n  { name: 'tailscale', description: 'Tailscale status for gateway remote access' },\n  { name: 'browser', description: 'Browser automation commands (uses Playwright)' },\n  { name: 'agents', description: 'Manage agents (config + workspace)' },\n  { name: 'extensions', description: 'Manage extensions' },\n  { name: 'help [command]', description: 'display help for command' },\n];\n\nfunction formatRows(rows: Array<{ label: string; description: string }>): string {\n  const labelWidth = Math.max(...rows.map((row) => row.label.length)) + 2;\n  return rows.map((row) => `  ${row.label.padEnd(labelWidth)}${row.description}`).join('\\n');\n}\n\nexport function formatRootHelp(): string {\n  const options = formatRows(ROOT_HELP_OPTIONS.map((option) => ({ label: option.flags, description: option.description })));\n  const commands = formatRows(\n    ROOT_HELP_COMMANDS.map((command) => ({ label: command.name, description: command.description })),\n  );\n  return `Usage: xopc [options] [command]\n\n${ROOT_COMMAND_DESCRIPTION}\n\nOptions:\n${options}\n\nCommands:\n${commands}`;\n}\n"],"mappings":";AAUA,MAAa,2BAA2B;AAExC,MAAa,oBAAsC;CACjD;EAAE,OAAO;EAAiB,aAAa;EAA6B;CACpE;EAAE,OAAO;EAAa,aAAa;EAA2C;CAC9E;EAAE,OAAO;EAAmB,aAAa;EAAoB;CAC7D;EAAE,OAAO;EAAsB,aAAa;EAAuB;CACnE;EAAE,OAAO;EAAc,aAAa;EAA4B;CACjE;AAED,MAAa,qBAAwC;CACnD;EAAE,MAAM;EAAkB,aAAa;EAAkE;CACzG;EAAE,MAAM;EAAmB,aAAa;EAAkD;CAC1F;EAAE,MAAM;EAAW,aAAa;EAA0D;CAC1F;EAAE,MAAM;EAAqB,aAAa;EAAoE;CAC9G;EAAE,MAAM;EAAY,aAAa;EAAmC;CACpE;EAAE,MAAM;EAAQ,aAAa;EAAqC;CAClE;EAAE,MAAM;EAAmB,aAAa;EAA0B;CAClE;EAAE,MAAM;EAAiB,aAAa;EAAoC;CAC1E;EAAE,MAAM;EAAU,aAAa;EAAmC;CAClE;EAAE,MAAM;EAAqB,aAAa;EAAiC;CAC3E;EAAE,MAAM;EAAW,aAAa;EAA+B;CAC/D;EAAE,MAAM;EAAW,aAAa;EAAgC;CAChE;EAAE,MAAM;EAAoB,aAAa;EAA6D;CACtG;EAAE,MAAM;EAAoB,aAAa;EAAsC;CAC/E;EAAE,MAAM;EAAQ,aAAa;EAAyB;CACtD;EAAE,MAAM;EAAQ,aAAa;EAAwB;CACrD;EAAE,MAAM;EAAoB,aAAa;EAA+B;CACxE;EAAE,MAAM;EAAS,aAAa;EAAuC;CACrE;EAAE,MAAM;EAAoB,aAAa;EAAyC;CAClF;EAAE,MAAM;EAAa,aAAa;EAAwE;CAC1G;EAAE,MAAM;EAAS,aAAa;EAAyC;CACvE;EAAE,MAAM;EAAU,aAAa;EAAiE;CAChG;EAAE,MAAM;EAAU,aAAa;EAAiB;CAChD;EAAE,MAAM;EAAa,aAAa;EAA8C;CAChF;EAAE,MAAM;EAAW,aAAa;EAAiD;CACjF;EAAE,MAAM;EAAU,aAAa;EAAsC;CACrE;EAAE,MAAM;EAAc,aAAa;EAAqB;CACxD;EAAE,MAAM;EAAkB,aAAa;EAA4B;CACpE;AAED,SAAS,WAAW,MAA6D;CAC/E,MAAM,aAAa,KAAK,IAAI,GAAG,KAAK,KAAK,QAAQ,IAAI,MAAM,OAAO,CAAC,GAAG;AACtE,QAAO,KAAK,KAAK,QAAQ,KAAK,IAAI,MAAM,OAAO,WAAW,GAAG,IAAI,cAAc,CAAC,KAAK,KAAK;;AAG5F,SAAgB,iBAAyB;AAKvC,QAAO;;EAEP,yBAAyB;;;EANT,WAAW,kBAAkB,KAAK,YAAY;EAAE,OAAO,OAAO;EAAO,aAAa,OAAO;EAAa,EAAE,CASjH,CAAC;;;EARS,WACf,mBAAmB,KAAK,aAAa;EAAE,OAAO,QAAQ;EAAM,aAAa,QAAQ;EAAa,EAAE,CAU1F"}
+{"version":3,"file":"command-manifest.js","names":[],"sources":["../../../src/cli/command-manifest.ts"],"sourcesContent":["export type RootHelpOption = {\n  flags: string;\n  description: string;\n};\n\nexport type RootHelpCommand = {\n  name: string;\n  description: string;\n};\n\nexport const ROOT_COMMAND_DESCRIPTION = 'Ultra-Lightweight Personal AI Assistant. Run `xopc` with no command to open the local TUI.';\n\nexport const ROOT_HELP_OPTIONS: RootHelpOption[] = [\n  { flags: '-V, --version', description: 'output the version number' },\n  { flags: '--verbose', description: 'Enable verbose logging (default: false)' },\n  { flags: '--config <path>', description: 'Config file path' },\n  { flags: '--workspace <path>', description: 'Workspace directory' },\n  { flags: '-h, --help', description: 'display help for command' },\n];\n\nexport const ROOT_HELP_COMMANDS: RootHelpCommand[] = [\n  { name: 'init [options]', description: 'Initialize xopc state directories, config, and agent workspace' },\n  { name: 'setup [options]', description: 'Initialize config file and workspace directory' },\n  { name: 'profile', description: 'Manage xopc state profiles (~/.xopc vs ~/.xopc-<name>)' },\n  { name: 'onboard [options]', description: 'Interactive setup wizard for xopc (gateway uses schema defaults)' },\n  { name: 'channels', description: 'Messaging channel configuration' },\n  { name: 'auth', description: 'Manage authentication credentials' },\n  { name: 'agent [options]', description: 'Chat with the AI agent' },\n  { name: 'tui [options]', description: 'Interactive terminal UI (pi-tui)' },\n  { name: 'tunnel', description: 'Manage FRP remote access tunnel' },\n  { name: 'gateway [options]', description: 'Start the xopc gateway server' },\n  { name: 'session', description: 'Session management commands' },\n  { name: 'project', description: 'Manage long-running projects' },\n  { name: 'doctor [options]', description: 'Check xopc installation health and diagnose common issues' },\n  { name: 'update [options]', description: 'Check for and install xopc updates' },\n  { name: 'logs', description: 'Manage and query logs' },\n  { name: 'goal', description: 'Manage durable goals' },\n  { name: 'config [options]', description: 'View and edit configuration' },\n  { name: 'image', description: 'Inspect image provider availability' },\n  { name: 'models [options]', description: 'List and manage models and model auth' },\n  { name: 'providers', description: 'Manage LLM provider credentials (user-friendly hub over `xopc auth`)' },\n  { name: 'voice', description: 'Configure text-to-speech (TTS) output' },\n  { name: 'search', description: 'Manage web-search providers (brave / tavily / bing / searxng)' },\n  { name: 'skills', description: 'Manage skills' },\n  { name: 'connectors', description: 'Browse and install verified connector capabilities from xopc-store' },\n  { name: 'tailscale', description: 'Tailscale status for gateway remote access' },\n  { name: 'browser', description: 'Browser automation commands (uses Playwright)' },\n  { name: 'agents', description: 'Manage agents (config + workspace)' },\n  { name: 'extensions', description: 'Manage extensions' },\n  { name: 'help [command]', description: 'display help for command' },\n];\n\nfunction formatRows(rows: Array<{ label: string; description: string }>): string {\n  const labelWidth = Math.max(...rows.map((row) => row.label.length)) + 2;\n  return rows.map((row) => `  ${row.label.padEnd(labelWidth)}${row.description}`).join('\\n');\n}\n\nexport function formatRootHelp(): string {\n  const options = formatRows(ROOT_HELP_OPTIONS.map((option) => ({ label: option.flags, description: option.description })));\n  const commands = formatRows(\n    ROOT_HELP_COMMANDS.map((command) => ({ label: command.name, description: command.description })),\n  );\n  return `Usage: xopc [options] [command]\n\n${ROOT_COMMAND_DESCRIPTION}\n\nOptions:\n${options}\n\nCommands:\n${commands}`;\n}\n"],"mappings":";AAUA,MAAa,2BAA2B;AAExC,MAAa,oBAAsC;CACjD;EAAE,OAAO;EAAiB,aAAa;EAA6B;CACpE;EAAE,OAAO;EAAa,aAAa;EAA2C;CAC9E;EAAE,OAAO;EAAmB,aAAa;EAAoB;CAC7D;EAAE,OAAO;EAAsB,aAAa;EAAuB;CACnE;EAAE,OAAO;EAAc,aAAa;EAA4B;CACjE;AAED,MAAa,qBAAwC;CACnD;EAAE,MAAM;EAAkB,aAAa;EAAkE;CACzG;EAAE,MAAM;EAAmB,aAAa;EAAkD;CAC1F;EAAE,MAAM;EAAW,aAAa;EAA0D;CAC1F;EAAE,MAAM;EAAqB,aAAa;EAAoE;CAC9G;EAAE,MAAM;EAAY,aAAa;EAAmC;CACpE;EAAE,MAAM;EAAQ,aAAa;EAAqC;CAClE;EAAE,MAAM;EAAmB,aAAa;EAA0B;CAClE;EAAE,MAAM;EAAiB,aAAa;EAAoC;CAC1E;EAAE,MAAM;EAAU,aAAa;EAAmC;CAClE;EAAE,MAAM;EAAqB,aAAa;EAAiC;CAC3E;EAAE,MAAM;EAAW,aAAa;EAA+B;CAC/D;EAAE,MAAM;EAAW,aAAa;EAAgC;CAChE;EAAE,MAAM;EAAoB,aAAa;EAA6D;CACtG;EAAE,MAAM;EAAoB,aAAa;EAAsC;CAC/E;EAAE,MAAM;EAAQ,aAAa;EAAyB;CACtD;EAAE,MAAM;EAAQ,aAAa;EAAwB;CACrD;EAAE,MAAM;EAAoB,aAAa;EAA+B;CACxE;EAAE,MAAM;EAAS,aAAa;EAAuC;CACrE;EAAE,MAAM;EAAoB,aAAa;EAAyC;CAClF;EAAE,MAAM;EAAa,aAAa;EAAwE;CAC1G;EAAE,MAAM;EAAS,aAAa;EAAyC;CACvE;EAAE,MAAM;EAAU,aAAa;EAAiE;CAChG;EAAE,MAAM;EAAU,aAAa;EAAiB;CAChD;EAAE,MAAM;EAAc,aAAa;EAAsE;CACzG;EAAE,MAAM;EAAa,aAAa;EAA8C;CAChF;EAAE,MAAM;EAAW,aAAa;EAAiD;CACjF;EAAE,MAAM;EAAU,aAAa;EAAsC;CACrE;EAAE,MAAM;EAAc,aAAa;EAAqB;CACxD;EAAE,MAAM;EAAkB,aAAa;EAA4B;CACpE;AAED,SAAS,WAAW,MAA6D;CAC/E,MAAM,aAAa,KAAK,IAAI,GAAG,KAAK,KAAK,QAAQ,IAAI,MAAM,OAAO,CAAC,GAAG;AACtE,QAAO,KAAK,KAAK,QAAQ,KAAK,IAAI,MAAM,OAAO,WAAW,GAAG,IAAI,cAAc,CAAC,KAAK,KAAK;;AAG5F,SAAgB,iBAAyB;AAKvC,QAAO;;EAEP,yBAAyB;;;EANT,WAAW,kBAAkB,KAAK,YAAY;EAAE,OAAO,OAAO;EAAO,aAAa,OAAO;EAAa,EAAE,CASjH,CAAC;;;EARS,WACf,mBAAmB,KAAK,aAAa;EAAE,OAAO,QAAQ;EAAM,aAAa,QAAQ;EAAa,EAAE,CAU1F"}

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

@@ -8,10 +8,10 @@ import { MessageBus, MessageBusShutdownError } from "../../infra/bus/queue.js";
 import "../../infra/bus/index.js";
 import { AgentService } from "../../agent/service.js";
 import "../../agent/index.js";
-import { getWorkspacePath } from "../../config/workspace-path-helpers.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";
+import { getWorkspacePath } from "../../config/workspace-path-helpers.js";
+import "../../config/index.js";
 import { listSessions } from "./agent/sessions.js";
 import { renderStreamToTerminal } from "./agent/stream-renderer.js";
 import { startInteractiveChat } from "./agent/interactive.js";

package/dist/src/cli/commands/connectors.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { type CLIContext } from '../registry.js';
+declare function createConnectorsCommand(ctx: CLIContext): Command;
+export { createConnectorsCommand };

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

@@ -0,0 +1,96 @@
+import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
+import { getStoreConnectorInstallPlan, installStoreConnector, listStoreConnectors } from "../../capabilities/store-connector.js";
+import { register } from "../registry.js";
+import { confirm } from "@inquirer/prompts";
+import { Command } from "commander";
+//#region src/cli/commands/connectors.ts
+init_loader();
+function parsePairs(values, option) {
+	const output = {};
+	for (const value of values ?? []) {
+		const index = value.indexOf("=");
+		const key = index > 0 ? value.slice(0, index).trim() : "";
+		const raw = index > 0 ? value.slice(index + 1) : "";
+		if (!key || !raw) throw new Error(`${option} must use KEY=VALUE.`);
+		output[key] = raw;
+	}
+	return output;
+}
+function printPlan(plan) {
+	console.log("");
+	console.log("Connector install review");
+	console.log(`  Package: ${plan.packageName}@${plan.version}`);
+	console.log(`  Name: ${plan.definition.displayName}`);
+	console.log(`  Authentication: ${plan.definition.auth.mode}`);
+	console.log(`  Endpoint: ${plan.definition.runtime.type === "mcp" ? String(plan.definition.runtime.serverTemplate.url) : "n/a"}`);
+	if (plan.permissions.data?.length) console.log(`  Data permissions: ${plan.permissions.data.join(", ")}`);
+	if (plan.permissions.networkDomains?.length) console.log(`  Network domains: ${plan.permissions.networkDomains.join(", ")}`);
+	console.log("  Local command execution: denied");
+	console.log("");
+}
+function createConnectorsCommand(ctx) {
+	const command = new Command("connectors").description("Browse and install verified connector capabilities from xopc-store");
+	command.command("list [query]").description("List connector capabilities from xopc-store").option("--category <category>", "Filter by category").option("--json", "Output JSON").action(async (query, options) => {
+		const result = await listStoreConnectors(loadConfig(ctx.configPath), {
+			q: query,
+			category: options.category,
+			page: 1,
+			pageSize: 50
+		});
+		if (options.json) {
+			console.log(JSON.stringify(result, null, 2));
+			return;
+		}
+		if (result.items.length === 0) {
+			console.log("No connector capabilities found.");
+			return;
+		}
+		for (const item of result.items) {
+			console.log(`${item.name}${item.latestVersion ? `@${item.latestVersion}` : ""}`);
+			console.log(`  ${item.description}`);
+		}
+	});
+	command.command("install <packageName>").description("Verify and install a connector capability from xopc-store").option("--version <version>", "Install an exact version").option("--secret <KEY=VALUE>", "Provide a required secret; repeat for multiple values", (value, previous = []) => [...previous, value], []).option("--config-value <KEY=VALUE>", "Provide a connector config value; repeat for multiple values", (value, previous = []) => [...previous, value], []).option("-y, --yes", "Skip the interactive confirmation", false).action(async (packageName, options) => {
+		try {
+			const config = loadConfig(ctx.configPath);
+			printPlan(await getStoreConnectorInstallPlan(config, packageName, options.version));
+			if (!options.yes && process.stdin.isTTY) {
+				if (!await confirm({
+					message: "Install this connector?",
+					default: false
+				})) {
+					console.log("Install cancelled.");
+					return;
+				}
+			}
+			const { instance } = await installStoreConnector(config, packageName, {
+				secrets: parsePairs(options.secret, "--secret"),
+				config: parsePairs(options.configValue, "--config-value")
+			}, options.version);
+			await saveConfig(config, ctx.configPath);
+			console.log(`Installed ${instance.displayName} (${instance.instanceId}).`);
+		} catch (error) {
+			console.error(error instanceof Error ? error.message : String(error));
+			process.exitCode = 1;
+		}
+	});
+	return command;
+}
+register({
+	id: "connectors",
+	name: "connectors",
+	description: "Browse and install verified connector capabilities from xopc-store",
+	factory: createConnectorsCommand,
+	metadata: {
+		category: "setup",
+		examples: [
+			"xopc connectors list",
+			"xopc connectors install demo-connector",
+			"xopc connectors install api-connector --secret API_KEY=…"
+		]
+	}
+});
+//#endregion
+export { createConnectorsCommand };
+
+//# sourceMappingURL=connectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.js","names":[],"sources":["../../../../src/cli/commands/connectors.ts"],"sourcesContent":["import { confirm } from '@inquirer/prompts';\nimport { Command } from 'commander';\n\nimport type { ConnectorInstallInput } from '../../connectors/types.js';\nimport { getStoreConnectorInstallPlan, installStoreConnector, listStoreConnectors } from '../../capabilities/store-connector.js';\nimport { loadConfig, saveConfig } from '../../config/loader.js';\nimport { register, type CLIContext } from '../registry.js';\n\nfunction parsePairs(values: string[] | undefined, option: string): Record<string, string> {\n  const output: Record<string, string> = {};\n  for (const value of values ?? []) {\n    const index = value.indexOf('=');\n    const key = index > 0 ? value.slice(0, index).trim() : '';\n    const raw = index > 0 ? value.slice(index + 1) : '';\n    if (!key || !raw) {\n      throw new Error(`${option} must use KEY=VALUE.`);\n    }\n    output[key] = raw;\n  }\n  return output;\n}\n\nfunction printPlan(plan: Awaited<ReturnType<typeof getStoreConnectorInstallPlan>>): void {\n  console.log('');\n  console.log('Connector install review');\n  console.log(`  Package: ${plan.packageName}@${plan.version}`);\n  console.log(`  Name: ${plan.definition.displayName}`);\n  console.log(`  Authentication: ${plan.definition.auth.mode}`);\n  console.log(`  Endpoint: ${plan.definition.runtime.type === 'mcp' ? String(plan.definition.runtime.serverTemplate.url) : 'n/a'}`);\n  if (plan.permissions.data?.length) console.log(`  Data permissions: ${plan.permissions.data.join(', ')}`);\n  if (plan.permissions.networkDomains?.length) console.log(`  Network domains: ${plan.permissions.networkDomains.join(', ')}`);\n  console.log('  Local command execution: denied');\n  console.log('');\n}\n\nfunction createConnectorsCommand(ctx: CLIContext): Command {\n  const command = new Command('connectors').description('Browse and install verified connector capabilities from xopc-store');\n\n  command\n    .command('list [query]')\n    .description('List connector capabilities from xopc-store')\n    .option('--category <category>', 'Filter by category')\n    .option('--json', 'Output JSON')\n    .action(async (query: string | undefined, options: { category?: string; json?: boolean }) => {\n      const result = await listStoreConnectors(loadConfig(ctx.configPath), {\n        q: query,\n        category: options.category,\n        page: 1,\n        pageSize: 50,\n      });\n      if (options.json) {\n        console.log(JSON.stringify(result, null, 2));\n        return;\n      }\n      if (result.items.length === 0) {\n        console.log('No connector capabilities found.');\n        return;\n      }\n      for (const item of result.items) {\n        console.log(`${item.name}${item.latestVersion ? `@${item.latestVersion}` : ''}`);\n        console.log(`  ${item.description}`);\n      }\n    });\n\n  command\n    .command('install <packageName>')\n    .description('Verify and install a connector capability from xopc-store')\n    .option('--version <version>', 'Install an exact version')\n    .option('--secret <KEY=VALUE>', 'Provide a required secret; repeat for multiple values', (value, previous: string[] = []) => [...previous, value], [])\n    .option('--config-value <KEY=VALUE>', 'Provide a connector config value; repeat for multiple values', (value, previous: string[] = []) => [...previous, value], [])\n    .option('-y, --yes', 'Skip the interactive confirmation', false)\n    .action(async (packageName: string, options: {\n      version?: string;\n      secret?: string[];\n      configValue?: string[];\n      yes?: boolean;\n    }) => {\n      try {\n        const config = loadConfig(ctx.configPath);\n        const plan = await getStoreConnectorInstallPlan(config, packageName, options.version);\n        printPlan(plan);\n        if (!options.yes && process.stdin.isTTY) {\n          const accepted = await confirm({ message: 'Install this connector?', default: false });\n          if (!accepted) {\n            console.log('Install cancelled.');\n            return;\n          }\n        }\n        const input: ConnectorInstallInput = {\n          secrets: parsePairs(options.secret, '--secret'),\n          config: parsePairs(options.configValue, '--config-value'),\n        };\n        const { instance } = await installStoreConnector(config, packageName, input, options.version);\n        await saveConfig(config, ctx.configPath);\n        console.log(`Installed ${instance.displayName} (${instance.instanceId}).`);\n      } catch (error) {\n        console.error(error instanceof Error ? error.message : String(error));\n        process.exitCode = 1;\n      }\n    });\n\n  return command;\n}\n\nregister({\n  id: 'connectors',\n  name: 'connectors',\n  description: 'Browse and install verified connector capabilities from xopc-store',\n  factory: createConnectorsCommand,\n  metadata: {\n    category: 'setup',\n    examples: [\n      'xopc connectors list',\n      'xopc connectors install demo-connector',\n      'xopc connectors install api-connector --secret API_KEY=…',\n    ],\n  },\n});\n\nexport { createConnectorsCommand };\n"],"mappings":"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"}

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v25).`,
+		message: `SQLite schema v${status.dbVersion} (current release v28).`,
 		hints: []
 	};
 }