From 9d6d65b018fa4d8ab4906ec97139aac276aebb94 Mon Sep 17 00:00:00 2001
From: Beon de Nood <beon@bigdune.net>
Date: Sat, 2 May 2026 11:11:54 -0400
Subject: [PATCH 1/2] docs: fix Documentation URL in PyPI metadata

Old URL docs.capisc.io/integrations/langchain returns 404.
Updated to actual published path at /how-to/integrations/langchain/.

Fixes: DOCS_REMEDIATION_PLAN P2-4
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index dca613f..d159aa8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -33,7 +33,7 @@ dependencies = [
 [project.urls]
 Homepage = "https://capisc.io"
 Repository = "https://github.com/capiscio/langchain-capiscio"
-Documentation = "https://docs.capisc.io/integrations/langchain"
+Documentation = "https://docs.capisc.io/how-to/integrations/langchain/"
 Issues = "https://github.com/capiscio/langchain-capiscio/issues"
 
 [tool.hatch.build.targets.wheel]

From b67d4b130a13c13c7e58433e6f7286df86365969 Mon Sep 17 00:00:00 2001
From: Beon de Nood <beon@bigdune.net>
Date: Sat, 2 May 2026 11:35:48 -0400
Subject: [PATCH 2/2] docs: fix CapiscioTool signature, add pydantic dep,
 langgraph note

- CapiscioTool uses keyword-only args (*, identity, config, mode, api_key)
  not positional (tool, mode, identity, api_key). Fixed API reference.
- Added pydantic>=2.0 to dependencies (directly imported in guard.py).
- Added note that langgraph is a separate install for LCEL example.
- Fixed dead CONTRIBUTING.md link (file doesn't exist).

Fixes: DOCS_REMEDIATION_PLAN P2-11
---
 README.md      | 7 +++++--
 pyproject.toml | 1 +
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 87c8a0c..20c752d 100644
--- a/README.md
+++ b/README.md
@@ -60,6 +60,9 @@ guard = CapiscioGuard(mode="log")      # Log only
 
 `CapiscioGuard` is a LangChain `Runnable` — compose it with any chain or agent via the `|` operator:
 
+> **Note**: The example below uses [LangGraph](https://langchain-ai.github.io/langgraph/).
+> Install it separately: `pip install langgraph`
+
 ```python
 from langchain_capiscio import CapiscioGuard
 from langgraph.prebuilt import create_react_agent
@@ -249,7 +252,7 @@ set_capiscio_context(CapiscioRequestContext(
 
 ### Tool Enforcement
 
-- `CapiscioTool(tool, mode, identity, api_key)` — Wrap a LangChain `Tool` with trust enforcement
+- `CapiscioTool(tool, *, identity=None, config=None, mode="block", api_key=None)` — Wrap a LangChain `Tool` with trust enforcement
 - `verify_badge` — `@tool`-decorated function for agent-driven badge verification
 - `resolve_agent_card` — `@tool`-decorated function for agent card resolution
 
@@ -292,4 +295,4 @@ Apache License 2.0
 
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+Contributions welcome! Please open an issue or pull request on [GitHub](https://github.com/capiscio/langchain-capiscio).
diff --git a/pyproject.toml b/pyproject.toml
index d159aa8..d359499 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -28,6 +28,7 @@ classifiers = [
 dependencies = [
     "capiscio-sdk>=2.6.0",
     "langchain-core>=0.3",
+    "pydantic>=2.0",
 ]
 
 [project.urls]