@melony/react 0.2.6 → 0.3.0

package/dist/index.cjs

@@ -10,7 +10,9 @@ var defaultGetRole = (e) => e.type === "user:text" ? "user" : "assistant";
 var defaultGetRunId = (e, context) => {
   return context?.runId;
 };
-var defaultGetThreadId = (e) => e.data?.threadId;
+var defaultGetSessionId = (e) => {
+  return e.data?.sessionId || e.data?.threadId;
+};
 var defaultShouldStartNewMessage = (event, current, utils) => {
   if (!current) return true;
   const role = utils.getRole(event);
@@ -25,19 +27,19 @@ var defaultProcessEvent = (event, current) => {
 function convertEventsToAggregatedMessages(events, options = {}) {
   const getRole = options.getRole || defaultGetRole;
   const getRunId = options.getRunId || defaultGetRunId;
-  const getThreadId = options.getThreadId || defaultGetThreadId;
+  const getSessionId = options.getSessionId || defaultGetSessionId;
   const shouldStartNewMessage = options.shouldStartNewMessage || defaultShouldStartNewMessage;
   const processEvent = options.processEvent || defaultProcessEvent;
   if (events.length === 0) return [];
   const messages = [];
   let currentMessage = null;
   for (const event of events) {
-    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {
+    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getSessionId })) {
       currentMessage = {
         role: getRole(event),
         content: [],
         runId: getRunId(event),
-        threadId: getThreadId(event)
+        sessionId: getSessionId(event)
       };
       messages.push(currentMessage);
     }
@@ -49,10 +51,10 @@ function convertEventsToAggregatedMessages(events, options = {}) {
           currentMessage.runId = runId;
         }
       }
-      if (!currentMessage.threadId) {
-        const threadId = getThreadId(event);
-        if (threadId) {
-          currentMessage.threadId = threadId;
+      if (!currentMessage.sessionId) {
+        const sessionId = getSessionId(event);
+        if (sessionId) {
+          currentMessage.sessionId = sessionId;
         }
       }
     }
@@ -120,60 +122,15 @@ 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);
-  const { client } = useMelony();
-  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 data2 = await response.json();
-        if (isMounted) {
-          setData(data2);
-        }
-      } 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;
 exports.convertEventsToAggregatedMessages = convertEventsToAggregatedMessages;
 exports.defaultGetRole = defaultGetRole;
 exports.defaultGetRunId = defaultGetRunId;
-exports.defaultGetThreadId = defaultGetThreadId;
+exports.defaultGetSessionId = defaultGetSessionId;
 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","../src/hooks/use-melony-init.ts"],"names":["createContext","useState","useEffect","useMemo","useCallback","useContext","data"],"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  useCallback,\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 send = useCallback(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  }, [client, eventHandlers, initialAdditionalBody]);\n\n  const reset = useCallback((events: Event[] = []) => {\n    client.reset(events);\n  }, [client]);\n\n  const stop = useCallback(() => {\n    client.stop();\n  }, [client]);\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      messages,\n      send,\n      reset,\n      stop,\n      client,\n    }),\n    [state, messages, send, reset, stop, 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\";\nimport { useMelony } from \"./use-melony\";\n\n/**\n * Fetches the initial UI state from a jsonResponse endpoint.\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  const { client } = useMelony();\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\n        const data = await response.json();\n\n        if (isMounted) {\n          setData(data);\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"],"names":["createContext","useState","useEffect","useMemo","useCallback","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 session this message belongs to */\n  sessionId?: 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 sessionId from an event.\n   * Defaults to event.data.sessionId, with threadId fallback.\n   */\n  getSessionId?: (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 sessionId from an event.\n */\nexport const defaultGetSessionId = <T extends Event>(e: T): string | undefined => {\n  return e.data?.sessionId || e.data?.threadId;\n};\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; getSessionId: (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 getSessionId = options.getSessionId || defaultGetSessionId;\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, getSessionId })) {\n      currentMessage = {\n        role: getRole(event),\n        content: [],\n        runId: getRunId(event),\n        sessionId: getSessionId(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 sessionId but this event does, update it\n      if (!currentMessage.sessionId) {\n        const sessionId = getSessionId(event);\n        if (sessionId) {\n          currentMessage.sessionId = sessionId;\n        }\n      }\n    }\n  }\n\n  return messages;\n}\n","import React, {\n  createContext,\n  useEffect,\n  useState,\n  useMemo,\n  useCallback,\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 send = useCallback(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  }, [client, eventHandlers, initialAdditionalBody]);\n\n  const reset = useCallback((events: Event[] = []) => {\n    client.reset(events);\n  }, [client]);\n\n  const stop = useCallback(() => {\n    client.stop();\n  }, [client]);\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      messages,\n      send,\n      reset,\n      stop,\n      client,\n    }),\n    [state, messages, send, reset, stop, 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"]}

package/dist/index.d.cts

@@ -12,8 +12,8 @@ interface AggregatedMessage {
     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;
+    /** The ID of the session this message belongs to */
+    sessionId?: string;
 }
 /**
  * Options for configuring how events are aggregated into messages.
@@ -30,10 +30,10 @@ interface AggregateOptions<TEvent extends Event = Event> {
      */
     getRunId?: (event: TEvent) => string | undefined;
     /**
-     * Custom logic to extract the threadId from an event.
-     * Defaults to event.meta.threadId.
+     * Custom logic to extract the sessionId from an event.
+     * Defaults to event.data.sessionId, with threadId fallback.
      */
-    getThreadId?: (event: TEvent) => string | undefined;
+    getSessionId?: (event: TEvent) => string | undefined;
     /**
      * Custom logic to determine if a new message should be started.
      * By default, starts a new message if:
@@ -60,16 +60,16 @@ declare const defaultGetRole: <T extends Event>(e: T) => string;
  */
 declare const defaultGetRunId: <T extends Event>(e: T, context?: RuntimeContext<any, T>) => string | undefined;
 /**
- * Default implementation for extracting threadId from an event.
+ * Default implementation for extracting sessionId from an event.
  */
-declare const defaultGetThreadId: <T extends Event>(e: T) => string | undefined;
+declare const defaultGetSessionId: <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) => string;
     getRunId: (e: T) => string | undefined;
-    getThreadId: (e: T) => string | undefined;
+    getSessionId: (e: T) => string | undefined;
 }) => boolean;
 /**
  * Default logic for processing an event into a message.
@@ -109,13 +109,4 @@ declare const MelonyProvider: React.FC<MelonyProviderProps>;
 
 declare const useMelony: () => MelonyContextValue;
 
-/**
- * Fetches the initial UI state from a jsonResponse endpoint.
- */
-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, type ClientHandler, 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, defaultGetSessionId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony };

package/dist/index.d.ts

@@ -12,8 +12,8 @@ interface AggregatedMessage {
     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;
+    /** The ID of the session this message belongs to */
+    sessionId?: string;
 }
 /**
  * Options for configuring how events are aggregated into messages.
@@ -30,10 +30,10 @@ interface AggregateOptions<TEvent extends Event = Event> {
      */
     getRunId?: (event: TEvent) => string | undefined;
     /**
-     * Custom logic to extract the threadId from an event.
-     * Defaults to event.meta.threadId.
+     * Custom logic to extract the sessionId from an event.
+     * Defaults to event.data.sessionId, with threadId fallback.
      */
-    getThreadId?: (event: TEvent) => string | undefined;
+    getSessionId?: (event: TEvent) => string | undefined;
     /**
      * Custom logic to determine if a new message should be started.
      * By default, starts a new message if:
@@ -60,16 +60,16 @@ declare const defaultGetRole: <T extends Event>(e: T) => string;
  */
 declare const defaultGetRunId: <T extends Event>(e: T, context?: RuntimeContext<any, T>) => string | undefined;
 /**
- * Default implementation for extracting threadId from an event.
+ * Default implementation for extracting sessionId from an event.
  */
-declare const defaultGetThreadId: <T extends Event>(e: T) => string | undefined;
+declare const defaultGetSessionId: <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) => string;
     getRunId: (e: T) => string | undefined;
-    getThreadId: (e: T) => string | undefined;
+    getSessionId: (e: T) => string | undefined;
 }) => boolean;
 /**
  * Default logic for processing an event into a message.
@@ -109,13 +109,4 @@ declare const MelonyProvider: React.FC<MelonyProviderProps>;
 
 declare const useMelony: () => MelonyContextValue;
 
-/**
- * Fetches the initial UI state from a jsonResponse endpoint.
- */
-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, type ClientHandler, 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, defaultGetSessionId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony };

package/dist/index.js

@@ -8,7 +8,9 @@ var defaultGetRole = (e) => e.type === "user:text" ? "user" : "assistant";
 var defaultGetRunId = (e, context) => {
   return context?.runId;
 };
-var defaultGetThreadId = (e) => e.data?.threadId;
+var defaultGetSessionId = (e) => {
+  return e.data?.sessionId || e.data?.threadId;
+};
 var defaultShouldStartNewMessage = (event, current, utils) => {
   if (!current) return true;
   const role = utils.getRole(event);
@@ -23,19 +25,19 @@ var defaultProcessEvent = (event, current) => {
 function convertEventsToAggregatedMessages(events, options = {}) {
   const getRole = options.getRole || defaultGetRole;
   const getRunId = options.getRunId || defaultGetRunId;
-  const getThreadId = options.getThreadId || defaultGetThreadId;
+  const getSessionId = options.getSessionId || defaultGetSessionId;
   const shouldStartNewMessage = options.shouldStartNewMessage || defaultShouldStartNewMessage;
   const processEvent = options.processEvent || defaultProcessEvent;
   if (events.length === 0) return [];
   const messages = [];
   let currentMessage = null;
   for (const event of events) {
-    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getThreadId })) {
+    if (shouldStartNewMessage(event, currentMessage, { getRole, getRunId, getSessionId })) {
       currentMessage = {
         role: getRole(event),
         content: [],
         runId: getRunId(event),
-        threadId: getThreadId(event)
+        sessionId: getSessionId(event)
       };
       messages.push(currentMessage);
     }
@@ -47,10 +49,10 @@ function convertEventsToAggregatedMessages(events, options = {}) {
           currentMessage.runId = runId;
         }
       }
-      if (!currentMessage.threadId) {
-        const threadId = getThreadId(event);
-        if (threadId) {
-          currentMessage.threadId = threadId;
+      if (!currentMessage.sessionId) {
+        const sessionId = getSessionId(event);
+        if (sessionId) {
+          currentMessage.sessionId = sessionId;
         }
       }
     }
@@ -118,51 +120,7 @@ var useMelony = () => {
   }
   return context;
 };
-function useMelonyInit(url, params = {}) {
-  const [data, setData] = useState(null);
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState(null);
-  const { client } = useMelony();
-  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 data2 = await response.json();
-        if (isMounted) {
-          setData(data2);
-        }
-      } 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, useMelonyInit };
+export { MelonyContext, MelonyProvider, convertEventsToAggregatedMessages, defaultGetRole, defaultGetRunId, defaultGetSessionId, defaultProcessEvent, defaultShouldStartNewMessage, useMelony };
 //# 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","../src/hooks/use-melony-init.ts"],"names":["useState","useEffect","data"],"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;ACtIO,IAAM,aAAA,GAAgB,aAAA;AAAA,EAC3B;AACF;AAgBO,IAAM,iBAAgD,CAAC;AAAA,EAC5D,QAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA;AAAA,EACA,qBAAA;AAAA,EACA,kBAAA;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,IAAA,GAAO,WAAA,CAAY,OAAO,KAAA,EAAc,cAAA,KAAyC;AACrF,IAAA,MAAM,OAAA,GAAU,aAAA,GAAgB,KAAA,CAAM,IAAI,CAAA;AAC1C,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,MAAM,OAAA,CAAQ,KAAA,EAAO,EAAE,MAAA,EAAQ,CAAA;AAC/B,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,GAAY,OAAO,IAAA,CAAK,KAAA,EAAO,EAAE,GAAG,qBAAA,EAAuB,GAAG,cAAA,EAAgB,CAAA;AAEpF,IAAA,WAAA,MAAiB,KAAK,SAAA,EAAW;AAAA,IAEjC;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,aAAA,EAAe,qBAAqB,CAAC,CAAA;AAEjD,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,CAAC,MAAA,GAAkB,EAAC,KAAM;AAClD,IAAA,MAAA,CAAO,MAAM,MAAM,CAAA;AAAA,EACrB,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,IAAA,GAAO,YAAY,MAAM;AAC7B,IAAA,MAAA,CAAO,IAAA,EAAK;AAAA,EACd,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,YAAA,GAAe,OAAA;AAAA,IACnB,OAAO;AAAA,MACL,GAAG,KAAA;AAAA,MACH,QAAA;AAAA,MACA,IAAA;AAAA,MACA,KAAA;AAAA,MACA,IAAA;AAAA,MACA;AAAA,KACF,CAAA;AAAA,IACA,CAAC,KAAA,EAAO,QAAA,EAAU,IAAA,EAAM,KAAA,EAAO,MAAM,MAAM;AAAA,GAC7C;AAEA,EAAA,2BACG,aAAA,CAAc,QAAA,EAAd,EAAuB,KAAA,EAAO,cAC5B,QAAA,EACH,CAAA;AAEJ;AC9GO,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;ACJO,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;AACrD,EAAA,MAAM,EAAE,MAAA,EAAO,GAAI,SAAA,EAAU;AAE7B,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;AAEA,QAAA,MAAMC,KAAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAEjC,QAAA,IAAI,SAAA,EAAW;AACb,UAAA,OAAA,CAAQA,KAAI,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  useCallback,\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 send = useCallback(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  }, [client, eventHandlers, initialAdditionalBody]);\n\n  const reset = useCallback((events: Event[] = []) => {\n    client.reset(events);\n  }, [client]);\n\n  const stop = useCallback(() => {\n    client.stop();\n  }, [client]);\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      messages,\n      send,\n      reset,\n      stop,\n      client,\n    }),\n    [state, messages, send, reset, stop, 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\";\nimport { useMelony } from \"./use-melony\";\n\n/**\n * Fetches the initial UI state from a jsonResponse endpoint.\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  const { client } = useMelony();\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\n        const data = await response.json();\n\n        if (isMounted) {\n          setData(data);\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"],"names":[],"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 session this message belongs to */\n  sessionId?: 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 sessionId from an event.\n   * Defaults to event.data.sessionId, with threadId fallback.\n   */\n  getSessionId?: (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 sessionId from an event.\n */\nexport const defaultGetSessionId = <T extends Event>(e: T): string | undefined => {\n  return e.data?.sessionId || e.data?.threadId;\n};\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; getSessionId: (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 getSessionId = options.getSessionId || defaultGetSessionId;\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, getSessionId })) {\n      currentMessage = {\n        role: getRole(event),\n        content: [],\n        runId: getRunId(event),\n        sessionId: getSessionId(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 sessionId but this event does, update it\n      if (!currentMessage.sessionId) {\n        const sessionId = getSessionId(event);\n        if (sessionId) {\n          currentMessage.sessionId = sessionId;\n        }\n      }\n    }\n  }\n\n  return messages;\n}\n","import React, {\n  createContext,\n  useEffect,\n  useState,\n  useMemo,\n  useCallback,\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 send = useCallback(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  }, [client, eventHandlers, initialAdditionalBody]);\n\n  const reset = useCallback((events: Event[] = []) => {\n    client.reset(events);\n  }, [client]);\n\n  const stop = useCallback(() => {\n    client.stop();\n  }, [client]);\n\n  const contextValue = useMemo(\n    () => ({\n      ...state,\n      messages,\n      send,\n      reset,\n      stop,\n      client,\n    }),\n    [state, messages, send, reset, stop, 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"]}

package/package.json

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