@providerprotocol/ai 0.0.34 → 0.0.36

package/dist/types-CE4B7pno.d.ts

@@ -0,0 +1,96 @@
+import { S as StreamEvent } from './stream-S7nwQRqM.js';
+
+/**
+ * @fileoverview Pub-sub middleware types for stream resumption.
+ *
+ * Defines interfaces for temporary stream storage, replay, and
+ * multi-client broadcast during active generation.
+ *
+ * @module middleware/pubsub/types
+ */
+
+/**
+ * Stored stream state (in-flight only).
+ */
+interface StoredStream {
+    readonly streamId: string;
+    readonly createdAt: number;
+    readonly events: readonly StreamEvent[];
+}
+/**
+ * Subscription callback for live events.
+ *
+ * @param event - Stream event payload
+ * @param cursor - Zero-based event index when adapter supports cursors
+ */
+type SubscriptionCallback = (event: StreamEvent, cursor?: number) => void;
+/**
+ * Completion callback when stream ends.
+ *
+ * Adapters should invoke this when {@link PubSubAdapter.remove} is called
+ * so subscriber streams can terminate before the stream is deleted.
+ */
+type CompletionCallback = () => void;
+/**
+ * Unsubscribe function returned by subscribe.
+ */
+type Unsubscribe = () => void;
+/**
+ * Storage adapter interface for pub-sub middleware.
+ *
+ * Stores in-flight streams only. Completed streams are removed immediately.
+ * Apps should persist completed conversations via `.then()` and serve from
+ * their own storage on reconnect.
+ */
+interface PubSubAdapter {
+    /**
+     * Checks if a stream exists.
+     */
+    exists(streamId: string): Promise<boolean>;
+    /**
+     * Appends an event to the stream (creates lazily if needed).
+     */
+    append(streamId: string, event: StreamEvent): Promise<void>;
+    /**
+     * Fetches all events for replay.
+     */
+    getEvents(streamId: string): Promise<StreamEvent[]>;
+    /**
+     * Subscribes to live events (creates lazily if needed).
+     */
+    subscribe(streamId: string, onEvent: SubscriptionCallback, onComplete: CompletionCallback): Unsubscribe;
+    /**
+     * Publishes event to all subscribers.
+     */
+    publish(streamId: string, event: StreamEvent): void;
+    /**
+     * Notifies subscribers and removes stream from storage.
+     */
+    remove(streamId: string): Promise<void>;
+}
+/**
+ * Options for pub-sub middleware.
+ */
+interface PubSubOptions {
+    /**
+     * Storage adapter instance.
+     * @default memoryAdapter()
+     */
+    adapter?: PubSubAdapter;
+    /**
+     * Stream identifier for pub-sub behavior.
+     */
+    streamId?: string;
+}
+/**
+ * Options for memory adapter.
+ */
+interface MemoryAdapterOptions {
+    /**
+     * Max concurrent streams allowed. Throws if exceeded.
+     * @default 1000
+     */
+    maxStreams?: number;
+}
+
+export type { CompletionCallback as C, MemoryAdapterOptions as M, PubSubAdapter as P, StoredStream as S, Unsubscribe as U, PubSubOptions as a, SubscriptionCallback as b };

package/dist/utils/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Partial JSON parser for streaming LLM responses.
+ *
+ * Enables incremental parsing of JSON data as it streams from LLM providers,
+ * allowing consumers to access usable partial objects during streaming rather
+ * than waiting for complete JSON.
+ *
+ * @module utils/partial-json
+ */
+/**
+ * Result of parsing partial JSON.
+ *
+ * @typeParam T - The expected type of the parsed value
+ */
+interface PartialParseResult<T = unknown> {
+    /** The parsed value, or undefined if parsing failed */
+    value: T | undefined;
+    /** Whether the JSON was complete and valid */
+    isComplete: boolean;
+}
+/**
+ * Parses potentially incomplete JSON, returning as much as can be extracted.
+ *
+ * Handles common incomplete states during streaming:
+ * - Incomplete strings: `{"name":"Jo` → `{name: "Jo"}`
+ * - Incomplete objects: `{"a":1,"b":` → `{a: 1}`
+ * - Incomplete arrays: `[1,2,` → `[1, 2]`
+ * - Incomplete numbers, booleans, null literals
+ * - Nested structures with partial completion
+ * - Unicode escape sequences
+ *
+ * @typeParam T - The expected type of the parsed value
+ * @param json - The potentially incomplete JSON string
+ * @returns A PartialParseResult with the parsed value and completion status
+ *
+ * @example
+ * ```typescript
+ * // Complete JSON
+ * parsePartialJson('{"name":"John"}');
+ * // => { value: { name: "John" }, isComplete: true }
+ *
+ * // Incomplete object
+ * parsePartialJson('{"user":{"firstName":"Jo');
+ * // => { value: { user: { firstName: "Jo" } }, isComplete: false }
+ *
+ * // Incomplete array
+ * parsePartialJson('[1, 2, 3');
+ * // => { value: [1, 2, 3], isComplete: false }
+ * ```
+ */
+declare function parsePartialJson<T = unknown>(json: string): PartialParseResult<T>;
+
+export { type PartialParseResult, parsePartialJson };

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+import {
+  parsePartialJson
+} from "../chunk-I53CI6ZZ.js";
+export {
+  parsePartialJson
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/xai/index.d.ts

@@ -1,4 +1,5 @@
-import { P as Provider } from '../llm-BQJZj3cD.js';
+import { d as Provider } from '../llm-ByUFPcFH.js';
+import '../stream-S7nwQRqM.js';
 
 /**
  * xAI Chat Completions API parameters (OpenAI-compatible).