@copilotkit/shared 1.84.2-canary.1793809041 → 1.85.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. package/README.md +1 -1
  2. package/dist/a2ui-catalog-schema.cjs +14 -5
  3. package/dist/a2ui-catalog-schema.cjs.map +1 -1
  4. package/dist/a2ui-catalog-schema.d.cts +4 -2
  5. package/dist/a2ui-catalog-schema.d.cts.map +1 -1
  6. package/dist/a2ui-catalog-schema.d.mts +4 -2
  7. package/dist/a2ui-catalog-schema.d.mts.map +1 -1
  8. package/dist/a2ui-catalog-schema.mjs +14 -5
  9. package/dist/a2ui-catalog-schema.mjs.map +1 -1
  10. package/dist/event-transforms/open-generative-ui-middleware.cjs +7 -6
  11. package/dist/event-transforms/open-generative-ui-middleware.cjs.map +1 -1
  12. package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +1 -1
  13. package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +1 -1
  14. package/dist/event-transforms/open-generative-ui-middleware.mjs +7 -6
  15. package/dist/event-transforms/open-generative-ui-middleware.mjs.map +1 -1
  16. package/dist/generative-ui/catalog/catalog-export.cjs +329 -0
  17. package/dist/generative-ui/catalog/catalog-export.cjs.map +1 -0
  18. package/dist/generative-ui/catalog/catalog-export.d.cts +92 -0
  19. package/dist/generative-ui/catalog/catalog-export.d.cts.map +1 -0
  20. package/dist/generative-ui/catalog/catalog-export.d.mts +92 -0
  21. package/dist/generative-ui/catalog/catalog-export.d.mts.map +1 -0
  22. package/dist/generative-ui/catalog/catalog-export.mjs +328 -0
  23. package/dist/generative-ui/catalog/catalog-export.mjs.map +1 -0
  24. package/dist/generative-ui/catalog/catalog.cjs +314 -0
  25. package/dist/generative-ui/catalog/catalog.cjs.map +1 -0
  26. package/dist/generative-ui/catalog/catalog.d.cts +407 -0
  27. package/dist/generative-ui/catalog/catalog.d.cts.map +1 -0
  28. package/dist/generative-ui/catalog/catalog.d.mts +407 -0
  29. package/dist/generative-ui/catalog/catalog.d.mts.map +1 -0
  30. package/dist/generative-ui/catalog/catalog.mjs +311 -0
  31. package/dist/generative-ui/catalog/catalog.mjs.map +1 -0
  32. package/dist/generative-ui/catalog/errors.cjs +13 -0
  33. package/dist/generative-ui/catalog/errors.cjs.map +1 -0
  34. package/dist/generative-ui/catalog/errors.d.cts +46 -0
  35. package/dist/generative-ui/catalog/errors.d.cts.map +1 -0
  36. package/dist/generative-ui/catalog/errors.d.mts +46 -0
  37. package/dist/generative-ui/catalog/errors.d.mts.map +1 -0
  38. package/dist/generative-ui/catalog/errors.mjs +12 -0
  39. package/dist/generative-ui/catalog/errors.mjs.map +1 -0
  40. package/dist/generative-ui/catalog/index.d.mts +6 -0
  41. package/dist/generative-ui/catalog/json-schema.cjs +19 -0
  42. package/dist/generative-ui/catalog/json-schema.cjs.map +1 -0
  43. package/dist/generative-ui/catalog/json-schema.d.cts +13 -0
  44. package/dist/generative-ui/catalog/json-schema.d.cts.map +1 -0
  45. package/dist/generative-ui/catalog/json-schema.d.mts +13 -0
  46. package/dist/generative-ui/catalog/json-schema.d.mts.map +1 -0
  47. package/dist/generative-ui/catalog/json-schema.mjs +18 -0
  48. package/dist/generative-ui/catalog/json-schema.mjs.map +1 -0
  49. package/dist/generative-ui/catalog/refs.cjs +20 -0
  50. package/dist/generative-ui/catalog/refs.cjs.map +1 -0
  51. package/dist/generative-ui/catalog/refs.d.cts +54 -0
  52. package/dist/generative-ui/catalog/refs.d.cts.map +1 -0
  53. package/dist/generative-ui/catalog/refs.d.mts +54 -0
  54. package/dist/generative-ui/catalog/refs.d.mts.map +1 -0
  55. package/dist/generative-ui/catalog/refs.mjs +18 -0
  56. package/dist/generative-ui/catalog/refs.mjs.map +1 -0
  57. package/dist/generative-ui/catalog/schema.cjs +74 -0
  58. package/dist/generative-ui/catalog/schema.cjs.map +1 -0
  59. package/dist/generative-ui/catalog/schema.d.cts +43 -0
  60. package/dist/generative-ui/catalog/schema.d.cts.map +1 -0
  61. package/dist/generative-ui/catalog/schema.d.mts +43 -0
  62. package/dist/generative-ui/catalog/schema.d.mts.map +1 -0
  63. package/dist/generative-ui/catalog/schema.mjs +68 -0
  64. package/dist/generative-ui/catalog/schema.mjs.map +1 -0
  65. package/dist/generative-ui/index.cjs +247 -0
  66. package/dist/generative-ui/index.d.cts +33 -0
  67. package/dist/generative-ui/index.d.mts +35 -0
  68. package/dist/generative-ui/index.mjs +34 -0
  69. package/dist/generative-ui/is-record.cjs +6 -1
  70. package/dist/generative-ui/is-record.cjs.map +1 -1
  71. package/dist/generative-ui/is-record.d.cts +6 -0
  72. package/dist/generative-ui/is-record.d.cts.map +1 -0
  73. package/dist/generative-ui/is-record.d.mts +6 -0
  74. package/dist/generative-ui/is-record.d.mts.map +1 -0
  75. package/dist/generative-ui/is-record.mjs +6 -2
  76. package/dist/generative-ui/is-record.mjs.map +1 -1
  77. package/dist/generative-ui/standard/chart.cjs +56 -0
  78. package/dist/generative-ui/standard/chart.cjs.map +1 -0
  79. package/dist/generative-ui/standard/chart.d.cts +142 -0
  80. package/dist/generative-ui/standard/chart.d.cts.map +1 -0
  81. package/dist/generative-ui/standard/chart.d.mts +142 -0
  82. package/dist/generative-ui/standard/chart.d.mts.map +1 -0
  83. package/dist/generative-ui/standard/chart.mjs +54 -0
  84. package/dist/generative-ui/standard/chart.mjs.map +1 -0
  85. package/dist/generative-ui/standard/checks.cjs +74 -0
  86. package/dist/generative-ui/standard/checks.cjs.map +1 -0
  87. package/dist/generative-ui/standard/checks.d.cts +74 -0
  88. package/dist/generative-ui/standard/checks.d.cts.map +1 -0
  89. package/dist/generative-ui/standard/checks.d.mts +74 -0
  90. package/dist/generative-ui/standard/checks.d.mts.map +1 -0
  91. package/dist/generative-ui/standard/checks.mjs +71 -0
  92. package/dist/generative-ui/standard/checks.mjs.map +1 -0
  93. package/dist/generative-ui/standard/components.cjs +23 -0
  94. package/dist/generative-ui/standard/components.cjs.map +1 -0
  95. package/dist/generative-ui/standard/components.d.cts +24 -0
  96. package/dist/generative-ui/standard/components.d.cts.map +1 -0
  97. package/dist/generative-ui/standard/components.d.mts +24 -0
  98. package/dist/generative-ui/standard/components.d.mts.map +1 -0
  99. package/dist/generative-ui/standard/components.mjs +22 -0
  100. package/dist/generative-ui/standard/components.mjs.map +1 -0
  101. package/dist/generative-ui/standard/composites.cjs +143 -0
  102. package/dist/generative-ui/standard/composites.cjs.map +1 -0
  103. package/dist/generative-ui/standard/composites.d.cts +500 -0
  104. package/dist/generative-ui/standard/composites.d.cts.map +1 -0
  105. package/dist/generative-ui/standard/composites.d.mts +500 -0
  106. package/dist/generative-ui/standard/composites.d.mts.map +1 -0
  107. package/dist/generative-ui/standard/composites.mjs +132 -0
  108. package/dist/generative-ui/standard/composites.mjs.map +1 -0
  109. package/dist/generative-ui/standard/data.cjs +176 -0
  110. package/dist/generative-ui/standard/data.cjs.map +1 -0
  111. package/dist/generative-ui/standard/data.d.cts +745 -0
  112. package/dist/generative-ui/standard/data.d.cts.map +1 -0
  113. package/dist/generative-ui/standard/data.d.mts +745 -0
  114. package/dist/generative-ui/standard/data.d.mts.map +1 -0
  115. package/dist/generative-ui/standard/data.mjs +167 -0
  116. package/dist/generative-ui/standard/data.mjs.map +1 -0
  117. package/dist/generative-ui/standard/declarations.cjs +40 -0
  118. package/dist/generative-ui/standard/declarations.cjs.map +1 -0
  119. package/dist/generative-ui/standard/declarations.d.cts +4604 -0
  120. package/dist/generative-ui/standard/declarations.d.cts.map +1 -0
  121. package/dist/generative-ui/standard/declarations.d.mts +4605 -0
  122. package/dist/generative-ui/standard/declarations.d.mts.map +1 -0
  123. package/dist/generative-ui/standard/declarations.mjs +39 -0
  124. package/dist/generative-ui/standard/declarations.mjs.map +1 -0
  125. package/dist/generative-ui/standard/feedback.cjs +97 -0
  126. package/dist/generative-ui/standard/feedback.cjs.map +1 -0
  127. package/dist/generative-ui/standard/feedback.d.cts +227 -0
  128. package/dist/generative-ui/standard/feedback.d.cts.map +1 -0
  129. package/dist/generative-ui/standard/feedback.d.mts +227 -0
  130. package/dist/generative-ui/standard/feedback.d.mts.map +1 -0
  131. package/dist/generative-ui/standard/feedback.mjs +90 -0
  132. package/dist/generative-ui/standard/feedback.mjs.map +1 -0
  133. package/dist/generative-ui/standard/index.d.mts +16 -0
  134. package/dist/generative-ui/standard/inputs.cjs +333 -0
  135. package/dist/generative-ui/standard/inputs.cjs.map +1 -0
  136. package/dist/generative-ui/standard/inputs.d.cts +2658 -0
  137. package/dist/generative-ui/standard/inputs.d.cts.map +1 -0
  138. package/dist/generative-ui/standard/inputs.d.mts +2658 -0
  139. package/dist/generative-ui/standard/inputs.d.mts.map +1 -0
  140. package/dist/generative-ui/standard/inputs.mjs +318 -0
  141. package/dist/generative-ui/standard/inputs.mjs.map +1 -0
  142. package/dist/generative-ui/standard/layout.cjs +289 -0
  143. package/dist/generative-ui/standard/layout.cjs.map +1 -0
  144. package/dist/generative-ui/standard/layout.d.cts +2854 -0
  145. package/dist/generative-ui/standard/layout.d.cts.map +1 -0
  146. package/dist/generative-ui/standard/layout.d.mts +2854 -0
  147. package/dist/generative-ui/standard/layout.d.mts.map +1 -0
  148. package/dist/generative-ui/standard/layout.mjs +269 -0
  149. package/dist/generative-ui/standard/layout.mjs.map +1 -0
  150. package/dist/generative-ui/standard/map.cjs +27 -0
  151. package/dist/generative-ui/standard/map.cjs.map +1 -0
  152. package/dist/generative-ui/standard/map.d.cts +93 -0
  153. package/dist/generative-ui/standard/map.d.cts.map +1 -0
  154. package/dist/generative-ui/standard/map.d.mts +93 -0
  155. package/dist/generative-ui/standard/map.d.mts.map +1 -0
  156. package/dist/generative-ui/standard/map.mjs +25 -0
  157. package/dist/generative-ui/standard/map.mjs.map +1 -0
  158. package/dist/generative-ui/standard/media.cjs +215 -0
  159. package/dist/generative-ui/standard/media.cjs.map +1 -0
  160. package/dist/generative-ui/standard/media.d.cts +968 -0
  161. package/dist/generative-ui/standard/media.d.cts.map +1 -0
  162. package/dist/generative-ui/standard/media.d.mts +968 -0
  163. package/dist/generative-ui/standard/media.d.mts.map +1 -0
  164. package/dist/generative-ui/standard/media.mjs +205 -0
  165. package/dist/generative-ui/standard/media.mjs.map +1 -0
  166. package/dist/generative-ui/standard/parameter-order.cjs +231 -0
  167. package/dist/generative-ui/standard/parameter-order.cjs.map +1 -0
  168. package/dist/generative-ui/standard/parameter-order.d.cts +84 -0
  169. package/dist/generative-ui/standard/parameter-order.d.cts.map +1 -0
  170. package/dist/generative-ui/standard/parameter-order.d.mts +84 -0
  171. package/dist/generative-ui/standard/parameter-order.d.mts.map +1 -0
  172. package/dist/generative-ui/standard/parameter-order.mjs +230 -0
  173. package/dist/generative-ui/standard/parameter-order.mjs.map +1 -0
  174. package/dist/generative-ui/standard/styles.cjs +62 -0
  175. package/dist/generative-ui/standard/styles.cjs.map +1 -0
  176. package/dist/generative-ui/standard/styles.d.cts +17 -0
  177. package/dist/generative-ui/standard/styles.d.cts.map +1 -0
  178. package/dist/generative-ui/standard/styles.d.mts +17 -0
  179. package/dist/generative-ui/standard/styles.d.mts.map +1 -0
  180. package/dist/generative-ui/standard/styles.mjs +60 -0
  181. package/dist/generative-ui/standard/styles.mjs.map +1 -0
  182. package/dist/generative-ui/standard/text.cjs +226 -0
  183. package/dist/generative-ui/standard/text.cjs.map +1 -0
  184. package/dist/generative-ui/standard/text.d.cts +687 -0
  185. package/dist/generative-ui/standard/text.d.cts.map +1 -0
  186. package/dist/generative-ui/standard/text.d.mts +687 -0
  187. package/dist/generative-ui/standard/text.d.mts.map +1 -0
  188. package/dist/generative-ui/standard/text.mjs +209 -0
  189. package/dist/generative-ui/standard/text.mjs.map +1 -0
  190. package/dist/generative-ui/standard/theme.cjs +115 -0
  191. package/dist/generative-ui/standard/theme.cjs.map +1 -0
  192. package/dist/generative-ui/standard/theme.d.cts +60 -0
  193. package/dist/generative-ui/standard/theme.d.cts.map +1 -0
  194. package/dist/generative-ui/standard/theme.d.mts +60 -0
  195. package/dist/generative-ui/standard/theme.d.mts.map +1 -0
  196. package/dist/generative-ui/standard/theme.mjs +112 -0
  197. package/dist/generative-ui/standard/theme.mjs.map +1 -0
  198. package/dist/generative-ui/standard/tokens.cjs +336 -0
  199. package/dist/generative-ui/standard/tokens.cjs.map +1 -0
  200. package/dist/generative-ui/standard/tokens.d.cts +76 -0
  201. package/dist/generative-ui/standard/tokens.d.cts.map +1 -0
  202. package/dist/generative-ui/standard/tokens.d.mts +76 -0
  203. package/dist/generative-ui/standard/tokens.d.mts.map +1 -0
  204. package/dist/generative-ui/standard/tokens.mjs +305 -0
  205. package/dist/generative-ui/standard/tokens.mjs.map +1 -0
  206. package/dist/index.cjs.map +1 -1
  207. package/dist/index.d.cts +10 -10
  208. package/dist/index.d.mts +10 -10
  209. package/dist/index.mjs.map +1 -1
  210. package/dist/index.umd.js +16 -7
  211. package/dist/index.umd.js.map +1 -1
  212. package/dist/package.cjs +1 -1
  213. package/dist/package.mjs +1 -1
  214. package/package.json +7 -3
  215. package/src/__tests__/a2ui-catalog-schema.test.ts +26 -0
  216. package/src/a2ui-catalog-schema.ts +14 -5
  217. package/src/event-transforms/open-generative-ui-middleware.ts +19 -10
  218. package/src/generative-ui/base.ts +9 -0
  219. package/src/generative-ui/catalog/catalog-export.ts +478 -0
  220. package/src/generative-ui/catalog/catalog.ts +1166 -0
  221. package/src/generative-ui/catalog/errors.ts +102 -0
  222. package/src/generative-ui/catalog/index.ts +6 -0
  223. package/src/generative-ui/catalog/json-schema.ts +23 -0
  224. package/src/generative-ui/catalog/refs.ts +86 -0
  225. package/src/generative-ui/catalog/schema.ts +107 -0
  226. package/src/generative-ui/index.ts +7 -0
  227. package/src/generative-ui/is-record.ts +6 -1
  228. package/src/generative-ui/standard/__tests__/theme.test.ts +61 -0
  229. package/src/generative-ui/standard/__tests__/tokens.test.ts +139 -0
  230. package/src/generative-ui/standard/chart.ts +79 -0
  231. package/src/generative-ui/standard/checks.ts +98 -0
  232. package/src/generative-ui/standard/components.ts +35 -0
  233. package/src/generative-ui/standard/composites.ts +158 -0
  234. package/src/generative-ui/standard/data.ts +213 -0
  235. package/src/generative-ui/standard/declarations.ts +57 -0
  236. package/src/generative-ui/standard/feedback.ts +105 -0
  237. package/src/generative-ui/standard/index.ts +19 -0
  238. package/src/generative-ui/standard/inputs.ts +423 -0
  239. package/src/generative-ui/standard/layout.ts +312 -0
  240. package/src/generative-ui/standard/map.ts +32 -0
  241. package/src/generative-ui/standard/media.ts +265 -0
  242. package/src/generative-ui/standard/parameter-order.ts +155 -0
  243. package/src/generative-ui/standard/styles.ts +79 -0
  244. package/src/generative-ui/standard/text.ts +210 -0
  245. package/src/generative-ui/standard/theme.ts +198 -0
  246. package/src/generative-ui/standard/tokens.ts +317 -0
  247. package/src/index.ts +1 -1
  248. package/tsdown.config.ts +1 -0
@@ -1 +1 @@
1
- {"version":3,"file":"open-generative-ui-middleware.mjs","names":[],"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\nexport class OpenGenerativeUIMiddleware extends Middleware {\n run(input: RunAgentInput, next: AbstractAgent): Observable<BaseEvent> {\n // Only the events are read, so `runNext`: `runNextWithState` copies the\n // messages and state on every event for a consumer that never looks.\n return this.processStream(this.runNext(input, next));\n }\n\n private processStream(source: Observable<BaseEvent>): Observable<BaseEvent> {\n return new Observable<BaseEvent>((subscriber) => {\n let heldRunFinished: BaseEvent | 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: (event) => {\n if (heldRunFinished) {\n subscriber.next(heldRunFinished);\n heldRunFinished = null;\n }\n\n if (event.type === EventType.RUN_FINISHED) {\n heldRunFinished = event;\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);\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);\n heldRunFinished = null;\n }\n activeParsers.clear();\n subscriber.complete();\n },\n });\n\n return () => subscription.unsubscribe();\n });\n }\n}\n"],"mappings":";;;;;AAaA,MAAM,YAAY;AAClB,MAAM,gBAAgB;;;;;AAuBtB,IAAa,aAAb,MAAwB;CAmBtB,YAAY,YAAoB,SAAuB;oBAdnB;eACpB;yBACyB;yBACf;0BAGC;2BACC;0BACD;gBAEyB,EAAE;AAKpD,OAAK,YAAY,GAAG,WAAW;AAC/B,OAAK,UAAU;AACf,OAAK,SAAS,SAAS,QAAQ;AAE/B,OAAK,OAAO,gBAAgB,QAA4B;AACtD,QAAK;AACL,OAAI,QAAQ,UAAa,KAAK,UAAU,GAAG;AACzC,SAAK,aAAa;AAClB,SAAK,kBAAkB,IAAI;;;AAI/B,OAAK,OAAO,SAAS,QAAgB;AACnC,OAAI,KAAK,UAAU,GAAG;AACpB,SAAK,aAAa;AAClB,SAAK,kBAAkB,IAAI;;;AAI/B,OAAK,OAAO,WAAW,UAA4C;AACjE,OAAI,KAAK,UAAU,KAAK,KAAK,WAC3B,KAAI,KAAK,iBAAiB;IACxB,MAAM,WAAW,OAAO,MAAM;AAC9B,QAAI,KAAK,oBAAoB,iBAAiB;AAC5C,SAAI,CAAC,KAAK,OAAO,cAAe,MAAK,OAAO,gBAAgB,EAAE;AAC9D,UAAK,OAAO,cAAc,KAAK,SAAS;eAC/B,KAAK,oBAAoB,uBAAuB;AACzD,SAAI,CAAC,KAAK,OAAO,oBACf,MAAK,OAAO,sBAAsB,EAAE;AACtC,UAAK,OAAO,oBAAoB,KAAK,SAAS;;AAEhD,SAAK,mBAAmB,KAAK,iBAAiB,SAAS;cAC9C,KAAK,kBAAkB;IAEhC,MAAM,WAAW,SAAS,OAAO,OAAO,MAAM,GAAG;AACjD,SAAK,OAAO,OAAO,YAAY;AAC/B,SAAK,gBAAgB,SAAS;AAC9B,SAAK,eAAe,gBAAgB,KAAK;AACzC,SAAK,mBAAmB;SAExB,MAAK,SAAS,KAAK,YAAY,MAAM;;AAK3C,OAAK,OAAO,oBAAoB;AAC9B,OAAI,KAAK,UAAU,KAAK,KAAK,YAAY;IACvC,MAAM,MAAM,KAAK;AACjB,QAAI,QAAQ,mBAAmB,QAAQ,uBAAuB;AAC5D,UAAK,kBAAkB;AACvB,SAAI,QAAQ,gBAAiB,MAAK,OAAO,gBAAgB,EAAE;SACtD,MAAK,OAAO,sBAAsB,EAAE;AAGzC,UAAK,eAAe,KAAK,EAAE,CAAC;;;;AAKlC,OAAK,OAAO,qBAAqB;AAC/B,OAAI,KAAK,UAAU,GAAG;AACpB,QAAI,KAAK,oBAAoB,gBAC3B,MAAK,eAAe,yBAAyB,KAAK;AAEpD,SAAK,kBAAkB;;;AAI3B,OAAK,OAAO,sBAAsB;AAChC,QAAK;;AAGP,OAAK,OAAO,WAAW,QAAe;AACpC,WAAQ,KACN,oEACA,KAAK,WAAW,IACjB;AAED,QAAK,OAAO,QAAQ;AACpB,QAAK,OAAO,QAAQ;;;CAIxB,MAAM,OAAqB;AACzB,OAAK,OAAO,MAAM,MAAM;AACxB,OAAK,iBAAiB;;CAGxB,AAAQ,kBAAkB,KAAmB;AAC3C,MAAI,QAAQ,QAAQ;AAClB,QAAK,mBAAmB;AACxB,QAAK,oBAAoB;AACzB,QAAK,mBAAmB;;;;;;;CAQ5B,AAAQ,kBAAwB;AAC9B,MAAI,CAAC,KAAK,iBAAkB;EAC5B,MAAM,WAAW,KAAK,OAAO;AAC7B,MAAI,OAAO,aAAa,SAAU;AAClC,MAAI,SAAS,WAAW,KAAK,kBAAmB;AAEhD,OAAK,gBAAgB,SAAS;;;;;;CAOhC,AAAQ,gBAAgB,UAAwB;EAC9C,MAAM,aAAa,SAAS,MAAM,KAAK,kBAAkB;AACzD,MAAI,WAAW,WAAW,EAAG;AAE7B,MAAI,CAAC,KAAK,kBAAkB;AAC1B,QAAK,mBAAmB;AACxB,QAAK,eAAe,QAAQ,EAAE,CAAC;;AAEjC,OAAK,mBAAmB,QAAQ,WAAW;AAC3C,OAAK,oBAAoB,SAAS;;CAGpC,AAAQ,SAAS,KAAa,OAA+C;AAC3E,UAAQ,KAAR;GACE,KAAK;AACH,SAAK,OAAO,gBACV,OAAO,UAAU,WAAW,QAAQ;AACtC,QAAI,KAAK,gBAGP,MAAK,eAAe,iBAAiB,KAAK,OAAO,cAAc;QAE/D,MAAK,cAAc;AAErB;GACF,KAAK;AACH,SAAK,OAAO,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG;AAClD,SAAK,eAAe,OAAO,KAAK,OAAO,IAAI;AAC3C,SAAK,eAAe,eAAe,KAAK;AACxC;GACF,KAAK;AACH,SAAK,OAAO,cAAc,SAAS,OAAO,OAAO,MAAM,GAAG;AAC1D,SAAK,eAAe,eAAe,KAAK,OAAO,YAAY;AAC3D,SAAK,eAAe,uBAAuB,KAAK;AAChD;;;CAIN,AAAQ,eAAqB;AAC3B,MAAI,KAAK,gBAAiB;AAC1B,OAAK,kBAAkB;EAEvB,MAAM,QAAQ;GACZ,MAAM,UAAU;GAChB,WAAW,KAAK;GAChB,cAAc;GACd,SAAS;IAAE,eAAe,KAAK,OAAO;IAAe,YAAY;IAAM;GACxE;AACD,OAAK,QAAQ,MAAM;;CAGrB,AAAQ,eAAe,KAAa,OAAsB;AAKxD,MAAI,UAAU,OAAW;AAKzB,OAAK,cAAc;EACnB,MAAM,QAA4B;GAChC,MAAM,UAAU;GAChB,WAAW,KAAK;GAChB,cAAc;GACd,OAAO,CAAC;IAAE,IAAI;IAAO,MAAM,IAAI;IAAO;IAAO,CAAC;GAC/C;AACD,OAAK,QAAQ,MAAM;;CAGrB,AAAQ,mBAAmB,UAAkB,OAAqB;AAChE,OAAK,cAAc;EACnB,MAAM,QAA4B;GAChC,MAAM,UAAU;GAChB,WAAW,KAAK;GAChB,cAAc;GACd,OAAO,CAAC;IAAE,IAAI;IAAO,MAAM,IAAI,SAAS;IAAK;IAAO,CAAC;GACtD;AACD,OAAK,QAAQ,MAAM;;;AAIvB,IAAa,6BAAb,cAAgD,WAAW;CACzD,IAAI,OAAsB,MAA4C;AAGpE,SAAO,KAAK,cAAc,KAAK,QAAQ,OAAO,KAAK,CAAC;;CAGtD,AAAQ,cAAc,QAAsD;AAC1E,SAAO,IAAI,YAAuB,eAAe;GAC/C,IAAI,kBAAoC;GAExC,MAAM,gCAAgB,IAAI,KAAyB;GAEnD,MAAM,qCAAqB,IAAI,KAA0B;GACzD,MAAM,mCAAmB,IAAI,KAAa;GAE1C,MAAM,mBAAmB,eAAuB;AAC9C,QAAI,iBAAiB,IAAI,WAAW,CAAE;AACtC,qBAAiB,IAAI,WAAW;IAChC,MAAM,OAAO,mBAAmB,IAAI,WAAW;AAC/C,QAAI,MAAM;AACR,UAAK,MAAM,KAAK,KACd,YAAW,KAAK,EAAE;AAEpB,wBAAmB,OAAO,WAAW;;;GAIzC,MAAM,eAAe,OAAO,UAAU;IACpC,OAAO,UAAU;AACf,SAAI,iBAAiB;AACnB,iBAAW,KAAK,gBAAgB;AAChC,wBAAkB;;AAGpB,SAAI,MAAM,SAAS,UAAU,cAAc;AACzC,wBAAkB;AAClB;;AAIF,SAAI,MAAM,SAAS,UAAU,iBAAiB;MAC5C,MAAM,aAAa;AACnB,UAAI,WAAW,iBAAiB,WAAW;AACzC,0BAAmB,IAAI,WAAW,YAAY,CAAC,MAAM,CAAC;AACtD,qBAAc,IACZ,WAAW,YACX,IAAI,WAAW,WAAW,aAAa,kBAAkB;AACvD,mBAAW,KAAK,cAAc;AAC9B,wBAAgB,WAAW,WAAW;SACtC,CACH;AACD;;;AAKJ,SAAI,MAAM,SAAS,UAAU,gBAAgB;MAC3C,MAAM,YAAY;MAClB,MAAM,SAAS,cAAc,IAAI,UAAU,WAAW;AACtD,UAAI,QAAQ;AACV,WAAI,CAAC,iBAAiB,IAAI,UAAU,WAAW,CAC7C,oBAAmB,IAAI,UAAU,WAAW,CAAE,KAAK,MAAM;WAEzD,YAAW,KAAK,MAAM;AAExB,cAAO,MAAM,UAAU,MAAM;AAC7B;;;AAKJ,SAAI,MAAM,SAAS,UAAU,eAAe;MAC1C,MAAM,WAAW;MACjB,MAAM,SAAS,cAAc,IAAI,SAAS,WAAW;AACrD,UAAI,QAAQ;OAEV,MAAM,gBAAoC;QACxC,MAAM,UAAU;QAChB,WAAW,OAAO;QAClB,cAAc;QACd,OAAO,CAAC;SAAE,IAAI;SAAO,MAAM;SAAe,OAAO;SAAO,CAAC;QAC1D;AACD,kBAAW,KAAK,cAAc;AAE9B,WAAI,CAAC,iBAAiB,IAAI,SAAS,WAAW,CAC5C,oBAAmB,IAAI,SAAS,WAAW,CAAE,KAAK,MAAM;WAExD,YAAW,KAAK,MAAM;AAExB;;;AAIJ,gBAAW,KAAK,MAAM;;IAExB,QAAQ,QAAQ;AAEd,UAAK,MAAM,GAAG,WAAW,mBACvB,MAAK,MAAM,SAAS,OAClB,YAAW,KAAK,MAAM;AAG1B,wBAAmB,OAAO;AAE1B,SAAI,iBAAiB;AACnB,iBAAW,KAAK,gBAAgB;AAChC,wBAAkB;;AAEpB,gBAAW,MAAM,IAAI;;IAEvB,gBAAgB;AAEd,wBAAmB,SAAS,GAAG,eAAe;AAC5C,sBAAgB,WAAW;OAC3B;AAEF,SAAI,iBAAiB;AACnB,iBAAW,KAAK,gBAAgB;AAChC,wBAAkB;;AAEpB,mBAAc,OAAO;AACrB,gBAAW,UAAU;;IAExB,CAAC;AAEF,gBAAa,aAAa,aAAa;IACvC"}
1
+ {"version":3,"file":"open-generative-ui-middleware.mjs","names":[],"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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"}
@@ -0,0 +1,329 @@
1
+ const require_basic_functions = require('../basic-functions.cjs');
2
+ const require_is_record = require('../is-record.cjs');
3
+ const require_child_refs = require('../child-refs.cjs');
4
+ const require_json_schema = require('./json-schema.cjs');
5
+
6
+ //#region src/generative-ui/catalog/catalog-export.ts
7
+ const COMMON = "common_types.json#/$defs/";
8
+ const DATA_BINDING_REF = `${COMMON}DataBinding`;
9
+ const FUNCTION_CALL_REF = `${COMMON}FunctionCall`;
10
+ const ACTION_REF = `${COMMON}Action`;
11
+ const DYNAMIC_REFS = {
12
+ string: `${COMMON}DynamicString`,
13
+ number: `${COMMON}DynamicNumber`,
14
+ boolean: `${COMMON}DynamicBoolean`,
15
+ "string[]": `${COMMON}DynamicStringList`,
16
+ unknown: `${COMMON}DynamicValue`
17
+ };
18
+ /**
19
+ * The A2UI 1.0 catalog definition of a generative UI, as a JSON value that
20
+ * follows `catalog_definition.json`: one `components` entry per component,
21
+ * with `component` as a `const`, `functions` for the built-ins and the
22
+ * declared functions, and `$defs.anyComponent` / `$defs.anyFunction`. Other
23
+ * A2UI tools (a validator, another renderer, a prompt builder) read it.
24
+ *
25
+ * - A prop that `child()` or `childList()` marks is a `ComponentId` or a
26
+ * `ChildList` reference; so is a slot. An event prop is an `Action`.
27
+ * - Every other value, at any depth of a prop or of the args of a declared
28
+ * function, takes its literal schema, a `DataBinding` or a `FunctionCall`,
29
+ * because the renderer resolves dynamic values at any depth.
30
+ * - Every function states `returnType` and `allowedCallers`: the built-ins
31
+ * are `rendererOnly`, and so is a declared function without
32
+ * `allowedCallers`, as in A2UI 1.0.
33
+ *
34
+ * @param ui - The generative UI to describe.
35
+ * @param options - The title, description and instructions of the catalog.
36
+ *
37
+ * @example
38
+ * ```ts
39
+ * const catalog = exportA2UICatalog(shopUI, { title: "Acme shop" });
40
+ * fs.writeFileSync("shop-catalog.json", JSON.stringify(catalog, null, 2));
41
+ * ```
42
+ */
43
+ function exportA2UICatalog(ui, options = {}) {
44
+ const components = Object.fromEntries(Object.entries(ui.manifestComponents).map(([name, manifest]) => [name, toDraft2020(rebaseRefs(componentDefinition(name, manifest), `#/components/${pointerSegment(name)}`))]));
45
+ const functions = {};
46
+ for (const [name, info] of Object.entries(require_basic_functions.GENERATIVE_UI_FUNCTIONS)) {
47
+ if (ui.functions.has(name)) continue;
48
+ functions[name] = functionEntry(name, info, {
49
+ description: info.description,
50
+ returnType: info.returnType,
51
+ args: argsSchemaFromSignature(info.parameters)
52
+ });
53
+ }
54
+ for (const [name, fn] of ui.functions) functions[name] = functionEntry(name, fn, {
55
+ description: fn.description,
56
+ returnType: fn.returnType ?? "any",
57
+ args: toDraft2020(rebaseRefs(dynamicArgs(require_json_schema.toJsonSchema(fn.parameters)), `#/functions/${pointerSegment(name)}/properties/args`))
58
+ });
59
+ const { title, description, instructions } = options;
60
+ return {
61
+ $schema: "https://json-schema.org/draft/2020-12/schema",
62
+ protocolVersion: "1.0",
63
+ catalogId: ui.id,
64
+ ...title === void 0 ? {} : { title },
65
+ ...description === void 0 ? {} : { description },
66
+ ...instructions === void 0 ? {} : { instructions },
67
+ components,
68
+ functions,
69
+ $defs: {
70
+ anyComponent: {
71
+ ...oneOfRefs("components", Object.keys(components)),
72
+ discriminator: { propertyName: "component" }
73
+ },
74
+ anyFunction: oneOfRefs("functions", Object.keys(functions))
75
+ }
76
+ };
77
+ }
78
+ /**
79
+ * `oneOf` over the entries of a section. JSON Schema wants at least one
80
+ * variant, so an empty section (a UI with no components) matches nothing.
81
+ */
82
+ function oneOfRefs(section, names) {
83
+ if (names.length === 0) return { not: {} };
84
+ return { oneOf: names.map((name) => ({ $ref: `#/${section}/${pointerSegment(name)}` })) };
85
+ }
86
+ /** A name as a JSON Pointer segment in a URI fragment: `acme/Card` is `acme~1Card`. */
87
+ function pointerSegment(name) {
88
+ return encodeURIComponent(name.replace(/~/g, "~0").replace(/\//g, "~1"));
89
+ }
90
+ /** Keywords whose value is data, not a schema. */
91
+ const LITERAL_KEYWORDS = new Set([
92
+ "default",
93
+ "const",
94
+ "enum",
95
+ "examples"
96
+ ]);
97
+ /**
98
+ * A schema in the draft 2020-12 dialect that the catalog declares. The
99
+ * converter writes draft-07, where a tuple is `items: [...]` with
100
+ * `additionalItems`; 2020-12 spells that `prefixItems` and `items`.
101
+ */
102
+ function toDraft2020(schema) {
103
+ return mapSchema(schema, (node) => {
104
+ const { items, additionalItems, ...rest } = node;
105
+ if (!Array.isArray(items)) return node;
106
+ return {
107
+ ...rest,
108
+ prefixItems: items,
109
+ ...additionalItems === void 0 ? {} : { items: additionalItems }
110
+ };
111
+ });
112
+ }
113
+ /** One `components` entry: the props as the model sets them, with the A2UI common types. */
114
+ function componentDefinition(name, manifest) {
115
+ const { properties, required, description, $defs, definitions } = manifest.props;
116
+ const props = Object.fromEntries(Object.entries(require_is_record.isRecord(properties) ? properties : {}).map(([key, schema]) => [key, dynamicProp(schema)]));
117
+ const events = Object.fromEntries(Object.entries(manifest.events ?? {}).map(([key, event]) => [key, {
118
+ $ref: ACTION_REF,
119
+ ...event.description ? { description: event.description } : {}
120
+ }]));
121
+ const slots = Object.fromEntries(Object.entries(manifest.slots ?? {}).map(([key, kind]) => [key, { $ref: kind === "single" ? require_child_refs.A2UI_COMPONENT_ID_REF : require_child_refs.A2UI_CHILD_LIST_REF }]));
122
+ const fields = {
123
+ ...props,
124
+ ...events,
125
+ ...slots
126
+ };
127
+ const orderedFields = manifest.parameterOrder === void 0 ? fields : Object.fromEntries([...new Set([...manifest.parameterOrder, ...Object.keys(fields)])].filter((key) => require_is_record.hasOwnKey(fields, key)).map((key) => [key, fields[key]]));
128
+ const text = manifest.description ?? description;
129
+ return {
130
+ type: "object",
131
+ ...typeof text === "string" ? { description: text } : {},
132
+ properties: {
133
+ component: { const: name },
134
+ ...orderedFields
135
+ },
136
+ required: ["component", ...Array.isArray(required) ? required.filter(isString) : []],
137
+ ...withDynamicChildren({
138
+ ...require_is_record.isRecord($defs) ? { $defs } : {},
139
+ ...require_is_record.isRecord(definitions) ? { definitions } : {}
140
+ })
141
+ };
142
+ }
143
+ /**
144
+ * The schema with its local references (`#/...`) pointing into the place
145
+ * it is embedded at. A converter that writes `$defs` refers to them from
146
+ * the root of its own document; inside the catalog, that root is `base`.
147
+ */
148
+ function rebaseRefs(schema, base) {
149
+ return mapSchema(schema, (node) => {
150
+ const ref = node.$ref;
151
+ if (ref === "#") return {
152
+ ...node,
153
+ $ref: base
154
+ };
155
+ if (typeof ref === "string" && ref.startsWith("#/")) return {
156
+ ...node,
157
+ $ref: `${base}${ref.slice(1)}`
158
+ };
159
+ return node;
160
+ });
161
+ }
162
+ /** Keywords whose value is a map from a name to a schema. */
163
+ const SCHEMA_MAP_KEYWORDS = new Set([
164
+ "properties",
165
+ "patternProperties",
166
+ "$defs",
167
+ "definitions",
168
+ "dependentSchemas"
169
+ ]);
170
+ /**
171
+ * Walks a JSON Schema and rebuilds each schema node with `transform`, the
172
+ * children first. The names in `properties` and the definition maps are
173
+ * names, not keywords: a prop called `default` is a schema, while the
174
+ * `default` of a schema is data and stays as it is.
175
+ */
176
+ function mapSchema(schema, transform) {
177
+ const visitValue = (value) => {
178
+ if (Array.isArray(value)) return value.map(visitValue);
179
+ return require_is_record.isRecord(value) ? visitNode(value) : value;
180
+ };
181
+ const visitNode = (node) => {
182
+ const result = {};
183
+ for (const [key, value] of Object.entries(node)) if (LITERAL_KEYWORDS.has(key)) result[key] = value;
184
+ else if (SCHEMA_MAP_KEYWORDS.has(key) && require_is_record.isRecord(value)) result[key] = Object.fromEntries(Object.entries(value).map(([name, entry]) => [name, require_is_record.isRecord(entry) ? visitNode(entry) : entry]));
185
+ else result[key] = visitValue(value);
186
+ return transform(result);
187
+ };
188
+ return visitNode(schema);
189
+ }
190
+ const isString = (value) => typeof value === "string";
191
+ /**
192
+ * A prop as the catalog states it. A component reference stays one. Any
193
+ * other value takes its literal schema, a data binding or a function call,
194
+ * and so does every value inside it: the properties of an object, the
195
+ * values of a record and the items of a list, because the renderer
196
+ * resolves dynamic values at any depth. The variants of a union are
197
+ * transformed in place.
198
+ */
199
+ function dynamicProp(schema) {
200
+ if (!require_is_record.isRecord(schema)) return { $ref: DYNAMIC_REFS.unknown };
201
+ if (require_child_refs.childRefKind(schema)) return schema;
202
+ const { description, ...literal } = withDynamicChildren(schema);
203
+ return {
204
+ ...typeof description === "string" ? { description } : {},
205
+ anyOf: [
206
+ literal,
207
+ { $ref: DATA_BINDING_REF },
208
+ { $ref: FUNCTION_CALL_REF }
209
+ ]
210
+ };
211
+ }
212
+ /** The schema with its nested values made dynamic, itself unchanged. */
213
+ function withDynamicChildren(schema) {
214
+ const result = { ...schema };
215
+ if (require_is_record.isRecord(schema.properties)) result.properties = Object.fromEntries(Object.entries(schema.properties).map(([key, value]) => [key, dynamicProp(value)]));
216
+ if (require_is_record.isRecord(schema.items)) result.items = dynamicProp(schema.items);
217
+ if (Array.isArray(schema.items)) result.items = schema.items.map((item) => require_is_record.isRecord(item) ? dynamicProp(item) : item);
218
+ if (require_is_record.isRecord(schema.additionalItems)) result.additionalItems = dynamicProp(schema.additionalItems);
219
+ for (const key of ["$defs", "definitions"]) {
220
+ const defs = schema[key];
221
+ if (require_is_record.isRecord(defs)) result[key] = Object.fromEntries(Object.entries(defs).map(([name, def]) => [name, require_is_record.isRecord(def) ? withDynamicChildren(def) : def]));
222
+ }
223
+ if (Array.isArray(schema.allOf)) result.allOf = schema.allOf.map((part) => require_is_record.isRecord(part) ? withDynamicChildren(part) : part);
224
+ if (require_is_record.isRecord(schema.additionalProperties)) result.additionalProperties = dynamicProp(schema.additionalProperties);
225
+ if (require_is_record.isRecord(schema.patternProperties)) result.patternProperties = Object.fromEntries(Object.entries(schema.patternProperties).map(([pattern, value]) => [pattern, dynamicProp(value)]));
226
+ for (const key of ["anyOf", "oneOf"]) {
227
+ const variants = schema[key];
228
+ if (Array.isArray(variants)) result[key] = variants.map((variant) => require_is_record.isRecord(variant) && !require_child_refs.childRefKind(variant) ? withDynamicChildren(variant) : variant);
229
+ }
230
+ return result;
231
+ }
232
+ /**
233
+ * The args of a declared function as the catalog states them: the object
234
+ * stays an object, each arg takes a value, a binding or a function call.
235
+ */
236
+ function dynamicArgs(schema) {
237
+ return withDynamicChildren(schema);
238
+ }
239
+ /** One `functions` entry, in the A2UI `FunctionDefinition` shape. */
240
+ function functionEntry(name, permissions, parts) {
241
+ const callers = require_basic_functions.functionCallers(permissions);
242
+ const allowedCallers = callers.renderer && callers.agent ? "rendererOrAgent" : callers.agent ? "agentOnly" : "rendererOnly";
243
+ const argsRequired = hasRequiredArgs(parts.args);
244
+ return {
245
+ type: "object",
246
+ ...parts.description ? { description: parts.description } : {},
247
+ returnType: parts.returnType,
248
+ allowedCallers,
249
+ requiresUserActivation: permissions.requiresUserActivation === true,
250
+ properties: {
251
+ "@call": { const: name },
252
+ args: parts.args
253
+ },
254
+ required: argsRequired ? ["@call", "args"] : ["@call"]
255
+ };
256
+ }
257
+ /**
258
+ * True when an empty args object fails the schema: a key is required at
259
+ * its top, in an `allOf` part, or in every variant of an `anyOf` / `oneOf`.
260
+ */
261
+ function hasRequiredArgs(schema) {
262
+ if (!require_is_record.isRecord(schema)) return false;
263
+ if (Array.isArray(schema.required) && schema.required.length > 0) return true;
264
+ if (Array.isArray(schema.allOf) && schema.allOf.some(hasRequiredArgs)) return true;
265
+ for (const key of ["anyOf", "oneOf"]) {
266
+ const variants = schema[key];
267
+ if (Array.isArray(variants) && variants.length > 0) {
268
+ if (variants.every(hasRequiredArgs)) return true;
269
+ }
270
+ }
271
+ return false;
272
+ }
273
+ /**
274
+ * The JSON Schema of the args of a built-in function, from its short
275
+ * TypeScript-like signature (`{ value: number; decimals?: number }`). Each
276
+ * arg takes a literal, a binding or a function call, so a type maps to the
277
+ * A2UI dynamic type; `[name: string]: T` becomes `additionalProperties`.
278
+ *
279
+ * @example
280
+ * ```ts
281
+ * argsSchemaFromSignature("{ value: string; min?: number }");
282
+ * // { type: "object", properties: { value: { $ref: ".../DynamicString" }, min: { $ref: ".../DynamicNumber" } }, required: ["value"], additionalProperties: false }
283
+ * ```
284
+ */
285
+ function argsSchemaFromSignature(signature) {
286
+ const body = signature.trim().replace(/^\{/, "").replace(/\}$/, "");
287
+ const properties = {};
288
+ const required = [];
289
+ let additionalProperties = false;
290
+ for (const part of body.split(";")) {
291
+ const field = part.trim();
292
+ if (field === "") continue;
293
+ const index = field.match(/^\[\w+: string\]:\s*(.+)$/);
294
+ if (index) {
295
+ additionalProperties = typeSchema(index[1]);
296
+ continue;
297
+ }
298
+ const named = field.match(/^(\w+)(\?)?:\s*(.+)$/);
299
+ if (!named) continue;
300
+ properties[named[1]] = typeSchema(named[3]);
301
+ if (!named[2]) required.push(named[1]);
302
+ }
303
+ return {
304
+ type: "object",
305
+ properties,
306
+ ...required.length > 0 ? { required } : {},
307
+ additionalProperties
308
+ };
309
+ }
310
+ function typeSchema(type) {
311
+ const trimmed = type.trim();
312
+ const alternatives = trimmed.split("|").map((part) => part.trim());
313
+ if (alternatives.length > 1) return { anyOf: alternatives.map(typeSchema) };
314
+ if (trimmed in DYNAMIC_REFS) return { $ref: DYNAMIC_REFS[trimmed] };
315
+ if (trimmed.endsWith("[]")) return { anyOf: [
316
+ {
317
+ type: "array",
318
+ items: typeSchema(trimmed.slice(0, -2))
319
+ },
320
+ { $ref: DATA_BINDING_REF },
321
+ { $ref: FUNCTION_CALL_REF }
322
+ ] };
323
+ return { $ref: DYNAMIC_REFS.unknown };
324
+ }
325
+
326
+ //#endregion
327
+ exports.argsSchemaFromSignature = argsSchemaFromSignature;
328
+ exports.exportA2UICatalog = exportA2UICatalog;
329
+ //# sourceMappingURL=catalog-export.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog-export.cjs","names":["GENERATIVE_UI_FUNCTIONS","toJsonSchema","isRecord","A2UI_COMPONENT_ID_REF","A2UI_CHILD_LIST_REF","hasOwnKey","childRefKind","functionCallers"],"sources":["../../../src/generative-ui/catalog/catalog-export.ts"],"sourcesContent":["import {\n A2UI_CHILD_LIST_REF,\n A2UI_COMPONENT_ID_REF,\n GENERATIVE_UI_FUNCTIONS,\n childRefKind,\n functionCallers,\n} from \"../base\";\nimport type {\n A2UIAllowedCallers,\n A2UIFunctionPermissions,\n GenerativeUIComponentManifest,\n GenerativeUIJSONSchema,\n} from \"../base\";\nimport type { GenerativeUI } from \"./catalog\";\nimport { toJsonSchema } from \"./json-schema\";\nimport { hasOwnKey, isRecord } from \"../is-record\";\n\nconst COMMON = \"common_types.json#/$defs/\";\nconst DATA_BINDING_REF = `${COMMON}DataBinding`;\nconst FUNCTION_CALL_REF = `${COMMON}FunctionCall`;\nconst ACTION_REF = `${COMMON}Action`;\nconst DYNAMIC_REFS: Record<string, string> = {\n string: `${COMMON}DynamicString`,\n number: `${COMMON}DynamicNumber`,\n boolean: `${COMMON}DynamicBoolean`,\n \"string[]\": `${COMMON}DynamicStringList`,\n unknown: `${COMMON}DynamicValue`,\n};\n\n/** What `exportA2UICatalog` adds at the top of the catalog. */\nexport interface ExportA2UICatalogOptions {\n /** The title of the catalog. */\n title?: string;\n /** What the catalog is for. */\n description?: string;\n /** Markdown design guidelines for a model that writes this catalog. */\n instructions?: string;\n}\n\n/**\n * The A2UI 1.0 catalog definition of a generative UI, as a JSON value that\n * follows `catalog_definition.json`: one `components` entry per component,\n * with `component` as a `const`, `functions` for the built-ins and the\n * declared functions, and `$defs.anyComponent` / `$defs.anyFunction`. Other\n * A2UI tools (a validator, another renderer, a prompt builder) read it.\n *\n * - A prop that `child()` or `childList()` marks is a `ComponentId` or a\n * `ChildList` reference; so is a slot. An event prop is an `Action`.\n * - Every other value, at any depth of a prop or of the args of a declared\n * function, takes its literal schema, a `DataBinding` or a `FunctionCall`,\n * because the renderer resolves dynamic values at any depth.\n * - Every function states `returnType` and `allowedCallers`: the built-ins\n * are `rendererOnly`, and so is a declared function without\n * `allowedCallers`, as in A2UI 1.0.\n *\n * @param ui - The generative UI to describe.\n * @param options - The title, description and instructions of the catalog.\n *\n * @example\n * ```ts\n * const catalog = exportA2UICatalog(shopUI, { title: \"Acme shop\" });\n * fs.writeFileSync(\"shop-catalog.json\", JSON.stringify(catalog, null, 2));\n * ```\n */\nexport function exportA2UICatalog(\n ui: GenerativeUI,\n options: ExportA2UICatalogOptions = {},\n) {\n const components = Object.fromEntries(\n Object.entries(ui.manifestComponents).map(([name, manifest]) => [\n name,\n toDraft2020(\n rebaseRefs(\n componentDefinition(name, manifest),\n `#/components/${pointerSegment(name)}`,\n ),\n ),\n ]),\n );\n const functions: Record<string, GenerativeUIJSONSchema> = {};\n for (const [name, info] of Object.entries(GENERATIVE_UI_FUNCTIONS)) {\n // A declared function of the same name is the app's.\n if (ui.functions.has(name)) continue;\n functions[name] = functionEntry(name, info, {\n description: info.description,\n returnType: info.returnType,\n args: argsSchemaFromSignature(info.parameters),\n });\n }\n for (const [name, fn] of ui.functions) {\n functions[name] = functionEntry(name, fn, {\n description: fn.description,\n returnType: fn.returnType ?? \"any\",\n args: toDraft2020(\n rebaseRefs(\n dynamicArgs(toJsonSchema(fn.parameters)),\n `#/functions/${pointerSegment(name)}/properties/args`,\n ),\n ),\n });\n }\n const { title, description, instructions } = options;\n return {\n $schema: \"https://json-schema.org/draft/2020-12/schema\",\n protocolVersion: \"1.0\",\n catalogId: ui.id,\n ...(title === undefined ? {} : { title }),\n ...(description === undefined ? {} : { description }),\n ...(instructions === undefined ? {} : { instructions }),\n components,\n functions,\n $defs: {\n anyComponent: {\n ...oneOfRefs(\"components\", Object.keys(components)),\n discriminator: { propertyName: \"component\" },\n },\n anyFunction: oneOfRefs(\"functions\", Object.keys(functions)),\n },\n };\n}\n\n/**\n * `oneOf` over the entries of a section. JSON Schema wants at least one\n * variant, so an empty section (a UI with no components) matches nothing.\n */\nfunction oneOfRefs(section: string, names: string[]) {\n if (names.length === 0) return { not: {} };\n return {\n oneOf: names.map((name) => ({\n $ref: `#/${section}/${pointerSegment(name)}`,\n })),\n };\n}\n\n/** A name as a JSON Pointer segment in a URI fragment: `acme/Card` is `acme~1Card`. */\nfunction pointerSegment(name: string) {\n return encodeURIComponent(name.replace(/~/g, \"~0\").replace(/\\//g, \"~1\"));\n}\n\n/** Keywords whose value is data, not a schema. */\nconst LITERAL_KEYWORDS = new Set([\"default\", \"const\", \"enum\", \"examples\"]);\n\n/**\n * A schema in the draft 2020-12 dialect that the catalog declares. The\n * converter writes draft-07, where a tuple is `items: [...]` with\n * `additionalItems`; 2020-12 spells that `prefixItems` and `items`.\n */\nfunction toDraft2020(schema: GenerativeUIJSONSchema): GenerativeUIJSONSchema {\n return mapSchema(schema, (node) => {\n const { items, additionalItems, ...rest } = node;\n if (!Array.isArray(items)) return node;\n return {\n ...rest,\n prefixItems: items,\n ...(additionalItems === undefined ? {} : { items: additionalItems }),\n };\n });\n}\n\n/** One `components` entry: the props as the model sets them, with the A2UI common types. */\nfunction componentDefinition(\n name: string,\n manifest: GenerativeUIComponentManifest,\n): GenerativeUIJSONSchema {\n const { properties, required, description, $defs, definitions } =\n manifest.props;\n const props = Object.fromEntries(\n Object.entries(isRecord(properties) ? properties : {}).map(\n ([key, schema]) => [key, dynamicProp(schema)],\n ),\n );\n const events = Object.fromEntries(\n Object.entries(manifest.events ?? {}).map(([key, event]) => [\n key,\n {\n $ref: ACTION_REF,\n ...(event.description ? { description: event.description } : {}),\n },\n ]),\n );\n const slots = Object.fromEntries(\n Object.entries(manifest.slots ?? {}).map(([key, kind]) => [\n key,\n { $ref: kind === \"single\" ? A2UI_COMPONENT_ID_REF : A2UI_CHILD_LIST_REF },\n ]),\n );\n const fields = { ...props, ...events, ...slots };\n const orderedFields =\n manifest.parameterOrder === undefined\n ? fields\n : Object.fromEntries(\n [...new Set([...manifest.parameterOrder, ...Object.keys(fields)])]\n .filter((key) => hasOwnKey(fields, key))\n .map((key) => [key, fields[key]]),\n );\n const text = manifest.description ?? description;\n return {\n type: \"object\",\n ...(typeof text === \"string\" ? { description: text } : {}),\n properties: { component: { const: name }, ...orderedFields },\n required: [\n \"component\",\n ...(Array.isArray(required) ? required.filter(isString) : []),\n ],\n // The definitions of the props schema, when its converter made some:\n // their values are dynamic like the props, and the references to them\n // are rebased onto this entry.\n ...withDynamicChildren({\n ...(isRecord($defs) ? { $defs } : {}),\n ...(isRecord(definitions) ? { definitions } : {}),\n }),\n };\n}\n\n/**\n * The schema with its local references (`#/...`) pointing into the place\n * it is embedded at. A converter that writes `$defs` refers to them from\n * the root of its own document; inside the catalog, that root is `base`.\n */\nfunction rebaseRefs(\n schema: GenerativeUIJSONSchema,\n base: string,\n): GenerativeUIJSONSchema {\n return mapSchema(schema, (node) => {\n const ref = node.$ref;\n // \"#\" is the root of the embedded schema (a recursive one refers to it).\n if (ref === \"#\") return { ...node, $ref: base };\n if (typeof ref === \"string\" && ref.startsWith(\"#/\")) {\n return { ...node, $ref: `${base}${ref.slice(1)}` };\n }\n return node;\n });\n}\n\n/** Keywords whose value is a map from a name to a schema. */\nconst SCHEMA_MAP_KEYWORDS = new Set([\n \"properties\",\n \"patternProperties\",\n \"$defs\",\n \"definitions\",\n \"dependentSchemas\",\n]);\n\n/**\n * Walks a JSON Schema and rebuilds each schema node with `transform`, the\n * children first. The names in `properties` and the definition maps are\n * names, not keywords: a prop called `default` is a schema, while the\n * `default` of a schema is data and stays as it is.\n */\nfunction mapSchema(\n schema: GenerativeUIJSONSchema,\n transform: (node: Record<string, unknown>) => Record<string, unknown>,\n): GenerativeUIJSONSchema {\n const visitValue = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(visitValue);\n return isRecord(value) ? visitNode(value) : value;\n };\n const visitNode = (\n node: Record<string, unknown>,\n ): Record<string, unknown> => {\n const result: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(node)) {\n if (LITERAL_KEYWORDS.has(key)) result[key] = value;\n else if (SCHEMA_MAP_KEYWORDS.has(key) && isRecord(value)) {\n result[key] = Object.fromEntries(\n Object.entries(value).map(([name, entry]) => [\n name,\n isRecord(entry) ? visitNode(entry) : entry,\n ]),\n );\n } else result[key] = visitValue(value);\n }\n return transform(result);\n };\n return visitNode(schema) as GenerativeUIJSONSchema;\n}\n\nconst isString = (value: unknown): value is string => typeof value === \"string\";\n\n/**\n * A prop as the catalog states it. A component reference stays one. Any\n * other value takes its literal schema, a data binding or a function call,\n * and so does every value inside it: the properties of an object, the\n * values of a record and the items of a list, because the renderer\n * resolves dynamic values at any depth. The variants of a union are\n * transformed in place.\n */\nfunction dynamicProp(schema: unknown): GenerativeUIJSONSchema {\n if (!isRecord(schema)) return { $ref: DYNAMIC_REFS.unknown };\n if (childRefKind(schema)) return schema;\n const { description, ...literal } = withDynamicChildren(schema);\n return {\n ...(typeof description === \"string\" ? { description } : {}),\n anyOf: [literal, { $ref: DATA_BINDING_REF }, { $ref: FUNCTION_CALL_REF }],\n };\n}\n\n/** The schema with its nested values made dynamic, itself unchanged. */\nfunction withDynamicChildren(\n schema: Record<string, unknown>,\n): Record<string, unknown> {\n const result = { ...schema };\n if (isRecord(schema.properties)) {\n result.properties = Object.fromEntries(\n Object.entries(schema.properties).map(([key, value]) => [\n key,\n dynamicProp(value),\n ]),\n );\n }\n if (isRecord(schema.items)) result.items = dynamicProp(schema.items);\n // A tuple, as the converter writes it; the catalog spells it prefixItems.\n if (Array.isArray(schema.items)) {\n result.items = schema.items.map((item) =>\n isRecord(item) ? dynamicProp(item) : item,\n );\n }\n if (isRecord(schema.additionalItems)) {\n result.additionalItems = dynamicProp(schema.additionalItems);\n }\n // The definitions a converter wrote: referenced from value positions.\n for (const key of [\"$defs\", \"definitions\"] as const) {\n const defs = schema[key];\n if (isRecord(defs)) {\n result[key] = Object.fromEntries(\n Object.entries(defs).map(([name, def]) => [\n name,\n isRecord(def) ? withDynamicChildren(def) : def,\n ]),\n );\n }\n }\n if (Array.isArray(schema.allOf)) {\n result.allOf = schema.allOf.map((part) =>\n isRecord(part) ? withDynamicChildren(part) : part,\n );\n }\n // The values of a record, by any key or by key pattern.\n if (isRecord(schema.additionalProperties)) {\n result.additionalProperties = dynamicProp(schema.additionalProperties);\n }\n if (isRecord(schema.patternProperties)) {\n result.patternProperties = Object.fromEntries(\n Object.entries(schema.patternProperties).map(([pattern, value]) => [\n pattern,\n dynamicProp(value),\n ]),\n );\n }\n for (const key of [\"anyOf\", \"oneOf\"] as const) {\n const variants = schema[key];\n if (Array.isArray(variants)) {\n result[key] = variants.map((variant) =>\n isRecord(variant) && !childRefKind(variant)\n ? withDynamicChildren(variant)\n : variant,\n );\n }\n }\n return result;\n}\n\n/**\n * The args of a declared function as the catalog states them: the object\n * stays an object, each arg takes a value, a binding or a function call.\n */\nfunction dynamicArgs(schema: GenerativeUIJSONSchema): GenerativeUIJSONSchema {\n return withDynamicChildren(schema);\n}\n\n/** One `functions` entry, in the A2UI `FunctionDefinition` shape. */\nfunction functionEntry(\n name: string,\n permissions: A2UIFunctionPermissions,\n parts: {\n description: string | undefined;\n returnType: string;\n args: GenerativeUIJSONSchema;\n },\n): GenerativeUIJSONSchema {\n const callers = functionCallers(permissions);\n const allowedCallers: A2UIAllowedCallers =\n callers.renderer && callers.agent\n ? \"rendererOrAgent\"\n : callers.agent\n ? \"agentOnly\"\n : \"rendererOnly\";\n // The metaschema's activation rule has no `required`, so it also matches\n // an entry without the key: the value is always written out.\n // `args` is required only when an arg is.\n const argsRequired = hasRequiredArgs(parts.args);\n return {\n type: \"object\",\n ...(parts.description ? { description: parts.description } : {}),\n returnType: parts.returnType,\n allowedCallers,\n requiresUserActivation: permissions.requiresUserActivation === true,\n properties: { \"@call\": { const: name }, args: parts.args },\n required: argsRequired ? [\"@call\", \"args\"] : [\"@call\"],\n };\n}\n\n/**\n * True when an empty args object fails the schema: a key is required at\n * its top, in an `allOf` part, or in every variant of an `anyOf` / `oneOf`.\n */\nfunction hasRequiredArgs(schema: unknown): boolean {\n if (!isRecord(schema)) return false;\n if (Array.isArray(schema.required) && schema.required.length > 0) return true;\n if (Array.isArray(schema.allOf) && schema.allOf.some(hasRequiredArgs)) {\n return true;\n }\n for (const key of [\"anyOf\", \"oneOf\"] as const) {\n const variants = schema[key];\n if (Array.isArray(variants) && variants.length > 0) {\n if (variants.every(hasRequiredArgs)) return true;\n }\n }\n return false;\n}\n\n/**\n * The JSON Schema of the args of a built-in function, from its short\n * TypeScript-like signature (`{ value: number; decimals?: number }`). Each\n * arg takes a literal, a binding or a function call, so a type maps to the\n * A2UI dynamic type; `[name: string]: T` becomes `additionalProperties`.\n *\n * @example\n * ```ts\n * argsSchemaFromSignature(\"{ value: string; min?: number }\");\n * // { type: \"object\", properties: { value: { $ref: \".../DynamicString\" }, min: { $ref: \".../DynamicNumber\" } }, required: [\"value\"], additionalProperties: false }\n * ```\n */\nexport function argsSchemaFromSignature(\n signature: string,\n): GenerativeUIJSONSchema {\n const body = signature.trim().replace(/^\\{/, \"\").replace(/\\}$/, \"\");\n const properties: Record<string, GenerativeUIJSONSchema> = {};\n const required: string[] = [];\n let additionalProperties: GenerativeUIJSONSchema | false = false;\n for (const part of body.split(\";\")) {\n const field = part.trim();\n if (field === \"\") continue;\n const index = field.match(/^\\[\\w+: string\\]:\\s*(.+)$/);\n if (index) {\n additionalProperties = typeSchema(index[1]);\n continue;\n }\n const named = field.match(/^(\\w+)(\\?)?:\\s*(.+)$/);\n if (!named) continue;\n properties[named[1]] = typeSchema(named[3]);\n if (!named[2]) required.push(named[1]);\n }\n return {\n type: \"object\",\n properties,\n ...(required.length > 0 ? { required } : {}),\n additionalProperties,\n };\n}\n\nfunction typeSchema(type: string): GenerativeUIJSONSchema {\n const trimmed = type.trim();\n const alternatives = trimmed.split(\"|\").map((part) => part.trim());\n if (alternatives.length > 1) return { anyOf: alternatives.map(typeSchema) };\n if (trimmed in DYNAMIC_REFS) return { $ref: DYNAMIC_REFS[trimmed] };\n if (trimmed.endsWith(\"[]\")) {\n // The whole list can be bound or computed, like any other arg.\n return {\n anyOf: [\n { type: \"array\", items: typeSchema(trimmed.slice(0, -2)) },\n { $ref: DATA_BINDING_REF },\n { $ref: FUNCTION_CALL_REF },\n ],\n };\n }\n return { $ref: DYNAMIC_REFS.unknown };\n}\n"],"mappings":"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"}
@@ -0,0 +1,92 @@
1
+ import { GenerativeUIJSONSchema } from "../types.cjs";
2
+ import { GenerativeUI } from "./catalog.cjs";
3
+
4
+ //#region src/generative-ui/catalog/catalog-export.d.ts
5
+ /** What `exportA2UICatalog` adds at the top of the catalog. */
6
+ interface ExportA2UICatalogOptions {
7
+ /** The title of the catalog. */
8
+ title?: string;
9
+ /** What the catalog is for. */
10
+ description?: string;
11
+ /** Markdown design guidelines for a model that writes this catalog. */
12
+ instructions?: string;
13
+ }
14
+ /**
15
+ * The A2UI 1.0 catalog definition of a generative UI, as a JSON value that
16
+ * follows `catalog_definition.json`: one `components` entry per component,
17
+ * with `component` as a `const`, `functions` for the built-ins and the
18
+ * declared functions, and `$defs.anyComponent` / `$defs.anyFunction`. Other
19
+ * A2UI tools (a validator, another renderer, a prompt builder) read it.
20
+ *
21
+ * - A prop that `child()` or `childList()` marks is a `ComponentId` or a
22
+ * `ChildList` reference; so is a slot. An event prop is an `Action`.
23
+ * - Every other value, at any depth of a prop or of the args of a declared
24
+ * function, takes its literal schema, a `DataBinding` or a `FunctionCall`,
25
+ * because the renderer resolves dynamic values at any depth.
26
+ * - Every function states `returnType` and `allowedCallers`: the built-ins
27
+ * are `rendererOnly`, and so is a declared function without
28
+ * `allowedCallers`, as in A2UI 1.0.
29
+ *
30
+ * @param ui - The generative UI to describe.
31
+ * @param options - The title, description and instructions of the catalog.
32
+ *
33
+ * @example
34
+ * ```ts
35
+ * const catalog = exportA2UICatalog(shopUI, { title: "Acme shop" });
36
+ * fs.writeFileSync("shop-catalog.json", JSON.stringify(catalog, null, 2));
37
+ * ```
38
+ */
39
+ declare function exportA2UICatalog(ui: GenerativeUI, options?: ExportA2UICatalogOptions): {
40
+ components: {
41
+ [k: string]: GenerativeUIJSONSchema;
42
+ };
43
+ functions: Record<string, GenerativeUIJSONSchema>;
44
+ $defs: {
45
+ anyComponent: {
46
+ discriminator: {
47
+ propertyName: string;
48
+ };
49
+ not: {};
50
+ oneOf?: undefined;
51
+ } | {
52
+ discriminator: {
53
+ propertyName: string;
54
+ };
55
+ oneOf: {
56
+ $ref: string;
57
+ }[];
58
+ not?: undefined;
59
+ };
60
+ anyFunction: {
61
+ not: {};
62
+ oneOf?: undefined;
63
+ } | {
64
+ oneOf: {
65
+ $ref: string;
66
+ }[];
67
+ not?: undefined;
68
+ };
69
+ };
70
+ instructions?: string | undefined;
71
+ description?: string | undefined;
72
+ title?: string | undefined;
73
+ $schema: string;
74
+ protocolVersion: string;
75
+ catalogId: string;
76
+ };
77
+ /**
78
+ * The JSON Schema of the args of a built-in function, from its short
79
+ * TypeScript-like signature (`{ value: number; decimals?: number }`). Each
80
+ * arg takes a literal, a binding or a function call, so a type maps to the
81
+ * A2UI dynamic type; `[name: string]: T` becomes `additionalProperties`.
82
+ *
83
+ * @example
84
+ * ```ts
85
+ * argsSchemaFromSignature("{ value: string; min?: number }");
86
+ * // { type: "object", properties: { value: { $ref: ".../DynamicString" }, min: { $ref: ".../DynamicNumber" } }, required: ["value"], additionalProperties: false }
87
+ * ```
88
+ */
89
+ declare function argsSchemaFromSignature(signature: string): GenerativeUIJSONSchema;
90
+ //#endregion
91
+ export { ExportA2UICatalogOptions, argsSchemaFromSignature, exportA2UICatalog };
92
+ //# sourceMappingURL=catalog-export.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog-export.d.cts","names":[],"sources":["../../../src/generative-ui/catalog/catalog-export.ts"],"mappings":";;;;;UA8BiB,wBAAA;EAAA;EAEf,KAAA;;EAEA,WAAA;EAFA;EAIA,YAAA;AAAA;;;AA4BF;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,iBAAA,CACd,EAAA,EAAI,YAAA,EACJ,OAAA,GAAS,wBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+WK,uBAAA,CACd,SAAA,WACC,sBAAA"}