melony 0.1.50 → 0.1.53

package/dist/{chunk-IK3OHUHO.js → chunk-W35Y2YZP.js}

@@ -1,6 +1,6 @@
 import { generateId } from './chunk-WAI5H335.js';
 
-// src/types.ts
+// src/ui.ts
 var ui = {
   card: (props) => {
     const { children, ...rest } = props;
@@ -30,17 +30,17 @@ var ui = {
     type: "text",
     props: { ...props, value }
   }),
-  heading: (value, level = 1) => ({
+  heading: (value, level = 1, props) => ({
     type: "heading",
-    props: { value, level }
+    props: { ...props, value, level }
   }),
   badge: (label, variant = "primary", size = "md") => ({
     type: "badge",
     props: { label, variant, size }
   }),
-  image: (src, alt, size = "md", groupId) => ({
+  image: (src, props) => ({
     type: "image",
-    props: { src, alt, size, groupId }
+    props: { ...props, src }
   }),
   video: (src, props) => ({
     type: "video",
@@ -54,10 +54,10 @@ var ui = {
     type: "chart",
     props
   }),
-  list: (children) => ({
-    type: "list",
-    children
-  }),
+  list: (props) => {
+    const { children, ...rest } = props;
+    return { type: "list", props: rest, children };
+  },
   listItem: (props) => {
     const { children, ...rest } = props;
     return { type: "listItem", props: rest, children };
@@ -106,6 +106,14 @@ var ui = {
     type: "button",
     props
   }),
+  float: (props) => {
+    const { children, ...rest } = props;
+    return { type: "float", props: rest, children };
+  },
+  dropdown: (props) => {
+    const { children, ...rest } = props;
+    return { type: "dropdown", props: rest, children };
+  },
   actions: {
     navigate: (url) => ({
       type: "client:navigate",
@@ -376,5 +384,5 @@ var action = (config) => config;
 var plugin = (config) => config;
 
 export { Runtime, action, melony, plugin, ui };
-//# sourceMappingURL=chunk-IK3OHUHO.js.map
-//# sourceMappingURL=chunk-IK3OHUHO.js.map
+//# sourceMappingURL=chunk-W35Y2YZP.js.map
+//# sourceMappingURL=chunk-W35Y2YZP.js.map

package/dist/chunk-W35Y2YZP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ui.ts","../src/runtime.ts"],"names":["event","plugin","action"],"mappings":"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","file":"chunk-W35Y2YZP.js","sourcesContent":["import { UIColor, UIContract, UINode, UISize, Event, UISpacing, UIWidth, UIRadius } from \"./types\";\n\n/**\n * UI Builder for SDUI.\n * Typed using the UIContract source of truth.\n */\nexport const ui = {\n  card: (\n    props: UIContract[\"card\"] & { children?: UINode<any>[] }\n  ): UINode<\"card\"> => {\n    const { children, ...rest } = props;\n    return { type: \"card\", props: rest, children };\n  },\n  row: (\n    props: UIContract[\"row\"] & { children?: UINode<any>[] }\n  ): UINode<\"row\"> => {\n    const { children, ...rest } = props;\n    return { type: \"row\", props: rest, children };\n  },\n  col: (\n    props: UIContract[\"col\"] & { children?: UINode<any>[] }\n  ): UINode<\"col\"> => {\n    const { children, ...rest } = props;\n    return { type: \"col\", props: rest, children };\n  },\n  box: (\n    props: UIContract[\"box\"] & { children?: UINode<any>[] }\n  ): UINode<\"box\"> => {\n    const { children, ...rest } = props;\n    return { type: \"box\", props: rest, children };\n  },\n  spacer: (props: UIContract[\"spacer\"]): UINode<\"spacer\"> => ({\n    type: \"spacer\",\n    props,\n  }),\n  divider: (props: UIContract[\"divider\"]): UINode<\"divider\"> => ({\n    type: \"divider\",\n    props,\n  }),\n  text: (\n    value: string,\n    props?: Omit<UIContract[\"text\"], \"value\">\n  ): UINode<\"text\"> => ({\n    type: \"text\",\n    props: { ...props, value },\n  }),\n  heading: (\n    value: string,\n    level: UIContract[\"heading\"][\"level\"] = 1,\n    props?: Omit<UIContract[\"heading\"], \"value\" | \"level\">\n  ): UINode<\"heading\"> => ({\n    type: \"heading\",\n    props: { ...props, value, level },\n  }),\n  badge: (\n    label: string,\n    variant: UIContract[\"badge\"][\"variant\"] = \"primary\",\n    size: UISize = \"md\"\n  ): UINode<\"badge\"> => ({\n    type: \"badge\",\n    props: { label, variant, size },\n  }),\n  image: (\n    src: string,\n    props?: Omit<UIContract[\"image\"], \"src\">\n  ): UINode<\"image\"> => ({\n    type: \"image\",\n    props: { ...props, src },\n  }),\n  video: (\n    src: string,\n    props?: Omit<UIContract[\"video\"], \"src\">\n  ): UINode<\"video\"> => ({\n    type: \"video\",\n    props: { ...props, src },\n  }),\n  icon: (\n    name: string,\n    size: UISize | number = \"md\",\n    color?: UIColor\n  ): UINode<\"icon\"> => ({\n    type: \"icon\",\n    props: { name, size, color },\n  }),\n  chart: (props: UIContract[\"chart\"]): UINode<\"chart\"> => ({\n    type: \"chart\",\n    props,\n  }),\n  list: (props: UIContract[\"list\"] & { children: UINode<any>[] }): UINode<\"list\"> => {\n    const { children, ...rest } = props;\n    return { type: \"list\", props: rest, children };\n  },\n  listItem: (\n    props: UIContract[\"listItem\"] & { children: UINode<any>[] }\n  ): UINode<\"listItem\"> => {\n    const { children, ...rest } = props;\n    return { type: \"listItem\", props: rest, children };\n  },\n  form: (\n    props: UIContract[\"form\"] & { children?: UINode<any>[] }\n  ): UINode<\"form\"> => {\n    const { children, ...rest } = props;\n    return { type: \"form\", props: rest, children };\n  },\n  input: (props: UIContract[\"input\"]): UINode<\"input\"> => ({\n    type: \"input\",\n    props,\n  }),\n  textarea: (props: UIContract[\"textarea\"]): UINode<\"textarea\"> => ({\n    type: \"textarea\",\n    props,\n  }),\n  select: (props: UIContract[\"select\"]): UINode<\"select\"> => ({\n    type: \"select\",\n    props,\n  }),\n  checkbox: (props: UIContract[\"checkbox\"]): UINode<\"checkbox\"> => ({\n    type: \"checkbox\",\n    props,\n  }),\n  hidden: (props: UIContract[\"hidden\"]): UINode<\"hidden\"> => ({\n    type: \"hidden\",\n    props,\n  }),\n  radioGroup: (props: UIContract[\"radioGroup\"]): UINode<\"radioGroup\"> => ({\n    type: \"radioGroup\",\n    props,\n  }),\n  label: (\n    value: string,\n    props?: Omit<UIContract[\"label\"], \"value\">\n  ): UINode<\"label\"> => ({\n    type: \"label\",\n    props: { ...props, value },\n  }),\n  colorPicker: (props: UIContract[\"colorPicker\"]): UINode<\"colorPicker\"> => ({\n    type: \"colorPicker\",\n    props,\n  }),\n  upload: (props: UIContract[\"upload\"]): UINode<\"upload\"> => ({\n    type: \"upload\",\n    props,\n  }),\n  button: (props: UIContract[\"button\"]): UINode<\"button\"> => ({\n    type: \"button\",\n    props,\n  }),\n  float: (\n    props: UIContract[\"float\"] & { children?: UINode<any>[] }\n  ): UINode<\"float\"> => {\n    const { children, ...rest } = props;\n    return { type: \"float\", props: rest, children };\n  },\n  dropdown: (\n    props: UIContract[\"dropdown\"] & { children?: UINode<any>[] }\n  ): UINode<\"dropdown\"> => {\n    const { children, ...rest } = props;\n    return { type: \"dropdown\", props: rest, children };\n  },\n  actions: {\n    navigate: (url: string): Event => ({\n      type: \"client:navigate\",\n      data: { url },\n    }),\n    openUrl: (url: string, target = \"_blank\"): Event => ({\n      type: \"client:open-url\",\n      data: { url, target },\n    }),\n    copy: (text: string): Event => ({ type: \"client:copy\", data: { text } }),\n    reset: (): Event => ({ type: \"client:reset\" }),\n    invalidateQuery: (queryKey: any[]): Event => ({\n      type: \"client:invalidate-query\",\n      data: { queryKey },\n    }),\n  },\n};\n","import {\n  Action,\n  Event,\n  NextAction,\n  RuntimeContext,\n  Config,\n  Plugin,\n  HookGenerator,\n} from \"./types\";\nimport { ui } from \"./ui\";\nimport { generateId } from \"./utils/generate-id\";\nimport { z } from \"zod\";\n\n/**\n * Helper to check if a value is a Melony Event.\n */\nfunction isEvent(val: any): val is Event {\n  return val && typeof val === \"object\" && typeof val.type === \"string\";\n}\n\n/**\n * The Slim Runtime.\n * Single Responsibility: Orchestrate Event -> Action -> Event transitions.\n */\nexport class Runtime<TState = any> {\n  private config: Config<TState>;\n\n  constructor(config: Config<TState>) {\n    this.config = config;\n  }\n\n  public async *run(event: Event): AsyncGenerator<Event> {\n    const runId = event.runId ?? generateId();\n\n    const context: RuntimeContext<TState> = {\n      state: (event.state ?? {}) as TState,\n      runId,\n      stepCount: 0,\n      actions: this.config.actions,\n      ui,\n      suspend: (event?: Event) => {\n        throw event || { type: \"run-suspended\" };\n      },\n    };\n\n    try {\n      let nextAction: NextAction | void = undefined;\n\n      // 1. Trigger Plugins: onBeforeRun\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onBeforeRun) {\n          const result = yield* this.callHook(\n            plugin.onBeforeRun({ event }, context),\n            context\n          );\n          if (result) {\n            nextAction = result as NextAction;\n          }\n        }\n      }\n\n      // 2. Trigger Hook: onBeforeRun\n      if (this.config.hooks?.onBeforeRun) {\n        const result = yield* this.callHook(\n          this.config.hooks.onBeforeRun({ event }, context),\n          context\n        );\n        if (result) {\n          nextAction = result as NextAction;\n        }\n      }\n\n      // Initial dispatch of the incoming event to the agent's brain\n      // Priority:\n      // 1. nextAction already set by onBeforeRun hooks\n      // 2. nextAction provided in the event itself\n      // 3. Dispatch to brain to decide nextAction\n      if (!nextAction && event.nextAction) {\n        nextAction = event.nextAction;\n      }\n\n      if (!nextAction && this.config.brain) {\n        nextAction = yield* this.dispatchToBrain(event, context);\n      }\n\n      // Agentic loop\n      while (nextAction) {\n        if (context.stepCount++ >= (this.config.safetyMaxSteps ?? 10)) {\n          yield* this.emit(\n            { type: \"error\", data: { message: \"Max steps exceeded\" } },\n            context\n          );\n          break;\n        }\n\n        const current: NextAction = nextAction;\n        nextAction = undefined; // Reset\n\n        // 1. Resolve Action\n        const actionName: string | undefined = current.action;\n\n        if (!actionName) {\n          yield* this.emit(\n            {\n              type: \"error\",\n              data: { message: \"No action name provided in NextAction\" },\n            },\n            context\n          );\n          break;\n        }\n\n        const action: Action<any, TState> = this.config.actions[actionName];\n\n        if (!action) {\n          yield* this.emit(\n            {\n              type: \"error\",\n              data: { message: `Action ${actionName} not found` },\n            },\n            context\n          );\n          break;\n        }\n\n        // 2. Execute Action\n        const result = yield* this.executeAction(action, current, context);\n\n        // 3. Decide Next Step\n        if (this.config.brain) {\n          // If we have a brain, feed the result back to it to decide what to do next.\n          // This keeps the brain in the loop for multi-step reasoning.\n          nextAction = yield* this.dispatchToBrain(\n            {\n              type: \"action-result\",\n              data: {\n                ...current, // Preserve all metadata (like toolCallId)\n                action: actionName,\n                result,\n              },\n            },\n            context\n          );\n        } else {\n          // Simple mode: follow the action's own suggestion for the next step.\n          nextAction = result;\n        }\n      }\n\n      // 1. Trigger Plugins: onAfterRun\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onAfterRun) {\n          yield* this.callHook(plugin.onAfterRun(context), context);\n        }\n      }\n\n      // 2. Trigger Hook: onAfterRun\n      if (this.config.hooks?.onAfterRun) {\n        yield* this.callHook(this.config.hooks.onAfterRun(context), context);\n      }\n    } catch (error) {\n      let eventToEmit: Event | undefined;\n\n      if (isEvent(error)) {\n        eventToEmit = error;\n      } else {\n        // Wrap unexpected errors into an Event\n        eventToEmit = {\n          type: \"error\",\n          data: {\n            message: error instanceof Error ? error.message : String(error),\n            stack: error instanceof Error ? error.stack : undefined,\n          },\n        };\n      }\n\n      if (eventToEmit) {\n        yield* this.emit(eventToEmit, context);\n      }\n\n      return; // Gracefully stop the runtime\n    }\n  }\n\n  private async *dispatchToBrain(\n    event: Event,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event, NextAction | void> {\n    const generator = this.config.brain!(event, context);\n    while (true) {\n      const { value, done } = await generator.next();\n      if (done) return value as NextAction | void;\n      yield* this.emit(value as Event, context);\n    }\n  }\n\n  private async *executeAction(\n    action: Action<any, TState>,\n    nextAction: NextAction,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event, NextAction | void> {\n    const params = nextAction.params;\n\n    // 1. Trigger Plugins: onBeforeAction\n    for (const plugin of this.config.plugins || []) {\n      if (plugin.onBeforeAction) {\n        const hookResult = yield* this.callHook(\n          plugin.onBeforeAction({ action, params, nextAction }, context),\n          context\n        );\n        if (hookResult) {\n          nextAction = hookResult as NextAction;\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onBeforeAction\n    if (this.config.hooks?.onBeforeAction) {\n      const hookResult = yield* this.callHook(\n        this.config.hooks.onBeforeAction(\n          { action, params, nextAction },\n          context\n        ),\n        context\n      );\n      if (hookResult) {\n        nextAction = hookResult as NextAction;\n      }\n    }\n\n    try {\n      const generator = action.execute(params, context);\n      let result: NextAction | void;\n\n      while (true) {\n        const { value, done } = await generator.next();\n        if (done) {\n          result = value as NextAction | void;\n          break;\n        }\n        yield* this.emit(value as Event, context);\n      }\n\n      // 3. Trigger Plugins: onAfterAction\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onAfterAction) {\n          const extra = yield* this.callHook(\n            plugin.onAfterAction({ action, data: result }, context),\n            context\n          );\n          if (extra) {\n            nextAction = extra as NextAction;\n          }\n        }\n      }\n\n      // 4. Trigger Hook: onAfterAction\n      if (this.config.hooks?.onAfterAction) {\n        const extra = yield* this.callHook(\n          this.config.hooks.onAfterAction({ action, data: result }, context),\n          context\n        );\n        if (extra) {\n          nextAction = extra as NextAction;\n        }\n      }\n\n      return result;\n    } catch (error) {\n      if (isEvent(error)) throw error;\n\n      throw {\n        type: \"error\",\n        data: {\n          action: action.name,\n          message: error instanceof Error ? error.message : String(error),\n          stack: error instanceof Error ? error.stack : undefined,\n        },\n      };\n    }\n  }\n\n  /**\n   * Internal helper to call a hook (generator) and yield its events.\n   */\n  private async *callHook<T>(\n    generator: HookGenerator<T> | undefined,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event, T | void> {\n    if (!generator) return;\n\n    while (true) {\n      const { value, done } = await generator.next();\n      if (done) return value as T | void;\n      yield* this.emit(value as Event, context);\n    }\n  }\n\n  /**\n   * Internal helper to yield an event and trigger the onEvent hook.\n   */\n  private async *emit(\n    event: Event,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event> {\n    const finalEvent = {\n      ...event,\n      runId: context.runId,\n      timestamp: event.timestamp ?? Date.now(),\n      role: event.role ?? \"assistant\",\n      state: context.state,\n    };\n\n    // Yield the actual event first\n    yield finalEvent;\n\n    // 1. Trigger Plugins: onEvent\n    for (const plugin of this.config.plugins || []) {\n      if (plugin.onEvent) {\n        const generator = plugin.onEvent(finalEvent, context);\n        for await (const extra of generator) {\n          yield { ...extra, runId: context.runId, timestamp: Date.now() };\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onEvent for side-effects or extra events\n    if (this.config.hooks?.onEvent) {\n      const generator = this.config.hooks.onEvent(finalEvent, context);\n      for await (const extra of generator) {\n        // Yield extra event from hook, ensuring it has required metadata\n        yield { ...extra, runId: context.runId, timestamp: Date.now() };\n      }\n    }\n  }\n}\n\nexport const melony = <TState = any>(config: Config<TState>) => {\n  const runtime = new Runtime<TState>(config);\n  return {\n    config,\n    run: runtime.run.bind(runtime),\n  };\n};\n\n/**\n * Helper to define an action with full type inference.\n */\nexport const action = <T extends z.ZodSchema, TState = any>(\n  config: Action<T, TState>\n): Action<T, TState> => config;\n\n/**\n * Helper to define a plugin.\n */\nexport const plugin = <TState = any>(config: Plugin<TState>): Plugin<TState> =>\n  config;\n"]}

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { E as Event, C as Config } from './types-Cn56J4A7.js';
+import { E as Event, C as Config } from './types-BWIe3XvZ.js';
 export { g as generateId } from './generate-id-DU8kwYc2.js';
 import 'zod';
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as Config, E as Event, A as Action, P as Plugin, M as Message } from './types-Cn56J4A7.js';
-export { i as ActionExecute, B as Brain, H as HookGenerator, k as Hooks, N as NextAction, R as Role, j as RuntimeContext, a as UIAlign, e as UIColor, g as UIContract, b as UIJustify, h as UINode, d as UIOrientation, U as UISize, f as UISpacing, c as UIWrap, u as ui } from './types-Cn56J4A7.js';
+import { C as Config, E as Event, A as Action, P as Plugin, M as Message } from './types-BWIe3XvZ.js';
+export { l as ActionExecute, B as Brain, H as HookGenerator, n as Hooks, N as NextAction, R as Role, m as RuntimeContext, a as UIAlign, e as UIColor, j as UIContract, b as UIJustify, k as UINode, d as UIOrientation, i as UIRadius, h as UIShadow, U as UISize, f as UISpacing, g as UIWidth, c as UIWrap, u as ui } from './types-BWIe3XvZ.js';
 import { z } from 'zod';
 export { g as generateId } from './generate-id-DU8kwYc2.js';
 
@@ -43,4 +43,11 @@ declare function createStreamResponse(generator: AsyncGenerator<Event>): Respons
 
 declare function convertEventsToMessages(events: Event[]): Message[];
 
-export { Action, Config, Event, Message, Plugin, Runtime, action, convertEventsToMessages, createStreamResponse, melony, plugin };
+/**
+ * Filters a list of events by their slot property.
+ * If multiple events have the same slot, only the latest one is kept,
+ * but its position in the returned array corresponds to the first time that slot appeared.
+ */
+declare function filterEventsBySlots(events: Event[]): Event[];
+
+export { Action, Config, Event, Message, Plugin, Runtime, action, convertEventsToMessages, createStreamResponse, filterEventsBySlots, melony, plugin };

package/dist/index.js

@@ -1,5 +1,5 @@
 export { createStreamResponse } from './chunk-CFG7FFEZ.js';
-export { Runtime, action, melony, plugin, ui } from './chunk-IK3OHUHO.js';
+export { Runtime, action, melony, plugin, ui } from './chunk-W35Y2YZP.js';
 export { generateId } from './chunk-WAI5H335.js';
 
 // src/utils/convert-events-to-messages.ts
@@ -27,6 +27,32 @@ function convertEventsToMessages(events) {
   return messages;
 }
 
-export { convertEventsToMessages };
+// src/utils/filter-events-by-slots.ts
+function filterEventsBySlots(events) {
+  const firstSlotIndexes = /* @__PURE__ */ new Map();
+  const latestSlotIndexes = /* @__PURE__ */ new Map();
+  events.forEach((event, index) => {
+    if (event.slot) {
+      if (!firstSlotIndexes.has(event.slot)) {
+        firstSlotIndexes.set(event.slot, index);
+      }
+      latestSlotIndexes.set(event.slot, index);
+    }
+  });
+  const result = [];
+  events.forEach((event, index) => {
+    if (event.slot) {
+      if (firstSlotIndexes.get(event.slot) === index) {
+        const latestIndex = latestSlotIndexes.get(event.slot);
+        result.push(events[latestIndex]);
+      }
+    } else {
+      result.push(event);
+    }
+  });
+  return result;
+}
+
+export { convertEventsToMessages, filterEventsBySlots };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/convert-events-to-messages.ts"],"names":[],"mappings":";;;;;AAEO,SAAS,wBAAwB,MAAA,EAA4B;AAClE,EAAA,IAAI,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAEjC,EAAA,MAAM,WAAsB,EAAC;AAC7B,EAAA,IAAI,cAAA,GAAiC,IAAA;AAErC,EAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,IAAA,MAAM,IAAA,GAAO,MAAM,IAAA,IAAQ,WAAA;AAC3B,IAAA,MAAM,QAAQ,KAAA,CAAM,KAAA;AAMpB,IAAA,IACE,CAAC,cAAA,IACD,cAAA,CAAe,IAAA,KAAS,IAAA,IACvB,SAAS,cAAA,CAAe,KAAA,IAAS,KAAA,KAAU,cAAA,CAAe,KAAA,EAC3D;AACA,MAAA,cAAA,GAAiB;AAAA,QACf,IAAA;AAAA,QACA,OAAA,EAAS,CAAC,KAAK,CAAA;AAAA,QACf;AAAA,OACF;AACA,MAAA,QAAA,CAAS,KAAK,cAAc,CAAA;AAAA,IAC9B,CAAA,MAAO;AACL,MAAA,cAAA,CAAe,OAAA,CAAQ,KAAK,KAAK,CAAA;AAEjC,MAAA,IAAI,CAAC,cAAA,CAAe,KAAA,IAAS,KAAA,EAAO;AAClC,QAAA,cAAA,CAAe,KAAA,GAAQ,KAAA;AAAA,MACzB;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,QAAA;AACT","file":"index.js","sourcesContent":["import { Event, Message } from \"../types\";\n\nexport function convertEventsToMessages(events: Event[]): Message[] {\n  if (events.length === 0) return [];\n\n  const messages: Message[] = [];\n  let currentMessage: Message | null = null;\n\n  for (const event of events) {\n    const role = event.role || \"assistant\";\n    const runId = event.runId;\n\n    // Start a new message if:\n    // 1. No current message\n    // 2. Role changed\n    // 3. runId changed (and both have runIds)\n    if (\n      !currentMessage ||\n      currentMessage.role !== role ||\n      (runId && currentMessage.runId && runId !== currentMessage.runId)\n    ) {\n      currentMessage = {\n        role: role,\n        content: [event],\n        runId,\n      };\n      messages.push(currentMessage);\n    } else {\n      currentMessage.content.push(event);\n      // If the current message didn't have a runId but this event does, update it\n      if (!currentMessage.runId && runId) {\n        currentMessage.runId = runId;\n      }\n    }\n  }\n\n  return messages;\n}\n"]}
+{"version":3,"sources":["../src/utils/convert-events-to-messages.ts","../src/utils/filter-events-by-slots.ts"],"names":[],"mappings":";;;;;AAEO,SAAS,wBAAwB,MAAA,EAA4B;AAClE,EAAA,IAAI,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAEjC,EAAA,MAAM,WAAsB,EAAC;AAC7B,EAAA,IAAI,cAAA,GAAiC,IAAA;AAErC,EAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,IAAA,MAAM,IAAA,GAAO,MAAM,IAAA,IAAQ,WAAA;AAC3B,IAAA,MAAM,QAAQ,KAAA,CAAM,KAAA;AAMpB,IAAA,IACE,CAAC,cAAA,IACD,cAAA,CAAe,IAAA,KAAS,IAAA,IACvB,SAAS,cAAA,CAAe,KAAA,IAAS,KAAA,KAAU,cAAA,CAAe,KAAA,EAC3D;AACA,MAAA,cAAA,GAAiB;AAAA,QACf,IAAA;AAAA,QACA,OAAA,EAAS,CAAC,KAAK,CAAA;AAAA,QACf;AAAA,OACF;AACA,MAAA,QAAA,CAAS,KAAK,cAAc,CAAA;AAAA,IAC9B,CAAA,MAAO;AACL,MAAA,cAAA,CAAe,OAAA,CAAQ,KAAK,KAAK,CAAA;AAEjC,MAAA,IAAI,CAAC,cAAA,CAAe,KAAA,IAAS,KAAA,EAAO;AAClC,QAAA,cAAA,CAAe,KAAA,GAAQ,KAAA;AAAA,MACzB;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,QAAA;AACT;;;AC9BO,SAAS,oBAAoB,MAAA,EAA0B;AAC5D,EAAA,MAAM,gBAAA,uBAAuB,GAAA,EAAoB;AACjD,EAAA,MAAM,iBAAA,uBAAwB,GAAA,EAAoB;AAElD,EAAA,MAAA,CAAO,OAAA,CAAQ,CAAC,KAAA,EAAO,KAAA,KAAU;AAC/B,IAAA,IAAI,MAAM,IAAA,EAAM;AACd,MAAA,IAAI,CAAC,gBAAA,CAAiB,GAAA,CAAI,KAAA,CAAM,IAAI,CAAA,EAAG;AACrC,QAAA,gBAAA,CAAiB,GAAA,CAAI,KAAA,CAAM,IAAA,EAAM,KAAK,CAAA;AAAA,MACxC;AACA,MAAA,iBAAA,CAAkB,GAAA,CAAI,KAAA,CAAM,IAAA,EAAM,KAAK,CAAA;AAAA,IACzC;AAAA,EACF,CAAC,CAAA;AAED,EAAA,MAAM,SAAkB,EAAC;AAEzB,EAAA,MAAA,CAAO,OAAA,CAAQ,CAAC,KAAA,EAAO,KAAA,KAAU;AAC/B,IAAA,IAAI,MAAM,IAAA,EAAM;AACd,MAAA,IAAI,gBAAA,CAAiB,GAAA,CAAI,KAAA,CAAM,IAAI,MAAM,KAAA,EAAO;AAC9C,QAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,GAAA,CAAI,KAAA,CAAM,IAAI,CAAA;AACpD,QAAA,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,WAAW,CAAC,CAAA;AAAA,MACjC;AAAA,IACF,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,IACnB;AAAA,EACF,CAAC,CAAA;AAED,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["import { Event, Message } from \"../types\";\n\nexport function convertEventsToMessages(events: Event[]): Message[] {\n  if (events.length === 0) return [];\n\n  const messages: Message[] = [];\n  let currentMessage: Message | null = null;\n\n  for (const event of events) {\n    const role = event.role || \"assistant\";\n    const runId = event.runId;\n\n    // Start a new message if:\n    // 1. No current message\n    // 2. Role changed\n    // 3. runId changed (and both have runIds)\n    if (\n      !currentMessage ||\n      currentMessage.role !== role ||\n      (runId && currentMessage.runId && runId !== currentMessage.runId)\n    ) {\n      currentMessage = {\n        role: role,\n        content: [event],\n        runId,\n      };\n      messages.push(currentMessage);\n    } else {\n      currentMessage.content.push(event);\n      // If the current message didn't have a runId but this event does, update it\n      if (!currentMessage.runId && runId) {\n        currentMessage.runId = runId;\n      }\n    }\n  }\n\n  return messages;\n}\n","import { Event } from \"../types\";\n\n/**\n * Filters a list of events by their slot property.\n * If multiple events have the same slot, only the latest one is kept,\n * but its position in the returned array corresponds to the first time that slot appeared.\n */\nexport function filterEventsBySlots(events: Event[]): Event[] {\n  const firstSlotIndexes = new Map<string, number>();\n  const latestSlotIndexes = new Map<string, number>();\n\n  events.forEach((event, index) => {\n    if (event.slot) {\n      if (!firstSlotIndexes.has(event.slot)) {\n        firstSlotIndexes.set(event.slot, index);\n      }\n      latestSlotIndexes.set(event.slot, index);\n    }\n  });\n\n  const result: Event[] = [];\n\n  events.forEach((event, index) => {\n    if (event.slot) {\n      if (firstSlotIndexes.get(event.slot) === index) {\n        const latestIndex = latestSlotIndexes.get(event.slot)!;\n        result.push(events[latestIndex]);\n      }\n    } else {\n      result.push(event);\n    }\n  });\n\n  return result;\n}\n"]}

package/dist/plugins/require-approval.d.ts

@@ -1,4 +1,4 @@
-import { A as Action, j as RuntimeContext, P as Plugin } from '../types-Cn56J4A7.js';
+import { A as Action, m as RuntimeContext, P as Plugin } from '../types-BWIe3XvZ.js';
 import 'zod';
 
 interface RequireApprovalOptions {

package/dist/plugins/require-approval.js

@@ -1,4 +1,4 @@
-import { plugin, ui } from '../chunk-IK3OHUHO.js';
+import { plugin, ui } from '../chunk-W35Y2YZP.js';
 import '../chunk-WAI5H335.js';
 
 // src/plugins/require-approval.ts

package/dist/plugins/require-approval.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/plugins/require-approval.ts"],"names":[],"mappings":"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","file":"require-approval.js","sourcesContent":["import { plugin } from \"../runtime\";\nimport { ui } from \"../types\";\nimport type { Action, RuntimeContext } from \"../types\";\n\nexport interface RequireApprovalOptions {\n  /**\n   * List of action names that require explicit approval.\n   * If not provided, all actions will require approval.\n   */\n  actions?: string[];\n\n  /**\n   * Optional secret to sign the approval payload.\n   * If provided, the plugin will verify that the parameters haven't been\n   * tampered with between the request and the approval.\n   */\n  secret?: string;\n\n  /**\n   * Custom message to show in the approval card.\n   */\n  message?: string | ((action: string, params: any) => string);\n\n  /**\n   * Optional condition to check if approval is needed dynamically.\n   */\n  shouldApprove?: (\n    action: Action<any>,\n    params: any,\n    context: RuntimeContext\n  ) => boolean | Promise<boolean>;\n}\n\n/**\n * A plugin that intercepts actions and requires human approval before execution.\n * It uses SDUI to prompt the user and handles the resumption of the agentic loop.\n */\nexport const requireApproval = (options: RequireApprovalOptions = {}) => {\n  return plugin({\n    name: \"require-approval\",\n\n    /**\n     * Step 1: Handle the resumption when the user clicks \"Approve\" or \"Cancel\".\n     * We verify the one-time-use approvalId to prevent replay attacks or double-clicks.\n     */\n    onBeforeRun: async function* ({ event }, context) {\n      if (\n        event.type === \"action-approved\" ||\n        event.type === \"action-rejected\"\n      ) {\n        const { token, approvalId } = event.data || {};\n        const action = event.nextAction?.action;\n        const params = event.nextAction?.params;\n\n        // 1. Check if this specific request exists and hasn't been used\n        const pending = context.state.__pending_approvals?.[approvalId];\n        if (!pending) {\n          context.suspend({\n            role: \"assistant\",\n            type: \"error\",\n            data: {\n              message:\n                \"Security Error: This approval request is invalid or has already been used.\",\n            },\n            ui: ui.card({\n              title: \"Security Error\",\n              children: [\n                ui.text(\n                  \"This approval request is invalid or has already been used.\"\n                ),\n              ],\n            }),\n          });\n        }\n\n        // 2. Consume the token immediately (Destroy after usage)\n        delete context.state.__pending_approvals[approvalId];\n\n        if (event.type === \"action-approved\") {\n          // 3. Security: Verify the token if a secret was provided\n          if (options.secret) {\n            const expectedToken = await signPayload(\n              { action, params, approvalId },\n              options.secret\n            );\n            if (token !== expectedToken) {\n              yield {\n                type: \"error\",\n                data: {\n                  message:\n                    \"Security Warning: Approval token mismatch. Execution blocked.\",\n                },\n              };\n              return;\n            }\n          }\n\n        // 4. Store approval in ephemeral state for the upcoming action execution\n        context.state.__approved_action = { action, params };\n\n        // No need to return anything here!\n        // The Runtime will automatically pick up `event.nextAction`\n        // which was attached to the \"action-approved\" event.\n        return;\n      }\n\n      // Handle Rejection\n        context.suspend({\n          type: \"error\",\n          data: {\n            message: `Action '${action}' was rejected by the user.`,\n          },\n        });\n      }\n    },\n\n    /**\n     * Step 2: Intercept actions that require approval.\n     */\n    onBeforeAction: async function* ({ action, params, nextAction }, context) {\n      // 1. Check if this action needs approval\n      const isTargetAction =\n        !options.actions || options.actions.includes(action.name);\n      if (!isTargetAction) return;\n\n      if (options.shouldApprove) {\n        const needsApproval = await options.shouldApprove(\n          action,\n          params,\n          context\n        );\n        if (!needsApproval) return;\n      }\n\n      // 2. Check if it was ALREADY approved in this run\n      const approval = context.state.__approved_action;\n      if (\n        approval &&\n        approval.action === action.name &&\n        JSON.stringify(approval.params) === JSON.stringify(params)\n      ) {\n        delete context.state.__approved_action;\n        return; // Proceed to execution\n      }\n\n      // 3. Suspend and request approval with a one-time-use nonce\n      const approvalId = Math.random().toString(36).substring(2, 15);\n      context.state.__pending_approvals =\n        context.state.__pending_approvals || {};\n      context.state.__pending_approvals[approvalId] = true;\n\n      const token = options.secret\n        ? await signPayload(\n            { action: action.name, params, approvalId },\n            options.secret\n          )\n        : undefined;\n\n      const message =\n        typeof options.message === \"function\"\n          ? options.message(action.name, params)\n          : options.message ||\n            `The agent wants to execute **${action.name}**. Do you approve?`;\n\n      context.suspend({\n        type: \"hitl-required\",\n        nextAction,\n        data: { token, approvalId },\n        slot: \"approval\",\n        ui: ui.card({\n          title: \"Approval Required\",\n          children: [\n            ui.text(message),\n            ui.box({\n              padding: \"md\",\n              background: \"muted\",\n              children: [\n                ui.text(JSON.stringify(params, null, 2), { size: \"xs\" }),\n              ],\n            }),\n            ui.row({\n              gap: \"md\",\n              children: [\n                ui.button({\n                  label: \"Approve\",\n                  variant: \"success\",\n                  onClickAction: {\n                    role: \"user\",\n                    type: \"action-approved\",\n                    nextAction,\n                    data: { token, approvalId },\n                    ui: ui.text(\"Approval granted\"),\n                  },\n                }),\n                ui.button({\n                  label: \"Cancel\",\n                  variant: \"outline\",\n                  onClickAction: {\n                    type: \"action-rejected\",\n                    nextAction,\n                    data: { approvalId },\n                  },\n                }),\n              ],\n            }),\n          ],\n        }),\n      });\n    },\n  });\n};\n\n/**\n * Simple HMAC signing using the Web Crypto API (supported in Node 16+ and Browsers).\n */\nasync function signPayload(data: any, secret: string): Promise<string> {\n  const msg = JSON.stringify(data);\n  const encoder = new TextEncoder();\n  const keyData = encoder.encode(secret);\n  const dataToSign = encoder.encode(msg);\n\n  const key = await crypto.subtle.importKey(\n    \"raw\",\n    keyData,\n    { name: \"HMAC\", hash: \"SHA-256\" },\n    false,\n    [\"sign\"]\n  );\n\n  const signature = await crypto.subtle.sign(\"HMAC\", key, dataToSign);\n  return btoa(String.fromCharCode(...new Uint8Array(signature)));\n}\n"]}
+{"version":3,"sources":["../../src/plugins/require-approval.ts"],"names":[],"mappings":"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","file":"require-approval.js","sourcesContent":["import { plugin } from \"../runtime\";\nimport { ui } from \"../ui\";\nimport type { Action, RuntimeContext } from \"../types\";\n\nexport interface RequireApprovalOptions {\n  /**\n   * List of action names that require explicit approval.\n   * If not provided, all actions will require approval.\n   */\n  actions?: string[];\n\n  /**\n   * Optional secret to sign the approval payload.\n   * If provided, the plugin will verify that the parameters haven't been\n   * tampered with between the request and the approval.\n   */\n  secret?: string;\n\n  /**\n   * Custom message to show in the approval card.\n   */\n  message?: string | ((action: string, params: any) => string);\n\n  /**\n   * Optional condition to check if approval is needed dynamically.\n   */\n  shouldApprove?: (\n    action: Action<any>,\n    params: any,\n    context: RuntimeContext\n  ) => boolean | Promise<boolean>;\n}\n\n/**\n * A plugin that intercepts actions and requires human approval before execution.\n * It uses SDUI to prompt the user and handles the resumption of the agentic loop.\n */\nexport const requireApproval = (options: RequireApprovalOptions = {}) => {\n  return plugin({\n    name: \"require-approval\",\n\n    /**\n     * Step 1: Handle the resumption when the user clicks \"Approve\" or \"Cancel\".\n     * We verify the one-time-use approvalId to prevent replay attacks or double-clicks.\n     */\n    onBeforeRun: async function* ({ event }, context) {\n      if (\n        event.type === \"action-approved\" ||\n        event.type === \"action-rejected\"\n      ) {\n        const { token, approvalId } = event.data || {};\n        const action = event.nextAction?.action;\n        const params = event.nextAction?.params;\n\n        // 1. Check if this specific request exists and hasn't been used\n        const pending = context.state.__pending_approvals?.[approvalId];\n        if (!pending) {\n          context.suspend({\n            role: \"assistant\",\n            type: \"error\",\n            data: {\n              message:\n                \"Security Error: This approval request is invalid or has already been used.\",\n            },\n            ui: ui.card({\n              title: \"Security Error\",\n              children: [\n                ui.text(\n                  \"This approval request is invalid or has already been used.\"\n                ),\n              ],\n            }),\n          });\n        }\n\n        // 2. Consume the token immediately (Destroy after usage)\n        delete context.state.__pending_approvals[approvalId];\n\n        if (event.type === \"action-approved\") {\n          // 3. Security: Verify the token if a secret was provided\n          if (options.secret) {\n            const expectedToken = await signPayload(\n              { action, params, approvalId },\n              options.secret\n            );\n            if (token !== expectedToken) {\n              yield {\n                type: \"error\",\n                data: {\n                  message:\n                    \"Security Warning: Approval token mismatch. Execution blocked.\",\n                },\n              };\n              return;\n            }\n          }\n\n        // 4. Store approval in ephemeral state for the upcoming action execution\n        context.state.__approved_action = { action, params };\n\n        // No need to return anything here!\n        // The Runtime will automatically pick up `event.nextAction`\n        // which was attached to the \"action-approved\" event.\n        return;\n      }\n\n      // Handle Rejection\n        context.suspend({\n          type: \"error\",\n          data: {\n            message: `Action '${action}' was rejected by the user.`,\n          },\n        });\n      }\n    },\n\n    /**\n     * Step 2: Intercept actions that require approval.\n     */\n    onBeforeAction: async function* ({ action, params, nextAction }, context) {\n      // 1. Check if this action needs approval\n      const isTargetAction =\n        !options.actions || options.actions.includes(action.name);\n      if (!isTargetAction) return;\n\n      if (options.shouldApprove) {\n        const needsApproval = await options.shouldApprove(\n          action,\n          params,\n          context\n        );\n        if (!needsApproval) return;\n      }\n\n      // 2. Check if it was ALREADY approved in this run\n      const approval = context.state.__approved_action;\n      if (\n        approval &&\n        approval.action === action.name &&\n        JSON.stringify(approval.params) === JSON.stringify(params)\n      ) {\n        delete context.state.__approved_action;\n        return; // Proceed to execution\n      }\n\n      // 3. Suspend and request approval with a one-time-use nonce\n      const approvalId = Math.random().toString(36).substring(2, 15);\n      context.state.__pending_approvals =\n        context.state.__pending_approvals || {};\n      context.state.__pending_approvals[approvalId] = true;\n\n      const token = options.secret\n        ? await signPayload(\n            { action: action.name, params, approvalId },\n            options.secret\n          )\n        : undefined;\n\n      const message =\n        typeof options.message === \"function\"\n          ? options.message(action.name, params)\n          : options.message ||\n            `The agent wants to execute **${action.name}**. Do you approve?`;\n\n      context.suspend({\n        type: \"hitl-required\",\n        nextAction,\n        data: { token, approvalId },\n        slot: \"approval\",\n        ui: ui.card({\n          title: \"Approval Required\",\n          children: [\n            ui.text(message),\n            ui.box({\n              padding: \"md\",\n              background: \"muted\",\n              children: [\n                ui.text(JSON.stringify(params, null, 2), { size: \"xs\" }),\n              ],\n            }),\n            ui.row({\n              gap: \"md\",\n              children: [\n                ui.button({\n                  label: \"Approve\",\n                  variant: \"success\",\n                  onClickAction: {\n                    role: \"user\",\n                    type: \"action-approved\",\n                    nextAction,\n                    data: { token, approvalId },\n                    ui: ui.text(\"Approval granted\"),\n                  },\n                }),\n                ui.button({\n                  label: \"Cancel\",\n                  variant: \"outline\",\n                  onClickAction: {\n                    type: \"action-rejected\",\n                    nextAction,\n                    data: { approvalId },\n                  },\n                }),\n              ],\n            }),\n          ],\n        }),\n      });\n    },\n  });\n};\n\n/**\n * Simple HMAC signing using the Web Crypto API (supported in Node 16+ and Browsers).\n */\nasync function signPayload(data: any, secret: string): Promise<string> {\n  const msg = JSON.stringify(data);\n  const encoder = new TextEncoder();\n  const keyData = encoder.encode(secret);\n  const dataToSign = encoder.encode(msg);\n\n  const key = await crypto.subtle.importKey(\n    \"raw\",\n    keyData,\n    { name: \"HMAC\", hash: \"SHA-256\" },\n    false,\n    [\"sign\"]\n  );\n\n  const signature = await crypto.subtle.sign(\"HMAC\", key, dataToSign);\n  return btoa(String.fromCharCode(...new Uint8Array(signature)));\n}\n"]}

package/dist/{types-Cn56J4A7.d.ts → types-BWIe3XvZ.d.ts}

@@ -1,12 +1,75 @@
 import z from 'zod';
 
+/**
+ * UI Builder for SDUI.
+ * Typed using the UIContract source of truth.
+ */
+declare const ui: {
+    card: (props: UIContract["card"] & {
+        children?: UINode<any>[];
+    }) => UINode<"card">;
+    row: (props: UIContract["row"] & {
+        children?: UINode<any>[];
+    }) => UINode<"row">;
+    col: (props: UIContract["col"] & {
+        children?: UINode<any>[];
+    }) => UINode<"col">;
+    box: (props: UIContract["box"] & {
+        children?: UINode<any>[];
+    }) => UINode<"box">;
+    spacer: (props: UIContract["spacer"]) => UINode<"spacer">;
+    divider: (props: UIContract["divider"]) => UINode<"divider">;
+    text: (value: string, props?: Omit<UIContract["text"], "value">) => UINode<"text">;
+    heading: (value: string, level?: UIContract["heading"]["level"], props?: Omit<UIContract["heading"], "value" | "level">) => UINode<"heading">;
+    badge: (label: string, variant?: UIContract["badge"]["variant"], size?: UISize) => UINode<"badge">;
+    image: (src: string, props?: Omit<UIContract["image"], "src">) => UINode<"image">;
+    video: (src: string, props?: Omit<UIContract["video"], "src">) => UINode<"video">;
+    icon: (name: string, size?: UISize | number, color?: UIColor) => UINode<"icon">;
+    chart: (props: UIContract["chart"]) => UINode<"chart">;
+    list: (props: UIContract["list"] & {
+        children: UINode<any>[];
+    }) => UINode<"list">;
+    listItem: (props: UIContract["listItem"] & {
+        children: UINode<any>[];
+    }) => UINode<"listItem">;
+    form: (props: UIContract["form"] & {
+        children?: UINode<any>[];
+    }) => UINode<"form">;
+    input: (props: UIContract["input"]) => UINode<"input">;
+    textarea: (props: UIContract["textarea"]) => UINode<"textarea">;
+    select: (props: UIContract["select"]) => UINode<"select">;
+    checkbox: (props: UIContract["checkbox"]) => UINode<"checkbox">;
+    hidden: (props: UIContract["hidden"]) => UINode<"hidden">;
+    radioGroup: (props: UIContract["radioGroup"]) => UINode<"radioGroup">;
+    label: (value: string, props?: Omit<UIContract["label"], "value">) => UINode<"label">;
+    colorPicker: (props: UIContract["colorPicker"]) => UINode<"colorPicker">;
+    upload: (props: UIContract["upload"]) => UINode<"upload">;
+    button: (props: UIContract["button"]) => UINode<"button">;
+    float: (props: UIContract["float"] & {
+        children?: UINode<any>[];
+    }) => UINode<"float">;
+    dropdown: (props: UIContract["dropdown"] & {
+        children?: UINode<any>[];
+    }) => UINode<"dropdown">;
+    actions: {
+        navigate: (url: string) => Event;
+        openUrl: (url: string, target?: string) => Event;
+        copy: (text: string) => Event;
+        reset: () => Event;
+        invalidateQuery: (queryKey: any[]) => Event;
+    };
+};
+
 type UISize = "sm" | "md" | "lg";
 type UIAlign = "start" | "center" | "end" | "stretch";
 type UIJustify = "start" | "center" | "end" | "between" | "around";
 type UIWrap = "nowrap" | "wrap" | "wrap-reverse";
 type UIOrientation = "horizontal" | "vertical";
-type UIColor = "primary" | "secondary" | "success" | "danger" | "warning" | "info" | "background" | "foreground" | "muted" | "mutedForeground" | "border";
-type UISpacing = "xs" | "sm" | "md" | "lg" | "xl" | "xxl";
+type UIColor = "primary" | "secondary" | "success" | "danger" | "warning" | "info" | "background" | "foreground" | "muted" | "mutedForeground" | "border" | "transparent";
+type UISpacing = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "xxl";
+type UIWidth = "auto" | "full" | "min" | "max" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4";
+type UIShadow = "none" | "sm" | "md" | "lg" | "xl";
+type UIRadius = "none" | "sm" | "md" | "lg" | "full";
 /**
  * UI Component Contracts
  * This acts as the source of truth for the SDUI protocol.
@@ -15,31 +78,44 @@ interface UIContract {
     card: {
         title?: string;
         subtitle?: string;
-        background?: string;
+        background?: UIColor;
+        padding?: UISpacing;
+        radius?: UIRadius;
+        shadow?: UIShadow;
         isLoading?: boolean;
+        group?: boolean;
     };
     row: {
         align?: UIAlign;
         justify?: UIJustify;
         wrap?: UIWrap;
         gap?: UISpacing;
+        padding?: UISpacing;
+        width?: UIWidth;
+        group?: boolean;
     };
     col: {
         align?: UIAlign;
         justify?: UIJustify;
         gap?: UISpacing;
-        width?: string | number;
-        height?: string | number;
+        width?: UIWidth;
+        height?: "auto" | "full";
         padding?: UISpacing;
+        background?: UIColor;
+        radius?: UIRadius;
+        group?: boolean;
     };
     box: {
         padding?: UISpacing;
-        margin?: string | number;
-        background?: string;
+        margin?: UISpacing;
+        background?: UIColor;
         border?: boolean;
-        borderRadius?: UISpacing;
-        width?: string | number;
-        height?: string | number;
+        borderColor?: UIColor;
+        radius?: UIRadius;
+        width?: UIWidth;
+        height?: "auto" | "full";
+        shadow?: UIShadow;
+        group?: boolean;
     };
     spacer: {
         size?: UISpacing;
@@ -48,6 +124,7 @@ interface UIContract {
     divider: {
         orientation?: UIOrientation;
         color?: UIColor;
+        margin?: UISpacing;
     };
     text: {
         value: string;
@@ -59,16 +136,21 @@ interface UIContract {
     heading: {
         value: string;
         level?: 1 | 2 | 3 | 4 | 5 | 6;
+        color?: UIColor;
+        align?: UIAlign;
     };
     badge: {
         label: string;
-        variant?: "primary" | "secondary" | "success" | "danger" | "warning";
+        variant?: "primary" | "secondary" | "success" | "danger" | "warning" | "outline";
         size?: UISize;
     };
     image: {
         src: string;
         alt?: string;
-        size?: UISize;
+        width?: UIWidth;
+        height?: string | number;
+        radius?: UIRadius;
+        objectFit?: "cover" | "contain" | "fill";
         groupId?: string;
     };
     video: {
@@ -79,11 +161,12 @@ interface UIContract {
         loop?: boolean;
         muted?: boolean;
         aspectRatio?: "16/9" | "4/3" | "1/1" | "9/16";
-        width?: string | number;
+        width?: UIWidth;
+        radius?: UIRadius;
     };
     icon: {
         name: string;
-        size?: UISize;
+        size?: UISize | number;
         color?: UIColor;
     };
     chart: {
@@ -94,22 +177,36 @@ interface UIContract {
         }>;
         chartType?: "bar" | "line" | "area" | "pie";
         title?: string;
+        height?: number;
+        showValues?: boolean;
+        showGrid?: boolean;
+        showTooltips?: boolean;
+    };
+    list: {
+        padding?: UISpacing;
+        gap?: UISpacing;
     };
-    list: {};
     listItem: {
         onClickAction?: Event;
         gap?: UISpacing;
+        padding?: UISpacing;
+        background?: UIColor;
+        radius?: UIRadius;
     };
     form: {
         onSubmitAction?: Event | ((data: any) => Event);
+        gap?: UISpacing;
     };
     input: {
         name: string;
         label?: string;
         placeholder?: string;
         defaultValue?: string;
-        inputType?: string;
+        inputType?: "text" | "password" | "email" | "number" | "tel" | "url";
         onChangeAction?: Event;
+        disabled?: boolean;
+        required?: boolean;
+        width?: UIWidth;
     };
     textarea: {
         name: string;
@@ -118,6 +215,9 @@ interface UIContract {
         defaultValue?: string;
         rows?: number;
         onChangeAction?: Event;
+        disabled?: boolean;
+        required?: boolean;
+        width?: UIWidth;
     };
     select: {
         name: string;
@@ -129,12 +229,16 @@ interface UIContract {
         defaultValue?: string;
         placeholder?: string;
         onChangeAction?: Event;
+        disabled?: boolean;
+        required?: boolean;
+        width?: UIWidth;
     };
     checkbox: {
         name: string;
         label?: string;
         checked?: boolean;
         onChangeAction?: Event;
+        disabled?: boolean;
     };
     hidden: {
         name: string;
@@ -151,17 +255,21 @@ interface UIContract {
         defaultValue?: string;
         orientation?: UIOrientation;
         onChangeAction?: Event;
+        disabled?: boolean;
     };
     label: {
         value: string;
         htmlFor?: string;
         required?: boolean;
+        size?: UISpacing;
+        color?: UIColor;
     };
     colorPicker: {
         name: string;
         label?: string;
         defaultValue?: string;
         onChangeAction?: Event;
+        disabled?: boolean;
     };
     upload: {
         label?: string;
@@ -173,77 +281,44 @@ interface UIContract {
         }[];
         onUploadAction?: Event | ((data: any) => Event);
         mode?: "append" | "replace";
+        disabled?: boolean;
     };
     button: {
-        type?: string;
+        type?: "button" | "submit" | "reset";
         label: string;
         variant?: "primary" | "secondary" | "success" | "danger" | "outline" | "ghost" | "link";
         size?: UISize;
         disabled?: boolean;
+        width?: UIWidth;
         onClickAction?: Event;
     };
+    float: {
+        position?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "center";
+        offsetX?: UISpacing;
+        offsetY?: UISpacing;
+        showOnHover?: boolean;
+    };
+    dropdown: {
+        items: Array<{
+            label: string;
+            icon?: string;
+            onClickAction?: Event;
+        }>;
+        className?: string;
+        triggerClassName?: string;
+    };
 }
 type UINode<T extends keyof UIContract = keyof UIContract> = {
     type: T;
     props?: UIContract[T];
     children?: UINode<any>[];
 };
-/**
- * UI Builder for SDUI.
- * Typed using the UIContract source of truth.
- */
-declare const ui: {
-    card: (props: UIContract["card"] & {
-        children?: UINode<any>[];
-    }) => UINode<"card">;
-    row: (props: UIContract["row"] & {
-        children?: UINode<any>[];
-    }) => UINode<"row">;
-    col: (props: UIContract["col"] & {
-        children?: UINode<any>[];
-    }) => UINode<"col">;
-    box: (props: UIContract["box"] & {
-        children?: UINode<any>[];
-    }) => UINode<"box">;
-    spacer: (props: UIContract["spacer"]) => UINode<"spacer">;
-    divider: (props: UIContract["divider"]) => UINode<"divider">;
-    text: (value: string, props?: Omit<UIContract["text"], "value">) => UINode<"text">;
-    heading: (value: string, level?: UIContract["heading"]["level"]) => UINode<"heading">;
-    badge: (label: string, variant?: UIContract["badge"]["variant"], size?: UISize) => UINode<"badge">;
-    image: (src: string, alt?: string, size?: UISize, groupId?: string) => UINode<"image">;
-    video: (src: string, props?: Omit<UIContract["video"], "src">) => UINode<"video">;
-    icon: (name: string, size?: UISize, color?: UIColor) => UINode<"icon">;
-    chart: (props: UIContract["chart"]) => UINode<"chart">;
-    list: (children: UINode<any>[]) => UINode<"list">;
-    listItem: (props: UIContract["listItem"] & {
-        children: UINode<any>[];
-    }) => UINode<"listItem">;
-    form: (props: UIContract["form"] & {
-        children?: UINode<any>[];
-    }) => UINode<"form">;
-    input: (props: UIContract["input"]) => UINode<"input">;
-    textarea: (props: UIContract["textarea"]) => UINode<"textarea">;
-    select: (props: UIContract["select"]) => UINode<"select">;
-    checkbox: (props: UIContract["checkbox"]) => UINode<"checkbox">;
-    hidden: (props: UIContract["hidden"]) => UINode<"hidden">;
-    radioGroup: (props: UIContract["radioGroup"]) => UINode<"radioGroup">;
-    label: (value: string, props?: Omit<UIContract["label"], "value">) => UINode<"label">;
-    colorPicker: (props: UIContract["colorPicker"]) => UINode<"colorPicker">;
-    upload: (props: UIContract["upload"]) => UINode<"upload">;
-    button: (props: UIContract["button"]) => UINode<"button">;
-    actions: {
-        navigate: (url: string) => Event;
-        openUrl: (url: string, target?: string) => Event;
-        copy: (text: string) => Event;
-        reset: () => Event;
-        invalidateQuery: (queryKey: any[]) => Event;
-    };
-};
 type Role = "user" | "assistant" | "system";
 type Event = {
     type: string;
     data?: any;
     ui?: UINode;
+    surface?: string;
     slot?: string;
     runId?: string;
     threadId?: string;
@@ -366,4 +441,4 @@ interface Config<TState = any> {
     };
 }
 
-export { type Action as A, type Brain as B, type Config as C, type Event as E, type HookGenerator as H, type Message as M, type NextAction as N, type Plugin as P, type Role as R, type UISize as U, type UIAlign as a, type UIJustify as b, type UIWrap as c, type UIOrientation as d, type UIColor as e, type UISpacing as f, type UIContract as g, type UINode as h, type ActionExecute as i, type RuntimeContext as j, type Hooks as k, ui as u };
+export { type Action as A, type Brain as B, type Config as C, type Event as E, type HookGenerator as H, type Message as M, type NextAction as N, type Plugin as P, type Role as R, type UISize as U, type UIAlign as a, type UIJustify as b, type UIWrap as c, type UIOrientation as d, type UIColor as e, type UISpacing as f, type UIWidth as g, type UIShadow as h, type UIRadius as i, type UIContract as j, type UINode as k, type ActionExecute as l, type RuntimeContext as m, type Hooks as n, ui as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "melony",
-  "version": "0.1.50",
+  "version": "0.1.53",
   "main": "dist/index.js",
   "type": "module",
   "sideEffects": false,

package/dist/chunk-IK3OHUHO.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types.ts","../src/runtime.ts"],"names":["event","plugin","action"],"mappings":";;;AA+MO,IAAM,EAAA,GAAK;AAAA,EAChB,IAAA,EAAM,CACJ,KAAA,KACmB;AACnB,IAAA,MAAM,EAAE,QAAA,EAAU,GAAG,IAAA,EAAK,GAAI,KAAA;AAC9B,IAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,KAAA,EAAO,MAAM,QAAA,EAAS;AAAA,EAC/C,CAAA;AAAA,EACA,GAAA,EAAK,CACH,KAAA,KACkB;AAClB,IAAA,MAAM,EAAE,QAAA,EAAU,GAAG,IAAA,EAAK,GAAI,KAAA;AAC9B,IAAA,OAAO,EAAE,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,MAAM,QAAA,EAAS;AAAA,EAC9C,CAAA;AAAA,EACA,GAAA,EAAK,CACH,KAAA,KACkB;AAClB,IAAA,MAAM,EAAE,QAAA,EAAU,GAAG,IAAA,EAAK,GAAI,KAAA;AAC9B,IAAA,OAAO,EAAE,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,MAAM,QAAA,EAAS;AAAA,EAC9C,CAAA;AAAA,EACA,GAAA,EAAK,CACH,KAAA,KACkB;AAClB,IAAA,MAAM,EAAE,QAAA,EAAU,GAAG,IAAA,EAAK,GAAI,KAAA;AAC9B,IAAA,OAAO,EAAE,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,MAAM,QAAA,EAAS;AAAA,EAC9C,CAAA;AAAA,EACA,MAAA,EAAQ,CAAC,KAAA,MAAmD;AAAA,IAC1D,IAAA,EAAM,QAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,OAAA,EAAS,CAAC,KAAA,MAAqD;AAAA,IAC7D,IAAA,EAAM,SAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,IAAA,EAAM,CACJ,KAAA,EACA,KAAA,MACoB;AAAA,IACpB,IAAA,EAAM,MAAA;AAAA,IACN,KAAA,EAAO,EAAE,GAAG,KAAA,EAAO,KAAA;AAAM,GAC3B,CAAA;AAAA,EACA,OAAA,EAAS,CACP,KAAA,EACA,KAAA,GAAwC,CAAA,MACjB;AAAA,IACvB,IAAA,EAAM,SAAA;AAAA,IACN,KAAA,EAAO,EAAE,KAAA,EAAO,KAAA;AAAM,GACxB,CAAA;AAAA,EACA,OAAO,CACL,KAAA,EACA,OAAA,GAA0C,SAAA,EAC1C,OAAe,IAAA,MACM;AAAA,IACrB,IAAA,EAAM,OAAA;AAAA,IACN,KAAA,EAAO,EAAE,KAAA,EAAO,OAAA,EAAS,IAAA;AAAK,GAChC,CAAA;AAAA,EACA,OAAO,CACL,GAAA,EACA,GAAA,EACA,IAAA,GAAe,MACf,OAAA,MACqB;AAAA,IACrB,IAAA,EAAM,OAAA;AAAA,IACN,KAAA,EAAO,EAAE,GAAA,EAAK,GAAA,EAAK,MAAM,OAAA;AAAQ,GACnC,CAAA;AAAA,EACA,KAAA,EAAO,CACL,GAAA,EACA,KAAA,MACqB;AAAA,IACrB,IAAA,EAAM,OAAA;AAAA,IACN,KAAA,EAAO,EAAE,GAAG,KAAA,EAAO,GAAA;AAAI,GACzB,CAAA;AAAA,EACA,IAAA,EAAM,CACJ,IAAA,EACA,IAAA,GAAe,MACf,KAAA,MACoB;AAAA,IACpB,IAAA,EAAM,MAAA;AAAA,IACN,KAAA,EAAO,EAAE,IAAA,EAAM,IAAA,EAAM,KAAA;AAAM,GAC7B,CAAA;AAAA,EACA,KAAA,EAAO,CAAC,KAAA,MAAiD;AAAA,IACvD,IAAA,EAAM,OAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,IAAA,EAAM,CAAC,QAAA,MAA6C;AAAA,IAClD,IAAA,EAAM,MAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,QAAA,EAAU,CACR,KAAA,KACuB;AACvB,IAAA,MAAM,EAAE,QAAA,EAAU,GAAG,IAAA,EAAK,GAAI,KAAA;AAC9B,IAAA,OAAO,EAAE,IAAA,EAAM,UAAA,EAAY,KAAA,EAAO,MAAM,QAAA,EAAS;AAAA,EACnD,CAAA;AAAA,EACA,IAAA,EAAM,CACJ,KAAA,KACmB;AACnB,IAAA,MAAM,EAAE,QAAA,EAAU,GAAG,IAAA,EAAK,GAAI,KAAA;AAC9B,IAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,KAAA,EAAO,MAAM,QAAA,EAAS;AAAA,EAC/C,CAAA;AAAA,EACA,KAAA,EAAO,CAAC,KAAA,MAAiD;AAAA,IACvD,IAAA,EAAM,OAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,QAAA,EAAU,CAAC,KAAA,MAAuD;AAAA,IAChE,IAAA,EAAM,UAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,MAAA,EAAQ,CAAC,KAAA,MAAmD;AAAA,IAC1D,IAAA,EAAM,QAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,QAAA,EAAU,CAAC,KAAA,MAAuD;AAAA,IAChE,IAAA,EAAM,UAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,MAAA,EAAQ,CAAC,KAAA,MAAmD;AAAA,IAC1D,IAAA,EAAM,QAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,UAAA,EAAY,CAAC,KAAA,MAA2D;AAAA,IACtE,IAAA,EAAM,YAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,KAAA,EAAO,CACL,KAAA,EACA,KAAA,MACqB;AAAA,IACrB,IAAA,EAAM,OAAA;AAAA,IACN,KAAA,EAAO,EAAE,GAAG,KAAA,EAAO,KAAA;AAAM,GAC3B,CAAA;AAAA,EACA,WAAA,EAAa,CAAC,KAAA,MAA6D;AAAA,IACzE,IAAA,EAAM,aAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,MAAA,EAAQ,CAAC,KAAA,MAAmD;AAAA,IAC1D,IAAA,EAAM,QAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,MAAA,EAAQ,CAAC,KAAA,MAAmD;AAAA,IAC1D,IAAA,EAAM,QAAA;AAAA,IACN;AAAA,GACF,CAAA;AAAA,EACA,OAAA,EAAS;AAAA,IACP,QAAA,EAAU,CAAC,GAAA,MAAwB;AAAA,MACjC,IAAA,EAAM,iBAAA;AAAA,MACN,IAAA,EAAM,EAAE,GAAA;AAAI,KACd,CAAA;AAAA,IACA,OAAA,EAAS,CAAC,GAAA,EAAa,MAAA,GAAS,QAAA,MAAqB;AAAA,MACnD,IAAA,EAAM,iBAAA;AAAA,MACN,IAAA,EAAM,EAAE,GAAA,EAAK,MAAA;AAAO,KACtB,CAAA;AAAA,IACA,IAAA,EAAM,CAAC,IAAA,MAAyB,EAAE,MAAM,aAAA,EAAe,IAAA,EAAM,EAAE,IAAA,EAAK,EAAE,CAAA;AAAA,IACtE,KAAA,EAAO,OAAc,EAAE,IAAA,EAAM,cAAA,EAAe,CAAA;AAAA,IAC5C,eAAA,EAAiB,CAAC,QAAA,MAA4B;AAAA,MAC5C,IAAA,EAAM,yBAAA;AAAA,MACN,IAAA,EAAM,EAAE,QAAA;AAAS,KACnB;AAAA;AAEJ;;;AC7VA,SAAS,QAAQ,GAAA,EAAwB;AACvC,EAAA,OAAO,OAAO,OAAO,GAAA,KAAQ,QAAA,IAAY,OAAO,IAAI,IAAA,KAAS,QAAA;AAC/D;AAMO,IAAM,UAAN,MAA4B;AAAA,EAGjC,YAAY,MAAA,EAAwB;AAClC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA,EAEA,OAAc,IAAI,KAAA,EAAqC;AACrD,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,IAAS,UAAA,EAAW;AAExC,IAAA,MAAM,OAAA,GAAkC;AAAA,MACtC,KAAA,EAAQ,KAAA,CAAM,KAAA,IAAS,EAAC;AAAA,MACxB,KAAA;AAAA,MACA,SAAA,EAAW,CAAA;AAAA,MACX,OAAA,EAAS,KAAK,MAAA,CAAO,OAAA;AAAA,MACrB,EAAA;AAAA,MACA,OAAA,EAAS,CAACA,MAAAA,KAAkB;AAC1B,QAAA,MAAMA,MAAAA,IAAS,EAAE,IAAA,EAAM,eAAA,EAAgB;AAAA,MACzC;AAAA,KACF;AAEA,IAAA,IAAI;AACF,MAAA,IAAI,UAAA,GAAgC,KAAA,CAAA;AAGpC,MAAA,KAAA,MAAWC,OAAAA,IAAU,IAAA,CAAK,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG;AAC9C,QAAA,IAAIA,QAAO,WAAA,EAAa;AACtB,UAAA,MAAM,MAAA,GAAS,OAAO,IAAA,CAAK,QAAA;AAAA,YACzBA,OAAAA,CAAO,WAAA,CAAY,EAAE,KAAA,IAAS,OAAO,CAAA;AAAA,YACrC;AAAA,WACF;AACA,UAAA,IAAI,MAAA,EAAQ;AACV,YAAA,UAAA,GAAa,MAAA;AAAA,UACf;AAAA,QACF;AAAA,MACF;AAGA,MAAA,IAAI,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,WAAA,EAAa;AAClC,QAAA,MAAM,MAAA,GAAS,OAAO,IAAA,CAAK,QAAA;AAAA,UACzB,KAAK,MAAA,CAAO,KAAA,CAAM,YAAY,EAAE,KAAA,IAAS,OAAO,CAAA;AAAA,UAChD;AAAA,SACF;AACA,QAAA,IAAI,MAAA,EAAQ;AACV,UAAA,UAAA,GAAa,MAAA;AAAA,QACf;AAAA,MACF;AAOA,MAAA,IAAI,CAAC,UAAA,IAAc,KAAA,CAAM,UAAA,EAAY;AACnC,QAAA,UAAA,GAAa,KAAA,CAAM,UAAA;AAAA,MACrB;AAEA,MAAA,IAAI,CAAC,UAAA,IAAc,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO;AACpC,QAAA,UAAA,GAAa,OAAO,IAAA,CAAK,eAAA,CAAgB,KAAA,EAAO,OAAO,CAAA;AAAA,MACzD;AAGA,MAAA,OAAO,UAAA,EAAY;AACjB,QAAA,IAAI,OAAA,CAAQ,SAAA,EAAA,KAAgB,IAAA,CAAK,MAAA,CAAO,kBAAkB,EAAA,CAAA,EAAK;AAC7D,UAAA,OAAO,IAAA,CAAK,IAAA;AAAA,YACV,EAAE,IAAA,EAAM,OAAA,EAAS,MAAM,EAAE,OAAA,EAAS,sBAAqB,EAAE;AAAA,YACzD;AAAA,WACF;AACA,UAAA;AAAA,QACF;AAEA,QAAA,MAAM,OAAA,GAAsB,UAAA;AAC5B,QAAA,UAAA,GAAa,KAAA,CAAA;AAGb,QAAA,MAAM,aAAiC,OAAA,CAAQ,MAAA;AAE/C,QAAA,IAAI,CAAC,UAAA,EAAY;AACf,UAAA,OAAO,IAAA,CAAK,IAAA;AAAA,YACV;AAAA,cACE,IAAA,EAAM,OAAA;AAAA,cACN,IAAA,EAAM,EAAE,OAAA,EAAS,uCAAA;AAAwC,aAC3D;AAAA,YACA;AAAA,WACF;AACA,UAAA;AAAA,QACF;AAEA,QAAA,MAAMC,OAAAA,GAA8B,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA;AAElE,QAAA,IAAI,CAACA,OAAAA,EAAQ;AACX,UAAA,OAAO,IAAA,CAAK,IAAA;AAAA,YACV;AAAA,cACE,IAAA,EAAM,OAAA;AAAA,cACN,IAAA,EAAM,EAAE,OAAA,EAAS,CAAA,OAAA,EAAU,UAAU,CAAA,UAAA,CAAA;AAAa,aACpD;AAAA,YACA;AAAA,WACF;AACA,UAAA;AAAA,QACF;AAGA,QAAA,MAAM,SAAS,OAAO,IAAA,CAAK,aAAA,CAAcA,OAAAA,EAAQ,SAAS,OAAO,CAAA;AAGjE,QAAA,IAAI,IAAA,CAAK,OAAO,KAAA,EAAO;AAGrB,UAAA,UAAA,GAAa,OAAO,IAAA,CAAK,eAAA;AAAA,YACvB;AAAA,cACE,IAAA,EAAM,eAAA;AAAA,cACN,IAAA,EAAM;AAAA,gBACJ,GAAG,OAAA;AAAA;AAAA,gBACH,MAAA,EAAQ,UAAA;AAAA,gBACR;AAAA;AACF,aACF;AAAA,YACA;AAAA,WACF;AAAA,QACF,CAAA,MAAO;AAEL,UAAA,UAAA,GAAa,MAAA;AAAA,QACf;AAAA,MACF;AAGA,MAAA,KAAA,MAAWD,OAAAA,IAAU,IAAA,CAAK,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG;AAC9C,QAAA,IAAIA,QAAO,UAAA,EAAY;AACrB,UAAA,OAAO,KAAK,QAAA,CAASA,OAAAA,CAAO,UAAA,CAAW,OAAO,GAAG,OAAO,CAAA;AAAA,QAC1D;AAAA,MACF;AAGA,MAAA,IAAI,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,UAAA,EAAY;AACjC,QAAA,OAAO,IAAA,CAAK,SAAS,IAAA,CAAK,MAAA,CAAO,MAAM,UAAA,CAAW,OAAO,GAAG,OAAO,CAAA;AAAA,MACrE;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,WAAA;AAEJ,MAAA,IAAI,OAAA,CAAQ,KAAK,CAAA,EAAG;AAClB,QAAA,WAAA,GAAc,KAAA;AAAA,MAChB,CAAA,MAAO;AAEL,QAAA,WAAA,GAAc;AAAA,UACZ,IAAA,EAAM,OAAA;AAAA,UACN,IAAA,EAAM;AAAA,YACJ,SAAS,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAAA,YAC9D,KAAA,EAAO,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,KAAA,GAAQ;AAAA;AAChD,SACF;AAAA,MACF;AAEA,MAAA,IAAI,WAAA,EAAa;AACf,QAAA,OAAO,IAAA,CAAK,IAAA,CAAK,WAAA,EAAa,OAAO,CAAA;AAAA,MACvC;AAEA,MAAA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAe,eAAA,CACb,KAAA,EACA,OAAA,EAC0C;AAC1C,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,MAAA,CAAO,KAAA,CAAO,OAAO,OAAO,CAAA;AACnD,IAAA,OAAO,IAAA,EAAM;AACX,MAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,MAAM,UAAU,IAAA,EAAK;AAC7C,MAAA,IAAI,MAAM,OAAO,KAAA;AACjB,MAAA,OAAO,IAAA,CAAK,IAAA,CAAK,KAAA,EAAgB,OAAO,CAAA;AAAA,IAC1C;AAAA,EACF;AAAA,EAEA,OAAe,aAAA,CACbC,OAAAA,EACA,UAAA,EACA,OAAA,EAC0C;AAC1C,IAAA,MAAM,SAAS,UAAA,CAAW,MAAA;AAG1B,IAAA,KAAA,MAAWD,OAAAA,IAAU,IAAA,CAAK,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG;AAC9C,MAAA,IAAIA,QAAO,cAAA,EAAgB;AACzB,QAAA,MAAM,UAAA,GAAa,OAAO,IAAA,CAAK,QAAA;AAAA,UAC7BA,OAAAA,CAAO,eAAe,EAAE,MAAA,EAAAC,SAAQ,MAAA,EAAQ,UAAA,IAAc,OAAO,CAAA;AAAA,UAC7D;AAAA,SACF;AACA,QAAA,IAAI,UAAA,EAAY;AACd,UAAA,UAAA,GAAa,UAAA;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,cAAA,EAAgB;AACrC,MAAA,MAAM,UAAA,GAAa,OAAO,IAAA,CAAK,QAAA;AAAA,QAC7B,IAAA,CAAK,OAAO,KAAA,CAAM,cAAA;AAAA,UAChB,EAAE,MAAA,EAAAA,OAAAA,EAAQ,MAAA,EAAQ,UAAA,EAAW;AAAA,UAC7B;AAAA,SACF;AAAA,QACA;AAAA,OACF;AACA,MAAA,IAAI,UAAA,EAAY;AACd,QAAA,UAAA,GAAa,UAAA;AAAA,MACf;AAAA,IACF;AAEA,IAAA,IAAI;AACF,MAAA,MAAM,SAAA,GAAYA,OAAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,OAAO,CAAA;AAChD,MAAA,IAAI,MAAA;AAEJ,MAAA,OAAO,IAAA,EAAM;AACX,QAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,MAAM,UAAU,IAAA,EAAK;AAC7C,QAAA,IAAI,IAAA,EAAM;AACR,UAAA,MAAA,GAAS,KAAA;AACT,UAAA;AAAA,QACF;AACA,QAAA,OAAO,IAAA,CAAK,IAAA,CAAK,KAAA,EAAgB,OAAO,CAAA;AAAA,MAC1C;AAGA,MAAA,KAAA,MAAWD,OAAAA,IAAU,IAAA,CAAK,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG;AAC9C,QAAA,IAAIA,QAAO,aAAA,EAAe;AACxB,UAAA,MAAM,KAAA,GAAQ,OAAO,IAAA,CAAK,QAAA;AAAA,YACxBA,OAAAA,CAAO,cAAc,EAAE,MAAA,EAAAC,SAAQ,IAAA,EAAM,MAAA,IAAU,OAAO,CAAA;AAAA,YACtD;AAAA,WACF;AACA,UAAA,IAAI,KAAA,EAAO;AACT,YAAA,UAAA,GAAa,KAAA;AAAA,UACf;AAAA,QACF;AAAA,MACF;AAGA,MAAA,IAAI,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,aAAA,EAAe;AACpC,QAAA,MAAM,KAAA,GAAQ,OAAO,IAAA,CAAK,QAAA;AAAA,UACxB,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,aAAA,CAAc,EAAE,QAAAA,OAAAA,EAAQ,IAAA,EAAM,MAAA,EAAO,EAAG,OAAO,CAAA;AAAA,UACjE;AAAA,SACF;AACA,QAAA,IAAI,KAAA,EAAO;AACT,UAAA,UAAA,GAAa,KAAA;AAAA,QACf;AAAA,MACF;AAEA,MAAA,OAAO,MAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,OAAA,CAAQ,KAAK,CAAA,EAAG,MAAM,KAAA;AAE1B,MAAA,MAAM;AAAA,QACJ,IAAA,EAAM,OAAA;AAAA,QACN,IAAA,EAAM;AAAA,UACJ,QAAQA,OAAAA,CAAO,IAAA;AAAA,UACf,SAAS,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAAA,UAC9D,KAAA,EAAO,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,KAAA,GAAQ;AAAA;AAChD,OACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAe,QAAA,CACb,SAAA,EACA,OAAA,EACiC;AACjC,IAAA,IAAI,CAAC,SAAA,EAAW;AAEhB,IAAA,OAAO,IAAA,EAAM;AACX,MAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,MAAM,UAAU,IAAA,EAAK;AAC7C,MAAA,IAAI,MAAM,OAAO,KAAA;AACjB,MAAA,OAAO,IAAA,CAAK,IAAA,CAAK,KAAA,EAAgB,OAAO,CAAA;AAAA,IAC1C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAe,IAAA,CACb,KAAA,EACA,OAAA,EACuB;AACvB,IAAA,MAAM,UAAA,GAAa;AAAA,MACjB,GAAG,KAAA;AAAA,MACH,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,SAAA,EAAW,KAAA,CAAM,SAAA,IAAa,IAAA,CAAK,GAAA,EAAI;AAAA,MACvC,IAAA,EAAM,MAAM,IAAA,IAAQ,WAAA;AAAA,MACpB,OAAO,OAAA,CAAQ;AAAA,KACjB;AAGA,IAAA,MAAM,UAAA;AAGN,IAAA,KAAA,MAAWD,OAAAA,IAAU,IAAA,CAAK,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG;AAC9C,MAAA,IAAIA,QAAO,OAAA,EAAS;AAClB,QAAA,MAAM,SAAA,GAAYA,OAAAA,CAAO,OAAA,CAAQ,UAAA,EAAY,OAAO,CAAA;AACpD,QAAA,WAAA,MAAiB,SAAS,SAAA,EAAW;AACnC,UAAA,MAAM,EAAE,GAAG,KAAA,EAAO,KAAA,EAAO,QAAQ,KAAA,EAAO,SAAA,EAAW,IAAA,CAAK,GAAA,EAAI,EAAE;AAAA,QAChE;AAAA,MACF;AAAA,IACF;AAGA,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,OAAA,EAAS;AAC9B,MAAA,MAAM,YAAY,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,OAAA,CAAQ,YAAY,OAAO,CAAA;AAC/D,MAAA,WAAA,MAAiB,SAAS,SAAA,EAAW;AAEnC,QAAA,MAAM,EAAE,GAAG,KAAA,EAAO,KAAA,EAAO,QAAQ,KAAA,EAAO,SAAA,EAAW,IAAA,CAAK,GAAA,EAAI,EAAE;AAAA,MAChE;AAAA,IACF;AAAA,EACF;AACF;AAEO,IAAM,MAAA,GAAS,CAAe,MAAA,KAA2B;AAC9D,EAAA,MAAM,OAAA,GAAU,IAAI,OAAA,CAAgB,MAAM,CAAA;AAC1C,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,GAAA,EAAK,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,OAAO;AAAA,GAC/B;AACF;AAKO,IAAM,MAAA,GAAS,CACpB,MAAA,KACsB;AAKjB,IAAM,MAAA,GAAS,CAAe,MAAA,KACnC","file":"chunk-IK3OHUHO.js","sourcesContent":["import z from \"zod\";\n\n// ============================================\n// UI Protocol & Contracts\n// ============================================\n\nexport type UISize = \"sm\" | \"md\" | \"lg\";\nexport type UIAlign = \"start\" | \"center\" | \"end\" | \"stretch\";\nexport type UIJustify = \"start\" | \"center\" | \"end\" | \"between\" | \"around\";\nexport type UIWrap = \"nowrap\" | \"wrap\" | \"wrap-reverse\";\nexport type UIOrientation = \"horizontal\" | \"vertical\";\n\nexport type UIColor =\n  | \"primary\"\n  | \"secondary\"\n  | \"success\"\n  | \"danger\"\n  | \"warning\"\n  | \"info\"\n  | \"background\"\n  | \"foreground\"\n  | \"muted\"\n  | \"mutedForeground\"\n  | \"border\";\n\nexport type UISpacing = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"xxl\";\n\n/**\n * UI Component Contracts\n * This acts as the source of truth for the SDUI protocol.\n */\nexport interface UIContract {\n  card: {\n    title?: string;\n    subtitle?: string;\n    background?: string;\n    isLoading?: boolean;\n  };\n  row: {\n    align?: UIAlign;\n    justify?: UIJustify;\n    wrap?: UIWrap;\n    gap?: UISpacing;\n  };\n  col: {\n    align?: UIAlign;\n    justify?: UIJustify;\n    gap?: UISpacing;\n    width?: string | number;\n    height?: string | number;\n    padding?: UISpacing;\n  };\n  box: {\n    padding?: UISpacing;\n    margin?: string | number;\n    background?: string;\n    border?: boolean;\n    borderRadius?: UISpacing;\n    width?: string | number;\n    height?: string | number;\n  };\n  spacer: {\n    size?: UISpacing;\n    direction?: UIOrientation;\n  };\n  divider: {\n    orientation?: UIOrientation;\n    color?: UIColor;\n  };\n  text: {\n    value: string;\n    size?: UISpacing;\n    weight?: \"normal\" | \"medium\" | \"semibold\" | \"bold\";\n    color?: UIColor;\n    align?: UIAlign;\n  };\n  heading: {\n    value: string;\n    level?: 1 | 2 | 3 | 4 | 5 | 6;\n  };\n  badge: {\n    label: string;\n    variant?: \"primary\" | \"secondary\" | \"success\" | \"danger\" | \"warning\";\n    size?: UISize;\n  };\n  image: {\n    src: string;\n    alt?: string;\n    size?: UISize;\n    groupId?: string;\n  };\n  video: {\n    src: string;\n    poster?: string;\n    autoPlay?: boolean;\n    controls?: boolean;\n    loop?: boolean;\n    muted?: boolean;\n    aspectRatio?: \"16/9\" | \"4/3\" | \"1/1\" | \"9/16\";\n    width?: string | number;\n  };\n  icon: {\n    name: string;\n    size?: UISize;\n    color?: UIColor;\n  };\n  chart: {\n    data: Array<{ label: string; value: number; color?: string }>;\n    chartType?: \"bar\" | \"line\" | \"area\" | \"pie\";\n    title?: string;\n  };\n  list: {};\n  listItem: {\n    onClickAction?: Event;\n    gap?: UISpacing;\n  };\n  form: {\n    onSubmitAction?: Event | ((data: any) => Event);\n  };\n  input: {\n    name: string;\n    label?: string;\n    placeholder?: string;\n    defaultValue?: string;\n    inputType?: string;\n    onChangeAction?: Event;\n  };\n  textarea: {\n    name: string;\n    label?: string;\n    placeholder?: string;\n    defaultValue?: string;\n    rows?: number;\n    onChangeAction?: Event;\n  };\n  select: {\n    name: string;\n    label?: string;\n    options: Array<{ label: string; value: string }>;\n    defaultValue?: string;\n    placeholder?: string;\n    onChangeAction?: Event;\n  };\n  checkbox: {\n    name: string;\n    label?: string;\n    checked?: boolean;\n    onChangeAction?: Event;\n  };\n  hidden: {\n    name: string;\n    value: string;\n  };\n  radioGroup: {\n    name: string;\n    options: Array<{ label: string; value: string; disabled?: boolean }>;\n    label?: string;\n    defaultValue?: string;\n    orientation?: UIOrientation;\n    onChangeAction?: Event;\n  };\n  label: {\n    value: string;\n    htmlFor?: string;\n    required?: boolean;\n  };\n  colorPicker: {\n    name: string;\n    label?: string;\n    defaultValue?: string;\n    onChangeAction?: Event;\n  };\n  upload: {\n    label?: string;\n    multiple?: boolean;\n    accept?: string;\n    initialFiles?: { name: string; url: string }[];\n    onUploadAction?: Event | ((data: any) => Event);\n    mode?: \"append\" | \"replace\";\n  };\n  button: {\n    type?: string;\n    label: string;\n    variant?:\n      | \"primary\"\n      | \"secondary\"\n      | \"success\"\n      | \"danger\"\n      | \"outline\"\n      | \"ghost\"\n      | \"link\";\n    size?: UISize;\n    disabled?: boolean;\n    onClickAction?: Event;\n  };\n}\n\nexport type UINode<T extends keyof UIContract = keyof UIContract> = {\n  type: T;\n  props?: UIContract[T];\n  children?: UINode<any>[];\n};\n\n/**\n * UI Builder for SDUI.\n * Typed using the UIContract source of truth.\n */\nexport const ui = {\n  card: (\n    props: UIContract[\"card\"] & { children?: UINode<any>[] }\n  ): UINode<\"card\"> => {\n    const { children, ...rest } = props;\n    return { type: \"card\", props: rest, children };\n  },\n  row: (\n    props: UIContract[\"row\"] & { children?: UINode<any>[] }\n  ): UINode<\"row\"> => {\n    const { children, ...rest } = props;\n    return { type: \"row\", props: rest, children };\n  },\n  col: (\n    props: UIContract[\"col\"] & { children?: UINode<any>[] }\n  ): UINode<\"col\"> => {\n    const { children, ...rest } = props;\n    return { type: \"col\", props: rest, children };\n  },\n  box: (\n    props: UIContract[\"box\"] & { children?: UINode<any>[] }\n  ): UINode<\"box\"> => {\n    const { children, ...rest } = props;\n    return { type: \"box\", props: rest, children };\n  },\n  spacer: (props: UIContract[\"spacer\"]): UINode<\"spacer\"> => ({\n    type: \"spacer\",\n    props,\n  }),\n  divider: (props: UIContract[\"divider\"]): UINode<\"divider\"> => ({\n    type: \"divider\",\n    props,\n  }),\n  text: (\n    value: string,\n    props?: Omit<UIContract[\"text\"], \"value\">\n  ): UINode<\"text\"> => ({\n    type: \"text\",\n    props: { ...props, value },\n  }),\n  heading: (\n    value: string,\n    level: UIContract[\"heading\"][\"level\"] = 1\n  ): UINode<\"heading\"> => ({\n    type: \"heading\",\n    props: { value, level },\n  }),\n  badge: (\n    label: string,\n    variant: UIContract[\"badge\"][\"variant\"] = \"primary\",\n    size: UISize = \"md\"\n  ): UINode<\"badge\"> => ({\n    type: \"badge\",\n    props: { label, variant, size },\n  }),\n  image: (\n    src: string,\n    alt?: string,\n    size: UISize = \"md\",\n    groupId?: string\n  ): UINode<\"image\"> => ({\n    type: \"image\",\n    props: { src, alt, size, groupId },\n  }),\n  video: (\n    src: string,\n    props?: Omit<UIContract[\"video\"], \"src\">\n  ): UINode<\"video\"> => ({\n    type: \"video\",\n    props: { ...props, src },\n  }),\n  icon: (\n    name: string,\n    size: UISize = \"md\",\n    color?: UIColor\n  ): UINode<\"icon\"> => ({\n    type: \"icon\",\n    props: { name, size, color },\n  }),\n  chart: (props: UIContract[\"chart\"]): UINode<\"chart\"> => ({\n    type: \"chart\",\n    props,\n  }),\n  list: (children: UINode<any>[]): UINode<\"list\"> => ({\n    type: \"list\",\n    children,\n  }),\n  listItem: (\n    props: UIContract[\"listItem\"] & { children: UINode<any>[] }\n  ): UINode<\"listItem\"> => {\n    const { children, ...rest } = props;\n    return { type: \"listItem\", props: rest, children };\n  },\n  form: (\n    props: UIContract[\"form\"] & { children?: UINode<any>[] }\n  ): UINode<\"form\"> => {\n    const { children, ...rest } = props;\n    return { type: \"form\", props: rest, children };\n  },\n  input: (props: UIContract[\"input\"]): UINode<\"input\"> => ({\n    type: \"input\",\n    props,\n  }),\n  textarea: (props: UIContract[\"textarea\"]): UINode<\"textarea\"> => ({\n    type: \"textarea\",\n    props,\n  }),\n  select: (props: UIContract[\"select\"]): UINode<\"select\"> => ({\n    type: \"select\",\n    props,\n  }),\n  checkbox: (props: UIContract[\"checkbox\"]): UINode<\"checkbox\"> => ({\n    type: \"checkbox\",\n    props,\n  }),\n  hidden: (props: UIContract[\"hidden\"]): UINode<\"hidden\"> => ({\n    type: \"hidden\",\n    props,\n  }),\n  radioGroup: (props: UIContract[\"radioGroup\"]): UINode<\"radioGroup\"> => ({\n    type: \"radioGroup\",\n    props,\n  }),\n  label: (\n    value: string,\n    props?: Omit<UIContract[\"label\"], \"value\">\n  ): UINode<\"label\"> => ({\n    type: \"label\",\n    props: { ...props, value },\n  }),\n  colorPicker: (props: UIContract[\"colorPicker\"]): UINode<\"colorPicker\"> => ({\n    type: \"colorPicker\",\n    props,\n  }),\n  upload: (props: UIContract[\"upload\"]): UINode<\"upload\"> => ({\n    type: \"upload\",\n    props,\n  }),\n  button: (props: UIContract[\"button\"]): UINode<\"button\"> => ({\n    type: \"button\",\n    props,\n  }),\n  actions: {\n    navigate: (url: string): Event => ({\n      type: \"client:navigate\",\n      data: { url },\n    }),\n    openUrl: (url: string, target = \"_blank\"): Event => ({\n      type: \"client:open-url\",\n      data: { url, target },\n    }),\n    copy: (text: string): Event => ({ type: \"client:copy\", data: { text } }),\n    reset: (): Event => ({ type: \"client:reset\" }),\n    invalidateQuery: (queryKey: any[]): Event => ({\n      type: \"client:invalidate-query\",\n      data: { queryKey },\n    }),\n  },\n};\n\n// ============================================\n// Events\n// ============================================\n\nexport type Role = \"user\" | \"assistant\" | \"system\";\n\nexport type Event = {\n  type: string;\n  data?: any;\n  ui?: UINode;\n  slot?: string;\n  runId?: string;\n  threadId?: string;\n  threadTitle?: string;\n  timestamp?: number;\n  role?: Role;\n  state?: any;\n  /**\n   * Optional next action to execute immediately.\n   * If provided, the runtime will skip the initial brain dispatch.\n   */\n  nextAction?: NextAction;\n};\n\nexport interface Message {\n  role: Role;\n  content: Event[];\n  runId?: string;\n  threadId?: string;\n}\n\n// ============================================\n// Runtime & Hooks\n// ============================================\n\nexport type ActionExecute<\n  TParams extends z.ZodSchema = z.ZodSchema,\n  TState = any,\n> = (\n  params: z.infer<TParams>,\n  context: RuntimeContext<TState>\n) => AsyncGenerator<Event, NextAction | void, unknown>;\n\nexport interface Action<\n  TParams extends z.ZodSchema = z.ZodObject<any>,\n  TState = any,\n> {\n  name: string;\n  description?: string;\n  paramsSchema: TParams;\n  execute: ActionExecute<TParams, TState>;\n}\n\nexport interface NextAction {\n  action?: string;\n  params?: any;\n  description?: string;\n  [key: string]: any; // Allow metadata like toolCallId\n}\n\nexport interface RuntimeContext<TState = any> {\n  state: TState;\n  runId: string;\n  stepCount: number;\n  actions: Record<string, Action<any, TState>>;\n  ui: typeof ui;\n\n  /**\n   * Immediately interrupts the runtime execution.\n   * If an event is provided, it will be emitted before the runtime stops.\n   */\n  suspend: (event?: Event) => never;\n}\n\n/**\n * Standardized Hook Result.\n * Now a generator to allow yielding multiple events and returning a result.\n */\nexport type HookGenerator<TReturn = void> = AsyncGenerator<\n  Event,\n  TReturn | void,\n  unknown\n>;\n\nexport interface Hooks<TState = any> {\n  /**\n   * Called when a run session begins.\n   * Can yield Events to be emitted, and return a NextAction to jump-start the loop.\n   */\n  onBeforeRun?: (\n    input: { event: Event },\n    context: RuntimeContext<TState>\n  ) => HookGenerator<NextAction>;\n\n  /**\n   * Called when a run session completes.\n   */\n  onAfterRun?: (context: RuntimeContext<TState>) => HookGenerator;\n\n  /**\n   * Called whenever an event is yielded by the runtime.\n   */\n  onEvent?: (event: Event, context: RuntimeContext<TState>) => HookGenerator;\n\n  /**\n   * Called before an action is executed.\n   * Yield events to intercept, and return a NextAction to redirect/suspend.\n   */\n  onBeforeAction?: (\n    call: { action: Action<any, TState>; params: any; nextAction: NextAction },\n    context: RuntimeContext<TState>\n  ) => HookGenerator<NextAction>;\n\n  /**\n   * Called after an action completes.\n   */\n  onAfterAction?: (\n    result: { action: Action<any, TState>; data: NextAction | void },\n    context: RuntimeContext<TState>\n  ) => HookGenerator<NextAction>;\n}\n\n/**\n * A plugin is just a named set of hooks.\n */\nexport interface Plugin<TState = any> extends Hooks<TState> {\n  name: string;\n}\n\nexport type Brain<TState = any> = (\n  event: Event,\n  context: RuntimeContext<TState>\n) => AsyncGenerator<Event, NextAction | void, unknown>;\n\nexport interface Config<TState = any> {\n  actions: Record<string, Action<any, TState>>;\n  /**\n   * The central brain for handling incoming events.\n   */\n  brain?: Brain<TState>;\n  hooks?: Hooks<TState>;\n  plugins?: Plugin<TState>[];\n  safetyMaxSteps?: number;\n  starterPrompts?: Array<{\n    label: string;\n    prompt: string;\n    icon?: string;\n  }>;\n  options?: Array<{\n    id: string;\n    label: string;\n    options: Array<{ id: string; label: string; value: any }>;\n    type?: \"single\" | \"multiple\";\n    defaultSelectedIds?: string[];\n  }>;\n  fileAttachments?: {\n    enabled?: boolean;\n    accept?: string; // e.g., \"image/*,.pdf\" for file input accept attribute\n    maxFiles?: number; // Maximum number of files allowed\n    maxFileSize?: number; // Maximum file size in bytes\n  };\n}\n","import {\n  Action,\n  Event,\n  NextAction,\n  RuntimeContext,\n  Config,\n  Plugin,\n  ui,\n  HookGenerator,\n} from \"./types\";\nimport { generateId } from \"./utils/generate-id\";\nimport { z } from \"zod\";\n\n/**\n * Helper to check if a value is a Melony Event.\n */\nfunction isEvent(val: any): val is Event {\n  return val && typeof val === \"object\" && typeof val.type === \"string\";\n}\n\n/**\n * The Slim Runtime.\n * Single Responsibility: Orchestrate Event -> Action -> Event transitions.\n */\nexport class Runtime<TState = any> {\n  private config: Config<TState>;\n\n  constructor(config: Config<TState>) {\n    this.config = config;\n  }\n\n  public async *run(event: Event): AsyncGenerator<Event> {\n    const runId = event.runId ?? generateId();\n\n    const context: RuntimeContext<TState> = {\n      state: (event.state ?? {}) as TState,\n      runId,\n      stepCount: 0,\n      actions: this.config.actions,\n      ui,\n      suspend: (event?: Event) => {\n        throw event || { type: \"run-suspended\" };\n      },\n    };\n\n    try {\n      let nextAction: NextAction | void = undefined;\n\n      // 1. Trigger Plugins: onBeforeRun\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onBeforeRun) {\n          const result = yield* this.callHook(\n            plugin.onBeforeRun({ event }, context),\n            context\n          );\n          if (result) {\n            nextAction = result as NextAction;\n          }\n        }\n      }\n\n      // 2. Trigger Hook: onBeforeRun\n      if (this.config.hooks?.onBeforeRun) {\n        const result = yield* this.callHook(\n          this.config.hooks.onBeforeRun({ event }, context),\n          context\n        );\n        if (result) {\n          nextAction = result as NextAction;\n        }\n      }\n\n      // Initial dispatch of the incoming event to the agent's brain\n      // Priority:\n      // 1. nextAction already set by onBeforeRun hooks\n      // 2. nextAction provided in the event itself\n      // 3. Dispatch to brain to decide nextAction\n      if (!nextAction && event.nextAction) {\n        nextAction = event.nextAction;\n      }\n\n      if (!nextAction && this.config.brain) {\n        nextAction = yield* this.dispatchToBrain(event, context);\n      }\n\n      // Agentic loop\n      while (nextAction) {\n        if (context.stepCount++ >= (this.config.safetyMaxSteps ?? 10)) {\n          yield* this.emit(\n            { type: \"error\", data: { message: \"Max steps exceeded\" } },\n            context\n          );\n          break;\n        }\n\n        const current: NextAction = nextAction;\n        nextAction = undefined; // Reset\n\n        // 1. Resolve Action\n        const actionName: string | undefined = current.action;\n\n        if (!actionName) {\n          yield* this.emit(\n            {\n              type: \"error\",\n              data: { message: \"No action name provided in NextAction\" },\n            },\n            context\n          );\n          break;\n        }\n\n        const action: Action<any, TState> = this.config.actions[actionName];\n\n        if (!action) {\n          yield* this.emit(\n            {\n              type: \"error\",\n              data: { message: `Action ${actionName} not found` },\n            },\n            context\n          );\n          break;\n        }\n\n        // 2. Execute Action\n        const result = yield* this.executeAction(action, current, context);\n\n        // 3. Decide Next Step\n        if (this.config.brain) {\n          // If we have a brain, feed the result back to it to decide what to do next.\n          // This keeps the brain in the loop for multi-step reasoning.\n          nextAction = yield* this.dispatchToBrain(\n            {\n              type: \"action-result\",\n              data: {\n                ...current, // Preserve all metadata (like toolCallId)\n                action: actionName,\n                result,\n              },\n            },\n            context\n          );\n        } else {\n          // Simple mode: follow the action's own suggestion for the next step.\n          nextAction = result;\n        }\n      }\n\n      // 1. Trigger Plugins: onAfterRun\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onAfterRun) {\n          yield* this.callHook(plugin.onAfterRun(context), context);\n        }\n      }\n\n      // 2. Trigger Hook: onAfterRun\n      if (this.config.hooks?.onAfterRun) {\n        yield* this.callHook(this.config.hooks.onAfterRun(context), context);\n      }\n    } catch (error) {\n      let eventToEmit: Event | undefined;\n\n      if (isEvent(error)) {\n        eventToEmit = error;\n      } else {\n        // Wrap unexpected errors into an Event\n        eventToEmit = {\n          type: \"error\",\n          data: {\n            message: error instanceof Error ? error.message : String(error),\n            stack: error instanceof Error ? error.stack : undefined,\n          },\n        };\n      }\n\n      if (eventToEmit) {\n        yield* this.emit(eventToEmit, context);\n      }\n\n      return; // Gracefully stop the runtime\n    }\n  }\n\n  private async *dispatchToBrain(\n    event: Event,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event, NextAction | void> {\n    const generator = this.config.brain!(event, context);\n    while (true) {\n      const { value, done } = await generator.next();\n      if (done) return value as NextAction | void;\n      yield* this.emit(value as Event, context);\n    }\n  }\n\n  private async *executeAction(\n    action: Action<any, TState>,\n    nextAction: NextAction,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event, NextAction | void> {\n    const params = nextAction.params;\n\n    // 1. Trigger Plugins: onBeforeAction\n    for (const plugin of this.config.plugins || []) {\n      if (plugin.onBeforeAction) {\n        const hookResult = yield* this.callHook(\n          plugin.onBeforeAction({ action, params, nextAction }, context),\n          context\n        );\n        if (hookResult) {\n          nextAction = hookResult as NextAction;\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onBeforeAction\n    if (this.config.hooks?.onBeforeAction) {\n      const hookResult = yield* this.callHook(\n        this.config.hooks.onBeforeAction(\n          { action, params, nextAction },\n          context\n        ),\n        context\n      );\n      if (hookResult) {\n        nextAction = hookResult as NextAction;\n      }\n    }\n\n    try {\n      const generator = action.execute(params, context);\n      let result: NextAction | void;\n\n      while (true) {\n        const { value, done } = await generator.next();\n        if (done) {\n          result = value as NextAction | void;\n          break;\n        }\n        yield* this.emit(value as Event, context);\n      }\n\n      // 3. Trigger Plugins: onAfterAction\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onAfterAction) {\n          const extra = yield* this.callHook(\n            plugin.onAfterAction({ action, data: result }, context),\n            context\n          );\n          if (extra) {\n            nextAction = extra as NextAction;\n          }\n        }\n      }\n\n      // 4. Trigger Hook: onAfterAction\n      if (this.config.hooks?.onAfterAction) {\n        const extra = yield* this.callHook(\n          this.config.hooks.onAfterAction({ action, data: result }, context),\n          context\n        );\n        if (extra) {\n          nextAction = extra as NextAction;\n        }\n      }\n\n      return result;\n    } catch (error) {\n      if (isEvent(error)) throw error;\n\n      throw {\n        type: \"error\",\n        data: {\n          action: action.name,\n          message: error instanceof Error ? error.message : String(error),\n          stack: error instanceof Error ? error.stack : undefined,\n        },\n      };\n    }\n  }\n\n  /**\n   * Internal helper to call a hook (generator) and yield its events.\n   */\n  private async *callHook<T>(\n    generator: HookGenerator<T> | undefined,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event, T | void> {\n    if (!generator) return;\n\n    while (true) {\n      const { value, done } = await generator.next();\n      if (done) return value as T | void;\n      yield* this.emit(value as Event, context);\n    }\n  }\n\n  /**\n   * Internal helper to yield an event and trigger the onEvent hook.\n   */\n  private async *emit(\n    event: Event,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event> {\n    const finalEvent = {\n      ...event,\n      runId: context.runId,\n      timestamp: event.timestamp ?? Date.now(),\n      role: event.role ?? \"assistant\",\n      state: context.state,\n    };\n\n    // Yield the actual event first\n    yield finalEvent;\n\n    // 1. Trigger Plugins: onEvent\n    for (const plugin of this.config.plugins || []) {\n      if (plugin.onEvent) {\n        const generator = plugin.onEvent(finalEvent, context);\n        for await (const extra of generator) {\n          yield { ...extra, runId: context.runId, timestamp: Date.now() };\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onEvent for side-effects or extra events\n    if (this.config.hooks?.onEvent) {\n      const generator = this.config.hooks.onEvent(finalEvent, context);\n      for await (const extra of generator) {\n        // Yield extra event from hook, ensuring it has required metadata\n        yield { ...extra, runId: context.runId, timestamp: Date.now() };\n      }\n    }\n  }\n}\n\nexport const melony = <TState = any>(config: Config<TState>) => {\n  const runtime = new Runtime<TState>(config);\n  return {\n    config,\n    run: runtime.run.bind(runtime),\n  };\n};\n\n/**\n * Helper to define an action with full type inference.\n */\nexport const action = <T extends z.ZodSchema, TState = any>(\n  config: Action<T, TState>\n): Action<T, TState> => config;\n\n/**\n * Helper to define a plugin.\n */\nexport const plugin = <TState = any>(config: Plugin<TState>): Plugin<TState> =>\n  config;\n"]}