@xopcai/xopc 0.0.102 → 0.0.104

package/dist/src/tui/xopc-tui-keybindings.js

@@ -46,13 +46,89 @@ const XOPC_TUI_KEYBINDINGS = {
 		defaultKeys: "ctrl+shift+p",
 		description: "Session picker"
 	},
+	"app.session.tree": {
+		defaultKeys: [],
+		description: "Show session tree"
+	},
+	"app.session.fork": {
+		defaultKeys: [],
+		description: "Fork current session"
+	},
+	"app.session.togglePath": {
+		defaultKeys: "ctrl+p",
+		description: "Toggle session key display"
+	},
+	"app.session.toggleSort": {
+		defaultKeys: "ctrl+s",
+		description: "Toggle session sort mode"
+	},
+	"app.session.toggleNamedFilter": {
+		defaultKeys: "ctrl+n",
+		description: "Toggle named session filter"
+	},
+	"app.session.rename": {
+		defaultKeys: "ctrl+r",
+		description: "Rename selected session"
+	},
+	"app.session.delete": {
+		defaultKeys: "ctrl+d",
+		description: "Delete selected session"
+	},
+	"app.session.deleteNoninvasive": {
+		defaultKeys: "ctrl+backspace",
+		description: "Delete session when query is empty"
+	},
+	"app.tree.foldOrUp": {
+		defaultKeys: ["ctrl+left", "alt+left"],
+		description: "Fold tree branch or move up"
+	},
+	"app.tree.unfoldOrDown": {
+		defaultKeys: ["ctrl+right", "alt+right"],
+		description: "Unfold tree branch or move down"
+	},
+	"app.tree.filter.default": {
+		defaultKeys: "ctrl+d",
+		description: "Tree filter: default view"
+	},
+	"app.tree.filter.noTools": {
+		defaultKeys: "ctrl+t",
+		description: "Tree filter: hide tool results"
+	},
+	"app.tree.filter.userOnly": {
+		defaultKeys: "ctrl+u",
+		description: "Tree filter: user messages only"
+	},
+	"app.tree.filter.labeledOnly": {
+		defaultKeys: "ctrl+l",
+		description: "Tree filter: labeled entries only"
+	},
+	"app.tree.filter.all": {
+		defaultKeys: "ctrl+a",
+		description: "Tree filter: show all entries"
+	},
+	"app.tree.filter.cycleForward": {
+		defaultKeys: "ctrl+o",
+		description: "Tree filter: cycle forward"
+	},
+	"app.tree.filter.cycleBackward": {
+		defaultKeys: "shift+ctrl+o",
+		description: "Tree filter: cycle backward"
+	},
+	"app.tree.editLabel": {
+		defaultKeys: "shift+l",
+		description: "Edit tree label"
+	},
+	"app.tree.toggleLabelTimestamp": {
+		defaultKeys: "shift+t",
+		description: "Toggle tree label timestamps"
+	},
 	"app.editor.external": {
 		defaultKeys: "ctrl+g",
 		description: "Edit input in $EDITOR"
 	},
 	"app.clipboard.pasteImage": {
 		defaultKeys: process.platform === "win32" ? "alt+v" : "ctrl+v",
-		description: "Paste image from clipboard (placeholder)"
+		description: "Paste image from clipboard"
 	},
 	"app.message.followUp": {
 		defaultKeys: "alt+enter",
@@ -61,6 +137,30 @@ const XOPC_TUI_KEYBINDINGS = {
 	"app.message.dequeue": {
 		defaultKeys: "alt+up",
 		description: "Restore queued messages to editor"
+	},
+	"app.models.save": {
+		defaultKeys: "ctrl+s",
+		description: "Save scoped model selection"
+	},
+	"app.models.enableAll": {
+		defaultKeys: "ctrl+a",
+		description: "Enable all scoped models"
+	},
+	"app.models.clearAll": {
+		defaultKeys: "ctrl+x",
+		description: "Clear scoped models"
+	},
+	"app.models.toggleProvider": {
+		defaultKeys: "ctrl+p",
+		description: "Toggle selected provider models"
+	},
+	"app.models.reorderUp": {
+		defaultKeys: "alt+up",
+		description: "Move scoped model up"
+	},
+	"app.models.reorderDown": {
+		defaultKeys: "alt+down",
+		description: "Move scoped model down"
 	}
 };
 /** Order for `/hotkeys` and docs (pi-style UX). */
@@ -74,12 +174,37 @@ const XOPC_TUI_HOTKEY_ORDER = [
 	"app.model.cycleBackward",
 	"app.model.select",
 	"app.session.resume",
+	"app.session.tree",
+	"app.session.fork",
+	"app.session.togglePath",
+	"app.session.toggleSort",
+	"app.session.toggleNamedFilter",
+	"app.session.rename",
+	"app.session.delete",
+	"app.session.deleteNoninvasive",
+	"app.tree.foldOrUp",
+	"app.tree.unfoldOrDown",
+	"app.tree.filter.default",
+	"app.tree.filter.noTools",
+	"app.tree.filter.userOnly",
+	"app.tree.filter.labeledOnly",
+	"app.tree.filter.all",
+	"app.tree.filter.cycleForward",
+	"app.tree.filter.cycleBackward",
+	"app.tree.editLabel",
+	"app.tree.toggleLabelTimestamp",
 	"app.tools.expand",
 	"app.thinking.toggle",
 	"app.editor.external",
 	"app.clipboard.pasteImage",
 	"app.message.followUp",
-	"app.message.dequeue"
+	"app.message.dequeue",
+	"app.models.save",
+	"app.models.enableAll",
+	"app.models.clearAll",
+	"app.models.toggleProvider",
+	"app.models.reorderUp",
+	"app.models.reorderDown"
 ];
 //#endregion
 export { XOPC_TUI_HOTKEY_ORDER, XOPC_TUI_KEYBINDINGS };

package/dist/src/tui/xopc-tui-keybindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"xopc-tui-keybindings.js","names":[],"sources":["../../../src/tui/xopc-tui-keybindings.ts"],"sourcesContent":["import {\n  TUI_KEYBINDINGS,\n  type KeybindingDefinitions,\n} from '@earendil-works/pi-tui';\n\n// Re-export removed — `./tui-keybindings-file.js` imports `XOPC_TUI_KEYBINDINGS`\n// from this file, so re-exporting from it created a circular cycle. Callers\n// (tui.ts, test files) import the manager directly from `./tui-keybindings-file.js`.\n\n/** App-level bindings wired by xopc TUI (subset of pi coding-agent). */\nexport type XopcTuiAppKeybinding =\n  | 'app.interrupt'\n  | 'app.clear'\n  | 'app.exit'\n  | 'app.suspend'\n  | 'app.thinking.cycle'\n  | 'app.model.cycleForward'\n  | 'app.model.cycleBackward'\n  | 'app.model.select'\n  | 'app.tools.expand'\n  | 'app.thinking.toggle'\n  | 'app.session.resume'\n  | 'app.editor.external'\n  | 'app.clipboard.pasteImage'\n  | 'app.message.followUp'\n  | 'app.message.dequeue';\n\ndeclare module '@earendil-works/pi-tui' {\n  interface Keybindings {\n    'app.interrupt': true;\n    'app.clear': true;\n    'app.exit': true;\n    'app.suspend': true;\n    'app.thinking.cycle': true;\n    'app.model.cycleForward': true;\n    'app.model.cycleBackward': true;\n    'app.model.select': true;\n    'app.tools.expand': true;\n    'app.thinking.toggle': true;\n    'app.session.resume': true;\n    'app.editor.external': true;\n    'app.clipboard.pasteImage': true;\n    'app.message.followUp': true;\n    'app.message.dequeue': true;\n  }\n}\n\nexport const XOPC_TUI_KEYBINDINGS = {\n  ...TUI_KEYBINDINGS,\n  'app.interrupt': { defaultKeys: 'escape', description: 'Abort run (or cancel overlay)' },\n  'app.clear': { defaultKeys: 'ctrl+c', description: 'Clear input; repeat within 0.5s to exit' },\n  'app.exit': { defaultKeys: 'ctrl+d', description: 'Exit when input empty' },\n  'app.suspend': {\n    defaultKeys: process.platform === 'win32' ? [] : 'ctrl+z',\n    description: 'Suspend to shell (SIGTSTP)',\n  },\n  'app.thinking.cycle': {\n    defaultKeys: 'shift+tab',\n    description: 'Cycle /think level',\n  },\n  'app.model.cycleForward': {\n    defaultKeys: 'ctrl+p',\n    description: 'Next model (/switch)',\n  },\n  'app.model.cycleBackward': {\n    defaultKeys: 'shift+ctrl+p',\n    description: 'Previous model (/switch)',\n  },\n  'app.model.select': { defaultKeys: 'ctrl+l', description: 'Model picker' },\n  'app.tools.expand': { defaultKeys: 'ctrl+o', description: 'Toggle tool output' },\n  'app.thinking.toggle': {\n    defaultKeys: 'ctrl+t',\n    description: 'Toggle thinking block display',\n  },\n  'app.session.resume': {\n    defaultKeys: 'ctrl+shift+p',\n    description: 'Session picker',\n  },\n  'app.editor.external': {\n    defaultKeys: 'ctrl+g',\n    description: 'Edit input in $EDITOR',\n  },\n  'app.clipboard.pasteImage': {\n    defaultKeys: process.platform === 'win32' ? 'alt+v' : 'ctrl+v',\n    description: 'Paste image from clipboard (placeholder)',\n  },\n  'app.message.followUp': {\n    defaultKeys: 'alt+enter',\n    description: 'Queue message while busy (or submit when idle)',\n  },\n  'app.message.dequeue': {\n    defaultKeys: 'alt+up',\n    description: 'Restore queued messages to editor',\n  },\n} as const satisfies KeybindingDefinitions;\n\n/** Order for `/hotkeys` and docs (pi-style UX). */\nexport const XOPC_TUI_HOTKEY_ORDER: XopcTuiAppKeybinding[] = [\n  'app.interrupt',\n  'app.clear',\n  'app.exit',\n  'app.suspend',\n  'app.thinking.cycle',\n  'app.model.cycleForward',\n  'app.model.cycleBackward',\n  'app.model.select',\n  'app.session.resume',\n  'app.tools.expand',\n  'app.thinking.toggle',\n  'app.editor.external',\n  'app.clipboard.pasteImage',\n  'app.message.followUp',\n  'app.message.dequeue',\n];\n"],"mappings":";;AA+CA,MAAa,uBAAuB;CAClC,GAAG;CACH,iBAAiB;EAAE,aAAa;EAAU,aAAa;EAAiC;CACxF,aAAa;EAAE,aAAa;EAAU,aAAa;EAA2C;CAC9F,YAAY;EAAE,aAAa;EAAU,aAAa;EAAyB;CAC3E,eAAe;EACb,aAAa,QAAQ,aAAa,UAAU,EAAE,GAAG;EACjD,aAAa;EACd;CACD,sBAAsB;EACpB,aAAa;EACb,aAAa;EACd;CACD,0BAA0B;EACxB,aAAa;EACb,aAAa;EACd;CACD,2BAA2B;EACzB,aAAa;EACb,aAAa;EACd;CACD,oBAAoB;EAAE,aAAa;EAAU,aAAa;EAAgB;CAC1E,oBAAoB;EAAE,aAAa;EAAU,aAAa;EAAsB;CAChF,uBAAuB;EACrB,aAAa;EACb,aAAa;EACd;CACD,sBAAsB;EACpB,aAAa;EACb,aAAa;EACd;CACD,uBAAuB;EACrB,aAAa;EACb,aAAa;EACd;CACD,4BAA4B;EAC1B,aAAa,QAAQ,aAAa,UAAU,UAAU;EACtD,aAAa;EACd;CACD,wBAAwB;EACtB,aAAa;EACb,aAAa;EACd;CACD,uBAAuB;EACrB,aAAa;EACb,aAAa;EACd;CACF;;AAGD,MAAa,wBAAgD;CAC3D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"xopc-tui-keybindings.js","names":[],"sources":["../../../src/tui/xopc-tui-keybindings.ts"],"sourcesContent":["import {\n  TUI_KEYBINDINGS,\n  type KeybindingDefinitions,\n} from '@earendil-works/pi-tui';\n\n// Re-export removed — `./tui-keybindings-file.js` imports `XOPC_TUI_KEYBINDINGS`\n// from this file, so re-exporting from it created a circular cycle. Callers\n// (tui.ts, test files) import the manager directly from `./tui-keybindings-file.js`.\n\n/** App-level bindings wired by xopc TUI (subset of pi coding-agent). */\nexport type XopcTuiAppKeybinding =\n  | 'app.interrupt'\n  | 'app.clear'\n  | 'app.exit'\n  | 'app.suspend'\n  | 'app.thinking.cycle'\n  | 'app.model.cycleForward'\n  | 'app.model.cycleBackward'\n  | 'app.model.select'\n  | 'app.tools.expand'\n  | 'app.thinking.toggle'\n  | 'app.session.resume'\n  | 'app.session.tree'\n  | 'app.session.fork'\n  | 'app.session.togglePath'\n  | 'app.session.toggleSort'\n  | 'app.session.toggleNamedFilter'\n  | 'app.session.rename'\n  | 'app.session.delete'\n  | 'app.session.deleteNoninvasive'\n  | 'app.tree.foldOrUp'\n  | 'app.tree.unfoldOrDown'\n  | 'app.tree.filter.default'\n  | 'app.tree.filter.noTools'\n  | 'app.tree.filter.userOnly'\n  | 'app.tree.filter.labeledOnly'\n  | 'app.tree.filter.all'\n  | 'app.tree.filter.cycleForward'\n  | 'app.tree.filter.cycleBackward'\n  | 'app.tree.editLabel'\n  | 'app.tree.toggleLabelTimestamp'\n  | 'app.editor.external'\n  | 'app.clipboard.pasteImage'\n  | 'app.message.followUp'\n  | 'app.message.dequeue'\n  | 'app.models.save'\n  | 'app.models.enableAll'\n  | 'app.models.clearAll'\n  | 'app.models.toggleProvider'\n  | 'app.models.reorderUp'\n  | 'app.models.reorderDown';\n\ndeclare module '@earendil-works/pi-tui' {\n  interface Keybindings {\n    'app.interrupt': true;\n    'app.clear': true;\n    'app.exit': true;\n    'app.suspend': true;\n    'app.thinking.cycle': true;\n    'app.model.cycleForward': true;\n    'app.model.cycleBackward': true;\n    'app.model.select': true;\n    'app.tools.expand': true;\n    'app.thinking.toggle': true;\n    'app.session.resume': true;\n    'app.session.tree': true;\n    'app.session.fork': true;\n    'app.session.togglePath': true;\n    'app.session.toggleSort': true;\n    'app.session.toggleNamedFilter': true;\n    'app.session.rename': true;\n    'app.session.delete': true;\n    'app.session.deleteNoninvasive': true;\n    'app.tree.foldOrUp': true;\n    'app.tree.unfoldOrDown': true;\n    'app.tree.filter.default': true;\n    'app.tree.filter.noTools': true;\n    'app.tree.filter.userOnly': true;\n    'app.tree.filter.labeledOnly': true;\n    'app.tree.filter.all': true;\n    'app.tree.filter.cycleForward': true;\n    'app.tree.filter.cycleBackward': true;\n    'app.tree.editLabel': true;\n    'app.tree.toggleLabelTimestamp': true;\n    'app.editor.external': true;\n    'app.clipboard.pasteImage': true;\n    'app.message.followUp': true;\n    'app.message.dequeue': true;\n    'app.models.save': true;\n    'app.models.enableAll': true;\n    'app.models.clearAll': true;\n    'app.models.toggleProvider': true;\n    'app.models.reorderUp': true;\n    'app.models.reorderDown': true;\n  }\n}\n\nexport const XOPC_TUI_KEYBINDINGS = {\n  ...TUI_KEYBINDINGS,\n  'app.interrupt': { defaultKeys: 'escape', description: 'Abort run (or cancel overlay)' },\n  'app.clear': { defaultKeys: 'ctrl+c', description: 'Clear input; repeat within 0.5s to exit' },\n  'app.exit': { defaultKeys: 'ctrl+d', description: 'Exit when input empty' },\n  'app.suspend': {\n    defaultKeys: process.platform === 'win32' ? [] : 'ctrl+z',\n    description: 'Suspend to shell (SIGTSTP)',\n  },\n  'app.thinking.cycle': {\n    defaultKeys: 'shift+tab',\n    description: 'Cycle /think level',\n  },\n  'app.model.cycleForward': {\n    defaultKeys: 'ctrl+p',\n    description: 'Next model (/switch)',\n  },\n  'app.model.cycleBackward': {\n    defaultKeys: 'shift+ctrl+p',\n    description: 'Previous model (/switch)',\n  },\n  'app.model.select': { defaultKeys: 'ctrl+l', description: 'Model picker' },\n  'app.tools.expand': { defaultKeys: 'ctrl+o', description: 'Toggle tool output' },\n  'app.thinking.toggle': {\n    defaultKeys: 'ctrl+t',\n    description: 'Toggle thinking block display',\n  },\n  'app.session.resume': {\n    defaultKeys: 'ctrl+shift+p',\n    description: 'Session picker',\n  },\n  'app.session.tree': {\n    defaultKeys: [],\n    description: 'Show session tree',\n  },\n  'app.session.fork': {\n    defaultKeys: [],\n    description: 'Fork current session',\n  },\n  'app.session.togglePath': {\n    defaultKeys: 'ctrl+p',\n    description: 'Toggle session key display',\n  },\n  'app.session.toggleSort': {\n    defaultKeys: 'ctrl+s',\n    description: 'Toggle session sort mode',\n  },\n  'app.session.toggleNamedFilter': {\n    defaultKeys: 'ctrl+n',\n    description: 'Toggle named session filter',\n  },\n  'app.session.rename': {\n    defaultKeys: 'ctrl+r',\n    description: 'Rename selected session',\n  },\n  'app.session.delete': {\n    defaultKeys: 'ctrl+d',\n    description: 'Delete selected session',\n  },\n  'app.session.deleteNoninvasive': {\n    defaultKeys: 'ctrl+backspace',\n    description: 'Delete session when query is empty',\n  },\n  'app.tree.foldOrUp': {\n    defaultKeys: ['ctrl+left', 'alt+left'],\n    description: 'Fold tree branch or move up',\n  },\n  'app.tree.unfoldOrDown': {\n    defaultKeys: ['ctrl+right', 'alt+right'],\n    description: 'Unfold tree branch or move down',\n  },\n  'app.tree.filter.default': {\n    defaultKeys: 'ctrl+d',\n    description: 'Tree filter: default view',\n  },\n  'app.tree.filter.noTools': {\n    defaultKeys: 'ctrl+t',\n    description: 'Tree filter: hide tool results',\n  },\n  'app.tree.filter.userOnly': {\n    defaultKeys: 'ctrl+u',\n    description: 'Tree filter: user messages only',\n  },\n  'app.tree.filter.labeledOnly': {\n    defaultKeys: 'ctrl+l',\n    description: 'Tree filter: labeled entries only',\n  },\n  'app.tree.filter.all': {\n    defaultKeys: 'ctrl+a',\n    description: 'Tree filter: show all entries',\n  },\n  'app.tree.filter.cycleForward': {\n    defaultKeys: 'ctrl+o',\n    description: 'Tree filter: cycle forward',\n  },\n  'app.tree.filter.cycleBackward': {\n    defaultKeys: 'shift+ctrl+o',\n    description: 'Tree filter: cycle backward',\n  },\n  'app.tree.editLabel': {\n    defaultKeys: 'shift+l',\n    description: 'Edit tree label',\n  },\n  'app.tree.toggleLabelTimestamp': {\n    defaultKeys: 'shift+t',\n    description: 'Toggle tree label timestamps',\n  },\n  'app.editor.external': {\n    defaultKeys: 'ctrl+g',\n    description: 'Edit input in $EDITOR',\n  },\n  'app.clipboard.pasteImage': {\n    defaultKeys: process.platform === 'win32' ? 'alt+v' : 'ctrl+v',\n    description: 'Paste image from clipboard',\n  },\n  'app.message.followUp': {\n    defaultKeys: 'alt+enter',\n    description: 'Queue message while busy (or submit when idle)',\n  },\n  'app.message.dequeue': {\n    defaultKeys: 'alt+up',\n    description: 'Restore queued messages to editor',\n  },\n  'app.models.save': {\n    defaultKeys: 'ctrl+s',\n    description: 'Save scoped model selection',\n  },\n  'app.models.enableAll': {\n    defaultKeys: 'ctrl+a',\n    description: 'Enable all scoped models',\n  },\n  'app.models.clearAll': {\n    defaultKeys: 'ctrl+x',\n    description: 'Clear scoped models',\n  },\n  'app.models.toggleProvider': {\n    defaultKeys: 'ctrl+p',\n    description: 'Toggle selected provider models',\n  },\n  'app.models.reorderUp': {\n    defaultKeys: 'alt+up',\n    description: 'Move scoped model up',\n  },\n  'app.models.reorderDown': {\n    defaultKeys: 'alt+down',\n    description: 'Move scoped model down',\n  },\n} as const satisfies KeybindingDefinitions;\n\n/** Order for `/hotkeys` and docs (pi-style UX). */\nexport const XOPC_TUI_HOTKEY_ORDER: XopcTuiAppKeybinding[] = [\n  'app.interrupt',\n  'app.clear',\n  'app.exit',\n  'app.suspend',\n  'app.thinking.cycle',\n  'app.model.cycleForward',\n  'app.model.cycleBackward',\n  'app.model.select',\n  'app.session.resume',\n  'app.session.tree',\n  'app.session.fork',\n  'app.session.togglePath',\n  'app.session.toggleSort',\n  'app.session.toggleNamedFilter',\n  'app.session.rename',\n  'app.session.delete',\n  'app.session.deleteNoninvasive',\n  'app.tree.foldOrUp',\n  'app.tree.unfoldOrDown',\n  'app.tree.filter.default',\n  'app.tree.filter.noTools',\n  'app.tree.filter.userOnly',\n  'app.tree.filter.labeledOnly',\n  'app.tree.filter.all',\n  'app.tree.filter.cycleForward',\n  'app.tree.filter.cycleBackward',\n  'app.tree.editLabel',\n  'app.tree.toggleLabelTimestamp',\n  'app.tools.expand',\n  'app.thinking.toggle',\n  'app.editor.external',\n  'app.clipboard.pasteImage',\n  'app.message.followUp',\n  'app.message.dequeue',\n  'app.models.save',\n  'app.models.enableAll',\n  'app.models.clearAll',\n  'app.models.toggleProvider',\n  'app.models.reorderUp',\n  'app.models.reorderDown',\n];\n"],"mappings":";;AAiGA,MAAa,uBAAuB;CAClC,GAAG;CACH,iBAAiB;EAAE,aAAa;EAAU,aAAa;EAAiC;CACxF,aAAa;EAAE,aAAa;EAAU,aAAa;EAA2C;CAC9F,YAAY;EAAE,aAAa;EAAU,aAAa;EAAyB;CAC3E,eAAe;EACb,aAAa,QAAQ,aAAa,UAAU,EAAE,GAAG;EACjD,aAAa;EACd;CACD,sBAAsB;EACpB,aAAa;EACb,aAAa;EACd;CACD,0BAA0B;EACxB,aAAa;EACb,aAAa;EACd;CACD,2BAA2B;EACzB,aAAa;EACb,aAAa;EACd;CACD,oBAAoB;EAAE,aAAa;EAAU,aAAa;EAAgB;CAC1E,oBAAoB;EAAE,aAAa;EAAU,aAAa;EAAsB;CAChF,uBAAuB;EACrB,aAAa;EACb,aAAa;EACd;CACD,sBAAsB;EACpB,aAAa;EACb,aAAa;EACd;CACD,oBAAoB;EAClB,aAAa,EAAE;EACf,aAAa;EACd;CACD,oBAAoB;EAClB,aAAa,EAAE;EACf,aAAa;EACd;CACD,0BAA0B;EACxB,aAAa;EACb,aAAa;EACd;CACD,0BAA0B;EACxB,aAAa;EACb,aAAa;EACd;CACD,iCAAiC;EAC/B,aAAa;EACb,aAAa;EACd;CACD,sBAAsB;EACpB,aAAa;EACb,aAAa;EACd;CACD,sBAAsB;EACpB,aAAa;EACb,aAAa;EACd;CACD,iCAAiC;EAC/B,aAAa;EACb,aAAa;EACd;CACD,qBAAqB;EACnB,aAAa,CAAC,aAAa,WAAW;EACtC,aAAa;EACd;CACD,yBAAyB;EACvB,aAAa,CAAC,cAAc,YAAY;EACxC,aAAa;EACd;CACD,2BAA2B;EACzB,aAAa;EACb,aAAa;EACd;CACD,2BAA2B;EACzB,aAAa;EACb,aAAa;EACd;CACD,4BAA4B;EAC1B,aAAa;EACb,aAAa;EACd;CACD,+BAA+B;EAC7B,aAAa;EACb,aAAa;EACd;CACD,uBAAuB;EACrB,aAAa;EACb,aAAa;EACd;CACD,gCAAgC;EAC9B,aAAa;EACb,aAAa;EACd;CACD,iCAAiC;EAC/B,aAAa;EACb,aAAa;EACd;CACD,sBAAsB;EACpB,aAAa;EACb,aAAa;EACd;CACD,iCAAiC;EAC/B,aAAa;EACb,aAAa;EACd;CACD,uBAAuB;EACrB,aAAa;EACb,aAAa;EACd;CACD,4BAA4B;EAC1B,aAAa,QAAQ,aAAa,UAAU,UAAU;EACtD,aAAa;EACd;CACD,wBAAwB;EACtB,aAAa;EACb,aAAa;EACd;CACD,uBAAuB;EACrB,aAAa;EACb,aAAa;EACd;CACD,mBAAmB;EACjB,aAAa;EACb,aAAa;EACd;CACD,wBAAwB;EACtB,aAAa;EACb,aAAa;EACd;CACD,uBAAuB;EACrB,aAAa;EACb,aAAa;EACd;CACD,6BAA6B;EAC3B,aAAa;EACb,aAAa;EACd;CACD,wBAAwB;EACtB,aAAa;EACb,aAAa;EACd;CACD,0BAA0B;EACxB,aAAa;EACb,aAAa;EACd;CACF;;AAGD,MAAa,wBAAgD;CAC3D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/src/workflows/domain/definition-utils.d.ts

@@ -1,5 +1,5 @@
 import type { WorkflowMeta } from '../../agent/workflow/types.js';
-import type { WorkflowDefinition } from './definition.js';
+import type { WorkflowDefinition, WorkflowDefinitionManifest } from './definition.js';
 export declare const DEFAULT_WORKFLOW_CONCURRENCY = 4;
 export declare const DEFAULT_WORKFLOW_TIMEOUT_SEC: number;
 export declare const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;
@@ -8,6 +8,7 @@ export interface WorkflowDefinitionBuildInput {
     source: 'builtin' | 'user';
     script: string;
     meta: WorkflowMeta;
+    manifest?: WorkflowDefinitionManifest;
 }
 export declare function buildWorkflowDefinition(input: WorkflowDefinitionBuildInput): WorkflowDefinition;
 export declare function normalizeWorkflowDefinitionId(value: string): string;

package/dist/src/workflows/domain/definition-utils.js

@@ -9,27 +9,33 @@ function buildWorkflowDefinition(input) {
 		title: phase.title,
 		description: phase.detail
 	})) ?? [];
+	const manifest = input.manifest;
+	const manifestDefaults = manifest?.defaults ?? {};
 	return {
 		id: input.name,
 		name: input.name,
-		title: toWorkflowDefinitionTitle(input.name),
-		description: input.meta.description,
-		version: "1.0.0",
+		title: manifest?.title ?? toWorkflowDefinitionTitle(input.name),
+		description: manifest?.description ?? input.meta.description,
+		version: manifest?.version ?? "1.0.0",
+		inputSchema: manifest?.inputSchema,
+		outputSchema: manifest?.outputSchema,
 		phases,
 		runtime: {
 			kind: "script",
 			source: input.script
 		},
 		defaults: {
-			concurrency: 4,
-			timeoutSec: DEFAULT_WORKFLOW_TIMEOUT_SEC,
-			maxSubagents: input.meta.estimatedAgents?.max ?? 100
+			concurrency: normalizePositiveInt(manifestDefaults.concurrency, 4),
+			timeoutSec: normalizePositiveInt(manifestDefaults.timeoutSec, DEFAULT_WORKFLOW_TIMEOUT_SEC),
+			maxSubagents: normalizePositiveInt(manifestDefaults.maxSubagents, input.meta.estimatedAgents?.max ?? 100)
 		},
+		permissions: manifest?.permissions,
+		resources: manifest?.resources,
 		metadata: {
-			tags: input.meta.tags ?? [],
+			tags: manifest?.tags ?? input.meta.tags ?? [],
 			builtIn: input.source === "builtin",
 			source: input.source,
-			whenToUse: input.meta.whenToUse,
+			whenToUse: manifest?.whenToUse ?? input.meta.whenToUse,
 			estimatedAgents: input.meta.estimatedAgents,
 			examplePrompts: input.meta.examplePrompts,
 			i18n: input.meta.i18n,
@@ -38,6 +44,10 @@ function buildWorkflowDefinition(input) {
 		}
 	};
 }
+function normalizePositiveInt(value, fallback) {
+	if (typeof value !== "number" || !Number.isFinite(value) || value < 1) return fallback;
+	return Math.floor(value);
+}
 function normalizeWorkflowDefinitionId(value) {
 	return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }

package/dist/src/workflows/domain/definition-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition-utils.js","names":[],"sources":["../../../../src/workflows/domain/definition-utils.ts"],"sourcesContent":["import type { WorkflowMeta } from '../../agent/workflow/types.js';\n\nimport type { WorkflowDefinition } from './definition.js';\n\nexport const DEFAULT_WORKFLOW_CONCURRENCY = 4;\nexport const DEFAULT_WORKFLOW_TIMEOUT_SEC = 30 * 60;\nexport const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;\n\nexport interface WorkflowDefinitionBuildInput {\n  name: string;\n  source: 'builtin' | 'user';\n  script: string;\n  meta: WorkflowMeta;\n}\n\nexport function buildWorkflowDefinition(input: WorkflowDefinitionBuildInput): WorkflowDefinition {\n  const nowMs = Date.now();\n  const phases = input.meta.phases?.map((phase, index) => ({\n    id: normalizeWorkflowDefinitionId(phase.title) || `phase-${index + 1}`,\n    title: phase.title,\n    description: phase.detail,\n  })) ?? [];\n\n  return {\n    id: input.name,\n    name: input.name,\n    title: toWorkflowDefinitionTitle(input.name),\n    description: input.meta.description,\n    version: '1.0.0',\n    phases,\n    runtime: {\n      kind: 'script',\n      source: input.script,\n    },\n    defaults: {\n      concurrency: DEFAULT_WORKFLOW_CONCURRENCY,\n      timeoutSec: DEFAULT_WORKFLOW_TIMEOUT_SEC,\n      maxSubagents: input.meta.estimatedAgents?.max ?? DEFAULT_WORKFLOW_MAX_SUBAGENTS,\n    },\n    metadata: {\n      tags: input.meta.tags ?? [],\n      builtIn: input.source === 'builtin',\n      source: input.source,\n      whenToUse: input.meta.whenToUse,\n      estimatedAgents: input.meta.estimatedAgents,\n      examplePrompts: input.meta.examplePrompts,\n      i18n: input.meta.i18n,\n      createdAtMs: nowMs,\n      updatedAtMs: nowMs,\n    },\n  };\n}\n\nexport function normalizeWorkflowDefinitionId(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n}\n\nexport function toWorkflowDefinitionTitle(value: string): string {\n  return value\n    .split(/[_-]+/g)\n    .filter(Boolean)\n    .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)\n    .join(' ');\n}\n"],"mappings":";AAIA,MAAa,+BAA+B;AAC5C,MAAa,+BAA+B;AAC5C,MAAa,iCAAiC;AAS9C,SAAgB,wBAAwB,OAAyD;CAC/F,MAAM,QAAQ,KAAK,KAAK;CACxB,MAAM,SAAS,MAAM,KAAK,QAAQ,KAAK,OAAO,WAAW;EACvD,IAAI,8BAA8B,MAAM,MAAM,IAAI,SAAS,QAAQ;EACnE,OAAO,MAAM;EACb,aAAa,MAAM;EACpB,EAAE,IAAI,EAAE;AAET,QAAO;EACL,IAAI,MAAM;EACV,MAAM,MAAM;EACZ,OAAO,0BAA0B,MAAM,KAAK;EAC5C,aAAa,MAAM,KAAK;EACxB,SAAS;EACT;EACA,SAAS;GACP,MAAM;GACN,QAAQ,MAAM;GACf;EACD,UAAU;GACR,aAAA;GACA,YAAY;GACZ,cAAc,MAAM,KAAK,iBAAiB,OAAA;GAC3C;EACD,UAAU;GACR,MAAM,MAAM,KAAK,QAAQ,EAAE;GAC3B,SAAS,MAAM,WAAW;GAC1B,QAAQ,MAAM;GACd,WAAW,MAAM,KAAK;GACtB,iBAAiB,MAAM,KAAK;GAC5B,gBAAgB,MAAM,KAAK;GAC3B,MAAM,MAAM,KAAK;GACjB,aAAa;GACb,aAAa;GACd;EACF;;AAGH,SAAgB,8BAA8B,OAAuB;AACnE,QAAO,MACJ,MAAM,CACN,aAAa,CACb,QAAQ,eAAe,IAAI,CAC3B,QAAQ,YAAY,GAAG;;AAG5B,SAAgB,0BAA0B,OAAuB;AAC/D,QAAO,MACJ,MAAM,SAAS,CACf,OAAO,QAAQ,CACf,KAAK,SAAS,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,GAAG,CAClE,KAAK,IAAI"}
+{"version":3,"file":"definition-utils.js","names":[],"sources":["../../../../src/workflows/domain/definition-utils.ts"],"sourcesContent":["import type { WorkflowMeta } from '../../agent/workflow/types.js';\n\nimport type { WorkflowDefinition, WorkflowDefinitionManifest } from './definition.js';\n\nexport const DEFAULT_WORKFLOW_CONCURRENCY = 4;\nexport const DEFAULT_WORKFLOW_TIMEOUT_SEC = 30 * 60;\nexport const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;\n\nexport interface WorkflowDefinitionBuildInput {\n  name: string;\n  source: 'builtin' | 'user';\n  script: string;\n  meta: WorkflowMeta;\n  manifest?: WorkflowDefinitionManifest;\n}\n\nexport function buildWorkflowDefinition(input: WorkflowDefinitionBuildInput): WorkflowDefinition {\n  const nowMs = Date.now();\n  const phases = input.meta.phases?.map((phase, index) => ({\n    id: normalizeWorkflowDefinitionId(phase.title) || `phase-${index + 1}`,\n    title: phase.title,\n    description: phase.detail,\n  })) ?? [];\n\n  const manifest = input.manifest;\n  const manifestDefaults = manifest?.defaults ?? {};\n\n  return {\n    id: input.name,\n    name: input.name,\n    title: manifest?.title ?? toWorkflowDefinitionTitle(input.name),\n    description: manifest?.description ?? input.meta.description,\n    version: manifest?.version ?? '1.0.0',\n    inputSchema: manifest?.inputSchema,\n    outputSchema: manifest?.outputSchema,\n    phases,\n    runtime: {\n      kind: 'script',\n      source: input.script,\n    },\n    defaults: {\n      concurrency: normalizePositiveInt(manifestDefaults.concurrency, DEFAULT_WORKFLOW_CONCURRENCY),\n      timeoutSec: normalizePositiveInt(manifestDefaults.timeoutSec, DEFAULT_WORKFLOW_TIMEOUT_SEC),\n      maxSubagents: normalizePositiveInt(\n        manifestDefaults.maxSubagents,\n        input.meta.estimatedAgents?.max ?? DEFAULT_WORKFLOW_MAX_SUBAGENTS,\n      ),\n    },\n    permissions: manifest?.permissions,\n    resources: manifest?.resources,\n    metadata: {\n      tags: manifest?.tags ?? input.meta.tags ?? [],\n      builtIn: input.source === 'builtin',\n      source: input.source,\n      whenToUse: manifest?.whenToUse ?? input.meta.whenToUse,\n      estimatedAgents: input.meta.estimatedAgents,\n      examplePrompts: input.meta.examplePrompts,\n      i18n: input.meta.i18n,\n      createdAtMs: nowMs,\n      updatedAtMs: nowMs,\n    },\n  };\n}\n\nfunction normalizePositiveInt(value: number | undefined, fallback: number): number {\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < 1) {\n    return fallback;\n  }\n  return Math.floor(value);\n}\n\nexport function normalizeWorkflowDefinitionId(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n}\n\nexport function toWorkflowDefinitionTitle(value: string): string {\n  return value\n    .split(/[_-]+/g)\n    .filter(Boolean)\n    .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)\n    .join(' ');\n}\n"],"mappings":";AAIA,MAAa,+BAA+B;AAC5C,MAAa,+BAA+B;AAC5C,MAAa,iCAAiC;AAU9C,SAAgB,wBAAwB,OAAyD;CAC/F,MAAM,QAAQ,KAAK,KAAK;CACxB,MAAM,SAAS,MAAM,KAAK,QAAQ,KAAK,OAAO,WAAW;EACvD,IAAI,8BAA8B,MAAM,MAAM,IAAI,SAAS,QAAQ;EACnE,OAAO,MAAM;EACb,aAAa,MAAM;EACpB,EAAE,IAAI,EAAE;CAET,MAAM,WAAW,MAAM;CACvB,MAAM,mBAAmB,UAAU,YAAY,EAAE;AAEjD,QAAO;EACL,IAAI,MAAM;EACV,MAAM,MAAM;EACZ,OAAO,UAAU,SAAS,0BAA0B,MAAM,KAAK;EAC/D,aAAa,UAAU,eAAe,MAAM,KAAK;EACjD,SAAS,UAAU,WAAW;EAC9B,aAAa,UAAU;EACvB,cAAc,UAAU;EACxB;EACA,SAAS;GACP,MAAM;GACN,QAAQ,MAAM;GACf;EACD,UAAU;GACR,aAAa,qBAAqB,iBAAiB,aAAA,EAA0C;GAC7F,YAAY,qBAAqB,iBAAiB,YAAY,6BAA6B;GAC3F,cAAc,qBACZ,iBAAiB,cACjB,MAAM,KAAK,iBAAiB,OAAA,IAC7B;GACF;EACD,aAAa,UAAU;EACvB,WAAW,UAAU;EACrB,UAAU;GACR,MAAM,UAAU,QAAQ,MAAM,KAAK,QAAQ,EAAE;GAC7C,SAAS,MAAM,WAAW;GAC1B,QAAQ,MAAM;GACd,WAAW,UAAU,aAAa,MAAM,KAAK;GAC7C,iBAAiB,MAAM,KAAK;GAC5B,gBAAgB,MAAM,KAAK;GAC3B,MAAM,MAAM,KAAK;GACjB,aAAa;GACb,aAAa;GACd;EACF;;AAGH,SAAS,qBAAqB,OAA2B,UAA0B;AACjF,KAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,MAAM,IAAI,QAAQ,EAClE,QAAO;AAET,QAAO,KAAK,MAAM,MAAM;;AAG1B,SAAgB,8BAA8B,OAAuB;AACnE,QAAO,MACJ,MAAM,CACN,aAAa,CACb,QAAQ,eAAe,IAAI,CAC3B,QAAQ,YAAY,GAAG;;AAG5B,SAAgB,0BAA0B,OAAuB;AAC/D,QAAO,MACJ,MAAM,SAAS,CACf,OAAO,QAAQ,CACf,KAAK,SAAS,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,GAAG,CAClE,KAAK,IAAI"}

package/dist/src/workflows/domain/definition.d.ts

@@ -20,8 +20,33 @@ export interface WorkflowDefinition {
     phases: WorkflowPhaseDefinition[];
     runtime: WorkflowRuntimeDefinition;
     defaults: WorkflowDefinitionDefaults;
+    permissions?: WorkflowPermissionPolicy;
+    resources?: WorkflowResourceRefs;
     metadata: WorkflowDefinitionMetadata;
 }
+export interface WorkflowDefinitionManifest {
+    title?: string;
+    description?: string;
+    version?: string;
+    inputSchema?: JsonSchema;
+    outputSchema?: JsonSchema;
+    defaults?: Partial<WorkflowDefinitionDefaults>;
+    tags?: string[];
+    whenToUse?: string;
+    permissions?: WorkflowPermissionPolicy;
+    resources?: WorkflowResourceRefs;
+}
+export interface WorkflowPermissionPolicy {
+    tools?: string[];
+    network?: boolean;
+    fileSystem?: 'read' | 'write' | 'none';
+    approvalRequired?: boolean;
+}
+export interface WorkflowResourceRefs {
+    skills?: string[];
+    contextFiles?: string[];
+    promptTemplates?: string[];
+}
 export interface WorkflowPhaseDefinition {
     id: string;
     title: string;

package/dist/src/workflows/domain/event.d.ts

@@ -28,6 +28,7 @@ export interface AgentQueuedPayload {
     label: string;
     phaseId?: string;
     prompt?: string;
+    sessionKey: string;
 }
 export interface AgentStartedPayload {
     agentId: string;

package/dist/src/workflows/domain/result.d.ts

@@ -4,8 +4,23 @@ export interface WorkflowResultEnvelope {
     sections: WorkflowResultSection[];
     actions?: WorkflowNextAction[];
     artifacts?: WorkflowArtifactRef[];
+    followUps?: WorkflowFollowUp[];
+    structuredOutput?: unknown;
     raw?: unknown;
 }
+/** Product-level outcome contract for reusable workflow deliverables. */
+export interface WorkflowOutcome {
+    summary: string;
+    artifacts?: WorkflowArtifactRef[];
+    followUps?: WorkflowFollowUp[];
+    structuredOutput?: unknown;
+}
+export interface WorkflowFollowUp {
+    id: string;
+    title: string;
+    prompt?: string;
+    priority?: 'low' | 'medium' | 'high';
+}
 export type WorkflowResultSection = WorkflowTextSection | WorkflowFindingsSection | WorkflowRisksSection | WorkflowQuestionsSection | WorkflowJsonSection;
 export interface WorkflowTextSection {
     kind: 'text';

package/dist/src/workflows/domain/run.d.ts

@@ -147,6 +147,8 @@ export interface WorkflowAgentView {
     phaseId?: string;
     status: WorkflowAgentStatus;
     prompt?: string;
+    sessionKey: string;
+    transcriptMessageCount: number;
     currentStep?: string;
     resultPreview?: string;
     error?: string;

package/dist/src/workflows/domain/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","names":[],"sources":["../../../../src/workflows/domain/run.ts"],"sourcesContent":["import type { WorkflowDefinitionEstimatedAgents } from './definition.js';\nimport type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';\n\nexport type WorkflowRunStatus =\n  | 'queued'\n  | 'running'\n  | 'succeeded'\n  | 'failed'\n  | 'cancelled'\n  | 'timeout';\n\nconst TERMINAL_WORKFLOW_RUN_STATUSES = new Set<WorkflowRunStatus>([\n  'succeeded',\n  'failed',\n  'cancelled',\n  'timeout',\n]);\n\nexport function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean {\n  return TERMINAL_WORKFLOW_RUN_STATUSES.has(status);\n}\n\nexport interface WorkflowRun {\n  id: string;\n  definitionId: string;\n  definitionVersion: string;\n  title: string;\n  goal: string;\n  input: unknown;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  result?: WorkflowResultEnvelope;\n  error?: WorkflowRunError;\n  metrics: WorkflowRunMetrics;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowRunMetadata {\n  sessionKey: string;\n  triggerSource: WorkflowRunSource['kind'];\n  agentId?: string;\n  retryOfRunId?: string;\n  definition: WorkflowRunDefinitionSnapshot;\n  input?: WorkflowRunInputEnvelope;\n  correlation?: WorkflowRunCorrelation;\n  origin?: WorkflowRunOrigin;\n  schedule?: WorkflowRunScheduleMetadata;\n}\n\nexport interface WorkflowRunInputEnvelope {\n  payload: unknown;\n  goal?: string;\n  variables?: Record<string, unknown>;\n  context?: Record<string, unknown>;\n}\n\nexport interface WorkflowRunCorrelation {\n  idempotencyKey?: string;\n  requestId?: string;\n  traceId?: string;\n  parentRunId?: string;\n}\n\nexport interface WorkflowRunOrigin {\n  channel: string;\n  sessionKey?: string;\n  chatId?: string;\n  messageId?: string;\n  scheduleId?: string;\n  fireId?: string;\n  requestId?: string;\n}\n\nexport interface WorkflowRunScheduleMetadata {\n  scheduleId: string;\n  fireId?: string;\n  scheduledAtMs?: number;\n}\n\nexport interface WorkflowRunDefinitionSnapshot {\n  id: string;\n  name: string;\n  title: string;\n  version: string;\n  source: 'builtin' | 'user';\n  tags: string[];\n  phaseCount: number;\n  estimatedAgents?: WorkflowDefinitionEstimatedAgents;\n}\n\nexport type WorkflowRunSource =\n  | { kind: 'chat'; sessionKey: string; messageId?: string }\n  | { kind: 'webui'; sessionKey?: string; requestId?: string }\n  | { kind: 'cron'; scheduleId: string; fireId?: string; scheduledAtMs?: number }\n  | { kind: 'api'; requestId?: string; idempotencyKey?: string }\n  | { kind: 'im'; channel: string; chatId: string; messageId?: string; userId?: string };\n\nexport interface WorkflowRunMetrics {\n  agentCount: number;\n  doneAgentCount: number;\n  errorAgentCount: number;\n  skippedAgentCount: number;\n  artifactCount: number;\n  durationMs?: number;\n}\n\nexport interface WorkflowRunError {\n  code: WorkflowRunErrorCode;\n  message: string;\n  detail?: string;\n  recoverable: boolean;\n}\n\nexport type WorkflowRunErrorCode =\n  | 'definition_not_found'\n  | 'invalid_input'\n  | 'runtime_error'\n  | 'timeout'\n  | 'cancelled'\n  | 'result_validation_failed'\n  | 'agent_quota_exceeded';\n\nexport interface WorkflowRunControls {\n  canCancel: boolean;\n  canRetry: boolean;\n  canArchive: boolean;\n}\n\nexport interface WorkflowRunSummary {\n  id: string;\n  definitionId: string;\n  title: string;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  metrics: WorkflowRunMetrics;\n}\n\nexport interface WorkflowRunView {\n  run: WorkflowRun;\n  phases: WorkflowPhaseView[];\n  agents: WorkflowAgentView[];\n  logs: WorkflowLogEntry[];\n  artifacts: WorkflowArtifactRef[];\n  timeline: WorkflowTimelineItem[];\n  controls: WorkflowRunControls;\n}\n\nexport type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';\n\nexport interface WorkflowPhaseView {\n  id: string;\n  title: string;\n  status: WorkflowPhaseStatus;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  agentIds: string[];\n}\n\nexport type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';\n\nexport interface WorkflowAgentView {\n  id: string;\n  label: string;\n  phaseId?: string;\n  status: WorkflowAgentStatus;\n  prompt?: string;\n  currentStep?: string;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  steps: WorkflowAgentStepView[];\n}\n\nexport type WorkflowAgentStepStatus = 'running' | 'done' | 'error';\n\nexport interface WorkflowAgentStepView {\n  id: string;\n  label: string;\n  kind: 'tool' | 'llm' | 'thinking';\n  toolName?: string;\n  detail?: string;\n  status: WorkflowAgentStepStatus;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowLogEntry {\n  sequence: number;\n  message: string;\n  createdAtMs: number;\n}\n\nexport interface WorkflowTimelineItem {\n  sequence: number;\n  type: string;\n  title: string;\n  createdAtMs: number;\n}\n"],"mappings":";AAWA,MAAM,iCAAiC,IAAI,IAAuB;CAChE;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,4BAA4B,QAAoC;AAC9E,QAAO,+BAA+B,IAAI,OAAO"}
+{"version":3,"file":"run.js","names":[],"sources":["../../../../src/workflows/domain/run.ts"],"sourcesContent":["import type { WorkflowDefinitionEstimatedAgents } from './definition.js';\nimport type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';\n\nexport type WorkflowRunStatus =\n  | 'queued'\n  | 'running'\n  | 'succeeded'\n  | 'failed'\n  | 'cancelled'\n  | 'timeout';\n\nconst TERMINAL_WORKFLOW_RUN_STATUSES = new Set<WorkflowRunStatus>([\n  'succeeded',\n  'failed',\n  'cancelled',\n  'timeout',\n]);\n\nexport function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean {\n  return TERMINAL_WORKFLOW_RUN_STATUSES.has(status);\n}\n\nexport interface WorkflowRun {\n  id: string;\n  definitionId: string;\n  definitionVersion: string;\n  title: string;\n  goal: string;\n  input: unknown;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  result?: WorkflowResultEnvelope;\n  error?: WorkflowRunError;\n  metrics: WorkflowRunMetrics;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowRunMetadata {\n  sessionKey: string;\n  triggerSource: WorkflowRunSource['kind'];\n  agentId?: string;\n  retryOfRunId?: string;\n  definition: WorkflowRunDefinitionSnapshot;\n  input?: WorkflowRunInputEnvelope;\n  correlation?: WorkflowRunCorrelation;\n  origin?: WorkflowRunOrigin;\n  schedule?: WorkflowRunScheduleMetadata;\n}\n\nexport interface WorkflowRunInputEnvelope {\n  payload: unknown;\n  goal?: string;\n  variables?: Record<string, unknown>;\n  context?: Record<string, unknown>;\n}\n\nexport interface WorkflowRunCorrelation {\n  idempotencyKey?: string;\n  requestId?: string;\n  traceId?: string;\n  parentRunId?: string;\n}\n\nexport interface WorkflowRunOrigin {\n  channel: string;\n  sessionKey?: string;\n  chatId?: string;\n  messageId?: string;\n  scheduleId?: string;\n  fireId?: string;\n  requestId?: string;\n}\n\nexport interface WorkflowRunScheduleMetadata {\n  scheduleId: string;\n  fireId?: string;\n  scheduledAtMs?: number;\n}\n\nexport interface WorkflowRunDefinitionSnapshot {\n  id: string;\n  name: string;\n  title: string;\n  version: string;\n  source: 'builtin' | 'user';\n  tags: string[];\n  phaseCount: number;\n  estimatedAgents?: WorkflowDefinitionEstimatedAgents;\n}\n\nexport type WorkflowRunSource =\n  | { kind: 'chat'; sessionKey: string; messageId?: string }\n  | { kind: 'webui'; sessionKey?: string; requestId?: string }\n  | { kind: 'cron'; scheduleId: string; fireId?: string; scheduledAtMs?: number }\n  | { kind: 'api'; requestId?: string; idempotencyKey?: string }\n  | { kind: 'im'; channel: string; chatId: string; messageId?: string; userId?: string };\n\nexport interface WorkflowRunMetrics {\n  agentCount: number;\n  doneAgentCount: number;\n  errorAgentCount: number;\n  skippedAgentCount: number;\n  artifactCount: number;\n  durationMs?: number;\n}\n\nexport interface WorkflowRunError {\n  code: WorkflowRunErrorCode;\n  message: string;\n  detail?: string;\n  recoverable: boolean;\n}\n\nexport type WorkflowRunErrorCode =\n  | 'definition_not_found'\n  | 'invalid_input'\n  | 'runtime_error'\n  | 'timeout'\n  | 'cancelled'\n  | 'result_validation_failed'\n  | 'agent_quota_exceeded';\n\nexport interface WorkflowRunControls {\n  canCancel: boolean;\n  canRetry: boolean;\n  canArchive: boolean;\n}\n\nexport interface WorkflowRunSummary {\n  id: string;\n  definitionId: string;\n  title: string;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  metrics: WorkflowRunMetrics;\n}\n\nexport interface WorkflowRunView {\n  run: WorkflowRun;\n  phases: WorkflowPhaseView[];\n  agents: WorkflowAgentView[];\n  logs: WorkflowLogEntry[];\n  artifacts: WorkflowArtifactRef[];\n  timeline: WorkflowTimelineItem[];\n  controls: WorkflowRunControls;\n}\n\nexport type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';\n\nexport interface WorkflowPhaseView {\n  id: string;\n  title: string;\n  status: WorkflowPhaseStatus;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  agentIds: string[];\n}\n\nexport type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';\n\nexport interface WorkflowAgentView {\n  id: string;\n  label: string;\n  phaseId?: string;\n  status: WorkflowAgentStatus;\n  prompt?: string;\n  sessionKey: string;\n  transcriptMessageCount: number;\n  currentStep?: string;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  steps: WorkflowAgentStepView[];\n}\n\nexport type WorkflowAgentStepStatus = 'running' | 'done' | 'error';\n\nexport interface WorkflowAgentStepView {\n  id: string;\n  label: string;\n  kind: 'tool' | 'llm' | 'thinking';\n  toolName?: string;\n  detail?: string;\n  status: WorkflowAgentStepStatus;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowLogEntry {\n  sequence: number;\n  message: string;\n  createdAtMs: number;\n}\n\nexport interface WorkflowTimelineItem {\n  sequence: number;\n  type: string;\n  title: string;\n  createdAtMs: number;\n}\n"],"mappings":";AAWA,MAAM,iCAAiC,IAAI,IAAuB;CAChE;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,4BAA4B,QAAoC;AAC9E,QAAO,+BAA+B,IAAI,OAAO"}

package/dist/src/workflows/engine/projector.js

@@ -71,6 +71,8 @@ function projectWorkflowRunView(events) {
 					phaseId: payload.phaseId,
 					status: "queued",
 					prompt: payload.prompt,
+					sessionKey: payload.sessionKey,
+					transcriptMessageCount: 0,
 					steps: []
 				});
 				if (payload.phaseId) {
@@ -98,6 +100,7 @@ function projectWorkflowRunView(events) {
 				if (existing) agentIdToAgent.set(payload.agentId, {
 					...existing,
 					currentStep: payload.label,
+					transcriptMessageCount: existing.transcriptMessageCount + 1,
 					steps: [...existing.steps, {
 						id: payload.stepId,
 						label: payload.label,
@@ -134,6 +137,7 @@ function projectWorkflowRunView(events) {
 					currentStep: void 0,
 					resultPreview: payload.resultPreview,
 					error: payload.error,
+					transcriptMessageCount: existing.transcriptMessageCount + 1,
 					completedAtMs: event.createdAtMs
 				});
 				break;

package/dist/src/workflows/engine/projector.js.map

@@ -1 +1 @@
-{"version":3,"file":"projector.js","names":[],"sources":["../../../../src/workflows/engine/projector.ts"],"sourcesContent":["import type { WorkflowEventEnvelope } from '../domain/event.js';\nimport type {\n  WorkflowAgentStatus,\n  WorkflowAgentView,\n  WorkflowLogEntry,\n  WorkflowPhaseStatus,\n  WorkflowPhaseView,\n  WorkflowRun,\n  WorkflowRunView,\n  WorkflowTimelineItem,\n} from '../domain/run.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/run.js';\nimport type { WorkflowArtifactRef } from '../domain/result.js';\n\nfunction terminalRunStatus(status: WorkflowRun['status']): boolean {\n  return isTerminalWorkflowRunStatus(status);\n}\n\nfunction phaseStatusAfterAgentStatus(agentStatuses: WorkflowAgentStatus[]): WorkflowPhaseStatus {\n  if (agentStatuses.some((status) => status === 'running')) {\n    return 'running';\n  }\n  if (agentStatuses.some((status) => status === 'error')) {\n    return 'failed';\n  }\n  if (agentStatuses.length > 0 && agentStatuses.every((status) => status === 'done' || status === 'skipped')) {\n    return 'completed';\n  }\n  return 'pending';\n}\n\nfunction buildTimelineItem(event: WorkflowEventEnvelope): WorkflowTimelineItem {\n  return {\n    sequence: event.sequence,\n    type: event.type,\n    title: event.type.replaceAll('_', ' '),\n    createdAtMs: event.createdAtMs,\n  };\n}\n\nexport function projectWorkflowRunView(events: WorkflowEventEnvelope[]): WorkflowRunView | null {\n  if (events.length === 0) {\n    return null;\n  }\n\n  const orderedEvents = [...events].sort((left, right) => left.sequence - right.sequence);\n  const firstEvent = orderedEvents[0];\n  if (firstEvent.type !== 'run_queued') {\n    return null;\n  }\n\n  const firstPayload = firstEvent.payload as { run?: WorkflowRun };\n  if (!firstPayload.run) {\n    return null;\n  }\n\n  const run: WorkflowRun = {\n    ...firstPayload.run,\n    metrics: { ...firstPayload.run.metrics },\n  };\n  const phaseIdToPhase = new Map<string, WorkflowPhaseView>();\n  const agentIdToAgent = new Map<string, WorkflowAgentView>();\n  const logs: WorkflowLogEntry[] = [];\n  const artifacts: WorkflowArtifactRef[] = [];\n  const timeline: WorkflowTimelineItem[] = [];\n\n  for (const event of orderedEvents) {\n    timeline.push(buildTimelineItem(event));\n\n    switch (event.type) {\n      case 'run_started': {\n        const payload = event.payload as { startedAtMs: number };\n        run.status = 'running';\n        run.startedAtMs = payload.startedAtMs;\n        break;\n      }\n      case 'phase_started': {\n        const payload = event.payload as { phaseId: string; title: string };\n        phaseIdToPhase.set(payload.phaseId, {\n          id: payload.phaseId,\n          title: payload.title,\n          status: 'running',\n          startedAtMs: event.createdAtMs,\n          agentIds: phaseIdToPhase.get(payload.phaseId)?.agentIds ?? [],\n        });\n        break;\n      }\n      case 'phase_completed': {\n        const payload = event.payload as { phaseId: string };\n        const existing = phaseIdToPhase.get(payload.phaseId);\n        if (existing) {\n          phaseIdToPhase.set(payload.phaseId, {\n            ...existing,\n            status: 'completed',\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_queued': {\n        const payload = event.payload as { agentId: string; label: string; phaseId?: string; prompt?: string };\n        agentIdToAgent.set(payload.agentId, {\n          id: payload.agentId,\n          label: payload.label,\n          phaseId: payload.phaseId,\n          status: 'queued',\n          prompt: payload.prompt,\n          steps: [],\n        });\n        if (payload.phaseId) {\n          const existingPhase = phaseIdToPhase.get(payload.phaseId);\n          if (existingPhase && !existingPhase.agentIds.includes(payload.agentId)) {\n            phaseIdToPhase.set(payload.phaseId, {\n              ...existingPhase,\n              agentIds: [...existingPhase.agentIds, payload.agentId],\n            });\n          }\n        }\n        break;\n      }\n      case 'agent_started': {\n        const payload = event.payload as { agentId: string };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: 'running',\n            startedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_step_started': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          label: string;\n          kind: 'tool' | 'llm' | 'thinking';\n          toolName?: string;\n          detail?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            currentStep: payload.label,\n            steps: [\n              ...existing.steps,\n              {\n                id: payload.stepId,\n                label: payload.label,\n                kind: payload.kind,\n                toolName: payload.toolName,\n                detail: payload.detail,\n                status: 'running',\n                startedAtMs: event.createdAtMs,\n              },\n            ],\n          });\n        }\n        break;\n      }\n      case 'agent_step_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          status: 'done' | 'error';\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            steps: existing.steps.map((step) =>\n              step.id === payload.stepId\n                ? {\n                    ...step,\n                    status: payload.status,\n                    resultPreview: payload.resultPreview,\n                    error: payload.error,\n                    completedAtMs: event.createdAtMs,\n                  }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'agent_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          status: WorkflowAgentStatus;\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: payload.status,\n            currentStep: undefined,\n            resultPreview: payload.resultPreview,\n            error: payload.error,\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'log_appended': {\n        const payload = event.payload as { message: string };\n        logs.push({ sequence: event.sequence, message: payload.message, createdAtMs: event.createdAtMs });\n        break;\n      }\n      case 'artifact_created': {\n        const payload = event.payload as { artifact: WorkflowArtifactRef };\n        artifacts.push(payload.artifact);\n        run.metrics.artifactCount = artifacts.length;\n        break;\n      }\n      case 'run_completed': {\n        const payload = event.payload as { result: WorkflowRun['result'] };\n        run.status = 'succeeded';\n        run.result = payload.result;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_failed': {\n        const payload = event.payload as { error: WorkflowRun['error'] };\n        run.status = payload.error?.code === 'timeout' ? 'timeout' : 'failed';\n        run.error = payload.error;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_cancelled': {\n        run.status = 'cancelled';\n        run.completedAtMs = event.createdAtMs;\n        for (const [agentId, agent] of agentIdToAgent) {\n          if (agent.status !== 'queued' && agent.status !== 'running') {\n            continue;\n          }\n          agentIdToAgent.set(agentId, {\n            ...agent,\n            status: 'skipped',\n            currentStep: undefined,\n            completedAtMs: event.createdAtMs,\n            steps: agent.steps.map((step) =>\n              step.status === 'running'\n                ? { ...step, status: 'error', completedAtMs: event.createdAtMs }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'run_queued':\n      default:\n        break;\n    }\n  }\n\n  const agents = [...agentIdToAgent.values()];\n  run.metrics.agentCount = agents.length;\n  run.metrics.doneAgentCount = agents.filter((agent) => agent.status === 'done').length;\n  run.metrics.errorAgentCount = agents.filter((agent) => agent.status === 'error').length;\n  run.metrics.skippedAgentCount = agents.filter((agent) => agent.status === 'skipped').length;\n  run.metrics.artifactCount = artifacts.length;\n  if (run.startedAtMs && run.completedAtMs) {\n    run.metrics.durationMs = run.completedAtMs - run.startedAtMs;\n  }\n\n  const phases = [...phaseIdToPhase.values()].map((phase) => {\n    if (phase.status === 'completed' || phase.status === 'failed') {\n      return phase;\n    }\n    const phaseAgents = phase.agentIds\n      .map((agentId) => agentIdToAgent.get(agentId)?.status)\n      .filter((status): status is WorkflowAgentStatus => Boolean(status));\n    return { ...phase, status: phaseStatusAfterAgentStatus(phaseAgents) };\n  });\n\n  return {\n    run,\n    phases,\n    agents,\n    logs,\n    artifacts,\n    timeline,\n    controls: {\n      canCancel: !terminalRunStatus(run.status),\n      canRetry: terminalRunStatus(run.status),\n      canArchive: terminalRunStatus(run.status),\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"projector.js","names":[],"sources":["../../../../src/workflows/engine/projector.ts"],"sourcesContent":["import type { WorkflowEventEnvelope } from '../domain/event.js';\nimport type {\n  WorkflowAgentStatus,\n  WorkflowAgentView,\n  WorkflowLogEntry,\n  WorkflowPhaseStatus,\n  WorkflowPhaseView,\n  WorkflowRun,\n  WorkflowRunView,\n  WorkflowTimelineItem,\n} from '../domain/run.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/run.js';\nimport type { WorkflowArtifactRef } from '../domain/result.js';\n\nfunction terminalRunStatus(status: WorkflowRun['status']): boolean {\n  return isTerminalWorkflowRunStatus(status);\n}\n\nfunction phaseStatusAfterAgentStatus(agentStatuses: WorkflowAgentStatus[]): WorkflowPhaseStatus {\n  if (agentStatuses.some((status) => status === 'running')) {\n    return 'running';\n  }\n  if (agentStatuses.some((status) => status === 'error')) {\n    return 'failed';\n  }\n  if (agentStatuses.length > 0 && agentStatuses.every((status) => status === 'done' || status === 'skipped')) {\n    return 'completed';\n  }\n  return 'pending';\n}\n\nfunction buildTimelineItem(event: WorkflowEventEnvelope): WorkflowTimelineItem {\n  return {\n    sequence: event.sequence,\n    type: event.type,\n    title: event.type.replaceAll('_', ' '),\n    createdAtMs: event.createdAtMs,\n  };\n}\n\nexport function projectWorkflowRunView(events: WorkflowEventEnvelope[]): WorkflowRunView | null {\n  if (events.length === 0) {\n    return null;\n  }\n\n  const orderedEvents = [...events].sort((left, right) => left.sequence - right.sequence);\n  const firstEvent = orderedEvents[0];\n  if (firstEvent.type !== 'run_queued') {\n    return null;\n  }\n\n  const firstPayload = firstEvent.payload as { run?: WorkflowRun };\n  if (!firstPayload.run) {\n    return null;\n  }\n\n  const run: WorkflowRun = {\n    ...firstPayload.run,\n    metrics: { ...firstPayload.run.metrics },\n  };\n  const phaseIdToPhase = new Map<string, WorkflowPhaseView>();\n  const agentIdToAgent = new Map<string, WorkflowAgentView>();\n  const logs: WorkflowLogEntry[] = [];\n  const artifacts: WorkflowArtifactRef[] = [];\n  const timeline: WorkflowTimelineItem[] = [];\n\n  for (const event of orderedEvents) {\n    timeline.push(buildTimelineItem(event));\n\n    switch (event.type) {\n      case 'run_started': {\n        const payload = event.payload as { startedAtMs: number };\n        run.status = 'running';\n        run.startedAtMs = payload.startedAtMs;\n        break;\n      }\n      case 'phase_started': {\n        const payload = event.payload as { phaseId: string; title: string };\n        phaseIdToPhase.set(payload.phaseId, {\n          id: payload.phaseId,\n          title: payload.title,\n          status: 'running',\n          startedAtMs: event.createdAtMs,\n          agentIds: phaseIdToPhase.get(payload.phaseId)?.agentIds ?? [],\n        });\n        break;\n      }\n      case 'phase_completed': {\n        const payload = event.payload as { phaseId: string };\n        const existing = phaseIdToPhase.get(payload.phaseId);\n        if (existing) {\n          phaseIdToPhase.set(payload.phaseId, {\n            ...existing,\n            status: 'completed',\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_queued': {\n        const payload = event.payload as { agentId: string; label: string; phaseId?: string; prompt?: string; sessionKey: string };\n        agentIdToAgent.set(payload.agentId, {\n          id: payload.agentId,\n          label: payload.label,\n          phaseId: payload.phaseId,\n          status: 'queued',\n          prompt: payload.prompt,\n          sessionKey: payload.sessionKey,\n          transcriptMessageCount: 0,\n          steps: [],\n        });\n        if (payload.phaseId) {\n          const existingPhase = phaseIdToPhase.get(payload.phaseId);\n          if (existingPhase && !existingPhase.agentIds.includes(payload.agentId)) {\n            phaseIdToPhase.set(payload.phaseId, {\n              ...existingPhase,\n              agentIds: [...existingPhase.agentIds, payload.agentId],\n            });\n          }\n        }\n        break;\n      }\n      case 'agent_started': {\n        const payload = event.payload as { agentId: string };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: 'running',\n            startedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_step_started': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          label: string;\n          kind: 'tool' | 'llm' | 'thinking';\n          toolName?: string;\n          detail?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            currentStep: payload.label,\n            transcriptMessageCount: existing.transcriptMessageCount + 1,\n            steps: [\n              ...existing.steps,\n              {\n                id: payload.stepId,\n                label: payload.label,\n                kind: payload.kind,\n                toolName: payload.toolName,\n                detail: payload.detail,\n                status: 'running',\n                startedAtMs: event.createdAtMs,\n              },\n            ],\n          });\n        }\n        break;\n      }\n      case 'agent_step_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          status: 'done' | 'error';\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            steps: existing.steps.map((step) =>\n              step.id === payload.stepId\n                ? {\n                    ...step,\n                    status: payload.status,\n                    resultPreview: payload.resultPreview,\n                    error: payload.error,\n                    completedAtMs: event.createdAtMs,\n                  }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'agent_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          status: WorkflowAgentStatus;\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: payload.status,\n            currentStep: undefined,\n            resultPreview: payload.resultPreview,\n            error: payload.error,\n            transcriptMessageCount: existing.transcriptMessageCount + 1,\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'log_appended': {\n        const payload = event.payload as { message: string };\n        logs.push({ sequence: event.sequence, message: payload.message, createdAtMs: event.createdAtMs });\n        break;\n      }\n      case 'artifact_created': {\n        const payload = event.payload as { artifact: WorkflowArtifactRef };\n        artifacts.push(payload.artifact);\n        run.metrics.artifactCount = artifacts.length;\n        break;\n      }\n      case 'run_completed': {\n        const payload = event.payload as { result: WorkflowRun['result'] };\n        run.status = 'succeeded';\n        run.result = payload.result;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_failed': {\n        const payload = event.payload as { error: WorkflowRun['error'] };\n        run.status = payload.error?.code === 'timeout' ? 'timeout' : 'failed';\n        run.error = payload.error;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_cancelled': {\n        run.status = 'cancelled';\n        run.completedAtMs = event.createdAtMs;\n        for (const [agentId, agent] of agentIdToAgent) {\n          if (agent.status !== 'queued' && agent.status !== 'running') {\n            continue;\n          }\n          agentIdToAgent.set(agentId, {\n            ...agent,\n            status: 'skipped',\n            currentStep: undefined,\n            completedAtMs: event.createdAtMs,\n            steps: agent.steps.map((step) =>\n              step.status === 'running'\n                ? { ...step, status: 'error', completedAtMs: event.createdAtMs }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'run_queued':\n      default:\n        break;\n    }\n  }\n\n  const agents = [...agentIdToAgent.values()];\n  run.metrics.agentCount = agents.length;\n  run.metrics.doneAgentCount = agents.filter((agent) => agent.status === 'done').length;\n  run.metrics.errorAgentCount = agents.filter((agent) => agent.status === 'error').length;\n  run.metrics.skippedAgentCount = agents.filter((agent) => agent.status === 'skipped').length;\n  run.metrics.artifactCount = artifacts.length;\n  if (run.startedAtMs && run.completedAtMs) {\n    run.metrics.durationMs = run.completedAtMs - run.startedAtMs;\n  }\n\n  const phases = [...phaseIdToPhase.values()].map((phase) => {\n    if (phase.status === 'completed' || phase.status === 'failed') {\n      return phase;\n    }\n    const phaseAgents = phase.agentIds\n      .map((agentId) => agentIdToAgent.get(agentId)?.status)\n      .filter((status): status is WorkflowAgentStatus => Boolean(status));\n    return { ...phase, status: phaseStatusAfterAgentStatus(phaseAgents) };\n  });\n\n  return {\n    run,\n    phases,\n    agents,\n    logs,\n    artifacts,\n    timeline,\n    controls: {\n      canCancel: !terminalRunStatus(run.status),\n      canRetry: terminalRunStatus(run.status),\n      canArchive: terminalRunStatus(run.status),\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/workflows/engine/workflow-engine.d.ts

@@ -1,8 +1,9 @@
 import type { WorkflowDefinition } from '../domain/definition.js';
 import type { WorkflowEventEnvelope } from '../domain/event.js';
-import type { WorkflowRunMetadata, WorkflowRunSource, WorkflowRunView } from '../domain/run.js';
+import type { WorkflowRun, WorkflowRunMetadata, WorkflowRunSource, WorkflowRunView } from '../domain/run.js';
 import { WorkflowEventStore } from '../store/event-store.js';
 import { WorkflowRunStore } from '../store/run-store.js';
+import type { WorkflowRuntime } from '../runtime/workflow-runtime-port.js';
 import type { Api, Model } from '@earendil-works/pi-ai';
 import type { WorkflowScriptSubagentRunner } from '../runtime/script-runtime.js';
 export interface WorkflowEngineOptions {
@@ -10,10 +11,44 @@ export interface WorkflowEngineOptions {
     eventStore: WorkflowEventStore;
     runStore: WorkflowRunStore;
     runner: WorkflowScriptSubagentRunner;
+    runtime?: WorkflowRuntime;
+    hooks?: WorkflowEngineHook[];
+    subagentSessionKeyFactory?: (ctx: {
+        runId: string;
+        agentId: string;
+    }) => string;
+    parentSessionKey?: string;
     onEventAppended?: (event: WorkflowEventEnvelope) => void;
     onRunViewUpdated?: (view: WorkflowRunView) => void;
     resolveModelId?: (modelId: string) => Model<Api>;
 }
+export interface WorkflowEngineHook {
+    beforeRun?(ctx: WorkflowRunHookContext): Promise<void> | void;
+    beforeAgent?(ctx: WorkflowAgentHookContext): Promise<void> | void;
+    afterAgent?(ctx: WorkflowAgentCompletedHookContext): Promise<void> | void;
+    afterRun?(ctx: WorkflowRunCompletedHookContext): Promise<void> | void;
+}
+export interface WorkflowRunHookContext {
+    definition: WorkflowDefinition;
+    run: WorkflowRun;
+}
+export interface WorkflowAgentHookContext {
+    runId: string;
+    agentId: string;
+    label: string;
+    phaseId?: string;
+    prompt: string;
+}
+export interface WorkflowAgentCompletedHookContext {
+    runId: string;
+    agentId: string;
+    status: 'done' | 'error' | 'skipped';
+    resultPreview?: string;
+}
+export interface WorkflowRunCompletedHookContext {
+    runId: string;
+    status: 'succeeded' | 'failed' | 'cancelled';
+}
 export interface StartWorkflowRunOptions {
     input?: unknown;
     source: WorkflowRunSource;
@@ -29,4 +64,5 @@ export declare class WorkflowEngine {
     private readonly options;
     constructor(options: WorkflowEngineOptions);
     startRun(definition: WorkflowDefinition, options: StartWorkflowRunOptions): Promise<WorkflowRunView>;
+    private callHooks;
 }