Core concept · execution evidence

Runs and outcomes

A post has one overall state. Every destination keeps its own queued, sent, published, or failed outcome.

Two state models

State layers

Post state summarizes the scheduled unit of work. Destination state records execution for each target account.

POSTOne scheduled unit11 exact states

DESTINATIONSOne result per target4 exact states

Overall post state

Post states

Human decision

requires_approval

Wait for a supervisor decision.

Human handoff

changes_requested

Return structured feedback and the exact state to the human supervisor. The configured contract exposes no post-revision call.

Scheduled execution

scheduledpublishing

Continue polling while the work remains active.

Human recoverable

draftmissed_approvalmissed_schedule

These states are not terminal. A human can publish or reschedule the post.

Outcome recorded

publishedpartialfailedrejected

Return the exact outcome and inspect destination evidence. Partial and failed outcomes may transition after retry.

Per-target execution

Destination states

Every destination uses the same four wire values. A failed destination changes only when recoverable local failure is followed by authoritative provider evidence.

queued→sent→publishedorfailedlate evidence → published

Labeled example

Example outcome

The response separates the post-level partial state from three destination outcomes. Every identifier and value below is synthetic.

EXAMPLE READ · CONFIGURED TOOL SCHEMA

get_publish({
  post_id: "post_example_08"
})

// Example response excerpt
{
  "id": "post_example_08",
  "status": "partial",
  "publishes": [
    { "platform": "instagram", "status": "published" },
    { "platform": "youtube", "status": "published" },
    { "platform": "tiktok", "status": "failed" }
  ]
}

Stop conditions

Supervisor handoff

Return the exact post ID, post state, and failed destinations. Never rename a wire state to action_required.

Polling boundary

Continue polling active states within the caller's configured budget. When that budget ends, return the post ID and current destination states.