Skip to content

plan: optional Eggsearch/MCP tools, embeddings, and retrieval interoperability - #9

Merged
dbowm91 merged 63 commits into
mainfrom
plan/optional-tools-privategpt-parity-20261103
Nov 6, 2026
Merged

dbowm91 merged 63 commits into
mainfrom
plan/optional-tools-privategpt-parity-20261103

Conversation

@dbowm91

@dbowm91 dbowm91 commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

Purpose

Planning-only follow-up to the Eggpool versus PrivateGPT/Zylon gap review. Keeps Eggpool an on-prem Rust inference gateway by default; tools/hosted execution are explicit opt-in; vectors/ingestion remain outside the router.

Documents

  • Proposed ADR-0007: optional MCP tool authority, per-user scopes and separately versioned hosted tool execution.
  • Proposed ADR-0008: typed, bounded embeddings inference route and capability qualification.
  • Three new subsystem roadmaps: tool-integration, embedding-routing, retrieval-interoperability.
  • Six bounded milestone implementation plans with source evidence, dependency typing, implementation packages, negative test matrices, stop gates and closure requirements.
  • plans/registry.md amended with all workstreams, one ready milestone, five blocked milestones and exact blockers.

Handoff order

  1. Tool T001 (ready): operator-only Eggsearch backend config and readiness diagnostics; no exposed MCP API.
  2. Tool T002 (blocked): accept ADR-0007 and close T001; add default-deny user/profile grants and scoped credentials.
  3. Tool T003 (blocked): authenticated, tool-filtered MCP gateway after T002.
  4. Tool T004 (blocked): explicit finite model→tool→model operation after T003.
  5. Embeddings E001 (blocked): accept ADR-0008; qualify typed /v1/embeddings route, provider/model eligibility, admission and accounting. Independent of tool milestones.
  6. Retrieval R001 (blocked): external RAG/PrivateGPT integration and ACL/citation contract, after T003. Embeddings route optional interface.

Invariants

No mandatory Eggsearch/embedding service; no arbitrary external MCP URLs; no default changes to Chat/Responses/Messages/compact or native/client-owned tool handling; no vector store/new SQLite writer, no prompt/tool-body retention; no bypass of user budgets, policy, generation leases or coordinator finalization.

Verification

Planning-file structural and registry checks performed; comparison against main confirms 12 documentation-only files, no runtime or test changes. Cargo suites / live MCP qualification are not run for this planning-only PR. All future implementation plans require serial default and no-default Rust suites and targeted negative/live tests before closure.

Maintainer decisions

Review and accept/supersede ADR-0007 and ADR-0008 before promoting blocked API/security milestones; preserve their proposed status until explicitly accepted.

dbowm91 and others added 30 commits November 3, 2026 15:15
wr3n-ai added 29 commits November 3, 2026 16:41
@dbowm91
dbowm91 merged commit e1bf41f into main Nov 6, 2026
4 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