@agentuity/core 1.0.31 → 1.0.33

package/src/index.ts

@@ -1,240 +1,242 @@
+// env-example.ts exports
+export type { EnvField, ResourceType } from './env-example.ts';
+export { detectResourceFromKey, parseEnvExample } from './env-example.ts';
 // error.ts exports
-export { RichError, StructuredError, isStructuredError } from './error.ts';
+export { isStructuredError, RichError, StructuredError } from './error.ts';
 
 // json.ts exports
 export { safeStringify } from './json.ts';
 
 // logger.ts exports
 export type { Logger, LogLevel } from './logger.ts';
-
+export { buildUrl, fromResponse, toPayload, toServiceException } from './services/_util.ts';
 // services exports
 export type {
+	Body,
 	FetchAdapter,
+	FetchErrorResponse,
 	FetchRequest,
 	FetchResponse,
 	FetchSuccessResponse,
-	FetchErrorResponse,
-	Body,
 	HttpMethod,
 } from './services/adapter.ts';
-export type {
-	SortDirection,
-	PaginationParams,
-	SortParams,
-	ListParams,
-	PaginatedList,
-} from './services/pagination.ts';
+export {
+	type EmailActivityDataPoint,
+	type EmailActivityParams,
+	type EmailActivityResult,
+	type EmailAddress,
+	type EmailAttachment,
+	type EmailConnectionConfig,
+	type EmailDestination,
+	type EmailInbound,
+	type EmailOutbound,
+	type EmailProtocolConfig,
+	type EmailSendParams,
+	type EmailService,
+	EmailStorageService,
+	type EmailStoredAttachment,
+} from './services/email.ts';
+export {
+	type EvalRunCompleteEvent,
+	EvalRunCompleteEventDelayedSchema,
+	EvalRunCompleteEventSchema,
+	type EvalRunEventProvider,
+	type EvalRunStartEvent,
+	EvalRunStartEventDelayedSchema,
+	EvalRunStartEventSchema,
+} from './services/evalrun.ts';
 export { ServiceException } from './services/exception.ts';
 export {
+	type CreateNamespaceParams,
 	type DataResult,
 	type DataResultFound,
 	type DataResultNotFound,
-	type KeyValueStorage,
-	type KeyValueStorageSetParams,
-	type KeyValueStats,
-	type KeyValueItemWithMetadata,
-	type CreateNamespaceParams,
 	type GetAllStatsParams,
+	type KeyValueItemWithMetadata,
+	type KeyValueStats,
 	type KeyValueStatsPaginated,
-	type KVSortField,
-	KV_MIN_TTL_SECONDS,
-	KV_MAX_TTL_SECONDS,
-	KV_DEFAULT_TTL_SECONDS,
+	type KeyValueStorage,
 	KeyValueStorageService,
+	type KeyValueStorageSetParams,
+	KV_DEFAULT_TTL_SECONDS,
+	KV_MAX_TTL_SECONDS,
+	KV_MIN_TTL_SECONDS,
+	type KVSortField,
 } from './services/keyvalue.ts';
+export type {
+	ListParams,
+	PaginatedList,
+	PaginationParams,
+	SortDirection,
+	SortParams,
+} from './services/pagination.ts';
 export {
-	type SessionEventProvider,
-	SessionStartEventSchema,
-	SessionCompleteEventSchema,
-	SessionStartEventDelayedSchema,
-	SessionCompleteEventDelayedSchema,
-	type SessionStartEvent,
-	type SessionCompleteEvent,
-} from './services/session.ts';
-export {
-	type CreateStreamProps,
-	type ListStreamsParams,
-	type StreamInfo,
-	type ListStreamsResponse,
-	type Stream,
-	type StreamStorage,
-	type StreamSortField,
-	STREAM_MIN_TTL_SECONDS,
-	STREAM_MAX_TTL_SECONDS,
-	STREAM_DEFAULT_TTL_SECONDS,
-	StreamStorageService,
-} from './services/stream.ts';
-export {
-	type VectorUpsertBase,
-	type VectorUpsertEmbeddings,
-	type VectorUpsertText,
-	type VectorUpsertParams,
-	type VectorSearchParams,
-	type VectorSearchResult,
-	type VectorSearchResultWithDocument,
-	type VectorUpsertResult,
-	type VectorResultFound,
-	type VectorResultNotFound,
-	type VectorResult,
-	type VectorNamespaceStats,
-	type VectorItemStats,
-	type VectorNamespaceStatsWithSamples,
-	type VectorGetAllStatsParams,
-	type VectorStatsPaginated,
-	type VectorStorage,
-	type VectorSortField,
-	VECTOR_MIN_TTL_SECONDS,
-	VECTOR_MAX_TTL_SECONDS,
-	VECTOR_DEFAULT_TTL_SECONDS,
-	VectorStorageService,
-} from './services/vector.ts';
-export {
-	type QueueService,
-	type QueuePublishParams,
-	type QueuePublishResult,
 	type QueueCreateParams,
 	type QueueCreateResult,
-	QueueStorageService,
-	QueuePublishError,
 	QueueNotFoundError,
+	QueuePublishError,
+	type QueuePublishParams,
+	type QueuePublishResult,
+	type QueueService,
+	QueueStorageService,
 	QueueValidationError,
 } from './services/queue.ts';
 export {
-	type EmailAddress,
-	type EmailDestination,
-	type EmailProtocolConfig,
-	type EmailConnectionConfig,
-	type EmailInbound,
-	type EmailOutbound,
-	type EmailAttachment,
-	type EmailStoredAttachment,
-	type EmailSendParams,
-	type EmailActivityParams,
-	type EmailActivityDataPoint,
-	type EmailActivityResult,
-	type EmailService,
-	EmailStorageService,
-} from './services/email.ts';
+	type ExecuteOptions,
+	type Execution,
+	type ExecutionStatus,
+	type FileToWrite,
+	type ListRuntimesParams,
+	type ListRuntimesResponse,
+	type ListSandboxesParams,
+	type ListSandboxesResponse,
+	type RuntimeSortField,
+	type Sandbox,
+	type SandboxAgentInfo,
+	type SandboxCommand,
+	type SandboxCreateOptions,
+	SandboxError,
+	type SandboxInfo,
+	type SandboxNetworkConfig,
+	type SandboxOrgInfo,
+	type SandboxProjectInfo,
+	type SandboxResources,
+	type SandboxRunOptions,
+	type SandboxRunResult,
+	type SandboxRuntime,
+	type SandboxRuntimeInfo,
+	type SandboxRuntimeRequirements,
+	type SandboxService,
+	type SandboxSnapshotInfo,
+	type SandboxSnapshotInfoPrivate,
+	type SandboxSnapshotInfoPublic,
+	type SandboxSnapshotOrgInfo,
+	type SandboxSnapshotUserInfo,
+	type SandboxSortField,
+	type SandboxStatus,
+	type SandboxStreamConfig,
+	type SandboxTimeoutConfig,
+	type SandboxUserInfo,
+	type SnapshotCreateOptions,
+	// Snapshot types
+	type SnapshotFileInfo,
+	type SnapshotInfo,
+	type SnapshotListParams,
+	type SnapshotListResponse,
+	type SnapshotOrgInfo,
+	type SnapshotService,
+	type SnapshotSortField,
+	type SnapshotUserInfo,
+	type StreamReader,
+} from './services/sandbox.ts';
 export {
-	type Schedule,
-	type ScheduleDestination,
-	type ScheduleDelivery,
-	type CreateScheduleParams,
 	type CreateScheduleDestinationParams,
-	type UpdateScheduleParams,
-	type ScheduleListResult,
-	type ScheduleGetResult,
+	type CreateScheduleParams,
+	type Schedule,
 	type ScheduleCreateResult,
+	type ScheduleDelivery,
 	type ScheduleDeliveryListResult,
+	type ScheduleDestination,
+	type ScheduleGetResult,
+	type ScheduleListResult,
 	ScheduleService,
+	type UpdateScheduleParams,
 } from './services/schedule.ts';
 export {
-	type Webhook,
-	type WebhookDestination,
-	type WebhookReceipt,
-	type WebhookDelivery,
-	type CreateWebhookParams,
-	type UpdateWebhookParams,
-	type CreateWebhookDestinationParams,
-	type WebhookListResult,
-	type WebhookGetResult,
-	type WebhookCreateResult,
-	type WebhookReceiptListResult,
-	type WebhookDeliveryListResult,
-	WebhookService,
-} from './services/webhook.ts';
+	type SessionCompleteEvent,
+	SessionCompleteEventDelayedSchema,
+	SessionCompleteEventSchema,
+	type SessionEventProvider,
+	type SessionStartEvent,
+	SessionStartEventDelayedSchema,
+	SessionStartEventSchema,
+} from './services/session.ts';
 export {
-	type TaskPriority,
-	type TaskType,
-	type TaskStatus,
-	type UserType,
-	type EntityRef,
-	type UserEntityRef,
-	type Task,
-	type Comment,
-	type Tag,
-	type TaskChangelogEntry,
-	type CreateTaskParams,
-	type UpdateTaskParams,
-	type ListTasksParams,
-	type ListTasksResult,
-	type BatchDeleteTasksParams,
+	type CreateStreamProps,
+	type ListStreamsParams,
+	type ListStreamsResponse,
+	STREAM_DEFAULT_TTL_SECONDS,
+	STREAM_MAX_TTL_SECONDS,
+	STREAM_MIN_TTL_SECONDS,
+	type Stream,
+	type StreamInfo,
+	type StreamSortField,
+	type StreamStorage,
+	StreamStorageService,
+} from './services/stream.ts';
+export {
+	type Attachment,
 	type BatchDeletedTask,
+	type BatchDeleteTasksParams,
 	type BatchDeleteTasksResult,
-	type TaskChangelogResult,
+	type Comment,
+	type CreateAttachmentParams,
+	type CreateTaskParams,
+	type EntityRef,
+	type ListAttachmentsResult,
 	type ListCommentsResult,
+	type ListProjectsResult,
 	type ListTagsResult,
+	type ListTasksParams,
+	type ListTasksResult,
 	type ListUsersResult,
-	type ListProjectsResult,
-	type TaskActivityParams,
+	type PresignDownloadResponse,
+	type PresignUploadResponse,
+	type Tag,
+	type Task,
 	type TaskActivityDataPoint,
+	type TaskActivityParams,
 	type TaskActivityResult,
+	type TaskChangelogEntry,
+	type TaskChangelogResult,
+	type TaskPriority,
+	type TaskStatus,
 	type TaskStorage,
-	type Attachment,
-	type CreateAttachmentParams,
-	type PresignUploadResponse,
-	type PresignDownloadResponse,
-	type ListAttachmentsResult,
 	TaskStorageService,
+	type TaskType,
+	type UpdateTaskParams,
+	type UserEntityRef,
+	type UserType,
 } from './services/task.ts';
 export {
-	type EvalRunEventProvider,
-	EvalRunStartEventSchema,
-	EvalRunCompleteEventSchema,
-	EvalRunStartEventDelayedSchema,
-	EvalRunCompleteEventDelayedSchema,
-	type EvalRunStartEvent,
-	type EvalRunCompleteEvent,
-} from './services/evalrun.ts';
+	VECTOR_DEFAULT_TTL_SECONDS,
+	VECTOR_MAX_TTL_SECONDS,
+	VECTOR_MIN_TTL_SECONDS,
+	type VectorGetAllStatsParams,
+	type VectorItemStats,
+	type VectorNamespaceStats,
+	type VectorNamespaceStatsWithSamples,
+	type VectorResult,
+	type VectorResultFound,
+	type VectorResultNotFound,
+	type VectorSearchParams,
+	type VectorSearchResult,
+	type VectorSearchResultWithDocument,
+	type VectorSortField,
+	type VectorStatsPaginated,
+	type VectorStorage,
+	VectorStorageService,
+	type VectorUpsertBase,
+	type VectorUpsertEmbeddings,
+	type VectorUpsertParams,
+	type VectorUpsertResult,
+	type VectorUpsertText,
+} from './services/vector.ts';
 export {
-	type SandboxResources,
-	type SandboxStatus,
-	type SandboxSortField,
-	type SandboxRuntimeRequirements,
-	type SandboxRuntime,
-	type RuntimeSortField,
-	type ExecutionStatus,
-	type StreamReader,
-	type SandboxStreamConfig,
-	type SandboxCommand,
-	type SandboxNetworkConfig,
-	type SandboxTimeoutConfig,
-	type SandboxCreateOptions,
-	type Sandbox,
-	type SandboxInfo,
-	type SandboxRuntimeInfo,
-	type SandboxSnapshotInfo,
-	type SandboxSnapshotInfoPublic,
-	type SandboxSnapshotInfoPrivate,
-	type SandboxSnapshotUserInfo,
-	type SandboxSnapshotOrgInfo,
-	type SnapshotSortField,
-	type SandboxUserInfo,
-	type SandboxAgentInfo,
-	type SandboxProjectInfo,
-	type SandboxOrgInfo,
-	type ListSandboxesParams,
-	type ListSandboxesResponse,
-	type ListRuntimesParams,
-	type ListRuntimesResponse,
-	type ExecuteOptions,
-	type Execution,
-	type SandboxRunOptions,
-	type SandboxRunResult,
-	type SandboxService,
-	type FileToWrite,
-	// Snapshot types
-	type SnapshotFileInfo,
-	type SnapshotOrgInfo,
-	type SnapshotUserInfo,
-	type SnapshotInfo,
-	type SnapshotCreateOptions,
-	type SnapshotListParams,
-	type SnapshotListResponse,
-	type SnapshotService,
-	SandboxError,
-} from './services/sandbox.ts';
-export { buildUrl, toServiceException, toPayload, fromResponse } from './services/_util.ts';
+	type CreateWebhookDestinationParams,
+	type CreateWebhookParams,
+	type UpdateWebhookParams,
+	type Webhook,
+	type WebhookCreateResult,
+	type WebhookDelivery,
+	type WebhookDeliveryListResult,
+	type WebhookDestination,
+	type WebhookGetResult,
+	type WebhookListResult,
+	type WebhookReceipt,
+	type WebhookReceiptListResult,
+	WebhookService,
+} from './services/webhook.ts';
 
 // standard_schema.ts exports
 export type { StandardSchemaV1 } from './standard_schema.ts';
@@ -244,34 +246,35 @@ export { toCamelCase, toPascalCase } from './string.ts';
 
 // typehelper.ts exports
 export type { InferInput, InferOutput } from './typehelper.ts';
-
-// workbench exports
-export {
-	WorkbenchConfigError,
-	WorkbenchNotFoundError,
-	encodeWorkbenchConfig,
-	decodeWorkbenchConfig,
-	getWorkbenchConfig,
-	type WorkbenchConfig,
-} from './workbench-config.ts';
-
 // webrtc.ts exports
 export type {
-	SDPDescription,
-	ICECandidate,
-	SignalMessage,
-	SignalMsg,
-	WebRTCConnectionState,
-	WebRTCDisconnectReason,
+	ConnectionQualitySummary,
 	DataChannelConfig,
 	DataChannelMessage,
 	DataChannelState,
-	WebRTCSignalingCallbacks,
-	ConnectionQualitySummary,
-	RecordingOptions,
+	ICECandidate,
 	RecordingHandle,
+	RecordingOptions,
 	RecordingState,
+	SDPDescription,
+	SignalMessage,
+	SignalMsg,
 	TrackSource,
+	WebRTCConnectionState,
+	WebRTCDisconnectReason,
+	WebRTCSignalingCallbacks,
 } from './webrtc.ts';
+// workbench exports
+export {
+	decodeWorkbenchConfig,
+	encodeWorkbenchConfig,
+	getWorkbenchConfig,
+	type WorkbenchConfig,
+	WorkbenchConfigError,
+	WorkbenchNotFoundError,
+} from './workbench-config.ts';
 
 // Client code moved to @agentuity/frontend for better bundler compatibility
+
+// API client and modules (moved from @agentuity/server)
+export * from './api/index.ts';

package/src/services/email.ts

@@ -743,7 +743,7 @@ export class EmailStorageService implements EmailService {
 	 * ```
 	 */
 	async createAddress(localPart: string): Promise<EmailAddress> {
-		const url = buildUrl(this.#baseUrl, '/email/2025-03-17/addresses');
+		const url = buildUrl(this.#baseUrl, '/email/addresses');
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'POST',
@@ -778,7 +778,7 @@ export class EmailStorageService implements EmailService {
 	 * ```
 	 */
 	async listAddresses(): Promise<EmailAddress[]> {
-		const url = buildUrl(this.#baseUrl, '/email/2025-03-17/addresses');
+		const url = buildUrl(this.#baseUrl, '/email/addresses');
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'GET',
@@ -814,7 +814,7 @@ export class EmailStorageService implements EmailService {
 	 * ```
 	 */
 	async getAddress(id: string): Promise<EmailAddress | null> {
-		const url = buildUrl(this.#baseUrl, `/email/2025-03-17/addresses/${encodeURIComponent(id)}`);
+		const url = buildUrl(this.#baseUrl, `/email/addresses/${encodeURIComponent(id)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'GET',
@@ -855,10 +855,7 @@ export class EmailStorageService implements EmailService {
 	 * ```
 	 */
 	async getConnectionConfig(id: string): Promise<EmailConnectionConfig | null> {
-		const url = buildUrl(
-			this.#baseUrl,
-			`/email/2025-03-17/addresses/${encodeURIComponent(id)}/connection`
-		);
+		const url = buildUrl(this.#baseUrl, `/email/addresses/${encodeURIComponent(id)}/connection`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'GET',
@@ -893,7 +890,7 @@ export class EmailStorageService implements EmailService {
 	 * ```
 	 */
 	async deleteAddress(id: string): Promise<void> {
-		const url = buildUrl(this.#baseUrl, `/email/2025-03-17/addresses/${encodeURIComponent(id)}`);
+		const url = buildUrl(this.#baseUrl, `/email/addresses/${encodeURIComponent(id)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'DELETE',
@@ -940,7 +937,7 @@ export class EmailStorageService implements EmailService {
 	): Promise<EmailDestination> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/email/2025-03-17/addresses/${encodeURIComponent(addressId)}/destinations`
+			`/email/addresses/${encodeURIComponent(addressId)}/destinations`
 		);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
@@ -980,7 +977,7 @@ export class EmailStorageService implements EmailService {
 	async listDestinations(addressId: string): Promise<EmailDestination[]> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/email/2025-03-17/addresses/${encodeURIComponent(addressId)}/destinations`
+			`/email/addresses/${encodeURIComponent(addressId)}/destinations`
 		);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
@@ -1020,7 +1017,7 @@ export class EmailStorageService implements EmailService {
 	async deleteDestination(addressId: string, destinationId: string): Promise<void> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/email/2025-03-17/addresses/${encodeURIComponent(addressId)}/destinations/${encodeURIComponent(destinationId)}`
+			`/email/addresses/${encodeURIComponent(addressId)}/destinations/${encodeURIComponent(destinationId)}`
 		);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
@@ -1073,7 +1070,7 @@ export class EmailStorageService implements EmailService {
 	 * ```
 	 */
 	async send(params: EmailSendParams): Promise<EmailOutbound> {
-		const url = buildUrl(this.#baseUrl, '/email/2025-03-17/outbound/send');
+		const url = buildUrl(this.#baseUrl, '/email/outbound/send');
 		const signal = AbortSignal.timeout(30_000);
 
 		// Transform attachments to API format (snake_case)
@@ -1144,10 +1141,7 @@ export class EmailStorageService implements EmailService {
 			queryParams.set('address_id', addressId);
 		}
 		const queryString = queryParams.toString();
-		const url = buildUrl(
-			this.#baseUrl,
-			`/email/2025-03-17/inbound${queryString ? `?${queryString}` : ''}`
-		);
+		const url = buildUrl(this.#baseUrl, `/email/inbound${queryString ? `?${queryString}` : ''}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'GET',
@@ -1186,7 +1180,7 @@ export class EmailStorageService implements EmailService {
 	 * ```
 	 */
 	async getInbound(id: string): Promise<EmailInbound | null> {
-		const url = buildUrl(this.#baseUrl, `/email/2025-03-17/inbound/${encodeURIComponent(id)}`);
+		const url = buildUrl(this.#baseUrl, `/email/inbound/${encodeURIComponent(id)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'GET',
@@ -1221,7 +1215,7 @@ export class EmailStorageService implements EmailService {
 	 * ```
 	 */
 	async deleteInbound(id: string): Promise<void> {
-		const url = buildUrl(this.#baseUrl, `/email/2025-03-17/inbound/${encodeURIComponent(id)}`);
+		const url = buildUrl(this.#baseUrl, `/email/inbound/${encodeURIComponent(id)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'DELETE',
@@ -1265,10 +1259,7 @@ export class EmailStorageService implements EmailService {
 			queryParams.set('address_id', addressId);
 		}
 		const queryString = queryParams.toString();
-		const url = buildUrl(
-			this.#baseUrl,
-			`/email/2025-03-17/outbound${queryString ? `?${queryString}` : ''}`
-		);
+		const url = buildUrl(this.#baseUrl, `/email/outbound${queryString ? `?${queryString}` : ''}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'GET',
@@ -1309,7 +1300,7 @@ export class EmailStorageService implements EmailService {
 	 * ```
 	 */
 	async getOutbound(id: string): Promise<EmailOutbound | null> {
-		const url = buildUrl(this.#baseUrl, `/email/2025-03-17/outbound/${encodeURIComponent(id)}`);
+		const url = buildUrl(this.#baseUrl, `/email/outbound/${encodeURIComponent(id)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'GET',
@@ -1344,7 +1335,7 @@ export class EmailStorageService implements EmailService {
 	 * ```
 	 */
 	async deleteOutbound(id: string): Promise<void> {
-		const url = buildUrl(this.#baseUrl, `/email/2025-03-17/outbound/${encodeURIComponent(id)}`);
+		const url = buildUrl(this.#baseUrl, `/email/outbound/${encodeURIComponent(id)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'DELETE',