@agimon-ai/po-workflow 0.0.0-alpha.0

package/dist/index.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_workflowLaunchCommand = require("./workflowLaunchCommand-C69Nn3k5.cjs");
+exports.parseWorkflowLaunchCommand = require_workflowLaunchCommand.parseWorkflowLaunchCommand;
+exports.validateWorkflowLaunch = require_workflowLaunchCommand.validateWorkflowLaunch;

package/dist/index.d.mts

@@ -0,0 +1,59 @@
+//#region src/services/workflowLaunchCommand/index.d.ts
+/**
+ * The `/workflow-launch` line, parsed.
+ *
+ * WHY A VERB AT ALL:
+ * A browser can only send a session a prompt frame, so every cockpit action
+ * that has to run inside the session travels as a slash line, the way the
+ * agent catalog sends `/run`. The workflow tools answer to the agent, not to a
+ * page, and the leader board answers to a keyboard, so neither of them can be
+ * what the launch dialog sends.
+ *
+ * THE SHAPE:
+ *   /workflow-launch <workflow> [key=value ...] [prompt words]
+ *
+ * Key-value pairs come first and stop at the first token that is not one, so
+ * everything after them is the prompt exactly as it was typed, including any
+ * `=` inside it. `runner`, `command` and `choice` are reserved keys; the rest
+ * are the workflow's own `workflow_dispatch` inputs. Values may be double
+ * quoted to hold spaces.
+ */
+interface ParsedWorkflowLaunch {
+  /** The workflow's name or its path, as typed; resolution belongs to the caller. */
+  workflow: string;
+  runner?: string;
+  command?: string;
+  choice?: string;
+  inputs: Record<string, string>;
+  prompt?: string;
+}
+interface WorkflowLaunchParseFailure {
+  error: string;
+}
+export declare function parseWorkflowLaunchCommand(args: string): ParsedWorkflowLaunch | WorkflowLaunchParseFailure;
+/** What a workflow declares, as much of it as a launch has to satisfy. */
+interface LaunchRequirements {
+  triggers: readonly string[];
+  inputs: readonly {
+    name: string;
+    required?: boolean;
+    options?: readonly string[];
+  }[];
+  /** Absent means the workflow names no runner map, so any runner will do. */
+  runners?: readonly string[];
+  /** Commands every templated step offers; absent when no step is templated. */
+  commands?: readonly string[];
+  /** Declared model choices. */
+  choices?: readonly string[];
+}
+/**
+ * Everything wrong with a launch, before it is started.
+ *
+ * Checked here rather than left to the engine because the failure would
+ * otherwise be a run that starts and then waits forever for terminal input, or
+ * one that dies on a runner its steps never declared. Both read as the launch
+ * having worked.
+ */
+export declare function validateWorkflowLaunch(requirements: LaunchRequirements, parsed: Pick<ParsedWorkflowLaunch, 'inputs' | 'prompt' | 'runner' | 'command' | 'choice'>): string[];
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/services/workflowLaunchCommand/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;UA4BiB;;EAEf;EACA;EACA;EACA;EACA,QAAQ;EACR;;UAGe;EACf;;wBAsCc,2BAA2B,eAAe,uBAAuB;;UAmEhE;EACf;EACA;IAAmB;IAAc;IAAoB;;;EAErD;;EAEA;;EAEA;;;;;;;;;;wBAcc,uBACd,cAAc,oBACd,QAAQ,KAAK"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { r as validateWorkflowLaunch, t as parseWorkflowLaunchCommand } from "./workflowLaunchCommand-GGqimmTC.mjs";
+export { parseWorkflowLaunchCommand, validateWorkflowLaunch };

package/dist/workflowLaunchCommand-C69Nn3k5.cjs

@@ -0,0 +1,139 @@
+//#region src/services/workflowLaunchCommand/index.ts
+/**
+* The `/workflow-launch` line, parsed.
+*
+* WHY A VERB AT ALL:
+* A browser can only send a session a prompt frame, so every cockpit action
+* that has to run inside the session travels as a slash line, the way the
+* agent catalog sends `/run`. The workflow tools answer to the agent, not to a
+* page, and the leader board answers to a keyboard, so neither of them can be
+* what the launch dialog sends.
+*
+* THE SHAPE:
+*   /workflow-launch <workflow> [key=value ...] [prompt words]
+*
+* Key-value pairs come first and stop at the first token that is not one, so
+* everything after them is the prompt exactly as it was typed, including any
+* `=` inside it. `runner`, `command` and `choice` are reserved keys; the rest
+* are the workflow's own `workflow_dispatch` inputs. Values may be double
+* quoted to hold spaces.
+*/
+/** Reserved key: which runner map entry the run executes with. */
+const RUNNER_KEY = "runner";
+/** Reserved key: which command templated steps run through. */
+const COMMAND_KEY = "command";
+/** Reserved key: which model choice steps without their own run with. */
+const CHOICE_KEY = "choice";
+const KEY_VALUE = /^([A-Za-z_][\w.-]*)=(.*)$/s;
+/** Strips one layer of surrounding double quotes, which is how a value holds spaces. */
+function unquote(value) {
+	return value.length > 1 && value.startsWith("\"") && value.endsWith("\"") ? value.slice(1, -1) : value;
+}
+/**
+* Splits on whitespace, keeping double-quoted runs together.
+*
+* Returns each token with the offset it started at, so the caller can take the
+* rest of the line verbatim rather than rebuilding it from tokens and losing
+* the spacing a prompt was written with.
+*/
+function tokenize(line) {
+	const tokens = [];
+	let index = 0;
+	while (index < line.length) {
+		while (index < line.length && /\s/.test(line[index])) index += 1;
+		if (index >= line.length) break;
+		const start = index;
+		let quoted = false;
+		while (index < line.length && (quoted || !/\s/.test(line[index]))) {
+			if (line[index] === "\"") quoted = !quoted;
+			index += 1;
+		}
+		tokens.push({
+			text: line.slice(start, index),
+			start
+		});
+	}
+	return tokens;
+}
+function parseWorkflowLaunchCommand(args) {
+	const tokens = tokenize(args.trim());
+	const first = tokens[0];
+	if (first === void 0) return { error: "Usage: /workflow-launch <workflow> [key=value …] [prompt]" };
+	const inputs = {};
+	const reserved = {};
+	let index = 1;
+	for (; index < tokens.length; index += 1) {
+		const token = tokens[index];
+		const match = KEY_VALUE.exec(token.text);
+		if (!match) break;
+		const key = match[1];
+		const value = unquote(match[2]);
+		if (key === RUNNER_KEY || key === COMMAND_KEY || key === CHOICE_KEY) reserved[key] = value;
+		else inputs[key] = value;
+	}
+	const rest = tokens[index];
+	const prompt = rest === void 0 ? void 0 : args.trim().slice(rest.start).trim();
+	return {
+		workflow: unquote(first.text),
+		...reserved,
+		inputs,
+		...prompt === void 0 || prompt === "" ? {} : { prompt }
+	};
+}
+/**
+* The workflow a token names: its name, its path in the repository, or the
+* tail of that path. Case-insensitive on the name, because the catalog shows
+* names as their author capitalised them and nobody types that back exactly.
+*/
+function resolveWorkflowEntry(entries, token) {
+	const needle = token.trim();
+	const lower = needle.toLocaleLowerCase();
+	return entries.find((entry) => entry.name.toLocaleLowerCase() === lower) ?? entries.find((entry) => entry.relativePath === needle || entry.path === needle) ?? entries.find((entry) => entry.relativePath.endsWith(`/${needle}`) || entry.path.endsWith(`/${needle}`));
+}
+/** The trigger that makes a prompt mandatory: the run waits for one otherwise. */
+const USER_PROMPT_TRIGGER = "user_prompt";
+/**
+* Everything wrong with a launch, before it is started.
+*
+* Checked here rather than left to the engine because the failure would
+* otherwise be a run that starts and then waits forever for terminal input, or
+* one that dies on a runner its steps never declared. Both read as the launch
+* having worked.
+*/
+function validateWorkflowLaunch(requirements, parsed) {
+	const problems = [];
+	if (requirements.triggers.includes(USER_PROMPT_TRIGGER) && (parsed.prompt ?? "") === "") problems.push("This workflow is triggered by a prompt, so it needs one.");
+	const missing = requirements.inputs.filter((input) => input.required === true && (parsed.inputs[input.name] ?? "") === "").map((input) => input.name);
+	if (missing.length > 0) problems.push(`Missing required input${missing.length > 1 ? "s" : ""}: ${missing.join(", ")}.`);
+	for (const input of requirements.inputs) {
+		const value = parsed.inputs[input.name];
+		if (value === void 0 || input.options === void 0 || input.options.includes(value)) continue;
+		problems.push(`Input ${input.name} must be one of: ${input.options.join(", ")}.`);
+	}
+	const declared = requirements.runners;
+	if (parsed.runner !== void 0 && declared !== void 0 && !declared.includes(parsed.runner)) problems.push(declared.length === 0 ? "This workflow declares no runner its steps agree on." : `Runner ${parsed.runner} is not one this workflow declares: ${declared.join(", ")}.`);
+	if (parsed.command !== void 0 && !(requirements.commands ?? []).includes(parsed.command)) problems.push(requirements.commands === void 0 || requirements.commands.length === 0 ? "This workflow has no templated steps to run through a command." : `Command ${parsed.command} is not one every step offers: ${requirements.commands.join(", ")}.`);
+	if (parsed.choice !== void 0 && !(requirements.choices ?? []).includes(parsed.choice)) problems.push(`Choice ${parsed.choice} is not declared${requirements.choices?.length ? `: ${requirements.choices.join(", ")}` : ""}.`);
+	return problems;
+}
+//#endregion
+Object.defineProperty(exports, "parseWorkflowLaunchCommand", {
+	enumerable: true,
+	get: function() {
+		return parseWorkflowLaunchCommand;
+	}
+});
+Object.defineProperty(exports, "resolveWorkflowEntry", {
+	enumerable: true,
+	get: function() {
+		return resolveWorkflowEntry;
+	}
+});
+Object.defineProperty(exports, "validateWorkflowLaunch", {
+	enumerable: true,
+	get: function() {
+		return validateWorkflowLaunch;
+	}
+});
+
+//# sourceMappingURL=workflowLaunchCommand-C69Nn3k5.cjs.map

package/dist/workflowLaunchCommand-C69Nn3k5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowLaunchCommand-C69Nn3k5.cjs","names":[],"sources":["../src/services/workflowLaunchCommand/index.ts"],"sourcesContent":["/**\n * The `/workflow-launch` line, parsed.\n *\n * WHY A VERB AT ALL:\n * A browser can only send a session a prompt frame, so every cockpit action\n * that has to run inside the session travels as a slash line, the way the\n * agent catalog sends `/run`. The workflow tools answer to the agent, not to a\n * page, and the leader board answers to a keyboard, so neither of them can be\n * what the launch dialog sends.\n *\n * THE SHAPE:\n *   /workflow-launch <workflow> [key=value ...] [prompt words]\n *\n * Key-value pairs come first and stop at the first token that is not one, so\n * everything after them is the prompt exactly as it was typed, including any\n * `=` inside it. `runner`, `command` and `choice` are reserved keys; the rest\n * are the workflow's own `workflow_dispatch` inputs. Values may be double\n * quoted to hold spaces.\n */\n\n/** Reserved key: which runner map entry the run executes with. */\nconst RUNNER_KEY = 'runner';\n/** Reserved key: which command templated steps run through. */\nconst COMMAND_KEY = 'command';\n/** Reserved key: which model choice steps without their own run with. */\nconst CHOICE_KEY = 'choice';\nconst KEY_VALUE = /^([A-Za-z_][\\w.-]*)=(.*)$/s;\n\nexport interface ParsedWorkflowLaunch {\n  /** The workflow's name or its path, as typed; resolution belongs to the caller. */\n  workflow: string;\n  runner?: string;\n  command?: string;\n  choice?: string;\n  inputs: Record<string, string>;\n  prompt?: string;\n}\n\nexport interface WorkflowLaunchParseFailure {\n  error: string;\n}\n\nexport function isLaunchParseFailure(\n  value: ParsedWorkflowLaunch | WorkflowLaunchParseFailure,\n): value is WorkflowLaunchParseFailure {\n  return 'error' in value;\n}\n\n/** Strips one layer of surrounding double quotes, which is how a value holds spaces. */\nfunction unquote(value: string): string {\n  return value.length > 1 && value.startsWith('\"') && value.endsWith('\"') ? value.slice(1, -1) : value;\n}\n\n/**\n * Splits on whitespace, keeping double-quoted runs together.\n *\n * Returns each token with the offset it started at, so the caller can take the\n * rest of the line verbatim rather than rebuilding it from tokens and losing\n * the spacing a prompt was written with.\n */\nfunction tokenize(line: string): { text: string; start: number }[] {\n  const tokens: { text: string; start: number }[] = [];\n  let index = 0;\n  while (index < line.length) {\n    while (index < line.length && /\\s/.test(line[index] as string)) index += 1;\n    if (index >= line.length) break;\n    const start = index;\n    let quoted = false;\n    while (index < line.length && (quoted || !/\\s/.test(line[index] as string))) {\n      if (line[index] === '\"') quoted = !quoted;\n      index += 1;\n    }\n    tokens.push({ text: line.slice(start, index), start });\n  }\n  return tokens;\n}\n\nexport function parseWorkflowLaunchCommand(args: string): ParsedWorkflowLaunch | WorkflowLaunchParseFailure {\n  const tokens = tokenize(args.trim());\n  const first = tokens[0];\n  if (first === undefined) return { error: 'Usage: /workflow-launch <workflow> [key=value …] [prompt]' };\n\n  const inputs: Record<string, string> = {};\n  const reserved: { runner?: string; command?: string; choice?: string } = {};\n  let index = 1;\n  for (; index < tokens.length; index += 1) {\n    const token = tokens[index] as { text: string; start: number };\n    const match = KEY_VALUE.exec(token.text);\n    if (!match) break;\n    const key = match[1] as string;\n    const value = unquote(match[2] as string);\n    if (key === RUNNER_KEY || key === COMMAND_KEY || key === CHOICE_KEY) reserved[key] = value;\n    else inputs[key] = value;\n  }\n\n  const rest = tokens[index];\n  const prompt = rest === undefined ? undefined : args.trim().slice(rest.start).trim();\n  return {\n    workflow: unquote(first.text),\n    ...reserved,\n    inputs,\n    ...(prompt === undefined || prompt === '' ? {} : { prompt }),\n  };\n}\n\n/** The line the cockpit sends, built from what its dialog collected. */\nexport function workflowLaunchCommand(request: ParsedWorkflowLaunch): string {\n  const quote = (value: string): string => (/\\s/.test(value) ? `\"${value}\"` : value);\n  const pairs = [\n    ...(request.runner === undefined ? [] : [`${RUNNER_KEY}=${quote(request.runner)}`]),\n    ...(request.command === undefined ? [] : [`${COMMAND_KEY}=${quote(request.command)}`]),\n    ...(request.choice === undefined ? [] : [`${CHOICE_KEY}=${quote(request.choice)}`]),\n    ...Object.entries(request.inputs).map(([key, value]) => `${key}=${quote(value)}`),\n  ];\n  const prompt = request.prompt?.trim();\n  return ['/workflow-launch', quote(request.workflow), ...pairs, ...(prompt ? [prompt] : [])].join(' ');\n}\n\n/** One catalog row, as much of it as resolution needs. */\nexport interface LaunchResolvableWorkflow {\n  name: string;\n  path: string;\n  relativePath: string;\n}\n\n/**\n * The workflow a token names: its name, its path in the repository, or the\n * tail of that path. Case-insensitive on the name, because the catalog shows\n * names as their author capitalised them and nobody types that back exactly.\n */\nexport function resolveWorkflowEntry<T extends LaunchResolvableWorkflow>(\n  entries: readonly T[],\n  token: string,\n): T | undefined {\n  const needle = token.trim();\n  const lower = needle.toLocaleLowerCase();\n  return (\n    entries.find((entry) => entry.name.toLocaleLowerCase() === lower) ??\n    entries.find((entry) => entry.relativePath === needle || entry.path === needle) ??\n    entries.find((entry) => entry.relativePath.endsWith(`/${needle}`) || entry.path.endsWith(`/${needle}`))\n  );\n}\n\n/** What a workflow declares, as much of it as a launch has to satisfy. */\nexport interface LaunchRequirements {\n  triggers: readonly string[];\n  inputs: readonly { name: string; required?: boolean; options?: readonly string[] }[];\n  /** Absent means the workflow names no runner map, so any runner will do. */\n  runners?: readonly string[];\n  /** Commands every templated step offers; absent when no step is templated. */\n  commands?: readonly string[];\n  /** Declared model choices. */\n  choices?: readonly string[];\n}\n\n/** The trigger that makes a prompt mandatory: the run waits for one otherwise. */\nconst USER_PROMPT_TRIGGER = 'user_prompt';\n\n/**\n * Everything wrong with a launch, before it is started.\n *\n * Checked here rather than left to the engine because the failure would\n * otherwise be a run that starts and then waits forever for terminal input, or\n * one that dies on a runner its steps never declared. Both read as the launch\n * having worked.\n */\nexport function validateWorkflowLaunch(\n  requirements: LaunchRequirements,\n  parsed: Pick<ParsedWorkflowLaunch, 'inputs' | 'prompt' | 'runner' | 'command' | 'choice'>,\n): string[] {\n  const problems: string[] = [];\n  if (requirements.triggers.includes(USER_PROMPT_TRIGGER) && (parsed.prompt ?? '') === '') {\n    problems.push('This workflow is triggered by a prompt, so it needs one.');\n  }\n  const missing = requirements.inputs\n    .filter((input) => input.required === true && (parsed.inputs[input.name] ?? '') === '')\n    .map((input) => input.name);\n  if (missing.length > 0)\n    problems.push(`Missing required input${missing.length > 1 ? 's' : ''}: ${missing.join(', ')}.`);\n  for (const input of requirements.inputs) {\n    const value = parsed.inputs[input.name];\n    if (value === undefined || input.options === undefined || input.options.includes(value)) continue;\n    problems.push(`Input ${input.name} must be one of: ${input.options.join(', ')}.`);\n  }\n  const declared = requirements.runners;\n  if (parsed.runner !== undefined && declared !== undefined && !declared.includes(parsed.runner)) {\n    problems.push(\n      declared.length === 0\n        ? 'This workflow declares no runner its steps agree on.'\n        : `Runner ${parsed.runner} is not one this workflow declares: ${declared.join(', ')}.`,\n    );\n  }\n  if (parsed.command !== undefined && !(requirements.commands ?? []).includes(parsed.command)) {\n    problems.push(\n      requirements.commands === undefined || requirements.commands.length === 0\n        ? 'This workflow has no templated steps to run through a command.'\n        : `Command ${parsed.command} is not one every step offers: ${requirements.commands.join(', ')}.`,\n    );\n  }\n  if (parsed.choice !== undefined && !(requirements.choices ?? []).includes(parsed.choice)) {\n    problems.push(\n      `Choice ${parsed.choice} is not declared${requirements.choices?.length ? `: ${requirements.choices.join(', ')}` : ''}.`,\n    );\n  }\n  return problems;\n}\n"],"mappings":"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"}

package/dist/workflowLaunchCommand-GGqimmTC.mjs

@@ -0,0 +1,122 @@
+//#region src/services/workflowLaunchCommand/index.ts
+/**
+* The `/workflow-launch` line, parsed.
+*
+* WHY A VERB AT ALL:
+* A browser can only send a session a prompt frame, so every cockpit action
+* that has to run inside the session travels as a slash line, the way the
+* agent catalog sends `/run`. The workflow tools answer to the agent, not to a
+* page, and the leader board answers to a keyboard, so neither of them can be
+* what the launch dialog sends.
+*
+* THE SHAPE:
+*   /workflow-launch <workflow> [key=value ...] [prompt words]
+*
+* Key-value pairs come first and stop at the first token that is not one, so
+* everything after them is the prompt exactly as it was typed, including any
+* `=` inside it. `runner`, `command` and `choice` are reserved keys; the rest
+* are the workflow's own `workflow_dispatch` inputs. Values may be double
+* quoted to hold spaces.
+*/
+/** Reserved key: which runner map entry the run executes with. */
+const RUNNER_KEY = "runner";
+/** Reserved key: which command templated steps run through. */
+const COMMAND_KEY = "command";
+/** Reserved key: which model choice steps without their own run with. */
+const CHOICE_KEY = "choice";
+const KEY_VALUE = /^([A-Za-z_][\w.-]*)=(.*)$/s;
+/** Strips one layer of surrounding double quotes, which is how a value holds spaces. */
+function unquote(value) {
+	return value.length > 1 && value.startsWith("\"") && value.endsWith("\"") ? value.slice(1, -1) : value;
+}
+/**
+* Splits on whitespace, keeping double-quoted runs together.
+*
+* Returns each token with the offset it started at, so the caller can take the
+* rest of the line verbatim rather than rebuilding it from tokens and losing
+* the spacing a prompt was written with.
+*/
+function tokenize(line) {
+	const tokens = [];
+	let index = 0;
+	while (index < line.length) {
+		while (index < line.length && /\s/.test(line[index])) index += 1;
+		if (index >= line.length) break;
+		const start = index;
+		let quoted = false;
+		while (index < line.length && (quoted || !/\s/.test(line[index]))) {
+			if (line[index] === "\"") quoted = !quoted;
+			index += 1;
+		}
+		tokens.push({
+			text: line.slice(start, index),
+			start
+		});
+	}
+	return tokens;
+}
+function parseWorkflowLaunchCommand(args) {
+	const tokens = tokenize(args.trim());
+	const first = tokens[0];
+	if (first === void 0) return { error: "Usage: /workflow-launch <workflow> [key=value …] [prompt]" };
+	const inputs = {};
+	const reserved = {};
+	let index = 1;
+	for (; index < tokens.length; index += 1) {
+		const token = tokens[index];
+		const match = KEY_VALUE.exec(token.text);
+		if (!match) break;
+		const key = match[1];
+		const value = unquote(match[2]);
+		if (key === RUNNER_KEY || key === COMMAND_KEY || key === CHOICE_KEY) reserved[key] = value;
+		else inputs[key] = value;
+	}
+	const rest = tokens[index];
+	const prompt = rest === void 0 ? void 0 : args.trim().slice(rest.start).trim();
+	return {
+		workflow: unquote(first.text),
+		...reserved,
+		inputs,
+		...prompt === void 0 || prompt === "" ? {} : { prompt }
+	};
+}
+/**
+* The workflow a token names: its name, its path in the repository, or the
+* tail of that path. Case-insensitive on the name, because the catalog shows
+* names as their author capitalised them and nobody types that back exactly.
+*/
+function resolveWorkflowEntry(entries, token) {
+	const needle = token.trim();
+	const lower = needle.toLocaleLowerCase();
+	return entries.find((entry) => entry.name.toLocaleLowerCase() === lower) ?? entries.find((entry) => entry.relativePath === needle || entry.path === needle) ?? entries.find((entry) => entry.relativePath.endsWith(`/${needle}`) || entry.path.endsWith(`/${needle}`));
+}
+/** The trigger that makes a prompt mandatory: the run waits for one otherwise. */
+const USER_PROMPT_TRIGGER = "user_prompt";
+/**
+* Everything wrong with a launch, before it is started.
+*
+* Checked here rather than left to the engine because the failure would
+* otherwise be a run that starts and then waits forever for terminal input, or
+* one that dies on a runner its steps never declared. Both read as the launch
+* having worked.
+*/
+function validateWorkflowLaunch(requirements, parsed) {
+	const problems = [];
+	if (requirements.triggers.includes(USER_PROMPT_TRIGGER) && (parsed.prompt ?? "") === "") problems.push("This workflow is triggered by a prompt, so it needs one.");
+	const missing = requirements.inputs.filter((input) => input.required === true && (parsed.inputs[input.name] ?? "") === "").map((input) => input.name);
+	if (missing.length > 0) problems.push(`Missing required input${missing.length > 1 ? "s" : ""}: ${missing.join(", ")}.`);
+	for (const input of requirements.inputs) {
+		const value = parsed.inputs[input.name];
+		if (value === void 0 || input.options === void 0 || input.options.includes(value)) continue;
+		problems.push(`Input ${input.name} must be one of: ${input.options.join(", ")}.`);
+	}
+	const declared = requirements.runners;
+	if (parsed.runner !== void 0 && declared !== void 0 && !declared.includes(parsed.runner)) problems.push(declared.length === 0 ? "This workflow declares no runner its steps agree on." : `Runner ${parsed.runner} is not one this workflow declares: ${declared.join(", ")}.`);
+	if (parsed.command !== void 0 && !(requirements.commands ?? []).includes(parsed.command)) problems.push(requirements.commands === void 0 || requirements.commands.length === 0 ? "This workflow has no templated steps to run through a command." : `Command ${parsed.command} is not one every step offers: ${requirements.commands.join(", ")}.`);
+	if (parsed.choice !== void 0 && !(requirements.choices ?? []).includes(parsed.choice)) problems.push(`Choice ${parsed.choice} is not declared${requirements.choices?.length ? `: ${requirements.choices.join(", ")}` : ""}.`);
+	return problems;
+}
+//#endregion
+export { resolveWorkflowEntry as n, validateWorkflowLaunch as r, parseWorkflowLaunchCommand as t };
+
+//# sourceMappingURL=workflowLaunchCommand-GGqimmTC.mjs.map

package/dist/workflowLaunchCommand-GGqimmTC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowLaunchCommand-GGqimmTC.mjs","names":[],"sources":["../src/services/workflowLaunchCommand/index.ts"],"sourcesContent":["/**\n * The `/workflow-launch` line, parsed.\n *\n * WHY A VERB AT ALL:\n * A browser can only send a session a prompt frame, so every cockpit action\n * that has to run inside the session travels as a slash line, the way the\n * agent catalog sends `/run`. The workflow tools answer to the agent, not to a\n * page, and the leader board answers to a keyboard, so neither of them can be\n * what the launch dialog sends.\n *\n * THE SHAPE:\n *   /workflow-launch <workflow> [key=value ...] [prompt words]\n *\n * Key-value pairs come first and stop at the first token that is not one, so\n * everything after them is the prompt exactly as it was typed, including any\n * `=` inside it. `runner`, `command` and `choice` are reserved keys; the rest\n * are the workflow's own `workflow_dispatch` inputs. Values may be double\n * quoted to hold spaces.\n */\n\n/** Reserved key: which runner map entry the run executes with. */\nconst RUNNER_KEY = 'runner';\n/** Reserved key: which command templated steps run through. */\nconst COMMAND_KEY = 'command';\n/** Reserved key: which model choice steps without their own run with. */\nconst CHOICE_KEY = 'choice';\nconst KEY_VALUE = /^([A-Za-z_][\\w.-]*)=(.*)$/s;\n\nexport interface ParsedWorkflowLaunch {\n  /** The workflow's name or its path, as typed; resolution belongs to the caller. */\n  workflow: string;\n  runner?: string;\n  command?: string;\n  choice?: string;\n  inputs: Record<string, string>;\n  prompt?: string;\n}\n\nexport interface WorkflowLaunchParseFailure {\n  error: string;\n}\n\nexport function isLaunchParseFailure(\n  value: ParsedWorkflowLaunch | WorkflowLaunchParseFailure,\n): value is WorkflowLaunchParseFailure {\n  return 'error' in value;\n}\n\n/** Strips one layer of surrounding double quotes, which is how a value holds spaces. */\nfunction unquote(value: string): string {\n  return value.length > 1 && value.startsWith('\"') && value.endsWith('\"') ? value.slice(1, -1) : value;\n}\n\n/**\n * Splits on whitespace, keeping double-quoted runs together.\n *\n * Returns each token with the offset it started at, so the caller can take the\n * rest of the line verbatim rather than rebuilding it from tokens and losing\n * the spacing a prompt was written with.\n */\nfunction tokenize(line: string): { text: string; start: number }[] {\n  const tokens: { text: string; start: number }[] = [];\n  let index = 0;\n  while (index < line.length) {\n    while (index < line.length && /\\s/.test(line[index] as string)) index += 1;\n    if (index >= line.length) break;\n    const start = index;\n    let quoted = false;\n    while (index < line.length && (quoted || !/\\s/.test(line[index] as string))) {\n      if (line[index] === '\"') quoted = !quoted;\n      index += 1;\n    }\n    tokens.push({ text: line.slice(start, index), start });\n  }\n  return tokens;\n}\n\nexport function parseWorkflowLaunchCommand(args: string): ParsedWorkflowLaunch | WorkflowLaunchParseFailure {\n  const tokens = tokenize(args.trim());\n  const first = tokens[0];\n  if (first === undefined) return { error: 'Usage: /workflow-launch <workflow> [key=value …] [prompt]' };\n\n  const inputs: Record<string, string> = {};\n  const reserved: { runner?: string; command?: string; choice?: string } = {};\n  let index = 1;\n  for (; index < tokens.length; index += 1) {\n    const token = tokens[index] as { text: string; start: number };\n    const match = KEY_VALUE.exec(token.text);\n    if (!match) break;\n    const key = match[1] as string;\n    const value = unquote(match[2] as string);\n    if (key === RUNNER_KEY || key === COMMAND_KEY || key === CHOICE_KEY) reserved[key] = value;\n    else inputs[key] = value;\n  }\n\n  const rest = tokens[index];\n  const prompt = rest === undefined ? undefined : args.trim().slice(rest.start).trim();\n  return {\n    workflow: unquote(first.text),\n    ...reserved,\n    inputs,\n    ...(prompt === undefined || prompt === '' ? {} : { prompt }),\n  };\n}\n\n/** The line the cockpit sends, built from what its dialog collected. */\nexport function workflowLaunchCommand(request: ParsedWorkflowLaunch): string {\n  const quote = (value: string): string => (/\\s/.test(value) ? `\"${value}\"` : value);\n  const pairs = [\n    ...(request.runner === undefined ? [] : [`${RUNNER_KEY}=${quote(request.runner)}`]),\n    ...(request.command === undefined ? [] : [`${COMMAND_KEY}=${quote(request.command)}`]),\n    ...(request.choice === undefined ? [] : [`${CHOICE_KEY}=${quote(request.choice)}`]),\n    ...Object.entries(request.inputs).map(([key, value]) => `${key}=${quote(value)}`),\n  ];\n  const prompt = request.prompt?.trim();\n  return ['/workflow-launch', quote(request.workflow), ...pairs, ...(prompt ? [prompt] : [])].join(' ');\n}\n\n/** One catalog row, as much of it as resolution needs. */\nexport interface LaunchResolvableWorkflow {\n  name: string;\n  path: string;\n  relativePath: string;\n}\n\n/**\n * The workflow a token names: its name, its path in the repository, or the\n * tail of that path. Case-insensitive on the name, because the catalog shows\n * names as their author capitalised them and nobody types that back exactly.\n */\nexport function resolveWorkflowEntry<T extends LaunchResolvableWorkflow>(\n  entries: readonly T[],\n  token: string,\n): T | undefined {\n  const needle = token.trim();\n  const lower = needle.toLocaleLowerCase();\n  return (\n    entries.find((entry) => entry.name.toLocaleLowerCase() === lower) ??\n    entries.find((entry) => entry.relativePath === needle || entry.path === needle) ??\n    entries.find((entry) => entry.relativePath.endsWith(`/${needle}`) || entry.path.endsWith(`/${needle}`))\n  );\n}\n\n/** What a workflow declares, as much of it as a launch has to satisfy. */\nexport interface LaunchRequirements {\n  triggers: readonly string[];\n  inputs: readonly { name: string; required?: boolean; options?: readonly string[] }[];\n  /** Absent means the workflow names no runner map, so any runner will do. */\n  runners?: readonly string[];\n  /** Commands every templated step offers; absent when no step is templated. */\n  commands?: readonly string[];\n  /** Declared model choices. */\n  choices?: readonly string[];\n}\n\n/** The trigger that makes a prompt mandatory: the run waits for one otherwise. */\nconst USER_PROMPT_TRIGGER = 'user_prompt';\n\n/**\n * Everything wrong with a launch, before it is started.\n *\n * Checked here rather than left to the engine because the failure would\n * otherwise be a run that starts and then waits forever for terminal input, or\n * one that dies on a runner its steps never declared. Both read as the launch\n * having worked.\n */\nexport function validateWorkflowLaunch(\n  requirements: LaunchRequirements,\n  parsed: Pick<ParsedWorkflowLaunch, 'inputs' | 'prompt' | 'runner' | 'command' | 'choice'>,\n): string[] {\n  const problems: string[] = [];\n  if (requirements.triggers.includes(USER_PROMPT_TRIGGER) && (parsed.prompt ?? '') === '') {\n    problems.push('This workflow is triggered by a prompt, so it needs one.');\n  }\n  const missing = requirements.inputs\n    .filter((input) => input.required === true && (parsed.inputs[input.name] ?? '') === '')\n    .map((input) => input.name);\n  if (missing.length > 0)\n    problems.push(`Missing required input${missing.length > 1 ? 's' : ''}: ${missing.join(', ')}.`);\n  for (const input of requirements.inputs) {\n    const value = parsed.inputs[input.name];\n    if (value === undefined || input.options === undefined || input.options.includes(value)) continue;\n    problems.push(`Input ${input.name} must be one of: ${input.options.join(', ')}.`);\n  }\n  const declared = requirements.runners;\n  if (parsed.runner !== undefined && declared !== undefined && !declared.includes(parsed.runner)) {\n    problems.push(\n      declared.length === 0\n        ? 'This workflow declares no runner its steps agree on.'\n        : `Runner ${parsed.runner} is not one this workflow declares: ${declared.join(', ')}.`,\n    );\n  }\n  if (parsed.command !== undefined && !(requirements.commands ?? []).includes(parsed.command)) {\n    problems.push(\n      requirements.commands === undefined || requirements.commands.length === 0\n        ? 'This workflow has no templated steps to run through a command.'\n        : `Command ${parsed.command} is not one every step offers: ${requirements.commands.join(', ')}.`,\n    );\n  }\n  if (parsed.choice !== undefined && !(requirements.choices ?? []).includes(parsed.choice)) {\n    problems.push(\n      `Choice ${parsed.choice} is not declared${requirements.choices?.length ? `: ${requirements.choices.join(', ')}` : ''}.`,\n    );\n  }\n  return problems;\n}\n"],"mappings":"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"}

package/llms.txt

@@ -0,0 +1,24 @@
+# Doom Pi Workflow
+
+Package-owned guidance for authoring, launching, monitoring, and recovering Doom Pi workflows.
+
+## How to author
+
+- [Author Po workflows](./src/prompts/po-author-workflow/SKILL.md): Define workflow graphs and host-executed steps safely.
+
+## How to use
+
+- [Use Po workflows](./src/prompts/po-use-workflow/SKILL.md): Discover, launch, monitor, control, and recover asynchronous runs.
+- [Workflow recovery skill](./skills/workflow-recovery/SKILL.md): Evidence-first recovery of failed or interrupted workflow runs.
+
+## Package reference
+
+- [Package README](./README.md): Workflow mode, leader bindings, execution model, monitoring, and public entrypoints.
+
+## Native execution contract
+
+Agent steps require an effective `runConfig.majorMode`; delegated workflows require top-level `runConfig.majorMode` before their owner child is created. Selection projects major mode, minor modes, profile and domains, adding the workflow minor mode once. `subagentModel` and `subagentThinking` set Team preferences independently of the step model.
+
+The native host requires execution-state inspection before creating agent steps. After settlement it waits for idle, no pending messages and a known background snapshot without core holds or holding-provider errors before checking decisions. Unknown ownership waits closed without consuming reminders; stops interrupt reads and retry delays.
+
+Delegated successes are informational. Errors wake the workflow owner through durable custom-message admission; the launcher gets an error notification, not an agent-waking failure completion. Diagnosis stays local. Recovery, pause, resume and stop are request-driven. User-requested stops do not trigger diagnosis or automatic restart.

package/package.json

@@ -0,0 +1,133 @@
+{
+  "name": "@agimon-ai/po-workflow",
+  "version": "0.0.0-alpha.0",
+  "description": "GitHub Actions-style workflow graphs, artifacts, recovery, and asynchronous runs for Po.",
+  "keywords": [
+    "ai",
+    "automation",
+    "coding-agent",
+    "developer-tools",
+    "github-actions",
+    "pi-extension",
+    "pi-package",
+    "po",
+    "workflow",
+    "workflow-orchestration"
+  ],
+  "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/po/issues"
+  },
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/po.git",
+    "directory": "packages/minor/po-workflow"
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "README.md",
+    "src/prompts",
+    "skills/workflow-recovery/SKILL.md",
+    "src/types/webWorkflows.ts",
+    "src/types/webWorkflowTerminal.ts"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./extensions/server": {
+      "types": "./dist/extensions/server.d.mts",
+      "import": "./dist/extensions/server.mjs",
+      "require": "./dist/extensions/server.cjs"
+    },
+    "./extensions/web": {
+      "import": "./dist/extensions/web.mjs"
+    },
+    "./skills/workflow-recovery/SKILL.md": "./skills/workflow-recovery/SKILL.md",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agimon-ai/po-core": "0.0.0-alpha.0",
+    "@agimon-ai/po-minor-mode": "0.0.0-alpha.0",
+    "@agimon-ai/po-telemetry": "0.0.0-alpha.0",
+    "@agimon-ai/po-ui": "0.0.0-alpha.0",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.0",
+    "@agimon-ai/po-web-security": "0.0.0-alpha.0",
+    "@agimon-ai/workflow-mcp": "0.24.12",
+    "@deepseek-ai/cordis": "4.0.4",
+    "@modelcontextprotocol/server": "2.2.0",
+    "hono": "4.13.12",
+    "typebox": "1.3.34",
+    "zod": "4.6.5"
+  },
+  "devDependencies": {
+    "@agimon-ai/po-build": "0.0.0-alpha.0",
+    "@earendil-works/pi-coding-agent": "1.0.2",
+    "@tanstack/react-store": "0.11.2",
+    "@tanstack/store": "0.11.2",
+    "@types/node": "26.6.4",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "@vitest/coverage-v8": "5.0.3",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "tsdown": "0.23.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "1.0.2"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "poServer": {
+    "entry": "./generated/server.ts",
+    "dist": "./dist/extensions/server.mjs",
+    "scopes": [
+      "global",
+      "workspace",
+      "session"
+    ],
+    "contracts": {
+      "entry": "./src/exports/apiContracts.ts",
+      "dist": "./dist/apiContracts.mjs"
+    }
+  },
+  "poWeb": {
+    "pluginId": "workflows",
+    "channels": [
+      "workflow_catalog",
+      "workflow_runs"
+    ],
+    "client": "./dist/extensions/web.mjs",
+    "scopes": [
+      "session"
+    ]
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.web.json",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}

package/skills/workflow-recovery/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: workflow-recovery
+description: Recover a failed or interrupted workflow-mcp run so it resumes from its active repair rather than starting over. Use before a recover action (workflow_run in Pi CLI, workflow_tools in server/web sessions), whenever a run shows stage error or interrupted, or when deciding between recovery, a fresh launch, and deferral. Covers evidence, permitted outcomes, judgement cases, and files that must never be edited.
+---
+
+# Recovering a workflow run
+
+A recovery is **not** a relaunch, and the difference is expensive to get wrong. A
+relaunch throws away the run's state and starts again; a recovery resumes the
+existing run from its active repair, preserving the worktree and the work already
+done. Choosing the wrong one either destroys progress or resumes a run that can
+never succeed.
+
+Recovery is also the explicit ownership-transfer path. A replacement Pi session
+may recover a terminal failed run launched by an earlier session; the replay is
+then stamped to the recovering session. This does not permit cross-session
+control of running or completed work.
+
+Read this before action `recover`: use `workflow_run` in Pi CLI sessions and
+`workflow_tools` in server/web sessions. Both take the same `runKey` and separate `workspace`.
+
+## 1. Gather evidence first
+
+Never act on the stage alone. Before touching a failed run, collect:
+
+- **Every log source**, not just the first one that looks relevant.
+- **Process state**: is anything still alive from the original run?
+- **The exact staged `run.json`** for the run.
+- **Only the repair referenced by `activeRepairId`.** Other repairs in the
+  directory belong to earlier cycles and are not yours to act on.
+
+Use action `recovery-evidence` on the same tool for the terminal `run.json`
+and durable `changelog.md`, `context.md`, and progress evidence. This dedicated
+action is terminal-only and read-only, including for failures from an earlier
+session; it never scrapes that session's live launcher. Generic `status` and
+`tail` remain limited to runs owned by this session.
+
+## 2. Choose exactly one outcome
+
+Every failed run resolves to one of three, and never two in the same pass:
+
+| Outcome                      | When                                                                                      |
+| ---------------------------- | ----------------------------------------------------------------------------------------- |
+| **Recover** the existing run | The recorded target is still valid and the failure was transient or an interruption       |
+| **Launch fresh**             | The run cannot resume, or the branch has diverged far enough that resuming is meaningless |
+| **Defer**                    | A named prerequisite is materially unresolved                                             |
+
+Recovery and a fresh launch each consume one launch from the pass budget.
+
+## 3. Judgement cases
+
+- `interrupted` with a valid failed job: the strong recovery case.
+- `failed` with a valid failed job: recoverable when the failure was transient
+  and the recorded target remains valid.
+- **Empty failed job**: cannot be recovered. Launch fresh if the work is ready,
+  otherwise defer.
+- **Terminal repair-triage run**: must never be recovered. Launch fresh once the
+  work is ready again.
+- **Stale branch**: prefer a fresh launch once the branch has diverged enough
+  that resuming would rebase onto unrecognisable history.
+- **No job id**: the run was launched by hand and is outside dispatch. Report
+  it; do not recover it.
+- **Blocked**: never recover or launch a run whose job sits in a blocked column.
+  A human resolves the blocker first.
+
+## 4. Hard constraints
+
+- **Never edit `issue.md` or `repair.json`.** They are the record of what went
+  wrong; editing them destroys the evidence and the repair chain.
+- **Never manufacture a recovery target.** If the recorded target is invalid,
+  that is a fresh-launch case, not a reason to invent one.
+- Prepare `run.json` **only** when verified recovery state requires it.
+- Preserve the active repair and the existing worktree identity.
+- Treat an “already claimed” result as another recovery winning the race; do
+  not launch fresh or retry around the claim.
+- Do not use `--dry-run` for a real recovery.
+
+## 5. Verify before reporting
+
+In Pi CLI sessions, recover through the launcher recorded for the run. In server/web
+sessions, the replay runs inside the recovering session; closing it requests a stop.
+Then confirm **real process and registry progress**. A `recover` call that returns is
+not a recovery that succeeded. After ownership transfers and the replacement run is
+visible to this session, check `workflow_run` with action `status` before reporting an outcome.
+Say what you recovered, what you skipped and why, and anything still blocked.