gagentic v0.1.0

First public release of gagentic, a Go framework for building agentic workflows around a generic graph engine and John Boyd's OODA loop.

Highlights

Core

• Graph engine (graph): generic directed workflow graphs parameterised by any state type, with static and conditional edges, cycles, parallel fan-out, and custom reducers
• Runtime executor (runtime): parallel frontier execution, recursion limits, structured event stream (node_start, node_end, checkpoint, ...) for observability
• Checkpointing: Checkpointer interface with in-memory and PostgreSQL (runtime/pgcheckpoint) implementations, thread-based resume and time travel to any historical checkpoint
• OODA agent (ooda): opinionated Observe/Orient/Decide/Act loop with Boyd's five orientation facets running as parallel goroutines, synthesizer, tool-calling decider, and immutable audit history

LLM layer

• Provider-neutral client (llm): chat + tool calling, token streaming via iter.Seq2
• Adapters for OpenAI and Anthropic, plus a scripted fake client for tests and offline demos

Tools

• tool.Wrap: turn plain typed Go functions into LLM tools, JSON Schema generated via reflection from struct tags (json, desc, required)
• Registry with concurrent InvokeAll execution

Examples

Example	Shows
examples/checkpointing	crash recovery + time travel, no external deps
examples/typedtools	typed tools, schema reflection, parallel invocation
examples/streaming	token streaming with offline fallback
examples/fanout	parallel nodes, custom reducer, event timeline
examples/hitl	human-in-the-loop gate with PostgreSQL checkpointing
examples/implementations/business	OODA business strategy agent

Install

go get github.com/GiesN/gagentic@v0.1.0

Requires Go 1.26+. Status: pre-alpha, APIs may change.