go

Go IR core

Primary SDK for Phase 1B (epic #113). Full Trajectory IR stack under trajir/. Python remains the supported reference and parity port from Phase 1A.

Packages

Integrations contract: docs/INTEGRATIONS.md.

Durable backend decision (issues #16 and #24)

Model inference and tools must go through durable.Step / Infer / Tool. Block and gate still relies on the NodeLog for NON_IDEMPOTENT_WRITE.

Temporal (optional)

Env (defaults match local Temporal dev server):

Run a worker process that calls temporal.NewWorker and Run. Use temporal.Dial or temporal.NewBackend as a durable.Backend with durable.Infer / durable.Tool / resume.RunStep.

Default go test ./... does not need Temporal. Optional live check:

# with Temporal listening on localhost:7233 and a worker on trajectory-ir
go test -tags=temporal_integration ./trajir/durable/temporal -count=1 -v

Client usage

tr, err := client.OpenTrajectory("demo", "t1", client.Options{WorkDir: dir})
// ...
results, err := tr.RunStep(ctx, 1, model, tools, map[string]any{"k": "v"})
// reopen same workdir
tr2, err := client.Resume("demo", "t1", client.Options{WorkDir: dir})

Demo: kill mid deploy

Human runnable story (seal, kill, resume):

cd go
go run ./examples/kill_mid_deploy -workdir ./kill_mid_deploy-data -crash-during=tool_call
# kill when deploy starts, then:
go run ./examples/kill_mid_deploy -workdir ./kill_mid_deploy-data -resume

See examples/kill_mid_deploy/README.md.

Portable packages (.tir)

Matches the Python reference in pkg/trajectory_ir/package/tir.py (README §9).

import (
    nodelog "github.com/Coder-s-OG-s/Trajectory-IR/go/trajir/log"
    "github.com/Coder-s-OG-s/Trajectory-IR/go/trajir/tir"
)

// Export thin package
path, err := tir.Export(nl, "t-export", "out.tir", tir.ExportOptions{Mode: tir.ModeThin})

// Import (always verifies node ids; idempotent append)
pkg, err := tir.Import(path, nl)

// Load without writing to a log
pkg, err = tir.Load(path)

Fat mode uses the same CAS layout: artifacts/cas/<2-char-shard>/<sha256>. Optional package signatures: tir.Sign / tir.Verify and Export SignKey (trajir-pkg-sig-v1). Unsigned remains the default. Redacted export is Python-only for now.

Cross-language fixtures: testdata/sample_thin.tir and testdata/sample_signed.tir (regenerate with python scripts/gen_tir_fixture.py).

Test

cd go
go test ./...

Crash resume conformance (R01/R02 style) lives under conformance/. Package signatures: R09–R11.

1. In-process tests always run (panic after seal, TOOL_CALL pre-seed for gate).
2. Subprocess tests build cmd/crashagent, hard-kill at markers, then resume. They skip if the host blocks running the binary (some Windows policies).

cd go
go test ./conformance -count=1 -v