SingleAxis Fabric recorder SDK for Python

The Python SDK adds passive OpenTelemetry activity capture to an AI agent. It records enough identity and causal context to reconstruct model calls, tool calls, retrieval, memory activity, side effects, delegation, retries and failures. It does not block or alter the agent.

CAPTURE -> PROTECT -> DELIVER
   ^
   |
Python SDK (optional instrumentation)

Protection and delivery happen in the customer-controlled Fabric Node. Raw LLM content capture is disabled by default.

Install

pip install singleaxis-fabric

Add OTLP export and only the integrations you use:

pip install "singleaxis-fabric[otlp,openai]"

Capture one agent decision

from fabric import Fabric, FabricConfig

fabric = Fabric(FabricConfig(tenant_id="acme", agent_id="support-agent"))

with fabric.decision(session_id="session-42", request_id="request-7") as decision:
    with decision.llm_call(provider="provider-example", model="model-example") as call:
        # Invoke the customer's model client here.
        call.set_response(model="model-example")

    with decision.tool_call("lookup_order", call_id="tool-1") as tool:
        tool.set_arguments('{"order_id":"order-123"}')
        # Invoke the customer's tool here.
        tool.set_result('{"status":"shipped"}')

The SDK hashes tool payloads locally. It does not send telemetry by itself; configure the OpenTelemetry provider/exporter used by the host application to send to Fabric Node.

Use Fabric.execution(...) to correlate multiple decisions and the retrieval, memory, side-effect, checkpoint, delegation and generic-interaction methods on Decision to capture consequential activity beyond LLM and tool calls.

Stable recorder-v1 surface

The fabric package root exports capture, activity-correlation, governed content-reference and integrity primitives only. Framework and provider instrumentation remain optional extras.

It does not export or install judges, evaluation workers, guardrail engines, prompt-time PII/NeMo controls, policy engines, tool authorization, escalation enforcement or management-plane commands.

Recorder-v1 artifacts do not contain the former runtime-control, judge, evaluation, policy, authorization or escalation modules. Their former Decision methods and Fabric constructor parameters have also been removed; this is an intentional breaking boundary so installing the recorder cannot put enforcement behavior in an agent's request path.

See the SDK scope and recorder-v1 spec for the authoritative boundary.

Development

uv sync --all-extras --dev
uv run pytest
uv run ruff check src tests
uv run mypy src

Development Status
- 4 - Beta
Intended Audience
- Developers
License
- OSI Approved :: Apache Software License
Programming Language
Typing
- Typed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

singleaxis_fabric-0.8.0rc2.tar.gz (77.3 kB view details)

Uploaded Aug 31, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

singleaxis_fabric-0.8.0rc2-py3-none-any.whl (92.5 kB view details)

Uploaded Aug 31, 2026 Python 3

File details

Details for the file singleaxis_fabric-0.8.0rc2.tar.gz.

File metadata

Download URL: singleaxis_fabric-0.8.0rc2.tar.gz
Upload date: Aug 31, 2026
Size: 77.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for singleaxis_fabric-0.8.0rc2.tar.gz
Algorithm	Hash digest
SHA256	`b216e33c7aa415793914ed2bacefe133d29b4b19ded860e5473ba7a688e11d14`
MD5	`21ff8e6d6feaef2add7c1d371a35751c`
BLAKE2b-256	`7bb75ce5bf4f401768426d1797a262a13e2cd632476fd487673011a5afe9afa0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for singleaxis_fabric-0.8.0rc2.tar.gz:

Publisher: release.yml on singleaxis/singleaxis-fabric

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: singleaxis_fabric-0.8.0rc2.tar.gz
- Subject digest: b216e33c7aa415793914ed2bacefe133d29b4b19ded860e5473ba7a688e11d14
- Sigstore transparency entry: 2661842429
- Sigstore integration time: Aug 31, 2026
Source repository:
- Permalink: singleaxis/singleaxis-fabric@ab959605c891947cfdfbdc8f0c627a0252004bdc
- Branch / Tag: refs/tags/v0.8.0-rc.2
- Owner: https://github.com/singleaxis
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@ab959605c891947cfdfbdc8f0c627a0252004bdc
- Trigger Event: push