@ably/ai-transport 0.0.1

package/dist/vercel/codec/accumulator.d.ts

@@ -0,0 +1,21 @@
+import { MessageAccumulator } from '../../core/codec/types.js';
+/**
+ * Vercel AI SDK Message Accumulator
+ *
+ * Builds and maintains a UIMessage[] list from decoder outputs.
+ * Implements MessageAccumulator<UIMessageChunk, UIMessage>.
+ *
+ * The accumulator consumes DecoderOutput[] from the decoder and groups
+ * streaming events into UIMessage objects using lifecycle boundaries
+ * (start/finish). Complete messages (from writeMessages) are inserted
+ * directly.
+ *
+ * Multiple messages can be in-progress concurrently — each is identified
+ * by the `messageId` field on DecoderOutput (read from x-ably-msg-id).
+ */
+import type * as AI from 'ai';
+/**
+ * Create a Vercel AI SDK accumulator that builds UIMessage[] from decoder outputs.
+ * @returns A {@link MessageAccumulator} for UIMessageChunk/UIMessage.
+ */
+export declare const createAccumulator: () => MessageAccumulator<AI.UIMessageChunk, AI.UIMessage>;

package/dist/vercel/codec/decoder.d.ts

@@ -0,0 +1,22 @@
+import { DecoderCoreOptions } from '../../core/codec/decoder.js';
+import { StreamDecoder } from '../../core/codec/types.js';
+/**
+ * Vercel AI SDK Decoder
+ *
+ * Maps Ably inbound messages to DecoderOutput<UIMessageChunk, UIMessage>[].
+ *
+ * Delegates action dispatch and serial tracking to the decoder core.
+ * This file contains only the Vercel-specific event building, discrete
+ * event decoding, and synthetic event emission.
+ *
+ * Domain-specific headers use the `x-domain-` prefix. Transport-level
+ * headers use the `x-ably-` prefix.
+ */
+import type * as AI from 'ai';
+/**
+ * Create a Vercel AI SDK decoder that maps Ably messages to UIMessageChunk
+ * events and UIMessage objects via the decoder core.
+ * @param options - Decoder configuration (callbacks, logger).
+ * @returns A {@link StreamDecoder} for UIMessageChunk/UIMessage.
+ */
+export declare const createDecoder: (options?: DecoderCoreOptions) => StreamDecoder<AI.UIMessageChunk, AI.UIMessage>;

package/dist/vercel/codec/encoder.d.ts

@@ -0,0 +1,41 @@
+import { EncoderCoreOptions } from '../../core/codec/encoder.js';
+import { ChannelWriter, StreamEncoder } from '../../core/codec/types.js';
+/**
+ * Vercel AI SDK Encoder
+ *
+ * Maps UIMessageChunk events and complete UIMessage objects to Ably channel
+ * operations (publish, appendMessage, updateMessage).
+ *
+ * Delegates the message append lifecycle (publish, append, close, abort,
+ * flush/recover) to the encoder core. This file contains only the
+ * Vercel-specific event-to-operation mapping.
+ *
+ * Domain-specific headers use the `x-domain-` prefix to distinguish them
+ * from transport-level `x-ably-` headers.
+ *
+ * ## Core operations and domain headers
+ *
+ * Each UIMessageChunk maps to exactly one encoder core operation. Domain
+ * headers are passed to every operation that accepts them — the core handles
+ * merging, persistence, and deduplication:
+ *
+ * - **`startStream`**: Opens a message stream. Domain headers become
+ *   "persistent headers" — the core repeats them on every subsequent append.
+ * - **`appendStream`**: Appends a text delta. Data only, no headers parameter.
+ *   The core automatically carries persistent headers from start.
+ * - **`closeStream`**: Closes the stream. Pass all domain headers from the
+ *   chunk — the core merges them on top of persistent headers, so changed
+ *   values (e.g. updated providerMetadata) are picked up and unchanged
+ *   values are harmlessly deduplicated.
+ * - **`publishDiscrete`**: Publishes a standalone message. All domain headers
+ *   for the chunk are passed directly.
+ */
+import type * as AI from 'ai';
+/**
+ * Create a Vercel AI SDK encoder that maps UIMessageChunk events to Ably
+ * channel operations via the encoder core.
+ * @param writer - The channel writer to publish messages through.
+ * @param options - Encoder configuration (clientId, extras, hooks, logger).
+ * @returns A {@link StreamEncoder} for UIMessageChunk/UIMessage.
+ */
+export declare const createEncoder: (writer: ChannelWriter, options?: EncoderCoreOptions) => StreamEncoder<AI.UIMessageChunk, AI.UIMessage>;

package/dist/vercel/codec/index.d.ts

@@ -0,0 +1,22 @@
+import { Codec } from '../../core/codec/types.js';
+/**
+ * Vercel AI SDK codec — maps UIMessageChunk events and UIMessage objects
+ * to/from native Ably message primitives (publish, append, update, delete).
+ *
+ * ```ts
+ * import { UIMessageCodec } from '@ably/ai-transport/vercel';
+ *
+ * const encoder = UIMessageCodec.createEncoder(writer, options);
+ * const decoder = UIMessageCodec.createDecoder();
+ * const accumulator = UIMessageCodec.createAccumulator();
+ * ```
+ */
+import type * as AI from 'ai';
+/**
+ * Vercel AI SDK codec implementing `Codec<UIMessageChunk, UIMessage>`.
+ *
+ * Provides factory methods for creating encoders, decoders, and accumulators
+ * that map between Vercel's UIMessageChunk/UIMessage types and Ably's native
+ * message primitives.
+ */
+export declare const UIMessageCodec: Codec<AI.UIMessageChunk, AI.UIMessage>;

package/dist/vercel/index.d.ts

@@ -0,0 +1,3 @@
+export { UIMessageCodec } from './codec/index.js';
+export type { ChatTransport, ChatTransportOptions, SendMessagesRequestContext, VercelClientTransportOptions, VercelServerTransportOptions, } from './transport/index.js';
+export { createChatTransport, createClientTransport, createServerTransport } from './transport/index.js';