Metadata-Version: 2.4
Name: actiongate-langchain
Version: 0.2.0
Summary: Gate LangChain tool execution through ActionGate primitives before execution.
Project-URL: Homepage, https://github.com/actiongate-oss/actiongate-langchain
Project-URL: Documentation, https://github.com/actiongate-oss/actiongate-langchain#readme
Project-URL: Repository, https://github.com/actiongate-oss/actiongate-langchain
Author-email: ActionGate OSS <actiongate-oss@users.noreply.github.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: actiongate,ai-agents,execution-control,langchain,tool-use
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: actiongate>=0.2.2
Requires-Dist: langchain-core>=0.2.0
Provides-Extra: all
Requires-Dist: auditgate>=0.2.0; extra == 'all'
Requires-Dist: budgetgate>=0.3.0; extra == 'all'
Requires-Dist: rulegate>=0.2.2; extra == 'all'
Provides-Extra: audit
Requires-Dist: auditgate>=0.2.0; extra == 'audit'
Provides-Extra: budget
Requires-Dist: budgetgate>=0.3.0; extra == 'budget'
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Provides-Extra: rules
Requires-Dist: rulegate>=0.2.2; extra == 'rules'
Description-Content-Type: text/markdown

# actiongate-langchain

Gate LangChain tool execution through [ActionGate](https://github.com/actiongate-oss/actiongate) primitives.

```
pip install actiongate-langchain
```

## Quick start

```python
from actiongate import Engine, Gate, Policy
from actiongate_langchain import gated_tool

ag = Engine()

@gated_tool(
    actiongate=ag,
    gate=Gate("tools", "search", "agent:1"),
    policy=Policy(max_calls=10, window=60),
)
def search_web(query: str) -> str:
    """Search the web for a query."""
    return api.search(query)

# Use with any LangChain agent
agent = create_react_agent(llm, [search_web], prompt)
```

The tool checks all gates before execution. If any gate blocks, it raises `ToolException` with the block reason — LangChain agents handle this automatically.

## Add more gates

```
pip install actiongate-langchain[all]
```

```python
from actiongate import Engine as AG, Gate, Policy
from budgetgate import Engine as BG, Ledger, Budget
from rulegate import Engine as RG, Rule, Ruleset, Context
from actiongate_langchain import gated_tool
from decimal import Decimal

def no_pii(ctx: Context) -> bool:
    return "ssn" not in str(ctx.kwargs).lower()

ag, bg, rg = AG(), BG(), RG()

@gated_tool(
    actiongate=ag,
    gate=Gate("tools", "search", "agent:1"),
    policy=Policy(max_calls=10, window=60),
    budgetgate=bg,
    ledger=Ledger("openai", "search", "agent:1"),
    budget=Budget(max_spend=Decimal("5.00"), window=3600),
    cost=Decimal("0.01"),
    rulegate=rg,
    rule=Rule("tools", "search"),
    ruleset=Ruleset(predicates=(no_pii,)),
)
def search_web(query: str) -> str:
    """Search the web for a query."""
    return api.search(query)
```

Gates evaluate in order: ActionGate → BudgetGate → RuleGate → execute → AuditGate.

## GatedTool class

For more control, use `GatedTool.from_function()` directly:

```python
from actiongate_langchain import GatedTool

tool = GatedTool.from_function(
    func=search_fn,
    name="search_web",
    description="Search the web",
    actiongate=ag,
    gate=Gate("tools", "search", "agent:1"),
    policy=Policy(max_calls=10, window=60),
)
```

## License

Apache-2.0. ActionGate and BudgetGate are Apache-2.0. RuleGate and AuditGate are BSL-1.1.
