Skip to the content.

FlowCraft

Go SDK for building AI agents with long-term memory, knowledge retrieval, runtime orchestration, and voice. Source on github.com/GizClaw/flowcraft.

Guides

Runtime

State and execution boundary

Assembly

Delegation

Cross-cutting

Migrations

Older sdk/sdkx migration notes remain in docs/migrations/ as historical reference and are not part of the current core migration path.

Layered architecture

The repository is organised as independently released Go modules, and core is layered: a package imports only from the layers below it.

Layer Packages Responsibility
Contracts core/message (+media), core/errdefs, core/permission, core/fsx, core/skill, core/correlation The vocabulary every other layer speaks: messages, error classes, permissions, file handles, skills, the run identity.
Inference core/inference (+model, outcome, protocol, route), core/inference-openai, core/inference-anthropic Model contracts, routing, and the two protocol families that ship with the platform.
Tools core/tool (+engine, middleware), core/tool-builtin/*, core/tool-mcp The function-calling contract, the projection, and the built-in adapters.
Sandbox core/sandbox (+engine, journal, netpolicy), core/sandbox-* The command boundary: contract, policy decorators, backends.
Execution core/agent (+checkpoint), core/agent-graph, core/agent-a2a, core/delegation Runs: the engine contract, the graph engine, the A2A client, delegation.
Assembly core/runtime One runtime per configuration document, owning what it built.
Deployment core/deploy (+engines/*, protocols/*, builtin), core/agent-host Documents and kind tables; host bindings, sessions, lifecycle.
Observability core/telemetry Tracing, run records, attributes.

core/internal/... holds module-private helpers and is never importable outside core.

Repository layout

core/            Platform module (contracts, inference, tools, sandbox, runtime, deploy)
driver/          Provider adapters that are not protocol families (bytedance, dashscope, minimax)
examples/        forge (graph demo, a workspace member) · parallel (outside consumer)
skills/          flowcraft-deploy: reference cards, templates, validator
tools/           Release gate, fuzz and stress scripts

Getting started

go get github.com/GizClaw/flowcraft/core@latest

Every package carries a doc.go stating what it is and what it deliberately is not; start there, then read the guide above for the layer you are wiring.