@agentuity/core 0.0.1

package/dist/json.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Safely stringify an object to JSON, handling circular references
+ * @param obj - The object to stringify
+ * @returns JSON string representation
+ */
+export declare function safeStringify(obj: unknown): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAoBlD"}

package/dist/services/_util.d.ts

@@ -0,0 +1,7 @@
+import { Body } from './adapter';
+import { ServiceException } from './exception';
+export declare const buildUrl: (base: string, path: string, subpath?: string, query?: URLSearchParams) => string;
+export declare function toServiceException(response: Response): Promise<ServiceException>;
+export declare function toPayload(data: unknown): Promise<[Body, string]>;
+export declare function fromResponse<T>(response: Response): Promise<T>;
+//# sourceMappingURL=_util.d.ts.map

package/dist/services/_util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_util.d.ts","sourceRoot":"","sources":["../../src/services/_util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,QAAQ,GACpB,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,UAAU,MAAM,EAChB,QAAQ,eAAe,KACrB,MAWF,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgCtF;AAMD,wBAAsB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CA0CtE;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAYpE"}

package/dist/services/adapter.d.ts

@@ -0,0 +1,29 @@
+export interface FetchSuccessResponse<TData> {
+    ok: true;
+    data: TData;
+    response: Response;
+}
+export interface FetchErrorResponse {
+    ok: false;
+    data: never;
+    response: Response;
+}
+export type FetchResponse<T> = FetchErrorResponse | FetchSuccessResponse<T>;
+export type Body = string | Buffer | ArrayBuffer | ReadableStream;
+export interface FetchRequest {
+    method: 'GET' | 'PUT' | 'POST' | 'DELETE';
+    body?: Body;
+    signal?: AbortSignal;
+    contentType?: string;
+    headers?: Record<string, string>;
+    telemetry?: {
+        name: string;
+        attributes?: Record<string, string>;
+    };
+    binary?: true;
+    duplex?: 'half';
+}
+export interface FetchAdapter {
+    invoke<T>(url: string, options: FetchRequest): Promise<FetchResponse<T>>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/services/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/services/adapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB,CAAC,KAAK;IAC1C,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,kBAAkB,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAE5E,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC;AAElE,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1C,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;CACzE"}

package/dist/services/exception.d.ts

@@ -0,0 +1,5 @@
+export declare class ServiceException extends Error {
+    statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+//# sourceMappingURL=exception.d.ts.map

package/dist/services/exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.d.ts","sourceRoot":"","sources":["../../src/services/exception.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,UAAU,EAAE,MAAM,CAAC;gBACP,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAI/C"}

package/dist/services/index.d.ts

@@ -0,0 +1,8 @@
+export * from './adapter';
+export * from './exception';
+export * from './keyvalue';
+export * from './objectstore';
+export * from './server';
+export * from './stream';
+export * from './vector';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/services/keyvalue.d.ts

@@ -0,0 +1,76 @@
+import { FetchAdapter } from './adapter';
+/**
+ * the result of a data operation when the data is found
+ */
+export interface DataResultFound<T> {
+    /**
+     * the data from the result of the operation
+     */
+    data: T;
+    /**
+     * the content type of the data
+     */
+    contentType: string;
+    /**
+     * the data was found
+     */
+    exists: true;
+}
+/**
+ * the result of a data operation when the data is not found
+ */
+export interface DataResultNotFound {
+    data: never;
+    /**
+     * the data was not found
+     */
+    exists: false;
+}
+/**
+ * the result of a data operation
+ */
+export type DataResult<T> = DataResultFound<T> | DataResultNotFound;
+export interface KeyValueStorageSetParams {
+    /**
+     * the number of milliseconds to keep the value in the cache
+     */
+    ttl?: number;
+    /**
+     * the content type of the value
+     */
+    contentType?: string;
+}
+export interface KeyValueStorage {
+    /**
+     * get a value from the key value storage
+     *
+     * @param name - the name of the key value storage
+     * @param key - the key to get the value of
+     * @returns the DataResult object
+     */
+    get<T>(name: string, key: string): Promise<DataResult<T>>;
+    /**
+     * set a value in the key value storage
+     *
+     * @param name - the name of the key value storage
+     * @param key - the key to set the value of
+     * @param value - the value to set in any of the supported data types
+     * @param params - the KeyValueStorageSetParams
+     */
+    set<T = unknown>(name: string, key: string, value: T, params?: KeyValueStorageSetParams): Promise<void>;
+    /**
+     * delete a value from the key value storage
+     *
+     * @param name - the name of the key value storage
+     * @param key - the key to delete
+     */
+    delete(name: string, key: string): Promise<void>;
+}
+export declare class KeyValueStorageService implements KeyValueStorage {
+    #private;
+    constructor(baseUrl: string, adapter: FetchAdapter);
+    get<T>(name: string, key: string): Promise<DataResult<T>>;
+    set<T = unknown>(name: string, key: string, value: T, params?: KeyValueStorageSetParams): Promise<void>;
+    delete(name: string, key: string): Promise<void>;
+}
+//# sourceMappingURL=keyvalue.d.ts.map

package/dist/services/keyvalue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyvalue.d.ts","sourceRoot":"","sources":["../../src/services/keyvalue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,IAAI,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,KAAK,CAAC;IACZ;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC;AAEpE,MAAM,WAAW,wBAAwB;IACxC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1D;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,MAAM,CAAC,EAAE,wBAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,qBAAa,sBAAuB,YAAW,eAAe;;gBAIjD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAK5C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IA8BzD,GAAG,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,MAAM,CAAC,EAAE,wBAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAkCV,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsBtD"}

package/dist/services/objectstore.d.ts

@@ -0,0 +1,157 @@
+import type { FetchAdapter } from './adapter';
+/**
+ * Parameters for putting an object into the object store
+ */
+export interface ObjectStorePutParams {
+    /**
+     * the content type of the object
+     */
+    contentType?: string;
+    /**
+     * the content encoding of the object
+     */
+    contentEncoding?: string;
+    /**
+     * the cache control header for the object
+     */
+    cacheControl?: string;
+    /**
+     * the content disposition header for the object
+     */
+    contentDisposition?: string;
+    /**
+     * the content language header for the object
+     */
+    contentLanguage?: string;
+    /**
+     * arbitrary metadata to attach to the object but not returned as part of the object when fetched via HTTP
+     */
+    metadata?: Record<string, string>;
+}
+/**
+ * Result when an object is found in the object store
+ */
+export interface ObjectResultFound {
+    /**
+     * the object data
+     */
+    data: Uint8Array;
+    /**
+     * the content type of the object
+     */
+    contentType: string;
+    /**
+     * the object was found
+     */
+    exists: true;
+}
+/**
+ * Result when an object is not found in the object store
+ */
+export interface ObjectResultNotFound {
+    data: never;
+    /**
+     * the object was not found
+     */
+    exists: false;
+}
+/**
+ * The result of an object store get operation
+ */
+export type ObjectResult = ObjectResultFound | ObjectResultNotFound;
+/**
+ * Parameters for creating a public URL
+ */
+export interface CreatePublicURLParams {
+    /**
+     * the duration of the signed URL in milliseconds. If not provided, the default is 1 hour.
+     */
+    expiresDuration?: number;
+}
+/**
+ * Object store service for storing and retrieving binary data
+ */
+export interface ObjectStorage {
+    /**
+     * Get an object from the object store
+     *
+     * @param bucket - the bucket to get the object from
+     * @param key - the key of the object to get
+     * @returns a Promise that resolves to the object result
+     *
+     * @example
+     * ```typescript
+     * const result = await objectStore.get('my-bucket', 'my-key');
+     * if (result.exists) {
+     *   console.log('Content type:', result.contentType);
+     *   console.log('Data:', result.data);
+     * }
+     * ```
+     */
+    get(bucket: string, key: string): Promise<ObjectResult>;
+    /**
+     * Put an object into the object store
+     *
+     * @param bucket - the bucket to put the object into
+     * @param key - the key of the object to put
+     * @param data - the data to put (Uint8Array, ArrayBuffer, or ReadableStream)
+     * @param params - optional parameters for the put operation
+     *
+     * @example
+     * ```typescript
+     * const data = new TextEncoder().encode('Hello, world!');
+     * await objectStore.put('my-bucket', 'greeting.txt', data, {
+     *   contentType: 'text/plain',
+     *   metadata: { author: 'user123' }
+     * });
+     * ```
+     */
+    put(bucket: string, key: string, data: Uint8Array | ArrayBuffer | ReadableStream, params?: ObjectStorePutParams): Promise<void>;
+    /**
+     * Delete an object from the object store
+     *
+     * @param bucket - the bucket to delete the object from
+     * @param key - the key of the object to delete
+     * @returns true if the object was deleted, false if the object did not exist
+     *
+     * @example
+     * ```typescript
+     * const deleted = await objectStore.delete('my-bucket', 'my-key');
+     * if (deleted) {
+     *   console.log('Object was deleted');
+     * } else {
+     *   console.log('Object did not exist');
+     * }
+     * ```
+     */
+    delete(bucket: string, key: string): Promise<boolean>;
+    /**
+     * Create a public URL for an object. This URL can be used to access the object without authentication.
+     *
+     * @param bucket - the bucket to create the signed URL for
+     * @param key - the key of the object to create the signed URL for
+     * @param params - optional parameters including expiration duration
+     * @returns the public URL
+     *
+     * @example
+     * ```typescript
+     * const url = await objectStore.createPublicURL('my-bucket', 'my-key', {
+     *   expiresDuration: 3600000 // 1 hour in milliseconds
+     * });
+     * console.log('Public URL:', url);
+     * ```
+     */
+    createPublicURL(bucket: string, key: string, params?: CreatePublicURLParams): Promise<string>;
+}
+/**
+ * Implementation of the ObjectStorage interface
+ */
+export declare class ObjectStorageService implements ObjectStorage {
+    #private;
+    constructor(baseUrl: string, adapter: FetchAdapter);
+    get(bucket: string, key: string): Promise<ObjectResult>;
+    put(bucket: string, key: string, data: Uint8Array | ArrayBuffer | ReadableStream, params?: ObjectStorePutParams): Promise<void>;
+    delete(bucket: string, key: string): Promise<boolean>;
+    createPublicURL(bucket: string, key: string, params?: CreatePublicURLParams): Promise<string>;
+}
+//# sourceMappingURL=objectstore.d.ts.map

package/dist/services/objectstore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectstore.d.ts","sourceRoot":"","sources":["../../src/services/objectstore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,WAAW,CAAC;AAGlE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,IAAI,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,KAAK,CAAC;IAEZ;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAgBD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAExD;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CACF,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,EAC/C,MAAM,CAAC,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtD;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9F;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,aAAa;;gBAI7C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAK5C,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA4DvD,GAAG,CACR,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,EAC/C,MAAM,CAAC,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC;IA0FV,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgDrD,eAAe,CACpB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,CAAC;CA+DlB"}

package/dist/services/server.d.ts

@@ -0,0 +1,22 @@
+import type { FetchRequest, FetchResponse, FetchAdapter } from './adapter';
+import { ServiceException } from './exception';
+interface ServiceAdapterConfig {
+    headers: Record<string, string>;
+    onBefore?: (url: string, options: FetchRequest, invoke: () => Promise<void>) => Promise<void>;
+    onAfter?: <T>(url: string, options: FetchRequest, response: FetchResponse<T>, err?: ServiceException) => Promise<void>;
+}
+declare class ServerFetchAdapter implements FetchAdapter {
+    #private;
+    constructor(config: ServiceAdapterConfig);
+    private _invoke;
+    invoke<T>(url: string, options?: FetchRequest): Promise<FetchResponse<T>>;
+}
+/**
+ * Create a Server Side Fetch Adapter to allow the server to add headers and track outgoing requests
+ *
+ * @param config the service config
+ * @returns
+ */
+export declare function createServerFetchAdapter(config: ServiceAdapterConfig): ServerFetchAdapter;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/services/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/services/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAsB,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,UAAU,oBAAoB;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,OAAO,CAAC,EAAE,CAAC,CAAC,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,CAAC,EAAE,gBAAgB,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,cAAM,kBAAmB,YAAW,YAAY;;gBAGnC,MAAM,EAAE,oBAAoB;YAG1B,OAAO;IA4Df,MAAM,CAAC,CAAC,EACb,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,YAAiC,GACxC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAmC5B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,sBAEpE"}

package/dist/services/stream.d.ts

@@ -0,0 +1,167 @@
+import { FetchAdapter } from './adapter';
+/**
+ * Properties for creating a stream
+ */
+export interface CreateStreamProps {
+    /**
+     * optional metadata for the stream
+     */
+    metadata?: Record<string, string>;
+    /**
+     * optional contentType for the stream data. If not set, defaults to application/octet-stream
+     */
+    contentType?: string;
+    /**
+     * optional flag to enable gzip compression of stream data during upload. if true, will also add
+     * add Content-Encoding: gzip header to responses. The client MUST be able to accept gzip
+     * compression for this to work or must be able to uncompress the raw data it receives.
+     */
+    compress?: true;
+}
+/**
+ * Parameters for listing streams
+ */
+export interface ListStreamsParams {
+    /**
+     * optional name filter to search for streams
+     */
+    name?: string;
+    /**
+     * optional metadata filters to match streams
+     */
+    metadata?: Record<string, string>;
+    /**
+     * maximum number of streams to return (default: 100, max: 1000)
+     */
+    limit?: number;
+    /**
+     * number of streams to skip for pagination
+     */
+    offset?: number;
+}
+/**
+ * Stream information returned by list operation
+ */
+export interface StreamInfo {
+    /**
+     * unique stream identifier
+     */
+    id: string;
+    /**
+     * the name of the stream
+     */
+    name: string;
+    /**
+     * the stream metadata
+     */
+    metadata: Record<string, string>;
+    /**
+     * the public URL to access the stream
+     */
+    url: string;
+    /**
+     * the size of the stream in bytes
+     */
+    sizeBytes: number;
+}
+/**
+ * Response from listing streams
+ */
+export interface ListStreamsResponse {
+    /**
+     * whether the request was successful
+     */
+    success: boolean;
+    /**
+     * optional error message if not successful
+     */
+    message?: string;
+    /**
+     * array of streams matching the filter criteria
+     */
+    streams: StreamInfo[];
+    /**
+     * total count of streams matching the filter (useful for pagination)
+     */
+    total: number;
+}
+/**
+ * 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
+     */
+    write(chunk: string | Uint8Array | ArrayBuffer | Buffer | 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 streams
+ */
+export interface StreamStorage {
+    /**
+     * create a new stream
+     *
+     * @param name - the name of the stream (1-254 characters). you can group streams by name to organize them.
+     * @param props - optional properties for creating the stream
+     * @returns a Promise that resolves to the created Stream
+     */
+    create(name: string, props?: CreateStreamProps): Promise<Stream>;
+    /**
+     * 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
+     */
+    list(params?: ListStreamsParams): Promise<ListStreamsResponse>;
+    /**
+     * delete a stream by id
+     *
+     * @param id - the stream id to delete
+     * @returns a Promise that resolves when the stream is deleted
+     */
+    delete(id: string): Promise<void>;
+}
+export declare class StreamStorageService implements StreamStorage {
+    #private;
+    constructor(baseUrl: string, adapter: FetchAdapter);
+    create(name: string, props?: CreateStreamProps): Promise<Stream>;
+    list(params?: ListStreamsParams): Promise<ListStreamsResponse>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/services/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/services/stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAiB,MAAM,WAAW,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;IAEtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,MAAO,SAAQ,cAAc;IAC7C;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;;;;OAOG;IACH,SAAS,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AA8SD,qBAAa,oBAAqB,YAAW,aAAa;;gBAI7C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAK5C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmDhE,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkD9D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBvC"}