Trajectory IR Logotrajectory_ir
Get Started
Trajectory IR LogoTrajectory IR
0.2.x∨
API Reference

.tir package

Thin vs fat packages, hash verification, and trajir-pkg-sig-v1 signatures.

A .tir package is a portable archive of a trajectory. Another runtime or auditor can verify node identity by content hash.

Thin vs fat

ModeContentsUse
ThinMetadata + hashes (artifacts by reference)Lightweight share / CI
FatMetadata + artifact bytesFull audit / offline replay
RedactedSensitive fields stripped/hashedExternal sharing

Export / import

  • Go: trajir/tir (Export / Load, optional ExportOptions.SignKey)
  • Python: export_tir / import_tir (optional sign_key=); package helpers under trajectory_ir.package

Signatures (trajir-pkg-sig-v1)

Package-level Ed25519 signatures are shipped (conformance R09–R11):

  • Domain-separated payload digest
  • Optional SIGNATURE member
  • Unsigned remains the default unless you sign
  • Cross-language verify (Go ↔ Python) is tested

Sigstore integration remains future work.

EffectClass

All six effect classes, fail-closed defaults, block-and-gate, and sandbox behavior.

CLI (trajirctl)

Operate Trajectory IR workdirs from the terminal, and wire trajir-mcp for agent hosts.

On this page

Thin vs fatExport / importSignatures (trajir-pkg-sig-v1)Related