agents 0.7.4 → 0.7.5

package/dist/client-storage-BPjfP_is.d.ts

@@ -1,604 +0,0 @@
-import { n as MCPObservabilityEvent } from "./agent-eZnMHidZ.js";
-import { AgentMcpOAuthProvider } from "./mcp/do-oauth-client-provider.js";
-import { McpAgent } from "./mcp/index.js";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import {
-  SSEClientTransport,
-  SSEClientTransportOptions
-} from "@modelcontextprotocol/sdk/client/sse.js";
-import {
-  StreamableHTTPClientTransport,
-  StreamableHTTPClientTransportOptions
-} from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import {
-  ElicitRequest,
-  ElicitResult,
-  InitializeRequestParams,
-  JSONRPCMessage,
-  MessageExtraInfo,
-  Prompt,
-  RequestId,
-  Resource,
-  ResourceTemplate,
-  ServerCapabilities,
-  Tool
-} from "@modelcontextprotocol/sdk/types.js";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import {
-  Transport,
-  TransportSendOptions
-} from "@modelcontextprotocol/sdk/shared/transport.js";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { Client as Client$1 } from "@modelcontextprotocol/sdk/client";
-import { EventStore } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
-
-//#region src/core/events.d.ts
-interface Disposable {
-  dispose(): void;
-}
-type Event<T> = (listener: (e: T) => void) => Disposable;
-declare class Emitter<T> implements Disposable {
-  private _listeners;
-  readonly event: Event<T>;
-  fire(data: T): void;
-  dispose(): void;
-}
-//#endregion
-//#region src/mcp/types.d.ts
-type MaybePromise<T> = T | Promise<T>;
-type HttpTransportType = "sse" | "streamable-http";
-type BaseTransportType = HttpTransportType | "rpc";
-type TransportType = BaseTransportType | "auto";
-interface CORSOptions {
-  origin?: string;
-  methods?: string;
-  headers?: string;
-  maxAge?: number;
-  exposeHeaders?: string;
-}
-interface ServeOptions {
-  binding?: string;
-  corsOptions?: CORSOptions;
-  transport?: BaseTransportType;
-  jurisdiction?: DurableObjectJurisdiction;
-}
-type McpClientOptions = ConstructorParameters<typeof Client$1>[1];
-//#endregion
-//#region src/mcp/client-transports.d.ts
-/**
- * @deprecated Use SSEClientTransport from @modelcontextprotocol/sdk/client/sse.js instead. This alias will be removed in the next major version.
- */
-declare class SSEEdgeClientTransport extends SSEClientTransport {
-  constructor(url: URL, options: SSEClientTransportOptions);
-}
-/**
- * @deprecated Use StreamableHTTPClientTransport from @modelcontextprotocol/sdk/client/streamableHttp.js instead. This alias will be removed in the next major version.
- */
-declare class StreamableHTTPEdgeClientTransport extends StreamableHTTPClientTransport {
-  constructor(url: URL, options: StreamableHTTPClientTransportOptions);
-}
-//#endregion
-//#region src/mcp/worker-transport.d.ts
-interface MCPStorageApi {
-  get(): Promise<TransportState | undefined> | TransportState | undefined;
-  set(state: TransportState): Promise<void> | void;
-}
-interface TransportState {
-  sessionId?: string;
-  initialized: boolean;
-  initializeParams?: InitializeRequestParams;
-}
-interface WorkerTransportOptions {
-  /**
-   * Function that generates a session ID for the transport.
-   * The session ID SHOULD be globally unique and cryptographically secure.
-   * Return undefined to disable session management (stateless mode).
-   */
-  sessionIdGenerator?: () => string;
-  /**
-   * Enable traditional Request/Response mode, this will disable streaming.
-   */
-  enableJsonResponse?: boolean;
-  /**
-   * Callback fired when a new session is initialized.
-   */
-  onsessioninitialized?: (sessionId: string) => void;
-  /**
-   * Callback fired when a session is closed via DELETE request.
-   */
-  onsessionclosed?: (sessionId: string) => void;
-  corsOptions?: CORSOptions;
-  /**
-   * Optional storage api for persisting transport state.
-   * Use this to store session state in Durable Object/Agent storage
-   * so it survives hibernation/restart.
-   */
-  storage?: MCPStorageApi;
-  /**
-   * Event store for resumability support.
-   * If provided, enables clients to reconnect and resume messages using Last-Event-ID.
-   */
-  eventStore?: EventStore;
-  /**
-   * Retry interval in milliseconds to suggest to clients in SSE retry field.
-   * Controls client reconnection timing for polling behavior.
-   */
-  retryInterval?: number;
-}
-declare class WorkerTransport implements Transport {
-  started: boolean;
-  private initialized;
-  private sessionIdGenerator?;
-  private enableJsonResponse;
-  private onsessioninitialized?;
-  private onsessionclosed?;
-  private standaloneSseStreamId;
-  private streamMapping;
-  private requestToStreamMapping;
-  private requestResponseMap;
-  private corsOptions?;
-  private storage?;
-  private stateRestored;
-  private eventStore?;
-  private retryInterval?;
-  private initializeParams?;
-  sessionId?: string;
-  onclose?: () => void;
-  onerror?: (error: Error) => void;
-  onmessage?: (message: JSONRPCMessage, extra?: MessageExtraInfo) => void;
-  constructor(options?: WorkerTransportOptions);
-  /**
-   * Restore transport state from persistent storage.
-   * This is automatically called on start.
-   */
-  private restoreState;
-  /**
-   * Persist current transport state to storage.
-   */
-  private saveState;
-  start(): Promise<void>;
-  /**
-   * Validates the MCP-Protocol-Version header on incoming requests.
-   *
-   * This performs a simple check: if a version header is present, it must be
-   * in the SUPPORTED_PROTOCOL_VERSIONS list. We do not track the negotiated
-   * version or enforce version consistency across requests - the SDK handles
-   * version negotiation during initialization, and we simply reject any
-   * explicitly unsupported versions.
-   *
-   * - Header present and supported: Accept
-   * - Header present and unsupported: 400 Bad Request
-   * - Header missing: Accept (version validation is optional)
-   */
-  private validateProtocolVersion;
-  private getHeaders;
-  handleRequest(request: Request, parsedBody?: unknown): Promise<Response>;
-  private handleGetRequest;
-  private handlePostRequest;
-  private handleDeleteRequest;
-  private handleOptionsRequest;
-  private handleUnsupportedRequest;
-  private validateSession;
-  close(): Promise<void>;
-  /**
-   * Close an SSE stream for a specific request, triggering client reconnection.
-   * Use this to implement polling behavior during long-running operations -
-   * client will reconnect after the retry interval specified in the priming event.
-   */
-  closeSSEStream(requestId: RequestId): void;
-  send(message: JSONRPCMessage, options?: TransportSendOptions): Promise<void>;
-}
-//#endregion
-//#region src/mcp/auth-context.d.ts
-interface McpAuthContext {
-  props: Record<string, unknown>;
-}
-declare function getMcpAuthContext(): McpAuthContext | undefined;
-//#endregion
-//#region src/mcp/handler.d.ts
-interface CreateMcpHandlerOptions extends WorkerTransportOptions {
-  /**
-   * The route path that this MCP handler should respond to.
-   * If specified, the handler will only process requests that match this route.
-   * @default "/mcp"
-   */
-  route?: string;
-  /**
-   * An optional auth context to use for handling MCP requests.
-   * If not provided, the handler will look for props in the execution context.
-   */
-  authContext?: McpAuthContext;
-  /**
-   * An optional transport to use for handling MCP requests.
-   * If not provided, a WorkerTransport will be created with the provided WorkerTransportOptions.
-   */
-  transport?: WorkerTransport;
-}
-declare function createMcpHandler(
-  server: McpServer | Server,
-  options?: CreateMcpHandlerOptions
-): (request: Request, env: unknown, ctx: ExecutionContext) => Promise<Response>;
-/**
- * @deprecated This has been renamed to createMcpHandler, and experimental_createMcpHandler will be removed in the next major version
- */
-declare function experimental_createMcpHandler(
-  server: McpServer | Server,
-  options?: CreateMcpHandlerOptions
-): (request: Request, env: unknown, ctx: ExecutionContext) => Promise<Response>;
-//#endregion
-//#region src/mcp/rpc.d.ts
-declare const RPC_DO_PREFIX = "rpc:";
-interface RPCClientTransportOptions<T extends McpAgent = McpAgent> {
-  namespace: DurableObjectNamespace<T>;
-  name: string;
-  props?: Record<string, unknown>;
-}
-declare class RPCClientTransport implements Transport {
-  private _namespace;
-  private _name;
-  private _props?;
-  private _stub?;
-  private _started;
-  private _protocolVersion?;
-  sessionId?: string;
-  onclose?: () => void;
-  onerror?: (error: Error) => void;
-  onmessage?: (message: JSONRPCMessage, extra?: MessageExtraInfo) => void;
-  constructor(options: RPCClientTransportOptions<McpAgent>);
-  setProtocolVersion(version: string): void;
-  getProtocolVersion(): string | undefined;
-  start(): Promise<void>;
-  close(): Promise<void>;
-  send(
-    message: JSONRPCMessage | JSONRPCMessage[],
-    options?: TransportSendOptions
-  ): Promise<void>;
-}
-interface RPCServerTransportOptions {
-  timeout?: number;
-}
-declare class RPCServerTransport implements Transport {
-  private _started;
-  private _pendingResponse;
-  private _responseResolver;
-  private _protocolVersion?;
-  private _timeout;
-  sessionId?: string;
-  onclose?: () => void;
-  onerror?: (error: Error) => void;
-  onmessage?: (message: JSONRPCMessage, extra?: MessageExtraInfo) => void;
-  constructor(options?: RPCServerTransportOptions);
-  setProtocolVersion(version: string): void;
-  getProtocolVersion(): string | undefined;
-  start(): Promise<void>;
-  close(): Promise<void>;
-  send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
-  handle(
-    message: JSONRPCMessage | JSONRPCMessage[]
-  ): Promise<JSONRPCMessage | JSONRPCMessage[] | undefined>;
-}
-//#endregion
-//#region src/mcp/client-connection.d.ts
-/**
- * Connection state machine for MCP client connections.
- *
- * State transitions:
- * - Non-OAuth: init() → CONNECTING → DISCOVERING → READY
- * - OAuth: init() → AUTHENTICATING → (callback) → CONNECTING → DISCOVERING → READY
- * - Any state can transition to FAILED on error
- */
-declare const MCPConnectionState: {
-  /** Waiting for OAuth authorization to complete */ readonly AUTHENTICATING: "authenticating" /** Establishing transport connection to MCP server */;
-  readonly CONNECTING: "connecting" /** Transport connection established */;
-  readonly CONNECTED: "connected" /** Discovering server capabilities (tools, resources, prompts) */;
-  readonly DISCOVERING: "discovering" /** Fully connected and ready to use */;
-  readonly READY: "ready" /** Connection failed at some point */;
-  readonly FAILED: "failed";
-};
-/**
- * Connection state type for MCP client connections.
- */
-type MCPConnectionState =
-  (typeof MCPConnectionState)[keyof typeof MCPConnectionState];
-/**
- * Transport options for MCP client connections.
- * Combines transport-specific options with auth provider and type selection.
- */
-type MCPTransportOptions = (
-  | SSEClientTransportOptions
-  | StreamableHTTPClientTransportOptions
-  | RPCClientTransportOptions
-) & {
-  authProvider?: AgentMcpOAuthProvider;
-  type?: TransportType;
-};
-/**
- * Result of a discovery operation.
- * success indicates whether discovery completed successfully.
- * error is present when success is false.
- */
-type MCPDiscoveryResult = {
-  success: boolean;
-  error?: string;
-};
-declare class MCPClientConnection {
-  url: URL;
-  options: {
-    transport: MCPTransportOptions;
-    client: McpClientOptions;
-  };
-  client: Client;
-  connectionState: MCPConnectionState;
-  connectionError: string | null;
-  lastConnectedTransport: BaseTransportType | undefined;
-  instructions?: string;
-  tools: Tool[];
-  prompts: Prompt[];
-  resources: Resource[];
-  resourceTemplates: ResourceTemplate[];
-  serverCapabilities: ServerCapabilities | undefined;
-  /** Tracks in-flight discovery to allow cancellation */
-  private _discoveryAbortController;
-  private readonly _onObservabilityEvent;
-  readonly onObservabilityEvent: Event<MCPObservabilityEvent>;
-  constructor(
-    url: URL,
-    info: ConstructorParameters<typeof Client>[0],
-    options?: {
-      transport: MCPTransportOptions;
-      client: McpClientOptions;
-    }
-  );
-  /**
-   * Initialize a client connection, if authentication is required, the connection will be in the AUTHENTICATING state
-   * Sets connection state based on the result and emits observability events
-   *
-   * @returns Error message if connection failed, undefined otherwise
-   */
-  init(): Promise<string | undefined>;
-  /**
-   * Finish OAuth by probing transports based on configured type.
-   * - Explicit: finish on that transport
-   * - Auto: try streamable-http, then sse on 404/405/Not Implemented
-   */
-  private finishAuthProbe;
-  /**
-   * Complete OAuth authorization
-   */
-  completeAuthorization(code: string): Promise<void>;
-  /**
-   * Discover server capabilities and register tools, resources, prompts, and templates.
-   * This method does the work but does not manage connection state - that's handled by discover().
-   */
-  discoverAndRegister(): Promise<void>;
-  /**
-   * Discover server capabilities with timeout and cancellation support.
-   * If called while a previous discovery is in-flight, the previous discovery will be aborted.
-   *
-   * @param options Optional configuration
-   * @param options.timeoutMs Timeout in milliseconds (default: 15000)
-   * @returns Result indicating success/failure with optional error message
-   */
-  discover(options?: { timeoutMs?: number }): Promise<MCPDiscoveryResult>;
-  /**
-   * Cancel any in-flight discovery operation.
-   * Called when closing the connection.
-   */
-  cancelDiscovery(): void;
-  /**
-   * Notification handler registration for tools
-   * Should only be called if serverCapabilities.tools exists
-   */
-  registerTools(): Promise<Tool[]>;
-  /**
-   * Notification handler registration for resources
-   * Should only be called if serverCapabilities.resources exists
-   */
-  registerResources(): Promise<Resource[]>;
-  /**
-   * Notification handler registration for prompts
-   * Should only be called if serverCapabilities.prompts exists
-   */
-  registerPrompts(): Promise<Prompt[]>;
-  registerResourceTemplates(): Promise<ResourceTemplate[]>;
-  fetchTools(): Promise<
-    {
-      inputSchema: {
-        [x: string]: unknown;
-        type: "object";
-        properties?:
-          | {
-              [x: string]: object;
-            }
-          | undefined;
-        required?: string[] | undefined;
-      };
-      name: string;
-      description?: string | undefined;
-      outputSchema?:
-        | {
-            [x: string]: unknown;
-            type: "object";
-            properties?:
-              | {
-                  [x: string]: object;
-                }
-              | undefined;
-            required?: string[] | undefined;
-          }
-        | undefined;
-      annotations?:
-        | {
-            title?: string | undefined;
-            readOnlyHint?: boolean | undefined;
-            destructiveHint?: boolean | undefined;
-            idempotentHint?: boolean | undefined;
-            openWorldHint?: boolean | undefined;
-          }
-        | undefined;
-      execution?:
-        | {
-            taskSupport?: "optional" | "required" | "forbidden" | undefined;
-          }
-        | undefined;
-      _meta?:
-        | {
-            [x: string]: unknown;
-          }
-        | undefined;
-      icons?:
-        | {
-            src: string;
-            mimeType?: string | undefined;
-            sizes?: string[] | undefined;
-            theme?: "light" | "dark" | undefined;
-          }[]
-        | undefined;
-      title?: string | undefined;
-    }[]
-  >;
-  fetchResources(): Promise<
-    {
-      uri: string;
-      name: string;
-      description?: string | undefined;
-      mimeType?: string | undefined;
-      annotations?:
-        | {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-          }
-        | undefined;
-      _meta?:
-        | {
-            [x: string]: unknown;
-          }
-        | undefined;
-      icons?:
-        | {
-            src: string;
-            mimeType?: string | undefined;
-            sizes?: string[] | undefined;
-            theme?: "light" | "dark" | undefined;
-          }[]
-        | undefined;
-      title?: string | undefined;
-    }[]
-  >;
-  fetchPrompts(): Promise<
-    {
-      name: string;
-      description?: string | undefined;
-      arguments?:
-        | {
-            name: string;
-            description?: string | undefined;
-            required?: boolean | undefined;
-          }[]
-        | undefined;
-      _meta?:
-        | {
-            [x: string]: unknown;
-          }
-        | undefined;
-      icons?:
-        | {
-            src: string;
-            mimeType?: string | undefined;
-            sizes?: string[] | undefined;
-            theme?: "light" | "dark" | undefined;
-          }[]
-        | undefined;
-      title?: string | undefined;
-    }[]
-  >;
-  fetchResourceTemplates(): Promise<
-    {
-      uriTemplate: string;
-      name: string;
-      description?: string | undefined;
-      mimeType?: string | undefined;
-      annotations?:
-        | {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-          }
-        | undefined;
-      _meta?:
-        | {
-            [x: string]: unknown;
-          }
-        | undefined;
-      icons?:
-        | {
-            src: string;
-            mimeType?: string | undefined;
-            sizes?: string[] | undefined;
-            theme?: "light" | "dark" | undefined;
-          }[]
-        | undefined;
-      title?: string | undefined;
-    }[]
-  >;
-  /**
-   * Handle elicitation request from server
-   * Automatically uses the Agent's built-in elicitation handling if available
-   */
-  handleElicitationRequest(_request: ElicitRequest): Promise<ElicitResult>;
-  /**
-   * Get the transport for the client
-   * @param transportType - The transport type to get
-   * @returns The transport for the client
-   */
-  getTransport(
-    transportType: BaseTransportType
-  ): StreamableHTTPClientTransport | SSEClientTransport | RPCClientTransport;
-  private tryConnect;
-  private _capabilityErrorHandler;
-}
-//#endregion
-//#region src/mcp/client-storage.d.ts
-/**
- * Represents a row in the cf_agents_mcp_servers table
- */
-type MCPServerRow = {
-  id: string;
-  name: string;
-  server_url: string;
-  client_id: string | null;
-  auth_url: string | null;
-  callback_url: string;
-  server_options: string | null;
-};
-//#endregion
-export {
-  ServeOptions as C,
-  Event as E,
-  McpClientOptions as S,
-  Emitter as T,
-  WorkerTransportOptions as _,
-  RPCClientTransport as a,
-  BaseTransportType as b,
-  RPCServerTransportOptions as c,
-  createMcpHandler as d,
-  experimental_createMcpHandler as f,
-  WorkerTransport as g,
-  TransportState as h,
-  MCPTransportOptions as i,
-  RPC_DO_PREFIX as l,
-  getMcpAuthContext as m,
-  MCPClientConnection as n,
-  RPCClientTransportOptions as o,
-  McpAuthContext as p,
-  MCPConnectionState as r,
-  RPCServerTransport as s,
-  MCPServerRow as t,
-  CreateMcpHandlerOptions as u,
-  SSEEdgeClientTransport as v,
-  TransportType as w,
-  MaybePromise as x,
-  StreamableHTTPEdgeClientTransport as y
-};
-//# sourceMappingURL=client-storage-BPjfP_is.d.ts.map