@copilotkit/shared 1.83.0 → 1.84.1

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 (101) hide show
  1. package/dist/a2ui-catalog-schema.cjs +264 -0
  2. package/dist/a2ui-catalog-schema.cjs.map +1 -0
  3. package/dist/a2ui-catalog-schema.d.cts +112 -0
  4. package/dist/a2ui-catalog-schema.d.cts.map +1 -0
  5. package/dist/a2ui-catalog-schema.d.mts +112 -0
  6. package/dist/a2ui-catalog-schema.d.mts.map +1 -0
  7. package/dist/a2ui-catalog-schema.mjs +259 -0
  8. package/dist/a2ui-catalog-schema.mjs.map +1 -0
  9. package/dist/a2ui-envelope.cjs +2 -2
  10. package/dist/a2ui-envelope.cjs.map +1 -1
  11. package/dist/a2ui-envelope.d.cts +1 -1
  12. package/dist/a2ui-envelope.d.cts.map +1 -1
  13. package/dist/a2ui-envelope.d.mts +1 -1
  14. package/dist/a2ui-envelope.d.mts.map +1 -1
  15. package/dist/a2ui-envelope.mjs +2 -2
  16. package/dist/a2ui-envelope.mjs.map +1 -1
  17. package/dist/a2ui-prompts.cjs +21 -62
  18. package/dist/a2ui-prompts.cjs.map +1 -1
  19. package/dist/a2ui-prompts.d.cts +8 -1
  20. package/dist/a2ui-prompts.d.cts.map +1 -1
  21. package/dist/a2ui-prompts.d.mts +8 -1
  22. package/dist/a2ui-prompts.d.mts.map +1 -1
  23. package/dist/a2ui-prompts.mjs +22 -62
  24. package/dist/a2ui-prompts.mjs.map +1 -1
  25. package/dist/generative-ui/basic-functions.cjs +1 -1
  26. package/dist/generative-ui/basic-functions.cjs.map +1 -1
  27. package/dist/generative-ui/basic-functions.mjs +1 -1
  28. package/dist/generative-ui/basic-functions.mjs.map +1 -1
  29. package/dist/generative-ui/compact-schema.cjs +187 -0
  30. package/dist/generative-ui/compact-schema.cjs.map +1 -0
  31. package/dist/generative-ui/compact-schema.d.cts +55 -0
  32. package/dist/generative-ui/compact-schema.d.cts.map +1 -0
  33. package/dist/generative-ui/compact-schema.d.mts +55 -0
  34. package/dist/generative-ui/compact-schema.d.mts.map +1 -0
  35. package/dist/generative-ui/compact-schema.mjs +185 -0
  36. package/dist/generative-ui/compact-schema.mjs.map +1 -0
  37. package/dist/generative-ui/prompt-spec.cjs +225 -0
  38. package/dist/generative-ui/prompt-spec.cjs.map +1 -0
  39. package/dist/generative-ui/prompt-spec.d.cts +94 -0
  40. package/dist/generative-ui/prompt-spec.d.cts.map +1 -0
  41. package/dist/generative-ui/prompt-spec.d.mts +94 -0
  42. package/dist/generative-ui/prompt-spec.d.mts.map +1 -0
  43. package/dist/generative-ui/prompt-spec.mjs +220 -0
  44. package/dist/generative-ui/prompt-spec.mjs.map +1 -0
  45. package/dist/generative-ui/prompt.cjs +10 -36
  46. package/dist/generative-ui/prompt.cjs.map +1 -1
  47. package/dist/generative-ui/prompt.d.cts +2 -1
  48. package/dist/generative-ui/prompt.d.cts.map +1 -1
  49. package/dist/generative-ui/prompt.d.mts +2 -1
  50. package/dist/generative-ui/prompt.d.mts.map +1 -1
  51. package/dist/generative-ui/prompt.mjs +12 -38
  52. package/dist/generative-ui/prompt.mjs.map +1 -1
  53. package/dist/generative-ui/schema-render.cjs +242 -0
  54. package/dist/generative-ui/schema-render.cjs.map +1 -0
  55. package/dist/generative-ui/schema-render.d.cts +44 -0
  56. package/dist/generative-ui/schema-render.d.cts.map +1 -0
  57. package/dist/generative-ui/schema-render.d.mts +44 -0
  58. package/dist/generative-ui/schema-render.d.mts.map +1 -0
  59. package/dist/generative-ui/schema-render.mjs +239 -0
  60. package/dist/generative-ui/schema-render.mjs.map +1 -0
  61. package/dist/generative-ui/types.cjs +2 -2
  62. package/dist/generative-ui/types.cjs.map +1 -1
  63. package/dist/generative-ui/types.d.cts +7 -7
  64. package/dist/generative-ui/types.d.cts.map +1 -1
  65. package/dist/generative-ui/types.d.mts +7 -7
  66. package/dist/generative-ui/types.d.mts.map +1 -1
  67. package/dist/generative-ui/types.mjs +2 -2
  68. package/dist/generative-ui/types.mjs.map +1 -1
  69. package/dist/index.cjs +20 -0
  70. package/dist/index.cjs.map +1 -1
  71. package/dist/index.d.cts +5 -1
  72. package/dist/index.d.cts.map +1 -1
  73. package/dist/index.d.mts +5 -1
  74. package/dist/index.d.mts.map +1 -1
  75. package/dist/index.mjs +5 -1
  76. package/dist/index.mjs.map +1 -1
  77. package/dist/index.umd.js +1023 -169
  78. package/dist/index.umd.js.map +1 -1
  79. package/dist/package.cjs +1 -1
  80. package/dist/package.mjs +1 -1
  81. package/package.json +1 -1
  82. package/src/__tests__/a2ui-catalog-schema.test.ts +403 -0
  83. package/src/__tests__/a2ui-envelope.test.ts +18 -13
  84. package/src/__tests__/a2ui-prompts.test.ts +47 -14
  85. package/src/__tests__/fixtures/prompt-goldens.json +354 -0
  86. package/src/__tests__/prompt-spec.test.ts +191 -0
  87. package/src/__tests__/schema-render.test.ts +245 -0
  88. package/src/a2ui-catalog-schema.ts +404 -0
  89. package/src/a2ui-envelope.ts +5 -5
  90. package/src/a2ui-prompts.ts +47 -96
  91. package/src/generative-ui/__tests__/render-ui-args.test.ts +7 -7
  92. package/src/generative-ui/__tests__/validate-operation.test.ts +19 -13
  93. package/src/generative-ui/basic-functions.ts +1 -1
  94. package/src/generative-ui/compact-schema.ts +277 -0
  95. package/src/generative-ui/index.ts +3 -0
  96. package/src/generative-ui/prompt-spec.ts +335 -0
  97. package/src/generative-ui/prompt.ts +25 -75
  98. package/src/generative-ui/schema-render.ts +374 -0
  99. package/src/generative-ui/types.ts +10 -7
  100. package/src/index.ts +13 -0
  101. package/src/utils/__tests__/conditions.test.ts +153 -43
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema-render.cjs","names":["compactType","compactProps","functionCallers","GENERATIVE_UI_AGENT_FUNCTION_CALLS","buildCompactGenerativeUISchema"],"sources":["../../src/generative-ui/schema-render.ts"],"sourcesContent":["import { functionCallers } from \"./basic-functions\";\nimport {\n buildCompactGenerativeUISchema,\n compactProps,\n compactType,\n} from \"./compact-schema\";\nimport type { GenerativeUISchemaSettings } from \"./prompt-spec\";\nimport { GENERATIVE_UI_AGENT_FUNCTION_CALLS } from \"./types\";\nimport type {\n GenerativeUIComponentManifest,\n GenerativeUIJSONSchema,\n GenerativeUIManifest,\n} from \"./types\";\n\ntype SchemaManifest = Pick<\n GenerativeUIManifest,\n \"catalogId\" | \"components\" | \"functions\" | \"targets\" | \"surfaces\"\n>;\n\n/** An own key (shared compiles to ES2017, which has no Object.hasOwn). */\nconst hasOwn = (target: object, key: string) =>\n Object.prototype.hasOwnProperty.call(target, key);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** The props schema without the description of each prop. */\nfunction withoutPropDescriptions(\n schema: GenerativeUIJSONSchema,\n): GenerativeUIJSONSchema {\n if (!isRecord(schema.properties)) return schema;\n return {\n ...schema,\n properties: Object.fromEntries(\n Object.entries(schema.properties).map(([key, value]) => {\n if (!isRecord(value)) return [key, value];\n const { description: _description, ...rest } = value;\n return [key, rest];\n }),\n ),\n };\n}\n\n/** The short signature of a function: its built-in signature, or its schema made short. */\nfunction functionSignature(fn: GenerativeUIManifest[\"functions\"][string]) {\n const signature = fn.parameters.description;\n const hasSignature =\n typeof signature === \"string\" &&\n signature.startsWith(\"{\") &&\n Object.keys(fn.parameters).length === 2;\n return hasSignature ? signature : compactType(fn.parameters, 0);\n}\n\n/**\n * A function name with its parameters: `pick{ id: string }`, `clearCart{}`\n * for no arguments, `setVolume(number)` for a parameter that is not an object.\n */\nfunction nameWithParameters(name: string, parameters: string) {\n if (parameters.startsWith(\"{\")) return `${name}${parameters}`;\n if (parameters === \"object\") return `${name}{}`;\n return `${name}(${parameters})`;\n}\n\n/**\n * One component as a TypeScript-like signature line, with its events and\n * slots on the lines below:\n * `- Text(text?: string // The text): Shows text`.\n */\nfunction signatureLines(\n name: string,\n component: GenerativeUIComponentManifest,\n settings: GenerativeUISchemaSettings,\n) {\n const props = Object.entries(\n compactProps(component.props, settings.propDescriptions),\n ).map(([key, type]) => `${key}: ${type}`);\n const lines = [\n `- ${name}(${props.join(\", \")})${component.description ? `: ${oneLine(component.description)}` : \"\"}`,\n ];\n const events = Object.entries(component.events ?? {}).map(\n ([event, definition]) =>\n `${event}(${definition.description ? oneLine(definition.description) : compactType(definition.parameters, 0)})`,\n );\n if (events.length > 0) lines.push(` events: ${events.join(\", \")}`);\n const slots = Object.entries(component.slots ?? {}).map(\n ([slot, kind]) => `${slot} (${kind})`,\n );\n if (slots.length > 0) lines.push(` slots: ${slots.join(\", \")}`);\n return lines;\n}\n\n/** The whole schema as signature text: targets, functions, components, surfaces. */\nfunction signatureSchema(\n manifest: SchemaManifest,\n settings: GenerativeUISchemaSettings,\n) {\n const targets = manifest.targets.map((t) => {\n const limit = t.components ? `; only ${t.components.join(\", \")}` : \"\";\n return `- ${t.id} (${t.kind}${limit})${t.description ? `: ${oneLine(t.description)}` : \"\"}`;\n });\n const functions = Object.entries(manifest.functions).map(([name, fn]) => {\n const callers = functionCallers(fn);\n const who =\n callers.agent && GENERATIVE_UI_AGENT_FUNCTION_CALLS\n ? callers.renderer\n ? \" (UI or agent)\"\n : \" (agent only)\"\n : \"\";\n return `- ${nameWithParameters(name, functionSignature(fn))}${who}${fn.description ? `: ${oneLine(fn.description)}` : \"\"}`;\n });\n const components = Object.entries(manifest.components).flatMap(\n ([name, component]) => signatureLines(name, component, settings),\n );\n const surfaces = Object.entries(manifest.surfaces).map(\n ([id, s]) =>\n `- ${id} (target ${s.target})${s.status ? ` status: ${s.status}` : \"\"}${s.dataModel ? ` user values: ${JSON.stringify(s.dataModel)}` : \"\"}${(s.rejected ?? []).map((r) => ` rejected: ${r}`).join(\"\")}`,\n );\n return [\n `Catalog: ${manifest.catalogId}`,\n `Targets:\\n${targets.join(\"\\n\") || \"- none\"}`,\n `Functions:\\n${functions.join(\"\\n\") || \"- none\"}`,\n `Components:\\n${components.join(\"\\n\") || \"- none\"}`,\n `Surfaces:\\n${surfaces.join(\"\\n\") || \"- none\"}`,\n ].join(\"\\n\\n\");\n}\n\n/** A description on one line, so its lines cannot read as new entries. */\nfunction oneLine(text: string) {\n return text.replace(/\\s*\\n\\s*/g, \" \");\n}\n\n/** Values that would read as a type or a number once their quotes are gone. */\nconst AMBIGUOUS_VALUE =\n /^(?:string|number|integer|boolean|true|false|null|object|array|unknown|any|-?\\d[\\d.]*)$/;\n\n/**\n * A compact type with bare enum values and tight unions:\n * `\"sm\" | \"md\" | \"lg\"` becomes `sm|md|lg`. A union keeps its quotes when it\n * also holds a type (`\"sm\" | number`) or a value that reads as a type or a\n * number (`\"number\" | \"currency\"`, `\"1\" | \"2\"`), and so do values that are\n * not plain words.\n */\nfunction bareType(type: string) {\n return type\n .replace(\n /\"[A-Za-z0-9_#%.-]+\"(?: \\| \"[A-Za-z0-9_#%.-]+\")*(?! \\|)/g,\n (union: string, offset: number, whole: string) => {\n if (whole.slice(offset - 2, offset) === \"| \") return union;\n const values = union.split(\" | \").map((v) => v.slice(1, -1));\n if (values.some((v) => AMBIGUOUS_VALUE.test(v))) return union;\n return values.join(\"|\");\n },\n )\n .replace(/ \\| /g, \"|\");\n}\n\n/** A compact prop (`type // description`) as `name: type - description`. */\nfunction propLine(key: string, value: string) {\n const name = key.endsWith(\"?\") ? key.slice(0, -1) : `${key}*`;\n const cut = value.indexOf(\" // \");\n const type = bareType(cut < 0 ? value : value.slice(0, cut));\n const text = cut < 0 ? \"\" : value.slice(cut + 4).trim();\n const description = text ? ` - ${oneLine(text)}` : \"\";\n return ` ${name}: ${type}${description}`;\n}\n\n/**\n * The whole schema as plain lines: a header line per component and one\n * indented line per prop: events are `action` props and slots `componentId`\n * or `childList` props. Props are optional unless marked `*`, enum values\n * are bare, and the common props are listed once. It carries the same names, types and descriptions as\n * `compact`, in fewer tokens.\n */\nfunction linesSchema(\n manifest: SchemaManifest,\n settings: GenerativeUISchemaSettings,\n) {\n const compact = buildCompactGenerativeUISchema(manifest, {\n propDescriptions: settings.propDescriptions,\n commonProps: settings.commonProps,\n });\n const targets = compact.targets\n .map((t) => {\n const limit = t.components ? `, only ${t.components.join(\", \")}` : \"\";\n return `${t.id} (${t.kind}${limit})${t.description ? `: ${oneLine(t.description)}` : \"\"}`;\n })\n .join(\"; \");\n const functions = Object.entries(compact.functions).map(\n ([name, fn]) =>\n `${nameWithParameters(name, fn.parameters)}${\"callers\" in fn ? ` (${fn.callers})` : \"\"}${fn.description ? `: ${oneLine(fn.description)}` : \"\"}`,\n );\n const common = compact.commonProps\n ? Object.entries(compact.commonProps).map(([k, v]) => propLine(k, v))\n : [];\n const lineSets = Object.entries(compact.components).map(([name, c]) => ({\n name,\n c,\n own: [\n ...Object.entries(c.props).map(([k, v]) => propLine(k, v)),\n ...Object.entries(c.events ?? {}).map(\n ([e, d]) => ` ${e}: action - ${oneLine(d)}`,\n ),\n ],\n }));\n const components = lineSets.flatMap(({ name, c, own }) => {\n const lines = [\n `${name}${c.includesCommonProps ? \" +common\" : \"\"}${c.description ? `: ${oneLine(c.description)}` : \"\"}`,\n ...own,\n ];\n // Slots are props that take component ids.\n for (const [slot, kind] of Object.entries(c.slots ?? {})) {\n lines.push(\n ` ${slot}: ${kind === \"single\" ? \"componentId\" : \"childList\"}`,\n );\n }\n return lines;\n });\n const surfaces = Object.keys(compact.surfaces).length\n ? JSON.stringify(compact.surfaces)\n : \"none\";\n return [\n `Catalog ${compact.catalogId}. Targets: ${targets || \"none\"}`,\n 'Props are optional unless marked *. a|b|c is one of those strings, quoted when one reads as a type or a number. A component marked +common also takes every common prop. A prop of type action is an event prop: give it {\"event\":{...}} or {\"functionCall\":{...}}. A componentId prop takes one component id; a childList prop takes a list of ids or a template.',\n `Functions:\\n${functions.join(\"\\n\")}`,\n ...(common.length ? [`Common props:\\n${common.join(\"\\n\")}`] : []),\n `Components:\\n${components.join(\"\\n\")}`,\n `Surfaces: ${surfaces}`,\n ].join(\"\\n\\n\");\n}\n\n/**\n * The component schema of the markdown transport, as the text of its\n * context entry, in the notation of `settings`. `compact` is the schema that\n * ships (`buildCompactGenerativeUISchema`), `json-schema` the manifest parts\n * as JSON, `ts-signature` one line per component, `lines` one line per\n * prop with bare enums (the fewest tokens).\n *\n * @example\n * ```ts\n * const value = renderGenerativeUISchema(manifest, spec.schema.markdown);\n * ```\n */\nexport function renderGenerativeUISchema(\n manifest: SchemaManifest,\n settings: GenerativeUISchemaSettings,\n): string {\n switch (settings.notation) {\n case \"compact\":\n return JSON.stringify(\n buildCompactGenerativeUISchema(manifest, {\n propDescriptions: settings.propDescriptions,\n commonProps: settings.commonProps,\n }),\n );\n case \"json-schema\": {\n const components = Object.fromEntries(\n Object.entries(manifest.components).map(([name, c]) => [\n name,\n settings.propDescriptions\n ? c\n : { ...c, props: withoutPropDescriptions(c.props) },\n ]),\n );\n return JSON.stringify({\n catalogId: manifest.catalogId,\n targets: manifest.targets,\n functions: manifest.functions,\n components,\n surfaces: manifest.surfaces,\n });\n }\n case \"ts-signature\":\n return signatureSchema(manifest, settings);\n case \"lines\":\n return linesSchema(manifest, settings);\n }\n}\n\n/**\n * The component list of the tool guide, one entry per component, in the\n * notation of `settings`. `json-schema` is the list that ships.\n */\nexport function renderGenerativeUIComponentList(\n components: GenerativeUIManifest[\"components\"],\n settings: GenerativeUISchemaSettings,\n): string {\n return Object.entries(components)\n .map(([name, c]) => {\n if (\n settings.notation === \"ts-signature\" ||\n settings.notation === \"lines\"\n ) {\n return signatureLines(name, c, settings).join(\"\\n\");\n }\n const props =\n settings.notation === \"compact\"\n ? compactProps(c.props, settings.propDescriptions)\n : settings.propDescriptions\n ? c.props\n : withoutPropDescriptions(c.props);\n const lines = [\n `- **${name}**${c.description ? `: ${oneLine(c.description)}` : \"\"}`,\n ` props: ${JSON.stringify(props)}`,\n ];\n if (c.events) lines.push(` event props: ${JSON.stringify(c.events)}`);\n if (c.slots)\n lines.push(` slot props (component ids): ${JSON.stringify(c.slots)}`);\n return lines.join(\"\\n\");\n })\n .join(\"\\n\");\n}\n\n/**\n * The manifest with replaced descriptions: `\"Name\"` replaces the\n * description of a component, `\"Name.prop\"` the description of one of its\n * props. Keys that name no component or prop are left out of the result\n * and listed in `unknown`. The manifest is not changed.\n */\nexport function applyDescriptionOverrides<\n M extends Pick<GenerativeUIManifest, \"components\">,\n>(\n manifest: M,\n overrides: Record<string, string>,\n): { manifest: M; unknown: string[] } {\n const components = structuredClone(manifest.components);\n const unknown: string[] = [];\n for (const [key, description] of Object.entries(overrides)) {\n const [name, prop, ...rest] = key.split(\".\");\n // Own keys only: \"__proto__\" must never reach Object.prototype.\n const component = hasOwn(components, name) ? components[name] : undefined;\n if (!component || rest.length > 0) {\n unknown.push(key);\n continue;\n }\n if (prop === undefined) {\n component.description = description;\n continue;\n }\n const properties = component.props.properties;\n const property =\n isRecord(properties) && hasOwn(properties, prop)\n ? properties[prop]\n : undefined;\n if (!isRecord(property)) {\n unknown.push(key);\n continue;\n }\n property.description = description;\n }\n return { manifest: { ...manifest, components }, unknown };\n}\n\n/**\n * The components and props of `manifest` whose names do not appear in\n * `rendered`. A schema notation that leaves one out would hide part of the\n * catalog from the model.\n */\nexport function schemaCoverage(\n manifest: Pick<GenerativeUIManifest, \"components\">,\n rendered: string,\n): { missing: string[] } {\n const missing: string[] = [];\n for (const [name, component] of Object.entries(manifest.components)) {\n if (!rendered.includes(name)) missing.push(name);\n const properties = isRecord(component.props.properties)\n ? component.props.properties\n : {};\n for (const prop of Object.keys(properties)) {\n if (!rendered.includes(prop)) missing.push(`${name}.${prop}`);\n }\n }\n return { missing };\n}\n"],"mappings":";;;;;;AAoBA,MAAM,UAAU,QAAgB,QAC9B,OAAO,UAAU,eAAe,KAAK,QAAQ,IAAI;AAEnD,SAAS,SAAS,OAAkD;AAClE,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;;;AAI7E,SAAS,wBACP,QACwB;AACxB,KAAI,CAAC,SAAS,OAAO,WAAW,CAAE,QAAO;AACzC,QAAO;EACL,GAAG;EACH,YAAY,OAAO,YACjB,OAAO,QAAQ,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,WAAW;AACtD,OAAI,CAAC,SAAS,MAAM,CAAE,QAAO,CAAC,KAAK,MAAM;GACzC,MAAM,EAAE,aAAa,cAAc,GAAG,SAAS;AAC/C,UAAO,CAAC,KAAK,KAAK;IAClB,CACH;EACF;;;AAIH,SAAS,kBAAkB,IAA+C;CACxE,MAAM,YAAY,GAAG,WAAW;AAKhC,QAHE,OAAO,cAAc,YACrB,UAAU,WAAW,IAAI,IACzB,OAAO,KAAK,GAAG,WAAW,CAAC,WAAW,IAClB,YAAYA,mCAAY,GAAG,YAAY,EAAE;;;;;;AAOjE,SAAS,mBAAmB,MAAc,YAAoB;AAC5D,KAAI,WAAW,WAAW,IAAI,CAAE,QAAO,GAAG,OAAO;AACjD,KAAI,eAAe,SAAU,QAAO,GAAG,KAAK;AAC5C,QAAO,GAAG,KAAK,GAAG,WAAW;;;;;;;AAQ/B,SAAS,eACP,MACA,WACA,UACA;CAIA,MAAM,QAAQ,CACZ,KAAK,KAAK,GAJE,OAAO,QACnBC,oCAAa,UAAU,OAAO,SAAS,iBAAiB,CACzD,CAAC,KAAK,CAAC,KAAK,UAAU,GAAG,IAAI,IAAI,OAAO,CAEpB,KAAK,KAAK,CAAC,GAAG,UAAU,cAAc,KAAK,QAAQ,UAAU,YAAY,KAAK,KAClG;CACD,MAAM,SAAS,OAAO,QAAQ,UAAU,UAAU,EAAE,CAAC,CAAC,KACnD,CAAC,OAAO,gBACP,GAAG,MAAM,GAAG,WAAW,cAAc,QAAQ,WAAW,YAAY,GAAGD,mCAAY,WAAW,YAAY,EAAE,CAAC,GAChH;AACD,KAAI,OAAO,SAAS,EAAG,OAAM,KAAK,aAAa,OAAO,KAAK,KAAK,GAAG;CACnE,MAAM,QAAQ,OAAO,QAAQ,UAAU,SAAS,EAAE,CAAC,CAAC,KACjD,CAAC,MAAM,UAAU,GAAG,KAAK,IAAI,KAAK,GACpC;AACD,KAAI,MAAM,SAAS,EAAG,OAAM,KAAK,YAAY,MAAM,KAAK,KAAK,GAAG;AAChE,QAAO;;;AAIT,SAAS,gBACP,UACA,UACA;CACA,MAAM,UAAU,SAAS,QAAQ,KAAK,MAAM;EAC1C,MAAM,QAAQ,EAAE,aAAa,UAAU,EAAE,WAAW,KAAK,KAAK,KAAK;AACnE,SAAO,KAAK,EAAE,GAAG,IAAI,EAAE,OAAO,MAAM,GAAG,EAAE,cAAc,KAAK,QAAQ,EAAE,YAAY,KAAK;GACvF;CACF,MAAM,YAAY,OAAO,QAAQ,SAAS,UAAU,CAAC,KAAK,CAAC,MAAM,QAAQ;EACvE,MAAM,UAAUE,wCAAgB,GAAG;EACnC,MAAM,MACJ,QAAQ,SAASC,mDACb,QAAQ,WACN,mBACA,kBACF;AACN,SAAO,KAAK,mBAAmB,MAAM,kBAAkB,GAAG,CAAC,GAAG,MAAM,GAAG,cAAc,KAAK,QAAQ,GAAG,YAAY,KAAK;GACtH;CACF,MAAM,aAAa,OAAO,QAAQ,SAAS,WAAW,CAAC,SACpD,CAAC,MAAM,eAAe,eAAe,MAAM,WAAW,SAAS,CACjE;CACD,MAAM,WAAW,OAAO,QAAQ,SAAS,SAAS,CAAC,KAChD,CAAC,IAAI,OACJ,KAAK,GAAG,WAAW,EAAE,OAAO,GAAG,EAAE,SAAS,YAAY,EAAE,WAAW,KAAK,EAAE,YAAY,iBAAiB,KAAK,UAAU,EAAE,UAAU,KAAK,MAAM,EAAE,YAAY,EAAE,EAAE,KAAK,MAAM,cAAc,IAAI,CAAC,KAAK,GAAG,GACxM;AACD,QAAO;EACL,YAAY,SAAS;EACrB,aAAa,QAAQ,KAAK,KAAK,IAAI;EACnC,eAAe,UAAU,KAAK,KAAK,IAAI;EACvC,gBAAgB,WAAW,KAAK,KAAK,IAAI;EACzC,cAAc,SAAS,KAAK,KAAK,IAAI;EACtC,CAAC,KAAK,OAAO;;;AAIhB,SAAS,QAAQ,MAAc;AAC7B,QAAO,KAAK,QAAQ,aAAa,IAAI;;;AAIvC,MAAM,kBACJ;;;;;;;;AASF,SAAS,SAAS,MAAc;AAC9B,QAAO,KACJ,QACC,4DACC,OAAe,QAAgB,UAAkB;AAChD,MAAI,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,KAAM,QAAO;EACrD,MAAM,SAAS,MAAM,MAAM,MAAM,CAAC,KAAK,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC;AAC5D,MAAI,OAAO,MAAM,MAAM,gBAAgB,KAAK,EAAE,CAAC,CAAE,QAAO;AACxD,SAAO,OAAO,KAAK,IAAI;GAE1B,CACA,QAAQ,SAAS,IAAI;;;AAI1B,SAAS,SAAS,KAAa,OAAe;CAC5C,MAAM,OAAO,IAAI,SAAS,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI;CAC3D,MAAM,MAAM,MAAM,QAAQ,OAAO;CACjC,MAAM,OAAO,SAAS,MAAM,IAAI,QAAQ,MAAM,MAAM,GAAG,IAAI,CAAC;CAC5D,MAAM,OAAO,MAAM,IAAI,KAAK,MAAM,MAAM,MAAM,EAAE,CAAC,MAAM;AAEvD,QAAO,IAAI,KAAK,IAAI,OADA,OAAO,MAAM,QAAQ,KAAK,KAAK;;;;;;;;;AAWrD,SAAS,YACP,UACA,UACA;CACA,MAAM,UAAUC,sDAA+B,UAAU;EACvD,kBAAkB,SAAS;EAC3B,aAAa,SAAS;EACvB,CAAC;CACF,MAAM,UAAU,QAAQ,QACrB,KAAK,MAAM;EACV,MAAM,QAAQ,EAAE,aAAa,UAAU,EAAE,WAAW,KAAK,KAAK,KAAK;AACnE,SAAO,GAAG,EAAE,GAAG,IAAI,EAAE,OAAO,MAAM,GAAG,EAAE,cAAc,KAAK,QAAQ,EAAE,YAAY,KAAK;GACrF,CACD,KAAK,KAAK;CACb,MAAM,YAAY,OAAO,QAAQ,QAAQ,UAAU,CAAC,KACjD,CAAC,MAAM,QACN,GAAG,mBAAmB,MAAM,GAAG,WAAW,GAAG,aAAa,KAAK,KAAK,GAAG,QAAQ,KAAK,KAAK,GAAG,cAAc,KAAK,QAAQ,GAAG,YAAY,KAAK,KAC9I;CACD,MAAM,SAAS,QAAQ,cACnB,OAAO,QAAQ,QAAQ,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO,SAAS,GAAG,EAAE,CAAC,GACnE,EAAE;CAWN,MAAM,aAVW,OAAO,QAAQ,QAAQ,WAAW,CAAC,KAAK,CAAC,MAAM,QAAQ;EACtE;EACA;EACA,KAAK,CACH,GAAG,OAAO,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,SAAS,GAAG,EAAE,CAAC,EAC1D,GAAG,OAAO,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,KAC/B,CAAC,GAAG,OAAO,IAAI,EAAE,aAAa,QAAQ,EAAE,GAC1C,CACF;EACF,EAAE,CACyB,SAAS,EAAE,MAAM,GAAG,UAAU;EACxD,MAAM,QAAQ,CACZ,GAAG,OAAO,EAAE,sBAAsB,aAAa,KAAK,EAAE,cAAc,KAAK,QAAQ,EAAE,YAAY,KAAK,MACpG,GAAG,IACJ;AAED,OAAK,MAAM,CAAC,MAAM,SAAS,OAAO,QAAQ,EAAE,SAAS,EAAE,CAAC,CACtD,OAAM,KACJ,IAAI,KAAK,IAAI,SAAS,WAAW,gBAAgB,cAClD;AAEH,SAAO;GACP;CACF,MAAM,WAAW,OAAO,KAAK,QAAQ,SAAS,CAAC,SAC3C,KAAK,UAAU,QAAQ,SAAS,GAChC;AACJ,QAAO;EACL,WAAW,QAAQ,UAAU,aAAa,WAAW;EACrD;EACA,eAAe,UAAU,KAAK,KAAK;EACnC,GAAI,OAAO,SAAS,CAAC,kBAAkB,OAAO,KAAK,KAAK,GAAG,GAAG,EAAE;EAChE,gBAAgB,WAAW,KAAK,KAAK;EACrC,aAAa;EACd,CAAC,KAAK,OAAO;;;;;;;;;;;;;;AAehB,SAAgB,yBACd,UACA,UACQ;AACR,SAAQ,SAAS,UAAjB;EACE,KAAK,UACH,QAAO,KAAK,UACVA,sDAA+B,UAAU;GACvC,kBAAkB,SAAS;GAC3B,aAAa,SAAS;GACvB,CAAC,CACH;EACH,KAAK,eAAe;GAClB,MAAM,aAAa,OAAO,YACxB,OAAO,QAAQ,SAAS,WAAW,CAAC,KAAK,CAAC,MAAM,OAAO,CACrD,MACA,SAAS,mBACL,IACA;IAAE,GAAG;IAAG,OAAO,wBAAwB,EAAE,MAAM;IAAE,CACtD,CAAC,CACH;AACD,UAAO,KAAK,UAAU;IACpB,WAAW,SAAS;IACpB,SAAS,SAAS;IAClB,WAAW,SAAS;IACpB;IACA,UAAU,SAAS;IACpB,CAAC;;EAEJ,KAAK,eACH,QAAO,gBAAgB,UAAU,SAAS;EAC5C,KAAK,QACH,QAAO,YAAY,UAAU,SAAS;;;;;;;AAQ5C,SAAgB,gCACd,YACA,UACQ;AACR,QAAO,OAAO,QAAQ,WAAW,CAC9B,KAAK,CAAC,MAAM,OAAO;AAClB,MACE,SAAS,aAAa,kBACtB,SAAS,aAAa,QAEtB,QAAO,eAAe,MAAM,GAAG,SAAS,CAAC,KAAK,KAAK;EAErD,MAAM,QACJ,SAAS,aAAa,YAClBH,oCAAa,EAAE,OAAO,SAAS,iBAAiB,GAChD,SAAS,mBACP,EAAE,QACF,wBAAwB,EAAE,MAAM;EACxC,MAAM,QAAQ,CACZ,OAAO,KAAK,IAAI,EAAE,cAAc,KAAK,QAAQ,EAAE,YAAY,KAAK,MAChE,YAAY,KAAK,UAAU,MAAM,GAClC;AACD,MAAI,EAAE,OAAQ,OAAM,KAAK,kBAAkB,KAAK,UAAU,EAAE,OAAO,GAAG;AACtE,MAAI,EAAE,MACJ,OAAM,KAAK,iCAAiC,KAAK,UAAU,EAAE,MAAM,GAAG;AACxE,SAAO,MAAM,KAAK,KAAK;GACvB,CACD,KAAK,KAAK;;;;;;;;AASf,SAAgB,0BAGd,UACA,WACoC;CACpC,MAAM,aAAa,gBAAgB,SAAS,WAAW;CACvD,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,CAAC,KAAK,gBAAgB,OAAO,QAAQ,UAAU,EAAE;EAC1D,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,IAAI,MAAM,IAAI;EAE5C,MAAM,YAAY,OAAO,YAAY,KAAK,GAAG,WAAW,QAAQ;AAChE,MAAI,CAAC,aAAa,KAAK,SAAS,GAAG;AACjC,WAAQ,KAAK,IAAI;AACjB;;AAEF,MAAI,SAAS,QAAW;AACtB,aAAU,cAAc;AACxB;;EAEF,MAAM,aAAa,UAAU,MAAM;EACnC,MAAM,WACJ,SAAS,WAAW,IAAI,OAAO,YAAY,KAAK,GAC5C,WAAW,QACX;AACN,MAAI,CAAC,SAAS,SAAS,EAAE;AACvB,WAAQ,KAAK,IAAI;AACjB;;AAEF,WAAS,cAAc;;AAEzB,QAAO;EAAE,UAAU;GAAE,GAAG;GAAU;GAAY;EAAE;EAAS;;;;;;;AAQ3D,SAAgB,eACd,UACA,UACuB;CACvB,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,CAAC,MAAM,cAAc,OAAO,QAAQ,SAAS,WAAW,EAAE;AACnE,MAAI,CAAC,SAAS,SAAS,KAAK,CAAE,SAAQ,KAAK,KAAK;EAChD,MAAM,aAAa,SAAS,UAAU,MAAM,WAAW,GACnD,UAAU,MAAM,aAChB,EAAE;AACN,OAAK,MAAM,QAAQ,OAAO,KAAK,WAAW,CACxC,KAAI,CAAC,SAAS,SAAS,KAAK,CAAE,SAAQ,KAAK,GAAG,KAAK,GAAG,OAAO;;AAGjE,QAAO,EAAE,SAAS"}
@@ -0,0 +1,44 @@
1
+ import { GenerativeUIManifest } from "./types.cjs";
2
+ import { GenerativeUISchemaSettings } from "./prompt-spec.cjs";
3
+
4
+ //#region src/generative-ui/schema-render.d.ts
5
+ type SchemaManifest = Pick<GenerativeUIManifest, "catalogId" | "components" | "functions" | "targets" | "surfaces">;
6
+ /**
7
+ * The component schema of the markdown transport, as the text of its
8
+ * context entry, in the notation of `settings`. `compact` is the schema that
9
+ * ships (`buildCompactGenerativeUISchema`), `json-schema` the manifest parts
10
+ * as JSON, `ts-signature` one line per component, `lines` one line per
11
+ * prop with bare enums (the fewest tokens).
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * const value = renderGenerativeUISchema(manifest, spec.schema.markdown);
16
+ * ```
17
+ */
18
+ declare function renderGenerativeUISchema(manifest: SchemaManifest, settings: GenerativeUISchemaSettings): string;
19
+ /**
20
+ * The component list of the tool guide, one entry per component, in the
21
+ * notation of `settings`. `json-schema` is the list that ships.
22
+ */
23
+ declare function renderGenerativeUIComponentList(components: GenerativeUIManifest["components"], settings: GenerativeUISchemaSettings): string;
24
+ /**
25
+ * The manifest with replaced descriptions: `"Name"` replaces the
26
+ * description of a component, `"Name.prop"` the description of one of its
27
+ * props. Keys that name no component or prop are left out of the result
28
+ * and listed in `unknown`. The manifest is not changed.
29
+ */
30
+ declare function applyDescriptionOverrides<M extends Pick<GenerativeUIManifest, "components">>(manifest: M, overrides: Record<string, string>): {
31
+ manifest: M;
32
+ unknown: string[];
33
+ };
34
+ /**
35
+ * The components and props of `manifest` whose names do not appear in
36
+ * `rendered`. A schema notation that leaves one out would hide part of the
37
+ * catalog from the model.
38
+ */
39
+ declare function schemaCoverage(manifest: Pick<GenerativeUIManifest, "components">, rendered: string): {
40
+ missing: string[];
41
+ };
42
+ //#endregion
43
+ export { applyDescriptionOverrides, renderGenerativeUIComponentList, renderGenerativeUISchema, schemaCoverage };
44
+ //# sourceMappingURL=schema-render.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema-render.d.cts","names":[],"sources":["../../src/generative-ui/schema-render.ts"],"mappings":";;;;KAcK,cAAA,GAAiB,IAAA,CACpB,oBAAA;;AAHe;;;;;AAuOjB;;;;;;iBAAgB,wBAAA,CACd,QAAA,EAAU,cAAA,EACV,QAAA,EAAU,0BAAA;;;;AAsCZ;iBAAgB,+BAAA,CACd,UAAA,EAAY,oBAAA,gBACZ,QAAA,EAAU,0BAAA;;;;;;;iBAkCI,yBAAA,WACJ,IAAA,CAAK,oBAAA,gBAAA,CAEf,QAAA,EAAU,CAAA,EACV,SAAA,EAAW,MAAA;EACR,QAAA,EAAU,CAAA;EAAG,OAAA;AAAA;;;;;;iBAkCF,cAAA,CACd,QAAA,EAAU,IAAA,CAAK,oBAAA,iBACf,QAAA;EACG,OAAA;AAAA"}
@@ -0,0 +1,44 @@
1
+ import { GenerativeUIManifest } from "./types.mjs";
2
+ import { GenerativeUISchemaSettings } from "./prompt-spec.mjs";
3
+
4
+ //#region src/generative-ui/schema-render.d.ts
5
+ type SchemaManifest = Pick<GenerativeUIManifest, "catalogId" | "components" | "functions" | "targets" | "surfaces">;
6
+ /**
7
+ * The component schema of the markdown transport, as the text of its
8
+ * context entry, in the notation of `settings`. `compact` is the schema that
9
+ * ships (`buildCompactGenerativeUISchema`), `json-schema` the manifest parts
10
+ * as JSON, `ts-signature` one line per component, `lines` one line per
11
+ * prop with bare enums (the fewest tokens).
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * const value = renderGenerativeUISchema(manifest, spec.schema.markdown);
16
+ * ```
17
+ */
18
+ declare function renderGenerativeUISchema(manifest: SchemaManifest, settings: GenerativeUISchemaSettings): string;
19
+ /**
20
+ * The component list of the tool guide, one entry per component, in the
21
+ * notation of `settings`. `json-schema` is the list that ships.
22
+ */
23
+ declare function renderGenerativeUIComponentList(components: GenerativeUIManifest["components"], settings: GenerativeUISchemaSettings): string;
24
+ /**
25
+ * The manifest with replaced descriptions: `"Name"` replaces the
26
+ * description of a component, `"Name.prop"` the description of one of its
27
+ * props. Keys that name no component or prop are left out of the result
28
+ * and listed in `unknown`. The manifest is not changed.
29
+ */
30
+ declare function applyDescriptionOverrides<M extends Pick<GenerativeUIManifest, "components">>(manifest: M, overrides: Record<string, string>): {
31
+ manifest: M;
32
+ unknown: string[];
33
+ };
34
+ /**
35
+ * The components and props of `manifest` whose names do not appear in
36
+ * `rendered`. A schema notation that leaves one out would hide part of the
37
+ * catalog from the model.
38
+ */
39
+ declare function schemaCoverage(manifest: Pick<GenerativeUIManifest, "components">, rendered: string): {
40
+ missing: string[];
41
+ };
42
+ //#endregion
43
+ export { applyDescriptionOverrides, renderGenerativeUIComponentList, renderGenerativeUISchema, schemaCoverage };
44
+ //# sourceMappingURL=schema-render.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema-render.d.mts","names":[],"sources":["../../src/generative-ui/schema-render.ts"],"mappings":";;;;KAcK,cAAA,GAAiB,IAAA,CACpB,oBAAA;;AAHe;;;;;AAuOjB;;;;;;iBAAgB,wBAAA,CACd,QAAA,EAAU,cAAA,EACV,QAAA,EAAU,0BAAA;;;;AAsCZ;iBAAgB,+BAAA,CACd,UAAA,EAAY,oBAAA,gBACZ,QAAA,EAAU,0BAAA;;;;;;;iBAkCI,yBAAA,WACJ,IAAA,CAAK,oBAAA,gBAAA,CAEf,QAAA,EAAU,CAAA,EACV,SAAA,EAAW,MAAA;EACR,QAAA,EAAU,CAAA;EAAG,OAAA;AAAA;;;;;;iBAkCF,cAAA,CACd,QAAA,EAAU,IAAA,CAAK,oBAAA,iBACf,QAAA;EACG,OAAA;AAAA"}
@@ -0,0 +1,239 @@
1
+ import { functionCallers } from "./basic-functions.mjs";
2
+ import { GENERATIVE_UI_AGENT_FUNCTION_CALLS } from "./types.mjs";
3
+ import { buildCompactGenerativeUISchema, compactProps, compactType } from "./compact-schema.mjs";
4
+
5
+ //#region src/generative-ui/schema-render.ts
6
+ /** An own key (shared compiles to ES2017, which has no Object.hasOwn). */
7
+ const hasOwn = (target, key) => Object.prototype.hasOwnProperty.call(target, key);
8
+ function isRecord(value) {
9
+ return typeof value === "object" && value !== null && !Array.isArray(value);
10
+ }
11
+ /** The props schema without the description of each prop. */
12
+ function withoutPropDescriptions(schema) {
13
+ if (!isRecord(schema.properties)) return schema;
14
+ return {
15
+ ...schema,
16
+ properties: Object.fromEntries(Object.entries(schema.properties).map(([key, value]) => {
17
+ if (!isRecord(value)) return [key, value];
18
+ const { description: _description, ...rest } = value;
19
+ return [key, rest];
20
+ }))
21
+ };
22
+ }
23
+ /** The short signature of a function: its built-in signature, or its schema made short. */
24
+ function functionSignature(fn) {
25
+ const signature = fn.parameters.description;
26
+ return typeof signature === "string" && signature.startsWith("{") && Object.keys(fn.parameters).length === 2 ? signature : compactType(fn.parameters, 0);
27
+ }
28
+ /**
29
+ * A function name with its parameters: `pick{ id: string }`, `clearCart{}`
30
+ * for no arguments, `setVolume(number)` for a parameter that is not an object.
31
+ */
32
+ function nameWithParameters(name, parameters) {
33
+ if (parameters.startsWith("{")) return `${name}${parameters}`;
34
+ if (parameters === "object") return `${name}{}`;
35
+ return `${name}(${parameters})`;
36
+ }
37
+ /**
38
+ * One component as a TypeScript-like signature line, with its events and
39
+ * slots on the lines below:
40
+ * `- Text(text?: string // The text): Shows text`.
41
+ */
42
+ function signatureLines(name, component, settings) {
43
+ const lines = [`- ${name}(${Object.entries(compactProps(component.props, settings.propDescriptions)).map(([key, type]) => `${key}: ${type}`).join(", ")})${component.description ? `: ${oneLine(component.description)}` : ""}`];
44
+ const events = Object.entries(component.events ?? {}).map(([event, definition]) => `${event}(${definition.description ? oneLine(definition.description) : compactType(definition.parameters, 0)})`);
45
+ if (events.length > 0) lines.push(` events: ${events.join(", ")}`);
46
+ const slots = Object.entries(component.slots ?? {}).map(([slot, kind]) => `${slot} (${kind})`);
47
+ if (slots.length > 0) lines.push(` slots: ${slots.join(", ")}`);
48
+ return lines;
49
+ }
50
+ /** The whole schema as signature text: targets, functions, components, surfaces. */
51
+ function signatureSchema(manifest, settings) {
52
+ const targets = manifest.targets.map((t) => {
53
+ const limit = t.components ? `; only ${t.components.join(", ")}` : "";
54
+ return `- ${t.id} (${t.kind}${limit})${t.description ? `: ${oneLine(t.description)}` : ""}`;
55
+ });
56
+ const functions = Object.entries(manifest.functions).map(([name, fn]) => {
57
+ const callers = functionCallers(fn);
58
+ const who = callers.agent && GENERATIVE_UI_AGENT_FUNCTION_CALLS ? callers.renderer ? " (UI or agent)" : " (agent only)" : "";
59
+ return `- ${nameWithParameters(name, functionSignature(fn))}${who}${fn.description ? `: ${oneLine(fn.description)}` : ""}`;
60
+ });
61
+ const components = Object.entries(manifest.components).flatMap(([name, component]) => signatureLines(name, component, settings));
62
+ const surfaces = Object.entries(manifest.surfaces).map(([id, s]) => `- ${id} (target ${s.target})${s.status ? ` status: ${s.status}` : ""}${s.dataModel ? ` user values: ${JSON.stringify(s.dataModel)}` : ""}${(s.rejected ?? []).map((r) => ` rejected: ${r}`).join("")}`);
63
+ return [
64
+ `Catalog: ${manifest.catalogId}`,
65
+ `Targets:\n${targets.join("\n") || "- none"}`,
66
+ `Functions:\n${functions.join("\n") || "- none"}`,
67
+ `Components:\n${components.join("\n") || "- none"}`,
68
+ `Surfaces:\n${surfaces.join("\n") || "- none"}`
69
+ ].join("\n\n");
70
+ }
71
+ /** A description on one line, so its lines cannot read as new entries. */
72
+ function oneLine(text) {
73
+ return text.replace(/\s*\n\s*/g, " ");
74
+ }
75
+ /** Values that would read as a type or a number once their quotes are gone. */
76
+ const AMBIGUOUS_VALUE = /^(?:string|number|integer|boolean|true|false|null|object|array|unknown|any|-?\d[\d.]*)$/;
77
+ /**
78
+ * A compact type with bare enum values and tight unions:
79
+ * `"sm" | "md" | "lg"` becomes `sm|md|lg`. A union keeps its quotes when it
80
+ * also holds a type (`"sm" | number`) or a value that reads as a type or a
81
+ * number (`"number" | "currency"`, `"1" | "2"`), and so do values that are
82
+ * not plain words.
83
+ */
84
+ function bareType(type) {
85
+ return type.replace(/"[A-Za-z0-9_#%.-]+"(?: \| "[A-Za-z0-9_#%.-]+")*(?! \|)/g, (union, offset, whole) => {
86
+ if (whole.slice(offset - 2, offset) === "| ") return union;
87
+ const values = union.split(" | ").map((v) => v.slice(1, -1));
88
+ if (values.some((v) => AMBIGUOUS_VALUE.test(v))) return union;
89
+ return values.join("|");
90
+ }).replace(/ \| /g, "|");
91
+ }
92
+ /** A compact prop (`type // description`) as `name: type - description`. */
93
+ function propLine(key, value) {
94
+ const name = key.endsWith("?") ? key.slice(0, -1) : `${key}*`;
95
+ const cut = value.indexOf(" // ");
96
+ const type = bareType(cut < 0 ? value : value.slice(0, cut));
97
+ const text = cut < 0 ? "" : value.slice(cut + 4).trim();
98
+ return ` ${name}: ${type}${text ? ` - ${oneLine(text)}` : ""}`;
99
+ }
100
+ /**
101
+ * The whole schema as plain lines: a header line per component and one
102
+ * indented line per prop: events are `action` props and slots `componentId`
103
+ * or `childList` props. Props are optional unless marked `*`, enum values
104
+ * are bare, and the common props are listed once. It carries the same names, types and descriptions as
105
+ * `compact`, in fewer tokens.
106
+ */
107
+ function linesSchema(manifest, settings) {
108
+ const compact = buildCompactGenerativeUISchema(manifest, {
109
+ propDescriptions: settings.propDescriptions,
110
+ commonProps: settings.commonProps
111
+ });
112
+ const targets = compact.targets.map((t) => {
113
+ const limit = t.components ? `, only ${t.components.join(", ")}` : "";
114
+ return `${t.id} (${t.kind}${limit})${t.description ? `: ${oneLine(t.description)}` : ""}`;
115
+ }).join("; ");
116
+ const functions = Object.entries(compact.functions).map(([name, fn]) => `${nameWithParameters(name, fn.parameters)}${"callers" in fn ? ` (${fn.callers})` : ""}${fn.description ? `: ${oneLine(fn.description)}` : ""}`);
117
+ const common = compact.commonProps ? Object.entries(compact.commonProps).map(([k, v]) => propLine(k, v)) : [];
118
+ const components = Object.entries(compact.components).map(([name, c]) => ({
119
+ name,
120
+ c,
121
+ own: [...Object.entries(c.props).map(([k, v]) => propLine(k, v)), ...Object.entries(c.events ?? {}).map(([e, d]) => ` ${e}: action - ${oneLine(d)}`)]
122
+ })).flatMap(({ name, c, own }) => {
123
+ const lines = [`${name}${c.includesCommonProps ? " +common" : ""}${c.description ? `: ${oneLine(c.description)}` : ""}`, ...own];
124
+ for (const [slot, kind] of Object.entries(c.slots ?? {})) lines.push(` ${slot}: ${kind === "single" ? "componentId" : "childList"}`);
125
+ return lines;
126
+ });
127
+ const surfaces = Object.keys(compact.surfaces).length ? JSON.stringify(compact.surfaces) : "none";
128
+ return [
129
+ `Catalog ${compact.catalogId}. Targets: ${targets || "none"}`,
130
+ "Props are optional unless marked *. a|b|c is one of those strings, quoted when one reads as a type or a number. A component marked +common also takes every common prop. A prop of type action is an event prop: give it {\"event\":{...}} or {\"functionCall\":{...}}. A componentId prop takes one component id; a childList prop takes a list of ids or a template.",
131
+ `Functions:\n${functions.join("\n")}`,
132
+ ...common.length ? [`Common props:\n${common.join("\n")}`] : [],
133
+ `Components:\n${components.join("\n")}`,
134
+ `Surfaces: ${surfaces}`
135
+ ].join("\n\n");
136
+ }
137
+ /**
138
+ * The component schema of the markdown transport, as the text of its
139
+ * context entry, in the notation of `settings`. `compact` is the schema that
140
+ * ships (`buildCompactGenerativeUISchema`), `json-schema` the manifest parts
141
+ * as JSON, `ts-signature` one line per component, `lines` one line per
142
+ * prop with bare enums (the fewest tokens).
143
+ *
144
+ * @example
145
+ * ```ts
146
+ * const value = renderGenerativeUISchema(manifest, spec.schema.markdown);
147
+ * ```
148
+ */
149
+ function renderGenerativeUISchema(manifest, settings) {
150
+ switch (settings.notation) {
151
+ case "compact": return JSON.stringify(buildCompactGenerativeUISchema(manifest, {
152
+ propDescriptions: settings.propDescriptions,
153
+ commonProps: settings.commonProps
154
+ }));
155
+ case "json-schema": {
156
+ const components = Object.fromEntries(Object.entries(manifest.components).map(([name, c]) => [name, settings.propDescriptions ? c : {
157
+ ...c,
158
+ props: withoutPropDescriptions(c.props)
159
+ }]));
160
+ return JSON.stringify({
161
+ catalogId: manifest.catalogId,
162
+ targets: manifest.targets,
163
+ functions: manifest.functions,
164
+ components,
165
+ surfaces: manifest.surfaces
166
+ });
167
+ }
168
+ case "ts-signature": return signatureSchema(manifest, settings);
169
+ case "lines": return linesSchema(manifest, settings);
170
+ }
171
+ }
172
+ /**
173
+ * The component list of the tool guide, one entry per component, in the
174
+ * notation of `settings`. `json-schema` is the list that ships.
175
+ */
176
+ function renderGenerativeUIComponentList(components, settings) {
177
+ return Object.entries(components).map(([name, c]) => {
178
+ if (settings.notation === "ts-signature" || settings.notation === "lines") return signatureLines(name, c, settings).join("\n");
179
+ const props = settings.notation === "compact" ? compactProps(c.props, settings.propDescriptions) : settings.propDescriptions ? c.props : withoutPropDescriptions(c.props);
180
+ const lines = [`- **${name}**${c.description ? `: ${oneLine(c.description)}` : ""}`, ` props: ${JSON.stringify(props)}`];
181
+ if (c.events) lines.push(` event props: ${JSON.stringify(c.events)}`);
182
+ if (c.slots) lines.push(` slot props (component ids): ${JSON.stringify(c.slots)}`);
183
+ return lines.join("\n");
184
+ }).join("\n");
185
+ }
186
+ /**
187
+ * The manifest with replaced descriptions: `"Name"` replaces the
188
+ * description of a component, `"Name.prop"` the description of one of its
189
+ * props. Keys that name no component or prop are left out of the result
190
+ * and listed in `unknown`. The manifest is not changed.
191
+ */
192
+ function applyDescriptionOverrides(manifest, overrides) {
193
+ const components = structuredClone(manifest.components);
194
+ const unknown = [];
195
+ for (const [key, description] of Object.entries(overrides)) {
196
+ const [name, prop, ...rest] = key.split(".");
197
+ const component = hasOwn(components, name) ? components[name] : void 0;
198
+ if (!component || rest.length > 0) {
199
+ unknown.push(key);
200
+ continue;
201
+ }
202
+ if (prop === void 0) {
203
+ component.description = description;
204
+ continue;
205
+ }
206
+ const properties = component.props.properties;
207
+ const property = isRecord(properties) && hasOwn(properties, prop) ? properties[prop] : void 0;
208
+ if (!isRecord(property)) {
209
+ unknown.push(key);
210
+ continue;
211
+ }
212
+ property.description = description;
213
+ }
214
+ return {
215
+ manifest: {
216
+ ...manifest,
217
+ components
218
+ },
219
+ unknown
220
+ };
221
+ }
222
+ /**
223
+ * The components and props of `manifest` whose names do not appear in
224
+ * `rendered`. A schema notation that leaves one out would hide part of the
225
+ * catalog from the model.
226
+ */
227
+ function schemaCoverage(manifest, rendered) {
228
+ const missing = [];
229
+ for (const [name, component] of Object.entries(manifest.components)) {
230
+ if (!rendered.includes(name)) missing.push(name);
231
+ const properties = isRecord(component.props.properties) ? component.props.properties : {};
232
+ for (const prop of Object.keys(properties)) if (!rendered.includes(prop)) missing.push(`${name}.${prop}`);
233
+ }
234
+ return { missing };
235
+ }
236
+
237
+ //#endregion
238
+ export { applyDescriptionOverrides, renderGenerativeUIComponentList, renderGenerativeUISchema, schemaCoverage };
239
+ //# sourceMappingURL=schema-render.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema-render.mjs","names":[],"sources":["../../src/generative-ui/schema-render.ts"],"sourcesContent":["import { functionCallers } from \"./basic-functions\";\nimport {\n buildCompactGenerativeUISchema,\n compactProps,\n compactType,\n} from \"./compact-schema\";\nimport type { GenerativeUISchemaSettings } from \"./prompt-spec\";\nimport { GENERATIVE_UI_AGENT_FUNCTION_CALLS } from \"./types\";\nimport type {\n GenerativeUIComponentManifest,\n GenerativeUIJSONSchema,\n GenerativeUIManifest,\n} from \"./types\";\n\ntype SchemaManifest = Pick<\n GenerativeUIManifest,\n \"catalogId\" | \"components\" | \"functions\" | \"targets\" | \"surfaces\"\n>;\n\n/** An own key (shared compiles to ES2017, which has no Object.hasOwn). */\nconst hasOwn = (target: object, key: string) =>\n Object.prototype.hasOwnProperty.call(target, key);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** The props schema without the description of each prop. */\nfunction withoutPropDescriptions(\n schema: GenerativeUIJSONSchema,\n): GenerativeUIJSONSchema {\n if (!isRecord(schema.properties)) return schema;\n return {\n ...schema,\n properties: Object.fromEntries(\n Object.entries(schema.properties).map(([key, value]) => {\n if (!isRecord(value)) return [key, value];\n const { description: _description, ...rest } = value;\n return [key, rest];\n }),\n ),\n };\n}\n\n/** The short signature of a function: its built-in signature, or its schema made short. */\nfunction functionSignature(fn: GenerativeUIManifest[\"functions\"][string]) {\n const signature = fn.parameters.description;\n const hasSignature =\n typeof signature === \"string\" &&\n signature.startsWith(\"{\") &&\n Object.keys(fn.parameters).length === 2;\n return hasSignature ? signature : compactType(fn.parameters, 0);\n}\n\n/**\n * A function name with its parameters: `pick{ id: string }`, `clearCart{}`\n * for no arguments, `setVolume(number)` for a parameter that is not an object.\n */\nfunction nameWithParameters(name: string, parameters: string) {\n if (parameters.startsWith(\"{\")) return `${name}${parameters}`;\n if (parameters === \"object\") return `${name}{}`;\n return `${name}(${parameters})`;\n}\n\n/**\n * One component as a TypeScript-like signature line, with its events and\n * slots on the lines below:\n * `- Text(text?: string // The text): Shows text`.\n */\nfunction signatureLines(\n name: string,\n component: GenerativeUIComponentManifest,\n settings: GenerativeUISchemaSettings,\n) {\n const props = Object.entries(\n compactProps(component.props, settings.propDescriptions),\n ).map(([key, type]) => `${key}: ${type}`);\n const lines = [\n `- ${name}(${props.join(\", \")})${component.description ? `: ${oneLine(component.description)}` : \"\"}`,\n ];\n const events = Object.entries(component.events ?? {}).map(\n ([event, definition]) =>\n `${event}(${definition.description ? oneLine(definition.description) : compactType(definition.parameters, 0)})`,\n );\n if (events.length > 0) lines.push(` events: ${events.join(\", \")}`);\n const slots = Object.entries(component.slots ?? {}).map(\n ([slot, kind]) => `${slot} (${kind})`,\n );\n if (slots.length > 0) lines.push(` slots: ${slots.join(\", \")}`);\n return lines;\n}\n\n/** The whole schema as signature text: targets, functions, components, surfaces. */\nfunction signatureSchema(\n manifest: SchemaManifest,\n settings: GenerativeUISchemaSettings,\n) {\n const targets = manifest.targets.map((t) => {\n const limit = t.components ? `; only ${t.components.join(\", \")}` : \"\";\n return `- ${t.id} (${t.kind}${limit})${t.description ? `: ${oneLine(t.description)}` : \"\"}`;\n });\n const functions = Object.entries(manifest.functions).map(([name, fn]) => {\n const callers = functionCallers(fn);\n const who =\n callers.agent && GENERATIVE_UI_AGENT_FUNCTION_CALLS\n ? callers.renderer\n ? \" (UI or agent)\"\n : \" (agent only)\"\n : \"\";\n return `- ${nameWithParameters(name, functionSignature(fn))}${who}${fn.description ? `: ${oneLine(fn.description)}` : \"\"}`;\n });\n const components = Object.entries(manifest.components).flatMap(\n ([name, component]) => signatureLines(name, component, settings),\n );\n const surfaces = Object.entries(manifest.surfaces).map(\n ([id, s]) =>\n `- ${id} (target ${s.target})${s.status ? ` status: ${s.status}` : \"\"}${s.dataModel ? ` user values: ${JSON.stringify(s.dataModel)}` : \"\"}${(s.rejected ?? []).map((r) => ` rejected: ${r}`).join(\"\")}`,\n );\n return [\n `Catalog: ${manifest.catalogId}`,\n `Targets:\\n${targets.join(\"\\n\") || \"- none\"}`,\n `Functions:\\n${functions.join(\"\\n\") || \"- none\"}`,\n `Components:\\n${components.join(\"\\n\") || \"- none\"}`,\n `Surfaces:\\n${surfaces.join(\"\\n\") || \"- none\"}`,\n ].join(\"\\n\\n\");\n}\n\n/** A description on one line, so its lines cannot read as new entries. */\nfunction oneLine(text: string) {\n return text.replace(/\\s*\\n\\s*/g, \" \");\n}\n\n/** Values that would read as a type or a number once their quotes are gone. */\nconst AMBIGUOUS_VALUE =\n /^(?:string|number|integer|boolean|true|false|null|object|array|unknown|any|-?\\d[\\d.]*)$/;\n\n/**\n * A compact type with bare enum values and tight unions:\n * `\"sm\" | \"md\" | \"lg\"` becomes `sm|md|lg`. A union keeps its quotes when it\n * also holds a type (`\"sm\" | number`) or a value that reads as a type or a\n * number (`\"number\" | \"currency\"`, `\"1\" | \"2\"`), and so do values that are\n * not plain words.\n */\nfunction bareType(type: string) {\n return type\n .replace(\n /\"[A-Za-z0-9_#%.-]+\"(?: \\| \"[A-Za-z0-9_#%.-]+\")*(?! \\|)/g,\n (union: string, offset: number, whole: string) => {\n if (whole.slice(offset - 2, offset) === \"| \") return union;\n const values = union.split(\" | \").map((v) => v.slice(1, -1));\n if (values.some((v) => AMBIGUOUS_VALUE.test(v))) return union;\n return values.join(\"|\");\n },\n )\n .replace(/ \\| /g, \"|\");\n}\n\n/** A compact prop (`type // description`) as `name: type - description`. */\nfunction propLine(key: string, value: string) {\n const name = key.endsWith(\"?\") ? key.slice(0, -1) : `${key}*`;\n const cut = value.indexOf(\" // \");\n const type = bareType(cut < 0 ? value : value.slice(0, cut));\n const text = cut < 0 ? \"\" : value.slice(cut + 4).trim();\n const description = text ? ` - ${oneLine(text)}` : \"\";\n return ` ${name}: ${type}${description}`;\n}\n\n/**\n * The whole schema as plain lines: a header line per component and one\n * indented line per prop: events are `action` props and slots `componentId`\n * or `childList` props. Props are optional unless marked `*`, enum values\n * are bare, and the common props are listed once. It carries the same names, types and descriptions as\n * `compact`, in fewer tokens.\n */\nfunction linesSchema(\n manifest: SchemaManifest,\n settings: GenerativeUISchemaSettings,\n) {\n const compact = buildCompactGenerativeUISchema(manifest, {\n propDescriptions: settings.propDescriptions,\n commonProps: settings.commonProps,\n });\n const targets = compact.targets\n .map((t) => {\n const limit = t.components ? `, only ${t.components.join(\", \")}` : \"\";\n return `${t.id} (${t.kind}${limit})${t.description ? `: ${oneLine(t.description)}` : \"\"}`;\n })\n .join(\"; \");\n const functions = Object.entries(compact.functions).map(\n ([name, fn]) =>\n `${nameWithParameters(name, fn.parameters)}${\"callers\" in fn ? ` (${fn.callers})` : \"\"}${fn.description ? `: ${oneLine(fn.description)}` : \"\"}`,\n );\n const common = compact.commonProps\n ? Object.entries(compact.commonProps).map(([k, v]) => propLine(k, v))\n : [];\n const lineSets = Object.entries(compact.components).map(([name, c]) => ({\n name,\n c,\n own: [\n ...Object.entries(c.props).map(([k, v]) => propLine(k, v)),\n ...Object.entries(c.events ?? {}).map(\n ([e, d]) => ` ${e}: action - ${oneLine(d)}`,\n ),\n ],\n }));\n const components = lineSets.flatMap(({ name, c, own }) => {\n const lines = [\n `${name}${c.includesCommonProps ? \" +common\" : \"\"}${c.description ? `: ${oneLine(c.description)}` : \"\"}`,\n ...own,\n ];\n // Slots are props that take component ids.\n for (const [slot, kind] of Object.entries(c.slots ?? {})) {\n lines.push(\n ` ${slot}: ${kind === \"single\" ? \"componentId\" : \"childList\"}`,\n );\n }\n return lines;\n });\n const surfaces = Object.keys(compact.surfaces).length\n ? JSON.stringify(compact.surfaces)\n : \"none\";\n return [\n `Catalog ${compact.catalogId}. Targets: ${targets || \"none\"}`,\n 'Props are optional unless marked *. a|b|c is one of those strings, quoted when one reads as a type or a number. A component marked +common also takes every common prop. A prop of type action is an event prop: give it {\"event\":{...}} or {\"functionCall\":{...}}. A componentId prop takes one component id; a childList prop takes a list of ids or a template.',\n `Functions:\\n${functions.join(\"\\n\")}`,\n ...(common.length ? [`Common props:\\n${common.join(\"\\n\")}`] : []),\n `Components:\\n${components.join(\"\\n\")}`,\n `Surfaces: ${surfaces}`,\n ].join(\"\\n\\n\");\n}\n\n/**\n * The component schema of the markdown transport, as the text of its\n * context entry, in the notation of `settings`. `compact` is the schema that\n * ships (`buildCompactGenerativeUISchema`), `json-schema` the manifest parts\n * as JSON, `ts-signature` one line per component, `lines` one line per\n * prop with bare enums (the fewest tokens).\n *\n * @example\n * ```ts\n * const value = renderGenerativeUISchema(manifest, spec.schema.markdown);\n * ```\n */\nexport function renderGenerativeUISchema(\n manifest: SchemaManifest,\n settings: GenerativeUISchemaSettings,\n): string {\n switch (settings.notation) {\n case \"compact\":\n return JSON.stringify(\n buildCompactGenerativeUISchema(manifest, {\n propDescriptions: settings.propDescriptions,\n commonProps: settings.commonProps,\n }),\n );\n case \"json-schema\": {\n const components = Object.fromEntries(\n Object.entries(manifest.components).map(([name, c]) => [\n name,\n settings.propDescriptions\n ? c\n : { ...c, props: withoutPropDescriptions(c.props) },\n ]),\n );\n return JSON.stringify({\n catalogId: manifest.catalogId,\n targets: manifest.targets,\n functions: manifest.functions,\n components,\n surfaces: manifest.surfaces,\n });\n }\n case \"ts-signature\":\n return signatureSchema(manifest, settings);\n case \"lines\":\n return linesSchema(manifest, settings);\n }\n}\n\n/**\n * The component list of the tool guide, one entry per component, in the\n * notation of `settings`. `json-schema` is the list that ships.\n */\nexport function renderGenerativeUIComponentList(\n components: GenerativeUIManifest[\"components\"],\n settings: GenerativeUISchemaSettings,\n): string {\n return Object.entries(components)\n .map(([name, c]) => {\n if (\n settings.notation === \"ts-signature\" ||\n settings.notation === \"lines\"\n ) {\n return signatureLines(name, c, settings).join(\"\\n\");\n }\n const props =\n settings.notation === \"compact\"\n ? compactProps(c.props, settings.propDescriptions)\n : settings.propDescriptions\n ? c.props\n : withoutPropDescriptions(c.props);\n const lines = [\n `- **${name}**${c.description ? `: ${oneLine(c.description)}` : \"\"}`,\n ` props: ${JSON.stringify(props)}`,\n ];\n if (c.events) lines.push(` event props: ${JSON.stringify(c.events)}`);\n if (c.slots)\n lines.push(` slot props (component ids): ${JSON.stringify(c.slots)}`);\n return lines.join(\"\\n\");\n })\n .join(\"\\n\");\n}\n\n/**\n * The manifest with replaced descriptions: `\"Name\"` replaces the\n * description of a component, `\"Name.prop\"` the description of one of its\n * props. Keys that name no component or prop are left out of the result\n * and listed in `unknown`. The manifest is not changed.\n */\nexport function applyDescriptionOverrides<\n M extends Pick<GenerativeUIManifest, \"components\">,\n>(\n manifest: M,\n overrides: Record<string, string>,\n): { manifest: M; unknown: string[] } {\n const components = structuredClone(manifest.components);\n const unknown: string[] = [];\n for (const [key, description] of Object.entries(overrides)) {\n const [name, prop, ...rest] = key.split(\".\");\n // Own keys only: \"__proto__\" must never reach Object.prototype.\n const component = hasOwn(components, name) ? components[name] : undefined;\n if (!component || rest.length > 0) {\n unknown.push(key);\n continue;\n }\n if (prop === undefined) {\n component.description = description;\n continue;\n }\n const properties = component.props.properties;\n const property =\n isRecord(properties) && hasOwn(properties, prop)\n ? properties[prop]\n : undefined;\n if (!isRecord(property)) {\n unknown.push(key);\n continue;\n }\n property.description = description;\n }\n return { manifest: { ...manifest, components }, unknown };\n}\n\n/**\n * The components and props of `manifest` whose names do not appear in\n * `rendered`. A schema notation that leaves one out would hide part of the\n * catalog from the model.\n */\nexport function schemaCoverage(\n manifest: Pick<GenerativeUIManifest, \"components\">,\n rendered: string,\n): { missing: string[] } {\n const missing: string[] = [];\n for (const [name, component] of Object.entries(manifest.components)) {\n if (!rendered.includes(name)) missing.push(name);\n const properties = isRecord(component.props.properties)\n ? component.props.properties\n : {};\n for (const prop of Object.keys(properties)) {\n if (!rendered.includes(prop)) missing.push(`${name}.${prop}`);\n }\n }\n return { missing };\n}\n"],"mappings":"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"}
@@ -1,7 +1,7 @@
1
1
 
2
2
  //#region src/generative-ui/types.ts
3
3
  /** A2UI protocol version used on the wire. */
4
- const A2UI_VERSION = "v1.0";
4
+ const A2UI_VERSION = "1.0";
5
5
  /** Activity type of a generated surface message. */
6
6
  const GENERATIVE_UI_ACTIVITY_TYPE = "generative-ui-surface";
7
7
  /** Activity type of a function call that the agent asks the client to run. */
@@ -65,7 +65,7 @@ const GENERATIVE_UI_MAX_REJECTION_LENGTH = 500;
65
65
  * @example
66
66
  * ```ts
67
67
  * toA2UIActionMessage({ name: "buy", surfaceId: "s1", componentId: "b", context: { sku: "a" } });
68
- * // { version: "v1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
68
+ * // { version: "1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
69
69
  * ```
70
70
  */
71
71
  function toA2UIActionMessage(event) {
@@ -1 +1 @@
1
- {"version":3,"file":"types.cjs","names":[],"sources":["../../src/generative-ui/types.ts"],"sourcesContent":["/** A2UI protocol version used on the wire. */\nexport const A2UI_VERSION = \"v1.0\";\n/** Activity type of a generated surface message. */\nexport const GENERATIVE_UI_ACTIVITY_TYPE = \"generative-ui-surface\";\n/** Activity type of a function call that the agent asks the client to run. */\nexport const GENERATIVE_UI_FUNCTION_CALL_ACTIVITY_TYPE =\n \"generative-ui-function-call\";\n/** Tool the model calls to render or update surfaces. */\nexport const GENERATIVE_UI_RENDER_TOOL = \"render_ui\";\n/** Target id of the chat transcript. */\nexport const GENERATIVE_UI_CHAT_TARGET = \"chat\";\n/** Component id every surface renders from. */\nexport const GENERATIVE_UI_ROOT_ID = \"root\";\n/**\n * Whether the agent may call renderer functions with `callRendererFunction`.\n * Off for now: the result goes back as a developer message, and not every\n * backend keeps that message where the model reads it in order. While off,\n * the prompts do not mention the operation, the validator rejects it, and\n * the dispatcher refuses the agent, whatever a declaration's\n * `allowedCallers` says. The code and its tests stay for when it is on.\n */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS = false;\n/** The reason an agent function call is rejected while they are off. */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON =\n \"callRendererFunction is not supported in this version: the agent cannot call renderer functions until their results can be sent back to it reliably\";\n\n/** Activity message id of a surface. One message per surface. */\nexport function generativeUISurfaceMessageId(surfaceId: string) {\n return `genui:${surfaceId}`;\n}\n\n/**\n * Activity message id of an agent-called function. One message per\n * `functionCallId`.\n *\n * @param functionCallId - The `functionCallId` of the `callRendererFunction` operation.\n *\n * @example\n * ```ts\n * generativeUIFunctionCallMessageId(\"f1\"); // \"genui-fn:f1\"\n * ```\n */\nexport function generativeUIFunctionCallMessageId(functionCallId: string) {\n return `genui-fn:${functionCallId}`;\n}\n\nimport type {\n A2UIFunctionPermissions,\n A2UIFunctionReturnType,\n} from \"./basic-functions\";\n\n// Named `GenerativeUIJSONSchema` because the package root already exports a\n// `JSONSchema` (utils/json-schema.ts); the bare name would collide.\nexport type GenerativeUIJSONSchema = Record<string, unknown>;\n\nexport type A2UIComponentNode = {\n id: string;\n component: string;\n [prop: string]: unknown;\n};\n\n/**\n * The keys of the A2UI 1.0 component envelope next to `id` and\n * `component`: `catalogId`, `accessibility` and `metadata`. They are not\n * props of the component. The renderer reads `accessibility` and ignores\n * the other two.\n */\nexport const A2UI_COMPONENT_ENVELOPE_KEYS: ReadonlySet<string> = new Set([\n \"catalogId\",\n \"accessibility\",\n \"metadata\",\n]);\n\n/**\n * A call of a named function: `{ \"@call\": \"addToCart\", \"args\": { ... } }`.\n * Without `catalogId`, the function comes from the catalog of the run.\n */\nexport type A2UIFunctionCall = {\n \"@call\": string;\n args?: Record<string, unknown>;\n catalogId?: string;\n};\n\nexport type A2UIOperation =\n | {\n version: \"v1.0\";\n createSurface: {\n surfaceId: string;\n /** Left out by the model. The run's catalog id is filled in. */\n catalogId?: string;\n /** Components to add at once, checked like `updateComponents`. */\n components?: A2UIComponentNode[];\n /** The initial root data model. */\n dataModel?: Record<string, unknown>;\n sendDataModel?: boolean;\n metadata?: { extensions?: Record<string, unknown> };\n };\n }\n | {\n version: \"v1.0\";\n updateComponents: { surfaceId: string; components: A2UIComponentNode[] };\n }\n | {\n version: \"v1.0\";\n /**\n * Sets `value` at `path`. A `null` value deletes the key at `path`.\n * With no `path`, or `\"/\"`, it sets the whole data model.\n */\n updateDataModel: { surfaceId: string; path?: string; value: unknown };\n }\n | { version: \"v1.0\"; deleteSurface: { surfaceId: string } }\n | {\n version: \"v1.0\";\n /** Runs an app function in the browser, with no user interaction. */\n callRendererFunction: {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n };\n };\n\n/** Value of an event prop: run a host function, or report the event to the agent. */\nexport type GenerativeUIActionBinding =\n | {\n event: {\n name: string;\n /**\n * First line of the user message that the event becomes: text, a\n * data binding, or a function value such as formatString.\n */\n userMessage?: string | { \"@path\": string } | A2UIFunctionCall;\n context?: Record<string, unknown>;\n };\n }\n | { functionCall: A2UIFunctionCall };\n\nexport type GenerativeUISurfaceStatus = \"streaming\" | \"ready\" | \"error\";\n\nexport interface GenerativeUIRejectedOperation {\n /** Position of the operation in the render_ui call, or in the content list. */\n index: number;\n reason: string;\n}\n\n/** Content of a `generative-ui-surface` activity message. */\nexport interface GenerativeUISurfaceContent {\n surfaceId: string;\n target: string;\n catalogId: string;\n /** Committed (validated) operations, cumulative. */\n operations: A2UIOperation[];\n status: GenerativeUISurfaceStatus;\n rejected: GenerativeUIRejectedOperation[];\n}\n\n/** Content of a `generative-ui-function-call` activity message. */\nexport interface GenerativeUIFunctionCallContent {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n}\n\n/**\n * Value of a \"multiple\" slot that repeats one component for each item of the\n * list at `path`. Paths inside the repeated component are relative to the item.\n */\nexport type GenerativeUITemplateChildren = {\n componentId: string;\n path: string;\n};\n\nexport interface GenerativeUIComponentManifest {\n /** CopilotKit positional order across model-visible props, slots and events.\n * Exporters encode this as JSON Schema property order; it is not an A2UI keyword. */\n parameterOrder?: readonly string[];\n description?: string;\n props: GenerativeUIJSONSchema;\n events?: Record<\n string,\n { description?: string; parameters: GenerativeUIJSONSchema }\n >;\n /**\n * Props that hold child components. A \"single\" slot takes one component id.\n * A \"multiple\" slot takes a `string[]` of component ids, or a\n * {@link GenerativeUITemplateChildren} template.\n */\n slots?: Record<string, \"single\" | \"multiple\">;\n}\n\nexport interface GenerativeUIFunctionManifest extends A2UIFunctionPermissions {\n description?: string;\n parameters: GenerativeUIJSONSchema;\n /** What the function gives back, as A2UI 1.0 names it. */\n returnType?: A2UIFunctionReturnType;\n}\n\n/** Serializable description of what the browser can render and call. */\nexport interface GenerativeUIManifest {\n /** The catalog of the run. A surface with no `catalogId` gets this one. */\n catalogId: string;\n /**\n * Every catalog that a `catalogId` can name: `catalogId` first, then the\n * catalogs of `extends`. Left out, only `catalogId`.\n */\n catalogIds?: string[];\n components: Record<string, GenerativeUIComponentManifest>;\n functions: Record<string, GenerativeUIFunctionManifest>;\n /**\n * Places where the model can render surfaces. Only mounted targets are\n * listed. `description` tells the model where the target is on the page\n * and what to put in it.\n */\n targets: GenerativeUITarget[];\n /** Surfaces the client already holds for the current thread. */\n surfaces: Record<string, GenerativeUISurfaceSummary>;\n}\n\n/** A place where the model can render surfaces. */\nexport interface GenerativeUITarget {\n id: string;\n kind: \"chat\" | \"inline\";\n description?: string;\n /**\n * The only components that the surfaces of this target can use, at most\n * {@link GENERATIVE_UI_MAX_TARGET_COMPONENTS} names. Left out, the target\n * takes every component of the catalog.\n */\n components?: string[];\n}\n\n/** Most component names that one target can list. */\nexport const GENERATIVE_UI_MAX_TARGET_COMPONENTS = 100;\n\n/** Most rejections that a surface summary lists. */\nexport const GENERATIVE_UI_MAX_SUMMARY_REJECTIONS = 20;\n/** Most characters of one rejection in a surface summary. */\nexport const GENERATIVE_UI_MAX_REJECTION_LENGTH = 500;\n\n/** One surface that the client holds, as the model sees it. */\nexport interface GenerativeUISurfaceSummary {\n target: string;\n /** The values that the user set, by path. Left out when there are none. */\n dataModel?: Record<string, unknown>;\n /**\n * Operations that the client dropped, as `\"operation <index>: <reason>\"`.\n * At most {@link GENERATIVE_UI_MAX_SUMMARY_REJECTIONS} entries of at most\n * {@link GENERATIVE_UI_MAX_REJECTION_LENGTH} characters. Left out when\n * there are none.\n */\n rejected?: string[];\n /**\n * Left out while the surface exists. `\"deleted\"`: a deleteSurface removed\n * it, and its id cannot be used again. `\"failed\"`: its createSurface was\n * rejected, so it does not exist; a corrected createSurface can use the id.\n */\n status?: \"deleted\" | \"failed\";\n}\n\n/** A user interaction bound to `{ event }`, sent to the agent. */\nexport interface GenerativeUIUserEvent {\n name: string;\n surfaceId: string;\n componentId: string;\n context: Record<string, unknown>;\n /** The resolved `event.userMessage`: the first line of the user message. */\n userMessage?: string;\n /** When the user acted, as an ISO 8601 string. Filled in when left out. */\n timestamp?: string;\n}\n\n/**\n * The A2UI 1.0 action message of a user event: what a renderer sends to the\n * agent when the user triggers an `{ event }` action. The run that the\n * event starts carries it in the envelope (`copilotkit_action`), next to\n * the visible user message.\n */\nexport interface A2UIActionMessage {\n version: typeof A2UI_VERSION;\n action: {\n name: string;\n surfaceId: string;\n sourceComponentId: string;\n /** ISO 8601. */\n timestamp: string;\n userMessage?: string;\n context: Record<string, unknown>;\n };\n}\n\n/**\n * The action message of a user event, with the A2UI field names. Takes the\n * time of the call when the event has no timestamp.\n *\n * @example\n * ```ts\n * toA2UIActionMessage({ name: \"buy\", surfaceId: \"s1\", componentId: \"b\", context: { sku: \"a\" } });\n * // { version: \"v1.0\", action: { name: \"buy\", surfaceId: \"s1\", sourceComponentId: \"b\", timestamp: \"2026-…\", context: { sku: \"a\" } } }\n * ```\n */\nexport function toA2UIActionMessage(\n event: GenerativeUIUserEvent,\n): A2UIActionMessage {\n return {\n version: A2UI_VERSION,\n action: {\n name: event.name,\n surfaceId: event.surfaceId,\n sourceComponentId: event.componentId,\n timestamp: event.timestamp ?? new Date().toISOString(),\n ...(event.userMessage === undefined\n ? {}\n : { userMessage: event.userMessage }),\n context: event.context,\n },\n };\n}\n"],"mappings":";;;AACA,MAAa,eAAe;;AAE5B,MAAa,8BAA8B;;AAE3C,MAAa,4CACX;;AAEF,MAAa,4BAA4B;;AAEzC,MAAa,4BAA4B;;AAEzC,MAAa,wBAAwB;;;;;;;;;AASrC,MAAa,qCAAqC;;AAElD,MAAa,gDACX;;AAGF,SAAgB,6BAA6B,WAAmB;AAC9D,QAAO,SAAS;;;;;;;;;;;;;AAclB,SAAgB,kCAAkC,gBAAwB;AACxE,QAAO,YAAY;;;;;;;;AAwBrB,MAAa,+BAAoD,IAAI,IAAI;CACvE;CACA;CACA;CACD,CAAC;;AA8JF,MAAa,sCAAsC;;AAGnD,MAAa,uCAAuC;;AAEpD,MAAa,qCAAqC;;;;;;;;;;;AA+DlD,SAAgB,oBACd,OACmB;AACnB,QAAO;EACL,SAAS;EACT,QAAQ;GACN,MAAM,MAAM;GACZ,WAAW,MAAM;GACjB,mBAAmB,MAAM;GACzB,WAAW,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtD,GAAI,MAAM,gBAAgB,SACtB,EAAE,GACF,EAAE,aAAa,MAAM,aAAa;GACtC,SAAS,MAAM;GAChB;EACF"}
1
+ {"version":3,"file":"types.cjs","names":[],"sources":["../../src/generative-ui/types.ts"],"sourcesContent":["/** A2UI protocol version used on the wire. */\nexport const A2UI_VERSION = \"1.0\";\n/** Activity type of a generated surface message. */\nexport const GENERATIVE_UI_ACTIVITY_TYPE = \"generative-ui-surface\";\n/** Activity type of a function call that the agent asks the client to run. */\nexport const GENERATIVE_UI_FUNCTION_CALL_ACTIVITY_TYPE =\n \"generative-ui-function-call\";\n/** Tool the model calls to render or update surfaces. */\nexport const GENERATIVE_UI_RENDER_TOOL = \"render_ui\";\n/** Target id of the chat transcript. */\nexport const GENERATIVE_UI_CHAT_TARGET = \"chat\";\n/** Component id every surface renders from. */\nexport const GENERATIVE_UI_ROOT_ID = \"root\";\n/**\n * Whether the agent may call renderer functions with `callRendererFunction`.\n * Off for now: the result goes back as a developer message, and not every\n * backend keeps that message where the model reads it in order. While off,\n * the prompts do not mention the operation, the validator rejects it, and\n * the dispatcher refuses the agent, whatever a declaration's\n * `allowedCallers` says. The code and its tests stay for when it is on.\n */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS = false;\n/** The reason an agent function call is rejected while they are off. */\nexport const GENERATIVE_UI_AGENT_FUNCTION_CALLS_OFF_REASON =\n \"callRendererFunction is not supported in this version: the agent cannot call renderer functions until their results can be sent back to it reliably\";\n\n/** Activity message id of a surface. One message per surface. */\nexport function generativeUISurfaceMessageId(surfaceId: string) {\n return `genui:${surfaceId}`;\n}\n\n/**\n * Activity message id of an agent-called function. One message per\n * `functionCallId`.\n *\n * @param functionCallId - The `functionCallId` of the `callRendererFunction` operation.\n *\n * @example\n * ```ts\n * generativeUIFunctionCallMessageId(\"f1\"); // \"genui-fn:f1\"\n * ```\n */\nexport function generativeUIFunctionCallMessageId(functionCallId: string) {\n return `genui-fn:${functionCallId}`;\n}\n\nimport type {\n A2UIFunctionPermissions,\n A2UIFunctionReturnType,\n} from \"./basic-functions\";\n\n// Named `GenerativeUIJSONSchema` because the package root already exports a\n// `JSONSchema` (utils/json-schema.ts); the bare name would collide.\nexport type GenerativeUIJSONSchema = Record<string, unknown>;\n\nexport type A2UIComponentNode = {\n id: string;\n component: string;\n [prop: string]: unknown;\n};\n\n/**\n * The keys of the A2UI 1.0 component envelope next to `id` and\n * `component`: `catalogId`, `accessibility` and `metadata`. They are not\n * props of the component. The renderer reads `accessibility` and ignores\n * the other two.\n */\nexport const A2UI_COMPONENT_ENVELOPE_KEYS: ReadonlySet<string> = new Set([\n \"catalogId\",\n \"accessibility\",\n \"metadata\",\n]);\n\n/**\n * A call of a named function: `{ \"@call\": \"addToCart\", \"args\": { ... } }`.\n * Without `catalogId`, the function comes from the catalog of the run.\n */\nexport type A2UIFunctionCall = {\n \"@call\": string;\n args?: Record<string, unknown>;\n catalogId?: string;\n};\n\nexport type A2UIOperation =\n | {\n version: typeof A2UI_VERSION;\n createSurface: {\n surfaceId: string;\n /** Left out by the model. The run's catalog id is filled in. */\n catalogId?: string;\n /** Components to add at once, checked like `updateComponents`. */\n components?: A2UIComponentNode[];\n /** The initial root data model. */\n dataModel?: Record<string, unknown>;\n sendDataModel?: boolean;\n metadata?: { extensions?: Record<string, unknown> };\n };\n }\n | {\n version: typeof A2UI_VERSION;\n updateComponents: { surfaceId: string; components: A2UIComponentNode[] };\n }\n | {\n version: typeof A2UI_VERSION;\n /**\n * Sets `value` at `path`. A `null` value deletes the key at `path`.\n * With no `path`, or `\"/\"`, it sets the whole data model.\n */\n updateDataModel: { surfaceId: string; path?: string; value: unknown };\n }\n | {\n version: typeof A2UI_VERSION;\n deleteSurface: { surfaceId: string };\n }\n | {\n version: typeof A2UI_VERSION;\n /** Runs an app function in the browser, with no user interaction. */\n callRendererFunction: {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n };\n };\n\n/** Value of an event prop: run a host function, or report the event to the agent. */\nexport type GenerativeUIActionBinding =\n | {\n event: {\n name: string;\n /**\n * First line of the user message that the event becomes: text, a\n * data binding, or a function value such as formatString.\n */\n userMessage?: string | { \"@path\": string } | A2UIFunctionCall;\n context?: Record<string, unknown>;\n };\n }\n | { functionCall: A2UIFunctionCall };\n\nexport type GenerativeUISurfaceStatus = \"streaming\" | \"ready\" | \"error\";\n\nexport interface GenerativeUIRejectedOperation {\n /** Position of the operation in the render_ui call, or in the content list. */\n index: number;\n reason: string;\n}\n\n/** Content of a `generative-ui-surface` activity message. */\nexport interface GenerativeUISurfaceContent {\n surfaceId: string;\n target: string;\n catalogId: string;\n /** Committed (validated) operations, cumulative. */\n operations: A2UIOperation[];\n status: GenerativeUISurfaceStatus;\n rejected: GenerativeUIRejectedOperation[];\n}\n\n/** Content of a `generative-ui-function-call` activity message. */\nexport interface GenerativeUIFunctionCallContent {\n functionCallId: string;\n callFunction: A2UIFunctionCall;\n}\n\n/**\n * Value of a \"multiple\" slot that repeats one component for each item of the\n * list at `path`. Paths inside the repeated component are relative to the item.\n */\nexport type GenerativeUITemplateChildren = {\n componentId: string;\n path: string;\n};\n\nexport interface GenerativeUIComponentManifest {\n /** CopilotKit positional order across model-visible props, slots and events.\n * Exporters encode this as JSON Schema property order; it is not an A2UI keyword. */\n parameterOrder?: readonly string[];\n description?: string;\n props: GenerativeUIJSONSchema;\n events?: Record<\n string,\n { description?: string; parameters: GenerativeUIJSONSchema }\n >;\n /**\n * Props that hold child components. A \"single\" slot takes one component id.\n * A \"multiple\" slot takes a `string[]` of component ids, or a\n * {@link GenerativeUITemplateChildren} template.\n */\n slots?: Record<string, \"single\" | \"multiple\">;\n}\n\nexport interface GenerativeUIFunctionManifest extends A2UIFunctionPermissions {\n description?: string;\n parameters: GenerativeUIJSONSchema;\n /** What the function gives back, as A2UI 1.0 names it. */\n returnType?: A2UIFunctionReturnType;\n}\n\n/** Serializable description of what the browser can render and call. */\nexport interface GenerativeUIManifest {\n /** The catalog of the run. A surface with no `catalogId` gets this one. */\n catalogId: string;\n /**\n * Every catalog that a `catalogId` can name: `catalogId` first, then the\n * catalogs of `extends`. Left out, only `catalogId`.\n */\n catalogIds?: string[];\n components: Record<string, GenerativeUIComponentManifest>;\n functions: Record<string, GenerativeUIFunctionManifest>;\n /**\n * Places where the model can render surfaces. Only mounted targets are\n * listed. `description` tells the model where the target is on the page\n * and what to put in it.\n */\n targets: GenerativeUITarget[];\n /** Surfaces the client already holds for the current thread. */\n surfaces: Record<string, GenerativeUISurfaceSummary>;\n}\n\n/** A place where the model can render surfaces. */\nexport interface GenerativeUITarget {\n id: string;\n kind: \"chat\" | \"inline\";\n description?: string;\n /**\n * The only components that the surfaces of this target can use, at most\n * {@link GENERATIVE_UI_MAX_TARGET_COMPONENTS} names. Left out, the target\n * takes every component of the catalog.\n */\n components?: string[];\n}\n\n/** Most component names that one target can list. */\nexport const GENERATIVE_UI_MAX_TARGET_COMPONENTS = 100;\n\n/** Most rejections that a surface summary lists. */\nexport const GENERATIVE_UI_MAX_SUMMARY_REJECTIONS = 20;\n/** Most characters of one rejection in a surface summary. */\nexport const GENERATIVE_UI_MAX_REJECTION_LENGTH = 500;\n\n/** One surface that the client holds, as the model sees it. */\nexport interface GenerativeUISurfaceSummary {\n target: string;\n /** The values that the user set, by path. Left out when there are none. */\n dataModel?: Record<string, unknown>;\n /**\n * Operations that the client dropped, as `\"operation <index>: <reason>\"`.\n * At most {@link GENERATIVE_UI_MAX_SUMMARY_REJECTIONS} entries of at most\n * {@link GENERATIVE_UI_MAX_REJECTION_LENGTH} characters. Left out when\n * there are none.\n */\n rejected?: string[];\n /**\n * Left out while the surface exists. `\"deleted\"`: a deleteSurface removed\n * it, and its id cannot be used again. `\"failed\"`: its createSurface was\n * rejected, so it does not exist; a corrected createSurface can use the id.\n */\n status?: \"deleted\" | \"failed\";\n}\n\n/** A user interaction bound to `{ event }`, sent to the agent. */\nexport interface GenerativeUIUserEvent {\n name: string;\n surfaceId: string;\n componentId: string;\n context: Record<string, unknown>;\n /** The resolved `event.userMessage`: the first line of the user message. */\n userMessage?: string;\n /** When the user acted, as an ISO 8601 string. Filled in when left out. */\n timestamp?: string;\n}\n\n/**\n * The A2UI 1.0 action message of a user event: what a renderer sends to the\n * agent when the user triggers an `{ event }` action. The run that the\n * event starts carries it in the envelope (`copilotkit_action`), next to\n * the visible user message.\n */\nexport interface A2UIActionMessage {\n version: typeof A2UI_VERSION;\n action: {\n name: string;\n surfaceId: string;\n sourceComponentId: string;\n /** ISO 8601. */\n timestamp: string;\n userMessage?: string;\n context: Record<string, unknown>;\n };\n}\n\n/**\n * The action message of a user event, with the A2UI field names. Takes the\n * time of the call when the event has no timestamp.\n *\n * @example\n * ```ts\n * toA2UIActionMessage({ name: \"buy\", surfaceId: \"s1\", componentId: \"b\", context: { sku: \"a\" } });\n * // { version: \"1.0\", action: { name: \"buy\", surfaceId: \"s1\", sourceComponentId: \"b\", timestamp: \"2026-…\", context: { sku: \"a\" } } }\n * ```\n */\nexport function toA2UIActionMessage(\n event: GenerativeUIUserEvent,\n): A2UIActionMessage {\n return {\n version: A2UI_VERSION,\n action: {\n name: event.name,\n surfaceId: event.surfaceId,\n sourceComponentId: event.componentId,\n timestamp: event.timestamp ?? new Date().toISOString(),\n ...(event.userMessage === undefined\n ? {}\n : { userMessage: event.userMessage }),\n context: event.context,\n },\n };\n}\n"],"mappings":";;;AACA,MAAa,eAAe;;AAE5B,MAAa,8BAA8B;;AAE3C,MAAa,4CACX;;AAEF,MAAa,4BAA4B;;AAEzC,MAAa,4BAA4B;;AAEzC,MAAa,wBAAwB;;;;;;;;;AASrC,MAAa,qCAAqC;;AAElD,MAAa,gDACX;;AAGF,SAAgB,6BAA6B,WAAmB;AAC9D,QAAO,SAAS;;;;;;;;;;;;;AAclB,SAAgB,kCAAkC,gBAAwB;AACxE,QAAO,YAAY;;;;;;;;AAwBrB,MAAa,+BAAoD,IAAI,IAAI;CACvE;CACA;CACA;CACD,CAAC;;AAiKF,MAAa,sCAAsC;;AAGnD,MAAa,uCAAuC;;AAEpD,MAAa,qCAAqC;;;;;;;;;;;AA+DlD,SAAgB,oBACd,OACmB;AACnB,QAAO;EACL,SAAS;EACT,QAAQ;GACN,MAAM,MAAM;GACZ,WAAW,MAAM;GACjB,mBAAmB,MAAM;GACzB,WAAW,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtD,GAAI,MAAM,gBAAgB,SACtB,EAAE,GACF,EAAE,aAAa,MAAM,aAAa;GACtC,SAAS,MAAM;GAChB;EACF"}
@@ -2,7 +2,7 @@ import { A2UIFunctionPermissions, A2UIFunctionReturnType } from "./basic-functio
2
2
 
3
3
  //#region src/generative-ui/types.d.ts
4
4
  /** A2UI protocol version used on the wire. */
5
- declare const A2UI_VERSION = "v1.0";
5
+ declare const A2UI_VERSION = "1.0";
6
6
  /** Activity type of a generated surface message. */
7
7
  declare const GENERATIVE_UI_ACTIVITY_TYPE = "generative-ui-surface";
8
8
  /** Activity type of a function call that the agent asks the client to run. */
@@ -61,7 +61,7 @@ type A2UIFunctionCall = {
61
61
  catalogId?: string;
62
62
  };
63
63
  type A2UIOperation = {
64
- version: "v1.0";
64
+ version: typeof A2UI_VERSION;
65
65
  createSurface: {
66
66
  surfaceId: string; /** Left out by the model. The run's catalog id is filled in. */
67
67
  catalogId?: string; /** Components to add at once, checked like `updateComponents`. */
@@ -73,13 +73,13 @@ type A2UIOperation = {
73
73
  };
74
74
  };
75
75
  } | {
76
- version: "v1.0";
76
+ version: typeof A2UI_VERSION;
77
77
  updateComponents: {
78
78
  surfaceId: string;
79
79
  components: A2UIComponentNode[];
80
80
  };
81
81
  } | {
82
- version: "v1.0";
82
+ version: typeof A2UI_VERSION;
83
83
  /**
84
84
  * Sets `value` at `path`. A `null` value deletes the key at `path`.
85
85
  * With no `path`, or `"/"`, it sets the whole data model.
@@ -90,12 +90,12 @@ type A2UIOperation = {
90
90
  value: unknown;
91
91
  };
92
92
  } | {
93
- version: "v1.0";
93
+ version: typeof A2UI_VERSION;
94
94
  deleteSurface: {
95
95
  surfaceId: string;
96
96
  };
97
97
  } | {
98
- version: "v1.0"; /** Runs an app function in the browser, with no user interaction. */
98
+ version: typeof A2UI_VERSION; /** Runs an app function in the browser, with no user interaction. */
99
99
  callRendererFunction: {
100
100
  functionCallId: string;
101
101
  callFunction: A2UIFunctionCall;
@@ -261,7 +261,7 @@ interface A2UIActionMessage {
261
261
  * @example
262
262
  * ```ts
263
263
  * toA2UIActionMessage({ name: "buy", surfaceId: "s1", componentId: "b", context: { sku: "a" } });
264
- * // { version: "v1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
264
+ * // { version: "1.0", action: { name: "buy", surfaceId: "s1", sourceComponentId: "b", timestamp: "2026-…", context: { sku: "a" } } }
265
265
  * ```
266
266
  */
267
267
  declare function toA2UIActionMessage(event: GenerativeUIUserEvent): A2UIActionMessage;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.cts","names":[],"sources":["../../src/generative-ui/types.ts"],"mappings":"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"}
1
+ {"version":3,"file":"types.d.cts","names":[],"sources":["../../src/generative-ui/types.ts"],"mappings":"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"}