@agentuity/core 1.0.33 → 1.0.34

package/src/api/session/list.ts

@@ -1,136 +0,0 @@
-import type { SortDirection } from '../../services/pagination.ts';
-import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api.ts';
-import { SessionResponseError } from './util.ts';
-
-const SessionSchema = z.object({
-	id: z.string().describe('the session id'),
-	created_at: z.string().describe('the creation timestamp'),
-	updated_at: z.string().describe('the last update timestamp'),
-	deleted: z.boolean().describe('whether the session is deleted'),
-	deleted_at: z.string().nullable().describe('the deletion timestamp'),
-	deleted_by: z.string().nullable().describe('who deleted the session'),
-	start_time: z.string().describe('the session start time'),
-	end_time: z.string().nullable().describe('the session end time'),
-	duration: z.number().nullable().describe('the session duration in nanoseconds'),
-	org_id: z.string().describe('the organization id'),
-	project_id: z.string().describe('the project id'),
-	deployment_id: z.string().describe('the deployment id'),
-	agent_ids: z.array(z.string()).describe('the agent ids involved'),
-	trigger: z.string().describe('how the session was triggered'),
-	env: z.string().describe('the environment'),
-	devmode: z.boolean().describe('whether dev mode was enabled'),
-	pending: z.boolean().describe('whether the session is pending'),
-	success: z.boolean().describe('whether the session succeeded'),
-	error: z.string().nullable().describe('the error message if failed'),
-	metadata: z
-		.record(z.string(), z.unknown())
-		.nullable()
-		.optional()
-		.describe('unencrypted key-value metadata'),
-	cpu_time: z.number().nullable().describe('the CPU time in nanoseconds'),
-	llm_cost: z.number().nullable().describe('the LLM cost'),
-	llm_prompt_token_count: z.number().nullable().describe('the LLM prompt token count'),
-	llm_completion_token_count: z.number().nullable().describe('the LLM completion token count'),
-	total_cost: z.number().nullable().describe('the total cost'),
-	method: z.string().nullable().describe('the HTTP method'),
-	url: z.string().nullable().describe('the request URL'),
-	route_id: z.string().nullable().describe('the route id'),
-	thread_id: z.string().nullable().describe('the thread id'),
-	timeline: z.unknown().nullable().optional().describe('the session timeline tree'),
-	user_data: z.string().nullable().optional().describe('the user data as JSON'),
-});
-
-export { SessionSchema };
-
-export const SessionListResponse = z.array(SessionSchema);
-
-export const SessionListResponseSchema = APIResponseSchema(SessionListResponse);
-
-export type SessionListResponse = z.infer<typeof SessionListResponseSchema>;
-export type SessionList = z.infer<typeof SessionListResponse>;
-export type Session = z.infer<typeof SessionSchema>;
-
-export type SessionSortField = 'created' | 'updated' | 'duration' | 'startTime';
-
-export interface SessionListOptions {
-	/** @deprecated Use `limit` instead. Will be removed in a future version. */
-	count?: number;
-	limit?: number;
-	offset?: number;
-	sort?: SessionSortField;
-	direction?: SortDirection;
-	orgId?: string;
-	projectId?: string;
-	deploymentId?: string;
-	trigger?: string;
-	env?: string;
-	devmode?: boolean;
-	success?: boolean;
-	threadId?: string;
-	agentIdentifier?: string;
-	startAfter?: string;
-	startBefore?: string;
-	metadata?: Record<string, unknown>;
-}
-
-/**
- * List sessions
- *
- * @param client
- * @param options filtering and pagination options
- * @returns
- */
-export async function sessionList(
-	client: APIClient,
-	options: SessionListOptions = {}
-): Promise<SessionList> {
-	const {
-		count,
-		limit,
-		offset,
-		sort,
-		direction,
-		orgId,
-		projectId,
-		deploymentId,
-		trigger,
-		env,
-		devmode,
-		success,
-		threadId,
-		agentIdentifier,
-		startAfter,
-		startBefore,
-		metadata,
-	} = options;
-	const resolvedLimit = limit ?? count ?? 10;
-	const params = new URLSearchParams({ limit: resolvedLimit.toString() });
-	if (orgId) params.set('orgId', orgId);
-	if (projectId) params.set('projectId', projectId);
-	if (deploymentId) params.set('deploymentId', deploymentId);
-	if (trigger) params.set('trigger', trigger);
-	if (env) params.set('env', env);
-	if (offset !== undefined) params.set('offset', offset.toString());
-	if (sort) params.set('sort', sort);
-	if (direction) params.set('direction', direction);
-	if (devmode !== undefined) params.set('devmode', devmode.toString());
-	if (success !== undefined) params.set('success', success.toString());
-	if (threadId) params.set('threadId', threadId);
-	if (agentIdentifier) params.set('agentIdentifier', agentIdentifier);
-	if (startAfter) params.set('startAfter', startAfter);
-	if (startBefore) params.set('startBefore', startBefore);
-	if (metadata) params.set('metadata', JSON.stringify(metadata));
-
-	const resp = await client.request<SessionListResponse>(
-		'GET',
-		`/session?${params.toString()}`,
-		SessionListResponseSchema
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new SessionResponseError({ message: resp.message });
-}

package/src/api/storage/objects.ts

@@ -1,250 +0,0 @@
-import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api.ts';
-import {
-	StorageListResponseSchema,
-	StorageDeleteResponseSchema,
-	StoragePresignResponseSchema,
-	StorageStatsResponseSchema,
-	StorageAnalyticsResponseSchema,
-	type StorageListResponse,
-	type StorageDeleteResponse,
-	type StoragePresignResponse,
-	type StorageStatsResponse,
-	type StorageAnalyticsResponse,
-} from './types.ts';
-import { StorageObjectsResponseError } from './util.ts';
-
-export const StorageListAPIResponseSchema = APIResponseSchema(StorageListResponseSchema);
-export const StorageDeleteAPIResponseSchema = APIResponseSchema(StorageDeleteResponseSchema);
-export const StoragePresignAPIResponseSchema = APIResponseSchema(StoragePresignResponseSchema);
-export const StorageStatsAPIResponseSchema = APIResponseSchema(StorageStatsResponseSchema);
-export const StorageAnalyticsAPIResponseSchema = APIResponseSchema(StorageAnalyticsResponseSchema);
-
-export interface ListStorageObjectsOptions {
-	prefix?: string;
-	limit?: number;
-	offset?: number;
-}
-
-/**
- * List objects in a storage bucket with optional prefix filtering and pagination.
- *
- * @param client - The API client to use for the request
- * @param bucketName - Name of the bucket to list objects from
- * @param options - Optional filtering/pagination options
- * @param extraHeaders - Optional extra headers (e.g. x-agentuity-orgid for CLI auth)
- * @returns Paginated list of objects with total count
- * @throws {StorageObjectsResponseError} If the request fails
- */
-export async function listStorageObjects(
-	client: APIClient,
-	bucketName: string,
-	options?: ListStorageObjectsOptions,
-	extraHeaders?: Record<string, string>
-): Promise<StorageListResponse> {
-	const params = new URLSearchParams();
-	if (options?.prefix) params.set('prefix', options.prefix);
-	if (options?.limit !== undefined) {
-		if (
-			!Number.isFinite(options.limit) ||
-			!Number.isInteger(options.limit) ||
-			options.limit < 0
-		) {
-			throw new TypeError('limit must be a non-negative integer');
-		}
-		params.set('limit', String(options.limit));
-	}
-	if (options?.offset !== undefined) {
-		if (
-			!Number.isFinite(options.offset) ||
-			!Number.isInteger(options.offset) ||
-			options.offset < 0
-		) {
-			throw new TypeError('offset must be a non-negative integer');
-		}
-		params.set('offset', String(options.offset));
-	}
-
-	const query = params.toString();
-	const url = `/storage/objects/${encodeURIComponent(bucketName)}${query ? `?${query}` : ''}`;
-
-	const resp = await client.get<z.infer<typeof StorageListAPIResponseSchema>>(
-		url,
-		StorageListAPIResponseSchema,
-		undefined,
-		extraHeaders
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new StorageObjectsResponseError({ message: resp.message });
-}
-
-export interface DeleteStorageObjectsOptions {
-	key?: string;
-	prefix?: string;
-}
-
-/**
- * Delete objects from a storage bucket.
- * Provide either `key` (single object) or `prefix` (all matching objects), but not both.
- *
- * @param client - The API client to use for the request
- * @param bucketName - Name of the bucket to delete from
- * @param options - Must include either key or prefix (mutually exclusive)
- * @param extraHeaders - Optional extra headers (e.g. x-agentuity-orgid for CLI auth)
- * @returns The count of deleted objects
- * @throws {StorageObjectsResponseError} If the request fails
- */
-export async function deleteStorageObjects(
-	client: APIClient,
-	bucketName: string,
-	options: DeleteStorageObjectsOptions,
-	extraHeaders?: Record<string, string>
-): Promise<StorageDeleteResponse> {
-	if (!options.key && !options.prefix) {
-		throw new StorageObjectsResponseError({ message: "Either 'key' or 'prefix' is required" });
-	}
-	if (options.key && options.prefix) {
-		throw new StorageObjectsResponseError({
-			message: "Provide either 'key' or 'prefix', not both",
-		});
-	}
-
-	const params = new URLSearchParams();
-	if (options.key) params.set('key', options.key);
-	if (options.prefix) params.set('prefix', options.prefix);
-
-	const url = `/storage/objects/${encodeURIComponent(bucketName)}?${params.toString()}`;
-
-	const resp = await client.delete<z.infer<typeof StorageDeleteAPIResponseSchema>>(
-		url,
-		StorageDeleteAPIResponseSchema,
-		undefined,
-		extraHeaders
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new StorageObjectsResponseError({ message: resp.message });
-}
-
-/**
- * Generate a presigned URL for downloading or uploading an object.
- *
- * @param client - The API client to use for the request
- * @param bucketName - Name of the bucket
- * @param key - Object key
- * @param operation - 'download' (default) or 'upload'
- * @param extraHeaders - Optional extra headers (e.g. x-agentuity-orgid for CLI auth)
- * @returns Presigned URL and expiry info
- * @throws {StorageObjectsResponseError} If the request fails
- */
-export async function presignStorageObject(
-	client: APIClient,
-	bucketName: string,
-	key: string,
-	operation: 'download' | 'upload' = 'download',
-	extraHeaders?: Record<string, string>
-): Promise<StoragePresignResponse> {
-	if (!key) {
-		throw new StorageObjectsResponseError({ message: "'key' must be a non-empty string" });
-	}
-	const params = new URLSearchParams();
-	params.set('key', key);
-	if (operation !== 'download') {
-		params.set('operation', operation);
-	}
-
-	const url = `/storage/presign/${encodeURIComponent(bucketName)}?${params.toString()}`;
-
-	const resp = await client.get<z.infer<typeof StoragePresignAPIResponseSchema>>(
-		url,
-		StoragePresignAPIResponseSchema,
-		undefined,
-		extraHeaders
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new StorageObjectsResponseError({ message: resp.message });
-}
-
-/**
- * Get aggregate stats for a storage bucket (object count, total size).
- *
- * @param client - The API client to use for the request
- * @param bucketName - Name of the bucket
- * @param extraHeaders - Optional extra headers (e.g. x-agentuity-orgid for CLI auth)
- * @returns Bucket statistics
- * @throws {StorageObjectsResponseError} If the request fails
- */
-export async function getStorageStats(
-	client: APIClient,
-	bucketName: string,
-	extraHeaders?: Record<string, string>
-): Promise<StorageStatsResponse> {
-	const url = `/storage/stats/${encodeURIComponent(bucketName)}`;
-
-	const resp = await client.get<z.infer<typeof StorageStatsAPIResponseSchema>>(
-		url,
-		StorageStatsAPIResponseSchema,
-		undefined,
-		extraHeaders
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new StorageObjectsResponseError({ message: resp.message });
-}
-
-export interface GetStorageAnalyticsOptions {
-	days?: number;
-}
-
-/**
- * Get storage analytics for the org: summary totals, per-bucket breakdown, and daily snapshots.
- *
- * @param client - The API client to use for the request
- * @param options - Optional options (days for sparkline history, default 180)
- * @param extraHeaders - Optional extra headers (e.g. x-agentuity-orgid for CLI auth)
- * @returns Analytics data with summary, buckets, and daily snapshots
- * @throws {StorageObjectsResponseError} If the request fails
- */
-export async function getStorageAnalytics(
-	client: APIClient,
-	options?: GetStorageAnalyticsOptions,
-	extraHeaders?: Record<string, string>
-): Promise<StorageAnalyticsResponse> {
-	const params = new URLSearchParams();
-	if (options?.days !== undefined) {
-		if (!Number.isFinite(options.days) || !Number.isInteger(options.days) || options.days < 0) {
-			throw new TypeError('days must be a non-negative integer');
-		}
-		params.set('days', String(options.days));
-	}
-
-	const query = params.toString();
-	const url = `/storage/analytics${query ? `?${query}` : ''}`;
-
-	const resp = await client.get<z.infer<typeof StorageAnalyticsAPIResponseSchema>>(
-		url,
-		StorageAnalyticsAPIResponseSchema,
-		undefined,
-		extraHeaders
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new StorageObjectsResponseError({ message: resp.message });
-}

package/src/api/stream/index.ts

@@ -1,3 +0,0 @@
-export * from './get.ts';
-export * from './list.ts';
-export * from './util.ts';

package/src/api/stream/list.ts

@@ -1,127 +0,0 @@
-import type { SortDirection } from '../../services/pagination.ts';
-import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api.ts';
-import { StreamResponseError } from './util.ts';
-
-export const StreamInfoSchema = z.object({
-	id: z.string().describe('the stream id'),
-	namespace: z.string().describe('the stream namespace'),
-	metadata: z.record(z.string(), z.string()).describe('stream metadata'),
-	url: z.string().describe('public URL to access the stream'),
-	sizeBytes: z.number().describe('size in bytes'),
-	expiresAt: z.string().nullable().describe('ISO 8601 expiration timestamp or null'),
-	orgId: z.string().describe('the organization id'),
-	projectId: z.string().nullable().describe('the project id'),
-	projectName: z.string().nullable().describe('the project name'),
-});
-
-export const StreamListDataSchema = z.object({
-	streams: z.array(StreamInfoSchema).describe('list of streams'),
-	total: z.number().describe('total count of matching streams'),
-});
-
-export const StreamListResponseSchema = APIResponseSchema(StreamListDataSchema);
-
-export type StreamListResponse = z.infer<typeof StreamListResponseSchema>;
-export type StreamListData = z.infer<typeof StreamListDataSchema>;
-export type StreamInfo = z.infer<typeof StreamInfoSchema>;
-
-export interface StreamListOptions {
-	/**
-	 * Filter by specific project ID
-	 */
-	projectId?: string;
-	/**
-	 * Filter by specific organization ID
-	 */
-	orgId?: string;
-	/**
-	 * Filter by stream namespace
-	 */
-	namespace?: string;
-	/**
-	 * Filter by stream name
-	 */
-	name?: string;
-	/**
-	 * Maximum number of streams to return (default: 100, max: 1000)
-	 */
-	limit?: number;
-	/**
-	 * Number of streams to skip for pagination
-	 */
-	offset?: number;
-	/**
-	 * Filter by metadata key-value pairs
-	 */
-	metadata?: Record<string, string>;
-	/**
-	 * Field to sort by
-	 */
-	sort?: string;
-	/**
-	 * Sort direction (default: 'desc')
-	 */
-	direction?: SortDirection;
-}
-
-/**
- * List streams with optional filtering.
- *
- * If no projectId or orgId is provided, returns streams from all orgs the user is a member of.
- *
- * @param client - The API client
- * @param options - Filtering and pagination options
- * @returns A promise that resolves to the list of streams with metadata
- *
- * @example
- * // List all streams across all orgs
- * const result = await streamList(client);
- * console.log(`Found ${result.total} streams`);
- *
- * @example
- * // List streams for a specific project
- * const result = await streamList(client, { projectId: 'proj_123' });
- *
- * @example
- * // List streams with namespace filter
- * const result = await streamList(client, { namespace: 'agent-logs' });
- *
- * @example
- * // List streams with metadata filter
- * const result = await streamList(client, {
- *   metadata: { type: 'export', env: 'production' }
- * });
- */
-export async function streamList(
-	client: APIClient,
-	options: StreamListOptions = {}
-): Promise<StreamListData> {
-	const { projectId, orgId, namespace, name, limit, offset, metadata } = options;
-	const params = new URLSearchParams();
-
-	if (projectId) params.set('projectId', projectId);
-	if (orgId) params.set('orgId', orgId);
-	if (namespace) params.set('namespace', namespace);
-	if (name) params.set('name', name);
-	if (limit !== undefined) params.set('limit', limit.toString());
-	if (offset !== undefined) params.set('offset', offset.toString());
-	if (metadata && Object.keys(metadata).length > 0) {
-		params.set('metadata', JSON.stringify(metadata));
-	}
-	if (options.sort) params.set('sort', options.sort);
-	if (options.direction) params.set('direction', options.direction);
-
-	const queryString = params.toString();
-	const resp = await client.request<StreamListResponse>(
-		'GET',
-		`/cli/stream${queryString ? `?${queryString}` : ''}`,
-		StreamListResponseSchema
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new StreamResponseError({ message: resp.message });
-}

package/src/api/thread/list.ts

@@ -1,76 +0,0 @@
-import type { SortDirection } from '../../services/pagination.ts';
-import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api.ts';
-import { ThreadResponseError } from './util.ts';
-
-export const ThreadSchema = z.object({
-	id: z.string().describe('the thread id'),
-	created_at: z.string().describe('the creation timestamp'),
-	updated_at: z.string().describe('the last update timestamp'),
-	deleted: z.boolean().describe('whether the thread is deleted'),
-	deleted_at: z.string().nullable().describe('the deletion timestamp'),
-	deleted_by: z.string().nullable().describe('who deleted the thread'),
-	org_id: z.string().describe('the organization id'),
-	project_id: z.string().describe('the project id'),
-	user_data: z.string().nullable().optional().describe('the user data as JSON'),
-	metadata: z
-		.record(z.string(), z.unknown())
-		.nullable()
-		.optional()
-		.describe('unencrypted key-value metadata'),
-});
-
-export const ThreadListResponseData = z.array(ThreadSchema);
-
-export const ThreadListResponseSchema = APIResponseSchema(ThreadListResponseData);
-
-export type ThreadListResponse = z.infer<typeof ThreadListResponseSchema>;
-export type ThreadList = z.infer<typeof ThreadListResponseData>;
-export type Thread = z.infer<typeof ThreadSchema>;
-
-export type ThreadSortField = 'created' | 'updated';
-
-export interface ThreadListOptions {
-	count?: number;
-	limit?: number;
-	offset?: number;
-	sort?: ThreadSortField;
-	direction?: SortDirection;
-	orgId?: string;
-	projectId?: string;
-	metadata?: Record<string, unknown>;
-}
-
-/**
- * List threads
- *
- * @param client
- * @param options filtering and pagination options
- * @returns
- */
-export async function threadList(
-	client: APIClient,
-	options: ThreadListOptions = {}
-): Promise<ThreadList> {
-	const { limit, count, offset, sort, direction, orgId, projectId, metadata } = options;
-	const resolvedLimit = limit ?? count ?? 10;
-	const params = new URLSearchParams({ limit: resolvedLimit.toString() });
-	if (orgId) params.set('orgId', orgId);
-	if (projectId) params.set('projectId', projectId);
-	if (offset !== undefined) params.set('offset', offset.toString());
-	if (sort) params.set('sort', sort);
-	if (direction) params.set('direction', direction);
-	if (metadata) params.set('metadata', JSON.stringify(metadata));
-
-	const resp = await client.request<ThreadListResponse>(
-		'GET',
-		`/thread?${params.toString()}`,
-		ThreadListResponseSchema
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new ThreadResponseError({ message: resp.message });
-}