@optiaxiom/proteus 0.2.4 → 0.2.6

package/dist/esm/_virtual/_openai-shim-script.js

@@ -75,7 +75,7 @@ Boolean requesting whether a visible border and background is provided by the ho
 - omitted: host decides border\`)}),cT=l.object({method:l.literal("ui/request-display-mode"),params:l.object({mode:so.describe("The display mode being requested.")})}),O_=l.object({mode:so.describe("The display mode that was actually set. May differ from requested if not supported.")}).passthrough(),D_=l.union([l.literal("model"),l.literal("app")]).describe("Tool visibility scope - who can access the tool."),uT=l.object({resourceUri:l.string().optional(),visibility:l.array(D_).optional().describe(\`Who can access this tool. Default: ["model", "app"]
 - "model": Tool visible to and callable by the agent
 - "app": Tool callable by the app from this server only\`)}),lT=l.object({mimeTypes:l.array(l.string()).optional().describe('Array of supported MIME types for UI resources.\\nMust include \`"text/html;profile=mcp-app"\` for MCP Apps support.')}),dT=l.object({method:l.literal("ui/download-file"),params:l.object({contents:l.array(l.union([Rl,Al])).describe("Resource contents to download \\u2014 embedded (inline data) or linked (host fetches). Uses standard MCP resource types.")})}),pT=l.object({method:l.literal("ui/message"),params:l.object({role:l.literal("user").describe('Message role, currently only "user" is supported.'),content:l.array(\$r).describe("Message content blocks (text, image, etc.).")})}),mT=l.object({method:l.literal("ui/notifications/sandbox-resource-ready"),params:l.object({html:l.string().describe("HTML content to load into the inner iframe."),sandbox:l.string().optional().describe("Optional override for the inner iframe's sandbox attribute."),csp:Wl.optional().describe("CSP configuration from resource metadata."),permissions:Kl.optional().describe("Sandbox permissions from resource metadata.")})}),N_=l.object({method:l.literal("ui/notifications/tool-result"),params:kr.describe("Standard MCP tool execution result.")}),bf=l.object({toolInfo:l.object({id:_r.optional().describe("JSON-RPC id of the tools/call request."),tool:ks.describe("Tool definition including name, inputSchema, etc.")}).optional().describe("Metadata of the tool call that instantiated this App."),theme:y_.optional().describe("Current color theme preference."),styles:T_.optional().describe("Style configuration for theming the app."),displayMode:so.optional().describe("How the UI is currently displayed."),availableDisplayModes:l.array(so).optional().describe("Display modes the host supports."),containerDimensions:l.union([l.object({height:l.number().describe("Fixed container height in pixels.")}),l.object({maxHeight:l.union([l.number(),l.undefined()]).optional().describe("Maximum container height in pixels.")})]).and(l.union([l.object({width:l.number().describe("Fixed container width in pixels.")}),l.object({maxWidth:l.union([l.number(),l.undefined()]).optional().describe("Maximum container width in pixels.")})])).optional().describe(\`Container dimensions. Represents the dimensions of the iframe or other
-container holding the app. Specify either width or maxWidth, and either height or maxHeight.\`),locale:l.string().optional().describe("User's language and region preference in BCP 47 format."),timeZone:l.string().optional().describe("User's timezone in IANA format."),userAgent:l.string().optional().describe("Host application identifier."),platform:l.union([l.literal("web"),l.literal("desktop"),l.literal("mobile")]).optional().describe("Platform type for responsive design decisions."),deviceCapabilities:l.object({touch:l.boolean().optional().describe("Whether the device supports touch input."),hover:l.boolean().optional().describe("Whether the device supports hover interactions.")}).optional().describe("Device input capabilities."),safeAreaInsets:l.object({top:l.number().describe("Top safe area inset in pixels."),right:l.number().describe("Right safe area inset in pixels."),bottom:l.number().describe("Bottom safe area inset in pixels."),left:l.number().describe("Left safe area inset in pixels.")}).optional().describe("Mobile safe area boundaries in pixels.")}).passthrough(),U_=l.object({method:l.literal("ui/notifications/host-context-changed"),params:bf.describe("Partial context update containing only changed fields.")}),fT=l.object({method:l.literal("ui/update-model-context"),params:l.object({content:l.array(\$r).optional().describe("Context content blocks (text, image, etc.)."),structuredContent:l.record(l.string(),l.unknown().describe("Structured content for machine-readable context data.")).optional().describe("Structured content for machine-readable context data.")})}),gT=l.object({method:l.literal("ui/initialize"),params:l.object({appInfo:qn.describe("App identification (name and version)."),appCapabilities:Z_.describe("Features and capabilities this app provides."),protocolVersion:l.string().describe("Protocol version this app supports.")})}),E_=l.object({protocolVersion:l.string().describe('Negotiated protocol version string (e.g., "2025-11-21").'),hostInfo:qn.describe("Host application identification and version."),hostCapabilities:j_.describe("Features and capabilities provided by the host."),hostContext:bf.describe("Rich context about the host environment.")}).passthrough();var Ps=class extends Bl{constructor(n,i={},t={autoResize:!0}){super(t);X(this,"_appInfo");X(this,"_capabilities");X(this,"options");X(this,"_hostCapabilities");X(this,"_hostInfo");X(this,"_hostContext");X(this,"eventSchemas",{toolinput:z_,toolinputpartial:S_,toolresult:N_,toolcancelled:w_,hostcontextchanged:U_});X(this,"_onteardown");X(this,"_oncalltool");X(this,"_onlisttools");X(this,"sendOpenLink",this.openLink);this._appInfo=n,this._capabilities=i,this.options=t,this.setRequestHandler(xr,o=>(console.log("Received ping:",o.params),{})),this.setEventHandler("hostcontextchanged",void 0)}onEventDispatch(n,i){n==="hostcontextchanged"&&(this._hostContext={...this._hostContext,...i})}getHostCapabilities(){return this._hostCapabilities}getHostVersion(){return this._hostInfo}getHostContext(){return this._hostContext}get ontoolinput(){return this.getEventHandler("toolinput")}set ontoolinput(n){this.setEventHandler("toolinput",n)}get ontoolinputpartial(){return this.getEventHandler("toolinputpartial")}set ontoolinputpartial(n){this.setEventHandler("toolinputpartial",n)}get ontoolresult(){return this.getEventHandler("toolresult")}set ontoolresult(n){this.setEventHandler("toolresult",n)}get ontoolcancelled(){return this.getEventHandler("toolcancelled")}set ontoolcancelled(n){this.setEventHandler("toolcancelled",n)}get onhostcontextchanged(){return this.getEventHandler("hostcontextchanged")}set onhostcontextchanged(n){this.setEventHandler("hostcontextchanged",n)}get onteardown(){return this._onteardown}set onteardown(n){this.warnIfRequestHandlerReplaced("onteardown",this._onteardown,n),this._onteardown=n,this.replaceRequestHandler(P_,(i,t)=>{if(!this._onteardown)throw Error("No onteardown handler set");return this._onteardown(i.params,t)})}get oncalltool(){return this._oncalltool}set oncalltool(n){this.warnIfRequestHandlerReplaced("oncalltool",this._oncalltool,n),this._oncalltool=n,this.replaceRequestHandler(Ml,(i,t)=>{if(!this._oncalltool)throw Error("No oncalltool handler set");return this._oncalltool(i.params,t)})}get onlisttools(){return this._onlisttools}set onlisttools(n){this.warnIfRequestHandlerReplaced("onlisttools",this._onlisttools,n),this._onlisttools=n,this.replaceRequestHandler(Cl,(i,t)=>{if(!this._onlisttools)throw Error("No onlisttools handler set");return this._onlisttools(i.params,t)})}assertCapabilityForMethod(n){}assertRequestHandlerCapability(n){switch(n){case"tools/call":case"tools/list":if(!this._capabilities.tools)throw Error(\`Client does not support tool capability (required for \${n})\`);return;case"ping":case"ui/resource-teardown":return;default:throw Error(\`No handler for method \${n} registered\`)}}assertNotificationCapability(n){}assertTaskCapability(n){throw Error("Tasks are not supported in MCP Apps")}assertTaskHandlerCapability(n){throw Error("Task handlers are not supported in MCP Apps")}async callServerTool(n,i){if(typeof n=="string")throw Error(\`callServerTool() expects an object as its first argument, but received a string ("\${n}"). Did you mean: callServerTool({ name: "\${n}", arguments: { ... } })?\`);return await this.request({method:"tools/call",params:n},kr,i)}async readServerResource(n,i){return await this.request({method:"resources/read",params:n},Dl,i)}async listServerResources(n,i){return await this.request({method:"resources/list",params:n},Zl,i)}sendMessage(n,i){return this.request({method:"ui/message",params:n},k_,i)}sendLog(n){return this.notification({method:"notifications/message",params:n})}updateModelContext(n,i){return this.request({method:"ui/update-model-context",params:n},ms,i)}openLink(n,i){return this.request({method:"ui/open-link",params:n},b_,i)}downloadFile(n,i){return this.request({method:"ui/download-file",params:n},\$_,i)}requestTeardown(n={}){return this.notification({method:"ui/notifications/request-teardown",params:n})}requestDisplayMode(n,i){return this.request({method:"ui/request-display-mode",params:n},O_,i)}sendSizeChanged(n){return this.notification({method:"ui/notifications/size-changed",params:n})}setupSizeChangedNotifications(){let n=!1,i=0,t=0,o=()=>{n||(n=!0,requestAnimationFrame(()=>{n=!1;let s=document.documentElement,u=s.style.height;s.style.height="max-content";let c=Math.ceil(s.getBoundingClientRect().height);s.style.height=u;let d=Math.ceil(window.innerWidth);(d!==i||c!==t)&&(i=d,t=c,this.sendSizeChanged({width:d,height:c}))}))};o();let a=new ResizeObserver(o);return a.observe(document.documentElement),a.observe(document.body),()=>a.disconnect()}async connect(n=new ao(window.parent,window.parent),i){if(this.transport)throw Error("App is already connected. Call close() before connecting again.");await super.connect(n);try{let t=await this.request({method:"ui/initialize",params:{appCapabilities:this._capabilities,appInfo:this._appInfo,protocolVersion:h_}},E_,i);if(t===void 0)throw Error(\`Server sent invalid initialize result: \${t}\`);this._hostCapabilities=t.hostCapabilities,this._hostInfo=t.hostInfo,this._hostContext=t.hostContext,await this.notification({method:"ui/notifications/initialized"}),this.options?.autoResize&&this.setupSizeChangedNotifications()}catch(t){throw this.close(),t}}};var Lt=new Ps({name:"Opal Widget",version:"1.0.0"},{}),Gl={},Xl=null,xt={};function Ql(){window.dispatchEvent(new CustomEvent("openai:set_globals",{detail:{globals:{displayMode:xt.displayMode,locale:xt.locale,maxHeight:xt.containerDimensions?.maxHeight,toolInput:Gl,toolOutput:Xl}}}))}Lt.ontoolinput=e=>{Gl=e.arguments??{},Ql()};Lt.ontoolresult=e=>{Xl=e.content,Ql()};Lt.onhostcontextchanged=e=>{xt={...xt,...e},Ql()};window.openai={get displayMode(){return xt.displayMode},get locale(){return xt.locale},get maxHeight(){return xt.containerDimensions?.maxHeight},get toolInput(){return Gl},get toolOutput(){return Xl},callTool:(e,r)=>Lt.callServerTool({arguments:r,name:e}),openExternal:e=>Lt.openLink({url:e.href}),sendFollowUpMessage:e=>Lt.sendMessage({content:[{text:e.prompt,type:"text"}],role:"user"})};var R_=new ao(window.parent,window.parent);Lt.connect(R_);})();
+container holding the app. Specify either width or maxWidth, and either height or maxHeight.\`),locale:l.string().optional().describe("User's language and region preference in BCP 47 format."),timeZone:l.string().optional().describe("User's timezone in IANA format."),userAgent:l.string().optional().describe("Host application identifier."),platform:l.union([l.literal("web"),l.literal("desktop"),l.literal("mobile")]).optional().describe("Platform type for responsive design decisions."),deviceCapabilities:l.object({touch:l.boolean().optional().describe("Whether the device supports touch input."),hover:l.boolean().optional().describe("Whether the device supports hover interactions.")}).optional().describe("Device input capabilities."),safeAreaInsets:l.object({top:l.number().describe("Top safe area inset in pixels."),right:l.number().describe("Right safe area inset in pixels."),bottom:l.number().describe("Bottom safe area inset in pixels."),left:l.number().describe("Left safe area inset in pixels.")}).optional().describe("Mobile safe area boundaries in pixels.")}).passthrough(),U_=l.object({method:l.literal("ui/notifications/host-context-changed"),params:bf.describe("Partial context update containing only changed fields.")}),fT=l.object({method:l.literal("ui/update-model-context"),params:l.object({content:l.array(\$r).optional().describe("Context content blocks (text, image, etc.)."),structuredContent:l.record(l.string(),l.unknown().describe("Structured content for machine-readable context data.")).optional().describe("Structured content for machine-readable context data.")})}),gT=l.object({method:l.literal("ui/initialize"),params:l.object({appInfo:qn.describe("App identification (name and version)."),appCapabilities:Z_.describe("Features and capabilities this app provides."),protocolVersion:l.string().describe("Protocol version this app supports.")})}),E_=l.object({protocolVersion:l.string().describe('Negotiated protocol version string (e.g., "2025-11-21").'),hostInfo:qn.describe("Host application identification and version."),hostCapabilities:j_.describe("Features and capabilities provided by the host."),hostContext:bf.describe("Rich context about the host environment.")}).passthrough();var Ps=class extends Bl{constructor(n,i={},t={autoResize:!0}){super(t);X(this,"_appInfo");X(this,"_capabilities");X(this,"options");X(this,"_hostCapabilities");X(this,"_hostInfo");X(this,"_hostContext");X(this,"eventSchemas",{toolinput:z_,toolinputpartial:S_,toolresult:N_,toolcancelled:w_,hostcontextchanged:U_});X(this,"_onteardown");X(this,"_oncalltool");X(this,"_onlisttools");X(this,"sendOpenLink",this.openLink);this._appInfo=n,this._capabilities=i,this.options=t,this.setRequestHandler(xr,o=>(console.log("Received ping:",o.params),{})),this.setEventHandler("hostcontextchanged",void 0)}onEventDispatch(n,i){n==="hostcontextchanged"&&(this._hostContext={...this._hostContext,...i})}getHostCapabilities(){return this._hostCapabilities}getHostVersion(){return this._hostInfo}getHostContext(){return this._hostContext}get ontoolinput(){return this.getEventHandler("toolinput")}set ontoolinput(n){this.setEventHandler("toolinput",n)}get ontoolinputpartial(){return this.getEventHandler("toolinputpartial")}set ontoolinputpartial(n){this.setEventHandler("toolinputpartial",n)}get ontoolresult(){return this.getEventHandler("toolresult")}set ontoolresult(n){this.setEventHandler("toolresult",n)}get ontoolcancelled(){return this.getEventHandler("toolcancelled")}set ontoolcancelled(n){this.setEventHandler("toolcancelled",n)}get onhostcontextchanged(){return this.getEventHandler("hostcontextchanged")}set onhostcontextchanged(n){this.setEventHandler("hostcontextchanged",n)}get onteardown(){return this._onteardown}set onteardown(n){this.warnIfRequestHandlerReplaced("onteardown",this._onteardown,n),this._onteardown=n,this.replaceRequestHandler(P_,(i,t)=>{if(!this._onteardown)throw Error("No onteardown handler set");return this._onteardown(i.params,t)})}get oncalltool(){return this._oncalltool}set oncalltool(n){this.warnIfRequestHandlerReplaced("oncalltool",this._oncalltool,n),this._oncalltool=n,this.replaceRequestHandler(Ml,(i,t)=>{if(!this._oncalltool)throw Error("No oncalltool handler set");return this._oncalltool(i.params,t)})}get onlisttools(){return this._onlisttools}set onlisttools(n){this.warnIfRequestHandlerReplaced("onlisttools",this._onlisttools,n),this._onlisttools=n,this.replaceRequestHandler(Cl,(i,t)=>{if(!this._onlisttools)throw Error("No onlisttools handler set");return this._onlisttools(i.params,t)})}assertCapabilityForMethod(n){}assertRequestHandlerCapability(n){switch(n){case"tools/call":case"tools/list":if(!this._capabilities.tools)throw Error(\`Client does not support tool capability (required for \${n})\`);return;case"ping":case"ui/resource-teardown":return;default:throw Error(\`No handler for method \${n} registered\`)}}assertNotificationCapability(n){}assertTaskCapability(n){throw Error("Tasks are not supported in MCP Apps")}assertTaskHandlerCapability(n){throw Error("Task handlers are not supported in MCP Apps")}async callServerTool(n,i){if(typeof n=="string")throw Error(\`callServerTool() expects an object as its first argument, but received a string ("\${n}"). Did you mean: callServerTool({ name: "\${n}", arguments: { ... } })?\`);return await this.request({method:"tools/call",params:n},kr,i)}async readServerResource(n,i){return await this.request({method:"resources/read",params:n},Dl,i)}async listServerResources(n,i){return await this.request({method:"resources/list",params:n},Zl,i)}sendMessage(n,i){return this.request({method:"ui/message",params:n},k_,i)}sendLog(n){return this.notification({method:"notifications/message",params:n})}updateModelContext(n,i){return this.request({method:"ui/update-model-context",params:n},ms,i)}openLink(n,i){return this.request({method:"ui/open-link",params:n},b_,i)}downloadFile(n,i){return this.request({method:"ui/download-file",params:n},\$_,i)}requestTeardown(n={}){return this.notification({method:"ui/notifications/request-teardown",params:n})}requestDisplayMode(n,i){return this.request({method:"ui/request-display-mode",params:n},O_,i)}sendSizeChanged(n){return this.notification({method:"ui/notifications/size-changed",params:n})}setupSizeChangedNotifications(){let n=!1,i=0,t=0,o=()=>{n||(n=!0,requestAnimationFrame(()=>{n=!1;let s=document.documentElement,u=s.style.height;s.style.height="max-content";let c=Math.ceil(s.getBoundingClientRect().height);s.style.height=u;let d=Math.ceil(window.innerWidth);(d!==i||c!==t)&&(i=d,t=c,this.sendSizeChanged({width:d,height:c}))}))};o();let a=new ResizeObserver(o);return a.observe(document.documentElement),a.observe(document.body),()=>a.disconnect()}async connect(n=new ao(window.parent,window.parent),i){if(this.transport)throw Error("App is already connected. Call close() before connecting again.");await super.connect(n);try{let t=await this.request({method:"ui/initialize",params:{appCapabilities:this._capabilities,appInfo:this._appInfo,protocolVersion:h_}},E_,i);if(t===void 0)throw Error(\`Server sent invalid initialize result: \${t}\`);this._hostCapabilities=t.hostCapabilities,this._hostInfo=t.hostInfo,this._hostContext=t.hostContext,await this.notification({method:"ui/notifications/initialized"}),this.options?.autoResize&&this.setupSizeChangedNotifications()}catch(t){throw this.close(),t}}};var Lt=new Ps({name:"Opal Widget",version:"1.0.0"},{}),Gl={},Xl=null,xt={};function Ql(){window.dispatchEvent(new CustomEvent("openai:set_globals",{detail:{globals:{displayMode:xt.displayMode,locale:xt.locale,maxHeight:xt.containerDimensions?.maxHeight,toolInput:Gl,toolOutput:Xl}}}))}Lt.ontoolinput=e=>{Gl=e.arguments??{},Ql()};Lt.ontoolresult=e=>{Xl=e.content,Ql()};Lt.onhostcontextchanged=e=>{xt={...xt,...e},Ql()};window.openai={get displayMode(){return xt.displayMode},get locale(){return xt.locale},get maxHeight(){return xt.containerDimensions?.maxHeight},get toolInput(){return Gl},get toolOutput(){return Xl},callTool:async(e,r)=>({result:await Lt.callServerTool({arguments:r,name:e})}),openExternal:e=>Lt.openLink({url:e.href}),sendFollowUpMessage:e=>Lt.sendMessage({content:[{text:e.prompt,type:"text"}],role:"user"})};var R_=new ao(window.parent,window.parent);Lt.connect(R_);})();
 </script>`;
 
 export { OPENAI_SHIM_SCRIPT };

package/dist/esm/assets/src/proteus-chart/{ProteusChart.css.ts.vanilla-BMEbDhgW.css → ProteusChart.css.ts.vanilla-UlV5bM-e.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom.txqk6n;
-@layer optiaxiom.txqk6n {
+@layer optiaxiom._10u9e24;
+@layer optiaxiom._10u9e24 {
   .ProteusChart__jmlqij1 {
     border-radius: 16px;
   }

package/dist/esm/assets/src/proteus-chart/{ProteusChartTooltipContent.css.ts.vanilla-DeE905en.css → ProteusChartTooltipContent.css.ts.vanilla-DFvGuq6I.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom.txqk6n;
-@layer optiaxiom.txqk6n {
+@layer optiaxiom._10u9e24;
+@layer optiaxiom._10u9e24 {
   .ProteusChartTooltipContent__1gsvq810 {
     min-width: 128px;
     position: absolute;

package/dist/esm/assets/src/proteus-document/{ProteusDocumentShell.css.ts.vanilla-JoQXI97u.css → ProteusDocumentShell.css.ts.vanilla-C3__yEhR.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom.txqk6n;
-@layer optiaxiom.txqk6n {
+@layer optiaxiom._10u9e24;
+@layer optiaxiom._10u9e24 {
   .ProteusDocumentShell__vpuvfj1 {
     margin: -4px;
   }

package/dist/esm/assets/src/proteus-image-carousel/{ProteusImageCarousel.css.ts.vanilla-D8aYxZmX.css → ProteusImageCarousel.css.ts.vanilla-bCVJ5JAJ.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom.txqk6n;
-@layer optiaxiom.txqk6n {
+@layer optiaxiom._10u9e24;
+@layer optiaxiom._10u9e24 {
   .ProteusImageCarousel__1t6qej70 {
     outline: none;
     user-select: none;

package/dist/esm/assets/src/proteus-question/{ProteusQuestion.css.ts.vanilla-CyslVupM.css → ProteusQuestion.css.ts.vanilla-usVGixHc.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom.txqk6n;
-@layer optiaxiom.txqk6n {
+@layer optiaxiom._10u9e24;
+@layer optiaxiom._10u9e24 {
   .ProteusQuestion__8f590p0 {
     outline: none;
   }

package/dist/esm/index.js

@@ -5,6 +5,7 @@ export { ProteusDataTable } from './proteus-data-table/ProteusDataTable.js';
 export { ProteusDocumentRenderer } from './proteus-document/ProteusDocumentRenderer.js';
 export { ProteusDocumentShell } from './proteus-document/ProteusDocumentShell.js';
 export { safeParseDocument } from './proteus-document/schemas.js';
+export { ProteusFileUpload } from './proteus-file-upload/ProteusFileUpload.js';
 export { ProteusImage } from './proteus-image/ProteusImage.js';
 export { ProteusImageCarousel } from './proteus-image-carousel/ProteusImageCarousel.js';
 export { ProteusInput } from './proteus-input/ProteusInput.js';

package/dist/esm/proteus-bridge/ProteusBridge.js

@@ -79,7 +79,7 @@ function ProteusBridge({ height = 400, resource }) {
     {
       ref: setIframe,
       sandbox: "allow-scripts allow-popups allow-popups-to-escape-sandbox allow-forms",
-      srcDoc: mimeType === "text/html;profile=openai-app" ? OPENAI_SHIM_SCRIPT + html : html,
+      srcDoc: mimeType === "text/html+skybridge" ? OPENAI_SHIM_SCRIPT + html : html,
       style: { border: "none", height, width: "100%" },
       title: "Opal Widget"
     }

package/dist/esm/proteus-chart/ProteusChart-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-chart/ProteusChart.css.ts.vanilla-BMEbDhgW.css';
+import './../assets/src/proteus-chart/ProteusChart.css.ts.vanilla-UlV5bM-e.css';
 import { recipe } from '@optiaxiom/react/css-runtime';
 
 var chart = recipe({base:[{border:'1',borderColor:'border.tertiary',fontSize:'sm',p:'16'},'ProteusChart__jmlqij1','ProteusChart__jmlqij0']});

package/dist/esm/proteus-chart/ProteusChart.js

@@ -69,7 +69,7 @@ const ProteusChart = ({
         portal: document.body
       }
     ),
-    series.map((s, i) => /* @__PURE__ */ jsx(
+    series?.map((s, i) => /* @__PURE__ */ jsx(
       Chart,
       {
         dataKey: (row) => get(row, "/" + s.dataKey),

package/dist/esm/proteus-chart/ProteusChartTooltipContent-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-chart/ProteusChartTooltipContent.css.ts.vanilla-DeE905en.css';
+import './../assets/src/proteus-chart/ProteusChartTooltipContent.css.ts.vanilla-DFvGuq6I.css';
 import { recipe } from '@optiaxiom/react/css-runtime';
 
 var tooltip = recipe({base:[{bg:'bg.default',border:'1',borderColor:'border.secondary',display:'grid',fontSize:'sm',gap:'6',pointerEvents:'none',px:'8',py:'10',rounded:'lg',shadow:'lg',transition:'all',z:'popover'},'ProteusChartTooltipContent__1gsvq810']});

package/dist/esm/proteus-data-table/ProteusDataTable.js

@@ -8,7 +8,7 @@ import { applyFormatter } from '../proteus-document/getProteusValue.js';
 const ProteusDataTable = ({ columns, data }) => {
   const tableData = data;
   const columnHelper = createColumnHelper();
-  const columnDefs = columns.map((col) => {
+  const columnDefs = (columns || []).map((col) => {
     return columnHelper.accessor(
       (row) => {
         const value = get(row, "/" + col.accessorKey);

package/dist/esm/proteus-document/ProteusDocumentShell-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-document/ProteusDocumentShell.css.ts.vanilla-JoQXI97u.css';
+import './../assets/src/proteus-document/ProteusDocumentShell.css.ts.vanilla-C3__yEhR.css';
 import { recipe } from '@optiaxiom/react/css-runtime';
 
 var body = recipe({base:[{flexDirection:'column',gap:'16'},'ProteusDocumentShell__vpuvfj0'],variants:{truncate:{false:{},true:[{maxH:'sm',overflow:'auto',p:'4'},'ProteusDocumentShell__vpuvfj1']}}});

package/dist/esm/proteus-document/ProteusDocumentShell.js

@@ -21,6 +21,7 @@ function ProteusDocumentShell({
   onMessage,
   onOpenChange,
   onTrack,
+  onUpload,
   open: openProp,
   readOnly = false,
   strict,
@@ -101,6 +102,7 @@ function ProteusDocumentShell({
           onTrack?.(event, properties);
         }
       ),
+      onUpload,
       readOnly,
       strict,
       useResource,

package/dist/esm/proteus-document/resolveProteusValue.js

@@ -88,11 +88,13 @@ function resolveProteusValue(value, data, parentPath, mapIndices = []) {
       }
       const resolvedPath = value.path.startsWith("/") ? value.path : `${parentPath}/${value.path}`;
       const items = array.map(
-        (_, index) => resolveProteusValue(value.children, data, `${resolvedPath}/${index}`, [
-          ...mapIndices,
-          index
-        ])
-      );
+        (_, index) => resolveProteusValue(
+          value.children,
+          data,
+          `${resolvedPath}/${index}`,
+          [...mapIndices, index]
+        )
+      ).filter((v) => v !== void 0);
       if ("separator" in value) {
         const sep = resolveProteusValue(
           value.separator,
@@ -122,8 +124,18 @@ function resolveProteusValue(value, data, parentPath, mapIndices = []) {
         (child) => resolveProteusValue(child, data, parentPath, mapIndices)
       ).filter((v) => v !== void 0).join("");
     }
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((v) => resolveProteusValue(v, data, parentPath, mapIndices)).filter((v) => v !== void 0);
+  }
+  const resolved = {};
+  for (const [k, v] of Object.entries(value)) {
+    const r = resolveProteusValue(v, data, parentPath, mapIndices);
+    if (r !== void 0)
+      resolved[k] = r;
   }
-  return value;
+  return resolved;
 }
 
 export { evaluateCondition, resolveProteusValue };

package/dist/esm/proteus-element/ProteusElement.js

@@ -11,6 +11,7 @@ import { useProteusDocumentContext } from '../proteus-document/ProteusDocumentCo
 import { useProteusDocumentPathContext } from '../proteus-document/ProteusDocumentPathContext.js';
 import { resolveProteusProp } from '../proteus-document/resolveProteusProp.js';
 import { safeParseElement } from '../proteus-document/schemas.js';
+import { ProteusFileUpload } from '../proteus-file-upload/ProteusFileUpload.js';
 import { ProteusImageCarousel } from '../proteus-image-carousel/ProteusImageCarousel.js';
 import { ProteusImage } from '../proteus-image/ProteusImage.js';
 import { ProteusInput } from '../proteus-input/ProteusInput.js';
@@ -97,6 +98,8 @@ const ProteusElement = ({
       );
     case "Field":
       return /* @__PURE__ */ jsx(Field, { ...resolve(element) });
+    case "FileUpload":
+      return /* @__PURE__ */ jsx(ProteusFileUpload, { ...resolve(element) });
     case "Group":
       return /* @__PURE__ */ jsx(Group, { ...resolve(element) });
     case "Heading":

package/dist/esm/proteus-file-upload/ProteusFileUpload.js

@@ -0,0 +1,66 @@
+"use client";
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { Flex } from '@optiaxiom/react';
+import { FileUpload, FileUploadList, FileUploadDropzone, FileUploadTrigger } from '@optiaxiom/react/unstable';
+import { useState, useCallback } from 'react';
+import { useProteusDocumentContext } from '../proteus-document/ProteusDocumentContext.js';
+import { useProteusDocumentPathContext } from '../proteus-document/ProteusDocumentPathContext.js';
+
+function ProteusFileUpload({ accept, name }) {
+  const { onDataChange, onUpload, readOnly } = useProteusDocumentContext(
+    "@optiaxiom/proteus/ProteusFileUpload"
+  );
+  const { path: parentPath } = useProteusDocumentPathContext(
+    "@optiaxiom/proteus/ProteusFileUpload"
+  );
+  const [item, setItem] = useState(null);
+  const writeUrl = useCallback(
+    (url) => {
+      if (!name)
+        return;
+      onDataChange?.(`${parentPath}/${name}`, url);
+    },
+    [name, onDataChange, parentPath]
+  );
+  const handleFilesDrop = useCallback(
+    async (incoming) => {
+      if (!onUpload || readOnly || incoming.length === 0) {
+        return;
+      }
+      const file = incoming[0];
+      setItem({ file, status: "uploading" });
+      writeUrl(null);
+      try {
+        const url = await onUpload(file);
+        setItem(
+          (curr) => curr?.file === file ? { file, status: "complete" } : curr
+        );
+        writeUrl(url);
+      } catch {
+        setItem(
+          (curr) => curr?.file === file ? { file, status: "error" } : curr
+        );
+      }
+    },
+    [onUpload, readOnly, writeUrl]
+  );
+  const handleRemove = useCallback(() => {
+    setItem(null);
+    writeUrl(null);
+  }, [writeUrl]);
+  return /* @__PURE__ */ jsx(
+    FileUpload,
+    {
+      accept,
+      disabled: !onUpload || readOnly,
+      onFilesDrop: handleFilesDrop,
+      children: item ? /* @__PURE__ */ jsxs(Flex, { flexDirection: "column", gap: "8", children: [
+        /* @__PURE__ */ jsx(FileUploadList, { items: [item], onRemove: handleRemove }),
+        /* @__PURE__ */ jsx(FileUploadDropzone, { overlay: true })
+      ] }) : /* @__PURE__ */ jsx(FileUploadDropzone, { children: /* @__PURE__ */ jsx(FileUploadTrigger, {}) })
+    }
+  );
+}
+ProteusFileUpload.displayName = "@optiaxiom/proteus/ProteusFileUpload";
+
+export { ProteusFileUpload };

package/dist/esm/proteus-image-carousel/ProteusImageCarousel-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-image-carousel/ProteusImageCarousel.css.ts.vanilla-D8aYxZmX.css';
+import './../assets/src/proteus-image-carousel/ProteusImageCarousel.css.ts.vanilla-bCVJ5JAJ.css';
 import { recipe } from '@optiaxiom/react/css-runtime';
 
 var carousel = recipe({base:[{flexDirection:'column',gap:'12'},'ProteusImageCarousel__1t6qej70']});

package/dist/esm/proteus-image-carousel/ProteusImageCarousel.js

@@ -16,7 +16,10 @@ function ProteusImageCarousel({
   const { onEvent } = useProteusDocumentContext(
     "@optiaxiom/proteus/ProteusImageCarousel"
   );
-  const [emblaMainRef, emblaMainApi] = useEmblaCarousel({ loop: false });
+  const [emblaMainRef, emblaMainApi] = useEmblaCarousel({
+    loop: false,
+    watchDrag: false
+  });
   const [emblaThumbsRef, emblaThumbsApi] = useEmblaCarousel({
     containScroll: "keepSnaps",
     dragFree: true

package/dist/esm/proteus-question/ProteusQuestion-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-question/ProteusQuestion.css.ts.vanilla-CyslVupM.css';
+import './../assets/src/proteus-question/ProteusQuestion.css.ts.vanilla-usVGixHc.css';
 import { recipe } from '@optiaxiom/react/css-runtime';
 
 var addon = recipe({base:[{display:'grid',fontWeight:'500',placeItems:'center',rounded:'lg',size:'md',transition:'colors'},'ProteusQuestion__8f590p3'],variants:{cursor:{pointer:{cursor:'pointer'}}}});

package/dist/esm/schema/public-schema.json.js

@@ -2734,6 +2734,9 @@ var definitions = {
 			{
 				$ref: "#/definitions/ProteusField"
 			},
+			{
+				$ref: "#/definitions/ProteusFileUpload"
+			},
 			{
 				$ref: "#/definitions/ProteusGroup"
 			},
@@ -2833,9 +2836,12 @@ var definitions = {
 							},
 							{
 								type: "string"
+							},
+							{
+								$ref: "#/definitions/ProteusStructuredMessage"
 							}
 						],
-						description: "Message to send to LLM via sendNewMessage(). Can be a string, a Value reference, or a Map expression."
+						description: "Message to send to LLM via sendNewMessage(). Can be a string, a Value reference, a Map expression, or a structured payload with parts and files."
 					}
 				},
 				required: [
@@ -2932,6 +2938,56 @@ var definitions = {
 		],
 		description: "A Proteus node can be a string, number, boolean, null, a single element, or an array of these types (similar to ReactNode)"
 	},
+	ProteusStructuredMessage: {
+		additionalProperties: false,
+		description: "Structured message payload that lets file URLs travel as a typed list alongside the text parts, instead of being joined into the text.",
+		properties: {
+			files: {
+				anyOf: [
+					{
+						items: {
+							type: "string"
+						},
+						type: "array"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "List of file URLs (typically signed URLs from a host upload)."
+			},
+			parts: {
+				items: {
+					additionalProperties: false,
+					properties: {
+						content: {
+							anyOf: [
+								{
+									type: "string"
+								},
+								{
+									$ref: "#/definitions/ProteusExpression"
+								}
+							]
+						},
+						type: {
+							"const": "text"
+						}
+					},
+					required: [
+						"type",
+						"content"
+					],
+					type: "object"
+				},
+				type: "array"
+			}
+		},
+		required: [
+			"parts"
+		],
+		type: "object"
+	},
 	ProteusZip: {
 		additionalProperties: false,
 		description: "Zips multiple parallel arrays into an array of objects. Each key in 'sources' becomes a property in the resulting row objects.",
@@ -4689,25 +4745,32 @@ var definitions = {
 				description: "Chart layout direction"
 			},
 			series: {
-				description: "Data series configuration",
-				items: {
-					additionalProperties: false,
-					properties: {
-						dataKey: {
-							description: "Key in data records for this series",
-							type: "string"
+				anyOf: [
+					{
+						description: "Data series configuration",
+						items: {
+							additionalProperties: false,
+							properties: {
+								dataKey: {
+									description: "Key in data records for this series",
+									type: "string"
+								},
+								name: {
+									description: "Display name for legend",
+									type: "string"
+								}
+							},
+							required: [
+								"dataKey"
+							],
+							type: "object"
 						},
-						name: {
-							description: "Display name for legend",
-							type: "string"
-						}
+						type: "array"
 					},
-					required: [
-						"dataKey"
-					],
-					type: "object"
-				},
-				type: "array"
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				]
 			},
 			type: {
 				anyOf: [
@@ -5080,6 +5143,53 @@ var definitions = {
 		],
 		type: "object"
 	},
+	ProteusFileUpload: {
+		additionalProperties: false,
+		examples: [
+			{
+				$type: "FileUpload",
+				name: "value"
+			}
+		],
+		properties: {
+			$type: {
+				"const": "FileUpload"
+			},
+			accept: {
+				description: "File types to accept; array of MIME types or extensions.",
+				items: {
+					type: "string"
+				},
+				type: "array"
+			},
+			name: {
+				anyOf: [
+					{
+						type: "string"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "The name of the form control element. The resolved URL is written at parentPath/name in form data."
+			},
+			required: {
+				anyOf: [
+					{
+						type: "boolean"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "Whether a file is required."
+			}
+		},
+		required: [
+			"$type"
+		],
+		type: "object"
+	},
 	ProteusGroup: {
 		additionalProperties: false,
 		examples: [