Skip to content

docs(grayswan): describe what post_call sends to Cygnal - #1968

Merged
yucheng-berri merged 1 commit into
mainfrom
litellm_grayswan_post_call_context_docs
Oct 1, 2026
Merged

yucheng-berri merged 1 commit into
mainfrom
litellm_grayswan_post_call_context_docs

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

Summary

Documents the Gray Swan post_call behavior shipped in BerriAI/litellm#43770 (LIT-6628). The page only said post_call scans "Model Outputs", so admins had no way to know that Cygnal now also receives the request conversation, the request tools and the answer's tool calls

The new "What Cygnal receives on post_call" section under Choosing Guardrail Modes covers four things. A post_call-only setup now sends user prompts and tool results to Gray Swan. Tool-call-only answers are scanned, so block can return 400 and fail_open: false can fail those requests. The skip flags scope what is sent, scan_only_tool_results also drops the request tools, and Cygnal gets the answer alone when the conversation can't be read. Per-chunk streaming checks carry the conversation too

The post_call row in the mode table is updated to match, and two existing typos are fixed ("recommmended", "treu")

scripts/check-writing-style.js is clean on the page. scripts/check-docs.py reports 4 errors, all in docs/harness/ and the same on main

Link to Devin session: https://app.devin.ai/sessions/6b56dc5062414c51b44c3f65cbcad683
Open in Devin Desktop: https://app.devin.ai/desktop/session/6b56dc5062414c51b44c3f65cbcad683?variant=devin
Requested by: @yucheng-berri

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

  • Disable automatic comment, CI, and merge conflict monitoring

@vercel

vercel Bot commented Oct 1, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
litellm Ready Ready Preview Oct 1, 2026 1:00am UTC

Request Review

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Devin Review

@yucheng-berri
yucheng-berri enabled auto-merge (squash) October 1, 2026 00:57
@yucheng-berri
yucheng-berri merged commit 9e6ac53 into main Oct 1, 2026
4 of 5 checks passed
@yucheng-berri
yucheng-berri deleted the litellm_grayswan_post_call_context_docs branch October 1, 2026 01:00

This branch was successfully deployed

1 active deployment
Preview — 1ea152f2 Deployed Oct 1, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant