melony 0.1.14 → 0.1.16

package/dist/chunk-WCI7WEZW.js

@@ -0,0 +1,315 @@
+import { generateId } from './chunk-WAI5H335.js';
+
+// src/types.ts
+var ui = {
+  card: (props) => {
+    const { children, ...rest } = props;
+    return { type: "card", props: rest, children };
+  },
+  row: (props) => {
+    const { children, ...rest } = props;
+    return { type: "row", props: rest, children };
+  },
+  col: (props) => {
+    const { children, ...rest } = props;
+    return { type: "col", props: rest, children };
+  },
+  box: (props) => {
+    const { children, ...rest } = props;
+    return { type: "box", props: rest, children };
+  },
+  spacer: (props) => ({
+    type: "spacer",
+    props
+  }),
+  divider: (props) => ({
+    type: "divider",
+    props
+  }),
+  text: (value, props) => ({
+    type: "text",
+    props: { ...props, value }
+  }),
+  heading: (value, level = 1) => ({
+    type: "heading",
+    props: { value, level }
+  }),
+  badge: (label, variant = "primary", size = "md") => ({
+    type: "badge",
+    props: { label, variant, size }
+  }),
+  image: (src, alt, size = "md") => ({
+    type: "image",
+    props: { src, alt, size }
+  }),
+  icon: (name, size = "md", color) => ({
+    type: "icon",
+    props: { name, size, color }
+  }),
+  chart: (props) => ({
+    type: "chart",
+    props
+  }),
+  list: (children) => ({
+    type: "list",
+    children
+  }),
+  listItem: (props) => {
+    const { children, ...rest } = props;
+    return { type: "listItem", props: rest, children };
+  },
+  form: (props) => {
+    const { children, ...rest } = props;
+    return { type: "form", props: rest, children };
+  },
+  input: (props) => ({
+    type: "input",
+    props
+  }),
+  textarea: (props) => ({
+    type: "textarea",
+    props
+  }),
+  select: (props) => ({
+    type: "select",
+    props
+  }),
+  checkbox: (props) => ({
+    type: "checkbox",
+    props
+  }),
+  radioGroup: (props) => ({
+    type: "radioGroup",
+    props
+  }),
+  label: (value, props) => ({
+    type: "label",
+    props: { ...props, value }
+  }),
+  button: (props) => ({
+    type: "button",
+    props
+  })
+};
+
+// src/runtime.ts
+var Runtime = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async *run(input) {
+    const runId = input.runId ?? generateId();
+    const context = {
+      state: input.state ?? {},
+      runId,
+      stepCount: 0,
+      isDone: false,
+      actions: this.config.actions,
+      ui,
+      suspend: () => {
+        context.isDone = true;
+      }
+    };
+    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
+      );
+      if (result) {
+        if ("type" in result) {
+          yield* this.emit(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 (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);
+      }
+    }
+    if (this.config.hooks?.onAfterRun) {
+      const extra = await this.config.hooks.onAfterRun(context);
+      if (extra) yield* this.emit(extra, context);
+    }
+  }
+  async *dispatchToBrain(event, context) {
+    const generator = this.config.brain(event, context);
+    while (true) {
+      const { value, done } = await generator.next();
+      if (done) return value;
+      yield* this.emit(value, context);
+    }
+  }
+  async *executeAction(action2, nextAction, context) {
+    const params = nextAction.params;
+    for (const plugin2 of this.config.plugins || []) {
+      if (plugin2.onBeforeAction) {
+        const hookResult = await plugin2.onBeforeAction(
+          { action: action2, params, nextAction },
+          context
+        );
+        if (hookResult) {
+          yield* this.emit(hookResult, context);
+          if (context.isDone) return;
+        }
+      }
+    }
+    if (this.config.hooks?.onBeforeAction) {
+      const hookResult = await this.config.hooks.onBeforeAction(
+        { action: action2, params, nextAction },
+        context
+      );
+      if (hookResult) {
+        yield* this.emit(hookResult, context);
+        if (context.isDone) return;
+      }
+    }
+    try {
+      const generator = action2.execute(params, context);
+      let result;
+      while (true) {
+        const { value, done } = await generator.next();
+        if (done) {
+          result = value;
+          break;
+        }
+        yield* this.emit(value, context);
+        if (context.isDone) return;
+      }
+      for (const plugin2 of this.config.plugins || []) {
+        if (plugin2.onAfterAction) {
+          const extra = await plugin2.onAfterAction(
+            { action: action2, data: result },
+            context
+          );
+          if (extra) yield* this.emit(extra, context);
+        }
+      }
+      if (this.config.hooks?.onAfterAction) {
+        const extra = await this.config.hooks.onAfterAction(
+          { action: action2, data: result },
+          context
+        );
+        if (extra) yield* this.emit(extra, context);
+      }
+      return result;
+    } catch (error) {
+      yield* this.emit(
+        {
+          type: "error",
+          data: {
+            action: action2.name,
+            error: error instanceof Error ? error.message : String(error)
+          }
+        },
+        context
+      );
+    }
+  }
+  /**
+   * Internal helper to yield an event and trigger the onEvent hook.
+   */
+  async *emit(event, context) {
+    const finalEvent = {
+      ...event,
+      runId: context.runId,
+      timestamp: event.timestamp ?? Date.now(),
+      role: event.role ?? "assistant"
+    };
+    yield finalEvent;
+    for (const plugin2 of this.config.plugins || []) {
+      if (plugin2.onEvent) {
+        const extra = await plugin2.onEvent(finalEvent, context);
+        if (extra) {
+          yield { ...extra, runId: context.runId, timestamp: Date.now() };
+        }
+      }
+    }
+    if (this.config.hooks?.onEvent) {
+      const extra = await this.config.hooks.onEvent(finalEvent, context);
+      if (extra) {
+        yield { ...extra, runId: context.runId, timestamp: Date.now() };
+      }
+    }
+  }
+};
+var melony = (config) => {
+  const runtime = new Runtime(config);
+  return {
+    config,
+    run: runtime.run.bind(runtime)
+  };
+};
+var action = (config) => config;
+var plugin = (config) => config;
+
+export { Runtime, action, melony, plugin, ui };
+//# sourceMappingURL=chunk-WCI7WEZW.js.map
+//# sourceMappingURL=chunk-WCI7WEZW.js.map

package/dist/chunk-WCI7WEZW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/runtime.ts"],"names":["plugin","action"],"mappings":"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","file":"chunk-WCI7WEZW.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?: \"primary\" | \"secondary\" | \"success\" | \"danger\" | \"outline\" | \"ghost\" | \"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: (props: UIContract[\"card\"] & { children?: UINode<any>[] }): UINode<\"card\"> => {\n    const { children, ...rest } = props;\n    return { type: \"card\", props: rest, children };\n  },\n  row: (props: UIContract[\"row\"] & { children?: UINode<any>[] }): UINode<\"row\"> => {\n    const { children, ...rest } = props;\n    return { type: \"row\", props: rest, children };\n  },\n  col: (props: UIContract[\"col\"] & { children?: UINode<any>[] }): UINode<\"col\"> => {\n    const { children, ...rest } = props;\n    return { type: \"col\", props: rest, children };\n  },\n  box: (props: UIContract[\"box\"] & { children?: UINode<any>[] }): UINode<\"box\"> => {\n    const { children, ...rest } = props;\n    return { type: \"box\", props: rest, children };\n  },\n  spacer: (props: UIContract[\"spacer\"]): UINode<\"spacer\"> => ({\n    type: \"spacer\",\n    props,\n  }),\n  divider: (props: UIContract[\"divider\"]): UINode<\"divider\"> => ({\n    type: \"divider\",\n    props,\n  }),\n  text: (\n    value: string,\n    props?: Omit<UIContract[\"text\"], \"value\">\n  ): UINode<\"text\"> => ({\n    type: \"text\",\n    props: { ...props, value },\n  }),\n  heading: (\n    value: string,\n    level: UIContract[\"heading\"][\"level\"] = 1\n  ): UINode<\"heading\"> => ({\n    type: \"heading\",\n    props: { value, level },\n  }),\n  badge: (\n    label: string,\n    variant: UIContract[\"badge\"][\"variant\"] = \"primary\",\n    size: UISize = \"md\"\n  ): UINode<\"badge\"> => ({\n    type: \"badge\",\n    props: { label, variant, size },\n  }),\n  image: (\n    src: string,\n    alt?: string,\n    size: UISize = \"md\"\n  ): 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: (props: UIContract[\"form\"] & { children?: UINode<any>[] }): 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  timestamp?: number;\n  role?: Role;\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}\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      // 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    };\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"]}

package/dist/client.d.ts

@@ -1,11 +1,15 @@
-import { E as Event } from './generate-id-CUOAZU5w.js';
-export { k as generateId } from './generate-id-CUOAZU5w.js';
+import { E as Event } from './types-BC3dKPi6.js';
+export { g as generateId } from './generate-id-DU8kwYc2.js';
 import 'zod';
 
 interface ClientState {
     events: Event[];
     isLoading: boolean;
     error: Error | null;
+    loadingStatus?: {
+        message: string;
+        details?: string;
+    };
 }
 declare class MelonyClient {
     private transport;
@@ -20,6 +24,10 @@ declare class MelonyClient {
         events: Event[];
         isLoading: boolean;
         error: Error | null;
+        loadingStatus?: {
+            message: string;
+            details?: string;
+        };
     };
     private setState;
     sendEvent(event: Event, options?: {

package/dist/client.js

@@ -10,7 +10,8 @@ var MelonyClient = class {
     this.state = {
       events: options?.initialEvents ?? [],
       isLoading: false,
-      error: null
+      error: null,
+      loadingStatus: void 0
     };
   }
   subscribe(listener) {
@@ -39,6 +40,7 @@ var MelonyClient = class {
     this.setState({
       isLoading: true,
       error: null,
+      loadingStatus: void 0,
       events: [...this.state.events, optimisticEvent]
     });
     try {
@@ -66,19 +68,36 @@ var MelonyClient = class {
           }
         }
       }
-      this.setState({ isLoading: false });
+      this.setState({ isLoading: false, loadingStatus: void 0 });
     } catch (err) {
       if (err instanceof Error && err.name === "AbortError") {
-        this.setState({ isLoading: false });
+        this.setState({ isLoading: false, loadingStatus: void 0 });
         return;
       }
       const error = err instanceof Error ? err : new Error(String(err));
-      this.setState({ error, isLoading: false });
+      this.setState({ error, isLoading: false, loadingStatus: void 0 });
       throw error;
     }
   }
   handleIncomingEvent(event) {
     const events = [...this.state.events];
+    if (event.type === "loading-status") {
+      const currentStatus = this.state.loadingStatus;
+      const newMessage = event.data?.message ?? currentStatus?.message ?? "Processing...";
+      const newDelta = event.data?.delta;
+      let newDetails = currentStatus?.details ?? "";
+      if (newDelta !== void 0) {
+        newDetails += newDelta;
+      } else if (event.data?.details !== void 0) {
+        newDetails = event.data.details;
+      }
+      this.setState({
+        loadingStatus: {
+          message: newMessage,
+          details: newDetails || void 0
+        }
+      });
+    }
     const lastEvent = events[events.length - 1];
     if (event.type === "text-delta" && lastEvent?.type === "text-delta" && event.runId === lastEvent.runId && event.data?.delta) {
       events[events.length - 1] = {
@@ -95,7 +114,7 @@ var MelonyClient = class {
   }
   reset(events = []) {
     if (this.abortController) this.abortController.abort();
-    this.setState({ events, error: null, isLoading: false });
+    this.setState({ events, error: null, isLoading: false, loadingStatus: void 0 });
   }
 };
 function createHttpTransport(api) {

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":";;;;AAYO,IAAM,eAAN,MAAmB;AAAA,EAMxB,WAAA,CAAY,WAAwB,OAAA,EAAuC;AAH3E,IAAA,IAAA,CAAQ,eAAA,GAA0C,IAAA;AAClD,IAAA,IAAA,CAAQ,cAAA,uBAAwD,GAAA,EAAI;AAGlE,IAAA,IAAA,CAAK,SAAA,GAAY,SAAA;AACjB,IAAA,IAAA,CAAK,KAAA,GAAQ;AAAA,MACX,MAAA,EAAQ,OAAA,EAAS,aAAA,IAAiB,EAAC;AAAA,MACnC,SAAA,EAAW,KAAA;AAAA,MACX,KAAA,EAAO;AAAA,KACT;AAAA,EACF;AAAA,EAEA,UAAU,QAAA,EAAwC;AAChD,IAAA,IAAA,CAAK,cAAA,CAAe,IAAI,QAAQ,CAAA;AAChC,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,cAAA,CAAe,OAAO,QAAQ,CAAA;AAAA,IACrC,CAAA;AAAA,EACF;AAAA,EAEA,QAAA,GAAW;AACT,IAAA,OAAO,EAAE,GAAG,IAAA,CAAK,KAAA,EAAM;AAAA,EACzB;AAAA,EAEQ,SAAS,OAAA,EAA+B;AAC9C,IAAA,IAAA,CAAK,QAAQ,EAAE,GAAG,IAAA,CAAK,KAAA,EAAO,GAAG,OAAA,EAAQ;AACzC,IAAA,IAAA,CAAK,cAAA,CAAe,QAAQ,CAAC,CAAA,KAAM,EAAE,IAAA,CAAK,QAAA,EAAU,CAAC,CAAA;AAAA,EACvD;AAAA,EAEA,OAAO,SAAA,CACL,KAAA,EACA,OAAA,EACuB;AACvB,IAAA,IAAI,IAAA,CAAK,eAAA,EAAiB,IAAA,CAAK,eAAA,CAAgB,KAAA,EAAM;AACrD,IAAA,IAAA,CAAK,eAAA,GAAkB,IAAI,eAAA,EAAgB;AAE3C,IAAA,MAAM,KAAA,GAAQ,OAAA,EAAS,KAAA,IAAS,UAAA,EAAW;AAC3C,IAAA,MAAM,eAAA,GAAyB;AAAA,MAC7B,GAAG,KAAA;AAAA,MACH,KAAA;AAAA,MACA,IAAA,EAAM,MAAM,IAAA,IAAQ,MAAA;AAAA,MACpB,SAAA,EAAW,KAAA,CAAM,SAAA,IAAa,IAAA,CAAK,GAAA;AAAI,KACzC;AAEA,IAAA,IAAA,CAAK,QAAA,CAAS;AAAA,MACZ,SAAA,EAAW,IAAA;AAAA,MACX,KAAA,EAAO,IAAA;AAAA,MACP,QAAQ,CAAC,GAAG,IAAA,CAAK,KAAA,CAAM,QAAQ,eAAe;AAAA,KAC/C,CAAA;AAED,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA;AAAA,QACxB,EAAE,KAAA,EAAO,eAAA,EAAiB,GAAG,SAAS,KAAA,EAAM;AAAA,QAC5C,KAAK,eAAA,CAAgB;AAAA,OACvB;AAEA,MAAA,MAAM,MAAA,GAAS,OAAO,SAAA,EAAU;AAChC,MAAA,MAAM,OAAA,GAAU,IAAI,WAAA,EAAY;AAChC,MAAA,IAAI,MAAA,GAAS,EAAA;AAEb,MAAA,OAAO,IAAA,EAAM;AACX,QAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,QAAA,IAAI,IAAA,EAAM;AAEV,QAAA,MAAA,IAAU,QAAQ,MAAA,CAAO,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAM,CAAA;AAChD,QAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,CAAM,MAAM,CAAA;AACjC,QAAA,MAAA,GAAS,KAAA,CAAM,KAAI,IAAK,EAAA;AAExB,QAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,UAAA,IAAI,CAAC,IAAA,CAAK,UAAA,CAAW,QAAQ,CAAA,EAAG;AAChC,UAAA,IAAI;AACF,YAAA,MAAM,gBAAuB,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA;AACrD,YAAA,IAAA,CAAK,oBAAoB,aAAa,CAAA;AACtC,YAAA,MAAM,aAAA;AAAA,UACR,SAAS,CAAA,EAAG;AACV,YAAA,OAAA,CAAQ,KAAA,CAAM,yBAAyB,CAAC,CAAA;AAAA,UAC1C;AAAA,QACF;AAAA,MACF;AACA,MAAA,IAAA,CAAK,QAAA,CAAS,EAAE,SAAA,EAAW,KAAA,EAAO,CAAA;AAAA,IACpC,SAAS,GAAA,EAAK;AACZ,MAAA,IAAI,GAAA,YAAe,KAAA,IAAS,GAAA,CAAI,IAAA,KAAS,YAAA,EAAc;AACrD,QAAA,IAAA,CAAK,QAAA,CAAS,EAAE,SAAA,EAAW,KAAA,EAAO,CAAA;AAClC,QAAA;AAAA,MACF;AACA,MAAA,MAAM,KAAA,GAAQ,eAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAA;AAChE,MAAA,IAAA,CAAK,QAAA,CAAS,EAAE,KAAA,EAAO,SAAA,EAAW,OAAO,CAAA;AACzC,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,oBAAoB,KAAA,EAAc;AACxC,IAAA,MAAM,MAAA,GAAS,CAAC,GAAG,IAAA,CAAK,MAAM,MAAM,CAAA;AAGpC,IAAA,MAAM,SAAA,GAAY,MAAA,CAAO,MAAA,CAAO,MAAA,GAAS,CAAC,CAAA;AAC1C,IAAA,IACE,KAAA,CAAM,IAAA,KAAS,YAAA,IACf,SAAA,EAAW,IAAA,KAAS,YAAA,IACpB,KAAA,CAAM,KAAA,KAAU,SAAA,CAAU,KAAA,IAC1B,KAAA,CAAM,IAAA,EAAM,KAAA,EACZ;AACA,MAAA,MAAA,CAAO,MAAA,CAAO,MAAA,GAAS,CAAC,CAAA,GAAI;AAAA,QAC1B,GAAG,SAAA;AAAA,QACH,IAAA,EAAM;AAAA,UACJ,GAAG,SAAA,CAAU,IAAA;AAAA,UACb,QAAQ,SAAA,CAAU,IAAA,EAAM,KAAA,IAAS,EAAA,IAAM,MAAM,IAAA,CAAK;AAAA;AACpD,OACF;AAAA,IACF,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,IACnB;AAEA,IAAA,IAAA,CAAK,QAAA,CAAS,EAAE,MAAA,EAAQ,CAAA;AAAA,EAC1B;AAAA,EAEA,KAAA,CAAM,MAAA,GAAkB,EAAC,EAAG;AAC1B,IAAA,IAAI,IAAA,CAAK,eAAA,EAAiB,IAAA,CAAK,eAAA,CAAgB,KAAA,EAAM;AACrD,IAAA,IAAA,CAAK,SAAS,EAAE,MAAA,EAAQ,OAAO,IAAA,EAAM,SAAA,EAAW,OAAO,CAAA;AAAA,EACzD;AACF;AAaO,SAAS,oBAAoB,GAAA,EAA0B;AAC5D,EAAA,OAAO,OAAO,SAA2B,MAAA,KAAyB;AAChE,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAChC,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,MAC9C,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,OAAO,CAAA;AAAA,MAC5B;AAAA,KACD,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AAC1E,IAAA,IAAI,CAAC,QAAA,CAAS,IAAA,EAAM,MAAM,IAAI,MAAM,kBAAkB,CAAA;AAEtD,IAAA,OAAO,QAAA,CAAS,IAAA;AAAA,EAClB,CAAA;AACF","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}\n\nexport class MelonyClient {\n  private transport: TransportFn;\n  private state: ClientState;\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    };\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 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 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      events: [...this.state.events, optimisticEvent],\n    });\n\n    try {\n      const stream = await this.transport(\n        { event: optimisticEvent, ...options, runId },\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 });\n    } catch (err) {\n      if (err instanceof Error && err.name === \"AbortError\") {\n        this.setState({ isLoading: false });\n        return;\n      }\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.setState({ error, isLoading: false });\n      throw error;\n    }\n  }\n\n  private handleIncomingEvent(event: Event) {\n    const events = [...this.state.events];\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({ events, error: null, isLoading: false });\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 { 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 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  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 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 },\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    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 = 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({ events, error: null, isLoading: false, loadingStatus: undefined });\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"]}

package/dist/generate-id-DU8kwYc2.d.ts

@@ -0,0 +1,3 @@
+declare const generateId: () => string;
+
+export { generateId as g };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { C as Config, E as Event, A as Action, P as Plugin } from './generate-id-CUOAZU5w.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, k as generateId, u as ui } from './generate-id-CUOAZU5w.js';
+import { C as Config, E as Event, A as Action, P as Plugin } from './types-BC3dKPi6.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-BC3dKPi6.js';
 import { z } from 'zod';
+export { g as generateId } from './generate-id-DU8kwYc2.js';
 
 /**
  * The Slim Runtime.

package/dist/index.js

@@ -1,314 +1,5 @@
-import { generateId } from './chunk-WAI5H335.js';
-export { generateId } from './chunk-WAI5H335.js';
 export { createStreamResponse } from './chunk-CFG7FFEZ.js';
-
-// src/types.ts
-var ui = {
-  card: (props) => {
-    const { children, ...rest } = props;
-    return { type: "card", props: rest, children };
-  },
-  row: (props) => {
-    const { children, ...rest } = props;
-    return { type: "row", props: rest, children };
-  },
-  col: (props) => {
-    const { children, ...rest } = props;
-    return { type: "col", props: rest, children };
-  },
-  box: (props) => {
-    const { children, ...rest } = props;
-    return { type: "box", props: rest, children };
-  },
-  spacer: (props) => ({
-    type: "spacer",
-    props
-  }),
-  divider: (props) => ({
-    type: "divider",
-    props
-  }),
-  text: (value, props) => ({
-    type: "text",
-    props: { ...props, value }
-  }),
-  heading: (value, level = 1) => ({
-    type: "heading",
-    props: { value, level }
-  }),
-  badge: (label, variant = "primary", size = "md") => ({
-    type: "badge",
-    props: { label, variant, size }
-  }),
-  image: (src, alt, size = "md") => ({
-    type: "image",
-    props: { src, alt, size }
-  }),
-  icon: (name, size = "md", color) => ({
-    type: "icon",
-    props: { name, size, color }
-  }),
-  chart: (props) => ({
-    type: "chart",
-    props
-  }),
-  list: (children) => ({
-    type: "list",
-    children
-  }),
-  listItem: (props) => {
-    const { children, ...rest } = props;
-    return { type: "listItem", props: rest, children };
-  },
-  form: (props) => {
-    const { children, ...rest } = props;
-    return { type: "form", props: rest, children };
-  },
-  input: (props) => ({
-    type: "input",
-    props
-  }),
-  textarea: (props) => ({
-    type: "textarea",
-    props
-  }),
-  select: (props) => ({
-    type: "select",
-    props
-  }),
-  checkbox: (props) => ({
-    type: "checkbox",
-    props
-  }),
-  radioGroup: (props) => ({
-    type: "radioGroup",
-    props
-  }),
-  label: (value, props) => ({
-    type: "label",
-    props: { ...props, value }
-  }),
-  button: (props) => ({
-    type: "button",
-    props
-  })
-};
-
-// src/runtime.ts
-var Runtime = class {
-  constructor(config) {
-    this.config = config;
-  }
-  async *run(input) {
-    const runId = input.runId ?? generateId();
-    const context = {
-      state: input.state ?? {},
-      runId,
-      stepCount: 0,
-      isDone: false,
-      actions: this.config.actions,
-      ui,
-      suspend: () => {
-        context.isDone = true;
-      }
-    };
-    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
-      );
-      if (result) {
-        if ("type" in result) {
-          yield* this.emit(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.params, context);
-      if (this.config.brain) {
-        nextAction = yield* this.dispatchToBrain(
-          {
-            type: "action-result",
-            data: {
-              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);
-      }
-    }
-    if (this.config.hooks?.onAfterRun) {
-      const extra = await this.config.hooks.onAfterRun(context);
-      if (extra) yield* this.emit(extra, context);
-    }
-  }
-  async *dispatchToBrain(event, context) {
-    const generator = this.config.brain(event, context);
-    while (true) {
-      const { value, done } = await generator.next();
-      if (done) return value;
-      yield* this.emit(value, context);
-    }
-  }
-  async *executeAction(action2, params, context) {
-    for (const plugin2 of this.config.plugins || []) {
-      if (plugin2.onBeforeAction) {
-        const hookResult = await plugin2.onBeforeAction(
-          { action: action2, params },
-          context
-        );
-        if (hookResult) {
-          yield* this.emit(hookResult, context);
-          if (context.isDone) return;
-        }
-      }
-    }
-    if (this.config.hooks?.onBeforeAction) {
-      const hookResult = await this.config.hooks.onBeforeAction(
-        { action: action2, params },
-        context
-      );
-      if (hookResult) {
-        yield* this.emit(hookResult, context);
-        if (context.isDone) return;
-      }
-    }
-    try {
-      const generator = action2.execute(params, context);
-      let result;
-      while (true) {
-        const { value, done } = await generator.next();
-        if (done) {
-          result = value;
-          break;
-        }
-        yield* this.emit(value, context);
-        if (context.isDone) return;
-      }
-      for (const plugin2 of this.config.plugins || []) {
-        if (plugin2.onAfterAction) {
-          const extra = await plugin2.onAfterAction(
-            { action: action2, data: result },
-            context
-          );
-          if (extra) yield* this.emit(extra, context);
-        }
-      }
-      if (this.config.hooks?.onAfterAction) {
-        const extra = await this.config.hooks.onAfterAction(
-          { action: action2, data: result },
-          context
-        );
-        if (extra) yield* this.emit(extra, context);
-      }
-      return result;
-    } catch (error) {
-      yield* this.emit(
-        {
-          type: "error",
-          data: {
-            action: action2.name,
-            error: error instanceof Error ? error.message : String(error)
-          }
-        },
-        context
-      );
-    }
-  }
-  /**
-   * Internal helper to yield an event and trigger the onEvent hook.
-   */
-  async *emit(event, context) {
-    const finalEvent = {
-      ...event,
-      runId: context.runId,
-      timestamp: event.timestamp ?? Date.now(),
-      role: event.role ?? "assistant"
-    };
-    yield finalEvent;
-    for (const plugin2 of this.config.plugins || []) {
-      if (plugin2.onEvent) {
-        const extra = await plugin2.onEvent(finalEvent, context);
-        if (extra) {
-          yield { ...extra, runId: context.runId, timestamp: Date.now() };
-        }
-      }
-    }
-    if (this.config.hooks?.onEvent) {
-      const extra = await this.config.hooks.onEvent(finalEvent, context);
-      if (extra) {
-        yield { ...extra, runId: context.runId, timestamp: Date.now() };
-      }
-    }
-  }
-};
-var melony = (config) => {
-  const runtime = new Runtime(config);
-  return {
-    config,
-    run: runtime.run.bind(runtime)
-  };
-};
-var action = (config) => config;
-var plugin = (config) => config;
-
-export { Runtime, action, melony, plugin, ui };
+export { Runtime, action, melony, plugin, ui } from './chunk-WCI7WEZW.js';
+export { generateId } from './chunk-WAI5H335.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/runtime.ts"],"names":["plugin","action"],"mappings":"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","file":"index.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?: \"primary\" | \"secondary\" | \"success\" | \"danger\" | \"outline\" | \"ghost\" | \"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: (props: UIContract[\"card\"] & { children?: UINode<any>[] }): UINode<\"card\"> => {\n    const { children, ...rest } = props;\n    return { type: \"card\", props: rest, children };\n  },\n  row: (props: UIContract[\"row\"] & { children?: UINode<any>[] }): UINode<\"row\"> => {\n    const { children, ...rest } = props;\n    return { type: \"row\", props: rest, children };\n  },\n  col: (props: UIContract[\"col\"] & { children?: UINode<any>[] }): UINode<\"col\"> => {\n    const { children, ...rest } = props;\n    return { type: \"col\", props: rest, children };\n  },\n  box: (props: UIContract[\"box\"] & { children?: UINode<any>[] }): UINode<\"box\"> => {\n    const { children, ...rest } = props;\n    return { type: \"box\", props: rest, children };\n  },\n  spacer: (props: UIContract[\"spacer\"]): UINode<\"spacer\"> => ({\n    type: \"spacer\",\n    props,\n  }),\n  divider: (props: UIContract[\"divider\"]): UINode<\"divider\"> => ({\n    type: \"divider\",\n    props,\n  }),\n  text: (\n    value: string,\n    props?: Omit<UIContract[\"text\"], \"value\">\n  ): UINode<\"text\"> => ({\n    type: \"text\",\n    props: { ...props, value },\n  }),\n  heading: (\n    value: string,\n    level: UIContract[\"heading\"][\"level\"] = 1\n  ): UINode<\"heading\"> => ({\n    type: \"heading\",\n    props: { value, level },\n  }),\n  badge: (\n    label: string,\n    variant: UIContract[\"badge\"][\"variant\"] = \"primary\",\n    size: UISize = \"md\"\n  ): UINode<\"badge\"> => ({\n    type: \"badge\",\n    props: { label, variant, size },\n  }),\n  image: (\n    src: string,\n    alt?: string,\n    size: UISize = \"md\"\n  ): 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: (props: UIContract[\"form\"] & { children?: UINode<any>[] }): 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  timestamp?: number;\n  role?: Role;\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}\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 },\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}\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, context);\n          } else {\n            nextAction = result;\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, context);\n        } else {\n          nextAction = result;\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.params, 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              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    params: any,\n    context: RuntimeContext\n  ): AsyncGenerator<Event, NextAction | void> {\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 },\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 },\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    };\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"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

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

@@ -0,0 +1,31 @@
+import { A as Action, i as RuntimeContext, P as Plugin } from '../types-BC3dKPi6.js';
+import 'zod';
+
+interface RequireApprovalOptions {
+    /**
+     * List of action names that require explicit approval.
+     * If not provided, all actions will require approval.
+     */
+    actions?: string[];
+    /**
+     * Optional secret to sign the approval payload.
+     * If provided, the plugin will verify that the parameters haven't been
+     * tampered with between the request and the approval.
+     */
+    secret?: string;
+    /**
+     * Custom message to show in the approval card.
+     */
+    message?: string | ((action: string, params: any) => string);
+    /**
+     * Optional condition to check if approval is needed dynamically.
+     */
+    shouldApprove?: (action: Action<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;
+
+export { type RequireApprovalOptions, requireApproval };

package/dist/plugins/require-approval.js

@@ -0,0 +1,104 @@
+import { plugin, ui } from '../chunk-WCI7WEZW.js';
+import '../chunk-WAI5H335.js';
+
+// src/plugins/require-approval.ts
+var requireApproval = (options = {}) => {
+  return plugin({
+    name: "require-approval",
+    /**
+     * Step 1: Handle the resumption when the user clicks "Approve".
+     */
+    onBeforeRun: async ({ event }, context) => {
+      if (event.type === "action-approved") {
+        const { action, params, token, ...rest } = event.data;
+        if (options.secret) {
+          const expectedToken = await signPayload({ action, params }, options.secret);
+          if (token !== expectedToken) {
+            return {
+              type: "error",
+              data: { message: "Security Warning: Approval token mismatch. Execution blocked." }
+            };
+          }
+        }
+        context.state.__approved_action = { action, params };
+        return { action, params, ...rest };
+      }
+    },
+    /**
+     * Step 2: Intercept actions that require approval.
+     */
+    onBeforeAction: async ({ action, params, nextAction }, context) => {
+      const isTargetAction = !options.actions || options.actions.includes(action.name);
+      if (!isTargetAction) return;
+      if (options.shouldApprove) {
+        const needsApproval = await options.shouldApprove(action, params, context);
+        if (!needsApproval) return;
+      }
+      const approval = context.state.__approved_action;
+      if (approval && approval.action === action.name && JSON.stringify(approval.params) === JSON.stringify(params)) {
+        delete context.state.__approved_action;
+        return;
+      }
+      context.suspend();
+      const token = options.secret ? await signPayload({ action: action.name, params }, 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 {
+        type: "hitl-required",
+        data: { ...nextAction, token },
+        ui: ui.card({
+          title: "Approval Required",
+          children: [
+            ui.text(message),
+            ui.box({
+              padding: "md",
+              background: "muted",
+              children: [
+                ui.text(JSON.stringify(params, null, 2), { size: "xs" })
+              ]
+            }),
+            ui.row({
+              gap: "md",
+              children: [
+                ui.button({
+                  label: "Approve",
+                  variant: "success",
+                  onClickAction: {
+                    type: "action-approved",
+                    data: { ...nextAction, token }
+                  }
+                }),
+                ui.button({
+                  label: "Cancel",
+                  variant: "outline",
+                  onClickAction: {
+                    type: "action-rejected",
+                    data: { action: action.name }
+                  }
+                })
+              ]
+            })
+          ]
+        })
+      };
+    }
+  });
+};
+async function signPayload(data, secret) {
+  const msg = JSON.stringify(data);
+  const encoder = new TextEncoder();
+  const keyData = encoder.encode(secret);
+  const dataToSign = encoder.encode(msg);
+  const key = await crypto.subtle.importKey(
+    "raw",
+    keyData,
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const signature = await crypto.subtle.sign("HMAC", key, dataToSign);
+  return btoa(String.fromCharCode(...new Uint8Array(signature)));
+}
+
+export { requireApproval };
+//# sourceMappingURL=require-approval.js.map
+//# sourceMappingURL=require-approval.js.map

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

@@ -0,0 +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?: (action: Action<any>, params: any, context: RuntimeContext) => 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\".\n     */\n    onBeforeRun: async ({ event }, context) => {\n      if (event.type === \"action-approved\") {\n        const { action, params, token, ...rest } = event.data;\n\n        // Security: Verify the token if a secret was provided\n        if (options.secret) {\n          const expectedToken = await signPayload({ action, params }, options.secret);\n          if (token !== expectedToken) {\n            return {\n              type: \"error\",\n              data: { message: \"Security Warning: Approval token mismatch. Execution blocked.\" },\n            };\n          }\n        }\n\n        // 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\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 = !options.actions || options.actions.includes(action.name);\n      if (!isTargetAction) return;\n\n      if (options.shouldApprove) {\n        const needsApproval = await options.shouldApprove(action, params, context);\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\n      context.suspend();\n\n      const token = options.secret \n        ? await signPayload({ action: action.name, params }, options.secret)\n        : undefined;\n\n      const message = typeof options.message === \"function\"\n        ? options.message(action.name, params)\n        : options.message || `The agent wants to execute **${action.name}**. Do you approve?`;\n\n      return {\n        type: \"hitl-required\",\n        data: { ...nextAction, token },\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                    type: \"action-approved\",\n                    data: { ...nextAction, token },\n                  },\n                }),\n                ui.button({\n                  label: \"Cancel\",\n                  variant: \"outline\",\n                  onClickAction: {\n                    type: \"action-rejected\",\n                    data: { action: action.name },\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\n"]}

package/dist/{generate-id-CUOAZU5w.d.ts → types-BC3dKPi6.d.ts}

@@ -214,6 +214,7 @@ interface NextAction {
     action?: string;
     params?: any;
     description?: string;
+    [key: string]: any;
 }
 interface RuntimeContext<TState = any> {
     state: TState;
@@ -253,6 +254,7 @@ interface Hooks {
     onBeforeAction?: (call: {
         action: Action<any>;
         params: any;
+        nextAction: NextAction;
     }, context: RuntimeContext) => HookResult;
     /**
      * Called after an action completes.
@@ -279,6 +281,4 @@ interface Config {
     safetyMaxSteps?: number;
 }
 
-declare const generateId: () => string;
-
-export { type Action as A, type Config as C, type Event as E, type HookResult 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, generateId as k, ui as u };
+export { type Action as A, type Config as C, type Event as E, type HookResult 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "melony",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "main": "dist/index.js",
   "type": "module",
   "sideEffects": false,
@@ -33,6 +33,11 @@
       "import": "./dist/adapters/*.js",
       "default": "./dist/adapters/*.js"
     },
+    "./plugins/*": {
+      "types": "./dist/plugins/*.d.ts",
+      "import": "./dist/plugins/*.js",
+      "default": "./dist/plugins/*.js"
+    },
     "./package.json": "./package.json"
   },
   "module": "dist/index.js",