Code runtime

Stacksona for CrewAI

Wrap side-effecting CrewAI tools so the crew can reason and delegate normally while Gate controls execution.

Where Gate goes

Inside each governed tool wrapper that owns the real side effect.

Keep the platform's normal reasoning and orchestration. Gate only the exact action at the last safe point before execution.

Crew chooses toolGoverned wrapper checks GateTool executes or crew replans

Start here

  1. 1
    Build the final action.

    Let CrewAI choose the action and produce the arguments it intends to execute.

  2. 2
    Check the exact action with Gate.

    Send tool_name and the final payload immediately before the side effect.

  3. 3
    Follow one of four outcomes.

    Continue, wait, revise, or stop. You do not need the advanced features to get this basic path working.

Minimal setup

Give agents the governed tool wrapper, not both the governed wrapper and the raw side-effecting implementation. The wrapper should carry useful reviewer context such as the task, subject, and proposed payload.

Handle the decision

OutcomeGate statusWhat CrewAI should do
Continueallow or approvedExecute the exact proposed action. If signed proof is required, validate it first.
Waitpending_reviewStore thread_id and resume that exact review later.
Revisechanges_requestedReturn reviewer feedback to the part of the runtime that can revise the proposal.
Stopreject or rejectedDo not execute. Replan, fall back, or end the action.
Unknown or failed decision = stop.

Fail closed if Gate cannot be reached, returns an unknown state, or required approval proof is missing or invalid.

Platform notes

  • Keep multi-agent reasoning and delegation in CrewAI.
  • Persist the exact review thread in task or crew state if work can pause.
  • Return requested-change feedback to the agent that can revise the proposal.
Advanced: review threads, revisions, proof, and audit

task_id is your grouping ID. thread_id identifies the exact Gate review and should be persisted whenever work can pause.

For changes_requested, revise on the same review thread using the revision event contract. For high-impact actions that require signed proof, validate the returned approval token before execution. Log execution success or failure when you need complete audit evidence.

For long reviews, use the platform's durable continuation mechanism instead of keeping a process, workflow, or runner open.

Advanced runtime patterns Full Gate API Exact decision states