melony 0.1.24 → 0.1.28

package/README.md

@@ -71,9 +71,11 @@ app.post("/api/chat", handle(assistant));
 ### 3) Stream from the client
 
 ```ts
-import { MelonyClient, createHttpTransport } from "melony/client";
+import { MelonyClient } from "melony/client";
 
-const client = new MelonyClient(createHttpTransport("/api/chat"));
+const client = new MelonyClient({
+  url: "/api/chat"
+});
 
 for await (const event of client.sendEvent({
   type: "text",

package/dist/{chunk-XNRV73PK.js → chunk-LECAXAQJ.js}

@@ -89,10 +89,26 @@ var ui = {
   button: (props) => ({
     type: "button",
     props
-  })
+  }),
+  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" })
+  }
 };
 
 // src/runtime.ts
+var RuntimeInterruption = class extends Error {
+  constructor(event) {
+    super("Runtime interrupted");
+    this.event = event;
+    this.name = "RuntimeInterruption";
+  }
+};
 var Runtime = class {
   constructor(config) {
     this.config = config;
@@ -103,17 +119,31 @@ var Runtime = class {
       state: input.state ?? {},
       runId,
       stepCount: 0,
-      isDone: false,
       actions: this.config.actions,
       ui,
-      suspend: () => {
-        context.isDone = true;
+      suspend: (event) => {
+        throw new RuntimeInterruption(event);
       }
     };
-    let nextAction = void 0;
-    for (const plugin2 of this.config.plugins || []) {
-      if (plugin2.onBeforeRun) {
-        const result = await plugin2.onBeforeRun(
+    try {
+      let nextAction = void 0;
+      for (const plugin2 of this.config.plugins || []) {
+        if (plugin2.onBeforeRun) {
+          const result = await plugin2.onBeforeRun(
+            { event: input.event, runId, state: context.state },
+            context
+          );
+          if (result) {
+            if ("type" in result) {
+              yield* this.emit(result, context);
+            } else {
+              nextAction = result;
+            }
+          }
+        }
+      }
+      if (this.config.hooks?.onBeforeRun) {
+        const result = await this.config.hooks.onBeforeRun(
           { event: input.event, runId, state: context.state },
           context
         );
@@ -125,79 +155,72 @@ var Runtime = class {
           }
         }
       }
-    }
-    if (this.config.hooks?.onBeforeRun) {
-      const result = await this.config.hooks.onBeforeRun(
-        { event: input.event, runId, state: context.state },
+      yield* this.emit(
+        { type: "run-started", data: { inputEvent: input.event } },
         context
       );
-      if (result) {
-        if ("type" in result) {
-          yield* this.emit(result, context);
+      if (!nextAction && this.config.brain) {
+        nextAction = yield* this.dispatchToBrain(input.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 ?? Object.keys(this.config.actions)[0];
+        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,
+                params: current.params,
+                result
+              }
+            },
+            context
+          );
         } else {
           nextAction = result;
         }
       }
-    }
-    if (context.isDone) return;
-    yield* this.emit(
-      { type: "run-started", data: { inputEvent: input.event } },
-      context
-    );
-    if (!nextAction && this.config.brain) {
-      nextAction = yield* this.dispatchToBrain(input.event, context);
-    }
-    while (nextAction && !context.isDone) {
-      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 ?? Object.keys(this.config.actions)[0];
-      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 (context.isDone) break;
-      if (this.config.brain) {
-        nextAction = yield* this.dispatchToBrain(
-          {
-            type: "action-result",
-            data: {
-              ...current,
-              // Preserve all metadata (like toolCallId)
-              action: actionName,
-              params: current.params,
-              result
-            }
-          },
-          context
-        );
-      } else {
-        nextAction = result;
+      for (const plugin2 of this.config.plugins || []) {
+        if (plugin2.onAfterRun) {
+          const extra = await plugin2.onAfterRun(context);
+          if (extra) yield* this.emit(extra, context);
+        }
       }
-    }
-    for (const plugin2 of this.config.plugins || []) {
-      if (plugin2.onAfterRun) {
-        const extra = await plugin2.onAfterRun(context);
+      if (this.config.hooks?.onAfterRun) {
+        const extra = await this.config.hooks.onAfterRun(context);
         if (extra) yield* this.emit(extra, context);
       }
-    }
-    if (this.config.hooks?.onAfterRun) {
-      const extra = await this.config.hooks.onAfterRun(context);
-      if (extra) yield* this.emit(extra, context);
+    } catch (error) {
+      if (error instanceof RuntimeInterruption) {
+        if (error.event) {
+          yield* this.emit(error.event, context);
+        }
+        return;
+      }
+      throw error;
     }
   }
   async *dispatchToBrain(event, context) {
@@ -218,7 +241,6 @@ var Runtime = class {
         );
         if (hookResult) {
           yield* this.emit(hookResult, context);
-          if (context.isDone) return;
         }
       }
     }
@@ -229,7 +251,6 @@ var Runtime = class {
       );
       if (hookResult) {
         yield* this.emit(hookResult, context);
-        if (context.isDone) return;
       }
     }
     try {
@@ -242,7 +263,6 @@ var Runtime = class {
           break;
         }
         yield* this.emit(value, context);
-        if (context.isDone) return;
       }
       for (const plugin2 of this.config.plugins || []) {
         if (plugin2.onAfterAction) {
@@ -262,6 +282,7 @@ var Runtime = class {
       }
       return result;
     } catch (error) {
+      if (error instanceof RuntimeInterruption) throw error;
       yield* this.emit(
         {
           type: "error",
@@ -312,6 +333,6 @@ var melony = (config) => {
 var action = (config) => config;
 var plugin = (config) => config;
 
-export { Runtime, action, melony, plugin, ui };
-//# sourceMappingURL=chunk-XNRV73PK.js.map
-//# sourceMappingURL=chunk-XNRV73PK.js.map
+export { Runtime, RuntimeInterruption, action, melony, plugin, ui };
+//# sourceMappingURL=chunk-LECAXAQJ.js.map
+//# sourceMappingURL=chunk-LECAXAQJ.js.map

package/dist/chunk-LECAXAQJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/runtime.ts"],"names":["plugin","action"],"mappings":";;;AAiLO,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,KAAA,EAAO,CAAC,GAAA,EAAa,GAAA,EAAc,OAAe,IAAA,MAA2B;AAAA,IAC3E,IAAA,EAAM,OAAA;AAAA,IACN,KAAA,EAAO,EAAE,GAAA,EAAK,GAAA,EAAK,IAAA;AAAK,GAC1B,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,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,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,EAAE,MAAM,iBAAA,EAAmB,IAAA,EAAM,EAAE,GAAA,EAAI,EAAE,CAAA;AAAA,IAC5E,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;AAAA;AAEhD;;;AChSO,IAAM,mBAAA,GAAN,cAAkC,KAAA,CAAM;AAAA,EAC7C,YAAmB,KAAA,EAAe;AAChC,IAAA,KAAA,CAAM,qBAAqB,CAAA;AADV,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAEjB,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AAAA,EACd;AACF;AAMO,IAAM,UAAN,MAAc;AAAA,EAGnB,YAAY,MAAA,EAAgB;AAC1B,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA,EAEA,OAAc,IAAI,KAAA,EAIQ;AACxB,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,IAAS,UAAA,EAAW;AAExC,IAAA,MAAM,OAAA,GAA0B;AAAA,MAC9B,KAAA,EAAO,KAAA,CAAM,KAAA,IAAS,EAAC;AAAA,MACvB,KAAA;AAAA,MACA,SAAA,EAAW,CAAA;AAAA,MACX,OAAA,EAAS,KAAK,MAAA,CAAO,OAAA;AAAA,MACrB,EAAA;AAAA,MACA,OAAA,EAAS,CAAC,KAAA,KAAkB;AAC1B,QAAA,MAAM,IAAI,oBAAoB,KAAK,CAAA;AAAA,MACrC;AAAA,KACF;AAEA,IAAA,IAAI;AACF,MAAA,IAAI,UAAA,GAAgC,KAAA,CAAA;AAGpC,MAAA,KAAA,MAAWA,OAAAA,IAAU,IAAA,CAAK,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG;AAC9C,QAAA,IAAIA,QAAO,WAAA,EAAa;AACtB,UAAA,MAAM,MAAA,GAAS,MAAMA,OAAAA,CAAO,WAAA;AAAA,YAC1B,EAAE,KAAA,EAAO,KAAA,CAAM,OAAO,KAAA,EAAO,KAAA,EAAO,QAAQ,KAAA,EAAM;AAAA,YAClD;AAAA,WACF;AACA,UAAA,IAAI,MAAA,EAAQ;AACV,YAAA,IAAI,UAAU,MAAA,EAAQ;AACpB,cAAA,OAAO,IAAA,CAAK,IAAA,CAAK,MAAA,EAAiB,OAAO,CAAA;AAAA,YAC3C,CAAA,MAAO;AACL,cAAA,UAAA,GAAa,MAAA;AAAA,YACf;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAGA,MAAA,IAAI,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,WAAA,EAAa;AAClC,QAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,WAAA;AAAA,UACrC,EAAE,KAAA,EAAO,KAAA,CAAM,OAAO,KAAA,EAAO,KAAA,EAAO,QAAQ,KAAA,EAAM;AAAA,UAClD;AAAA,SACF;AACA,QAAA,IAAI,MAAA,EAAQ;AACV,UAAA,IAAI,UAAU,MAAA,EAAQ;AACpB,YAAA,OAAO,IAAA,CAAK,IAAA,CAAK,MAAA,EAAiB,OAAO,CAAA;AAAA,UAC3C,CAAA,MAAO;AACL,YAAA,UAAA,GAAa,MAAA;AAAA,UACf;AAAA,QACF;AAAA,MACF;AAEA,MAAA,OAAO,IAAA,CAAK,IAAA;AAAA,QACV,EAAE,MAAM,aAAA,EAAe,IAAA,EAAM,EAAE,UAAA,EAAY,KAAA,CAAM,OAAM,EAAE;AAAA,QACzD;AAAA,OACF;AAIA,MAAA,IAAI,CAAC,UAAA,IAAc,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO;AACpC,QAAA,UAAA,GAAa,OAAO,IAAA,CAAK,eAAA,CAAgB,KAAA,CAAM,OAAO,OAAO,CAAA;AAAA,MAC/D;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,UAAA,GACJ,QAAQ,MAAA,IAAU,MAAA,CAAO,KAAK,IAAA,CAAK,MAAA,CAAO,OAAO,CAAA,CAAE,CAAC,CAAA;AACtD,QAAA,MAAMC,OAAAA,GAAsB,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA;AAE1D,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,QAAQ,OAAA,CAAQ,MAAA;AAAA,gBAChB;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,MAAM,KAAA,GAAQ,MAAMA,OAAAA,CAAO,UAAA,CAAW,OAAO,CAAA;AAC7C,UAAA,IAAI,KAAA,EAAO,OAAO,IAAA,CAAK,IAAA,CAAK,OAAO,OAAO,CAAA;AAAA,QAC5C;AAAA,MACF;AAGA,MAAA,IAAI,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,UAAA,EAAY;AACjC,QAAA,MAAM,QAAQ,MAAM,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,WAAW,OAAO,CAAA;AACxD,QAAA,IAAI,KAAA,EAAO,OAAO,IAAA,CAAK,IAAA,CAAK,OAAO,OAAO,CAAA;AAAA,MAC5C;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,iBAAiB,mBAAA,EAAqB;AAExC,QAAA,IAAI,MAAM,KAAA,EAAO;AACf,UAAA,OAAO,IAAA,CAAK,IAAA,CAAK,KAAA,CAAM,KAAA,EAAO,OAAO,CAAA;AAAA,QACvC;AACA,QAAA;AAAA,MACF;AACA,MAAA,MAAM,KAAA;AAAA,IACR;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,MAAMA,OAAAA,CAAO,cAAA;AAAA,UAC9B,EAAE,MAAA,EAAAC,OAAAA,EAAQ,MAAA,EAAQ,UAAA,EAAW;AAAA,UAC7B;AAAA,SACF;AACA,QAAA,IAAI,UAAA,EAAY;AACd,UAAA,OAAO,IAAA,CAAK,IAAA,CAAK,UAAA,EAAY,OAAO,CAAA;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAGA,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,cAAA,EAAgB;AACrC,MAAA,MAAM,UAAA,GAAa,MAAM,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,cAAA;AAAA,QACzC,EAAE,MAAA,EAAAA,OAAAA,EAAQ,MAAA,EAAQ,UAAA,EAAW;AAAA,QAC7B;AAAA,OACF;AACA,MAAA,IAAI,UAAA,EAAY;AACd,QAAA,OAAO,IAAA,CAAK,IAAA,CAAK,UAAA,EAAY,OAAO,CAAA;AAAA,MACtC;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,MAAMA,OAAAA,CAAO,aAAA;AAAA,YACzB,EAAE,MAAA,EAAAC,OAAAA,EAAQ,IAAA,EAAM,MAAA,EAAO;AAAA,YACvB;AAAA,WACF;AACA,UAAA,IAAI,KAAA,EAAO,OAAO,IAAA,CAAK,IAAA,CAAK,OAAO,OAAO,CAAA;AAAA,QAC5C;AAAA,MACF;AAGA,MAAA,IAAI,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,aAAA,EAAe;AACpC,QAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,aAAA;AAAA,UACpC,EAAE,MAAA,EAAAA,OAAAA,EAAQ,IAAA,EAAM,MAAA,EAAO;AAAA,UACvB;AAAA,SACF;AACA,QAAA,IAAI,KAAA,EAAO,OAAO,IAAA,CAAK,IAAA,CAAK,OAAO,OAAO,CAAA;AAAA,MAC5C;AAEA,MAAA,OAAO,MAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,KAAA,YAAiB,qBAAqB,MAAM,KAAA;AAEhD,MAAA,OAAO,IAAA,CAAK,IAAA;AAAA,QACV;AAAA,UACE,IAAA,EAAM,OAAA;AAAA,UACN,IAAA,EAAM;AAAA,YACJ,QAAQA,OAAAA,CAAO,IAAA;AAAA,YACf,OAAO,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK;AAAA;AAC9D,SACF;AAAA,QACA;AAAA,OACF;AAAA,IACF;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,KAAA,GAAQ,MAAMA,OAAAA,CAAO,OAAA,CAAQ,YAAY,OAAO,CAAA;AACtD,QAAA,IAAI,KAAA,EAAO;AACT,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,QAAQ,MAAM,IAAA,CAAK,OAAO,KAAA,CAAM,OAAA,CAAQ,YAAY,OAAO,CAAA;AACjE,MAAA,IAAI,KAAA,EAAO;AAET,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,CAAC,MAAA,KAAmB;AACxC,EAAA,MAAM,OAAA,GAAU,IAAI,OAAA,CAAQ,MAAM,CAAA;AAClC,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,GAAA,EAAK,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,OAAO;AAAA,GAC/B;AACF;AAKO,IAAM,MAAA,GAAS,CAAwB,MAAA,KAC5C;AAKK,IAAM,MAAA,GAAS,CAAC,MAAA,KAA2B","file":"chunk-LECAXAQJ.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  };\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;\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  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  button: {\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: (src: string, alt?: string, size: UISize = \"md\"): UINode<\"image\"> => ({\n    type: \"image\",\n    props: { src, alt, size },\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  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  button: (props: UIContract[\"button\"]): UINode<\"button\"> => ({\n    type: \"button\",\n    props,\n  }),\n  actions: {\n    navigate: (url: string): Event => ({ type: \"client:navigate\", data: { url } }),\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  },\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  runId?: string;\n  threadId?: string;\n  timestamp?: number;\n  role?: Role;\n  state?: any;\n};\n\n// ============================================\n// Runtime & Hooks\n// ============================================\n\nexport interface Action<TParams extends z.ZodSchema = z.ZodObject<any>> {\n  name: string;\n  description?: string;\n  paramsSchema: TParams;\n  execute: (\n    params: z.infer<TParams>,\n    context: RuntimeContext\n  ) => AsyncGenerator<Event, NextAction | void, unknown>;\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>>;\n  ui: typeof ui;\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 for consistent DX.\n */\nexport type HookResult = Promise<Event | void>;\n\nexport interface Hooks {\n  /**\n   * Called when a run session begins.\n   * Can return an Event to be emitted, or a NextAction to jump-start the loop.\n   */\n  onBeforeRun?: (\n    input: { event: Event; runId: string; state: Record<string, any> },\n    context: RuntimeContext\n  ) => Promise<Event | NextAction | void>;\n\n  /**\n   * Called when a run session completes.\n   */\n  onAfterRun?: (context: RuntimeContext) => HookResult;\n\n  /**\n   * Called whenever an event is yielded by the runtime.\n   */\n  onEvent?: (event: Event, context: RuntimeContext) => HookResult;\n\n  /**\n   * Called before an action is executed.\n   * Return an event to intercept/suspend the action.\n   */\n  onBeforeAction?: (\n    call: { action: Action<any>; params: any; nextAction: NextAction },\n    context: RuntimeContext\n  ) => HookResult;\n\n  /**\n   * Called after an action completes.\n   */\n  onAfterAction?: (\n    result: { action: Action<any>; data: NextAction | void },\n    context: RuntimeContext\n  ) => HookResult;\n}\n\n/**\n * A plugin is just a named set of hooks.\n */\nexport interface Plugin extends Hooks {\n  name: string;\n}\n\nexport interface Config {\n  actions: Record<string, Action<any>>;\n  /**\n   * The central brain for handling incoming events.\n   */\n  brain?: (\n    event: Event,\n    context: RuntimeContext\n  ) => AsyncGenerator<Event, NextAction | void, unknown>;\n  hooks?: Hooks;\n  plugins?: Plugin[];\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} from \"./types\";\nimport { generateId } from \"./utils/generate-id\";\nimport { z } from \"zod\";\n\n/**\n * Special error to immediately interrupt the runtime.\n * This is used for Human-In-The-Loop (HITL) or other suspension cases.\n */\nexport class RuntimeInterruption extends Error {\n  constructor(public event?: Event) {\n    super(\"Runtime interrupted\");\n    this.name = \"RuntimeInterruption\";\n  }\n}\n\n/**\n * The Slim Runtime.\n * Single Responsibility: Orchestrate Event -> Action -> Event transitions.\n */\nexport class Runtime {\n  private config: Config;\n\n  constructor(config: Config) {\n    this.config = config;\n  }\n\n  public async *run(input: {\n    event: Event;\n    runId?: string;\n    state?: Record<string, any>;\n  }): AsyncGenerator<Event> {\n    const runId = input.runId ?? generateId();\n\n    const context: RuntimeContext = {\n      state: input.state ?? {},\n      runId,\n      stepCount: 0,\n      actions: this.config.actions,\n      ui,\n      suspend: (event?: Event) => {\n        throw new RuntimeInterruption(event);\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 = await plugin.onBeforeRun(\n            { event: input.event, runId, state: context.state },\n            context\n          );\n          if (result) {\n            if (\"type\" in result) {\n              yield* this.emit(result as Event, context);\n            } else {\n              nextAction = result as NextAction;\n            }\n          }\n        }\n      }\n\n      // 2. Trigger Hook: onBeforeRun\n      if (this.config.hooks?.onBeforeRun) {\n        const result = await this.config.hooks.onBeforeRun(\n          { event: input.event, runId, state: context.state },\n          context\n        );\n        if (result) {\n          if (\"type\" in result) {\n            yield* this.emit(result as Event, context);\n          } else {\n            nextAction = result as NextAction;\n          }\n        }\n      }\n\n      yield* this.emit(\n        { type: \"run-started\", data: { inputEvent: input.event } },\n        context\n      );\n\n      // Initial dispatch of the incoming event to the agent's brain\n      // Only if onBeforeRun didn't already provide a nextAction\n      if (!nextAction && this.config.brain) {\n        nextAction = yield* this.dispatchToBrain(input.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 =\n          current.action ?? Object.keys(this.config.actions)[0];\n        const action: Action<any> = 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                params: current.params,\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          const extra = await plugin.onAfterRun(context);\n          if (extra) yield* this.emit(extra, context);\n        }\n      }\n\n      // 2. Trigger Hook: onAfterRun\n      if (this.config.hooks?.onAfterRun) {\n        const extra = await this.config.hooks.onAfterRun(context);\n        if (extra) yield* this.emit(extra, context);\n      }\n    } catch (error) {\n      if (error instanceof RuntimeInterruption) {\n        // If the suspension carried an event, emit it before finishing\n        if (error.event) {\n          yield* this.emit(error.event, context);\n        }\n        return;\n      }\n      throw error;\n    }\n  }\n\n  private async *dispatchToBrain(\n    event: Event,\n    context: RuntimeContext\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,\n    nextAction: NextAction,\n    context: RuntimeContext\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 = await plugin.onBeforeAction(\n          { action, params, nextAction },\n          context\n        );\n        if (hookResult) {\n          yield* this.emit(hookResult, context);\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onBeforeAction\n    if (this.config.hooks?.onBeforeAction) {\n      const hookResult = await this.config.hooks.onBeforeAction(\n        { action, params, nextAction },\n        context\n      );\n      if (hookResult) {\n        yield* this.emit(hookResult, context);\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 = await plugin.onAfterAction(\n            { action, data: result },\n            context\n          );\n          if (extra) yield* this.emit(extra, context);\n        }\n      }\n\n      // 4. Trigger Hook: onAfterAction\n      if (this.config.hooks?.onAfterAction) {\n        const extra = await this.config.hooks.onAfterAction(\n          { action, data: result },\n          context\n        );\n        if (extra) yield* this.emit(extra, context);\n      }\n\n      return result;\n    } catch (error) {\n      if (error instanceof RuntimeInterruption) throw error;\n\n      yield* this.emit(\n        {\n          type: \"error\",\n          data: {\n            action: action.name,\n            error: error instanceof Error ? error.message : String(error),\n          },\n        },\n        context\n      );\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\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 extra = await plugin.onEvent(finalEvent, context);\n        if (extra) {\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 extra = await this.config.hooks.onEvent(finalEvent, context);\n      if (extra) {\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 = (config: Config) => {\n  const runtime = new Runtime(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>(config: Action<T>): Action<T> =>\n  config;\n\n/**\n * Helper to define a plugin.\n */\nexport const plugin = (config: Plugin): Plugin => config;\n"]}

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { E as Event } from './types-BMLnUzH9.js';
+import { E as Event, C as Config } from './types-CFbiFt1b.js';
 export { g as generateId } from './generate-id-DU8kwYc2.js';
 import 'zod';
 
@@ -11,15 +11,19 @@ interface ClientState {
         details?: string;
     };
 }
+interface MelonyClientOptions {
+    url: string;
+    initialEvents?: Event[];
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+}
 declare class MelonyClient {
-    private transport;
     private state;
+    readonly url: string;
+    private headers?;
     private lastServerState;
     private abortController;
     private stateListeners;
-    constructor(transport: TransportFn, options?: {
-        initialEvents?: Event[];
-    });
+    constructor(options: MelonyClientOptions);
     subscribe(listener: (state: ClientState) => void): () => void;
     getState(): {
         events: Event[];
@@ -30,16 +34,8 @@ declare class MelonyClient {
             details?: string;
         };
     };
-    getConfig(api?: string): Promise<{
-        starterPrompts: any[];
-        options: any[];
-        fileAttachments?: {
-            enabled?: boolean;
-            accept?: string;
-            maxFiles?: number;
-            maxFileSize?: number;
-        };
-    }>;
+    private getRequestHeaders;
+    getConfig(): Promise<Config>;
     private setState;
     sendEvent(event: Event, options?: {
         runId?: string;
@@ -48,12 +44,5 @@ declare class MelonyClient {
     private handleIncomingEvent;
     reset(events?: Event[]): void;
 }
-interface TransportRequest {
-    event: Event;
-    runId?: string;
-    state?: Record<string, any>;
-}
-type TransportFn = (request: TransportRequest, signal?: AbortSignal) => Promise<ReadableStream<Uint8Array>>;
-declare function createHttpTransport(api: string): TransportFn;
 
-export { type ClientState, Event, MelonyClient, type TransportFn, type TransportRequest, createHttpTransport };
+export { type ClientState, Event, MelonyClient, type MelonyClientOptions };

package/dist/client.js

@@ -3,13 +3,14 @@ export { generateId } from './chunk-WAI5H335.js';
 
 // src/client.ts
 var MelonyClient = class {
-  constructor(transport, options) {
+  constructor(options) {
     this.lastServerState = null;
     this.abortController = null;
     this.stateListeners = /* @__PURE__ */ new Set();
-    this.transport = transport;
+    this.url = options.url;
+    this.headers = options.headers;
     this.state = {
-      events: options?.initialEvents ?? [],
+      events: options.initialEvents ?? [],
       isLoading: false,
       error: null,
       loadingStatus: void 0
@@ -24,13 +25,21 @@ var MelonyClient = class {
   getState() {
     return { ...this.state };
   }
-  async getConfig(api) {
-    if (!api) return { starterPrompts: [], options: [] };
-    const response = await fetch(api, {
+  async getRequestHeaders() {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.headers) {
+      const extraHeaders = typeof this.headers === "function" ? await this.headers() : this.headers;
+      Object.assign(headers, extraHeaders);
+    }
+    return headers;
+  }
+  async getConfig() {
+    const headers = await this.getRequestHeaders();
+    const response = await fetch(this.url, {
       method: "GET",
-      headers: {
-        "Content-Type": "application/json"
-      }
+      headers
     });
     if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
     return response.json();
@@ -57,11 +66,16 @@ var MelonyClient = class {
       events: [...this.state.events, optimisticEvent]
     });
     try {
-      const stream = await this.transport(
-        { event: optimisticEvent, ...options, runId, state },
-        this.abortController.signal
-      );
-      const reader = stream.getReader();
+      const headers = await this.getRequestHeaders();
+      const response = await fetch(this.url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ event: optimisticEvent, ...options, runId, state }),
+        signal: this.abortController.signal
+      });
+      if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
+      if (!response.body) throw new Error("No response body");
+      const reader = response.body.getReader();
       const decoder = new TextDecoder();
       let buffer = "";
       while (true) {
@@ -138,20 +152,7 @@ var MelonyClient = class {
     });
   }
 };
-function createHttpTransport(api) {
-  return async (request, signal) => {
-    const response = await fetch(api, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(request),
-      signal
-    });
-    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
-    if (!response.body) throw new Error("No response body");
-    return response.body;
-  };
-}
 
-export { MelonyClient, createHttpTransport };
+export { MelonyClient };
 //# sourceMappingURL=client.js.map
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"client.js","sourcesContent":["import { Event } from \"./types\";\nimport { generateId } from \"./utils/generate-id\";\n\nexport type { Event };\nexport { generateId };\n\nexport interface ClientState {\n  events: Event[];\n  isLoading: boolean;\n  error: Error | null;\n  loadingStatus?: {\n    message: string;\n    details?: string;\n  };\n}\n\nexport class MelonyClient {\n  private transport: TransportFn;\n  private state: ClientState;\n  private lastServerState: any = null;\n  private abortController: AbortController | null = null;\n  private stateListeners: Set<(state: ClientState) => void> = new Set();\n\n  constructor(transport: TransportFn, options?: { initialEvents?: Event[] }) {\n    this.transport = transport;\n    this.state = {\n      events: options?.initialEvents ?? [],\n      isLoading: false,\n      error: null,\n      loadingStatus: undefined,\n    };\n  }\n\n  subscribe(listener: (state: ClientState) => void) {\n    this.stateListeners.add(listener);\n    return () => {\n      this.stateListeners.delete(listener);\n    };\n  }\n\n  getState() {\n    return { ...this.state };\n  }\n\n  async getConfig(api?: string): Promise<{\n    starterPrompts: any[];\n    options: any[];\n    fileAttachments?: {\n      enabled?: boolean;\n      accept?: string;\n      maxFiles?: number;\n      maxFileSize?: number;\n    };\n  }> {\n    if (!api) return { starterPrompts: [], options: [] };\n    \n    const response = await fetch(api, {\n      method: \"GET\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n    });\n\n    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);\n    return response.json();\n  }\n\n  private setState(updates: Partial<ClientState>) {\n    this.state = { ...this.state, ...updates };\n    this.stateListeners.forEach((l) => l(this.getState()));\n  }\n\n  async *sendEvent(\n    event: Event,\n    options?: { runId?: string; state?: Record<string, any> }\n  ): AsyncGenerator<Event> {\n    if (this.abortController) this.abortController.abort();\n    this.abortController = new AbortController();\n\n    const runId = options?.runId ?? generateId();\n    const state = options?.state ?? this.lastServerState;\n    const optimisticEvent: Event = {\n      ...event,\n      runId,\n      role: event.role ?? \"user\",\n      timestamp: event.timestamp ?? Date.now(),\n    };\n\n    this.setState({\n      isLoading: true,\n      error: null,\n      loadingStatus: undefined,\n      events: [...this.state.events, optimisticEvent],\n    });\n\n    try {\n      const stream = await this.transport(\n        { event: optimisticEvent, ...options, runId, state },\n        this.abortController.signal\n      );\n\n      const reader = stream.getReader();\n      const decoder = new TextDecoder();\n      let buffer = \"\";\n\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split(\"\\n\\n\");\n        buffer = lines.pop() || \"\";\n\n        for (const line of lines) {\n          if (!line.startsWith(\"data: \")) continue;\n          try {\n            const incomingEvent: Event = JSON.parse(line.slice(6));\n            this.handleIncomingEvent(incomingEvent);\n            yield incomingEvent;\n          } catch (e) {\n            console.error(\"Failed to parse event\", e);\n          }\n        }\n      }\n      this.setState({ isLoading: false, loadingStatus: undefined });\n    } catch (err) {\n      if (err instanceof Error && err.name === \"AbortError\") {\n        this.setState({ isLoading: false, loadingStatus: undefined });\n        return;\n      }\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.setState({ error, isLoading: false, loadingStatus: undefined });\n      throw error;\n    }\n  }\n\n  private handleIncomingEvent(event: Event) {\n    if (event.state) {\n      this.lastServerState = event.state;\n    }\n    const events = [...this.state.events];\n\n    // Track loading-status events\n    if (event.type === \"loading-status\") {\n      const currentStatus = this.state.loadingStatus;\n      const newMessage =\n        event.data?.message ?? currentStatus?.message ?? \"Processing...\";\n      const newDelta = event.data?.delta;\n\n      let newDetails = currentStatus?.details ?? \"\";\n      if (newDelta !== undefined) {\n        newDetails += newDelta;\n      } else if (event.data?.details !== undefined) {\n        newDetails = event.data.details;\n      }\n\n      this.setState({\n        loadingStatus: {\n          message: newMessage,\n          details: newDetails || undefined,\n        },\n      });\n    }\n\n    // Contiguous text-delta merging for the same run\n    const lastEvent = events[events.length - 1];\n    if (\n      event.type === \"text-delta\" &&\n      lastEvent?.type === \"text-delta\" &&\n      event.runId === lastEvent.runId &&\n      event.data?.delta\n    ) {\n      events[events.length - 1] = {\n        ...lastEvent,\n        data: {\n          ...lastEvent.data,\n          delta: (lastEvent.data?.delta || \"\") + event.data.delta,\n        },\n      };\n    } else {\n      events.push(event);\n    }\n\n    this.setState({ events });\n  }\n\n  reset(events: Event[] = []) {\n    if (this.abortController) this.abortController.abort();\n    this.setState({\n      events,\n      error: null,\n      isLoading: false,\n      loadingStatus: undefined,\n    });\n  }\n}\n\nexport interface TransportRequest {\n  event: Event;\n  runId?: string;\n  state?: Record<string, any>;\n}\n\nexport type TransportFn = (\n  request: TransportRequest,\n  signal?: AbortSignal\n) => Promise<ReadableStream<Uint8Array>>;\n\nexport function createHttpTransport(api: string): TransportFn {\n  return async (request: TransportRequest, signal?: AbortSignal) => {\n    const response = await fetch(api, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(request),\n      signal,\n    });\n\n    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);\n    if (!response.body) throw new Error(\"No response body\");\n\n    return response.body;\n  };\n}\n"]}
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"client.js","sourcesContent":["import { Config, Event } from \"./types\";\nimport { generateId } from \"./utils/generate-id\";\n\nexport type { Event };\nexport { generateId };\n\nexport interface ClientState {\n  events: Event[];\n  isLoading: boolean;\n  error: Error | null;\n  loadingStatus?: {\n    message: string;\n    details?: string;\n  };\n}\n\nexport interface MelonyClientOptions {\n  url: string;\n  initialEvents?: Event[];\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>);\n}\n\nexport class MelonyClient {\n  private state: ClientState;\n  public readonly url: string;\n  private headers?: MelonyClientOptions[\"headers\"];\n  private lastServerState: any = null;\n  private abortController: AbortController | null = null;\n  private stateListeners: Set<(state: ClientState) => void> = new Set();\n\n  constructor(options: MelonyClientOptions) {\n    this.url = options.url;\n    this.headers = options.headers;\n    this.state = {\n      events: options.initialEvents ?? [],\n      isLoading: false,\n      error: null,\n      loadingStatus: undefined,\n    };\n  }\n\n  subscribe(listener: (state: ClientState) => void) {\n    this.stateListeners.add(listener);\n    return () => {\n      this.stateListeners.delete(listener);\n    };\n  }\n\n  getState() {\n    return { ...this.state };\n  }\n\n  private async getRequestHeaders() {\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n    };\n\n    if (this.headers) {\n      const extraHeaders =\n        typeof this.headers === \"function\"\n          ? await this.headers()\n          : this.headers;\n      Object.assign(headers, extraHeaders);\n    }\n    return headers;\n  }\n\n  async getConfig(): Promise<Config> {\n    const headers = await this.getRequestHeaders();\n    const response = await fetch(this.url, {\n      method: \"GET\",\n      headers,\n    });\n\n    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);\n    return response.json();\n  }\n\n  private setState(updates: Partial<ClientState>) {\n    this.state = { ...this.state, ...updates };\n    this.stateListeners.forEach((l) => l(this.getState()));\n  }\n\n  async *sendEvent(\n    event: Event,\n    options?: { runId?: string; state?: Record<string, any> }\n  ): AsyncGenerator<Event> {\n    if (this.abortController) this.abortController.abort();\n    this.abortController = new AbortController();\n\n    const runId = options?.runId ?? generateId();\n    const state = options?.state ?? this.lastServerState;\n    const optimisticEvent: Event = {\n      ...event,\n      runId,\n      role: event.role ?? \"user\",\n      timestamp: event.timestamp ?? Date.now(),\n    };\n\n    this.setState({\n      isLoading: true,\n      error: null,\n      loadingStatus: undefined,\n      events: [...this.state.events, optimisticEvent],\n    });\n\n    try {\n      const headers = await this.getRequestHeaders();\n      const response = await fetch(this.url, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify({ event: optimisticEvent, ...options, runId, state }),\n        signal: this.abortController.signal,\n      });\n\n      if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);\n      if (!response.body) throw new Error(\"No response body\");\n\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder();\n      let buffer = \"\";\n\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split(\"\\n\\n\");\n        buffer = lines.pop() || \"\";\n\n        for (const line of lines) {\n          if (!line.startsWith(\"data: \")) continue;\n          try {\n            const incomingEvent: Event = JSON.parse(line.slice(6));\n            this.handleIncomingEvent(incomingEvent);\n            yield incomingEvent;\n          } catch (e) {\n            console.error(\"Failed to parse event\", e);\n          }\n        }\n      }\n      this.setState({ isLoading: false, loadingStatus: undefined });\n    } catch (err) {\n      if (err instanceof Error && err.name === \"AbortError\") {\n        this.setState({ isLoading: false, loadingStatus: undefined });\n        return;\n      }\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.setState({ error, isLoading: false, loadingStatus: undefined });\n      throw error;\n    }\n  }\n\n  private handleIncomingEvent(event: Event) {\n    if (event.state) {\n      this.lastServerState = event.state;\n    }\n    const events = [...this.state.events];\n\n    if (event.type === \"loading-status\") {\n      const currentStatus = this.state.loadingStatus;\n      const newMessage =\n        event.data?.message ?? currentStatus?.message ?? \"Processing...\";\n      const newDelta = event.data?.delta;\n\n      let newDetails = currentStatus?.details ?? \"\";\n      if (newDelta !== undefined) {\n        newDetails += newDelta;\n      } else if (event.data?.details !== undefined) {\n        newDetails = event.data.details;\n      }\n\n      this.setState({\n        loadingStatus: {\n          message: newMessage,\n          details: newDetails || undefined,\n        },\n      });\n    }\n\n    const lastEvent = events[events.length - 1];\n    if (\n      event.type === \"text-delta\" &&\n      lastEvent?.type === \"text-delta\" &&\n      event.runId === lastEvent.runId &&\n      event.data?.delta\n    ) {\n      events[events.length - 1] = {\n        ...lastEvent,\n        data: {\n          ...lastEvent.data,\n          delta: (lastEvent.data?.delta || \"\") + event.data.delta,\n        },\n      };\n    } else {\n      events.push(event);\n    }\n\n    this.setState({ events });\n  }\n\n  reset(events: Event[] = []) {\n    if (this.abortController) this.abortController.abort();\n    this.setState({\n      events,\n      error: null,\n      isLoading: false,\n      loadingStatus: undefined,\n    });\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,8 +1,16 @@
-import { C as Config, E as Event, A as Action, P as Plugin } from './types-BMLnUzH9.js';
-export { H as HookResult, j as Hooks, N as NextAction, R as Role, i 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-BMLnUzH9.js';
+import { E as Event, C as Config, A as Action, P as Plugin } from './types-CFbiFt1b.js';
+export { H as HookResult, j as Hooks, N as NextAction, R as Role, i 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-CFbiFt1b.js';
 import { z } from 'zod';
 export { g as generateId } from './generate-id-DU8kwYc2.js';
 
+/**
+ * Special error to immediately interrupt the runtime.
+ * This is used for Human-In-The-Loop (HITL) or other suspension cases.
+ */
+declare class RuntimeInterruption extends Error {
+    event?: Event | undefined;
+    constructor(event?: Event | undefined);
+}
 /**
  * The Slim Runtime.
  * Single Responsibility: Orchestrate Event -> Action -> Event transitions.
@@ -45,4 +53,4 @@ declare const plugin: (config: Plugin) => Plugin;
  */
 declare function createStreamResponse(generator: AsyncGenerator<Event>): Response;
 
-export { Action, Config, Event, Plugin, Runtime, action, createStreamResponse, melony, plugin };
+export { Action, Config, Event, Plugin, Runtime, RuntimeInterruption, action, createStreamResponse, melony, plugin };

package/dist/index.js

@@ -1,5 +1,5 @@
 export { createStreamResponse } from './chunk-CFG7FFEZ.js';
-export { Runtime, action, melony, plugin, ui } from './chunk-XNRV73PK.js';
+export { Runtime, RuntimeInterruption, action, melony, plugin, ui } from './chunk-LECAXAQJ.js';
 export { generateId } from './chunk-WAI5H335.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

@@ -1,4 +1,4 @@
-import { A as Action, i as RuntimeContext, P as Plugin } from '../types-BMLnUzH9.js';
+import { A as Action, i as RuntimeContext, P as Plugin } from '../types-CFbiFt1b.js';
 import 'zod';
 
 interface RequireApprovalOptions {

package/dist/plugins/require-approval.js

@@ -1,4 +1,4 @@
-import { plugin, ui } from '../chunk-XNRV73PK.js';
+import { plugin, ui } from '../chunk-LECAXAQJ.js';
 import '../chunk-WAI5H335.js';
 
 // src/plugins/require-approval.ts
@@ -14,8 +14,7 @@ var requireApproval = (options = {}) => {
         const { action, params, token, approvalId, ...rest } = event.data;
         const pending = context.state.__pending_approvals?.[approvalId];
         if (!pending) {
-          context.suspend();
-          return {
+          context.suspend({
             role: "assistant",
             type: "error",
             data: {
@@ -29,7 +28,7 @@ var requireApproval = (options = {}) => {
                 )
               ]
             })
-          };
+          });
         }
         delete context.state.__pending_approvals[approvalId];
         if (event.type === "action-approved") {
@@ -50,13 +49,12 @@ var requireApproval = (options = {}) => {
           context.state.__approved_action = { action, params };
           return { action, params, ...rest };
         }
-        context.suspend();
-        return {
+        context.suspend({
           type: "error",
           data: {
             message: `Action '${action}' was rejected by the user.`
           }
-        };
+        });
       }
     },
     /**
@@ -78,7 +76,6 @@ var requireApproval = (options = {}) => {
         delete context.state.__approved_action;
         return;
       }
-      context.suspend();
       const approvalId = Math.random().toString(36).substring(2, 15);
       context.state.__pending_approvals = context.state.__pending_approvals || {};
       context.state.__pending_approvals[approvalId] = true;
@@ -87,7 +84,7 @@ var requireApproval = (options = {}) => {
         options.secret
       ) : void 0;
       const message = typeof options.message === "function" ? options.message(action.name, params) : options.message || `The agent wants to execute **${action.name}**. Do you approve?`;
-      return {
+      context.suspend({
         type: "hitl-required",
         data: { ...nextAction, token, approvalId },
         ui: ui.card({
@@ -126,7 +123,7 @@ 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 \"../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 ({ event }, context) => {\n      if (\n        event.type === \"action-approved\" ||\n        event.type === \"action-rejected\"\n      ) {\n        const { action, params, token, approvalId, ...rest } = event.data;\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          return {\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              return {\n                type: \"error\",\n                data: {\n                  message:\n                    \"Security Warning: Approval token mismatch. Execution blocked.\",\n                },\n              };\n            }\n          }\n\n          // 4. Store approval in ephemeral state for the upcoming action execution\n          context.state.__approved_action = { action, params };\n\n          // Return the action to jump-start the loop exactly where we left off\n          return { action, params, ...rest };\n        }\n\n        // Handle Rejection\n        context.suspend();\n        return {\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 ({ 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      context.suspend();\n\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      return {\n        type: \"hitl-required\",\n        data: { ...nextAction, token, approvalId },\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                    data: { ...nextAction, 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                    data: { action: action.name, 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 \"../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 ({ event }, context) => {\n      if (\n        event.type === \"action-approved\" ||\n        event.type === \"action-rejected\"\n      ) {\n        const { action, params, token, approvalId, ...rest } = event.data;\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              return {\n                type: \"error\",\n                data: {\n                  message:\n                    \"Security Warning: Approval token mismatch. Execution blocked.\",\n                },\n              };\n            }\n          }\n\n          // 4. Store approval in ephemeral state for the upcoming action execution\n          context.state.__approved_action = { action, params };\n\n          // Return the action to jump-start the loop exactly where we left off\n          return { action, params, ...rest };\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 ({ 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        data: { ...nextAction, token, approvalId },\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                    data: { ...nextAction, 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                    data: { action: action.name, 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-BMLnUzH9.d.ts → types-CFbiFt1b.d.ts}

@@ -194,6 +194,12 @@ declare const ui: {
     radioGroup: (props: UIContract["radioGroup"]) => UINode<"radioGroup">;
     label: (value: string, props?: Omit<UIContract["label"], "value">) => UINode<"label">;
     button: (props: UIContract["button"]) => UINode<"button">;
+    actions: {
+        navigate: (url: string) => Event;
+        openUrl: (url: string, target?: string) => Event;
+        copy: (text: string) => Event;
+        reset: () => Event;
+    };
 };
 type Role = "user" | "assistant" | "system";
 type Event = {
@@ -222,10 +228,13 @@ interface RuntimeContext<TState = any> {
     state: TState;
     runId: string;
     stepCount: number;
-    isDone: boolean;
     actions: Record<string, Action<any>>;
     ui: typeof ui;
-    suspend: () => void;
+    /**
+     * Immediately interrupts the runtime execution.
+     * If an event is provided, it will be emitted before the runtime stops.
+     */
+    suspend: (event?: Event) => never;
 }
 /**
  * Standardized Hook Result for consistent DX.

package/package.json

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

package/dist/chunk-XNRV73PK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types.ts","../src/runtime.ts"],"names":["plugin","action"],"mappings":"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","file":"chunk-XNRV73PK.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  };\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;\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  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  button: {\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: (src: string, alt?: string, size: UISize = \"md\"): UINode<\"image\"> => ({\n    type: \"image\",\n    props: { src, alt, size },\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  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  button: (props: UIContract[\"button\"]): UINode<\"button\"> => ({\n    type: \"button\",\n    props,\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  runId?: string;\n  threadId?: string;\n  timestamp?: number;\n  role?: Role;\n  state?: any;\n};\n\n// ============================================\n// Runtime & Hooks\n// ============================================\n\nexport interface Action<TParams extends z.ZodSchema = z.ZodObject<any>> {\n  name: string;\n  description?: string;\n  paramsSchema: TParams;\n  execute: (\n    params: z.infer<TParams>,\n    context: RuntimeContext\n  ) => AsyncGenerator<Event, NextAction | void, unknown>;\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  isDone: boolean;\n  actions: Record<string, Action<any>>;\n  ui: typeof ui;\n  suspend: () => void;\n}\n\n/**\n * Standardized Hook Result for consistent DX.\n */\nexport type HookResult = Promise<Event | void>;\n\nexport interface Hooks {\n  /**\n   * Called when a run session begins.\n   * Can return an Event to be emitted, or a NextAction to jump-start the loop.\n   */\n  onBeforeRun?: (\n    input: { event: Event; runId: string; state: Record<string, any> },\n    context: RuntimeContext\n  ) => Promise<Event | NextAction | void>;\n\n  /**\n   * Called when a run session completes.\n   */\n  onAfterRun?: (context: RuntimeContext) => HookResult;\n\n  /**\n   * Called whenever an event is yielded by the runtime.\n   */\n  onEvent?: (event: Event, context: RuntimeContext) => HookResult;\n\n  /**\n   * Called before an action is executed.\n   * Return an event to intercept/suspend the action.\n   */\n  onBeforeAction?: (\n    call: { action: Action<any>; params: any; nextAction: NextAction },\n    context: RuntimeContext\n  ) => HookResult;\n\n  /**\n   * Called after an action completes.\n   */\n  onAfterAction?: (\n    result: { action: Action<any>; data: NextAction | void },\n    context: RuntimeContext\n  ) => HookResult;\n}\n\n/**\n * A plugin is just a named set of hooks.\n */\nexport interface Plugin extends Hooks {\n  name: string;\n}\n\nexport interface Config {\n  actions: Record<string, Action<any>>;\n  /**\n   * The central brain for handling incoming events.\n   */\n  brain?: (\n    event: Event,\n    context: RuntimeContext\n  ) => AsyncGenerator<Event, NextAction | void, unknown>;\n  hooks?: Hooks;\n  plugins?: Plugin[];\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} from \"./types\";\nimport { generateId } from \"./utils/generate-id\";\nimport { z } from \"zod\";\n\n/**\n * The Slim Runtime.\n * Single Responsibility: Orchestrate Event -> Action -> Event transitions.\n */\nexport class Runtime {\n  private config: Config;\n\n  constructor(config: Config) {\n    this.config = config;\n  }\n\n  public async *run(input: {\n    event: Event;\n    runId?: string;\n    state?: Record<string, any>;\n  }): AsyncGenerator<Event> {\n    const runId = input.runId ?? generateId();\n\n    const context: RuntimeContext = {\n      state: input.state ?? {},\n      runId,\n      stepCount: 0,\n      isDone: false,\n      actions: this.config.actions,\n      ui,\n      suspend: () => {\n        context.isDone = true;\n      },\n    };\n\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 = await plugin.onBeforeRun(\n          { event: input.event, runId, state: context.state },\n          context\n        );\n        if (result) {\n          if (\"type\" in result) {\n            yield* this.emit(result as Event, context);\n          } else {\n            nextAction = result as NextAction;\n          }\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onBeforeRun\n    if (this.config.hooks?.onBeforeRun) {\n      const result = await this.config.hooks.onBeforeRun(\n        { event: input.event, runId, state: context.state },\n        context\n      );\n      if (result) {\n        if (\"type\" in result) {\n          yield* this.emit(result as Event, context);\n        } else {\n          nextAction = result as NextAction;\n        }\n      }\n    }\n\n    if (context.isDone) return;\n\n    yield* this.emit(\n      { type: \"run-started\", data: { inputEvent: input.event } },\n      context\n    );\n\n    // Initial dispatch of the incoming event to the agent's brain\n    // Only if onBeforeRun didn't already provide a nextAction\n    if (!nextAction && this.config.brain) {\n      nextAction = yield* this.dispatchToBrain(input.event, context);\n    }\n\n    // Agentic loop\n    while (nextAction && !context.isDone) {\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 =\n        current.action ?? Object.keys(this.config.actions)[0];\n      const action: Action<any> = 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      // If the action or a plugin suspended the run (e.g. for HITL approval), \n      // stop immediately before feeding the result back to the brain.\n      if (context.isDone) break;\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              params: current.params,\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        const extra = await plugin.onAfterRun(context);\n        if (extra) yield* this.emit(extra, context);\n      }\n    }\n\n    // 2. Trigger Hook: onAfterRun\n    if (this.config.hooks?.onAfterRun) {\n      const extra = await this.config.hooks.onAfterRun(context);\n      if (extra) yield* this.emit(extra, context);\n    }\n  }\n\n  private async *dispatchToBrain(\n    event: Event,\n    context: RuntimeContext\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,\n    nextAction: NextAction,\n    context: RuntimeContext\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 = await plugin.onBeforeAction(\n          { action, params, nextAction },\n          context\n        );\n        if (hookResult) {\n          yield* this.emit(hookResult, context);\n          if (context.isDone) return;\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onBeforeAction\n    if (this.config.hooks?.onBeforeAction) {\n      const hookResult = await this.config.hooks.onBeforeAction(\n        { action, params, nextAction },\n        context\n      );\n      if (hookResult) {\n        yield* this.emit(hookResult, context);\n        if (context.isDone) return;\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        if (context.isDone) return;\n      }\n\n      // 3. Trigger Plugins: onAfterAction\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onAfterAction) {\n          const extra = await plugin.onAfterAction(\n            { action, data: result },\n            context\n          );\n          if (extra) yield* this.emit(extra, context);\n        }\n      }\n\n      // 4. Trigger Hook: onAfterAction\n      if (this.config.hooks?.onAfterAction) {\n        const extra = await this.config.hooks.onAfterAction(\n          { action, data: result },\n          context\n        );\n        if (extra) yield* this.emit(extra, context);\n      }\n\n      return result;\n    } catch (error) {\n      yield* this.emit(\n        {\n          type: \"error\",\n          data: {\n            action: action.name,\n            error: error instanceof Error ? error.message : String(error),\n          },\n        },\n        context\n      );\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\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 extra = await plugin.onEvent(finalEvent, context);\n        if (extra) {\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 extra = await this.config.hooks.onEvent(finalEvent, context);\n      if (extra) {\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 = (config: Config) => {\n  const runtime = new Runtime(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>(\n  config: Action<T>\n): Action<T> => config;\n\n/**\n * Helper to define a plugin.\n */\nexport const plugin = (config: Plugin): Plugin => config;\n"]}