Skip to content

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

Description

@elliotBraem

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    ready-for-agentFully specified, ready for an AFK agent

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions