treeship-sdk
Python SDK for Treeship -- portable trust receipts for agent workflows.
Install
pip install treeship-sdk
Requires the treeship CLI binary in PATH:
curl -fsSL treeship.dev/install | sh
treeship init
Usage
from treeship_sdk import Treeship
ts = Treeship()
# Attest an action
result = ts.attest_action(actor="agent://my-agent", action="tool.call")
print(result.artifact_id) # art_abc123...
# Attest a decision (LLM reasoning)
ts.attest_decision(
actor="agent://analyst",
model="claude-opus-4",
tokens_in=8432,
tokens_out=1247,
summary="Contract looks standard.",
confidence=0.91,
)
# Attest an approval
approval = ts.attest_approval(
approver="human://alice",
description="approve payment max $500",
allowed_actions=["payments.charge"], # a scope is required
max_uses=1,
)
print(approval.nonce) # binding token; replay enforcement is package-local in v0.9.6
# Attest with approval binding
ts.attest_action(
actor="agent://executor",
action="stripe.charge.create",
approval_nonce=approval.nonce,
)
# Verify
result = ts.verify("art_abc123")
print(result.outcome) # "pass"
# Push to Hub
push = ts.hub_push("art_abc123")
print(push.hub_url) # https://treeship.dev/verify/art_abc123
# Wrap a command
result = ts.wrap("npm test", actor="agent://ci")
print(result.artifact_id)
API
| Method | Returns | Description |
|---|---|---|
attest_action(actor, action, ...) |
ActionResult |
Sign an action receipt |
attest_approval(approver, description, allowed_actions=..., ...) |
ApprovalResult |
Sign a scoped approval with nonce |
attest_handoff(from_actor, to_actor, artifacts) |
ActionResult |
Sign a handoff receipt |
attest_decision(actor, model, ...) |
ActionResult |
Sign a decision receipt |
verify(artifact_id) |
VerifyResult |
Verify an artifact chain |
hub_push(artifact_id) |
PushResult |
Push artifact to the configured Hub |
wrap(command, actor) |
ActionResult |
Wrap a shell command |
How it works
The SDK calls the treeship CLI binary via subprocess. All signing happens in the Rust binary. The Python SDK is a thin wrapper.
License
Apache-2.0
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
treeship_sdk-0.31.0.tar.gz
(34.8 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file treeship_sdk-0.31.0.tar.gz.
File metadata
- Download URL: treeship_sdk-0.31.0.tar.gz
- Upload date:
- Size: 34.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5976d8710a43295210f249c3212f4ff4212a32a4b6153ff780df86f22feac856
|
|
| MD5 |
e840949878b2baa4f8e0f0c8e09fae54
|
|
| BLAKE2b-256 |
5c86b10de5729cda1acb5818b98a123daa619e03d18e2d3e7abf1e32a559cbfb
|
File details
Details for the file treeship_sdk-0.31.0-py3-none-any.whl.
File metadata
- Download URL: treeship_sdk-0.31.0-py3-none-any.whl
- Upload date:
- Size: 27.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e1d16530b1933771e3e63421cfb7cecc85c887e101005d9ec108d1e139f17ca
|
|
| MD5 |
56ba7a9e6a8e15453fa8cf947eab7d08
|
|
| BLAKE2b-256 |
df9a8d836bf7f74167b5f200ea67f3a3fa18cde0c2f90923ec1f893b1f2e6aec
|
