NEARBuilders / NEARBuilders/everything-dev

orpc-v2: host handlers, OpenAPI 3.1.1 pin, and MCP tool generation

Open
#265 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

ready-for-agent
Dominant language
TypeScript
Stars
5
Forks
6
Avg merge
1m
Merged PRs (30d)
1

Description

Ticket ID: B5

Parent

#248 — orpc-v2: consolidate fork into everything-dev and migrate platform to oRPC v2 + Effect 4 (epic)

What to build

Stage B, step 5: migrate the host to oRPC v2. The host's API route handlers live in host/src/routes/api.ts (the plan doc's claim that they live in program.ts is wrong) and need:

  • Updated RPCHandler wiring; the interceptors option carries over unchanged (the doc's routingInterceptors/transportInterceptors rename does not apply).
  • The ZodToJsonSchemaConverter import path update and the OpenAPIReferencePlugin rename per the v2 migration guide.
  • The OpenAPI generator pinned to version: '3.1.1' — v2 defaults to 3.2.0 and MCP tool generation requires 3.1.
  • The MCP service (tools generated from the OpenAPI spec) verified end-to-end.

Acceptance criteria

  • Host serves identical REST/RPC paths (spec diff vs pre-migration, ignoring the OAS version field)
  • OpenAPI spec generated at 3.1.1; /api docs render; MCP tools generate and invoke
  • Host vitest suite green

Blocked by

  • #259 — createPlugin restructure
  • #260 — migrate all six contracts to the v2 route builder

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with host/src/routes/api.ts and the oRPC v2 migration guide, then inspect the host's OpenAPI and MCP integration. Compare the generated spec with the pre-migration version and run the host vitest suite; done means identical paths, OpenAPI 3.1.1 docs, and MCP tools that generate and invoke successfully.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi, typescript
Domain
api, backend
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.