@12-apps/mcp 2.0.0 → 3.0.0

package/ADOPTING.md

@@ -34,7 +34,7 @@ library updates, every host updates with **no app changes**. Same contract
    `enabled: false` authorize/token/jwks/discovery answer **404** — a probe cannot
    tell a disabled AS from an app that has none — while registration answers
    **403 `access_denied`**, because RFC 7591 has a code for "the endpoint is here,
-   registration is closed". future-pay passes
+   registration is closed". The origin host passes
    `enabled: () => process.env.MCP_BEARER_ENABLED === 'true'`, so the surface stays
    OFF until an operator opts in.
 4. **No signing key, no tokens.** `signingKey` defaults to the env-backed provider
@@ -51,7 +51,7 @@ library updates, every host updates with **no app changes**. Same contract
    the internal origin rather than to an attacker's. Issuance and verification read
    the same resolver from the same request, which is what stops "minted for A,
    verified against B" from rejecting valid tokens.
-   `trustedOriginsFromEnv('MCP_OAUTH_TRUSTED_ORIGINS')` keeps future-pay's wiring.
+   `trustedOriginsFromEnv('MCP_OAUTH_TRUSTED_ORIGINS')` keeps the origin host's wiring.
 6. **The stores are narrow ports; Prisma fills them in one line.**
    `createPrismaMcpStores(async () => prisma as unknown as McpOauthPrisma)`. A
    non-Prisma host implements `OAuthClientStore` / `RefreshTokenStore` /
@@ -104,7 +104,7 @@ library updates, every host updates with **no app changes**. Same contract
      default, and it is deliberately the inconvenient one.
 10. **Connections are per USER, not per tenant** — an MCP bearer is
     auth-passthrough. `connections.resolveUserId(email)` maps the token's email to
-    the host's user id (future-pay resolves it by email because `session.user.id` is
+    the host's user id (the origin host resolves it by email because `session.user.id` is
     the OAuth `sub`); returning `null` records nothing. Recording is best-effort and
     FENCED: a failing directory can never turn a valid grant into a 500, and nothing
     about the attempt is logged, because the only values in hand are an email and a
@@ -211,7 +211,7 @@ Two things about the gates worth knowing before you adopt them:
   committed exclusions file the moment it adopted the package, so it needs its own
   burn-down).
 
-## Phase B — adopting into a host that ALREADY has these tables (future-pay)
+## Phase B — adopting into a host that ALREADY has these tables (the origin host)
 
 **Nothing to baseline.** Every statement in the package migration is guarded
 (`CREATE TABLE IF NOT EXISTS`, `CREATE [UNIQUE] INDEX IF NOT EXISTS`, `ADD COLUMN
@@ -223,8 +223,8 @@ a host that already has `oauth_clients` / `oauth_refresh_tokens` /
 Deliberate deltas to reconcile:
 
 - **The FK from `mcp_connections.user_id` to `users` is not in the package
-  migration** — host vocabulary. future-pay keeps its `ON DELETE CASCADE`.
-- **`onboarding_states` is not here.** future-pay's migration created it beside
+  migration** — host vocabulary. The origin host keeps its `ON DELETE CASCADE`.
+- **`onboarding_states` is not here.** The origin host's migration created it beside
   `mcp_connections`; it belongs to `@12-apps/onboarding` (12-23).
 - The host's `lib/mcp/oauth/**` (~1.5k LOC) and its four route files are replaced
   by the mount plus, where a coverage gate forces the file to exist, a one-line
@@ -242,7 +242,7 @@ Deliberate deltas to reconcile:
   and redactions, is the host's catalogue. The package generates, dispatches and
   gates it.
 - **`mcp:lint`, `mcp:parity`, `mcp:smoke`, `mcp:test-coverage`** — the remaining
-  future-pay MCP scripts. Only the two the reusable CI workflows shell out to moved
+  the origin host MCP scripts. Only the two the reusable CI workflows shell out to moved
   (12-23's scope).
 - **Authorization codes as rows.** They are stateless signed blobs, so there is no
   table and nothing to sweep — only the replay store (rule 8).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/mcp",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "type": "module",
   "description": "App-agnostic MCP server core: generate one MCP tool per OpenAPI operation and proxy each call carrying the caller's bearer token (permission passthrough). Also ships the OAuth 2.1 authorization server (./oauth, ./hono: register/authorize/token, JWKS and both .well-known documents), the package-owned Prisma partial + migration for its three tables, the mcp:generate/mcp:check (./generate) and mcp:coverage (./coverage) gates, and the reusable AI-connect onboarding UI (./react).",
   "exports": {
@@ -23,9 +23,9 @@
     "prisma:sync:check": "node scripts/sync-mcp-schema.mjs --check"
   },
   "dependencies": {
-    "@12-apps/onboarding": "^1.20.0",
-    "@12-apps/rbac": "^3.0.0",
-    "@12-apps/ui": "^4.1.0",
+    "@12-apps/onboarding": "^2.0.0",
+    "@12-apps/rbac": "^4.0.0",
+    "@12-apps/ui": "^5.0.0",
     "@mui/icons-material": "^6.5.0",
     "jose": "^6.1.3",
     "react": "^19.2.0"

package/prisma/mcp.prisma

@@ -11,7 +11,7 @@
 //
 // Host-agnostic by design (the entity-lifecycle / rbac doctrine): `user_id` is a
 // by-value scalar with NO relation, because this package cannot know the name of
-// the host's user model. The host's own migration may add the FK (future-pay's
+// the host's user model. The host's own migration may add the FK (the origin host's
 // is ON DELETE CASCADE). Note there is deliberately no `oauth_codes` table:
 // authorization codes are STATELESS signed blobs, so there is nothing to store
 // and nothing to sweep.

package/prisma/migrations/20260812150000_add_mcp_oauth_tables/migration.sql

@@ -18,13 +18,13 @@
 -- Authorization codes are deliberately absent: they are STATELESS signed blobs,
 -- so there is no table to create and nothing to sweep.
 --
--- The columns, defaults, indexes and CHECK are future-pay's
+-- The columns, defaults, indexes and CHECK are the origin host's
 -- `20260713120000_add_oauth_client_refresh`,
 -- `20260715180000_add_onboarding_state_mcp_connection` (the mcp_connections half
 -- — the onboarding half belongs to @12-apps/onboarding) and
 -- `20260720120000_add_mcp_connection_host` verbatim, minus the FK to `users`:
 -- this package cannot know the name of a host's user table, and a host that has
--- one keeps its own constraint (future-pay's is ON DELETE CASCADE).
+-- one keeps its own constraint (the origin host's is ON DELETE CASCADE).
 --
 -- EVERY statement is guarded (`IF NOT EXISTS`, and a conrelid-scoped DO block for
 -- the CHECK, which has no IF NOT EXISTS form). That is what makes adoption by a
@@ -35,7 +35,7 @@
 -- the difference bites exactly the host this file is written for: `CREATE TABLE IF
 -- NOT EXISTS` skips the whole table, columns included, so a host holding an OLDER
 -- shape of one of these tables silently keeps it. Each table below is therefore
--- followed by a guarded `ADD COLUMN` for every column that reached future-pay in a
+-- followed by a guarded `ADD COLUMN` for every column that reached the origin host in a
 -- LATER migration than its own CREATE. The full audit: `oauth_refresh_tokens
 -- .user_sub` (`20260713150000_add_oauth_refresh_user_sub`) and `mcp_connections
 -- .host` (`20260720120000_add_mcp_connection_host`). `oauth_clients` needs none —
@@ -112,10 +112,10 @@ CREATE INDEX IF NOT EXISTS "oauth_refresh_tokens_user_email_client_id_idx"
 -- `CREATE TABLE IF NOT EXISTS` skips the WHOLE table, so a host that already holds
 -- `oauth_refresh_tokens` in an OLDER SHAPE gets none of the columns declared above
 -- — statement-level guarding is not the same as column-level guarding. That is
--- precisely how future-pay's own history ran: `user_sub` arrived in a SECOND
+-- precisely how the origin host's own history ran: `user_sub` arrived in a SECOND
 -- migration (FUT-105, `20260713150000_add_oauth_refresh_user_sub`), so a host
 -- frozen before it would adopt this file, skip the CREATE, never get the column,
--- and then fail on every refresh the package serves. Mirror future-pay's pair
+-- and then fail on every refresh the package serves. Mirror the origin host's pair
 -- verbatim — guarded add with a backfill default to satisfy NOT NULL, then drop
 -- the default so the column matches the Prisma schema (`String`, no default).
 -- Both statements are no-ops on a fresh host and on a replay.
@@ -147,6 +147,6 @@ CREATE INDEX IF NOT EXISTS "mcp_connections_last_active_at_idx"
   ON "mcp_connections"("last_active_at");
 
 -- A host adopting this migration where `mcp_connections` predates the `host`
--- column (future-pay added it in a later migration) gets it here; a fresh host
+-- column (the origin host added it in a later migration) gets it here; a fresh host
 -- already has it from the CREATE above, so the guard makes both cases a no-op.
 ALTER TABLE "mcp_connections" ADD COLUMN IF NOT EXISTS "host" TEXT;

package/scripts/sync-mcp-schema.mjs

@@ -14,14 +14,14 @@
  *
  * Only the schema partial. MIGRATIONS ARE NOT HANDLED HERE — the host
  * discovers and copies them structurally, by looking for a `prisma/migrations`
- * directory inside every installed `@12-apps/*` package (see future-pay's
+ * directory inside every installed `@12-apps/*` package (see the origin host's
  * packages/prisma/scripts/sync-prisma-plugins.mjs).
  *
  * The host package that owns the schema folder MUST also declare this package
  * as a dependency, so the source of the copy is present in every build
  * context.
  *
- * Default host path follows the future-pay layout
+ * Default host path follows the origin host layout
  * (`packages/prisma/prisma/schema/`); another repo passes its own schema
  * folder as the positional argument, or sets MCP_HOST_SCHEMA_DIR.
  */

package/src/coverage-gate/index.ts

@@ -6,7 +6,7 @@ import { collectRouteMethods } from "./route-methods";
 
 /**
  * `@12-apps/mcp/coverage` — the MCP route/action coverage gate (12-23), moved out
- * of future-pay's `apps/web/scripts/mcp/coverage.ts` so a host's own script is a
+ * of the origin host's `apps/web/scripts/mcp/coverage.ts` so a host's own script is a
  * one-line re-export and the CI workflow that shells out to the consumer's
  * `mcp:coverage` package script (`12-apps/ci`'s `mcp-contract.yml`) keeps working
  * unchanged.

package/src/coverage-gate/route-methods.ts

@@ -11,7 +11,7 @@ import { exportedNamesOf, urlPathOf, walkRouteFiles } from "@12-apps/rbac/covera
  * walk (`walkRouteFiles`), the URL mapping (`urlPathOf`) AND the export-head
  * parser (`exportedNamesOf`) — and that is deliberate: both gates assert a
  * COMPLETENESS property over the same two surfaces (`app/**` route files and
- * `*actions.ts` modules), and future-pay's own comment on the shared scanner says
+ * `*actions.ts` modules), and the origin host's own comment on the shared scanner says
  * why they must share it — "so the two gates can never disagree about what the
  * surface is". Two copies would agree on the day they were written and drift
  * silently after, in the direction of not looking. What is left here is the one

package/src/generate/index.ts

@@ -13,7 +13,7 @@ import type { ToolManifest } from "../types";
 
 /**
  * `@12-apps/mcp/generate` — the `mcp:generate` / `mcp:check` gate (12-23), moved
- * out of future-pay's `apps/web/scripts/mcp/generate.ts` so a host's own script is
+ * out of the origin host's `apps/web/scripts/mcp/generate.ts` so a host's own script is
  * a one-line call and `12-apps/ci`'s `mcp-contract.yml`, which shells out to the
  * consumer's `mcp:check` package script, keeps working unchanged.
  *

package/src/oauth/access-token.ts

@@ -4,7 +4,7 @@ import { issuer, resourceAudience, DEFAULT_MCP_RESOURCE_PATH, type McpScope } fr
 import { SIGNING_ALG, type McpSigningKeyProvider } from "./keys";
 
 /**
- * JWT access-token issuer + verifier (12-23, ported from future-pay's
+ * JWT access-token issuer + verifier (12-23, ported from the origin host's
  * `lib/mcp/oauth/jwt.ts` — behaviour unchanged; the signing key arrives through a
  * provider and the resource path is config).
  *

package/src/oauth/authorization-code.ts

@@ -4,7 +4,7 @@ import { issuer } from "./config";
 import { SIGNING_ALG, type McpSigningKeyProvider } from "./keys";
 
 /**
- * Stateless authorization-code mint/verify (12-23, ported from future-pay's
+ * Stateless authorization-code mint/verify (12-23, ported from the origin host's
  * `lib/mcp/oauth/authorization-code.ts` — behaviour unchanged; the signing key
  * arrives through a provider instead of an env read).
  *

package/src/oauth/authorize.ts

@@ -6,7 +6,7 @@ import type { StoredOAuthClient } from "./stores";
 
 /**
  * The OAuth 2.1 Authorization Code + PKCE authorization endpoint (12-23, ported
- * from future-pay's `app/api/oauth/authorize/route.ts`).
+ * from the origin host's `app/api/oauth/authorize/route.ts`).
  *
  * It renders no UI: it authenticates the caller against the host's cookie session
  * (through `resolveSession`), validates the request, and either 302-redirects an

package/src/oauth/clients.ts

@@ -8,7 +8,7 @@ import type {
 
 /**
  * Client registration and the open-redirect guard (12-23, ported from
- * future-pay's `lib/mcp/oauth/clients.ts`).
+ * the origin host's `lib/mcp/oauth/clients.ts`).
  *
  * A registered client is an external host (a Claude.ai / ChatGPT connector) from
  * RFC 7591 dynamic client registration, or a static registration an operator
@@ -122,7 +122,7 @@ export interface ProviderAttributionRule {
   provider: string;
 }
 
-/** future-pay's rules, and a sane default for any host talking to the same two. */
+/** The origin host's rules, and a sane default for any host talking to the same two. */
 export const DEFAULT_PROVIDER_ROOTS: readonly ProviderAttributionRule[] = [
   { roots: ["claude.ai", "anthropic.com"], provider: "claude" },
   { roots: ["chatgpt.com", "openai.com"], provider: "chatgpt" },

package/src/oauth/code-replay.ts

@@ -1,6 +1,6 @@
 /**
  * Single-use guard for the stateless authorization codes (12-23, ported from
- * future-pay's `lib/mcp/oauth/token-replay.ts`).
+ * the origin host's `lib/mcp/oauth/token-replay.ts`).
  *
  * A code is a signed blob with a `jti`, so "already redeemed" has to be remembered
  * somewhere. The in-process option remembers it IN THIS PROCESS: a small map of

package/src/oauth/config.ts

@@ -1,7 +1,7 @@
 /**
  * The OAuth 2.1 authorization-server foundation: the shared scope source, the
  * issuer/audience derivation, and the trusted-origin resolver every URL in the
- * surface is built from (12-23, ported from future-pay's
+ * surface is built from (12-23, ported from the origin host's
  * `lib/mcp/oauth/config.ts`).
  *
  * Keeping the scopes and the origin resolution in ONE place is what stops the
@@ -11,7 +11,7 @@
  *
  * What was env-reading in the host is CONFIG here (the package must not learn a
  * host's variable names); `trustedOriginsFromEnv` is the one-line helper that
- * keeps future-pay's wiring identical.
+ * keeps the origin host's wiring identical.
  */
 
 /** Scopes advertised by both discovery documents. `mcp:write` gates mutating tools. */
@@ -66,7 +66,7 @@ function normalizeOrigins(origins: readonly string[]): string[] {
 }
 
 /**
- * Read a comma-separated allowlist out of an environment variable — future-pay
+ * Read a comma-separated allowlist out of an environment variable — the origin host
  * passes `trustedOriginsFromEnv('MCP_OAUTH_TRUSTED_ORIGINS')`, so the behaviour
  * is identical while the variable's NAME stays the host's.
  */

package/src/oauth/context.ts

@@ -25,7 +25,7 @@ import type { McpOauthStores, StoredOAuthClient } from "./stores";
 /** The identity an authorize request binds a code to. From the SESSION only. */
 export interface McpOauthSession {
   /**
-   * The OAuth subject (future-pay passes the Google `sub`, falling back to the
+   * The OAuth subject (the origin host passes the Google `sub`, falling back to the
    * email). Carried through every rotation so a refreshed token keeps the same
    * stable `sub`.
    */
@@ -45,7 +45,7 @@ export interface McpOauthPaths {
 }
 
 export const DEFAULT_OAUTH_PATHS: McpOauthPaths = {
-  // future-pay's paths, and the ones the RFC 8414 document has always advertised.
+  // the origin host's paths, and the ones the RFC 8414 document has always advertised.
   authorize: "/api/oauth/authorize",
   token: "/api/oauth/token",
   register: "/api/oauth/register",
@@ -78,12 +78,12 @@ export interface McpOauthConfig {
   resolveSession: (request: Request) => Promise<McpOauthSession | null> | McpOauthSession | null;
   /**
    * The operator gate. `false` makes the whole surface inert — authorize/token/jwks
-   * answer 404 and registration answers 403 — which is how future-pay ships it OFF
+   * answer 404 and registration answers 403 — which is how the origin host ships it OFF
    * by default (`MCP_BEARER_ENABLED`). Default: enabled (mounting is the opt-in).
    */
   enabled?: boolean | (() => boolean);
   /**
-   * Signing material. Default: the env-backed provider with future-pay's variable
+   * Signing material. Default: the env-backed provider with the origin host's variable
    * names. `null` from the provider means "not provisioned": nothing is minted and
    * the JWKS answers 503 rather than falling back to a weaker mode.
    */
@@ -216,7 +216,7 @@ export function resolveMcpOauthConfig(config: McpOauthConfig): McpOauthContext {
     stores: config.stores,
     resolveSession: config.resolveSession,
     // Mounting is the opt-in, so the gate defaults to ON; a host that ships the
-    // surface dark passes its own flag (future-pay: `MCP_BEARER_ENABLED`).
+    // surface dark passes its own flag (the origin host: `MCP_BEARER_ENABLED`).
     enabled: typeof enabled === "function" ? enabled : () => enabled,
     // `null` from the provider means "not provisioned": nothing is minted and the
     // JWKS answers 503 rather than falling back to a weaker mode.

package/src/oauth/keys.ts

@@ -2,7 +2,7 @@ import { exportJWK, importPKCS8, type CryptoKey, type JWK } from "jose";
 
 /**
  * Signing-key / JWK loading for the OAuth authorization server (12-23, ported
- * from future-pay's `lib/mcp/oauth/keys.ts`).
+ * from the origin host's `lib/mcp/oauth/keys.ts`).
  *
  * ES256 (P-256) from PEM material, the published public JWK (with `kid` for
  * rotation), and a safe-by-default absence signal (`null`) when no key is
@@ -10,7 +10,7 @@ import { exportJWK, importPKCS8, type CryptoKey, type JWK } from "jose";
  * rather than falling back to a weaker mode while the surface is mounted.
  *
  * WHERE the PEM comes from is the host's business: `loadSigningKeyFromEnv` keeps
- * future-pay's env-var wiring, and any other provider (a secrets manager, a KMS
+ * the origin host's env-var wiring, and any other provider (a secrets manager, a KMS
  * export) satisfies the same `McpSigningKeyProvider` shape.
  */
 
@@ -87,13 +87,13 @@ export function signingKeyProvider(
   };
 }
 
-/** Env var carrying the ES256 private key as a PKCS#8 PEM (future-pay's name). */
+/** Env var carrying the ES256 private key as a PKCS#8 PEM (the origin host's name). */
 export const DEFAULT_SIGNING_KEY_ENV = "MCP_OAUTH_SIGNING_KEY";
 /** Env var carrying the key id (`kid`) used to select the key during rotation. */
 export const DEFAULT_SIGNING_KEY_ID_ENV = "MCP_OAUTH_SIGNING_KEY_ID";
 
 /**
- * The env-backed provider — future-pay's wiring, kept identical, with the
+ * The env-backed provider — the origin host's wiring, kept identical, with the
  * variable names as arguments so the package states no host's vocabulary.
  */
 export function loadSigningKeyFromEnv(

package/src/oauth/pkce.ts

@@ -1,6 +1,6 @@
 /**
  * PKCE (RFC 7636) S256 challenge helpers for the OAuth authorization server
- * (12-23, ported verbatim from future-pay's `lib/mcp/oauth/pkce.ts`).
+ * (12-23, ported verbatim from the origin host's `lib/mcp/oauth/pkce.ts`).
  *
  * OAuth 2.1 mandates the `S256` code-challenge method and forbids `plain`, so
  * this module computes `BASE64URL(SHA-256(code_verifier))` and compares it to

package/src/oauth/refresh.ts

@@ -3,7 +3,7 @@ import { createHash, randomBytes } from "node:crypto";
 import type { NewRefreshToken, RefreshTokenStore, StoredRefreshToken } from "./stores";
 
 /**
- * Refresh-token issue + rotation (12-23, ported from future-pay's
+ * Refresh-token issue + rotation (12-23, ported from the origin host's
  * `lib/mcp/oauth/refresh.ts` — behaviour unchanged; Prisma calls became the
  * `RefreshTokenStore` port).
  *

package/src/oauth/register.ts

@@ -3,7 +3,7 @@ import type { McpOauthContext } from "./context";
 import type { TokenEndpointAuthMethod } from "./stores";
 
 /**
- * RFC 7591 Dynamic Client Registration (12-23, ported from future-pay's
+ * RFC 7591 Dynamic Client Registration (12-23, ported from the origin host's
  * `app/api/oauth/register/route.ts`).
  *
  * An external host (a Claude.ai / ChatGPT connector) self-registers by POSTing RFC

package/src/oauth/token-grants.ts

@@ -19,7 +19,7 @@ import {
 } from "./token-response";
 
 /**
- * The two grant handlers of the token endpoint (12-23, ported from future-pay's
+ * The two grant handlers of the token endpoint (12-23, ported from the origin host's
  * `lib/mcp/oauth/token-grants.ts`).
  *
  * Security invariants enforced here, unchanged:
@@ -123,7 +123,7 @@ function readAuthorizationCodeParams(form: URLSearchParams): AuthorizationCodePa
 /**
  * Redeem a presented code, or refuse.
  *
- * The ORDER is the security contract, and it is the order future-pay established:
+ * The ORDER is the security contract, and it is the order the origin host established:
  * verify the code's signature, authenticate the presenting client against the
  * client the code was bound to, check the bound `redirect_uri`, check PKCE — and
  * only THEN consume the single-use `jti`. Consuming earlier would let a failed

package/src/oauth/token-response.ts

@@ -5,7 +5,7 @@ import type { OAuthClientStore } from "./stores";
 /**
  * The token endpoint's wire helpers: the RFC 6749 §5.1/§5.2 bodies and client
  * authentication (12-23, split out of the grant handlers so each file stays under
- * the size gate — the same split future-pay made).
+ * the size gate — the same split the origin host made).
  *
  * These bodies are NOT the house `{ data }` envelope, deliberately: they are read
  * by OAuth clients that expect the RFC shapes at the top level, and `Cache-Control:

package/src/server/manifest.ts

@@ -11,7 +11,7 @@ import type { GeneratedTool, ToolManifest } from "../types";
 export interface BuildManifestOptions {
   /** Bumped intentionally on any tool-shape change (mirrors the golden catalog). */
   version: number;
-  /** Human label for the spec, e.g. "future-pay web @ openapi.json". */
+  /** Human label for the spec, e.g. "acme web @ openapi.json". */
   source: string;
 }
 

package/src/server/surface-lock.ts

@@ -16,7 +16,7 @@ import type { GeneratedTool } from "../types";
  * ask again: a tool that shipped stays invisible to every ALREADY CONNECTED
  * client for as long as that connection lives.
  *
- * That is not a hypothetical. In `future-pay` a new tool reached production,
+ * That is not a hypothetical. In the origin host a new tool reached production,
  * answered on its route, and did not appear in a live connector — behind a
  * `serverInfo.version` frozen at its initial value while ~280 tools were added
  * underneath it. Nothing was broken; the only thing asking anyone to bump it was