@xopcai/xopc 0.0.84 → 0.0.85

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

@@ -1,4 +1,5 @@
 import { commandRegistry } from "../registry.js";
+import { bulletList, commandBullet, joinBlocks, kvList, section } from "../format-output.js";
 //#region src/chat-commands/builtins/system.ts
 const helpCommand = {
 	id: "system.help",
@@ -18,17 +19,10 @@ const helpCommand = {
 			if (!byCategory.has(cmd.category)) byCategory.set(cmd.category, []);
 			byCategory.get(cmd.category).push(cmd);
 		}
-		const lines = ["📖 *Available Commands*\n"];
-		for (const [category, commands] of byCategory) {
-			lines.push(`*${category.toUpperCase()}*`);
-			for (const cmd of commands) {
-				const aliases = cmd.aliases?.length ? ` (${cmd.aliases.join(", ")})` : "";
-				lines.push(`/${cmd.name}${aliases} - ${cmd.description}`);
-			}
-			lines.push("");
-		}
+		const categoryBlocks = [];
+		for (const [category, commands] of byCategory) categoryBlocks.push(joinBlocks(section(category.toUpperCase()), commands.map((cmd) => commandBullet(cmd.name, cmd.description, cmd.aliases)).join("\n")));
 		return {
-			content: lines.join("\n"),
+			content: joinBlocks(section("📖 Available Commands"), ...categoryBlocks),
 			success: true
 		};
 	}
@@ -45,7 +39,11 @@ const startCommand = {
 	],
 	handler: async (_ctx) => {
 		return {
-			content: "👋 *Welcome to xopc!*\n\nI am your AI assistant. Here's what I can do:\n\n🤖 *AI Chat* - Just send a message to start chatting\n📊 *Session Management* - Use /new, /list, /usage\n🔧 *Model Selection* - `/models` shows names and `provider/model` refs; `/switch` uses that ref\n\nType /help to see all available commands.",
+			content: joinBlocks(section("👋 Welcome to xopc!"), "I am your AI assistant. Here's what I can do:", bulletList([
+				"**AI Chat** — Just send a message to start chatting",
+				"**Session Management** — Use `/new`, `/list`, `/usage`",
+				"**Model Selection** — `/models` shows names and `provider/model` refs; `/switch` uses that ref"
+			]), "Type `/help` to see all available commands."),
 			success: true
 		};
 	}
@@ -61,10 +59,27 @@ const settingsCommand = {
 		"group"
 	],
 	handler: async (ctx) => {
+		const model = ctx.getCurrentModel();
+		const sessionKey = ctx.sessionKey;
 		return {
-			content: `⚙️ *Current Settings*
-
-🤖 Model: ${ctx.getCurrentModel()}\n💬 Session: ${ctx.sessionKey}\n📱 Platform: ${ctx.source}\n👥 Group: ${ctx.isGroup ? "Yes" : "No"}`,
+			content: joinBlocks(section("⚙️ Current Settings"), kvList([
+				{
+					key: "Model",
+					value: model
+				},
+				{
+					key: "Session",
+					value: sessionKey
+				},
+				{
+					key: "Platform",
+					value: ctx.source
+				},
+				{
+					key: "Group",
+					value: ctx.isGroup ? "Yes" : "No"
+				}
+			])),
 			success: true
 		};
 	}
@@ -87,7 +102,7 @@ const skillsCommand = {
 			success: true
 		};
 		return {
-			content: "🛠️ *Skills Management*\n\nAvailable commands:\n/skills reload - Reload all skills from disk",
+			content: joinBlocks(section("🛠️ Skills Management"), bulletList(["`/skills reload` — Reload all skills from disk"])),
 			success: true
 		};
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"system.js","names":[],"sources":["../../../../src/chat-commands/builtins/system.ts"],"sourcesContent":["/**\n * System Commands\n *\n * Built-in system commands:\n * - /help - Show help message\n * - /start - Welcome message\n * - /settings - Show settings\n */\n\nimport type { CommandDefinition, CommandContext } from '../types.js';\nimport { commandRegistry } from '../registry.js';\n\nconst helpCommand: CommandDefinition = {\n  id: 'system.help',\n  name: 'help',\n  aliases: ['h', 'commands'],\n  description: 'Show available commands',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  handler: async (_ctx: CommandContext) => {\n    const allCommands = commandRegistry.list();\n\n    // Group by category\n    const byCategory = new Map<string, typeof allCommands>();\n    for (const cmd of allCommands) {\n      if (!byCategory.has(cmd.category)) {\n        byCategory.set(cmd.category, []);\n      }\n      byCategory.get(cmd.category)!.push(cmd);\n    }\n\n    const lines: string[] = ['📖 *Available Commands*\\n'];\n\n    for (const [category, commands] of byCategory) {\n      lines.push(`*${category.toUpperCase()}*`);\n      for (const cmd of commands) {\n        const aliases = cmd.aliases?.length ? ` (${cmd.aliases.join(', ')})` : '';\n        lines.push(`/${cmd.name}${aliases} - ${cmd.description}`);\n      }\n      lines.push('');\n    }\n\n    return {\n      content: lines.join('\\n'),\n      success: true,\n    };\n  },\n};\n\nconst startCommand: CommandDefinition = {\n  id: 'system.start',\n  name: 'start',\n  description: 'Show welcome message',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  handler: async (_ctx: CommandContext) => {\n    const content =\n      '👋 *Welcome to xopc!*\\n\\n' +\n      'I am your AI assistant. Here\\'s what I can do:\\n\\n' +\n      '🤖 *AI Chat* - Just send a message to start chatting\\n' +\n      '📊 *Session Management* - Use /new, /list, /usage\\n' +\n      '🔧 *Model Selection* - `/models` shows names and `provider/model` refs; `/switch` uses that ref\\n\\n' +\n      'Type /help to see all available commands.';\n\n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\nconst settingsCommand: CommandDefinition = {\n  id: 'system.settings',\n  name: 'settings',\n  description: 'Show current settings',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    const model = ctx.getCurrentModel();\n    const sessionKey = ctx.sessionKey;\n\n    const content =\n      '⚙️ *Current Settings*\\n\\n' +\n      `🤖 Model: ${model}\\n` +\n      `💬 Session: ${sessionKey}\\n` +\n      `📱 Platform: ${ctx.source}\\n` +\n      `👥 Group: ${ctx.isGroup ? 'Yes' : 'No'}`;\n\n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\nconst skillsCommand: CommandDefinition = {\n  id: 'system.skills',\n  name: 'skills',\n  description: 'Manage skills (e.g., /skills reload)',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/skills reload'],\n  handler: async (ctx: CommandContext, args: string) => {\n    if (args === 'reload') {\n      // Publish system event to reload skills\n      // This will be handled by AgentService skill reload logic\n      return {\n        content: '✅ Skills reloaded successfully',\n        success: true,\n      };\n    }\n    \n    return {\n      content: \n        '🛠️ *Skills Management*\\n\\n' +\n        'Available commands:\\n' +\n        '/skills reload - Reload all skills from disk',\n      success: true,\n    };\n  },\n};\n\n// Register all system commands\nexport function registerSystemCommands(): void {\n  commandRegistry.register(helpCommand);\n  commandRegistry.register(startCommand);\n  commandRegistry.register(settingsCommand);\n  commandRegistry.register(skillsCommand);\n}\n"],"mappings":";;AAYA,MAAM,cAAiC;CACrC,IAAI;CACJ,MAAM;CACN,SAAS,CAAC,KAAK,WAAW;CAC1B,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,SAAyB;EACvC,MAAM,cAAc,gBAAgB,MAAM;EAG1C,MAAM,6BAAa,IAAI,KAAiC;AACxD,OAAK,MAAM,OAAO,aAAa;AAC7B,OAAI,CAAC,WAAW,IAAI,IAAI,SAAS,CAC/B,YAAW,IAAI,IAAI,UAAU,EAAE,CAAC;AAElC,cAAW,IAAI,IAAI,SAAS,CAAE,KAAK,IAAI;;EAGzC,MAAM,QAAkB,CAAC,4BAA4B;AAErD,OAAK,MAAM,CAAC,UAAU,aAAa,YAAY;AAC7C,SAAM,KAAK,IAAI,SAAS,aAAa,CAAC,GAAG;AACzC,QAAK,MAAM,OAAO,UAAU;IAC1B,MAAM,UAAU,IAAI,SAAS,SAAS,KAAK,IAAI,QAAQ,KAAK,KAAK,CAAC,KAAK;AACvE,UAAM,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,IAAI,cAAc;;AAE3D,SAAM,KAAK,GAAG;;AAGhB,SAAO;GACL,SAAS,MAAM,KAAK,KAAK;GACzB,SAAS;GACV;;CAEJ;AAED,MAAM,eAAkC;CACtC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,SAAyB;AASvC,SAAO;GACL,SAAA;GACA,SAAS;GACV;;CAEJ;AAED,MAAM,kBAAqC;CACzC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,QAAwB;AAWtC,SAAO;GACL,SAAA;;YAXY,IAAI,iBAKE,CAAC,gBAJF,IAAI,WAKK,iBACV,IAAI,OAAO,cACd,IAAI,UAAU,QAAQ;GAInC,SAAS;GACV;;CAEJ;AAED,MAAM,gBAAmC;CACvC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,aAAa;CACb,UAAU,CAAC,iBAAiB;CAC5B,SAAS,OAAO,KAAqB,SAAiB;AACpD,MAAI,SAAS,SAGX,QAAO;GACL,SAAS;GACT,SAAS;GACV;AAGH,SAAO;GACL,SACE;GAGF,SAAS;GACV;;CAEJ;AAGD,SAAgB,yBAA+B;AAC7C,iBAAgB,SAAS,YAAY;AACrC,iBAAgB,SAAS,aAAa;AACtC,iBAAgB,SAAS,gBAAgB;AACzC,iBAAgB,SAAS,cAAc"}
+{"version":3,"file":"system.js","names":[],"sources":["../../../../src/chat-commands/builtins/system.ts"],"sourcesContent":["/**\n * System Commands\n *\n * Built-in system commands:\n * - /help - Show help message\n * - /start - Welcome message\n * - /settings - Show settings\n */\n\nimport type { CommandDefinition, CommandContext } from '../types.js';\nimport { commandRegistry } from '../registry.js';\nimport { bulletList, commandBullet, joinBlocks, kvList, section } from '../format-output.js';\n\nconst helpCommand: CommandDefinition = {\n  id: 'system.help',\n  name: 'help',\n  aliases: ['h', 'commands'],\n  description: 'Show available commands',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  handler: async (_ctx: CommandContext) => {\n    const allCommands = commandRegistry.list();\n\n    // Group by category\n    const byCategory = new Map<string, typeof allCommands>();\n    for (const cmd of allCommands) {\n      if (!byCategory.has(cmd.category)) {\n        byCategory.set(cmd.category, []);\n      }\n      byCategory.get(cmd.category)!.push(cmd);\n    }\n\n    const categoryBlocks: string[] = [];\n    for (const [category, commands] of byCategory) {\n      categoryBlocks.push(\n        joinBlocks(\n          section(category.toUpperCase()),\n          commands\n            .map((cmd) => commandBullet(cmd.name, cmd.description, cmd.aliases))\n            .join('\\n'),\n        ),\n      );\n    }\n\n    return {\n      content: joinBlocks(section('📖 Available Commands'), ...categoryBlocks),\n      success: true,\n    };\n  },\n};\n\nconst startCommand: CommandDefinition = {\n  id: 'system.start',\n  name: 'start',\n  description: 'Show welcome message',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  handler: async (_ctx: CommandContext) => {\n    const content = joinBlocks(\n      section('👋 Welcome to xopc!'),\n      \"I am your AI assistant. Here's what I can do:\",\n      bulletList([\n        '**AI Chat** — Just send a message to start chatting',\n        '**Session Management** — Use `/new`, `/list`, `/usage`',\n        '**Model Selection** — `/models` shows names and `provider/model` refs; `/switch` uses that ref',\n      ]),\n      'Type `/help` to see all available commands.',\n    );\n\n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\nconst settingsCommand: CommandDefinition = {\n  id: 'system.settings',\n  name: 'settings',\n  description: 'Show current settings',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    const model = ctx.getCurrentModel();\n    const sessionKey = ctx.sessionKey;\n\n    const content = joinBlocks(\n      section('⚙️ Current Settings'),\n      kvList([\n        { key: 'Model', value: model },\n        { key: 'Session', value: sessionKey },\n        { key: 'Platform', value: ctx.source },\n        { key: 'Group', value: ctx.isGroup ? 'Yes' : 'No' },\n      ]),\n    );\n\n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\nconst skillsCommand: CommandDefinition = {\n  id: 'system.skills',\n  name: 'skills',\n  description: 'Manage skills (e.g., /skills reload)',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/skills reload'],\n  handler: async (ctx: CommandContext, args: string) => {\n    if (args === 'reload') {\n      // Publish system event to reload skills\n      // This will be handled by AgentService skill reload logic\n      return {\n        content: '✅ Skills reloaded successfully',\n        success: true,\n      };\n    }\n\n    const content = joinBlocks(\n      section('🛠️ Skills Management'),\n      bulletList(['`/skills reload` — Reload all skills from disk']),\n    );\n\n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\n// Register all system commands\nexport function registerSystemCommands(): void {\n  commandRegistry.register(helpCommand);\n  commandRegistry.register(startCommand);\n  commandRegistry.register(settingsCommand);\n  commandRegistry.register(skillsCommand);\n}\n"],"mappings":";;;AAaA,MAAM,cAAiC;CACrC,IAAI;CACJ,MAAM;CACN,SAAS,CAAC,KAAK,WAAW;CAC1B,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,SAAyB;EACvC,MAAM,cAAc,gBAAgB,MAAM;EAG1C,MAAM,6BAAa,IAAI,KAAiC;AACxD,OAAK,MAAM,OAAO,aAAa;AAC7B,OAAI,CAAC,WAAW,IAAI,IAAI,SAAS,CAC/B,YAAW,IAAI,IAAI,UAAU,EAAE,CAAC;AAElC,cAAW,IAAI,IAAI,SAAS,CAAE,KAAK,IAAI;;EAGzC,MAAM,iBAA2B,EAAE;AACnC,OAAK,MAAM,CAAC,UAAU,aAAa,WACjC,gBAAe,KACb,WACE,QAAQ,SAAS,aAAa,CAAC,EAC/B,SACG,KAAK,QAAQ,cAAc,IAAI,MAAM,IAAI,aAAa,IAAI,QAAQ,CAAC,CACnE,KAAK,KAAK,CACd,CACF;AAGH,SAAO;GACL,SAAS,WAAW,QAAQ,wBAAwB,EAAE,GAAG,eAAe;GACxE,SAAS;GACV;;CAEJ;AAED,MAAM,eAAkC;CACtC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,SAAyB;AAYvC,SAAO;GACL,SAZc,WACd,QAAQ,sBAAsB,EAC9B,iDACA,WAAW;IACT;IACA;IACA;IACD,CAAC,EACF,8CAIO;GACP,SAAS;GACV;;CAEJ;AAED,MAAM,kBAAqC;CACzC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,QAAwB;EACtC,MAAM,QAAQ,IAAI,iBAAiB;EACnC,MAAM,aAAa,IAAI;AAYvB,SAAO;GACL,SAXc,WACd,QAAQ,sBAAsB,EAC9B,OAAO;IACL;KAAE,KAAK;KAAS,OAAO;KAAO;IAC9B;KAAE,KAAK;KAAW,OAAO;KAAY;IACrC;KAAE,KAAK;KAAY,OAAO,IAAI;KAAQ;IACtC;KAAE,KAAK;KAAS,OAAO,IAAI,UAAU,QAAQ;KAAM;IACpD,CAAC,CAIK;GACP,SAAS;GACV;;CAEJ;AAED,MAAM,gBAAmC;CACvC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,aAAa;CACb,UAAU,CAAC,iBAAiB;CAC5B,SAAS,OAAO,KAAqB,SAAiB;AACpD,MAAI,SAAS,SAGX,QAAO;GACL,SAAS;GACT,SAAS;GACV;AAQH,SAAO;GACL,SANc,WACd,QAAQ,wBAAwB,EAChC,WAAW,CAAC,iDAAiD,CAAC,CAIvD;GACP,SAAS;GACV;;CAEJ;AAGD,SAAgB,yBAA+B;AAC7C,iBAAgB,SAAS,YAAY;AACrC,iBAAgB,SAAS,aAAa;AACtC,iBAAgB,SAAS,gBAAgB;AACzC,iBAAgB,SAAS,cAAc"}

package/dist/src/chat-commands/builtins/workflow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `/workflows` and `/workflow <subcommand>` — read-only commands for browsing
+ * saved workflows.
+ *
+ * Why only read commands here? Slash command results are sent to the user; they
+ * are NOT injected back into the agent's turn. Triggering a workflow run from
+ * the slash layer would require a non-trivial cross-cutting "inject this as the
+ * next user message" hook that doesn't exist yet. Instead, the workflow tool
+ * understands `name`, and its description tells the model to prefer that route
+ * whenever a user mentions a saved workflow by name. Plain text — "run the
+ * audit_repo workflow" — works end-to-end.
+ *
+ * `/workflows` and `/workflow view` make discovery cheap, which is the missing
+ * piece.
+ */
+import type { CommandDefinition } from '../types.js';
+export declare const workflowCommand: CommandDefinition;
+export declare function registerWorkflowCommands(): void;

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

@@ -0,0 +1,167 @@
+import { createWorkflowCatalog } from "../../agent/workflow/catalog.js";
+import { getLastWorkflowMemory } from "../../agent/workflow/last-run-memory.js";
+import { commandRegistry } from "../registry.js";
+import { bulletList, code, joinBlocks, section } from "../format-output.js";
+//#region src/chat-commands/builtins/workflow.ts
+/**
+* `/workflows` and `/workflow <subcommand>` — read-only commands for browsing
+* saved workflows.
+*
+* Why only read commands here? Slash command results are sent to the user; they
+* are NOT injected back into the agent's turn. Triggering a workflow run from
+* the slash layer would require a non-trivial cross-cutting "inject this as the
+* next user message" hook that doesn't exist yet. Instead, the workflow tool
+* understands `name`, and its description tells the model to prefer that route
+* whenever a user mentions a saved workflow by name. Plain text — "run the
+* audit_repo workflow" — works end-to-end.
+*
+* `/workflows` and `/workflow view` make discovery cheap, which is the missing
+* piece.
+*/
+const VIEW_MAX_LINES = 200;
+function formatWorkflowListContent(entries, userDir) {
+	const grouped = {
+		builtin: entries.filter((e) => e.source === "builtin"),
+		user: entries.filter((e) => e.source === "user")
+	};
+	const exampleName = entries[0]?.name ?? "audit_repo";
+	const blocks = [];
+	if (grouped.user.length > 0) blocks.push(joinBlocks(section("User workflows"), bulletList(grouped.user.map((e) => ({
+		label: e.name,
+		detail: e.description
+	})))));
+	if (grouped.builtin.length > 0) blocks.push(joinBlocks(section("Built-in workflows"), bulletList(grouped.builtin.map((e) => ({
+		label: e.name,
+		detail: e.description
+	})))));
+	blocks.push(joinBlocks(section("How to run"), bulletList([
+		`Plain language: "run the ${exampleName} workflow"`,
+		`Inspect source: ${code(`/workflow view ${exampleName}`)}`,
+		`Add your own: drop a ${code(".js")} at ${code(userDir)}`
+	])));
+	return joinBlocks(...blocks);
+}
+const workflowsCommand = {
+	id: "system.workflows",
+	name: "workflows",
+	description: "List saved workflows (built-in + ~/.xopc/workflows/)",
+	category: "system",
+	scope: [
+		"global",
+		"private",
+		"group"
+	],
+	handler: async (_ctx) => {
+		const catalog = createWorkflowCatalog();
+		const entries = catalog.list();
+		if (entries.length === 0) return {
+			content: `No workflows found. Drop a script at ${code(`${catalog.userDir}/<name>.js`)} to add one.`,
+			success: true
+		};
+		return {
+			content: formatWorkflowListContent(entries, catalog.userDir),
+			success: true
+		};
+	}
+};
+const workflowCommand = {
+	id: "system.workflow",
+	name: "workflow",
+	description: "Inspect or manage saved workflows. Subcommands: list, view <name>",
+	category: "system",
+	scope: [
+		"global",
+		"private",
+		"group"
+	],
+	acceptsArgs: true,
+	examples: ["/workflow list", "/workflow view audit_repo"],
+	handler: async (ctx, args) => {
+		const trimmed = args.trim();
+		if (!trimmed || trimmed.toLowerCase() === "list") return workflowsCommand.handler(ctx, "");
+		const [sub, ...rest] = trimmed.split(/\s+/);
+		const subLower = sub.toLowerCase();
+		const target = rest.join(" ").trim();
+		if (subLower === "view" || subLower === "show" || subLower === "cat") {
+			if (!target) return {
+				content: `usage: ${code("/workflow view <name>")}`,
+				success: false
+			};
+			const catalog = createWorkflowCatalog();
+			try {
+				const loaded = catalog.load(target);
+				const lines = loaded.script.split("\n");
+				const visible = lines.length > VIEW_MAX_LINES ? [...lines.slice(0, VIEW_MAX_LINES), `… (truncated; ${lines.length - VIEW_MAX_LINES} more lines)`] : lines;
+				const source = loaded.source === "user" ? loaded.path ?? "user" : "built-in";
+				return {
+					content: joinBlocks(`**${loaded.name}** (${source}) — ${loaded.meta.description}`, "```js\n" + visible.join("\n") + "\n```"),
+					success: true
+				};
+			} catch (e) {
+				return {
+					content: `error: ${e instanceof Error ? e.message : String(e)}`,
+					success: false
+				};
+			}
+		}
+		if (subLower === "run" || subLower === "start") {
+			const name = target || "<name>";
+			return {
+				content: joinBlocks(`To run a workflow, ask in plain language: "run the ${name} workflow".`, `The assistant will call the workflow tool with ${code(`name="${name}"`)} and stream progress inline.`),
+				success: true
+			};
+		}
+		if (subLower === "save") {
+			if (!target) return {
+				content: `usage: ${code("/workflow save <name>")}`,
+				success: false
+			};
+			const last = getLastWorkflowMemory().get(ctx.sessionKey);
+			if (!last) return {
+				content: "No workflow has run successfully in this session yet. Run one first (e.g. ask \"run the audit_repo workflow\"), then `/workflow save <name>`.",
+				success: false
+			};
+			const catalog = createWorkflowCatalog();
+			try {
+				const script = last.metaName === target ? last.script : rewriteMetaName(last.script, target);
+				const { path } = catalog.save(target, script);
+				return {
+					content: joinBlocks(`✓ Saved workflow **${target}** → ${code(path)}`, bulletList([`Trigger with ${code(`/${target}`)} or "run the ${target} workflow"`, `Inspect with ${code(`/workflow view ${target}`)}`])),
+					success: true
+				};
+			} catch (e) {
+				return {
+					content: `error: ${e instanceof Error ? e.message : String(e)}`,
+					success: false
+				};
+			}
+		}
+		return {
+			content: joinBlocks(`Unknown subcommand "${sub}". Available: list, view ${code("<name>")}, save ${code("<name>")}.`, "To run a workflow, ask in plain language (\"run the audit_repo workflow\") — the assistant uses the workflow tool with `name=\"...\"`."),
+			success: false
+		};
+	}
+};
+/**
+* Replace the `name` field inside the FIRST `export const meta = { ... }` literal.
+*
+* Why text-level (not AST re-emit)? The parser already accepted the script
+* once (the runtime ran it), so the surrounding code is unchanged. A targeted
+* regex on the `name: '...'` slot inside the first object literal keeps the
+* user's formatting / comments / quote style intact, which an AST round-trip
+* would smash. The match anchors to the first `name:` after `export const meta`
+* and only touches that single value.
+*/
+function rewriteMetaName(script, newName) {
+	const re = /(export\s+const\s+meta\s*=\s*\{[^}]*?\bname\s*:\s*)(['"`])([^'"`]*)\2/;
+	if (!re.test(script)) throw new Error("could not locate meta.name in the recorded script to rewrite");
+	return script.replace(re, (_m, prefix, quote) => `${prefix}${quote}${newName}${quote}`);
+}
+function registerWorkflowCommands() {
+	commandRegistry.register(workflowsCommand);
+	commandRegistry.register(workflowCommand);
+}
+//#endregion
+export { registerWorkflowCommands, workflowCommand };
+
+//# sourceMappingURL=workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","names":[],"sources":["../../../../src/chat-commands/builtins/workflow.ts"],"sourcesContent":["/**\n * `/workflows` and `/workflow <subcommand>` — read-only commands for browsing\n * saved workflows.\n *\n * Why only read commands here? Slash command results are sent to the user; they\n * are NOT injected back into the agent's turn. Triggering a workflow run from\n * the slash layer would require a non-trivial cross-cutting \"inject this as the\n * next user message\" hook that doesn't exist yet. Instead, the workflow tool\n * understands `name`, and its description tells the model to prefer that route\n * whenever a user mentions a saved workflow by name. Plain text — \"run the\n * audit_repo workflow\" — works end-to-end.\n *\n * `/workflows` and `/workflow view` make discovery cheap, which is the missing\n * piece.\n */\n\nimport { commandRegistry } from '../registry.js';\nimport type { CommandContext, CommandDefinition } from '../types.js';\nimport { bulletList, code, joinBlocks, section } from '../format-output.js';\n\nimport { createWorkflowCatalog } from '../../agent/workflow/catalog.js';\nimport { getLastWorkflowMemory } from '../../agent/workflow/last-run-memory.js';\nimport type { CatalogEntry } from '../../agent/workflow/catalog.js';\n\nconst VIEW_MAX_LINES = 200;\n\nfunction formatWorkflowListContent(entries: CatalogEntry[], userDir: string): string {\n  const grouped = {\n    builtin: entries.filter((e) => e.source === 'builtin'),\n    user: entries.filter((e) => e.source === 'user'),\n  };\n  const exampleName = entries[0]?.name ?? 'audit_repo';\n  const blocks: string[] = [];\n\n  if (grouped.user.length > 0) {\n    blocks.push(\n      joinBlocks(\n        section('User workflows'),\n        bulletList(grouped.user.map((e) => ({ label: e.name, detail: e.description }))),\n      ),\n    );\n  }\n  if (grouped.builtin.length > 0) {\n    blocks.push(\n      joinBlocks(\n        section('Built-in workflows'),\n        bulletList(grouped.builtin.map((e) => ({ label: e.name, detail: e.description }))),\n      ),\n    );\n  }\n\n  blocks.push(\n    joinBlocks(\n      section('How to run'),\n      bulletList([\n        `Plain language: \"run the ${exampleName} workflow\"`,\n        `Inspect source: ${code(`/workflow view ${exampleName}`)}`,\n        `Add your own: drop a ${code('.js')} at ${code(userDir)}`,\n      ]),\n    ),\n  );\n\n  return joinBlocks(...blocks);\n}\n\nconst workflowsCommand: CommandDefinition = {\n  id: 'system.workflows',\n  name: 'workflows',\n  description: 'List saved workflows (built-in + ~/.xopc/workflows/)',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  handler: async (_ctx: CommandContext) => {\n    const catalog = createWorkflowCatalog();\n    const entries = catalog.list();\n    if (entries.length === 0) {\n      return {\n        content: `No workflows found. Drop a script at ${code(`${catalog.userDir}/<name>.js`)} to add one.`,\n        success: true,\n      };\n    }\n    return { content: formatWorkflowListContent(entries, catalog.userDir), success: true };\n  },\n};\n\nexport const workflowCommand: CommandDefinition = {\n  id: 'system.workflow',\n  name: 'workflow',\n  description: 'Inspect or manage saved workflows. Subcommands: list, view <name>',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/workflow list', '/workflow view audit_repo'],\n  handler: async (ctx: CommandContext, args: string) => {\n    const trimmed = args.trim();\n    if (!trimmed || trimmed.toLowerCase() === 'list') {\n      return workflowsCommand.handler(ctx, '');\n    }\n    const [sub, ...rest] = trimmed.split(/\\s+/);\n    const subLower = sub.toLowerCase();\n    const target = rest.join(' ').trim();\n\n    if (subLower === 'view' || subLower === 'show' || subLower === 'cat') {\n      if (!target) {\n        return { content: `usage: ${code('/workflow view <name>')}`, success: false };\n      }\n      const catalog = createWorkflowCatalog();\n      try {\n        const loaded = catalog.load(target);\n        const lines = loaded.script.split('\\n');\n        const visible =\n          lines.length > VIEW_MAX_LINES\n            ? [...lines.slice(0, VIEW_MAX_LINES), `… (truncated; ${lines.length - VIEW_MAX_LINES} more lines)`]\n            : lines;\n        const source = loaded.source === 'user' ? loaded.path ?? 'user' : 'built-in';\n        return {\n          content: joinBlocks(\n            `**${loaded.name}** (${source}) — ${loaded.meta.description}`,\n            '```js\\n' + visible.join('\\n') + '\\n```',\n          ),\n          success: true,\n        };\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        return { content: `error: ${message}`, success: false };\n      }\n    }\n\n    if (subLower === 'run' || subLower === 'start') {\n      const name = target || '<name>';\n      return {\n        content: joinBlocks(\n          `To run a workflow, ask in plain language: \"run the ${name} workflow\".`,\n          `The assistant will call the workflow tool with ${code(`name=\"${name}\"`)} and stream progress inline.`,\n        ),\n        success: true,\n      };\n    }\n\n    if (subLower === 'save') {\n      if (!target) {\n        return { content: `usage: ${code('/workflow save <name>')}`, success: false };\n      }\n      const last = getLastWorkflowMemory().get(ctx.sessionKey);\n      if (!last) {\n        return {\n          content:\n            'No workflow has run successfully in this session yet. Run one first (e.g. ask \"run the audit_repo workflow\"), then `/workflow save <name>`.',\n          success: false,\n        };\n      }\n      const catalog = createWorkflowCatalog();\n      try {\n        // Allow the user to rename: if target differs from meta.name, rewrite it\n        // before saving so the file is addressable as `target`.\n        const script =\n          last.metaName === target ? last.script : rewriteMetaName(last.script, target);\n        const { path } = catalog.save(target, script);\n        return {\n          content: joinBlocks(\n            `✓ Saved workflow **${target}** → ${code(path)}`,\n            bulletList([\n              `Trigger with ${code(`/${target}`)} or \"run the ${target} workflow\"`,\n              `Inspect with ${code(`/workflow view ${target}`)}`,\n            ]),\n          ),\n          success: true,\n        };\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        return { content: `error: ${message}`, success: false };\n      }\n    }\n\n    return {\n      content: joinBlocks(\n        `Unknown subcommand \"${sub}\". Available: list, view ${code('<name>')}, save ${code('<name>')}.`,\n        'To run a workflow, ask in plain language (\"run the audit_repo workflow\") — the assistant uses the workflow tool with `name=\"...\"`.',\n      ),\n      success: false,\n    };\n  },\n};\n\n/**\n * Replace the `name` field inside the FIRST `export const meta = { ... }` literal.\n *\n * Why text-level (not AST re-emit)? The parser already accepted the script\n * once (the runtime ran it), so the surrounding code is unchanged. A targeted\n * regex on the `name: '...'` slot inside the first object literal keeps the\n * user's formatting / comments / quote style intact, which an AST round-trip\n * would smash. The match anchors to the first `name:` after `export const meta`\n * and only touches that single value.\n */\nfunction rewriteMetaName(script: string, newName: string): string {\n  const re = /(export\\s+const\\s+meta\\s*=\\s*\\{[^}]*?\\bname\\s*:\\s*)(['\"`])([^'\"`]*)\\2/;\n  if (!re.test(script)) {\n    throw new Error('could not locate meta.name in the recorded script to rewrite');\n  }\n  return script.replace(re, (_m, prefix, quote) => `${prefix}${quote}${newName}${quote}`);\n}\n\nexport function registerWorkflowCommands(): void {\n  commandRegistry.register(workflowsCommand);\n  commandRegistry.register(workflowCommand);\n}\n"],"mappings":"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"}

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

@@ -4,8 +4,8 @@ import { init_loader, saveConfig } from "../config/loader.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getRoutingInfo, getSessionDisplayName } from "./session-key.js";
 import { wrapMarkdownExportAsHtml } from "../session/chat-export.js";
-import { mkdir, writeFile } from "fs/promises";
 import { join } from "path";
+import { mkdir, writeFile } from "fs/promises";
 //#region src/chat-commands/context.ts
 init_logger();
 init_loader();

package/dist/src/chat-commands/format-output.d.ts

@@ -0,0 +1,28 @@
+/**
+ * GFM formatters for slash-command replies.
+ *
+ * Command output is rendered as Markdown on Web UI, TUI (gateway), and channels
+ * (Telegram IR). Use blank-line-separated blocks and `-` lists — not single
+ * newlines or unicode `•` bullets — so lists and headings parse correctly.
+ */
+/** Join non-empty blocks with a blank line (GFM paragraph separation). */
+export declare function joinBlocks(...blocks: Array<string | undefined | null | false>): string;
+/** Section heading (bold). */
+export declare function section(title: string): string;
+/** Inline code span. */
+export declare function code(text: string): string;
+/** Italic hint / footnote. */
+export declare function hint(text: string): string;
+export type BulletItem = string | {
+    label: string;
+    detail: string;
+};
+/** GFM bullet list (`-` prefix). */
+export declare function bulletList(items: BulletItem[]): string;
+/** Settings-style key/value bullets. */
+export declare function kvList(entries: Array<{
+    key: string;
+    value: string;
+}>): string;
+/** Slash command reference line in a bullet list. */
+export declare function commandBullet(name: string, description: string, aliases?: string[]): string;

package/dist/src/chat-commands/format-output.js

@@ -0,0 +1,45 @@
+//#region src/chat-commands/format-output.ts
+/**
+* GFM formatters for slash-command replies.
+*
+* Command output is rendered as Markdown on Web UI, TUI (gateway), and channels
+* (Telegram IR). Use blank-line-separated blocks and `-` lists — not single
+* newlines or unicode `•` bullets — so lists and headings parse correctly.
+*/
+/** Join non-empty blocks with a blank line (GFM paragraph separation). */
+function joinBlocks(...blocks) {
+	return blocks.filter((b) => typeof b === "string" && b.trim().length > 0).join("\n\n").trimEnd();
+}
+/** Section heading (bold). */
+function section(title) {
+	return `**${title}**`;
+}
+/** Inline code span. */
+function code(text) {
+	return `\`${text}\``;
+}
+/** Italic hint / footnote. */
+function hint(text) {
+	return `_${text}_`;
+}
+/** GFM bullet list (`-` prefix). */
+function bulletList(items) {
+	if (items.length === 0) return "";
+	return items.map((item) => {
+		if (typeof item === "string") return `- ${item}`;
+		return `- **${item.label}** — ${item.detail}`;
+	}).join("\n");
+}
+/** Settings-style key/value bullets. */
+function kvList(entries) {
+	if (entries.length === 0) return "";
+	return entries.map(({ key, value }) => `- **${key}**: ${value}`).join("\n");
+}
+/** Slash command reference line in a bullet list. */
+function commandBullet(name, description, aliases) {
+	return `- ${code(`/${name}${aliases?.length ? ` (${aliases.join(", ")})` : ""}`)} — ${description}`;
+}
+//#endregion
+export { bulletList, code, commandBullet, hint, joinBlocks, kvList, section };
+
+//# sourceMappingURL=format-output.js.map

package/dist/src/chat-commands/format-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-output.js","names":[],"sources":["../../../src/chat-commands/format-output.ts"],"sourcesContent":["/**\n * GFM formatters for slash-command replies.\n *\n * Command output is rendered as Markdown on Web UI, TUI (gateway), and channels\n * (Telegram IR). Use blank-line-separated blocks and `-` lists — not single\n * newlines or unicode `•` bullets — so lists and headings parse correctly.\n */\n\n/** Join non-empty blocks with a blank line (GFM paragraph separation). */\nexport function joinBlocks(...blocks: Array<string | undefined | null | false>): string {\n  return blocks\n    .filter((b): b is string => typeof b === 'string' && b.trim().length > 0)\n    .join('\\n\\n')\n    .trimEnd();\n}\n\n/** Section heading (bold). */\nexport function section(title: string): string {\n  return `**${title}**`;\n}\n\n/** Inline code span. */\nexport function code(text: string): string {\n  return `\\`${text}\\``;\n}\n\n/** Italic hint / footnote. */\nexport function hint(text: string): string {\n  return `_${text}_`;\n}\n\nexport type BulletItem = string | { label: string; detail: string };\n\n/** GFM bullet list (`-` prefix). */\nexport function bulletList(items: BulletItem[]): string {\n  if (items.length === 0) return '';\n  return items\n    .map((item) => {\n      if (typeof item === 'string') return `- ${item}`;\n      return `- **${item.label}** — ${item.detail}`;\n    })\n    .join('\\n');\n}\n\n/** Settings-style key/value bullets. */\nexport function kvList(entries: Array<{ key: string; value: string }>): string {\n  if (entries.length === 0) return '';\n  return entries.map(({ key, value }) => `- **${key}**: ${value}`).join('\\n');\n}\n\n/** Slash command reference line in a bullet list. */\nexport function commandBullet(name: string, description: string, aliases?: string[]): string {\n  const aliasSuffix = aliases?.length ? ` (${aliases.join(', ')})` : '';\n  return `- ${code(`/${name}${aliasSuffix}`)} — ${description}`;\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,WAAW,GAAG,QAA0D;AACtF,QAAO,OACJ,QAAQ,MAAmB,OAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,CACxE,KAAK,OAAO,CACZ,SAAS;;;AAId,SAAgB,QAAQ,OAAuB;AAC7C,QAAO,KAAK,MAAM;;;AAIpB,SAAgB,KAAK,MAAsB;AACzC,QAAO,KAAK,KAAK;;;AAInB,SAAgB,KAAK,MAAsB;AACzC,QAAO,IAAI,KAAK;;;AAMlB,SAAgB,WAAW,OAA6B;AACtD,KAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAO,MACJ,KAAK,SAAS;AACb,MAAI,OAAO,SAAS,SAAU,QAAO,KAAK;AAC1C,SAAO,OAAO,KAAK,MAAM,OAAO,KAAK;GACrC,CACD,KAAK,KAAK;;;AAIf,SAAgB,OAAO,SAAwD;AAC7E,KAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAO,QAAQ,KAAK,EAAE,KAAK,YAAY,OAAO,IAAI,MAAM,QAAQ,CAAC,KAAK,KAAK;;;AAI7E,SAAgB,cAAc,MAAc,aAAqB,SAA4B;AAE3F,QAAO,KAAK,KAAK,IAAI,OADD,SAAS,SAAS,KAAK,QAAQ,KAAK,KAAK,CAAC,KAAK,KACzB,CAAC,KAAK"}

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

@@ -19,6 +19,7 @@ export { registerConfigCommand } from './builtins/config.js';
 export { registerContextCommands } from './builtins/context.js';
 export { registerGoalCommand } from './builtins/goal.js';
 export { registerSubgoalCommand } from './builtins/subgoal.js';
+export { registerWorkflowCommands } from './builtins/workflow.js';
 /**
  * Initialize the command system with all built-in commands
  */

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

@@ -10,6 +10,7 @@ import { registerConfigCommand } from "./builtins/config.js";
 import { registerContextCommands } from "./builtins/context.js";
 import { registerGoalCommand } from "./builtins/goal.js";
 import { registerSubgoalCommand } from "./builtins/subgoal.js";
+import { registerWorkflowCommands } from "./builtins/workflow.js";
 import { CommandContextImpl, createCommandContext } from "./context.js";
 //#region src/chat-commands/index.ts
 /**
@@ -31,8 +32,9 @@ function initializeCommands() {
 	registerThinkingCommands();
 	registerGoalCommand();
 	registerSubgoalCommand();
+	registerWorkflowCommands();
 }
 //#endregion
-export { CommandContextImpl, CommandRegistry, commandRegistry, createCommandContext, generateSessionKey, getRoutingInfo, getSessionDisplayName, initializeCommands, isValidSessionKey, normalizeTelegramCommandName, parseSessionKey, parseSlashCommand, registerConfigCommand, registerContextCommands, registerGoalCommand, registerModelCommands, registerSessionCommands, registerSubgoalCommand, registerSystemCommands, registerTTSCommands, registerThinkingCommands };
+export { CommandContextImpl, CommandRegistry, commandRegistry, createCommandContext, generateSessionKey, getRoutingInfo, getSessionDisplayName, initializeCommands, isValidSessionKey, normalizeTelegramCommandName, parseSessionKey, parseSlashCommand, registerConfigCommand, registerContextCommands, registerGoalCommand, registerModelCommands, registerSessionCommands, 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';\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 Key\nexport {\n  generateSessionKey,\n  parseSessionKey,\n  isValidSessionKey,\n  getSessionDisplayName,\n  getRoutingInfo,\n  type SessionKeyContext,\n} 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';\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}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAiFA,SAAgB,qBAA2B;AACzC,0BAAyB;AACzB,wBAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,0BAAyB;AACzB,sBAAqB;AACrB,2BAA0B;AAC1B,sBAAqB;AACrB,yBAAwB"}
+{"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';\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 Key\nexport {\n  generateSessionKey,\n  parseSessionKey,\n  isValidSessionKey,\n  getSessionDisplayName,\n  getRoutingInfo,\n  type SessionKeyContext,\n} 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';\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}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAmFA,SAAgB,qBAA2B;AACzC,0BAAyB;AACzB,wBAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,0BAAyB;AACzB,sBAAqB;AACrB,2BAA0B;AAC1B,sBAAqB;AACrB,yBAAwB;AACxB,2BAA0B"}

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

@@ -1,7 +1,7 @@
-import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { ConfigSchema, init_schema } from "../../config/schema.js";
-import { formatExamples, register } from "../registry.js";
+import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { resolveGatewayLocalClientHost } from "../../config/gateway-bind.js";
+import { formatExamples, register } from "../registry.js";
 import { existsSync, readFileSync } from "fs";
 import { Command } from "commander";
 //#region src/cli/commands/config.ts

package/dist/src/cli/commands/doctor/checks/config-health.js

@@ -1,7 +1,7 @@
 import { ConfigSchema, init_schema } from "../../../../config/schema.js";
 import { init_loader, loadConfig, saveConfig } from "../../../../config/loader.js";
-import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { dirname } from "node:path";
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/config-health.ts
 init_loader();
 init_schema();

package/dist/src/cli/commands/doctor/checks/provider-auth.js

@@ -1,6 +1,6 @@
-import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "../../../../providers/env-keys.js";
 import { getAgentDefaultModelRef, init_schema, parseModelRef } from "../../../../config/schema.js";
 import { init_loader, loadConfig } from "../../../../config/loader.js";
+import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "../../../../providers/env-keys.js";
 import { existsSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/provider-auth.ts
 init_loader();

package/dist/src/cli/commands/doctor/checks/session-integrity.js

@@ -2,8 +2,8 @@ import { init_agent_scope, resolveDefaultAgentId } from "../../../../agent/agent
 import { init_transcript_paths, resolveSessionFilePath } from "../../../../session/parity/transcript-paths.js";
 import { FILENAMES, init_paths, resolveSessionsDir } from "../../../../config/paths.js";
 import { init_loader, loadConfig } from "../../../../config/loader.js";
-import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/session-integrity.ts
 init_agent_scope();
 init_loader();

package/dist/src/cli/commands/doctor/checks/state-integrity.js

@@ -1,5 +1,5 @@
-import { accessSync, chmodSync, constants, existsSync, mkdirSync, statSync } from "node:fs";
 import { join } from "node:path";
+import { accessSync, chmodSync, constants, existsSync, mkdirSync, statSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/state-integrity.ts
 function isWritable(dir) {
 	try {

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

@@ -1,8 +1,8 @@
 import { init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../../../../agent/agent-scope.js";
 import { WORKSPACE_FILES, init_paths } from "../../../../config/paths.js";
 import { init_loader, loadConfig } from "../../../../config/loader.js";
-import { existsSync } from "node:fs";
 import { join } from "node:path";
+import { existsSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/workspace-status.ts
 init_agent_scope();
 init_loader();

package/dist/src/cli/commands/extension-dev.js

@@ -12,8 +12,8 @@ import { runGatewayLoop } from "../../gateway/run-loop.js";
 import "../../gateway/index.js";
 import { colors } from "../utils/colors.js";
 import { initWorkspace } from "../utils/init-workspace.js";
-import { existsSync, mkdirSync, readFileSync, symlinkSync, unlinkSync, watch } from "node:fs";
 import { join, resolve } from "node:path";
+import { existsSync, mkdirSync, readFileSync, symlinkSync, unlinkSync, watch } from "node:fs";
 import { Command } from "commander";
 //#region src/cli/commands/extension-dev.ts
 init_loader();

package/dist/src/cli/commands/extension-marketplace.js

@@ -7,8 +7,8 @@ import { installExtensionFromStoreZip, installFromLocal, installFromNpm, peekExt
 import { fetchRegistry, findExtension, getExtensionMarketplaceStoreBaseUrl, listExtensions, searchExtensions } from "../../extensions/marketplace.js";
 import { downloadExtensionStoreZipBuffer, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl } from "../../agent/skills/marketplace/adapters/store/store-api-client.js";
 import { colors } from "../utils/colors.js";
-import { existsSync, readFileSync, rmSync, statSync } from "node:fs";
 import { join, resolve } from "node:path";
+import { existsSync, readFileSync, rmSync, statSync } from "node:fs";
 import { execSync } from "node:child_process";
 import { Command } from "commander";
 import semver from "semver";

package/dist/src/cli/commands/extension-pack.js

@@ -4,8 +4,8 @@ import { init_logger } from "../../utils/logger.js";
 import { normalizeExtensionManifest } from "../../extensions/normalize-manifest.js";
 import { checkEngineCompatibility } from "../../extensions/engine-check.js";
 import { colors } from "../utils/colors.js";
-import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync } from "node:fs";
 import { isAbsolute, join, resolve } from "node:path";
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync } from "node:fs";
 import { execSync } from "node:child_process";
 import { Command } from "commander";
 //#region src/cli/commands/extension-pack.ts

package/dist/src/cli/commands/gateway/lifecycle.js

@@ -3,7 +3,7 @@ import { loadConfig } from "../../../config/loader.js";
 import "../../../config/index.js";
 import { isRestartEnabled } from "../../../config/commands.flags.js";
 import { resolveGatewayService } from "../../../daemon/service.js";
-import { authorizeGatewaySigusr1Restart } from "../../../infra/restart.js";
+import { authorizeGatewaySigusr1Restart, writeGatewayRestartIntentSync } from "../../../infra/restart.js";
 import { findVerifiedGatewayListenerPidsOnPortSync, formatGatewayPidList, signalVerifiedGatewayPidSync } from "../../../infra/gateway-processes.js";
 import { runServiceRestart, runServiceStop } from "./lifecycle-core.js";
 import { DEFAULT_RESTART_HEALTH_ATTEMPTS, renderGatewayPortHealthDiagnostics, waitForGatewayHealthyListener } from "./restart-health.js";
@@ -48,11 +48,17 @@ async function restartGatewayWithoutServiceManager(port) {
 	const pids = resolveVerifiedGatewayListenerPids(port);
 	if (pids.length === 0) return null;
 	if (pids.length > 1) throw new Error(`multiple gateway processes are listening on port ${port}: ${formatGatewayPidList(pids)}; use "xopc gateway status" before retrying restart`);
-	authorizeGatewaySigusr1Restart();
-	signalVerifiedGatewayPidSync(pids[0], "SIGUSR1");
+	const targetPid = pids[0];
+	if (process.platform === "win32") {
+		writeGatewayRestartIntentSync({ targetPid });
+		signalVerifiedGatewayPidSync(targetPid, "SIGTERM");
+	} else {
+		authorizeGatewaySigusr1Restart();
+		signalVerifiedGatewayPidSync(targetPid, "SIGUSR1");
+	}
 	return {
 		result: "restarted",
-		message: `Gateway restart signal sent to unmanaged process on port ${port}: ${pids[0]}.`
+		message: `Gateway restart signal sent to unmanaged process on port ${port}: ${targetPid}.`
 	};
 }
 async function runDaemonStop(options = {}) {