Skip to content

Tracekit 1.0.0

Choose a tag to compare

@LoopGlitch26 LoopGlitch26 released this 11 Oct 04:30
· 342 commits to main since this release
b1aa330

Install: pip install tracekit-ai — then add import tracekit; tracekit.instrument() to your agent and run tracekit last. Container image: ghcr.io/cygnux-labs/tracekit-signer:v1.0.0 (@sha256:d9cbad7dc635959d9812ec7a7507c5d306199285d29a29aa2f7839ee583c8e95).

Verify this release: the wheel and sdist below are the files PyPI serves (SHA256SUMS); each carries SLSA build provenance from this repository's release workflow (gh attestation verify tracekit_ai-1.0.0-py3-none-any.whl --repo Cygnux-Labs/Tracekit), the image is cosign-signed (keyless), and the CycloneDX SBOMs of the package and the image are attached. The npm packages (@cygnux/tracekit) are not published for 1.0.0 yet; use the TypeScript SDK from this repository until they are. Known limits and trade-offs: docs/limits.md.

1.0.0 is 1.0.0rc2 made stable: the v2 signer, evidence format v2 and its verifier, witnesses, the monitor, team approvals,
server deployments (container, Kubernetes sidecar, central signer on Postgres) and the run viewer. The v2 format is now
stable: 1.x verifiers verify every 1.0 bundle, and a bundle that needs a newer verifier says so (UNVERIFIABLE), never
FAILED. The v1 laptop setup and v1 bundles keep working unchanged. Upgrade notes from 0.4.0: see 1.0.0rc1 below.

Added

  • One install, one line, a verified run. pip install tracekit-ai now installs everything the dev signer needs
    (tracekit-ai[signer] still works); pip install --no-deps tracekit-ai is the verifier alone, on the standard
    library. import tracekit; tracekit.instrument() wires the frameworks it finds (OpenAI Agents SDK, LangGraph /
    LangChain, Claude Agent SDK, MCP, and the OpenAI, Anthropic and Google Gen AI SDKs), starting a dev signer if none
    is running. tracekit last exports the newest finished run, pins the dev signer's key and verifies it. The README
    and each framework quickstart are those three steps. What this path doesn't cover:
    docs/limits.md.
  • docs/limits.md: every known limit and trade-off on one page.

Changed

  • tracekit.instrument(tracer) (v1 model-call tracing) is now tracekit.autotrace.instrument(tracer);
    tracekit.instrument() raises a TypeError naming it when given a tracer.

Fixed

  • A network service that refused a request before reading its body (wrong Host, missing session or CSRF token) could
    reset the connection before the client read the answer, on Windows always and elsewhere while a large body was
    still arriving. Each service now reads what the client sent, up to 1 MiB, before closing.
  • A config file written as JSON (signer.yaml, the viewer's and the gateway's) failed to load where PyYAML isn't
    installed, which tracekit-ai[signer] doesn't install. JSON documents now load either way.

Release

  • npm: no @cygnux/tracekit-signer-darwin-x64 package (google-re2 and cryptography publish no Intel-Mac wheels it can
    use). On an Intel Mac, pip install 'tracekit-ai[signer]'; @cygnux/tracekit uses that tracekit from PATH.
  • Releases are built and published by the attested release workflow: PyPI files, npm packages and the signer image
    carry SLSA build provenance and SBOMs, the image is cosign-signed, and SHA256SUMS is attached to the GitHub release
    (docs/RELEASING.md).
  • SECURITY.md: 1.x is the supported line.