langchain-ai/docs
1
0
Fork 0
mirror of https://github.com/langchain-ai/docs.git synced 2026-07-22 12:25:55 -04:00
Code Issues 490 Packages Projects Releases Wiki Activity

[PR #3645] docs: add Signet integration (callbacks + provider) #3681

New Issue
Open
opened 2026-06-05 18:52:48 -04:00 by yindo · 0 comments
yindo commented 2026-06-05 18:52:48 -04:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/3645
Author: @willamhou
Created: 4/21/2026
Status: 🔄 Open

Base: main ← Head: add-signet-integration

📝 Commits (1)

  • 3d42374 docs: add Signet integration page

📊 Changes

2 files changed (+168 additions, -0 deletions)

View changed files

➕ src/oss/python/integrations/callbacks/signet.mdx (+158 -0)
➕ src/oss/python/integrations/providers/signet.mdx (+10 -0)

📄 Description

What this adds

This PR adds Signet to the Python integrations under Callbacks and Providers.

  • src/oss/python/integrations/callbacks/signet.mdx — documents the SignetCallbackHandler exported from signet-auth[langchain]. Signs each tool lifecycle event (on_tool_start + either on_tool_end or on_tool_error) with Ed25519 and appends each receipt to a local hash-chained JSONL audit log.
  • src/oss/python/integrations/providers/signet.mdx — provider overview that links to the callback page.

Why it fits LangChain's docs

  • It sits in the same category as the existing AgentSystems Notary page (src/oss/python/integrations/callbacks/agentsystems_notary.mdx) but operates one layer below the transcript: receipts are per-tool-call, not per-LLM-payload. The two integrations are complementary.
  • The integration is a plain BaseCallbackHandler (plus an async variant). No framework changes. Users attach it via config={"callbacks": [handler]}, the same pattern as every other callback integration.
  • Verification is fully offline — Python methods on the agent, or a standalone CLI.

Verification

Checks

  • Vale prose lint passes (make lint_prose) — 0 errors, 0 warnings, 0 suggestions across both files
  • Code example runs end-to-end against current signet-auth (0.9.1) + langchain-core (1.3.0): result='5254', handler.receipts length == 2 (start + _tool_end)
  • All CLI commands, imports, and method names verified against bindings/signet-py/python/signet_auth/langchain.py and agent.py
  • No existing docs or navigation touched (two new files only, no docs.json changes)
  • make dev local render — please verify on merge CI / reviewer preview

Notes for reviewers

  • signet-auth does not follow the langchain-<name> package naming convention, so it is not added to packages.yml. Happy to ship a thin langchain-signet wrapper and register it in a follow-up if maintainers prefer.
  • Positioning is neutral toward AgentSystems Notary; the two pages describe different layers (transcript vs tool call) and are designed to be usable together.

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langchain-ai/docs/pull/3645 **Author:** [@willamhou](https://github.com/willamhou) **Created:** 4/21/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `add-signet-integration` --- ### 📝 Commits (1) - [`3d42374`](https://github.com/langchain-ai/docs/commit/3d423742df6f04a21aa048710f21beb691323490) docs: add Signet integration page ### 📊 Changes **2 files changed** (+168 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `src/oss/python/integrations/callbacks/signet.mdx` (+158 -0) ➕ `src/oss/python/integrations/providers/signet.mdx` (+10 -0) </details> ### 📄 Description ## What this adds This PR adds [Signet](https://github.com/Prismer-AI/signet) to the Python integrations under Callbacks and Providers. - `src/oss/python/integrations/callbacks/signet.mdx` — documents the `SignetCallbackHandler` exported from `signet-auth[langchain]`. Signs each tool lifecycle event (`on_tool_start` + either `on_tool_end` or `on_tool_error`) with Ed25519 and appends each receipt to a local hash-chained JSONL audit log. - `src/oss/python/integrations/providers/signet.mdx` — provider overview that links to the callback page. ## Why it fits LangChain's docs - It sits in the same category as the existing AgentSystems Notary page (`src/oss/python/integrations/callbacks/agentsystems_notary.mdx`) but operates one layer below the transcript: receipts are per-tool-call, not per-LLM-payload. The two integrations are complementary. - The integration is a plain `BaseCallbackHandler` (plus an async variant). No framework changes. Users attach it via `config={"callbacks": [handler]}`, the same pattern as every other callback integration. - Verification is fully offline — Python methods on the agent, or a standalone CLI. ## Verification - Package on PyPI: https://pypi.org/project/signet-auth/ - Installable as `pip install signet-auth[langchain]` — the `langchain` extra is declared in [bindings/signet-py/pyproject.toml](https://github.com/Prismer-AI/signet/blob/main/bindings/signet-py/pyproject.toml) - End-to-end runnable example in-repo: https://github.com/Prismer-AI/signet/tree/main/examples/langchain-compliance - Callback source: https://github.com/Prismer-AI/signet/blob/main/bindings/signet-py/python/signet_auth/langchain.py ## Checks - [x] Vale prose lint passes (`make lint_prose`) — 0 errors, 0 warnings, 0 suggestions across both files - [x] Code example runs end-to-end against current `signet-auth` (0.9.1) + `langchain-core` (1.3.0): `result='5254'`, `handler.receipts` length == 2 (start + `_tool_end`) - [x] All CLI commands, imports, and method names verified against `bindings/signet-py/python/signet_auth/langchain.py` and `agent.py` - [x] No existing docs or navigation touched (two new files only, no `docs.json` changes) - [ ] `make dev` local render — please verify on merge CI / reviewer preview ## Notes for reviewers - `signet-auth` does not follow the `langchain-<name>` package naming convention, so it is not added to `packages.yml`. Happy to ship a thin `langchain-signet` wrapper and register it in a follow-up if maintainers prefer. - Positioning is neutral toward AgentSystems Notary; the two pages describe different layers (transcript vs tool call) and are designed to be usable together. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-06-05 18:52:48 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
deepagents
docs-infra
external
external
help wanted
integration
internal
internal
javascript
js/ts
langchain
langgraph
langsmith
needs-title
pull-request
Mirrored from GitHub Pull Request
 python
reference
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#3681
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?