@zuplo/runtime 6.60.23 → 6.60.24

package/out/types/index.d.ts

@@ -1833,6 +1833,55 @@ export declare interface CognitoJwtInboundPolicyOptions {
   oAuthResourceMetadataEnabled?: boolean;
 }
 
+/**
+ * Comet Opik Tracing Inbound Policy
+ * @title Comet Opik Tracing
+ * @hidden
+ *
+ * This policy automatically handles tracing for both streaming and non-streaming
+ * responses from AI Gateway. It creates traces when requests start and spans
+ * when responses complete.
+ *
+ * For streaming responses, it clones the response stream and processes it in
+ * the background using `waitUntil`, allowing the original stream to pass through
+ * unmodified while still capturing the complete content for tracing.
+ *
+ * @param request - The ZuploRequest
+ * @param context - The ZuploContext
+ * @param options - The policy options set in policies.json
+ * @param policyName - The name of the policy as set in policies.json
+ * @returns A Request or a Response
+ */
+export declare function CometOpikTracingInboundPolicy(
+  request: ZuploRequest,
+  context: ZuploContext,
+  options: CometOpikTracingPolicyOptions,
+  policyName: string
+): Promise<ZuploRequest | Response>;
+
+/**
+ * Track AI Gateway requests and responses using Comet Opik's LLM observability platform.
+ * @public
+ */
+export declare interface CometOpikTracingPolicyOptions {
+  /**
+   * The Comet Opik API key for authentication.
+   */
+  apiKey: string;
+  /**
+   * The Comet Opik project name for organizing traces.
+   */
+  projectName: string;
+  /**
+   * The Comet Opik workspace name.
+   */
+  workspace: string;
+  /**
+   * The base URL for the Comet Opik API (optional, defaults to https://www.comet.com/opik/api).
+   */
+  baseUrl?: string;
+}
+
 /**
  * The compatibility date on which to run the gateway
  */
@@ -4980,6 +5029,89 @@ declare type LokiTransportVersion = 1 | 2;
 
 /* Excluded from this release type: LookupResult */
 
+/**
+ * Configuration structure for the MCP Gateway
+ */
+export declare interface McpGatewayConfig {
+  /**
+   * Array of MCP server configurations
+   */
+  servers: McpGatewayServerConfig[];
+}
+
+/**
+ * The Zuplo MCP gateway handler: used to build and bind origin MCP servers
+ * to "virtual" MCP servers.
+ * Only POST requests are supported for the HTTP streamable MCP transport.
+ *
+ * @beta
+ * @param request - The ZuploRequest
+ * @param context - The ZuploContext
+ * @returns ZuploResponse
+ */
+export declare function mcpGatewayHandler(
+  request: ZuploRequest,
+  context: ZuploContext
+): Promise<Response>;
+
+declare interface McpGatewayOrigin {
+  /**
+   * display name for the origin MCP server
+   */
+  name: string;
+  /**
+   * display description for the origin MCP server
+   */
+  description: string;
+  /**
+   * The actual endpoint of the origin MCP server
+   */
+  baseUrl: string;
+  /**
+   * The list of allowed tools on the server
+   */
+  tools: McpGatewayTool[];
+  /**
+   * Optional prefix to add to all tool names from this server to avoid conflicts
+   * @example "weather_" would make "get_forecast" become "weather_get_forecast"
+   */
+  toolNamePrefix?: string;
+  /**
+   * Whether to include this server's capabilities in the combined server.
+   * Defaults to true.
+   */
+  enabled?: boolean;
+}
+
+/**
+ * Configuration for an individual MCP server in the gateway
+ */
+declare interface McpGatewayServerConfig {
+  /**
+   * Unique name and identifier for the MCP server
+   */
+  name: string;
+  /**
+   * Description of what this MCP server provides
+   */
+  description: string;
+  /**
+   * The endpoint slug path where this MCP server will be accessible
+   * @example "/todo-mcp"
+   */
+  slug: string;
+  /**
+   * Array of origin configurations for this server
+   */
+  origins: McpGatewayOrigin[];
+}
+
+declare interface McpGatewayTool {
+  name: string;
+  description: string;
+  inputSchema: object;
+}
+
 /**
  * An MCP Server handler for Zuplo
  * Only POST requests are supported for the HTTP streamable MCP transport.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zuplo/runtime",
   "type": "module",
-  "version": "6.60.23",
+  "version": "6.60.24",
   "repository": "https://github.com/zuplo/zuplo",
   "author": "Zuplo, Inc.",
   "exports": {