@agimon-ai/doompi-workflow 0.0.1-alpha.76 → 0.0.1-alpha.78

package/dist/src/services/workflowTools/index.cjs

@@ -0,0 +1,221 @@
+const require_workflow = require("../../constants/workflow.cjs");
+const require_workflowPi = require("../../schemas/workflowPi.cjs");
+const require_index = require("../piToolBridge/index.cjs");
+const require_index$1 = require("../workflowExecution/index.cjs");
+let _agimon_ai_doompi_core_child_process = require("@agimon-ai/doompi-core/child-process");
+let _agimon_ai_workflow_mcp = require("@agimon-ai/workflow-mcp");
+let zod = require("zod");
+//#region src/services/workflowTools/index.ts
+const PI_LAUNCH_FIELDS = {
+	workflowPath: true,
+	workspace: true,
+	runner: true,
+	name: true,
+	env: true,
+	prompt: true,
+	job: true,
+	inputs: true
+};
+function createWorkflowTools(dependencies, renderers = () => ({})) {
+	const feature = dependencies.feature ?? (0, _agimon_ai_workflow_mcp.createEmbeddedWorkflowFeature)();
+	const runTool = dependencies.runTool ?? feature.runTool;
+	const listWorkflowsTool = dependencies.listWorkflowsTool ?? feature.listWorkflowsTool;
+	const recoverTool = dependencies.recoverTool ?? feature.createRecoverTool();
+	const controlTool = dependencies.controlTool ?? feature.createControlTool();
+	const trackPendingRun = dependencies.trackPendingRun ?? ((run) => run);
+	const launchExecutor = dependencies.launchExecutor ?? require_index$1.createWorkflowLaunchExecutor({
+		environment: dependencies.environment,
+		activeRunCount: dependencies.activeRunCount,
+		onLaunch: dependencies.onLaunch,
+		observeSession: dependencies.observeSession,
+		rejectRunner: dependencies.rejectRunner,
+		runTool,
+		trackPendingRun
+	});
+	return [
+		{
+			name: require_workflow.LIST_WORKFLOWS_TOOL_NAME,
+			label: "List Workflows",
+			description: "List the workflow definitions available in this repository.",
+			promptSnippet: "List available workflow definitions",
+			parameters: zod.z.toJSONSchema(listWorkflowsTool.getInputSchema()),
+			renderShell: "self",
+			...renderers(require_workflow.LIST_WORKFLOWS_TOOL_NAME),
+			async execute(_toolCallId, params) {
+				return require_index.toAgentToolResult(require_workflow.LIST_WORKFLOWS_TOOL_NAME, await listWorkflowsTool.execute(params));
+			}
+		},
+		{
+			name: require_workflow.LAUNCH_WORKFLOW_TOOL_NAME,
+			label: "Launch Workflow",
+			description: "Start a workflow run. Returns once the run has started, not once it finishes; use workflow_run with action status or wait for the completion notice.",
+			promptSnippet: "Start a workflow run and return its identifier",
+			promptGuidelines: [
+				"Before launching, call list_workflows and pick the workflow whose own description matches the work. A workflow description is the source of truth; never infer one from its filename. If nothing matches, say so and stop rather than launching an approximate fit.",
+				"launch_workflow returns when the run has STARTED, not when it has finished. Never report success from its result. Poll workflow_run with action status, or wait for the completion notice the extension delivers on its own.",
+				"When dispatching Agiflow work, pass AGIFLOW_PROJECT_ID, AGIFLOW_JOB_KIND, and AGIFLOW_JOB_ID through env plus a non-empty prompt. Kind must be task or work-unit. The id alone is not a key, and omitting prompt leaves user_prompt workflows waiting for terminal input.",
+				"A workflow claims its own job in its pre step. Never claim a job yourself. JOB_ALREADY_CLAIMED or HTTP 409 means another worker won the race, so report contention and do not unlock, release, or retry automatically.",
+				"If a result says WORKFLOW_NOT_OWNED or a release failed, inspect current ownership and ask the user before any release or unlock. Never force another worker’s lock.",
+				"If a running workflow is not found, call workflow_run with action status to re-check current state before retrying.",
+				"The per-session concurrency ceiling is a real limit. If launch_workflow refuses, wait for a run to finish; do not launch through the shell to get around it."
+			],
+			parameters: zod.z.toJSONSchema(runTool.getInputSchema().pick(PI_LAUNCH_FIELDS)),
+			renderShell: "self",
+			...renderers(require_workflow.LAUNCH_WORKFLOW_TOOL_NAME),
+			async execute(_toolCallId, params, _signal, onUpdate, ctx) {
+				const input = params;
+				const result = await launchExecutor.execute(input, ctx, onUpdate);
+				const adapted = require_index.toAgentToolResult(require_workflow.LAUNCH_WORKFLOW_TOOL_NAME, result, require_index$1.launchFailureOptions);
+				return require_index$1.appendGuidance(adapted, "Next: call workflow_run with action status and verify the recorded stage before reporting the workflow outcome.");
+			}
+		},
+		{
+			name: require_workflow.WORKFLOW_RUN_TOOL_NAME,
+			label: "Workflow Run",
+			description: "Inspect or control one workflow run. Use action status, tail, recovery-evidence, follow, open, pause, resume, stop, or recover. Every action requires an exact run key.",
+			promptSnippet: "Inspect or control a workflow run",
+			promptGuidelines: [
+				"Use action status as the authority for stage, outcome, execution state, and pause cursor. A run that started is not a run that succeeded.",
+				"Use action pause or resume for cooperative lifecycle control. Pause is not stop: the run keeps its stage running, capacity, services, and heartbeat while paused.",
+				"Use action stop only when the user requests stopping a run. A user-requested stop is not a failure and needs no failure diagnosis.",
+				"Do not use follow or tail merely to wait for a healthy run; use status or the completion notice. Tail returns chat-safe status without raw PTY frames. Use follow only when the user asks to pin live progress, and open only when a human wants the recorded launcher foregrounded.",
+				"Use action recovery-evidence for terminal-only, durable status and artifacts before recovery. It is the only inspection path that may read a failed run from an earlier session and it never reads a live launcher.",
+				"Use action recover only after loading the `workflow-recovery` skill and gathering its required evidence. Recovery may adopt a terminal failed run from an earlier Pi session; it never grants cross-session control of running work. Never edit issue.md or repair.json, and verify real process and registry progress before recovery.",
+				"Never unlock or force-release an Agiflow claim from this tool."
+			],
+			parameters: zod.z.toJSONSchema(require_workflowPi.workflowRunInputSchema),
+			renderShell: "self",
+			...renderers(require_workflow.WORKFLOW_RUN_TOOL_NAME),
+			async execute(_toolCallId, rawParams, _signal, onUpdate, ctx) {
+				const input = require_workflowPi.workflowRunInputSchema.parse(rawParams);
+				const sessionId = (0, _agimon_ai_doompi_core_child_process.resolveRootSessionId)(ctx.sessionManager.getSessionId(), dependencies.environment);
+				dependencies.observeSession?.(sessionId);
+				const selector = {
+					runKey: input.runKey,
+					workspace: input.workspace
+				};
+				const requireOwnedRun = async () => {
+					if (!dependencies.requireSessionRun) throw new Error("Workflow run ownership is not available in this session.");
+					return dependencies.requireSessionRun(selector, sessionId);
+				};
+				if (input.action === "status") {
+					const record = await requireOwnedRun();
+					return {
+						content: [{
+							type: "text",
+							text: JSON.stringify(record, null, 2)
+						}],
+						details: { tool: require_workflow.WORKFLOW_RUN_TOOL_NAME }
+					};
+				}
+				if (input.action === "tail") {
+					if (!dependencies.tailRun) throw new Error("Reading workflow output is not available in this session.");
+					const record = await requireOwnedRun();
+					require_index$1.reportProgress(onUpdate, require_workflow.WORKFLOW_RUN_TOOL_NAME, `Reading output for workflow ${input.runKey}...`);
+					await dependencies.tailRun(selector, ctx);
+					return {
+						content: [{
+							type: "text",
+							text: [
+								`Workflow: ${record.displayName} (${record.runKey})`,
+								`Stage: ${record.effectiveStage ?? record.stage}`,
+								"Raw launcher output is hidden from chat. Use action follow or open to view it."
+							].join("\n")
+						}],
+						details: { tool: require_workflow.WORKFLOW_RUN_TOOL_NAME }
+					};
+				}
+				if (input.action === "recovery-evidence") {
+					if (!dependencies.readRecoveryEvidence) throw new Error("Reading workflow recovery evidence is not available in this session.");
+					require_index$1.reportProgress(onUpdate, require_workflow.WORKFLOW_RUN_TOOL_NAME, `Reading recovery evidence for workflow ${input.runKey}...`);
+					return {
+						content: [{
+							type: "text",
+							text: await dependencies.readRecoveryEvidence(selector, ctx)
+						}],
+						details: { tool: require_workflow.WORKFLOW_RUN_TOOL_NAME }
+					};
+				}
+				if (input.action === "follow") {
+					if (!dependencies.followRun) throw new Error("Following workflow output is not available in this session.");
+					await requireOwnedRun();
+					require_index$1.reportProgress(onUpdate, require_workflow.WORKFLOW_RUN_TOOL_NAME, `Following workflow ${input.runKey}...`);
+					return {
+						content: [{
+							type: "text",
+							text: await dependencies.followRun(selector, ctx)
+						}],
+						details: { tool: require_workflow.WORKFLOW_RUN_TOOL_NAME }
+					};
+				}
+				if (input.action === "open") {
+					if (!dependencies.openRun) throw new Error("Opening a workflow launcher is not available in this session.");
+					await requireOwnedRun();
+					require_index$1.reportProgress(onUpdate, require_workflow.WORKFLOW_RUN_TOOL_NAME, `Opening workflow ${input.runKey}...`);
+					return {
+						content: [{
+							type: "text",
+							text: await dependencies.openRun(selector, ctx)
+						}],
+						details: { tool: require_workflow.WORKFLOW_RUN_TOOL_NAME }
+					};
+				}
+				if (input.action === "recover") {
+					if (!dependencies.requireRecoverableRun) throw new Error("Workflow recovery ownership transfer is not available in this session.");
+					const recoverable = await dependencies.requireRecoverableRun(selector);
+					const recoverySelector = {
+						runKey: recoverable.runKey,
+						workspace: recoverable.workspace
+					};
+					require_index$1.reportProgress(onUpdate, require_workflow.WORKFLOW_RUN_TOOL_NAME, `Recovering workflow ${input.runKey}...`);
+					if (!input.dryRun) {
+						const delegated = await dependencies.delegateRecovery?.({
+							...recoverySelector,
+							runner: input.runner
+						}, ctx);
+						if (delegated) {
+							const guidance = require_index$1.actionGuidance(input.action, input.runKey);
+							await dependencies.onLaunch?.(ctx);
+							return {
+								content: [{
+									type: "text",
+									text: [delegated, guidance[0]].join("\n\n")
+								}],
+								details: { tool: require_workflow.WORKFLOW_RUN_TOOL_NAME }
+							};
+						}
+					}
+					const recoverInput = {
+						dryRun: input.dryRun,
+						job: input.job,
+						runKey: recoverySelector.runKey,
+						runner: input.runner,
+						workspace: recoverySelector.workspace
+					};
+					const result = await trackPendingRun(recoverTool.execute(recoverInput));
+					const guidance = require_index$1.actionGuidance(input.action, input.runKey);
+					const adapted = require_index.toAgentToolResult(require_workflow.WORKFLOW_RUN_TOOL_NAME, result, guidance);
+					await dependencies.onLaunch?.(ctx);
+					return require_index$1.appendGuidance(adapted, guidance[0]);
+				}
+				const ownedRun = await requireOwnedRun();
+				if (!ownedRun.runId) throw new Error(`Workflow ${input.runKey} has no controllable run generation.`);
+				require_index$1.reportProgress(onUpdate, require_workflow.WORKFLOW_RUN_TOOL_NAME, `Requesting ${input.action} for workflow ${input.runKey}...`);
+				const result = await controlTool.execute({
+					action: input.action,
+					expectedRunId: ownedRun.runId,
+					reason: input.reason,
+					runKey: input.runKey,
+					workspace: input.workspace
+				});
+				const guidance = require_index$1.actionGuidance(input.action, input.runKey);
+				const adapted = require_index.toAgentToolResult(require_workflow.WORKFLOW_RUN_TOOL_NAME, result, guidance);
+				return require_index$1.appendGuidance(adapted, guidance[0]);
+			}
+		}
+	];
+}
+//#endregion
+exports.createWorkflowTools = createWorkflowTools;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/workflowTools/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["createEmbeddedWorkflowFeature","createWorkflowLaunchExecutor","LIST_WORKFLOWS_TOOL_NAME","z","toAgentToolResult","LAUNCH_WORKFLOW_TOOL_NAME","launchFailureOptions","appendGuidance","WORKFLOW_RUN_TOOL_NAME","workflowRunInputSchema","resolveRootSessionId","actionGuidance"],"sources":["../../../../src/services/workflowTools/index.ts"],"sourcesContent":["import { resolveRootSessionId } from '@agimon-ai/doompi-core/child-process';\nimport {\n  createEmbeddedWorkflowFeature,\n  type WorkflowRunRecord,\n  type EmbeddedWorkflowFeature,\n} from '@agimon-ai/workflow-mcp';\nimport type { ExtensionAPI, ToolDefinition } from '@earendil-works/pi-coding-agent';\nimport { z } from 'zod';\n\nimport { workflowRunInputSchema } from '../../schemas/workflowPi';\nimport { toAgentToolResult, type WorkflowToolDetails } from '../../services/piToolBridge';\nimport {\n  type WorkflowLaunchInput,\n  type WorkflowRunSelector,\n  launchFailureOptions,\n} from '../../services/workflowExecution';\nimport {\n  createWorkflowLaunchExecutor,\n  reportProgress,\n  appendGuidance,\n  actionGuidance,\n  type WorkflowPiToolDependencies,\n} from '../../services/workflowExecution';\ntype WorkflowToolSchema = Parameters<ExtensionAPI['registerTool']>[0]['parameters'];\nimport {\n  WORKFLOW_PI_TOOL_NAMES,\n  LIST_WORKFLOWS_TOOL_NAME,\n  LAUNCH_WORKFLOW_TOOL_NAME,\n  WORKFLOW_RUN_TOOL_NAME,\n} from '../../constants/workflow';\nconst PI_LAUNCH_FIELDS = {\n  workflowPath: true,\n  workspace: true,\n  runner: true,\n  name: true,\n  env: true,\n  prompt: true,\n  job: true,\n  inputs: true,\n} as const;\nexport type WorkflowNativeTool = ToolDefinition<WorkflowToolSchema, WorkflowToolDetails>;\nexport type WorkflowToolRenderers = Pick<WorkflowNativeTool, 'renderCall' | 'renderResult'>;\nexport function createWorkflowTools(\n  dependencies: WorkflowPiToolDependencies,\n  renderers: (name: (typeof WORKFLOW_PI_TOOL_NAMES)[number]) => WorkflowToolRenderers = () => ({}),\n): WorkflowNativeTool[] {\n  const feature = dependencies.feature ?? createEmbeddedWorkflowFeature();\n  const runTool = dependencies.runTool ?? feature.runTool;\n  const listWorkflowsTool = dependencies.listWorkflowsTool ?? feature.listWorkflowsTool;\n  const recoverTool = dependencies.recoverTool ?? feature.createRecoverTool();\n  const controlTool = dependencies.controlTool ?? feature.createControlTool();\n  const trackPendingRun = dependencies.trackPendingRun ?? (<T>(run: Promise<T>): Promise<T> => run);\n  const launchExecutor =\n    dependencies.launchExecutor ??\n    createWorkflowLaunchExecutor({\n      environment: dependencies.environment,\n      activeRunCount: dependencies.activeRunCount,\n      onLaunch: dependencies.onLaunch,\n      observeSession: dependencies.observeSession,\n      rejectRunner: dependencies.rejectRunner,\n      runTool,\n      trackPendingRun,\n    });\n\n  return [\n    {\n      name: LIST_WORKFLOWS_TOOL_NAME,\n      label: 'List Workflows',\n      description: 'List the workflow definitions available in this repository.',\n      promptSnippet: 'List available workflow definitions',\n      parameters: z.toJSONSchema(listWorkflowsTool.getInputSchema()),\n      renderShell: 'self',\n      ...renderers(LIST_WORKFLOWS_TOOL_NAME),\n      async execute(_toolCallId, params) {\n        return toAgentToolResult(\n          LIST_WORKFLOWS_TOOL_NAME,\n          await listWorkflowsTool.execute(\n            params as Parameters<EmbeddedWorkflowFeature['listWorkflowsTool']['execute']>[0],\n          ),\n        );\n      },\n    },\n\n    {\n      name: LAUNCH_WORKFLOW_TOOL_NAME,\n      label: 'Launch Workflow',\n      description:\n        'Start a workflow run. Returns once the run has started, not once it finishes; use workflow_run with action status or wait for the completion notice.',\n      promptSnippet: 'Start a workflow run and return its identifier',\n      promptGuidelines: [\n        'Before launching, call list_workflows and pick the workflow whose own description matches the work. A workflow description is the source of truth; never infer one from its filename. If nothing matches, say so and stop rather than launching an approximate fit.',\n        'launch_workflow returns when the run has STARTED, not when it has finished. Never report success from its result. Poll workflow_run with action status, or wait for the completion notice the extension delivers on its own.',\n        'When dispatching Agiflow work, pass AGIFLOW_PROJECT_ID, AGIFLOW_JOB_KIND, and AGIFLOW_JOB_ID through env plus a non-empty prompt. Kind must be task or work-unit. The id alone is not a key, and omitting prompt leaves user_prompt workflows waiting for terminal input.',\n        'A workflow claims its own job in its pre step. Never claim a job yourself. JOB_ALREADY_CLAIMED or HTTP 409 means another worker won the race, so report contention and do not unlock, release, or retry automatically.',\n        'If a result says WORKFLOW_NOT_OWNED or a release failed, inspect current ownership and ask the user before any release or unlock. Never force another worker’s lock.',\n        'If a running workflow is not found, call workflow_run with action status to re-check current state before retrying.',\n        'The per-session concurrency ceiling is a real limit. If launch_workflow refuses, wait for a run to finish; do not launch through the shell to get around it.',\n      ],\n      parameters: z.toJSONSchema(runTool.getInputSchema().pick(PI_LAUNCH_FIELDS)),\n      renderShell: 'self',\n      ...renderers(LAUNCH_WORKFLOW_TOOL_NAME),\n      async execute(_toolCallId, params, _signal, onUpdate, ctx) {\n        const input = params as WorkflowLaunchInput;\n        const result = await launchExecutor.execute(input, ctx, onUpdate);\n        const adapted = toAgentToolResult(LAUNCH_WORKFLOW_TOOL_NAME, result, launchFailureOptions);\n        return appendGuidance(\n          adapted,\n          'Next: call workflow_run with action status and verify the recorded stage before reporting the workflow outcome.',\n        );\n      },\n    },\n\n    {\n      name: WORKFLOW_RUN_TOOL_NAME,\n      label: 'Workflow Run',\n      description:\n        'Inspect or control one workflow run. Use action status, tail, recovery-evidence, follow, open, pause, resume, stop, or recover. Every action requires an exact run key.',\n      promptSnippet: 'Inspect or control a workflow run',\n      promptGuidelines: [\n        'Use action status as the authority for stage, outcome, execution state, and pause cursor. A run that started is not a run that succeeded.',\n        'Use action pause or resume for cooperative lifecycle control. Pause is not stop: the run keeps its stage running, capacity, services, and heartbeat while paused.',\n        'Use action stop only when the user requests stopping a run. A user-requested stop is not a failure and needs no failure diagnosis.',\n        'Do not use follow or tail merely to wait for a healthy run; use status or the completion notice. Tail returns chat-safe status without raw PTY frames. Use follow only when the user asks to pin live progress, and open only when a human wants the recorded launcher foregrounded.',\n        'Use action recovery-evidence for terminal-only, durable status and artifacts before recovery. It is the only inspection path that may read a failed run from an earlier session and it never reads a live launcher.',\n        'Use action recover only after loading the `workflow-recovery` skill and gathering its required evidence. Recovery may adopt a terminal failed run from an earlier Pi session; it never grants cross-session control of running work. Never edit issue.md or repair.json, and verify real process and registry progress before recovery.',\n        'Never unlock or force-release an Agiflow claim from this tool.',\n      ],\n      parameters: z.toJSONSchema(workflowRunInputSchema),\n      renderShell: 'self',\n      ...renderers(WORKFLOW_RUN_TOOL_NAME),\n      async execute(_toolCallId, rawParams, _signal, onUpdate, ctx) {\n        const input = workflowRunInputSchema.parse(rawParams);\n        const sessionId = resolveRootSessionId(ctx.sessionManager.getSessionId(), dependencies.environment);\n        dependencies.observeSession?.(sessionId);\n        const selector: WorkflowRunSelector = { runKey: input.runKey, workspace: input.workspace };\n        const requireOwnedRun = async (): Promise<WorkflowRunRecord> => {\n          if (!dependencies.requireSessionRun) {\n            throw new Error('Workflow run ownership is not available in this session.');\n          }\n          return dependencies.requireSessionRun(selector, sessionId);\n        };\n\n        if (input.action === 'status') {\n          const record = await requireOwnedRun();\n          return {\n            content: [{ type: 'text', text: JSON.stringify(record, null, 2) }],\n            details: { tool: WORKFLOW_RUN_TOOL_NAME },\n          };\n        }\n        if (input.action === 'tail') {\n          if (!dependencies.tailRun) throw new Error('Reading workflow output is not available in this session.');\n          const record = await requireOwnedRun();\n          reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Reading output for workflow ${input.runKey}...`);\n          await dependencies.tailRun(selector, ctx);\n          return {\n            content: [\n              {\n                type: 'text',\n                text: [\n                  `Workflow: ${record.displayName} (${record.runKey})`,\n                  `Stage: ${record.effectiveStage ?? record.stage}`,\n                  'Raw launcher output is hidden from chat. Use action follow or open to view it.',\n                ].join('\\n'),\n              },\n            ],\n            details: { tool: WORKFLOW_RUN_TOOL_NAME },\n          };\n        }\n        if (input.action === 'recovery-evidence') {\n          if (!dependencies.readRecoveryEvidence) {\n            throw new Error('Reading workflow recovery evidence is not available in this session.');\n          }\n          reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Reading recovery evidence for workflow ${input.runKey}...`);\n          return {\n            content: [{ type: 'text', text: await dependencies.readRecoveryEvidence(selector, ctx) }],\n            details: { tool: WORKFLOW_RUN_TOOL_NAME },\n          };\n        }\n        if (input.action === 'follow') {\n          if (!dependencies.followRun) throw new Error('Following workflow output is not available in this session.');\n          await requireOwnedRun();\n          reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Following workflow ${input.runKey}...`);\n          return {\n            content: [{ type: 'text', text: await dependencies.followRun(selector, ctx) }],\n            details: { tool: WORKFLOW_RUN_TOOL_NAME },\n          };\n        }\n        if (input.action === 'open') {\n          if (!dependencies.openRun) throw new Error('Opening a workflow launcher is not available in this session.');\n          await requireOwnedRun();\n          reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Opening workflow ${input.runKey}...`);\n          return {\n            content: [{ type: 'text', text: await dependencies.openRun(selector, ctx) }],\n            details: { tool: WORKFLOW_RUN_TOOL_NAME },\n          };\n        }\n\n        if (input.action === 'recover') {\n          if (!dependencies.requireRecoverableRun) {\n            throw new Error('Workflow recovery ownership transfer is not available in this session.');\n          }\n          const recoverable = await dependencies.requireRecoverableRun(selector);\n          const recoverySelector = { runKey: recoverable.runKey, workspace: recoverable.workspace };\n          reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Recovering workflow ${input.runKey}...`);\n          // A recovery replays the workflow, and the replay skips the launch\n          // step, so every job runs in THIS process. For a workflow whose steps\n          // are interactive that means an agent TUI spawned onto this process's\n          // own terminal. Hand it to a launcher instead, where the workflow says\n          // how. A dry run prints rather than executes, so it stays here.\n          if (!input.dryRun) {\n            const delegated = await dependencies.delegateRecovery?.({ ...recoverySelector, runner: input.runner }, ctx);\n            if (delegated) {\n              const guidance = actionGuidance(input.action, input.runKey);\n              await dependencies.onLaunch?.(ctx);\n              return {\n                content: [{ type: 'text', text: [delegated, guidance[0]].join('\\n\\n') }],\n                details: { tool: WORKFLOW_RUN_TOOL_NAME },\n              };\n            }\n          }\n          const recoverInput = {\n            dryRun: input.dryRun,\n            job: input.job,\n            runKey: recoverySelector.runKey,\n            runner: input.runner,\n            workspace: recoverySelector.workspace,\n          };\n          const result = await trackPendingRun(recoverTool.execute(recoverInput));\n          const guidance = actionGuidance(input.action, input.runKey);\n          const adapted = toAgentToolResult(WORKFLOW_RUN_TOOL_NAME, result, guidance);\n          await dependencies.onLaunch?.(ctx);\n          return appendGuidance(adapted, guidance[0]!);\n        }\n\n        const ownedRun = await requireOwnedRun();\n        if (!ownedRun.runId) throw new Error(`Workflow ${input.runKey} has no controllable run generation.`);\n        reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Requesting ${input.action} for workflow ${input.runKey}...`);\n        const result = await controlTool.execute({\n          action: input.action,\n          expectedRunId: ownedRun.runId,\n          reason: input.reason,\n          runKey: input.runKey,\n          workspace: input.workspace,\n        });\n        const guidance = actionGuidance(input.action, input.runKey);\n        const adapted = toAgentToolResult(WORKFLOW_RUN_TOOL_NAME, result, guidance);\n        return appendGuidance(adapted, guidance[0]!);\n      },\n    },\n  ];\n}\n"],"mappings":"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"}

package/dist/src/services/workflowTools/index.mjs

@@ -0,0 +1,221 @@
+import { LAUNCH_WORKFLOW_TOOL_NAME, LIST_WORKFLOWS_TOOL_NAME, WORKFLOW_RUN_TOOL_NAME } from "../../constants/workflow.mjs";
+import { workflowRunInputSchema } from "../../schemas/workflowPi.mjs";
+import { toAgentToolResult } from "../piToolBridge/index.mjs";
+import { actionGuidance, appendGuidance, createWorkflowLaunchExecutor, launchFailureOptions, reportProgress } from "../workflowExecution/index.mjs";
+import { resolveRootSessionId } from "@agimon-ai/doompi-core/child-process";
+import { createEmbeddedWorkflowFeature } from "@agimon-ai/workflow-mcp";
+import { z } from "zod";
+//#region src/services/workflowTools/index.ts
+const PI_LAUNCH_FIELDS = {
+	workflowPath: true,
+	workspace: true,
+	runner: true,
+	name: true,
+	env: true,
+	prompt: true,
+	job: true,
+	inputs: true
+};
+function createWorkflowTools(dependencies, renderers = () => ({})) {
+	const feature = dependencies.feature ?? createEmbeddedWorkflowFeature();
+	const runTool = dependencies.runTool ?? feature.runTool;
+	const listWorkflowsTool = dependencies.listWorkflowsTool ?? feature.listWorkflowsTool;
+	const recoverTool = dependencies.recoverTool ?? feature.createRecoverTool();
+	const controlTool = dependencies.controlTool ?? feature.createControlTool();
+	const trackPendingRun = dependencies.trackPendingRun ?? ((run) => run);
+	const launchExecutor = dependencies.launchExecutor ?? createWorkflowLaunchExecutor({
+		environment: dependencies.environment,
+		activeRunCount: dependencies.activeRunCount,
+		onLaunch: dependencies.onLaunch,
+		observeSession: dependencies.observeSession,
+		rejectRunner: dependencies.rejectRunner,
+		runTool,
+		trackPendingRun
+	});
+	return [
+		{
+			name: LIST_WORKFLOWS_TOOL_NAME,
+			label: "List Workflows",
+			description: "List the workflow definitions available in this repository.",
+			promptSnippet: "List available workflow definitions",
+			parameters: z.toJSONSchema(listWorkflowsTool.getInputSchema()),
+			renderShell: "self",
+			...renderers(LIST_WORKFLOWS_TOOL_NAME),
+			async execute(_toolCallId, params) {
+				return toAgentToolResult(LIST_WORKFLOWS_TOOL_NAME, await listWorkflowsTool.execute(params));
+			}
+		},
+		{
+			name: LAUNCH_WORKFLOW_TOOL_NAME,
+			label: "Launch Workflow",
+			description: "Start a workflow run. Returns once the run has started, not once it finishes; use workflow_run with action status or wait for the completion notice.",
+			promptSnippet: "Start a workflow run and return its identifier",
+			promptGuidelines: [
+				"Before launching, call list_workflows and pick the workflow whose own description matches the work. A workflow description is the source of truth; never infer one from its filename. If nothing matches, say so and stop rather than launching an approximate fit.",
+				"launch_workflow returns when the run has STARTED, not when it has finished. Never report success from its result. Poll workflow_run with action status, or wait for the completion notice the extension delivers on its own.",
+				"When dispatching Agiflow work, pass AGIFLOW_PROJECT_ID, AGIFLOW_JOB_KIND, and AGIFLOW_JOB_ID through env plus a non-empty prompt. Kind must be task or work-unit. The id alone is not a key, and omitting prompt leaves user_prompt workflows waiting for terminal input.",
+				"A workflow claims its own job in its pre step. Never claim a job yourself. JOB_ALREADY_CLAIMED or HTTP 409 means another worker won the race, so report contention and do not unlock, release, or retry automatically.",
+				"If a result says WORKFLOW_NOT_OWNED or a release failed, inspect current ownership and ask the user before any release or unlock. Never force another worker’s lock.",
+				"If a running workflow is not found, call workflow_run with action status to re-check current state before retrying.",
+				"The per-session concurrency ceiling is a real limit. If launch_workflow refuses, wait for a run to finish; do not launch through the shell to get around it."
+			],
+			parameters: z.toJSONSchema(runTool.getInputSchema().pick(PI_LAUNCH_FIELDS)),
+			renderShell: "self",
+			...renderers(LAUNCH_WORKFLOW_TOOL_NAME),
+			async execute(_toolCallId, params, _signal, onUpdate, ctx) {
+				const input = params;
+				const result = await launchExecutor.execute(input, ctx, onUpdate);
+				const adapted = toAgentToolResult(LAUNCH_WORKFLOW_TOOL_NAME, result, launchFailureOptions);
+				return appendGuidance(adapted, "Next: call workflow_run with action status and verify the recorded stage before reporting the workflow outcome.");
+			}
+		},
+		{
+			name: WORKFLOW_RUN_TOOL_NAME,
+			label: "Workflow Run",
+			description: "Inspect or control one workflow run. Use action status, tail, recovery-evidence, follow, open, pause, resume, stop, or recover. Every action requires an exact run key.",
+			promptSnippet: "Inspect or control a workflow run",
+			promptGuidelines: [
+				"Use action status as the authority for stage, outcome, execution state, and pause cursor. A run that started is not a run that succeeded.",
+				"Use action pause or resume for cooperative lifecycle control. Pause is not stop: the run keeps its stage running, capacity, services, and heartbeat while paused.",
+				"Use action stop only when the user requests stopping a run. A user-requested stop is not a failure and needs no failure diagnosis.",
+				"Do not use follow or tail merely to wait for a healthy run; use status or the completion notice. Tail returns chat-safe status without raw PTY frames. Use follow only when the user asks to pin live progress, and open only when a human wants the recorded launcher foregrounded.",
+				"Use action recovery-evidence for terminal-only, durable status and artifacts before recovery. It is the only inspection path that may read a failed run from an earlier session and it never reads a live launcher.",
+				"Use action recover only after loading the `workflow-recovery` skill and gathering its required evidence. Recovery may adopt a terminal failed run from an earlier Pi session; it never grants cross-session control of running work. Never edit issue.md or repair.json, and verify real process and registry progress before recovery.",
+				"Never unlock or force-release an Agiflow claim from this tool."
+			],
+			parameters: z.toJSONSchema(workflowRunInputSchema),
+			renderShell: "self",
+			...renderers(WORKFLOW_RUN_TOOL_NAME),
+			async execute(_toolCallId, rawParams, _signal, onUpdate, ctx) {
+				const input = workflowRunInputSchema.parse(rawParams);
+				const sessionId = resolveRootSessionId(ctx.sessionManager.getSessionId(), dependencies.environment);
+				dependencies.observeSession?.(sessionId);
+				const selector = {
+					runKey: input.runKey,
+					workspace: input.workspace
+				};
+				const requireOwnedRun = async () => {
+					if (!dependencies.requireSessionRun) throw new Error("Workflow run ownership is not available in this session.");
+					return dependencies.requireSessionRun(selector, sessionId);
+				};
+				if (input.action === "status") {
+					const record = await requireOwnedRun();
+					return {
+						content: [{
+							type: "text",
+							text: JSON.stringify(record, null, 2)
+						}],
+						details: { tool: WORKFLOW_RUN_TOOL_NAME }
+					};
+				}
+				if (input.action === "tail") {
+					if (!dependencies.tailRun) throw new Error("Reading workflow output is not available in this session.");
+					const record = await requireOwnedRun();
+					reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Reading output for workflow ${input.runKey}...`);
+					await dependencies.tailRun(selector, ctx);
+					return {
+						content: [{
+							type: "text",
+							text: [
+								`Workflow: ${record.displayName} (${record.runKey})`,
+								`Stage: ${record.effectiveStage ?? record.stage}`,
+								"Raw launcher output is hidden from chat. Use action follow or open to view it."
+							].join("\n")
+						}],
+						details: { tool: WORKFLOW_RUN_TOOL_NAME }
+					};
+				}
+				if (input.action === "recovery-evidence") {
+					if (!dependencies.readRecoveryEvidence) throw new Error("Reading workflow recovery evidence is not available in this session.");
+					reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Reading recovery evidence for workflow ${input.runKey}...`);
+					return {
+						content: [{
+							type: "text",
+							text: await dependencies.readRecoveryEvidence(selector, ctx)
+						}],
+						details: { tool: WORKFLOW_RUN_TOOL_NAME }
+					};
+				}
+				if (input.action === "follow") {
+					if (!dependencies.followRun) throw new Error("Following workflow output is not available in this session.");
+					await requireOwnedRun();
+					reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Following workflow ${input.runKey}...`);
+					return {
+						content: [{
+							type: "text",
+							text: await dependencies.followRun(selector, ctx)
+						}],
+						details: { tool: WORKFLOW_RUN_TOOL_NAME }
+					};
+				}
+				if (input.action === "open") {
+					if (!dependencies.openRun) throw new Error("Opening a workflow launcher is not available in this session.");
+					await requireOwnedRun();
+					reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Opening workflow ${input.runKey}...`);
+					return {
+						content: [{
+							type: "text",
+							text: await dependencies.openRun(selector, ctx)
+						}],
+						details: { tool: WORKFLOW_RUN_TOOL_NAME }
+					};
+				}
+				if (input.action === "recover") {
+					if (!dependencies.requireRecoverableRun) throw new Error("Workflow recovery ownership transfer is not available in this session.");
+					const recoverable = await dependencies.requireRecoverableRun(selector);
+					const recoverySelector = {
+						runKey: recoverable.runKey,
+						workspace: recoverable.workspace
+					};
+					reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Recovering workflow ${input.runKey}...`);
+					if (!input.dryRun) {
+						const delegated = await dependencies.delegateRecovery?.({
+							...recoverySelector,
+							runner: input.runner
+						}, ctx);
+						if (delegated) {
+							const guidance = actionGuidance(input.action, input.runKey);
+							await dependencies.onLaunch?.(ctx);
+							return {
+								content: [{
+									type: "text",
+									text: [delegated, guidance[0]].join("\n\n")
+								}],
+								details: { tool: WORKFLOW_RUN_TOOL_NAME }
+							};
+						}
+					}
+					const recoverInput = {
+						dryRun: input.dryRun,
+						job: input.job,
+						runKey: recoverySelector.runKey,
+						runner: input.runner,
+						workspace: recoverySelector.workspace
+					};
+					const result = await trackPendingRun(recoverTool.execute(recoverInput));
+					const guidance = actionGuidance(input.action, input.runKey);
+					const adapted = toAgentToolResult(WORKFLOW_RUN_TOOL_NAME, result, guidance);
+					await dependencies.onLaunch?.(ctx);
+					return appendGuidance(adapted, guidance[0]);
+				}
+				const ownedRun = await requireOwnedRun();
+				if (!ownedRun.runId) throw new Error(`Workflow ${input.runKey} has no controllable run generation.`);
+				reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Requesting ${input.action} for workflow ${input.runKey}...`);
+				const result = await controlTool.execute({
+					action: input.action,
+					expectedRunId: ownedRun.runId,
+					reason: input.reason,
+					runKey: input.runKey,
+					workspace: input.workspace
+				});
+				const guidance = actionGuidance(input.action, input.runKey);
+				const adapted = toAgentToolResult(WORKFLOW_RUN_TOOL_NAME, result, guidance);
+				return appendGuidance(adapted, guidance[0]);
+			}
+		}
+	];
+}
+//#endregion
+export { createWorkflowTools };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/workflowTools/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/workflowTools/index.ts"],"sourcesContent":["import { resolveRootSessionId } from '@agimon-ai/doompi-core/child-process';\nimport {\n  createEmbeddedWorkflowFeature,\n  type WorkflowRunRecord,\n  type EmbeddedWorkflowFeature,\n} from '@agimon-ai/workflow-mcp';\nimport type { ExtensionAPI, ToolDefinition } from '@earendil-works/pi-coding-agent';\nimport { z } from 'zod';\n\nimport { workflowRunInputSchema } from '../../schemas/workflowPi';\nimport { toAgentToolResult, type WorkflowToolDetails } from '../../services/piToolBridge';\nimport {\n  type WorkflowLaunchInput,\n  type WorkflowRunSelector,\n  launchFailureOptions,\n} from '../../services/workflowExecution';\nimport {\n  createWorkflowLaunchExecutor,\n  reportProgress,\n  appendGuidance,\n  actionGuidance,\n  type WorkflowPiToolDependencies,\n} from '../../services/workflowExecution';\ntype WorkflowToolSchema = Parameters<ExtensionAPI['registerTool']>[0]['parameters'];\nimport {\n  WORKFLOW_PI_TOOL_NAMES,\n  LIST_WORKFLOWS_TOOL_NAME,\n  LAUNCH_WORKFLOW_TOOL_NAME,\n  WORKFLOW_RUN_TOOL_NAME,\n} from '../../constants/workflow';\nconst PI_LAUNCH_FIELDS = {\n  workflowPath: true,\n  workspace: true,\n  runner: true,\n  name: true,\n  env: true,\n  prompt: true,\n  job: true,\n  inputs: true,\n} as const;\nexport type WorkflowNativeTool = ToolDefinition<WorkflowToolSchema, WorkflowToolDetails>;\nexport type WorkflowToolRenderers = Pick<WorkflowNativeTool, 'renderCall' | 'renderResult'>;\nexport function createWorkflowTools(\n  dependencies: WorkflowPiToolDependencies,\n  renderers: (name: (typeof WORKFLOW_PI_TOOL_NAMES)[number]) => WorkflowToolRenderers = () => ({}),\n): WorkflowNativeTool[] {\n  const feature = dependencies.feature ?? createEmbeddedWorkflowFeature();\n  const runTool = dependencies.runTool ?? feature.runTool;\n  const listWorkflowsTool = dependencies.listWorkflowsTool ?? feature.listWorkflowsTool;\n  const recoverTool = dependencies.recoverTool ?? feature.createRecoverTool();\n  const controlTool = dependencies.controlTool ?? feature.createControlTool();\n  const trackPendingRun = dependencies.trackPendingRun ?? (<T>(run: Promise<T>): Promise<T> => run);\n  const launchExecutor =\n    dependencies.launchExecutor ??\n    createWorkflowLaunchExecutor({\n      environment: dependencies.environment,\n      activeRunCount: dependencies.activeRunCount,\n      onLaunch: dependencies.onLaunch,\n      observeSession: dependencies.observeSession,\n      rejectRunner: dependencies.rejectRunner,\n      runTool,\n      trackPendingRun,\n    });\n\n  return [\n    {\n      name: LIST_WORKFLOWS_TOOL_NAME,\n      label: 'List Workflows',\n      description: 'List the workflow definitions available in this repository.',\n      promptSnippet: 'List available workflow definitions',\n      parameters: z.toJSONSchema(listWorkflowsTool.getInputSchema()),\n      renderShell: 'self',\n      ...renderers(LIST_WORKFLOWS_TOOL_NAME),\n      async execute(_toolCallId, params) {\n        return toAgentToolResult(\n          LIST_WORKFLOWS_TOOL_NAME,\n          await listWorkflowsTool.execute(\n            params as Parameters<EmbeddedWorkflowFeature['listWorkflowsTool']['execute']>[0],\n          ),\n        );\n      },\n    },\n\n    {\n      name: LAUNCH_WORKFLOW_TOOL_NAME,\n      label: 'Launch Workflow',\n      description:\n        'Start a workflow run. Returns once the run has started, not once it finishes; use workflow_run with action status or wait for the completion notice.',\n      promptSnippet: 'Start a workflow run and return its identifier',\n      promptGuidelines: [\n        'Before launching, call list_workflows and pick the workflow whose own description matches the work. A workflow description is the source of truth; never infer one from its filename. If nothing matches, say so and stop rather than launching an approximate fit.',\n        'launch_workflow returns when the run has STARTED, not when it has finished. Never report success from its result. Poll workflow_run with action status, or wait for the completion notice the extension delivers on its own.',\n        'When dispatching Agiflow work, pass AGIFLOW_PROJECT_ID, AGIFLOW_JOB_KIND, and AGIFLOW_JOB_ID through env plus a non-empty prompt. Kind must be task or work-unit. The id alone is not a key, and omitting prompt leaves user_prompt workflows waiting for terminal input.',\n        'A workflow claims its own job in its pre step. Never claim a job yourself. JOB_ALREADY_CLAIMED or HTTP 409 means another worker won the race, so report contention and do not unlock, release, or retry automatically.',\n        'If a result says WORKFLOW_NOT_OWNED or a release failed, inspect current ownership and ask the user before any release or unlock. Never force another worker’s lock.',\n        'If a running workflow is not found, call workflow_run with action status to re-check current state before retrying.',\n        'The per-session concurrency ceiling is a real limit. If launch_workflow refuses, wait for a run to finish; do not launch through the shell to get around it.',\n      ],\n      parameters: z.toJSONSchema(runTool.getInputSchema().pick(PI_LAUNCH_FIELDS)),\n      renderShell: 'self',\n      ...renderers(LAUNCH_WORKFLOW_TOOL_NAME),\n      async execute(_toolCallId, params, _signal, onUpdate, ctx) {\n        const input = params as WorkflowLaunchInput;\n        const result = await launchExecutor.execute(input, ctx, onUpdate);\n        const adapted = toAgentToolResult(LAUNCH_WORKFLOW_TOOL_NAME, result, launchFailureOptions);\n        return appendGuidance(\n          adapted,\n          'Next: call workflow_run with action status and verify the recorded stage before reporting the workflow outcome.',\n        );\n      },\n    },\n\n    {\n      name: WORKFLOW_RUN_TOOL_NAME,\n      label: 'Workflow Run',\n      description:\n        'Inspect or control one workflow run. Use action status, tail, recovery-evidence, follow, open, pause, resume, stop, or recover. Every action requires an exact run key.',\n      promptSnippet: 'Inspect or control a workflow run',\n      promptGuidelines: [\n        'Use action status as the authority for stage, outcome, execution state, and pause cursor. A run that started is not a run that succeeded.',\n        'Use action pause or resume for cooperative lifecycle control. Pause is not stop: the run keeps its stage running, capacity, services, and heartbeat while paused.',\n        'Use action stop only when the user requests stopping a run. A user-requested stop is not a failure and needs no failure diagnosis.',\n        'Do not use follow or tail merely to wait for a healthy run; use status or the completion notice. Tail returns chat-safe status without raw PTY frames. Use follow only when the user asks to pin live progress, and open only when a human wants the recorded launcher foregrounded.',\n        'Use action recovery-evidence for terminal-only, durable status and artifacts before recovery. It is the only inspection path that may read a failed run from an earlier session and it never reads a live launcher.',\n        'Use action recover only after loading the `workflow-recovery` skill and gathering its required evidence. Recovery may adopt a terminal failed run from an earlier Pi session; it never grants cross-session control of running work. Never edit issue.md or repair.json, and verify real process and registry progress before recovery.',\n        'Never unlock or force-release an Agiflow claim from this tool.',\n      ],\n      parameters: z.toJSONSchema(workflowRunInputSchema),\n      renderShell: 'self',\n      ...renderers(WORKFLOW_RUN_TOOL_NAME),\n      async execute(_toolCallId, rawParams, _signal, onUpdate, ctx) {\n        const input = workflowRunInputSchema.parse(rawParams);\n        const sessionId = resolveRootSessionId(ctx.sessionManager.getSessionId(), dependencies.environment);\n        dependencies.observeSession?.(sessionId);\n        const selector: WorkflowRunSelector = { runKey: input.runKey, workspace: input.workspace };\n        const requireOwnedRun = async (): Promise<WorkflowRunRecord> => {\n          if (!dependencies.requireSessionRun) {\n            throw new Error('Workflow run ownership is not available in this session.');\n          }\n          return dependencies.requireSessionRun(selector, sessionId);\n        };\n\n        if (input.action === 'status') {\n          const record = await requireOwnedRun();\n          return {\n            content: [{ type: 'text', text: JSON.stringify(record, null, 2) }],\n            details: { tool: WORKFLOW_RUN_TOOL_NAME },\n          };\n        }\n        if (input.action === 'tail') {\n          if (!dependencies.tailRun) throw new Error('Reading workflow output is not available in this session.');\n          const record = await requireOwnedRun();\n          reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Reading output for workflow ${input.runKey}...`);\n          await dependencies.tailRun(selector, ctx);\n          return {\n            content: [\n              {\n                type: 'text',\n                text: [\n                  `Workflow: ${record.displayName} (${record.runKey})`,\n                  `Stage: ${record.effectiveStage ?? record.stage}`,\n                  'Raw launcher output is hidden from chat. Use action follow or open to view it.',\n                ].join('\\n'),\n              },\n            ],\n            details: { tool: WORKFLOW_RUN_TOOL_NAME },\n          };\n        }\n        if (input.action === 'recovery-evidence') {\n          if (!dependencies.readRecoveryEvidence) {\n            throw new Error('Reading workflow recovery evidence is not available in this session.');\n          }\n          reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Reading recovery evidence for workflow ${input.runKey}...`);\n          return {\n            content: [{ type: 'text', text: await dependencies.readRecoveryEvidence(selector, ctx) }],\n            details: { tool: WORKFLOW_RUN_TOOL_NAME },\n          };\n        }\n        if (input.action === 'follow') {\n          if (!dependencies.followRun) throw new Error('Following workflow output is not available in this session.');\n          await requireOwnedRun();\n          reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Following workflow ${input.runKey}...`);\n          return {\n            content: [{ type: 'text', text: await dependencies.followRun(selector, ctx) }],\n            details: { tool: WORKFLOW_RUN_TOOL_NAME },\n          };\n        }\n        if (input.action === 'open') {\n          if (!dependencies.openRun) throw new Error('Opening a workflow launcher is not available in this session.');\n          await requireOwnedRun();\n          reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Opening workflow ${input.runKey}...`);\n          return {\n            content: [{ type: 'text', text: await dependencies.openRun(selector, ctx) }],\n            details: { tool: WORKFLOW_RUN_TOOL_NAME },\n          };\n        }\n\n        if (input.action === 'recover') {\n          if (!dependencies.requireRecoverableRun) {\n            throw new Error('Workflow recovery ownership transfer is not available in this session.');\n          }\n          const recoverable = await dependencies.requireRecoverableRun(selector);\n          const recoverySelector = { runKey: recoverable.runKey, workspace: recoverable.workspace };\n          reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Recovering workflow ${input.runKey}...`);\n          // A recovery replays the workflow, and the replay skips the launch\n          // step, so every job runs in THIS process. For a workflow whose steps\n          // are interactive that means an agent TUI spawned onto this process's\n          // own terminal. Hand it to a launcher instead, where the workflow says\n          // how. A dry run prints rather than executes, so it stays here.\n          if (!input.dryRun) {\n            const delegated = await dependencies.delegateRecovery?.({ ...recoverySelector, runner: input.runner }, ctx);\n            if (delegated) {\n              const guidance = actionGuidance(input.action, input.runKey);\n              await dependencies.onLaunch?.(ctx);\n              return {\n                content: [{ type: 'text', text: [delegated, guidance[0]].join('\\n\\n') }],\n                details: { tool: WORKFLOW_RUN_TOOL_NAME },\n              };\n            }\n          }\n          const recoverInput = {\n            dryRun: input.dryRun,\n            job: input.job,\n            runKey: recoverySelector.runKey,\n            runner: input.runner,\n            workspace: recoverySelector.workspace,\n          };\n          const result = await trackPendingRun(recoverTool.execute(recoverInput));\n          const guidance = actionGuidance(input.action, input.runKey);\n          const adapted = toAgentToolResult(WORKFLOW_RUN_TOOL_NAME, result, guidance);\n          await dependencies.onLaunch?.(ctx);\n          return appendGuidance(adapted, guidance[0]!);\n        }\n\n        const ownedRun = await requireOwnedRun();\n        if (!ownedRun.runId) throw new Error(`Workflow ${input.runKey} has no controllable run generation.`);\n        reportProgress(onUpdate, WORKFLOW_RUN_TOOL_NAME, `Requesting ${input.action} for workflow ${input.runKey}...`);\n        const result = await controlTool.execute({\n          action: input.action,\n          expectedRunId: ownedRun.runId,\n          reason: input.reason,\n          runKey: input.runKey,\n          workspace: input.workspace,\n        });\n        const guidance = actionGuidance(input.action, input.runKey);\n        const adapted = toAgentToolResult(WORKFLOW_RUN_TOOL_NAME, result, guidance);\n        return appendGuidance(adapted, guidance[0]!);\n      },\n    },\n  ];\n}\n"],"mappings":"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"}

package/dist/src/services/workflowWatcher/index.cjs

@@ -0,0 +1,78 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_index = require("../workflowRuns/index.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_os = require("node:os");
+node_os = require_runtime.__toESM(node_os, 1);
+//#region src/services/workflowWatcher/index.ts
+/**
+* Read the durable workflow registry once.
+*
+* The registry is an initial snapshot only. Live delivery belongs to the
+* session lifecycle and is routed through the host-owned direct event bus.
+*/
+function readWorkflowRuns(options = {}) {
+	const environment = options.environment;
+	const homeDir = options.homeDir ?? require_index.resolveWorkflowHome({
+		envValue: environment?.["WORKFLOW_MCP_HOME"],
+		homeDir: node_os.default.homedir()
+	});
+	const workspacesDir = node_path.default.join(homeDir, require_index.WORKSPACES_DIR_NAME);
+	const recordCache = /* @__PURE__ */ new Map();
+	const progressCache = /* @__PURE__ */ new Map();
+	const cachedParse = (cache, filePath, parse, empty) => {
+		let stat;
+		try {
+			stat = node_fs.default.statSync(filePath);
+		} catch {
+			cache.delete(filePath);
+			return empty;
+		}
+		const cached = cache.get(filePath);
+		if (cached && cached.size === stat.size && cached.mtimeMs === stat.mtimeMs) return cached.value;
+		let raw;
+		try {
+			raw = node_fs.default.readFileSync(filePath, "utf8");
+		} catch {
+			cache.delete(filePath);
+			return empty;
+		}
+		const value = parse(raw);
+		cache.set(filePath, {
+			size: stat.size,
+			mtimeMs: stat.mtimeMs,
+			value
+		});
+		return value;
+	};
+	const listDir = (directory) => {
+		try {
+			return node_fs.default.readdirSync(directory).sort();
+		} catch {
+			return [];
+		}
+	};
+	const runs = [];
+	for (const workspace of listDir(workspacesDir)) for (const stage of require_index.WORKFLOW_STAGES) {
+		const stageDir = node_path.default.join(workspacesDir, workspace, stage);
+		for (const runKey of listDir(stageDir)) {
+			const runDir = node_path.default.join(stageDir, runKey);
+			const recordPath = node_path.default.join(runDir, require_index.RUN_RECORD_FILE_NAME);
+			const progressPath = node_path.default.join(runDir, require_index.PROGRESS_FILE_NAME);
+			const parsed = cachedParse(recordCache, recordPath, require_index.parseWorkflowRunRecord, void 0);
+			if (parsed === void 0) continue;
+			const jobs = cachedParse(progressCache, progressPath, (raw) => require_index.foldWorkflowProgress(require_index.parseWorkflowProgress(raw)), []);
+			runs.push({
+				...parsed,
+				view: require_index.completeWorkflowRunView(parsed.view, jobs)
+			});
+		}
+	}
+	return runs;
+}
+//#endregion
+exports.readWorkflowRuns = readWorkflowRuns;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/workflowWatcher/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["resolveWorkflowHome","os","path","WORKSPACES_DIR_NAME","fs","WORKFLOW_STAGES","RUN_RECORD_FILE_NAME","PROGRESS_FILE_NAME","parseWorkflowRunRecord","foldWorkflowProgress","parseWorkflowProgress","completeWorkflowRunView"],"sources":["../../../../src/services/workflowWatcher/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport {\n  completeWorkflowRunView,\n  foldWorkflowProgress,\n  type ParsedWorkflowRun,\n  parseWorkflowProgress,\n  parseWorkflowRunRecord,\n  PROGRESS_FILE_NAME,\n  resolveWorkflowHome,\n  RUN_RECORD_FILE_NAME,\n  WORKFLOW_HOME_ENV,\n  WORKFLOW_STAGES,\n  WORKSPACES_DIR_NAME,\n} from '../workflowRuns';\n\nexport interface ReadWorkflowRunsOptions {\n  /** Registry home override, primarily for tests. */\n  homeDir?: string;\n  /** Admitted session environment used to resolve the registry home. */\n  environment?: Readonly<Record<string, string | undefined>>;\n}\n\n/**\n * Read the durable workflow registry once.\n *\n * The registry is an initial snapshot only. Live delivery belongs to the\n * session lifecycle and is routed through the host-owned direct event bus.\n */\nexport function readWorkflowRuns(options: ReadWorkflowRunsOptions = {}): ParsedWorkflowRun[] {\n  const environment = options.environment;\n  const homeDir =\n    options.homeDir ??\n    resolveWorkflowHome({\n      envValue: environment?.[WORKFLOW_HOME_ENV],\n      homeDir: os.homedir(),\n    });\n  const workspacesDir = path.join(homeDir, WORKSPACES_DIR_NAME);\n  const recordCache = new Map<string, { size: number; mtimeMs: number; value: ParsedWorkflowRun | undefined }>();\n  const progressCache = new Map<\n    string,\n    { size: number; mtimeMs: number; value: ReturnType<typeof foldWorkflowProgress> }\n  >();\n\n  const cachedParse = <T>(\n    cache: Map<string, { size: number; mtimeMs: number; value: T }>,\n    filePath: string,\n    parse: (raw: string) => T,\n    empty: T,\n  ): T => {\n    let stat: fs.Stats;\n    try {\n      stat = fs.statSync(filePath);\n    } catch {\n      cache.delete(filePath);\n      return empty;\n    }\n    const cached = cache.get(filePath);\n    if (cached && cached.size === stat.size && cached.mtimeMs === stat.mtimeMs) return cached.value;\n    let raw: string;\n    try {\n      raw = fs.readFileSync(filePath, 'utf8');\n    } catch {\n      cache.delete(filePath);\n      return empty;\n    }\n    const value = parse(raw);\n    cache.set(filePath, { size: stat.size, mtimeMs: stat.mtimeMs, value });\n    return value;\n  };\n\n  const listDir = (directory: string): string[] => {\n    try {\n      return fs.readdirSync(directory).sort();\n    } catch {\n      return [];\n    }\n  };\n\n  const runs: ParsedWorkflowRun[] = [];\n  for (const workspace of listDir(workspacesDir)) {\n    for (const stage of WORKFLOW_STAGES) {\n      const stageDir = path.join(workspacesDir, workspace, stage);\n      for (const runKey of listDir(stageDir)) {\n        const runDir = path.join(stageDir, runKey);\n        const recordPath = path.join(runDir, RUN_RECORD_FILE_NAME);\n        const progressPath = path.join(runDir, PROGRESS_FILE_NAME);\n        const parsed = cachedParse(recordCache, recordPath, parseWorkflowRunRecord, undefined);\n        if (parsed === undefined) continue;\n        const jobs = cachedParse(\n          progressCache,\n          progressPath,\n          (raw) => foldWorkflowProgress(parseWorkflowProgress(raw)),\n          [],\n        );\n        runs.push({ ...parsed, view: completeWorkflowRunView(parsed.view, jobs) });\n      }\n    }\n  }\n  return runs;\n}\n"],"mappings":";;;;;;;;;;;;;;;AA+BA,SAAgB,iBAAiB,UAAmC,CAAC,GAAwB;CAC3F,MAAM,cAAc,QAAQ;CAC5B,MAAM,UACJ,QAAQ,WACRA,cAAAA,oBAAoB;EAClB,UAAU,cAAA;EACV,SAASC,QAAAA,QAAG,QAAQ;CACtB,CAAC;CACH,MAAM,gBAAgBC,UAAAA,QAAK,KAAK,SAASC,cAAAA,mBAAmB;CAC5D,MAAM,8BAAc,IAAI,IAAqF;CAC7G,MAAM,gCAAgB,IAAI,IAGxB;CAEF,MAAM,eACJ,OACA,UACA,OACA,UACM;EACN,IAAI;EACJ,IAAI;GACF,OAAOC,QAAAA,QAAG,SAAS,QAAQ;EAC7B,QAAQ;GACN,MAAM,OAAO,QAAQ;GACrB,OAAO;EACT;EACA,MAAM,SAAS,MAAM,IAAI,QAAQ;EACjC,IAAI,UAAU,OAAO,SAAS,KAAK,QAAQ,OAAO,YAAY,KAAK,SAAS,OAAO,OAAO;EAC1F,IAAI;EACJ,IAAI;GACF,MAAMA,QAAAA,QAAG,aAAa,UAAU,MAAM;EACxC,QAAQ;GACN,MAAM,OAAO,QAAQ;GACrB,OAAO;EACT;EACA,MAAM,QAAQ,MAAM,GAAG;EACvB,MAAM,IAAI,UAAU;GAAE,MAAM,KAAK;GAAM,SAAS,KAAK;GAAS;EAAM,CAAC;EACrE,OAAO;CACT;CAEA,MAAM,WAAW,cAAgC;EAC/C,IAAI;GACF,OAAOA,QAAAA,QAAG,YAAY,SAAS,CAAC,CAAC,KAAK;EACxC,QAAQ;GACN,OAAO,CAAC;EACV;CACF;CAEA,MAAM,OAA4B,CAAC;CACnC,KAAK,MAAM,aAAa,QAAQ,aAAa,GAC3C,KAAK,MAAM,SAASC,cAAAA,iBAAiB;EACnC,MAAM,WAAWH,UAAAA,QAAK,KAAK,eAAe,WAAW,KAAK;EAC1D,KAAK,MAAM,UAAU,QAAQ,QAAQ,GAAG;GACtC,MAAM,SAASA,UAAAA,QAAK,KAAK,UAAU,MAAM;GACzC,MAAM,aAAaA,UAAAA,QAAK,KAAK,QAAQI,cAAAA,oBAAoB;GACzD,MAAM,eAAeJ,UAAAA,QAAK,KAAK,QAAQK,cAAAA,kBAAkB;GACzD,MAAM,SAAS,YAAY,aAAa,YAAYC,cAAAA,wBAAwB,KAAA,CAAS;GACrF,IAAI,WAAW,KAAA,GAAW;GAC1B,MAAM,OAAO,YACX,eACA,eACC,QAAQC,cAAAA,qBAAqBC,cAAAA,sBAAsB,GAAG,CAAC,GACxD,CAAC,CACH;GACA,KAAK,KAAK;IAAE,GAAG;IAAQ,MAAMC,cAAAA,wBAAwB,OAAO,MAAM,IAAI;GAAE,CAAC;EAC3E;CACF;CAEF,OAAO;AACT"}