@mcpcloud/runtime 0.1.1

package/dist/config.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Runtime configuration for an MCPCloud-generated server.
+ *
+ * The codegen used to bake server-specific constants into every bundle's
+ * `src/config.ts`; in the package the same values arrive as a
+ * `ServerIdentity` (the `defineServer` data) and behavior lives here once.
+ */
+export type RuntimeAccessMode = 'public' | 'privateOrg' | 'unlisted';
+export interface RuntimeEnv {
+    UPSTREAM_BASE_URL?: string;
+    UPSTREAM_API_KEY?: string;
+    UPSTREAM_API_KEY_HEADER?: string;
+    UPSTREAM_API_KEY_PREFIX?: string;
+    UPSTREAM_CUSTOM_HEADERS?: string;
+    MCP_OAUTH_RUNTIME_URL?: string;
+    MCP_OAUTH_CONNECTION_ID?: string;
+    MCP_OAUTH_RUNTIME_TOKEN?: string;
+    MCP_OAUTH_MODE?: string;
+    MCP_OAUTH_APPLY_ALL?: string;
+    MCP_OAUTH_TOOL_OVERRIDES?: string;
+    MCP_RUNTIME_AUTH_ACCESS_MODE?: string;
+    MCP_RUNTIME_AUTH_AUDIENCE?: string;
+    MCP_RUNTIME_AUTH_DEPLOYMENT_ID?: string;
+    MCP_RUNTIME_AUTH_DEPLOYMENT_VERSION?: string;
+    MCP_RUNTIME_AUTH_ISSUER?: string;
+    MCP_RUNTIME_AUTH_ORGANIZATION_ID?: string;
+    MCP_RUNTIME_AUTH_PUBLIC_KEY?: string;
+    MCP_RUNTIME_AUTH_SERVER_ID?: string;
+}
+/** Per-server data the codegen passes to `defineServer` / config resolution. */
+export interface ServerIdentity {
+    serverName: string;
+    serverVersion: string;
+    /** Spec-derived default upstream origin; null when the spec declared none. */
+    defaultUpstreamBaseUrl: string | null;
+    apiKeyHeader: string;
+    apiKeyPrefix: string;
+}
+export interface RuntimeOAuthConfig {
+    runtimeUrl: string;
+    connectionId: string;
+    mode: 'shared' | 'perMember';
+    applyToAllTools: boolean;
+    toolOverrides: Partial<Record<string, 'on' | 'off'>>;
+}
+export interface CallerContext {
+    userId: string | null;
+    runtimeToken: string | null;
+}
+export interface RuntimeAccessConfig {
+    audience: string;
+    deploymentId: string;
+    deploymentVersion: number;
+    issuer: string;
+    organizationId: string;
+    publicKey: string;
+    serverId: string;
+}
+export interface RuntimeConfig {
+    serverName: string;
+    serverVersion: string;
+    upstreamBaseUrl: string;
+    apiKey: string | null;
+    apiKeyHeader: string;
+    apiKeyPrefix: string;
+    customHeaders: Record<string, string>;
+    accessMode: RuntimeAccessMode;
+    oauth: RuntimeOAuthConfig | null;
+    runtimeAuth: RuntimeAccessConfig | null;
+}
+export declare function getProcessEnv(): RuntimeEnv;
+export declare function resolveRuntimeAccessMode(env?: RuntimeEnv): RuntimeAccessMode;
+export declare function resolveRuntimeConfig(identity: ServerIdentity, env?: RuntimeEnv): RuntimeConfig;
+export declare function postOAuthRuntimeRequest(config: RuntimeConfig, body: {
+    connectionId: string;
+    forceRefresh: boolean;
+    callerRuntimeToken: string | null;
+}): Promise<Response>;

package/dist/discovery.d.ts

@@ -0,0 +1,20 @@
+export interface ToolCatalogEntry {
+    name: string;
+    title: string;
+    description: string;
+    tags: string[];
+}
+export interface ToolSearchResult {
+    name: string;
+    title: string;
+    description: string;
+    score: number;
+}
+/**
+ * Hybrid tool search over a catalog.
+ * - `/pattern/flags` → regex match against name/title/description/tags.
+ * - empty query → directory listing of the first `limit` tools.
+ * - otherwise → BM25 ranking, with a substring fallback for exact-name or
+ *   partial-word lookups that produced no BM25 hit.
+ */
+export declare function searchCatalog(entries: ToolCatalogEntry[], query: string, limit?: number): ToolSearchResult[];

package/dist/http.d.ts

@@ -0,0 +1,11 @@
+import type { CallerContext, RuntimeConfig } from './config';
+import type { ToolDefinition } from './types';
+export declare function buildUpstreamRequest(tool: ToolDefinition, rawInput: Record<string, unknown>, config: RuntimeConfig, caller: CallerContext, forceOauthRefresh?: boolean): Promise<{
+    url: string;
+    init: RequestInit;
+}>;
+export declare function encodeFormUrlencodedBody(value: unknown): string;
+export declare function parseUpstreamResponse(response: Response): Promise<unknown>;
+export declare function mapUpstreamError(tool: ToolDefinition, status: number, payload: unknown): Error;
+export declare function normalizeUpstreamPayload(tool: ToolDefinition, response: Response, payload: unknown): unknown;
+export declare function formatToolResultText(tool: ToolDefinition, payload: unknown): string;

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @mcpcloud/runtime — the runtime for MCPCloud-generated MCP servers.
+ *
+ * Worker-safe entry: everything here runs on Cloudflare Workers, Node 20+,
+ * and Bun. stdio and node HTTP adapters live in the `./stdio` and `./node`
+ * subpath exports (they import node builtins).
+ */
+export type { EndpointDefinition, ErrorMappingDefinition, SecuritySchemeDefinition, ToolDefinition, } from './types';
+export { getProcessEnv, postOAuthRuntimeRequest, resolveRuntimeAccessMode, resolveRuntimeConfig, } from './config';
+export type { CallerContext, RuntimeAccessConfig, RuntimeAccessMode, RuntimeConfig, RuntimeEnv, RuntimeOAuthConfig, ServerIdentity, } from './config';
+export { buildUpstreamHeaders, hasOauthSecurity, resolveUseOAuth, } from './auth-headers';
+export { buildUpstreamRequest, encodeFormUrlencodedBody, formatToolResultText, mapUpstreamError, normalizeUpstreamPayload, parseUpstreamResponse, } from './http';
+export { authorizeRuntimeRequest, describeRuntimeAccess, isProtectedRuntimeAccessMode, } from './access';
+export type { RuntimeAuthorization } from './access';
+export { assertValidInput } from './validation';
+export { applyResponseProjection } from './projection';
+export { jsonSchemaToZodObject, jsonSchemaToZodSchema } from './schema';
+export { clearMetadataOverrides, getMetadataOverrides, resolveDescription, resolveTitle, setMetadataOverride, } from './metadata-overrides';
+export type { ToolMetadataOverride } from './metadata-overrides';
+export { searchCatalog } from './discovery';
+export type { ToolCatalogEntry, ToolSearchResult } from './discovery';
+export { defineServer } from './server';
+export type { DefineServerOptions, GeneratedServer, RegisteredTool, ToolHandler, } from './server';
+export { toWorkerHandler } from './adapters/worker';
+export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
+export { McpError } from '@modelcontextprotocol/sdk/types.js';
+export type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export { z } from 'zod';