Skip to main content

Setrya

Setrya tests whether a background job or a reopened AI chat can bring deleted data back. Run a deletion against a test subject in your LangGraph app, read the result as two users, and give a reviewer a receipt they can replay. Setrya also tests access revocation, tenant offboarding, and search updates.

Tests Offline qualification

Erase a test subject · Replay an access change · Review a tenant deletion · Test your own endpoint

Erase a test subject

Alice’s chart was deleted. A worker still holds an old snapshot. When two care-team members reopen the saved handoff, can either of them see Alice again? Run the fictional example on a laptop with Python 3.11+.

python -m pip install 'setrya[erasure]'
setrya demo erasure --output alice
setrya replay alice/guarded
Run What the two users see Receipt
Broken worker Alice returns in the reopened chat. FAIL
Guarded worker Alice stays gone. Both users can still read Bob’s chart. PASS
Provider copy The app is clear. The provider’s storage cannot be inspected. NOT TESTED · one unknown copy

Run setrya init erasure to connect your own fixture, worker and read path. The receipt lists the copies observed in the journal or discovered in declared stores. A reviewer can check the signature and replay it without your app. Starter · Evidence and signing · Download the signed example

Replay an access change

Two colleagues ask an internal AI assistant about the staff refund policy. You revoke one person’s access and clear their cached answer. They ask again and get the public policy. Then a background job that read the private policy before revocation finishes.

In a Python 3.11+ environment, install the SDK and CLI and replay the recorded responses. The demo uses two synthetic accounts and runs offline after installation.

python -m pip install setrya
setrya demo access
What happened Person who lost access Colleague who kept access
The worker was still paused Public policy · 14 days Staff policy · 45 days
The worker wrote its old answer · FAIL Staff policy · 45 days Staff policy · 45 days
The guarded worker rejected the write · PASS Public policy · 14 days Staff policy · 45 days

A third recording returns NOT TESTED because the endpoint evidence doesn’t identify who made the request. A pass covers the callers, question, and timing the test exercised. See what a reviewer gets in a pull request.

Review a tenant deletion

A customer leaves. Your app deletes their ticket and summary, but a worker still has the ticket it was summarizing. Run the live example against a local SQLite app with fictional tenants. Choose a fresh output directory.

setrya offboarding demo --output offboarding-run

The broken worker puts the summary back where a support agent can read it. The fixed worker discards the stale write. The test also checks that the agent can still read the other tenant’s summary.

The demo also creates a receipt for a separate staging deletion request. It checks the source, stored summary, and support endpoint after deletion and again after the worker finishes. All six checks pass. A provider reports deletion, but a backup is still on a retention schedule. You can see both results in offboarding-run/receipt/receipt.json.

Technical verdict PASS
Review status OPEN_ITEMS

A reviewer can verify the receipt against the original request, job evidence, and attachments offline. Offboarding guide · Download the example receipt and evidence

Test your own endpoint

Start in a disposable checkout of your application with two signed-in synthetic users.

python -m pip install 'setrya[pytest]'
setrya init endpoint

Connect the generated answer(caller, question) hook to your HTTP route and set the expected answers. Run the first check with both sessions before wiring up the worker.

python -m pytest -q -s -p setrya.pytest_plugin --setrya-reads-only tests/test_setrya_endpoint.py

This first check exits 1 with NOT TESTED. Once you connect the worker and the access change, run the test without --setrya-reads-only. Endpoint guide · Celery and LangChain starter

Review the result in a pull request

Run the connected test on two Git revisions. Setrya reports FIX VERIFIED when the old worker exposed the private answer on the base commit and the same case passes for both users on the candidate. A teammate can replay either result after the app shuts down.

setrya run-pr --endpoint --repo . --base origin/main --candidate HEAD \
  --output endpoint-review -- python -m pytest -q tests/test_setrya_endpoint.py

In the approvals example, the delayed worker restored a private answer for the revoked reviewer. After the fix, the reviewer got public guidance and the owner still got the private answer. Open review.md in the download and run its Review again command to reproduce FIX VERIFIED offline. Read the FIX VERIFIED report · Download both runs and the two fixture commits

Routine PRs can pass on both commits. Download the two-pass example · GitHub Actions recipe

Search, caching, and the Python SDK

  • Search freshness. Run setrya demo to see an old indexing job bring back a 30-day refund policy after its 14-day replacement was already searchable. The live demo uses SQLite FTS5. Test other worker schedules · Try pgvector
  • Answer caching. Track which source revisions went into an answer and invalidate affected entries in memory or Redis. Local cache · Redis cache
  • Existing tests. Record a worker’s actions and search results with the setrya_record pytest fixture. A coverage map can flag changed routes and jobs that lack matching evidence. Record a test · Check route coverage

Contributing · Security policy · Apache 2.0 license

Metadata

Release files for setrya 0.16.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for setrya 0.16.0
File Size Uploaded Provenance Actions
setrya-0.16.0.tar.gz 299.8 kB With provenance Details for setrya-0.16.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for setrya 0.16.0
File Interpreter ABI Platform Actions
setrya-0.16.0-py3-none-any.whl Python 3 none any Details for setrya-0.16.0-py3-none-any.whl

Total release size: 555.2 kB

Release files / setrya-0.16.0.tar.gz

Download URL setrya-0.16.0.tar.gz
Size 299.8 kB
Tags Source
SHA-256 checksum
How to use checksums
4d6f94feec11d399fc79527729bb402c527c71bff2c2a7f2001f2bf08df4ac2a
BLAKE2b-256 checksum
How to use checksums
c002f84cc5b1fac56fd6b5b9e3d2682a4bb37751f1ade98a2149bc474047545a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / setrya-0.16.0-py3-none-any.whl

Download URL setrya-0.16.0-py3-none-any.whl
Size 255.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dbf4234b435749a4b79729f79df5321483a6fc422a7bdc3c15ba56f21918869a
BLAKE2b-256 checksum
How to use checksums
62d5ba51030c8b3a2a3c1fc46a710edc3bcfe5179943862529af0c1edddc0a0f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Security for setrya 0.16.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for setrya-0.16.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page