melony 0.3.1 → 0.3.3

package/dist/{chunk-7YBEEXMK.js → chunk-EY5SDCRC.js}

@@ -52,7 +52,7 @@ var MelonyClient = class {
     });
     try {
       const headers = await this.getRequestHeaders();
-      const response = await fetch(this.url, {
+      const runResponse = await fetch(`${this.url}/runs`, {
         method: "POST",
         headers,
         body: JSON.stringify({
@@ -61,6 +61,42 @@ var MelonyClient = class {
         }),
         signal: this.abortController.signal
       });
+      if (!runResponse.ok)
+        throw new Error(`HTTP error! status: ${runResponse.status}`);
+      const { runId, threadId } = await runResponse.json();
+      yield* this.stream({ runId, threadId });
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        this.setState({ streaming: false });
+        return;
+      }
+      const error = err instanceof Error ? err : new Error(String(err));
+      this.setState({ error, streaming: false });
+      throw error;
+    }
+  }
+  /**
+   * Stream events from a specific run or thread.
+   */
+  async *stream(filter) {
+    if (this.abortController) this.abortController.abort();
+    this.abortController = new AbortController();
+    this.setState({
+      streaming: true,
+      error: null
+    });
+    try {
+      const headers = await this.getRequestHeaders();
+      const streamUrl = new URL(`${this.url}/stream`);
+      if (filter.runId) streamUrl.searchParams.set("runId", filter.runId);
+      if (filter.threadId) streamUrl.searchParams.set("threadId", filter.threadId);
+      const response = await fetch(streamUrl.toString(), {
+        headers: {
+          ...headers,
+          "Accept": "text/event-stream"
+        },
+        signal: this.abortController.signal
+      });
       if (!response.ok)
         throw new Error(`HTTP error! status: ${response.status}`);
       if (!response.body) throw new Error("No response body");
@@ -80,6 +116,13 @@ var MelonyClient = class {
             const handled = this.handleIncomingEvent(incomingEvent);
             if (!handled) continue;
             yield incomingEvent;
+            if (incomingEvent.type === "run:status:updated") {
+              const data = incomingEvent.data;
+              if (data?.status === "completed" || data?.status === "failed") {
+                this.setState({ streaming: false });
+                return;
+              }
+            }
           } catch (e) {
             console.error("Failed to parse event", e);
           }
@@ -96,6 +139,50 @@ var MelonyClient = class {
       throw error;
     }
   }
+  /**
+   * List all unique threads.
+   */
+  async listThreads() {
+    const headers = await this.getRequestHeaders();
+    const response = await fetch(`${this.url}/threads`, { headers });
+    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
+    const data = await response.json();
+    return data.threads;
+  }
+  /**
+   * List all runs, optionally filtered by thread ID.
+   */
+  async listRuns(filter) {
+    const headers = await this.getRequestHeaders();
+    const runsUrl = new URL(`${this.url}/runs`);
+    if (filter?.threadId) runsUrl.searchParams.set("threadId", filter.threadId);
+    const response = await fetch(runsUrl.toString(), { headers });
+    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
+    const data = await response.json();
+    return data.runs;
+  }
+  /**
+   * Get historical events for a run or thread.
+   */
+  async listEvents(filter) {
+    const headers = await this.getRequestHeaders();
+    const eventsUrl = new URL(`${this.url}/events`);
+    if (filter.runId) eventsUrl.searchParams.set("runId", filter.runId);
+    if (filter.threadId) eventsUrl.searchParams.set("threadId", filter.threadId);
+    const response = await fetch(eventsUrl.toString(), { headers });
+    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
+    const data = await response.json();
+    return data.events;
+  }
+  /**
+   * Check server health.
+   */
+  async getHealth() {
+    const headers = await this.getRequestHeaders();
+    const response = await fetch(`${this.url}/health`, { headers });
+    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
+    return await response.json();
+  }
   handleIncomingEvent(event) {
     const events = [...this.state.events];
     const index = event.id ? events.findIndex((e) => e.id === event.id) : -1;
@@ -125,5 +212,5 @@ var MelonyClient = class {
 };
 
 export { MelonyClient };
-//# sourceMappingURL=chunk-7YBEEXMK.js.map
-//# sourceMappingURL=chunk-7YBEEXMK.js.map
+//# sourceMappingURL=chunk-EY5SDCRC.js.map
+//# sourceMappingURL=chunk-EY5SDCRC.js.map

package/dist/chunk-EY5SDCRC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"chunk-EY5SDCRC.js","sourcesContent":["import { Event } from \"./types\";\nimport { generateId } from \"./utils/generate-id\";\n\nexport type { Event };\nexport { generateId };\n\nexport interface ClientState<TEvent extends Event = Event> {\n  events: TEvent[];\n  streaming: boolean;\n  error: Error | null;\n  context: Record<string, any>;\n}\n\nexport interface MelonyClientOptions<TEvent extends Event = Event> {\n  url: string;\n  initialEvents?: TEvent[];\n  initialContext?: Record<string, any>;\n  headers?:\n  | Record<string, string>\n  | (() => Record<string, string> | Promise<Record<string, string>>);\n}\n\nexport class MelonyClient<TEvent extends Event = Event> {\n  private state: ClientState<TEvent>;\n  public readonly url: string;\n  private headers?: MelonyClientOptions<TEvent>[\"headers\"];\n  private lastServerState: any = null;\n  private abortController: AbortController | null = null;\n  private stateListeners: Set<(state: ClientState<TEvent>) => void> = new Set();\n\n  constructor(options: MelonyClientOptions<TEvent>) {\n    this.url = options.url;\n    this.headers = options.headers;\n    this.state = {\n      events: options.initialEvents ?? [],\n      streaming: false,\n      error: null,\n      context: options.initialContext ?? {},\n    };\n  }\n\n  subscribe(listener: (state: ClientState<TEvent>) => void) {\n    this.stateListeners.add(listener);\n    return () => {\n      this.stateListeners.delete(listener);\n    };\n  }\n\n  getState() {\n    return { ...this.state };\n  }\n\n  private async getRequestHeaders() {\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n    };\n\n    if (this.headers) {\n      const extraHeaders =\n        typeof this.headers === \"function\"\n          ? await this.headers()\n          : this.headers;\n      Object.assign(headers, extraHeaders);\n    }\n    return headers;\n  }\n\n  private setState(updates: Partial<ClientState<TEvent>>) {\n    this.state = { ...this.state, ...updates };\n    this.stateListeners.forEach((l) => l(this.getState()));\n  }\n\n  async *send(\n    event: TEvent,\n    additionalBody?: Record<string, any>\n  ): AsyncGenerator<TEvent> {\n    if (this.abortController) this.abortController.abort();\n    this.abortController = new AbortController();\n\n    const optimisticEvent: TEvent = {\n      id: generateId(),\n      ...event\n    } as TEvent;\n\n    this.setState({\n      streaming: true,\n      error: null,\n      events: [...this.state.events, optimisticEvent],\n    });\n\n    try {\n      const headers = await this.getRequestHeaders();\n      \n      // 1. Create a Run\n      const runResponse = await fetch(`${this.url}/runs`, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify({\n          event: optimisticEvent,\n          ...additionalBody,\n        }),\n        signal: this.abortController.signal,\n      });\n\n      if (!runResponse.ok)\n        throw new Error(`HTTP error! status: ${runResponse.status}`);\n      \n      const { runId, threadId } = await runResponse.json();\n      yield* this.stream({ runId, threadId });\n    } catch (err) {\n      if (err instanceof Error && err.name === \"AbortError\") {\n        this.setState({ streaming: false });\n        return;\n      }\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.setState({ error, streaming: false });\n      throw error;\n    }\n  }\n\n  /**\n   * Stream events from a specific run or thread.\n   */\n  async *stream(filter: { runId?: string; threadId?: string }): AsyncGenerator<TEvent> {\n    if (this.abortController) this.abortController.abort();\n    this.abortController = new AbortController();\n\n    this.setState({\n      streaming: true,\n      error: null,\n    });\n\n    try {\n      const headers = await this.getRequestHeaders();\n      const streamUrl = new URL(`${this.url}/stream`);\n      if (filter.runId) streamUrl.searchParams.set(\"runId\", filter.runId);\n      if (filter.threadId) streamUrl.searchParams.set(\"threadId\", filter.threadId);\n\n      const response = await fetch(streamUrl.toString(), {\n        headers: {\n          ...headers,\n          \"Accept\": \"text/event-stream\",\n        },\n        signal: this.abortController.signal,\n      });\n\n      if (!response.ok)\n        throw new Error(`HTTP error! status: ${response.status}`);\n      if (!response.body) throw new Error(\"No response body\");\n\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder();\n      let buffer = \"\";\n\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split(\"\\n\\n\");\n        buffer = lines.pop() || \"\";\n\n        for (const line of lines) {\n          if (!line.startsWith(\"data: \")) continue;\n          try {\n            const incomingEvent: TEvent = JSON.parse(line.slice(6));\n            const handled = this.handleIncomingEvent(incomingEvent);\n            if (!handled) continue;\n            yield incomingEvent;\n\n            // If we receive a run:status:updated event with completed/failed, we can stop\n            if (incomingEvent.type === \"run:status:updated\") {\n              const data = incomingEvent.data as { status?: string };\n              if (data?.status === \"completed\" || data?.status === \"failed\") {\n                this.setState({ streaming: false });\n                return;\n              }\n            }\n          } catch (e) {\n            console.error(\"Failed to parse event\", e);\n          }\n        }\n      }\n      this.setState({ streaming: false });\n    } catch (err) {\n      if (err instanceof Error && err.name === \"AbortError\") {\n        this.setState({ streaming: false });\n        return;\n      }\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.setState({ error, streaming: false });\n      throw error;\n    }\n  }\n\n  /**\n   * List all unique threads.\n   */\n  async listThreads(): Promise<{ id: string }[]> {\n    const headers = await this.getRequestHeaders();\n    const response = await fetch(`${this.url}/threads`, { headers });\n    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);\n    const data = await response.json();\n    return data.threads;\n  }\n\n  /**\n   * List all runs, optionally filtered by thread ID.\n   */\n  async listRuns(filter?: { threadId?: string }): Promise<any[]> {\n    const headers = await this.getRequestHeaders();\n    const runsUrl = new URL(`${this.url}/runs`);\n    if (filter?.threadId) runsUrl.searchParams.set(\"threadId\", filter.threadId);\n    \n    const response = await fetch(runsUrl.toString(), { headers });\n    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);\n    const data = await response.json();\n    return data.runs;\n  }\n\n  /**\n   * Get historical events for a run or thread.\n   */\n  async listEvents(filter: { runId?: string; threadId?: string }): Promise<TEvent[]> {\n    const headers = await this.getRequestHeaders();\n    const eventsUrl = new URL(`${this.url}/events`);\n    if (filter.runId) eventsUrl.searchParams.set(\"runId\", filter.runId);\n    if (filter.threadId) eventsUrl.searchParams.set(\"threadId\", filter.threadId);\n\n    const response = await fetch(eventsUrl.toString(), { headers });\n    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);\n    const data = await response.json();\n    return data.events;\n  }\n\n  /**\n   * Check server health.\n   */\n  async getHealth(): Promise<any> {\n    const headers = await this.getRequestHeaders();\n    const response = await fetch(`${this.url}/health`, { headers });\n    if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);\n    return await response.json();\n  }\n\n  private handleIncomingEvent(event: TEvent) {\n    const events = [...this.state.events];\n\n    // Replace optimistic event if IDs match, otherwise push\n    const index = event.id ? events.findIndex((e) => e.id === event.id) : -1;\n    if (index !== -1) {\n      events[index] = event;\n    } else {\n      events.push(event);\n    }\n\n    this.setState({ events });\n    return true;\n  }\n\n  reset(events: TEvent[] = []) {\n    this.stop();\n    this.setState({\n      events,\n      error: null,\n      streaming: false,\n    });\n  }\n\n  stop() {\n    if (this.abortController) {\n      this.abortController.abort();\n      this.abortController = null;\n      this.setState({ streaming: false });\n    }\n  }\n}\n"]}

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { MelonyClient } from './chunk-7YBEEXMK.js';
+import { MelonyClient } from './chunk-EY5SDCRC.js';
 import './chunk-WAI5H335.js';
 import 'dotenv/config';
 import * as readline from 'readline/promises';

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { E as Event } from './generate-id-nIiN6qMt.js';
-export { g as generateId } from './generate-id-nIiN6qMt.js';
+import { E as Event } from './generate-id-wXNQEJ8t.js';
+export { g as generateId } from './generate-id-wXNQEJ8t.js';
 
 interface ClientState<TEvent extends Event = Event> {
     events: TEvent[];
@@ -31,6 +31,36 @@ declare class MelonyClient<TEvent extends Event = Event> {
     private getRequestHeaders;
     private setState;
     send(event: TEvent, additionalBody?: Record<string, any>): AsyncGenerator<TEvent>;
+    /**
+     * Stream events from a specific run or thread.
+     */
+    stream(filter: {
+        runId?: string;
+        threadId?: string;
+    }): AsyncGenerator<TEvent>;
+    /**
+     * List all unique threads.
+     */
+    listThreads(): Promise<{
+        id: string;
+    }[]>;
+    /**
+     * List all runs, optionally filtered by thread ID.
+     */
+    listRuns(filter?: {
+        threadId?: string;
+    }): Promise<any[]>;
+    /**
+     * Get historical events for a run or thread.
+     */
+    listEvents(filter: {
+        runId?: string;
+        threadId?: string;
+    }): Promise<TEvent[]>;
+    /**
+     * Check server health.
+     */
+    getHealth(): Promise<any>;
     private handleIncomingEvent;
     reset(events?: TEvent[]): void;
     stop(): void;

package/dist/client.js

@@ -1,4 +1,4 @@
-export { MelonyClient } from './chunk-7YBEEXMK.js';
+export { MelonyClient } from './chunk-EY5SDCRC.js';
 export { generateId } from './chunk-WAI5H335.js';
 //# sourceMappingURL=client.js.map
 //# sourceMappingURL=client.js.map

package/dist/{generate-id-nIiN6qMt.d.ts → generate-id-wXNQEJ8t.d.ts}

@@ -27,13 +27,17 @@ declare class Runtime<TState = any, TEvent extends Event = Event> {
  * The core Event structure.
  * Fully unopinionated - just type, data, and optional metadata.
  */
-type Event<TData = any> = {
+type Event<TData = any, TMeta = Record<string, any>> = {
     /** Unique identifier for the event */
     id?: string;
     /** The type of the event */
     type: string;
     /** The data associated with the event */
-    data: TData;
+    data?: TData;
+    /** Optional metadata associated with the event */
+    meta?: TMeta;
+    /** Timestamp of when the event occurred */
+    timestamp?: number;
 };
 /**
  * Built-in error event emitted by the runtime.
@@ -44,6 +48,16 @@ interface ErrorEvent extends Event<{
 }> {
     type: "error";
 }
+type RunStatus = "pending" | "running" | "completed" | "failed" | "suspended";
+interface Run<TState = any, TEvent extends Event = Event> {
+    id: string;
+    threadId?: string;
+    status: RunStatus;
+    events: TEvent[];
+    state: TState;
+    startTime: number;
+    endTime?: number;
+}
 interface RuntimeContext<TState = any, TEvent extends Event = Event> {
     state: TState;
     runId: string;
@@ -71,4 +85,4 @@ interface Config<TState = any, TEvent extends Event = Event> {
 
 declare const generateId: () => string;
 
-export { type Config as C, type Event as E, type Interceptor as I, Runtime as R, type RuntimeContext as a, type ErrorEvent as b, type EventHandler as c, generateId as g };
+export { type Config as C, type Event as E, type Interceptor as I, Runtime as R, type RuntimeContext as a, type ErrorEvent as b, type RunStatus as c, type Run as d, type EventHandler as e, generateId as g };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as Runtime, E as Event, C as Config, a as RuntimeContext, I as Interceptor } from './generate-id-nIiN6qMt.js';
-export { b as ErrorEvent, c as EventHandler, g as generateId } from './generate-id-nIiN6qMt.js';
+import { R as Runtime, E as Event, C as Config, a as RuntimeContext, I as Interceptor } from './generate-id-wXNQEJ8t.js';
+export { b as ErrorEvent, e as EventHandler, d as Run, c as RunStatus, g as generateId } from './generate-id-wXNQEJ8t.js';
 
 declare const MelonyRuntime: typeof Runtime;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "melony",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "main": "dist/index.js",
   "type": "module",
   "sideEffects": false,

package/dist/chunk-7YBEEXMK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"chunk-7YBEEXMK.js","sourcesContent":["import { Event } from \"./types\";\nimport { generateId } from \"./utils/generate-id\";\n\nexport type { Event };\nexport { generateId };\n\nexport interface ClientState<TEvent extends Event = Event> {\n  events: TEvent[];\n  streaming: boolean;\n  error: Error | null;\n  context: Record<string, any>;\n}\n\nexport interface MelonyClientOptions<TEvent extends Event = Event> {\n  url: string;\n  initialEvents?: TEvent[];\n  initialContext?: Record<string, any>;\n  headers?:\n  | Record<string, string>\n  | (() => Record<string, string> | Promise<Record<string, string>>);\n}\n\nexport class MelonyClient<TEvent extends Event = Event> {\n  private state: ClientState<TEvent>;\n  public readonly url: string;\n  private headers?: MelonyClientOptions<TEvent>[\"headers\"];\n  private lastServerState: any = null;\n  private abortController: AbortController | null = null;\n  private stateListeners: Set<(state: ClientState<TEvent>) => void> = new Set();\n\n  constructor(options: MelonyClientOptions<TEvent>) {\n    this.url = options.url;\n    this.headers = options.headers;\n    this.state = {\n      events: options.initialEvents ?? [],\n      streaming: false,\n      error: null,\n      context: options.initialContext ?? {},\n    };\n  }\n\n  subscribe(listener: (state: ClientState<TEvent>) => void) {\n    this.stateListeners.add(listener);\n    return () => {\n      this.stateListeners.delete(listener);\n    };\n  }\n\n  getState() {\n    return { ...this.state };\n  }\n\n  private async getRequestHeaders() {\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n    };\n\n    if (this.headers) {\n      const extraHeaders =\n        typeof this.headers === \"function\"\n          ? await this.headers()\n          : this.headers;\n      Object.assign(headers, extraHeaders);\n    }\n    return headers;\n  }\n\n  private setState(updates: Partial<ClientState<TEvent>>) {\n    this.state = { ...this.state, ...updates };\n    this.stateListeners.forEach((l) => l(this.getState()));\n  }\n\n  async *send(\n    event: TEvent,\n    additionalBody?: Record<string, any>\n  ): AsyncGenerator<TEvent> {\n    if (this.abortController) this.abortController.abort();\n    this.abortController = new AbortController();\n\n    const optimisticEvent: TEvent = {\n      id: generateId(),\n      ...event\n    } as TEvent;\n\n    this.setState({\n      streaming: true,\n      error: null,\n      events: [...this.state.events, optimisticEvent],\n    });\n\n    try {\n      const headers = await this.getRequestHeaders();\n      const response = await fetch(this.url, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify({\n          event: optimisticEvent,\n          ...additionalBody,\n        }),\n        signal: this.abortController.signal,\n      });\n\n      if (!response.ok)\n        throw new Error(`HTTP error! status: ${response.status}`);\n      if (!response.body) throw new Error(\"No response body\");\n\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder();\n      let buffer = \"\";\n\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split(\"\\n\\n\");\n        buffer = lines.pop() || \"\";\n\n        for (const line of lines) {\n          if (!line.startsWith(\"data: \")) continue;\n          try {\n            const incomingEvent: TEvent = JSON.parse(line.slice(6));\n            const handled = this.handleIncomingEvent(incomingEvent);\n            if (!handled) continue;\n            yield incomingEvent;\n          } catch (e) {\n            console.error(\"Failed to parse event\", e);\n          }\n        }\n      }\n      this.setState({ streaming: false });\n    } catch (err) {\n      if (err instanceof Error && err.name === \"AbortError\") {\n        this.setState({ streaming: false });\n        return;\n      }\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.setState({ error, streaming: false });\n      throw error;\n    }\n  }\n\n  private handleIncomingEvent(event: TEvent) {\n    const events = [...this.state.events];\n\n    // Replace optimistic event if IDs match, otherwise push\n    const index = event.id ? events.findIndex((e) => e.id === event.id) : -1;\n    if (index !== -1) {\n      events[index] = event;\n    } else {\n      events.push(event);\n    }\n\n    this.setState({ events });\n    return true;\n  }\n\n  reset(events: TEvent[] = []) {\n    this.stop();\n    this.setState({\n      events,\n      error: null,\n      streaming: false,\n    });\n  }\n\n  stop() {\n    if (this.abortController) {\n      this.abortController.abort();\n      this.abortController = null;\n      this.setState({ streaming: false });\n    }\n  }\n}\n"]}