@agentuity/core 1.0.32 → 1.0.34

package/src/services/{stream.ts → stream/service.ts}

@@ -1,8 +1,9 @@
-import { StructuredError } from '../error.ts';
-import { safeStringify } from '../json.ts';
-import { buildUrl, toServiceException } from './_util.ts';
-import type { FetchAdapter } from './adapter.ts';
-import type { ListParams } from './pagination.ts';
+import { StructuredError } from '../../error.ts';
+import { safeStringify } from '../../json.ts';
+import { buildUrl, toServiceException } from '../_util.ts';
+import type { FetchAdapter } from '../adapter.ts';
+import { ListParamsSchema } from '../pagination.ts';
+import { z } from 'zod';
 
 /**
  * Minimum TTL value in seconds (1 minute)
@@ -28,23 +29,36 @@ const NativeCompressionStream = globalThis.CompressionStream;
 /**
  * Properties for creating a stream
  */
-export interface CreateStreamProps {
+export const CreateStreamPropsSchema = z.object({
 	/**
 	 * optional metadata for the stream
 	 */
-	metadata?: Record<string, string>;
+	metadata: z
+		.record(z.string(), z.string())
+		.optional()
+		.describe('optional metadata for the stream'),
 
 	/**
 	 * optional contentType for the stream data. If not set, defaults to application/octet-stream
 	 */
-	contentType?: string;
+	contentType: z
+		.string()
+		.optional()
+		.describe(
+			'optional contentType for the stream data. If not set, defaults to application/octet-stream'
+		),
 
 	/**
-	 * optional flag to enable gzip compression of stream data during upload. if true, will also add
+	 * optional flag to enable gzip compression of stream data during upload. if true, will also
 	 * 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;
+	compress: z
+		.literal(true)
+		.optional()
+		.describe(
+			'optional flag to enable gzip compression of stream data during upload. if true, will also add Content-Encoding: gzip header to responses.'
+		),
 
 	/**
 	 * optional time-to-live in seconds for the stream. Controls when the stream expires and is automatically deleted.
@@ -58,10 +72,27 @@ export interface CreateStreamProps {
 	 *
 	 * @default 2592000 (30 days)
 	 */
-	ttl?: number | null;
-}
+	ttl: z
+		.number()
+		.nullable()
+		.optional()
+		.describe(
+			'optional time-to-live in seconds for the stream. Controls when the stream expires and is automatically deleted.'
+		),
+});
+
+export type CreateStreamProps = z.infer<typeof CreateStreamPropsSchema>;
+
+export const StreamSortFieldSchema = z.enum([
+	'name',
+	'created',
+	'updated',
+	'size',
+	'count',
+	'lastUsed',
+]);
 
-export type StreamSortField = 'name' | 'created' | 'updated' | 'size' | 'count' | 'lastUsed';
+export type StreamSortField = z.infer<typeof StreamSortFieldSchema>;
 
 /**
  * Parameters for listing streams.
@@ -69,82 +100,94 @@ export type StreamSortField = 'name' | 'created' | 'updated' | 'size' | 'count'
  * Note: If both `namespace` and `name` are provided, `namespace` takes precedence
  * and `name` is ignored in the API request body.
  */
-export interface ListStreamsParams extends ListParams<StreamSortField> {
+export const ListStreamsParamsSchema = ListParamsSchema(StreamSortFieldSchema).extend({
 	/**
 	 * optional namespace filter to search for streams
 	 */
-	namespace?: string;
+	namespace: z.string().optional().describe('optional namespace filter to search for streams'),
 
 	/**
 	 * optional name filter to search for streams
 	 */
-	name?: string;
+	name: z.string().optional().describe('optional name filter to search for streams'),
 
 	/**
 	 * optional metadata filters to match streams
 	 */
-	metadata?: Record<string, string>;
-}
+	metadata: z
+		.record(z.string(), z.string())
+		.optional()
+		.describe('optional metadata filters to match streams'),
+});
+
+export type ListStreamsParams = z.infer<typeof ListStreamsParamsSchema>;
 
 /**
  * Stream information returned by list operation
  */
-export interface StreamInfo {
+export const StreamInfoSchema = z.object({
 	/**
 	 * unique stream identifier
 	 */
-	id: string;
+	id: z.string().describe('unique stream identifier'),
 
 	/**
 	 * the namespace of the stream
 	 */
-	namespace: string;
+	namespace: z.string().describe('the namespace of the stream'),
 
 	/**
 	 * the stream metadata
 	 */
-	metadata: Record<string, string>;
+	metadata: z.record(z.string(), z.string()).describe('the stream metadata'),
 
 	/**
 	 * the public URL to access the stream
 	 */
-	url: string;
+	url: z.string().describe('the public URL to access the stream'),
 
 	/**
 	 * the size of the stream in bytes
 	 */
-	sizeBytes: number;
+	sizeBytes: z.number().describe('the size of the stream in bytes'),
 
 	/**
-	 * ISO 8601 timestamp when stream expires, or undefined if stream never expires
+	 * ISO 8601 timestamp when stream expires, or null if stream never expires
 	 */
-	expiresAt?: string;
-}
+	expiresAt: z
+		.string()
+		.nullable()
+		.describe('ISO 8601 timestamp when stream expires, or null if stream never expires'),
+});
+
+export type StreamInfo = z.infer<typeof StreamInfoSchema>;
 
 /**
  * Response from listing streams
  */
-export interface ListStreamsResponse {
+export const ListStreamsResponseSchema = z.object({
 	/**
 	 * whether the request was successful
 	 */
-	success: boolean;
+	success: z.boolean().describe('whether the request was successful'),
 
 	/**
 	 * optional error message if not successful
 	 */
-	message?: string;
+	message: z.string().optional().describe('optional error message if not successful'),
 
 	/**
 	 * array of streams matching the filter criteria
 	 */
-	streams: StreamInfo[];
+	streams: z.array(StreamInfoSchema).describe('array of streams matching the filter criteria'),
 
 	/**
 	 * total count of streams matching the filter (useful for pagination)
 	 */
-	total: number;
-}
+	total: z.number().describe('total count of streams matching the filter (useful for pagination)'),
+});
+
+export type ListStreamsResponse = z.infer<typeof ListStreamsResponseSchema>;
 
 /**
  * A durable and resumable stream that can be written to and read many times.
@@ -792,7 +835,7 @@ export class StreamStorageService implements StreamStorage {
 					metadata: s.metadata ?? {},
 					url: s.url,
 					sizeBytes: s.size_bytes,
-					...(s.expires_at && { expiresAt: s.expires_at }),
+					expiresAt: s.expires_at ?? null,
 				})),
 				total: res.data.total,
 			};
@@ -833,7 +876,7 @@ export class StreamStorageService implements StreamStorage {
 				metadata: res.data.metadata ?? {},
 				url: res.data.url,
 				sizeBytes: res.data.size_bytes,
-				...(res.data.expires_at && { expiresAt: res.data.expires_at }),
+				expiresAt: res.data.expires_at ?? null,
 			};
 		}
 		throw await toServiceException('POST', url, res.response);

package/src/services/stream/util.ts

@@ -0,0 +1,3 @@
+import { StructuredError } from '../../error.ts';
+
+export const StreamResponseError = StructuredError('StreamResponseError');

package/src/services/task/index.ts

@@ -0,0 +1 @@
+export * from './service.ts';