haiku.rag 0.14.0__py3-none-any.whl → 0.23.0__py3-none-any.whl

README.md

@@ -1,25 +1,22 @@
 # Haiku RAG
 
-Retrieval-Augmented Generation (RAG) library built on LanceDB.
-
-`haiku.rag` is a Retrieval-Augmented Generation (RAG) library built to work with LanceDB as a local vector database. It uses LanceDB for storing embeddings and performs semantic (vector) search as well as full-text search combined through native hybrid search with Reciprocal Rank Fusion. Both open-source (Ollama) as well as commercial (OpenAI, VoyageAI) embedding providers are supported.
-
-> **Note**: Configuration now uses YAML files instead of environment variables. If you're upgrading from an older version, run `haiku-rag init-config --from-env` to migrate your `.env` file to `haiku.rag.yaml`. See [Configuration](https://ggozad.github.io/haiku.rag/configuration/) for details.
+Agentic RAG built on [LanceDB](https://lancedb.com/), [Pydantic AI](https://ai.pydantic.dev/), and [Docling](https://docling-project.github.io/docling/).
 
 ## Features
 
-- **Local LanceDB**: No external servers required, supports also LanceDB cloud storage, S3, Google Cloud & Azure
-- **Multiple embedding providers**: Ollama, VoyageAI, OpenAI, vLLM
-- **Multiple QA providers**: Any provider/model supported by Pydantic AI
-- **Research graph (multi‑agent)**: Plan → Search → Evaluate → Synthesize with agentic AI
-- **Native hybrid search**: Vector + full-text search with native LanceDB RRF reranking
-- **Reranking**: Default search result reranking with MixedBread AI, Cohere, Zero Entropy, or vLLM
-- **Question answering**: Built-in QA agents on your documents
-- **File monitoring**: Auto-index files when run as server
-- **40+ file formats**: PDF, DOCX, HTML, Markdown, code files, URLs
-- **MCP server**: Expose as tools for AI assistants
-- **A2A agent**: Conversational agent with context and multi-turn dialogue
-- **CLI & Python API**: Use from command line or Python
+- **Hybrid search** — Vector + full-text with Reciprocal Rank Fusion
+- **Reranking** — MxBAI, Cohere, Zero Entropy, or vLLM
+- **Question answering** — QA agents with citations (page numbers, section headings)
+- **Research agents** — Multi-agent workflows via pydantic-graph: plan, search, evaluate, synthesize
+- **Document structure** — Stores full [DoclingDocument](https://docling-project.github.io/docling/concepts/docling_document/), enabling structure-aware context expansion
+- **Visual grounding** — View chunks highlighted on original page images
+- **Time travel** — Query the database at any historical point with `--before`
+- **Multiple providers** — Embeddings: Ollama, OpenAI, VoyageAI, LM Studio, vLLM. QA/Research: any model supported by Pydantic AI
+- **Local-first** — Embedded LanceDB, no servers required. Also supports S3, GCS, Azure, and LanceDB Cloud
+- **MCP server** — Expose as tools for AI assistants (Claude Desktop, etc.)
+- **File monitoring** — Watch directories and auto-index on changes
+- **Inspector** — TUI for browsing documents, chunks, and search results
+- **CLI & Python API** — Full functionality from command line or code
 
 ## Installation
 
@@ -31,7 +28,7 @@ Retrieval-Augmented Generation (RAG) library built on LanceDB.
 uv pip install haiku.rag
 ```
 
-Includes all features: document processing, all embedding providers, rerankers, and A2A agent support.
+Includes all features: document processing, all embedding providers, and rerankers.
 
 ### Slim Package (Minimal Dependencies)
 
@@ -44,150 +41,84 @@ Install only the extras you need. See the [Installation](https://ggozad.github.i
 ## Quick Start
 
 ```bash
-# Add documents
-haiku-rag add "Your content here"
-haiku-rag add "Your content here" --meta author=alice --meta topic=notes
-haiku-rag add-src document.pdf --meta source=manual
+# Index a PDF
+haiku-rag add-src paper.pdf
 
 # Search
-haiku-rag search "query"
-
-# Search with filters
-haiku-rag search "query" --filter "uri LIKE '%.pdf' AND title LIKE '%paper%'"
-
-# Ask questions
-haiku-rag ask "Who is the author of haiku.rag?"
+haiku-rag search "attention mechanism"
 
 # Ask questions with citations
-haiku-rag ask "Who is the author of haiku.rag?" --cite
+haiku-rag ask "What datasets were used for evaluation?" --cite
 
-# Deep QA (multi-agent question decomposition)
-haiku-rag ask "Who is the author of haiku.rag?" --deep --cite
+# Deep QA — decomposes complex questions into sub-queries
+haiku-rag ask "How does the proposed method compare to the baseline on MMLU?" --deep
 
-# Deep QA with verbose output
-haiku-rag ask "Who is the author of haiku.rag?" --deep --verbose
+# Research mode — iterative planning and search
+haiku-rag research "What are the limitations of the approach?" --verbose
 
-# Multi‑agent research (iterative plan/search/evaluate)
-haiku-rag research \
-  "What are the main drivers and trends of global temperature anomalies since 1990?" \
-  --max-iterations 2 \
-  --confidence-threshold 0.8 \
-  --max-concurrency 3 \
-  --verbose
+# Interactive research — human-in-the-loop with decision points
+haiku-rag research "Compare the approaches discussed" --interactive
 
-# Rebuild database (re-chunk and re-embed all documents)
-haiku-rag rebuild
-
-# Start server with file monitoring
+# Watch a directory for changes
 haiku-rag serve --monitor
 ```
 
-To customize settings, create a `haiku.rag.yaml` config file (see [Configuration](https://ggozad.github.io/haiku.rag/configuration/)).
+See [Configuration](https://ggozad.github.io/haiku.rag/configuration/) for customization options.
 
-## Python Usage
+## Python API
 
 ```python
 from haiku.rag.client import HaikuRAG
-from haiku.rag.research import (
-    PlanNode,
-    ResearchContext,
-    ResearchDeps,
-    ResearchState,
-    build_research_graph,
-    stream_research_graph,
-)
-
-async with HaikuRAG("database.lancedb") as client:
-    # Add document
-    doc = await client.create_document("Your content")
-
-    # Search (reranking enabled by default)
-    results = await client.search("query")
-    for chunk, score in results:
-        print(f"{score:.3f}: {chunk.content}")
-
-    # Ask questions
-    answer = await client.ask("Who is the author of haiku.rag?")
-    print(answer)
 
-    # Ask questions with citations
-    answer = await client.ask("Who is the author of haiku.rag?", cite=True)
-    print(answer)
+async with HaikuRAG("research.lancedb", create=True) as rag:
+    # Index documents
+    await rag.create_document_from_source("paper.pdf")
+    await rag.create_document_from_source("https://arxiv.org/pdf/1706.03762")
+
+    # Search — returns chunks with provenance
+    results = await rag.search("self-attention")
+    for result in results:
+        print(f"{result.score:.2f} | p.{result.page_numbers} | {result.content[:100]}")
 
-    # Multi‑agent research pipeline (Plan → Search → Evaluate → Synthesize)
-    graph = build_research_graph()
-    question = (
-        "What are the main drivers and trends of global temperature "
-        "anomalies since 1990?"
-    )
-    state = ResearchState(
-        context=ResearchContext(original_question=question),
-        max_iterations=2,
-        confidence_threshold=0.8,
-        max_concurrency=2,
-    )
-    deps = ResearchDeps(client=client)
-
-    # Blocking run (final result only)
-    result = await graph.run(
-        PlanNode(provider="openai", model="gpt-4o-mini"),
-        state=state,
-        deps=deps,
-    )
-    print(result.output.title)
-
-    # Streaming progress (log/report/error events)
-    async for event in stream_research_graph(
-        graph,
-        PlanNode(provider="openai", model="gpt-4o-mini"),
-        state,
-        deps,
-    ):
-        if event.type == "log":
-            iteration = event.state.iterations if event.state else state.iterations
-            print(f"[{iteration}] {event.message}")
-        elif event.type == "report":
-            print("\nResearch complete!\n")
-            print(event.report.title)
-            print(event.report.executive_summary)
+    # QA with citations
+    answer, citations = await rag.ask("What is the complexity of self-attention?")
+    print(answer)
+    for cite in citations:
+        print(f"  [{cite.chunk_id}] p.{cite.page_numbers}: {cite.content[:80]}")
 ```
 
+For research agents and streaming with [AG-UI](https://docs.ag-ui.com/), see the [Agents docs](https://ggozad.github.io/haiku.rag/agents/).
+
 ## MCP Server
 
 Use with AI assistants like Claude Desktop:
 
 ```bash
-haiku-rag serve --stdio
+haiku-rag serve --mcp --stdio
 ```
 
-Provides tools for document management and search directly in your AI assistant.
-
-## A2A Agent
-
-Run as a conversational agent with the Agent-to-Agent protocol:
-
-```bash
-# Start the A2A server
-haiku-rag serve --a2a
-
-# Connect with the interactive client (in another terminal)
-haiku-rag a2aclient
+Add to your Claude Desktop configuration:
+
+```json
+{
+  "mcpServers": {
+    "haiku-rag": {
+      "command": "haiku-rag",
+      "args": ["serve", "--mcp", "--stdio"]
+    }
+  }
+}
 ```
 
-The A2A agent provides:
-
-- Multi-turn dialogue with context
-- Intelligent multi-search for complex questions
-- Source citations with titles and URIs
-- Full document retrieval on request
+Provides tools for document management, search, QA, and research directly in your AI assistant.
 
 ## Examples
 
 See the [examples directory](examples/) for working examples:
 
 - **[Interactive Research Assistant](examples/ag-ui-research/)** - Full-stack research assistant with Pydantic AI and AG-UI featuring human-in-the-loop approval and real-time state synchronization
-- **[Docker Setup](examples/docker/)** - Complete Docker deployment with file monitoring, MCP server, and A2A agent
-- **[A2A Security](examples/a2a-security/)** - Authentication examples (API key, OAuth2, GitHub)
+- **[Docker Setup](examples/docker/)** - Complete Docker deployment with file monitoring and MCP server
+- **[A2A Server](examples/a2a-server/)** - Self-contained A2A protocol server package with conversational agent interface
 
 ## Documentation
 
@@ -198,8 +129,10 @@ Full documentation at: https://ggozad.github.io/haiku.rag/
 - [CLI](https://ggozad.github.io/haiku.rag/cli/) - Command reference
 - [Python API](https://ggozad.github.io/haiku.rag/python/) - Complete API docs
 - [Agents](https://ggozad.github.io/haiku.rag/agents/) - QA agent and multi-agent research
-- [MCP Server](https://ggozad.github.io/haiku.rag/mcp/) - Model Context Protocol integration
-- [A2A Agent](https://ggozad.github.io/haiku.rag/a2a/) - Agent-to-Agent protocol support
-- [Benchmarks](https://ggozad.github.io/haiku.rag/benchmarks/) - Performance Benchmarks
+- [Server](https://ggozad.github.io/haiku.rag/server/) - File monitoring, MCP, and AG-UI
+- [MCP](https://ggozad.github.io/haiku.rag/mcp/) - Model Context Protocol integration
+- [Inspector](https://ggozad.github.io/haiku.rag/inspector/) - Database browser TUI
+- [Benchmarks](https://ggozad.github.io/haiku.rag/benchmarks/) - Performance benchmarks
+- [Changelog](https://ggozad.github.io/haiku.rag/changelog/) - Version history
 
 mcp-name: io.github.ggozad/haiku-rag

haiku_rag-0.23.0.dist-info/METADATA

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: haiku.rag
+Version: 0.23.0
+Summary: Opinionated agentic RAG powered by LanceDB, Pydantic AI, and Docling
+Author-email: Yiorgis Gozadinos <ggozadinos@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: RAG,docling,lancedb,mcp,ml,pydantic-ai,vector-database
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: Microsoft :: Windows :: Windows 11
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: haiku-rag-slim[cohere,docling,inspector,mxbai,voyageai,zeroentropy]==0.23.0
+Provides-Extra: inspector
+Requires-Dist: textual>=1.0.0; extra == 'inspector'
+Description-Content-Type: text/markdown
+
+# Haiku RAG
+
+Agentic RAG built on [LanceDB](https://lancedb.com/), [Pydantic AI](https://ai.pydantic.dev/), and [Docling](https://docling-project.github.io/docling/).
+
+## Features
+
+- **Hybrid search** — Vector + full-text with Reciprocal Rank Fusion
+- **Reranking** — MxBAI, Cohere, Zero Entropy, or vLLM
+- **Question answering** — QA agents with citations (page numbers, section headings)
+- **Research agents** — Multi-agent workflows via pydantic-graph: plan, search, evaluate, synthesize
+- **Document structure** — Stores full [DoclingDocument](https://docling-project.github.io/docling/concepts/docling_document/), enabling structure-aware context expansion
+- **Visual grounding** — View chunks highlighted on original page images
+- **Time travel** — Query the database at any historical point with `--before`
+- **Multiple providers** — Embeddings: Ollama, OpenAI, VoyageAI, LM Studio, vLLM. QA/Research: any model supported by Pydantic AI
+- **Local-first** — Embedded LanceDB, no servers required. Also supports S3, GCS, Azure, and LanceDB Cloud
+- **MCP server** — Expose as tools for AI assistants (Claude Desktop, etc.)
+- **File monitoring** — Watch directories and auto-index on changes
+- **Inspector** — TUI for browsing documents, chunks, and search results
+- **CLI & Python API** — Full functionality from command line or code
+
+## Installation
+
+**Python 3.12 or newer required**
+
+### Full Package (Recommended)
+
+```bash
+uv pip install haiku.rag
+```
+
+Includes all features: document processing, all embedding providers, and rerankers.
+
+### Slim Package (Minimal Dependencies)
+
+```bash
+uv pip install haiku.rag-slim
+```
+
+Install only the extras you need. See the [Installation](https://ggozad.github.io/haiku.rag/installation/) documentation for available options
+
+## Quick Start
+
+```bash
+# Index a PDF
+haiku-rag add-src paper.pdf
+
+# Search
+haiku-rag search "attention mechanism"
+
+# Ask questions with citations
+haiku-rag ask "What datasets were used for evaluation?" --cite
+
+# Deep QA — decomposes complex questions into sub-queries
+haiku-rag ask "How does the proposed method compare to the baseline on MMLU?" --deep
+
+# Research mode — iterative planning and search
+haiku-rag research "What are the limitations of the approach?" --verbose
+
+# Interactive research — human-in-the-loop with decision points
+haiku-rag research "Compare the approaches discussed" --interactive
+
+# Watch a directory for changes
+haiku-rag serve --monitor
+```
+
+See [Configuration](https://ggozad.github.io/haiku.rag/configuration/) for customization options.
+
+## Python API
+
+```python
+from haiku.rag.client import HaikuRAG
+
+async with HaikuRAG("research.lancedb", create=True) as rag:
+    # Index documents
+    await rag.create_document_from_source("paper.pdf")
+    await rag.create_document_from_source("https://arxiv.org/pdf/1706.03762")
+
+    # Search — returns chunks with provenance
+    results = await rag.search("self-attention")
+    for result in results:
+        print(f"{result.score:.2f} | p.{result.page_numbers} | {result.content[:100]}")
+
+    # QA with citations
+    answer, citations = await rag.ask("What is the complexity of self-attention?")
+    print(answer)
+    for cite in citations:
+        print(f"  [{cite.chunk_id}] p.{cite.page_numbers}: {cite.content[:80]}")
+```
+
+For research agents and streaming with [AG-UI](https://docs.ag-ui.com/), see the [Agents docs](https://ggozad.github.io/haiku.rag/agents/).
+
+## MCP Server
+
+Use with AI assistants like Claude Desktop:
+
+```bash
+haiku-rag serve --mcp --stdio
+```
+
+Add to your Claude Desktop configuration:
+
+```json
+{
+  "mcpServers": {
+    "haiku-rag": {
+      "command": "haiku-rag",
+      "args": ["serve", "--mcp", "--stdio"]
+    }
+  }
+}
+```
+
+Provides tools for document management, search, QA, and research directly in your AI assistant.
+
+## Examples
+
+See the [examples directory](examples/) for working examples:
+
+- **[Interactive Research Assistant](examples/ag-ui-research/)** - Full-stack research assistant with Pydantic AI and AG-UI featuring human-in-the-loop approval and real-time state synchronization
+- **[Docker Setup](examples/docker/)** - Complete Docker deployment with file monitoring and MCP server
+- **[A2A Server](examples/a2a-server/)** - Self-contained A2A protocol server package with conversational agent interface
+
+## Documentation
+
+Full documentation at: https://ggozad.github.io/haiku.rag/
+
+- [Installation](https://ggozad.github.io/haiku.rag/installation/) - Provider setup
+- [Configuration](https://ggozad.github.io/haiku.rag/configuration/) - YAML configuration
+- [CLI](https://ggozad.github.io/haiku.rag/cli/) - Command reference
+- [Python API](https://ggozad.github.io/haiku.rag/python/) - Complete API docs
+- [Agents](https://ggozad.github.io/haiku.rag/agents/) - QA agent and multi-agent research
+- [Server](https://ggozad.github.io/haiku.rag/server/) - File monitoring, MCP, and AG-UI
+- [MCP](https://ggozad.github.io/haiku.rag/mcp/) - Model Context Protocol integration
+- [Inspector](https://ggozad.github.io/haiku.rag/inspector/) - Database browser TUI
+- [Benchmarks](https://ggozad.github.io/haiku.rag/benchmarks/) - Performance benchmarks
+- [Changelog](https://ggozad.github.io/haiku.rag/changelog/) - Version history
+
+mcp-name: io.github.ggozad/haiku-rag

haiku_rag-0.23.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+README.md,sha256=aFW4_ghsf-SUJzlYFq9RC2NO5nu7BFjqG6n5-cRYcyQ,5287
+haiku_rag-0.23.0.dist-info/METADATA,sha256=txl5cEtHupw_PJPl3k-a4hj-s-7aYkLFXlKc4voHBmI,6279
+haiku_rag-0.23.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+haiku_rag-0.23.0.dist-info/entry_points.txt,sha256=G1U3nAkNd5YDYd4v0tuYFbriz0i-JheCsFuT9kIoGCI,48
+haiku_rag-0.23.0.dist-info/licenses/LICENSE,sha256=eXZrWjSk9PwYFNK9yUczl3oPl95Z4V9UXH7bPN46iPo,1065
+haiku_rag-0.23.0.dist-info/RECORD,,

{haiku_rag-0.14.0.dist-info → haiku_rag-0.23.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

haiku_rag-0.14.0.dist-info/METADATA

@@ -1,227 +0,0 @@
-Metadata-Version: 2.4
-Name: haiku.rag
-Version: 0.14.0
-Summary: Agentic Retrieval Augmented Generation (RAG) with LanceDB
-Author-email: Yiorgis Gozadinos <ggozadinos@gmail.com>
-License: MIT
-License-File: LICENSE
-Keywords: RAG,lancedb,mcp,ml,vector-database
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows :: Windows 10
-Classifier: Operating System :: Microsoft :: Windows :: Windows 11
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Typing :: Typed
-Requires-Python: >=3.12
-Requires-Dist: haiku-rag-slim[a2a,cohere,docling,mxbai,voyageai,zeroentropy]
-Description-Content-Type: text/markdown
-
-# Haiku RAG
-
-Retrieval-Augmented Generation (RAG) library built on LanceDB.
-
-`haiku.rag` is a Retrieval-Augmented Generation (RAG) library built to work with LanceDB as a local vector database. It uses LanceDB for storing embeddings and performs semantic (vector) search as well as full-text search combined through native hybrid search with Reciprocal Rank Fusion. Both open-source (Ollama) as well as commercial (OpenAI, VoyageAI) embedding providers are supported.
-
-> **Note**: Configuration now uses YAML files instead of environment variables. If you're upgrading from an older version, run `haiku-rag init-config --from-env` to migrate your `.env` file to `haiku.rag.yaml`. See [Configuration](https://ggozad.github.io/haiku.rag/configuration/) for details.
-
-## Features
-
-- **Local LanceDB**: No external servers required, supports also LanceDB cloud storage, S3, Google Cloud & Azure
-- **Multiple embedding providers**: Ollama, VoyageAI, OpenAI, vLLM
-- **Multiple QA providers**: Any provider/model supported by Pydantic AI
-- **Research graph (multi‑agent)**: Plan → Search → Evaluate → Synthesize with agentic AI
-- **Native hybrid search**: Vector + full-text search with native LanceDB RRF reranking
-- **Reranking**: Default search result reranking with MixedBread AI, Cohere, Zero Entropy, or vLLM
-- **Question answering**: Built-in QA agents on your documents
-- **File monitoring**: Auto-index files when run as server
-- **40+ file formats**: PDF, DOCX, HTML, Markdown, code files, URLs
-- **MCP server**: Expose as tools for AI assistants
-- **A2A agent**: Conversational agent with context and multi-turn dialogue
-- **CLI & Python API**: Use from command line or Python
-
-## Installation
-
-**Python 3.12 or newer required**
-
-### Full Package (Recommended)
-
-```bash
-uv pip install haiku.rag
-```
-
-Includes all features: document processing, all embedding providers, rerankers, and A2A agent support.
-
-### Slim Package (Minimal Dependencies)
-
-```bash
-uv pip install haiku.rag-slim
-```
-
-Install only the extras you need. See the [Installation](https://ggozad.github.io/haiku.rag/installation/) documentation for available options
-
-## Quick Start
-
-```bash
-# Add documents
-haiku-rag add "Your content here"
-haiku-rag add "Your content here" --meta author=alice --meta topic=notes
-haiku-rag add-src document.pdf --meta source=manual
-
-# Search
-haiku-rag search "query"
-
-# Search with filters
-haiku-rag search "query" --filter "uri LIKE '%.pdf' AND title LIKE '%paper%'"
-
-# Ask questions
-haiku-rag ask "Who is the author of haiku.rag?"
-
-# Ask questions with citations
-haiku-rag ask "Who is the author of haiku.rag?" --cite
-
-# Deep QA (multi-agent question decomposition)
-haiku-rag ask "Who is the author of haiku.rag?" --deep --cite
-
-# Deep QA with verbose output
-haiku-rag ask "Who is the author of haiku.rag?" --deep --verbose
-
-# Multi‑agent research (iterative plan/search/evaluate)
-haiku-rag research \
-  "What are the main drivers and trends of global temperature anomalies since 1990?" \
-  --max-iterations 2 \
-  --confidence-threshold 0.8 \
-  --max-concurrency 3 \
-  --verbose
-
-# Rebuild database (re-chunk and re-embed all documents)
-haiku-rag rebuild
-
-# Start server with file monitoring
-haiku-rag serve --monitor
-```
-
-To customize settings, create a `haiku.rag.yaml` config file (see [Configuration](https://ggozad.github.io/haiku.rag/configuration/)).
-
-## Python Usage
-
-```python
-from haiku.rag.client import HaikuRAG
-from haiku.rag.research import (
-    PlanNode,
-    ResearchContext,
-    ResearchDeps,
-    ResearchState,
-    build_research_graph,
-    stream_research_graph,
-)
-
-async with HaikuRAG("database.lancedb") as client:
-    # Add document
-    doc = await client.create_document("Your content")
-
-    # Search (reranking enabled by default)
-    results = await client.search("query")
-    for chunk, score in results:
-        print(f"{score:.3f}: {chunk.content}")
-
-    # Ask questions
-    answer = await client.ask("Who is the author of haiku.rag?")
-    print(answer)
-
-    # Ask questions with citations
-    answer = await client.ask("Who is the author of haiku.rag?", cite=True)
-    print(answer)
-
-    # Multi‑agent research pipeline (Plan → Search → Evaluate → Synthesize)
-    graph = build_research_graph()
-    question = (
-        "What are the main drivers and trends of global temperature "
-        "anomalies since 1990?"
-    )
-    state = ResearchState(
-        context=ResearchContext(original_question=question),
-        max_iterations=2,
-        confidence_threshold=0.8,
-        max_concurrency=2,
-    )
-    deps = ResearchDeps(client=client)
-
-    # Blocking run (final result only)
-    result = await graph.run(
-        PlanNode(provider="openai", model="gpt-4o-mini"),
-        state=state,
-        deps=deps,
-    )
-    print(result.output.title)
-
-    # Streaming progress (log/report/error events)
-    async for event in stream_research_graph(
-        graph,
-        PlanNode(provider="openai", model="gpt-4o-mini"),
-        state,
-        deps,
-    ):
-        if event.type == "log":
-            iteration = event.state.iterations if event.state else state.iterations
-            print(f"[{iteration}] {event.message}")
-        elif event.type == "report":
-            print("\nResearch complete!\n")
-            print(event.report.title)
-            print(event.report.executive_summary)
-```
-
-## MCP Server
-
-Use with AI assistants like Claude Desktop:
-
-```bash
-haiku-rag serve --stdio
-```
-
-Provides tools for document management and search directly in your AI assistant.
-
-## A2A Agent
-
-Run as a conversational agent with the Agent-to-Agent protocol:
-
-```bash
-# Start the A2A server
-haiku-rag serve --a2a
-
-# Connect with the interactive client (in another terminal)
-haiku-rag a2aclient
-```
-
-The A2A agent provides:
-
-- Multi-turn dialogue with context
-- Intelligent multi-search for complex questions
-- Source citations with titles and URIs
-- Full document retrieval on request
-
-## Examples
-
-See the [examples directory](examples/) for working examples:
-
-- **[Interactive Research Assistant](examples/ag-ui-research/)** - Full-stack research assistant with Pydantic AI and AG-UI featuring human-in-the-loop approval and real-time state synchronization
-- **[Docker Setup](examples/docker/)** - Complete Docker deployment with file monitoring, MCP server, and A2A agent
-- **[A2A Security](examples/a2a-security/)** - Authentication examples (API key, OAuth2, GitHub)
-
-## Documentation
-
-Full documentation at: https://ggozad.github.io/haiku.rag/
-
-- [Installation](https://ggozad.github.io/haiku.rag/installation/) - Provider setup
-- [Configuration](https://ggozad.github.io/haiku.rag/configuration/) - YAML configuration
-- [CLI](https://ggozad.github.io/haiku.rag/cli/) - Command reference
-- [Python API](https://ggozad.github.io/haiku.rag/python/) - Complete API docs
-- [Agents](https://ggozad.github.io/haiku.rag/agents/) - QA agent and multi-agent research
-- [MCP Server](https://ggozad.github.io/haiku.rag/mcp/) - Model Context Protocol integration
-- [A2A Agent](https://ggozad.github.io/haiku.rag/a2a/) - Agent-to-Agent protocol support
-- [Benchmarks](https://ggozad.github.io/haiku.rag/benchmarks/) - Performance Benchmarks
-
-mcp-name: io.github.ggozad/haiku-rag

haiku_rag-0.14.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-README.md,sha256=N8nk6cs6JkWHAmVz3ci7lTiLr6Xq_UqifWGivZnuPJU,7216
-haiku_rag-0.14.0.dist-info/METADATA,sha256=I3H0hBrGIgDwtIvFe9tnu2-PeLESLlhEHVrgmrKCnr4,8085
-haiku_rag-0.14.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-haiku_rag-0.14.0.dist-info/entry_points.txt,sha256=G1U3nAkNd5YDYd4v0tuYFbriz0i-JheCsFuT9kIoGCI,48
-haiku_rag-0.14.0.dist-info/licenses/LICENSE,sha256=eXZrWjSk9PwYFNK9yUczl3oPl95Z4V9UXH7bPN46iPo,1065
-haiku_rag-0.14.0.dist-info/RECORD,,