@melony/react 0.2.2 → 0.2.4

package/README.md

@@ -31,12 +31,12 @@ export default function App() {
 import { useMelony } from "@melony/react";
 
 function Controls() {
-  const { sendEvent, isLoading } = useMelony();
+  const { send, streaming } = useMelony();
   return (
     <button
-      disabled={isLoading}
+      disabled={streaming}
       onClick={() =>
-        sendEvent({ type: "text", data: { content: "Hello!" } })
+        send({ type: "text", data: { content: "Hello!" } })
       }
     >
       Send
@@ -49,26 +49,36 @@ function Controls() {
 
 - **`MelonyProvider`** + **`useMelony()`**
   - Connects to a Melony runtime endpoint.
-  - Exposes `events`, `isLoading`, `error`, and `sendEvent()`.
+  - Exposes `messages`, `events`, `streaming`, `error`, and `send()`.
 
 ## Event Stream & UI
 
-Melony React provides the foundation for building interactive agent UIs. You can listen to the event stream via `useMelony()` and render your own components based on the event types.
+Melony React provides the foundation for building interactive agent UIs. It automatically aggregates raw events into `messages` for easy rendering of chat interfaces.
 
 ```tsx
-const { events } = useMelony();
+const { messages } = useMelony();
 
 return (
   <div>
-    {events.map(event => {
-      if (event.type === "text") return <Text key={event.id} content={event.data.content} />;
-      if (event.type === "custom-ui") return <MyCustomUI key={event.id} {...event.data} />;
-      return null;
-    })}
+    {messages.map(message => (
+      <div key={message.runId} className={message.role}>
+        {message.content.map(event => {
+          if (event.type === "assistant:text-delta") {
+             return <span key={event.id}>{event.data.delta}</span>;
+          }
+          if (event.type === "ui") {
+             return <MyCustomUI key={event.id} {...event.data} />;
+          }
+          return null;
+        })}
+      </div>
+    ))}
   </div>
 );
 ```
 
+You can still access raw `events` if you need lower-level control.
+
 ## Development
 
 ```bash

package/dist/index.cjs

@@ -6,9 +6,11 @@ var jsxRuntime = require('react/jsx-runtime');
 // src/providers/melony-provider.tsx
 
 // src/utils/message-converter.ts
-var defaultGetRole = (e) => e.meta?.role || "assistant";
-var defaultGetRunId = (e) => e.meta?.runId;
-var defaultGetThreadId = (e) => e.meta?.threadId || e.meta?.state?.threadId;
+var defaultGetRole = (e) => e.type === "user:text" ? "user" : "assistant";
+var defaultGetRunId = (e, context) => {
+  return context?.runId;
+};
+var defaultGetThreadId = (e) => e.data?.threadId;
 var defaultShouldStartNewMessage = (event, current, utils) => {
   if (!current) return true;
   const role = utils.getRole(event);
@@ -18,13 +20,7 @@ var defaultShouldStartNewMessage = (event, current, utils) => {
   return false;
 };
 var defaultProcessEvent = (event, current) => {
-  if (event.type === "text-delta" && event.data?.delta) {
-    current.content += event.data.delta;
-  } else if (event.type === "text") {
-    current.content += event.data?.content || event.data?.text || "";
-  } else {
-    current.uiEvents.push(event);
-  }
+  current.content.push(event);
 };
 function convertEventsToAggregatedMessages(events, options = {}) {
   const getRole = options.getRole || defaultGetRole;
@@ -39,10 +35,9 @@ function convertEventsToAggregatedMessages(events, options = {}) {
     if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {
       currentMessage = {
         role: getRole(event),
-        content: "",
+        content: [],
         runId: getRunId(event),
-        threadId: getThreadId(event),
-        uiEvents: []
+        threadId: getThreadId(event)
       };
       messages.push(currentMessage);
     }
@@ -91,8 +86,8 @@ var MelonyProvider = ({
     () => ({
       ...state,
       messages,
-      sendEvent: async (event) => {
-        const generator = client.sendEvent(event);
+      send: async (event) => {
+        const generator = client.send(event);
         for await (const _ of generator) {
         }
       },
@@ -110,6 +105,49 @@ var useMelony = () => {
   }
   return context;
 };
+function useMelonyInit(url, params = {}) {
+  const [data, setData] = react.useState(null);
+  const [loading, setLoading] = react.useState(true);
+  const [error, setError] = react.useState(null);
+  react.useEffect(() => {
+    let isMounted = true;
+    async function init() {
+      try {
+        setLoading(true);
+        setError(null);
+        const searchParams = new URLSearchParams();
+        Object.entries(params).forEach(([key, value]) => {
+          if (value !== void 0) {
+            searchParams.append(key, String(value));
+          }
+        });
+        const queryString = searchParams.toString();
+        const fullUrl = queryString ? `${url}${url.includes("?") ? "&" : "?"}${queryString}` : url;
+        const response = await fetch(fullUrl);
+        if (!response.ok) {
+          throw new Error(`Failed to initialize: ${response.statusText}`);
+        }
+        const json = await response.json();
+        if (isMounted) {
+          setData(json);
+        }
+      } catch (err) {
+        if (isMounted) {
+          setError(err instanceof Error ? err : new Error(String(err)));
+        }
+      } finally {
+        if (isMounted) {
+          setLoading(false);
+        }
+      }
+    }
+    init();
+    return () => {
+      isMounted = false;
+    };
+  }, [url, JSON.stringify(params)]);
+  return { data, loading, error };
+}
 
 exports.MelonyContext = MelonyContext;
 exports.MelonyProvider = MelonyProvider;
@@ -120,5 +158,6 @@ exports.defaultGetThreadId = defaultGetThreadId;
 exports.defaultProcessEvent = defaultProcessEvent;
 exports.defaultShouldStartNewMessage = defaultShouldStartNewMessage;
 exports.useMelony = useMelony;
+exports.useMelonyInit = useMelonyInit;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/message-converter.ts","../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts"],"names":["createContext","useState","useEffect","useMemo","useContext"],"mappings":"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","file":"index.cjs","sourcesContent":["import { Event, Role } from \"melony\";\n\n/**\n * A message aggregated from multiple events.\n */\nexport interface AggregatedMessage {\n  /** The role of the sender (user, assistant, or system) */\n  role: Role;\n  /** The text content of the message, aggregated from text events */\n  content: string;\n  /** The unique ID for the run that produced this message */\n  runId?: string;\n  /** The ID of the thread this message belongs to */\n  threadId?: string;\n  /** UI events (e.g. SDUI components) associated with this message */\n  uiEvents: Event[];\n}\n\n/**\n * Options for configuring how events are aggregated into messages.\n */\nexport interface AggregateOptions<TEvent extends Event = Event> {\n  /**\n   * Custom logic to extract the role from an event.\n   * Defaults to event.meta.role or 'assistant'.\n   */\n  getRole?: (event: TEvent) => Role;\n\n  /**\n   * Custom logic to extract the runId from an event.\n   * Defaults to event.meta.runId.\n   */\n  getRunId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to extract the threadId from an event.\n   * Defaults to event.meta.threadId.\n   */\n  getThreadId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to determine if a new message should be started.\n   * By default, starts a new message if:\n   * 1. There is no current message.\n   * 2. The role of the event is different from the current message.\n   * 3. The runId of the event is different from the current message's runId.\n   */\n  shouldStartNewMessage?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage | null,\n    options: { getRole: (e: TEvent) => Role; getRunId: (e: TEvent) => string | undefined }\n  ) => boolean;\n\n  /**\n   * Custom logic to process an event and update the current message.\n   * By default:\n   * - 'text-delta' events append their delta to the message content.\n   * - 'text' events append their content or text to the message content.\n   * - All other events are added to the message's uiEvents array.\n   */\n  processEvent?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage,\n  ) => void;\n}\n\n/**\n * Default implementation for extracting role from an event.\n */\nexport const defaultGetRole = <T extends Event>(e: T): Role => e.meta?.role || \"assistant\";\n\n/**\n * Default implementation for extracting runId from an event.\n */\nexport const defaultGetRunId = <T extends Event>(e: T): string | undefined => e.meta?.runId;\n\n/**\n * Default implementation for extracting threadId from an event.\n */\nexport const defaultGetThreadId = <T extends Event>(e: T): string | undefined => e.meta?.threadId || e.meta?.state?.threadId;\n\n/**\n * Default logic for determining if a new message should start.\n */\nexport const defaultShouldStartNewMessage = <T extends Event>(\n  event: T,\n  current: AggregatedMessage | null,\n  utils: { getRole: (e: T) => Role; getRunId: (e: T) => string | undefined; getThreadId: (e: T) => string | undefined }\n): boolean => {\n  if (!current) return true;\n  const role = utils.getRole(event);\n  const runId = utils.getRunId(event);\n  \n  // Start new message if role changes\n  if (current.role !== role) return true;\n  \n  // Start new message if runId changes (and both have runIds)\n  if (runId && current.runId && runId !== current.runId) return true;\n  \n  return false;\n};\n\n/**\n * Default logic for processing an event into a message.\n */\nexport const defaultProcessEvent = <T extends Event>(event: T, current: AggregatedMessage): void => {\n  if (event.type === \"text-delta\" && (event.data as any)?.delta) {\n    current.content += (event.data as any).delta;\n  } else if (event.type === \"text\") {\n    current.content += (event.data as any)?.content || (event.data as any)?.text || \"\";\n  } else {\n    current.uiEvents.push(event);\n  }\n};\n\n/**\n * Helper to aggregate a list of events into a list of messages.\n * This is useful for rendering a chat-like interface from a raw event stream.\n * \n * @param events The list of events to aggregate.\n * @param options Configuration for aggregation logic.\n * @returns An array of aggregated messages.\n */\nexport function convertEventsToAggregatedMessages<TEvent extends Event = Event>(\n  events: TEvent[],\n  options: AggregateOptions<TEvent> = {}\n): AggregatedMessage[] {\n  const getRole = options.getRole || defaultGetRole;\n  const getRunId = options.getRunId || defaultGetRunId;\n  const getThreadId = options.getThreadId || defaultGetThreadId;\n  const shouldStartNewMessage = options.shouldStartNewMessage || defaultShouldStartNewMessage;\n  const processEvent = options.processEvent || defaultProcessEvent;\n\n  if (events.length === 0) return [];\n\n  const messages: AggregatedMessage[] = [];\n  let currentMessage: AggregatedMessage | null = null;\n\n  for (const event of events) {\n    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {\n      currentMessage = {\n        role: getRole(event),\n        content: \"\",\n        runId: getRunId(event),\n        threadId: getThreadId(event),\n        uiEvents: [],\n      };\n      messages.push(currentMessage);\n    }\n\n    if (currentMessage) {\n      processEvent(event, currentMessage);\n      \n      // If current message didn't have a runId but this event does, update it\n      if (!currentMessage.runId) {\n        const runId = getRunId(event);\n        if (runId) {\n          currentMessage.runId = runId;\n        }\n      }\n\n      // If current message didn't have a threadId but this event does, update it\n      if (!currentMessage.threadId) {\n        const threadId = getThreadId(event);\n        if (threadId) {\n          currentMessage.threadId = threadId;\n        }\n      }\n    }\n  }\n\n  return messages;\n}\n","import React, {\n  createContext,\n  useEffect,\n  useState,\n  useMemo,\n  ReactNode,\n} from \"react\";\nimport { MelonyClient, ClientState } from \"melony/client\";\nimport {\n  Config,\n  Event,\n} from \"melony\";\nimport { \n  AggregatedMessage, \n  AggregateOptions, \n  convertEventsToAggregatedMessages \n} from \"../utils/message-converter\";\n\nexport interface MelonyContextValue extends ClientState {\n  sendEvent: (event: Event) => Promise<void>;\n  reset: (events?: Event[]) => void;\n  client: MelonyClient;\n  config?: Config;\n  messages: AggregatedMessage[];\n}\n\nexport const MelonyContext = createContext<MelonyContextValue | undefined>(\n  undefined,\n);\n\nexport interface MelonyProviderProps {\n  children: ReactNode;\n  client: MelonyClient;\n  initialEvents?: Event[];\n  aggregationOptions?: AggregateOptions;\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n  children,\n  client,\n  initialEvents,\n  aggregationOptions,\n}) => {\n  const [state, setState] = useState<ClientState>(client.getState());\n\n  // Handle initial events on mount only\n  useEffect(() => {\n    if (initialEvents?.length && client.getState().events.length === 0) {\n      client.reset(initialEvents);\n    }\n  }, []); // Empty deps - run once on mount\n\n  // Subscribe to state changes\n  useEffect(() => {\n    const unsubscribe = client.subscribe(setState);\n    return unsubscribe;\n  }, [client]);\n\n  const messages = useMemo(\n    () => convertEventsToAggregatedMessages(state.events, aggregationOptions),\n    [state.events, aggregationOptions]\n  );\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      messages,\n      sendEvent: async (event: Event) => {\n        const generator = client.sendEvent(event);\n        // Consume the generator to ensure event processing completes\n        for await (const _ of generator) {\n          // Events are handled by the client subscription\n        }\n      },\n      reset: client.reset.bind(client),\n      client,\n    }),\n    [state, messages, client],\n  );\n\n  return (\n    <MelonyContext.Provider value={contextValue}>\n      {children}\n    </MelonyContext.Provider>\n  );\n};","import { useContext } from \"react\";\nimport { MelonyContext, MelonyContextValue } from \"@/providers/melony-provider\";\n\nexport const useMelony = (): MelonyContextValue => {\n  const context = useContext(MelonyContext);\n  if (context === undefined) {\n    throw new Error(\"useMelony must be used within a MelonyProvider\");\n  }\n\n  return context;\n};\n"]}
+{"version":3,"sources":["../src/utils/message-converter.ts","../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts","../src/hooks/use-melony-init.ts"],"names":["createContext","useState","useEffect","useMemo","useContext"],"mappings":";;;;;;;;AAgEO,IAAM,iBAAiB,CAAkB,CAAA,KAAiB,CAAA,CAAE,IAAA,KAAS,cAAc,MAAA,GAAS;AAK5F,IAAM,eAAA,GAAkB,CAAkB,CAAA,EAAM,OAAA,KAAyD;AAC9G,EAAA,OAAO,OAAA,EAAS,KAAA;AAClB;AAKO,IAAM,kBAAA,GAAqB,CAAkB,CAAA,KAA6B,CAAA,CAAE,IAAA,EAAM;AAKlF,IAAM,4BAAA,GAA+B,CAC1C,KAAA,EACA,OAAA,EACA,KAAA,KACY;AACZ,EAAA,IAAI,CAAC,SAAS,OAAO,IAAA;AACrB,EAAA,MAAM,IAAA,GAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA;AAChC,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,QAAA,CAAS,KAAK,CAAA;AAGlC,EAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,IAAA,EAAM,OAAO,IAAA;AAGlC,EAAA,IAAI,SAAS,OAAA,CAAQ,KAAA,IAAS,KAAA,KAAU,OAAA,CAAQ,OAAO,OAAO,IAAA;AAE9D,EAAA,OAAO,KAAA;AACT;AAKO,IAAM,mBAAA,GAAsB,CAAkB,KAAA,EAAU,OAAA,KAAqC;AAClG,EAAA,OAAA,CAAQ,OAAA,CAAQ,KAAK,KAAK,CAAA;AAC5B;AAUO,SAAS,iCAAA,CACd,MAAA,EACA,OAAA,GAAoC,EAAC,EAChB;AACrB,EAAA,MAAM,OAAA,GAAU,QAAQ,OAAA,IAAW,cAAA;AACnC,EAAA,MAAM,QAAA,GAAW,QAAQ,QAAA,IAAY,eAAA;AACrC,EAAA,MAAM,WAAA,GAAc,QAAQ,WAAA,IAAe,kBAAA;AAC3C,EAAA,MAAM,qBAAA,GAAwB,QAAQ,qBAAA,IAAyB,4BAAA;AAC/D,EAAA,MAAM,YAAA,GAAe,QAAQ,YAAA,IAAgB,mBAAA;AAE7C,EAAA,IAAI,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAEjC,EAAA,MAAM,WAAgC,EAAC;AACvC,EAAA,IAAI,cAAA,GAA2C,IAAA;AAE/C,EAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,IAAA,IAAI,qBAAA,CAAsB,OAAO,cAAA,EAAgB,EAAE,SAAS,QAAA,EAAU,WAAA,EAAa,CAAA,EAAG;AACpF,MAAA,cAAA,GAAiB;AAAA,QACf,IAAA,EAAM,QAAQ,KAAK,CAAA;AAAA,QACnB,SAAS,EAAC;AAAA,QACV,KAAA,EAAO,SAAS,KAAK,CAAA;AAAA,QACrB,QAAA,EAAU,YAAY,KAAK;AAAA,OAC7B;AACA,MAAA,QAAA,CAAS,KAAK,cAAc,CAAA;AAAA,IAC9B;AAEA,IAAA,IAAI,cAAA,EAAgB;AAClB,MAAA,YAAA,CAAa,OAAO,cAAc,CAAA;AAGlC,MAAA,IAAI,CAAC,eAAe,KAAA,EAAO;AACzB,QAAA,MAAM,KAAA,GAAQ,SAAS,KAAK,CAAA;AAC5B,QAAA,IAAI,KAAA,EAAO;AACT,UAAA,cAAA,CAAe,KAAA,GAAQ,KAAA;AAAA,QACzB;AAAA,MACF;AAGA,MAAA,IAAI,CAAC,eAAe,QAAA,EAAU;AAC5B,QAAA,MAAM,QAAA,GAAW,YAAY,KAAK,CAAA;AAClC,QAAA,IAAI,QAAA,EAAU;AACZ,UAAA,cAAA,CAAe,QAAA,GAAW,QAAA;AAAA,QAC5B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,QAAA;AACT;ACxIO,IAAM,aAAA,GAAgBA,mBAAA;AAAA,EAC3B;AACF;AASO,IAAM,iBAAgD,CAAC;AAAA,EAC5D,QAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA,KAAM;AACJ,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,IAAIC,cAAA,CAAsB,MAAA,CAAO,UAAU,CAAA;AAGjE,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,eAAe,MAAA,IAAU,MAAA,CAAO,UAAS,CAAE,MAAA,CAAO,WAAW,CAAA,EAAG;AAClE,MAAA,MAAA,CAAO,MAAM,aAAa,CAAA;AAAA,IAC5B;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAGL,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,WAAA,GAAc,MAAA,CAAO,SAAA,CAAU,QAAQ,CAAA;AAC7C,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,QAAA,GAAWC,aAAA;AAAA,IACf,MAAM,iCAAA,CAAkC,KAAA,CAAM,MAAA,EAAQ,kBAAkB,CAAA;AAAA,IACxE,CAAC,KAAA,CAAM,MAAA,EAAQ,kBAAkB;AAAA,GACnC;AAEA,EAAA,MAAM,YAAA,GAAeA,aAAA;AAAA,IACnB,OAAO;AAAA,MACL,GAAG,KAAA;AAAA,MACH,QAAA;AAAA,MACA,IAAA,EAAM,OAAO,KAAA,KAAiB;AAC5B,QAAA,MAAM,SAAA,GAAY,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA;AAEnC,QAAA,WAAA,MAAiB,KAAK,SAAA,EAAW;AAAA,QAEjC;AAAA,MACF,CAAA;AAAA,MACA,KAAA,EAAO,MAAA,CAAO,KAAA,CAAM,IAAA,CAAK,MAAM,CAAA;AAAA,MAC/B;AAAA,KACF,CAAA;AAAA,IACA,CAAC,KAAA,EAAO,QAAA,EAAU,MAAM;AAAA,GAC1B;AAEA,EAAA,sCACG,aAAA,CAAc,QAAA,EAAd,EAAuB,KAAA,EAAO,cAC5B,QAAA,EACH,CAAA;AAEJ;AClFO,IAAM,YAAY,MAA0B;AACjD,EAAA,MAAM,OAAA,GAAUC,iBAAW,aAAa,CAAA;AACxC,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAAA,EAClE;AAEA,EAAA,OAAO,OAAA;AACT;ACDO,SAAS,aAAA,CACd,GAAA,EACA,MAAA,GAAgE,EAAC,EACjE;AACA,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAIH,eAAmB,IAAI,CAAA;AAC/C,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,eAAS,IAAI,CAAA;AAC3C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAuB,IAAI,CAAA;AAErD,EAAAC,gBAAU,MAAM;AACd,IAAA,IAAI,SAAA,GAAY,IAAA;AAEhB,IAAA,eAAe,IAAA,GAAO;AACpB,MAAA,IAAI;AACF,QAAA,UAAA,CAAW,IAAI,CAAA;AACf,QAAA,QAAA,CAAS,IAAI,CAAA;AAEb,QAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AACzC,QAAA,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM;AAC/C,UAAA,IAAI,UAAU,KAAA,CAAA,EAAW;AACvB,YAAA,YAAA,CAAa,MAAA,CAAO,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,UACxC;AAAA,QACF,CAAC,CAAA;AAED,QAAA,MAAM,WAAA,GAAc,aAAa,QAAA,EAAS;AAC1C,QAAA,MAAM,OAAA,GAAU,WAAA,GAAc,CAAA,EAAG,GAAG,CAAA,EAAG,GAAA,CAAI,QAAA,CAAS,GAAG,CAAA,GAAI,GAAA,GAAM,GAAG,CAAA,EAAG,WAAW,CAAA,CAAA,GAAK,GAAA;AAEvF,QAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,OAAO,CAAA;AACpC,QAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,UAAA,MAAM,IAAI,KAAA,CAAM,CAAA,sBAAA,EAAyB,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,QAChE;AACA,QAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAEjC,QAAA,IAAI,SAAA,EAAW;AACb,UAAA,OAAA,CAAQ,IAAI,CAAA;AAAA,QACd;AAAA,MACF,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,SAAA,EAAW;AACb,UAAA,QAAA,CAAS,GAAA,YAAe,QAAQ,GAAA,GAAM,IAAI,MAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AAAA,QAC9D;AAAA,MACF,CAAA,SAAE;AACA,QAAA,IAAI,SAAA,EAAW;AACb,UAAA,UAAA,CAAW,KAAK,CAAA;AAAA,QAClB;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAA,EAAK;AAEL,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,KAAA;AAAA,IACd,CAAA;AAAA,EACF,GAAG,CAAC,GAAA,EAAK,KAAK,SAAA,CAAU,MAAM,CAAC,CAAC,CAAA;AAEhC,EAAA,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,KAAA,EAAM;AAChC","file":"index.cjs","sourcesContent":["import { Event, RuntimeContext } from \"melony\";\n\n/**\n * A message aggregated from multiple events.\n */\nexport interface AggregatedMessage {\n  /** The role of the sender (user, assistant, or system) */\n  role: string;\n  /** The content of the message, containing the events */\n  content: Event[];\n  /** The unique ID for the run that produced this message */\n  runId?: string;\n  /** The ID of the thread this message belongs to */\n  threadId?: string;\n}\n\n/**\n * Options for configuring how events are aggregated into messages.\n */\nexport interface AggregateOptions<TEvent extends Event = Event> {\n  /**\n   * Custom logic to extract the role from an event.\n   * Defaults to event.meta.role or 'assistant'.\n   */\n  getRole?: (event: TEvent) => string;\n\n  /**\n   * Custom logic to extract the runId from an event.\n   * Defaults to event.meta.runId.\n   */\n  getRunId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to extract the threadId from an event.\n   * Defaults to event.meta.threadId.\n   */\n  getThreadId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to determine if a new message should be started.\n   * By default, starts a new message if:\n   * 1. There is no current message.\n   * 2. The role of the event is different from the current message.\n   * 3. The runId of the event is different from the current message's runId.\n   */\n  shouldStartNewMessage?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage | null,\n    options: { getRole: (e: TEvent) => string; getRunId: (e: TEvent) => string | undefined }\n  ) => boolean;\n\n  /**\n   * Custom logic to process an event and update the current message.\n   * By default, events are simply added to the message's content array.\n   */\n  processEvent?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage,\n  ) => void;\n}\n\n/**\n * Default implementation for extracting role from an event.\n */\nexport const defaultGetRole = <T extends Event>(e: T): string => e.type === \"user:text\" ? \"user\" : \"assistant\";\n\n/**\n * Default implementation for extracting runId from an event.\n */\nexport const defaultGetRunId = <T extends Event>(e: T, context?: RuntimeContext<any, T>): string | undefined => {\n  return context?.runId;\n};\n\n/**\n * Default implementation for extracting threadId from an event.\n */\nexport const defaultGetThreadId = <T extends Event>(e: T): string | undefined => e.data?.threadId;\n\n/**\n * Default logic for determining if a new message should start.\n */\nexport const defaultShouldStartNewMessage = <T extends Event>(\n  event: T,\n  current: AggregatedMessage | null,\n  utils: { getRole: (e: T) => string; getRunId: (e: T) => string | undefined; getThreadId: (e: T) => string | undefined }\n): boolean => {\n  if (!current) return true;\n  const role = utils.getRole(event);\n  const runId = utils.getRunId(event);\n  \n  // Start new message if role changes\n  if (current.role !== role) return true;\n  \n  // Start new message if runId changes (and both have runIds)\n  if (runId && current.runId && runId !== current.runId) return true;\n  \n  return false;\n};\n\n/**\n * Default logic for processing an event into a message.\n */\nexport const defaultProcessEvent = <T extends Event>(event: T, current: AggregatedMessage): void => {\n  current.content.push(event);\n};\n\n/**\n * Helper to aggregate a list of events into a list of messages.\n * This is useful for rendering a chat-like interface from a raw event stream.\n * \n * @param events The list of events to aggregate.\n * @param options Configuration for aggregation logic.\n * @returns An array of aggregated messages.\n */\nexport function convertEventsToAggregatedMessages<TEvent extends Event = Event>(\n  events: TEvent[],\n  options: AggregateOptions<TEvent> = {}\n): AggregatedMessage[] {\n  const getRole = options.getRole || defaultGetRole;\n  const getRunId = options.getRunId || defaultGetRunId;\n  const getThreadId = options.getThreadId || defaultGetThreadId;\n  const shouldStartNewMessage = options.shouldStartNewMessage || defaultShouldStartNewMessage;\n  const processEvent = options.processEvent || defaultProcessEvent;\n\n  if (events.length === 0) return [];\n\n  const messages: AggregatedMessage[] = [];\n  let currentMessage: AggregatedMessage | null = null;\n\n  for (const event of events) {\n    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {\n      currentMessage = {\n        role: getRole(event),\n        content: [],\n        runId: getRunId(event),\n        threadId: getThreadId(event),\n      };\n      messages.push(currentMessage);\n    }\n\n    if (currentMessage) {\n      processEvent(event, currentMessage);\n      \n      // If current message didn't have a runId but this event does, update it\n      if (!currentMessage.runId) {\n        const runId = getRunId(event);\n        if (runId) {\n          currentMessage.runId = runId;\n        }\n      }\n\n      // If current message didn't have a threadId but this event does, update it\n      if (!currentMessage.threadId) {\n        const threadId = getThreadId(event);\n        if (threadId) {\n          currentMessage.threadId = threadId;\n        }\n      }\n    }\n  }\n\n  return messages;\n}\n","import React, {\n  createContext,\n  useEffect,\n  useState,\n  useMemo,\n  ReactNode,\n} from \"react\";\nimport { MelonyClient, ClientState } from \"melony/client\";\nimport {\n  Config,\n  Event,\n} from \"melony\";\nimport { \n  AggregatedMessage, \n  AggregateOptions, \n  convertEventsToAggregatedMessages \n} from \"../utils/message-converter\";\n\nexport interface MelonyContextValue extends ClientState {\n  send: (event: Event) => Promise<void>;\n  reset: (events?: Event[]) => void;\n  client: MelonyClient;\n  config?: Config;\n  messages: AggregatedMessage[];\n}\n\nexport const MelonyContext = createContext<MelonyContextValue | undefined>(\n  undefined,\n);\n\nexport interface MelonyProviderProps {\n  children: ReactNode;\n  client: MelonyClient;\n  initialEvents?: Event[];\n  aggregationOptions?: AggregateOptions;\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n  children,\n  client,\n  initialEvents,\n  aggregationOptions,\n}) => {\n  const [state, setState] = useState<ClientState>(client.getState());\n\n  // Handle initial events on mount only\n  useEffect(() => {\n    if (initialEvents?.length && client.getState().events.length === 0) {\n      client.reset(initialEvents);\n    }\n  }, []); // Empty deps - run once on mount\n\n  // Subscribe to state changes\n  useEffect(() => {\n    const unsubscribe = client.subscribe(setState);\n    return unsubscribe;\n  }, [client]);\n\n  const messages = useMemo(\n    () => convertEventsToAggregatedMessages(state.events, aggregationOptions),\n    [state.events, aggregationOptions]\n  );\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      messages,\n      send: async (event: Event) => {\n        const generator = client.send(event);\n        // Consume the generator to ensure event processing completes\n        for await (const _ of generator) {\n          // Events are handled by the client subscription\n        }\n      },\n      reset: client.reset.bind(client),\n      client,\n    }),\n    [state, messages, client],\n  );\n\n  return (\n    <MelonyContext.Provider value={contextValue}>\n      {children}\n    </MelonyContext.Provider>\n  );\n};","import { useContext } from \"react\";\nimport { MelonyContext, MelonyContextValue } from \"../providers/melony-provider\";\n\nexport const useMelony = (): MelonyContextValue => {\n  const context = useContext(MelonyContext);\n  if (context === undefined) {\n    throw new Error(\"useMelony must be used within a MelonyProvider\");\n  }\n\n  return context;\n};\n","import { useEffect, useState } from \"react\";\n\n/**\n * A hook to initialize a Melony application by fetching the initial UI state.\n * \n * @param url The API endpoint to fetch the initial state from.\n * @param params Optional query parameters to include in the request.\n * @returns An object containing the UI data, loading state, and any error encountered.\n */\nexport function useMelonyInit<T = any>(\n  url: string, \n  params: Record<string, string | number | boolean | undefined> = {}\n) {\n  const [data, setData] = useState<T | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    let isMounted = true;\n\n    async function init() {\n      try {\n        setLoading(true);\n        setError(null);\n\n        const searchParams = new URLSearchParams();\n        Object.entries(params).forEach(([key, value]) => {\n          if (value !== undefined) {\n            searchParams.append(key, String(value));\n          }\n        });\n        \n        const queryString = searchParams.toString();\n        const fullUrl = queryString ? `${url}${url.includes('?') ? '&' : '?'}${queryString}` : url;\n        \n        const response = await fetch(fullUrl);\n        if (!response.ok) {\n          throw new Error(`Failed to initialize: ${response.statusText}`);\n        }\n        const json = await response.json();\n        \n        if (isMounted) {\n          setData(json);\n        }\n      } catch (err) {\n        if (isMounted) {\n          setError(err instanceof Error ? err : new Error(String(err)));\n        }\n      } finally {\n        if (isMounted) {\n          setLoading(false);\n        }\n      }\n    }\n\n    init();\n\n    return () => {\n      isMounted = false;\n    };\n  }, [url, JSON.stringify(params)]);\n\n  return { data, loading, error };\n}\n"]}

package/dist/index.d.cts

@@ -1,21 +1,19 @@
 import React, { ReactNode } from 'react';
 import { ClientState, MelonyClient } from 'melony/client';
-import { Role, Event, Config } from 'melony';
+import { Event, RuntimeContext, Config } from 'melony';
 
 /**
  * A message aggregated from multiple events.
  */
 interface AggregatedMessage {
     /** The role of the sender (user, assistant, or system) */
-    role: Role;
-    /** The text content of the message, aggregated from text events */
-    content: string;
+    role: string;
+    /** The content of the message, containing the events */
+    content: Event[];
     /** The unique ID for the run that produced this message */
     runId?: string;
     /** The ID of the thread this message belongs to */
     threadId?: string;
-    /** UI events (e.g. SDUI components) associated with this message */
-    uiEvents: Event[];
 }
 /**
  * Options for configuring how events are aggregated into messages.
@@ -25,7 +23,7 @@ interface AggregateOptions<TEvent extends Event = Event> {
      * Custom logic to extract the role from an event.
      * Defaults to event.meta.role or 'assistant'.
      */
-    getRole?: (event: TEvent) => Role;
+    getRole?: (event: TEvent) => string;
     /**
      * Custom logic to extract the runId from an event.
      * Defaults to event.meta.runId.
@@ -44,26 +42,23 @@ interface AggregateOptions<TEvent extends Event = Event> {
      * 3. The runId of the event is different from the current message's runId.
      */
     shouldStartNewMessage?: (event: TEvent, currentMessage: AggregatedMessage | null, options: {
-        getRole: (e: TEvent) => Role;
+        getRole: (e: TEvent) => string;
         getRunId: (e: TEvent) => string | undefined;
     }) => boolean;
     /**
      * Custom logic to process an event and update the current message.
-     * By default:
-     * - 'text-delta' events append their delta to the message content.
-     * - 'text' events append their content or text to the message content.
-     * - All other events are added to the message's uiEvents array.
+     * By default, events are simply added to the message's content array.
      */
     processEvent?: (event: TEvent, currentMessage: AggregatedMessage) => void;
 }
 /**
  * Default implementation for extracting role from an event.
  */
-declare const defaultGetRole: <T extends Event>(e: T) => Role;
+declare const defaultGetRole: <T extends Event>(e: T) => string;
 /**
  * Default implementation for extracting runId from an event.
  */
-declare const defaultGetRunId: <T extends Event>(e: T) => string | undefined;
+declare const defaultGetRunId: <T extends Event>(e: T, context?: RuntimeContext<any, T>) => string | undefined;
 /**
  * Default implementation for extracting threadId from an event.
  */
@@ -72,7 +67,7 @@ declare const defaultGetThreadId: <T extends Event>(e: T) => string | undefined;
  * Default logic for determining if a new message should start.
  */
 declare const defaultShouldStartNewMessage: <T extends Event>(event: T, current: AggregatedMessage | null, utils: {
-    getRole: (e: T) => Role;
+    getRole: (e: T) => string;
     getRunId: (e: T) => string | undefined;
     getThreadId: (e: T) => string | undefined;
 }) => boolean;
@@ -91,7 +86,7 @@ declare const defaultProcessEvent: <T extends Event>(event: T, current: Aggregat
 declare function convertEventsToAggregatedMessages<TEvent extends Event = Event>(events: TEvent[], options?: AggregateOptions<TEvent>): AggregatedMessage[];
 
 interface MelonyContextValue extends ClientState {
-    sendEvent: (event: Event) => Promise<void>;
+    send: (event: Event) => Promise<void>;
     reset: (events?: Event[]) => void;
     client: MelonyClient;
     config?: Config;
@@ -108,4 +103,17 @@ declare const MelonyProvider: React.FC<MelonyProviderProps>;
 
 declare const useMelony: () => MelonyContextValue;
 
-export { type AggregateOptions, type AggregatedMessage, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony };
+/**
+ * A hook to initialize a Melony application by fetching the initial UI state.
+ *
+ * @param url The API endpoint to fetch the initial state from.
+ * @param params Optional query parameters to include in the request.
+ * @returns An object containing the UI data, loading state, and any error encountered.
+ */
+declare function useMelonyInit<T = any>(url: string, params?: Record<string, string | number | boolean | undefined>): {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+};
+
+export { type AggregateOptions, type AggregatedMessage, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };

package/dist/index.d.ts

@@ -1,21 +1,19 @@
 import React, { ReactNode } from 'react';
 import { ClientState, MelonyClient } from 'melony/client';
-import { Role, Event, Config } from 'melony';
+import { Event, RuntimeContext, Config } from 'melony';
 
 /**
  * A message aggregated from multiple events.
  */
 interface AggregatedMessage {
     /** The role of the sender (user, assistant, or system) */
-    role: Role;
-    /** The text content of the message, aggregated from text events */
-    content: string;
+    role: string;
+    /** The content of the message, containing the events */
+    content: Event[];
     /** The unique ID for the run that produced this message */
     runId?: string;
     /** The ID of the thread this message belongs to */
     threadId?: string;
-    /** UI events (e.g. SDUI components) associated with this message */
-    uiEvents: Event[];
 }
 /**
  * Options for configuring how events are aggregated into messages.
@@ -25,7 +23,7 @@ interface AggregateOptions<TEvent extends Event = Event> {
      * Custom logic to extract the role from an event.
      * Defaults to event.meta.role or 'assistant'.
      */
-    getRole?: (event: TEvent) => Role;
+    getRole?: (event: TEvent) => string;
     /**
      * Custom logic to extract the runId from an event.
      * Defaults to event.meta.runId.
@@ -44,26 +42,23 @@ interface AggregateOptions<TEvent extends Event = Event> {
      * 3. The runId of the event is different from the current message's runId.
      */
     shouldStartNewMessage?: (event: TEvent, currentMessage: AggregatedMessage | null, options: {
-        getRole: (e: TEvent) => Role;
+        getRole: (e: TEvent) => string;
         getRunId: (e: TEvent) => string | undefined;
     }) => boolean;
     /**
      * Custom logic to process an event and update the current message.
-     * By default:
-     * - 'text-delta' events append their delta to the message content.
-     * - 'text' events append their content or text to the message content.
-     * - All other events are added to the message's uiEvents array.
+     * By default, events are simply added to the message's content array.
      */
     processEvent?: (event: TEvent, currentMessage: AggregatedMessage) => void;
 }
 /**
  * Default implementation for extracting role from an event.
  */
-declare const defaultGetRole: <T extends Event>(e: T) => Role;
+declare const defaultGetRole: <T extends Event>(e: T) => string;
 /**
  * Default implementation for extracting runId from an event.
  */
-declare const defaultGetRunId: <T extends Event>(e: T) => string | undefined;
+declare const defaultGetRunId: <T extends Event>(e: T, context?: RuntimeContext<any, T>) => string | undefined;
 /**
  * Default implementation for extracting threadId from an event.
  */
@@ -72,7 +67,7 @@ declare const defaultGetThreadId: <T extends Event>(e: T) => string | undefined;
  * Default logic for determining if a new message should start.
  */
 declare const defaultShouldStartNewMessage: <T extends Event>(event: T, current: AggregatedMessage | null, utils: {
-    getRole: (e: T) => Role;
+    getRole: (e: T) => string;
     getRunId: (e: T) => string | undefined;
     getThreadId: (e: T) => string | undefined;
 }) => boolean;
@@ -91,7 +86,7 @@ declare const defaultProcessEvent: <T extends Event>(event: T, current: Aggregat
 declare function convertEventsToAggregatedMessages<TEvent extends Event = Event>(events: TEvent[], options?: AggregateOptions<TEvent>): AggregatedMessage[];
 
 interface MelonyContextValue extends ClientState {
-    sendEvent: (event: Event) => Promise<void>;
+    send: (event: Event) => Promise<void>;
     reset: (events?: Event[]) => void;
     client: MelonyClient;
     config?: Config;
@@ -108,4 +103,17 @@ declare const MelonyProvider: React.FC<MelonyProviderProps>;
 
 declare const useMelony: () => MelonyContextValue;
 
-export { type AggregateOptions, type AggregatedMessage, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony };
+/**
+ * A hook to initialize a Melony application by fetching the initial UI state.
+ *
+ * @param url The API endpoint to fetch the initial state from.
+ * @param params Optional query parameters to include in the request.
+ * @returns An object containing the UI data, loading state, and any error encountered.
+ */
+declare function useMelonyInit<T = any>(url: string, params?: Record<string, string | number | boolean | undefined>): {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+};
+
+export { type AggregateOptions, type AggregatedMessage, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };

package/dist/index.js

@@ -4,9 +4,11 @@ import { jsx } from 'react/jsx-runtime';
 // src/providers/melony-provider.tsx
 
 // src/utils/message-converter.ts
-var defaultGetRole = (e) => e.meta?.role || "assistant";
-var defaultGetRunId = (e) => e.meta?.runId;
-var defaultGetThreadId = (e) => e.meta?.threadId || e.meta?.state?.threadId;
+var defaultGetRole = (e) => e.type === "user:text" ? "user" : "assistant";
+var defaultGetRunId = (e, context) => {
+  return context?.runId;
+};
+var defaultGetThreadId = (e) => e.data?.threadId;
 var defaultShouldStartNewMessage = (event, current, utils) => {
   if (!current) return true;
   const role = utils.getRole(event);
@@ -16,13 +18,7 @@ var defaultShouldStartNewMessage = (event, current, utils) => {
   return false;
 };
 var defaultProcessEvent = (event, current) => {
-  if (event.type === "text-delta" && event.data?.delta) {
-    current.content += event.data.delta;
-  } else if (event.type === "text") {
-    current.content += event.data?.content || event.data?.text || "";
-  } else {
-    current.uiEvents.push(event);
-  }
+  current.content.push(event);
 };
 function convertEventsToAggregatedMessages(events, options = {}) {
   const getRole = options.getRole || defaultGetRole;
@@ -37,10 +33,9 @@ function convertEventsToAggregatedMessages(events, options = {}) {
     if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {
       currentMessage = {
         role: getRole(event),
-        content: "",
+        content: [],
         runId: getRunId(event),
-        threadId: getThreadId(event),
-        uiEvents: []
+        threadId: getThreadId(event)
       };
       messages.push(currentMessage);
     }
@@ -89,8 +84,8 @@ var MelonyProvider = ({
     () => ({
       ...state,
       messages,
-      sendEvent: async (event) => {
-        const generator = client.sendEvent(event);
+      send: async (event) => {
+        const generator = client.send(event);
         for await (const _ of generator) {
         }
       },
@@ -108,7 +103,50 @@ var useMelony = () => {
   }
   return context;
 };
+function useMelonyInit(url, params = {}) {
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    let isMounted = true;
+    async function init() {
+      try {
+        setLoading(true);
+        setError(null);
+        const searchParams = new URLSearchParams();
+        Object.entries(params).forEach(([key, value]) => {
+          if (value !== void 0) {
+            searchParams.append(key, String(value));
+          }
+        });
+        const queryString = searchParams.toString();
+        const fullUrl = queryString ? `${url}${url.includes("?") ? "&" : "?"}${queryString}` : url;
+        const response = await fetch(fullUrl);
+        if (!response.ok) {
+          throw new Error(`Failed to initialize: ${response.statusText}`);
+        }
+        const json = await response.json();
+        if (isMounted) {
+          setData(json);
+        }
+      } catch (err) {
+        if (isMounted) {
+          setError(err instanceof Error ? err : new Error(String(err)));
+        }
+      } finally {
+        if (isMounted) {
+          setLoading(false);
+        }
+      }
+    }
+    init();
+    return () => {
+      isMounted = false;
+    };
+  }, [url, JSON.stringify(params)]);
+  return { data, loading, error };
+}
 
-export { MelonyContext, MelonyProvider, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony };
+export { MelonyContext, MelonyProvider, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/message-converter.ts","../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Event, Role } from \"melony\";\n\n/**\n * A message aggregated from multiple events.\n */\nexport interface AggregatedMessage {\n  /** The role of the sender (user, assistant, or system) */\n  role: Role;\n  /** The text content of the message, aggregated from text events */\n  content: string;\n  /** The unique ID for the run that produced this message */\n  runId?: string;\n  /** The ID of the thread this message belongs to */\n  threadId?: string;\n  /** UI events (e.g. SDUI components) associated with this message */\n  uiEvents: Event[];\n}\n\n/**\n * Options for configuring how events are aggregated into messages.\n */\nexport interface AggregateOptions<TEvent extends Event = Event> {\n  /**\n   * Custom logic to extract the role from an event.\n   * Defaults to event.meta.role or 'assistant'.\n   */\n  getRole?: (event: TEvent) => Role;\n\n  /**\n   * Custom logic to extract the runId from an event.\n   * Defaults to event.meta.runId.\n   */\n  getRunId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to extract the threadId from an event.\n   * Defaults to event.meta.threadId.\n   */\n  getThreadId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to determine if a new message should be started.\n   * By default, starts a new message if:\n   * 1. There is no current message.\n   * 2. The role of the event is different from the current message.\n   * 3. The runId of the event is different from the current message's runId.\n   */\n  shouldStartNewMessage?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage | null,\n    options: { getRole: (e: TEvent) => Role; getRunId: (e: TEvent) => string | undefined }\n  ) => boolean;\n\n  /**\n   * Custom logic to process an event and update the current message.\n   * By default:\n   * - 'text-delta' events append their delta to the message content.\n   * - 'text' events append their content or text to the message content.\n   * - All other events are added to the message's uiEvents array.\n   */\n  processEvent?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage,\n  ) => void;\n}\n\n/**\n * Default implementation for extracting role from an event.\n */\nexport const defaultGetRole = <T extends Event>(e: T): Role => e.meta?.role || \"assistant\";\n\n/**\n * Default implementation for extracting runId from an event.\n */\nexport const defaultGetRunId = <T extends Event>(e: T): string | undefined => e.meta?.runId;\n\n/**\n * Default implementation for extracting threadId from an event.\n */\nexport const defaultGetThreadId = <T extends Event>(e: T): string | undefined => e.meta?.threadId || e.meta?.state?.threadId;\n\n/**\n * Default logic for determining if a new message should start.\n */\nexport const defaultShouldStartNewMessage = <T extends Event>(\n  event: T,\n  current: AggregatedMessage | null,\n  utils: { getRole: (e: T) => Role; getRunId: (e: T) => string | undefined; getThreadId: (e: T) => string | undefined }\n): boolean => {\n  if (!current) return true;\n  const role = utils.getRole(event);\n  const runId = utils.getRunId(event);\n  \n  // Start new message if role changes\n  if (current.role !== role) return true;\n  \n  // Start new message if runId changes (and both have runIds)\n  if (runId && current.runId && runId !== current.runId) return true;\n  \n  return false;\n};\n\n/**\n * Default logic for processing an event into a message.\n */\nexport const defaultProcessEvent = <T extends Event>(event: T, current: AggregatedMessage): void => {\n  if (event.type === \"text-delta\" && (event.data as any)?.delta) {\n    current.content += (event.data as any).delta;\n  } else if (event.type === \"text\") {\n    current.content += (event.data as any)?.content || (event.data as any)?.text || \"\";\n  } else {\n    current.uiEvents.push(event);\n  }\n};\n\n/**\n * Helper to aggregate a list of events into a list of messages.\n * This is useful for rendering a chat-like interface from a raw event stream.\n * \n * @param events The list of events to aggregate.\n * @param options Configuration for aggregation logic.\n * @returns An array of aggregated messages.\n */\nexport function convertEventsToAggregatedMessages<TEvent extends Event = Event>(\n  events: TEvent[],\n  options: AggregateOptions<TEvent> = {}\n): AggregatedMessage[] {\n  const getRole = options.getRole || defaultGetRole;\n  const getRunId = options.getRunId || defaultGetRunId;\n  const getThreadId = options.getThreadId || defaultGetThreadId;\n  const shouldStartNewMessage = options.shouldStartNewMessage || defaultShouldStartNewMessage;\n  const processEvent = options.processEvent || defaultProcessEvent;\n\n  if (events.length === 0) return [];\n\n  const messages: AggregatedMessage[] = [];\n  let currentMessage: AggregatedMessage | null = null;\n\n  for (const event of events) {\n    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {\n      currentMessage = {\n        role: getRole(event),\n        content: \"\",\n        runId: getRunId(event),\n        threadId: getThreadId(event),\n        uiEvents: [],\n      };\n      messages.push(currentMessage);\n    }\n\n    if (currentMessage) {\n      processEvent(event, currentMessage);\n      \n      // If current message didn't have a runId but this event does, update it\n      if (!currentMessage.runId) {\n        const runId = getRunId(event);\n        if (runId) {\n          currentMessage.runId = runId;\n        }\n      }\n\n      // If current message didn't have a threadId but this event does, update it\n      if (!currentMessage.threadId) {\n        const threadId = getThreadId(event);\n        if (threadId) {\n          currentMessage.threadId = threadId;\n        }\n      }\n    }\n  }\n\n  return messages;\n}\n","import React, {\n  createContext,\n  useEffect,\n  useState,\n  useMemo,\n  ReactNode,\n} from \"react\";\nimport { MelonyClient, ClientState } from \"melony/client\";\nimport {\n  Config,\n  Event,\n} from \"melony\";\nimport { \n  AggregatedMessage, \n  AggregateOptions, \n  convertEventsToAggregatedMessages \n} from \"../utils/message-converter\";\n\nexport interface MelonyContextValue extends ClientState {\n  sendEvent: (event: Event) => Promise<void>;\n  reset: (events?: Event[]) => void;\n  client: MelonyClient;\n  config?: Config;\n  messages: AggregatedMessage[];\n}\n\nexport const MelonyContext = createContext<MelonyContextValue | undefined>(\n  undefined,\n);\n\nexport interface MelonyProviderProps {\n  children: ReactNode;\n  client: MelonyClient;\n  initialEvents?: Event[];\n  aggregationOptions?: AggregateOptions;\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n  children,\n  client,\n  initialEvents,\n  aggregationOptions,\n}) => {\n  const [state, setState] = useState<ClientState>(client.getState());\n\n  // Handle initial events on mount only\n  useEffect(() => {\n    if (initialEvents?.length && client.getState().events.length === 0) {\n      client.reset(initialEvents);\n    }\n  }, []); // Empty deps - run once on mount\n\n  // Subscribe to state changes\n  useEffect(() => {\n    const unsubscribe = client.subscribe(setState);\n    return unsubscribe;\n  }, [client]);\n\n  const messages = useMemo(\n    () => convertEventsToAggregatedMessages(state.events, aggregationOptions),\n    [state.events, aggregationOptions]\n  );\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      messages,\n      sendEvent: async (event: Event) => {\n        const generator = client.sendEvent(event);\n        // Consume the generator to ensure event processing completes\n        for await (const _ of generator) {\n          // Events are handled by the client subscription\n        }\n      },\n      reset: client.reset.bind(client),\n      client,\n    }),\n    [state, messages, client],\n  );\n\n  return (\n    <MelonyContext.Provider value={contextValue}>\n      {children}\n    </MelonyContext.Provider>\n  );\n};","import { useContext } from \"react\";\nimport { MelonyContext, MelonyContextValue } from \"@/providers/melony-provider\";\n\nexport const useMelony = (): MelonyContextValue => {\n  const context = useContext(MelonyContext);\n  if (context === undefined) {\n    throw new Error(\"useMelony must be used within a MelonyProvider\");\n  }\n\n  return context;\n};\n"]}
+{"version":3,"sources":["../src/utils/message-converter.ts","../src/providers/melony-provider.tsx","../src/hooks/use-melony.ts","../src/hooks/use-melony-init.ts"],"names":["useState","useEffect"],"mappings":"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","file":"index.js","sourcesContent":["import { Event, RuntimeContext } from \"melony\";\n\n/**\n * A message aggregated from multiple events.\n */\nexport interface AggregatedMessage {\n  /** The role of the sender (user, assistant, or system) */\n  role: string;\n  /** The content of the message, containing the events */\n  content: Event[];\n  /** The unique ID for the run that produced this message */\n  runId?: string;\n  /** The ID of the thread this message belongs to */\n  threadId?: string;\n}\n\n/**\n * Options for configuring how events are aggregated into messages.\n */\nexport interface AggregateOptions<TEvent extends Event = Event> {\n  /**\n   * Custom logic to extract the role from an event.\n   * Defaults to event.meta.role or 'assistant'.\n   */\n  getRole?: (event: TEvent) => string;\n\n  /**\n   * Custom logic to extract the runId from an event.\n   * Defaults to event.meta.runId.\n   */\n  getRunId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to extract the threadId from an event.\n   * Defaults to event.meta.threadId.\n   */\n  getThreadId?: (event: TEvent) => string | undefined;\n\n  /**\n   * Custom logic to determine if a new message should be started.\n   * By default, starts a new message if:\n   * 1. There is no current message.\n   * 2. The role of the event is different from the current message.\n   * 3. The runId of the event is different from the current message's runId.\n   */\n  shouldStartNewMessage?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage | null,\n    options: { getRole: (e: TEvent) => string; getRunId: (e: TEvent) => string | undefined }\n  ) => boolean;\n\n  /**\n   * Custom logic to process an event and update the current message.\n   * By default, events are simply added to the message's content array.\n   */\n  processEvent?: (\n    event: TEvent,\n    currentMessage: AggregatedMessage,\n  ) => void;\n}\n\n/**\n * Default implementation for extracting role from an event.\n */\nexport const defaultGetRole = <T extends Event>(e: T): string => e.type === \"user:text\" ? \"user\" : \"assistant\";\n\n/**\n * Default implementation for extracting runId from an event.\n */\nexport const defaultGetRunId = <T extends Event>(e: T, context?: RuntimeContext<any, T>): string | undefined => {\n  return context?.runId;\n};\n\n/**\n * Default implementation for extracting threadId from an event.\n */\nexport const defaultGetThreadId = <T extends Event>(e: T): string | undefined => e.data?.threadId;\n\n/**\n * Default logic for determining if a new message should start.\n */\nexport const defaultShouldStartNewMessage = <T extends Event>(\n  event: T,\n  current: AggregatedMessage | null,\n  utils: { getRole: (e: T) => string; getRunId: (e: T) => string | undefined; getThreadId: (e: T) => string | undefined }\n): boolean => {\n  if (!current) return true;\n  const role = utils.getRole(event);\n  const runId = utils.getRunId(event);\n  \n  // Start new message if role changes\n  if (current.role !== role) return true;\n  \n  // Start new message if runId changes (and both have runIds)\n  if (runId && current.runId && runId !== current.runId) return true;\n  \n  return false;\n};\n\n/**\n * Default logic for processing an event into a message.\n */\nexport const defaultProcessEvent = <T extends Event>(event: T, current: AggregatedMessage): void => {\n  current.content.push(event);\n};\n\n/**\n * Helper to aggregate a list of events into a list of messages.\n * This is useful for rendering a chat-like interface from a raw event stream.\n * \n * @param events The list of events to aggregate.\n * @param options Configuration for aggregation logic.\n * @returns An array of aggregated messages.\n */\nexport function convertEventsToAggregatedMessages<TEvent extends Event = Event>(\n  events: TEvent[],\n  options: AggregateOptions<TEvent> = {}\n): AggregatedMessage[] {\n  const getRole = options.getRole || defaultGetRole;\n  const getRunId = options.getRunId || defaultGetRunId;\n  const getThreadId = options.getThreadId || defaultGetThreadId;\n  const shouldStartNewMessage = options.shouldStartNewMessage || defaultShouldStartNewMessage;\n  const processEvent = options.processEvent || defaultProcessEvent;\n\n  if (events.length === 0) return [];\n\n  const messages: AggregatedMessage[] = [];\n  let currentMessage: AggregatedMessage | null = null;\n\n  for (const event of events) {\n    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {\n      currentMessage = {\n        role: getRole(event),\n        content: [],\n        runId: getRunId(event),\n        threadId: getThreadId(event),\n      };\n      messages.push(currentMessage);\n    }\n\n    if (currentMessage) {\n      processEvent(event, currentMessage);\n      \n      // If current message didn't have a runId but this event does, update it\n      if (!currentMessage.runId) {\n        const runId = getRunId(event);\n        if (runId) {\n          currentMessage.runId = runId;\n        }\n      }\n\n      // If current message didn't have a threadId but this event does, update it\n      if (!currentMessage.threadId) {\n        const threadId = getThreadId(event);\n        if (threadId) {\n          currentMessage.threadId = threadId;\n        }\n      }\n    }\n  }\n\n  return messages;\n}\n","import React, {\n  createContext,\n  useEffect,\n  useState,\n  useMemo,\n  ReactNode,\n} from \"react\";\nimport { MelonyClient, ClientState } from \"melony/client\";\nimport {\n  Config,\n  Event,\n} from \"melony\";\nimport { \n  AggregatedMessage, \n  AggregateOptions, \n  convertEventsToAggregatedMessages \n} from \"../utils/message-converter\";\n\nexport interface MelonyContextValue extends ClientState {\n  send: (event: Event) => Promise<void>;\n  reset: (events?: Event[]) => void;\n  client: MelonyClient;\n  config?: Config;\n  messages: AggregatedMessage[];\n}\n\nexport const MelonyContext = createContext<MelonyContextValue | undefined>(\n  undefined,\n);\n\nexport interface MelonyProviderProps {\n  children: ReactNode;\n  client: MelonyClient;\n  initialEvents?: Event[];\n  aggregationOptions?: AggregateOptions;\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n  children,\n  client,\n  initialEvents,\n  aggregationOptions,\n}) => {\n  const [state, setState] = useState<ClientState>(client.getState());\n\n  // Handle initial events on mount only\n  useEffect(() => {\n    if (initialEvents?.length && client.getState().events.length === 0) {\n      client.reset(initialEvents);\n    }\n  }, []); // Empty deps - run once on mount\n\n  // Subscribe to state changes\n  useEffect(() => {\n    const unsubscribe = client.subscribe(setState);\n    return unsubscribe;\n  }, [client]);\n\n  const messages = useMemo(\n    () => convertEventsToAggregatedMessages(state.events, aggregationOptions),\n    [state.events, aggregationOptions]\n  );\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      messages,\n      send: async (event: Event) => {\n        const generator = client.send(event);\n        // Consume the generator to ensure event processing completes\n        for await (const _ of generator) {\n          // Events are handled by the client subscription\n        }\n      },\n      reset: client.reset.bind(client),\n      client,\n    }),\n    [state, messages, client],\n  );\n\n  return (\n    <MelonyContext.Provider value={contextValue}>\n      {children}\n    </MelonyContext.Provider>\n  );\n};","import { useContext } from \"react\";\nimport { MelonyContext, MelonyContextValue } from \"../providers/melony-provider\";\n\nexport const useMelony = (): MelonyContextValue => {\n  const context = useContext(MelonyContext);\n  if (context === undefined) {\n    throw new Error(\"useMelony must be used within a MelonyProvider\");\n  }\n\n  return context;\n};\n","import { useEffect, useState } from \"react\";\n\n/**\n * A hook to initialize a Melony application by fetching the initial UI state.\n * \n * @param url The API endpoint to fetch the initial state from.\n * @param params Optional query parameters to include in the request.\n * @returns An object containing the UI data, loading state, and any error encountered.\n */\nexport function useMelonyInit<T = any>(\n  url: string, \n  params: Record<string, string | number | boolean | undefined> = {}\n) {\n  const [data, setData] = useState<T | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    let isMounted = true;\n\n    async function init() {\n      try {\n        setLoading(true);\n        setError(null);\n\n        const searchParams = new URLSearchParams();\n        Object.entries(params).forEach(([key, value]) => {\n          if (value !== undefined) {\n            searchParams.append(key, String(value));\n          }\n        });\n        \n        const queryString = searchParams.toString();\n        const fullUrl = queryString ? `${url}${url.includes('?') ? '&' : '?'}${queryString}` : url;\n        \n        const response = await fetch(fullUrl);\n        if (!response.ok) {\n          throw new Error(`Failed to initialize: ${response.statusText}`);\n        }\n        const json = await response.json();\n        \n        if (isMounted) {\n          setData(json);\n        }\n      } catch (err) {\n        if (isMounted) {\n          setError(err instanceof Error ? err : new Error(String(err)));\n        }\n      } finally {\n        if (isMounted) {\n          setLoading(false);\n        }\n      }\n    }\n\n    init();\n\n    return () => {\n      isMounted = false;\n    };\n  }, [url, JSON.stringify(params)]);\n\n  return { data, loading, error };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melony/react",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "main": "dist/index.js",
   "type": "module",
   "sideEffects": false,
@@ -33,7 +33,7 @@
     "react": ">=18"
   },
   "dependencies": {
-    "melony": "^0.2.2"
+    "melony": "^0.2.4"
   },
   "devDependencies": {
     "@types/react": "^19.1.12",