openai 7.3.0 → 7.5.0

package/lib/ChatCompletionStreamingRunner.d.mts

@@ -1,26 +1,34 @@
-import { type ChatCompletionChunk, type ChatCompletionCreateParamsStreaming } from "../resources/chat/completions.mjs";
-import { RunnerOptions, type AbstractChatCompletionRunnerEvents } from "./AbstractChatCompletionRunner.mjs";
-import { type ReadableStream } from "../internal/shim-types.mjs";
-import { RunnableTools, type BaseFunctionsArgs } from "./RunnableFunction.mjs";
-import { ChatCompletionSnapshot, ChatCompletionStream } from "./ChatCompletionStream.mjs";
-import OpenAI from "../index.mjs";
-import { AutoParseableTool } from "../lib/parser.mjs";
+import type { ChatCompletionChunk, ChatCompletionCreateParamsStreaming } from "../resources/chat/completions.mjs";
+import type { AbstractChatCompletionRunnerEvents, RunnerOptions } from "./AbstractChatCompletionRunner.mjs";
+import type { ReadableStream } from "../internal/shim-types.mjs";
+import type { BaseFunctionsArgs, RunnableTools } from "./RunnableFunction.mjs";
+import { ChatCompletionStream } from "./ChatCompletionStream.mjs";
+import type { ChatCompletionSnapshot } from "./ChatCompletionStream.mjs";
+import type OpenAI from "../index.mjs";
+import type { AutoParseableTool } from "../lib/parser.mjs";
+/** Conversation and chunk events emitted by a streaming chat completion tool runner. */
 export interface ChatCompletionStreamEvents extends AbstractChatCompletionRunnerEvents {
+    /** Called with each assistant-text fragment and the text accumulated so far. */
     content: (contentDelta: string, contentSnapshot: string) => void;
+    /** Called with each raw API chunk and its accumulated completion snapshot. */
     chunk: (chunk: ChatCompletionChunk, snapshot: ChatCompletionSnapshot) => void;
 }
+/** Streaming chat completion request fields shared by all tool-runner overloads. */
 type ChatCompletionStreamingToolRunnerParamsBase = Omit<ChatCompletionCreateParamsStreaming, 'tools'>;
 /**
  * Parameters for tools that do not require a context value.
  */
 export type ChatCompletionStreamingToolRunnerParamsWithoutContext<FunctionsArgs extends BaseFunctionsArgs> = ChatCompletionStreamingToolRunnerParamsBase & {
+    /** Runnable function tools or auto-parseable tools with an attached callback. */
     tools: RunnableTools<FunctionsArgs> | AutoParseableTool<any, true>[];
+    /** Context is unavailable for the no-context runner overload. */
     toolContext?: never;
 };
 /**
  * Parameters for tools that require a context value.
  */
 export type ChatCompletionStreamingToolRunnerParamsWithContext<FunctionsArgs extends BaseFunctionsArgs, ToolContext> = ChatCompletionStreamingToolRunnerParamsBase & {
+    /** Runnable function tools or auto-parseable tools that receive `toolContext`. */
     tools: RunnableTools<FunctionsArgs, ToolContext> | AutoParseableTool<any, true>[];
     /**
      * Context to pass to each tool callback during this run.
@@ -32,10 +40,15 @@ export type ChatCompletionStreamingToolRunnerParamsWithContext<FunctionsArgs ext
  * `toolContext` required; omitting it preserves the existing no-context form.
  */
 export type ChatCompletionStreamingToolRunnerParams<FunctionsArgs extends BaseFunctionsArgs, ToolContext = never> = [ToolContext] extends [never] ? ChatCompletionStreamingToolRunnerParamsWithoutContext<FunctionsArgs> : ChatCompletionStreamingToolRunnerParamsWithContext<FunctionsArgs, ToolContext>;
+/** Executes function tools while streaming every intermediate chat completion. */
 export declare class ChatCompletionStreamingRunner<ParsedT = null> extends ChatCompletionStream<ParsedT> implements AsyncIterable<ChatCompletionChunk> {
+    /** Restores a serialized tool run, including intermediate completions and tool-result messages. */
     static fromReadableStream(stream: ReadableStream): ChatCompletionStreamingRunner<null>;
+    /** Serializes completion chunks and tool-result messages for replay in another runtime. */
     toReadableStream(): ReadableStream;
+    /** Runs streaming function tools, passing the supplied context to each callback. */
     static runTools<T extends (string | object)[], ParsedT = null, ToolContext = unknown>(client: OpenAI, params: ChatCompletionStreamingToolRunnerParamsWithContext<T, ToolContext>, options?: RunnerOptions): ChatCompletionStreamingRunner<ParsedT>;
+    /** Runs streaming function tools until the model produces a final assistant message. */
     static runTools<T extends (string | object)[], ParsedT = null>(client: OpenAI, params: ChatCompletionStreamingToolRunnerParamsWithoutContext<T>, options?: RunnerOptions): ChatCompletionStreamingRunner<ParsedT>;
 }
 export {};

package/lib/ChatCompletionStreamingRunner.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatCompletionStreamingRunner.d.mts","sourceRoot":"","sources":["../src/lib/ChatCompletionStreamingRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,mCAAmC,EAEzC,0CAAsC;AACvC,OAAO,EAAE,aAAa,EAAE,KAAK,kCAAkC,EAAE,2CAAuC;AACxG,OAAO,EAAE,KAAK,cAAc,EAAE,mCAA+B;AAC7D,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,+BAA2B;AAC3E,OAAO,EAEL,sBAAsB,EACtB,oBAAoB,EAErB,mCAA+B;AAEhC,OAAO,MAAM,qBAAiB;AAC9B,OAAO,EAAE,iBAAiB,EAAE,0BAAsB;AAIlD,MAAM,WAAW,0BAA2B,SAAQ,kCAAkC;IACpF,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,KAAK,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC/E;AAED,KAAK,2CAA2C,GAAG,IAAI,CAAC,mCAAmC,EAAE,OAAO,CAAC,CAAC;AAEtG;;GAEG;AACH,MAAM,MAAM,qDAAqD,CAAC,aAAa,SAAS,iBAAiB,IACvG,2CAA2C,GAAG;IAC5C,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;IACrE,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,kDAAkD,CAC5D,aAAa,SAAS,iBAAiB,EACvC,WAAW,IACT,2CAA2C,GAAG;IAChD,KAAK,EAAE,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;IAClF;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,uCAAuC,CACjD,aAAa,SAAS,iBAAiB,EACvC,WAAW,GAAG,KAAK,IACjB,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,qDAAqD,CAAC,aAAa,CAAC,GACtG,kDAAkD,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;AAEjF,qBAAa,6BAA6B,CAAC,OAAO,GAAG,IAAI,CACvD,SAAQ,oBAAoB,CAAC,OAAO,CACpC,YAAW,aAAa,CAAC,mBAAmB,CAAC;WAE7B,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,6BAA6B,CAAC,IAAI,CAAC;IAMtF,gBAAgB,IAAI,cAAc;IAuF3C,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAAE,WAAW,GAAG,OAAO,EAClF,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kDAAkD,CAAC,CAAC,EAAE,WAAW,CAAC,EAC1E,OAAO,CAAC,EAAE,aAAa,GACtB,6BAA6B,CAAC,OAAO,CAAC;IAEzC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAC3D,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,qDAAqD,CAAC,CAAC,CAAC,EAChE,OAAO,CAAC,EAAE,aAAa,GACtB,6BAA6B,CAAC,OAAO,CAAC;CAmB1C"}
+{"version":3,"file":"ChatCompletionStreamingRunner.d.mts","sourceRoot":"","sources":["../src/lib/ChatCompletionStreamingRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mCAAmC,EAEpC,0CAAsC;AACvC,OAAO,KAAK,EAAE,kCAAkC,EAAE,aAAa,EAAE,2CAAuC;AACxG,OAAO,KAAK,EAAE,cAAc,EAAE,mCAA+B;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,+BAA2B;AAC3E,OAAO,EAAE,oBAAoB,EAAgD,mCAA+B;AAC5G,OAAO,KAAK,EAAoC,sBAAsB,EAAE,mCAA+B;AAEvG,OAAO,KAAK,MAAM,qBAAiB;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAAsB;AAIvD,wFAAwF;AACxF,MAAM,WAAW,0BAA2B,SAAQ,kCAAkC;IACpF,gFAAgF;IAChF,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,8EAA8E;IAC9E,KAAK,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC/E;AAED,oFAAoF;AACpF,KAAK,2CAA2C,GAAG,IAAI,CAAC,mCAAmC,EAAE,OAAO,CAAC,CAAC;AAEtG;;GAEG;AACH,MAAM,MAAM,qDAAqD,CAAC,aAAa,SAAS,iBAAiB,IACvG,2CAA2C,GAAG;IAC5C,iFAAiF;IACjF,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;IACrE,iEAAiE;IACjE,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,kDAAkD,CAC5D,aAAa,SAAS,iBAAiB,EACvC,WAAW,IACT,2CAA2C,GAAG;IAChD,kFAAkF;IAClF,KAAK,EAAE,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;IAClF;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,uCAAuC,CACjD,aAAa,SAAS,iBAAiB,EACvC,WAAW,GAAG,KAAK,IACjB,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,GAC7B,qDAAqD,CAAC,aAAa,CAAC,GACpE,kDAAkD,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;AAEnF,kFAAkF;AAClF,qBAAa,6BAA6B,CAAC,OAAO,GAAG,IAAI,CACvD,SAAQ,oBAAoB,CAAC,OAAO,CACpC,YAAW,aAAa,CAAC,mBAAmB,CAAC;IAE7C,mGAAmG;WACnF,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,6BAA6B,CAAC,IAAI,CAAC;IAM/F,2FAA2F;IAClF,gBAAgB,IAAI,cAAc;IAqC3C,oFAAoF;IACpF,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAAE,WAAW,GAAG,OAAO,EAClF,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kDAAkD,CAAC,CAAC,EAAE,WAAW,CAAC,EAC1E,OAAO,CAAC,EAAE,aAAa,GACtB,6BAA6B,CAAC,OAAO,CAAC;IAEzC,wFAAwF;IACxF,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAC3D,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,qDAAqD,CAAC,CAAC,CAAC,EAChE,OAAO,CAAC,EAAE,aAAa,GACtB,6BAA6B,CAAC,OAAO,CAAC;CAoB1C"}

package/lib/ChatCompletionStreamingRunner.d.ts

@@ -1,26 +1,34 @@
-import { type ChatCompletionChunk, type ChatCompletionCreateParamsStreaming } from "../resources/chat/completions.js";
-import { RunnerOptions, type AbstractChatCompletionRunnerEvents } from "./AbstractChatCompletionRunner.js";
-import { type ReadableStream } from "../internal/shim-types.js";
-import { RunnableTools, type BaseFunctionsArgs } from "./RunnableFunction.js";
-import { ChatCompletionSnapshot, ChatCompletionStream } from "./ChatCompletionStream.js";
-import OpenAI from "../index.js";
-import { AutoParseableTool } from "../lib/parser.js";
+import type { ChatCompletionChunk, ChatCompletionCreateParamsStreaming } from "../resources/chat/completions.js";
+import type { AbstractChatCompletionRunnerEvents, RunnerOptions } from "./AbstractChatCompletionRunner.js";
+import type { ReadableStream } from "../internal/shim-types.js";
+import type { BaseFunctionsArgs, RunnableTools } from "./RunnableFunction.js";
+import { ChatCompletionStream } from "./ChatCompletionStream.js";
+import type { ChatCompletionSnapshot } from "./ChatCompletionStream.js";
+import type OpenAI from "../index.js";
+import type { AutoParseableTool } from "../lib/parser.js";
+/** Conversation and chunk events emitted by a streaming chat completion tool runner. */
 export interface ChatCompletionStreamEvents extends AbstractChatCompletionRunnerEvents {
+    /** Called with each assistant-text fragment and the text accumulated so far. */
     content: (contentDelta: string, contentSnapshot: string) => void;
+    /** Called with each raw API chunk and its accumulated completion snapshot. */
     chunk: (chunk: ChatCompletionChunk, snapshot: ChatCompletionSnapshot) => void;
 }
+/** Streaming chat completion request fields shared by all tool-runner overloads. */
 type ChatCompletionStreamingToolRunnerParamsBase = Omit<ChatCompletionCreateParamsStreaming, 'tools'>;
 /**
  * Parameters for tools that do not require a context value.
  */
 export type ChatCompletionStreamingToolRunnerParamsWithoutContext<FunctionsArgs extends BaseFunctionsArgs> = ChatCompletionStreamingToolRunnerParamsBase & {
+    /** Runnable function tools or auto-parseable tools with an attached callback. */
     tools: RunnableTools<FunctionsArgs> | AutoParseableTool<any, true>[];
+    /** Context is unavailable for the no-context runner overload. */
     toolContext?: never;
 };
 /**
  * Parameters for tools that require a context value.
  */
 export type ChatCompletionStreamingToolRunnerParamsWithContext<FunctionsArgs extends BaseFunctionsArgs, ToolContext> = ChatCompletionStreamingToolRunnerParamsBase & {
+    /** Runnable function tools or auto-parseable tools that receive `toolContext`. */
     tools: RunnableTools<FunctionsArgs, ToolContext> | AutoParseableTool<any, true>[];
     /**
      * Context to pass to each tool callback during this run.
@@ -32,10 +40,15 @@ export type ChatCompletionStreamingToolRunnerParamsWithContext<FunctionsArgs ext
  * `toolContext` required; omitting it preserves the existing no-context form.
  */
 export type ChatCompletionStreamingToolRunnerParams<FunctionsArgs extends BaseFunctionsArgs, ToolContext = never> = [ToolContext] extends [never] ? ChatCompletionStreamingToolRunnerParamsWithoutContext<FunctionsArgs> : ChatCompletionStreamingToolRunnerParamsWithContext<FunctionsArgs, ToolContext>;
+/** Executes function tools while streaming every intermediate chat completion. */
 export declare class ChatCompletionStreamingRunner<ParsedT = null> extends ChatCompletionStream<ParsedT> implements AsyncIterable<ChatCompletionChunk> {
+    /** Restores a serialized tool run, including intermediate completions and tool-result messages. */
     static fromReadableStream(stream: ReadableStream): ChatCompletionStreamingRunner<null>;
+    /** Serializes completion chunks and tool-result messages for replay in another runtime. */
     toReadableStream(): ReadableStream;
+    /** Runs streaming function tools, passing the supplied context to each callback. */
     static runTools<T extends (string | object)[], ParsedT = null, ToolContext = unknown>(client: OpenAI, params: ChatCompletionStreamingToolRunnerParamsWithContext<T, ToolContext>, options?: RunnerOptions): ChatCompletionStreamingRunner<ParsedT>;
+    /** Runs streaming function tools until the model produces a final assistant message. */
     static runTools<T extends (string | object)[], ParsedT = null>(client: OpenAI, params: ChatCompletionStreamingToolRunnerParamsWithoutContext<T>, options?: RunnerOptions): ChatCompletionStreamingRunner<ParsedT>;
 }
 export {};

package/lib/ChatCompletionStreamingRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatCompletionStreamingRunner.d.ts","sourceRoot":"","sources":["../src/lib/ChatCompletionStreamingRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,mCAAmC,EAEzC,yCAAsC;AACvC,OAAO,EAAE,aAAa,EAAE,KAAK,kCAAkC,EAAE,0CAAuC;AACxG,OAAO,EAAE,KAAK,cAAc,EAAE,kCAA+B;AAC7D,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,8BAA2B;AAC3E,OAAO,EAEL,sBAAsB,EACtB,oBAAoB,EAErB,kCAA+B;AAEhC,OAAO,MAAM,oBAAiB;AAC9B,OAAO,EAAE,iBAAiB,EAAE,yBAAsB;AAIlD,MAAM,WAAW,0BAA2B,SAAQ,kCAAkC;IACpF,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,KAAK,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC/E;AAED,KAAK,2CAA2C,GAAG,IAAI,CAAC,mCAAmC,EAAE,OAAO,CAAC,CAAC;AAEtG;;GAEG;AACH,MAAM,MAAM,qDAAqD,CAAC,aAAa,SAAS,iBAAiB,IACvG,2CAA2C,GAAG;IAC5C,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;IACrE,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,kDAAkD,CAC5D,aAAa,SAAS,iBAAiB,EACvC,WAAW,IACT,2CAA2C,GAAG;IAChD,KAAK,EAAE,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;IAClF;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,uCAAuC,CACjD,aAAa,SAAS,iBAAiB,EACvC,WAAW,GAAG,KAAK,IACjB,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,qDAAqD,CAAC,aAAa,CAAC,GACtG,kDAAkD,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;AAEjF,qBAAa,6BAA6B,CAAC,OAAO,GAAG,IAAI,CACvD,SAAQ,oBAAoB,CAAC,OAAO,CACpC,YAAW,aAAa,CAAC,mBAAmB,CAAC;WAE7B,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,6BAA6B,CAAC,IAAI,CAAC;IAMtF,gBAAgB,IAAI,cAAc;IAuF3C,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAAE,WAAW,GAAG,OAAO,EAClF,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kDAAkD,CAAC,CAAC,EAAE,WAAW,CAAC,EAC1E,OAAO,CAAC,EAAE,aAAa,GACtB,6BAA6B,CAAC,OAAO,CAAC;IAEzC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAC3D,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,qDAAqD,CAAC,CAAC,CAAC,EAChE,OAAO,CAAC,EAAE,aAAa,GACtB,6BAA6B,CAAC,OAAO,CAAC;CAmB1C"}
+{"version":3,"file":"ChatCompletionStreamingRunner.d.ts","sourceRoot":"","sources":["../src/lib/ChatCompletionStreamingRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mCAAmC,EAEpC,yCAAsC;AACvC,OAAO,KAAK,EAAE,kCAAkC,EAAE,aAAa,EAAE,0CAAuC;AACxG,OAAO,KAAK,EAAE,cAAc,EAAE,kCAA+B;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,8BAA2B;AAC3E,OAAO,EAAE,oBAAoB,EAAgD,kCAA+B;AAC5G,OAAO,KAAK,EAAoC,sBAAsB,EAAE,kCAA+B;AAEvG,OAAO,KAAK,MAAM,oBAAiB;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,yBAAsB;AAIvD,wFAAwF;AACxF,MAAM,WAAW,0BAA2B,SAAQ,kCAAkC;IACpF,gFAAgF;IAChF,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,8EAA8E;IAC9E,KAAK,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC/E;AAED,oFAAoF;AACpF,KAAK,2CAA2C,GAAG,IAAI,CAAC,mCAAmC,EAAE,OAAO,CAAC,CAAC;AAEtG;;GAEG;AACH,MAAM,MAAM,qDAAqD,CAAC,aAAa,SAAS,iBAAiB,IACvG,2CAA2C,GAAG;IAC5C,iFAAiF;IACjF,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;IACrE,iEAAiE;IACjE,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,kDAAkD,CAC5D,aAAa,SAAS,iBAAiB,EACvC,WAAW,IACT,2CAA2C,GAAG;IAChD,kFAAkF;IAClF,KAAK,EAAE,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;IAClF;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,uCAAuC,CACjD,aAAa,SAAS,iBAAiB,EACvC,WAAW,GAAG,KAAK,IACjB,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,GAC7B,qDAAqD,CAAC,aAAa,CAAC,GACpE,kDAAkD,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;AAEnF,kFAAkF;AAClF,qBAAa,6BAA6B,CAAC,OAAO,GAAG,IAAI,CACvD,SAAQ,oBAAoB,CAAC,OAAO,CACpC,YAAW,aAAa,CAAC,mBAAmB,CAAC;IAE7C,mGAAmG;WACnF,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,6BAA6B,CAAC,IAAI,CAAC;IAM/F,2FAA2F;IAClF,gBAAgB,IAAI,cAAc;IAqC3C,oFAAoF;IACpF,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAAE,WAAW,GAAG,OAAO,EAClF,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kDAAkD,CAAC,CAAC,EAAE,WAAW,CAAC,EAC1E,OAAO,CAAC,EAAE,aAAa,GACtB,6BAA6B,CAAC,OAAO,CAAC;IAEzC,wFAAwF;IACxF,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAC3D,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,qDAAqD,CAAC,CAAC,CAAC,EAChE,OAAO,CAAC,EAAE,aAAa,GACtB,6BAA6B,CAAC,OAAO,CAAC;CAoB1C"}

package/lib/ChatCompletionStreamingRunner.js

@@ -5,93 +5,53 @@ const ChatCompletionStream_1 = require("./ChatCompletionStream.js");
 const error_1 = require("../error.js");
 const streaming_1 = require("../streaming.js");
 const chatCompletionUtils_1 = require("./chatCompletionUtils.js");
+/** Executes function tools while streaming every intermediate chat completion. */
 class ChatCompletionStreamingRunner extends ChatCompletionStream_1.ChatCompletionStream {
+    /** Restores a serialized tool run, including intermediate completions and tool-result messages. */
     static fromReadableStream(stream) {
         const runner = new ChatCompletionStreamingRunner(null);
         runner._run(() => runner._fromReadableStream(stream));
         return runner;
     }
+    /** Serializes completion chunks and tool-result messages for replay in another runtime. */
     toReadableStream() {
-        const pushQueue = [];
-        const readQueue = [];
-        let done = false;
         let lastChunk;
         let toolCallIds;
-        const pushEvent = (event) => {
-            const reader = readQueue.shift();
-            if (reader) {
-                reader.resolve(event);
-            }
-            else {
-                pushQueue.push(event);
-            }
-        };
-        this.on('chunk', (chunk) => {
-            lastChunk = chunk;
-            pushEvent(chunk);
-        });
-        this.on('message', (message) => {
-            if ((0, chatCompletionUtils_1.isAssistantMessage)(message)) {
-                toolCallIds = message.tool_calls?.map((toolCall) => toolCall.id);
-                return;
-            }
-            if ((0, chatCompletionUtils_1.isToolMessage)(message)) {
-                if (!lastChunk) {
-                    throw new error_1.OpenAIError('cannot serialize a tool message before receiving any chunks');
+        const iterator = this._createIterator((push) => {
+            const onChunk = (chunk) => {
+                lastChunk = chunk;
+                push(chunk);
+            };
+            const onMessage = (message) => {
+                if ((0, chatCompletionUtils_1.isAssistantMessage)(message)) {
+                    toolCallIds = message.tool_calls?.map((toolCall) => toolCall.id);
+                    return;
                 }
-                pushEvent((0, ChatCompletionStream_1.makeChatCompletionReadableStreamMessageChunk)(lastChunk, message, toolCallIds));
-            }
-        });
-        this.on('end', () => {
-            done = true;
-            for (const reader of readQueue) {
-                reader.resolve(undefined);
-            }
-            readQueue.length = 0;
-        });
-        this.on('abort', (err) => {
-            done = true;
-            for (const reader of readQueue) {
-                reader.reject(err);
-            }
-            readQueue.length = 0;
-        });
-        this.on('error', (err) => {
-            done = true;
-            for (const reader of readQueue) {
-                reader.reject(err);
-            }
-            readQueue.length = 0;
-        });
-        const iterator = () => ({
-            next: async () => {
-                if (!pushQueue.length) {
-                    if (done) {
-                        return { value: undefined, done: true };
+                if ((0, chatCompletionUtils_1.isToolMessage)(message)) {
+                    if (!lastChunk) {
+                        throw new error_1.OpenAIError('cannot serialize a tool message before receiving any chunks');
                     }
-                    return new Promise((resolve, reject) => readQueue.push({ resolve, reject })).then((event) => (event ? { value: event, done: false } : { value: undefined, done: true }));
-                }
-                const event = pushQueue.shift();
-                if (!event) {
-                    return { value: undefined, done: true };
+                    push((0, ChatCompletionStream_1.makeChatCompletionReadableStreamMessageChunk)(lastChunk, message, toolCallIds));
                 }
-                return { value: event, done: false };
-            },
-            return: async () => {
-                this.abort();
-                return { value: undefined, done: true };
-            },
-        });
-        const stream = new streaming_1.Stream(iterator, this.controller);
+            };
+            this.on('chunk', onChunk);
+            this.on('message', onMessage);
+            return () => {
+                this.off('chunk', onChunk);
+                this.off('message', onMessage);
+            };
+        }, { onReturn: () => this.abort() });
+        const stream = new streaming_1.Stream(() => iterator, this.controller);
         return stream.toReadableStream();
     }
+    /** Starts a streaming tool loop and returns its event-driven conversation runner. */
     static runTools(client, params, options) {
         const runner = new ChatCompletionStreamingRunner(
         // @ts-expect-error TODO these types are incompatible
         params);
         const opts = {
             ...options,
-            headers: { ...options?.headers, 'X-Stainless-Helper-Method': 'runTools' },
+            __metadata: { ...options?.__metadata, helperMethod: 'runTools' },
         };
         runner._run(() => runner._runTools(client, params, runner, opts));
         return runner;

package/lib/ChatCompletionStreamingRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatCompletionStreamingRunner.js","sourceRoot":"","sources":["../src/lib/ChatCompletionStreamingRunner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ChatCompletionStreamingRunner.js","sourceRoot":"","sources":["../src/lib/ChatCompletionStreamingRunner.ts"],"names":[],"mappings":";;;AAQA,oEAA4G;AAE5G,uCAAuC;AAGvC,+CAAsC;AACtC,kEAA0E;AAkD1E,kFAAkF;AAClF,MAAa,6BACX,SAAQ,2CAA6B;IAGrC,mGAAmG;IACnG,MAAM,CAAU,kBAAkB,CAAC,MAAsB;QACvD,MAAM,MAAM,GAAG,IAAI,6BAA6B,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,2FAA2F;IAClF,gBAAgB;QACvB,IAAI,SAA0C,CAAC;QAC/C,IAAI,WAAiC,CAAC;QAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CACnC,CAAC,IAAI,EAAE,EAAE;YACP,MAAM,OAAO,GAAG,CAAC,KAA0B,EAAE,EAAE;gBAC7C,SAAS,GAAG,KAAK,CAAC;gBAClB,IAAI,CAAC,KAAK,CAAC,CAAC;YACd,CAAC,CAAC;YACF,MAAM,SAAS,GAAG,CAAC,OAAmC,EAAE,EAAE;gBACxD,IAAI,IAAA,wCAAkB,EAAC,OAAO,CAAC,EAAE,CAAC;oBAChC,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBACjE,OAAO;gBACT,CAAC;gBAED,IAAI,IAAA,mCAAa,EAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,MAAM,IAAI,mBAAW,CAAC,6DAA6D,CAAC,CAAC;oBACvF,CAAC;oBACD,IAAI,CAAC,IAAA,mEAA4C,EAAC,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC,CAAC;YACF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1B,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC9B,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACjC,CAAC,CAAC;QACJ,CAAC,EACD,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CACjC,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,kBAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC,gBAAgB,EAAE,CAAC;IACnC,CAAC;IAeD,qFAAqF;IACrF,MAAM,CAAC,QAAQ,CACb,MAAc,EACd,MAE4D,EAC5D,OAAuB;QAEvB,MAAM,MAAM,GAAG,IAAI,6BAA6B;QAC9C,qDAAqD;QACrD,MAAM,CACP,CAAC;QACF,MAAM,IAAI,GAAG;YACX,GAAG,OAAO;YACV,UAAU,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE;SACjE,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAjFD,sEAiFC"}

package/lib/ChatCompletionStreamingRunner.mjs

@@ -1,94 +1,54 @@
-import { ChatCompletionStream, makeChatCompletionReadableStreamMessageChunk, } from "./ChatCompletionStream.mjs";
+import { ChatCompletionStream, makeChatCompletionReadableStreamMessageChunk } from "./ChatCompletionStream.mjs";
 import { OpenAIError } from "../error.mjs";
 import { Stream } from "../streaming.mjs";
 import { isAssistantMessage, isToolMessage } from "./chatCompletionUtils.mjs";
+/** Executes function tools while streaming every intermediate chat completion. */
 export class ChatCompletionStreamingRunner extends ChatCompletionStream {
+    /** Restores a serialized tool run, including intermediate completions and tool-result messages. */
     static fromReadableStream(stream) {
         const runner = new ChatCompletionStreamingRunner(null);
         runner._run(() => runner._fromReadableStream(stream));
         return runner;
     }
+    /** Serializes completion chunks and tool-result messages for replay in another runtime. */
     toReadableStream() {
-        const pushQueue = [];
-        const readQueue = [];
-        let done = false;
         let lastChunk;
         let toolCallIds;
-        const pushEvent = (event) => {
-            const reader = readQueue.shift();
-            if (reader) {
-                reader.resolve(event);
-            }
-            else {
-                pushQueue.push(event);
-            }
-        };
-        this.on('chunk', (chunk) => {
-            lastChunk = chunk;
-            pushEvent(chunk);
-        });
-        this.on('message', (message) => {
-            if (isAssistantMessage(message)) {
-                toolCallIds = message.tool_calls?.map((toolCall) => toolCall.id);
-                return;
-            }
-            if (isToolMessage(message)) {
-                if (!lastChunk) {
-                    throw new OpenAIError('cannot serialize a tool message before receiving any chunks');
+        const iterator = this._createIterator((push) => {
+            const onChunk = (chunk) => {
+                lastChunk = chunk;
+                push(chunk);
+            };
+            const onMessage = (message) => {
+                if (isAssistantMessage(message)) {
+                    toolCallIds = message.tool_calls?.map((toolCall) => toolCall.id);
+                    return;
                 }
-                pushEvent(makeChatCompletionReadableStreamMessageChunk(lastChunk, message, toolCallIds));
-            }
-        });
-        this.on('end', () => {
-            done = true;
-            for (const reader of readQueue) {
-                reader.resolve(undefined);
-            }
-            readQueue.length = 0;
-        });
-        this.on('abort', (err) => {
-            done = true;
-            for (const reader of readQueue) {
-                reader.reject(err);
-            }
-            readQueue.length = 0;
-        });
-        this.on('error', (err) => {
-            done = true;
-            for (const reader of readQueue) {
-                reader.reject(err);
-            }
-            readQueue.length = 0;
-        });
-        const iterator = () => ({
-            next: async () => {
-                if (!pushQueue.length) {
-                    if (done) {
-                        return { value: undefined, done: true };
+                if (isToolMessage(message)) {
+                    if (!lastChunk) {
+                        throw new OpenAIError('cannot serialize a tool message before receiving any chunks');
                     }
-                    return new Promise((resolve, reject) => readQueue.push({ resolve, reject })).then((event) => (event ? { value: event, done: false } : { value: undefined, done: true }));
-                }
-                const event = pushQueue.shift();
-                if (!event) {
-                    return { value: undefined, done: true };
+                    push(makeChatCompletionReadableStreamMessageChunk(lastChunk, message, toolCallIds));
                 }
-                return { value: event, done: false };
-            },
-            return: async () => {
-                this.abort();
-                return { value: undefined, done: true };
-            },
-        });
-        const stream = new Stream(iterator, this.controller);
+            };
+            this.on('chunk', onChunk);
+            this.on('message', onMessage);
+            return () => {
+                this.off('chunk', onChunk);
+                this.off('message', onMessage);
+            };
+        }, { onReturn: () => this.abort() });
+        const stream = new Stream(() => iterator, this.controller);
         return stream.toReadableStream();
     }
+    /** Starts a streaming tool loop and returns its event-driven conversation runner. */
     static runTools(client, params, options) {
         const runner = new ChatCompletionStreamingRunner(
         // @ts-expect-error TODO these types are incompatible
         params);
         const opts = {
             ...options,
-            headers: { ...options?.headers, 'X-Stainless-Helper-Method': 'runTools' },
+            __metadata: { ...options?.__metadata, helperMethod: 'runTools' },
         };
         runner._run(() => runner._runTools(client, params, runner, opts));
         return runner;

package/lib/ChatCompletionStreamingRunner.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ChatCompletionStreamingRunner.mjs","sourceRoot":"","sources":["../src/lib/ChatCompletionStreamingRunner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ChatCompletionStreamingRunner.mjs","sourceRoot":"","sources":["../src/lib/ChatCompletionStreamingRunner.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,4CAA4C,EAAE,mCAA+B;AAE5G,OAAO,EAAE,WAAW,EAAE,qBAAiB;AAGvC,OAAO,EAAE,MAAM,EAAE,yBAAqB;AACtC,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,kCAA8B;AAkD1E,kFAAkF;AAClF,MAAM,OAAO,6BACX,SAAQ,oBAA6B;IAGrC,mGAAmG;IACnG,MAAM,CAAU,kBAAkB,CAAC,MAAsB;QACvD,MAAM,MAAM,GAAG,IAAI,6BAA6B,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,2FAA2F;IAClF,gBAAgB;QACvB,IAAI,SAA0C,CAAC;QAC/C,IAAI,WAAiC,CAAC;QAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CACnC,CAAC,IAAI,EAAE,EAAE;YACP,MAAM,OAAO,GAAG,CAAC,KAA0B,EAAE,EAAE;gBAC7C,SAAS,GAAG,KAAK,CAAC;gBAClB,IAAI,CAAC,KAAK,CAAC,CAAC;YACd,CAAC,CAAC;YACF,MAAM,SAAS,GAAG,CAAC,OAAmC,EAAE,EAAE;gBACxD,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;oBAChC,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBACjE,OAAO;gBACT,CAAC;gBAED,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,MAAM,IAAI,WAAW,CAAC,6DAA6D,CAAC,CAAC;oBACvF,CAAC;oBACD,IAAI,CAAC,4CAA4C,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC,CAAC;YACF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1B,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC9B,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACjC,CAAC,CAAC;QACJ,CAAC,EACD,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CACjC,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC,gBAAgB,EAAE,CAAC;IACnC,CAAC;IAeD,qFAAqF;IACrF,MAAM,CAAC,QAAQ,CACb,MAAc,EACd,MAE4D,EAC5D,OAAuB;QAEvB,MAAM,MAAM,GAAG,IAAI,6BAA6B;QAC9C,qDAAqD;QACrD,MAAM,CACP,CAAC;QACF,MAAM,IAAI,GAAG;YACX,GAAG,OAAO;YACV,UAAU,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE;SACjE,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/lib/EventEmitter.d.mts

@@ -1,7 +1,8 @@
+/** The listener callback associated with one event name in an event map. */
 type EventListener<Events, EventType extends keyof Events> = Events[EventType];
-export type EventParameters<Events, EventType extends keyof Events> = {
-    [Event in EventType]: EventListener<Events, EventType> extends (...args: infer P) => any ? P : never;
-}[EventType];
+/** The positional listener arguments associated with a named event. */
+export type EventParameters<Events, EventType extends keyof Events> = Record<EventType, EventListener<Events, EventType> extends (...args: infer P) => any ? P : never>[EventType];
+/** A lightweight event emitter with type-safe listeners and promise-based event waiting. */
 export declare class EventEmitter<EventTypes extends Record<string, (...args: any) => any>> {
     #private;
     /**
@@ -29,9 +30,11 @@ export declare class EventEmitter<EventTypes extends Record<string, (...args: an
     /**
      * This is similar to `.once()`, but returns a Promise that resolves the next time
      * the event is triggered, instead of calling a listener callback.
-     * @returns a Promise that resolves the next time given event is triggered,
-     * or rejects if an error is emitted.  (If you request the 'error' event,
-     * returns a promise that resolves with the error).
+     * Events without arguments resolve to `undefined`, single-argument events resolve
+     * to that argument, and events with multiple arguments resolve to an argument tuple.
+     *
+     * @returns A promise for the next event, or a rejection if an error occurs first.
+     * Requesting the `error` event resolves with the emitted error instead.
      *
      * Example:
      *

package/lib/EventEmitter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"EventEmitter.d.mts","sourceRoot":"","sources":["../src/lib/EventEmitter.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,CAAC,MAAM,EAAE,SAAS,SAAS,MAAM,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;AAO/E,MAAM,MAAM,eAAe,CAAC,MAAM,EAAE,SAAS,SAAS,MAAM,MAAM,IAAI;KACnE,KAAK,IAAI,SAAS,GAAG,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK;CACrG,CAAC,SAAS,CAAC,CAAC;AAEb,qBAAa,YAAY,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;;IAKhF;;;;;;OAMG;IACH,EAAE,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAOlG;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAQnG;;;;OAIG;IACH,IAAI,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAOpG;;;;;;;;;;OAUG;IACH,OAAO,CAAC,KAAK,SAAS,MAAM,UAAU,EACpC,KAAK,EAAE,KAAK,GACX,OAAO,CACR,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,GAAG,KAAK,GAC9D,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,GACpD,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CACrC;IAgBD,SAAS,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,UAAU,EAC5C,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,EAC9B,KAAK,EAAE,KAAK,EACZ,GAAG,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC;IAS7C,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,UAAU,GAAG,OAAO;CAIzD"}
+{"version":3,"file":"EventEmitter.d.mts","sourceRoot":"","sources":["../src/lib/EventEmitter.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,KAAK,aAAa,CAAC,MAAM,EAAE,SAAS,SAAS,MAAM,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;AAO/E,uEAAuE;AACvE,MAAM,MAAM,eAAe,CAAC,MAAM,EAAE,SAAS,SAAS,MAAM,MAAM,IAAI,MAAM,CAC1E,SAAS,EACT,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK,CAC/E,CAAC,SAAS,CAAC,CAAC;AAEb,4FAA4F;AAC5F,qBAAa,YAAY,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;;IAKhF;;;;;;OAMG;IACH,EAAE,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAMlG;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAYnG;;;;OAIG;IACH,IAAI,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAMpG;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,KAAK,SAAS,MAAM,UAAU,EACpC,KAAK,EAAE,KAAK,GACX,OAAO,CACR,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,GACpD,KAAK,GACL,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,GAC3C,IAAI,GACJ,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CACzC;IAoBD,SAAS,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,UAAU,EAC5C,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,EAC9B,KAAK,EAAE,KAAK,EACZ,GAAG,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC;IAW7C,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,UAAU,GAAG,OAAO;CAIzD"}

package/lib/EventEmitter.d.ts

@@ -1,7 +1,8 @@
+/** The listener callback associated with one event name in an event map. */
 type EventListener<Events, EventType extends keyof Events> = Events[EventType];
-export type EventParameters<Events, EventType extends keyof Events> = {
-    [Event in EventType]: EventListener<Events, EventType> extends (...args: infer P) => any ? P : never;
-}[EventType];
+/** The positional listener arguments associated with a named event. */
+export type EventParameters<Events, EventType extends keyof Events> = Record<EventType, EventListener<Events, EventType> extends (...args: infer P) => any ? P : never>[EventType];
+/** A lightweight event emitter with type-safe listeners and promise-based event waiting. */
 export declare class EventEmitter<EventTypes extends Record<string, (...args: any) => any>> {
     #private;
     /**
@@ -29,9 +30,11 @@ export declare class EventEmitter<EventTypes extends Record<string, (...args: an
     /**
      * This is similar to `.once()`, but returns a Promise that resolves the next time
      * the event is triggered, instead of calling a listener callback.
-     * @returns a Promise that resolves the next time given event is triggered,
-     * or rejects if an error is emitted.  (If you request the 'error' event,
-     * returns a promise that resolves with the error).
+     * Events without arguments resolve to `undefined`, single-argument events resolve
+     * to that argument, and events with multiple arguments resolve to an argument tuple.
+     *
+     * @returns A promise for the next event, or a rejection if an error occurs first.
+     * Requesting the `error` event resolves with the emitted error instead.
      *
      * Example:
      *

package/lib/EventEmitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../src/lib/EventEmitter.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,CAAC,MAAM,EAAE,SAAS,SAAS,MAAM,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;AAO/E,MAAM,MAAM,eAAe,CAAC,MAAM,EAAE,SAAS,SAAS,MAAM,MAAM,IAAI;KACnE,KAAK,IAAI,SAAS,GAAG,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK;CACrG,CAAC,SAAS,CAAC,CAAC;AAEb,qBAAa,YAAY,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;;IAKhF;;;;;;OAMG;IACH,EAAE,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAOlG;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAQnG;;;;OAIG;IACH,IAAI,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAOpG;;;;;;;;;;OAUG;IACH,OAAO,CAAC,KAAK,SAAS,MAAM,UAAU,EACpC,KAAK,EAAE,KAAK,GACX,OAAO,CACR,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,GAAG,KAAK,GAC9D,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,GACpD,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CACrC;IAgBD,SAAS,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,UAAU,EAC5C,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,EAC9B,KAAK,EAAE,KAAK,EACZ,GAAG,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC;IAS7C,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,UAAU,GAAG,OAAO;CAIzD"}
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../src/lib/EventEmitter.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,KAAK,aAAa,CAAC,MAAM,EAAE,SAAS,SAAS,MAAM,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;AAO/E,uEAAuE;AACvE,MAAM,MAAM,eAAe,CAAC,MAAM,EAAE,SAAS,SAAS,MAAM,MAAM,IAAI,MAAM,CAC1E,SAAS,EACT,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK,CAC/E,CAAC,SAAS,CAAC,CAAC;AAEb,4FAA4F;AAC5F,qBAAa,YAAY,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;;IAKhF;;;;;;OAMG;IACH,EAAE,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAMlG;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAYnG;;;;OAIG;IACH,IAAI,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IAMpG;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,KAAK,SAAS,MAAM,UAAU,EACpC,KAAK,EAAE,KAAK,GACX,OAAO,CACR,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,GACpD,KAAK,GACL,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,GAC3C,IAAI,GACJ,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CACzC;IAoBD,SAAS,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,UAAU,EAC5C,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,EAC9B,KAAK,EAAE,KAAK,EACZ,GAAG,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC;IAW7C,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,UAAU,GAAG,OAAO;CAIzD"}

package/lib/EventEmitter.js

@@ -3,9 +3,10 @@ var _EventEmitter_listeners;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventEmitter = void 0;
 const tslib_1 = require("../internal/tslib.js");
+/** A lightweight event emitter with type-safe listeners and promise-based event waiting. */
 class EventEmitter {
     constructor() {
-        _EventEmitter_listeners.set(this, {});
+        _EventEmitter_listeners.set(this, Object.create(null));
     }
     /**
      * Adds the listener function to the end of the listeners array for the event.
@@ -15,7 +16,8 @@ class EventEmitter {
      * @returns this, so that calls can be chained
      */
     on(event, listener) {
-        const listeners = tslib_1.__classPrivateFieldGet(this, _EventEmitter_listeners, "f")[event] || (tslib_1.__classPrivateFieldGet(this, _EventEmitter_listeners, "f")[event] = []);
+        var _a;
+        const listeners = ((_a = tslib_1.__classPrivateFieldGet(this, _EventEmitter_listeners, "f"))[event] || (_a[event] = []));
         listeners.push({ listener });
         return this;
     }
@@ -28,11 +30,13 @@ class EventEmitter {
      */
     off(event, listener) {
         const listeners = tslib_1.__classPrivateFieldGet(this, _EventEmitter_listeners, "f")[event];
-        if (!listeners)
+        if (!listeners) {
             return this;
+        }
         const index = listeners.findIndex((l) => l.listener === listener);
-        if (index >= 0)
+        if (index !== -1) {
             listeners.splice(index, 1);
+        }
         return this;
     }
     /**
@@ -41,16 +45,19 @@ class EventEmitter {
      * @returns this, so that calls can be chained
      */
     once(event, listener) {
-        const listeners = tslib_1.__classPrivateFieldGet(this, _EventEmitter_listeners, "f")[event] || (tslib_1.__classPrivateFieldGet(this, _EventEmitter_listeners, "f")[event] = []);
+        var _a;
+        const listeners = ((_a = tslib_1.__classPrivateFieldGet(this, _EventEmitter_listeners, "f"))[event] || (_a[event] = []));
         listeners.push({ listener, once: true });
         return this;
     }
     /**
      * This is similar to `.once()`, but returns a Promise that resolves the next time
      * the event is triggered, instead of calling a listener callback.
-     * @returns a Promise that resolves the next time given event is triggered,
-     * or rejects if an error is emitted.  (If you request the 'error' event,
-     * returns a promise that resolves with the error).
+     * Events without arguments resolve to `undefined`, single-argument events resolve
+     * to that argument, and events with multiple arguments resolve to an argument tuple.
+     *
+     * @returns A promise for the next event, or a rejection if an error occurs first.
+     * Requesting the `error` event resolves with the emitted error instead.
      *
      * Example:
      *
@@ -62,13 +69,15 @@ class EventEmitter {
                 this.off(event, onEvent);
                 reject(error);
             };
-            const onEvent = (value) => {
-                if (event !== 'error')
+            const onEvent = (...values) => {
+                if (event !== 'error') {
                     this.off('error', onError);
-                resolve(value);
+                }
+                resolve((values.length > 1 ? values : values[0]));
             };
-            if (event !== 'error')
+            if (event !== 'error') {
                 this.once('error', onError);
+            }
             this.once(event, onEvent);
         });
     }
@@ -76,7 +85,9 @@ class EventEmitter {
         const listeners = tslib_1.__classPrivateFieldGet(this, _EventEmitter_listeners, "f")[event];
         if (listeners) {
             tslib_1.__classPrivateFieldGet(this, _EventEmitter_listeners, "f")[event] = listeners.filter((l) => !l.once);
-            listeners.forEach(({ listener }) => listener(...args));
+            for (const { listener } of listeners) {
+                listener(...args);
+            }
         }
     }
     _hasListener(event) {

package/lib/EventEmitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"EventEmitter.js","sourceRoot":"","sources":["../src/lib/EventEmitter.ts"],"names":[],"mappings":";;;;;AAWA,MAAa,YAAY;IAAzB;QACE,kCAEI,EAAE,EAAC;IA4FT,CAAC;IA1FC;;;;;;OAMG;IACH,EAAE,CAAiC,KAAY,EAAE,QAA0C;QACzF,MAAM,SAAS,GACb,+BAAA,IAAI,+BAAW,CAAC,KAAK,CAAC,IAAI,CAAC,+BAAA,IAAI,+BAAW,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1D,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAiC,KAAY,EAAE,QAA0C;QAC1F,MAAM,SAAS,GAAG,+BAAA,IAAI,+BAAW,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAClE,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAiC,KAAY,EAAE,QAA0C;QAC3F,MAAM,SAAS,GACb,+BAAA,IAAI,+BAAW,CAAC,KAAK,CAAC,IAAI,CAAC,+BAAA,IAAI,+BAAW,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1D,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACH,OAAO,CACL,KAAY;QAMZ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE;gBACjC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAc,CAAC,CAAC;gBAChC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE;gBACjC,IAAI,KAAK,KAAK,OAAO;oBAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAc,CAAC,CAAC;gBACzD,OAAO,CAAC,KAAY,CAAC,CAAC;YACxB,CAAC,CAAC;YAEF,IAAI,KAAK,KAAK,OAAO;gBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAc,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAc,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IAES,KAAK,CAEb,KAAY,EACZ,GAAG,IAAwC;QAE3C,MAAM,SAAS,GAAkD,+BAAA,IAAI,+BAAW,CAAC,KAAK,CAAC,CAAC;QACxF,IAAI,SAAS,EAAE,CAAC;YACd,+BAAA,IAAI,+BAAW,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAQ,CAAC;YACjE,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAI,IAAY,CAAC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAES,YAAY,CAAC,KAAuB;QAC5C,MAAM,SAAS,GAAG,+BAAA,IAAI,+BAAW,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3C,CAAC;CACF;AA/FD,oCA+FC"}
+{"version":3,"file":"EventEmitter.js","sourceRoot":"","sources":["../src/lib/EventEmitter.ts"],"names":[],"mappings":"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"}