@xopcai/xopc 0.0.110 → 0.0.112

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

@@ -1,27 +1,28 @@
+import { GoalService } from "../../goals/goal-service.js";
+import "../../goals/index.js";
 import { commandRegistry } from "../registry.js";
-import { checklistCounts } from "../../agent/goals/checklist-types.js";
-import { readPersistentGoal, renderChecklistNumbered } from "../../agent/goals/state.js";
-import { applyChecklistUserMutation } from "../../agent/goals/checklist-user.js";
 //#region src/chat-commands/builtins/subgoal.ts
-async function patchMetadata(ctx, patchCustom) {
-	const apis = ctx.persistentGoalApis;
-	if (!apis) return {
-		ok: false,
-		error: "Goals unavailable on this surface."
-	};
-	const meta = await apis.getSessionMetadata(ctx.sessionKey);
-	if (!meta) return {
-		ok: false,
-		error: "Session not found"
-	};
-	const customData = patchCustom({ ...meta.customData });
-	await apis.updateSessionMetadata(ctx.sessionKey, { customData });
-	return { ok: true };
+/**
+* `/subgoal` — view or edit checklist criteria for the active first-class goal.
+*/
+const goals = new GoalService();
+function activeGoal(ctx) {
+	return goals.getActiveForSession(ctx.sessionKey);
+}
+function renderChecklist(goal) {
+	if (!goal.checklist.length) return "Checklist is empty. Add criteria with /subgoal add <text>.";
+	const done = goal.checklist.filter((it) => it.status === "completed" || it.status === "impossible").length;
+	const lines = goal.checklist.map((it, index) => {
+		const marker = it.status === "completed" ? "[x]" : it.status === "impossible" ? "[!]" : "[ ]";
+		const evidence = it.evidenceSummary ? ` (${it.evidenceSummary})` : "";
+		return `${index + 1}. ${marker} ${it.text}${evidence}`;
+	});
+	return `Checklist (${done}/${goal.checklist.length} terminal):\n${lines.join("\n")}`;
 }
 const subgoalCommand = {
 	id: "system.subgoal",
 	name: "subgoal",
-	description: "View or edit checklist criteria for the active /goal (add, mark, remove, reset)",
+	description: "View or edit checklist criteria for the active goal (add, mark, remove, reset)",
 	category: "system",
 	scope: [
 		"global",
@@ -37,73 +38,31 @@ const subgoalCommand = {
 		"/subgoal reset"
 	],
 	handler: async (ctx, args) => {
-		const apis = ctx.persistentGoalApis;
-		if (!apis) return {
-			content: "Goals unavailable on this surface.",
-			success: false
+		const goal = activeGoal(ctx);
+		if (!goal) return {
+			content: "No active goal. Set one with /goal <text> first.",
+			success: true
 		};
 		const t = args.trim();
 		const lower = t.toLowerCase();
-		const custom = (await apis.getSessionMetadata(ctx.sessionKey))?.customData;
-		const s = readPersistentGoal(custom);
-		if (!t || lower === "list" || lower === "status") {
-			if (!s || s.status === "cleared") return {
-				content: "No active goal. Set one with /goal <text> first.",
-				success: true
-			};
-			const items = s.checklist ?? [];
-			if (!items.length) return {
-				content: s.decomposed === true ? "Checklist is empty (decomposition produced no items). The judge will use freeform mode." : "Checklist not built yet — it appears after the first assistant turn once decomposition runs.",
-				success: true
-			};
-			const { total, completed, impossible } = checklistCounts(items);
-			return {
-				content: `Checklist (${completed + impossible}/${total} terminal):\n` + renderChecklistNumbered(items),
-				success: true
-			};
-		}
+		if (!t || lower === "list" || lower === "status") return {
+			content: renderChecklist(goal),
+			success: true
+		};
 		if (lower === "reset" || lower === "clear") {
-			const applied = applyChecklistUserMutation(custom, { type: "reset" });
-			if (applied.kind === "error") return {
-				content: applied.error,
-				success: false
-			};
-			if (applied.kind === "noop") return {
-				content: applied.message,
-				success: true
-			};
-			const cd = applied.customData;
-			const r = await patchMetadata(ctx, () => cd);
-			if (!r.ok) return {
-				content: "error" in r ? r.error : "Failed",
-				success: false
-			};
+			goals.updateChecklist(goal.id, { type: "reset" });
 			return {
-				content: "✓ Checklist cleared. Decomposition will run again on the next goal evaluation turn (or set /goal anew).",
+				content: "✓ Checklist cleared.",
 				success: true
 			};
 		}
 		const addM = t.match(/^add\s+([\s\S]+)$/i);
 		if (addM) {
 			const text = addM[1].trim();
-			const applied = applyChecklistUserMutation(custom, {
+			goals.updateChecklist(goal.id, {
 				type: "add",
 				text
 			});
-			if (applied.kind === "error") return {
-				content: applied.error,
-				success: false
-			};
-			if (applied.kind === "noop") return {
-				content: applied.message,
-				success: true
-			};
-			const cd = applied.customData;
-			const r = await patchMetadata(ctx, () => cd);
-			if (!r.ok) return {
-				content: "error" in r ? r.error : "Failed",
-				success: false
-			};
 			return {
 				content: `⊙ Added checklist item: ${text}`,
 				success: true
@@ -111,60 +70,42 @@ const subgoalCommand = {
 		}
 		const removeM = t.match(/^remove\s+(\d+)\s*$/i);
 		if (removeM) {
-			const idx = Number(removeM[1]);
-			const applied = applyChecklistUserMutation(custom, {
-				type: "remove",
-				index1Based: idx
-			});
-			if (applied.kind === "error") return {
-				content: applied.error,
-				success: false
-			};
-			if (applied.kind === "noop") return {
-				content: applied.message,
-				success: true
-			};
-			const cd = applied.customData;
-			const r = await patchMetadata(ctx, () => cd);
-			if (!r.ok) return {
-				content: "error" in r ? r.error : "Failed",
+			const index = Number(removeM[1]);
+			const item = goal.checklist[index - 1];
+			if (!item) return {
+				content: `No checklist item #${index}.`,
 				success: false
 			};
+			goals.updateChecklist(goal.id, {
+				type: "remove",
+				itemId: item.id
+			});
 			return {
-				content: `✓ Removed item #${idx}.`,
+				content: `✓ Removed item #${index}.`,
 				success: true
 			};
 		}
 		const markM = t.match(/^mark\s+(\d+)\s+(pending|completed|impossible)\s*$/i);
 		if (markM) {
-			const idx = Number(markM[1]);
+			const index = Number(markM[1]);
 			const status = markM[2].toLowerCase();
-			const applied = applyChecklistUserMutation(custom, {
+			const item = goal.checklist[index - 1];
+			if (!item) return {
+				content: `No checklist item #${index}.`,
+				success: false
+			};
+			goals.updateChecklist(goal.id, {
 				type: "mark",
-				index1Based: idx,
+				itemId: item.id,
 				status
 			});
-			if (applied.kind === "error") return {
-				content: applied.error,
-				success: false
-			};
-			if (applied.kind === "noop") return {
-				content: applied.message,
-				success: true
-			};
-			const cd = applied.customData;
-			const r = await patchMetadata(ctx, () => cd);
-			if (!r.ok) return {
-				content: "error" in r ? r.error : "Failed",
-				success: false
-			};
 			return {
-				content: `⊙ Item #${idx} → ${status}.`,
+				content: `⊙ Item #${index} -> ${status}.`,
 				success: true
 			};
 		}
 		return {
-			content: "Usage:\n• /subgoal — show checklist\n• /subgoal add <text>\n• /subgoal mark <n> pending|completed|impossible\n• /subgoal remove <n>\n• /subgoal reset — wipe checklist (re-decompose on next turn)",
+			content: "Usage:\n• /subgoal — show checklist\n• /subgoal add <text>\n• /subgoal mark <n> pending|completed|impossible\n• /subgoal remove <n>\n• /subgoal reset",
 			success: true
 		};
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"subgoal.js","names":[],"sources":["../../../../src/chat-commands/builtins/subgoal.ts"],"sourcesContent":["/**\n * `/subgoal` — view or edit the standing goal checklist (Hermes parity).\n */\n\nimport type { CommandContext, CommandDefinition } from '../types.js';\nimport { commandRegistry } from '../registry.js';\n\nimport { applyChecklistUserMutation } from '../../agent/goals/checklist-user.js';\nimport { checklistCounts } from '../../agent/goals/checklist-types.js';\nimport { readPersistentGoal, renderChecklistNumbered } from '../../agent/goals/state.js';\n\nasync function patchMetadata(\n  ctx: CommandContext,\n  patchCustom: (base: Record<string, unknown>) => Record<string, unknown>,\n): Promise<{ ok: true } | { ok: false; error: string }> {\n  const apis = ctx.persistentGoalApis;\n  if (!apis) return { ok: false, error: 'Goals unavailable on this surface.' };\n  const meta = await apis.getSessionMetadata(ctx.sessionKey);\n  if (!meta) return { ok: false, error: 'Session not found' };\n  const base = { ...(meta.customData as Record<string, unknown> | undefined) };\n  const customData = patchCustom(base);\n  await apis.updateSessionMetadata(ctx.sessionKey, { customData });\n  return { ok: true };\n}\n\nconst subgoalCommand: CommandDefinition = {\n  id: 'system.subgoal',\n  name: 'subgoal',\n  description: 'View or edit checklist criteria for the active /goal (add, mark, remove, reset)',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: [\n    '/subgoal',\n    '/subgoal add Run tests in CI',\n    '/subgoal mark 2 completed',\n    '/subgoal remove 3',\n    '/subgoal reset',\n  ],\n  handler: async (ctx: CommandContext, args: string) => {\n    const apis = ctx.persistentGoalApis;\n    if (!apis) {\n      return { content: 'Goals unavailable on this surface.', success: false };\n    }\n\n    const t = args.trim();\n    const lower = t.toLowerCase();\n    const meta = await apis.getSessionMetadata(ctx.sessionKey);\n    const custom = meta?.customData as Record<string, unknown> | undefined;\n    const s = readPersistentGoal(custom);\n\n    if (!t || lower === 'list' || lower === 'status') {\n      if (!s || s.status === 'cleared') {\n        return { content: 'No active goal. Set one with /goal <text> first.', success: true };\n      }\n      const items = s.checklist ?? [];\n      if (!items.length) {\n        return {\n          content:\n            s.decomposed === true\n              ? 'Checklist is empty (decomposition produced no items). The judge will use freeform mode.'\n              : 'Checklist not built yet — it appears after the first assistant turn once decomposition runs.',\n          success: true,\n        };\n      }\n      const { total, completed, impossible } = checklistCounts(items);\n      const header = `Checklist (${completed + impossible}/${total} terminal):\\n`;\n      return { content: header + renderChecklistNumbered(items), success: true };\n    }\n\n    if (lower === 'reset' || lower === 'clear') {\n      const applied = applyChecklistUserMutation(custom, { type: 'reset' });\n      if (applied.kind === 'error') return { content: applied.error, success: false };\n      if (applied.kind === 'noop') return { content: applied.message, success: true };\n      const cd = applied.customData;\n      const r = await patchMetadata(ctx, () => cd);\n      if (!r.ok) return { content: 'error' in r ? r.error : 'Failed', success: false };\n      return {\n        content:\n          '✓ Checklist cleared. Decomposition will run again on the next goal evaluation turn (or set /goal anew).',\n        success: true,\n      };\n    }\n\n    const addM = t.match(/^add\\s+([\\s\\S]+)$/i);\n    if (addM) {\n      const text = addM[1]!.trim();\n      const applied = applyChecklistUserMutation(custom, { type: 'add', text });\n      if (applied.kind === 'error') return { content: applied.error, success: false };\n      if (applied.kind === 'noop') return { content: applied.message, success: true };\n      const cd = applied.customData;\n      const r = await patchMetadata(ctx, () => cd);\n      if (!r.ok) return { content: 'error' in r ? r.error : 'Failed', success: false };\n      return { content: `⊙ Added checklist item: ${text}`, success: true };\n    }\n\n    const removeM = t.match(/^remove\\s+(\\d+)\\s*$/i);\n    if (removeM) {\n      const idx = Number(removeM[1]);\n      const applied = applyChecklistUserMutation(custom, { type: 'remove', index1Based: idx });\n      if (applied.kind === 'error') return { content: applied.error, success: false };\n      if (applied.kind === 'noop') return { content: applied.message, success: true };\n      const cd = applied.customData;\n      const r = await patchMetadata(ctx, () => cd);\n      if (!r.ok) return { content: 'error' in r ? r.error : 'Failed', success: false };\n      return { content: `✓ Removed item #${idx}.`, success: true };\n    }\n\n    const markM = t.match(/^mark\\s+(\\d+)\\s+(pending|completed|impossible)\\s*$/i);\n    if (markM) {\n      const idx = Number(markM[1]);\n      const status = markM[2]!.toLowerCase() as 'pending' | 'completed' | 'impossible';\n      const applied = applyChecklistUserMutation(custom, { type: 'mark', index1Based: idx, status });\n      if (applied.kind === 'error') return { content: applied.error, success: false };\n      if (applied.kind === 'noop') return { content: applied.message, success: true };\n      const cd = applied.customData;\n      const r = await patchMetadata(ctx, () => cd);\n      if (!r.ok) return { content: 'error' in r ? r.error : 'Failed', success: false };\n      return { content: `⊙ Item #${idx} → ${status}.`, success: true };\n    }\n\n    return {\n      content:\n        'Usage:\\n' +\n        '• /subgoal — show checklist\\n' +\n        '• /subgoal add <text>\\n' +\n        '• /subgoal mark <n> pending|completed|impossible\\n' +\n        '• /subgoal remove <n>\\n' +\n        '• /subgoal reset — wipe checklist (re-decompose on next turn)',\n      success: true,\n    };\n  },\n};\n\nexport function registerSubgoalCommand(): void {\n  commandRegistry.register(subgoalCommand);\n}\n"],"mappings":"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"}
+{"version":3,"file":"subgoal.js","names":[],"sources":["../../../../src/chat-commands/builtins/subgoal.ts"],"sourcesContent":["/**\n * `/subgoal` — view or edit checklist criteria for the active first-class goal.\n */\n\nimport { GoalService } from '../../goals/index.js';\nimport type { CommandContext, CommandDefinition } from '../types.js';\nimport { commandRegistry } from '../registry.js';\n\nconst goals = new GoalService();\n\nfunction activeGoal(ctx: CommandContext) {\n  return goals.getActiveForSession(ctx.sessionKey);\n}\n\nfunction renderChecklist(goal: NonNullable<ReturnType<typeof activeGoal>>): string {\n  if (!goal.checklist.length) return 'Checklist is empty. Add criteria with /subgoal add <text>.';\n  const done = goal.checklist.filter((it) => it.status === 'completed' || it.status === 'impossible').length;\n  const lines = goal.checklist.map((it, index) => {\n    const marker = it.status === 'completed' ? '[x]' : it.status === 'impossible' ? '[!]' : '[ ]';\n    const evidence = it.evidenceSummary ? ` (${it.evidenceSummary})` : '';\n    return `${index + 1}. ${marker} ${it.text}${evidence}`;\n  });\n  return `Checklist (${done}/${goal.checklist.length} terminal):\\n${lines.join('\\n')}`;\n}\n\nconst subgoalCommand: CommandDefinition = {\n  id: 'system.subgoal',\n  name: 'subgoal',\n  description: 'View or edit checklist criteria for the active goal (add, mark, remove, reset)',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: [\n    '/subgoal',\n    '/subgoal add Run tests in CI',\n    '/subgoal mark 2 completed',\n    '/subgoal remove 3',\n    '/subgoal reset',\n  ],\n  handler: async (ctx: CommandContext, args: string) => {\n    const goal = activeGoal(ctx);\n    if (!goal) return { content: 'No active goal. Set one with /goal <text> first.', success: true };\n\n    const t = args.trim();\n    const lower = t.toLowerCase();\n\n    if (!t || lower === 'list' || lower === 'status') {\n      return { content: renderChecklist(goal), success: true };\n    }\n\n    if (lower === 'reset' || lower === 'clear') {\n      goals.updateChecklist(goal.id, { type: 'reset' });\n      return { content: '✓ Checklist cleared.', success: true };\n    }\n\n    const addM = t.match(/^add\\s+([\\s\\S]+)$/i);\n    if (addM) {\n      const text = addM[1]!.trim();\n      goals.updateChecklist(goal.id, { type: 'add', text });\n      return { content: `⊙ Added checklist item: ${text}`, success: true };\n    }\n\n    const removeM = t.match(/^remove\\s+(\\d+)\\s*$/i);\n    if (removeM) {\n      const index = Number(removeM[1]);\n      const item = goal.checklist[index - 1];\n      if (!item) return { content: `No checklist item #${index}.`, success: false };\n      goals.updateChecklist(goal.id, { type: 'remove', itemId: item.id });\n      return { content: `✓ Removed item #${index}.`, success: true };\n    }\n\n    const markM = t.match(/^mark\\s+(\\d+)\\s+(pending|completed|impossible)\\s*$/i);\n    if (markM) {\n      const index = Number(markM[1]);\n      const status = markM[2]!.toLowerCase() as 'pending' | 'completed' | 'impossible';\n      const item = goal.checklist[index - 1];\n      if (!item) return { content: `No checklist item #${index}.`, success: false };\n      goals.updateChecklist(goal.id, { type: 'mark', itemId: item.id, status });\n      return { content: `⊙ Item #${index} -> ${status}.`, success: true };\n    }\n\n    return {\n      content:\n        'Usage:\\n' +\n        '• /subgoal — show checklist\\n' +\n        '• /subgoal add <text>\\n' +\n        '• /subgoal mark <n> pending|completed|impossible\\n' +\n        '• /subgoal remove <n>\\n' +\n        '• /subgoal reset',\n      success: true,\n    };\n  },\n};\n\nexport function registerSubgoalCommand(): void {\n  commandRegistry.register(subgoalCommand);\n}\n"],"mappings":";;;;;;;AAQA,MAAM,QAAQ,IAAI,aAAa;AAE/B,SAAS,WAAW,KAAqB;AACvC,QAAO,MAAM,oBAAoB,IAAI,WAAW;;AAGlD,SAAS,gBAAgB,MAA0D;AACjF,KAAI,CAAC,KAAK,UAAU,OAAQ,QAAO;CACnC,MAAM,OAAO,KAAK,UAAU,QAAQ,OAAO,GAAG,WAAW,eAAe,GAAG,WAAW,aAAa,CAAC;CACpG,MAAM,QAAQ,KAAK,UAAU,KAAK,IAAI,UAAU;EAC9C,MAAM,SAAS,GAAG,WAAW,cAAc,QAAQ,GAAG,WAAW,eAAe,QAAQ;EACxF,MAAM,WAAW,GAAG,kBAAkB,KAAK,GAAG,gBAAgB,KAAK;AACnE,SAAO,GAAG,QAAQ,EAAE,IAAI,OAAO,GAAG,GAAG,OAAO;GAC5C;AACF,QAAO,cAAc,KAAK,GAAG,KAAK,UAAU,OAAO,eAAe,MAAM,KAAK,KAAK;;AAGpF,MAAM,iBAAoC;CACxC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,aAAa;CACb,UAAU;EACR;EACA;EACA;EACA;EACA;EACD;CACD,SAAS,OAAO,KAAqB,SAAiB;EACpD,MAAM,OAAO,WAAW,IAAI;AAC5B,MAAI,CAAC,KAAM,QAAO;GAAE,SAAS;GAAoD,SAAS;GAAM;EAEhG,MAAM,IAAI,KAAK,MAAM;EACrB,MAAM,QAAQ,EAAE,aAAa;AAE7B,MAAI,CAAC,KAAK,UAAU,UAAU,UAAU,SACtC,QAAO;GAAE,SAAS,gBAAgB,KAAK;GAAE,SAAS;GAAM;AAG1D,MAAI,UAAU,WAAW,UAAU,SAAS;AAC1C,SAAM,gBAAgB,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AACjD,UAAO;IAAE,SAAS;IAAwB,SAAS;IAAM;;EAG3D,MAAM,OAAO,EAAE,MAAM,qBAAqB;AAC1C,MAAI,MAAM;GACR,MAAM,OAAO,KAAK,GAAI,MAAM;AAC5B,SAAM,gBAAgB,KAAK,IAAI;IAAE,MAAM;IAAO;IAAM,CAAC;AACrD,UAAO;IAAE,SAAS,2BAA2B;IAAQ,SAAS;IAAM;;EAGtE,MAAM,UAAU,EAAE,MAAM,uBAAuB;AAC/C,MAAI,SAAS;GACX,MAAM,QAAQ,OAAO,QAAQ,GAAG;GAChC,MAAM,OAAO,KAAK,UAAU,QAAQ;AACpC,OAAI,CAAC,KAAM,QAAO;IAAE,SAAS,sBAAsB,MAAM;IAAI,SAAS;IAAO;AAC7E,SAAM,gBAAgB,KAAK,IAAI;IAAE,MAAM;IAAU,QAAQ,KAAK;IAAI,CAAC;AACnE,UAAO;IAAE,SAAS,mBAAmB,MAAM;IAAI,SAAS;IAAM;;EAGhE,MAAM,QAAQ,EAAE,MAAM,sDAAsD;AAC5E,MAAI,OAAO;GACT,MAAM,QAAQ,OAAO,MAAM,GAAG;GAC9B,MAAM,SAAS,MAAM,GAAI,aAAa;GACtC,MAAM,OAAO,KAAK,UAAU,QAAQ;AACpC,OAAI,CAAC,KAAM,QAAO;IAAE,SAAS,sBAAsB,MAAM;IAAI,SAAS;IAAO;AAC7E,SAAM,gBAAgB,KAAK,IAAI;IAAE,MAAM;IAAQ,QAAQ,KAAK;IAAI;IAAQ,CAAC;AACzE,UAAO;IAAE,SAAS,WAAW,MAAM,MAAM,OAAO;IAAI,SAAS;IAAM;;AAGrE,SAAO;GACL,SACE;GAMF,SAAS;GACV;;CAEJ;AAED,SAAgB,yBAA+B;AAC7C,iBAAgB,SAAS,eAAe"}

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

@@ -97,10 +97,17 @@ const skillsCommand = {
 	acceptsArgs: true,
 	examples: ["/skills reload"],
 	handler: async (ctx, args) => {
-		if (args === "reload") return {
-			content: "✅ Skills reloaded successfully",
-			success: true
-		};
+		if (args === "reload") {
+			if (!ctx.reloadSkills) return {
+				content: "Skills reload is not available in this context.",
+				success: false
+			};
+			await ctx.reloadSkills();
+			return {
+				content: "Skills reloaded successfully",
+				success: true
+			};
+		}
 		return {
 			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';\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"}
+{"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      if (!ctx.reloadSkills) {\n        return {\n          content: 'Skills reload is not available in this context.',\n          success: false,\n        };\n      }\n      await ctx.reloadSkills();\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,UAAU;AACrB,OAAI,CAAC,IAAI,aACP,QAAO;IACL,SAAS;IACT,SAAS;IACV;AAEH,SAAM,IAAI,cAAc;AACxB,UAAO;IACL,SAAS;IACT,SAAS;IACV;;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.js

@@ -1,3 +1,4 @@
+import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { createWorkflowCatalog } from "../../agent/workflow/catalog.js";
 import { getLastWorkflowMemory } from "../../agent/workflow/last-run-memory.js";
 import { commandRegistry } from "../registry.js";
@@ -109,13 +110,7 @@ const workflowCommand = {
 				};
 			}
 		}
-		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 === "run" || subLower === "start") return runWorkflowFromCommand(ctx, target);
 		if (subLower === "save") {
 			if (!target) return {
 				content: `usage: ${code("/workflow save <name>")}`,
@@ -142,11 +137,140 @@ const workflowCommand = {
 			}
 		}
 		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=\"...\"`."),
+			content: joinBlocks(`Unknown subcommand "${sub}". Available: list, view ${code("<name>")}, save ${code("<name>")}.`, `Run directly with ${code("/workflow run <name> [--goal \"...\"] [--json '{...}']")}.`),
 			success: false
 		};
 	}
 };
+async function runWorkflowFromCommand(ctx, args) {
+	if (!ctx.workflowRunApis) return {
+		content: "Workflow runs are not available in this context.",
+		success: false
+	};
+	let parsed;
+	try {
+		parsed = parseWorkflowRunArgs(args);
+	} catch (err) {
+		return {
+			content: `error: ${err instanceof Error ? err.message : String(err)}`,
+			success: false
+		};
+	}
+	if (!parsed.name) return {
+		content: `usage: ${code("/workflow run <name> [--goal \"...\"] [--json '{...}']")}`,
+		success: false
+	};
+	const catalog = createWorkflowCatalog();
+	try {
+		catalog.load(parsed.name);
+	} catch (e) {
+		return {
+			content: `error: ${e instanceof Error ? e.message : String(e)}`,
+			success: false
+		};
+	}
+	const agentId = extractProfileAgentId(ctx.sessionKey, ctx.config);
+	const source = ctx.source === "webui" || ctx.channelId === "webchat" ? {
+		kind: "webui",
+		sessionKey: ctx.sessionKey
+	} : {
+		kind: "chat",
+		sessionKey: ctx.sessionKey
+	};
+	const result = await ctx.workflowRunApis.startWorkflowRun({
+		agentId,
+		definitionId: parsed.name,
+		goal: parsed.goal,
+		input: parsed.input,
+		parentSessionKey: ctx.sessionKey,
+		source
+	});
+	if (result.ok === false) return {
+		content: `error: ${result.message}`,
+		success: false,
+		metadata: { workflowRun: {
+			ok: false,
+			definitionId: parsed.name,
+			code: result.code,
+			message: result.message
+		} }
+	};
+	return {
+		content: joinBlocks(`Started workflow **${parsed.name}**.`, bulletList([{
+			label: "runId",
+			detail: code(result.runId)
+		}, {
+			label: "sessionKey",
+			detail: code(result.sessionKey)
+		}])),
+		success: true,
+		metadata: { workflowRun: {
+			ok: true,
+			definitionId: parsed.name,
+			runId: result.runId,
+			sessionKey: result.sessionKey,
+			parentSessionKey: ctx.sessionKey
+		} }
+	};
+}
+function parseWorkflowRunArgs(raw) {
+	const tokens = tokenizeArgs(raw);
+	const name = tokens.shift()?.trim() ?? "";
+	let goal;
+	let input;
+	for (let i = 0; i < tokens.length; i += 1) {
+		const token = tokens[i];
+		if (token === "--goal" || token === "-g") {
+			goal = tokens[++i]?.trim() || void 0;
+			continue;
+		}
+		if (token.startsWith("--goal=")) {
+			goal = token.slice(7).trim() || void 0;
+			continue;
+		}
+		if (token === "--json" || token === "--input") {
+			const value = tokens[++i];
+			input = parseJsonArg(value, token);
+			continue;
+		}
+		if (token.startsWith("--json=")) {
+			input = parseJsonArg(token.slice(7), "--json");
+			continue;
+		}
+		if (token.startsWith("--input=")) {
+			input = parseJsonArg(token.slice(8), "--input");
+			continue;
+		}
+		if (!goal) {
+			goal = [token, ...tokens.slice(i + 1)].join(" ").trim() || void 0;
+			break;
+		}
+	}
+	return {
+		name,
+		goal,
+		input
+	};
+}
+function parseJsonArg(value, flag) {
+	if (!value?.trim()) throw new Error(`${flag} requires a JSON value`);
+	try {
+		return JSON.parse(value);
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		throw new Error(`${flag} is not valid JSON: ${message}`);
+	}
+}
+function tokenizeArgs(raw) {
+	const tokens = [];
+	const re = /"([^"\\]*(?:\\.[^"\\]*)*)"|'([^'\\]*(?:\\.[^'\\]*)*)'|(\S+)/g;
+	let match;
+	while ((match = re.exec(raw)) !== null) {
+		const value = match[1] ?? match[2] ?? match[3] ?? "";
+		tokens.push(value.replace(/\\(["'\\])/g, "$1"));
+	}
+	return tokens;
+}
 /**
 * Replace the `name` field inside the FIRST `export const meta = { ... }` literal.
 *

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

@@ -1 +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 formatEntryDetail(entry: CatalogEntry): string {\n  const tags = entry.tags?.length ? `[${entry.tags.join(', ')}] ` : '';\n  const agents = entry.estimatedAgents\n    ? ` (~${entry.estimatedAgents.min}–${entry.estimatedAgents.max} agents)`\n    : '';\n  return `${tags}${entry.description}${agents}`;\n}\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: formatEntryDetail(e) }))),\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: formatEntryDetail(e) }))),\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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"}
+{"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';\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\n\nconst VIEW_MAX_LINES = 200;\n\nfunction formatEntryDetail(entry: CatalogEntry): string {\n  const tags = entry.tags?.length ? `[${entry.tags.join(', ')}] ` : '';\n  const agents = entry.estimatedAgents\n    ? ` (~${entry.estimatedAgents.min}–${entry.estimatedAgents.max} agents)`\n    : '';\n  return `${tags}${entry.description}${agents}`;\n}\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: formatEntryDetail(e) }))),\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: formatEntryDetail(e) }))),\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      return runWorkflowFromCommand(ctx, target);\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        `Run directly with ${code('/workflow run <name> [--goal \"...\"] [--json \\'{...}\\']')}.`,\n      ),\n      success: false,\n    };\n  },\n};\n\nasync function runWorkflowFromCommand(ctx: CommandContext, args: string) {\n  if (!ctx.workflowRunApis) {\n    return {\n      content: 'Workflow runs are not available in this context.',\n      success: false,\n    };\n  }\n\n  let parsed: { name: string; goal?: string; input?: unknown };\n  try {\n    parsed = parseWorkflowRunArgs(args);\n  } catch (err) {\n    return {\n      content: `error: ${err instanceof Error ? err.message : String(err)}`,\n      success: false,\n    };\n  }\n  if (!parsed.name) {\n    return {\n      content: `usage: ${code('/workflow run <name> [--goal \"...\"] [--json \\'{...}\\']')}`,\n      success: false,\n    };\n  }\n\n  const catalog = createWorkflowCatalog();\n  try {\n    catalog.load(parsed.name);\n  } catch (e) {\n    const message = e instanceof Error ? e.message : String(e);\n    return { content: `error: ${message}`, success: false };\n  }\n\n  const agentId = extractProfileAgentId(ctx.sessionKey, ctx.config);\n  const source =\n    ctx.source === 'webui' || ctx.channelId === 'webchat'\n      ? ({ kind: 'webui' as const, sessionKey: ctx.sessionKey })\n      : ({ kind: 'chat' as const, sessionKey: ctx.sessionKey });\n  const result = await ctx.workflowRunApis.startWorkflowRun({\n    agentId,\n    definitionId: parsed.name,\n    goal: parsed.goal,\n    input: parsed.input,\n    parentSessionKey: ctx.sessionKey,\n    source,\n  });\n\n  if (result.ok === false) {\n    return {\n      content: `error: ${result.message}`,\n      success: false,\n      metadata: {\n        workflowRun: {\n          ok: false,\n          definitionId: parsed.name,\n          code: result.code,\n          message: result.message,\n        },\n      },\n    };\n  }\n\n  const content = joinBlocks(\n    `Started workflow **${parsed.name}**.`,\n    bulletList([\n      { label: 'runId', detail: code(result.runId) },\n      { label: 'sessionKey', detail: code(result.sessionKey) },\n    ]),\n  );\n\n  return {\n    content,\n    success: true,\n    metadata: {\n      workflowRun: {\n        ok: true,\n        definitionId: parsed.name,\n        runId: result.runId,\n        sessionKey: result.sessionKey,\n        parentSessionKey: ctx.sessionKey,\n      },\n    },\n  };\n}\n\nfunction parseWorkflowRunArgs(raw: string): { name: string; goal?: string; input?: unknown } {\n  const tokens = tokenizeArgs(raw);\n  const name = tokens.shift()?.trim() ?? '';\n  let goal: string | undefined;\n  let input: unknown;\n\n  for (let i = 0; i < tokens.length; i += 1) {\n    const token = tokens[i];\n    if (token === '--goal' || token === '-g') {\n      goal = tokens[++i]?.trim() || undefined;\n      continue;\n    }\n    if (token.startsWith('--goal=')) {\n      goal = token.slice('--goal='.length).trim() || undefined;\n      continue;\n    }\n    if (token === '--json' || token === '--input') {\n      const value = tokens[++i];\n      input = parseJsonArg(value, token);\n      continue;\n    }\n    if (token.startsWith('--json=')) {\n      input = parseJsonArg(token.slice('--json='.length), '--json');\n      continue;\n    }\n    if (token.startsWith('--input=')) {\n      input = parseJsonArg(token.slice('--input='.length), '--input');\n      continue;\n    }\n    if (!goal) {\n      goal = [token, ...tokens.slice(i + 1)].join(' ').trim() || undefined;\n      break;\n    }\n  }\n\n  return { name, goal, input };\n}\n\nfunction parseJsonArg(value: string | undefined, flag: string): unknown {\n  if (!value?.trim()) {\n    throw new Error(`${flag} requires a JSON value`);\n  }\n  try {\n    return JSON.parse(value);\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    throw new Error(`${flag} is not valid JSON: ${message}`);\n  }\n}\n\nfunction tokenizeArgs(raw: string): string[] {\n  const tokens: string[] = [];\n  const re = /\"([^\"\\\\]*(?:\\\\.[^\"\\\\]*)*)\"|'([^'\\\\]*(?:\\\\.[^'\\\\]*)*)'|(\\S+)/g;\n  let match: RegExpExecArray | null;\n  while ((match = re.exec(raw)) !== null) {\n    const value = match[1] ?? match[2] ?? match[3] ?? '';\n    tokens.push(value.replace(/\\\\([\"'\\\\])/g, '$1'));\n  }\n  return tokens;\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.d.ts

@@ -12,6 +12,7 @@ import type { SessionStore, SessionConfigStore } from '../session/index.js';
 import type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';
 import type { CompactionResult } from '../agent/memory/compaction.js';
 import type { PersistentGoalApis } from '../agent/goals/persistent-goal-apis.js';
+import type { WorkflowRunServiceLike } from '../workflows/service/workflow-run-service.types.js';
 export interface CommandContextDeps {
     sessionKey: string;
     source: MessageSource;
@@ -39,6 +40,8 @@ export interface CommandContextDeps {
     getUsage?: () => Promise<UsageStats>;
     /** Stop current LLM turn and clear channel preview stream (Telegram draft, etc.) */
     abortCurrentTurn?: () => Promise<void>;
+    /** Reload skills from disk and refresh active agent prompts. */
+    reloadSkills?: () => Promise<void>;
     compactSession?: (sessionKey: string, options?: {
         instructions?: string;
         force?: boolean;
@@ -49,6 +52,7 @@ export interface CommandContextDeps {
     }>;
     getSessionContextReport?: (sessionKey: string, mode: 'list' | 'detail' | 'json') => Promise<string>;
     persistentGoalApis?: PersistentGoalApis;
+    workflowRunService?: WorkflowRunServiceLike;
 }
 export declare class CommandContextImpl implements CommandContext {
     readonly sessionKey: string;
@@ -59,7 +63,9 @@ export declare class CommandContextImpl implements CommandContext {
     readonly isGroup: boolean;
     readonly config: Config;
     readonly abortCurrentTurn?: () => Promise<void>;
+    readonly reloadSkills?: () => Promise<void>;
     readonly persistentGoalApis?: PersistentGoalApis;
+    readonly workflowRunApis?: CommandContext['workflowRunApis'];
     private deps;
     constructor(deps: CommandContextDeps);
     reply(text: string, options?: ReplyOptions): Promise<void>;

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

@@ -19,7 +19,9 @@ var CommandContextImpl = class {
 	isGroup;
 	config;
 	abortCurrentTurn;
+	reloadSkills;
 	persistentGoalApis;
+	workflowRunApis;
 	deps;
 	constructor(deps) {
 		this.sessionKey = deps.sessionKey;
@@ -36,7 +38,17 @@ var CommandContextImpl = class {
 				await run();
 			};
 		}
+		if (deps.reloadSkills) {
+			const run = deps.reloadSkills;
+			this.reloadSkills = async () => {
+				await run();
+			};
+		}
 		this.persistentGoalApis = deps.persistentGoalApis;
+		if (deps.workflowRunService) this.workflowRunApis = {
+			service: deps.workflowRunService,
+			startWorkflowRun: (params) => deps.workflowRunService.startWorkflowRun(params)
+		};
 	}
 	async reply(text, options) {
 		await this.deps.replyHandler(text, options);