tide-runtime 0.2.7

Tide runtime policy, approvals, and earned-use ledger for AI agent tools.

Tide Runtime SDK

Python SDK for wrapping production agent tools with Tide policy, approvals, and earned-use logging.

pip install tide-runtime
tide init --pack support-refunds --environment prod

tide init --dry-run --pack <name> prints the policy before writing it. Built-in packs: baseline, support-refunds, sql-analyst, mcp-baseline.

To have Tide suggest wrappers for an existing Python agent:

tide scan --path . --pack support-refunds
$EDITOR .tide/tide-plan.json
tide apply --interactive --write-policy

Use tide apply --yes --write-policy to accept the reviewed plan non-interactively.

from tide import configure, controlled_tool, record_outcome

configure(agent_id="crm-agent", workflow_id="lead-sync", environment="prod")

@controlled_tool(name="crm.update_lead", risk_class="internal_write", capture=["lead_id"])
def update_lead(lead_id, status):
    return {"lead_id": lead_id, "status": status}

try:
    update_lead("L-1", "qualified")
    record_outcome("success")
except Exception:
    record_outcome("failure")
    raise

Default files live in .tide/ledger/. Override with TIDE_LEDGER_DIR or configure(project="...").

tide approvals
tide approve <id>
tide deny <id> --reason "not in scope"
tide report