workflow_execution_operations
Manages workflow execution by creating, querying, updating, and completing workflows with validated parameters. Tracks context and progress to ensure efficient workflow orchestration and state management.
Instructions
Manages workflow execution state through strongly-typed operations for creating, querying, updating, and completing workflow executions. Handles execution context and progress tracking with validated parameters.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| autoCreatedTask | No | Whether task was auto-created | |
| contextUpdates | No | Context updates to merge with existing execution context | |
| dataKey | No | Specific data key to retrieve from context | |
| executionContext | No | Additional execution context | |
| executionId | No | Execution ID for operations requiring it | |
| executionMode | No | Execution mode | |
| operation | Yes | Operation to execute | |
| orchestrationConfig | No | Configuration for orchestrating multiple service calls | |
| roleName | No | Role name for execution | |
| stepId | No | Current step ID | |
| taskId | No | Task ID (optional for bootstrap executions) | |
| updateData | No | Fields that can be updated in WorkflowExecution |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"description": "Workflow execution operation with strongly typed parameters",
"properties": {
"autoCreatedTask": {
"description": "Whether task was auto-created",
"type": "boolean"
},
"contextUpdates": {
"additionalProperties": true,
"description": "Context updates to merge with existing execution context",
"properties": {
"bootstrapTime": {
"type": "string"
},
"bootstrapped": {
"type": "boolean"
},
"firstStepName": {
"type": "string"
},
"initialRoleName": {
"type": "string"
},
"projectPath": {
"type": "string"
},
"workflowPhase": {
"type": "string"
}
},
"type": "object"
},
"dataKey": {
"description": "Specific data key to retrieve from context",
"type": "string"
},
"executionContext": {
"additionalProperties": false,
"description": "Additional execution context",
"properties": {
"bootstrapTime": {
"type": "string"
},
"bootstrapped": {
"type": "boolean"
},
"firstStepName": {
"type": "string"
},
"initialRoleName": {
"type": "string"
},
"projectPath": {
"type": "string"
},
"workflowPhase": {
"type": "string"
}
},
"type": "object"
},
"executionId": {
"description": "Execution ID for operations requiring it",
"type": "string"
},
"executionMode": {
"description": "Execution mode",
"enum": [
"GUIDED",
"AUTOMATED",
"HYBRID"
],
"type": "string"
},
"operation": {
"description": "Operation to execute",
"enum": [
"create_execution",
"get_execution",
"update_execution",
"complete_execution",
"get_active_executions",
"get_execution_context",
"update_execution_context"
],
"type": "string"
},
"orchestrationConfig": {
"additionalProperties": false,
"description": "Configuration for orchestrating multiple service calls",
"properties": {
"continueOnFailure": {
"type": "boolean"
},
"executionMode": {
"enum": [
"sequential",
"parallel"
],
"type": "string"
},
"serviceCalls": {
"items": {
"additionalProperties": false,
"description": "MCP service call configuration",
"properties": {
"operation": {
"description": "Operation to execute",
"type": "string"
},
"parameters": {
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{}
]
},
"description": "Operation parameters",
"type": "object"
},
"serviceName": {
"description": "MCP service name",
"type": "string"
}
},
"required": [
"serviceName",
"operation",
"parameters"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"roleName": {
"description": "Role name for execution",
"enum": [
"boomerang",
"researcher",
"architect",
"senior-developer",
"code-review"
],
"type": "string"
},
"stepId": {
"description": "Current step ID",
"type": "string"
},
"taskId": {
"description": "Task ID (optional for bootstrap executions)",
"type": "number"
},
"updateData": {
"additionalProperties": false,
"description": "Fields that can be updated in WorkflowExecution",
"properties": {
"completedAt": {
"type": "string"
},
"currentRoleId": {
"type": "string"
},
"currentStepId": {
"type": "string"
},
"executionContext": {
"$ref": "#/properties/executionContext",
"description": "Additional execution context"
},
"executionMode": {
"enum": [
"GUIDED",
"AUTOMATED",
"HYBRID"
],
"type": "string"
},
"executionState": {
"additionalProperties": false,
"description": "Current workflow execution state",
"properties": {
"currentContext": {
"additionalProperties": {},
"type": "object"
},
"currentStep": {
"additionalProperties": false,
"properties": {
"assignedAt": {
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"sequenceNumber": {
"type": "number"
}
},
"required": [
"id",
"name",
"assignedAt"
],
"type": "object"
},
"lastCompletedStep": {
"additionalProperties": false,
"properties": {
"completedAt": {
"type": "string"
},
"executionData": {},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"result": {
"enum": [
"success",
"failure"
],
"type": "string"
}
},
"required": [
"id",
"completedAt",
"result"
],
"type": "object"
},
"lastProgressUpdate": {
"type": "string"
},
"phase": {
"enum": [
"initialized",
"in-progress",
"completed",
"failed",
"paused"
],
"type": "string"
},
"progressMarkers": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"lastError": {
"additionalProperties": false,
"description": "Last error encountered during execution",
"properties": {
"code": {
"type": "string"
},
"details": {},
"message": {
"type": "string"
},
"stack": {
"type": "string"
},
"timestamp": {
"type": "string"
}
},
"required": [
"message",
"timestamp"
],
"type": "object"
},
"maxRecoveryAttempts": {
"type": "number"
},
"progressPercentage": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"recoveryAttempts": {
"type": "number"
},
"stepsCompleted": {
"type": "number"
},
"totalSteps": {
"type": "number"
}
},
"type": "object"
}
},
"required": [
"operation"
],
"type": "object"
}