@agimon-ai/doompi-workflow 0.0.1-alpha.95 → 0.0.1-alpha.97

package/dist/extensions/server.mjs

@@ -724,7 +724,8 @@ function createWorkflowServerRuntime(host, serverHost) {
 				},
 				name: LIST_TOOL,
 				label: "List Workflows",
-				description: "List workflow definitions available in this repository.",
+				description: "List workflow definitions in this repository, not existing runs.",
+				promptGuidelines: ["Use list_workflows to discover definitions, not to find an existing run."],
 				parameters: z.toJSONSchema(feature.listWorkflowsTool.getInputSchema()),
 				executionMode: "serial",
 				async execute(_toolCallId, parameters, signal, _onUpdate, context) {
@@ -746,7 +747,8 @@ function createWorkflowServerRuntime(host, serverHost) {
 				},
 				name: LAUNCH_TOOL,
 				label: "Launch Workflow",
-				description: "Start a workflow run and return its recorded launch result.",
+				description: "Start a workflow run. A successful launch is not a completed workflow.",
+				promptGuidelines: ["Launch returns when a run starts, not when it finishes. Use the exact run key and separate workspace from its launch result for workflow_run status, not Agiflow project or job identifiers.", "Do not relaunch a healthy running workflow merely because it has not completed."],
 				parameters: z.toJSONSchema(feature.runTool.getInputSchema()),
 				executionMode: "serial",
 				async execute(_toolCallId, parameters, signal, _onUpdate, context) {
@@ -768,7 +770,13 @@ function createWorkflowServerRuntime(host, serverHost) {
 				},
 				name: RUN_TOOL,
 				label: "Workflow Run",
-				description: "Inspect the status of a workflow run or request cooperative control.",
+				description: "Inspect a session-owned workflow by exact run key and separate workspace, or request cooperative control.",
+				promptGuidelines: [
+					"Use workflow_run status for the recorded stage, outcome, position, jobs, and steps. A successful status lookup is not evidence that the workflow completed.",
+					"For a healthy running workflow, summarize the recorded progress. Do not automatically search CLI commands or filesystem logs, relaunch, or diagnose failure merely because it remains running.",
+					"Investigate further when the run reports failure or staleness, or when the user requests diagnostics. Only status, pause, resume, and stop are supported here; stop only on user request.",
+					"Use exact registry runKey and separate workspace from the launch or status result. Agiflow project and job identifiers are not workflow run keys."
+				],
 				parameters: {
 					type: "object",
 					properties: {
@@ -783,9 +791,13 @@ function createWorkflowServerRuntime(host, serverHost) {
 						},
 						runKey: {
 							type: "string",
-							minLength: 1
+							minLength: 1,
+							description: "Exact registry run key from the launch result, without the workspace prefix. Not an Agiflow job ID."
+						},
+						workspace: {
+							type: "string",
+							description: "Workspace from the launch result, passed separately from runKey."
 						},
-						workspace: { type: "string" },
 						reason: { type: "string" },
 						expectedRunId: { type: "string" }
 					},
@@ -798,7 +810,7 @@ function createWorkflowServerRuntime(host, serverHost) {
 					const input = parameters;
 					const runs = readWorkflowRuns({ environment: host.context.environment }).filter((run) => runBelongsToSession(run, host.context.sessionId) && run.view.runKey === input.runKey && (input.workspace === void 0 || run.view.workspace === input.workspace));
 					if (runs.length !== 1) return {
-						...callResult({ error: runs.length === 0 ? "Workflow run was not found in this session." : "Specify the workspace for this run key." }),
+						...callResult({ error: runs.length === 0 ? "No matching workflow run was found in this session. This is a lookup failure, not evidence that the workflow failed. Use the exact runKey and separate workspace from its launch result, not Agiflow job identifiers." : "Specify the workspace for this run key." }),
 						isError: true
 					};
 					const run = runs[0].view;