@runtypelabs/sdk 10.11.2 → 10.12.1

package/README.md

@@ -55,6 +55,37 @@ console.log(analysis)
 - **Error Handling**: Proper error handling with custom error types
 - **Zero Dependencies**: No external runtime dependencies
 
+## Expose an existing agent over A2A
+
+Use `createA2AHandler` to expose a text-returning function through an A2A endpoint.
+The handler uses Web `Request` and `Response` APIs and requires no framework dependency.
+
+```typescript
+import { createA2AHandler } from '@runtypelabs/sdk'
+
+export const handler = createA2AHandler({
+	name: 'Support agent',
+	url: 'http://localhost:4111/a2a',
+	run: async ({ text }) => `You sent: ${text}`,
+})
+```
+
+Mount the handler at `POST /a2a` and `GET /.well-known/agent-card.json` in your HTTP server.
+For a public deployment, set `url` to the public endpoint and authenticate invocation POSTs before calling the handler.
+Keep the basic agent card GET public; Runtype fetches that card without the invocation bearer token.
+Authorize access to each conversation in your application before using its `contextId`.
+
+Replace `run` with your framework's invocation and return its final text.
+The callback receives `text`, the original text `message`, request `metadata`, a `contextId`, and an abort `signal`.
+Store conversation history in your framework using `contextId`; the handler retains no history.
+Pass `signal` to framework APIs that support cancellation.
+
+The handler implements A2A 0.3 JSON-RPC `message/send` and returns a completed task with a text artifact.
+It accepts text parts only and does not support streaming, retained tasks, or push notifications.
+Requests are limited to 1 MiB by default; set `maxRequestBytes` to change that limit.
+POSTs require `Content-Type: application/json`. If an `Origin` header is present, it must match the configured endpoint's origin.
+Use the [official A2A JavaScript SDK](https://github.com/a2aproject/a2a-js) for the full protocol.
+
 ## FlowBuilder API
 
 The FlowBuilder provides a fluent interface for constructing and executing flows.

package/dist/index.cjs

@@ -14068,6 +14068,174 @@ var Runtype = class {
 	}
 };
 //#endregion
+//#region src/a2a-handler.ts
+function record(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function rpcError(id, code, message, status = 200) {
+	return Response.json({
+		jsonrpc: "2.0",
+		id,
+		error: {
+			code,
+			message
+		}
+	}, { status });
+}
+function isRpcId(value) {
+	return value === null || typeof value === "string" || typeof value === "number" && Number.isFinite(value);
+}
+var RequestTooLargeError = class extends Error {};
+async function readRequest(request, limit) {
+	const reader = request.body?.getReader();
+	if (!reader) return JSON.parse("");
+	const decoder = new TextDecoder();
+	let size = 0;
+	let text = "";
+	const cancel = () => {
+		reader.cancel().catch(() => void 0);
+	};
+	request.signal.addEventListener("abort", cancel, { once: true });
+	try {
+		request.signal.throwIfAborted();
+		while (true) {
+			const { done, value } = await reader.read();
+			request.signal.throwIfAborted();
+			if (done) break;
+			size += value.byteLength;
+			if (size > limit) {
+				cancel();
+				throw new RequestTooLargeError();
+			}
+			text += decoder.decode(value, { stream: true });
+		}
+		return JSON.parse(text + decoder.decode());
+	} finally {
+		request.signal.removeEventListener("abort", cancel);
+		reader.releaseLock();
+	}
+}
+function parseMessage(value) {
+	const message = record(value);
+	if (!message || message.role !== "user" && message.role !== "agent") return void 0;
+	if (typeof message.messageId !== "string" || !message.messageId) return void 0;
+	if (message.contextId !== void 0 && (typeof message.contextId !== "string" || !message.contextId)) return;
+	if (message.metadata !== void 0 && !record(message.metadata)) return void 0;
+	if (!Array.isArray(message.parts) || message.parts.length === 0) return void 0;
+	for (const raw of message.parts) {
+		const part = record(raw);
+		if (!part || part.kind !== "text" || typeof part.text !== "string") return void 0;
+		if (part.metadata !== void 0 && !record(part.metadata)) return void 0;
+	}
+	return message;
+}
+function validateSend(params, id) {
+	if (record(params.message)?.taskId !== void 0) return rpcError(id, -32001, "Task not found");
+	if (params.metadata !== void 0 && !record(params.metadata)) return rpcError(id, -32602, "Invalid metadata");
+	const configuration = record(params.configuration);
+	if (params.configuration !== void 0 && !configuration) return rpcError(id, -32602, "Invalid configuration");
+	if (configuration?.pushNotificationConfig !== void 0) return rpcError(id, -32003, "Push notifications are not supported");
+	const modes = configuration?.acceptedOutputModes;
+	if (modes !== void 0 && (!Array.isArray(modes) || !modes.every((mode) => typeof mode === "string"))) return rpcError(id, -32602, "Invalid accepted output modes");
+	if (Array.isArray(modes) && modes.length > 0 && !modes.includes("text/plain")) return rpcError(id, -32005, "Only text/plain output is supported");
+}
+/**
+* Serve POST at options.url and GET /.well-known/agent-card.json with Web APIs.
+* Supports A2A 0.3 message/send with text parts; no streaming or retained tasks.
+* The callback owns history, authorization of context IDs, and model cancellation.
+*/
+function createA2AHandler(options) {
+	const endpoint = new URL(options.url);
+	if (!["http:", "https:"].includes(endpoint.protocol) || endpoint.username || endpoint.password || endpoint.search || endpoint.hash) throw new Error("A2A url must be an HTTP(S) endpoint without credentials, query, or fragment");
+	if (!options.name.trim()) throw new Error("A2A name must not be empty");
+	const limit = options.maxRequestBytes ?? 1048576;
+	if (!Number.isSafeInteger(limit) || limit <= 0) throw new Error("maxRequestBytes must be a positive integer");
+	const card = {
+		protocolVersion: "0.3.0",
+		name: options.name,
+		description: options.description ?? options.name,
+		url: endpoint.href,
+		preferredTransport: "JSONRPC",
+		version: "1.0.0",
+		capabilities: {
+			streaming: false,
+			pushNotifications: false
+		},
+		defaultInputModes: ["text/plain"],
+		defaultOutputModes: ["text/plain"],
+		skills: [{
+			id: "chat",
+			name: options.name,
+			description: options.description ?? options.name,
+			tags: ["chat"]
+		}]
+	};
+	return async (request) => {
+		const path = new URL(request.url).pathname;
+		if (request.method === "GET" && path === "/.well-known/agent-card.json") return Response.json(card);
+		if (path !== endpoint.pathname) return new Response("Not found", { status: 404 });
+		if (request.method !== "POST") return new Response("Method not allowed", {
+			status: 405,
+			headers: { Allow: "POST" }
+		});
+		if (request.headers.get("content-type")?.split(";")[0]?.trim().toLowerCase() !== "application/json") return rpcError(null, -32600, "Content-Type must be application/json", 415);
+		const origin = request.headers.get("origin");
+		if (origin !== null && origin !== endpoint.origin) return rpcError(null, -32600, "Origin is not allowed", 403);
+		const version = request.headers.get("a2a-version");
+		if (version && version !== "0.3" && version !== "0.3.0") return rpcError(null, -32009, "Only A2A 0.3 is supported", 400);
+		if (request.signal.aborted) return rpcError(null, -32603, "Request cancelled");
+		let body;
+		try {
+			body = await readRequest(request, limit);
+		} catch (error) {
+			if (request.signal.aborted) return rpcError(null, -32603, "Request cancelled");
+			return error instanceof RequestTooLargeError ? rpcError(null, -32600, "Request body too large", 413) : rpcError(null, -32700, "Invalid JSON");
+		}
+		const rpc = record(body);
+		if (!rpc || rpc.jsonrpc !== "2.0" || !isRpcId(rpc.id) || typeof rpc.method !== "string") return rpcError(null, -32600, "Invalid JSON-RPC request");
+		const id = rpc.id;
+		if (rpc.method !== "message/send") return rpcError(id, -32601, "Method not supported");
+		const params = record(rpc.params);
+		if (!params) return rpcError(id, -32602, "Invalid message parameters");
+		const invalid = validateSend(params, id);
+		if (invalid) return invalid;
+		const message = parseMessage(params.message);
+		if (!message) return rpcError(id, -32602, "Expected a message with a messageId, role, and text parts");
+		const contextId = message.contextId ?? crypto.randomUUID();
+		try {
+			request.signal.throwIfAborted();
+			const output = await options.run({
+				text: message.parts.map((part) => part.text).join(""),
+				contextId,
+				message,
+				metadata: record(params.metadata) ?? {},
+				signal: request.signal
+			});
+			request.signal.throwIfAborted();
+			if (typeof output !== "string") return rpcError(id, -32603, "Agent must return text");
+			return Response.json({
+				jsonrpc: "2.0",
+				id,
+				result: {
+					kind: "task",
+					id: crypto.randomUUID(),
+					contextId,
+					status: { state: "completed" },
+					artifacts: [{
+						artifactId: crypto.randomUUID(),
+						parts: [{
+							kind: "text",
+							text: output
+						}]
+					}]
+				}
+			});
+		} catch {
+			return rpcError(id, -32603, request.signal.aborted ? "Request cancelled" : "Agent execution failed");
+		}
+	};
+}
+//#endregion
 //#region src/agent-promotion.ts
 const MANIFEST_VERSION = 1;
 /** Receipts read per page, and the page ceiling, while hunting the staged receipt. */
@@ -14277,7 +14445,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.11.2";
+const SDK_VERSION = "10.12.1";
 /**
 * Canonical client identity the API uses for attribution
 * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
@@ -16595,6 +16763,7 @@ exports.computeSurfaceContentHash = computeSurfaceContentHash;
 exports.computeToolContentHash = computeToolContentHash;
 exports.contains = contains;
 exports.cost = cost;
+exports.createA2AHandler = createA2AHandler;
 exports.createAgentEventTranslator = createAgentEventTranslator;
 exports.createClient = createClient;
 exports.createExternalTool = createExternalTool;

package/dist/index.d.cts

@@ -1283,10 +1283,11 @@ interface paths {
                 }[];
                 version?: string;
               };
+              deviceId?: string;
               /** Format: uri */
               endpoint: string;
               /** @enum {string} */
-              framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "custom";
+              framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "mastra" | "custom";
               /** @enum {string} */
               protocol?: "a2a" | "runtype-stream";
               retryCount?: number;
@@ -1323,6 +1324,8 @@ interface paths {
                 role?: "orchestrator" | "tool" | "standalone" | "hidden";
               }[];
               timeoutMs?: number;
+              /** @enum {string} */
+              transport?: "http" | "device";
             };
             icon?: string;
             maxTurns?: number;
@@ -1881,7 +1884,7 @@ interface paths {
     put?: never;
     /**
      * Fetch external agent card
-     * @description Proxy-fetch an external agent card from a URL, avoiding CORS issues. The URL is validated against SSRF attacks.
+     * @description Proxy-fetch an external agent card from a URL, avoiding CORS issues. The URL is validated against SSRF attacks. With `transport: "device"`, the card is fetched through the paired local listener `deviceId`, so the URL must be a loopback address on that machine. Pass `bearerToken` when the card itself requires one.
      */
     post: {
       parameters: {
@@ -1893,6 +1896,15 @@ interface paths {
       requestBody?: {
         content: {
           "application/json": {
+            /** @description Sent as `Authorization: Bearer` on the card request. Never stored or echoed. */
+            bearerToken?: string;
+            /** @description The paired listener to fetch through. Required when transport is "device". */
+            deviceId?: string;
+            /**
+             * @description How to reach the card: directly (default) or through a paired local listener
+             * @enum {string}
+             */
+            transport?: "http" | "device";
             /** Format: uri */
             url: string;
           };
@@ -2606,10 +2618,11 @@ interface paths {
                 }[];
                 version?: string;
               } | null;
+              deviceId?: string | null;
               /** Format: uri */
               endpoint?: string;
               /** @enum {string|null} */
-              framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "custom" | null;
+              framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "mastra" | "custom" | null;
               /** @enum {string|null} */
               protocol?: "a2a" | "runtype-stream" | null;
               retryCount?: number | null;
@@ -2646,6 +2659,8 @@ interface paths {
                 role?: "orchestrator" | "tool" | "standalone" | "hidden";
               }[] | null;
               timeoutMs?: number | null;
+              /** @enum {string|null} */
+              transport?: "http" | "device" | null;
             } | null;
             icon?: string;
             maxTurns?: number;
@@ -4475,6 +4490,15 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
+        /** @description An external agent call failed upstream: rejected credentials, rate limited, an HTTP error, a network failure, or an invalid response */
+        502: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
         /** @description Asynchronous execution unavailable */
         503: {
           headers: {
@@ -4484,6 +4508,15 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
+        /** @description An external agent call timed out */
+        504: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
       };
     };
     delete?: never;
@@ -12984,7 +13017,7 @@ interface paths {
                 mcpUrl: string;
                 name: string;
                 /** @enum {string} */
-                platform: "macos";
+                platform: "macos" | "cli";
                 publicKeyFingerprint: string;
                 revokedAt: string | null;
                 status: {
@@ -13028,6 +13061,87 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/v1/devices/loopback": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /** Register this computer as a local loopback device (development only) */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          "application/json": Record<string, never>;
+        };
+      };
+      responses: {
+        /** @description Loopback device ready */
+        201: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": {
+              data: {
+                appVersion: string | null;
+                createdAt: string;
+                id: string;
+                lastAuthenticatedAt: string | null;
+                /** Format: uri */
+                mcpUrl: string;
+                name: string;
+                /** @enum {string} */
+                platform: "macos" | "cli";
+                publicKeyFingerprint: string;
+                revokedAt: string | null;
+                status: {
+                  appVersion?: string;
+                  availableTools: string[];
+                  deviceId: string;
+                  lastSeenAt?: string;
+                  online: boolean;
+                  protocolVersion?: number;
+                };
+                updatedAt: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/v1/devices/pair": {
     parameters: {
       query?: never;
@@ -13052,7 +13166,7 @@ interface paths {
             code: string;
             name: string;
             /** @enum {string} */
-            platform: "macos";
+            platform: "macos" | "cli";
             publicKey: string;
           };
         };
@@ -13072,7 +13186,7 @@ interface paths {
                 lastAuthenticatedAt: string | null;
                 name: string;
                 /** @enum {string} */
-                platform: "macos";
+                platform: "macos" | "cli";
                 publicKeyFingerprint: string;
                 revokedAt: string | null;
                 updatedAt: string;
@@ -13215,7 +13329,7 @@ interface paths {
                 mcpUrl: string;
                 name: string;
                 /** @enum {string} */
-                platform: "macos";
+                platform: "macos" | "cli";
                 publicKeyFingerprint: string;
                 revokedAt: string | null;
                 status: {
@@ -13401,7 +13515,7 @@ interface paths {
                 lastAuthenticatedAt: string | null;
                 name: string;
                 /** @enum {string} */
-                platform: "macos";
+                platform: "macos" | "cli";
                 publicKeyFingerprint: string;
                 revokedAt: string | null;
                 updatedAt: string;
@@ -63615,6 +63729,42 @@ export declare class Runtype {
   static get clientTokens(): ClientTokensNamespace;
 }
 //#endregion
+//#region src/a2a-handler.d.ts
+/** The text-only A2A 0.3 message delivered to a framework callback. */
+interface A2ATextMessage {
+  role: 'user' | 'agent';
+  messageId: string;
+  parts: Array<{
+    kind: 'text';
+    text: string;
+    metadata?: Record<string, unknown>;
+  }>;
+  contextId?: string;
+  metadata?: Record<string, unknown>;
+}
+/** A single incoming turn; persist conversation history in the framework using contextId. */
+interface A2ARunInput {
+  text: string;
+  contextId: string;
+  message: A2ATextMessage;
+  metadata: Record<string, unknown>;
+  signal: AbortSignal;
+}
+/** Configure a synchronous text adapter. Authenticate invocation POSTs before calling the handler. */
+interface A2AHandlerOptions {
+  name: string;
+  description?: string;
+  url: string;
+  maxRequestBytes?: number;
+  run: (input: A2ARunInput) => string | Promise<string>;
+}
+/**
+ * Serve POST at options.url and GET /.well-known/agent-card.json with Web APIs.
+ * Supports A2A 0.3 message/send with text parts; no streaming or retained tasks.
+ * The callback owns history, authorization of context IDs, and model cancellation.
+ */
+export declare function createA2AHandler(options: A2AHandlerOptions): (request: Request) => Promise<Response>;
+//#endregion
 //#region src/agent-promotion.d.ts
 /**
  * The HTTP surface a promotion leg needs from one organization's credentials.
@@ -68978,5 +69128,5 @@ export declare function getLikelySupportingCandidatePaths(bestCandidatePath: str
 export declare function getDefaultPlanPath(taskName: string): string;
 export declare function sanitizeTaskSlug(taskName: string): string;
 //#endregion
-export type { AIGrader, ActivateAgentAliasInput, ActivateAgentPromotionInput, AgentAlias, AgentAliasActivation, AgentAliasArchiveFailure, AgentAliasArchived, AgentAliasList, AgentAliasTransport, AgentCapabilityChange, AgentCapabilityDeclaration, AgentDefinition, AgentDefinitionConfig, AgentDeploymentList, AgentDeploymentPromotion, AgentDeploymentReceipt, AgentPromotionManifest, AgentPromotionTransport, AgentPromotionValidation, AgentPullResult, AgentSkillBinding, AgentSkillBindingChange, AgentStreamEvent, ApiKeyRequest, ApiKeyRequestDelivery, ApiKeyRequestEnvironment, ApiKeyRequestHandoff, ApiKeyRequestListParams, ApiKeyRequestRequester, ApiKeyRequestStatus, ApplyGeneratedProposalOptions, ApplyGeneratedProposalResult, ArchiveAgentAliasEverywhereResult, ArchiveAgentAliasInput, AttachRuntimeToolsOptions, BatchClient, BatchListParams, BatchOptions, BatchRequest, BatchResult, BatchScheduleConfig, BatchStatus, BindSkillInput, BuiltInGraderId, CaseExpected, CheckGrader, ClaimApiKeyRequestInput, ClaimApiKeyRequestResponse, ClientConversation, ClientToken, ClientTokenConfig, ClientTokenDefinition, ClientTokenEnvironment, ClientTokenVersionPin, ClientWidgetTheme, CollectionPullResult, CollectionSchemaChange, ConditionalGetResult, ConditionalStepConfig, ContextErrorHandling, ContextFallback, CreateApiKeyRequestInput, CreateApiKeyRequestResponse, CreateClientTokenRequest, CreateClientTokenResponse, CreateEvalSuiteInput, CreatePromptData, DecomposeCriteriaResult, DefineAgentInput, DefineEvalCaseInput, DefineEvalInput, DefineFlowInput, DefineProductInput, DefineScheduleInput, DefineSkillInput, DefineSurfaceInput, DefineToolInput, DetachedReattach, DetachedReconnectOptions, DispatchClient, DispatchEvent, DispatchOptions, EnsureAgentConverged, EnsureAgentOptions, EnsureAgentPlan, EnsureAgentResult, EnsureClientTokenConverged, EnsureClientTokenOptions, EnsureClientTokenPlan, EnsureClientTokenResult, EnsureCollectionConverged, EnsureCollectionOptions, EnsureCollectionPlan, EnsureCollectionResult, EnsureEvalApplyOptions, EnsureEvalOptions, EnsureEvalPlan, EnsureEvalResult, EnsureFlowConverged, EnsureFlowOptions, EnsureFlowPlan, EnsureFlowResult, EnsureFpoOptions, EnsureFpoResult, EnsureProductConverged, EnsureProductOptions, EnsureProductPlan, EnsureProductResult, EnsureQuestionSetConverged, EnsureQuestionSetOptions, EnsureQuestionSetPlan, EnsureQuestionSetResult, EnsureScheduleConverged, EnsureScheduleOptions, EnsureSchedulePlan, EnsureScheduleResult, EnsureSkillConverged, EnsureSkillOptions, EnsureSkillPlan, EnsureSkillResult, EnsureSurfaceConverged, EnsureSurfaceOptions, EnsureSurfacePlan, EnsureSurfaceResult, EnsureToolConverged, EnsureToolOptions, EnsureToolPlan, EnsureToolResult, ErrorHandlingMode, EvalAgentSelector, EvalAgentTargetResolution, EvalCaseDefinition, EvalCaseInput, EvalCaseProposal, EvalCaseProposalAccepted, EvalCaseProposalListResult, EvalCasesGenerated, EvalClient, EvalDefinition, EvalListParams, EvalMessage, EvalOptions, EvalProposalSource, EvalProposalStatus, EvalProposedCase, EvalPullResult, EvalRecord, EvalRequest, EvalResult, EvalRunCaseScores, EvalRunConfig, EvalRunEvidence, EvalRunScores, EvalStatus, EvalSuiteCase, EvalSuiteCaseInput, EvalSuiteCoverage, EvalSuiteDetail, EvalSuiteLatestRun, EvalSuiteListResult, EvalSuiteRunQueued, EvalSuiteRunResult, EvalSuiteSummary, EvalTarget, ExecutionStreamEvent, FallbackFailEvent, FallbackStartEvent, FallbackSuccessEvent, FallbackTrigger, FallbackTriggerType, FallbacksExhaustedEvent, FallbacksInitiatedEvent, FetchUrlStepConfig, FieldFormat, FlowCompleteEvent, FlowConfig, FlowDefinition, FlowDefinitionStep, FlowErrorEvent, FlowFallback, FlowInlineEvalInput, FlowPausedEvent, FlowPullResult, FlowStartEvent, FlowStreamEvent, FlowSummary, FlowValidationClient, FlowValidationIssue, FlowValidationResult, FpoEntityOutcome, FpoInput, GenerateEmbeddingStepConfig, GenerateEvalCasesInput, GeneratedRuntimeToolGateDecision, GeneratedRuntimeToolGateOptions, GetApiKeyRequestResponse, GetRecordStepConfig, Gradeable, GraderConfig, GraderOutcome, GraderSeverity, HumanVerdict, ListAgentAliasesOptions, ListAgentDeploymentsOptions, ListConversationsResponse, ListRecordsStepConfig, LoopStepConfig, Message, MessageFallback, ModelFallback, ModelOverride, OrganizationAgentAlias, OrganizationAgentAliasList, PersistedGraderOutcome, PrepareAgentPromotionInput, ProductDefinition, ProductPullResult, PromoteAgentInput, PromoteAgentResult, PromptErrorHandling, PromptFallback, PromptListParams, PromptStepConfig, PullFpoResult, QuestionSetDefinition, QuestionSetPullResult, RecordCollectionDefinition, RecordCollectionValidationMode, RecordConfig, RecordFilter, RecordFilterCondition, RecordFilterGroup, RecordFilterOperator, RetrieveRecordStepConfig, RetryFallback, RollbackAgentAliasInput, RunEvalCaseResult, RunEvalInput, RunEvalResult, RunListParams, RunListResponse, RunListRow, AgentSkillBinding$1 as RuntypeAgentSkillBinding, ConditionalStepConfig$1 as RuntypeConditionalStepConfig, RuntypeConfig, FetchUrlStepConfig$1 as RuntypeFetchUrlStepConfig, FlowConfig$1 as RuntypeFlowConfig, GenerateEmbeddingStepConfig$1 as RuntypeGenerateEmbeddingStepConfig, GetRecordStepConfig$1 as RuntypeGetRecordStepConfig, ListRecordsStepConfig$1 as RuntypeListRecordsStepConfig, LoopStepConfig$1 as RuntypeLoopStepConfig, Message$1 as RuntypeMessage, ModelOverride$1 as RuntypeModelOverride, Prompt$1 as RuntypePrompt, PromptStepConfig$1 as RuntypePromptStepConfig, RecordConfig$1 as RuntypeRecordConfig, RetrieveRecordStepConfig$1 as RuntypeRetrieveRecordStepConfig, SearchStepConfig as RuntypeSearchStepConfig, SendEmailStepConfig as RuntypeSendEmailStepConfig, SendEventStepConfig as RuntypeSendEventStepConfig, SendStreamStepConfig as RuntypeSendStreamStepConfig, SetVariableStepConfig as RuntypeSetVariableStepConfig, Skill as RuntypeSkill, SkillBindingWithAgent as RuntypeSkillBindingWithAgent, SkillCapabilities as RuntypeSkillCapabilities, SkillFrontmatter as RuntypeSkillFrontmatter, SkillManifest as RuntypeSkillManifest, SkillProposal as RuntypeSkillProposal, SkillRuntypeExtensions as RuntypeSkillRuntypeExtensions, SkillVersion as RuntypeSkillVersion, TransformDataStepConfig as RuntypeTransformDataStepConfig, UpsertFlowConfig as RuntypeUpsertFlowConfig, UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, VectorSearchStepConfig as RuntypeVectorSearchStepConfig, WaitUntilStepConfig as RuntypeWaitUntilStepConfig, ScheduleDefinition, ScheduleDefinitionMessage, ScheduleEnsureTransport, SchedulePullResult, SearchStepConfig$1 as SearchStepConfig, SendEmailStepConfig$1 as SendEmailStepConfig, SendEventStepConfig$1 as SendEventStepConfig, SendStreamStepConfig$1 as SendStreamStepConfig, SetVariableStepConfig$1 as SetVariableStepConfig, SkillDefinition, SkillListPage, SkillListPagination, SkillListParams, SkillManifestInput, SkillMarkdownInput, SkillOrigin, SkillProposalStatus, SkillPullResult, SkillStatus, SkillTrustLevel, SkillVersionStatus, SkillWithVersion, SkillWriteInput, StepCompleteEvent, StepDeltaEvent, StepFallback, StepFieldMeta, StepStartEvent, StepWaitingLocalEvent, StreamCallbacks, StreamConsumeOptions, StreamEvent, StreamEventOf, SurfaceDefinition, SurfaceDefinitionStatus, SurfaceDefinitionType, SurfacePullResult, ToolDefinition, ToolDefinitionType, ToolPullResult, TransformDataStepConfig$1 as TransformDataStepConfig, UpdateClientTokenRequest, UpdateEvalCaseInput, UpdateEvalSuiteInput, UpdatePromptData, UpsertFlowConfig$1 as UpsertFlowConfig, UpsertRecordStepConfig$1 as UpsertRecordStepConfig, ValidateAgentPromotionInput, VectorSearchStepConfig$1 as VectorSearchStepConfig, WaitUntilStepConfig$1 as WaitUntilStepConfig, WorkflowCompileDeps, WorkflowCompletionCriteriaConfig, WorkflowConfig, WorkflowConfigFactory, WorkflowHookEntry, WorkflowHookKind, WorkflowHookRef, WorkflowHookSignatures, WorkflowMilestoneConfig, WorkflowPolicyConfig, WorkflowRecoveryConfig, WorkflowSlot };
+export type { A2AHandlerOptions, A2ARunInput, A2ATextMessage, AIGrader, ActivateAgentAliasInput, ActivateAgentPromotionInput, AgentAlias, AgentAliasActivation, AgentAliasArchiveFailure, AgentAliasArchived, AgentAliasList, AgentAliasTransport, AgentCapabilityChange, AgentCapabilityDeclaration, AgentDefinition, AgentDefinitionConfig, AgentDeploymentList, AgentDeploymentPromotion, AgentDeploymentReceipt, AgentPromotionManifest, AgentPromotionTransport, AgentPromotionValidation, AgentPullResult, AgentSkillBinding, AgentSkillBindingChange, AgentStreamEvent, ApiKeyRequest, ApiKeyRequestDelivery, ApiKeyRequestEnvironment, ApiKeyRequestHandoff, ApiKeyRequestListParams, ApiKeyRequestRequester, ApiKeyRequestStatus, ApplyGeneratedProposalOptions, ApplyGeneratedProposalResult, ArchiveAgentAliasEverywhereResult, ArchiveAgentAliasInput, AttachRuntimeToolsOptions, BatchClient, BatchListParams, BatchOptions, BatchRequest, BatchResult, BatchScheduleConfig, BatchStatus, BindSkillInput, BuiltInGraderId, CaseExpected, CheckGrader, ClaimApiKeyRequestInput, ClaimApiKeyRequestResponse, ClientConversation, ClientToken, ClientTokenConfig, ClientTokenDefinition, ClientTokenEnvironment, ClientTokenVersionPin, ClientWidgetTheme, CollectionPullResult, CollectionSchemaChange, ConditionalGetResult, ConditionalStepConfig, ContextErrorHandling, ContextFallback, CreateApiKeyRequestInput, CreateApiKeyRequestResponse, CreateClientTokenRequest, CreateClientTokenResponse, CreateEvalSuiteInput, CreatePromptData, DecomposeCriteriaResult, DefineAgentInput, DefineEvalCaseInput, DefineEvalInput, DefineFlowInput, DefineProductInput, DefineScheduleInput, DefineSkillInput, DefineSurfaceInput, DefineToolInput, DetachedReattach, DetachedReconnectOptions, DispatchClient, DispatchEvent, DispatchOptions, EnsureAgentConverged, EnsureAgentOptions, EnsureAgentPlan, EnsureAgentResult, EnsureClientTokenConverged, EnsureClientTokenOptions, EnsureClientTokenPlan, EnsureClientTokenResult, EnsureCollectionConverged, EnsureCollectionOptions, EnsureCollectionPlan, EnsureCollectionResult, EnsureEvalApplyOptions, EnsureEvalOptions, EnsureEvalPlan, EnsureEvalResult, EnsureFlowConverged, EnsureFlowOptions, EnsureFlowPlan, EnsureFlowResult, EnsureFpoOptions, EnsureFpoResult, EnsureProductConverged, EnsureProductOptions, EnsureProductPlan, EnsureProductResult, EnsureQuestionSetConverged, EnsureQuestionSetOptions, EnsureQuestionSetPlan, EnsureQuestionSetResult, EnsureScheduleConverged, EnsureScheduleOptions, EnsureSchedulePlan, EnsureScheduleResult, EnsureSkillConverged, EnsureSkillOptions, EnsureSkillPlan, EnsureSkillResult, EnsureSurfaceConverged, EnsureSurfaceOptions, EnsureSurfacePlan, EnsureSurfaceResult, EnsureToolConverged, EnsureToolOptions, EnsureToolPlan, EnsureToolResult, ErrorHandlingMode, EvalAgentSelector, EvalAgentTargetResolution, EvalCaseDefinition, EvalCaseInput, EvalCaseProposal, EvalCaseProposalAccepted, EvalCaseProposalListResult, EvalCasesGenerated, EvalClient, EvalDefinition, EvalListParams, EvalMessage, EvalOptions, EvalProposalSource, EvalProposalStatus, EvalProposedCase, EvalPullResult, EvalRecord, EvalRequest, EvalResult, EvalRunCaseScores, EvalRunConfig, EvalRunEvidence, EvalRunScores, EvalStatus, EvalSuiteCase, EvalSuiteCaseInput, EvalSuiteCoverage, EvalSuiteDetail, EvalSuiteLatestRun, EvalSuiteListResult, EvalSuiteRunQueued, EvalSuiteRunResult, EvalSuiteSummary, EvalTarget, ExecutionStreamEvent, FallbackFailEvent, FallbackStartEvent, FallbackSuccessEvent, FallbackTrigger, FallbackTriggerType, FallbacksExhaustedEvent, FallbacksInitiatedEvent, FetchUrlStepConfig, FieldFormat, FlowCompleteEvent, FlowConfig, FlowDefinition, FlowDefinitionStep, FlowErrorEvent, FlowFallback, FlowInlineEvalInput, FlowPausedEvent, FlowPullResult, FlowStartEvent, FlowStreamEvent, FlowSummary, FlowValidationClient, FlowValidationIssue, FlowValidationResult, FpoEntityOutcome, FpoInput, GenerateEmbeddingStepConfig, GenerateEvalCasesInput, GeneratedRuntimeToolGateDecision, GeneratedRuntimeToolGateOptions, GetApiKeyRequestResponse, GetRecordStepConfig, Gradeable, GraderConfig, GraderOutcome, GraderSeverity, HumanVerdict, ListAgentAliasesOptions, ListAgentDeploymentsOptions, ListConversationsResponse, ListRecordsStepConfig, LoopStepConfig, Message, MessageFallback, ModelFallback, ModelOverride, OrganizationAgentAlias, OrganizationAgentAliasList, PersistedGraderOutcome, PrepareAgentPromotionInput, ProductDefinition, ProductPullResult, PromoteAgentInput, PromoteAgentResult, PromptErrorHandling, PromptFallback, PromptListParams, PromptStepConfig, PullFpoResult, QuestionSetDefinition, QuestionSetPullResult, RecordCollectionDefinition, RecordCollectionValidationMode, RecordConfig, RecordFilter, RecordFilterCondition, RecordFilterGroup, RecordFilterOperator, RetrieveRecordStepConfig, RetryFallback, RollbackAgentAliasInput, RunEvalCaseResult, RunEvalInput, RunEvalResult, RunListParams, RunListResponse, RunListRow, AgentSkillBinding$1 as RuntypeAgentSkillBinding, ConditionalStepConfig$1 as RuntypeConditionalStepConfig, RuntypeConfig, FetchUrlStepConfig$1 as RuntypeFetchUrlStepConfig, FlowConfig$1 as RuntypeFlowConfig, GenerateEmbeddingStepConfig$1 as RuntypeGenerateEmbeddingStepConfig, GetRecordStepConfig$1 as RuntypeGetRecordStepConfig, ListRecordsStepConfig$1 as RuntypeListRecordsStepConfig, LoopStepConfig$1 as RuntypeLoopStepConfig, Message$1 as RuntypeMessage, ModelOverride$1 as RuntypeModelOverride, Prompt$1 as RuntypePrompt, PromptStepConfig$1 as RuntypePromptStepConfig, RecordConfig$1 as RuntypeRecordConfig, RetrieveRecordStepConfig$1 as RuntypeRetrieveRecordStepConfig, SearchStepConfig as RuntypeSearchStepConfig, SendEmailStepConfig as RuntypeSendEmailStepConfig, SendEventStepConfig as RuntypeSendEventStepConfig, SendStreamStepConfig as RuntypeSendStreamStepConfig, SetVariableStepConfig as RuntypeSetVariableStepConfig, Skill as RuntypeSkill, SkillBindingWithAgent as RuntypeSkillBindingWithAgent, SkillCapabilities as RuntypeSkillCapabilities, SkillFrontmatter as RuntypeSkillFrontmatter, SkillManifest as RuntypeSkillManifest, SkillProposal as RuntypeSkillProposal, SkillRuntypeExtensions as RuntypeSkillRuntypeExtensions, SkillVersion as RuntypeSkillVersion, TransformDataStepConfig as RuntypeTransformDataStepConfig, UpsertFlowConfig as RuntypeUpsertFlowConfig, UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, VectorSearchStepConfig as RuntypeVectorSearchStepConfig, WaitUntilStepConfig as RuntypeWaitUntilStepConfig, ScheduleDefinition, ScheduleDefinitionMessage, ScheduleEnsureTransport, SchedulePullResult, SearchStepConfig$1 as SearchStepConfig, SendEmailStepConfig$1 as SendEmailStepConfig, SendEventStepConfig$1 as SendEventStepConfig, SendStreamStepConfig$1 as SendStreamStepConfig, SetVariableStepConfig$1 as SetVariableStepConfig, SkillDefinition, SkillListPage, SkillListPagination, SkillListParams, SkillManifestInput, SkillMarkdownInput, SkillOrigin, SkillProposalStatus, SkillPullResult, SkillStatus, SkillTrustLevel, SkillVersionStatus, SkillWithVersion, SkillWriteInput, StepCompleteEvent, StepDeltaEvent, StepFallback, StepFieldMeta, StepStartEvent, StepWaitingLocalEvent, StreamCallbacks, StreamConsumeOptions, StreamEvent, StreamEventOf, SurfaceDefinition, SurfaceDefinitionStatus, SurfaceDefinitionType, SurfacePullResult, ToolDefinition, ToolDefinitionType, ToolPullResult, TransformDataStepConfig$1 as TransformDataStepConfig, UpdateClientTokenRequest, UpdateEvalCaseInput, UpdateEvalSuiteInput, UpdatePromptData, UpsertFlowConfig$1 as UpsertFlowConfig, UpsertRecordStepConfig$1 as UpsertRecordStepConfig, ValidateAgentPromotionInput, VectorSearchStepConfig$1 as VectorSearchStepConfig, WaitUntilStepConfig$1 as WaitUntilStepConfig, WorkflowCompileDeps, WorkflowCompletionCriteriaConfig, WorkflowConfig, WorkflowConfigFactory, WorkflowHookEntry, WorkflowHookKind, WorkflowHookRef, WorkflowHookSignatures, WorkflowMilestoneConfig, WorkflowPolicyConfig, WorkflowRecoveryConfig, WorkflowSlot };
 export {}

package/dist/index.d.ts

@@ -1283,10 +1283,11 @@ interface paths {
                 }[];
                 version?: string;
               };
+              deviceId?: string;
               /** Format: uri */
               endpoint: string;
               /** @enum {string} */
-              framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "custom";
+              framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "mastra" | "custom";
               /** @enum {string} */
               protocol?: "a2a" | "runtype-stream";
               retryCount?: number;
@@ -1323,6 +1324,8 @@ interface paths {
                 role?: "orchestrator" | "tool" | "standalone" | "hidden";
               }[];
               timeoutMs?: number;
+              /** @enum {string} */
+              transport?: "http" | "device";
             };
             icon?: string;
             maxTurns?: number;
@@ -1881,7 +1884,7 @@ interface paths {
     put?: never;
     /**
      * Fetch external agent card
-     * @description Proxy-fetch an external agent card from a URL, avoiding CORS issues. The URL is validated against SSRF attacks.
+     * @description Proxy-fetch an external agent card from a URL, avoiding CORS issues. The URL is validated against SSRF attacks. With `transport: "device"`, the card is fetched through the paired local listener `deviceId`, so the URL must be a loopback address on that machine. Pass `bearerToken` when the card itself requires one.
      */
     post: {
       parameters: {
@@ -1893,6 +1896,15 @@ interface paths {
       requestBody?: {
         content: {
           "application/json": {
+            /** @description Sent as `Authorization: Bearer` on the card request. Never stored or echoed. */
+            bearerToken?: string;
+            /** @description The paired listener to fetch through. Required when transport is "device". */
+            deviceId?: string;
+            /**
+             * @description How to reach the card: directly (default) or through a paired local listener
+             * @enum {string}
+             */
+            transport?: "http" | "device";
             /** Format: uri */
             url: string;
           };
@@ -2606,10 +2618,11 @@ interface paths {
                 }[];
                 version?: string;
               } | null;
+              deviceId?: string | null;
               /** Format: uri */
               endpoint?: string;
               /** @enum {string|null} */
-              framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "custom" | null;
+              framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "mastra" | "custom" | null;
               /** @enum {string|null} */
               protocol?: "a2a" | "runtype-stream" | null;
               retryCount?: number | null;
@@ -2646,6 +2659,8 @@ interface paths {
                 role?: "orchestrator" | "tool" | "standalone" | "hidden";
               }[] | null;
               timeoutMs?: number | null;
+              /** @enum {string|null} */
+              transport?: "http" | "device" | null;
             } | null;
             icon?: string;
             maxTurns?: number;
@@ -4475,6 +4490,15 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
+        /** @description An external agent call failed upstream: rejected credentials, rate limited, an HTTP error, a network failure, or an invalid response */
+        502: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
         /** @description Asynchronous execution unavailable */
         503: {
           headers: {
@@ -4484,6 +4508,15 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
+        /** @description An external agent call timed out */
+        504: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
       };
     };
     delete?: never;
@@ -12984,7 +13017,7 @@ interface paths {
                 mcpUrl: string;
                 name: string;
                 /** @enum {string} */
-                platform: "macos";
+                platform: "macos" | "cli";
                 publicKeyFingerprint: string;
                 revokedAt: string | null;
                 status: {
@@ -13028,6 +13061,87 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/v1/devices/loopback": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /** Register this computer as a local loopback device (development only) */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          "application/json": Record<string, never>;
+        };
+      };
+      responses: {
+        /** @description Loopback device ready */
+        201: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": {
+              data: {
+                appVersion: string | null;
+                createdAt: string;
+                id: string;
+                lastAuthenticatedAt: string | null;
+                /** Format: uri */
+                mcpUrl: string;
+                name: string;
+                /** @enum {string} */
+                platform: "macos" | "cli";
+                publicKeyFingerprint: string;
+                revokedAt: string | null;
+                status: {
+                  appVersion?: string;
+                  availableTools: string[];
+                  deviceId: string;
+                  lastSeenAt?: string;
+                  online: boolean;
+                  protocolVersion?: number;
+                };
+                updatedAt: string;
+              };
+            };
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/v1/devices/pair": {
     parameters: {
       query?: never;
@@ -13052,7 +13166,7 @@ interface paths {
             code: string;
             name: string;
             /** @enum {string} */
-            platform: "macos";
+            platform: "macos" | "cli";
             publicKey: string;
           };
         };
@@ -13072,7 +13186,7 @@ interface paths {
                 lastAuthenticatedAt: string | null;
                 name: string;
                 /** @enum {string} */
-                platform: "macos";
+                platform: "macos" | "cli";
                 publicKeyFingerprint: string;
                 revokedAt: string | null;
                 updatedAt: string;
@@ -13215,7 +13329,7 @@ interface paths {
                 mcpUrl: string;
                 name: string;
                 /** @enum {string} */
-                platform: "macos";
+                platform: "macos" | "cli";
                 publicKeyFingerprint: string;
                 revokedAt: string | null;
                 status: {
@@ -13401,7 +13515,7 @@ interface paths {
                 lastAuthenticatedAt: string | null;
                 name: string;
                 /** @enum {string} */
-                platform: "macos";
+                platform: "macos" | "cli";
                 publicKeyFingerprint: string;
                 revokedAt: string | null;
                 updatedAt: string;
@@ -63615,6 +63729,42 @@ export declare class Runtype {
   static get clientTokens(): ClientTokensNamespace;
 }
 //#endregion
+//#region src/a2a-handler.d.ts
+/** The text-only A2A 0.3 message delivered to a framework callback. */
+interface A2ATextMessage {
+  role: 'user' | 'agent';
+  messageId: string;
+  parts: Array<{
+    kind: 'text';
+    text: string;
+    metadata?: Record<string, unknown>;
+  }>;
+  contextId?: string;
+  metadata?: Record<string, unknown>;
+}
+/** A single incoming turn; persist conversation history in the framework using contextId. */
+interface A2ARunInput {
+  text: string;
+  contextId: string;
+  message: A2ATextMessage;
+  metadata: Record<string, unknown>;
+  signal: AbortSignal;
+}
+/** Configure a synchronous text adapter. Authenticate invocation POSTs before calling the handler. */
+interface A2AHandlerOptions {
+  name: string;
+  description?: string;
+  url: string;
+  maxRequestBytes?: number;
+  run: (input: A2ARunInput) => string | Promise<string>;
+}
+/**
+ * Serve POST at options.url and GET /.well-known/agent-card.json with Web APIs.
+ * Supports A2A 0.3 message/send with text parts; no streaming or retained tasks.
+ * The callback owns history, authorization of context IDs, and model cancellation.
+ */
+export declare function createA2AHandler(options: A2AHandlerOptions): (request: Request) => Promise<Response>;
+//#endregion
 //#region src/agent-promotion.d.ts
 /**
  * The HTTP surface a promotion leg needs from one organization's credentials.
@@ -68978,5 +69128,5 @@ export declare function getLikelySupportingCandidatePaths(bestCandidatePath: str
 export declare function getDefaultPlanPath(taskName: string): string;
 export declare function sanitizeTaskSlug(taskName: string): string;
 //#endregion
-export type { AIGrader, ActivateAgentAliasInput, ActivateAgentPromotionInput, AgentAlias, AgentAliasActivation, AgentAliasArchiveFailure, AgentAliasArchived, AgentAliasList, AgentAliasTransport, AgentCapabilityChange, AgentCapabilityDeclaration, AgentDefinition, AgentDefinitionConfig, AgentDeploymentList, AgentDeploymentPromotion, AgentDeploymentReceipt, AgentPromotionManifest, AgentPromotionTransport, AgentPromotionValidation, AgentPullResult, AgentSkillBinding, AgentSkillBindingChange, AgentStreamEvent, ApiKeyRequest, ApiKeyRequestDelivery, ApiKeyRequestEnvironment, ApiKeyRequestHandoff, ApiKeyRequestListParams, ApiKeyRequestRequester, ApiKeyRequestStatus, ApplyGeneratedProposalOptions, ApplyGeneratedProposalResult, ArchiveAgentAliasEverywhereResult, ArchiveAgentAliasInput, AttachRuntimeToolsOptions, BatchClient, BatchListParams, BatchOptions, BatchRequest, BatchResult, BatchScheduleConfig, BatchStatus, BindSkillInput, BuiltInGraderId, CaseExpected, CheckGrader, ClaimApiKeyRequestInput, ClaimApiKeyRequestResponse, ClientConversation, ClientToken, ClientTokenConfig, ClientTokenDefinition, ClientTokenEnvironment, ClientTokenVersionPin, ClientWidgetTheme, CollectionPullResult, CollectionSchemaChange, ConditionalGetResult, ConditionalStepConfig, ContextErrorHandling, ContextFallback, CreateApiKeyRequestInput, CreateApiKeyRequestResponse, CreateClientTokenRequest, CreateClientTokenResponse, CreateEvalSuiteInput, CreatePromptData, DecomposeCriteriaResult, DefineAgentInput, DefineEvalCaseInput, DefineEvalInput, DefineFlowInput, DefineProductInput, DefineScheduleInput, DefineSkillInput, DefineSurfaceInput, DefineToolInput, DetachedReattach, DetachedReconnectOptions, DispatchClient, DispatchEvent, DispatchOptions, EnsureAgentConverged, EnsureAgentOptions, EnsureAgentPlan, EnsureAgentResult, EnsureClientTokenConverged, EnsureClientTokenOptions, EnsureClientTokenPlan, EnsureClientTokenResult, EnsureCollectionConverged, EnsureCollectionOptions, EnsureCollectionPlan, EnsureCollectionResult, EnsureEvalApplyOptions, EnsureEvalOptions, EnsureEvalPlan, EnsureEvalResult, EnsureFlowConverged, EnsureFlowOptions, EnsureFlowPlan, EnsureFlowResult, EnsureFpoOptions, EnsureFpoResult, EnsureProductConverged, EnsureProductOptions, EnsureProductPlan, EnsureProductResult, EnsureQuestionSetConverged, EnsureQuestionSetOptions, EnsureQuestionSetPlan, EnsureQuestionSetResult, EnsureScheduleConverged, EnsureScheduleOptions, EnsureSchedulePlan, EnsureScheduleResult, EnsureSkillConverged, EnsureSkillOptions, EnsureSkillPlan, EnsureSkillResult, EnsureSurfaceConverged, EnsureSurfaceOptions, EnsureSurfacePlan, EnsureSurfaceResult, EnsureToolConverged, EnsureToolOptions, EnsureToolPlan, EnsureToolResult, ErrorHandlingMode, EvalAgentSelector, EvalAgentTargetResolution, EvalCaseDefinition, EvalCaseInput, EvalCaseProposal, EvalCaseProposalAccepted, EvalCaseProposalListResult, EvalCasesGenerated, EvalClient, EvalDefinition, EvalListParams, EvalMessage, EvalOptions, EvalProposalSource, EvalProposalStatus, EvalProposedCase, EvalPullResult, EvalRecord, EvalRequest, EvalResult, EvalRunCaseScores, EvalRunConfig, EvalRunEvidence, EvalRunScores, EvalStatus, EvalSuiteCase, EvalSuiteCaseInput, EvalSuiteCoverage, EvalSuiteDetail, EvalSuiteLatestRun, EvalSuiteListResult, EvalSuiteRunQueued, EvalSuiteRunResult, EvalSuiteSummary, EvalTarget, ExecutionStreamEvent, FallbackFailEvent, FallbackStartEvent, FallbackSuccessEvent, FallbackTrigger, FallbackTriggerType, FallbacksExhaustedEvent, FallbacksInitiatedEvent, FetchUrlStepConfig, FieldFormat, FlowCompleteEvent, FlowConfig, FlowDefinition, FlowDefinitionStep, FlowErrorEvent, FlowFallback, FlowInlineEvalInput, FlowPausedEvent, FlowPullResult, FlowStartEvent, FlowStreamEvent, FlowSummary, FlowValidationClient, FlowValidationIssue, FlowValidationResult, FpoEntityOutcome, FpoInput, GenerateEmbeddingStepConfig, GenerateEvalCasesInput, GeneratedRuntimeToolGateDecision, GeneratedRuntimeToolGateOptions, GetApiKeyRequestResponse, GetRecordStepConfig, Gradeable, GraderConfig, GraderOutcome, GraderSeverity, HumanVerdict, ListAgentAliasesOptions, ListAgentDeploymentsOptions, ListConversationsResponse, ListRecordsStepConfig, LoopStepConfig, Message, MessageFallback, ModelFallback, ModelOverride, OrganizationAgentAlias, OrganizationAgentAliasList, PersistedGraderOutcome, PrepareAgentPromotionInput, ProductDefinition, ProductPullResult, PromoteAgentInput, PromoteAgentResult, PromptErrorHandling, PromptFallback, PromptListParams, PromptStepConfig, PullFpoResult, QuestionSetDefinition, QuestionSetPullResult, RecordCollectionDefinition, RecordCollectionValidationMode, RecordConfig, RecordFilter, RecordFilterCondition, RecordFilterGroup, RecordFilterOperator, RetrieveRecordStepConfig, RetryFallback, RollbackAgentAliasInput, RunEvalCaseResult, RunEvalInput, RunEvalResult, RunListParams, RunListResponse, RunListRow, AgentSkillBinding$1 as RuntypeAgentSkillBinding, ConditionalStepConfig$1 as RuntypeConditionalStepConfig, RuntypeConfig, FetchUrlStepConfig$1 as RuntypeFetchUrlStepConfig, FlowConfig$1 as RuntypeFlowConfig, GenerateEmbeddingStepConfig$1 as RuntypeGenerateEmbeddingStepConfig, GetRecordStepConfig$1 as RuntypeGetRecordStepConfig, ListRecordsStepConfig$1 as RuntypeListRecordsStepConfig, LoopStepConfig$1 as RuntypeLoopStepConfig, Message$1 as RuntypeMessage, ModelOverride$1 as RuntypeModelOverride, Prompt$1 as RuntypePrompt, PromptStepConfig$1 as RuntypePromptStepConfig, RecordConfig$1 as RuntypeRecordConfig, RetrieveRecordStepConfig$1 as RuntypeRetrieveRecordStepConfig, SearchStepConfig as RuntypeSearchStepConfig, SendEmailStepConfig as RuntypeSendEmailStepConfig, SendEventStepConfig as RuntypeSendEventStepConfig, SendStreamStepConfig as RuntypeSendStreamStepConfig, SetVariableStepConfig as RuntypeSetVariableStepConfig, Skill as RuntypeSkill, SkillBindingWithAgent as RuntypeSkillBindingWithAgent, SkillCapabilities as RuntypeSkillCapabilities, SkillFrontmatter as RuntypeSkillFrontmatter, SkillManifest as RuntypeSkillManifest, SkillProposal as RuntypeSkillProposal, SkillRuntypeExtensions as RuntypeSkillRuntypeExtensions, SkillVersion as RuntypeSkillVersion, TransformDataStepConfig as RuntypeTransformDataStepConfig, UpsertFlowConfig as RuntypeUpsertFlowConfig, UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, VectorSearchStepConfig as RuntypeVectorSearchStepConfig, WaitUntilStepConfig as RuntypeWaitUntilStepConfig, ScheduleDefinition, ScheduleDefinitionMessage, ScheduleEnsureTransport, SchedulePullResult, SearchStepConfig$1 as SearchStepConfig, SendEmailStepConfig$1 as SendEmailStepConfig, SendEventStepConfig$1 as SendEventStepConfig, SendStreamStepConfig$1 as SendStreamStepConfig, SetVariableStepConfig$1 as SetVariableStepConfig, SkillDefinition, SkillListPage, SkillListPagination, SkillListParams, SkillManifestInput, SkillMarkdownInput, SkillOrigin, SkillProposalStatus, SkillPullResult, SkillStatus, SkillTrustLevel, SkillVersionStatus, SkillWithVersion, SkillWriteInput, StepCompleteEvent, StepDeltaEvent, StepFallback, StepFieldMeta, StepStartEvent, StepWaitingLocalEvent, StreamCallbacks, StreamConsumeOptions, StreamEvent, StreamEventOf, SurfaceDefinition, SurfaceDefinitionStatus, SurfaceDefinitionType, SurfacePullResult, ToolDefinition, ToolDefinitionType, ToolPullResult, TransformDataStepConfig$1 as TransformDataStepConfig, UpdateClientTokenRequest, UpdateEvalCaseInput, UpdateEvalSuiteInput, UpdatePromptData, UpsertFlowConfig$1 as UpsertFlowConfig, UpsertRecordStepConfig$1 as UpsertRecordStepConfig, ValidateAgentPromotionInput, VectorSearchStepConfig$1 as VectorSearchStepConfig, WaitUntilStepConfig$1 as WaitUntilStepConfig, WorkflowCompileDeps, WorkflowCompletionCriteriaConfig, WorkflowConfig, WorkflowConfigFactory, WorkflowHookEntry, WorkflowHookKind, WorkflowHookRef, WorkflowHookSignatures, WorkflowMilestoneConfig, WorkflowPolicyConfig, WorkflowRecoveryConfig, WorkflowSlot };
+export type { A2AHandlerOptions, A2ARunInput, A2ATextMessage, AIGrader, ActivateAgentAliasInput, ActivateAgentPromotionInput, AgentAlias, AgentAliasActivation, AgentAliasArchiveFailure, AgentAliasArchived, AgentAliasList, AgentAliasTransport, AgentCapabilityChange, AgentCapabilityDeclaration, AgentDefinition, AgentDefinitionConfig, AgentDeploymentList, AgentDeploymentPromotion, AgentDeploymentReceipt, AgentPromotionManifest, AgentPromotionTransport, AgentPromotionValidation, AgentPullResult, AgentSkillBinding, AgentSkillBindingChange, AgentStreamEvent, ApiKeyRequest, ApiKeyRequestDelivery, ApiKeyRequestEnvironment, ApiKeyRequestHandoff, ApiKeyRequestListParams, ApiKeyRequestRequester, ApiKeyRequestStatus, ApplyGeneratedProposalOptions, ApplyGeneratedProposalResult, ArchiveAgentAliasEverywhereResult, ArchiveAgentAliasInput, AttachRuntimeToolsOptions, BatchClient, BatchListParams, BatchOptions, BatchRequest, BatchResult, BatchScheduleConfig, BatchStatus, BindSkillInput, BuiltInGraderId, CaseExpected, CheckGrader, ClaimApiKeyRequestInput, ClaimApiKeyRequestResponse, ClientConversation, ClientToken, ClientTokenConfig, ClientTokenDefinition, ClientTokenEnvironment, ClientTokenVersionPin, ClientWidgetTheme, CollectionPullResult, CollectionSchemaChange, ConditionalGetResult, ConditionalStepConfig, ContextErrorHandling, ContextFallback, CreateApiKeyRequestInput, CreateApiKeyRequestResponse, CreateClientTokenRequest, CreateClientTokenResponse, CreateEvalSuiteInput, CreatePromptData, DecomposeCriteriaResult, DefineAgentInput, DefineEvalCaseInput, DefineEvalInput, DefineFlowInput, DefineProductInput, DefineScheduleInput, DefineSkillInput, DefineSurfaceInput, DefineToolInput, DetachedReattach, DetachedReconnectOptions, DispatchClient, DispatchEvent, DispatchOptions, EnsureAgentConverged, EnsureAgentOptions, EnsureAgentPlan, EnsureAgentResult, EnsureClientTokenConverged, EnsureClientTokenOptions, EnsureClientTokenPlan, EnsureClientTokenResult, EnsureCollectionConverged, EnsureCollectionOptions, EnsureCollectionPlan, EnsureCollectionResult, EnsureEvalApplyOptions, EnsureEvalOptions, EnsureEvalPlan, EnsureEvalResult, EnsureFlowConverged, EnsureFlowOptions, EnsureFlowPlan, EnsureFlowResult, EnsureFpoOptions, EnsureFpoResult, EnsureProductConverged, EnsureProductOptions, EnsureProductPlan, EnsureProductResult, EnsureQuestionSetConverged, EnsureQuestionSetOptions, EnsureQuestionSetPlan, EnsureQuestionSetResult, EnsureScheduleConverged, EnsureScheduleOptions, EnsureSchedulePlan, EnsureScheduleResult, EnsureSkillConverged, EnsureSkillOptions, EnsureSkillPlan, EnsureSkillResult, EnsureSurfaceConverged, EnsureSurfaceOptions, EnsureSurfacePlan, EnsureSurfaceResult, EnsureToolConverged, EnsureToolOptions, EnsureToolPlan, EnsureToolResult, ErrorHandlingMode, EvalAgentSelector, EvalAgentTargetResolution, EvalCaseDefinition, EvalCaseInput, EvalCaseProposal, EvalCaseProposalAccepted, EvalCaseProposalListResult, EvalCasesGenerated, EvalClient, EvalDefinition, EvalListParams, EvalMessage, EvalOptions, EvalProposalSource, EvalProposalStatus, EvalProposedCase, EvalPullResult, EvalRecord, EvalRequest, EvalResult, EvalRunCaseScores, EvalRunConfig, EvalRunEvidence, EvalRunScores, EvalStatus, EvalSuiteCase, EvalSuiteCaseInput, EvalSuiteCoverage, EvalSuiteDetail, EvalSuiteLatestRun, EvalSuiteListResult, EvalSuiteRunQueued, EvalSuiteRunResult, EvalSuiteSummary, EvalTarget, ExecutionStreamEvent, FallbackFailEvent, FallbackStartEvent, FallbackSuccessEvent, FallbackTrigger, FallbackTriggerType, FallbacksExhaustedEvent, FallbacksInitiatedEvent, FetchUrlStepConfig, FieldFormat, FlowCompleteEvent, FlowConfig, FlowDefinition, FlowDefinitionStep, FlowErrorEvent, FlowFallback, FlowInlineEvalInput, FlowPausedEvent, FlowPullResult, FlowStartEvent, FlowStreamEvent, FlowSummary, FlowValidationClient, FlowValidationIssue, FlowValidationResult, FpoEntityOutcome, FpoInput, GenerateEmbeddingStepConfig, GenerateEvalCasesInput, GeneratedRuntimeToolGateDecision, GeneratedRuntimeToolGateOptions, GetApiKeyRequestResponse, GetRecordStepConfig, Gradeable, GraderConfig, GraderOutcome, GraderSeverity, HumanVerdict, ListAgentAliasesOptions, ListAgentDeploymentsOptions, ListConversationsResponse, ListRecordsStepConfig, LoopStepConfig, Message, MessageFallback, ModelFallback, ModelOverride, OrganizationAgentAlias, OrganizationAgentAliasList, PersistedGraderOutcome, PrepareAgentPromotionInput, ProductDefinition, ProductPullResult, PromoteAgentInput, PromoteAgentResult, PromptErrorHandling, PromptFallback, PromptListParams, PromptStepConfig, PullFpoResult, QuestionSetDefinition, QuestionSetPullResult, RecordCollectionDefinition, RecordCollectionValidationMode, RecordConfig, RecordFilter, RecordFilterCondition, RecordFilterGroup, RecordFilterOperator, RetrieveRecordStepConfig, RetryFallback, RollbackAgentAliasInput, RunEvalCaseResult, RunEvalInput, RunEvalResult, RunListParams, RunListResponse, RunListRow, AgentSkillBinding$1 as RuntypeAgentSkillBinding, ConditionalStepConfig$1 as RuntypeConditionalStepConfig, RuntypeConfig, FetchUrlStepConfig$1 as RuntypeFetchUrlStepConfig, FlowConfig$1 as RuntypeFlowConfig, GenerateEmbeddingStepConfig$1 as RuntypeGenerateEmbeddingStepConfig, GetRecordStepConfig$1 as RuntypeGetRecordStepConfig, ListRecordsStepConfig$1 as RuntypeListRecordsStepConfig, LoopStepConfig$1 as RuntypeLoopStepConfig, Message$1 as RuntypeMessage, ModelOverride$1 as RuntypeModelOverride, Prompt$1 as RuntypePrompt, PromptStepConfig$1 as RuntypePromptStepConfig, RecordConfig$1 as RuntypeRecordConfig, RetrieveRecordStepConfig$1 as RuntypeRetrieveRecordStepConfig, SearchStepConfig as RuntypeSearchStepConfig, SendEmailStepConfig as RuntypeSendEmailStepConfig, SendEventStepConfig as RuntypeSendEventStepConfig, SendStreamStepConfig as RuntypeSendStreamStepConfig, SetVariableStepConfig as RuntypeSetVariableStepConfig, Skill as RuntypeSkill, SkillBindingWithAgent as RuntypeSkillBindingWithAgent, SkillCapabilities as RuntypeSkillCapabilities, SkillFrontmatter as RuntypeSkillFrontmatter, SkillManifest as RuntypeSkillManifest, SkillProposal as RuntypeSkillProposal, SkillRuntypeExtensions as RuntypeSkillRuntypeExtensions, SkillVersion as RuntypeSkillVersion, TransformDataStepConfig as RuntypeTransformDataStepConfig, UpsertFlowConfig as RuntypeUpsertFlowConfig, UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, VectorSearchStepConfig as RuntypeVectorSearchStepConfig, WaitUntilStepConfig as RuntypeWaitUntilStepConfig, ScheduleDefinition, ScheduleDefinitionMessage, ScheduleEnsureTransport, SchedulePullResult, SearchStepConfig$1 as SearchStepConfig, SendEmailStepConfig$1 as SendEmailStepConfig, SendEventStepConfig$1 as SendEventStepConfig, SendStreamStepConfig$1 as SendStreamStepConfig, SetVariableStepConfig$1 as SetVariableStepConfig, SkillDefinition, SkillListPage, SkillListPagination, SkillListParams, SkillManifestInput, SkillMarkdownInput, SkillOrigin, SkillProposalStatus, SkillPullResult, SkillStatus, SkillTrustLevel, SkillVersionStatus, SkillWithVersion, SkillWriteInput, StepCompleteEvent, StepDeltaEvent, StepFallback, StepFieldMeta, StepStartEvent, StepWaitingLocalEvent, StreamCallbacks, StreamConsumeOptions, StreamEvent, StreamEventOf, SurfaceDefinition, SurfaceDefinitionStatus, SurfaceDefinitionType, SurfacePullResult, ToolDefinition, ToolDefinitionType, ToolPullResult, TransformDataStepConfig$1 as TransformDataStepConfig, UpdateClientTokenRequest, UpdateEvalCaseInput, UpdateEvalSuiteInput, UpdatePromptData, UpsertFlowConfig$1 as UpsertFlowConfig, UpsertRecordStepConfig$1 as UpsertRecordStepConfig, ValidateAgentPromotionInput, VectorSearchStepConfig$1 as VectorSearchStepConfig, WaitUntilStepConfig$1 as WaitUntilStepConfig, WorkflowCompileDeps, WorkflowCompletionCriteriaConfig, WorkflowConfig, WorkflowConfigFactory, WorkflowHookEntry, WorkflowHookKind, WorkflowHookRef, WorkflowHookSignatures, WorkflowMilestoneConfig, WorkflowPolicyConfig, WorkflowRecoveryConfig, WorkflowSlot };
 export {}

package/dist/index.mjs

@@ -14067,6 +14067,174 @@ var Runtype = class {
 	}
 };
 //#endregion
+//#region src/a2a-handler.ts
+function record(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function rpcError(id, code, message, status = 200) {
+	return Response.json({
+		jsonrpc: "2.0",
+		id,
+		error: {
+			code,
+			message
+		}
+	}, { status });
+}
+function isRpcId(value) {
+	return value === null || typeof value === "string" || typeof value === "number" && Number.isFinite(value);
+}
+var RequestTooLargeError = class extends Error {};
+async function readRequest(request, limit) {
+	const reader = request.body?.getReader();
+	if (!reader) return JSON.parse("");
+	const decoder = new TextDecoder();
+	let size = 0;
+	let text = "";
+	const cancel = () => {
+		reader.cancel().catch(() => void 0);
+	};
+	request.signal.addEventListener("abort", cancel, { once: true });
+	try {
+		request.signal.throwIfAborted();
+		while (true) {
+			const { done, value } = await reader.read();
+			request.signal.throwIfAborted();
+			if (done) break;
+			size += value.byteLength;
+			if (size > limit) {
+				cancel();
+				throw new RequestTooLargeError();
+			}
+			text += decoder.decode(value, { stream: true });
+		}
+		return JSON.parse(text + decoder.decode());
+	} finally {
+		request.signal.removeEventListener("abort", cancel);
+		reader.releaseLock();
+	}
+}
+function parseMessage(value) {
+	const message = record(value);
+	if (!message || message.role !== "user" && message.role !== "agent") return void 0;
+	if (typeof message.messageId !== "string" || !message.messageId) return void 0;
+	if (message.contextId !== void 0 && (typeof message.contextId !== "string" || !message.contextId)) return;
+	if (message.metadata !== void 0 && !record(message.metadata)) return void 0;
+	if (!Array.isArray(message.parts) || message.parts.length === 0) return void 0;
+	for (const raw of message.parts) {
+		const part = record(raw);
+		if (!part || part.kind !== "text" || typeof part.text !== "string") return void 0;
+		if (part.metadata !== void 0 && !record(part.metadata)) return void 0;
+	}
+	return message;
+}
+function validateSend(params, id) {
+	if (record(params.message)?.taskId !== void 0) return rpcError(id, -32001, "Task not found");
+	if (params.metadata !== void 0 && !record(params.metadata)) return rpcError(id, -32602, "Invalid metadata");
+	const configuration = record(params.configuration);
+	if (params.configuration !== void 0 && !configuration) return rpcError(id, -32602, "Invalid configuration");
+	if (configuration?.pushNotificationConfig !== void 0) return rpcError(id, -32003, "Push notifications are not supported");
+	const modes = configuration?.acceptedOutputModes;
+	if (modes !== void 0 && (!Array.isArray(modes) || !modes.every((mode) => typeof mode === "string"))) return rpcError(id, -32602, "Invalid accepted output modes");
+	if (Array.isArray(modes) && modes.length > 0 && !modes.includes("text/plain")) return rpcError(id, -32005, "Only text/plain output is supported");
+}
+/**
+* Serve POST at options.url and GET /.well-known/agent-card.json with Web APIs.
+* Supports A2A 0.3 message/send with text parts; no streaming or retained tasks.
+* The callback owns history, authorization of context IDs, and model cancellation.
+*/
+function createA2AHandler(options) {
+	const endpoint = new URL(options.url);
+	if (!["http:", "https:"].includes(endpoint.protocol) || endpoint.username || endpoint.password || endpoint.search || endpoint.hash) throw new Error("A2A url must be an HTTP(S) endpoint without credentials, query, or fragment");
+	if (!options.name.trim()) throw new Error("A2A name must not be empty");
+	const limit = options.maxRequestBytes ?? 1048576;
+	if (!Number.isSafeInteger(limit) || limit <= 0) throw new Error("maxRequestBytes must be a positive integer");
+	const card = {
+		protocolVersion: "0.3.0",
+		name: options.name,
+		description: options.description ?? options.name,
+		url: endpoint.href,
+		preferredTransport: "JSONRPC",
+		version: "1.0.0",
+		capabilities: {
+			streaming: false,
+			pushNotifications: false
+		},
+		defaultInputModes: ["text/plain"],
+		defaultOutputModes: ["text/plain"],
+		skills: [{
+			id: "chat",
+			name: options.name,
+			description: options.description ?? options.name,
+			tags: ["chat"]
+		}]
+	};
+	return async (request) => {
+		const path = new URL(request.url).pathname;
+		if (request.method === "GET" && path === "/.well-known/agent-card.json") return Response.json(card);
+		if (path !== endpoint.pathname) return new Response("Not found", { status: 404 });
+		if (request.method !== "POST") return new Response("Method not allowed", {
+			status: 405,
+			headers: { Allow: "POST" }
+		});
+		if (request.headers.get("content-type")?.split(";")[0]?.trim().toLowerCase() !== "application/json") return rpcError(null, -32600, "Content-Type must be application/json", 415);
+		const origin = request.headers.get("origin");
+		if (origin !== null && origin !== endpoint.origin) return rpcError(null, -32600, "Origin is not allowed", 403);
+		const version = request.headers.get("a2a-version");
+		if (version && version !== "0.3" && version !== "0.3.0") return rpcError(null, -32009, "Only A2A 0.3 is supported", 400);
+		if (request.signal.aborted) return rpcError(null, -32603, "Request cancelled");
+		let body;
+		try {
+			body = await readRequest(request, limit);
+		} catch (error) {
+			if (request.signal.aborted) return rpcError(null, -32603, "Request cancelled");
+			return error instanceof RequestTooLargeError ? rpcError(null, -32600, "Request body too large", 413) : rpcError(null, -32700, "Invalid JSON");
+		}
+		const rpc = record(body);
+		if (!rpc || rpc.jsonrpc !== "2.0" || !isRpcId(rpc.id) || typeof rpc.method !== "string") return rpcError(null, -32600, "Invalid JSON-RPC request");
+		const id = rpc.id;
+		if (rpc.method !== "message/send") return rpcError(id, -32601, "Method not supported");
+		const params = record(rpc.params);
+		if (!params) return rpcError(id, -32602, "Invalid message parameters");
+		const invalid = validateSend(params, id);
+		if (invalid) return invalid;
+		const message = parseMessage(params.message);
+		if (!message) return rpcError(id, -32602, "Expected a message with a messageId, role, and text parts");
+		const contextId = message.contextId ?? crypto.randomUUID();
+		try {
+			request.signal.throwIfAborted();
+			const output = await options.run({
+				text: message.parts.map((part) => part.text).join(""),
+				contextId,
+				message,
+				metadata: record(params.metadata) ?? {},
+				signal: request.signal
+			});
+			request.signal.throwIfAborted();
+			if (typeof output !== "string") return rpcError(id, -32603, "Agent must return text");
+			return Response.json({
+				jsonrpc: "2.0",
+				id,
+				result: {
+					kind: "task",
+					id: crypto.randomUUID(),
+					contextId,
+					status: { state: "completed" },
+					artifacts: [{
+						artifactId: crypto.randomUUID(),
+						parts: [{
+							kind: "text",
+							text: output
+						}]
+					}]
+				}
+			});
+		} catch {
+			return rpcError(id, -32603, request.signal.aborted ? "Request cancelled" : "Agent execution failed");
+		}
+	};
+}
+//#endregion
 //#region src/agent-promotion.ts
 const MANIFEST_VERSION = 1;
 /** Receipts read per page, and the page ceiling, while hunting the staged receipt. */
@@ -14276,7 +14444,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.11.2";
+const SDK_VERSION = "10.12.1";
 /**
 * Canonical client identity the API uses for attribution
 * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
@@ -16465,5 +16633,5 @@ const STEP_TYPE_TO_METHOD = {
 	"memory-summary": "memorySummary"
 };
 //#endregion
-export { AgentAliasDependencyError, AgentAliasNotFoundError, AgentAliasRevisionMismatchError, AgentAliasRevisionRequiredError, AgentAliasesNamespace, AgentDeploymentsNamespace, AgentDriftError, AgentEnsureConflictError, AgentPromotionError, AgentVersionsEndpoint, AgentsEndpoint, AgentsNamespace, AnalyticsEndpoint, ApiKeyRequestsEndpoint, ApiKeysEndpoint, BatchBuilder, BatchesNamespace, BillingEndpoint, ChatEndpoint, ClientBatchBuilder, ClientEvalBuilder, ClientFlowBuilder, ClientTokenDriftError, ClientTokenEnsureError, ClientTokensEndpoint, ClientTokensNamespace, CollectionDriftError, CollectionEnsureConflictError, CollectionsEndpoint, ContextTemplatesEndpoint, ConversationsEndpoint, DEFAULT_MAX_DETACHED_RECONNECTS, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, DispatchEndpoint, ENSURE_RELEASE_DEPLOY_CONFLICT_MESSAGE, EvalBuilder, EvalDriftError, EvalEndpoint, EvalEnsureConflictError, EvalRunner, EvalSuitesNamespace, EvalsNamespace, ExecutionsEndpoint, ExecutionsNamespace, FlowBuilder, FlowDriftError, FlowEnsureConflictError, FlowResult, FlowStepsEndpoint, FlowVersionsEndpoint, FlowsEndpoint, FlowsNamespace, FpoDriftError, IntegrationsEndpoint, LEDGER_ARTIFACT_LINE_PREFIX, LIVE_AGENT_ALIAS, LogsEndpoint, ModelConfigsEndpoint, ProductDriftError, ProductEnsureConflictError, ProductsNamespace, PromptsEndpoint, PromptsNamespace, ProviderKeysEndpoint, QuestionSetDriftError, QuestionSetEnsureConflictError, QuestionSetsNamespace, RUNTYPE_CLIENT_KIND, RecordsEndpoint, RunsNamespace, Runtype, RuntypeApiError, RuntypeClient, RuntypeFlowBuilder, SDK_USER_AGENT, SDK_VERSION, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, ScheduleDriftError, ScheduleEnsureConflictError, SchedulesEndpoint, SecretsEndpoint, SkillDriftError, SkillEnsureConflictError, SkillProposalsNamespace, SkillsNamespace, SurfaceDriftError, SurfaceEnsureConflictError, SurfacesEndpoint, SurfacesNamespace, ToolApprovalGrantsEndpoint, ToolDriftError, ToolEnsureConflictError, ToolsEndpoint, ToolsNamespace, TypedRecordsScope, UNIFIED_EVENTS_QUERY, UsersEndpoint, activateAgentPromotion, agentAliasErrorCode, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildExecutionEventsPath, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildObservationMaskMarker, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, combineAbortSignals, compileWorkflowConfig, completed, computeAgentContentHash, computeEvalContentHash, computeFlowContentHash, computeFpoContentHash, computeProductContentHash, computeQuestionSetContentHash, computeRecordCollectionContentHash, computeScheduleContentHash, computeScheduleDefinitionHash, computeSkillContentHash, computeSurfaceContentHash, computeToolContentHash, contains, cost, createAgentEventTranslator, createClient, createExternalTool, createFlowEventTranslator, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineEval, defineFlow, defineFpo, definePlaybook, defineProduct, defineQuestionSet, defineSchedule, defineSkill, defineSurface, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, ensureEval, ensureFpo, ensureSchedule, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, fpoPlanHasDrift, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isBuiltinToolExecuteResponse, isCatalogClientToolRef, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isUnifiedEventType, isWorkflowHookRef, jsonField, judge, judges, latency, length, listWorkflowHooks, matchesExpected, maxToolCalls, noError, normalizeAgentDefinition, normalizeCandidatePath, normalizeFpoDefinition, normalizeProductDefinition, normalizeQuestionSetDefinition, normalizeRecordCollectionDefinition, normalizeScheduleContent, normalizeSkillDefinition, normalizeSurfaceDefinition, normalizeToolDefinition, notCalledTool, notContains, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, prepareAgentPromotion, processStream, promoteAgent, promotionIdempotencyKey, pullEval, pullFpo, pullSchedule, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, validateAgentPromotion, withDetachedReconnect, withUnifiedEvents };
+export { AgentAliasDependencyError, AgentAliasNotFoundError, AgentAliasRevisionMismatchError, AgentAliasRevisionRequiredError, AgentAliasesNamespace, AgentDeploymentsNamespace, AgentDriftError, AgentEnsureConflictError, AgentPromotionError, AgentVersionsEndpoint, AgentsEndpoint, AgentsNamespace, AnalyticsEndpoint, ApiKeyRequestsEndpoint, ApiKeysEndpoint, BatchBuilder, BatchesNamespace, BillingEndpoint, ChatEndpoint, ClientBatchBuilder, ClientEvalBuilder, ClientFlowBuilder, ClientTokenDriftError, ClientTokenEnsureError, ClientTokensEndpoint, ClientTokensNamespace, CollectionDriftError, CollectionEnsureConflictError, CollectionsEndpoint, ContextTemplatesEndpoint, ConversationsEndpoint, DEFAULT_MAX_DETACHED_RECONNECTS, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, DispatchEndpoint, ENSURE_RELEASE_DEPLOY_CONFLICT_MESSAGE, EvalBuilder, EvalDriftError, EvalEndpoint, EvalEnsureConflictError, EvalRunner, EvalSuitesNamespace, EvalsNamespace, ExecutionsEndpoint, ExecutionsNamespace, FlowBuilder, FlowDriftError, FlowEnsureConflictError, FlowResult, FlowStepsEndpoint, FlowVersionsEndpoint, FlowsEndpoint, FlowsNamespace, FpoDriftError, IntegrationsEndpoint, LEDGER_ARTIFACT_LINE_PREFIX, LIVE_AGENT_ALIAS, LogsEndpoint, ModelConfigsEndpoint, ProductDriftError, ProductEnsureConflictError, ProductsNamespace, PromptsEndpoint, PromptsNamespace, ProviderKeysEndpoint, QuestionSetDriftError, QuestionSetEnsureConflictError, QuestionSetsNamespace, RUNTYPE_CLIENT_KIND, RecordsEndpoint, RunsNamespace, Runtype, RuntypeApiError, RuntypeClient, RuntypeFlowBuilder, SDK_USER_AGENT, SDK_VERSION, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, ScheduleDriftError, ScheduleEnsureConflictError, SchedulesEndpoint, SecretsEndpoint, SkillDriftError, SkillEnsureConflictError, SkillProposalsNamespace, SkillsNamespace, SurfaceDriftError, SurfaceEnsureConflictError, SurfacesEndpoint, SurfacesNamespace, ToolApprovalGrantsEndpoint, ToolDriftError, ToolEnsureConflictError, ToolsEndpoint, ToolsNamespace, TypedRecordsScope, UNIFIED_EVENTS_QUERY, UsersEndpoint, activateAgentPromotion, agentAliasErrorCode, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildExecutionEventsPath, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildObservationMaskMarker, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, combineAbortSignals, compileWorkflowConfig, completed, computeAgentContentHash, computeEvalContentHash, computeFlowContentHash, computeFpoContentHash, computeProductContentHash, computeQuestionSetContentHash, computeRecordCollectionContentHash, computeScheduleContentHash, computeScheduleDefinitionHash, computeSkillContentHash, computeSurfaceContentHash, computeToolContentHash, contains, cost, createA2AHandler, createAgentEventTranslator, createClient, createExternalTool, createFlowEventTranslator, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineEval, defineFlow, defineFpo, definePlaybook, defineProduct, defineQuestionSet, defineSchedule, defineSkill, defineSurface, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, ensureEval, ensureFpo, ensureSchedule, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, fpoPlanHasDrift, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isBuiltinToolExecuteResponse, isCatalogClientToolRef, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isUnifiedEventType, isWorkflowHookRef, jsonField, judge, judges, latency, length, listWorkflowHooks, matchesExpected, maxToolCalls, noError, normalizeAgentDefinition, normalizeCandidatePath, normalizeFpoDefinition, normalizeProductDefinition, normalizeQuestionSetDefinition, normalizeRecordCollectionDefinition, normalizeScheduleContent, normalizeSkillDefinition, normalizeSurfaceDefinition, normalizeToolDefinition, notCalledTool, notContains, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, prepareAgentPromotion, processStream, promoteAgent, promotionIdempotencyKey, pullEval, pullFpo, pullSchedule, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, validateAgentPromotion, withDetachedReconnect, withUnifiedEvents };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "10.11.2",
+  "version": "10.12.1",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",
@@ -24,7 +24,7 @@
   ],
   "dependencies": {},
   "devDependencies": {
-    "@runtypelabs/shared": "3.71.1",
+    "@runtypelabs/shared": "3.73.0",
     "openapi-typescript": "^7.13.0",
     "tsdown": "^0.23.0",
     "typescript": "^6.0.3",