@prestyj/ai 4.2.77 → 4.3.34

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-type Provider = "anthropic" | "openai" | "glm" | "moonshot" | "palsu";
+type Provider = "anthropic" | "xiaomi" | "openai" | "glm" | "moonshot" | "minimax" | "openrouter" | "palsu";
 type ThinkingLevel = "low" | "medium" | "high" | "max";
 type CacheRetention = "none" | "short" | "long";
 interface TextContent {
@@ -119,7 +119,10 @@ interface ServerToolResultEvent {
     resultType: string;
     data: unknown;
 }
-type StreamEvent = TextDeltaEvent | ThinkingDeltaEvent | ToolCallDeltaEvent | ToolCallDoneEvent | ServerToolCallEvent | ServerToolResultEvent | DoneEvent | ErrorEvent;
+interface KeepaliveEvent {
+    type: "keepalive";
+}
+type StreamEvent = TextDeltaEvent | ThinkingDeltaEvent | ToolCallDeltaEvent | ToolCallDoneEvent | ServerToolCallEvent | ServerToolResultEvent | DoneEvent | ErrorEvent | KeepaliveEvent;
 type StopReason = "end_turn" | "tool_use" | "max_tokens" | "pause_turn" | "stop_sequence" | "refusal" | "error";
 interface StreamResponse {
     message: AssistantMessage;
@@ -171,6 +174,12 @@ interface StreamOptions {
      *  where the default `globalThis.fetch` doesn't support streaming properly.
      *  Passed directly to the underlying provider SDK. */
     fetch?: typeof globalThis.fetch;
+    /** Use streaming transport (default: true). When false, providers issue a
+     *  single non-streaming request and synthesize events from the full response.
+     *  The agent loop flips this to `false` as a fallback after repeated stream
+     *  stalls — broken SSE connections (transient CDN / proxy issues) often
+     *  recover when the same request is issued over a plain HTTP request/response. */
+    streaming?: boolean;
 }
 
 /**
@@ -189,25 +198,29 @@ declare class EventStream<T = StreamEvent> implements AsyncIterable<T> {
     [Symbol.asyncIterator](): AsyncIterator<T>;
 }
 /**
- * Wraps EventStream and adds a `.response` promise that resolves
- * to the final StreamResponse. Also implements thenable so:
+ * Pull-based stream result. Wraps an async generator that yields
+ * StreamEvents and returns a StreamResponse. Also thenable so:
  *
  *   const msg = await stream({...})          // awaits response
  *   for await (const e of stream({...})) {}  // iterates events
+ *
+ * The generator is pumped eagerly — events flow into an internal
+ * buffer regardless of whether a consumer is iterating. This avoids
+ * the push-based EventStream's stall bugs (lost wakeups, single
+ * resolve field, iterator starvation).
  */
 declare class StreamResult implements AsyncIterable<StreamEvent> {
-    readonly events: EventStream<StreamEvent>;
     readonly response: Promise<StreamResponse>;
+    private buffer;
+    private done;
+    private error;
     private resolveResponse;
     private rejectResponse;
-    private hasConsumer;
-    constructor();
-    push(event: StreamEvent): void;
-    complete(response: StreamResponse): void;
-    abort(error: Error): void;
+    private resolveWait;
+    constructor(generator: AsyncGenerator<StreamEvent, StreamResponse>);
+    private pump;
     [Symbol.asyncIterator](): AsyncIterator<StreamEvent>;
     then<TResult1 = StreamResponse, TResult2 = never>(onfulfilled?: ((value: StreamResponse) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
-    private drainEvents;
 }
 
 /**

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-type Provider = "anthropic" | "openai" | "glm" | "moonshot" | "palsu";
+type Provider = "anthropic" | "xiaomi" | "openai" | "glm" | "moonshot" | "minimax" | "openrouter" | "palsu";
 type ThinkingLevel = "low" | "medium" | "high" | "max";
 type CacheRetention = "none" | "short" | "long";
 interface TextContent {
@@ -119,7 +119,10 @@ interface ServerToolResultEvent {
     resultType: string;
     data: unknown;
 }
-type StreamEvent = TextDeltaEvent | ThinkingDeltaEvent | ToolCallDeltaEvent | ToolCallDoneEvent | ServerToolCallEvent | ServerToolResultEvent | DoneEvent | ErrorEvent;
+interface KeepaliveEvent {
+    type: "keepalive";
+}
+type StreamEvent = TextDeltaEvent | ThinkingDeltaEvent | ToolCallDeltaEvent | ToolCallDoneEvent | ServerToolCallEvent | ServerToolResultEvent | DoneEvent | ErrorEvent | KeepaliveEvent;
 type StopReason = "end_turn" | "tool_use" | "max_tokens" | "pause_turn" | "stop_sequence" | "refusal" | "error";
 interface StreamResponse {
     message: AssistantMessage;
@@ -171,6 +174,12 @@ interface StreamOptions {
      *  where the default `globalThis.fetch` doesn't support streaming properly.
      *  Passed directly to the underlying provider SDK. */
     fetch?: typeof globalThis.fetch;
+    /** Use streaming transport (default: true). When false, providers issue a
+     *  single non-streaming request and synthesize events from the full response.
+     *  The agent loop flips this to `false` as a fallback after repeated stream
+     *  stalls — broken SSE connections (transient CDN / proxy issues) often
+     *  recover when the same request is issued over a plain HTTP request/response. */
+    streaming?: boolean;
 }
 
 /**
@@ -189,25 +198,29 @@ declare class EventStream<T = StreamEvent> implements AsyncIterable<T> {
     [Symbol.asyncIterator](): AsyncIterator<T>;
 }
 /**
- * Wraps EventStream and adds a `.response` promise that resolves
- * to the final StreamResponse. Also implements thenable so:
+ * Pull-based stream result. Wraps an async generator that yields
+ * StreamEvents and returns a StreamResponse. Also thenable so:
  *
  *   const msg = await stream({...})          // awaits response
  *   for await (const e of stream({...})) {}  // iterates events
+ *
+ * The generator is pumped eagerly — events flow into an internal
+ * buffer regardless of whether a consumer is iterating. This avoids
+ * the push-based EventStream's stall bugs (lost wakeups, single
+ * resolve field, iterator starvation).
  */
 declare class StreamResult implements AsyncIterable<StreamEvent> {
-    readonly events: EventStream<StreamEvent>;
     readonly response: Promise<StreamResponse>;
+    private buffer;
+    private done;
+    private error;
     private resolveResponse;
     private rejectResponse;
-    private hasConsumer;
-    constructor();
-    push(event: StreamEvent): void;
-    complete(response: StreamResponse): void;
-    abort(error: Error): void;
+    private resolveWait;
+    constructor(generator: AsyncGenerator<StreamEvent, StreamResponse>);
+    private pump;
     [Symbol.asyncIterator](): AsyncIterator<StreamEvent>;
     then<TResult1 = StreamResponse, TResult2 = never>(onfulfilled?: ((value: StreamResponse) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
-    private drainEvents;
 }
 
 /**