melony 0.1.12

package/README.md

@@ -0,0 +1,104 @@
+# @melony/core
+
+Melony Core is a small **event-streaming runtime** for AI agents with first-class **Server‑Driven UI (SDUI)**.
+
+You write a `brain` (decides what to do) and `actions` (do work and stream events). Actions/brains can stream:
+
+- **Text** (`{ type: "text" }` / `{ type: "text-delta" }`)
+- **UI trees** (`event.ui = ui.card(...)`) that React (and other renderers) can display
+- Any custom events you want (`{ type: "tool-result", data: ... }`)
+
+## Installation
+
+```bash
+npm install @melony/core zod
+```
+
+## 60-second usage
+
+### 1) Define an agent runtime
+
+```ts
+import { melony, action, ui } from "@melony/core";
+import { z } from "zod";
+
+export const assistant = melony({
+  actions: {
+    searchProducts: action({
+      name: "searchProducts",
+      description: "Search products by keyword",
+      paramsSchema: z.object({ query: z.string() }),
+      execute: async function* ({ query }) {
+        yield { type: "text", data: { content: `Searching for "${query}"...` } };
+
+        // SDUI: stream real UI to the frontend
+        yield {
+          type: "ui",
+          ui: ui.card({
+            title: "Results",
+            children: [
+              ui.list([
+                ui.listItem({ children: [ui.text("Product A — $10")] }),
+                ui.listItem({ children: [ui.text("Product B — $12")] }),
+              ]),
+            ],
+          }),
+        };
+      },
+    }),
+  },
+
+  // The brain receives events and returns the next action to run.
+  brain: async function* (event) {
+    if (event.type === "text") {
+      return { action: "searchProducts", params: { query: event.data?.content } };
+    }
+  },
+});
+```
+
+### 2) Serve it (Hono adapter)
+
+```ts
+import { Hono } from "hono";
+import { handle } from "@melony/core/adapters/hono";
+import { assistant } from "./assistant";
+
+const app = new Hono();
+app.post("/api/chat", handle(assistant));
+```
+
+### 3) Stream from the client
+
+```ts
+import { MelonyClient, createHttpTransport } from "@melony/core/client";
+
+const client = new MelonyClient(createHttpTransport("/api/chat"));
+
+for await (const event of client.sendEvent({
+  type: "text",
+  role: "user",
+  data: { content: "running shoes" },
+})) {
+  console.log("event:", event);
+}
+```
+
+## Core concepts
+
+- **Event**: the universal unit of streaming.
+- **Action**: an async generator that yields events and (optionally) returns a `NextAction`.
+- **Brain**: an async generator that decides the next action to run based on incoming events/results.
+- **Plugins/Hooks**: intercept runs, actions, and events (great place for HITL, logging, persistence).
+
+## SDUI (Server‑Driven UI)
+
+Melony ships a typed UI contract and builder:
+
+- `ui.card(...)`, `ui.form(...)`, `ui.button(...)`, etc.
+- Put the resulting `UINode` into `event.ui`
+- `@melony/react` renders it automatically
+
+## License
+
+MIT

package/dist/adapters/hono.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Event-centric Hono adapter for Melony.
+ */
+declare const handle: (instance: {
+    run: any;
+    config: any;
+}) => (c: any) => Promise<any>;
+
+export { handle };

package/dist/adapters/hono.js

@@ -0,0 +1,23 @@
+import { createStreamResponse } from '../chunk-CFG7FFEZ.js';
+
+// src/adapters/hono.ts
+var handle = (instance) => {
+  return async (c) => {
+    const body = await c.req.json();
+    const event = body.event;
+    if (!event) {
+      return c.json({ error: "Invalid request: event required" }, 400);
+    }
+    return createStreamResponse(
+      instance.run({
+        event,
+        runId: body.runId,
+        state: body.state
+      })
+    );
+  };
+};
+
+export { handle };
+//# sourceMappingURL=hono.js.map
+//# sourceMappingURL=hono.js.map

package/dist/adapters/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/hono.ts"],"names":[],"mappings":";;;AAMO,IAAM,MAAA,GAAS,CACpB,QAAA,KACG;AACH,EAAA,OAAO,OAAO,CAAA,KAAW;AACvB,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;AAEA,IAAA,OAAO,oBAAA;AAAA,MACL,SAAS,GAAA,CAAI;AAAA,QACX,KAAA;AAAA,QACA,OAAO,IAAA,CAAK,KAAA;AAAA,QACZ,OAAO,IAAA,CAAK;AAAA,OACb;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 = (\n  instance: { run: any; config: any }\n) => {\n  return async (c: any) => {\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    return createStreamResponse(\n      instance.run({\n        event,\n        runId: body.runId,\n        state: body.state,\n      })\n    );\n  };\n};\n"]}

package/dist/chunk-CFG7FFEZ.js

@@ -0,0 +1,30 @@
+// src/utils/create-stream-response.ts
+function createStreamResponse(generator) {
+  const encoder = new TextEncoder();
+  const stream = new ReadableStream({
+    async start(controller) {
+      try {
+        for await (const message of generator) {
+          const chunk = `data: ${JSON.stringify(message)}
+
+`;
+          controller.enqueue(encoder.encode(chunk));
+        }
+        controller.close();
+      } catch (error) {
+        controller.error(error);
+      }
+    }
+  });
+  return new Response(stream, {
+    headers: {
+      "Content-Type": "text/event-stream",
+      "Cache-Control": "no-cache",
+      Connection: "keep-alive"
+    }
+  });
+}
+
+export { createStreamResponse };
+//# sourceMappingURL=chunk-CFG7FFEZ.js.map
+//# sourceMappingURL=chunk-CFG7FFEZ.js.map

package/dist/chunk-CFG7FFEZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/create-stream-response.ts"],"names":[],"mappings":";AAMO,SAAS,qBACd,SAAA,EACU;AACV,EAAA,MAAM,OAAA,GAAU,IAAI,WAAA,EAAY;AAChC,EAAA,MAAM,MAAA,GAAS,IAAI,cAAA,CAAe;AAAA,IAChC,MAAM,MAAM,UAAA,EAAY;AACtB,MAAA,IAAI;AACF,QAAA,WAAA,MAAiB,WAAW,SAAA,EAAW;AAErC,UAAA,MAAM,KAAA,GAAQ,CAAA,MAAA,EAAS,IAAA,CAAK,SAAA,CAAU,OAAO,CAAC;;AAAA,CAAA;AAC9C,UAAA,UAAA,CAAW,OAAA,CAAQ,OAAA,CAAQ,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,QAC1C;AACA,QAAA,UAAA,CAAW,KAAA,EAAM;AAAA,MACnB,SAAS,KAAA,EAAO;AACd,QAAA,UAAA,CAAW,MAAM,KAAK,CAAA;AAAA,MACxB;AAAA,IACF;AAAA,GACD,CAAA;AAED,EAAA,OAAO,IAAI,SAAS,MAAA,EAAQ;AAAA,IAC1B,OAAA,EAAS;AAAA,MACP,cAAA,EAAgB,mBAAA;AAAA,MAChB,eAAA,EAAiB,UAAA;AAAA,MACjB,UAAA,EAAY;AAAA;AACd,GACD,CAAA;AACH","file":"chunk-CFG7FFEZ.js","sourcesContent":["import { Event } from \"../types\";\n\n/**\n * Convert an async generator of events to an HTTP streaming response\n * Exported for backward compatibility and standalone usage\n */\nexport function createStreamResponse(\n  generator: AsyncGenerator<Event>\n): Response {\n  const encoder = new TextEncoder();\n  const stream = new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const message of generator) {\n          // Format as SSE: data: {...}\\n\\n\n          const chunk = `data: ${JSON.stringify(message)}\\n\\n`;\n          controller.enqueue(encoder.encode(chunk));\n        }\n        controller.close();\n      } catch (error) {\n        controller.error(error);\n      }\n    },\n  });\n\n  return new Response(stream, {\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    },\n  });\n}\n"]}

package/dist/chunk-WAI5H335.js

@@ -0,0 +1,8 @@
+// src/utils/generate-id.ts
+var generateId = () => {
+  return typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).substring(7);
+};
+
+export { generateId };
+//# sourceMappingURL=chunk-WAI5H335.js.map
+//# sourceMappingURL=chunk-WAI5H335.js.map

package/dist/chunk-WAI5H335.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/generate-id.ts"],"names":[],"mappings":";AAAO,IAAM,aAAa,MAAM;AAC9B,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,aAC3C,MAAA,CAAO,UAAA,EAAW,GAClB,IAAA,CAAK,QAAO,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,UAAU,CAAC,CAAA;AAC5C","file":"chunk-WAI5H335.js","sourcesContent":["export const generateId = () => {\n  return typeof crypto !== \"undefined\" && crypto.randomUUID\n    ? crypto.randomUUID()\n    : Math.random().toString(36).substring(7);\n};\n"]}

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+import { E as Event } from './generate-id-CUOAZU5w.js';
+export { k as generateId } from './generate-id-CUOAZU5w.js';
+import 'zod';
+
+interface ClientState {
+    events: Event[];
+    isLoading: boolean;
+    error: Error | null;
+}
+declare class MelonyClient {
+    private transport;
+    private state;
+    private abortController;
+    private stateListeners;
+    constructor(transport: TransportFn, options?: {
+        initialEvents?: Event[];
+    });
+    subscribe(listener: (state: ClientState) => void): () => void;
+    getState(): {
+        events: Event[];
+        isLoading: boolean;
+        error: Error | null;
+    };
+    private setState;
+    sendEvent(event: Event, options?: {
+        runId?: string;
+        state?: Record<string, any>;
+    }): AsyncGenerator<Event>;
+    private handleIncomingEvent;
+    reset(events?: Event[]): void;
+}
+interface TransportRequest {
+    event: Event;
+    runId?: string;
+    state?: Record<string, any>;
+}
+type TransportFn = (request: TransportRequest, signal?: AbortSignal) => Promise<ReadableStream<Uint8Array>>;
+declare function createHttpTransport(api: string): TransportFn;
+
+export { type ClientState, Event, MelonyClient, type TransportFn, type TransportRequest, createHttpTransport };

package/dist/client.js

@@ -0,0 +1,117 @@
+import { generateId } from './chunk-WAI5H335.js';
+export { generateId } from './chunk-WAI5H335.js';
+
+// src/client.ts
+var MelonyClient = class {
+  constructor(transport, options) {
+    this.abortController = null;
+    this.stateListeners = /* @__PURE__ */ new Set();
+    this.transport = transport;
+    this.state = {
+      events: options?.initialEvents ?? [],
+      isLoading: false,
+      error: null
+    };
+  }
+  subscribe(listener) {
+    this.stateListeners.add(listener);
+    return () => {
+      this.stateListeners.delete(listener);
+    };
+  }
+  getState() {
+    return { ...this.state };
+  }
+  setState(updates) {
+    this.state = { ...this.state, ...updates };
+    this.stateListeners.forEach((l) => l(this.getState()));
+  }
+  async *sendEvent(event, options) {
+    if (this.abortController) this.abortController.abort();
+    this.abortController = new AbortController();
+    const runId = options?.runId ?? generateId();
+    const optimisticEvent = {
+      ...event,
+      runId,
+      role: event.role ?? "user",
+      timestamp: event.timestamp ?? Date.now()
+    };
+    this.setState({
+      isLoading: true,
+      error: null,
+      events: [...this.state.events, optimisticEvent]
+    });
+    try {
+      const stream = await this.transport(
+        { event: optimisticEvent, ...options, runId },
+        this.abortController.signal
+      );
+      const reader = stream.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n\n");
+        buffer = lines.pop() || "";
+        for (const line of lines) {
+          if (!line.startsWith("data: ")) continue;
+          try {
+            const incomingEvent = JSON.parse(line.slice(6));
+            this.handleIncomingEvent(incomingEvent);
+            yield incomingEvent;
+          } catch (e) {
+            console.error("Failed to parse event", e);
+          }
+        }
+      }
+      this.setState({ isLoading: false });
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        this.setState({ isLoading: false });
+        return;
+      }
+      const error = err instanceof Error ? err : new Error(String(err));
+      this.setState({ error, isLoading: false });
+      throw error;
+    }
+  }
+  handleIncomingEvent(event) {
+    const events = [...this.state.events];
+    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] = {
+        ...lastEvent,
+        data: {
+          ...lastEvent.data,
+          delta: (lastEvent.data?.delta || "") + event.data.delta
+        }
+      };
+    } else {
+      events.push(event);
+    }
+    this.setState({ events });
+  }
+  reset(events = []) {
+    if (this.abortController) this.abortController.abort();
+    this.setState({ events, error: null, isLoading: false });
+  }
+};
+function createHttpTransport(api) {
+  return async (request, signal) => {
+    const response = await fetch(api, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(request),
+      signal
+    });
+    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
+    if (!response.body) throw new Error("No response body");
+    return response.body;
+  };
+}
+
+export { MelonyClient, createHttpTransport };
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"client.js","sourcesContent":["import { Event } from \"./types\";\nimport { generateId } from \"./utils/generate-id\";\n\nexport type { Event };\nexport { generateId };\n\nexport interface ClientState {\n  events: Event[];\n  isLoading: boolean;\n  error: Error | null;\n}\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"]}

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

@@ -0,0 +1,284 @@
+import z from 'zod';
+
+type UISize = "sm" | "md" | "lg";
+type UIAlign = "start" | "center" | "end" | "stretch";
+type UIJustify = "start" | "center" | "end" | "between" | "around";
+type UIWrap = "nowrap" | "wrap" | "wrap-reverse";
+type UIOrientation = "horizontal" | "vertical";
+type UIColor = "primary" | "secondary" | "success" | "danger" | "warning" | "info" | "background" | "foreground" | "muted" | "mutedForeground" | "border";
+type UISpacing = "xs" | "sm" | "md" | "lg" | "xl" | "xxl";
+/**
+ * UI Component Contracts
+ * This acts as the source of truth for the SDUI protocol.
+ */
+interface UIContract {
+    card: {
+        title?: string;
+        subtitle?: string;
+        background?: string;
+        isLoading?: boolean;
+    };
+    row: {
+        align?: UIAlign;
+        justify?: UIJustify;
+        wrap?: UIWrap;
+        gap?: UISpacing;
+    };
+    col: {
+        align?: UIAlign;
+        justify?: UIJustify;
+        gap?: UISpacing;
+        width?: string | number;
+        height?: string | number;
+        padding?: UISpacing;
+    };
+    box: {
+        padding?: UISpacing;
+        margin?: string | number;
+        background?: string;
+        border?: boolean;
+        borderRadius?: UISpacing;
+        width?: string | number;
+        height?: string | number;
+    };
+    spacer: {
+        size?: UISpacing;
+        direction?: UIOrientation;
+    };
+    divider: {
+        orientation?: UIOrientation;
+        color?: UIColor;
+    };
+    text: {
+        value: string;
+        size?: UISpacing;
+        weight?: "normal" | "medium" | "semibold" | "bold";
+        color?: UIColor;
+        align?: UIAlign;
+    };
+    heading: {
+        value: string;
+        level?: 1 | 2 | 3 | 4 | 5 | 6;
+    };
+    badge: {
+        label: string;
+        variant?: "primary" | "secondary" | "success" | "danger" | "warning";
+        size?: UISize;
+    };
+    image: {
+        src: string;
+        alt?: string;
+        size?: UISize;
+    };
+    icon: {
+        name: string;
+        size?: UISize;
+        color?: UIColor;
+    };
+    chart: {
+        data: Array<{
+            label: string;
+            value: number;
+            color?: string;
+        }>;
+        chartType?: "bar" | "line" | "area" | "pie";
+        title?: string;
+    };
+    list: {};
+    listItem: {
+        onClickAction?: Event;
+        gap?: UISpacing;
+    };
+    form: {
+        onSubmitAction?: Event;
+    };
+    input: {
+        name: string;
+        label?: string;
+        placeholder?: string;
+        defaultValue?: string;
+        inputType?: string;
+        onChangeAction?: Event;
+    };
+    textarea: {
+        name: string;
+        label?: string;
+        placeholder?: string;
+        defaultValue?: string;
+        rows?: number;
+        onChangeAction?: Event;
+    };
+    select: {
+        name: string;
+        label?: string;
+        options: Array<{
+            label: string;
+            value: string;
+        }>;
+        defaultValue?: string;
+        placeholder?: string;
+        onChangeAction?: Event;
+    };
+    checkbox: {
+        name: string;
+        label?: string;
+        checked?: boolean;
+        onChangeAction?: Event;
+    };
+    radioGroup: {
+        name: string;
+        options: Array<{
+            label: string;
+            value: string;
+            disabled?: boolean;
+        }>;
+        label?: string;
+        defaultValue?: string;
+        orientation?: UIOrientation;
+        onChangeAction?: Event;
+    };
+    label: {
+        value: string;
+        htmlFor?: string;
+        required?: boolean;
+    };
+    button: {
+        label: string;
+        variant?: "primary" | "secondary" | "success" | "danger" | "outline" | "ghost" | "link";
+        size?: UISize;
+        disabled?: boolean;
+        onClickAction?: Event;
+    };
+}
+type UINode<T extends keyof UIContract = keyof UIContract> = {
+    type: T;
+    props?: UIContract[T];
+    children?: UINode<any>[];
+};
+/**
+ * UI Builder for SDUI.
+ * Typed using the UIContract source of truth.
+ */
+declare const ui: {
+    card: (props: UIContract["card"] & {
+        children?: UINode<any>[];
+    }) => UINode<"card">;
+    row: (props: UIContract["row"] & {
+        children?: UINode<any>[];
+    }) => UINode<"row">;
+    col: (props: UIContract["col"] & {
+        children?: UINode<any>[];
+    }) => UINode<"col">;
+    box: (props: UIContract["box"] & {
+        children?: UINode<any>[];
+    }) => UINode<"box">;
+    spacer: (props: UIContract["spacer"]) => UINode<"spacer">;
+    divider: (props: UIContract["divider"]) => UINode<"divider">;
+    text: (value: string, props?: Omit<UIContract["text"], "value">) => UINode<"text">;
+    heading: (value: string, level?: UIContract["heading"]["level"]) => UINode<"heading">;
+    badge: (label: string, variant?: UIContract["badge"]["variant"], size?: UISize) => UINode<"badge">;
+    image: (src: string, alt?: string, size?: UISize) => UINode<"image">;
+    icon: (name: string, size?: UISize, color?: UIColor) => UINode<"icon">;
+    chart: (props: UIContract["chart"]) => UINode<"chart">;
+    list: (children: UINode<any>[]) => UINode<"list">;
+    listItem: (props: UIContract["listItem"] & {
+        children: UINode<any>[];
+    }) => UINode<"listItem">;
+    form: (props: UIContract["form"] & {
+        children?: UINode<any>[];
+    }) => UINode<"form">;
+    input: (props: UIContract["input"]) => UINode<"input">;
+    textarea: (props: UIContract["textarea"]) => UINode<"textarea">;
+    select: (props: UIContract["select"]) => UINode<"select">;
+    checkbox: (props: UIContract["checkbox"]) => UINode<"checkbox">;
+    radioGroup: (props: UIContract["radioGroup"]) => UINode<"radioGroup">;
+    label: (value: string, props?: Omit<UIContract["label"], "value">) => UINode<"label">;
+    button: (props: UIContract["button"]) => UINode<"button">;
+};
+type Role = "user" | "assistant" | "system";
+type Event = {
+    type: string;
+    data?: any;
+    ui?: UINode;
+    runId?: string;
+    timestamp?: number;
+    role?: Role;
+};
+interface Action<TParams extends z.ZodSchema = z.ZodObject<any>> {
+    name: string;
+    description?: string;
+    paramsSchema: TParams;
+    execute: (params: z.infer<TParams>, context: RuntimeContext) => AsyncGenerator<Event, NextAction | void, unknown>;
+}
+interface NextAction {
+    action?: string;
+    params?: any;
+    description?: string;
+}
+interface RuntimeContext<TState = any> {
+    state: TState;
+    runId: string;
+    stepCount: number;
+    isDone: boolean;
+    actions: Record<string, Action<any>>;
+    ui: typeof ui;
+    suspend: () => void;
+}
+/**
+ * Standardized Hook Result for consistent DX.
+ */
+type HookResult = Promise<Event | void>;
+interface Hooks {
+    /**
+     * Called when a run session begins.
+     * Can return an Event to be emitted, or a NextAction to jump-start the loop.
+     */
+    onBeforeRun?: (input: {
+        event: Event;
+        runId: string;
+        state: Record<string, any>;
+    }, context: RuntimeContext) => Promise<Event | NextAction | void>;
+    /**
+     * Called when a run session completes.
+     */
+    onAfterRun?: (context: RuntimeContext) => HookResult;
+    /**
+     * Called whenever an event is yielded by the runtime.
+     */
+    onEvent?: (event: Event, context: RuntimeContext) => HookResult;
+    /**
+     * Called before an action is executed.
+     * Return an event to intercept/suspend the action.
+     */
+    onBeforeAction?: (call: {
+        action: Action<any>;
+        params: any;
+    }, context: RuntimeContext) => HookResult;
+    /**
+     * Called after an action completes.
+     */
+    onAfterAction?: (result: {
+        action: Action<any>;
+        data: NextAction | void;
+    }, context: RuntimeContext) => HookResult;
+}
+/**
+ * A plugin is just a named set of hooks.
+ */
+interface Plugin extends Hooks {
+    name: string;
+}
+interface Config {
+    actions: Record<string, Action<any>>;
+    /**
+     * The central brain for handling incoming events.
+     */
+    brain?: (event: Event, context: RuntimeContext) => AsyncGenerator<Event, NextAction | void, unknown>;
+    hooks?: Hooks;
+    plugins?: Plugin[];
+    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 };

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+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 { z } from 'zod';
+
+/**
+ * The Slim Runtime.
+ * Single Responsibility: Orchestrate Event -> Action -> Event transitions.
+ */
+declare class Runtime {
+    private config;
+    constructor(config: Config);
+    run(input: {
+        event: Event;
+        runId?: string;
+        state?: Record<string, any>;
+    }): AsyncGenerator<Event>;
+    private dispatchToBrain;
+    private executeAction;
+    /**
+     * Internal helper to yield an event and trigger the onEvent hook.
+     */
+    private emit;
+}
+declare const melony: (config: Config) => {
+    config: Config;
+    run: (input: {
+        event: Event;
+        runId?: string;
+        state?: Record<string, any>;
+    }) => AsyncGenerator<Event>;
+};
+/**
+ * Helper to define an action with full type inference.
+ */
+declare const action: <T extends z.ZodSchema>(config: Action<T>) => Action<T>;
+/**
+ * Helper to define a plugin.
+ */
+declare const plugin: (config: Plugin) => Plugin;
+
+/**
+ * Convert an async generator of events to an HTTP streaming response
+ * Exported for backward compatibility and standalone usage
+ */
+declare function createStreamResponse(generator: AsyncGenerator<Event>): Response;
+
+export { Action, Config, Event, Plugin, Runtime, action, createStreamResponse, melony, plugin };

package/dist/index.js

@@ -0,0 +1,314 @@
+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 };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "melony",
+  "version": "0.1.12",
+  "main": "dist/index.js",
+  "type": "module",
+  "sideEffects": false,
+  "keywords": [
+    "ai",
+    "agents",
+    "framework",
+    "typescript",
+    "sdui"
+  ],
+  "author": "",
+  "license": "MIT",
+  "description": "The universal AI agent framework with built-in SDUI and HITL.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    },
+    "./adapters/*": {
+      "types": "./dist/adapters/*.d.ts",
+      "import": "./dist/adapters/*.js",
+      "default": "./dist/adapters/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "rimraf": "^5.0.10",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "zod": "^4.1.11",
+    "node-html-parser": "^7.0.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}