NeoSyntropyFramework

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
    )