@copilotkit/shared 1.55.0-next.9 → 1.55.1-next.0

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # @copilotkit/shared
 
-## 1.55.0-next.9
+## 1.55.1-next.0
+
+## 1.55.0
+
+### Minor Changes
+
+- 1ceb963: refactor: consolidate V1/V2 packages into flat @copilotkit/\* structure
+- 5289791: feat: add multimodal attachment support to the builtin agent
+
+### Patch Changes
+
+- 52a9322: Fixing license warnings, barrel export and typing
+- 434ccd8: A2UI v0.9 + Open Generative UI: BYOC catalogs, dark mode, sandboxed UI generation
 
 ## 1.55.0-next.8
 

package/dist/a2ui-prompts.cjs

@@ -0,0 +1,106 @@
+
+//#region src/a2ui-prompts.ts
+/**
+* Default A2UI generation and design guideline prompts.
+*
+* These are the canonical prompt fragments that instruct an LLM how to call
+* the render_a2ui tool, how to bind data, and how to style surfaces.
+*/
+/**
+* Generation guidelines — protocol rules, tool arguments, path rules,
+* data model format, and form/two-way-binding instructions.
+*/
+const A2UI_DEFAULT_GENERATION_GUIDELINES = `\
+Generate A2UI v0.9 JSON.
+
+## A2UI Protocol Instructions
+
+A2UI (Agent to UI) is a protocol for rendering rich UI surfaces from agent responses.
+
+CRITICAL: You MUST call the render_a2ui tool with ALL of these arguments:
+- surfaceId: A unique ID for the surface (e.g. "product-comparison")
+- components: REQUIRED — the A2UI component array. NEVER omit this. Only use
+  components listed in the Available Components schema provided as context.
+- data: OPTIONAL — a JSON object written to the root of the surface data model.
+  Use for pre-filling form values or providing data for path-bound components.
+- every component must have the "component" field specifying the component type.
+  ONLY use component names from the Available Components schema — do NOT invent
+  component names or use names not in the schema.
+
+COMPONENT ID RULES:
+- Every component ID must be unique within the surface.
+- A component MUST NOT reference itself as child/children. This causes a
+  circular dependency error. For example, if a component has id="avatar",
+  its child must be a DIFFERENT id (e.g. "avatar-img"), never "avatar".
+- The child/children tree must be a DAG — no cycles allowed.
+
+REPEATING CONTENT (TEMPLATES):
+To repeat a component for each item in an array, use the structural children format:
+  children: { componentId: "card-id", path: "/items" }
+This tells the renderer to create one instance of "card-id" per item in the "/items" array.
+
+PATH RULES FOR TEMPLATES:
+Components inside a repeating template use RELATIVE paths (no leading slash).
+The path is resolved relative to each array item automatically.
+If a container has children: { componentId: "card", path: "/items" } and each item
+has a key "name", use { "path": "name" } (NO leading slash — relative to item).
+CRITICAL: Do NOT use "/name" (absolute) inside templates — use "name" (relative).
+The container's path ("/items") uses a leading slash (absolute), but all
+components INSIDE the template use paths WITHOUT leading slash.
+
+DATA MODEL:
+The "data" key in the tool args is a plain JSON object that initializes the surface
+data model. Components bound to paths (e.g. "value": { "path": "/form/name" })
+read from and write to this data model. Examples:
+  For forms:  "data": { "form": { "name": "Alice", "email": "" } }
+  For lists:  "data": { "items": [{"name": "Product A"}, {"name": "Product B"}] }
+  For mixed:  "data": { "form": { "query": "" }, "results": [...] }
+
+FORMS AND TWO-WAY DATA BINDING:
+To create editable forms, bind input components to data model paths using { "path": "..." }.
+The client automatically writes user input back to the data model at the bound path.
+CRITICAL: Using a literal value (e.g. "value": "") makes the field READ-ONLY.
+You MUST use { "path": "..." } to make inputs editable.
+
+Input components use "value" as the binding property:
+  "value": { "path": "/form/fieldName" }
+
+To retrieve form values when a button is clicked, include "context" with path references
+in the button's action. Paths are resolved to their current values at click time:
+  "action": { "event": { "name": "submit", "context": { "userName": { "path": "/form/name" } } } }
+
+To pre-fill form values, pass initial data via the "data" tool argument:
+  "data": { "form": { "name": "Markus" } }`;
+/**
+* Design guidelines — visual design rules, component hierarchy tips,
+* and action handler patterns.
+*/
+const A2UI_DEFAULT_DESIGN_GUIDELINES = `\
+Create polished, visually appealing interfaces. ONLY use components listed in the
+Available Components schema — do NOT use component names that are not in the schema.
+
+Design principles:
+- Create clear visual hierarchy within cards and layouts.
+- Keep cards clean — avoid clutter. Whitespace is good.
+- Use consistent surfaceIds (lowercase, hyphenated).
+- NEVER use the same ID for a component and its child — this creates a
+  circular dependency. E.g. if id="avatar", child must NOT be "avatar".
+- For side-by-side comparisons, use a container with structural children
+  (children: { componentId, path }) to repeat a card template per data item.
+- Include images when relevant (logos, icons, product photos):
+  - Prefer company logos via Google favicons: https://www.google.com/s2/favicons?domain=example.com&sz=128
+  - Do NOT invent Unsplash photo-IDs — they will 404. Only use real, known URLs.
+- For buttons: action MUST use this exact nested format:
+    "action": { "event": { "name": "myAction", "context": { "key": "value" } } }
+  The "event" key holds an OBJECT with "name" (required) and "context" (optional).
+  Do NOT use a flat format like {"event": "name"} — "event" must be an object.
+- For forms: every input MUST use path binding on the "value" property
+  (e.g. "value": { "path": "/form/name" }) to be editable. The submit button's
+  action context MUST reference the same paths to capture the user's input.
+
+Use the SAME surfaceId as the main surface. Match action names to button action event names.`;
+
+//#endregion
+exports.A2UI_DEFAULT_DESIGN_GUIDELINES = A2UI_DEFAULT_DESIGN_GUIDELINES;
+exports.A2UI_DEFAULT_GENERATION_GUIDELINES = A2UI_DEFAULT_GENERATION_GUIDELINES;
+//# sourceMappingURL=a2ui-prompts.cjs.map

package/dist/a2ui-prompts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2ui-prompts.cjs","names":[],"sources":["../src/a2ui-prompts.ts"],"sourcesContent":["/**\n * Default A2UI generation and design guideline prompts.\n *\n * These are the canonical prompt fragments that instruct an LLM how to call\n * the render_a2ui tool, how to bind data, and how to style surfaces.\n */\n\n/**\n * Generation guidelines — protocol rules, tool arguments, path rules,\n * data model format, and form/two-way-binding instructions.\n */\nexport const A2UI_DEFAULT_GENERATION_GUIDELINES = `\\\nGenerate A2UI v0.9 JSON.\n\n## A2UI Protocol Instructions\n\nA2UI (Agent to UI) is a protocol for rendering rich UI surfaces from agent responses.\n\nCRITICAL: You MUST call the render_a2ui tool with ALL of these arguments:\n- surfaceId: A unique ID for the surface (e.g. \"product-comparison\")\n- components: REQUIRED — the A2UI component array. NEVER omit this. Only use\n  components listed in the Available Components schema provided as context.\n- data: OPTIONAL — a JSON object written to the root of the surface data model.\n  Use for pre-filling form values or providing data for path-bound components.\n- every component must have the \"component\" field specifying the component type.\n  ONLY use component names from the Available Components schema — do NOT invent\n  component names or use names not in the schema.\n\nCOMPONENT ID RULES:\n- Every component ID must be unique within the surface.\n- A component MUST NOT reference itself as child/children. This causes a\n  circular dependency error. For example, if a component has id=\"avatar\",\n  its child must be a DIFFERENT id (e.g. \"avatar-img\"), never \"avatar\".\n- The child/children tree must be a DAG — no cycles allowed.\n\nREPEATING CONTENT (TEMPLATES):\nTo repeat a component for each item in an array, use the structural children format:\n  children: { componentId: \"card-id\", path: \"/items\" }\nThis tells the renderer to create one instance of \"card-id\" per item in the \"/items\" array.\n\nPATH RULES FOR TEMPLATES:\nComponents inside a repeating template use RELATIVE paths (no leading slash).\nThe path is resolved relative to each array item automatically.\nIf a container has children: { componentId: \"card\", path: \"/items\" } and each item\nhas a key \"name\", use { \"path\": \"name\" } (NO leading slash — relative to item).\nCRITICAL: Do NOT use \"/name\" (absolute) inside templates — use \"name\" (relative).\nThe container's path (\"/items\") uses a leading slash (absolute), but all\ncomponents INSIDE the template use paths WITHOUT leading slash.\n\nDATA MODEL:\nThe \"data\" key in the tool args is a plain JSON object that initializes the surface\ndata model. Components bound to paths (e.g. \"value\": { \"path\": \"/form/name\" })\nread from and write to this data model. Examples:\n  For forms:  \"data\": { \"form\": { \"name\": \"Alice\", \"email\": \"\" } }\n  For lists:  \"data\": { \"items\": [{\"name\": \"Product A\"}, {\"name\": \"Product B\"}] }\n  For mixed:  \"data\": { \"form\": { \"query\": \"\" }, \"results\": [...] }\n\nFORMS AND TWO-WAY DATA BINDING:\nTo create editable forms, bind input components to data model paths using { \"path\": \"...\" }.\nThe client automatically writes user input back to the data model at the bound path.\nCRITICAL: Using a literal value (e.g. \"value\": \"\") makes the field READ-ONLY.\nYou MUST use { \"path\": \"...\" } to make inputs editable.\n\nInput components use \"value\" as the binding property:\n  \"value\": { \"path\": \"/form/fieldName\" }\n\nTo retrieve form values when a button is clicked, include \"context\" with path references\nin the button's action. Paths are resolved to their current values at click time:\n  \"action\": { \"event\": { \"name\": \"submit\", \"context\": { \"userName\": { \"path\": \"/form/name\" } } } }\n\nTo pre-fill form values, pass initial data via the \"data\" tool argument:\n  \"data\": { \"form\": { \"name\": \"Markus\" } }`;\n\n/**\n * Design guidelines — visual design rules, component hierarchy tips,\n * and action handler patterns.\n */\nexport const A2UI_DEFAULT_DESIGN_GUIDELINES = `\\\nCreate polished, visually appealing interfaces. ONLY use components listed in the\nAvailable Components schema — do NOT use component names that are not in the schema.\n\nDesign principles:\n- Create clear visual hierarchy within cards and layouts.\n- Keep cards clean — avoid clutter. Whitespace is good.\n- Use consistent surfaceIds (lowercase, hyphenated).\n- NEVER use the same ID for a component and its child — this creates a\n  circular dependency. E.g. if id=\"avatar\", child must NOT be \"avatar\".\n- For side-by-side comparisons, use a container with structural children\n  (children: { componentId, path }) to repeat a card template per data item.\n- Include images when relevant (logos, icons, product photos):\n  - Prefer company logos via Google favicons: https://www.google.com/s2/favicons?domain=example.com&sz=128\n  - Do NOT invent Unsplash photo-IDs — they will 404. Only use real, known URLs.\n- For buttons: action MUST use this exact nested format:\n    \"action\": { \"event\": { \"name\": \"myAction\", \"context\": { \"key\": \"value\" } } }\n  The \"event\" key holds an OBJECT with \"name\" (required) and \"context\" (optional).\n  Do NOT use a flat format like {\"event\": \"name\"} — \"event\" must be an object.\n- For forms: every input MUST use path binding on the \"value\" property\n  (e.g. \"value\": { \"path\": \"/form/name\" }) to be editable. The submit button's\n  action context MUST reference the same paths to capture the user's input.\n\nUse the SAME surfaceId as the main surface. Match action names to button action event names.`;\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkElD,MAAa,iCAAiC"}

package/dist/a2ui-prompts.d.cts

@@ -0,0 +1,20 @@
+//#region src/a2ui-prompts.d.ts
+/**
+ * Default A2UI generation and design guideline prompts.
+ *
+ * These are the canonical prompt fragments that instruct an LLM how to call
+ * the render_a2ui tool, how to bind data, and how to style surfaces.
+ */
+/**
+ * Generation guidelines — protocol rules, tool arguments, path rules,
+ * data model format, and form/two-way-binding instructions.
+ */
+declare const A2UI_DEFAULT_GENERATION_GUIDELINES = "Generate A2UI v0.9 JSON.\n\n## A2UI Protocol Instructions\n\nA2UI (Agent to UI) is a protocol for rendering rich UI surfaces from agent responses.\n\nCRITICAL: You MUST call the render_a2ui tool with ALL of these arguments:\n- surfaceId: A unique ID for the surface (e.g. \"product-comparison\")\n- components: REQUIRED \u2014 the A2UI component array. NEVER omit this. Only use\n  components listed in the Available Components schema provided as context.\n- data: OPTIONAL \u2014 a JSON object written to the root of the surface data model.\n  Use for pre-filling form values or providing data for path-bound components.\n- every component must have the \"component\" field specifying the component type.\n  ONLY use component names from the Available Components schema \u2014 do NOT invent\n  component names or use names not in the schema.\n\nCOMPONENT ID RULES:\n- Every component ID must be unique within the surface.\n- A component MUST NOT reference itself as child/children. This causes a\n  circular dependency error. For example, if a component has id=\"avatar\",\n  its child must be a DIFFERENT id (e.g. \"avatar-img\"), never \"avatar\".\n- The child/children tree must be a DAG \u2014 no cycles allowed.\n\nREPEATING CONTENT (TEMPLATES):\nTo repeat a component for each item in an array, use the structural children format:\n  children: { componentId: \"card-id\", path: \"/items\" }\nThis tells the renderer to create one instance of \"card-id\" per item in the \"/items\" array.\n\nPATH RULES FOR TEMPLATES:\nComponents inside a repeating template use RELATIVE paths (no leading slash).\nThe path is resolved relative to each array item automatically.\nIf a container has children: { componentId: \"card\", path: \"/items\" } and each item\nhas a key \"name\", use { \"path\": \"name\" } (NO leading slash \u2014 relative to item).\nCRITICAL: Do NOT use \"/name\" (absolute) inside templates \u2014 use \"name\" (relative).\nThe container's path (\"/items\") uses a leading slash (absolute), but all\ncomponents INSIDE the template use paths WITHOUT leading slash.\n\nDATA MODEL:\nThe \"data\" key in the tool args is a plain JSON object that initializes the surface\ndata model. Components bound to paths (e.g. \"value\": { \"path\": \"/form/name\" })\nread from and write to this data model. Examples:\n  For forms:  \"data\": { \"form\": { \"name\": \"Alice\", \"email\": \"\" } }\n  For lists:  \"data\": { \"items\": [{\"name\": \"Product A\"}, {\"name\": \"Product B\"}] }\n  For mixed:  \"data\": { \"form\": { \"query\": \"\" }, \"results\": [...] }\n\nFORMS AND TWO-WAY DATA BINDING:\nTo create editable forms, bind input components to data model paths using { \"path\": \"...\" }.\nThe client automatically writes user input back to the data model at the bound path.\nCRITICAL: Using a literal value (e.g. \"value\": \"\") makes the field READ-ONLY.\nYou MUST use { \"path\": \"...\" } to make inputs editable.\n\nInput components use \"value\" as the binding property:\n  \"value\": { \"path\": \"/form/fieldName\" }\n\nTo retrieve form values when a button is clicked, include \"context\" with path references\nin the button's action. Paths are resolved to their current values at click time:\n  \"action\": { \"event\": { \"name\": \"submit\", \"context\": { \"userName\": { \"path\": \"/form/name\" } } } }\n\nTo pre-fill form values, pass initial data via the \"data\" tool argument:\n  \"data\": { \"form\": { \"name\": \"Markus\" } }";
+/**
+ * Design guidelines — visual design rules, component hierarchy tips,
+ * and action handler patterns.
+ */
+declare const A2UI_DEFAULT_DESIGN_GUIDELINES = "Create polished, visually appealing interfaces. ONLY use components listed in the\nAvailable Components schema \u2014 do NOT use component names that are not in the schema.\n\nDesign principles:\n- Create clear visual hierarchy within cards and layouts.\n- Keep cards clean \u2014 avoid clutter. Whitespace is good.\n- Use consistent surfaceIds (lowercase, hyphenated).\n- NEVER use the same ID for a component and its child \u2014 this creates a\n  circular dependency. E.g. if id=\"avatar\", child must NOT be \"avatar\".\n- For side-by-side comparisons, use a container with structural children\n  (children: { componentId, path }) to repeat a card template per data item.\n- Include images when relevant (logos, icons, product photos):\n  - Prefer company logos via Google favicons: https://www.google.com/s2/favicons?domain=example.com&sz=128\n  - Do NOT invent Unsplash photo-IDs \u2014 they will 404. Only use real, known URLs.\n- For buttons: action MUST use this exact nested format:\n    \"action\": { \"event\": { \"name\": \"myAction\", \"context\": { \"key\": \"value\" } } }\n  The \"event\" key holds an OBJECT with \"name\" (required) and \"context\" (optional).\n  Do NOT use a flat format like {\"event\": \"name\"} \u2014 \"event\" must be an object.\n- For forms: every input MUST use path binding on the \"value\" property\n  (e.g. \"value\": { \"path\": \"/form/name\" }) to be editable. The submit button's\n  action context MUST reference the same paths to capture the user's input.\n\nUse the SAME surfaceId as the main surface. Match action names to button action event names.";
+//#endregion
+export { A2UI_DEFAULT_DESIGN_GUIDELINES, A2UI_DEFAULT_GENERATION_GUIDELINES };
+//# sourceMappingURL=a2ui-prompts.d.cts.map

package/dist/a2ui-prompts.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2ui-prompts.d.cts","names":[],"sources":["../src/a2ui-prompts.ts"],"mappings":";;AAWA;;;;;AAkEA;;;;AAAA,cAlEa,kCAAA;;;;;cAkEA,8BAAA"}

package/dist/a2ui-prompts.d.mts

@@ -0,0 +1,20 @@
+//#region src/a2ui-prompts.d.ts
+/**
+ * Default A2UI generation and design guideline prompts.
+ *
+ * These are the canonical prompt fragments that instruct an LLM how to call
+ * the render_a2ui tool, how to bind data, and how to style surfaces.
+ */
+/**
+ * Generation guidelines — protocol rules, tool arguments, path rules,
+ * data model format, and form/two-way-binding instructions.
+ */
+declare const A2UI_DEFAULT_GENERATION_GUIDELINES = "Generate A2UI v0.9 JSON.\n\n## A2UI Protocol Instructions\n\nA2UI (Agent to UI) is a protocol for rendering rich UI surfaces from agent responses.\n\nCRITICAL: You MUST call the render_a2ui tool with ALL of these arguments:\n- surfaceId: A unique ID for the surface (e.g. \"product-comparison\")\n- components: REQUIRED \u2014 the A2UI component array. NEVER omit this. Only use\n  components listed in the Available Components schema provided as context.\n- data: OPTIONAL \u2014 a JSON object written to the root of the surface data model.\n  Use for pre-filling form values or providing data for path-bound components.\n- every component must have the \"component\" field specifying the component type.\n  ONLY use component names from the Available Components schema \u2014 do NOT invent\n  component names or use names not in the schema.\n\nCOMPONENT ID RULES:\n- Every component ID must be unique within the surface.\n- A component MUST NOT reference itself as child/children. This causes a\n  circular dependency error. For example, if a component has id=\"avatar\",\n  its child must be a DIFFERENT id (e.g. \"avatar-img\"), never \"avatar\".\n- The child/children tree must be a DAG \u2014 no cycles allowed.\n\nREPEATING CONTENT (TEMPLATES):\nTo repeat a component for each item in an array, use the structural children format:\n  children: { componentId: \"card-id\", path: \"/items\" }\nThis tells the renderer to create one instance of \"card-id\" per item in the \"/items\" array.\n\nPATH RULES FOR TEMPLATES:\nComponents inside a repeating template use RELATIVE paths (no leading slash).\nThe path is resolved relative to each array item automatically.\nIf a container has children: { componentId: \"card\", path: \"/items\" } and each item\nhas a key \"name\", use { \"path\": \"name\" } (NO leading slash \u2014 relative to item).\nCRITICAL: Do NOT use \"/name\" (absolute) inside templates \u2014 use \"name\" (relative).\nThe container's path (\"/items\") uses a leading slash (absolute), but all\ncomponents INSIDE the template use paths WITHOUT leading slash.\n\nDATA MODEL:\nThe \"data\" key in the tool args is a plain JSON object that initializes the surface\ndata model. Components bound to paths (e.g. \"value\": { \"path\": \"/form/name\" })\nread from and write to this data model. Examples:\n  For forms:  \"data\": { \"form\": { \"name\": \"Alice\", \"email\": \"\" } }\n  For lists:  \"data\": { \"items\": [{\"name\": \"Product A\"}, {\"name\": \"Product B\"}] }\n  For mixed:  \"data\": { \"form\": { \"query\": \"\" }, \"results\": [...] }\n\nFORMS AND TWO-WAY DATA BINDING:\nTo create editable forms, bind input components to data model paths using { \"path\": \"...\" }.\nThe client automatically writes user input back to the data model at the bound path.\nCRITICAL: Using a literal value (e.g. \"value\": \"\") makes the field READ-ONLY.\nYou MUST use { \"path\": \"...\" } to make inputs editable.\n\nInput components use \"value\" as the binding property:\n  \"value\": { \"path\": \"/form/fieldName\" }\n\nTo retrieve form values when a button is clicked, include \"context\" with path references\nin the button's action. Paths are resolved to their current values at click time:\n  \"action\": { \"event\": { \"name\": \"submit\", \"context\": { \"userName\": { \"path\": \"/form/name\" } } } }\n\nTo pre-fill form values, pass initial data via the \"data\" tool argument:\n  \"data\": { \"form\": { \"name\": \"Markus\" } }";
+/**
+ * Design guidelines — visual design rules, component hierarchy tips,
+ * and action handler patterns.
+ */
+declare const A2UI_DEFAULT_DESIGN_GUIDELINES = "Create polished, visually appealing interfaces. ONLY use components listed in the\nAvailable Components schema \u2014 do NOT use component names that are not in the schema.\n\nDesign principles:\n- Create clear visual hierarchy within cards and layouts.\n- Keep cards clean \u2014 avoid clutter. Whitespace is good.\n- Use consistent surfaceIds (lowercase, hyphenated).\n- NEVER use the same ID for a component and its child \u2014 this creates a\n  circular dependency. E.g. if id=\"avatar\", child must NOT be \"avatar\".\n- For side-by-side comparisons, use a container with structural children\n  (children: { componentId, path }) to repeat a card template per data item.\n- Include images when relevant (logos, icons, product photos):\n  - Prefer company logos via Google favicons: https://www.google.com/s2/favicons?domain=example.com&sz=128\n  - Do NOT invent Unsplash photo-IDs \u2014 they will 404. Only use real, known URLs.\n- For buttons: action MUST use this exact nested format:\n    \"action\": { \"event\": { \"name\": \"myAction\", \"context\": { \"key\": \"value\" } } }\n  The \"event\" key holds an OBJECT with \"name\" (required) and \"context\" (optional).\n  Do NOT use a flat format like {\"event\": \"name\"} \u2014 \"event\" must be an object.\n- For forms: every input MUST use path binding on the \"value\" property\n  (e.g. \"value\": { \"path\": \"/form/name\" }) to be editable. The submit button's\n  action context MUST reference the same paths to capture the user's input.\n\nUse the SAME surfaceId as the main surface. Match action names to button action event names.";
+//#endregion
+export { A2UI_DEFAULT_DESIGN_GUIDELINES, A2UI_DEFAULT_GENERATION_GUIDELINES };
+//# sourceMappingURL=a2ui-prompts.d.mts.map

package/dist/a2ui-prompts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2ui-prompts.d.mts","names":[],"sources":["../src/a2ui-prompts.ts"],"mappings":";;AAWA;;;;;AAkEA;;;;AAAA,cAlEa,kCAAA;;;;;cAkEA,8BAAA"}

package/dist/a2ui-prompts.mjs

@@ -0,0 +1,104 @@
+//#region src/a2ui-prompts.ts
+/**
+* Default A2UI generation and design guideline prompts.
+*
+* These are the canonical prompt fragments that instruct an LLM how to call
+* the render_a2ui tool, how to bind data, and how to style surfaces.
+*/
+/**
+* Generation guidelines — protocol rules, tool arguments, path rules,
+* data model format, and form/two-way-binding instructions.
+*/
+const A2UI_DEFAULT_GENERATION_GUIDELINES = `\
+Generate A2UI v0.9 JSON.
+
+## A2UI Protocol Instructions
+
+A2UI (Agent to UI) is a protocol for rendering rich UI surfaces from agent responses.
+
+CRITICAL: You MUST call the render_a2ui tool with ALL of these arguments:
+- surfaceId: A unique ID for the surface (e.g. "product-comparison")
+- components: REQUIRED — the A2UI component array. NEVER omit this. Only use
+  components listed in the Available Components schema provided as context.
+- data: OPTIONAL — a JSON object written to the root of the surface data model.
+  Use for pre-filling form values or providing data for path-bound components.
+- every component must have the "component" field specifying the component type.
+  ONLY use component names from the Available Components schema — do NOT invent
+  component names or use names not in the schema.
+
+COMPONENT ID RULES:
+- Every component ID must be unique within the surface.
+- A component MUST NOT reference itself as child/children. This causes a
+  circular dependency error. For example, if a component has id="avatar",
+  its child must be a DIFFERENT id (e.g. "avatar-img"), never "avatar".
+- The child/children tree must be a DAG — no cycles allowed.
+
+REPEATING CONTENT (TEMPLATES):
+To repeat a component for each item in an array, use the structural children format:
+  children: { componentId: "card-id", path: "/items" }
+This tells the renderer to create one instance of "card-id" per item in the "/items" array.
+
+PATH RULES FOR TEMPLATES:
+Components inside a repeating template use RELATIVE paths (no leading slash).
+The path is resolved relative to each array item automatically.
+If a container has children: { componentId: "card", path: "/items" } and each item
+has a key "name", use { "path": "name" } (NO leading slash — relative to item).
+CRITICAL: Do NOT use "/name" (absolute) inside templates — use "name" (relative).
+The container's path ("/items") uses a leading slash (absolute), but all
+components INSIDE the template use paths WITHOUT leading slash.
+
+DATA MODEL:
+The "data" key in the tool args is a plain JSON object that initializes the surface
+data model. Components bound to paths (e.g. "value": { "path": "/form/name" })
+read from and write to this data model. Examples:
+  For forms:  "data": { "form": { "name": "Alice", "email": "" } }
+  For lists:  "data": { "items": [{"name": "Product A"}, {"name": "Product B"}] }
+  For mixed:  "data": { "form": { "query": "" }, "results": [...] }
+
+FORMS AND TWO-WAY DATA BINDING:
+To create editable forms, bind input components to data model paths using { "path": "..." }.
+The client automatically writes user input back to the data model at the bound path.
+CRITICAL: Using a literal value (e.g. "value": "") makes the field READ-ONLY.
+You MUST use { "path": "..." } to make inputs editable.
+
+Input components use "value" as the binding property:
+  "value": { "path": "/form/fieldName" }
+
+To retrieve form values when a button is clicked, include "context" with path references
+in the button's action. Paths are resolved to their current values at click time:
+  "action": { "event": { "name": "submit", "context": { "userName": { "path": "/form/name" } } } }
+
+To pre-fill form values, pass initial data via the "data" tool argument:
+  "data": { "form": { "name": "Markus" } }`;
+/**
+* Design guidelines — visual design rules, component hierarchy tips,
+* and action handler patterns.
+*/
+const A2UI_DEFAULT_DESIGN_GUIDELINES = `\
+Create polished, visually appealing interfaces. ONLY use components listed in the
+Available Components schema — do NOT use component names that are not in the schema.
+
+Design principles:
+- Create clear visual hierarchy within cards and layouts.
+- Keep cards clean — avoid clutter. Whitespace is good.
+- Use consistent surfaceIds (lowercase, hyphenated).
+- NEVER use the same ID for a component and its child — this creates a
+  circular dependency. E.g. if id="avatar", child must NOT be "avatar".
+- For side-by-side comparisons, use a container with structural children
+  (children: { componentId, path }) to repeat a card template per data item.
+- Include images when relevant (logos, icons, product photos):
+  - Prefer company logos via Google favicons: https://www.google.com/s2/favicons?domain=example.com&sz=128
+  - Do NOT invent Unsplash photo-IDs — they will 404. Only use real, known URLs.
+- For buttons: action MUST use this exact nested format:
+    "action": { "event": { "name": "myAction", "context": { "key": "value" } } }
+  The "event" key holds an OBJECT with "name" (required) and "context" (optional).
+  Do NOT use a flat format like {"event": "name"} — "event" must be an object.
+- For forms: every input MUST use path binding on the "value" property
+  (e.g. "value": { "path": "/form/name" }) to be editable. The submit button's
+  action context MUST reference the same paths to capture the user's input.
+
+Use the SAME surfaceId as the main surface. Match action names to button action event names.`;
+
+//#endregion
+export { A2UI_DEFAULT_DESIGN_GUIDELINES, A2UI_DEFAULT_GENERATION_GUIDELINES };
+//# sourceMappingURL=a2ui-prompts.mjs.map

package/dist/a2ui-prompts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2ui-prompts.mjs","names":[],"sources":["../src/a2ui-prompts.ts"],"sourcesContent":["/**\n * Default A2UI generation and design guideline prompts.\n *\n * These are the canonical prompt fragments that instruct an LLM how to call\n * the render_a2ui tool, how to bind data, and how to style surfaces.\n */\n\n/**\n * Generation guidelines — protocol rules, tool arguments, path rules,\n * data model format, and form/two-way-binding instructions.\n */\nexport const A2UI_DEFAULT_GENERATION_GUIDELINES = `\\\nGenerate A2UI v0.9 JSON.\n\n## A2UI Protocol Instructions\n\nA2UI (Agent to UI) is a protocol for rendering rich UI surfaces from agent responses.\n\nCRITICAL: You MUST call the render_a2ui tool with ALL of these arguments:\n- surfaceId: A unique ID for the surface (e.g. \"product-comparison\")\n- components: REQUIRED — the A2UI component array. NEVER omit this. Only use\n  components listed in the Available Components schema provided as context.\n- data: OPTIONAL — a JSON object written to the root of the surface data model.\n  Use for pre-filling form values or providing data for path-bound components.\n- every component must have the \"component\" field specifying the component type.\n  ONLY use component names from the Available Components schema — do NOT invent\n  component names or use names not in the schema.\n\nCOMPONENT ID RULES:\n- Every component ID must be unique within the surface.\n- A component MUST NOT reference itself as child/children. This causes a\n  circular dependency error. For example, if a component has id=\"avatar\",\n  its child must be a DIFFERENT id (e.g. \"avatar-img\"), never \"avatar\".\n- The child/children tree must be a DAG — no cycles allowed.\n\nREPEATING CONTENT (TEMPLATES):\nTo repeat a component for each item in an array, use the structural children format:\n  children: { componentId: \"card-id\", path: \"/items\" }\nThis tells the renderer to create one instance of \"card-id\" per item in the \"/items\" array.\n\nPATH RULES FOR TEMPLATES:\nComponents inside a repeating template use RELATIVE paths (no leading slash).\nThe path is resolved relative to each array item automatically.\nIf a container has children: { componentId: \"card\", path: \"/items\" } and each item\nhas a key \"name\", use { \"path\": \"name\" } (NO leading slash — relative to item).\nCRITICAL: Do NOT use \"/name\" (absolute) inside templates — use \"name\" (relative).\nThe container's path (\"/items\") uses a leading slash (absolute), but all\ncomponents INSIDE the template use paths WITHOUT leading slash.\n\nDATA MODEL:\nThe \"data\" key in the tool args is a plain JSON object that initializes the surface\ndata model. Components bound to paths (e.g. \"value\": { \"path\": \"/form/name\" })\nread from and write to this data model. Examples:\n  For forms:  \"data\": { \"form\": { \"name\": \"Alice\", \"email\": \"\" } }\n  For lists:  \"data\": { \"items\": [{\"name\": \"Product A\"}, {\"name\": \"Product B\"}] }\n  For mixed:  \"data\": { \"form\": { \"query\": \"\" }, \"results\": [...] }\n\nFORMS AND TWO-WAY DATA BINDING:\nTo create editable forms, bind input components to data model paths using { \"path\": \"...\" }.\nThe client automatically writes user input back to the data model at the bound path.\nCRITICAL: Using a literal value (e.g. \"value\": \"\") makes the field READ-ONLY.\nYou MUST use { \"path\": \"...\" } to make inputs editable.\n\nInput components use \"value\" as the binding property:\n  \"value\": { \"path\": \"/form/fieldName\" }\n\nTo retrieve form values when a button is clicked, include \"context\" with path references\nin the button's action. Paths are resolved to their current values at click time:\n  \"action\": { \"event\": { \"name\": \"submit\", \"context\": { \"userName\": { \"path\": \"/form/name\" } } } }\n\nTo pre-fill form values, pass initial data via the \"data\" tool argument:\n  \"data\": { \"form\": { \"name\": \"Markus\" } }`;\n\n/**\n * Design guidelines — visual design rules, component hierarchy tips,\n * and action handler patterns.\n */\nexport const A2UI_DEFAULT_DESIGN_GUIDELINES = `\\\nCreate polished, visually appealing interfaces. ONLY use components listed in the\nAvailable Components schema — do NOT use component names that are not in the schema.\n\nDesign principles:\n- Create clear visual hierarchy within cards and layouts.\n- Keep cards clean — avoid clutter. Whitespace is good.\n- Use consistent surfaceIds (lowercase, hyphenated).\n- NEVER use the same ID for a component and its child — this creates a\n  circular dependency. E.g. if id=\"avatar\", child must NOT be \"avatar\".\n- For side-by-side comparisons, use a container with structural children\n  (children: { componentId, path }) to repeat a card template per data item.\n- Include images when relevant (logos, icons, product photos):\n  - Prefer company logos via Google favicons: https://www.google.com/s2/favicons?domain=example.com&sz=128\n  - Do NOT invent Unsplash photo-IDs — they will 404. Only use real, known URLs.\n- For buttons: action MUST use this exact nested format:\n    \"action\": { \"event\": { \"name\": \"myAction\", \"context\": { \"key\": \"value\" } } }\n  The \"event\" key holds an OBJECT with \"name\" (required) and \"context\" (optional).\n  Do NOT use a flat format like {\"event\": \"name\"} — \"event\" must be an object.\n- For forms: every input MUST use path binding on the \"value\" property\n  (e.g. \"value\": { \"path\": \"/form/name\" }) to be editable. The submit button's\n  action context MUST reference the same paths to capture the user's input.\n\nUse the SAME surfaceId as the main surface. Match action names to button action event names.`;\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkElD,MAAa,iCAAiC"}

package/dist/attachments/types.d.cts

@@ -0,0 +1,54 @@
+import { InputContentDataSource, InputContentUrlSource } from "@ag-ui/core";
+
+//#region src/attachments/types.d.ts
+interface AttachmentUploadDataResult {
+  type: "data";
+  value: string;
+  mimeType: string;
+  /** Custom metadata to include in the InputContent part (merged with auto-generated metadata like filename). */
+  metadata?: Record<string, unknown>;
+}
+interface AttachmentUploadUrlResult {
+  type: "url";
+  value: string;
+  mimeType?: string;
+  /** Custom metadata to include in the InputContent part (merged with auto-generated metadata like filename). */
+  metadata?: Record<string, unknown>;
+}
+type AttachmentUploadResult = AttachmentUploadDataResult | AttachmentUploadUrlResult;
+type AttachmentUploadErrorReason = "file-too-large" | "invalid-type" | "upload-failed";
+interface AttachmentUploadError {
+  /** Why the upload failed. */
+  reason: AttachmentUploadErrorReason;
+  /** The file that failed to upload. */
+  file: File;
+  /** Human-readable error message. */
+  message: string;
+}
+interface AttachmentsConfig {
+  /** Enable file attachments in the chat input */
+  enabled: boolean;
+  /** MIME type filter for the file input, default all files */
+  accept?: string;
+  /** Maximum file size in bytes, default 20MB (20 * 1024 * 1024) */
+  maxSize?: number;
+  /** Custom upload handler. Return an InputContentSource with optional metadata. */
+  onUpload?: (file: File) => AttachmentUploadResult | Promise<AttachmentUploadResult>;
+  /** Called when an attachment fails validation or upload. Use this to show a toast or inline error. */
+  onUploadFailed?: (error: AttachmentUploadError) => void;
+}
+type AttachmentModality = "image" | "audio" | "video" | "document";
+interface Attachment {
+  id: string;
+  type: AttachmentModality;
+  source: InputContentDataSource | InputContentUrlSource;
+  filename?: string;
+  size?: number;
+  status: "uploading" | "ready";
+  thumbnail?: string;
+  /** Custom metadata from onUpload, included in the InputContent part. */
+  metadata?: Record<string, unknown>;
+}
+//#endregion
+export { Attachment, AttachmentModality, AttachmentUploadError, AttachmentUploadErrorReason, AttachmentUploadResult, AttachmentsConfig };
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/attachments/types.ts"],"mappings":";;;UAKiB,0BAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA;;EAEA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,yBAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA;EANiB;EAQjB,QAAA,GAAW,MAAA;AAAA;AAAA,KAGD,sBAAA,GACR,0BAAA,GACA,yBAAA;AAAA,KAEQ,2BAAA;AAAA,UAKK,qBAAA;EAhBf;EAkBA,MAAA,EAAQ,2BAAA;EAhBR;EAkBA,IAAA,EAAM,IAAA;EAhBK;EAkBX,OAAA;AAAA;AAAA,UAGe,iBAAA;EAlBiB;EAoBhC,OAAA;EAnBE;EAqBF,MAAA;EAlBU;EAoBV,OAAA;;EAEA,QAAA,IACE,IAAA,EAAM,IAAA,KACH,sBAAA,GAAyB,OAAA,CAAQ,sBAAA;EAxBD;EA0BrC,cAAA,IAAkB,KAAA,EAAO,qBAAA;AAAA;AAAA,KAGf,kBAAA;AAAA,UAEK,UAAA;EACf,EAAA;EACA,IAAA,EAAM,kBAAA;EACN,MAAA,EAAQ,sBAAA,GAAyB,qBAAA;EACjC,QAAA;EACA,IAAA;EACA,MAAA;EACA,SAAA;EAxBe;EA0Bf,QAAA,GAAW,MAAA;AAAA"}

package/dist/attachments/types.d.mts

@@ -0,0 +1,54 @@
+import { InputContentDataSource, InputContentUrlSource } from "@ag-ui/core";
+
+//#region src/attachments/types.d.ts
+interface AttachmentUploadDataResult {
+  type: "data";
+  value: string;
+  mimeType: string;
+  /** Custom metadata to include in the InputContent part (merged with auto-generated metadata like filename). */
+  metadata?: Record<string, unknown>;
+}
+interface AttachmentUploadUrlResult {
+  type: "url";
+  value: string;
+  mimeType?: string;
+  /** Custom metadata to include in the InputContent part (merged with auto-generated metadata like filename). */
+  metadata?: Record<string, unknown>;
+}
+type AttachmentUploadResult = AttachmentUploadDataResult | AttachmentUploadUrlResult;
+type AttachmentUploadErrorReason = "file-too-large" | "invalid-type" | "upload-failed";
+interface AttachmentUploadError {
+  /** Why the upload failed. */
+  reason: AttachmentUploadErrorReason;
+  /** The file that failed to upload. */
+  file: File;
+  /** Human-readable error message. */
+  message: string;
+}
+interface AttachmentsConfig {
+  /** Enable file attachments in the chat input */
+  enabled: boolean;
+  /** MIME type filter for the file input, default all files */
+  accept?: string;
+  /** Maximum file size in bytes, default 20MB (20 * 1024 * 1024) */
+  maxSize?: number;
+  /** Custom upload handler. Return an InputContentSource with optional metadata. */
+  onUpload?: (file: File) => AttachmentUploadResult | Promise<AttachmentUploadResult>;
+  /** Called when an attachment fails validation or upload. Use this to show a toast or inline error. */
+  onUploadFailed?: (error: AttachmentUploadError) => void;
+}
+type AttachmentModality = "image" | "audio" | "video" | "document";
+interface Attachment {
+  id: string;
+  type: AttachmentModality;
+  source: InputContentDataSource | InputContentUrlSource;
+  filename?: string;
+  size?: number;
+  status: "uploading" | "ready";
+  thumbnail?: string;
+  /** Custom metadata from onUpload, included in the InputContent part. */
+  metadata?: Record<string, unknown>;
+}
+//#endregion
+export { Attachment, AttachmentModality, AttachmentUploadError, AttachmentUploadErrorReason, AttachmentUploadResult, AttachmentsConfig };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/attachments/types.ts"],"mappings":";;;UAKiB,0BAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA;;EAEA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,yBAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA;EANiB;EAQjB,QAAA,GAAW,MAAA;AAAA;AAAA,KAGD,sBAAA,GACR,0BAAA,GACA,yBAAA;AAAA,KAEQ,2BAAA;AAAA,UAKK,qBAAA;EAhBf;EAkBA,MAAA,EAAQ,2BAAA;EAhBR;EAkBA,IAAA,EAAM,IAAA;EAhBK;EAkBX,OAAA;AAAA;AAAA,UAGe,iBAAA;EAlBiB;EAoBhC,OAAA;EAnBE;EAqBF,MAAA;EAlBU;EAoBV,OAAA;;EAEA,QAAA,IACE,IAAA,EAAM,IAAA,KACH,sBAAA,GAAyB,OAAA,CAAQ,sBAAA;EAxBD;EA0BrC,cAAA,IAAkB,KAAA,EAAO,qBAAA;AAAA;AAAA,KAGf,kBAAA;AAAA,UAEK,UAAA;EACf,EAAA;EACA,IAAA,EAAM,kBAAA;EACN,MAAA,EAAQ,sBAAA,GAAyB,qBAAA;EACjC,QAAA;EACA,IAAA;EACA,MAAA;EACA,SAAA;EAxBe;EA0Bf,QAAA,GAAW,MAAA;AAAA"}

package/dist/attachments/utils.cjs

@@ -0,0 +1,134 @@
+
+//#region src/attachments/utils.ts
+const DEFAULT_MAX_SIZE = 20 * 1024 * 1024;
+/**
+* Derive the attachment modality from a MIME type string.
+*/
+function getModalityFromMimeType(mimeType) {
+	if (mimeType.startsWith("image/")) return "image";
+	if (mimeType.startsWith("audio/")) return "audio";
+	if (mimeType.startsWith("video/")) return "video";
+	return "document";
+}
+/**
+* Format a byte count as a human-readable file size string.
+*/
+function formatFileSize(bytes) {
+	if (bytes < 1024) return `${bytes} B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+	return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+* Check if a file exceeds the maximum allowed size.
+*/
+function exceedsMaxSize(file, maxSize = DEFAULT_MAX_SIZE) {
+	return file.size > maxSize;
+}
+/**
+* Read a File as a base64 string (without the data URL prefix).
+*/
+function readFileAsBase64(file) {
+	return new Promise((resolve, reject) => {
+		const reader = new FileReader();
+		reader.onload = (e) => {
+			const base64 = (e.target?.result)?.split(",")[1];
+			if (base64) resolve(base64);
+			else reject(/* @__PURE__ */ new Error("Failed to read file as base64"));
+		};
+		reader.onerror = reject;
+		reader.readAsDataURL(file);
+	});
+}
+/**
+* Generate a thumbnail data URL from a video file by capturing a frame near the start (at 0.1s).
+* Returns undefined if thumbnail generation fails or if called outside a browser environment.
+*/
+function generateVideoThumbnail(file) {
+	if (typeof document === "undefined") return Promise.resolve(void 0);
+	return new Promise((resolve) => {
+		let resolved = false;
+		const video = document.createElement("video");
+		const canvas = document.createElement("canvas");
+		const url = URL.createObjectURL(file);
+		const cleanup = (result) => {
+			if (resolved) return;
+			resolved = true;
+			URL.revokeObjectURL(url);
+			resolve(result);
+		};
+		const timeout = setTimeout(() => {
+			console.warn(`[CopilotKit] generateVideoThumbnail: timed out for file "${file.name}"`);
+			cleanup(void 0);
+		}, 1e4);
+		video.preload = "metadata";
+		video.muted = true;
+		video.playsInline = true;
+		video.onloadeddata = () => {
+			video.currentTime = .1;
+		};
+		video.onseeked = () => {
+			clearTimeout(timeout);
+			canvas.width = video.videoWidth;
+			canvas.height = video.videoHeight;
+			const ctx = canvas.getContext("2d");
+			if (ctx) {
+				ctx.drawImage(video, 0, 0);
+				cleanup(canvas.toDataURL("image/jpeg", .7));
+			} else {
+				console.warn("[CopilotKit] generateVideoThumbnail: could not get 2d canvas context");
+				cleanup(void 0);
+			}
+		};
+		video.onerror = () => {
+			clearTimeout(timeout);
+			console.warn(`[CopilotKit] generateVideoThumbnail: video element error for file "${file.name}"`);
+			cleanup(void 0);
+		};
+		video.src = url;
+	});
+}
+/**
+* Check if a file's MIME type matches an accept filter string.
+* Handles file extensions (e.g. ".pdf"), MIME wildcards ("image/*"), and comma-separated lists.
+*/
+function matchesAcceptFilter(file, accept) {
+	if (!accept || accept === "*/*") return true;
+	return accept.split(",").map((f) => f.trim()).some((filter) => {
+		if (filter.startsWith(".")) return (file.name ?? "").toLowerCase().endsWith(filter.toLowerCase());
+		if (filter.endsWith("/*")) {
+			const prefix = filter.slice(0, -2);
+			return file.type.startsWith(prefix + "/");
+		}
+		return file.type === filter;
+	});
+}
+/**
+* Convert an InputContentSource to a usable URL string.
+* For data sources, returns a base64 data URL; for URL sources, returns the URL directly.
+*/
+function getSourceUrl(source) {
+	if (source.type === "url") return source.value;
+	return `data:${source.mimeType};base64,${source.value}`;
+}
+/**
+* Return a short human-readable label for a document MIME type (e.g. "PDF", "DOC").
+*/
+function getDocumentIcon(mimeType) {
+	if (mimeType.includes("pdf")) return "PDF";
+	if (mimeType.includes("sheet") || mimeType.includes("excel")) return "XLS";
+	if (mimeType.includes("presentation") || mimeType.includes("powerpoint")) return "PPT";
+	if (mimeType.includes("word") || mimeType.includes("document")) return "DOC";
+	if (mimeType.includes("text/")) return "TXT";
+	return "FILE";
+}
+
+//#endregion
+exports.exceedsMaxSize = exceedsMaxSize;
+exports.formatFileSize = formatFileSize;
+exports.generateVideoThumbnail = generateVideoThumbnail;
+exports.getDocumentIcon = getDocumentIcon;
+exports.getModalityFromMimeType = getModalityFromMimeType;
+exports.getSourceUrl = getSourceUrl;
+exports.matchesAcceptFilter = matchesAcceptFilter;
+exports.readFileAsBase64 = readFileAsBase64;
+//# sourceMappingURL=utils.cjs.map

package/dist/attachments/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","names":[],"sources":["../../src/attachments/utils.ts"],"sourcesContent":["import type { AttachmentModality } from \"./types\";\nimport type { InputContentSource } from \"../types/message\";\n\nconst DEFAULT_MAX_SIZE = 20 * 1024 * 1024; // 20MB\n\n/**\n * Derive the attachment modality from a MIME type string.\n */\nexport function getModalityFromMimeType(mimeType: string): AttachmentModality {\n  if (mimeType.startsWith(\"image/\")) return \"image\";\n  if (mimeType.startsWith(\"audio/\")) return \"audio\";\n  if (mimeType.startsWith(\"video/\")) return \"video\";\n  return \"document\";\n}\n\n/**\n * Format a byte count as a human-readable file size string.\n */\nexport function formatFileSize(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n}\n\n/**\n * Check if a file exceeds the maximum allowed size.\n */\nexport function exceedsMaxSize(\n  file: File,\n  maxSize: number = DEFAULT_MAX_SIZE,\n): boolean {\n  return file.size > maxSize;\n}\n\n/**\n * Read a File as a base64 string (without the data URL prefix).\n */\nexport function readFileAsBase64(file: File): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const reader = new FileReader();\n    reader.onload = (e) => {\n      const result = e.target?.result as string;\n      const base64 = result?.split(\",\")[1];\n      if (base64) {\n        resolve(base64);\n      } else {\n        reject(new Error(\"Failed to read file as base64\"));\n      }\n    };\n    reader.onerror = reject;\n    reader.readAsDataURL(file);\n  });\n}\n\n/**\n * Generate a thumbnail data URL from a video file by capturing a frame near the start (at 0.1s).\n * Returns undefined if thumbnail generation fails or if called outside a browser environment.\n */\nexport function generateVideoThumbnail(\n  file: File,\n): Promise<string | undefined> {\n  if (typeof document === \"undefined\") {\n    return Promise.resolve(undefined);\n  }\n  return new Promise((resolve) => {\n    let resolved = false;\n    const video = document.createElement(\"video\");\n    const canvas = document.createElement(\"canvas\");\n    const url = URL.createObjectURL(file);\n\n    const cleanup = (result: string | undefined) => {\n      if (resolved) return;\n      resolved = true;\n      URL.revokeObjectURL(url);\n      resolve(result);\n    };\n\n    const timeout = setTimeout(() => {\n      console.warn(\n        `[CopilotKit] generateVideoThumbnail: timed out for file \"${file.name}\"`,\n      );\n      cleanup(undefined);\n    }, 10000);\n\n    video.preload = \"metadata\";\n    video.muted = true;\n    video.playsInline = true;\n\n    video.onloadeddata = () => {\n      video.currentTime = 0.1;\n    };\n\n    video.onseeked = () => {\n      clearTimeout(timeout);\n      canvas.width = video.videoWidth;\n      canvas.height = video.videoHeight;\n      const ctx = canvas.getContext(\"2d\");\n      if (ctx) {\n        ctx.drawImage(video, 0, 0);\n        const thumbnail = canvas.toDataURL(\"image/jpeg\", 0.7);\n        cleanup(thumbnail);\n      } else {\n        console.warn(\n          \"[CopilotKit] generateVideoThumbnail: could not get 2d canvas context\",\n        );\n        cleanup(undefined);\n      }\n    };\n\n    video.onerror = () => {\n      clearTimeout(timeout);\n      console.warn(\n        `[CopilotKit] generateVideoThumbnail: video element error for file \"${file.name}\"`,\n      );\n      cleanup(undefined);\n    };\n\n    video.src = url;\n  });\n}\n\n/**\n * Check if a file's MIME type matches an accept filter string.\n * Handles file extensions (e.g. \".pdf\"), MIME wildcards (\"image/*\"), and comma-separated lists.\n */\nexport function matchesAcceptFilter(file: File, accept: string): boolean {\n  if (!accept || accept === \"*/*\") return true;\n\n  const filters = accept.split(\",\").map((f) => f.trim());\n  return filters.some((filter) => {\n    if (filter.startsWith(\".\")) {\n      return (file.name ?? \"\").toLowerCase().endsWith(filter.toLowerCase());\n    }\n    if (filter.endsWith(\"/*\")) {\n      const prefix = filter.slice(0, -2);\n      return file.type.startsWith(prefix + \"/\");\n    }\n    return file.type === filter;\n  });\n}\n\n/**\n * Convert an InputContentSource to a usable URL string.\n * For data sources, returns a base64 data URL; for URL sources, returns the URL directly.\n */\nexport function getSourceUrl(source: InputContentSource): string {\n  if (source.type === \"url\") {\n    return source.value;\n  }\n  return `data:${source.mimeType};base64,${source.value}`;\n}\n\n/**\n * Return a short human-readable label for a document MIME type (e.g. \"PDF\", \"DOC\").\n */\nexport function getDocumentIcon(mimeType: string): string {\n  if (mimeType.includes(\"pdf\")) return \"PDF\";\n  if (mimeType.includes(\"sheet\") || mimeType.includes(\"excel\")) return \"XLS\";\n  if (mimeType.includes(\"presentation\") || mimeType.includes(\"powerpoint\"))\n    return \"PPT\";\n  if (mimeType.includes(\"word\") || mimeType.includes(\"document\")) return \"DOC\";\n  if (mimeType.includes(\"text/\")) return \"TXT\";\n  return \"FILE\";\n}\n"],"mappings":"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"}