Get Workflow Execution Result

Overview

This skill retrieves the result (return value) of a completed workflow execution. Use it after a workflow started with npx output workflow start has completed, or to retrieve results from historical runs.

When to Use This Skill

•Getting output from an asynchronously started workflow
•Retrieving results from a completed workflow
•Checking what a workflow produced
•Processing workflow output in scripts
•Comparing results between runs

Prerequisites

•The workflow must have completed (status: COMPLETED)
•You need the workflow ID
•For FAILED workflows, use npx output workflow debug instead

Instructions

Get Result

bash

npx output workflow result <workflowId>

The result is the return value of the workflow function, typically JSON.

Check Status First

Before getting results, verify the workflow completed:

bash

npx output workflow status <workflowId>
# Should show: COMPLETED

npx output workflow result <workflowId>

Understanding Results

Success Results

A successful workflow returns the value from its fn function:

typescript

// Workflow code
export default workflow({
  fn: async (input) => {
    return { processed: true, count: 42 };
  }
});

bash

# Result output
npx output workflow result abc123
# { "processed": true, "count": 42 }

Error Results

If you try to get the result of a failed workflow:

•You'll get an error message
•Use npx output workflow debug instead to see what went wrong

No Result (void workflows)

Some workflows don't return a value:

bash

npx output workflow result abc123
# null

Examples

Scenario: Get result after async start

bash

# Start workflow
npx output workflow start calculate '{"values": [1, 2, 3]}'
# Output: Workflow ID: calc-abc123

# Wait for completion
npx output workflow status calc-abc123
# Status: COMPLETED

# Get the result
npx output workflow result calc-abc123
# { "sum": 6, "average": 2 }

Scenario: Process result with jq

bash

# Extract specific field
npx output workflow result abc123 | jq '.total'

# Format for display
npx output workflow result abc123 | jq '.'

# Save to file
npx output workflow result abc123 > result.json

Scenario: Compare results between runs

bash

# Get results from two runs
npx output workflow result run-1-abc > result1.json
npx output workflow result run-2-xyz > result2.json

# Compare
diff result1.json result2.json

Scenario: Use in a script

bash

WORKFLOW_ID="abc123"

# Wait for completion
while [[ $(npx output workflow status $WORKFLOW_ID) == *"RUNNING"* ]]; do
  sleep 5
done

# Check if completed successfully
if [[ $(npx output workflow status $WORKFLOW_ID) == *"COMPLETED"* ]]; then
  RESULT=$(npx output workflow result $WORKFLOW_ID)
  echo "Workflow result: $RESULT"
else
  echo "Workflow did not complete successfully"
  npx output workflow debug $WORKFLOW_ID
fi

Handling Different Result Types

JSON Objects

bash

npx output workflow result abc123
# { "key": "value", "nested": { "data": true } }

Arrays

bash

npx output workflow result abc123
# [1, 2, 3, 4, 5]

Primitive Values

bash

npx output workflow result abc123
# 42

npx output workflow result abc123
# "success"

npx output workflow result abc123
# true

Large Results

For large results, redirect to a file:

bash

npx output workflow result abc123 > large-result.json

Error Handling

"Workflow not found"

•Check the workflow ID is correct
•Use npx output workflow runs list to find valid IDs

"Workflow not completed"

•Check status: npx output workflow status <id>
•Wait for COMPLETED status before getting result
•If RUNNING, wait and try again
•If FAILED, use npx output workflow debug

"No result available"

•The workflow may return void/undefined
•Check the workflow code to see what it returns

Related Commands

•npx output workflow status <id> - Check if workflow completed
•npx output workflow debug <id> - Debug failed workflows
•npx output workflow run <name> - Run and get result in one step
•npx output workflow runs list - Find workflow IDs