Skip to content

feat: add composable Go agent packages and a durable runtime - #2

Merged
piotrlaczkowski merged 5 commits into
mainfrom
codex/go-native-agent-packages
Nov 14, 2026
Merged

piotrlaczkowski merged 5 commits into
mainfrom
codex/go-native-agent-packages

Conversation

@piotrlaczkowski

@piotrlaczkowski piotrlaczkowski commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Agents can now be authored and distributed as ordinary Go modules, then composed and executed by GoLangGraph. The new experimental contract is Go-native: it has no TypeScript runtime dependency or Standard Agent Specification compatibility claim.

  • Add a standard-library-only SDK for immutable packages, typed prompt/tool agents, pure Go handlers, exact child dependencies, strict schemas and inspectable manifests.
  • Add a graph runtime with isolated persistent parent/child threads, atomic dependency registration, pinned versions/models/definition fingerprints, cancellation, call budgets and typed invocation checks.
  • Record request intent before execution. Completed request IDs return their saved result; conflicts fail, and interrupted runs require explicit recovery instead of automatic replay. Persist correlated execution traces.
  • Add golanggraph package init and package inspect, three independent example agent modules, and an offline/live consumer demonstrating both reusable composition and application-owned graph workflows.
  • Document authoring, distribution, recovery guarantees, and which concepts remain future host features. Include nested modules and manifest fuzzing in CI.
  • Pin scanner releases and use Go 1.27.4 for CI, release and Docker builds. This restores scanner/toolchain compatibility and addresses standard-library findings such as GO-2026-6859.
  • Keep generated Docker CI artifacts inside the checkout so current Bake builds respect their filesystem boundary. Align all generated Dockerfiles with the patched builder image.

Validation: full repository tests with the race detector passed locally and in CI on Go 1.27.4. CI reports 71.1% package source coverage (65% floor). Independent modules, CLI-generated module compilation, manifest fuzzing, separate-process restart/deduplication, Linux/Windows builds, and dependency-boundary checks passed. Lint and GoSec are clean. Govulncheck on Go 1.27.4 reports no reachable vulnerabilities.

The API remains experimental. One Runtime must own a thread's writes; external effects and parent/child commits are not a distributed transaction. Modules are local development versions pending a separate SDK release. Offline tests do not certify a live model.

@piotrlaczkowski
piotrlaczkowski merged commit 5a348d6 into main Nov 14, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant