Skip to content

v1.7.0: Mount composition, MCPMock, A2AMock, VectorMock, services#56

Open
jpr5 wants to merge 14 commits intomainfrom
feat/v1.7.0-subproject1
Open

v1.7.0: Mount composition, MCPMock, A2AMock, VectorMock, services#56
jpr5 wants to merge 14 commits intomainfrom
feat/v1.7.0-subproject1

Conversation

@jpr5
Copy link
Copy Markdown
Contributor

@jpr5 jpr5 commented Mar 24, 2026 •
edited
Loading

Summary

v1.7.0 adds mountable protocol mocking, AI service mocking, and supporting infrastructure. Zero new runtime dependencies.

Sub-project 1: Core Infrastructure

  • Mountable composition — multiple protocol handlers on a single server via llmock.mount(path, handler)
  • JSON-RPC 2.0 transport — batch, notifications, error codes, spec-compliant id handling
  • Config loader — start a full multi-mock stack from a single JSON/YAML file
  • Suite runner — createMockSuite() for one-line multi-mock setup
  • aimock CLI — aimock --config config.json with port validation and graceful shutdown
  • Subpath exports — @copilotkit/llmock/mcp, ./a2a, ./vector

Sub-project 2: Protocol Mocking

  • MCPMock — Model Context Protocol: tools, resources, prompts with session lifecycle and initialization enforcement
  • A2AMock — Agent-to-Agent: agent cards, message/task pattern matching, SSE streaming with terminal state respect

Sub-project 3: AI Service Mocking

  • VectorMock — Pinecone, Qdrant, ChromaDB compatible endpoints with in-memory vector store
  • Search (Tavily-compatible), Rerank (Cohere v2), Moderation (OpenAI) service handlers

Quality

  • 1,896 tests across 49 files (was ~1,400)
  • Coverage: ≥90% lines, ≥85% branches across all modules
  • Pre-existing modules (bedrock, cohere, ollama, WebSocket, etc.) also brought to ≥85% branches
  • Two full CR rounds (MSAL workflow): module-scoped + cross-cutting + final gate
  • Zero as any in production source

Bug fixes included

  • Server catches unhandled promise rejections on HTTP and WebSocket paths
  • JSON-RPC passes null id for notifications (not fabricated 0)
  • A2A streaming respects terminal states from events
  • Vector journal only records handled requests
  • MCP enforces session initialization before method calls
  • CLI validates port arguments and handles shutdown errors
  • Extracted duplicated readBody/matchesPattern into shared helpers

Test plan

  • pnpm run test — 1,896 tests pass
  • pnpm run lint — clean
  • pnpm run format:check — clean
  • pnpm run build — clean (175 files, 973 kB)
  • Coverage thresholds enforced (90/85/90)

🤖 Generated with Claude Code

@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new bot commented Mar 24, 2026 •
edited
Loading

Open in StackBlitz

npm i https://pkg.pr.new/CopilotKit/llmock/@copilotkit/llmock@56

commit: 4bdf324

@jpr5 jpr5 force-pushed the feat/v1.7.0-subproject1 branch from 2ddbb64 to 5f3d5a8 Compare March 24, 2026 06:05
@jpr5 jpr5 changed the title v1.7.0: Mount Composition, MCPMock, A2AMock, VectorMock, Search, Rerank, Moderation v1.7.0: Mount composition, MCPMock, A2AMock, VectorMock, services Mar 24, 2026
@jpr5 jpr5 force-pushed the feat/v1.7.0-subproject1 branch from 5f3d5a8 to 8346ba6 Compare March 24, 2026 06:07
jpr5 added 8 commits March 31, 2026 15:57
@jpr5
feat: v1.7.0 core infrastructure — mount composition, JSON-RPC, confi…
7959aaf 
…g, CLI

Mountable interface for composing protocol handlers on a single server.
JSON-RPC 2.0 transport with batch, notifications (null id), error codes.
Config loader for multi-mock YAML/JSON configuration files.
Suite runner for one-line multi-mock setup with reset delegation.
aimock CLI with port validation, graceful shutdown, dependency injection.
Late-mount wiring for journal and baseUrl on already-running servers.
Server catches unhandled rejections on HTTP and WebSocket paths.
Extracted readBody and matchesPattern into shared helpers.
@jpr5
feat: MCPMock — Model Context Protocol mock with session management
45b0bc1 
Tools, resources, and prompts with JSON-RPC dispatch. Session lifecycle
with initialize/notifications/initialized handshake and enforcement.
Standalone and mounted operation modes. inputSchema typed as
Record<string, unknown>. Subpath export at ./mcp.
@jpr5
feat: A2AMock — Agent-to-Agent protocol mock with SSE streaming
2671ac9 
Agent cards, message/task pattern matching, SSE streaming responses.
Streaming respects terminal states (COMPLETED/FAILED/CANCELED).
Types use proper unions (A2ATaskState, A2ARole). Standalone and
mounted modes. Subpath export at ./a2a.
@jpr5
feat: VectorMock — Pinecone, Qdrant, ChromaDB compatible vector DB mock
81d7ef8 
In-memory vector store with upsert, query, delete, list, fetch, describe.
Three vendor-compatible endpoint sets. Auto-collection creation on upsert.
Conditional journaling (only handled requests). Custom query handlers.
Standalone and mounted modes. Subpath export at ./vector.
@jpr5
feat: search, rerank, and moderation service mocks
935e3cf 
Tavily-compatible search, Cohere v2 rerank, OpenAI moderation endpoints.
Pattern matching with case-insensitive string and regex support.
Journal integration with service tags.
@jpr5
test: improve branch coverage for pre-existing handler modules
458540e 
Expand tests for bedrock, bedrock-converse, cohere, ollama, responses,
messages, embeddings, gemini, ws-framing, ws-realtime, ws-gemini-live,
and recorder to meet >= 85% branch coverage threshold.
@jpr5
docs: v1.7.0 documentation — MCP, A2A, Vector, services pages
f4e4794 
Add mcp-mock.html, a2a-mock.html, vector-mock.html, services.html,
aimock-cli.html, mount.html. Restructure docs site for use-case-first
navigation. Update all existing pages and README.
@jpr5
chore: v1.7.0 packaging — subpath exports, aimock CLI, coverage tooling
b65fad0 
Add ./mcp, ./a2a, ./vector subpath exports and aimock bin entry.
Add new entry points to tsdown config. Configure vitest coverage-v8
with 90/85/90 thresholds. Add coverage/ to ignore files.
@jpr5 jpr5 force-pushed the feat/v1.7.0-subproject1 branch from 8346ba6 to b65fad0 Compare March 31, 2026 23:00
jpr5 added 6 commits March 31, 2026 21:18
@jpr5
refactor: rebrand llmock → aimock in source
6d3c419 
- Logger prefix: [llmock] → [aimock]
- CLI startup: "llmock server listening" → "aimock server listening"
- Chaos headers: x-llmock-chaos-* → x-aimock-chaos-*
- Models endpoint: owned_by "llmock" → "aimock"
- All tests updated to match
@jpr5
feat: rename metrics to aimock_* and add MCP/A2A/Vector counters
c735033 
- aimock_requests_total, aimock_request_duration_seconds, etc.
- aimock_mcp_requests_total{method} for JSON-RPC methods
- aimock_a2a_requests_total{method} for A2A operations
- aimock_vector_requests_total{operation,provider} for vector DB ops
- Mountable interface gains optional setRegistry() method
- 12 new tests for service metrics
@jpr5
feat: add /__aimock/* control API for external fixture management
4bed2d2 
POST /__aimock/fixtures, DELETE /__aimock/fixtures, POST /__aimock/reset,
GET /__aimock/journal, POST /__aimock/error, GET /__aimock/health.

Foundation for aimock-pytest pip package. LLMock gains
addFixturesFromJSON() method. entryToFixture() exported from
fixture-loader for reuse. 12 tests.
@jpr5
feat: drift automation updates skills alongside source fixes
fe4ab39 
fix-drift.ts now includes write-fixtures skill in remediation PRs.
BUILDER_TO_SKILL_SECTION maps source files to skill doc sections.
affectedSkillSections() identifies which sections need review.
35 new tests.
@jpr5
docs: rebrand site to aimock with new homepage and docs overview
c2ff48b 
- Treatment 3 Progressive Disclosure homepage with animated terminal demo
- Docs overview with section bar (LLM, MCP, A2A, Vector, Search, Chaos)
- sidebar.js: single source of truth for navigation across 30+ pages
- cli-tabs.js: CLI/Docker tab switching with localStorage persistence
- All page titles, nav, footer, prose, imports, Docker refs → aimock
- Font ligatures disabled, sticky table header, Record & Replay elevated
- "Ready to switch?" and "Built for production" sections
@jpr5
docs: add 6 migration guides and docs overview page
4bdf324 
- migrate-from-msw.html: streaming comparison, side-by-side usage
- migrate-from-vidaimock.html: binary → programmatic API
- migrate-from-mock-llm.html: OpenAI-only → multi-provider, Helm migration
- migrate-from-piyook.html: JSON templates → declarative fixtures
- migrate-from-python-mocks.html: Docker + npx paths, validated examples
- migrate-from-mokksy.html: JVM/Kotlin with TestContainers integration
- docs-overview.html: suite overview with section cards
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@jpr5