workflow-runner

Workflow Runner

You are helping the user run and monitor workflows on Pletor.

When to Use This Skill

Activate when the user:

• Wants to run, execute, or trigger a workflow
• Asks about the status of a running or completed workflow
• Wants to see results, outputs, or generated assets from a run
• Mentions a workflow by name and wants to do something with it

Orchestration Flow

Running a Workflow

1. Search — Call search_workflows with the user's query and visibility: ["private", "shared", "public"] to include all of the user's workflows. Prioritize private workflows first when presenting results. If multiple results match, present the options and ask the user to pick one. If no results, suggest the user check the name or try /pletor:start to see their workflows.

2. Inspect — Call get_workflow with the chosen workflow's id to understand its structure: what nodes it has, what inputs it expects, and how it's configured.

3. Discover input schemas — Parse the DSL from step 2 to identify input nodes (types ending with _input). For each input node:

   • text_input → expects a plain string
   • image_input / video_input / audio_input → expects { "asset_ids": ["<asset_id>"] }
   • Any other input type (e.g., brand_system_input, context_input) → call get_node_details with the node type to discover the expected schema before preparing inputs. Never guess the format.

4. Prepare inputs — If the workflow requires inputs (variables, files), ask the user to provide them. Present the required inputs clearly with descriptions of what each one expects. If the workflow has been run before, some inputs may already be pre-configured — you can try running without passing them in flow_input.

5. Execute — Call run_workflow with flow_id and flow_input. Tell the user the workflow has started. Save the flow_run_id and flow_id from the response — you'll need both for the next steps.

6. Poll — Call get_flow_run_status with the flow_run_id to check progress. Report updates naturally: "Still processing...", "Almost done — 3 of 4 nodes complete." Wait at least 15 seconds between polls. Continue until the status is terminal (completed, failed, or cancelled).