Browse the guides
ZAMBO / INTEGRATIONS
AI Framework Receipts
By Brennan Zambo
In short: These pages show honest patterns for recording framework agent tool calls as verifiable execution receipts. They use framework names descriptively and do not claim a native plugin, partnership, endorsement, or built-in support.
Each page explains how to preserve the task, tool call, observed result, timestamp, and verification path. The framework remains the caller's context; the receipt is the independent record of what the execution layer observed.
Installable adapters
zambo-openai-agents
pip install zambo-openai-agents
Give an agent Zambo's live tools. Zambo records each executed tool call as a verifiable receipt, and the receipt URL can be attached to the agent trace. Free access follows the published allowance, with no account required.
PyPI page
Framework patterns
AI agent answers · AI agent execution receipts · The AER-1 Internet-Draft · Install the Zambo MCP
What this question can establish
The practical question behind AI Framework Receipts is whether the record supports the claim being reviewed. A team is connecting an agent framework to tools and needs to understand what the integration exposes, what it records, and how review works. Separate the request, the execution, the system's observed output, and confirmation from any outside system. These are different evidence boundaries, and a reviewer should not treat them as interchangeable.
Choose an integration based on the host's supported transport and the evidence it preserves. LangChain and CrewAI are examples of framework contexts, not claims that every feature is supported. A useful conclusion names the evidence that was checked and the conditions that remain unresolved. This keeps an execution record useful without stretching it into a broader assurance claim.
Evidence to retain for this workflow
Start with the smallest set of fields that lets a second reviewer identify the event and repeat the relevant check. For this topic, Check the connection URL, tool discovery response, argument schema, caller scope, execution result, receipt link, and any required read-back from the connected system.
- Task boundary: record the requested state and what would count as acceptance.
- Execution identity: preserve the receipt ID, tool name, caller scope, time, and status.
- Committed result: keep canonical bytes or the published representation needed to recompute the output hash.
- Provenance: distinguish an action the system ran from one it observed or merely received as a report.
- External confirmation: capture a real callback, transaction reference, read-back, or provider record when the task depends on outside state.
- Review context: note who checked the record, which verifier was used, and any limitation that affected the conclusion.
A repeatable review sequence
Use the same order for routine checks and incident review. It prevents a later summary from replacing the evidence the task actually requires.
- State the requirement. Write the expected outcome and the exact source that can confirm it. A team is connecting an agent framework to tools and needs to understand what the integration exposes, what it records, and how review works.
- Locate the execution. Match the public receipt identifier to the requested event, then confirm the tool, scope, timestamp, and status.
- Check integrity. Decode the committed bytes as specified by the receipt format, recompute SHA-256, and compare the complete digest rather than a shortened preview.
- Check the owning system. When the claim involves an outside change, query that system or inspect its genuine callback. A receipt alone cannot supply a missing confirmation.
- Write a bounded finding. Record what ran, what was observed, whether the bytes matched, and what remains unknown. Choose an integration based on the host's supported transport and the evidence it preserves. LangChain and CrewAI are examples of framework contexts, not claims that every feature is supported.
Failure states and misleading success signals
Preserve failed, blocked, pending, retried, and partially completed states as distinct outcomes. A framework adapter can make a tool callable without making every result independently verified. Missing schemas, permissions, or provider responses should remain explicit. A successful transport response can still contain a tool error, and a valid integrity check can still protect an incorrect or incomplete result.
When evidence conflicts, keep both records and identify which system owns each fact. Do not overwrite an earlier receipt or silently promote a retry into proof that the original step succeeded. Explain whether the conflict is a timing issue, a stale read, a missing callback, a policy boundary, or a different task interpretation.
Privacy, retention, and safe sharing
Reviewability does not require publishing every input. Keep credentials in the host's secret store, not in prompts or receipts. Review how each framework handles logs, retries, and sharing before enabling real data. Prefer stable references and cryptographic commitments where they are enough for the reviewer, and keep the underlying sensitive record with the system that controls it.
Before sharing, check the public page, result preview, metadata, and linked evidence for secrets or personal information. Set retention and access according to the review purpose. If a record must be corrected, publish a new reference and preserve the original history rather than rewriting a record that another reviewer may already have captured.
Example of a careful conclusion
A reviewer could write: “The receipt identifies the recorded tool call and timestamp. The SHA-256 digest matches the exposed canonical bytes. The result preview is consistent with the stored record. Choose an integration based on the host's supported transport and the evidence it preserves. LangChain and CrewAI are examples of framework contexts, not claims that every feature is supported. No additional outside outcome is claimed unless the owning system supplied its own confirmation.”
This kind of note gives the next person a useful handoff: what was checked, what the check means, and where the evidence stops. It is more informative than a bare success label and avoids presenting an unobserved event as a verified fact.
Common review questions
What does the record establish?
It establishes what the execution system recorded and whether the exposed canonical bytes match the output commitment. For ai framework receipts, it does not by itself establish correctness or a result outside that system.
What if a provider or callback is unavailable?
Keep the state pending or unavailable, retain the error and time, and avoid claiming completion. In this workflow, A framework adapter can make a tool callable without making every result independently verified. Missing schemas, permissions, or provider responses should remain explicit.
What should a reviewer inspect first?
Check the connection URL, tool discovery response, argument schema, caller scope, execution result, receipt link, and any required read-back from the connected system. Then compare the record with the task requirement and ask the system that owns any claimed external state for a separate read-back.
What is safe to share?
Share the public receipt URL, identifier, status, verifier result, and a short sanitized task description. Keep credentials in the host's secret store, not in prompts or receipts. Review how each framework handles logs, retries, and sharing before enabling real data.
Try a reviewable tool call
Use the install guide to connect Zambo, make a bounded request, and inspect the receipt before relying on any outside outcome.
The free tier does not require an account. Check the pricing page for the current per-tool allowance before you start.
Open the Zambo install guide