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.
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 demoto 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_recordpytest fixture. A coverage map can flag changed routes and jobs that lack matching evidence. Record a test · Check route coverage
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.