Sections
Statuses, MCP, and glossary
A compact reference for run states, the live MCP surface, budgets, policies, and council vocabulary.
queuedrunningwaiting_for_agentwaiting_for_usercompletedfailedcancelledMCP surface
Builder
harness.list · create · create_version · add_role · add_workflow_node · connect_workflow_nodes · set_budget · set_context_policy · set_output_schema · set_policy · validate · publishRuns
harness.start_run · get_run · list_runs · list_pending_approvals · retry_stepParticipants
work.list_available · work.claim · work.get_context · work.heartbeat · work.complete · work.failDecisions
council.get_deliberation · submit_proposal · submit_claim · submit_critique · cast_vote · abstain · submit_judgementThe complete generated MCP reference on this site is imported from the server registration. Tool names use dots, and every example must use the exact schema shown there.
council.submit_proposal({
deliberation_id: "deliberation_8f2c1",
author_agent_id: "architect-1",
title: "Separate the worker",
summary: "Move asynchronous delivery into its own service",
body: "This reduces release coupling and scales the queue independently",
confidence: 0.82
})Runtime rules at a glance
- Published versions are immutable; only a published version can be started.
agent_taskandreviewcreate one work item.debateandvotecreatemin_instanceswork items.judgecreates one.condition,loop,human_gate,create_flow_nodes, andendare driven by the runtime.parallel_groupandtransformcurrently do no work and producenode.unimplemented_typewarnings.- Nodes in one council share a deliberation only when their
config.deliberation_keymatches. - Vote rules live in the
votenode config. Debate rounds live inconfig.max_rounds; generic rework lives in aloopnode. - Only
toolspolicy is enforced forwork.*andcouncil.*. Other categories returnpolicy.not_enforced. - Role
output_schemais enforced onwork.complete; the versionoutput_schema(harness.set_output_schema) on steps leading intoend. Mismatches returnoutput.schema_violation, invalid schemasoutput.schema_invalid. harness.set_context_policyselectswork.get_contextsections (run_input,role,predecessors,all_steps), stripsexcludekeys, and caps step outputs withmax_tokens.- Budgets cover run duration, work-item count, reported tokens, and reported cost. An exhausted limit fails the run with
budget.exceeded.
Glossary
- Definition — a named template; Version — a draft or immutable published configuration.
- Run — one execution of a Version; StepRun — one pass through a workflow node; WorkItem — leased work for an external agent.
- Proposal — a decision option; Claim — a verifiable assertion; Evidence — supporting or contradicting material; Critique — a reasoned objection and its responses.
- Deliberation — shared council state; Ballot — a vote over its proposals; Decision — a recorded judgement or winning proposal.
- ApprovalRequest — a human decision requested by
human_gateor arequire_approvaltools policy. - Artifact — a referenced output.
create_flow_nodescan materialize a confirmedoutput.flow_nodeslist as real Flownix nodes.
Frequently asked questions
Can I edit a published version?
No. Create another draft version, or clone the full definition. Existing runs keep their original version.
How does an agent get all context?
Claim the work item and call work.get_context. It returns the run input, source nodes, role, predecessor outputs, deliberation ID, and the ballot for vote work — as selected by the version's context policy.
How do I see why a run is waiting?
Read it with harness.get_run; for human decisions call harness.list_pending_approvals. Agents cannot answer those approvals.
What if an agent misses its lease?
The attempt is spent and the work item returns to the queue while attempts remain. Lease duration and retries come from the workflow node.