@agentuity/core 1.0.23 → 1.0.25

package/src/services/_util.ts

@@ -2,6 +2,30 @@ import { safeStringify } from '../json.ts';
 import type { Body, HttpMethod } from './adapter.ts';
 import { ServiceException } from './exception.ts';
 
+/**
+ * Extract a human-readable error message from an HTML error page or plain text body.
+ * Looks for content inside `<p>` tags first (Agentuity error pages put the message there),
+ * then falls back to the raw body.
+ */
+function extractMessageFromBody(body: string): string {
+	if (body.includes('<html') || body.includes('<!DOCTYPE')) {
+		// Try to extract message from <p> tags (Agentuity error pages use <p> for the message)
+		const pMatch = /<p[^>]*>([^<]+)<\/p>/i.exec(body);
+		if (pMatch?.[1]) {
+			// Strip ref suffix like "(ref: sess_xxx)" to get clean message
+			const msg = pMatch[1].trim();
+			const refMatch = /^(.+?)\s*\(ref:\s*\S+\)$/.exec(msg);
+			return refMatch?.[1]?.trim() ?? msg;
+		}
+		// Try <h1> as fallback
+		const h1Match = /<h1[^>]*>([^<]+)<\/h1>/i.exec(body);
+		if (h1Match?.[1]) {
+			return h1Match[1].trim();
+		}
+	}
+	return body;
+}
+
 export const buildUrl = (
 	base: string,
 	path: string,
@@ -90,8 +114,10 @@ export async function toServiceException(
 	}
 	try {
 		const body = await response.text();
+		// If the response is HTML (e.g. server error page), extract the human-readable message
+		const message = extractMessageFromBody(body);
 		return new ServiceException({
-			message: body,
+			message,
 			method,
 			url,
 			statusCode: response.status,

package/src/services/email.ts

@@ -36,8 +36,10 @@ export interface EmailInbound {
 	to: string;
 	subject?: string;
 	text?: string;
-	status?: string;
+	html?: string;
 	received_at?: string;
+	headers?: Record<string, unknown>;
+	attachments?: EmailStoredAttachment[];
 }
 
 /**
@@ -52,9 +54,9 @@ export interface EmailOutbound {
 	html?: string;
 	status?: string;
 	error?: string;
-	sent_at?: string;
 	created_at?: string;
-	updated_at?: string;
+	headers?: Record<string, unknown>;
+	attachments?: EmailStoredAttachment[];
 }
 
 /**
@@ -77,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
  */
@@ -110,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>;
 }
 
 /**
@@ -276,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
 	 *
@@ -307,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>;
 }
 
 /**
@@ -382,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',
@@ -407,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',
@@ -525,10 +569,13 @@ export class EmailStorageService implements EmailService {
 		if (params.attachments && params.attachments.length > 0) {
 			body.attachments = params.attachments.map((a) => ({
 				filename: a.filename,
-				content_base64: a.content,
+				content: a.content,
 				...(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',
@@ -581,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',
@@ -605,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) {
@@ -637,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',
@@ -660,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';