agents 0.20.1 → 0.22.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +51 -12
- package/dist/{agent-tool-types-BC-WFlsz.d.ts → agent-routing-CnkaHb-v.d.ts} +3305 -3138
- package/dist/agent-routing.d.ts +14 -0
- package/dist/agent-routing.js +187 -0
- package/dist/agent-routing.js.map +1 -0
- package/dist/agent-tool-types.d.ts +26 -26
- package/dist/{agent-tools-DeHe9Xov.d.ts → agent-tools-C0XJqWzB.d.ts} +7 -7
- package/dist/agent-tools.d.ts +44 -28
- package/dist/agent-tools.js +16 -7
- package/dist/agent-tools.js.map +1 -1
- package/dist/browser/ai.d.ts +5 -3
- package/dist/browser/ai.js +88 -8
- package/dist/browser/ai.js.map +1 -1
- package/dist/browser/index.d.ts +1 -1
- package/dist/browser/index.js +1 -1
- package/dist/browser/tanstack-ai.js +13 -1
- package/dist/browser/tanstack-ai.js.map +1 -1
- package/dist/capability-BjSKYpzg.js +42 -0
- package/dist/capability-BjSKYpzg.js.map +1 -0
- package/dist/capability-runner-CvHGZqUu.d.ts +150 -0
- package/dist/chat/index.d.ts +51 -15
- package/dist/chat/index.js +59 -4
- package/dist/chat/index.js.map +1 -1
- package/dist/chat/react.d.ts +19 -180
- package/dist/chat/react.js +93 -600
- package/dist/chat/react.js.map +1 -1
- package/dist/chat/transport.d.ts +10 -0
- package/dist/chat/transport.js +2 -0
- package/dist/chat-sdk/index.d.ts +4 -4
- package/dist/chat-sdk/index.js +1 -1
- package/dist/{client-zqKcsyFa.js → client-jagG8a9_.js} +129 -37
- package/dist/client-jagG8a9_.js.map +1 -0
- package/dist/client.d.ts +1 -1
- package/dist/client.js +1 -1
- package/dist/{cloudflare-BduZwmYK.js → cloudflare-Dzvc7V2N.js} +10 -3
- package/dist/{cloudflare-BduZwmYK.js.map → cloudflare-Dzvc7V2N.js.map} +1 -1
- package/dist/{connector-v2M1zlZp.d.ts → connector-CkQD4MK3.d.ts} +20 -3
- package/dist/{connector-KEJnl6e5.js → connector-CptFKzRh.js} +158 -40
- package/dist/connector-CptFKzRh.js.map +1 -0
- package/dist/current-agent-CuMErtly.d.ts +283 -0
- package/dist/current-agent-DhoDkSnH.js +51 -0
- package/dist/current-agent-DhoDkSnH.js.map +1 -0
- package/dist/diagnostics-CaBjfz4J.js +41 -0
- package/dist/diagnostics-CaBjfz4J.js.map +1 -0
- package/dist/{do-oauth-client-provider-VTZj2VtM.d.ts → do-oauth-client-provider-Tmf1vgKz.d.ts} +2 -2
- package/dist/durable-object-lifecycle-D6nNQJJd.js +862 -0
- package/dist/durable-object-lifecycle-D6nNQJJd.js.map +1 -0
- package/dist/{email-CL27preh.d.ts → email-7TatiTnl.d.ts} +38 -9
- package/dist/email-send.d.ts +15 -0
- package/dist/email-send.js +32 -0
- package/dist/email-send.js.map +1 -0
- package/dist/email.d.ts +14 -10
- package/dist/email.js.map +1 -1
- package/dist/experimental/memory/session/index.d.ts +3 -2
- package/dist/experimental/memory/session/index.js +15 -10
- package/dist/experimental/memory/session/index.js.map +1 -1
- package/dist/{handler-stateless-C_bo-Ytq.d.ts → handler-stateless-DxYpJ_XF.d.ts} +3 -3
- package/dist/{handler-stateless-CIkKPETH.js → handler-stateless-VvrWSAVA.js} +5 -5
- package/dist/handler-stateless-VvrWSAVA.js.map +1 -0
- package/dist/{index-BRnybD6X.d.ts → index-DcSAZKsB.d.ts} +19 -31
- package/dist/index.d.ts +102 -91
- package/dist/index.js +12 -7235
- package/dist/internal_context-BlxFEWfn.d.ts +19 -0
- package/dist/internal_context.d.ts +10 -4
- package/dist/internal_context.js +1 -10
- package/dist/{client-invoker-BNSZxAkv.d.ts → invoker-CG0_p_Wq.d.ts} +2 -2
- package/dist/{client-invoker-VNZ7X0nn.js → invoker-CHMnoxIA.js} +2 -2
- package/dist/invoker-CHMnoxIA.js.map +1 -0
- package/dist/lifecycle/index.d.ts +48 -0
- package/dist/lifecycle/index.js +4 -0
- package/dist/mcp/{do-oauth-client-provider.d.ts → client/do-oauth-client-provider.d.ts} +1 -1
- package/dist/mcp/{do-oauth-client-provider.js → client/do-oauth-client-provider.js} +1 -1
- package/dist/mcp/client/do-oauth-client-provider.js.map +1 -0
- package/dist/mcp/client/index.d.ts +42 -0
- package/dist/mcp/{client.js → client/index.js} +1 -1
- package/dist/mcp/{x402.d.ts → client/x402.d.ts} +2 -2
- package/dist/mcp/{x402.js → client/x402.js} +2 -2
- package/dist/mcp/client/x402.js.map +1 -0
- package/dist/mcp/index.d.ts +36 -36
- package/dist/mcp/index.js +14 -16
- package/dist/mcp/index.js.map +1 -1
- package/dist/mcp/{server.d.ts → server/index.d.ts} +1 -1
- package/dist/mcp/{server.js → server/index.js} +1 -1
- package/dist/observability/ai/index.d.ts +1 -130
- package/dist/observability/ai/index.js +88 -433
- package/dist/observability/ai/index.js.map +1 -1
- package/dist/observability/index.d.ts +4 -4
- package/dist/observability/index.js +3 -50
- package/dist/observability/index.js.map +1 -1
- package/dist/{wire-types-CU9rLoeS.js → protocol-B0nh6KNf.js} +20 -66
- package/dist/protocol-B0nh6KNf.js.map +1 -0
- package/dist/react.d.ts +4 -4
- package/dist/react.js +6 -9
- package/dist/react.js.map +1 -1
- package/dist/schedule.d.ts +25 -94
- package/dist/schedule.js +1 -98
- package/dist/schedule.js.map +1 -1
- package/dist/scheduler-CR9RHGos.js +857 -0
- package/dist/scheduler-CR9RHGos.js.map +1 -0
- package/dist/scheduler-DQoTGoAW.d.ts +224 -0
- package/dist/schedules/index.d.ts +22 -0
- package/dist/schedules/index.js +2 -0
- package/dist/schedules/parser.d.ts +79 -0
- package/dist/schedules/parser.js +103 -0
- package/dist/schedules/parser.js.map +1 -0
- package/dist/serializable.d.ts +1 -1
- package/dist/sql-error-CPY-GXyI.d.ts +12 -0
- package/dist/sql-error.d.ts +2 -0
- package/dist/sql-error.js +16 -0
- package/dist/sql-error.js.map +1 -0
- package/dist/src-5W6JNKVb.js +6613 -0
- package/dist/src-5W6JNKVb.js.map +1 -0
- package/dist/sub-routing.d.ts +18 -6
- package/dist/sub-routing.js +92 -2
- package/dist/sub-routing.js.map +1 -1
- package/dist/wire-types-CnMt6_HR.js +47 -0
- package/dist/wire-types-CnMt6_HR.js.map +1 -0
- package/dist/workflow-types.d.ts +25 -25
- package/dist/workflow-types.js.map +1 -1
- package/dist/workflows.d.ts +22 -22
- package/dist/workflows.js +2 -1
- package/dist/workflows.js.map +1 -1
- package/dist/ws-chat-transport-UNRIS2xl.d.ts +184 -0
- package/dist/ws-chat-transport-rWwta645.js +698 -0
- package/dist/ws-chat-transport-rWwta645.js.map +1 -0
- package/docs/adding-to-existing-project.md +4 -2
- package/docs/agent-class.md +29 -87
- package/docs/agent-tools.md +29 -0
- package/docs/browse-the-web.md +16 -1
- package/docs/chat-agents.md +16 -13
- package/docs/client-sdk.md +12 -8
- package/docs/configuration.md +7 -1
- package/docs/cross-domain-authentication.md +7 -35
- package/docs/durable-execution.md +1 -1
- package/docs/email.md +2 -13
- package/docs/http-websockets.md +1 -11
- package/docs/human-in-the-loop.md +16 -13
- package/docs/index.md +1 -0
- package/docs/lifecycle.md +323 -0
- package/docs/long-running-agents.md +13 -15
- package/docs/mcp-client.md +55 -0
- package/docs/mcp-servers.md +6 -0
- package/docs/mcp-transports.md +18 -12
- package/docs/migration-to-ai-sdk-v5.md +2 -2
- package/docs/migration-to-ai-sdk-v6.md +5 -1
- package/docs/observability.md +33 -77
- package/docs/resumable-streaming.md +1 -1
- package/docs/routing.md +27 -0
- package/docs/scheduling.md +175 -15
- package/docs/server-driven-messages.md +1 -1
- package/docs/sub-agents.md +47 -2
- package/docs/webhooks.md +109 -136
- package/docs/workflows.md +9 -1
- package/package.json +41 -23
- package/dist/cli/index.d.ts +0 -1
- package/dist/cli/index.js +0 -26
- package/dist/cli/index.js.map +0 -1
- package/dist/client-invoker-VNZ7X0nn.js.map +0 -1
- package/dist/client-zqKcsyFa.js.map +0 -1
- package/dist/connector-KEJnl6e5.js.map +0 -1
- package/dist/handler-stateless-CIkKPETH.js.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/internal_context-Dg4Cgjcu.d.ts +0 -37
- package/dist/internal_context.js.map +0 -1
- package/dist/mcp/client.d.ts +0 -42
- package/dist/mcp/do-oauth-client-provider.js.map +0 -1
- package/dist/mcp/x402.js.map +0 -1
- package/dist/wire-types-CU9rLoeS.js.map +0 -1
- package/dist/workflow-types-Baz_PO5v.d.ts +0 -280
|
@@ -44,13 +44,13 @@ interface ServeOptions {
|
|
|
44
44
|
jurisdiction?: DurableObjectJurisdiction;
|
|
45
45
|
}
|
|
46
46
|
//#endregion
|
|
47
|
-
//#region src/mcp/auth-context.d.ts
|
|
47
|
+
//#region src/mcp/server/auth-context.d.ts
|
|
48
48
|
interface McpAuthContext {
|
|
49
49
|
props: Record<string, unknown>;
|
|
50
50
|
}
|
|
51
51
|
declare function getMcpAuthContext(): McpAuthContext | undefined;
|
|
52
52
|
//#endregion
|
|
53
|
-
//#region src/mcp/handler-stateless.d.ts
|
|
53
|
+
//#region src/mcp/server/handler-stateless.d.ts
|
|
54
54
|
interface CreateStatelessMcpHandlerOptions extends Omit<
|
|
55
55
|
CreateMcpHandlerOptions,
|
|
56
56
|
"bus"
|
|
@@ -104,4 +104,4 @@ export {
|
|
|
104
104
|
CreateStatelessMcpHandlerOptions as t,
|
|
105
105
|
McpClientOptions as u
|
|
106
106
|
};
|
|
107
|
-
//# sourceMappingURL=handler-stateless-
|
|
107
|
+
//# sourceMappingURL=handler-stateless-DxYpJ_XF.d.ts.map
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { AsyncLocalStorage } from "node:async_hooks";
|
|
2
2
|
import { WebStandardStreamableHTTPServerTransport, createMcpHandler, hostHeaderValidationResponse, isJSONRPCRequest, isLegacyRequest, localhostAllowedHostnames, localhostAllowedOrigins, originValidationResponse } from "@modelcontextprotocol/server";
|
|
3
|
-
//#region src/mcp/auth-context.ts
|
|
3
|
+
//#region src/mcp/server/auth-context.ts
|
|
4
4
|
const VERIFIED_OAUTH_CONTEXT = Symbol.for("cloudflare.workers-oauth-provider.verified-context.v1");
|
|
5
5
|
const authContextStorage = new AsyncLocalStorage();
|
|
6
6
|
function getMcpAuthContext() {
|
|
@@ -49,7 +49,7 @@ function getVerifiedOAuthAuthInfo(ctx) {
|
|
|
49
49
|
};
|
|
50
50
|
}
|
|
51
51
|
//#endregion
|
|
52
|
-
//#region src/mcp/handler-errors.ts
|
|
52
|
+
//#region src/mcp/server/handler-errors.ts
|
|
53
53
|
function internalErrorResponse(id = null) {
|
|
54
54
|
return Response.json({
|
|
55
55
|
jsonrpc: "2.0",
|
|
@@ -70,7 +70,7 @@ function reportHandlerError(onerror, error) {
|
|
|
70
70
|
} catch {}
|
|
71
71
|
}
|
|
72
72
|
//#endregion
|
|
73
|
-
//#region src/mcp/handler-legacy-compat.ts
|
|
73
|
+
//#region src/mcp/server/handler-legacy-compat.ts
|
|
74
74
|
/**
|
|
75
75
|
* Temporary adapter for Legacy compatibility on the SDK v2 transport.
|
|
76
76
|
*
|
|
@@ -178,7 +178,7 @@ function createLegacyCompatibilityRequestHandler(factory, handlerOptions = {}) {
|
|
|
178
178
|
return { fetch };
|
|
179
179
|
}
|
|
180
180
|
//#endregion
|
|
181
|
-
//#region src/mcp/handler-stateless.ts
|
|
181
|
+
//#region src/mcp/server/handler-stateless.ts
|
|
182
182
|
const DEFAULT_CORS_OPTIONS = {
|
|
183
183
|
origin: "*",
|
|
184
184
|
headers: "Content-Type, Accept, Authorization, mcp-session-id, MCP-Protocol-Version, Mcp-Method, Mcp-Name",
|
|
@@ -315,4 +315,4 @@ function createStatelessMcpHandler(factory, options = {}) {
|
|
|
315
315
|
//#endregion
|
|
316
316
|
export { getMcpAuthContext as n, runWithAuthContext as r, createStatelessMcpHandler as t };
|
|
317
317
|
|
|
318
|
-
//# sourceMappingURL=handler-stateless-
|
|
318
|
+
//# sourceMappingURL=handler-stateless-VvrWSAVA.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"handler-stateless-VvrWSAVA.js","names":["candidate","createSdkMcpHandler"],"sources":["../src/mcp/server/auth-context.ts","../src/mcp/server/handler-errors.ts","../src/mcp/server/handler-legacy-compat.ts","../src/mcp/server/handler-stateless.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { AuthInfo } from \"@modelcontextprotocol/server\";\n\nconst VERIFIED_OAUTH_CONTEXT = Symbol.for(\n \"cloudflare.workers-oauth-provider.verified-context.v1\"\n);\n\ninterface VerifiedWorkersOAuthContext {\n version: 1;\n token: string;\n clientId: string;\n scopes: string[];\n expiresAt?: number;\n resource?: string;\n props: Record<string, unknown>;\n}\n\nexport interface McpAuthContext {\n props: Record<string, unknown>;\n}\n\nconst authContextStorage = new AsyncLocalStorage<McpAuthContext>();\n\nexport function getMcpAuthContext(): McpAuthContext | undefined {\n return authContextStorage.getStore();\n}\n\nexport function runWithAuthContext<T>(context: McpAuthContext, fn: () => T): T {\n return authContextStorage.run(context, fn);\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n return false;\n }\n const prototype = Object.getPrototypeOf(value);\n return prototype === Object.prototype || prototype === null;\n}\n\nfunction invalidVerifiedContext(): never {\n throw new TypeError(\"Invalid verified OAuth request context\");\n}\n\nexport function getVerifiedOAuthAuthInfo(\n ctx: ExecutionContext\n): { authInfo: AuthInfo; props: Record<string, unknown> } | undefined {\n const symbolContext = ctx as ExecutionContext & Record<symbol, unknown>;\n if (!(VERIFIED_OAUTH_CONTEXT in symbolContext)) return undefined;\n\n const value = symbolContext[VERIFIED_OAUTH_CONTEXT];\n if (!isPlainRecord(value) || value.version !== 1) invalidVerifiedContext();\n\n const candidate = value as Partial<VerifiedWorkersOAuthContext>;\n const { token, clientId, scopes, expiresAt, resource, props } = candidate;\n if (\n typeof token !== \"string\" ||\n token.length === 0 ||\n typeof clientId !== \"string\" ||\n clientId.length === 0 ||\n !Array.isArray(scopes) ||\n !scopes.every((scope) => typeof scope === \"string\") ||\n !isPlainRecord(props)\n ) {\n invalidVerifiedContext();\n }\n\n if (\n expiresAt !== undefined &&\n (typeof expiresAt !== \"number\" ||\n !Number.isFinite(expiresAt) ||\n expiresAt <= 0)\n ) {\n invalidVerifiedContext();\n }\n\n let resourceUrl: URL | undefined;\n if (resource !== undefined) {\n if (typeof resource !== \"string\") invalidVerifiedContext();\n try {\n resourceUrl = new URL(resource);\n } catch {\n invalidVerifiedContext();\n }\n if (resourceUrl.protocol !== \"http:\" && resourceUrl.protocol !== \"https:\") {\n invalidVerifiedContext();\n }\n }\n\n if (ctx.props !== props) invalidVerifiedContext();\n\n return {\n props,\n authInfo: {\n token,\n clientId,\n scopes: [...scopes],\n ...(expiresAt !== undefined && { expiresAt }),\n ...(resourceUrl !== undefined && { resource: resourceUrl }),\n extra: { props }\n }\n };\n}\n","export function internalErrorResponse(\n id: string | number | null = null\n): Response {\n return Response.json(\n {\n jsonrpc: \"2.0\",\n error: { code: -32603, message: \"Internal server error\" },\n id\n },\n { status: 500 }\n );\n}\n\nexport function requestIdFromParsedBody(body: unknown): string | number | null {\n if (\n typeof body !== \"object\" ||\n body === null ||\n Array.isArray(body) ||\n !(\"method\" in body) ||\n typeof body.method !== \"string\" ||\n !(\"id\" in body)\n ) {\n return null;\n }\n return typeof body.id === \"string\" || typeof body.id === \"number\"\n ? body.id\n : null;\n}\n\nexport function reportHandlerError(\n onerror: ((error: Error) => void) | undefined,\n error: unknown\n): void {\n try {\n onerror?.(error instanceof Error ? error : new Error(String(error)));\n } catch {\n // Error reporting must not change the response.\n }\n}\n","import {\n WebStandardStreamableHTTPServerTransport,\n isJSONRPCRequest,\n type CreateMcpHandlerOptions,\n type McpHandlerRequestOptions,\n type McpServer,\n type McpServerFactory,\n type Server\n} from \"@modelcontextprotocol/server\";\nimport {\n internalErrorResponse,\n reportHandlerError,\n requestIdFromParsedBody\n} from \"./handler-errors\";\n/**\n * Temporary adapter for Legacy compatibility on the SDK v2 transport.\n *\n * Local deltas from the upstream stateless fallback:\n *\n * - impossible stateless server-to-client requests fail immediately rather\n * than leaving the tool handler waiting for a session response.\n *\n * Streaming and keepalive behavior remain delegated to the SDK transport.\n * Remove this adapter once the SDK exposes the reverse-request policy directly.\n */\nexport function createLegacyCompatibilityRequestHandler(\n factory: McpServerFactory,\n handlerOptions: Pick<CreateMcpHandlerOptions, \"keepAliveMs\" | \"onerror\"> = {}\n) {\n const { keepAliveMs, onerror } = handlerOptions;\n const fetch = async (\n request: Request,\n requestOptions: McpHandlerRequestOptions | undefined\n ): Promise<Response> => {\n // Match the upstream Legacy fallback: GET and DELETE are session operations\n // and cannot be served by a fresh per-request transport. Reject\n // them before running a factory with application-visible side effects.\n if (request.method.toUpperCase() !== \"POST\") {\n return Response.json(\n {\n jsonrpc: \"2.0\",\n error: { code: -32000, message: \"Method not allowed.\" },\n id: null\n },\n { status: 405 }\n );\n }\n\n if (request.signal.aborted) {\n return new Response(null, { status: 499 });\n }\n\n let product: McpServer | Server | undefined;\n let transport: WebStandardStreamableHTTPServerTransport | undefined;\n let teardownPromise: Promise<void> | undefined;\n const teardown = () =>\n (teardownPromise ??= (async () => {\n await Promise.all([\n transport?.close().catch(() => {}),\n product?.close().catch(() => {})\n ]);\n })());\n const onAbort = () => void teardown();\n\n try {\n product = await factory({\n era: \"legacy\",\n ...(requestOptions?.authInfo !== undefined && {\n authInfo: requestOptions.authInfo\n }),\n requestInfo: request\n });\n transport = new WebStandardStreamableHTTPServerTransport({\n keepAliveMs,\n sessionIdGenerator: undefined\n });\n\n const send = transport.send.bind(transport);\n transport.send = async (message, sendOptions) => {\n if (isJSONRPCRequest(message)) {\n transport?.onmessage?.({\n jsonrpc: \"2.0\",\n id: message.id,\n error: {\n code: -32603,\n message:\n \"Server-to-client requests are unavailable in the Legacy compatibility lane. \" +\n \"Use inputRequired(...) for Stateless clients, or route \" +\n \"Legacy traffic to a sessionful transport.\"\n }\n });\n return;\n }\n await send(message, sendOptions);\n };\n\n await product.connect(transport);\n if (request.signal.aborted) {\n await teardown();\n return new Response(null, { status: 499 });\n }\n request.signal.addEventListener(\"abort\", onAbort, { once: true });\n const response = await transport.handleRequest(request, {\n ...(requestOptions?.authInfo !== undefined && {\n authInfo: requestOptions.authInfo\n }),\n ...(requestOptions?.parsedBody !== undefined && {\n parsedBody: requestOptions.parsedBody\n })\n });\n\n if (\n response.body === null ||\n !response.headers.get(\"content-type\")?.includes(\"text/event-stream\")\n ) {\n request.signal.removeEventListener(\"abort\", onAbort);\n await teardown();\n return response;\n }\n\n const reader = response.body.getReader();\n const body = new ReadableStream<Uint8Array>({\n async pull(controller) {\n try {\n const { done, value } = await reader.read();\n if (done) {\n request.signal.removeEventListener(\"abort\", onAbort);\n await teardown();\n controller.close();\n } else if (value !== undefined) {\n controller.enqueue(value);\n }\n } catch (error) {\n request.signal.removeEventListener(\"abort\", onAbort);\n await teardown();\n controller.error(error);\n }\n },\n async cancel(reason) {\n request.signal.removeEventListener(\"abort\", onAbort);\n await reader.cancel(reason).catch(() => {});\n await teardown();\n }\n });\n return new Response(body, {\n status: response.status,\n statusText: response.statusText,\n headers: response.headers\n });\n } catch (error) {\n request.signal.removeEventListener(\"abort\", onAbort);\n await teardown();\n reportHandlerError(onerror, error);\n return internalErrorResponse(\n requestIdFromParsedBody(requestOptions?.parsedBody)\n );\n }\n };\n\n return { fetch };\n}\n","import {\n createMcpHandler as createSdkMcpHandler,\n hostHeaderValidationResponse,\n isLegacyRequest,\n localhostAllowedHostnames,\n localhostAllowedOrigins,\n originValidationResponse,\n type AuthInfo,\n type CreateMcpHandlerOptions as SdkCreateMcpHandlerOptions,\n type McpHandlerRequestOptions,\n type McpServerFactory,\n type ServerNotifier\n} from \"@modelcontextprotocol/server\";\nimport {\n getVerifiedOAuthAuthInfo,\n runWithAuthContext,\n type McpAuthContext\n} from \"./auth-context\";\nimport { internalErrorResponse, reportHandlerError } from \"./handler-errors\";\nimport { createLegacyCompatibilityRequestHandler } from \"./handler-legacy-compat\";\nimport type { CORSOptions } from \"../types\";\n\nexport interface CreateStatelessMcpHandlerOptions extends Omit<\n SdkCreateMcpHandlerOptions,\n \"bus\"\n> {\n /** Exact pathname handled by this Worker wrapper. @default \"/mcp\" */\n route?: string;\n /** CORS headers applied by the Worker wrapper. Pass `false` to disable. */\n corsOptions?: CORSOptions | false;\n /**\n * Restrict `Host` headers to these hostnames. Localhost and `workers.dev`\n * endpoints receive matching defaults; custom domains rely on Cloudflare\n * routing unless this option is set.\n */\n allowedHostnames?: string[];\n /**\n * Restrict present browser `Origin` headers to these hostnames. Requests\n * without an Origin (including non-browser MCP clients) remain valid. The\n * default includes localhost-class Origins, the endpoint's `workers.dev`\n * hostname, and a concrete `corsOptions.origin` hostname. Pass `\"*\"` only\n * when equivalent Origin validation runs in trusted middleware upstream.\n */\n allowedOriginHostnames?: string[] | \"*\";\n /** Application props exposed through {@link getMcpAuthContext}. */\n authContext?: McpAuthContext;\n}\n\nexport type StatelessMcpHandler = {\n (request: Request, env: unknown, ctx: ExecutionContext): Promise<Response>;\n fetch(\n request: Request,\n options?: McpHandlerRequestOptions\n ): Promise<Response>;\n notify: ServerNotifier;\n};\n\nexport type StatelessMcpServerInput = McpServerFactory;\n\nconst DEFAULT_CORS_OPTIONS: Required<CORSOptions> = {\n origin: \"*\",\n headers:\n \"Content-Type, Accept, Authorization, mcp-session-id, MCP-Protocol-Version, Mcp-Method, Mcp-Name\",\n methods: \"GET, POST, DELETE, OPTIONS\",\n exposeHeaders: \"mcp-session-id\",\n maxAge: 86400\n};\n\nfunction corsHeaders(options: CORSOptions = {}): Headers {\n const merged = { ...DEFAULT_CORS_OPTIONS, ...options };\n return new Headers({\n \"Access-Control-Allow-Headers\": merged.headers,\n \"Access-Control-Allow-Methods\": merged.methods,\n \"Access-Control-Allow-Origin\": merged.origin,\n \"Access-Control-Expose-Headers\": merged.exposeHeaders,\n \"Access-Control-Max-Age\": String(merged.maxAge)\n });\n}\n\nfunction withCors(response: Response, options: CORSOptions | false): Response {\n const headers = new Headers(response.headers);\n if (options === false) {\n for (const name of Array.from(headers.keys())) {\n if (name.toLowerCase().startsWith(\"access-control-\")) {\n headers.delete(name);\n }\n }\n } else {\n for (const [name, value] of corsHeaders(options)) {\n headers.set(name, value);\n }\n }\n return new Response(response.body, {\n status: response.status,\n statusText: response.statusText,\n headers\n });\n}\n\nfunction wrapResponseBodyWithAuthContext(\n response: Response,\n authContext: McpAuthContext | undefined\n): Response {\n if (!authContext || !response.body) return response;\n\n const reader = response.body.getReader();\n const body = new ReadableStream<Uint8Array>({\n pull(controller) {\n return runWithAuthContext(authContext, async () => {\n try {\n const { done, value } = await reader.read();\n if (done) {\n controller.close();\n } else {\n controller.enqueue(value);\n }\n } catch (error) {\n controller.error(error);\n }\n });\n },\n cancel(reason) {\n return runWithAuthContext(authContext, () => reader.cancel(reason));\n }\n });\n\n return new Response(body, {\n status: response.status,\n statusText: response.statusText,\n headers: response.headers\n });\n}\n\nexport function createStatelessMcpHandler(\n factory: StatelessMcpServerInput,\n options: CreateStatelessMcpHandlerOptions = {}\n): StatelessMcpHandler {\n const optionRecord = options as Record<string, unknown>;\n if (optionRecord.bus !== undefined) {\n throw new TypeError(\n 'createMcpHandler option \"bus\" is not exposed by the Agents SDK.'\n );\n }\n const legacyOnlyOption = [\n \"transport\",\n \"storage\",\n \"sessionIdGenerator\",\n \"onsessioninitialized\",\n \"onsessionclosed\",\n \"enableJsonResponse\",\n \"eventStore\",\n \"allowedHosts\",\n \"allowedOrigins\",\n \"enableDnsRebindingProtection\",\n \"retryInterval\"\n ].find((key) => optionRecord[key] !== undefined);\n if (legacyOnlyOption) {\n throw new TypeError(\n `createMcpHandler option \"${legacyOnlyOption}\" is only supported with an MCP SDK v1 server. The managed SDK v2 handler is stateless; remove this option or keep the v1 server during migration.`\n );\n }\n\n const {\n route = \"/mcp\",\n corsOptions = {},\n allowedHostnames,\n allowedOriginHostnames,\n authContext,\n legacy = \"stateless\",\n ...sdkOptions\n } = options;\n\n const sdkHandler = createSdkMcpHandler(factory, {\n ...sdkOptions,\n legacy: \"reject\"\n });\n const legacyCompatibilityHandler =\n legacy === \"stateless\"\n ? createLegacyCompatibilityRequestHandler(factory, {\n keepAliveMs: sdkOptions.keepAliveMs,\n onerror: sdkOptions.onerror\n })\n : undefined;\n\n const serve = async (\n request: Request,\n requestOptions?: McpHandlerRequestOptions,\n workerCtx?: ExecutionContext\n ): Promise<Response> => {\n const requestUrl = new URL(request.url);\n if (requestUrl.pathname !== route) {\n return withCors(new Response(\"Not Found\", { status: 404 }), corsOptions);\n }\n\n // The SDK app factories can distinguish their bind address from an\n // attacker-controlled Host header. A bare Worker cannot. Use defaults we\n // can establish independently: localhost-class names, a standard\n // workers.dev route, and any concrete CORS Origin the application chose.\n // Custom-domain deployments can provide explicit Host and Origin lists.\n const localEndpoint = localhostAllowedHostnames().includes(\n requestUrl.hostname\n );\n const workersDevEndpoint = requestUrl.hostname.endsWith(\".workers.dev\");\n const acceptedHostnames =\n allowedHostnames ??\n (localEndpoint\n ? localhostAllowedHostnames()\n : workersDevEndpoint\n ? [requestUrl.hostname]\n : undefined);\n const hostRejection = acceptedHostnames\n ? hostHeaderValidationResponse(request, acceptedHostnames)\n : undefined;\n if (hostRejection) {\n return withCors(hostRejection, corsOptions);\n }\n if (allowedOriginHostnames !== \"*\") {\n let acceptedOriginHostnames = allowedOriginHostnames;\n if (acceptedOriginHostnames === undefined) {\n const defaults = new Set(localhostAllowedOrigins());\n if (workersDevEndpoint) defaults.add(requestUrl.hostname);\n if (corsOptions !== false && corsOptions.origin !== undefined) {\n try {\n const configuredOrigin = new URL(corsOptions.origin);\n if (\n (configuredOrigin.protocol === \"http:\" ||\n configuredOrigin.protocol === \"https:\") &&\n configuredOrigin.hostname\n ) {\n defaults.add(configuredOrigin.hostname);\n }\n } catch {\n // A wildcard or malformed CORS value does not expand the allowlist.\n }\n }\n acceptedOriginHostnames = [...defaults];\n }\n const originRejection = originValidationResponse(\n request,\n acceptedOriginHostnames ?? []\n );\n if (originRejection) {\n return withCors(originRejection, corsOptions);\n }\n }\n\n if (request.method === \"OPTIONS\" && corsOptions !== false) {\n return new Response(null, { headers: corsHeaders(corsOptions) });\n }\n\n const legacyRequest =\n legacyCompatibilityHandler !== undefined &&\n (await isLegacyRequest(request, requestOptions?.parsedBody));\n\n try {\n const verified = workerCtx\n ? getVerifiedOAuthAuthInfo(workerCtx)\n : undefined;\n const explicitAuthInfo = requestOptions?.authInfo;\n if (\n verified &&\n explicitAuthInfo &&\n explicitAuthInfo.clientId !== verified.authInfo.clientId\n ) {\n throw new TypeError(\"Conflicting verified OAuth client identity\");\n }\n\n const authInfo: AuthInfo | undefined =\n explicitAuthInfo ?? verified?.authInfo;\n const resolvedAuthContext =\n authContext ??\n (verified\n ? { props: verified.props }\n : workerCtx?.props && Object.keys(workerCtx.props).length > 0\n ? { props: workerCtx.props as Record<string, unknown> }\n : undefined);\n const upstreamOptions: McpHandlerRequestOptions | undefined =\n requestOptions || authInfo\n ? { ...requestOptions, ...(authInfo && { authInfo }) }\n : undefined;\n const invoke = async () => {\n if (legacyRequest && legacyCompatibilityHandler) {\n return legacyCompatibilityHandler.fetch(request, upstreamOptions);\n }\n return sdkHandler.fetch(request, upstreamOptions);\n };\n const response = resolvedAuthContext\n ? await runWithAuthContext(resolvedAuthContext, invoke)\n : await invoke();\n return withCors(\n wrapResponseBodyWithAuthContext(response, resolvedAuthContext),\n corsOptions\n );\n } catch (error) {\n reportHandlerError(sdkOptions.onerror, error);\n return withCors(internalErrorResponse(), corsOptions);\n }\n };\n\n const callable = (request: Request, _env: unknown, ctx: ExecutionContext) =>\n serve(request, undefined, ctx);\n const fetch = (request: Request, requestOptions?: McpHandlerRequestOptions) =>\n serve(request, requestOptions);\n\n return Object.assign(callable, {\n fetch,\n notify: sdkHandler.notify\n }) as StatelessMcpHandler;\n}\n"],"mappings":"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"}
|
|
@@ -776,33 +776,8 @@ type AgentObservabilityEvent =
|
|
|
776
776
|
}
|
|
777
777
|
>;
|
|
778
778
|
//#endregion
|
|
779
|
-
//#region src/observability/
|
|
780
|
-
/**
|
|
781
|
-
* Union of all observability event types from different domains
|
|
782
|
-
*/
|
|
783
|
-
type ObservabilityEvent = AgentObservabilityEvent | MCPObservabilityEvent;
|
|
784
|
-
interface Observability {
|
|
785
|
-
/**
|
|
786
|
-
* Emit an event for the Agent's observability implementation to handle.
|
|
787
|
-
* @param event - The event to emit
|
|
788
|
-
*/
|
|
789
|
-
emit(event: ObservabilityEvent): void;
|
|
790
|
-
}
|
|
791
|
-
/**
|
|
792
|
-
* Diagnostics channels for agent observability.
|
|
793
|
-
*
|
|
794
|
-
* Events are published to named channels using the Node.js diagnostics_channel API.
|
|
795
|
-
* By default, publishing to a channel with no subscribers is a no-op (zero overhead).
|
|
796
|
-
*
|
|
797
|
-
* To observe events, subscribe to the channels you care about:
|
|
798
|
-
* ```ts
|
|
799
|
-
* import { subscribe } from "node:diagnostics_channel";
|
|
800
|
-
* subscribe("agents:rpc", (event) => console.log(event));
|
|
801
|
-
* ```
|
|
802
|
-
*
|
|
803
|
-
* In production, all published messages are automatically forwarded to
|
|
804
|
-
* Tail Workers via `event.diagnosticsChannelEvents` — no subscription needed.
|
|
805
|
-
*/
|
|
779
|
+
//#region src/observability/diagnostics.d.ts
|
|
780
|
+
/** Diagnostics channels for Agent and Lifecycle telemetry. */
|
|
806
781
|
declare const channels: {
|
|
807
782
|
readonly state: Channel<any, any>;
|
|
808
783
|
readonly rpc: Channel<any, any>;
|
|
@@ -818,6 +793,19 @@ declare const channels: {
|
|
|
818
793
|
readonly email: Channel<any, any>;
|
|
819
794
|
readonly channel: Channel<any, any>;
|
|
820
795
|
};
|
|
796
|
+
//#endregion
|
|
797
|
+
//#region src/observability/index.d.ts
|
|
798
|
+
/**
|
|
799
|
+
* Union of all observability event types from different domains
|
|
800
|
+
*/
|
|
801
|
+
type ObservabilityEvent = AgentObservabilityEvent | MCPObservabilityEvent;
|
|
802
|
+
interface Observability {
|
|
803
|
+
/**
|
|
804
|
+
* Emit an event for the Agent's observability implementation to handle.
|
|
805
|
+
* @param event - The event to emit
|
|
806
|
+
*/
|
|
807
|
+
emit(event: ObservabilityEvent): void;
|
|
808
|
+
}
|
|
821
809
|
/**
|
|
822
810
|
* The default observability implementation.
|
|
823
811
|
*
|
|
@@ -936,12 +924,12 @@ declare function subscribe$1<K extends keyof ChannelEventMap>(
|
|
|
936
924
|
): () => void;
|
|
937
925
|
//#endregion
|
|
938
926
|
export {
|
|
939
|
-
|
|
940
|
-
|
|
927
|
+
subscribe$1 as a,
|
|
928
|
+
genericObservability as i,
|
|
941
929
|
Observability as n,
|
|
942
|
-
|
|
930
|
+
channels as o,
|
|
943
931
|
ObservabilityEvent as r,
|
|
944
932
|
MCPObservabilityEvent as s,
|
|
945
933
|
ChannelEventMap as t
|
|
946
934
|
};
|
|
947
|
-
//# sourceMappingURL=index-
|
|
935
|
+
//# sourceMappingURL=index-DcSAZKsB.d.ts.map
|
package/dist/index.d.ts
CHANGED
|
@@ -1,87 +1,93 @@
|
|
|
1
1
|
/// <reference path="../skills-module.d.ts" />
|
|
2
|
-
import { r as __DO_NOT_USE_WILL_BREAK__agentContext } from "./internal_context-Dg4Cgjcu.js";
|
|
3
2
|
import {
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
3
|
+
c as WSMessage,
|
|
4
|
+
i as __DO_NOT_USE_WILL_BREAK__agentContext,
|
|
5
|
+
l as Connection,
|
|
6
|
+
u as ConnectionContext
|
|
7
|
+
} from "./current-agent-CuMErtly.js";
|
|
8
|
+
import {
|
|
9
|
+
$ as AgentToolRunPart,
|
|
10
|
+
A as StateUpdateMessage,
|
|
11
|
+
B as AgentToolChildAdapter,
|
|
12
|
+
C as MCPServerMessage,
|
|
13
|
+
Cn as AgentPathStep,
|
|
14
|
+
D as RPCResponse,
|
|
15
|
+
Dn as buildAgentPath,
|
|
16
|
+
E as RPCRequest,
|
|
17
|
+
En as SubAgentPathMatch,
|
|
18
|
+
F as getCurrentAgent,
|
|
19
|
+
Ft as MCPAITool,
|
|
20
|
+
G as AgentToolFailure,
|
|
21
|
+
H as AgentToolEvent,
|
|
22
|
+
I as routeAgentEmail,
|
|
23
|
+
It as MCPAIToolSet,
|
|
24
|
+
J as AgentToolMilestone,
|
|
25
|
+
Jt as MCP_SERVER_ID_MAX_LENGTH,
|
|
26
|
+
K as AgentToolInterruptedReason,
|
|
27
|
+
L as unstable_callable,
|
|
28
|
+
M as SubAgentClass,
|
|
29
|
+
Mn as parseSubAgentPath,
|
|
30
|
+
N as SubAgentStub,
|
|
31
|
+
Nn as routeSubAgentRequest,
|
|
32
|
+
O as StartFiberOptions,
|
|
33
|
+
On as buildAgentUrl,
|
|
34
|
+
P as callable,
|
|
35
|
+
Pn as withInvocationScope,
|
|
36
|
+
Q as AgentToolRunInspection,
|
|
37
|
+
R as AGENT_TOOL_MILESTONE_PART,
|
|
38
|
+
S as MCPServer,
|
|
39
|
+
T as QueueItem,
|
|
40
|
+
Tn as SUB_PREFIX,
|
|
41
|
+
U as AgentToolEventMessage,
|
|
42
|
+
V as AgentToolDisplayMetadata,
|
|
43
|
+
W as AgentToolEventState,
|
|
44
|
+
X as AgentToolProgressSnapshot,
|
|
45
|
+
Y as AgentToolProgress,
|
|
46
|
+
Z as AgentToolRunInfo,
|
|
47
|
+
Zt as normalizeServerId,
|
|
48
|
+
_ as FiberInspection,
|
|
49
|
+
a as routeAgentRequest,
|
|
50
|
+
at as DetachedAgentToolConfig,
|
|
51
|
+
b as FiberStatus,
|
|
52
|
+
c as Agent,
|
|
53
|
+
ct as RunAgentToolResult,
|
|
54
|
+
d as AgentStaticOptions,
|
|
55
|
+
et as AgentToolRunState,
|
|
56
|
+
f as CallableMetadata,
|
|
57
|
+
g as FiberContext,
|
|
58
|
+
h as EmailRoutingOptions,
|
|
59
|
+
i as getAgentByName,
|
|
60
|
+
it as ChatCapableAgentClass,
|
|
61
|
+
j as StreamingResponse,
|
|
62
|
+
jn as getSubAgentByName,
|
|
63
|
+
k as StartFiberResult,
|
|
64
|
+
l as AgentContext,
|
|
65
|
+
m as DeleteFibersOptions,
|
|
66
|
+
n as AgentOptions,
|
|
67
|
+
nt as AgentToolStoredChunk,
|
|
68
|
+
o as AddMcpServerOptions,
|
|
69
|
+
ot as DetachedRunAgentToolResult,
|
|
70
|
+
p as DEFAULT_AGENT_STATIC_OPTIONS,
|
|
71
|
+
q as AgentToolLifecycleResult,
|
|
72
|
+
r as RoutingRetryOptions,
|
|
73
|
+
rt as AgentToolTerminalStatus,
|
|
74
|
+
s as AddRpcMcpServerOptions,
|
|
75
|
+
st as RunAgentToolOptions,
|
|
76
|
+
t as AgentGetOptions,
|
|
77
|
+
tt as AgentToolRunStatus,
|
|
78
|
+
u as AgentNamespace,
|
|
79
|
+
v as FiberRecoveryContext,
|
|
80
|
+
w as MCPServersState,
|
|
81
|
+
wn as BuildAgentPathOptions,
|
|
82
|
+
x as ListFibersOptions,
|
|
83
|
+
y as FiberRecoveryResult,
|
|
84
|
+
z as AGENT_TOOL_PROGRESS_PART
|
|
85
|
+
} from "./agent-routing-CnkaHb-v.js";
|
|
86
|
+
import {
|
|
87
|
+
a as EmailSendBinding,
|
|
88
|
+
d as createHeaderBasedEmailResolver,
|
|
89
|
+
s as SendEmailOptions
|
|
90
|
+
} from "./email-7TatiTnl.js";
|
|
85
91
|
import { n as camelCaseToKebabCase } from "./utils-CGtGDSgA.js";
|
|
86
92
|
import {
|
|
87
93
|
i as isDurableObjectStorageReset,
|
|
@@ -94,10 +100,11 @@ import {
|
|
|
94
100
|
n as AgentsOAuthProvider,
|
|
95
101
|
r as DurableObjectOAuthClientProvider,
|
|
96
102
|
t as AgentMcpOAuthProvider
|
|
97
|
-
} from "./do-oauth-client-provider-
|
|
98
|
-
import { f as TransportType } from "./handler-stateless-
|
|
103
|
+
} from "./do-oauth-client-provider-Tmf1vgKz.js";
|
|
104
|
+
import { f as TransportType } from "./handler-stateless-DxYpJ_XF.js";
|
|
99
105
|
import { t as MessageType } from "./types-6Zo2zfoO.js";
|
|
100
|
-
import {
|
|
106
|
+
import { a as ScheduleCriteria, i as Schedule } from "./scheduler-DQoTGoAW.js";
|
|
107
|
+
import { t as SqlError } from "./sql-error-CPY-GXyI.js";
|
|
101
108
|
export {
|
|
102
109
|
AGENT_TOOL_MILESTONE_PART,
|
|
103
110
|
AGENT_TOOL_PROGRESS_PART,
|
|
@@ -105,10 +112,11 @@ export {
|
|
|
105
112
|
AddRpcMcpServerOptions,
|
|
106
113
|
Agent,
|
|
107
114
|
AgentContext,
|
|
108
|
-
AgentGetOptions,
|
|
115
|
+
type AgentGetOptions,
|
|
109
116
|
type AgentMcpOAuthProvider,
|
|
110
117
|
AgentNamespace,
|
|
111
|
-
AgentOptions,
|
|
118
|
+
type AgentOptions,
|
|
119
|
+
type AgentPathStep,
|
|
112
120
|
AgentStaticOptions,
|
|
113
121
|
type AgentToolChildAdapter,
|
|
114
122
|
type AgentToolDisplayMetadata,
|
|
@@ -129,6 +137,7 @@ export {
|
|
|
129
137
|
type AgentToolStoredChunk,
|
|
130
138
|
type AgentToolTerminalStatus,
|
|
131
139
|
type AgentsOAuthProvider,
|
|
140
|
+
type BuildAgentPathOptions,
|
|
132
141
|
CallableMetadata,
|
|
133
142
|
type ChatCapableAgentClass,
|
|
134
143
|
type Connection,
|
|
@@ -139,7 +148,7 @@ export {
|
|
|
139
148
|
type DetachedRunAgentToolResult,
|
|
140
149
|
DurableObjectOAuthClientProvider,
|
|
141
150
|
EmailRoutingOptions,
|
|
142
|
-
EmailSendBinding,
|
|
151
|
+
type EmailSendBinding,
|
|
143
152
|
FiberContext,
|
|
144
153
|
FiberInspection,
|
|
145
154
|
FiberRecoveryContext,
|
|
@@ -161,9 +170,9 @@ export {
|
|
|
161
170
|
type RunAgentToolOptions,
|
|
162
171
|
type RunAgentToolResult,
|
|
163
172
|
SUB_PREFIX,
|
|
164
|
-
Schedule,
|
|
165
|
-
ScheduleCriteria,
|
|
166
|
-
SendEmailOptions,
|
|
173
|
+
type Schedule,
|
|
174
|
+
type ScheduleCriteria,
|
|
175
|
+
type SendEmailOptions,
|
|
167
176
|
SqlError,
|
|
168
177
|
StartFiberOptions,
|
|
169
178
|
StartFiberResult,
|
|
@@ -176,6 +185,8 @@ export {
|
|
|
176
185
|
type WSMessage,
|
|
177
186
|
__DO_NOT_USE_WILL_BREAK__agentContext,
|
|
178
187
|
withInvocationScope as __DO_NOT_USE_WILL_BREAK__withInvocationScope,
|
|
188
|
+
buildAgentPath,
|
|
189
|
+
buildAgentUrl,
|
|
179
190
|
callable,
|
|
180
191
|
camelCaseToKebabCase,
|
|
181
192
|
createHeaderBasedEmailResolver,
|