@agentuity/core 1.0.24 → 1.0.25

package/src/services/email.ts

@@ -39,7 +39,7 @@ export interface EmailInbound {
 	html?: string;
 	received_at?: string;
 	headers?: Record<string, unknown>;
-	attachments?: unknown[];
+	attachments?: EmailStoredAttachment[];
 }
 
 /**
@@ -56,7 +56,7 @@ export interface EmailOutbound {
 	error?: string;
 	created_at?: string;
 	headers?: Record<string, unknown>;
-	attachments?: unknown[];
+	attachments?: EmailStoredAttachment[];
 }
 
 /**
@@ -79,6 +79,25 @@ export interface EmailAttachment {
 	contentType?: string;
 }
 
+/**
+ * A stored email attachment with S3 location metadata.
+ * Returned by inbound/outbound email queries — different from EmailAttachment used for sending.
+ */
+export interface EmailStoredAttachment {
+	/** The original filename */
+	filename: string;
+	/** The MIME content type */
+	content_type?: string;
+	/** File size in bytes */
+	size: number;
+	/** The S3 bucket name where the attachment is stored */
+	bucket: string;
+	/** The S3 object key */
+	key: string;
+	/** Optional pre-signed download URL */
+	url?: string;
+}
+
 /**
  * Parameters for sending an email
  */
@@ -112,6 +131,11 @@ export interface EmailSendParams {
 	 * File attachments
 	 */
 	attachments?: EmailAttachment[];
+
+	/**
+	 * Custom email headers (e.g., In-Reply-To, References for threading)
+	 */
+	headers?: Record<string, string>;
 }
 
 /**
@@ -278,6 +302,18 @@ export interface EmailService {
 	 */
 	getInbound(id: string): Promise<EmailInbound | null>;
 
+	/**
+	 * Delete an inbound email by ID
+	 *
+	 * @param id - the inbound email ID
+	 *
+	 * @example
+	 * ```typescript
+	 * await email.deleteInbound('inb_abc123');
+	 * ```
+	 */
+	deleteInbound(id: string): Promise<void>;
+
 	/**
 	 * List outbound emails
 	 *
@@ -309,6 +345,18 @@ export interface EmailService {
 	 * ```
 	 */
 	getOutbound(id: string): Promise<EmailOutbound | null>;
+
+	/**
+	 * Delete an outbound email by ID
+	 *
+	 * @param id - the outbound email ID
+	 *
+	 * @example
+	 * ```typescript
+	 * await email.deleteOutbound('out_abc123');
+	 * ```
+	 */
+	deleteOutbound(id: string): Promise<void>;
 }
 
 /**
@@ -384,10 +432,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/2025-03-17/addresses/${encodeURIComponent(id)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'GET',
@@ -409,10 +454,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/2025-03-17/addresses/${encodeURIComponent(id)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'DELETE',
@@ -531,6 +573,9 @@ export class EmailStorageService implements EmailService {
 				...(a.contentType && { content_type: a.contentType }),
 			}));
 		}
+		if (params.headers && Object.keys(params.headers).length > 0) {
+			body.headers = params.headers;
+		}
 
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'POST',
@@ -583,10 +628,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/2025-03-17/inbound/${encodeURIComponent(id)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'GET',
@@ -607,6 +649,25 @@ export class EmailStorageService implements EmailService {
 		throw await toServiceException('GET', url, res.response);
 	}
 
+	async deleteInbound(id: string): Promise<void> {
+		const url = buildUrl(this.#baseUrl, `/email/2025-03-17/inbound/${encodeURIComponent(id)}`);
+		const signal = AbortSignal.timeout(30_000);
+		const res = await this.#adapter.invoke<unknown>(url, {
+			method: 'DELETE',
+			signal,
+			telemetry: {
+				name: 'agentuity.email.deleteInbound',
+				attributes: {
+					id,
+				},
+			},
+		});
+		if (res.ok || res.response.status === 404) {
+			return;
+		}
+		throw await toServiceException('DELETE', url, res.response);
+	}
+
 	async listOutbound(addressId?: string): Promise<EmailOutbound[]> {
 		const queryParams = new URLSearchParams();
 		if (addressId) {
@@ -639,10 +700,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/2025-03-17/outbound/${encodeURIComponent(id)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<unknown>(url, {
 			method: 'GET',
@@ -662,4 +720,23 @@ export class EmailStorageService implements EmailService {
 		}
 		throw await toServiceException('GET', url, res.response);
 	}
+
+	async deleteOutbound(id: string): Promise<void> {
+		const url = buildUrl(this.#baseUrl, `/email/2025-03-17/outbound/${encodeURIComponent(id)}`);
+		const signal = AbortSignal.timeout(30_000);
+		const res = await this.#adapter.invoke<unknown>(url, {
+			method: 'DELETE',
+			signal,
+			telemetry: {
+				name: 'agentuity.email.deleteOutbound',
+				attributes: {
+					id,
+				},
+			},
+		});
+		if (res.ok || res.response.status === 404) {
+			return;
+		}
+		throw await toServiceException('DELETE', url, res.response);
+	}
 }

package/src/services/index.ts

@@ -9,5 +9,23 @@ export * from './session.ts';
 export * from './stream.ts';
 export * from './task.ts';
 export * from './vector.ts';
+export { WebhookService } from './webhook.ts';
+export type {
+	Webhook,
+	WebhookDestination,
+	WebhookReceipt,
+	WebhookDelivery,
+	CreateWebhookParams,
+	UpdateWebhookParams,
+	CreateWebhookDestinationParams,
+	WebhookListResult,
+	WebhookGetResult,
+	WebhookCreateResult,
+	UpdateWebhookResult,
+	CreateDestinationResult,
+	ListDestinationsResult,
+	WebhookReceiptListResult,
+	WebhookDeliveryListResult,
+} from './webhook.ts';
 export * from './email.ts';
 export { buildUrl, toServiceException, toPayload, fromResponse } from './_util.ts';