NeoSyntropyFramework

Framework / Composition

Compose subgraphs. Allowlist tools.

Groups package a named subgraph. ToolRegistry supplies callable functions, but each reasoning node still declares which tools it may request.

Groups are named subgraphs

A Group can define its own entry, internal nodes, routers, and edges. The outer graph may target the group while the compiled FSM preserves each internal transition.

Tools require two permissions

  • Register the callable in ToolRegistry.
  • Allowlist its name on the reasoning step or node that may request it.
  • Validate and authorize arguments before executing side effects.
  • Return results as evidence and inspect tool-call records in the audit trail.
Pythonpython
from neosyntropy import ToolRegistry, tool

registry = ToolRegistry()

@tool(registry=registry)
def lookup_order(args: OrderLookup) -> dict:
    return order_service.get(args.order_id)

reason = StochasticReasoningNode(
    id="Investigate",
    input_schema=SupportRequest,
    output_schema=Investigation,
    tools=["lookup_order"],  # node-level allowlist
    prompt="Look up the order and summarize the evidence.",
)

result = workflow.run(request, client=client, tools=registry)