Framework / Contracts
Type the boundary. Commit state deliberately.
Pydantic contracts validate capability inputs and outputs while NodeContext separates immutable request input from committed workflow state.Pick the narrowest contract
- Use a Pydantic model for production inputs and outputs.
- OpenInput and OpenOutput accept flexible payloads while a contract is still evolving.
- EmptyOutput marks a capability that intentionally returns no data.
- TextOutput standardizes a single message field.
Input and state are different
Pythonpython
@node(id="Approve", input_schema=ApprovalRequest, output_schema=ApprovalResult)
def approve(ctx):
request = ctx.input # validated input for this invocation
prior = ctx.state # state committed by earlier nodes
return ctx.result(
output={"approved": request.amount <= 100},
state_updates={"reviewed_by": "policy-v1"},
next_state="End", # proposal; graph validation still applies
)