melony 0.1.54 → 0.1.55

package/dist/chunk-N2OIHGFV.js

@@ -0,0 +1,138 @@
+// src/ui.ts
+var ui = {
+  card: (props) => {
+    const { children, ...rest } = props;
+    return { type: "card", props: rest, children };
+  },
+  row: (props) => {
+    const { children, ...rest } = props;
+    return { type: "row", props: rest, children };
+  },
+  col: (props) => {
+    const { children, ...rest } = props;
+    return { type: "col", props: rest, children };
+  },
+  box: (props) => {
+    const { children, ...rest } = props;
+    return { type: "box", props: rest, children };
+  },
+  spacer: (props) => ({
+    type: "spacer",
+    props
+  }),
+  divider: (props) => ({
+    type: "divider",
+    props
+  }),
+  text: (value, props) => ({
+    type: "text",
+    props: { ...props, value }
+  }),
+  heading: (value, level = 1, props) => ({
+    type: "heading",
+    props: { ...props, value, level }
+  }),
+  badge: (label, variant = "primary", size = "md") => ({
+    type: "badge",
+    props: { label, variant, size }
+  }),
+  image: (src, props) => ({
+    type: "image",
+    props: { ...props, src }
+  }),
+  video: (src, props) => ({
+    type: "video",
+    props: { ...props, src }
+  }),
+  icon: (name, size = "md", color) => ({
+    type: "icon",
+    props: { name, size, color }
+  }),
+  chart: (props) => ({
+    type: "chart",
+    props
+  }),
+  list: (props) => {
+    const { children, ...rest } = props;
+    return { type: "list", props: rest, children };
+  },
+  listItem: (props) => {
+    const { children, ...rest } = props;
+    return { type: "listItem", props: rest, children };
+  },
+  form: (props) => {
+    const { children, ...rest } = props;
+    return { type: "form", props: rest, children };
+  },
+  input: (props) => ({
+    type: "input",
+    props
+  }),
+  textarea: (props) => ({
+    type: "textarea",
+    props
+  }),
+  select: (props) => ({
+    type: "select",
+    props
+  }),
+  checkbox: (props) => ({
+    type: "checkbox",
+    props
+  }),
+  hidden: (props) => ({
+    type: "hidden",
+    props
+  }),
+  radioGroup: (props) => ({
+    type: "radioGroup",
+    props
+  }),
+  label: (value, props) => ({
+    type: "label",
+    props: { ...props, value }
+  }),
+  colorPicker: (props) => ({
+    type: "colorPicker",
+    props
+  }),
+  upload: (props) => ({
+    type: "upload",
+    props
+  }),
+  button: (props) => ({
+    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",
+      data: { url }
+    }),
+    openUrl: (url, target = "_blank") => ({
+      type: "client:open-url",
+      data: { url, target }
+    }),
+    copy: (text) => ({ type: "client:copy", data: { text } }),
+    reset: () => ({ type: "client:reset" }),
+    invalidateQuery: (queryKey) => ({
+      type: "client:invalidate-query",
+      data: { queryKey }
+    })
+  }
+};
+
+// src/plugin.ts
+var plugin = (config) => config;
+
+export { plugin, ui };
+//# sourceMappingURL=chunk-N2OIHGFV.js.map
+//# sourceMappingURL=chunk-N2OIHGFV.js.map

package/dist/chunk-N2OIHGFV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ui.ts","../src/plugin.ts"],"names":[],"mappings":"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","file":"chunk-N2OIHGFV.js","sourcesContent":["import {\n  UIColor,\n  UIContract,\n  UINode,\n  UISize,\n  Event,\n  UISpacing,\n  UIWidth,\n  UIRadius,\n} 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: (\n    props: UIContract[\"list\"] & { children: UINode<any>[] },\n  ): 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 { Plugin } from \"./types\";\n\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-CNb-HLkM.js';
+import { E as Event, C as Config } from './types-CE5iiNir.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-CNb-HLkM.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-CNb-HLkM.js';
+import { C as Config, E as Event, A as Action, B as Brain, P as Plugin, M as Message } from './types-CE5iiNir.js';
+export { l as ActionExecute, 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-CE5iiNir.js';
 import { z } from 'zod';
 export { g as generateId } from './generate-id-DU8kwYc2.js';
 
@@ -22,14 +22,28 @@ declare class Runtime<TState = any> {
      */
     private emit;
 }
+
 declare const melony: <TState = any>(config: Config<TState>) => {
     config: Config<TState>;
     run: (event: Event) => AsyncGenerator<Event>;
 };
+
 /**
  * Helper to define an action with full type inference.
  */
 declare const action: <T extends z.ZodSchema, TState = any>(config: Action<T, TState>) => Action<T, TState>;
+
+/**
+ * A Cortex is a collection of Brain Regions (Lobes).
+ * It delegates events to the appropriate region and coordinates the agentic loop.
+ */
+declare function cortex<TState = any>(regions: Record<string, Brain<TState>>): Brain<TState>;
+/**
+ * Helper to define a lobe with full type inference.
+ * Lobes are just Brain functions but named for clarity in the biological theme.
+ */
+declare const lobe: <TState = any>(brain: Brain<TState>) => Brain<TState>;
+
 /**
  * Helper to define a plugin.
  */
@@ -50,4 +64,4 @@ declare function convertEventsToMessages(events: Event[]): Message[];
  */
 declare function filterEventsBySlots(events: Event[]): Event[];
 
-export { Action, Config, Event, Message, Plugin, Runtime, action, convertEventsToMessages, createStreamResponse, filterEventsBySlots, melony, plugin };
+export { Action, Brain, Config, Event, Message, Plugin, Runtime, action, convertEventsToMessages, cortex, createStreamResponse, filterEventsBySlots, lobe, melony, plugin };

package/dist/index.js

@@ -1,6 +1,284 @@
-export { createStreamResponse } from './chunk-PDXLHPTX.js';
-export { Runtime, action, melony, plugin, ui } from './chunk-EGZ4YTE4.js';
+import { generateId } from './chunk-WAI5H335.js';
 export { generateId } from './chunk-WAI5H335.js';
+export { createStreamResponse } from './chunk-PDXLHPTX.js';
+import { ui } from './chunk-N2OIHGFV.js';
+export { plugin, ui } from './chunk-N2OIHGFV.js';
+
+// src/runtime.ts
+function isEvent(val) {
+  return val && typeof val === "object" && typeof val.type === "string";
+}
+var Runtime = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async *run(event) {
+    const runId = event.runId ?? generateId();
+    const context = {
+      state: event.state ?? {},
+      runId,
+      stepCount: 0,
+      actions: this.config.actions,
+      ui,
+      suspend: (event2) => {
+        throw event2 || { type: "run-suspended" };
+      }
+    };
+    try {
+      let nextAction = void 0;
+      for (const plugin2 of this.config.plugins || []) {
+        if (plugin2.onBeforeRun) {
+          const result = yield* this.callHook(
+            plugin2.onBeforeRun({ event }, context),
+            context
+          );
+          if (result) {
+            nextAction = result;
+          }
+        }
+      }
+      if (this.config.hooks?.onBeforeRun) {
+        const result = yield* this.callHook(
+          this.config.hooks.onBeforeRun({ event }, context),
+          context
+        );
+        if (result) {
+          nextAction = result;
+        }
+      }
+      if (!nextAction && event.nextAction) {
+        nextAction = event.nextAction;
+      }
+      if (!nextAction && this.config.brain) {
+        nextAction = yield* this.dispatchToBrain(event, context);
+      }
+      while (nextAction) {
+        if (context.stepCount++ >= (this.config.safetyMaxSteps ?? 10)) {
+          yield* this.emit(
+            { type: "error", data: { message: "Max steps exceeded" } },
+            context
+          );
+          break;
+        }
+        const current = nextAction;
+        nextAction = void 0;
+        const actionName = current.action;
+        if (!actionName) {
+          yield* this.emit(
+            {
+              type: "error",
+              data: { message: "No action name provided in NextAction" }
+            },
+            context
+          );
+          break;
+        }
+        const action2 = this.config.actions[actionName];
+        if (!action2) {
+          yield* this.emit(
+            {
+              type: "error",
+              data: { message: `Action ${actionName} not found` }
+            },
+            context
+          );
+          break;
+        }
+        const result = yield* this.executeAction(action2, current, context);
+        if (this.config.brain) {
+          nextAction = yield* this.dispatchToBrain(
+            {
+              type: "action-result",
+              data: {
+                ...current,
+                // Preserve all metadata (like toolCallId)
+                action: actionName,
+                result
+              }
+            },
+            context
+          );
+        } else {
+          nextAction = result;
+        }
+      }
+      for (const plugin2 of this.config.plugins || []) {
+        if (plugin2.onAfterRun) {
+          yield* this.callHook(plugin2.onAfterRun(context), context);
+        }
+      }
+      if (this.config.hooks?.onAfterRun) {
+        yield* this.callHook(this.config.hooks.onAfterRun(context), context);
+      }
+    } catch (error) {
+      let eventToEmit;
+      if (isEvent(error)) {
+        eventToEmit = error;
+      } else {
+        eventToEmit = {
+          type: "error",
+          data: {
+            message: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : void 0
+          }
+        };
+      }
+      if (eventToEmit) {
+        yield* this.emit(eventToEmit, context);
+      }
+      return;
+    }
+  }
+  async *dispatchToBrain(event, context) {
+    const generator = this.config.brain(event, context);
+    while (true) {
+      const { value, done } = await generator.next();
+      if (done) return value;
+      yield* this.emit(value, context);
+    }
+  }
+  async *executeAction(action2, nextAction, context) {
+    const params = nextAction.params;
+    for (const plugin2 of this.config.plugins || []) {
+      if (plugin2.onBeforeAction) {
+        const hookResult = yield* this.callHook(
+          plugin2.onBeforeAction({ action: action2, params, nextAction }, context),
+          context
+        );
+        if (hookResult) {
+          nextAction = hookResult;
+        }
+      }
+    }
+    if (this.config.hooks?.onBeforeAction) {
+      const hookResult = yield* this.callHook(
+        this.config.hooks.onBeforeAction(
+          { action: action2, params, nextAction },
+          context
+        ),
+        context
+      );
+      if (hookResult) {
+        nextAction = hookResult;
+      }
+    }
+    try {
+      const generator = action2.execute(params, context);
+      let result;
+      while (true) {
+        const { value, done } = await generator.next();
+        if (done) {
+          result = value;
+          break;
+        }
+        yield* this.emit(value, context);
+      }
+      for (const plugin2 of this.config.plugins || []) {
+        if (plugin2.onAfterAction) {
+          const extra = yield* this.callHook(
+            plugin2.onAfterAction({ action: action2, data: result }, context),
+            context
+          );
+          if (extra) {
+            nextAction = extra;
+          }
+        }
+      }
+      if (this.config.hooks?.onAfterAction) {
+        const extra = yield* this.callHook(
+          this.config.hooks.onAfterAction({ action: action2, data: result }, context),
+          context
+        );
+        if (extra) {
+          nextAction = extra;
+        }
+      }
+      return result;
+    } catch (error) {
+      if (isEvent(error)) throw error;
+      throw {
+        type: "error",
+        data: {
+          action: action2.name,
+          message: error instanceof Error ? error.message : String(error),
+          stack: error instanceof Error ? error.stack : void 0
+        }
+      };
+    }
+  }
+  /**
+   * Internal helper to call a hook (generator) and yield its events.
+   */
+  async *callHook(generator, context) {
+    if (!generator) return;
+    while (true) {
+      const { value, done } = await generator.next();
+      if (done) return value;
+      yield* this.emit(value, context);
+    }
+  }
+  /**
+   * Internal helper to yield an event and trigger the onEvent hook.
+   */
+  async *emit(event, context) {
+    const finalEvent = {
+      ...event,
+      runId: context.runId,
+      timestamp: event.timestamp ?? Date.now(),
+      role: event.role ?? "assistant",
+      state: context.state
+    };
+    yield finalEvent;
+    for (const plugin2 of this.config.plugins || []) {
+      if (plugin2.onEvent) {
+        const generator = plugin2.onEvent(finalEvent, context);
+        for await (const extra of generator) {
+          yield { ...extra, runId: context.runId, timestamp: Date.now() };
+        }
+      }
+    }
+    if (this.config.hooks?.onEvent) {
+      const generator = this.config.hooks.onEvent(finalEvent, context);
+      for await (const extra of generator) {
+        yield { ...extra, runId: context.runId, timestamp: Date.now() };
+      }
+    }
+  }
+};
+
+// src/melony.ts
+var melony = (config) => {
+  const runtime = new Runtime(config);
+  return {
+    config,
+    run: runtime.run.bind(runtime)
+  };
+};
+
+// src/action.ts
+var action = (config) => config;
+
+// src/cortex.ts
+function cortex(regions) {
+  return async function* (event, context) {
+    for (const [name, region] of Object.entries(regions)) {
+      const generator = region(event, context);
+      while (true) {
+        const { value, done } = await generator.next();
+        if (done) {
+          if (value) return value;
+          break;
+        }
+        yield {
+          ...value,
+          metadata: { ...value.metadata, region: name }
+        };
+      }
+    }
+    return;
+  };
+}
+var lobe = (brain) => brain;
 
 // src/utils/convert-events-to-messages.ts
 function convertEventsToMessages(events) {
@@ -53,6 +331,6 @@ function filterEventsBySlots(events) {
   return result;
 }
 
-export { convertEventsToMessages, filterEventsBySlots };
+export { Runtime, action, convertEventsToMessages, cortex, filterEventsBySlots, lobe, melony };
 //# 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","../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"]}
+{"version":3,"sources":["../src/runtime.ts","../src/melony.ts","../src/action.ts","../src/cortex.ts","../src/utils/convert-events-to-messages.ts","../src/utils/filter-events-by-slots.ts"],"names":["event","plugin","action"],"mappings":"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","file":"index.js","sourcesContent":["import {\n  Action,\n  Event,\n  NextAction,\n  RuntimeContext,\n  Config,\n  HookGenerator,\n} from \"./types\";\nimport { ui } from \"./ui\";\nimport { generateId } from \"./utils/generate-id\";\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}","import { Runtime } from \"./runtime\";\nimport { Config } from \"./types\";\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};","import { z } from 'zod'\nimport { Action } from './types';\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","import { Brain, Event, RuntimeContext } from \"./types\";\n\n/**\n * A Cortex is a collection of Brain Regions (Lobes).\n * It delegates events to the appropriate region and coordinates the agentic loop.\n */\nexport function cortex<TState = any>(\n  regions: Record<string, Brain<TState>>,\n): Brain<TState> {\n  return async function* (event: Event, context: RuntimeContext<TState>) {\n    // We iterate through all regions sequentially.\n    for (const [name, region] of Object.entries(regions)) {\n      const generator = region(event, context);\n\n      while (true) {\n        const { value, done } = await generator.next();\n\n        if (done) {\n          // If a region returns a NextAction, that region has \"taken control\"\n          // of the executive function. We return it to the runtime.\n          if (value) return value;\n          break;\n        }\n\n        // Yield events from the region (text, UI, etc.)\n        // We tag them with the region name in metadata.\n        yield {\n          ...value,\n          metadata: { ...value.metadata, region: name },\n        };\n      }\n    }\n\n    // If no region returns a NextAction, the brain is \"resting.\"\n    return;\n  };\n}\n\n/**\n * Helper to define a lobe with full type inference.\n * Lobes are just Brain functions but named for clarity in the biological theme.\n */\nexport const lobe = <TState = any>(brain: Brain<TState>): Brain<TState> => brain;\n","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, m as RuntimeContext, P as Plugin } from '../types-CNb-HLkM.js';
+import { A as Action, m as RuntimeContext, P as Plugin } from '../types-CE5iiNir.js';
 import 'zod';
 
 interface RequireApprovalOptions {

package/dist/plugins/require-approval.js

@@ -1,5 +1,4 @@
-import { plugin, ui } from '../chunk-EGZ4YTE4.js';
-import '../chunk-WAI5H335.js';
+import { plugin, ui } from '../chunk-N2OIHGFV.js';
 
 // src/plugins/require-approval.ts
 var requireApproval = (options = {}) => {

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 \"../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"]}
+{"version":3,"sources":["../../src/plugins/require-approval.ts"],"names":[],"mappings":"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","file":"require-approval.js","sourcesContent":["import { plugin } from \"../plugin\";\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-CNb-HLkM.d.ts → types-CE5iiNir.d.ts}

@@ -327,6 +327,7 @@ type Event = {
     timestamp?: number;
     role?: Role;
     state?: any;
+    metadata?: Record<string, any>;
     /**
      * Optional next action to execute immediately.
      * If provided, the runtime will skip the initial brain dispatch.

package/package.json

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

package/dist/chunk-EGZ4YTE4.js

@@ -1,388 +0,0 @@
-import { generateId } from './chunk-WAI5H335.js';
-
-// src/ui.ts
-var ui = {
-  card: (props) => {
-    const { children, ...rest } = props;
-    return { type: "card", props: rest, children };
-  },
-  row: (props) => {
-    const { children, ...rest } = props;
-    return { type: "row", props: rest, children };
-  },
-  col: (props) => {
-    const { children, ...rest } = props;
-    return { type: "col", props: rest, children };
-  },
-  box: (props) => {
-    const { children, ...rest } = props;
-    return { type: "box", props: rest, children };
-  },
-  spacer: (props) => ({
-    type: "spacer",
-    props
-  }),
-  divider: (props) => ({
-    type: "divider",
-    props
-  }),
-  text: (value, props) => ({
-    type: "text",
-    props: { ...props, value }
-  }),
-  heading: (value, level = 1, props) => ({
-    type: "heading",
-    props: { ...props, value, level }
-  }),
-  badge: (label, variant = "primary", size = "md") => ({
-    type: "badge",
-    props: { label, variant, size }
-  }),
-  image: (src, props) => ({
-    type: "image",
-    props: { ...props, src }
-  }),
-  video: (src, props) => ({
-    type: "video",
-    props: { ...props, src }
-  }),
-  icon: (name, size = "md", color) => ({
-    type: "icon",
-    props: { name, size, color }
-  }),
-  chart: (props) => ({
-    type: "chart",
-    props
-  }),
-  list: (props) => {
-    const { children, ...rest } = props;
-    return { type: "list", props: rest, children };
-  },
-  listItem: (props) => {
-    const { children, ...rest } = props;
-    return { type: "listItem", props: rest, children };
-  },
-  form: (props) => {
-    const { children, ...rest } = props;
-    return { type: "form", props: rest, children };
-  },
-  input: (props) => ({
-    type: "input",
-    props
-  }),
-  textarea: (props) => ({
-    type: "textarea",
-    props
-  }),
-  select: (props) => ({
-    type: "select",
-    props
-  }),
-  checkbox: (props) => ({
-    type: "checkbox",
-    props
-  }),
-  hidden: (props) => ({
-    type: "hidden",
-    props
-  }),
-  radioGroup: (props) => ({
-    type: "radioGroup",
-    props
-  }),
-  label: (value, props) => ({
-    type: "label",
-    props: { ...props, value }
-  }),
-  colorPicker: (props) => ({
-    type: "colorPicker",
-    props
-  }),
-  upload: (props) => ({
-    type: "upload",
-    props
-  }),
-  button: (props) => ({
-    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",
-      data: { url }
-    }),
-    openUrl: (url, target = "_blank") => ({
-      type: "client:open-url",
-      data: { url, target }
-    }),
-    copy: (text) => ({ type: "client:copy", data: { text } }),
-    reset: () => ({ type: "client:reset" }),
-    invalidateQuery: (queryKey) => ({
-      type: "client:invalidate-query",
-      data: { queryKey }
-    })
-  }
-};
-
-// src/runtime.ts
-function isEvent(val) {
-  return val && typeof val === "object" && typeof val.type === "string";
-}
-var Runtime = class {
-  constructor(config) {
-    this.config = config;
-  }
-  async *run(event) {
-    const runId = event.runId ?? generateId();
-    const context = {
-      state: event.state ?? {},
-      runId,
-      stepCount: 0,
-      actions: this.config.actions,
-      ui,
-      suspend: (event2) => {
-        throw event2 || { type: "run-suspended" };
-      }
-    };
-    try {
-      let nextAction = void 0;
-      for (const plugin2 of this.config.plugins || []) {
-        if (plugin2.onBeforeRun) {
-          const result = yield* this.callHook(
-            plugin2.onBeforeRun({ event }, context),
-            context
-          );
-          if (result) {
-            nextAction = result;
-          }
-        }
-      }
-      if (this.config.hooks?.onBeforeRun) {
-        const result = yield* this.callHook(
-          this.config.hooks.onBeforeRun({ event }, context),
-          context
-        );
-        if (result) {
-          nextAction = result;
-        }
-      }
-      if (!nextAction && event.nextAction) {
-        nextAction = event.nextAction;
-      }
-      if (!nextAction && this.config.brain) {
-        nextAction = yield* this.dispatchToBrain(event, context);
-      }
-      while (nextAction) {
-        if (context.stepCount++ >= (this.config.safetyMaxSteps ?? 10)) {
-          yield* this.emit(
-            { type: "error", data: { message: "Max steps exceeded" } },
-            context
-          );
-          break;
-        }
-        const current = nextAction;
-        nextAction = void 0;
-        const actionName = current.action;
-        if (!actionName) {
-          yield* this.emit(
-            {
-              type: "error",
-              data: { message: "No action name provided in NextAction" }
-            },
-            context
-          );
-          break;
-        }
-        const action2 = this.config.actions[actionName];
-        if (!action2) {
-          yield* this.emit(
-            {
-              type: "error",
-              data: { message: `Action ${actionName} not found` }
-            },
-            context
-          );
-          break;
-        }
-        const result = yield* this.executeAction(action2, current, context);
-        if (this.config.brain) {
-          nextAction = yield* this.dispatchToBrain(
-            {
-              type: "action-result",
-              data: {
-                ...current,
-                // Preserve all metadata (like toolCallId)
-                action: actionName,
-                result
-              }
-            },
-            context
-          );
-        } else {
-          nextAction = result;
-        }
-      }
-      for (const plugin2 of this.config.plugins || []) {
-        if (plugin2.onAfterRun) {
-          yield* this.callHook(plugin2.onAfterRun(context), context);
-        }
-      }
-      if (this.config.hooks?.onAfterRun) {
-        yield* this.callHook(this.config.hooks.onAfterRun(context), context);
-      }
-    } catch (error) {
-      let eventToEmit;
-      if (isEvent(error)) {
-        eventToEmit = error;
-      } else {
-        eventToEmit = {
-          type: "error",
-          data: {
-            message: error instanceof Error ? error.message : String(error),
-            stack: error instanceof Error ? error.stack : void 0
-          }
-        };
-      }
-      if (eventToEmit) {
-        yield* this.emit(eventToEmit, context);
-      }
-      return;
-    }
-  }
-  async *dispatchToBrain(event, context) {
-    const generator = this.config.brain(event, context);
-    while (true) {
-      const { value, done } = await generator.next();
-      if (done) return value;
-      yield* this.emit(value, context);
-    }
-  }
-  async *executeAction(action2, nextAction, context) {
-    const params = nextAction.params;
-    for (const plugin2 of this.config.plugins || []) {
-      if (plugin2.onBeforeAction) {
-        const hookResult = yield* this.callHook(
-          plugin2.onBeforeAction({ action: action2, params, nextAction }, context),
-          context
-        );
-        if (hookResult) {
-          nextAction = hookResult;
-        }
-      }
-    }
-    if (this.config.hooks?.onBeforeAction) {
-      const hookResult = yield* this.callHook(
-        this.config.hooks.onBeforeAction(
-          { action: action2, params, nextAction },
-          context
-        ),
-        context
-      );
-      if (hookResult) {
-        nextAction = hookResult;
-      }
-    }
-    try {
-      const generator = action2.execute(params, context);
-      let result;
-      while (true) {
-        const { value, done } = await generator.next();
-        if (done) {
-          result = value;
-          break;
-        }
-        yield* this.emit(value, context);
-      }
-      for (const plugin2 of this.config.plugins || []) {
-        if (plugin2.onAfterAction) {
-          const extra = yield* this.callHook(
-            plugin2.onAfterAction({ action: action2, data: result }, context),
-            context
-          );
-          if (extra) {
-            nextAction = extra;
-          }
-        }
-      }
-      if (this.config.hooks?.onAfterAction) {
-        const extra = yield* this.callHook(
-          this.config.hooks.onAfterAction({ action: action2, data: result }, context),
-          context
-        );
-        if (extra) {
-          nextAction = extra;
-        }
-      }
-      return result;
-    } catch (error) {
-      if (isEvent(error)) throw error;
-      throw {
-        type: "error",
-        data: {
-          action: action2.name,
-          message: error instanceof Error ? error.message : String(error),
-          stack: error instanceof Error ? error.stack : void 0
-        }
-      };
-    }
-  }
-  /**
-   * Internal helper to call a hook (generator) and yield its events.
-   */
-  async *callHook(generator, context) {
-    if (!generator) return;
-    while (true) {
-      const { value, done } = await generator.next();
-      if (done) return value;
-      yield* this.emit(value, context);
-    }
-  }
-  /**
-   * Internal helper to yield an event and trigger the onEvent hook.
-   */
-  async *emit(event, context) {
-    const finalEvent = {
-      ...event,
-      runId: context.runId,
-      timestamp: event.timestamp ?? Date.now(),
-      role: event.role ?? "assistant",
-      state: context.state
-    };
-    yield finalEvent;
-    for (const plugin2 of this.config.plugins || []) {
-      if (plugin2.onEvent) {
-        const generator = plugin2.onEvent(finalEvent, context);
-        for await (const extra of generator) {
-          yield { ...extra, runId: context.runId, timestamp: Date.now() };
-        }
-      }
-    }
-    if (this.config.hooks?.onEvent) {
-      const generator = this.config.hooks.onEvent(finalEvent, context);
-      for await (const extra of generator) {
-        yield { ...extra, runId: context.runId, timestamp: Date.now() };
-      }
-    }
-  }
-};
-var melony = (config) => {
-  const runtime = new Runtime(config);
-  return {
-    config,
-    run: runtime.run.bind(runtime)
-  };
-};
-var action = (config) => config;
-var plugin = (config) => config;
-
-export { Runtime, action, melony, plugin, ui };
-//# sourceMappingURL=chunk-EGZ4YTE4.js.map
-//# sourceMappingURL=chunk-EGZ4YTE4.js.map

package/dist/chunk-EGZ4YTE4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ui.ts","../src/runtime.ts"],"names":["event","plugin","action"],"mappings":"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","file":"chunk-EGZ4YTE4.js","sourcesContent":["import {\n  UIColor,\n  UIContract,\n  UINode,\n  UISize,\n  Event,\n  UISpacing,\n  UIWidth,\n  UIRadius,\n} 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: (\n    props: UIContract[\"list\"] & { children: UINode<any>[] },\n  ): 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"]}