lda-wf/docs/historical/superpowers/plans/2026-05-17-call-wrapper-artifacts.md

Call Wrapper Artifacts Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Let wf.workflow.call_capability execute saved WorkflowArtifact(kind="wrapper") artifacts by their stable artifact node name without turning arbitrary saved workflows into node capabilities.

Architecture: Keep live NodeSpec execution unchanged. Extend the workflow surface resolution path so workflow.<artifact_id>.v<version> can resolve to a saved wrapper artifact, validate that it is wrapper-kind and interrupt-free, execute its stored plan through the existing workflow runner, and normalize the final workflow result into the same qualified_name / outcome / output payload shape as live capabilities.

Tech Stack: Python, Pydantic, wf_artifacts, wf_core, pytest.

---

Task 1: Pin Wrapper-Artifact Call Semantics

Files:

• Modify: tests/wf_mcp/test_service.py

• Step 1: Write the failing test

Add a test that saves a wrapper artifact with a simple one-node plan, calls WorkflowSurfaceHandlers.call_capability() with workflow.<id>.v<version>, and asserts the returned qualified_name, outcome, and output.

• Step 2: Run test to verify it fails

Run: uv run --with pytest pytest tests/wf_mcp/test_service.py -q

Expected: FAIL because call_capability() only resolves live specs today.

Task 2: Resolve Wrapper Artifacts in the Workflow Surface

Files:

• Modify: src/wf_mcp/workflow_surface/handlers.py

• Step 1: Implement minimal wrapper-artifact resolution

Add a small helper that:

• recognizes stable artifact node names

• loads the artifact from the store

• rejects non-wrapper artifacts

• rejects unsupported interrupt plans

• executes the artifact plan with the existing workflow runner

• converts the workflow run into the call_capability response payload

• Step 2: Run focused tests

Run: uv run --with pytest pytest tests/wf_mcp/test_service.py -q

Expected: PASS.

Task 3: Verify the Whole Project

Files:

• No additional files.

• Step 1: Run focused workflow-surface tests

Run: uv run --with pytest pytest tests/wf_mcp -q

Expected: PASS.

• Step 2: Run the full suite

Run: uv run --with pytest pytest -q

Expected: PASS.