Skip to content

Implement v0.1: agentic RAG mesh (LangGraph agent + MCP retrieval server + FAISS) - #1

Merged
BaliDataMan merged 4 commits into
mainfrom
feature/v0.1-implementation
Sep 4, 2026
Merged

BaliDataMan merged 4 commits into
mainfrom
feature/v0.1-implementation

Conversation

@BaliDataMan

Copy link
Copy Markdown
Owner

Summary

  • Single LangGraph ReAct-style agent (create_agent) talks to a real MCP retrieval server over streamable-http, not an in-process function call.
  • Retrieval: local embeddings (sentence-transformers/all-MiniLM-L6-v2) + FAISS, indexed over the repo's own docs (self-referential sample corpus).
  • Config-driven LLM provider swap (Anthropic/OpenAI/Bedrock) via init_chat_model.
  • FastAPI POST /chat + thin CLI, Docker Compose (agent-api + mcp-server containers), hermetic unit test suite + opt-in Docker integration test, CI (ruff/mypy/pytest), 3 ADRs + architecture rationale + developer guide.

Test plan

  • ruff check . clean
  • mypy src clean
  • pytest tests/unit -v — 7/7 passing
  • docker compose up --build — both containers build and start; mcp-server healthy; agent-api startup completes
  • GET /health returns 200
  • FAISS retrieval verified directly inside the running container
  • POST /chat reaches the Anthropic client correctly (fails only on account-level billing in local testing, not a wiring issue)

BaliDataMan and others added 4 commits September 4, 2026 22:50
Single LangGraph agent talks to a real MCP tool server over
streamable-http, backed by a local FAISS vector store built over the
repo's own docs. Config-driven LLM provider swap (Anthropic/OpenAI/
Bedrock) via init_chat_model.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Hermetic unit suite (fake embeddings/chat model, in-memory MCP
session) needs no network or API key. Integration tier actually runs
docker compose and hits /chat, opt-in only (needs a live LLM key).
CI runs ruff, mypy, and the unit suite on every push/PR.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
mcp-server builds the FAISS index at image build time and serves it
over streamable-http, internal-only. agent-api depends on its
healthcheck and exposes POST /chat on host port 8080.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
project-docs/ holds the public architecture record: three ADRs for
the closest judgment calls, the fuller rationale doc, and an
end-to-end developer guide. README gets a Mermaid architecture
diagram, quickstart, and CI badge.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@BaliDataMan
BaliDataMan merged commit c909f2c into main Sep 4, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant