@agentuity/core 1.0.24 → 1.0.26

package/src/services/email.ts

@@ -8,8 +8,6 @@ import { safeStringify } from '../json.ts';
 export interface EmailAddress {
 	id: string;
 	email: string;
-	project_id?: string;
-	provider?: string;
 	config?: Record<string, unknown>;
 	created_by?: string;
 	created_at: string;
@@ -27,6 +25,20 @@ export interface EmailDestination {
 	updated_at?: string;
 }
 
+export interface EmailProtocolConfig {
+	host: string;
+	port: number;
+	tls: string;
+	username: string;
+	password: string;
+}
+
+export interface EmailConnectionConfig {
+	email: string;
+	imap: EmailProtocolConfig;
+	pop3: EmailProtocolConfig;
+}
+
 /**
  * An inbound email message
  */
@@ -39,7 +51,7 @@ export interface EmailInbound {
 	html?: string;
 	received_at?: string;
 	headers?: Record<string, unknown>;
-	attachments?: unknown[];
+	attachments?: EmailStoredAttachment[];
 }
 
 /**
@@ -56,7 +68,7 @@ export interface EmailOutbound {
 	error?: string;
 	created_at?: string;
 	headers?: Record<string, unknown>;
-	attachments?: unknown[];
+	attachments?: EmailStoredAttachment[];
 }
 
 /**
@@ -79,6 +91,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 +143,11 @@ export interface EmailSendParams {
 	 * File attachments
 	 */
 	attachments?: EmailAttachment[];
+
+	/**
+	 * Custom email headers (e.g., In-Reply-To, References for threading)
+	 */
+	headers?: Record<string, string>;
 }
 
 /**
@@ -163,6 +199,14 @@ export interface EmailService {
 	 */
 	getAddress(id: string): Promise<EmailAddress | null>;
 
+	/**
+	 * Get email connection settings (IMAP/POP3) for an address
+	 *
+	 * @param id - the email address ID
+	 * @returns the connection configuration or null if not found
+	 */
+	getConnectionConfig(id: string): Promise<EmailConnectionConfig | null>;
+
 	/**
 	 * Delete an email address
 	 *
@@ -278,6 +322,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 +365,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 +452,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',
@@ -408,12 +473,34 @@ export class EmailStorageService implements EmailService {
 		throw await toServiceException('GET', url, res.response);
 	}
 
-	async deleteAddress(id: string): Promise<void> {
+	async getConnectionConfig(id: string): Promise<EmailConnectionConfig | null> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/email/2025-03-17/addresses/${encodeURIComponent(id)}`
+			`/email/2025-03-17/addresses/${encodeURIComponent(id)}/connection`
 		);
 		const signal = AbortSignal.timeout(30_000);
+		const res = await this.#adapter.invoke<unknown>(url, {
+			method: 'GET',
+			signal,
+			telemetry: {
+				name: 'agentuity.email.getConnectionConfig',
+				attributes: {
+					id,
+				},
+			},
+		});
+		if (res.response.status === 404) {
+			return null;
+		}
+		if (res.ok) {
+			return unwrap<EmailConnectionConfig>(res.data, 'connection');
+		}
+		throw await toServiceException('GET', url, res.response);
+	}
+
+	async deleteAddress(id: string): Promise<void> {
+		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',
 			signal,
@@ -531,6 +618,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 +673,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 +694,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 +745,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 +765,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';