@copilotkit/shared 1.73.0 → 1.73.2-canary.1790068297

package/README.md

@@ -198,3 +198,25 @@ request the optional metadata route when a runtime reports
 # Documentation
 
 To get started with CopilotKit, please check out the [documentation](https://docs.copilotkit.ai).
+
+## Event and attachment conversion
+
+`createAttachmentContent` from `@copilotkit/shared` builds the same AG-UI
+attachment content part used by the React, Angular, and Vue chat components.
+It preserves the source and merges the filename into metadata, with explicit
+metadata taking precedence.
+
+The Node-only `@copilotkit/shared/event-transforms` entry exports
+`OpenGenerativeUIMiddleware`, the existing upstream `A2UIMiddleware`, and
+`transformRecordedEvents(input, events, options)`. The latter applies the same
+converters to one recorded, pre-middleware AG-UI run without executing tools or
+contacting an agent. Enable converters explicitly with `openGenerativeUI: true`
+and/or `a2ui: { ...originalRuntimeOptions }`. Pass the recorded input, including
+prior messages and catalog context, to preserve live conversion behavior.
+
+The result includes the original events and generated activities in runtime
+order. The caller owns persistence IDs, historical timestamps, and provenance.
+A2UI can generate random message IDs for synthetic tool results; an importer
+that needs deterministic IDs must assign them before saving. Do not process
+already transformed histories a second time. This entry does not include MCP
+execution or recreate runtime configuration absent from the recording.

package/dist/attachments/content.cjs

@@ -0,0 +1,17 @@
+
+//#region src/attachments/content.ts
+/** Build the AG-UI content part used when sending a ready attachment. */
+function createAttachmentContent(attachment) {
+	return {
+		type: attachment.type,
+		source: attachment.source,
+		metadata: {
+			...attachment.filename ? { filename: attachment.filename } : {},
+			...attachment.metadata
+		}
+	};
+}
+
+//#endregion
+exports.createAttachmentContent = createAttachmentContent;
+//# sourceMappingURL=content.cjs.map

package/dist/attachments/content.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.cjs","names":[],"sources":["../../src/attachments/content.ts"],"sourcesContent":["import type { InputContent } from \"@ag-ui/core\";\nimport type { Attachment } from \"./types\";\n\n/** Build the AG-UI content part used when sending a ready attachment. */\nexport function createAttachmentContent(\n  attachment: Pick<Attachment, \"type\" | \"source\" | \"filename\" | \"metadata\">,\n): InputContent {\n  return {\n    type: attachment.type,\n    source: attachment.source,\n    metadata: {\n      ...(attachment.filename ? { filename: attachment.filename } : {}),\n      ...attachment.metadata,\n    },\n  };\n}\n"],"mappings":";;;AAIA,SAAgB,wBACd,YACc;AACd,QAAO;EACL,MAAM,WAAW;EACjB,QAAQ,WAAW;EACnB,UAAU;GACR,GAAI,WAAW,WAAW,EAAE,UAAU,WAAW,UAAU,GAAG,EAAE;GAChE,GAAG,WAAW;GACf;EACF"}

package/dist/attachments/content.d.cts

@@ -0,0 +1,9 @@
+import { Attachment } from "./types.cjs";
+import { InputContent } from "@ag-ui/core";
+
+//#region src/attachments/content.d.ts
+/** Build the AG-UI content part used when sending a ready attachment. */
+declare function createAttachmentContent(attachment: Pick<Attachment, "type" | "source" | "filename" | "metadata">): InputContent;
+//#endregion
+export { createAttachmentContent };
+//# sourceMappingURL=content.d.cts.map

package/dist/attachments/content.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.cts","names":[],"sources":["../../src/attachments/content.ts"],"mappings":";;;;;iBAIgB,uBAAA,CACd,UAAA,EAAY,IAAA,CAAK,UAAA,iDAChB,YAAA"}

package/dist/attachments/content.d.mts

@@ -0,0 +1,9 @@
+import { Attachment } from "./types.mjs";
+import { InputContent } from "@ag-ui/core";
+
+//#region src/attachments/content.d.ts
+/** Build the AG-UI content part used when sending a ready attachment. */
+declare function createAttachmentContent(attachment: Pick<Attachment, "type" | "source" | "filename" | "metadata">): InputContent;
+//#endregion
+export { createAttachmentContent };
+//# sourceMappingURL=content.d.mts.map

package/dist/attachments/content.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.mts","names":[],"sources":["../../src/attachments/content.ts"],"mappings":";;;;;iBAIgB,uBAAA,CACd,UAAA,EAAY,IAAA,CAAK,UAAA,iDAChB,YAAA"}

package/dist/attachments/content.mjs

@@ -0,0 +1,16 @@
+//#region src/attachments/content.ts
+/** Build the AG-UI content part used when sending a ready attachment. */
+function createAttachmentContent(attachment) {
+	return {
+		type: attachment.type,
+		source: attachment.source,
+		metadata: {
+			...attachment.filename ? { filename: attachment.filename } : {},
+			...attachment.metadata
+		}
+	};
+}
+
+//#endregion
+export { createAttachmentContent };
+//# sourceMappingURL=content.mjs.map

package/dist/attachments/content.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.mjs","names":[],"sources":["../../src/attachments/content.ts"],"sourcesContent":["import type { InputContent } from \"@ag-ui/core\";\nimport type { Attachment } from \"./types\";\n\n/** Build the AG-UI content part used when sending a ready attachment. */\nexport function createAttachmentContent(\n  attachment: Pick<Attachment, \"type\" | \"source\" | \"filename\" | \"metadata\">,\n): InputContent {\n  return {\n    type: attachment.type,\n    source: attachment.source,\n    metadata: {\n      ...(attachment.filename ? { filename: attachment.filename } : {}),\n      ...attachment.metadata,\n    },\n  };\n}\n"],"mappings":";;AAIA,SAAgB,wBACd,YACc;AACd,QAAO;EACL,MAAM,WAAW;EACjB,QAAQ,WAAW;EACnB,UAAU;GACR,GAAI,WAAW,WAAW,EAAE,UAAU,WAAW,UAAU,GAAG,EAAE;GAChE,GAAG,WAAW;GACf;EACF"}

package/dist/event-transforms/index.cjs

@@ -0,0 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_open_generative_ui_middleware = require('./open-generative-ui-middleware.cjs');
+const require_recorded_events = require('./recorded-events.cjs');
+let _ag_ui_a2ui_middleware = require("@ag-ui/a2ui-middleware");
+
+Object.defineProperty(exports, 'A2UIMiddleware', {
+  enumerable: true,
+  get: function () {
+    return _ag_ui_a2ui_middleware.A2UIMiddleware;
+  }
+});
+exports.ArgsParser = require_open_generative_ui_middleware.ArgsParser;
+exports.OpenGenerativeUIMiddleware = require_open_generative_ui_middleware.OpenGenerativeUIMiddleware;
+exports.transformRecordedEvents = require_recorded_events.transformRecordedEvents;

package/dist/event-transforms/index.d.cts

@@ -0,0 +1,4 @@
+import { ArgsParser, GenerateSandboxedUIParams, OnParamEvent, OpenGenerativeUIMiddleware } from "./open-generative-ui-middleware.cjs";
+import { RecordedEventTransformOptions, transformRecordedEvents } from "./recorded-events.cjs";
+import { A2UIMiddleware, A2UIMiddlewareConfig } from "@ag-ui/a2ui-middleware";
+export { A2UIMiddleware, type A2UIMiddlewareConfig, ArgsParser, GenerateSandboxedUIParams, OnParamEvent, OpenGenerativeUIMiddleware, RecordedEventTransformOptions, transformRecordedEvents };

package/dist/event-transforms/index.d.mts

@@ -0,0 +1,4 @@
+import { ArgsParser, GenerateSandboxedUIParams, OnParamEvent, OpenGenerativeUIMiddleware } from "./open-generative-ui-middleware.mjs";
+import { RecordedEventTransformOptions, transformRecordedEvents } from "./recorded-events.mjs";
+import { A2UIMiddleware, A2UIMiddlewareConfig } from "@ag-ui/a2ui-middleware";
+export { A2UIMiddleware, type A2UIMiddlewareConfig, ArgsParser, GenerateSandboxedUIParams, OnParamEvent, OpenGenerativeUIMiddleware, RecordedEventTransformOptions, transformRecordedEvents };

package/dist/event-transforms/index.mjs

@@ -0,0 +1,5 @@
+import { ArgsParser, OpenGenerativeUIMiddleware } from "./open-generative-ui-middleware.mjs";
+import { transformRecordedEvents } from "./recorded-events.mjs";
+import { A2UIMiddleware } from "@ag-ui/a2ui-middleware";
+
+export { A2UIMiddleware, ArgsParser, OpenGenerativeUIMiddleware, transformRecordedEvents };

package/dist/event-transforms/open-generative-ui-middleware.cjs

@@ -0,0 +1,286 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _ag_ui_client = require("@ag-ui/client");
+let rxjs = require("rxjs");
+let clarinet = require("clarinet");
+clarinet = require_runtime.__toESM(clarinet);
+
+//#region src/event-transforms/open-generative-ui-middleware.ts
+const TOOL_NAME = "generateSandboxedUi";
+const ACTIVITY_TYPE = "open-generative-ui";
+/**
+* Tracks incremental JSON parsing state for a single tool call's arguments.
+* Emits activity events via the onEvent callback as parameters complete.
+*/
+var ArgsParser = class {
+	constructor(toolCallId, onEvent) {
+		this.currentKey = null;
+		this.depth = 0;
+		this.currentArrayKey = null;
+		this.snapshotEmitted = false;
+		this.streamingHtmlKey = false;
+		this.htmlEmittedLength = 0;
+		this.htmlArrayEmitted = false;
+		this.params = {};
+		this.messageId = `${toolCallId}-activity`;
+		this.onEvent = onEvent;
+		this.parser = clarinet.default.parser();
+		this.parser.onopenobject = (key) => {
+			this.depth++;
+			if (key !== void 0 && this.depth === 1) {
+				this.currentKey = key;
+				this.initHtmlStreaming(key);
+			}
+		};
+		this.parser.onkey = (key) => {
+			if (this.depth === 1) {
+				this.currentKey = key;
+				this.initHtmlStreaming(key);
+			}
+		};
+		this.parser.onvalue = (value) => {
+			if (this.depth === 1 && this.currentKey) if (this.currentArrayKey) {
+				const strValue = String(value);
+				if (this.currentArrayKey === "jsExpressions") {
+					if (!this.params.jsExpressions) this.params.jsExpressions = [];
+					this.params.jsExpressions.push(strValue);
+				} else if (this.currentArrayKey === "placeholderMessages") {
+					if (!this.params.placeholderMessages) this.params.placeholderMessages = [];
+					this.params.placeholderMessages.push(strValue);
+				}
+				this.emitArrayItemDelta(this.currentArrayKey, strValue);
+			} else if (this.streamingHtmlKey) {
+				const fullHtml = value != null ? String(value) : "";
+				this.params.html = fullHtml || void 0;
+				this.emitPendingHtml(fullHtml);
+				this.emitParamDelta("htmlComplete", true);
+				this.streamingHtmlKey = false;
+			} else this.setParam(this.currentKey, value);
+		};
+		this.parser.onopenarray = () => {
+			if (this.depth === 1 && this.currentKey) {
+				const key = this.currentKey;
+				if (key === "jsExpressions" || key === "placeholderMessages") {
+					this.currentArrayKey = key;
+					if (key === "jsExpressions") this.params.jsExpressions = [];
+					else this.params.placeholderMessages = [];
+					this.emitParamDelta(key, []);
+				}
+			}
+		};
+		this.parser.onclosearray = () => {
+			if (this.depth === 1) {
+				if (this.currentArrayKey === "jsExpressions") this.emitParamDelta("jsExpressionsComplete", true);
+				this.currentArrayKey = null;
+			}
+		};
+		this.parser.oncloseobject = () => {
+			this.depth--;
+		};
+		this.parser.onerror = (err) => {
+			console.warn("[OpenGenerativeUI] JSON parse error in streaming args, resuming:", err?.message ?? err);
+			this.parser.error = null;
+			this.parser.resume();
+		};
+	}
+	write(chunk) {
+		this.parser.write(chunk);
+		this.flushHtmlChunks();
+	}
+	initHtmlStreaming(key) {
+		if (key === "html") {
+			this.streamingHtmlKey = true;
+			this.htmlEmittedLength = 0;
+			this.htmlArrayEmitted = false;
+		}
+	}
+	/**
+	* Read clarinet's internal textNode buffer to emit html chunks incrementally.
+	* Called after every write() so partial string content is emitted as it streams in.
+	*/
+	flushHtmlChunks() {
+		if (!this.streamingHtmlKey) return;
+		const textNode = this.parser.textNode;
+		if (typeof textNode !== "string") return;
+		if (textNode.length === this.htmlEmittedLength) return;
+		this.emitPendingHtml(textNode);
+	}
+	/**
+	* Emit accumulated html content since the last emission.
+	* Called by flushHtmlChunks and directly when html completes.
+	*/
+	emitPendingHtml(textNode) {
+		const newContent = textNode.slice(this.htmlEmittedLength);
+		if (newContent.length === 0) return;
+		if (!this.htmlArrayEmitted) {
+			this.htmlArrayEmitted = true;
+			this.emitParamDelta("html", []);
+		}
+		this.emitArrayItemDelta("html", newContent);
+		this.htmlEmittedLength = textNode.length;
+	}
+	setParam(key, value) {
+		switch (key) {
+			case "initialHeight":
+				this.params.initialHeight = typeof value === "number" ? value : void 0;
+				if (this.snapshotEmitted) this.emitParamDelta("initialHeight", this.params.initialHeight);
+				else this.emitSnapshot();
+				break;
+			case "css":
+				this.params.css = value != null ? String(value) : void 0;
+				this.emitParamDelta("css", this.params.css);
+				this.emitParamDelta("cssComplete", true);
+				break;
+			case "jsFunctions":
+				this.params.jsFunctions = value != null ? String(value) : void 0;
+				this.emitParamDelta("jsFunctions", this.params.jsFunctions);
+				this.emitParamDelta("jsFunctionsComplete", true);
+				break;
+		}
+	}
+	emitSnapshot() {
+		if (this.snapshotEmitted) return;
+		this.snapshotEmitted = true;
+		const event = {
+			type: _ag_ui_client.EventType.ACTIVITY_SNAPSHOT,
+			messageId: this.messageId,
+			activityType: ACTIVITY_TYPE,
+			content: {
+				initialHeight: this.params.initialHeight,
+				generating: true
+			}
+		};
+		this.onEvent(event);
+	}
+	emitParamDelta(key, value) {
+		if (value === void 0) return;
+		this.emitSnapshot();
+		const event = {
+			type: _ag_ui_client.EventType.ACTIVITY_DELTA,
+			messageId: this.messageId,
+			activityType: ACTIVITY_TYPE,
+			patch: [{
+				op: "add",
+				path: `/${key}`,
+				value
+			}]
+		};
+		this.onEvent(event);
+	}
+	emitArrayItemDelta(arrayKey, value) {
+		this.emitSnapshot();
+		const event = {
+			type: _ag_ui_client.EventType.ACTIVITY_DELTA,
+			messageId: this.messageId,
+			activityType: ACTIVITY_TYPE,
+			patch: [{
+				op: "add",
+				path: `/${arrayKey}/-`,
+				value
+			}]
+		};
+		this.onEvent(event);
+	}
+};
+var OpenGenerativeUIMiddleware = class extends _ag_ui_client.Middleware {
+	run(input, next) {
+		return this.processStream(this.runNextWithState(input, next));
+	}
+	processStream(source) {
+		return new rxjs.Observable((subscriber) => {
+			let heldRunFinished = null;
+			const activeParsers = /* @__PURE__ */ new Map();
+			const heldToolCallEvents = /* @__PURE__ */ new Map();
+			const flushedToolCalls = /* @__PURE__ */ new Set();
+			const flushHeldEvents = (toolCallId) => {
+				if (flushedToolCalls.has(toolCallId)) return;
+				flushedToolCalls.add(toolCallId);
+				const held = heldToolCallEvents.get(toolCallId);
+				if (held) {
+					for (const e of held) subscriber.next(e);
+					heldToolCallEvents.delete(toolCallId);
+				}
+			};
+			const subscription = source.subscribe({
+				next: (eventWithState) => {
+					const event = eventWithState.event;
+					if (heldRunFinished) {
+						subscriber.next(heldRunFinished.event);
+						heldRunFinished = null;
+					}
+					if (event.type === _ag_ui_client.EventType.RUN_FINISHED) {
+						heldRunFinished = eventWithState;
+						return;
+					}
+					if (event.type === _ag_ui_client.EventType.TOOL_CALL_START) {
+						const startEvent = event;
+						if (startEvent.toolCallName === TOOL_NAME) {
+							heldToolCallEvents.set(startEvent.toolCallId, [event]);
+							activeParsers.set(startEvent.toolCallId, new ArgsParser(startEvent.toolCallId, (activityEvent) => {
+								subscriber.next(activityEvent);
+								flushHeldEvents(startEvent.toolCallId);
+							}));
+							return;
+						}
+					}
+					if (event.type === _ag_ui_client.EventType.TOOL_CALL_ARGS) {
+						const argsEvent = event;
+						const parser = activeParsers.get(argsEvent.toolCallId);
+						if (parser) {
+							if (!flushedToolCalls.has(argsEvent.toolCallId)) heldToolCallEvents.get(argsEvent.toolCallId).push(event);
+							else subscriber.next(event);
+							parser.write(argsEvent.delta);
+							return;
+						}
+					}
+					if (event.type === _ag_ui_client.EventType.TOOL_CALL_END) {
+						const endEvent = event;
+						const parser = activeParsers.get(endEvent.toolCallId);
+						if (parser) {
+							const completeEvent = {
+								type: _ag_ui_client.EventType.ACTIVITY_DELTA,
+								messageId: parser.messageId,
+								activityType: ACTIVITY_TYPE,
+								patch: [{
+									op: "add",
+									path: "/generating",
+									value: false
+								}]
+							};
+							subscriber.next(completeEvent);
+							if (!flushedToolCalls.has(endEvent.toolCallId)) heldToolCallEvents.get(endEvent.toolCallId).push(event);
+							else subscriber.next(event);
+							return;
+						}
+					}
+					subscriber.next(event);
+				},
+				error: (err) => {
+					for (const [, events] of heldToolCallEvents) for (const event of events) subscriber.next(event);
+					heldToolCallEvents.clear();
+					if (heldRunFinished) {
+						subscriber.next(heldRunFinished.event);
+						heldRunFinished = null;
+					}
+					subscriber.error(err);
+				},
+				complete: () => {
+					heldToolCallEvents.forEach((_, toolCallId) => {
+						flushHeldEvents(toolCallId);
+					});
+					if (heldRunFinished) {
+						subscriber.next(heldRunFinished.event);
+						heldRunFinished = null;
+					}
+					activeParsers.clear();
+					subscriber.complete();
+				}
+			});
+			return () => subscription.unsubscribe();
+		});
+	}
+};
+
+//#endregion
+exports.ArgsParser = ArgsParser;
+exports.OpenGenerativeUIMiddleware = OpenGenerativeUIMiddleware;
+//# sourceMappingURL=open-generative-ui-middleware.cjs.map

package/dist/event-transforms/open-generative-ui-middleware.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-generative-ui-middleware.cjs","names":["EventType","Middleware","Observable"],"sources":["../../src/event-transforms/open-generative-ui-middleware.ts"],"sourcesContent":["import type {\n  RunAgentInput,\n  AbstractAgent,\n  BaseEvent,\n  ToolCallStartEvent,\n  ToolCallArgsEvent,\n  ActivitySnapshotEventProps,\n  ActivityDeltaEvent,\n} from \"@ag-ui/client\";\nimport { Middleware, EventType } from \"@ag-ui/client\";\nimport { Observable } from \"rxjs\";\nimport clarinet from \"clarinet\";\n\nconst TOOL_NAME = \"generateSandboxedUi\";\nconst ACTIVITY_TYPE = \"open-generative-ui\";\n\n/**\n * Parsed parameters from the generateSandboxedUi tool call.\n */\nexport interface GenerateSandboxedUIParams {\n  initialHeight?: number;\n  placeholderMessages?: string[];\n  css?: string;\n  html?: string;\n  jsFunctions?: string;\n  jsExpressions?: string[];\n}\n\n/**\n * Callback invoked by ArgsParser whenever a parameter (or array item) finishes parsing.\n */\nexport type OnParamEvent = (event: BaseEvent) => void;\n\n/**\n * Tracks incremental JSON parsing state for a single tool call's arguments.\n * Emits activity events via the onEvent callback as parameters complete.\n */\nexport class ArgsParser {\n  private parser: ReturnType<typeof clarinet.parser> & {\n    error?: Error | null;\n    textNode?: string;\n  };\n  private currentKey: string | null = null;\n  private depth = 0;\n  private currentArrayKey: string | null = null;\n  private snapshotEmitted = false;\n\n  // Streaming html state — reads parser.textNode to emit incremental chunks\n  private streamingHtmlKey = false;\n  private htmlEmittedLength = 0;\n  private htmlArrayEmitted = false;\n\n  public readonly params: GenerateSandboxedUIParams = {};\n  public readonly messageId: string;\n  private readonly onEvent: OnParamEvent;\n\n  constructor(toolCallId: string, onEvent: OnParamEvent) {\n    this.messageId = `${toolCallId}-activity`;\n    this.onEvent = onEvent;\n    this.parser = clarinet.parser();\n\n    this.parser.onopenobject = (key: string | undefined) => {\n      this.depth++;\n      if (key !== undefined && this.depth === 1) {\n        this.currentKey = key;\n        this.initHtmlStreaming(key);\n      }\n    };\n\n    this.parser.onkey = (key: string) => {\n      if (this.depth === 1) {\n        this.currentKey = key;\n        this.initHtmlStreaming(key);\n      }\n    };\n\n    this.parser.onvalue = (value: string | boolean | number | null) => {\n      if (this.depth === 1 && this.currentKey) {\n        if (this.currentArrayKey) {\n          const strValue = String(value);\n          if (this.currentArrayKey === \"jsExpressions\") {\n            if (!this.params.jsExpressions) this.params.jsExpressions = [];\n            this.params.jsExpressions.push(strValue);\n          } else if (this.currentArrayKey === \"placeholderMessages\") {\n            if (!this.params.placeholderMessages)\n              this.params.placeholderMessages = [];\n            this.params.placeholderMessages.push(strValue);\n          }\n          this.emitArrayItemDelta(this.currentArrayKey, strValue);\n        } else if (this.streamingHtmlKey) {\n          // HTML string completed — flush any remaining content immediately + htmlComplete\n          const fullHtml = value != null ? String(value) : \"\";\n          this.params.html = fullHtml || undefined;\n          this.emitPendingHtml(fullHtml);\n          this.emitParamDelta(\"htmlComplete\", true);\n          this.streamingHtmlKey = false;\n        } else {\n          this.setParam(this.currentKey, value);\n        }\n      }\n    };\n\n    this.parser.onopenarray = () => {\n      if (this.depth === 1 && this.currentKey) {\n        const key = this.currentKey;\n        if (key === \"jsExpressions\" || key === \"placeholderMessages\") {\n          this.currentArrayKey = key;\n          if (key === \"jsExpressions\") this.params.jsExpressions = [];\n          else this.params.placeholderMessages = [];\n          // Emit a delta to create the array in the activity content.\n          // Subsequent \"add\" ops with path \"/<key>/-\" append to this array.\n          this.emitParamDelta(key, []);\n        }\n      }\n    };\n\n    this.parser.onclosearray = () => {\n      if (this.depth === 1) {\n        if (this.currentArrayKey === \"jsExpressions\") {\n          this.emitParamDelta(\"jsExpressionsComplete\", true);\n        }\n        this.currentArrayKey = null;\n      }\n    };\n\n    this.parser.oncloseobject = () => {\n      this.depth--;\n    };\n\n    this.parser.onerror = (err: Error) => {\n      console.warn(\n        \"[OpenGenerativeUI] JSON parse error in streaming args, resuming:\",\n        err?.message ?? err,\n      );\n      // Reset error state so parsing can continue with the next chunk\n      this.parser.error = null;\n      this.parser.resume();\n    };\n  }\n\n  write(chunk: string): void {\n    this.parser.write(chunk);\n    this.flushHtmlChunks();\n  }\n\n  private initHtmlStreaming(key: string): void {\n    if (key === \"html\") {\n      this.streamingHtmlKey = true;\n      this.htmlEmittedLength = 0;\n      this.htmlArrayEmitted = false;\n    }\n  }\n\n  /**\n   * Read clarinet's internal textNode buffer to emit html chunks incrementally.\n   * Called after every write() so partial string content is emitted as it streams in.\n   */\n  private flushHtmlChunks(): void {\n    if (!this.streamingHtmlKey) return;\n    const textNode = this.parser.textNode;\n    if (typeof textNode !== \"string\") return;\n    if (textNode.length === this.htmlEmittedLength) return;\n\n    this.emitPendingHtml(textNode);\n  }\n\n  /**\n   * Emit accumulated html content since the last emission.\n   * Called by flushHtmlChunks and directly when html completes.\n   */\n  private emitPendingHtml(textNode: string): void {\n    const newContent = textNode.slice(this.htmlEmittedLength);\n    if (newContent.length === 0) return;\n\n    if (!this.htmlArrayEmitted) {\n      this.htmlArrayEmitted = true;\n      this.emitParamDelta(\"html\", []);\n    }\n    this.emitArrayItemDelta(\"html\", newContent);\n    this.htmlEmittedLength = textNode.length;\n  }\n\n  private setParam(key: string, value: string | boolean | number | null): void {\n    switch (key) {\n      case \"initialHeight\":\n        this.params.initialHeight =\n          typeof value === \"number\" ? value : undefined;\n        if (this.snapshotEmitted) {\n          // Snapshot already went out (another param parsed first) — deliver\n          // the height as a delta instead.\n          this.emitParamDelta(\"initialHeight\", this.params.initialHeight);\n        } else {\n          this.emitSnapshot();\n        }\n        break;\n      case \"css\":\n        this.params.css = value != null ? String(value) : undefined;\n        this.emitParamDelta(\"css\", this.params.css);\n        this.emitParamDelta(\"cssComplete\", true);\n        break;\n      case \"jsFunctions\":\n        this.params.jsFunctions = value != null ? String(value) : undefined;\n        this.emitParamDelta(\"jsFunctions\", this.params.jsFunctions);\n        this.emitParamDelta(\"jsFunctionsComplete\", true);\n        break;\n    }\n  }\n\n  private emitSnapshot(): void {\n    if (this.snapshotEmitted) return;\n    this.snapshotEmitted = true;\n\n    const event = {\n      type: EventType.ACTIVITY_SNAPSHOT,\n      messageId: this.messageId,\n      activityType: ACTIVITY_TYPE,\n      content: { initialHeight: this.params.initialHeight, generating: true },\n    } satisfies ActivitySnapshotEventProps;\n    this.onEvent(event);\n  }\n\n  private emitParamDelta(key: string, value: unknown): void {\n    // A JSON Patch \"add\" requires a value; emitting one without it (e.g. when\n    // the LLM sends a null/empty jsFunctions or css) makes fast-json-patch\n    // reject the whole patch client-side with OPERATION_VALUE_REQUIRED and\n    // drops it. Skip the delta when there's nothing to add.\n    if (value === undefined) return;\n    // The activity message must exist before any delta can be applied —\n    // the client silently drops ACTIVITY_DELTA events whose messageId has\n    // no prior ACTIVITY_SNAPSHOT. The LLM controls the key order of the\n    // streamed args, so the snapshot cannot wait for initialHeight.\n    this.emitSnapshot();\n    const event: ActivityDeltaEvent = {\n      type: EventType.ACTIVITY_DELTA,\n      messageId: this.messageId,\n      activityType: ACTIVITY_TYPE,\n      patch: [{ op: \"add\", path: `/${key}`, value }],\n    };\n    this.onEvent(event);\n  }\n\n  private emitArrayItemDelta(arrayKey: string, value: string): void {\n    this.emitSnapshot();\n    const event: ActivityDeltaEvent = {\n      type: EventType.ACTIVITY_DELTA,\n      messageId: this.messageId,\n      activityType: ACTIVITY_TYPE,\n      patch: [{ op: \"add\", path: `/${arrayKey}/-`, value }],\n    };\n    this.onEvent(event);\n  }\n}\n\n/**\n * Extract EventWithState type from Middleware.runNextWithState return type\n */\ntype ExtractObservableType<T> = T extends Observable<infer U> ? U : never;\ntype RunNextWithStateReturn = ReturnType<Middleware[\"runNextWithState\"]>;\ntype EventWithState = ExtractObservableType<RunNextWithStateReturn>;\n\nexport class OpenGenerativeUIMiddleware extends Middleware {\n  run(input: RunAgentInput, next: AbstractAgent): Observable<BaseEvent> {\n    return this.processStream(this.runNextWithState(input, next));\n  }\n\n  private processStream(\n    source: Observable<EventWithState>,\n  ): Observable<BaseEvent> {\n    return new Observable<BaseEvent>((subscriber) => {\n      let heldRunFinished: EventWithState | null = null;\n      // Track active generateSandboxedUi tool call IDs → their streaming parser\n      const activeParsers = new Map<string, ArgsParser>();\n      // Hold genui tool call events until the first activity event is emitted\n      const heldToolCallEvents = new Map<string, BaseEvent[]>();\n      const flushedToolCalls = new Set<string>();\n\n      const flushHeldEvents = (toolCallId: string) => {\n        if (flushedToolCalls.has(toolCallId)) return;\n        flushedToolCalls.add(toolCallId);\n        const held = heldToolCallEvents.get(toolCallId);\n        if (held) {\n          for (const e of held) {\n            subscriber.next(e);\n          }\n          heldToolCallEvents.delete(toolCallId);\n        }\n      };\n\n      const subscription = source.subscribe({\n        next: (eventWithState) => {\n          const event = eventWithState.event;\n\n          if (heldRunFinished) {\n            subscriber.next(heldRunFinished.event);\n            heldRunFinished = null;\n          }\n\n          if (event.type === EventType.RUN_FINISHED) {\n            heldRunFinished = eventWithState;\n            return;\n          }\n\n          // Hold TOOL_CALL_START for genui until the first activity event\n          if (event.type === EventType.TOOL_CALL_START) {\n            const startEvent = event as ToolCallStartEvent;\n            if (startEvent.toolCallName === TOOL_NAME) {\n              heldToolCallEvents.set(startEvent.toolCallId, [event]);\n              activeParsers.set(\n                startEvent.toolCallId,\n                new ArgsParser(startEvent.toolCallId, (activityEvent) => {\n                  subscriber.next(activityEvent);\n                  flushHeldEvents(startEvent.toolCallId);\n                }),\n              );\n              return;\n            }\n          }\n\n          // Hold or emit TOOL_CALL_ARGS for genui tool calls\n          if (event.type === EventType.TOOL_CALL_ARGS) {\n            const argsEvent = event as ToolCallArgsEvent;\n            const parser = activeParsers.get(argsEvent.toolCallId);\n            if (parser) {\n              if (!flushedToolCalls.has(argsEvent.toolCallId)) {\n                heldToolCallEvents.get(argsEvent.toolCallId)!.push(event);\n              } else {\n                subscriber.next(event);\n              }\n              parser.write(argsEvent.delta);\n              return;\n            }\n          }\n\n          // Hold or emit TOOL_CALL_END for genui tool calls\n          if (event.type === EventType.TOOL_CALL_END) {\n            const endEvent = event as { toolCallId: string } & BaseEvent;\n            const parser = activeParsers.get(endEvent.toolCallId);\n            if (parser) {\n              // Mark generation complete\n              const completeEvent: ActivityDeltaEvent = {\n                type: EventType.ACTIVITY_DELTA,\n                messageId: parser.messageId,\n                activityType: ACTIVITY_TYPE,\n                patch: [{ op: \"add\", path: \"/generating\", value: false }],\n              };\n              subscriber.next(completeEvent);\n\n              if (!flushedToolCalls.has(endEvent.toolCallId)) {\n                heldToolCallEvents.get(endEvent.toolCallId)!.push(event);\n              } else {\n                subscriber.next(event);\n              }\n              return;\n            }\n          }\n\n          subscriber.next(event);\n        },\n        error: (err) => {\n          // Flush any held tool call events so downstream sees them before the error\n          for (const [, events] of heldToolCallEvents) {\n            for (const event of events) {\n              subscriber.next(event);\n            }\n          }\n          heldToolCallEvents.clear();\n\n          if (heldRunFinished) {\n            subscriber.next(heldRunFinished.event);\n            heldRunFinished = null;\n          }\n          subscriber.error(err);\n        },\n        complete: () => {\n          // Flush any remaining held tool call events (e.g. parser never emitted)\n          heldToolCallEvents.forEach((_, toolCallId) => {\n            flushHeldEvents(toolCallId);\n          });\n\n          if (heldRunFinished) {\n            subscriber.next(heldRunFinished.event);\n            heldRunFinished = null;\n          }\n          activeParsers.clear();\n          subscriber.complete();\n        },\n      });\n\n      return () => subscription.unsubscribe();\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/event-transforms/open-generative-ui-middleware.d.cts

@@ -0,0 +1,60 @@
+import { AbstractAgent, BaseEvent, Middleware, RunAgentInput } from "@ag-ui/client";
+import { Observable } from "rxjs";
+
+//#region src/event-transforms/open-generative-ui-middleware.d.ts
+/**
+ * Parsed parameters from the generateSandboxedUi tool call.
+ */
+interface GenerateSandboxedUIParams {
+  initialHeight?: number;
+  placeholderMessages?: string[];
+  css?: string;
+  html?: string;
+  jsFunctions?: string;
+  jsExpressions?: string[];
+}
+/**
+ * Callback invoked by ArgsParser whenever a parameter (or array item) finishes parsing.
+ */
+type OnParamEvent = (event: BaseEvent) => void;
+/**
+ * Tracks incremental JSON parsing state for a single tool call's arguments.
+ * Emits activity events via the onEvent callback as parameters complete.
+ */
+declare class ArgsParser {
+  private parser;
+  private currentKey;
+  private depth;
+  private currentArrayKey;
+  private snapshotEmitted;
+  private streamingHtmlKey;
+  private htmlEmittedLength;
+  private htmlArrayEmitted;
+  readonly params: GenerateSandboxedUIParams;
+  readonly messageId: string;
+  private readonly onEvent;
+  constructor(toolCallId: string, onEvent: OnParamEvent);
+  write(chunk: string): void;
+  private initHtmlStreaming;
+  /**
+   * Read clarinet's internal textNode buffer to emit html chunks incrementally.
+   * Called after every write() so partial string content is emitted as it streams in.
+   */
+  private flushHtmlChunks;
+  /**
+   * Emit accumulated html content since the last emission.
+   * Called by flushHtmlChunks and directly when html completes.
+   */
+  private emitPendingHtml;
+  private setParam;
+  private emitSnapshot;
+  private emitParamDelta;
+  private emitArrayItemDelta;
+}
+declare class OpenGenerativeUIMiddleware extends Middleware {
+  run(input: RunAgentInput, next: AbstractAgent): Observable<BaseEvent>;
+  private processStream;
+}
+//#endregion
+export { ArgsParser, GenerateSandboxedUIParams, OnParamEvent, OpenGenerativeUIMiddleware };
+//# sourceMappingURL=open-generative-ui-middleware.d.cts.map

package/dist/event-transforms/open-generative-ui-middleware.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-generative-ui-middleware.d.cts","names":[],"sources":["../../src/event-transforms/open-generative-ui-middleware.ts"],"mappings":";;;;;AAmBA;;UAAiB,yBAAA;EACf,aAAA;EACA,mBAAA;EACA,GAAA;EACA,IAAA;EACA,WAAA;EACA,aAAA;AAAA;;;AAMF;KAAY,YAAA,IAAgB,KAAA,EAAO,SAAA;;;;AAMnC;cAAa,UAAA;EAAA,QACH,MAAA;EAAA,QAIA,UAAA;EAAA,QACA,KAAA;EAAA,QACA,eAAA;EAAA,QACA,eAAA;EAAA,QAGA,gBAAA;EAAA,QACA,iBAAA;EAAA,QACA,gBAAA;EAAA,SAEQ,MAAA,EAAQ,yBAAA;EAAA,SACR,SAAA;EAAA,iBACC,OAAA;cAEL,UAAA,UAAoB,OAAA,EAAS,YAAA;EAoFzC,KAAA,CAAM,KAAA;EAAA,QAKE,iBAAA;;;;;UAYA,eAAA;EAjBF;;;;EAAA,QA8BE,eAAA;EAAA,QAYA,QAAA;EAAA,QA0BA,YAAA;EAAA,QAaA,cAAA;EAAA,QAoBA,kBAAA;AAAA;AAAA,cAmBG,0BAAA,SAAmC,UAAA;EAC9C,GAAA,CAAI,KAAA,EAAO,aAAA,EAAe,IAAA,EAAM,aAAA,GAAgB,UAAA,CAAW,SAAA;EAAA,QAInD,aAAA;AAAA"}

package/dist/event-transforms/open-generative-ui-middleware.d.mts

@@ -0,0 +1,60 @@
+import { AbstractAgent, BaseEvent, Middleware, RunAgentInput } from "@ag-ui/client";
+import { Observable } from "rxjs";
+
+//#region src/event-transforms/open-generative-ui-middleware.d.ts
+/**
+ * Parsed parameters from the generateSandboxedUi tool call.
+ */
+interface GenerateSandboxedUIParams {
+  initialHeight?: number;
+  placeholderMessages?: string[];
+  css?: string;
+  html?: string;
+  jsFunctions?: string;
+  jsExpressions?: string[];
+}
+/**
+ * Callback invoked by ArgsParser whenever a parameter (or array item) finishes parsing.
+ */
+type OnParamEvent = (event: BaseEvent) => void;
+/**
+ * Tracks incremental JSON parsing state for a single tool call's arguments.
+ * Emits activity events via the onEvent callback as parameters complete.
+ */
+declare class ArgsParser {
+  private parser;
+  private currentKey;
+  private depth;
+  private currentArrayKey;
+  private snapshotEmitted;
+  private streamingHtmlKey;
+  private htmlEmittedLength;
+  private htmlArrayEmitted;
+  readonly params: GenerateSandboxedUIParams;
+  readonly messageId: string;
+  private readonly onEvent;
+  constructor(toolCallId: string, onEvent: OnParamEvent);
+  write(chunk: string): void;
+  private initHtmlStreaming;
+  /**
+   * Read clarinet's internal textNode buffer to emit html chunks incrementally.
+   * Called after every write() so partial string content is emitted as it streams in.
+   */
+  private flushHtmlChunks;
+  /**
+   * Emit accumulated html content since the last emission.
+   * Called by flushHtmlChunks and directly when html completes.
+   */
+  private emitPendingHtml;
+  private setParam;
+  private emitSnapshot;
+  private emitParamDelta;
+  private emitArrayItemDelta;
+}
+declare class OpenGenerativeUIMiddleware extends Middleware {
+  run(input: RunAgentInput, next: AbstractAgent): Observable<BaseEvent>;
+  private processStream;
+}
+//#endregion
+export { ArgsParser, GenerateSandboxedUIParams, OnParamEvent, OpenGenerativeUIMiddleware };
+//# sourceMappingURL=open-generative-ui-middleware.d.mts.map

package/dist/event-transforms/open-generative-ui-middleware.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-generative-ui-middleware.d.mts","names":[],"sources":["../../src/event-transforms/open-generative-ui-middleware.ts"],"mappings":";;;;;AAmBA;;UAAiB,yBAAA;EACf,aAAA;EACA,mBAAA;EACA,GAAA;EACA,IAAA;EACA,WAAA;EACA,aAAA;AAAA;;;AAMF;KAAY,YAAA,IAAgB,KAAA,EAAO,SAAA;;;;AAMnC;cAAa,UAAA;EAAA,QACH,MAAA;EAAA,QAIA,UAAA;EAAA,QACA,KAAA;EAAA,QACA,eAAA;EAAA,QACA,eAAA;EAAA,QAGA,gBAAA;EAAA,QACA,iBAAA;EAAA,QACA,gBAAA;EAAA,SAEQ,MAAA,EAAQ,yBAAA;EAAA,SACR,SAAA;EAAA,iBACC,OAAA;cAEL,UAAA,UAAoB,OAAA,EAAS,YAAA;EAoFzC,KAAA,CAAM,KAAA;EAAA,QAKE,iBAAA;;;;;UAYA,eAAA;EAjBF;;;;EAAA,QA8BE,eAAA;EAAA,QAYA,QAAA;EAAA,QA0BA,YAAA;EAAA,QAaA,cAAA;EAAA,QAoBA,kBAAA;AAAA;AAAA,cAmBG,0BAAA,SAAmC,UAAA;EAC9C,GAAA,CAAI,KAAA,EAAO,aAAA,EAAe,IAAA,EAAM,aAAA,GAAgB,UAAA,CAAW,SAAA;EAAA,QAInD,aAAA;AAAA"}