@assistant-ui/react-ag-ui 0.0.57 → 0.0.59

package/dist/runtime/event-parser.js

@@ -11,6 +11,10 @@ const withOptional = (base, optionals) => {
 	};
 };
 const isPlainObject = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+const logRejectedEvent = (logger, type, payload, reason) => {
+	const typeLabel = isString(type) ? type : "unknown";
+	logger?.debug?.(`[agui] ${typeLabel} ${reason}`, payload);
+};
 const parseInterrupt = (raw) => {
 	if (!isPlainObject(raw)) return null;
 	const id = raw.id;
@@ -27,17 +31,37 @@ const parseInterrupt = (raw) => {
 	if (isPlainObject(raw.metadata)) interrupt.metadata = raw.metadata;
 	return raw.responseSchema == null || isPlainObject(raw.responseSchema) ? interrupt : withRawResponseSchema(interrupt, raw.responseSchema);
 };
-const parseRunFinishedOutcome = (raw, logger) => {
-	if (!isPlainObject(raw)) return void 0;
+const parseRunFinishedOutcome = (raw, runId, logger) => {
+	if (raw == null) return void 0;
+	if (!isPlainObject(raw)) {
+		logRejectedEvent(logger, "RUN_FINISHED", {
+			runId,
+			outcome: raw
+		}, "has invalid outcome");
+		return;
+	}
 	if (raw.type === "success") return { type: "success" };
 	if (raw.type === "interrupt") {
 		if (!Array.isArray(raw.interrupts)) {
-			logger?.debug?.("[agui] RUN_FINISHED interrupt outcome missing interrupts array", raw);
+			logRejectedEvent(logger, "RUN_FINISHED", {
+				runId,
+				outcome: raw
+			}, "has an interrupt outcome missing interrupts array");
 			return;
 		}
-		const parsed = raw.interrupts.map((entry) => parseInterrupt(entry)).filter((entry) => entry !== null);
+		const parsed = raw.interrupts.map((entry) => {
+			const interrupt = parseInterrupt(entry);
+			if (interrupt === null) logRejectedEvent(logger, "RUN_FINISHED", {
+				runId,
+				interrupt: entry
+			}, "has malformed interrupt");
+			return interrupt;
+		}).filter((entry) => entry !== null);
 		if (parsed.length === 0) {
-			logger?.debug?.("[agui] RUN_FINISHED interrupt outcome has no valid interrupts", raw.interrupts);
+			logRejectedEvent(logger, "RUN_FINISHED", {
+				runId,
+				interrupts: raw.interrupts
+			}, "has an interrupt outcome with no valid interrupts");
 			return;
 		}
 		return {
@@ -45,12 +69,26 @@ const parseRunFinishedOutcome = (raw, logger) => {
 			interrupts: parsed
 		};
 	}
+	logRejectedEvent(logger, "RUN_FINISHED", {
+		runId,
+		outcome: raw
+	}, "has unsupported outcome type");
 };
 const parseAgUiEvent = (event, options) => {
-	if (!event || typeof event !== "object") return null;
+	if (!event || typeof event !== "object") {
+		logRejectedEvent(options?.logger, void 0, event, "is not an object");
+		return null;
+	}
 	const payload = event;
 	const typeValue = payload.type;
-	if (!isString(typeValue)) return null;
+	if (!isString(typeValue)) {
+		logRejectedEvent(options?.logger, typeValue, payload, "has no string type");
+		return null;
+	}
+	const reject = (reason) => {
+		logRejectedEvent(options?.logger, typeValue, payload, reason);
+		return null;
+	};
 	const getString = (key) => isString(payload[key]) ? payload[key] : void 0;
 	switch (typeValue) {
 		case "RUN_STARTED": {
@@ -58,15 +96,15 @@ const parseAgUiEvent = (event, options) => {
 			return runId ? {
 				type: "RUN_STARTED",
 				runId
-			} : null;
+			} : reject("missing runId");
 		}
 		case "RUN_FINISHED": {
 			const runId = getString("runId");
-			if (!runId) return null;
+			if (!runId) return reject("missing runId");
 			return withOptional({
 				type: "RUN_FINISHED",
 				runId
-			}, { outcome: parseRunFinishedOutcome(payload.outcome, options?.logger) });
+			}, { outcome: parseRunFinishedOutcome(payload.outcome, runId, options?.logger) });
 		}
 		case "RUN_CANCELLED": {
 			const runId = getString("runId");
@@ -76,22 +114,34 @@ const parseAgUiEvent = (event, options) => {
 			message: getString("message"),
 			code: getString("code")
 		});
-		case "TEXT_MESSAGE_START": return withOptional({ type: "TEXT_MESSAGE_START" }, { messageId: getString("messageId") });
+		case "TEXT_MESSAGE_START": return withOptional({ type: "TEXT_MESSAGE_START" }, {
+			messageId: getString("messageId"),
+			subagentRunId: getString("subagentRunId")
+		});
 		case "TEXT_MESSAGE_CONTENT": {
 			const delta = getString("delta");
-			if (!isNonEmptyString(delta)) return null;
+			if (!isNonEmptyString(delta)) return reject("missing non-empty delta");
 			return withOptional({
 				type: "TEXT_MESSAGE_CONTENT",
 				delta
-			}, { messageId: getString("messageId") });
+			}, {
+				messageId: getString("messageId"),
+				subagentRunId: getString("subagentRunId")
+			});
 		}
-		case "TEXT_MESSAGE_END": return withOptional({ type: "TEXT_MESSAGE_END" }, { messageId: getString("messageId") });
+		case "TEXT_MESSAGE_END": return withOptional({ type: "TEXT_MESSAGE_END" }, {
+			messageId: getString("messageId"),
+			subagentRunId: getString("subagentRunId")
+		});
 		case "TEXT_MESSAGE_CHUNK": {
 			const delta = getString("delta") ?? "";
 			return withOptional({
 				type: "TEXT_MESSAGE_CHUNK",
 				delta
-			}, { messageId: getString("messageId") });
+			}, {
+				messageId: getString("messageId"),
+				subagentRunId: getString("subagentRunId")
+			});
 		}
 		case "THINKING_START": return withOptional({ type: "THINKING_START" }, { title: getString("title") });
 		case "THINKING_TEXT_MESSAGE_START": return { type: "THINKING_TEXT_MESSAGE_START" };
@@ -101,66 +151,87 @@ const parseAgUiEvent = (event, options) => {
 		};
 		case "THINKING_TEXT_MESSAGE_END": return { type: "THINKING_TEXT_MESSAGE_END" };
 		case "THINKING_END": return { type: "THINKING_END" };
-		case "REASONING_START": return withOptional({ type: "REASONING_START" }, { messageId: getString("messageId") });
-		case "REASONING_MESSAGE_START": return withOptional({ type: "REASONING_MESSAGE_START" }, { messageId: getString("messageId") });
+		case "REASONING_START": return withOptional({ type: "REASONING_START" }, {
+			messageId: getString("messageId"),
+			subagentRunId: getString("subagentRunId")
+		});
+		case "REASONING_MESSAGE_START": return withOptional({ type: "REASONING_MESSAGE_START" }, {
+			messageId: getString("messageId"),
+			subagentRunId: getString("subagentRunId")
+		});
 		case "REASONING_MESSAGE_CONTENT": {
 			const delta = getString("delta") ?? "";
 			return withOptional({
 				type: "REASONING_MESSAGE_CONTENT",
 				delta
-			}, { messageId: getString("messageId") });
+			}, {
+				messageId: getString("messageId"),
+				subagentRunId: getString("subagentRunId")
+			});
 		}
-		case "REASONING_MESSAGE_END": return withOptional({ type: "REASONING_MESSAGE_END" }, { messageId: getString("messageId") });
+		case "REASONING_MESSAGE_END": return withOptional({ type: "REASONING_MESSAGE_END" }, {
+			messageId: getString("messageId"),
+			subagentRunId: getString("subagentRunId")
+		});
 		case "REASONING_ENCRYPTED_VALUE": {
 			const entityId = getString("entityId");
 			const encryptedValue = getString("encryptedValue");
 			const subtype = getString("subtype");
-			if (!entityId || !encryptedValue) return null;
-			if (subtype !== "message" && subtype !== "tool-call") return null;
+			if (!entityId || !encryptedValue) return reject("missing entityId or encryptedValue");
+			if (subtype !== "message" && subtype !== "tool-call") return reject("has an invalid subtype");
+			const subagentRunId = getString("subagentRunId");
 			return {
 				type: "REASONING_ENCRYPTED_VALUE",
 				subtype,
 				entityId,
-				encryptedValue
+				encryptedValue,
+				...subagentRunId !== void 0 ? { subagentRunId } : {}
 			};
 		}
-		case "REASONING_END": return withOptional({ type: "REASONING_END" }, { messageId: getString("messageId") });
+		case "REASONING_END": return withOptional({ type: "REASONING_END" }, {
+			messageId: getString("messageId"),
+			subagentRunId: getString("subagentRunId")
+		});
 		case "TOOL_CALL_START": {
 			const toolCallId = getString("toolCallId");
-			if (!toolCallId) return null;
+			if (!toolCallId) return reject("missing toolCallId");
 			return withOptional({
 				type: "TOOL_CALL_START",
 				toolCallId
 			}, {
 				toolCallName: getString("toolCallName"),
-				parentMessageId: getString("parentMessageId")
+				parentMessageId: getString("parentMessageId"),
+				subagentRunId: getString("subagentRunId")
 			});
 		}
 		case "TOOL_CALL_ARGS": {
 			const toolCallId = getString("toolCallId");
-			if (!toolCallId) return null;
-			return {
+			if (!toolCallId) return reject("missing toolCallId");
+			const delta = getString("delta") ?? "";
+			return withOptional({
 				type: "TOOL_CALL_ARGS",
 				toolCallId,
-				delta: getString("delta") ?? ""
-			};
+				delta
+			}, { subagentRunId: getString("subagentRunId") });
 		}
 		case "TOOL_CALL_END": {
 			const toolCallId = getString("toolCallId");
-			return toolCallId ? {
+			if (!toolCallId) return reject("missing toolCallId");
+			return withOptional({
 				type: "TOOL_CALL_END",
 				toolCallId
-			} : null;
+			}, { subagentRunId: getString("subagentRunId") });
 		}
 		case "TOOL_CALL_CHUNK": return withOptional({ type: "TOOL_CALL_CHUNK" }, {
 			toolCallId: getString("toolCallId"),
 			toolCallName: getString("toolCallName"),
 			parentMessageId: getString("parentMessageId"),
-			delta: getString("delta")
+			delta: getString("delta"),
+			subagentRunId: getString("subagentRunId")
 		});
 		case "TOOL_CALL_RESULT": {
 			const toolCallId = getString("toolCallId");
-			if (!toolCallId) return null;
+			if (!toolCallId) return reject("missing toolCallId");
 			const content = getString("content") ?? "";
 			return withOptional({
 				type: "TOOL_CALL_RESULT",
@@ -169,31 +240,37 @@ const parseAgUiEvent = (event, options) => {
 			}, {
 				messageId: getString("messageId"),
 				role: payload.role === "tool" ? "tool" : void 0,
-				mcpResult: parseMcpToolCallResult(payload, content)
+				mcpResult: parseMcpToolCallResult(payload, content),
+				subagentRunId: getString("subagentRunId")
 			});
 		}
-		case "STATE_SNAPSHOT": return {
-			type: "STATE_SNAPSHOT",
-			snapshot: payload.snapshot
-		};
+		case "STATE_SNAPSHOT":
+			if (payload.snapshot === void 0) return reject("missing snapshot");
+			return {
+				type: "STATE_SNAPSHOT",
+				snapshot: payload.snapshot
+			};
 		case "STATE_DELTA": return {
 			type: "STATE_DELTA",
 			delta: Array.isArray(payload.delta) ? payload.delta : []
 		};
-		case "MESSAGES_SNAPSHOT": return {
-			type: "MESSAGES_SNAPSHOT",
-			messages: Array.isArray(payload.messages) ? payload.messages : []
-		};
+		case "MESSAGES_SNAPSHOT":
+			if (!Array.isArray(payload.messages)) return reject("missing messages array");
+			return {
+				type: "MESSAGES_SNAPSHOT",
+				messages: payload.messages
+			};
 		case "ACTIVITY_SNAPSHOT": {
 			const activityType = getString("activityType");
-			if (!activityType || !isPlainObject(payload.content)) return null;
+			if (!activityType || !isPlainObject(payload.content)) return reject("missing activityType or object content");
 			return withOptional({
 				type: "ACTIVITY_SNAPSHOT",
 				activityType,
 				content: payload.content
 			}, {
 				messageId: getString("messageId"),
-				replace: typeof payload.replace === "boolean" ? payload.replace : void 0
+				replace: typeof payload.replace === "boolean" ? payload.replace : void 0,
+				subagentRunId: getString("subagentRunId")
 			});
 		}
 		case "RAW": return withOptional({
@@ -202,13 +279,67 @@ const parseAgUiEvent = (event, options) => {
 		}, { source: getString("source") });
 		case "CUSTOM": {
 			const name = getString("name");
-			if (!name) return null;
+			if (!name) return reject("missing name");
 			return {
 				type: "CUSTOM",
 				name,
 				value: payload.value
 			};
 		}
+		case "SUBAGENT_STARTED": {
+			const subagentRunId = getString("subagentRunId");
+			const name = getString("name");
+			if (!subagentRunId || !name) return reject("missing subagentRunId or name");
+			return withOptional({
+				type: "SUBAGENT_STARTED",
+				subagentRunId,
+				name
+			}, {
+				description: getString("description"),
+				parentSubagentRunId: getString("parentSubagentRunId"),
+				parentToolCallId: getString("parentToolCallId"),
+				parentMessageId: getString("parentMessageId")
+			});
+		}
+		case "SUBAGENT_FINISHED": {
+			const subagentRunId = getString("subagentRunId");
+			if (!subagentRunId) return reject("missing subagentRunId");
+			const rawOutcome = payload.outcome;
+			let outcome;
+			if (rawOutcome == null) outcome = void 0;
+			else if (!isPlainObject(rawOutcome)) {
+				logRejectedEvent(options?.logger, "SUBAGENT_FINISHED", {
+					subagentRunId,
+					outcome: rawOutcome
+				}, "has invalid outcome");
+				outcome = void 0;
+			} else if (rawOutcome.type === "success") outcome = { type: "success" };
+			else if (rawOutcome.type === "suspended") outcome = withOptional({ type: "suspended" }, { interruptIds: Array.isArray(rawOutcome.interruptIds) ? rawOutcome.interruptIds.filter(isString) : void 0 });
+			else {
+				logRejectedEvent(options?.logger, "SUBAGENT_FINISHED", {
+					subagentRunId,
+					outcome: rawOutcome
+				}, "has unsupported outcome type");
+				outcome = void 0;
+			}
+			return withOptional({
+				type: "SUBAGENT_FINISHED",
+				subagentRunId
+			}, {
+				result: payload.result,
+				outcome
+			});
+		}
+		case "SUBAGENT_ERROR": {
+			const subagentRunId = getString("subagentRunId");
+			const message = getString("message");
+			if (!subagentRunId || !message) return reject("missing subagentRunId or message");
+			return withOptional({
+				type: "SUBAGENT_ERROR",
+				subagentRunId,
+				message
+			}, { code: getString("code") });
+		}
 		default: return withOptional({
 			type: "RAW",
 			event: payload

package/dist/runtime/event-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-parser.js","names":[],"sources":["../../src/runtime/event-parser.ts"],"sourcesContent":["import type { AgUiEvent, AgUiInterrupt, AgUiRunFinishedOutcome } from \"./types\";\nimport type { Logger } from \"./logger\";\nimport { parseMcpToolCallResult } from \"./mcp-tool-result\";\nimport { withRawResponseSchema } from \"./interrupt-internals\";\n\nexport type ParseAgUiEventOptions = {\n  logger?: Logger;\n};\n\nconst isString = (value: unknown): value is string => typeof value === \"string\";\nconst isNonEmptyString = (value: unknown): value is string =>\n  isString(value) && value.length > 0;\n\nconst withOptional = <T extends object>(\n  base: T,\n  optionals: Record<string, unknown>,\n) => {\n  const definedEntries = Object.entries(optionals).filter(\n    ([, value]) => value !== undefined,\n  );\n  return definedEntries.length === 0\n    ? base\n    : ({ ...base, ...Object.fromEntries(definedEntries) } as T);\n};\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\nconst parseInterrupt = (raw: unknown): AgUiInterrupt | null => {\n  if (!isPlainObject(raw)) return null;\n  const id = raw.id;\n  const reason = raw.reason;\n  if (typeof id !== \"string\" || typeof reason !== \"string\") return null;\n  const interrupt: AgUiInterrupt = { id, reason };\n  if (typeof raw.message === \"string\") interrupt.message = raw.message;\n  if (typeof raw.toolCallId === \"string\") interrupt.toolCallId = raw.toolCallId;\n  if (typeof raw.expiresAt === \"string\") interrupt.expiresAt = raw.expiresAt;\n  if (isPlainObject(raw.responseSchema))\n    interrupt.responseSchema = raw.responseSchema;\n  if (isPlainObject(raw.metadata)) interrupt.metadata = raw.metadata;\n  // A present schema is kept whatever its shape: `false` is a JSON Schema that\n  // rejects every payload, so normalizing it to absent would claim a gate no\n  // decision can answer. Only an object schema fits `responseSchema`; every\n  // other shape travels on the internal carrier. `null` is not a JSON Schema at\n  // all, and it is what a server serializing an unset optional field sends, so\n  // it reads as absent rather than as a schema nothing can satisfy.\n  return raw.responseSchema == null || isPlainObject(raw.responseSchema)\n    ? interrupt\n    : withRawResponseSchema(interrupt, raw.responseSchema);\n};\n\nconst parseRunFinishedOutcome = (\n  raw: unknown,\n  logger: Logger | undefined,\n): AgUiRunFinishedOutcome | undefined => {\n  if (!isPlainObject(raw)) return undefined;\n  if (raw.type === \"success\") return { type: \"success\" };\n  if (raw.type === \"interrupt\") {\n    if (!Array.isArray(raw.interrupts)) {\n      logger?.debug?.(\n        \"[agui] RUN_FINISHED interrupt outcome missing interrupts array\",\n        raw,\n      );\n      return undefined;\n    }\n    const parsed = raw.interrupts\n      .map((entry) => parseInterrupt(entry))\n      .filter((entry): entry is AgUiInterrupt => entry !== null);\n    if (parsed.length === 0) {\n      logger?.debug?.(\n        \"[agui] RUN_FINISHED interrupt outcome has no valid interrupts\",\n        raw.interrupts,\n      );\n      return undefined;\n    }\n    return { type: \"interrupt\", interrupts: parsed };\n  }\n  return undefined;\n};\n\nexport const parseAgUiEvent = (\n  event: unknown,\n  options?: ParseAgUiEventOptions,\n): AgUiEvent | null => {\n  if (!event || typeof event !== \"object\") return null;\n  const payload = event as Record<string, unknown>;\n  const typeValue = payload.type;\n  if (!isString(typeValue)) return null;\n\n  const getString = (key: string) =>\n    isString(payload[key]) ? (payload[key] as string) : undefined;\n\n  switch (typeValue) {\n    case \"RUN_STARTED\": {\n      const runId = getString(\"runId\");\n      return runId ? { type: \"RUN_STARTED\", runId } : null;\n    }\n    case \"RUN_FINISHED\": {\n      const runId = getString(\"runId\");\n      if (!runId) return null;\n      return withOptional(\n        { type: \"RUN_FINISHED\" as const, runId },\n        {\n          outcome: parseRunFinishedOutcome(payload.outcome, options?.logger),\n        },\n      );\n    }\n    case \"RUN_CANCELLED\": {\n      const runId = getString(\"runId\");\n      return withOptional({ type: \"RUN_CANCELLED\" as const }, { runId });\n    }\n    case \"RUN_ERROR\": {\n      return withOptional(\n        { type: \"RUN_ERROR\" as const },\n        {\n          message: getString(\"message\"),\n          code: getString(\"code\"),\n        },\n      );\n    }\n    case \"TEXT_MESSAGE_START\":\n      return withOptional(\n        { type: \"TEXT_MESSAGE_START\" as const },\n        { messageId: getString(\"messageId\") },\n      );\n    case \"TEXT_MESSAGE_CONTENT\": {\n      const delta = getString(\"delta\");\n      if (!isNonEmptyString(delta)) return null;\n      return withOptional(\n        { type: \"TEXT_MESSAGE_CONTENT\" as const, delta },\n        { messageId: getString(\"messageId\") },\n      );\n    }\n    case \"TEXT_MESSAGE_END\":\n      return withOptional(\n        { type: \"TEXT_MESSAGE_END\" as const },\n        { messageId: getString(\"messageId\") },\n      );\n    case \"TEXT_MESSAGE_CHUNK\": {\n      const delta = getString(\"delta\") ?? \"\";\n      return withOptional(\n        { type: \"TEXT_MESSAGE_CHUNK\" as const, delta },\n        { messageId: getString(\"messageId\") },\n      );\n    }\n    case \"THINKING_START\":\n      return withOptional(\n        { type: \"THINKING_START\" as const },\n        { title: getString(\"title\") },\n      );\n    case \"THINKING_TEXT_MESSAGE_START\":\n      return { type: \"THINKING_TEXT_MESSAGE_START\" };\n    case \"THINKING_TEXT_MESSAGE_CONTENT\": {\n      const delta = getString(\"delta\") ?? \"\";\n      return { type: \"THINKING_TEXT_MESSAGE_CONTENT\", delta };\n    }\n    case \"THINKING_TEXT_MESSAGE_END\":\n      return { type: \"THINKING_TEXT_MESSAGE_END\" };\n    case \"THINKING_END\":\n      return { type: \"THINKING_END\" };\n    case \"REASONING_START\":\n      return withOptional(\n        { type: \"REASONING_START\" as const },\n        { messageId: getString(\"messageId\") },\n      );\n    case \"REASONING_MESSAGE_START\":\n      return withOptional(\n        { type: \"REASONING_MESSAGE_START\" as const },\n        { messageId: getString(\"messageId\") },\n      );\n    case \"REASONING_MESSAGE_CONTENT\": {\n      const delta = getString(\"delta\") ?? \"\";\n      return withOptional(\n        { type: \"REASONING_MESSAGE_CONTENT\" as const, delta },\n        { messageId: getString(\"messageId\") },\n      );\n    }\n    case \"REASONING_MESSAGE_END\":\n      return withOptional(\n        { type: \"REASONING_MESSAGE_END\" as const },\n        { messageId: getString(\"messageId\") },\n      );\n    case \"REASONING_ENCRYPTED_VALUE\": {\n      const entityId = getString(\"entityId\");\n      const encryptedValue = getString(\"encryptedValue\");\n      const subtype = getString(\"subtype\");\n      if (!entityId || !encryptedValue) return null;\n      if (subtype !== \"message\" && subtype !== \"tool-call\") return null;\n      return {\n        type: \"REASONING_ENCRYPTED_VALUE\" as const,\n        subtype,\n        entityId,\n        encryptedValue,\n      };\n    }\n    case \"REASONING_END\":\n      return withOptional(\n        { type: \"REASONING_END\" as const },\n        { messageId: getString(\"messageId\") },\n      );\n    case \"TOOL_CALL_START\": {\n      const toolCallId = getString(\"toolCallId\");\n      if (!toolCallId) return null;\n      return withOptional(\n        { type: \"TOOL_CALL_START\" as const, toolCallId },\n        {\n          toolCallName: getString(\"toolCallName\"),\n          parentMessageId: getString(\"parentMessageId\"),\n        },\n      );\n    }\n    case \"TOOL_CALL_ARGS\": {\n      const toolCallId = getString(\"toolCallId\");\n      if (!toolCallId) return null;\n      const delta = getString(\"delta\") ?? \"\";\n      return { type: \"TOOL_CALL_ARGS\", toolCallId, delta };\n    }\n    case \"TOOL_CALL_END\": {\n      const toolCallId = getString(\"toolCallId\");\n      return toolCallId ? { type: \"TOOL_CALL_END\", toolCallId } : null;\n    }\n    case \"TOOL_CALL_CHUNK\":\n      return withOptional(\n        { type: \"TOOL_CALL_CHUNK\" as const },\n        {\n          toolCallId: getString(\"toolCallId\"),\n          toolCallName: getString(\"toolCallName\"),\n          parentMessageId: getString(\"parentMessageId\"),\n          delta: getString(\"delta\"),\n        },\n      );\n    case \"TOOL_CALL_RESULT\": {\n      const toolCallId = getString(\"toolCallId\");\n      if (!toolCallId) return null;\n      const content = getString(\"content\") ?? \"\";\n      return withOptional(\n        {\n          type: \"TOOL_CALL_RESULT\" as const,\n          toolCallId,\n          content,\n        },\n        {\n          messageId: getString(\"messageId\"),\n          role: payload.role === \"tool\" ? \"tool\" : undefined,\n          mcpResult: parseMcpToolCallResult(payload, content),\n        },\n      );\n    }\n    case \"STATE_SNAPSHOT\":\n      return { type: \"STATE_SNAPSHOT\", snapshot: payload.snapshot };\n    case \"STATE_DELTA\":\n      return {\n        type: \"STATE_DELTA\",\n        delta: Array.isArray(payload.delta) ? (payload.delta as any[]) : [],\n      };\n    case \"MESSAGES_SNAPSHOT\":\n      return {\n        type: \"MESSAGES_SNAPSHOT\",\n        messages: Array.isArray(payload.messages)\n          ? (payload.messages as any[])\n          : [],\n      };\n    case \"ACTIVITY_SNAPSHOT\": {\n      const activityType = getString(\"activityType\");\n      if (!activityType || !isPlainObject(payload.content)) return null;\n      return withOptional(\n        {\n          type: \"ACTIVITY_SNAPSHOT\" as const,\n          activityType,\n          content: payload.content,\n        },\n        {\n          messageId: getString(\"messageId\"),\n          replace:\n            typeof payload.replace === \"boolean\" ? payload.replace : undefined,\n        },\n      );\n    }\n    case \"RAW\":\n      return withOptional(\n        { type: \"RAW\" as const, event: payload.event },\n        { source: getString(\"source\") },\n      );\n    case \"CUSTOM\": {\n      const name = getString(\"name\");\n      if (!name) return null;\n      return { type: \"CUSTOM\", name, value: payload.value };\n    }\n    default:\n      return withOptional(\n        { type: \"RAW\" as const, event: payload },\n        {\n          source: isString(payload.type) ? (payload.type as string) : undefined,\n        },\n      );\n  }\n};\n"],"mappings":";;;AASA,MAAM,YAAY,UAAoC,OAAO,UAAU;AACvE,MAAM,oBAAoB,UACxB,SAAS,KAAK,KAAK,MAAM,SAAS;AAEpC,MAAM,gBACJ,MACA,cACG;CACH,MAAM,iBAAiB,OAAO,QAAQ,SAAS,CAAC,CAAC,QAC9C,GAAG,WAAW,UAAU,KAAA,CAC3B;CACA,OAAO,eAAe,WAAW,IAC7B,OACC;EAAE,GAAG;EAAM,GAAG,OAAO,YAAY,cAAc;CAAE;AACxD;AAEA,MAAM,iBAAiB,UACrB,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAE9D,MAAM,kBAAkB,QAAuC;CAC7D,IAAI,CAAC,cAAc,GAAG,GAAG,OAAO;CAChC,MAAM,KAAK,IAAI;CACf,MAAM,SAAS,IAAI;CACnB,IAAI,OAAO,OAAO,YAAY,OAAO,WAAW,UAAU,OAAO;CACjE,MAAM,YAA2B;EAAE;EAAI;CAAO;CAC9C,IAAI,OAAO,IAAI,YAAY,UAAU,UAAU,UAAU,IAAI;CAC7D,IAAI,OAAO,IAAI,eAAe,UAAU,UAAU,aAAa,IAAI;CACnE,IAAI,OAAO,IAAI,cAAc,UAAU,UAAU,YAAY,IAAI;CACjE,IAAI,cAAc,IAAI,cAAc,GAClC,UAAU,iBAAiB,IAAI;CACjC,IAAI,cAAc,IAAI,QAAQ,GAAG,UAAU,WAAW,IAAI;CAO1D,OAAO,IAAI,kBAAkB,QAAQ,cAAc,IAAI,cAAc,IACjE,YACA,sBAAsB,WAAW,IAAI,cAAc;AACzD;AAEA,MAAM,2BACJ,KACA,WACuC;CACvC,IAAI,CAAC,cAAc,GAAG,GAAG,OAAO,KAAA;CAChC,IAAI,IAAI,SAAS,WAAW,OAAO,EAAE,MAAM,UAAU;CACrD,IAAI,IAAI,SAAS,aAAa;EAC5B,IAAI,CAAC,MAAM,QAAQ,IAAI,UAAU,GAAG;GAClC,QAAQ,QACN,kEACA,GACF;GACA;EACF;EACA,MAAM,SAAS,IAAI,WAChB,KAAK,UAAU,eAAe,KAAK,CAAC,CAAC,CACrC,QAAQ,UAAkC,UAAU,IAAI;EAC3D,IAAI,OAAO,WAAW,GAAG;GACvB,QAAQ,QACN,iEACA,IAAI,UACN;GACA;EACF;EACA,OAAO;GAAE,MAAM;GAAa,YAAY;EAAO;CACjD;AAEF;AAEA,MAAa,kBACX,OACA,YACqB;CACrB,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU,OAAO;CAChD,MAAM,UAAU;CAChB,MAAM,YAAY,QAAQ;CAC1B,IAAI,CAAC,SAAS,SAAS,GAAG,OAAO;CAEjC,MAAM,aAAa,QACjB,SAAS,QAAQ,IAAI,IAAK,QAAQ,OAAkB,KAAA;CAEtD,QAAQ,WAAR;EACE,KAAK,eAAe;GAClB,MAAM,QAAQ,UAAU,OAAO;GAC/B,OAAO,QAAQ;IAAE,MAAM;IAAe;GAAM,IAAI;EAClD;EACA,KAAK,gBAAgB;GACnB,MAAM,QAAQ,UAAU,OAAO;GAC/B,IAAI,CAAC,OAAO,OAAO;GACnB,OAAO,aACL;IAAE,MAAM;IAAyB;GAAM,GACvC,EACE,SAAS,wBAAwB,QAAQ,SAAS,SAAS,MAAM,EACnE,CACF;EACF;EACA,KAAK,iBAAiB;GACpB,MAAM,QAAQ,UAAU,OAAO;GAC/B,OAAO,aAAa,EAAE,MAAM,gBAAyB,GAAG,EAAE,MAAM,CAAC;EACnE;EACA,KAAK,aACH,OAAO,aACL,EAAE,MAAM,YAAqB,GAC7B;GACE,SAAS,UAAU,SAAS;GAC5B,MAAM,UAAU,MAAM;EACxB,CACF;EAEF,KAAK,sBACH,OAAO,aACL,EAAE,MAAM,qBAA8B,GACtC,EAAE,WAAW,UAAU,WAAW,EAAE,CACtC;EACF,KAAK,wBAAwB;GAC3B,MAAM,QAAQ,UAAU,OAAO;GAC/B,IAAI,CAAC,iBAAiB,KAAK,GAAG,OAAO;GACrC,OAAO,aACL;IAAE,MAAM;IAAiC;GAAM,GAC/C,EAAE,WAAW,UAAU,WAAW,EAAE,CACtC;EACF;EACA,KAAK,oBACH,OAAO,aACL,EAAE,MAAM,mBAA4B,GACpC,EAAE,WAAW,UAAU,WAAW,EAAE,CACtC;EACF,KAAK,sBAAsB;GACzB,MAAM,QAAQ,UAAU,OAAO,KAAK;GACpC,OAAO,aACL;IAAE,MAAM;IAA+B;GAAM,GAC7C,EAAE,WAAW,UAAU,WAAW,EAAE,CACtC;EACF;EACA,KAAK,kBACH,OAAO,aACL,EAAE,MAAM,iBAA0B,GAClC,EAAE,OAAO,UAAU,OAAO,EAAE,CAC9B;EACF,KAAK,+BACH,OAAO,EAAE,MAAM,8BAA8B;EAC/C,KAAK,iCAEH,OAAO;GAAE,MAAM;GAAiC,OADlC,UAAU,OAAO,KAAK;EACkB;EAExD,KAAK,6BACH,OAAO,EAAE,MAAM,4BAA4B;EAC7C,KAAK,gBACH,OAAO,EAAE,MAAM,eAAe;EAChC,KAAK,mBACH,OAAO,aACL,EAAE,MAAM,kBAA2B,GACnC,EAAE,WAAW,UAAU,WAAW,EAAE,CACtC;EACF,KAAK,2BACH,OAAO,aACL,EAAE,MAAM,0BAAmC,GAC3C,EAAE,WAAW,UAAU,WAAW,EAAE,CACtC;EACF,KAAK,6BAA6B;GAChC,MAAM,QAAQ,UAAU,OAAO,KAAK;GACpC,OAAO,aACL;IAAE,MAAM;IAAsC;GAAM,GACpD,EAAE,WAAW,UAAU,WAAW,EAAE,CACtC;EACF;EACA,KAAK,yBACH,OAAO,aACL,EAAE,MAAM,wBAAiC,GACzC,EAAE,WAAW,UAAU,WAAW,EAAE,CACtC;EACF,KAAK,6BAA6B;GAChC,MAAM,WAAW,UAAU,UAAU;GACrC,MAAM,iBAAiB,UAAU,gBAAgB;GACjD,MAAM,UAAU,UAAU,SAAS;GACnC,IAAI,CAAC,YAAY,CAAC,gBAAgB,OAAO;GACzC,IAAI,YAAY,aAAa,YAAY,aAAa,OAAO;GAC7D,OAAO;IACL,MAAM;IACN;IACA;IACA;GACF;EACF;EACA,KAAK,iBACH,OAAO,aACL,EAAE,MAAM,gBAAyB,GACjC,EAAE,WAAW,UAAU,WAAW,EAAE,CACtC;EACF,KAAK,mBAAmB;GACtB,MAAM,aAAa,UAAU,YAAY;GACzC,IAAI,CAAC,YAAY,OAAO;GACxB,OAAO,aACL;IAAE,MAAM;IAA4B;GAAW,GAC/C;IACE,cAAc,UAAU,cAAc;IACtC,iBAAiB,UAAU,iBAAiB;GAC9C,CACF;EACF;EACA,KAAK,kBAAkB;GACrB,MAAM,aAAa,UAAU,YAAY;GACzC,IAAI,CAAC,YAAY,OAAO;GAExB,OAAO;IAAE,MAAM;IAAkB;IAAY,OAD/B,UAAU,OAAO,KAAK;GACe;EACrD;EACA,KAAK,iBAAiB;GACpB,MAAM,aAAa,UAAU,YAAY;GACzC,OAAO,aAAa;IAAE,MAAM;IAAiB;GAAW,IAAI;EAC9D;EACA,KAAK,mBACH,OAAO,aACL,EAAE,MAAM,kBAA2B,GACnC;GACE,YAAY,UAAU,YAAY;GAClC,cAAc,UAAU,cAAc;GACtC,iBAAiB,UAAU,iBAAiB;GAC5C,OAAO,UAAU,OAAO;EAC1B,CACF;EACF,KAAK,oBAAoB;GACvB,MAAM,aAAa,UAAU,YAAY;GACzC,IAAI,CAAC,YAAY,OAAO;GACxB,MAAM,UAAU,UAAU,SAAS,KAAK;GACxC,OAAO,aACL;IACE,MAAM;IACN;IACA;GACF,GACA;IACE,WAAW,UAAU,WAAW;IAChC,MAAM,QAAQ,SAAS,SAAS,SAAS,KAAA;IACzC,WAAW,uBAAuB,SAAS,OAAO;GACpD,CACF;EACF;EACA,KAAK,kBACH,OAAO;GAAE,MAAM;GAAkB,UAAU,QAAQ;EAAS;EAC9D,KAAK,eACH,OAAO;GACL,MAAM;GACN,OAAO,MAAM,QAAQ,QAAQ,KAAK,IAAK,QAAQ,QAAkB,CAAC;EACpE;EACF,KAAK,qBACH,OAAO;GACL,MAAM;GACN,UAAU,MAAM,QAAQ,QAAQ,QAAQ,IACnC,QAAQ,WACT,CAAC;EACP;EACF,KAAK,qBAAqB;GACxB,MAAM,eAAe,UAAU,cAAc;GAC7C,IAAI,CAAC,gBAAgB,CAAC,cAAc,QAAQ,OAAO,GAAG,OAAO;GAC7D,OAAO,aACL;IACE,MAAM;IACN;IACA,SAAS,QAAQ;GACnB,GACA;IACE,WAAW,UAAU,WAAW;IAChC,SACE,OAAO,QAAQ,YAAY,YAAY,QAAQ,UAAU,KAAA;GAC7D,CACF;EACF;EACA,KAAK,OACH,OAAO,aACL;GAAE,MAAM;GAAgB,OAAO,QAAQ;EAAM,GAC7C,EAAE,QAAQ,UAAU,QAAQ,EAAE,CAChC;EACF,KAAK,UAAU;GACb,MAAM,OAAO,UAAU,MAAM;GAC7B,IAAI,CAAC,MAAM,OAAO;GAClB,OAAO;IAAE,MAAM;IAAU;IAAM,OAAO,QAAQ;GAAM;EACtD;EACA,SACE,OAAO,aACL;GAAE,MAAM;GAAgB,OAAO;EAAQ,GACvC,EACE,QAAQ,SAAS,QAAQ,IAAI,IAAK,QAAQ,OAAkB,KAAA,EAC9D,CACF;CACJ;AACF"}
+{"version":3,"file":"event-parser.js","names":[],"sources":["../../src/runtime/event-parser.ts"],"sourcesContent":["import type {\n  AgUiEvent,\n  AgUiInterrupt,\n  AgUiRunFinishedOutcome,\n  AgUiSubagentFinishedOutcome,\n} from \"./types\";\nimport type { Logger } from \"./logger\";\nimport { parseMcpToolCallResult } from \"./mcp-tool-result\";\nimport { withRawResponseSchema } from \"./interrupt-internals\";\n\nexport type ParseAgUiEventOptions = {\n  logger?: Logger;\n};\n\nconst isString = (value: unknown): value is string => typeof value === \"string\";\nconst isNonEmptyString = (value: unknown): value is string =>\n  isString(value) && value.length > 0;\n\nconst withOptional = <T extends object>(\n  base: T,\n  optionals: Record<string, unknown>,\n) => {\n  const definedEntries = Object.entries(optionals).filter(\n    ([, value]) => value !== undefined,\n  );\n  return definedEntries.length === 0\n    ? base\n    : ({ ...base, ...Object.fromEntries(definedEntries) } as T);\n};\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\nconst logRejectedEvent = (\n  logger: Logger | undefined,\n  type: unknown,\n  payload: unknown,\n  reason: string,\n) => {\n  const typeLabel = isString(type) ? type : \"unknown\";\n  logger?.debug?.(`[agui] ${typeLabel} ${reason}`, payload);\n};\n\nconst parseInterrupt = (raw: unknown): AgUiInterrupt | null => {\n  if (!isPlainObject(raw)) return null;\n  const id = raw.id;\n  const reason = raw.reason;\n  if (typeof id !== \"string\" || typeof reason !== \"string\") return null;\n  const interrupt: AgUiInterrupt = { id, reason };\n  if (typeof raw.message === \"string\") interrupt.message = raw.message;\n  if (typeof raw.toolCallId === \"string\") interrupt.toolCallId = raw.toolCallId;\n  if (typeof raw.expiresAt === \"string\") interrupt.expiresAt = raw.expiresAt;\n  if (isPlainObject(raw.responseSchema))\n    interrupt.responseSchema = raw.responseSchema;\n  if (isPlainObject(raw.metadata)) interrupt.metadata = raw.metadata;\n  // A present schema is kept whatever its shape: `false` is a JSON Schema that\n  // rejects every payload, so normalizing it to absent would claim a gate no\n  // decision can answer. Only an object schema fits `responseSchema`; every\n  // other shape travels on the internal carrier. `null` is not a JSON Schema at\n  // all, and it is what a server serializing an unset optional field sends, so\n  // it reads as absent rather than as a schema nothing can satisfy.\n  return raw.responseSchema == null || isPlainObject(raw.responseSchema)\n    ? interrupt\n    : withRawResponseSchema(interrupt, raw.responseSchema);\n};\n\nconst parseRunFinishedOutcome = (\n  raw: unknown,\n  runId: string,\n  logger: Logger | undefined,\n): AgUiRunFinishedOutcome | undefined => {\n  if (raw == null) return undefined;\n  if (!isPlainObject(raw)) {\n    logRejectedEvent(\n      logger,\n      \"RUN_FINISHED\",\n      { runId, outcome: raw },\n      \"has invalid outcome\",\n    );\n    return undefined;\n  }\n  if (raw.type === \"success\") return { type: \"success\" };\n  if (raw.type === \"interrupt\") {\n    if (!Array.isArray(raw.interrupts)) {\n      logRejectedEvent(\n        logger,\n        \"RUN_FINISHED\",\n        { runId, outcome: raw },\n        \"has an interrupt outcome missing interrupts array\",\n      );\n      return undefined;\n    }\n    const parsed = raw.interrupts\n      .map((entry) => {\n        const interrupt = parseInterrupt(entry);\n        if (interrupt === null) {\n          logRejectedEvent(\n            logger,\n            \"RUN_FINISHED\",\n            { runId, interrupt: entry },\n            \"has malformed interrupt\",\n          );\n        }\n        return interrupt;\n      })\n      .filter((entry): entry is AgUiInterrupt => entry !== null);\n    if (parsed.length === 0) {\n      logRejectedEvent(\n        logger,\n        \"RUN_FINISHED\",\n        { runId, interrupts: raw.interrupts },\n        \"has an interrupt outcome with no valid interrupts\",\n      );\n      return undefined;\n    }\n    return { type: \"interrupt\", interrupts: parsed };\n  }\n  logRejectedEvent(\n    logger,\n    \"RUN_FINISHED\",\n    { runId, outcome: raw },\n    \"has unsupported outcome type\",\n  );\n  return undefined;\n};\n\nexport const parseAgUiEvent = (\n  event: unknown,\n  options?: ParseAgUiEventOptions,\n): AgUiEvent | null => {\n  if (!event || typeof event !== \"object\") {\n    logRejectedEvent(options?.logger, undefined, event, \"is not an object\");\n    return null;\n  }\n  const payload = event as Record<string, unknown>;\n  const typeValue = payload.type;\n  if (!isString(typeValue)) {\n    logRejectedEvent(options?.logger, typeValue, payload, \"has no string type\");\n    return null;\n  }\n\n  const reject = (reason: string): null => {\n    logRejectedEvent(options?.logger, typeValue, payload, reason);\n    return null;\n  };\n\n  const getString = (key: string) =>\n    isString(payload[key]) ? (payload[key] as string) : undefined;\n\n  switch (typeValue) {\n    case \"RUN_STARTED\": {\n      const runId = getString(\"runId\");\n      return runId ? { type: \"RUN_STARTED\", runId } : reject(\"missing runId\");\n    }\n    case \"RUN_FINISHED\": {\n      const runId = getString(\"runId\");\n      if (!runId) return reject(\"missing runId\");\n      return withOptional(\n        { type: \"RUN_FINISHED\" as const, runId },\n        {\n          outcome: parseRunFinishedOutcome(\n            payload.outcome,\n            runId,\n            options?.logger,\n          ),\n        },\n      );\n    }\n    case \"RUN_CANCELLED\": {\n      const runId = getString(\"runId\");\n      return withOptional({ type: \"RUN_CANCELLED\" as const }, { runId });\n    }\n    case \"RUN_ERROR\": {\n      return withOptional(\n        { type: \"RUN_ERROR\" as const },\n        {\n          message: getString(\"message\"),\n          code: getString(\"code\"),\n        },\n      );\n    }\n    case \"TEXT_MESSAGE_START\":\n      return withOptional(\n        { type: \"TEXT_MESSAGE_START\" as const },\n        {\n          messageId: getString(\"messageId\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    case \"TEXT_MESSAGE_CONTENT\": {\n      const delta = getString(\"delta\");\n      if (!isNonEmptyString(delta)) return reject(\"missing non-empty delta\");\n      return withOptional(\n        { type: \"TEXT_MESSAGE_CONTENT\" as const, delta },\n        {\n          messageId: getString(\"messageId\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    }\n    case \"TEXT_MESSAGE_END\":\n      return withOptional(\n        { type: \"TEXT_MESSAGE_END\" as const },\n        {\n          messageId: getString(\"messageId\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    case \"TEXT_MESSAGE_CHUNK\": {\n      const delta = getString(\"delta\") ?? \"\";\n      return withOptional(\n        { type: \"TEXT_MESSAGE_CHUNK\" as const, delta },\n        {\n          messageId: getString(\"messageId\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    }\n    case \"THINKING_START\":\n      return withOptional(\n        { type: \"THINKING_START\" as const },\n        { title: getString(\"title\") },\n      );\n    case \"THINKING_TEXT_MESSAGE_START\":\n      return { type: \"THINKING_TEXT_MESSAGE_START\" };\n    case \"THINKING_TEXT_MESSAGE_CONTENT\": {\n      const delta = getString(\"delta\") ?? \"\";\n      return { type: \"THINKING_TEXT_MESSAGE_CONTENT\", delta };\n    }\n    case \"THINKING_TEXT_MESSAGE_END\":\n      return { type: \"THINKING_TEXT_MESSAGE_END\" };\n    case \"THINKING_END\":\n      return { type: \"THINKING_END\" };\n    case \"REASONING_START\":\n      return withOptional(\n        { type: \"REASONING_START\" as const },\n        {\n          messageId: getString(\"messageId\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    case \"REASONING_MESSAGE_START\":\n      return withOptional(\n        { type: \"REASONING_MESSAGE_START\" as const },\n        {\n          messageId: getString(\"messageId\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    case \"REASONING_MESSAGE_CONTENT\": {\n      const delta = getString(\"delta\") ?? \"\";\n      return withOptional(\n        { type: \"REASONING_MESSAGE_CONTENT\" as const, delta },\n        {\n          messageId: getString(\"messageId\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    }\n    case \"REASONING_MESSAGE_END\":\n      return withOptional(\n        { type: \"REASONING_MESSAGE_END\" as const },\n        {\n          messageId: getString(\"messageId\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    case \"REASONING_ENCRYPTED_VALUE\": {\n      const entityId = getString(\"entityId\");\n      const encryptedValue = getString(\"encryptedValue\");\n      const subtype = getString(\"subtype\");\n      if (!entityId || !encryptedValue) {\n        return reject(\"missing entityId or encryptedValue\");\n      }\n      if (subtype !== \"message\" && subtype !== \"tool-call\") {\n        return reject(\"has an invalid subtype\");\n      }\n      // Spread rather than withOptional: routing the narrowed `subtype` through\n      // a generic helper widens it back to string.\n      const subagentRunId = getString(\"subagentRunId\");\n      return {\n        type: \"REASONING_ENCRYPTED_VALUE\" as const,\n        subtype,\n        entityId,\n        encryptedValue,\n        ...(subagentRunId !== undefined ? { subagentRunId } : {}),\n      };\n    }\n    case \"REASONING_END\":\n      return withOptional(\n        { type: \"REASONING_END\" as const },\n        {\n          messageId: getString(\"messageId\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    case \"TOOL_CALL_START\": {\n      const toolCallId = getString(\"toolCallId\");\n      if (!toolCallId) return reject(\"missing toolCallId\");\n      return withOptional(\n        { type: \"TOOL_CALL_START\" as const, toolCallId },\n        {\n          toolCallName: getString(\"toolCallName\"),\n          parentMessageId: getString(\"parentMessageId\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    }\n    case \"TOOL_CALL_ARGS\": {\n      const toolCallId = getString(\"toolCallId\");\n      if (!toolCallId) return reject(\"missing toolCallId\");\n      const delta = getString(\"delta\") ?? \"\";\n      return withOptional(\n        { type: \"TOOL_CALL_ARGS\" as const, toolCallId, delta },\n        { subagentRunId: getString(\"subagentRunId\") },\n      );\n    }\n    case \"TOOL_CALL_END\": {\n      const toolCallId = getString(\"toolCallId\");\n      if (!toolCallId) return reject(\"missing toolCallId\");\n      return withOptional(\n        { type: \"TOOL_CALL_END\" as const, toolCallId },\n        { subagentRunId: getString(\"subagentRunId\") },\n      );\n    }\n    case \"TOOL_CALL_CHUNK\":\n      return withOptional(\n        { type: \"TOOL_CALL_CHUNK\" as const },\n        {\n          toolCallId: getString(\"toolCallId\"),\n          toolCallName: getString(\"toolCallName\"),\n          parentMessageId: getString(\"parentMessageId\"),\n          delta: getString(\"delta\"),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    case \"TOOL_CALL_RESULT\": {\n      const toolCallId = getString(\"toolCallId\");\n      if (!toolCallId) return reject(\"missing toolCallId\");\n      const content = getString(\"content\") ?? \"\";\n      return withOptional(\n        {\n          type: \"TOOL_CALL_RESULT\" as const,\n          toolCallId,\n          content,\n        },\n        {\n          messageId: getString(\"messageId\"),\n          role: payload.role === \"tool\" ? \"tool\" : undefined,\n          mcpResult: parseMcpToolCallResult(payload, content),\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    }\n    case \"STATE_SNAPSHOT\":\n      if (payload.snapshot === undefined) {\n        return reject(\"missing snapshot\");\n      }\n      return { type: \"STATE_SNAPSHOT\", snapshot: payload.snapshot };\n    case \"STATE_DELTA\":\n      return {\n        type: \"STATE_DELTA\",\n        delta: Array.isArray(payload.delta) ? (payload.delta as any[]) : [],\n      };\n    case \"MESSAGES_SNAPSHOT\":\n      if (!Array.isArray(payload.messages)) {\n        return reject(\"missing messages array\");\n      }\n      return {\n        type: \"MESSAGES_SNAPSHOT\",\n        messages: payload.messages as any[],\n      };\n    case \"ACTIVITY_SNAPSHOT\": {\n      const activityType = getString(\"activityType\");\n      if (!activityType || !isPlainObject(payload.content)) {\n        return reject(\"missing activityType or object content\");\n      }\n      return withOptional(\n        {\n          type: \"ACTIVITY_SNAPSHOT\" as const,\n          activityType,\n          content: payload.content,\n        },\n        {\n          messageId: getString(\"messageId\"),\n          replace:\n            typeof payload.replace === \"boolean\" ? payload.replace : undefined,\n          subagentRunId: getString(\"subagentRunId\"),\n        },\n      );\n    }\n    case \"RAW\":\n      return withOptional(\n        { type: \"RAW\" as const, event: payload.event },\n        { source: getString(\"source\") },\n      );\n    case \"CUSTOM\": {\n      const name = getString(\"name\");\n      if (!name) return reject(\"missing name\");\n      return { type: \"CUSTOM\", name, value: payload.value };\n    }\n    case \"SUBAGENT_STARTED\": {\n      const subagentRunId = getString(\"subagentRunId\");\n      const name = getString(\"name\");\n      if (!subagentRunId || !name) {\n        return reject(\"missing subagentRunId or name\");\n      }\n      return withOptional(\n        { type: \"SUBAGENT_STARTED\" as const, subagentRunId, name },\n        {\n          description: getString(\"description\"),\n          parentSubagentRunId: getString(\"parentSubagentRunId\"),\n          parentToolCallId: getString(\"parentToolCallId\"),\n          parentMessageId: getString(\"parentMessageId\"),\n        },\n      );\n    }\n    case \"SUBAGENT_FINISHED\": {\n      const subagentRunId = getString(\"subagentRunId\");\n      if (!subagentRunId) return reject(\"missing subagentRunId\");\n      const rawOutcome = payload.outcome;\n      let outcome: AgUiSubagentFinishedOutcome | undefined;\n      if (rawOutcome == null) {\n        outcome = undefined;\n      } else if (!isPlainObject(rawOutcome)) {\n        logRejectedEvent(\n          options?.logger,\n          \"SUBAGENT_FINISHED\",\n          { subagentRunId, outcome: rawOutcome },\n          \"has invalid outcome\",\n        );\n        outcome = undefined;\n      } else if (rawOutcome.type === \"success\") {\n        outcome = { type: \"success\" as const };\n      } else if (rawOutcome.type === \"suspended\") {\n        outcome = withOptional(\n          { type: \"suspended\" as const },\n          {\n            interruptIds: Array.isArray(rawOutcome.interruptIds)\n              ? (rawOutcome.interruptIds as unknown[]).filter(isString)\n              : undefined,\n          },\n        );\n      } else {\n        logRejectedEvent(\n          options?.logger,\n          \"SUBAGENT_FINISHED\",\n          { subagentRunId, outcome: rawOutcome },\n          \"has unsupported outcome type\",\n        );\n        outcome = undefined;\n      }\n      return withOptional(\n        { type: \"SUBAGENT_FINISHED\" as const, subagentRunId },\n        { result: payload.result, outcome },\n      );\n    }\n    case \"SUBAGENT_ERROR\": {\n      const subagentRunId = getString(\"subagentRunId\");\n      const message = getString(\"message\");\n      if (!subagentRunId || !message) {\n        return reject(\"missing subagentRunId or message\");\n      }\n      return withOptional(\n        { type: \"SUBAGENT_ERROR\" as const, subagentRunId, message },\n        { code: getString(\"code\") },\n      );\n    }\n    default:\n      return withOptional(\n        { type: \"RAW\" as const, event: payload },\n        {\n          source: isString(payload.type) ? (payload.type as string) : undefined,\n        },\n      );\n  }\n};\n"],"mappings":"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"}

package/dist/runtime/types.d.ts

@@ -35,10 +35,35 @@ type UseAgUiRuntimeAdapters = {
    */
   threadList?: UseAgUiThreadListAdapter;
 };
+type AgUiResumeTranscript = "full" | "appended";
 type UseAgUiRuntimeOptions = ExternalStoreSharedOptions & {
   agent: AbstractAgent;
   logger?: Partial<Logger>;
   showThinking?: boolean;
+  /**
+   * What `messages` carries on a resume run, meaning a `RunAgentInput` that
+   * also carries `resume`. The AG-UI interrupt spec leaves this undefined: its
+   * contract rules constrain the thread id, interrupt coverage, idempotency,
+   * and expiry, and none of them mentions `messages`. Hosts therefore disagree,
+   * and both readings are conformant.
+   *
+   * `"full"` sends the whole thread, which is what `@ag-ui/client` itself does.
+   * Hosts that resume from a checkpoint ignore the transcript, and hosts that
+   * rebuild the interrupted run from it need it.
+   *
+   * `"appended"` sends only what was appended locally after the interrupted
+   * assistant message, which is nothing for an approval or a denial and the new
+   * user turn for `steerAway`. Choose it for a host that owns the thread and
+   * seeds a resume request from its own stored snapshot, because such a host
+   * appends the request body to that snapshot and a re-sent transcript
+   * duplicates the interrupted turn in its stored history. A host that rebuilds
+   * the run from `messages` has nothing to resume from under `"appended"`, and
+   * a host that derives its outgoing `MESSAGES_SNAPSHOT` from the request body
+   * emits a truncated one.
+   *
+   * Defaults to `"full"`.
+   */
+  resumeTranscript?: AgUiResumeTranscript | undefined;
   /**
    * When the user sends, edits, or reloads a message while client-side tool
    * calls are still pending, automatically cancel the unresolved tool calls
@@ -90,6 +115,12 @@ type AgUiRunFinishedOutcome = {
   type: "interrupt";
   interrupts: AgUiInterrupt[];
 };
+type AgUiSubagentFinishedOutcome = {
+  type: "success";
+} | {
+  type: "suspended";
+  interruptIds?: string[];
+};
 type AgUiEvent = {
   type: "RUN_STARTED";
   runId: string;
@@ -107,16 +138,21 @@ type AgUiEvent = {
 } | {
   type: "TEXT_MESSAGE_START";
   messageId?: string;
+  subagentRunId?: string;
 } | {
   type: "TEXT_MESSAGE_CONTENT";
   messageId?: string;
   delta: string;
+  subagentRunId?: string;
 } | {
   type: "TEXT_MESSAGE_END";
   messageId?: string;
+  subagentRunId?: string;
 } | {
   type: "TEXT_MESSAGE_CHUNK";
+  messageId?: string;
   delta: string;
+  subagentRunId?: string;
 } | {
   type: "THINKING_START";
   title?: string;
@@ -132,42 +168,52 @@ type AgUiEvent = {
 } | {
   type: "REASONING_START";
   messageId?: string;
+  subagentRunId?: string;
 } | {
   type: "REASONING_MESSAGE_START";
   messageId?: string;
+  subagentRunId?: string;
 } | {
   type: "REASONING_MESSAGE_CONTENT";
   messageId?: string;
   delta: string;
+  subagentRunId?: string;
 } | {
   type: "REASONING_MESSAGE_END";
   messageId?: string;
+  subagentRunId?: string;
 } | {
   type: "REASONING_ENCRYPTED_VALUE";
   subtype: "message" | "tool-call";
   entityId: string;
   encryptedValue: string;
+  subagentRunId?: string;
 } | {
   type: "REASONING_END";
   messageId?: string;
+  subagentRunId?: string;
 } | {
   type: "TOOL_CALL_START";
   toolCallId: string;
   toolCallName?: string;
   parentMessageId?: string;
+  subagentRunId?: string;
 } | {
   type: "TOOL_CALL_ARGS";
   toolCallId: string;
   delta: string;
+  subagentRunId?: string;
 } | {
   type: "TOOL_CALL_END";
   toolCallId: string;
+  subagentRunId?: string;
 } | {
   type: "TOOL_CALL_CHUNK";
   toolCallId?: string;
   toolCallName?: string;
   parentMessageId?: string;
   delta?: string;
+  subagentRunId?: string;
 } | {
   type: "TOOL_CALL_RESULT";
   messageId?: string;
@@ -175,12 +221,14 @@ type AgUiEvent = {
   content: string;
   role?: "tool";
   mcpResult?: McpToolCallResult;
+  subagentRunId?: string;
 } | {
   type: "ACTIVITY_SNAPSHOT";
   activityType: string;
   content: Record<string, unknown>;
   messageId?: string;
   replace?: boolean;
+  subagentRunId?: string;
 } | {
   type: "RAW";
   event: any;
@@ -198,7 +246,25 @@ type AgUiEvent = {
 } | {
   type: "MESSAGES_SNAPSHOT";
   messages: any[];
+} | {
+  type: "SUBAGENT_STARTED";
+  subagentRunId: string;
+  name: string;
+  description?: string;
+  parentSubagentRunId?: string;
+  parentToolCallId?: string;
+  parentMessageId?: string;
+} | {
+  type: "SUBAGENT_FINISHED";
+  subagentRunId: string;
+  result?: unknown;
+  outcome?: AgUiSubagentFinishedOutcome;
+} | {
+  type: "SUBAGENT_ERROR";
+  subagentRunId: string;
+  message: string;
+  code?: string;
 };
 //#endregion
-export { AgUiEvent, AgUiInterrupt, AgUiInterruptReason, AgUiResumeEntry, AgUiRunFinishedOutcome, AgUiRuntimeExtras, UseAgUiRuntimeAdapters, UseAgUiRuntimeOptions, UseAgUiThreadListAdapter };
+export { AgUiEvent, AgUiInterrupt, AgUiInterruptReason, AgUiResumeEntry, AgUiResumeTranscript, AgUiRunFinishedOutcome, AgUiRuntimeExtras, AgUiSubagentFinishedOutcome, UseAgUiRuntimeAdapters, UseAgUiRuntimeOptions, UseAgUiThreadListAdapter };
 //# sourceMappingURL=types.d.ts.map

package/dist/runtime/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/runtime/types.ts"],"mappings":";;;;;;;;;;;;KAuBK;EACH,mBAAmB;EACnB,QAAQ;;;;;;EAMR;;KAGU,2BAA2B,KACrC;EAGA,qBAEM,qBACG,QAAQ,wBAAwB;;KAI/B;EACV,cAAc;EACd,SAAS;EACT,YAAY;EACZ,QAAQ;EACR,WAAW;EACX,UAAU;;;;EAIV,aAAa;;KAGH,wBAAwB;EAClC,OAAO;EACP,SAAS,QAAQ;EACjB;;;;;;;;;;;EAWA;;;;;;;EAOA;EACA,WAAW,GAAG;EACd;EACA,WAAW;;KAGD;KAMA;EACV;EACA,QAAQ;EACR;EACA;EACA,iBAAiB;EACjB;EACA,WAAW;;KAGD;EACV;EACA;EACA;;KAGU;EACV,qBAAqB;EACrB,iBAAiB,QAAQ;EACzB,2BACE,oBAAoB,sBACjB;EACL,YACE,SAAS,qBACT,qBAAqB,sBAClB;EACL,OAAO;EACP,WACE,MACI,sBACE,MAAM,kCAAkC;;KAItC;EACN;;EACA;EAAmB,YAAY;;KAEzB;EACN;EAAqB;;EAErB;EACA;EACA,UAAU;;EAEV;EAAuB;;EACvB;EAAmB;EAAkB;;EACrC;EAA4B;;EAC5B;EAA8B;EAAoB;;EAClD;EAA0B;;EAC1B;EAA4B;;EAC5B;EAAwB;;EACxB;;EACA;EAAuC;;EACvC;;EACA;;EACA;EAAyB;;EACzB;EAAiC;;EACjC;EAAmC;EAAoB;;EACvD;EAA+B;;EAE/B;EACA;EACA;EACA;;EAEA;EAAuB;;EAEvB;EACA;EACA;EACA;;EAEA;EAAwB;EAAoB;;EAC5C;EAAuB;;EAEvB;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;EACA,YAAY;;EAGZ;EACA;EACA,SAAS;EACT;EACA;;EAEA;EAAa;EAAY;;EACzB;EAAgB;EAAc;;EAC9B;EAAwB;;EACxB;EAAqB;;EACrB;EAA2B"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/runtime/types.ts"],"mappings":";;;;;;;;;;;;KAuBK;EACH,mBAAmB;EACnB,QAAQ;;;;;;EAMR;;KAGU,2BAA2B,KACrC;EAGA,qBAEM,qBACG,QAAQ,wBAAwB;;KAI/B;EACV,cAAc;EACd,SAAS;EACT,YAAY;EACZ,QAAQ;EACR,WAAW;EACX,UAAU;;;;EAIV,aAAa;;KAGH;KAEA,wBAAwB;EAClC,OAAO;EACP,SAAS,QAAQ;EACjB;;;;;;;;;;;;;;;;;;;;;;;;EAwBA,mBAAmB;;;;;;;;;;;EAWnB;;;;;;;EAOA;EACA,WAAW,GAAG;EACd;EACA,WAAW;;KAGD;KAMA;EACV;EACA,QAAQ;EACR;EACA;EACA,iBAAiB;EACjB;EACA,WAAW;;KAGD;EACV;EACA;EACA;;KAGU;EACV,qBAAqB;EACrB,iBAAiB,QAAQ;EACzB,2BACE,oBAAoB,sBACjB;EACL,YACE,SAAS,qBACT,qBAAqB,sBAClB;EACL,OAAO;EACP,WACE,MACI,sBACE,MAAM,kCAAkC;;KAItC;EACN;;EACA;EAAmB,YAAY;;KAEzB;EACN;;EACA;EAAmB;;KAEb;EACN;EAAqB;;EAErB;EACA;EACA,UAAU;;EAEV;EAAuB;;EACvB;EAAmB;EAAkB;;EACrC;EAA4B;EAAoB;;EAEhD;EACA;EACA;EACA;;EAEA;EAA0B;EAAoB;;EAE9C;EACA;EACA;EACA;;EAEA;EAAwB;;EACxB;;EACA;EAAuC;;EACvC;;EACA;;EACA;EAAyB;EAAoB;;EAE7C;EACA;EACA;;EAGA;EACA;EACA;EACA;;EAGA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;;EAEA;EAAuB;EAAoB;;EAE3C;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;;EAEA;EAAuB;EAAoB;;EAE3C;EACA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;EACA,YAAY;EACZ;;EAGA;EACA;EACA,SAAS;EACT;EACA;EACA;;EAEA;EAAa;EAAY;;EACzB;EAAgB;EAAc;;EAC9B;EAAwB;;EACxB;EAAqB;;EACrB;EAA2B;;EAE3B;EACA;EACA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA,UAAU;;EAGV;EACA;EACA;EACA"}

package/dist/useAgUiRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAgUiRuntime.d.ts","names":[],"sources":["../src/useAgUiRuntime.ts"],"mappings":";;;KAyCY,uBAAuB;;;;;EAKjC,8CAA8C;;;;;;EAM9C,oCACE,oBAAoB,sBACjB;;iBAGS,eACd,SAAS,wBACR"}
+{"version":3,"file":"useAgUiRuntime.d.ts","names":[],"sources":["../src/useAgUiRuntime.ts"],"mappings":";;;KA0CY,uBAAuB;;;;;EAKjC,8CAA8C;;;;;;EAM9C,oCACE,oBAAoB,sBACjB;;iBAGS,eACd,SAAS,wBACR"}