Skip to content

docs: add connecting-agent-frameworks, tool-catalog-authoring, advisory-mode-debugging tutorials#335

Merged
imran-siddique merged 2 commits into
mainfrom
docs/new-tutorials
Jun 22, 2026
Merged

docs: add connecting-agent-frameworks, tool-catalog-authoring, advisory-mode-debugging tutorials#335
imran-siddique merged 2 commits into
mainfrom
docs/new-tutorials

Conversation

@imran-siddique

Copy link
Copy Markdown
Contributor

Summary

Three tutorials covering day-0/day-1 gaps identified in the tutorial audit:

  • Connecting agent frameworks — how to wire LangChain, LlamaIndex, and a raw httpx client to the gateway; bearer token auth, _cmcp metadata block, workflow_id passthrough, handling denied calls
  • Tool catalog authoring — full catalog.json field reference; how definition_hash and catalog_hash are computed (with reproducible Python snippets); schema_validation_mode values (redact/strict/log) and when to use each; complete two-tool example
  • Advisory mode debuggingenforcing/advisory/silent mode differences; would_have_denied signal in _cmcp; policy_decision: "advisory_deny" in the audit chain; workflow for moving from advisory to enforcing

All content verified against actual source: loader.py (definition_hash, catalog_hash computation), config.py (EnforcementMode values), server.py (endpoints, auth, _cmcp fields), chain.py (audit entry fields, advisory_deny decision value).

Test plan

  • CI passes (lint, type check, tests)
  • mkdocs serve renders all three new pages without errors
  • Links in "Related tutorials" sections resolve correctly

🤖 Generated with Claude Code

imran-siddique and others added 2 commits June 22, 2026 13:09
…ry-mode-debugging tutorials

Three day-0/day-1 gap tutorials:
- connecting-agent-frameworks: how to wire LangChain, LlamaIndex, and httpx to the gateway with bearer auth and _cmcp metadata handling
- tool-catalog-authoring: full catalog.json field reference, definition_hash and catalog_hash computation, schema_validation_mode
- advisory-mode-debugging: enforcing/advisory/silent mode differences, would_have_denied signal, audit chain advisory_deny entries, tuning workflow

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@imran-siddique imran-siddique merged commit f9e5e67 into main Jun 22, 2026
10 checks passed
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