Metadata-Version: 2.4
Name: langchain-fodda
Version: 1.0.0
Summary: LangChain custom tool integration for the Fodda Context Layer
Author-email: Fodda / PSFK Team <team@fodda.ai>
License-Expression: MIT
Project-URL: Homepage, https://fodda.ai
Project-URL: Documentation, https://fodda.ai/connect
Project-URL: Repository, https://github.com/fodda-ai/langchain-fodda
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: langchain-core>=0.1.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0

# langchain-fodda

Official LangChain custom tool integration for the **Fodda Context Layer** — verified knowledge graphs, live supplemental market intelligence, and working Human Agents for autonomous AI reasoning models.

## Installation

```bash
pip install langchain-fodda
```

## Quickstart

```python
from langchain_fodda import FoddaContextRetriever

# Initialize tool (API key optional for unauthenticated discovery / x402 on-chain settlement)
fodda_tool = FoddaContextRetriever(api_key="sk_live_...")

# Query a knowledge graph
result = fodda_tool.run("psfk-retail")
print(result)
```

## Features

- **Autonomous 402 Paywall Handling**: Gracefully catches HTTP 402 challenges. If no credentials or wallet are configured, it automatically falls back to Fodda's verified markdown schema summaries (`free_readme`) so the LLM reasoning loop never crashes.
- **Base USDC Micro-Settlement**: Supports on-chain 5¢ Base USDC payments via `X-402-Payment`.
- **Stripe Shared Payment Tokens (SPT)**: Supports zero-friction bearer token settlement.

## License

MIT
