@agentuity/stream 3.0.11 → 3.1.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { StreamStorageService, StreamStorage, Stream, type CreateStreamProps, type ListStreamsParams, type ListStreamsResponse, type StreamInfo, type StreamSortField, STREAM_MIN_TTL_SECONDS, STREAM_MAX_TTL_SECONDS, STREAM_DEFAULT_TTL_SECONDS, CreateStreamPropsSchema, ListStreamsParamsSchema, ListStreamsResponseSchema, StreamInfoSchema, StreamSortFieldSchema, } from '@agentuity/core/stream';
-import { type CreateStreamProps, type ListStreamsParams, type ListStreamsResponse, type StreamInfo, type Stream } from '@agentuity/core/stream';
-import { type Logger } from '@agentuity/adapter';
+export * from './service.ts';
+import { type CreateStreamProps, type ListStreamsParams, type ListStreamsResponse, type StreamInfo, type Stream } from './service.ts';
+import { type Logger } from '@agentuity/client';
 import { z } from 'zod';
 export declare const StreamClientOptionsSchema: z.ZodObject<{
     apiKey: z.ZodOptional<z.ZodString>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,aAAa,EACb,MAAM,EACN,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAEN,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,MAAM,EACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAgD,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAI/F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,qBAAa,YAAY;;gBAGZ,OAAO,GAAE,mBAAwB;IAoB7C;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3E;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1C;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAI/D;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIpE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,OAAO,EAEN,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,MAAM,EACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EAMN,KAAK,MAAM,EACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,qBAAa,YAAY;;gBAGZ,OAAO,GAAE,mBAAwB;IAgB7C;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3E;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1C;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAI/D;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIpE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvC"}

package/dist/index.js

@@ -1,13 +1,8 @@
-export { StreamStorageService, STREAM_MIN_TTL_SECONDS, STREAM_MAX_TTL_SECONDS, STREAM_DEFAULT_TTL_SECONDS, CreateStreamPropsSchema, ListStreamsParamsSchema, ListStreamsResponseSchema, StreamInfoSchema, StreamSortFieldSchema, } from '@agentuity/core/stream';
-import { StreamStorageService, } from '@agentuity/core/stream';
-import { createServerFetchAdapter, buildClientHeaders } from '@agentuity/adapter';
-import { createMinimalLogger } from '@agentuity/core';
-import { getEnv } from '@agentuity/core';
-import { getServiceUrls } from '@agentuity/core/config';
+export * from "./service.js";
+import { StreamStorageService, } from "./service.js";
+import { getServiceUrls } from '@agentuity/config';
+import { createServiceAdapter, isLogger, resolveApiKey, resolveRegion, resolveServiceUrl, } from '@agentuity/client';
 import { z } from 'zod';
-const isLogger = (val) => typeof val === 'object' &&
-    val !== null &&
-    ['info', 'warn', 'error', 'debug', 'trace'].every((m) => typeof val[m] === 'function');
 export const StreamClientOptionsSchema = z.object({
     apiKey: z.string().optional().describe('API key for authentication'),
     url: z.string().optional().describe('Base URL for the Stream API'),
@@ -18,16 +13,17 @@ export class StreamClient {
     #service;
     constructor(options = {}) {
         const validatedOptions = StreamClientOptionsSchema.parse(options);
-        const apiKey = validatedOptions.apiKey || getEnv('AGENTUITY_SDK_KEY') || getEnv('AGENTUITY_CLI_KEY');
-        const region = getEnv('AGENTUITY_REGION') ?? 'usc';
-        const serviceUrls = getServiceUrls(region);
-        const url = validatedOptions.url || getEnv('AGENTUITY_STREAM_URL') || serviceUrls.stream;
-        const logger = validatedOptions.logger ?? createMinimalLogger();
-        const headers = buildClientHeaders({
-            apiKey,
+        const serviceUrls = getServiceUrls(resolveRegion());
+        const url = resolveServiceUrl({
+            url: validatedOptions.url,
+            envKey: 'AGENTUITY_STREAM_URL',
+            fallback: serviceUrls.stream,
+        });
+        const { adapter } = createServiceAdapter({
+            apiKey: resolveApiKey(validatedOptions.apiKey),
             orgId: validatedOptions.orgId,
+            logger: validatedOptions.logger,
         });
-        const adapter = createServerFetchAdapter({ headers }, logger);
         this.#service = new StreamStorageService(url, adapter);
     }
     /**

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EAQpB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACN,oBAAoB,GAMpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAe,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,QAAQ,GAAG,CAAC,GAAY,EAAiB,EAAE,CAChD,OAAO,GAAG,KAAK,QAAQ;IACvB,GAAG,KAAK,IAAI;IACZ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAChD,CAAC,CAAC,EAAE,EAAE,CAAC,OAAQ,GAA+B,CAAC,CAAC,CAAC,KAAK,UAAU,CAChE,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACpE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACpF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAS,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CAChF,CAAC,CAAC;AAGH,MAAM,OAAO,YAAY;IACf,QAAQ,CAAuB;IAExC,YAAY,UAA+B,EAAE;QAC5C,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,MAAM,GACX,gBAAgB,CAAC,MAAM,IAAI,MAAM,CAAC,mBAAmB,CAAC,IAAI,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC;QACnD,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAE3C,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,IAAI,MAAM,CAAC,sBAAsB,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC;QAEzF,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAEhE,MAAM,OAAO,GAAG,kBAAkB,CAAC;YAClC,MAAM;YACN,KAAK,EAAE,gBAAgB,CAAC,KAAK;SAC7B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,wBAAwB,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,KAAyB;QACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAU;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAA0B;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;CACD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,OAAO,EACN,oBAAoB,GAMpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACN,oBAAoB,EACpB,QAAQ,EACR,aAAa,EACb,aAAa,EACb,iBAAiB,GAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACpE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACpF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAS,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CAChF,CAAC,CAAC;AAGH,MAAM,OAAO,YAAY;IACf,QAAQ,CAAuB;IAExC,YAAY,UAA+B,EAAE;QAC5C,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,WAAW,GAAG,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,iBAAiB,CAAC;YAC7B,GAAG,EAAE,gBAAgB,CAAC,GAAG;YACzB,MAAM,EAAE,sBAAsB;YAC9B,QAAQ,EAAE,WAAW,CAAC,MAAM;SAC5B,CAAC,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,CAAC;YACxC,MAAM,EAAE,aAAa,CAAC,gBAAgB,CAAC,MAAM,CAAC;YAC9C,KAAK,EAAE,gBAAgB,CAAC,KAAK;YAC7B,MAAM,EAAE,gBAAgB,CAAC,MAAM;SAC/B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,KAAyB;QACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAU;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAA0B;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;CACD"}

package/dist/service.d.ts

@@ -0,0 +1,264 @@
+import type { FetchAdapter } from '@agentuity/adapter';
+import { z } from 'zod';
+/**
+ * Minimum TTL value in seconds (1 minute)
+ */
+export declare const STREAM_MIN_TTL_SECONDS = 60;
+/**
+ * Maximum TTL value in seconds (90 days)
+ */
+export declare const STREAM_MAX_TTL_SECONDS = 7776000;
+/**
+ * Default TTL value in seconds (30 days) - used when no TTL is specified
+ */
+export declare const STREAM_DEFAULT_TTL_SECONDS = 2592000;
+/**
+ * Properties for creating a stream
+ */
+export declare const CreateStreamPropsSchema: z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    contentType: z.ZodOptional<z.ZodString>;
+    compress: z.ZodOptional<z.ZodLiteral<true>>;
+    ttl: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type CreateStreamProps = z.infer<typeof CreateStreamPropsSchema>;
+export declare const StreamSortFieldSchema: z.ZodEnum<{
+    name: "name";
+    created: "created";
+    updated: "updated";
+    size: "size";
+    count: "count";
+    lastUsed: "lastUsed";
+}>;
+export type StreamSortField = z.infer<typeof StreamSortFieldSchema>;
+/**
+ * Parameters for listing streams.
+ *
+ * Note: If both `namespace` and `name` are provided, `namespace` takes precedence
+ * and `name` is ignored in the API request body.
+ */
+export declare const ListStreamsParamsSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        name: "name";
+        created: "created";
+        updated: "updated";
+        size: "size";
+        count: "count";
+        lastUsed: "lastUsed";
+    }>>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    namespace: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type ListStreamsParams = z.infer<typeof ListStreamsParamsSchema>;
+/**
+ * Stream information returned by list operation
+ */
+export declare const StreamInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    namespace: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+    url: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    expiresAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StreamInfo = z.infer<typeof StreamInfoSchema>;
+/**
+ * Response from listing streams
+ */
+export declare const ListStreamsResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    message: z.ZodOptional<z.ZodString>;
+    streams: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        namespace: z.ZodString;
+        metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+        url: z.ZodString;
+        sizeBytes: z.ZodNumber;
+        expiresAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type ListStreamsResponse = z.infer<typeof ListStreamsResponseSchema>;
+/**
+ * A durable and resumable stream that can be written to and read many times.
+ * The underlying stream is backed by a durable storage system and the URL
+ * returned is public and guaranteed to return the same data every time it is accessed.
+ * You can read from this stream internal in the agent using the getReader() method or
+ * return the URL to the stream to be used externally.
+ *
+ * You must write and close the stream before it can be read but if you attempt to read
+ * before any data is written, the reader will block until the first write occurs.
+ */
+export interface Stream extends WritableStream {
+    /**
+     * unique stream identifier
+     */
+    id: string;
+    /**
+     * the unique stream url to consume the stream
+     */
+    url: string;
+    /**
+     * the total number of bytes written to the stream
+     */
+    readonly bytesWritten: number;
+    /**
+     * whether the stream is using compression
+     */
+    readonly compressed: boolean;
+    /**
+     * Write data to the stream.
+     *
+     * Each write call can send up to 5MB of data. For larger payloads, split the data
+     * across multiple write calls.
+     *
+     * @param chunk - The data to write (string, binary, or object that will be JSON-serialized)
+     * @throws ServiceException with status 413 if chunk exceeds 5MB
+     */
+    write(chunk: string | Uint8Array | ArrayBuffer | object): Promise<void>;
+    /**
+     * close the stream gracefully, handling already closed streams without error
+     */
+    close(): Promise<void>;
+    /**
+     * get a ReadableStream that streams from the internal URL
+     *
+     * Note: This method will block waiting for data until writes start to the Stream.
+     * The returned ReadableStream will remain open until the Stream is closed or an error occurs.
+     *
+     * @returns a ReadableStream that can be passed to response.stream()
+     */
+    getReader(): ReadableStream<Uint8Array>;
+}
+/**
+ * Stream API for creating and managing durable, resumable data streams.
+ * Streams are backed by durable storage and provide public URLs for access.
+ */
+export interface StreamStorage {
+    /**
+     * Create a new stream for writing data that can be read multiple times
+     *
+     * @param namespace - the namespace of the stream (1-254 characters). Use namespaces to group and organize streams.
+     * @param props - optional properties including metadata, content type, compression, and TTL
+     * @returns a Promise that resolves to the created Stream
+     *
+     * @example
+     * ```typescript
+     * // Create a simple text stream (expires in 30 days by default)
+     * const stream = await streams.create('agent-logs');
+     * await stream.write('Starting agent execution\n');
+     * await stream.write('Processing data...\n');
+     * await stream.close();
+     * console.log('Stream URL:', stream.url);
+     *
+     * // Create a stream with custom TTL (expires in 1 hour)
+     * const tempStream = await streams.create('temp-data', {
+     *   ttl: 3600  // 1 hour in seconds
+     * });
+     *
+     * // Create a stream that never expires
+     * const permanentStream = await streams.create('permanent-data', {
+     *   ttl: null  // or ttl: 0
+     * });
+     *
+     * // Create a compressed JSON stream with metadata
+     * const dataStream = await streams.create('data-export', {
+     *   contentType: 'application/json',
+     *   compress: true,
+     *   metadata: { exportDate: '2024-01-15', version: '1.0' }
+     * });
+     * await dataStream.write({ records: [...] });
+     * await dataStream.close();
+     *
+     * // Read back from the stream
+     * const reader = dataStream.getReader();
+     * for await (const chunk of reader) {
+     *   console.log('Chunk:', chunk);
+     * }
+     * ```
+     */
+    create(namespace: string, props?: CreateStreamProps): Promise<Stream>;
+    /**
+     * Get stream metadata by ID
+     *
+     * @param id - the stream ID
+     * @returns a Promise that resolves to the stream information
+     *
+     * @example
+     * ```typescript
+     * const stream = await streams.get('stream_0199a52b06e3767dbe2f10afabb5e5e4');
+     * console.log(`Namespace: ${stream.namespace}, Size: ${stream.sizeBytes} bytes`);
+     * ```
+     */
+    get(id: string): Promise<StreamInfo>;
+    /**
+     * Download stream content
+     *
+     * @param id - the stream ID to download
+     * @returns a Promise that resolves to a ReadableStream of the content
+     *
+     * @example
+     * ```typescript
+     * const readable = await streams.download('stream_0199a52b06e3767dbe2f10afabb5e5e4');
+     * // Pipe to a file or process the stream
+     * ```
+     */
+    download(id: string): Promise<ReadableStream<Uint8Array>>;
+    /**
+     * List streams with optional filtering and pagination
+     *
+     * @param params - optional parameters for filtering and pagination
+     * @returns a Promise that resolves to the list of streams with metadata
+     *
+     * @example
+     * ```typescript
+     * // List all streams
+     * const all = await streams.list();
+     * console.log(`Found ${all.total} streams`);
+     *
+     * // Filter by namespace
+     * const logs = await streams.list({ namespace: 'agent-logs' });
+     *
+     * // Filter by metadata and paginate
+     * const filtered = await streams.list({
+     *   metadata: { type: 'export' },
+     *   limit: 50,
+     *   offset: 100
+     * });
+     *
+     * for (const stream of filtered.streams) {
+     *   console.log(`${stream.namespace}: ${stream.sizeBytes} bytes at ${stream.url}`);
+     * }
+     * ```
+     */
+    list(params?: ListStreamsParams): Promise<ListStreamsResponse>;
+    /**
+     * Delete a stream by its ID
+     *
+     * @param id - the stream ID to delete
+     * @returns a Promise that resolves when the stream is deleted
+     *
+     * @example
+     * ```typescript
+     * await streams.delete('stream-id-123');
+     * ```
+     */
+    delete(id: string): Promise<void>;
+}
+export declare class StreamStorageService implements StreamStorage {
+    #private;
+    constructor(baseUrl: string, adapter: FetchAdapter);
+    create(namespace: string, props?: CreateStreamProps): Promise<Stream>;
+    list(params?: ListStreamsParams): Promise<ListStreamsResponse>;
+    get(id: string): Promise<StreamInfo>;
+    download(id: string): Promise<ReadableStream<Uint8Array>>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}