@agimon-ai/doompi-workflow 0.0.1-alpha.112 → 0.0.1-alpha.114

package/dist/apiContracts.cjs

@@ -237,6 +237,26 @@ const apiContracts = (0, _agimon_ai_doompi_core_apiContracts.defineApiContract)(
 			description: "Delete a settled run and its directory.",
 			responses: (0, _agimon_ai_doompi_core_apiContracts.jsonApiResponses)(typebox.Type.Object({ deleted: typebox.Type.Literal(true) }))
 		},
+		{
+			id: "workflow.openRunDirectory",
+			scope,
+			basePath: "workflow",
+			path: `${root}/open-directory`,
+			method: "POST",
+			authentication: "owner",
+			description: "Open the registered run folder in Finder. Local callers only.",
+			responses: {
+				...(0, _agimon_ai_doompi_core_apiContracts.jsonApiResponses)(typebox.Type.Object({ opened: typebox.Type.Literal(true) })),
+				"403": {
+					description: "Local caller required.",
+					schema: typebox.Type.Object({ error: S })
+				},
+				"409": {
+					description: "Folder opening unavailable.",
+					schema: typebox.Type.Object({ error: S })
+				}
+			}
+		},
 		{
 			id: "workflow.artifacts",
 			scope,
@@ -244,7 +264,13 @@ const apiContracts = (0, _agimon_ai_doompi_core_apiContracts.defineApiContract)(
 			path: `${root}/artifacts`,
 			method: "GET",
 			authentication: "owner",
-			description: "List declared and discovered artifacts.",
+			description: "List declared and discovered artifacts, or immediate children of a directory.",
+			parameters: [{
+				name: "directory",
+				in: "query",
+				required: false,
+				schema: S
+			}],
 			responses: (0, _agimon_ai_doompi_core_apiContracts.jsonApiResponses)(typebox.Type.Object({
 				runDir: S,
 				description: S,

package/dist/apiContracts.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.cjs","names":["Type","defineApiContract","jsonApiResponses"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses, type DoomHttpContract } from '@agimon-ai/doompi-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst values = <T extends string>(items: T[]) => Type.Union(items.map((item) => Type.Literal(item)));\nconst Progress = values(['running', 'completed', 'skipped', 'failed', 'pause_requested', 'paused', 'resumed']);\nconst Step = { name: S, status: Progress, reason: O(S), group: O(S), startedAt: O(S), endedAt: O(S) };\nconst Run = Type.Object({\n  runKey: S,\n  workspace: S,\n  displayName: S,\n  workflowName: O(S),\n  workflowPath: S,\n  stage: values(['running', 'completed', 'error']),\n  outcome: O(values(['success', 'skipped', 'failed', 'interrupted'])),\n  executionState: O(values(['running', 'pause_requested', 'paused', 'resume_requested'])),\n  prompt: O(S),\n  startedAt: S,\n  finishedAt: O(S),\n  errorMessage: O(S),\n  failedJob: O(S),\n  stale: O(B),\n  staleReason: O(S),\n  worktreeBranch: O(S),\n  position: O(Type.Object({ job: S, step: O(S), index: O(N), total: O(N) })),\n  jobs: Type.Array(\n    Type.Object({\n      ...Step,\n      phase: values(['pre', 'job', 'post']),\n      index: O(N),\n      total: O(N),\n      steps: Type.Array(Type.Object(Step)),\n    }),\n  ),\n});\nexport const WorkflowRunsSchema = Type.Object({ runs: Type.Array(Run) });\nconst Artifact = { path: S, kind: values(['file', 'directory']), description: S, producedBy: Type.Array(S) };\nexport const WorkflowCatalogSchema = Type.Object({\n  cwd: S,\n  warning: O(S),\n  workflows: Type.Array(\n    Type.Object({\n      path: S,\n      relativePath: S,\n      name: S,\n      description: S,\n      tags: Type.Array(S),\n      triggers: Type.Array(S),\n      inputs: Type.Array(\n        Type.Object({\n          name: S,\n          description: O(S),\n          required: O(B),\n          default: O(S),\n          type: O(S),\n          options: O(Type.Array(S)),\n        }),\n      ),\n      jobs: Type.Array(Type.Object({ name: S, steps: Type.Array(S) })),\n      artifacts: Type.Array(Type.Object(Artifact)),\n      runners: O(Type.Array(S)),\n      commands: O(Type.Array(S)),\n      choices: O(Type.Array(S)),\n      error: O(S),\n    }),\n  ),\n});\nconst Screen = Type.Object({\n  lines: Type.Array(S),\n  capabilities: Type.Object({ readable: B, writable: B, resizable: B, reason: O(S) }),\n  ended: O(B),\n});\nconst Control = Type.Object({ held: B, token: O(S), reason: O(S) });\nconst root = '/runs/{workspace}/{runKey}';\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: (['global', 'workspace', 'session'] as const).flatMap((scope): DoomHttpContract[] => [\n    {\n      id: 'workflow.screen',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/screen/stream`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Follow the workflow terminal.',\n      responses: {\n        '200': {\n          description: 'SSE stream with JSON screen events.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: { screen: Screen },\n        },\n        '404': { description: 'Run unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.control',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/control`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Take or release the keyboard.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ release: O(B), token: O(S) }) },\n      responses: { ...jsonApiResponses(Control), '409': { description: 'Keyboard unavailable.', schema: Control } },\n    },\n    {\n      id: 'workflow.keys',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/keys`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Write terminal data with the control token.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, data: S }) },\n      responses: {\n        '204': { description: 'Data written.' },\n        '400': { description: 'Invalid request.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Write refused.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.resize',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/resize`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Resize the terminal.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, columns: N, rows: N }) },\n      responses: jsonApiResponses(Type.Object({ resized: B })),\n    },\n    {\n      id: 'workflow.delete',\n      scope,\n      basePath: 'workflow',\n      path: root,\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a settled run and its directory.',\n      responses: jsonApiResponses(Type.Object({ deleted: Type.Literal(true) })),\n    },\n    {\n      id: 'workflow.artifacts',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List declared and discovered artifacts.',\n      responses: jsonApiResponses(\n        Type.Object({\n          runDir: S,\n          description: S,\n          artifacts: Type.Array(\n            Type.Object({\n              ...Artifact,\n              declared: B,\n              state: values(['written', 'empty', 'pending', 'unreadable']),\n              size: O(N),\n              modifiedAt: O(S),\n            }),\n          ),\n        }),\n      ),\n    },\n    {\n      id: 'workflow.artifact',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts/{name}`,\n      method: 'GET',\n      authentication: 'owner',\n      description:\n        'Read artifact metadata and text. name may contain nested path segments. raw=1 streams binary with its media type and supports byte ranges.',\n      parameters: [\n        { name: 'raw', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'download', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'range', in: 'header', required: false, schema: S },\n      ],\n      responses: {\n        ...jsonApiResponses(\n          Type.Union([Type.Object({ path: S, size: N, modifiedAt: S, mimeType: O(S), text: O(S), truncated: B }), S]),\n        ),\n        '206': { description: 'Partial raw bytes.', contentType: 'application/octet-stream', schema: S },\n        '416': { description: 'Unsatisfiable byte range.' },\n      },\n    },\n  ]),\n  sockets: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'workflow.runs',\n      scope,\n      service: 'doompi.hub.v1',\n      member: 'workflow_runs',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow runs channel payload.',\n      input: WorkflowRunsSchema,\n    },\n    {\n      id: 'workflow.catalog',\n      scope,\n      service: 'doompi.hub.v1',\n      member: 'workflow_catalog',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow catalog channel payload.',\n      input: WorkflowCatalogSchema,\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":"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"}
+{"version":3,"file":"apiContracts.cjs","names":["Type","defineApiContract","jsonApiResponses"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses, type DoomHttpContract } from '@agimon-ai/doompi-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst values = <T extends string>(items: T[]) => Type.Union(items.map((item) => Type.Literal(item)));\nconst Progress = values(['running', 'completed', 'skipped', 'failed', 'pause_requested', 'paused', 'resumed']);\nconst Step = { name: S, status: Progress, reason: O(S), group: O(S), startedAt: O(S), endedAt: O(S) };\nconst Run = Type.Object({\n  runKey: S,\n  workspace: S,\n  displayName: S,\n  workflowName: O(S),\n  workflowPath: S,\n  stage: values(['running', 'completed', 'error']),\n  outcome: O(values(['success', 'skipped', 'failed', 'interrupted'])),\n  executionState: O(values(['running', 'pause_requested', 'paused', 'resume_requested'])),\n  prompt: O(S),\n  startedAt: S,\n  finishedAt: O(S),\n  errorMessage: O(S),\n  failedJob: O(S),\n  stale: O(B),\n  staleReason: O(S),\n  worktreeBranch: O(S),\n  position: O(Type.Object({ job: S, step: O(S), index: O(N), total: O(N) })),\n  jobs: Type.Array(\n    Type.Object({\n      ...Step,\n      phase: values(['pre', 'job', 'post']),\n      index: O(N),\n      total: O(N),\n      steps: Type.Array(Type.Object(Step)),\n    }),\n  ),\n});\nexport const WorkflowRunsSchema = Type.Object({ runs: Type.Array(Run) });\nconst Artifact = { path: S, kind: values(['file', 'directory']), description: S, producedBy: Type.Array(S) };\nexport const WorkflowCatalogSchema = Type.Object({\n  cwd: S,\n  warning: O(S),\n  workflows: Type.Array(\n    Type.Object({\n      path: S,\n      relativePath: S,\n      name: S,\n      description: S,\n      tags: Type.Array(S),\n      triggers: Type.Array(S),\n      inputs: Type.Array(\n        Type.Object({\n          name: S,\n          description: O(S),\n          required: O(B),\n          default: O(S),\n          type: O(S),\n          options: O(Type.Array(S)),\n        }),\n      ),\n      jobs: Type.Array(Type.Object({ name: S, steps: Type.Array(S) })),\n      artifacts: Type.Array(Type.Object(Artifact)),\n      runners: O(Type.Array(S)),\n      commands: O(Type.Array(S)),\n      choices: O(Type.Array(S)),\n      error: O(S),\n    }),\n  ),\n});\nconst Screen = Type.Object({\n  lines: Type.Array(S),\n  capabilities: Type.Object({ readable: B, writable: B, resizable: B, reason: O(S) }),\n  ended: O(B),\n});\nconst Control = Type.Object({ held: B, token: O(S), reason: O(S) });\nconst root = '/runs/{workspace}/{runKey}';\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: (['global', 'workspace', 'session'] as const).flatMap((scope): DoomHttpContract[] => [\n    {\n      id: 'workflow.screen',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/screen/stream`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Follow the workflow terminal.',\n      responses: {\n        '200': {\n          description: 'SSE stream with JSON screen events.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: { screen: Screen },\n        },\n        '404': { description: 'Run unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.control',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/control`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Take or release the keyboard.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ release: O(B), token: O(S) }) },\n      responses: { ...jsonApiResponses(Control), '409': { description: 'Keyboard unavailable.', schema: Control } },\n    },\n    {\n      id: 'workflow.keys',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/keys`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Write terminal data with the control token.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, data: S }) },\n      responses: {\n        '204': { description: 'Data written.' },\n        '400': { description: 'Invalid request.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Write refused.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.resize',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/resize`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Resize the terminal.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, columns: N, rows: N }) },\n      responses: jsonApiResponses(Type.Object({ resized: B })),\n    },\n    {\n      id: 'workflow.delete',\n      scope,\n      basePath: 'workflow',\n      path: root,\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a settled run and its directory.',\n      responses: jsonApiResponses(Type.Object({ deleted: Type.Literal(true) })),\n    },\n    {\n      id: 'workflow.openRunDirectory',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/open-directory`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Open the registered run folder in Finder. Local callers only.',\n      responses: {\n        ...jsonApiResponses(Type.Object({ opened: Type.Literal(true) })),\n        '403': { description: 'Local caller required.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Folder opening unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.artifacts',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List declared and discovered artifacts, or immediate children of a directory.',\n      parameters: [{ name: 'directory', in: 'query', required: false, schema: S }],\n      responses: jsonApiResponses(\n        Type.Object({\n          runDir: S,\n          description: S,\n          artifacts: Type.Array(\n            Type.Object({\n              ...Artifact,\n              declared: B,\n              state: values(['written', 'empty', 'pending', 'unreadable']),\n              size: O(N),\n              modifiedAt: O(S),\n            }),\n          ),\n        }),\n      ),\n    },\n    {\n      id: 'workflow.artifact',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts/{name}`,\n      method: 'GET',\n      authentication: 'owner',\n      description:\n        'Read artifact metadata and text. name may contain nested path segments. raw=1 streams binary with its media type and supports byte ranges.',\n      parameters: [\n        { name: 'raw', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'download', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'range', in: 'header', required: false, schema: S },\n      ],\n      responses: {\n        ...jsonApiResponses(\n          Type.Union([Type.Object({ path: S, size: N, modifiedAt: S, mimeType: O(S), text: O(S), truncated: B }), S]),\n        ),\n        '206': { description: 'Partial raw bytes.', contentType: 'application/octet-stream', schema: S },\n        '416': { description: 'Unsatisfiable byte range.' },\n      },\n    },\n  ]),\n  sockets: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'workflow.runs',\n      scope,\n      service: 'doompi.hub.v1',\n      member: 'workflow_runs',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow runs channel payload.',\n      input: WorkflowRunsSchema,\n    },\n    {\n      id: 'workflow.catalog',\n      scope,\n      service: 'doompi.hub.v1',\n      member: 'workflow_catalog',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow catalog channel payload.',\n      input: WorkflowCatalogSchema,\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":"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"}

package/dist/apiContracts.mjs

@@ -233,6 +233,26 @@ const apiContracts = defineApiContract({
 			description: "Delete a settled run and its directory.",
 			responses: jsonApiResponses(Type.Object({ deleted: Type.Literal(true) }))
 		},
+		{
+			id: "workflow.openRunDirectory",
+			scope,
+			basePath: "workflow",
+			path: `${root}/open-directory`,
+			method: "POST",
+			authentication: "owner",
+			description: "Open the registered run folder in Finder. Local callers only.",
+			responses: {
+				...jsonApiResponses(Type.Object({ opened: Type.Literal(true) })),
+				"403": {
+					description: "Local caller required.",
+					schema: Type.Object({ error: S })
+				},
+				"409": {
+					description: "Folder opening unavailable.",
+					schema: Type.Object({ error: S })
+				}
+			}
+		},
 		{
 			id: "workflow.artifacts",
 			scope,
@@ -240,7 +260,13 @@ const apiContracts = defineApiContract({
 			path: `${root}/artifacts`,
 			method: "GET",
 			authentication: "owner",
-			description: "List declared and discovered artifacts.",
+			description: "List declared and discovered artifacts, or immediate children of a directory.",
+			parameters: [{
+				name: "directory",
+				in: "query",
+				required: false,
+				schema: S
+			}],
 			responses: jsonApiResponses(Type.Object({
 				runDir: S,
 				description: S,

package/dist/apiContracts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses, type DoomHttpContract } from '@agimon-ai/doompi-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst values = <T extends string>(items: T[]) => Type.Union(items.map((item) => Type.Literal(item)));\nconst Progress = values(['running', 'completed', 'skipped', 'failed', 'pause_requested', 'paused', 'resumed']);\nconst Step = { name: S, status: Progress, reason: O(S), group: O(S), startedAt: O(S), endedAt: O(S) };\nconst Run = Type.Object({\n  runKey: S,\n  workspace: S,\n  displayName: S,\n  workflowName: O(S),\n  workflowPath: S,\n  stage: values(['running', 'completed', 'error']),\n  outcome: O(values(['success', 'skipped', 'failed', 'interrupted'])),\n  executionState: O(values(['running', 'pause_requested', 'paused', 'resume_requested'])),\n  prompt: O(S),\n  startedAt: S,\n  finishedAt: O(S),\n  errorMessage: O(S),\n  failedJob: O(S),\n  stale: O(B),\n  staleReason: O(S),\n  worktreeBranch: O(S),\n  position: O(Type.Object({ job: S, step: O(S), index: O(N), total: O(N) })),\n  jobs: Type.Array(\n    Type.Object({\n      ...Step,\n      phase: values(['pre', 'job', 'post']),\n      index: O(N),\n      total: O(N),\n      steps: Type.Array(Type.Object(Step)),\n    }),\n  ),\n});\nexport const WorkflowRunsSchema = Type.Object({ runs: Type.Array(Run) });\nconst Artifact = { path: S, kind: values(['file', 'directory']), description: S, producedBy: Type.Array(S) };\nexport const WorkflowCatalogSchema = Type.Object({\n  cwd: S,\n  warning: O(S),\n  workflows: Type.Array(\n    Type.Object({\n      path: S,\n      relativePath: S,\n      name: S,\n      description: S,\n      tags: Type.Array(S),\n      triggers: Type.Array(S),\n      inputs: Type.Array(\n        Type.Object({\n          name: S,\n          description: O(S),\n          required: O(B),\n          default: O(S),\n          type: O(S),\n          options: O(Type.Array(S)),\n        }),\n      ),\n      jobs: Type.Array(Type.Object({ name: S, steps: Type.Array(S) })),\n      artifacts: Type.Array(Type.Object(Artifact)),\n      runners: O(Type.Array(S)),\n      commands: O(Type.Array(S)),\n      choices: O(Type.Array(S)),\n      error: O(S),\n    }),\n  ),\n});\nconst Screen = Type.Object({\n  lines: Type.Array(S),\n  capabilities: Type.Object({ readable: B, writable: B, resizable: B, reason: O(S) }),\n  ended: O(B),\n});\nconst Control = Type.Object({ held: B, token: O(S), reason: O(S) });\nconst root = '/runs/{workspace}/{runKey}';\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: (['global', 'workspace', 'session'] as const).flatMap((scope): DoomHttpContract[] => [\n    {\n      id: 'workflow.screen',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/screen/stream`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Follow the workflow terminal.',\n      responses: {\n        '200': {\n          description: 'SSE stream with JSON screen events.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: { screen: Screen },\n        },\n        '404': { description: 'Run unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.control',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/control`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Take or release the keyboard.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ release: O(B), token: O(S) }) },\n      responses: { ...jsonApiResponses(Control), '409': { description: 'Keyboard unavailable.', schema: Control } },\n    },\n    {\n      id: 'workflow.keys',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/keys`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Write terminal data with the control token.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, data: S }) },\n      responses: {\n        '204': { description: 'Data written.' },\n        '400': { description: 'Invalid request.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Write refused.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.resize',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/resize`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Resize the terminal.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, columns: N, rows: N }) },\n      responses: jsonApiResponses(Type.Object({ resized: B })),\n    },\n    {\n      id: 'workflow.delete',\n      scope,\n      basePath: 'workflow',\n      path: root,\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a settled run and its directory.',\n      responses: jsonApiResponses(Type.Object({ deleted: Type.Literal(true) })),\n    },\n    {\n      id: 'workflow.artifacts',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List declared and discovered artifacts.',\n      responses: jsonApiResponses(\n        Type.Object({\n          runDir: S,\n          description: S,\n          artifacts: Type.Array(\n            Type.Object({\n              ...Artifact,\n              declared: B,\n              state: values(['written', 'empty', 'pending', 'unreadable']),\n              size: O(N),\n              modifiedAt: O(S),\n            }),\n          ),\n        }),\n      ),\n    },\n    {\n      id: 'workflow.artifact',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts/{name}`,\n      method: 'GET',\n      authentication: 'owner',\n      description:\n        'Read artifact metadata and text. name may contain nested path segments. raw=1 streams binary with its media type and supports byte ranges.',\n      parameters: [\n        { name: 'raw', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'download', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'range', in: 'header', required: false, schema: S },\n      ],\n      responses: {\n        ...jsonApiResponses(\n          Type.Union([Type.Object({ path: S, size: N, modifiedAt: S, mimeType: O(S), text: O(S), truncated: B }), S]),\n        ),\n        '206': { description: 'Partial raw bytes.', contentType: 'application/octet-stream', schema: S },\n        '416': { description: 'Unsatisfiable byte range.' },\n      },\n    },\n  ]),\n  sockets: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'workflow.runs',\n      scope,\n      service: 'doompi.hub.v1',\n      member: 'workflow_runs',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow runs channel payload.',\n      input: WorkflowRunsSchema,\n    },\n    {\n      id: 'workflow.catalog',\n      scope,\n      service: 'doompi.hub.v1',\n      member: 'workflow_catalog',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow catalog channel payload.',\n      input: WorkflowCatalogSchema,\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":"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"}
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses, type DoomHttpContract } from '@agimon-ai/doompi-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst values = <T extends string>(items: T[]) => Type.Union(items.map((item) => Type.Literal(item)));\nconst Progress = values(['running', 'completed', 'skipped', 'failed', 'pause_requested', 'paused', 'resumed']);\nconst Step = { name: S, status: Progress, reason: O(S), group: O(S), startedAt: O(S), endedAt: O(S) };\nconst Run = Type.Object({\n  runKey: S,\n  workspace: S,\n  displayName: S,\n  workflowName: O(S),\n  workflowPath: S,\n  stage: values(['running', 'completed', 'error']),\n  outcome: O(values(['success', 'skipped', 'failed', 'interrupted'])),\n  executionState: O(values(['running', 'pause_requested', 'paused', 'resume_requested'])),\n  prompt: O(S),\n  startedAt: S,\n  finishedAt: O(S),\n  errorMessage: O(S),\n  failedJob: O(S),\n  stale: O(B),\n  staleReason: O(S),\n  worktreeBranch: O(S),\n  position: O(Type.Object({ job: S, step: O(S), index: O(N), total: O(N) })),\n  jobs: Type.Array(\n    Type.Object({\n      ...Step,\n      phase: values(['pre', 'job', 'post']),\n      index: O(N),\n      total: O(N),\n      steps: Type.Array(Type.Object(Step)),\n    }),\n  ),\n});\nexport const WorkflowRunsSchema = Type.Object({ runs: Type.Array(Run) });\nconst Artifact = { path: S, kind: values(['file', 'directory']), description: S, producedBy: Type.Array(S) };\nexport const WorkflowCatalogSchema = Type.Object({\n  cwd: S,\n  warning: O(S),\n  workflows: Type.Array(\n    Type.Object({\n      path: S,\n      relativePath: S,\n      name: S,\n      description: S,\n      tags: Type.Array(S),\n      triggers: Type.Array(S),\n      inputs: Type.Array(\n        Type.Object({\n          name: S,\n          description: O(S),\n          required: O(B),\n          default: O(S),\n          type: O(S),\n          options: O(Type.Array(S)),\n        }),\n      ),\n      jobs: Type.Array(Type.Object({ name: S, steps: Type.Array(S) })),\n      artifacts: Type.Array(Type.Object(Artifact)),\n      runners: O(Type.Array(S)),\n      commands: O(Type.Array(S)),\n      choices: O(Type.Array(S)),\n      error: O(S),\n    }),\n  ),\n});\nconst Screen = Type.Object({\n  lines: Type.Array(S),\n  capabilities: Type.Object({ readable: B, writable: B, resizable: B, reason: O(S) }),\n  ended: O(B),\n});\nconst Control = Type.Object({ held: B, token: O(S), reason: O(S) });\nconst root = '/runs/{workspace}/{runKey}';\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: (['global', 'workspace', 'session'] as const).flatMap((scope): DoomHttpContract[] => [\n    {\n      id: 'workflow.screen',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/screen/stream`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Follow the workflow terminal.',\n      responses: {\n        '200': {\n          description: 'SSE stream with JSON screen events.',\n          contentType: 'text/event-stream',\n          schema: S,\n          events: { screen: Screen },\n        },\n        '404': { description: 'Run unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.control',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/control`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Take or release the keyboard.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ release: O(B), token: O(S) }) },\n      responses: { ...jsonApiResponses(Control), '409': { description: 'Keyboard unavailable.', schema: Control } },\n    },\n    {\n      id: 'workflow.keys',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/keys`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Write terminal data with the control token.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, data: S }) },\n      responses: {\n        '204': { description: 'Data written.' },\n        '400': { description: 'Invalid request.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Write refused.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.resize',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/resize`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Resize the terminal.',\n      body: { required: true, contentType: 'application/json', schema: Type.Object({ token: S, columns: N, rows: N }) },\n      responses: jsonApiResponses(Type.Object({ resized: B })),\n    },\n    {\n      id: 'workflow.delete',\n      scope,\n      basePath: 'workflow',\n      path: root,\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a settled run and its directory.',\n      responses: jsonApiResponses(Type.Object({ deleted: Type.Literal(true) })),\n    },\n    {\n      id: 'workflow.openRunDirectory',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/open-directory`,\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Open the registered run folder in Finder. Local callers only.',\n      responses: {\n        ...jsonApiResponses(Type.Object({ opened: Type.Literal(true) })),\n        '403': { description: 'Local caller required.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Folder opening unavailable.', schema: Type.Object({ error: S }) },\n      },\n    },\n    {\n      id: 'workflow.artifacts',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts`,\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List declared and discovered artifacts, or immediate children of a directory.',\n      parameters: [{ name: 'directory', in: 'query', required: false, schema: S }],\n      responses: jsonApiResponses(\n        Type.Object({\n          runDir: S,\n          description: S,\n          artifacts: Type.Array(\n            Type.Object({\n              ...Artifact,\n              declared: B,\n              state: values(['written', 'empty', 'pending', 'unreadable']),\n              size: O(N),\n              modifiedAt: O(S),\n            }),\n          ),\n        }),\n      ),\n    },\n    {\n      id: 'workflow.artifact',\n      scope,\n      basePath: 'workflow',\n      path: `${root}/artifacts/{name}`,\n      method: 'GET',\n      authentication: 'owner',\n      description:\n        'Read artifact metadata and text. name may contain nested path segments. raw=1 streams binary with its media type and supports byte ranges.',\n      parameters: [\n        { name: 'raw', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'download', in: 'query', required: false, schema: values(['0', '1']) },\n        { name: 'range', in: 'header', required: false, schema: S },\n      ],\n      responses: {\n        ...jsonApiResponses(\n          Type.Union([Type.Object({ path: S, size: N, modifiedAt: S, mimeType: O(S), text: O(S), truncated: B }), S]),\n        ),\n        '206': { description: 'Partial raw bytes.', contentType: 'application/octet-stream', schema: S },\n        '416': { description: 'Unsatisfiable byte range.' },\n      },\n    },\n  ]),\n  sockets: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'workflow.runs',\n      scope,\n      service: 'doompi.hub.v1',\n      member: 'workflow_runs',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow runs channel payload.',\n      input: WorkflowRunsSchema,\n    },\n    {\n      id: 'workflow.catalog',\n      scope,\n      service: 'doompi.hub.v1',\n      member: 'workflow_catalog',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Workflow catalog channel payload.',\n      input: WorkflowCatalogSchema,\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":"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"}

package/dist/extensions/server.cjs

@@ -14,12 +14,14 @@ node_path = require_workflowTerminal.__toESM(node_path, 1);
 let _agimon_ai_workflow_mcp = require("@agimon-ai/workflow-mcp");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
+let node_child_process = require("node:child_process");
 let _agimon_ai_doompi_minor_mode = require("@agimon-ai/doompi-minor-mode");
 let _agimon_ai_doompi_telemetry = require("@agimon-ai/doompi-telemetry");
 let _agimon_ai_doompi_core_serverFacet = require("@agimon-ai/doompi-core/serverFacet");
 let _agimon_ai_doompi_core_notification = require("@agimon-ai/doompi-core/notification");
 let _agimon_ai_doompi_core_hubChannel = require("@agimon-ai/doompi-core/hubChannel");
 let node_stream = require("node:stream");
+let _agimon_ai_doompi_core_packageApi = require("@agimon-ai/doompi-core/packageApi");
 let hono = require("hono");
 let hono_streaming = require("hono/streaming");
 let _agimon_ai_doompi_core_web = require("@agimon-ai/doompi-core/web");
@@ -223,14 +225,56 @@ function jobPhase(name) {
 	if (name === PHASE_JOB_POST) return PHASE_JOB_POST;
 	return "job";
 }
-/**
-* Folds the event log into the current job tree; later events win, so a job
-* that started and later failed reads as failed. Jobs and steps keep the
-* order of their first appearance.
-*/
-function foldWorkflowProgress(events) {
-	const jobs = [];
-	const jobByName = /* @__PURE__ */ new Map();
+/** Names match the engine's progress log, including unnamed parallel children. */
+function plannedSteps(steps = []) {
+	return steps.flatMap((step, index) => {
+		const name = step.name ?? `step ${index + 1}`;
+		return step.parallel === void 0 ? [{
+			name,
+			status: "pending"
+		}] : step.parallel.map((child, childIndex) => ({
+			name: child.name ?? `${name} ${childIndex + 1}`,
+			status: "pending",
+			group: name
+		}));
+	});
+}
+/** The whole declared route, before any job or step has emitted progress. */
+function planWorkflowJobs(workflow, order) {
+	const jobs = order.map((name) => {
+		const job = workflow.jobs[name];
+		return {
+			name,
+			phase: "job",
+			status: "pending",
+			steps: [
+				...plannedSteps(job.preJob?.steps),
+				...plannedSteps(job.steps),
+				...plannedSteps(job.postJob?.steps)
+			]
+		};
+	});
+	if (workflow.pre !== void 0) jobs.unshift({
+		name: PHASE_JOB_PRE,
+		phase: "pre",
+		status: "pending",
+		steps: plannedSteps(workflow.pre.steps)
+	});
+	if (workflow.post !== void 0) jobs.push({
+		name: PHASE_JOB_POST,
+		phase: "post",
+		status: "pending",
+		steps: plannedSteps(workflow.post.steps)
+	});
+	return jobs;
+}
+/** Overlay progress on the plan, retaining recorded jobs and steps absent from the current definition. */
+function foldWorkflowProgress(events, plan = []) {
+	const jobs = plan.map((job) => ({
+		...job,
+		steps: job.steps.map((step) => ({ ...step }))
+	}));
+	const jobByName = new Map(jobs.map((job) => [job.name, job]));
 	for (const event of events) {
 		let job = jobByName.get(event.job);
 		if (job === void 0) {
@@ -258,6 +302,7 @@ function foldWorkflowProgress(events) {
 			continue;
 		}
 		if (event.step === void 0) continue;
+		if (job.status === "pending") job.status = event.status;
 		let step = job.steps.find((candidate) => candidate.name === event.step);
 		if (step === void 0) {
 			step = {
@@ -278,6 +323,9 @@ function foldWorkflowProgress(events) {
 		if (event.status === "running" && step.startedAt === void 0) step.startedAt = event.at;
 		if (STEP_TERMINAL_STATES.has(event.status)) step.endedAt = event.at;
 	}
+	for (const job of jobs) if (job.status === "skipped") {
+		for (const step of job.steps) if (step.status === "pending") step.status = "skipped";
+	}
 	return jobs;
 }
 const ACTIVE_PROGRESS_STATES = /* @__PURE__ */ new Set([
@@ -1368,9 +1416,15 @@ var apiRoutes_default = (0, _agimon_ai_doompi_core_web.defineApiRoutes)({
 		path: "/launch",
 		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
 	},
+	openRunDirectory: {
+		method: "POST",
+		path: `${RUN}/open-directory`,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
 	artifacts: {
 		method: "GET",
 		path: `${RUN}/artifacts`,
+		query: ["directory"],
 		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
 	},
 	/** One artifact: its metadata and text, or its raw bytes under `raw=1`. */
@@ -1681,18 +1735,49 @@ function createWorkflowHubApi(options = {}) {
 		}
 		return context.json({ deleted: true });
 	});
+	app.post(apiRoutes_default.openRunDirectory.path, async (context) => {
+		if ((0, _agimon_ai_doompi_core_packageApi.doomApiCallerFrom)(context.req.raw.headers)?.locality !== "local") return context.json({ error: "Opening Finder is only available on the host." }, 403);
+		const workspace = context.req.param("workspace");
+		const runKey = context.req.param("runKey");
+		const record = await runOf(workspace, runKey);
+		if (record === void 0) return context.json(missing(workspace, runKey), 404);
+		if (process.platform !== "darwin") return context.json({ error: "Finder is only available on macOS." }, 409);
+		try {
+			const runDir = node_path.default.resolve(registry.runDirectoryFor(record));
+			if (!node_fs.default.statSync(runDir).isDirectory()) return context.json({ error: "The run directory is not a folder." }, 409);
+			await new Promise((resolve, reject) => {
+				(0, node_child_process.execFile)("/usr/bin/open", [
+					"-a",
+					"Finder",
+					runDir
+				], { timeout: 5e3 }, (error) => {
+					if (error) reject(error);
+					else resolve();
+				});
+			});
+			return context.json({ opened: true });
+		} catch (error) {
+			return context.json({ error: error instanceof Error ? error.message : String(error) }, 409);
+		}
+	});
 	app.get(apiRoutes_default.artifacts.path, async (context) => {
 		const workspace = context.req.param("workspace");
 		const runKey = context.req.param("runKey");
 		const record = await runOf(workspace, runKey);
 		if (record === void 0) return context.json(missing(workspace, runKey), 404);
 		const runDir = registry.runDirectoryFor(record);
-		const body = {
-			runDir,
-			description: record.runDirectory?.description ?? "",
-			artifacts: readArtifacts(runDir, record)
-		};
-		return context.json(body);
+		const directory = context.req.query("directory") ?? "";
+		if (resolveInside(runDir, directory) === void 0) return context.json({ error: "That folder is not inside this run." }, 400);
+		try {
+			const body = {
+				runDir,
+				description: record.runDirectory?.description ?? "",
+				artifacts: readArtifacts(runDir, record, directory)
+			};
+			return context.json(body);
+		} catch (error) {
+			return context.json({ error: error instanceof Error ? error.message : String(error) }, 409);
+		}
 	});
 	app.get(apiRoutes_default.artifact.path, async (context) => {
 		const workspace = context.req.param("workspace");
@@ -1721,7 +1806,20 @@ function resolveInside(runDir, requested) {
 	const resolved = node_path.default.resolve(runDir, requested);
 	const root = node_path.default.resolve(runDir);
 	if (resolved !== root && !resolved.startsWith(`${root}${node_path.default.sep}`)) return void 0;
-	return resolved;
+	try {
+		const realRoot = node_fs.default.realpathSync(root);
+		let ancestor = resolved;
+		while (!node_fs.default.existsSync(ancestor)) {
+			const parent = node_path.default.dirname(ancestor);
+			if (parent === ancestor) return void 0;
+			ancestor = parent;
+		}
+		const real = node_fs.default.realpathSync(ancestor);
+		if (real !== realRoot && !real.startsWith(`${realRoot}${node_path.default.sep}`)) return void 0;
+		return resolved;
+	} catch {
+		return;
+	}
 }
 /** Size and modification time of one path, or undefined when it is not there. */
 function statOf(target) {
@@ -1737,10 +1835,12 @@ function stateOf(stats) {
 	return stats.size === 0 ? "empty" : "written";
 }
 function viewOf(runDir, entry) {
-	const stats = statOf(node_path.default.join(runDir, entry.path));
+	const target = resolveInside(runDir, entry.path);
+	const stats = target === void 0 ? void 0 : statOf(target);
 	return {
 		...entry,
-		state: stateOf(stats),
+		kind: stats?.isDirectory() ? "directory" : entry.kind,
+		state: target === void 0 ? "unreadable" : stateOf(stats),
 		...stats === void 0 ? {} : {
 			size: stats.size,
 			modifiedAt: stats.mtime.toISOString()
@@ -1756,7 +1856,7 @@ function viewOf(runDir, entry) {
 * hidden: the engine's own context.md and progress log are often exactly what a
 * reader is looking for.
 */
-function readArtifacts(runDir, record) {
+function readArtifacts(runDir, record, directory = "") {
 	const declared = (record.runDirectory?.entries ?? []).map((entry) => viewOf(runDir, {
 		path: entry.path,
 		kind: entry.kind,
@@ -1764,21 +1864,16 @@ function readArtifacts(runDir, record) {
 		producedBy: entry["produced-by"] ?? [],
 		declared: true
 	}));
-	const claimed = new Set(declared.map((entry) => entry.path));
-	let names;
-	try {
-		names = node_fs.default.readdirSync(runDir, { withFileTypes: true });
-	} catch {
-		return declared;
-	}
-	const found = names.filter((entry) => !claimed.has(entry.name)).map((entry) => viewOf(runDir, {
-		path: entry.name,
+	const children = declared.filter((entry) => node_path.default.posix.dirname(entry.path) === (directory || "."));
+	const claimed = new Set(children.map((entry) => entry.path));
+	const found = node_fs.default.readdirSync(node_path.default.join(runDir, directory), { withFileTypes: true }).filter((entry) => !claimed.has(node_path.default.posix.join(directory, entry.name))).map((entry) => viewOf(runDir, {
+		path: node_path.default.posix.join(directory, entry.name),
 		kind: entry.isDirectory() ? "directory" : "file",
 		description: "",
 		producedBy: [],
 		declared: false
 	})).sort((left, right) => left.path.localeCompare(right.path));
-	return [...declared, ...found];
+	return [...directory === "" ? declared : children, ...found];
 }
 /** Browser content type inferred from a filename without trusting client input. */
 function artifactMimeType(requested) {
@@ -2079,6 +2174,7 @@ function createWorkflowSessionLifecycle(deps) {
 }
 //#endregion
 //#region src/services/workflowWatcher/index.ts
+const { parser } = (0, _agimon_ai_workflow_mcp.createEmbeddedWorkflowFeature)();
 /**
 * Read the durable workflow registry once.
 *
@@ -2126,6 +2222,18 @@ function readWorkflowRuns(options = {}) {
 			return [];
 		}
 	};
+	const plans = /* @__PURE__ */ new Map();
+	const planFor = (workflowPath) => {
+		const cached = plans.get(workflowPath);
+		if (cached !== void 0) return cached;
+		let plan = [];
+		try {
+			const workflow = parser.parseWorkflowFile(workflowPath);
+			plan = planWorkflowJobs(workflow, parser.resolveJobOrder(workflow.jobs, null));
+		} catch {}
+		plans.set(workflowPath, plan);
+		return plan;
+	};
 	const runs = [];
 	for (const workspace of listDir(workspacesDir)) for (const stage of WORKFLOW_STAGES) {
 		const stageDir = node_path.default.join(workspacesDir, workspace, stage);
@@ -2135,7 +2243,7 @@ function readWorkflowRuns(options = {}) {
 			const progressPath = node_path.default.join(runDir, PROGRESS_FILE_NAME);
 			const parsed = cachedParse(recordCache, recordPath, parseWorkflowRunRecord, void 0);
 			if (parsed === void 0) continue;
-			const jobs = cachedParse(progressCache, progressPath, (raw) => foldWorkflowProgress(parseWorkflowProgress(raw)), []);
+			const jobs = foldWorkflowProgress(cachedParse(progressCache, progressPath, parseWorkflowProgress, []), planFor(parsed.view.workflowPath));
 			runs.push({
 				...parsed,
 				view: completeWorkflowRunView(parsed.view, jobs)
@@ -2741,8 +2849,13 @@ function createWorkflowServerRuntime(host, serverHost) {
 				},
 				name: LAUNCH_TOOL,
 				label: "Launch Workflow",
-				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."],
+				description: "Start a workflow run. Prefer in-process Pi execution with command: \"pi\" when supported; runner: \"codex\" is not an alias for it. A successful launch is not a completed workflow.",
+				promptGuidelines: [
+					"Before launching, inspect the workflow and its imports for commands and interactiveRun choices. Prefer a supported Pi template with inProcess: true, selected explicitly with command: \"pi\" (or a supported in-process \"pi-claude\" command when requested). Only use an external CLI when the user requests it or no in-process option exists.",
+					"command selects the exact template. Without it, runner only matches an exact command name; otherwise each step uses its first command. runner: \"codex\" does not imply command: \"pi\", so pass command explicitly to avoid switching to \"claude\" on later steps.",
+					"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: zod.z.toJSONSchema(feature.runTool.getInputSchema()),
 				executionMode: "serial",
 				async execute(_toolCallId, parameters, signal, _onUpdate, context) {