@melony/react 0.2.4 → 0.2.5

package/dist/index.cjs

@@ -66,7 +66,9 @@ var MelonyProvider = ({
   children,
   client,
   initialEvents,
-  aggregationOptions
+  initialAdditionalBody,
+  aggregationOptions,
+  eventHandlers
 }) => {
   const [state, setState] = react.useState(client.getState());
   react.useEffect(() => {
@@ -86,12 +88,18 @@ var MelonyProvider = ({
     () => ({
       ...state,
       messages,
-      send: async (event) => {
-        const generator = client.send(event);
+      send: async (event, additionalBody) => {
+        const handler = eventHandlers?.[event.type];
+        if (handler) {
+          await handler(event, { client });
+          return;
+        }
+        const generator = client.send(event, { ...initialAdditionalBody, ...additionalBody });
         for await (const _ of generator) {
         }
       },
       reset: client.reset.bind(client),
+      stop: client.stop.bind(client),
       client
     }),
     [state, messages, client]

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","../src/hooks/use-melony-init.ts"],"names":["createContext","useState","useEffect","useMemo","useContext"],"mappings":"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","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"]}
+{"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":"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","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, additionalBody?: Record<string, any>) => Promise<void>;\n  reset: (events?: Event[]) => void;\n  stop: () => void;\n  client: MelonyClient;\n  config?: Config;\n  messages: AggregatedMessage[];\n}\n\nexport const MelonyContext = createContext<MelonyContextValue | undefined>(\n  undefined,\n);\n\nexport type ClientHandler<TEvent extends Event = Event> = (\n  event: TEvent,\n  context: { client: MelonyClient<TEvent> }\n) => void | Promise<void>;\n\nexport interface MelonyProviderProps {\n  children: ReactNode;\n  client: MelonyClient;\n  initialEvents?: Event[];\n  initialAdditionalBody?: Record<string, any>;\n  aggregationOptions?: AggregateOptions;\n  eventHandlers?: Record<string, ClientHandler>;\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n  children,\n  client,\n  initialEvents,\n  initialAdditionalBody,\n  aggregationOptions,\n  eventHandlers,\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, additionalBody?: Record<string, any>) => {\n        const handler = eventHandlers?.[event.type];\n        if (handler) {\n          await handler(event, { client });\n          return;\n        }\n\n        const generator = client.send(event, { ...initialAdditionalBody, ...additionalBody });\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      stop: client.stop.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

@@ -86,18 +86,24 @@ 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 {
-    send: (event: Event) => Promise<void>;
+    send: (event: Event, additionalBody?: Record<string, any>) => Promise<void>;
     reset: (events?: Event[]) => void;
+    stop: () => void;
     client: MelonyClient;
     config?: Config;
     messages: AggregatedMessage[];
 }
 declare const MelonyContext: React.Context<MelonyContextValue | undefined>;
+type ClientHandler<TEvent extends Event = Event> = (event: TEvent, context: {
+    client: MelonyClient<TEvent>;
+}) => void | Promise<void>;
 interface MelonyProviderProps {
     children: ReactNode;
     client: MelonyClient;
     initialEvents?: Event[];
+    initialAdditionalBody?: Record<string, any>;
     aggregationOptions?: AggregateOptions;
+    eventHandlers?: Record<string, ClientHandler>;
 }
 declare const MelonyProvider: React.FC<MelonyProviderProps>;
 
@@ -116,4 +122,4 @@ declare function useMelonyInit<T = any>(url: string, params?: Record<string, str
     error: Error | null;
 };
 
-export { type AggregateOptions, type AggregatedMessage, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };
+export { type AggregateOptions, type AggregatedMessage, type ClientHandler, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };

package/dist/index.d.ts

@@ -86,18 +86,24 @@ 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 {
-    send: (event: Event) => Promise<void>;
+    send: (event: Event, additionalBody?: Record<string, any>) => Promise<void>;
     reset: (events?: Event[]) => void;
+    stop: () => void;
     client: MelonyClient;
     config?: Config;
     messages: AggregatedMessage[];
 }
 declare const MelonyContext: React.Context<MelonyContextValue | undefined>;
+type ClientHandler<TEvent extends Event = Event> = (event: TEvent, context: {
+    client: MelonyClient<TEvent>;
+}) => void | Promise<void>;
 interface MelonyProviderProps {
     children: ReactNode;
     client: MelonyClient;
     initialEvents?: Event[];
+    initialAdditionalBody?: Record<string, any>;
     aggregationOptions?: AggregateOptions;
+    eventHandlers?: Record<string, ClientHandler>;
 }
 declare const MelonyProvider: React.FC<MelonyProviderProps>;
 
@@ -116,4 +122,4 @@ declare function useMelonyInit<T = any>(url: string, params?: Record<string, str
     error: Error | null;
 };
 
-export { type AggregateOptions, type AggregatedMessage, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };
+export { type AggregateOptions, type AggregatedMessage, type ClientHandler, MelonyContext, type MelonyContextValue, MelonyProvider, type MelonyProviderProps, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetThreadId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony, useMelonyInit };

package/dist/index.js

@@ -64,7 +64,9 @@ var MelonyProvider = ({
   children,
   client,
   initialEvents,
-  aggregationOptions
+  initialAdditionalBody,
+  aggregationOptions,
+  eventHandlers
 }) => {
   const [state, setState] = useState(client.getState());
   useEffect(() => {
@@ -84,12 +86,18 @@ var MelonyProvider = ({
     () => ({
       ...state,
       messages,
-      send: async (event) => {
-        const generator = client.send(event);
+      send: async (event, additionalBody) => {
+        const handler = eventHandlers?.[event.type];
+        if (handler) {
+          await handler(event, { client });
+          return;
+        }
+        const generator = client.send(event, { ...initialAdditionalBody, ...additionalBody });
         for await (const _ of generator) {
         }
       },
       reset: client.reset.bind(client),
+      stop: client.stop.bind(client),
       client
     }),
     [state, messages, client]

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","../src/hooks/use-melony-init.ts"],"names":["useState","useEffect"],"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,GAAgB,aAAA;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,IAAI,QAAA,CAAsB,MAAA,CAAO,UAAU,CAAA;AAGjE,EAAA,SAAA,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,EAAA,SAAA,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,GAAW,OAAA;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,GAAe,OAAA;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,2BACG,aAAA,CAAc,QAAA,EAAd,EAAuB,KAAA,EAAO,cAC5B,QAAA,EACH,CAAA;AAEJ;AClFO,IAAM,YAAY,MAA0B;AACjD,EAAA,MAAM,OAAA,GAAU,WAAW,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,GAAIA,SAAmB,IAAI,CAAA;AAC/C,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,SAAS,IAAI,CAAA;AAC3C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,SAAuB,IAAI,CAAA;AAErD,EAAAC,UAAU,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.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"]}
+{"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, additionalBody?: Record<string, any>) => Promise<void>;\n  reset: (events?: Event[]) => void;\n  stop: () => void;\n  client: MelonyClient;\n  config?: Config;\n  messages: AggregatedMessage[];\n}\n\nexport const MelonyContext = createContext<MelonyContextValue | undefined>(\n  undefined,\n);\n\nexport type ClientHandler<TEvent extends Event = Event> = (\n  event: TEvent,\n  context: { client: MelonyClient<TEvent> }\n) => void | Promise<void>;\n\nexport interface MelonyProviderProps {\n  children: ReactNode;\n  client: MelonyClient;\n  initialEvents?: Event[];\n  initialAdditionalBody?: Record<string, any>;\n  aggregationOptions?: AggregateOptions;\n  eventHandlers?: Record<string, ClientHandler>;\n}\n\nexport const MelonyProvider: React.FC<MelonyProviderProps> = ({\n  children,\n  client,\n  initialEvents,\n  initialAdditionalBody,\n  aggregationOptions,\n  eventHandlers,\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, additionalBody?: Record<string, any>) => {\n        const handler = eventHandlers?.[event.type];\n        if (handler) {\n          await handler(event, { client });\n          return;\n        }\n\n        const generator = client.send(event, { ...initialAdditionalBody, ...additionalBody });\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      stop: client.stop.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.4",
+  "version": "0.2.5",
   "main": "dist/index.js",
   "type": "module",
   "sideEffects": false,
@@ -33,7 +33,7 @@
     "react": ">=18"
   },
   "dependencies": {
-    "melony": "^0.2.4"
+    "melony": "^0.2.6"
   },
   "devDependencies": {
     "@types/react": "^19.1.12",