@agentuity/runtime 0.0.103 → 0.0.105

package/src/workbench.ts

@@ -3,7 +3,7 @@ import { timingSafeEqual } from 'node:crypto';
 import { toJSONSchema } from '@agentuity/server';
 import { getAgents, createAgentMiddleware } from './agent';
 import { createRouter } from './router';
-import type { WebSocketConnection } from './router';
+import { websocket, type WebSocketConnection } from './handlers/websocket';
 import { privateContext } from './_server';
 import { getThreadProvider } from './_services';
 import { loadBuildMetadata, getAgentMetadataByAgentId, hasMetadata } from './_metadata';
@@ -255,7 +255,7 @@ export const createWorkbenchRouter = () => {
 	router.use('/_agentuity/workbench/*', createAgentMiddleware(''));
 
 	// Add workbench routes
-	router.websocket('/_agentuity/workbench/ws', createWorkbenchWebsocketRoute());
+	router.get('/_agentuity/workbench/ws', websocket(createWorkbenchWebsocketHandler()));
 	router.get('/_agentuity/workbench/metadata.json', createWorkbenchMetadataRoute());
 	router.get('/_agentuity/workbench/sample', createWorkbenchSampleRoute());
 	router.get('/_agentuity/workbench/state', createWorkbenchStateRoute());
@@ -506,35 +506,38 @@ export const createWorkbenchMetadataRoute = (): Handler => {
 // Store WebSocket connections to notify them on app restart
 const workbenchWebSockets = new Set<WebSocketConnection>();
 
-export const createWorkbenchWebsocketRoute = () => {
-	return (_ctx: Context) => {
-		return (ws: WebSocketConnection) => {
-			ws.onOpen(() => {
-				workbenchWebSockets.add(ws);
-				ws.send('alive');
-			});
+export const createWorkbenchWebsocketHandler = () => {
+	return (_c: Context, ws: WebSocketConnection) => {
+		ws.onOpen(() => {
+			workbenchWebSockets.add(ws);
+			ws.send('alive');
+		});
 
-			ws.onMessage((event) => {
-				const message = event.data;
-
-				// If a client sends a message (CLI), broadcast to all other clients
-				if (message === 'restarting' || message === 'alive') {
-					// Broadcast the message to all other clients (excluding this CLI connection)
-					for (const clientWs of workbenchWebSockets) {
-						if (clientWs !== ws) {
-							try {
-								clientWs.send(message);
-							} catch (_error) {
-								workbenchWebSockets.delete(clientWs);
-							}
+		ws.onMessage((event) => {
+			const message = (event as MessageEvent).data;
+
+			// If a client sends a message (CLI), broadcast to all other clients
+			if (message === 'restarting' || message === 'alive') {
+				// Broadcast the message to all other clients (excluding this CLI connection)
+				for (const clientWs of workbenchWebSockets) {
+					if (clientWs !== ws) {
+						try {
+							clientWs.send(message);
+						} catch (_error) {
+							workbenchWebSockets.delete(clientWs);
 						}
 					}
 				}
-			});
+			}
+		});
 
-			ws.onClose(() => {
-				workbenchWebSockets.delete(ws);
-			});
-		};
+		ws.onClose(() => {
+			workbenchWebSockets.delete(ws);
+		});
 	};
 };
+
+/**
+ * @deprecated Use createWorkbenchWebsocketHandler instead
+ */
+export const createWorkbenchWebsocketRoute = createWorkbenchWebsocketHandler;

package/dist/io/email.d.ts

@@ -1,77 +0,0 @@
-import { type ParsedMail, type Headers } from 'mailparser';
-/**
- * A class representing an email with common information for processing.
- *
- * This class wraps the parsed email message and provides convenient accessor methods
- * for common email properties like subject, sender, recipient, body content, etc.
- */
-export declare class Email {
-    private readonly _message;
-    constructor(data: ParsedMail);
-    toString(): string;
-    /**
-     * The date of the email.
-     */
-    date(): Date | null;
-    /**
-     * The message ID of the email.
-     */
-    messageId(): string | null;
-    /**
-     * The headers of the email.
-     */
-    headers(): Headers;
-    /**
-     * The email address of the recipient or null if there is no recipient.
-     *
-     * If the email has multiple recipients, the email addresses are comma separated.
-     */
-    to(): string | null;
-    /**
-     * The email address of the sender or null if there is no sender.
-     */
-    fromEmail(): string | null;
-    /**
-     * The name of the sender or null if there is no name.
-     */
-    fromName(): string | null;
-    /**
-     * The email address of the first recipient or null if there is no recipient.
-     */
-    toEmail(): string | null;
-    /**
-     * The name of the first recipient or null if there is no name.
-     */
-    toName(): string | null;
-    /**
-     * The subject of the email or null if there is no subject.
-     */
-    subject(): string | null;
-    /**
-     * The plain text body of the email or null if there is no plain text body.
-     */
-    text(): string | null;
-    /**
-     * The HTML body of the email or null if there is no HTML body.
-     */
-    html(): string | null;
-    /**
-     * The attachments of the email or an empty array if there are no attachments.
-     *
-     * Note: Attachment handling is minimal in this implementation.
-     * For full attachment support with SSRF protection, see the sdk-js implementation.
-     */
-    attachments(): Array<{
-        filename: string;
-        contentType: string;
-    }>;
-}
-/**
- * Parse an email from a buffer and return an Email object.
- *
- * @param data - The raw RFC822 email message as a Buffer
- * @returns A promise that resolves to an Email object
- * @throws Error if the email cannot be parsed or if the input is not a valid RFC822 message
- */
-export declare function parseEmail(data: Buffer): Promise<Email>;
-//# sourceMappingURL=email.d.ts.map

package/dist/io/email.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/io/email.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAoC,MAAM,YAAY,CAAC;AAE7F;;;;;GAKG;AACH,qBAAa,KAAK;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;gBAE1B,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,IAAI,IAAI,IAAI,GAAG,IAAI;IAInB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;OAIG;IACH,EAAE,IAAI,MAAM,GAAG,IAAI;IAgBnB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI;IAaxB;;OAEG;IACH,MAAM,IAAI,MAAM,GAAG,IAAI;IAavB;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACH,IAAI,IAAI,MAAM,GAAG,IAAI;IAIrB;;OAEG;IACH,IAAI,IAAI,MAAM,GAAG,IAAI;IAIrB;;;;;OAKG;IACH,WAAW,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAS/D;AAiBD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAsB7D"}

package/dist/io/email.js

@@ -1,162 +0,0 @@
-import { StructuredError } from '@agentuity/core';
-import { simpleParser } from 'mailparser';
-/**
- * A class representing an email with common information for processing.
- *
- * This class wraps the parsed email message and provides convenient accessor methods
- * for common email properties like subject, sender, recipient, body content, etc.
- */
-export class Email {
-    _message;
-    constructor(data) {
-        this._message = data;
-    }
-    toString() {
-        return `[Email id=${this.messageId()},from=${this.fromEmail()},subject=${this.subject()}]`;
-    }
-    /**
-     * The date of the email.
-     */
-    date() {
-        return this._message.date ?? null;
-    }
-    /**
-     * The message ID of the email.
-     */
-    messageId() {
-        return this._message.messageId ?? null;
-    }
-    /**
-     * The headers of the email.
-     */
-    headers() {
-        return this._message.headers;
-    }
-    /**
-     * The email address of the recipient or null if there is no recipient.
-     *
-     * If the email has multiple recipients, the email addresses are comma separated.
-     */
-    to() {
-        if (!this._message.to) {
-            return null;
-        }
-        if (Array.isArray(this._message.to)) {
-            return this._message.to
-                .map((addr) => (addr.text ?? '').trim())
-                .filter((text) => text.length > 0)
-                .join(', ');
-        }
-        if (typeof this._message.to === 'object' && 'text' in this._message.to) {
-            return this._message.to.text ? this._message.to.text.trim() : null;
-        }
-        return null;
-    }
-    /**
-     * The email address of the sender or null if there is no sender.
-     */
-    fromEmail() {
-        return this._message.from?.value[0]?.address ?? null;
-    }
-    /**
-     * The name of the sender or null if there is no name.
-     */
-    fromName() {
-        return this._message.from?.value[0]?.name ?? null;
-    }
-    /**
-     * The email address of the first recipient or null if there is no recipient.
-     */
-    toEmail() {
-        if (!this._message.to) {
-            return null;
-        }
-        if (Array.isArray(this._message.to)) {
-            return this._message.to[0]?.value[0]?.address ?? null;
-        }
-        if (typeof this._message.to === 'object' && 'value' in this._message.to) {
-            return this._message.to.value[0]?.address ?? null;
-        }
-        return null;
-    }
-    /**
-     * The name of the first recipient or null if there is no name.
-     */
-    toName() {
-        if (!this._message.to) {
-            return null;
-        }
-        if (Array.isArray(this._message.to)) {
-            return this._message.to[0]?.value[0]?.name ?? null;
-        }
-        if (typeof this._message.to === 'object' && 'value' in this._message.to) {
-            return this._message.to.value[0]?.name ?? null;
-        }
-        return null;
-    }
-    /**
-     * The subject of the email or null if there is no subject.
-     */
-    subject() {
-        return this._message.subject ?? null;
-    }
-    /**
-     * The plain text body of the email or null if there is no plain text body.
-     */
-    text() {
-        return this._message.text ?? null;
-    }
-    /**
-     * The HTML body of the email or null if there is no HTML body.
-     */
-    html() {
-        return this._message.html ? this._message.html : null;
-    }
-    /**
-     * The attachments of the email or an empty array if there are no attachments.
-     *
-     * Note: Attachment handling is minimal in this implementation.
-     * For full attachment support with SSRF protection, see the sdk-js implementation.
-     */
-    attachments() {
-        if (!this._message.attachments || this._message.attachments.length === 0) {
-            return [];
-        }
-        return this._message.attachments.map((att) => ({
-            filename: att.filename ?? 'unknown',
-            contentType: att.contentType ?? 'application/octet-stream',
-        }));
-    }
-}
-const InvalidEmailEmptyError = StructuredError('InvalidEmailEmptyError', 'Failed to parse email: empty buffer');
-const InvalidEmailHeadersError = StructuredError('InvalidEmailHeadersError', 'Failed to parse email: missing headers');
-const InvalidEmailParseError = StructuredError('InvalidEmailParseError', 'Failed to parse email: body was invalid')();
-/**
- * Parse an email from a buffer and return an Email object.
- *
- * @param data - The raw RFC822 email message as a Buffer
- * @returns A promise that resolves to an Email object
- * @throws Error if the email cannot be parsed or if the input is not a valid RFC822 message
- */
-export async function parseEmail(data) {
-    if (data.length === 0) {
-        throw new InvalidEmailEmptyError();
-    }
-    const first16KB = data.slice(0, 16384).toString('utf-8', 0, Math.min(data.length, 16384));
-    const hasHeaders = /(^|\r?\n)[!-9;-~]+:\s/.test(first16KB);
-    if (!hasHeaders) {
-        throw new InvalidEmailHeadersError();
-    }
-    try {
-        const message = await simpleParser(data);
-        return new Email(message);
-    }
-    catch (error) {
-        throw new InvalidEmailParseError({
-            bufferSize: data.length,
-            preview: data.subarray(0, 50).toString('hex'),
-            cause: error,
-        });
-    }
-}
-//# sourceMappingURL=email.js.map

package/dist/io/email.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/io/email.ts"],"names":[],"mappings":"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"}

package/src/io/email.ts

@@ -1,191 +0,0 @@
-import { StructuredError } from '@agentuity/core';
-import { type ParsedMail, type Headers, simpleParser, type AddressObject } from 'mailparser';
-
-/**
- * A class representing an email with common information for processing.
- *
- * This class wraps the parsed email message and provides convenient accessor methods
- * for common email properties like subject, sender, recipient, body content, etc.
- */
-export class Email {
-	private readonly _message: ParsedMail;
-
-	constructor(data: ParsedMail) {
-		this._message = data;
-	}
-
-	toString(): string {
-		return `[Email id=${this.messageId()},from=${this.fromEmail()},subject=${this.subject()}]`;
-	}
-
-	/**
-	 * The date of the email.
-	 */
-	date(): Date | null {
-		return this._message.date ?? null;
-	}
-
-	/**
-	 * The message ID of the email.
-	 */
-	messageId(): string | null {
-		return this._message.messageId ?? null;
-	}
-
-	/**
-	 * The headers of the email.
-	 */
-	headers(): Headers {
-		return this._message.headers;
-	}
-
-	/**
-	 * The email address of the recipient or null if there is no recipient.
-	 *
-	 * If the email has multiple recipients, the email addresses are comma separated.
-	 */
-	to(): string | null {
-		if (!this._message.to) {
-			return null;
-		}
-		if (Array.isArray(this._message.to)) {
-			return this._message.to
-				.map((addr: AddressObject) => (addr.text ?? '').trim())
-				.filter((text: string) => text.length > 0)
-				.join(', ');
-		}
-		if (typeof this._message.to === 'object' && 'text' in this._message.to) {
-			return this._message.to.text ? this._message.to.text.trim() : null;
-		}
-		return null;
-	}
-
-	/**
-	 * The email address of the sender or null if there is no sender.
-	 */
-	fromEmail(): string | null {
-		return this._message.from?.value[0]?.address ?? null;
-	}
-
-	/**
-	 * The name of the sender or null if there is no name.
-	 */
-	fromName(): string | null {
-		return this._message.from?.value[0]?.name ?? null;
-	}
-
-	/**
-	 * The email address of the first recipient or null if there is no recipient.
-	 */
-	toEmail(): string | null {
-		if (!this._message.to) {
-			return null;
-		}
-		if (Array.isArray(this._message.to)) {
-			return this._message.to[0]?.value[0]?.address ?? null;
-		}
-		if (typeof this._message.to === 'object' && 'value' in this._message.to) {
-			return this._message.to.value[0]?.address ?? null;
-		}
-		return null;
-	}
-
-	/**
-	 * The name of the first recipient or null if there is no name.
-	 */
-	toName(): string | null {
-		if (!this._message.to) {
-			return null;
-		}
-		if (Array.isArray(this._message.to)) {
-			return this._message.to[0]?.value[0]?.name ?? null;
-		}
-		if (typeof this._message.to === 'object' && 'value' in this._message.to) {
-			return this._message.to.value[0]?.name ?? null;
-		}
-		return null;
-	}
-
-	/**
-	 * The subject of the email or null if there is no subject.
-	 */
-	subject(): string | null {
-		return this._message.subject ?? null;
-	}
-
-	/**
-	 * The plain text body of the email or null if there is no plain text body.
-	 */
-	text(): string | null {
-		return this._message.text ?? null;
-	}
-
-	/**
-	 * The HTML body of the email or null if there is no HTML body.
-	 */
-	html(): string | null {
-		return this._message.html ? this._message.html : null;
-	}
-
-	/**
-	 * The attachments of the email or an empty array if there are no attachments.
-	 *
-	 * Note: Attachment handling is minimal in this implementation.
-	 * For full attachment support with SSRF protection, see the sdk-js implementation.
-	 */
-	attachments(): Array<{ filename: string; contentType: string }> {
-		if (!this._message.attachments || this._message.attachments.length === 0) {
-			return [];
-		}
-		return this._message.attachments.map((att: { filename?: string; contentType?: string }) => ({
-			filename: att.filename ?? 'unknown',
-			contentType: att.contentType ?? 'application/octet-stream',
-		}));
-	}
-}
-
-const InvalidEmailEmptyError = StructuredError(
-	'InvalidEmailEmptyError',
-	'Failed to parse email: empty buffer'
-);
-
-const InvalidEmailHeadersError = StructuredError(
-	'InvalidEmailHeadersError',
-	'Failed to parse email: missing headers'
-);
-
-const InvalidEmailParseError = StructuredError(
-	'InvalidEmailParseError',
-	'Failed to parse email: body was invalid'
-)<{ bufferSize: number; preview?: string }>();
-
-/**
- * Parse an email from a buffer and return an Email object.
- *
- * @param data - The raw RFC822 email message as a Buffer
- * @returns A promise that resolves to an Email object
- * @throws Error if the email cannot be parsed or if the input is not a valid RFC822 message
- */
-export async function parseEmail(data: Buffer): Promise<Email> {
-	if (data.length === 0) {
-		throw new InvalidEmailEmptyError();
-	}
-
-	const first16KB = data.slice(0, 16384).toString('utf-8', 0, Math.min(data.length, 16384));
-	const hasHeaders = /(^|\r?\n)[!-9;-~]+:\s/.test(first16KB);
-
-	if (!hasHeaders) {
-		throw new InvalidEmailHeadersError();
-	}
-
-	try {
-		const message = await simpleParser(data);
-		return new Email(message);
-	} catch (error) {
-		throw new InvalidEmailParseError({
-			bufferSize: data.length,
-			preview: data.subarray(0, 50).toString('hex'),
-			cause: error,
-		});
-	}
-}