sunpeak 0.19.2 → 0.19.10

package/dist/mcp/production-server.d.ts

@@ -83,6 +83,16 @@ export interface ProductionServerConfig {
      * where holding open SSE connections is unreliable. Defaults to `true`.
      */
     enableJsonResponse?: boolean;
+    /**
+     * Enable stateless mode for serverless and horizontally-scaled deployments.
+     *
+     * When `true`, every request creates a fresh MCP server instance with no
+     * session tracking. This means:
+     * - No in-memory session map (works across Lambda invocations, multiple instances)
+     * - No `mcp-session-id` validation (requests aren't tied to a specific instance)
+     * - The MCP SDK's stateless transport is used (`sessionIdGenerator: undefined`)
+     */
+    stateless?: boolean;
 }
 /**
  * Configuration for creating a Web Standard MCP handler (serverless/edge).
@@ -113,6 +123,16 @@ export interface WebHandlerConfig {
      * where holding open SSE connections is unreliable. Defaults to `true`.
      */
     enableJsonResponse?: boolean;
+    /**
+     * Enable stateless mode for serverless and horizontally-scaled deployments.
+     *
+     * When `true`, every request creates a fresh MCP server instance with no
+     * session tracking. This means:
+     * - No in-memory session map (works across Lambda invocations, multiple instances)
+     * - No `mcp-session-id` validation (requests aren't tied to a specific instance)
+     * - The MCP SDK's stateless transport is used (`sessionIdGenerator: undefined`)
+     */
+    stateless?: boolean;
 }
 /**
  * Create an MCP server with production tool handlers and pre-built resources.
@@ -121,6 +141,17 @@ export interface WebHandlerConfig {
  * Resources serve pre-built HTML with their _meta preserved.
  */
 export declare function createProductionMcpServer(config: ProductionServerConfig): McpServer;
+/**
+ * Detect the MCP host from HTTP request headers.
+ *
+ * ChatGPT sends `user-agent: openai-mcp/1.0.0` on all MCP HTTP requests.
+ * Claude sends `user-agent: Claude-User` and `x-anthropic-client: ClaudeAI`.
+ *
+ * Returns the `clientInfo.name` equivalent: `'openai-mcp'` or `'claude'`.
+ * Returns undefined if the host can't be identified.
+ */
+export declare function detectClientFromHeaders(headers: Headers): string | undefined;
+export declare function detectClientFromHeaders(headers: Record<string, string | string[] | undefined>): string | undefined;
 /**
  * Create a request handler that manages MCP sessions over Streamable HTTP.
  *