raidr_types

Shared TypeScript types for the raidr platform: MCP manifests, skills, sites, and the request/response shapes of raidr_api.

bun add @sudobility/raidr_types

Exports

| Import | Contents | Needs | | --- | --- | --- | | @sudobility/raidr_types | plain types, successResponse, errorResponse, paginatedResponse, path helpers, constants | @sudobility/types | | @sudobility/raidr_types/schemas | zod schemas for every wire type, bound to the interfaces with satisfies | zod v4 |

Only raidr_api and raidr_crawler import ./schemas. Front-end packages use the root export and never pull zod.

Manifest shape

One McpManifest per API host. Each McpTool carries a JSON Schema input and an McpToolRequest that maps input fields onto path, query, header and body. The hosted MCP server in raidr_api proxies tool calls from that mapping and forwards the caller's X-Raidr-Token per McpAuth.

API docs

One ApiDoc per API host lists its endpoints with typed parameters (text, number, enum, boolean, JSON, with formats and validation hints), the credential each needs (none, user or api_key), and EndpointLinks between endpoints (an auth token or an id that one response supplies to a later request), which ApiFlow serves as a flow map. ApiExecuteRequest / ApiExecuteResult are the body and reply of raidr_api's execute proxy.

Site credentials

extractCredential(headers, auth) pulls a signed-in user's token off a request the site itself sent: the bearer token without its prefix, a named header without its tokenPrefix, or one cookie's value. It never returns placeholders or anonymous values. The same module defines the message protocol between raidr.app and the raidr extension (BridgeRequest / BridgeResponse, TokenRequest, CapturedCredential), and RaidrSettings.siteTokens holds tokens saved by raidr token.

Related projects

• raidr_api — CRUD for manifests, skills, sites and API docs plus the hosted MCP server
• raidr_crawler — crawls a site, analyses the bundle, publishes manifests
• raidr_client / raidr_lib / raidr_app — front-end stack