Skip to content
threadle

Splice

When a run pauses. At an approval gate, a circuit breaker set to park, or a Judge with unmatched = park. The dock doesn’t just ask yes or no. It hands you the text in an editable box.

Editing it before continuing is a splice: downstream nodes receive your version, not the original.

Why it matters

Section titled “Why it matters”

Most of the time a human reviewing an intermediate result doesn’t want to veto it. They want to fix two words, delete a wrong paragraph, or add the constraint the agent forgot. Then let the pipeline continue.

Without splice you’d reject, edit the prompt, and re-run the whole branch. With it you fix the value in flight.

How it works

Section titled “How it works”
  1. The run parks. The node shows as waiting.
  2. The dock shows the inbound text, editable.
  3. Approve · continue forwards the current contents of the box.
  4. Reject · stop aborts the run.

Leave the text untouched and approve, and it’s a plain approval gate.

Where it appears

Section titled “Where it appears”
SourceBehavior
✓ Approval nodeAlways parks for review
‡ Circuit breaker, action = parkParks only when the condition fires
? Judge, unmatched = parkParks when no matcher hits. Continue emits on out:unsure
⇄ Live handoffChat with an agent until Ready, then the distilled result continues the run

Detached runs

Section titled “Detached runs”

There is no dock in a headless run. Pass --approve-all and parked text is forwarded unchanged, with a log line recording that it was auto-passed. Without the flag, a workflow containing gates refuses to start rather than silently skipping a checkpoint you meant to keep.

‡ circuit-breaker park auto-passed (approveAll) — content 43 chars < min 200

Patterns

Section titled “Patterns”

Edit the brief, not the prompt. Put an approval right after a distill step: correct the summary once, and every downstream agent inherits the correction.

Trim before it spreads. An iterator fed by a parked gate lets you delete the three junk items before they each become an agent run.

Guard the expensive step. Park before implement, not after. The cheapest edit is the one made before the tokens are spent.

Examples

Section titled “Examples”

▶ Approval gate. Approval with an editable splice, no agent required. ▶ Min-chars breaker. A park triggered automatically by a short draft.

Section titled “Related”