melony 0.1.33 → 0.1.35

package/dist/adapters/hono.js

@@ -21,9 +21,7 @@ var handle = (instance) => {
       requestHeaders: headers
     };
     return createStreamResponse(
-      instance.run({
-        event
-      })
+      instance.run(event)
     );
   };
 };

package/dist/adapters/hono.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/hono.ts"],"names":[],"mappings":";;;AAMO,IAAM,MAAA,GAAS,CAAC,QAAA,KAAwC;AAC7D,EAAA,OAAO,OAAO,CAAA,KAAW;AACvB,IAAA,IAAI,CAAA,CAAE,GAAA,CAAI,MAAA,KAAW,KAAA,EAAO;AAC1B,MAAA,OAAO,EAAE,IAAA,CAAK;AAAA,QACZ,cAAA,EAAgB,QAAA,CAAS,MAAA,CAAO,cAAA,IAAkB,EAAC;AAAA,QACnD,OAAA,EAAS,QAAA,CAAS,MAAA,CAAO,OAAA,IAAW,EAAC;AAAA,QACrC,eAAA,EAAiB,SAAS,MAAA,CAAO;AAAA,OAClC,CAAA;AAAA,IACH;AAEA,IAAA,MAAM,OAAA,GAAU,CAAA,CAAE,GAAA,CAAI,MAAA,EAAO;AAC7B,IAAA,MAAM,IAAA,GAAO,MAAM,CAAA,CAAE,GAAA,CAAI,IAAA,EAAK;AAC9B,IAAA,MAAM,QAAQ,IAAA,CAAK,KAAA;AAEnB,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,OAAO,EAAE,IAAA,CAAK,EAAE,KAAA,EAAO,iCAAA,IAAqC,GAAG,CAAA;AAAA,IACjE;AAGA,IAAA,KAAA,CAAM,KAAA,GAAQ;AAAA,MACZ,GAAG,KAAA,CAAM,KAAA;AAAA,MACT,cAAA,EAAgB;AAAA,KAClB;AAEA,IAAA,OAAO,oBAAA;AAAA,MACL,SAAS,GAAA,CAAI;AAAA,QACX;AAAA,OACD;AAAA,KACH;AAAA,EACF,CAAA;AACF","file":"hono.js","sourcesContent":["import { Event } from \"../types\";\nimport { createStreamResponse } from \"../utils/create-stream-response\";\n\n/**\n * Event-centric Hono adapter for Melony.\n */\nexport const handle = (instance: { run: any; config: any }) => {\n  return async (c: any) => {\n    if (c.req.method === \"GET\") {\n      return c.json({\n        starterPrompts: instance.config.starterPrompts || [],\n        options: instance.config.options || [],\n        fileAttachments: instance.config.fileAttachments,\n      });\n    }\n\n    const headers = c.req.header();\n    const body = await c.req.json();\n    const event = body.event as Event;\n\n    if (!event) {\n      return c.json({ error: \"Invalid request: event required\" }, 400);\n    }\n\n    // Merge headers into event state\n    event.state = {\n      ...event.state,\n      requestHeaders: headers,\n    };\n\n    return createStreamResponse(\n      instance.run({\n        event,\n      })\n    );\n  };\n};\n"]}
+{"version":3,"sources":["../../src/adapters/hono.ts"],"names":[],"mappings":";;;AAMO,IAAM,MAAA,GAAS,CAAC,QAAA,KAAwC;AAC7D,EAAA,OAAO,OAAO,CAAA,KAAW;AACvB,IAAA,IAAI,CAAA,CAAE,GAAA,CAAI,MAAA,KAAW,KAAA,EAAO;AAC1B,MAAA,OAAO,EAAE,IAAA,CAAK;AAAA,QACZ,cAAA,EAAgB,QAAA,CAAS,MAAA,CAAO,cAAA,IAAkB,EAAC;AAAA,QACnD,OAAA,EAAS,QAAA,CAAS,MAAA,CAAO,OAAA,IAAW,EAAC;AAAA,QACrC,eAAA,EAAiB,SAAS,MAAA,CAAO;AAAA,OAClC,CAAA;AAAA,IACH;AAEA,IAAA,MAAM,OAAA,GAAU,CAAA,CAAE,GAAA,CAAI,MAAA,EAAO;AAC7B,IAAA,MAAM,IAAA,GAAO,MAAM,CAAA,CAAE,GAAA,CAAI,IAAA,EAAK;AAC9B,IAAA,MAAM,QAAQ,IAAA,CAAK,KAAA;AAEnB,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,OAAO,EAAE,IAAA,CAAK,EAAE,KAAA,EAAO,iCAAA,IAAqC,GAAG,CAAA;AAAA,IACjE;AAGA,IAAA,KAAA,CAAM,KAAA,GAAQ;AAAA,MACZ,GAAG,KAAA,CAAM,KAAA;AAAA,MACT,cAAA,EAAgB;AAAA,KAClB;AAEA,IAAA,OAAO,oBAAA;AAAA,MACL,QAAA,CAAS,IAAI,KAAK;AAAA,KACpB;AAAA,EACF,CAAA;AACF","file":"hono.js","sourcesContent":["import { Event } from \"../types\";\nimport { createStreamResponse } from \"../utils/create-stream-response\";\n\n/**\n * Event-centric Hono adapter for Melony.\n */\nexport const handle = (instance: { run: any; config: any }) => {\n  return async (c: any) => {\n    if (c.req.method === \"GET\") {\n      return c.json({\n        starterPrompts: instance.config.starterPrompts || [],\n        options: instance.config.options || [],\n        fileAttachments: instance.config.fileAttachments,\n      });\n    }\n\n    const headers = c.req.header();\n    const body = await c.req.json();\n    const event = body.event as Event;\n\n    if (!event) {\n      return c.json({ error: \"Invalid request: event required\" }, 400);\n    }\n\n    // Merge headers into event state\n    event.state = {\n      ...event.state,\n      requestHeaders: headers,\n    };\n\n    return createStreamResponse(\n      instance.run(event)\n    );\n  };\n};\n"]}

package/dist/{chunk-NQ2SOCUO.js → chunk-H5YOYQV4.js}

@@ -112,16 +112,16 @@ var Runtime = class {
   constructor(config) {
     this.config = config;
   }
-  async *run(input) {
-    const runId = input.event.runId ?? generateId();
+  async *run(event) {
+    const runId = event.runId ?? generateId();
     const context = {
-      state: input.event.state ?? {},
+      state: event.state ?? {},
       runId,
       stepCount: 0,
       actions: this.config.actions,
       ui,
-      suspend: (event) => {
-        throw event || { type: "run-suspended" };
+      suspend: (event2) => {
+        throw event2 || { type: "run-suspended" };
       }
     };
     try {
@@ -129,7 +129,7 @@ var Runtime = class {
       for (const plugin2 of this.config.plugins || []) {
         if (plugin2.onBeforeRun) {
           const result = yield* this.callHook(
-            plugin2.onBeforeRun({ event: input.event }, context),
+            plugin2.onBeforeRun({ event }, context),
             context
           );
           if (result) {
@@ -139,7 +139,7 @@ var Runtime = class {
       }
       if (this.config.hooks?.onBeforeRun) {
         const result = yield* this.callHook(
-          this.config.hooks.onBeforeRun({ event: input.event }, context),
+          this.config.hooks.onBeforeRun({ event }, context),
           context
         );
         if (result) {
@@ -147,11 +147,11 @@ var Runtime = class {
         }
       }
       yield* this.emit(
-        { type: "run-started", data: { inputEvent: input.event } },
+        { type: "run-started", data: { inputEvent: event } },
         context
       );
       if (!nextAction && this.config.brain) {
-        nextAction = yield* this.dispatchToBrain(input.event, context);
+        nextAction = yield* this.dispatchToBrain(event, context);
       }
       while (nextAction) {
         if (context.stepCount++ >= (this.config.safetyMaxSteps ?? 10)) {
@@ -163,7 +163,17 @@ var Runtime = class {
         }
         const current = nextAction;
         nextAction = void 0;
-        const actionName = current.action ?? Object.keys(this.config.actions)[0];
+        const actionName = current.action;
+        if (!actionName) {
+          yield* this.emit(
+            {
+              type: "error",
+              data: { message: "No action name provided in NextAction" }
+            },
+            context
+          );
+          break;
+        }
         const action2 = this.config.actions[actionName];
         if (!action2) {
           yield* this.emit(
@@ -184,7 +194,6 @@ var Runtime = class {
                 ...current,
                 // Preserve all metadata (like toolCallId)
                 action: actionName,
-                params: current.params,
                 result
               }
             },
@@ -345,5 +354,5 @@ var action = (config) => config;
 var plugin = (config) => config;
 
 export { Runtime, action, melony, plugin, ui };
-//# sourceMappingURL=chunk-NQ2SOCUO.js.map
-//# sourceMappingURL=chunk-NQ2SOCUO.js.map
+//# sourceMappingURL=chunk-H5YOYQV4.js.map
+//# sourceMappingURL=chunk-H5YOYQV4.js.map

package/dist/chunk-H5YOYQV4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/runtime.ts"],"names":["event","plugin","action"],"mappings":"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","file":"chunk-H5YOYQV4.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 => ({\n      type: \"client:navigate\",\n      data: { url },\n    }),\n    openUrl: (url: string, target = \"_blank\"): Event => ({\n      type: \"client:open-url\",\n      data: { url, target },\n    }),\n    copy: (text: string): Event => ({ type: \"client:copy\", data: { text } }),\n    reset: (): Event => ({ type: \"client:reset\" }),\n  },\n};\n\n// ============================================\n// Events\n// ============================================\n\nexport type Role = \"user\" | \"assistant\" | \"system\";\n\nexport type Event = {\n  type: string;\n  data?: any;\n  ui?: UINode;\n  slot?: string;\n  runId?: string;\n  threadId?: string;\n  timestamp?: number;\n  role?: Role;\n  state?: any;\n};\n\n// ============================================\n// Runtime & Hooks\n// ============================================\n\nexport type ActionExecute<\n  TState = any,\n  TParams extends z.ZodSchema = z.ZodSchema,\n> = (\n  params: z.infer<TParams>,\n  context: RuntimeContext<TState>,\n) => AsyncGenerator<Event, NextAction | void, unknown>;\n\nexport interface Action<\n  TState = any,\n  TParams extends z.ZodSchema = z.ZodSchema,\n> {\n  name: string;\n  description?: string;\n  paramsSchema: TParams;\n  execute: ActionExecute<TState, TParams>;\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<TState, any>>;\n  ui: typeof ui;\n\n  /**\n   * Immediately interrupts the runtime execution.\n   * If an event is provided, it will be emitted before the runtime stops.\n   */\n  suspend: (event?: Event) => never;\n}\n\n/**\n * Standardized Hook Result.\n * Now a generator to allow yielding multiple events and returning a result.\n */\nexport type HookGenerator<TReturn = void> = AsyncGenerator<\n  Event,\n  TReturn | void,\n  unknown\n>;\n\nexport interface Hooks<TState = any> {\n  /**\n   * Called when a run session begins.\n   * Can yield Events to be emitted, and return a NextAction to jump-start the loop.\n   */\n  onBeforeRun?: (\n    input: { event: Event },\n    context: RuntimeContext<TState>\n  ) => HookGenerator<NextAction>;\n\n  /**\n   * Called when a run session completes.\n   */\n  onAfterRun?: (context: RuntimeContext<TState>) => HookGenerator;\n\n  /**\n   * Called whenever an event is yielded by the runtime.\n   */\n  onEvent?: (event: Event, context: RuntimeContext<TState>) => HookGenerator;\n\n  /**\n   * Called before an action is executed.\n   * Yield events to intercept, and return a NextAction to redirect/suspend.\n   */\n  onBeforeAction?: (\n    call: { action: Action<TState, any>; params: any; nextAction: NextAction },\n    context: RuntimeContext<TState>\n  ) => HookGenerator<NextAction>;\n\n  /**\n   * Called after an action completes.\n   */\n  onAfterAction?: (\n    result: { action: Action<TState, any>; data: NextAction | void },\n    context: RuntimeContext<TState>\n  ) => HookGenerator<NextAction>;\n}\n\n/**\n * A plugin is just a named set of hooks.\n */\nexport interface Plugin<TState = any> extends Hooks<TState> {\n  name: string;\n}\n\nexport type Brain<TState = any> = (\n  event: Event,\n  context: RuntimeContext<TState>\n) => AsyncGenerator<Event, NextAction | void, unknown>;\n\nexport interface Config<TState = any> {\n  actions: Record<string, Action<TState, any>>;\n  /**\n   * The central brain for handling incoming events.\n   */\n  brain?: Brain<TState>;\n  hooks?: Hooks<TState>;\n  plugins?: Plugin<TState>[];\n  safetyMaxSteps?: number;\n  starterPrompts?: Array<{\n    label: string;\n    prompt: string;\n    icon?: string;\n  }>;\n  options?: Array<{\n    id: string;\n    label: string;\n    options: Array<{ id: string; label: string; value: any }>;\n    type?: \"single\" | \"multiple\";\n    defaultSelectedIds?: string[];\n  }>;\n  fileAttachments?: {\n    enabled?: boolean;\n    accept?: string; // e.g., \"image/*,.pdf\" for file input accept attribute\n    maxFiles?: number; // Maximum number of files allowed\n    maxFileSize?: number; // Maximum file size in bytes\n  };\n}\n","import {\n  Action,\n  Event,\n  NextAction,\n  RuntimeContext,\n  Config,\n  Plugin,\n  ui,\n  HookGenerator,\n} from \"./types\";\nimport { generateId } from \"./utils/generate-id\";\nimport { z } from \"zod\";\n\n/**\n * Helper to check if a value is a Melony Event.\n */\nfunction isEvent(val: any): val is Event {\n  return val && typeof val === \"object\" && typeof val.type === \"string\";\n}\n\n/**\n * The Slim Runtime.\n * Single Responsibility: Orchestrate Event -> Action -> Event transitions.\n */\nexport class Runtime<TState = any> {\n  private config: Config<TState>;\n\n  constructor(config: Config<TState>) {\n    this.config = config;\n  }\n\n  public async *run(event: Event): AsyncGenerator<Event> {\n    const runId = event.runId ?? generateId();\n\n    const context: RuntimeContext<TState> = {\n      state: (event.state ?? {}) as TState,\n      runId,\n      stepCount: 0,\n      actions: this.config.actions,\n      ui,\n      suspend: (event?: Event) => {\n        throw event || { type: \"run-suspended\" };\n      },\n    };\n\n    try {\n      let nextAction: NextAction | void = undefined;\n\n      // 1. Trigger Plugins: onBeforeRun\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onBeforeRun) {\n          const result = yield* this.callHook(\n            plugin.onBeforeRun({ event }, context),\n            context\n          );\n          if (result) {\n            nextAction = result as NextAction;\n          }\n        }\n      }\n\n      // 2. Trigger Hook: onBeforeRun\n      if (this.config.hooks?.onBeforeRun) {\n        const result = yield* this.callHook(\n          this.config.hooks.onBeforeRun({ event }, context),\n          context\n        );\n        if (result) {\n          nextAction = result as NextAction;\n        }\n      }\n\n      yield* this.emit(\n        { type: \"run-started\", data: { inputEvent: 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(event, context);\n      }\n\n      // Agentic loop\n      while (nextAction) {\n        if (context.stepCount++ >= (this.config.safetyMaxSteps ?? 10)) {\n          yield* this.emit(\n            { type: \"error\", data: { message: \"Max steps exceeded\" } },\n            context\n          );\n          break;\n        }\n\n        const current: NextAction = nextAction;\n        nextAction = undefined; // Reset\n\n        // 1. Resolve Action\n        const actionName: string | undefined = current.action;\n\n        if (!actionName) {\n          yield* this.emit(\n            {\n              type: \"error\",\n              data: { message: \"No action name provided in NextAction\" },\n            },\n            context\n          );\n          break;\n        }\n\n        const action: Action<TState, 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                result,\n              },\n            },\n            context\n          );\n        } else {\n          // Simple mode: follow the action's own suggestion for the next step.\n          nextAction = result;\n        }\n      }\n\n      // 1. Trigger Plugins: onAfterRun\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onAfterRun) {\n          yield* this.callHook(plugin.onAfterRun(context), context);\n        }\n      }\n\n      // 2. Trigger Hook: onAfterRun\n      if (this.config.hooks?.onAfterRun) {\n        yield* this.callHook(this.config.hooks.onAfterRun(context), context);\n      }\n    } catch (error) {\n      let eventToEmit: Event | undefined;\n\n      if (isEvent(error)) {\n        eventToEmit = error;\n      } else {\n        // Wrap unexpected errors into an Event\n        eventToEmit = {\n          type: \"error\",\n          data: {\n            message: error instanceof Error ? error.message : String(error),\n            stack: error instanceof Error ? error.stack : undefined,\n          },\n        };\n      }\n\n      if (eventToEmit) {\n        yield* this.emit(eventToEmit, context);\n      }\n\n      return; // Gracefully stop the runtime\n    }\n  }\n\n  private async *dispatchToBrain(\n    event: Event,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event, NextAction | void> {\n    const generator = this.config.brain!(event, context);\n    while (true) {\n      const { value, done } = await generator.next();\n      if (done) return value as NextAction | void;\n      yield* this.emit(value as Event, context);\n    }\n  }\n\n  private async *executeAction(\n    action: Action<TState, any>,\n    nextAction: NextAction,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event, NextAction | void> {\n    const params = nextAction.params;\n\n    // 1. Trigger Plugins: onBeforeAction\n    for (const plugin of this.config.plugins || []) {\n      if (plugin.onBeforeAction) {\n        const hookResult = yield* this.callHook(\n          plugin.onBeforeAction({ action, params, nextAction }, context),\n          context\n        );\n        if (hookResult) {\n          nextAction = hookResult as NextAction;\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onBeforeAction\n    if (this.config.hooks?.onBeforeAction) {\n      const hookResult = yield* this.callHook(\n        this.config.hooks.onBeforeAction({ action, params, nextAction }, context),\n        context\n      );\n      if (hookResult) {\n        nextAction = hookResult as NextAction;\n      }\n    }\n\n    try {\n      const generator = action.execute(params, context);\n      let result: NextAction | void;\n\n      while (true) {\n        const { value, done } = await generator.next();\n        if (done) {\n          result = value as NextAction | void;\n          break;\n        }\n        yield* this.emit(value as Event, context);\n      }\n\n      // 3. Trigger Plugins: onAfterAction\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onAfterAction) {\n          const extra = yield* this.callHook(\n            plugin.onAfterAction({ action, data: result }, context),\n            context\n          );\n          if (extra) {\n            nextAction = extra as NextAction;\n          }\n        }\n      }\n\n      // 4. Trigger Hook: onAfterAction\n      if (this.config.hooks?.onAfterAction) {\n        const extra = yield* this.callHook(\n          this.config.hooks.onAfterAction({ action, data: result }, context),\n          context\n        );\n        if (extra) {\n          nextAction = extra as NextAction;\n        }\n      }\n\n      return result;\n    } catch (error) {\n      if (isEvent(error)) throw error;\n\n      throw {\n        type: \"error\",\n        data: {\n          action: action.name,\n          message: error instanceof Error ? error.message : String(error),\n          stack: error instanceof Error ? error.stack : undefined,\n        },\n      };\n    }\n  }\n\n  /**\n   * Internal helper to call a hook (generator) and yield its events.\n   */\n  private async *callHook<T>(\n    generator: HookGenerator<T> | undefined,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event, T | void> {\n    if (!generator) return;\n\n    while (true) {\n      const { value, done } = await generator.next();\n      if (done) return value as T | void;\n      yield* this.emit(value as Event, context);\n    }\n  }\n\n  /**\n   * Internal helper to yield an event and trigger the onEvent hook.\n   */\n  private async *emit(\n    event: Event,\n    context: RuntimeContext<TState>\n  ): AsyncGenerator<Event> {\n    const finalEvent = {\n      ...event,\n      runId: context.runId,\n      timestamp: event.timestamp ?? Date.now(),\n      role: event.role ?? \"assistant\",\n      state: context.state,\n    };\n\n    // Yield the actual event first\n    yield finalEvent;\n\n    // 1. Trigger Plugins: onEvent\n    for (const plugin of this.config.plugins || []) {\n      if (plugin.onEvent) {\n        const generator = plugin.onEvent(finalEvent, context);\n        for await (const extra of generator) {\n          yield { ...extra, runId: context.runId, timestamp: Date.now() };\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onEvent for side-effects or extra events\n    if (this.config.hooks?.onEvent) {\n      const generator = this.config.hooks.onEvent(finalEvent, context);\n      for await (const extra of generator) {\n        // Yield extra event from hook, ensuring it has required metadata\n        yield { ...extra, runId: context.runId, timestamp: Date.now() };\n      }\n    }\n  }\n}\n\nexport const melony = <TState = any>(config: Config<TState>) => {\n  const runtime = new Runtime<TState>(config);\n  return {\n    config,\n    run: runtime.run.bind(runtime),\n  };\n};\n\n/**\n * Helper to define an action with full type inference.\n */\nexport const action = <TState = any, T extends z.ZodSchema = z.ZodSchema>(\n  config: Action<TState, T>\n): Action<TState, T> => config;\n\n/**\n * Helper to define a plugin.\n */\nexport const plugin = <TState = any>(config: Plugin<TState>): Plugin<TState> =>\n  config;\n"]}

package/dist/client.d.ts

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as Config, E as Event, A as Action, P as Plugin } from './types-D8iQuUwX.js';
-export { H as HookGenerator, 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-D8iQuUwX.js';
+import { C as Config, E as Event, A as Action, P as Plugin } from './types-BF5vGIfM.js';
+export { i as ActionExecute, B as Brain, H as HookGenerator, k as Hooks, N as NextAction, R as Role, j as RuntimeContext, a as UIAlign, e as UIColor, g as UIContract, b as UIJustify, h as UINode, d as UIOrientation, U as UISize, f as UISpacing, c as UIWrap, u as ui } from './types-BF5vGIfM.js';
 import { z } from 'zod';
 export { g as generateId } from './generate-id-DU8kwYc2.js';
 
@@ -7,12 +7,10 @@ export { g as generateId } from './generate-id-DU8kwYc2.js';
  * The Slim Runtime.
  * Single Responsibility: Orchestrate Event -> Action -> Event transitions.
  */
-declare class Runtime {
+declare class Runtime<TState = any> {
     private config;
-    constructor(config: Config);
-    run(input: {
-        event: Event;
-    }): AsyncGenerator<Event>;
+    constructor(config: Config<TState>);
+    run(event: Event): AsyncGenerator<Event>;
     private dispatchToBrain;
     private executeAction;
     /**
@@ -24,20 +22,18 @@ declare class Runtime {
      */
     private emit;
 }
-declare const melony: (config: Config) => {
-    config: Config;
-    run: (input: {
-        event: Event;
-    }) => AsyncGenerator<Event>;
+declare const melony: <TState = any>(config: Config<TState>) => {
+    config: Config<TState>;
+    run: (event: Event) => AsyncGenerator<Event>;
 };
 /**
  * Helper to define an action with full type inference.
  */
-declare const action: <T extends z.ZodSchema>(config: Action<T>) => Action<T>;
+declare const action: <TState = any, T extends z.ZodSchema = z.ZodSchema>(config: Action<TState, T>) => Action<TState, T>;
 /**
  * Helper to define a plugin.
  */
-declare const plugin: (config: Plugin) => Plugin;
+declare const plugin: <TState = any>(config: Plugin<TState>) => Plugin<TState>;
 
 /**
  * Convert an async generator of events to an HTTP streaming response

package/dist/index.js

@@ -1,5 +1,5 @@
 export { createStreamResponse } from './chunk-CFG7FFEZ.js';
-export { Runtime, action, melony, plugin, ui } from './chunk-NQ2SOCUO.js';
+export { Runtime, action, melony, plugin, ui } from './chunk-H5YOYQV4.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-D8iQuUwX.js';
+import { A as Action, j as RuntimeContext, P as Plugin } from '../types-BF5vGIfM.js';
 import 'zod';
 
 interface RequireApprovalOptions {
@@ -20,12 +20,12 @@ interface RequireApprovalOptions {
     /**
      * Optional condition to check if approval is needed dynamically.
      */
-    shouldApprove?: (action: Action<any>, params: any, context: RuntimeContext) => boolean | Promise<boolean>;
+    shouldApprove?: (action: Action<any, any>, params: any, context: RuntimeContext) => boolean | Promise<boolean>;
 }
 /**
  * A plugin that intercepts actions and requires human approval before execution.
  * It uses SDUI to prompt the user and handles the resumption of the agentic loop.
  */
-declare const requireApproval: (options?: RequireApprovalOptions) => Plugin;
+declare const requireApproval: (options?: RequireApprovalOptions) => Plugin<any>;
 
 export { type RequireApprovalOptions, requireApproval };

package/dist/plugins/require-approval.js

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

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/plugins/require-approval.ts"],"names":[],"mappings":"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","file":"require-approval.js","sourcesContent":["import { plugin } from \"../runtime\";\nimport { ui } from \"../types\";\nimport type { Action, RuntimeContext } from \"../types\";\n\nexport interface RequireApprovalOptions {\n  /**\n   * List of action names that require explicit approval.\n   * If not provided, all actions will require approval.\n   */\n  actions?: string[];\n\n  /**\n   * Optional secret to sign the approval payload.\n   * If provided, the plugin will verify that the parameters haven't been\n   * tampered with between the request and the approval.\n   */\n  secret?: string;\n\n  /**\n   * Custom message to show in the approval card.\n   */\n  message?: string | ((action: string, params: any) => string);\n\n  /**\n   * Optional condition to check if approval is needed dynamically.\n   */\n  shouldApprove?: (\n    action: Action<any>,\n    params: any,\n    context: RuntimeContext\n  ) => boolean | Promise<boolean>;\n}\n\n/**\n * A plugin that intercepts actions and requires human approval before execution.\n * It uses SDUI to prompt the user and handles the resumption of the agentic loop.\n */\nexport const requireApproval = (options: RequireApprovalOptions = {}) => {\n  return plugin({\n    name: \"require-approval\",\n\n    /**\n     * Step 1: Handle the resumption when the user clicks \"Approve\" or \"Cancel\".\n     * We verify the one-time-use approvalId to prevent replay attacks or double-clicks.\n     */\n    onBeforeRun: async function* ({ event }, context) {\n      if (\n        event.type === \"action-approved\" ||\n        event.type === \"action-rejected\"\n      ) {\n        const { 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              yield {\n                type: \"error\",\n                data: {\n                  message:\n                    \"Security Warning: Approval token mismatch. Execution blocked.\",\n                },\n              };\n              return;\n            }\n          }\n\n          // 4. Store approval in ephemeral state for the upcoming action execution\n          context.state.__approved_action = { action, params };\n\n          // 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 function* ({ action, params, nextAction }, context) {\n      // 1. Check if this action needs approval\n      const isTargetAction =\n        !options.actions || options.actions.includes(action.name);\n      if (!isTargetAction) return;\n\n      if (options.shouldApprove) {\n        const needsApproval = await options.shouldApprove(\n          action,\n          params,\n          context\n        );\n        if (!needsApproval) return;\n      }\n\n      // 2. Check if it was ALREADY approved in this run\n      const approval = context.state.__approved_action;\n      if (\n        approval &&\n        approval.action === action.name &&\n        JSON.stringify(approval.params) === JSON.stringify(params)\n      ) {\n        delete context.state.__approved_action;\n        return; // Proceed to execution\n      }\n\n      // 3. Suspend and request approval with a one-time-use nonce\n      const approvalId = Math.random().toString(36).substring(2, 15);\n      context.state.__pending_approvals =\n        context.state.__pending_approvals || {};\n      context.state.__pending_approvals[approvalId] = true;\n\n      const token = options.secret\n        ? await signPayload(\n            { action: action.name, params, approvalId },\n            options.secret\n          )\n        : undefined;\n\n      const message =\n        typeof options.message === \"function\"\n          ? options.message(action.name, params)\n          : options.message ||\n            `The agent wants to execute **${action.name}**. Do you approve?`;\n\n      context.suspend({\n        type: \"hitl-required\",\n        data: { ...nextAction, token, approvalId },\n        slot: \"approval\",\n        ui: ui.card({\n          title: \"Approval Required\",\n          children: [\n            ui.text(message),\n            ui.box({\n              padding: \"md\",\n              background: \"muted\",\n              children: [\n                ui.text(JSON.stringify(params, null, 2), { size: \"xs\" }),\n              ],\n            }),\n            ui.row({\n              gap: \"md\",\n              children: [\n                ui.button({\n                  label: \"Approve\",\n                  variant: \"success\",\n                  onClickAction: {\n                    role: \"user\",\n                    type: \"action-approved\",\n                    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, any>,\n    params: any,\n    context: RuntimeContext\n  ) => boolean | Promise<boolean>;\n}\n\n/**\n * A plugin that intercepts actions and requires human approval before execution.\n * It uses SDUI to prompt the user and handles the resumption of the agentic loop.\n */\nexport const requireApproval = (options: RequireApprovalOptions = {}) => {\n  return plugin({\n    name: \"require-approval\",\n\n    /**\n     * Step 1: Handle the resumption when the user clicks \"Approve\" or \"Cancel\".\n     * We verify the one-time-use approvalId to prevent replay attacks or double-clicks.\n     */\n    onBeforeRun: async function* ({ event }, context) {\n      if (\n        event.type === \"action-approved\" ||\n        event.type === \"action-rejected\"\n      ) {\n        const { 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              yield {\n                type: \"error\",\n                data: {\n                  message:\n                    \"Security Warning: Approval token mismatch. Execution blocked.\",\n                },\n              };\n              return;\n            }\n          }\n\n          // 4. Store approval in ephemeral state for the upcoming action execution\n          context.state.__approved_action = { action, params };\n\n          // 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 function* ({ action, params, nextAction }, context) {\n      // 1. Check if this action needs approval\n      const isTargetAction =\n        !options.actions || options.actions.includes(action.name);\n      if (!isTargetAction) return;\n\n      if (options.shouldApprove) {\n        const needsApproval = await options.shouldApprove(\n          action,\n          params,\n          context\n        );\n        if (!needsApproval) return;\n      }\n\n      // 2. Check if it was ALREADY approved in this run\n      const approval = context.state.__approved_action;\n      if (\n        approval &&\n        approval.action === action.name &&\n        JSON.stringify(approval.params) === JSON.stringify(params)\n      ) {\n        delete context.state.__approved_action;\n        return; // Proceed to execution\n      }\n\n      // 3. Suspend and request approval with a one-time-use nonce\n      const approvalId = Math.random().toString(36).substring(2, 15);\n      context.state.__pending_approvals =\n        context.state.__pending_approvals || {};\n      context.state.__pending_approvals[approvalId] = true;\n\n      const token = options.secret\n        ? await signPayload(\n            { action: action.name, params, approvalId },\n            options.secret\n          )\n        : undefined;\n\n      const message =\n        typeof options.message === \"function\"\n          ? options.message(action.name, params)\n          : options.message ||\n            `The agent wants to execute **${action.name}**. Do you approve?`;\n\n      context.suspend({\n        type: \"hitl-required\",\n        data: { ...nextAction, token, approvalId },\n        slot: \"approval\",\n        ui: ui.card({\n          title: \"Approval Required\",\n          children: [\n            ui.text(message),\n            ui.box({\n              padding: \"md\",\n              background: \"muted\",\n              children: [\n                ui.text(JSON.stringify(params, null, 2), { size: \"xs\" }),\n              ],\n            }),\n            ui.row({\n              gap: \"md\",\n              children: [\n                ui.button({\n                  label: \"Approve\",\n                  variant: \"success\",\n                  onClickAction: {\n                    role: \"user\",\n                    type: \"action-approved\",\n                    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-D8iQuUwX.d.ts → types-BF5vGIfM.d.ts}

@@ -213,11 +213,12 @@ type Event = {
     role?: Role;
     state?: any;
 };
-interface Action<TParams extends z.ZodSchema = z.ZodObject<any>> {
+type ActionExecute<TState = any, TParams extends z.ZodSchema = z.ZodSchema> = (params: z.infer<TParams>, context: RuntimeContext<TState>) => AsyncGenerator<Event, NextAction | void, unknown>;
+interface Action<TState = any, TParams extends z.ZodSchema = z.ZodSchema> {
     name: string;
     description?: string;
     paramsSchema: TParams;
-    execute: (params: z.infer<TParams>, context: RuntimeContext) => AsyncGenerator<Event, NextAction | void, unknown>;
+    execute: ActionExecute<TState, TParams>;
 }
 interface NextAction {
     action?: string;
@@ -229,7 +230,7 @@ interface RuntimeContext<TState = any> {
     state: TState;
     runId: string;
     stepCount: number;
-    actions: Record<string, Action<any>>;
+    actions: Record<string, Action<TState, any>>;
     ui: typeof ui;
     /**
      * Immediately interrupts the runtime execution.
@@ -242,53 +243,54 @@ interface RuntimeContext<TState = any> {
  * Now a generator to allow yielding multiple events and returning a result.
  */
 type HookGenerator<TReturn = void> = AsyncGenerator<Event, TReturn | void, unknown>;
-interface Hooks {
+interface Hooks<TState = any> {
     /**
      * Called when a run session begins.
      * Can yield Events to be emitted, and return a NextAction to jump-start the loop.
      */
     onBeforeRun?: (input: {
         event: Event;
-    }, context: RuntimeContext) => HookGenerator<NextAction>;
+    }, context: RuntimeContext<TState>) => HookGenerator<NextAction>;
     /**
      * Called when a run session completes.
      */
-    onAfterRun?: (context: RuntimeContext) => HookGenerator;
+    onAfterRun?: (context: RuntimeContext<TState>) => HookGenerator;
     /**
      * Called whenever an event is yielded by the runtime.
      */
-    onEvent?: (event: Event, context: RuntimeContext) => HookGenerator;
+    onEvent?: (event: Event, context: RuntimeContext<TState>) => HookGenerator;
     /**
      * Called before an action is executed.
      * Yield events to intercept, and return a NextAction to redirect/suspend.
      */
     onBeforeAction?: (call: {
-        action: Action<any>;
+        action: Action<TState, any>;
         params: any;
         nextAction: NextAction;
-    }, context: RuntimeContext) => HookGenerator<NextAction>;
+    }, context: RuntimeContext<TState>) => HookGenerator<NextAction>;
     /**
      * Called after an action completes.
      */
     onAfterAction?: (result: {
-        action: Action<any>;
+        action: Action<TState, any>;
         data: NextAction | void;
-    }, context: RuntimeContext) => HookGenerator<NextAction>;
+    }, context: RuntimeContext<TState>) => HookGenerator<NextAction>;
 }
 /**
  * A plugin is just a named set of hooks.
  */
-interface Plugin extends Hooks {
+interface Plugin<TState = any> extends Hooks<TState> {
     name: string;
 }
-interface Config {
-    actions: Record<string, Action<any>>;
+type Brain<TState = any> = (event: Event, context: RuntimeContext<TState>) => AsyncGenerator<Event, NextAction | void, unknown>;
+interface Config<TState = any> {
+    actions: Record<string, Action<TState, any>>;
     /**
      * The central brain for handling incoming events.
      */
-    brain?: (event: Event, context: RuntimeContext) => AsyncGenerator<Event, NextAction | void, unknown>;
-    hooks?: Hooks;
-    plugins?: Plugin[];
+    brain?: Brain<TState>;
+    hooks?: Hooks<TState>;
+    plugins?: Plugin<TState>[];
     safetyMaxSteps?: number;
     starterPrompts?: Array<{
         label: string;
@@ -314,4 +316,4 @@ interface Config {
     };
 }
 
-export { type Action as A, type Config as C, type Event as E, type HookGenerator as H, type NextAction as N, type Plugin as P, type Role as R, type UISize as U, type UIAlign as a, type UIJustify as b, type UIWrap as c, type UIOrientation as d, type UIColor as e, type UISpacing as f, type UIContract as g, type UINode as h, type RuntimeContext as i, type Hooks as j, ui as u };
+export { type Action as A, type Brain as B, type Config as C, type Event as E, type HookGenerator as H, type NextAction as N, type Plugin as P, type Role as R, type UISize as U, type UIAlign as a, type UIJustify as b, type UIWrap as c, type UIOrientation as d, type UIColor as e, type UISpacing as f, type UIContract as g, type UINode as h, type ActionExecute as i, type RuntimeContext as j, type Hooks as k, ui as u };

package/package.json

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

package/dist/chunk-NQ2SOCUO.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types.ts","../src/runtime.ts"],"names":["plugin","action"],"mappings":"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","file":"chunk-NQ2SOCUO.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 => ({\n      type: \"client:navigate\",\n      data: { url },\n    }),\n    openUrl: (url: string, target = \"_blank\"): Event => ({\n      type: \"client:open-url\",\n      data: { url, target },\n    }),\n    copy: (text: string): Event => ({ type: \"client:copy\", data: { text } }),\n    reset: (): Event => ({ type: \"client:reset\" }),\n  },\n};\n\n// ============================================\n// Events\n// ============================================\n\nexport type Role = \"user\" | \"assistant\" | \"system\";\n\nexport type Event = {\n  type: string;\n  data?: any;\n  ui?: UINode;\n  slot?: string;\n  runId?: string;\n  threadId?: string;\n  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.\n * Now a generator to allow yielding multiple events and returning a result.\n */\nexport type HookGenerator<TReturn = void> = AsyncGenerator<\n  Event,\n  TReturn | void,\n  unknown\n>;\n\nexport interface Hooks {\n  /**\n   * Called when a run session begins.\n   * Can yield Events to be emitted, and return a NextAction to jump-start the loop.\n   */\n  onBeforeRun?: (\n    input: { event: Event },\n    context: RuntimeContext\n  ) => HookGenerator<NextAction>;\n\n  /**\n   * Called when a run session completes.\n   */\n  onAfterRun?: (context: RuntimeContext) => HookGenerator;\n\n  /**\n   * Called whenever an event is yielded by the runtime.\n   */\n  onEvent?: (event: Event, context: RuntimeContext) => HookGenerator;\n\n  /**\n   * Called before an action is executed.\n   * Yield events to intercept, and return a NextAction to redirect/suspend.\n   */\n  onBeforeAction?: (\n    call: { action: Action<any>; params: any; nextAction: NextAction },\n    context: RuntimeContext\n  ) => HookGenerator<NextAction>;\n\n  /**\n   * Called after an action completes.\n   */\n  onAfterAction?: (\n    result: { action: Action<any>; data: NextAction | void },\n    context: RuntimeContext\n  ) => HookGenerator<NextAction>;\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  HookGenerator,\n} from \"./types\";\nimport { generateId } from \"./utils/generate-id\";\nimport { z } from \"zod\";\n\n/**\n * Helper to check if a value is a Melony Event.\n */\nfunction isEvent(val: any): val is Event {\n  return val && typeof val === \"object\" && typeof val.type === \"string\";\n}\n\n/**\n * The Slim Runtime.\n * Single Responsibility: Orchestrate Event -> Action -> Event transitions.\n */\nexport class Runtime {\n  private config: Config;\n\n  constructor(config: Config) {\n    this.config = config;\n  }\n\n  public async *run(input: {\n    event: Event;\n  }): AsyncGenerator<Event> {\n    const runId = input.event.runId ?? generateId();\n\n    const context: RuntimeContext = {\n      state: input.event.state ?? {},\n      runId,\n      stepCount: 0,\n      actions: this.config.actions,\n      ui,\n      suspend: (event?: Event) => {\n        throw event || { type: \"run-suspended\" };\n      },\n    };\n\n    try {\n      let nextAction: NextAction | void = undefined;\n\n      // 1. Trigger Plugins: onBeforeRun\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onBeforeRun) {\n          const result = yield* this.callHook(\n            plugin.onBeforeRun({ event: input.event }, context),\n            context\n          );\n          if (result) {\n            nextAction = result as NextAction;\n          }\n        }\n      }\n\n      // 2. Trigger Hook: onBeforeRun\n      if (this.config.hooks?.onBeforeRun) {\n        const result = yield* this.callHook(\n          this.config.hooks.onBeforeRun({ event: input.event }, context),\n          context\n        );\n        if (result) {\n          nextAction = result as NextAction;\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          yield* this.callHook(plugin.onAfterRun(context), context);\n        }\n      }\n\n      // 2. Trigger Hook: onAfterRun\n      if (this.config.hooks?.onAfterRun) {\n        yield* this.callHook(this.config.hooks.onAfterRun(context), context);\n      }\n    } catch (error) {\n      let eventToEmit: Event | undefined;\n\n      if (isEvent(error)) {\n        eventToEmit = error;\n      } else {\n        // Wrap unexpected errors into an Event\n        eventToEmit = {\n          type: \"error\",\n          data: {\n            message: error instanceof Error ? error.message : String(error),\n            stack: error instanceof Error ? error.stack : undefined,\n          },\n        };\n      }\n\n      if (eventToEmit) {\n        yield* this.emit(eventToEmit, context);\n      }\n\n      return; // Gracefully stop the runtime\n    }\n  }\n\n  private async *dispatchToBrain(\n    event: Event,\n    context: RuntimeContext\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 = yield* this.callHook(\n          plugin.onBeforeAction({ action, params, nextAction }, context),\n          context\n        );\n        if (hookResult) {\n          nextAction = hookResult as NextAction;\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onBeforeAction\n    if (this.config.hooks?.onBeforeAction) {\n      const hookResult = yield* this.callHook(\n        this.config.hooks.onBeforeAction({ action, params, nextAction }, context),\n        context\n      );\n      if (hookResult) {\n        nextAction = hookResult as NextAction;\n      }\n    }\n\n    try {\n      const generator = action.execute(params, context);\n      let result: NextAction | void;\n\n      while (true) {\n        const { value, done } = await generator.next();\n        if (done) {\n          result = value as NextAction | void;\n          break;\n        }\n        yield* this.emit(value as Event, context);\n      }\n\n      // 3. Trigger Plugins: onAfterAction\n      for (const plugin of this.config.plugins || []) {\n        if (plugin.onAfterAction) {\n          const extra = yield* this.callHook(\n            plugin.onAfterAction({ action, data: result }, context),\n            context\n          );\n          if (extra) {\n            nextAction = extra as NextAction;\n          }\n        }\n      }\n\n      // 4. Trigger Hook: onAfterAction\n      if (this.config.hooks?.onAfterAction) {\n        const extra = yield* this.callHook(\n          this.config.hooks.onAfterAction({ action, data: result }, context),\n          context\n        );\n        if (extra) {\n          nextAction = extra as NextAction;\n        }\n      }\n\n      return result;\n    } catch (error) {\n      if (isEvent(error)) throw error;\n\n      throw {\n        type: \"error\",\n        data: {\n          action: action.name,\n          message: error instanceof Error ? error.message : String(error),\n          stack: error instanceof Error ? error.stack : undefined,\n        },\n      };\n    }\n  }\n\n  /**\n   * Internal helper to call a hook (generator) and yield its events.\n   */\n  private async *callHook<T>(\n    generator: HookGenerator<T> | undefined,\n    context: RuntimeContext\n  ): AsyncGenerator<Event, T | void> {\n    if (!generator) return;\n\n    while (true) {\n      const { value, done } = await generator.next();\n      if (done) return value as T | void;\n      yield* this.emit(value as Event, context);\n    }\n  }\n\n  /**\n   * Internal helper to yield an event and trigger the onEvent hook.\n   */\n  private async *emit(\n    event: Event,\n    context: RuntimeContext\n  ): AsyncGenerator<Event> {\n    const finalEvent = {\n      ...event,\n      runId: context.runId,\n      timestamp: event.timestamp ?? Date.now(),\n      role: event.role ?? \"assistant\",\n      state: context.state,\n    };\n\n    // Yield the actual event first\n    yield finalEvent;\n\n    // 1. Trigger Plugins: onEvent\n    for (const plugin of this.config.plugins || []) {\n      if (plugin.onEvent) {\n        const generator = plugin.onEvent(finalEvent, context);\n        for await (const extra of generator) {\n          yield { ...extra, runId: context.runId, timestamp: Date.now() };\n        }\n      }\n    }\n\n    // 2. Trigger Hook: onEvent for side-effects or extra events\n    if (this.config.hooks?.onEvent) {\n      const generator = this.config.hooks.onEvent(finalEvent, context);\n      for await (const extra of generator) {\n        // Yield extra event from hook, ensuring it has required metadata\n        yield { ...extra, runId: context.runId, timestamp: Date.now() };\n      }\n    }\n  }\n}\n\nexport const melony = (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"]}