@framers/agentos-ext-channel-email 0.1.2 → 0.2.1

package/dist/ResendTransport.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @fileoverview A transport for Resend's HTTPS API: one `POST /emails` a message, the API key as the bearer, an
+ * `Idempotency-Key` when the caller gives one, the text and the HTML part in one call, and Resend's own retry terms
+ * inside one deadline. A refusal keeps the status and Resend's error name, never its message, which can quote an
+ * address.
+ */
+/**
+ * An attachment path Resend fetches the file from itself: an `http:` or `https:` address. The agent surfaces'
+ * attachment check passes an address by this same test, so an address it passes is never read here.
+ */
+export declare const REMOTE_ADDRESS: RegExp;
+/** What the transport needs: the key, and where and as what it calls. */
+export interface ResendOptions {
+    /**
+     * The API key, or a function that answers it at each send (a key file read when a message goes out). Whitespace around
+     * it, such as a key file's final line break, is trimmed.
+     */
+    apiKey: string | (() => string);
+    /** The API's origin with no trailing slash; Resend's own when unset. */
+    baseUrl?: string;
+    /** The `User-Agent` every request carries, which Resend requires; the pack's name when unset. */
+    userAgent?: string;
+    /** The longest one send may take, its retries and their waits included; fifteen seconds when unset. */
+    timeoutMs?: number;
+    /** The most retries one send makes; two when unset. */
+    maxRetries?: number;
+}
+/**
+ * One file sent with a message: its `content` (Base64 on the wire), or a `path`. An `http:` or `https:` path is the
+ * address Resend fetches the file from; a `data:` address or a file on this host is read here and sent as content, as
+ * nodemailer reads both over SMTP. With `content` given, a path Resend cannot fetch is left out. This process reads a
+ * file path, so it must come from the developer's code and never from a model's output: the pack's `emailSend` tool
+ * and channel adapter accept only `content`, `data:` addresses and, through Resend, `http(s)` addresses.
+ */
+export interface OutgoingAttachment {
+    filename: string;
+    content?: string | Buffer;
+    path?: string;
+    contentType?: string;
+}
+/** One message as the transport sends it. */
+export interface OutgoingEmail {
+    /** The From header; a display name is allowed, as in "Example <hello@example.com>". */
+    from: string;
+    /** The one recipient. */
+    to: string;
+    subject: string;
+    /** The plain-text part. */
+    text: string;
+    /** The HTML part, sent in the same call. */
+    html?: string;
+    replyTo?: string;
+    cc?: string;
+    bcc?: string;
+    /** Headers added to the message, such as `In-Reply-To` and `References` for a reply. */
+    headers?: Record<string, string>;
+    /**
+     * Resend's `Idempotency-Key`: a second request under the same key within 24 hours delivers nothing more. At most 256
+     * characters, and never personal data.
+     */
+    idempotencyKey?: string;
+    attachments?: OutgoingAttachment[];
+}
+/** A send Resend answered outside 2xx: its status, Resend's error name (`unknown` when it named none) and the wait it asked for. */
+export declare class EmailApiError extends Error {
+    /** The type's own name. */
+    name: string;
+    /** The HTTP status Resend answered with. */
+    readonly status: number;
+    /** Resend's error name, such as `rate_limit_exceeded`, or `unknown`. */
+    readonly type: string;
+    /** The seconds the answer's `retry-after` header asked for, or null. */
+    readonly retryAfterSeconds: number | null;
+    constructor(status: number, type: string, retryAfterSeconds: number | null);
+}
+/**
+ * The wait before the next try, in seconds, or null when the refusal is not tried again: a rate limit always (it was
+ * refused before anything was sent), and under an idempotency key a 409 `concurrent_idempotent_requests` and any 5xx,
+ * which Resend's errors page answers with "Try the request again later"; never a quota, a validation error or
+ * `invalid_idempotent_request`. The wait is the answer's `retry-after`, else one second, then two.
+ */
+export declare function retryWaitSeconds(error: EmailApiError, keyed: boolean, retry: number): number | null;
+/** Resend's send call. */
+export declare class ResendTransport {
+    private readonly options;
+    constructor(options: ResendOptions);
+    /**
+     * Sends one message: the key read once and trimmed, then `POST /emails`, tried again on Resend's terms while the
+     * deadline allows. Throws an `Error` before any request when the key, the idempotency key or the User-Agent holds a
+     * character an HTTP header cannot carry, with a message that names the field and none of its value; `EmailApiError`
+     * for a refusal; and what `fetch` throws for a connection that fails (`TypeError`) or the deadline (`TimeoutError`),
+     * so a caller can tell them apart. A 2xx answer always resolves, since Resend has taken the email: its `messageId` is
+     * the empty string when the answer names no id or its body cannot be read before the deadline. An attachment from a
+     * `data:` address or a file on this host is read first, before the deadline starts; a file that cannot be read throws
+     * its own error before any request.
+     */
+    send(message: OutgoingEmail): Promise<{
+        messageId: string;
+    }>;
+}
+//# sourceMappingURL=ResendTransport.d.ts.map

package/dist/ResendTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResendTransport.d.ts","sourceRoot":"","sources":["../src/ResendTransport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAkB,CAAC;AAK9C,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAChC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED,oIAAoI;AACpI,qBAAa,aAAc,SAAQ,KAAK;IACtC,2BAA2B;IAClB,IAAI,SAAmB;IAEhC,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wEAAwE;IACxE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAE9B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnG;AAsFD,0BAA0B;AAC1B,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,OAAO,EAAE,aAAa;IAIlC;;;;;;;;;OASG;IACG,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAwBnE"}

package/dist/ResendTransport.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * @fileoverview A transport for Resend's HTTPS API: one `POST /emails` a message, the API key as the bearer, an
+ * `Idempotency-Key` when the caller gives one, the text and the HTML part in one call, and Resend's own retry terms
+ * inside one deadline. A refusal keeps the status and Resend's error name, never its message, which can quote an
+ * address.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResendTransport = exports.EmailApiError = exports.REMOTE_ADDRESS = void 0;
+exports.retryWaitSeconds = retryWaitSeconds;
+const promises_1 = require("node:fs/promises");
+/** Resend's API origin. */
+const RESEND_API = 'https://api.resend.com';
+/** The `User-Agent` sent when the caller names none: Resend refuses a request without one. */
+const DEFAULT_USER_AGENT = 'agentos-ext-channel-email';
+/** The longest one send may take when the caller names no deadline, retries and their waits included. */
+const DEFAULT_TIMEOUT_MS = 15000;
+/** The retries one send makes at most when the caller names no number. */
+const DEFAULT_MAX_RETRIES = 2;
+/** The shape of an error name Resend gives, such as `validation_error`; any other value is read as `unknown`. */
+const ERROR_NAME = /^[A-Za-z0-9_.:-]{1,64}$/;
+/**
+ * A character an HTTP header value cannot carry through Node's `fetch` (undici), whose own header check this is: only a
+ * tab, a space, the visible ASCII characters and U+0080 to U+00FF pass. `Headers` throws a `TypeError` for a character
+ * above U+00FF and for a NUL, CR or LF inside the value (that one quoting the whole value, key and all), and the
+ * request fails for any other control character.
+ */
+const NOT_A_HEADER_CHARACTER = /[^\t\x20-\x7e\x80-\xff]/;
+/**
+ * An attachment path Resend fetches the file from itself: an `http:` or `https:` address. The agent surfaces'
+ * attachment check passes an address by this same test, so an address it passes is never read here.
+ */
+exports.REMOTE_ADDRESS = /^https?:\/\//i;
+/** A `data:` address, which holds its attachment's bytes in itself. */
+const DATA_ADDRESS = /^data:/i;
+/** A send Resend answered outside 2xx: its status, Resend's error name (`unknown` when it named none) and the wait it asked for. */
+class EmailApiError extends Error {
+    constructor(status, type, retryAfterSeconds) {
+        super(`Resend refused the email with ${status} ${type}`);
+        /** The type's own name. */
+        this.name = 'EmailApiError';
+        this.status = status;
+        this.type = type;
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+exports.EmailApiError = EmailApiError;
+/**
+ * The wait before the next try, in seconds, or null when the refusal is not tried again: a rate limit always (it was
+ * refused before anything was sent), and under an idempotency key a 409 `concurrent_idempotent_requests` and any 5xx,
+ * which Resend's errors page answers with "Try the request again later"; never a quota, a validation error or
+ * `invalid_idempotent_request`. The wait is the answer's `retry-after`, else one second, then two.
+ */
+function retryWaitSeconds(error, keyed, retry) {
+    const tryAgain = error.type === 'rate_limit_exceeded' || (keyed && (error.type === 'concurrent_idempotent_requests' || error.status >= 500));
+    return tryAgain ? (error.retryAfterSeconds ?? retry) : null;
+}
+/** The answer's `retry-after` in seconds, or null when it is absent or not a number of seconds. */
+function retryAfterOf(headers) {
+    const raw = headers.get('retry-after');
+    if (raw === null || raw.trim() === '')
+        return null;
+    const seconds = Number(raw);
+    return Number.isFinite(seconds) && seconds >= 0 ? seconds : null;
+}
+/** A refusal read from Resend's answer: the status, the error's name when it is a word, the wait; the rest dropped. */
+async function refusalOf(answer) {
+    let type = 'unknown';
+    try {
+        const body = await answer.json();
+        const name = typeof body === 'object' && body !== null && 'name' in body ? body.name : undefined;
+        if (typeof name === 'string' && ERROR_NAME.test(name))
+            type = name;
+    }
+    catch {
+        // not JSON: the name stays unknown
+    }
+    return new EmailApiError(answer.status, type, retryAfterOf(answer.headers));
+}
+/**
+ * The message's id from a 2xx answer, or the empty string when the answer's body names none or cannot be read (not
+ * JSON, no `id`, or cut off by the deadline). A 2xx means Resend took the email, so the send still succeeds: a failure
+ * reported here would lead a caller to send the email a second time.
+ */
+async function messageIdOf(answer) {
+    try {
+        const body = await answer.json();
+        const id = typeof body === 'object' && body !== null && 'id' in body ? body.id : undefined;
+        return typeof id === 'string' ? id : '';
+    }
+    catch {
+        return '';
+    }
+}
+/** What a path Resend cannot fetch holds: a `data:` address decoded, with its media type, or a file on this host read. */
+async function readAttachment(path) {
+    if (DATA_ADDRESS.test(path)) {
+        // fetch decodes a data: address itself, Base64 or percent-encoded, by the Fetch standard's data: URL processor.
+        const decoded = await fetch(path);
+        return { bytes: Buffer.from(await decoded.arrayBuffer()), type: decoded.headers.get('content-type') };
+    }
+    return { bytes: await (0, promises_1.readFile)(path), type: null };
+}
+/** One attachment in Resend's shape: an `http:` or `https:` path as Resend's own, any other path read into content. */
+async function attachmentOf(attachment) {
+    const shaped = { filename: attachment.filename };
+    if (attachment.content !== undefined) {
+        shaped.content = (typeof attachment.content === 'string' ? Buffer.from(attachment.content) : attachment.content).toString('base64');
+    }
+    if (attachment.path !== undefined && exports.REMOTE_ADDRESS.test(attachment.path)) {
+        shaped.path = attachment.path;
+    }
+    else if (attachment.path !== undefined && attachment.content === undefined) {
+        const { bytes, type } = await readAttachment(attachment.path);
+        shaped.content = bytes.toString('base64');
+        if (type !== null)
+            shaped.content_type = type;
+    }
+    if (attachment.contentType !== undefined)
+        shaped.content_type = attachment.contentType;
+    return shaped;
+}
+/** The request's JSON body: the fields Resend's send call names, and only those the message carries. */
+async function bodyOf(message) {
+    const body = { from: message.from, to: [message.to], subject: message.subject, text: message.text };
+    if (message.html !== undefined)
+        body.html = message.html;
+    if (message.replyTo !== undefined)
+        body.reply_to = message.replyTo;
+    if (message.cc !== undefined)
+        body.cc = message.cc;
+    if (message.bcc !== undefined)
+        body.bcc = message.bcc;
+    if (message.headers !== undefined)
+        body.headers = message.headers;
+    if (message.attachments !== undefined && message.attachments.length > 0)
+        body.attachments = await Promise.all(message.attachments.map(attachmentOf));
+    return body;
+}
+/**
+ * Throws an `Error` that names the field and none of its value when a header's value holds a character a header cannot
+ * carry, so the send stops before any request rather than inside `fetch` with a `TypeError` that reads as a failed
+ * connection.
+ */
+function requireHeaderValue(value, field) {
+    if (NOT_A_HEADER_CHARACTER.test(value))
+        throw new Error(`${field} holds a character an HTTP header cannot carry`);
+}
+/** Resend's send call. */
+class ResendTransport {
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Sends one message: the key read once and trimmed, then `POST /emails`, tried again on Resend's terms while the
+     * deadline allows. Throws an `Error` before any request when the key, the idempotency key or the User-Agent holds a
+     * character an HTTP header cannot carry, with a message that names the field and none of its value; `EmailApiError`
+     * for a refusal; and what `fetch` throws for a connection that fails (`TypeError`) or the deadline (`TimeoutError`),
+     * so a caller can tell them apart. A 2xx answer always resolves, since Resend has taken the email: its `messageId` is
+     * the empty string when the answer names no id or its body cannot be read before the deadline. An attachment from a
+     * `data:` address or a file on this host is read first, before the deadline starts; a file that cannot be read throws
+     * its own error before any request.
+     */
+    async send(message) {
+        // String() keeps the coercion a template literal gave a key answered outside TypeScript, such as a Buffer.
+        const key = String(typeof this.options.apiKey === 'function' ? this.options.apiKey() : this.options.apiKey).trim();
+        requireHeaderValue(key, 'The Resend API key');
+        const userAgent = this.options.userAgent ?? DEFAULT_USER_AGENT;
+        requireHeaderValue(userAgent, 'The User-Agent');
+        if (message.idempotencyKey !== undefined)
+            requireHeaderValue(message.idempotencyKey, 'The idempotency key');
+        const body = JSON.stringify(await bodyOf(message));
+        const timeoutMs = this.options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        const maxRetries = this.options.maxRetries ?? DEFAULT_MAX_RETRIES;
+        const deadline = Date.now() + timeoutMs;
+        const signal = AbortSignal.timeout(timeoutMs);
+        const headers = new Headers({ Authorization: `Bearer ${key}`, 'Content-Type': 'application/json', 'User-Agent': userAgent });
+        if (message.idempotencyKey !== undefined)
+            headers.set('Idempotency-Key', message.idempotencyKey);
+        const url = `${(this.options.baseUrl ?? RESEND_API).replace(/\/+$/, '')}/emails`;
+        for (let retry = 0;; retry += 1) {
+            const answer = await fetch(url, { method: 'POST', headers, body, redirect: 'error', signal });
+            if (answer.ok)
+                return { messageId: await messageIdOf(answer) };
+            const error = await refusalOf(answer);
+            const wait = retry < maxRetries ? retryWaitSeconds(error, message.idempotencyKey !== undefined, retry + 1) : null;
+            if (wait === null || Date.now() + wait * 1000 >= deadline)
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, wait * 1000));
+        }
+    }
+}
+exports.ResendTransport = ResendTransport;
+//# sourceMappingURL=ResendTransport.js.map

package/dist/ResendTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResendTransport.js","sourceRoot":"","sources":["../src/ResendTransport.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAuHH,4CAGC;AAxHD,+CAA4C;AAE5C,2BAA2B;AAC3B,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAE5C,8FAA8F;AAC9F,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAEvD,yGAAyG;AACzG,MAAM,kBAAkB,GAAG,KAAM,CAAC;AAElC,0EAA0E;AAC1E,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,iHAAiH;AACjH,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,sBAAsB,GAAG,yBAAyB,CAAC;AAEzD;;;GAGG;AACU,QAAA,cAAc,GAAG,eAAe,CAAC;AAE9C,uEAAuE;AACvE,MAAM,YAAY,GAAG,SAAS,CAAC;AAyD/B,oIAAoI;AACpI,MAAa,aAAc,SAAQ,KAAK;IAatC,YAAY,MAAc,EAAE,IAAY,EAAE,iBAAgC;QACxE,KAAK,CAAC,iCAAiC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QAb3D,2BAA2B;QAClB,SAAI,GAAG,eAAe,CAAC;QAa9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAnBD,sCAmBC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,KAAoB,EAAE,KAAc,EAAE,KAAa;IAClF,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,qBAAqB,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,gCAAgC,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC;IAC7I,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,mGAAmG;AACnG,SAAS,YAAY,CAAC,OAAgB;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACvC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACnE,CAAC;AAED,uHAAuH;AACvH,KAAK,UAAU,SAAS,CAAC,MAAgB;IACvC,IAAI,IAAI,GAAG,SAAS,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,CAAC,CAAC,CAAE,IAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACxH,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,IAAI,GAAG,IAAI,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IACD,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,WAAW,CAAC,MAAgB;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,CAAE,IAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAChH,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,0HAA0H;AAC1H,KAAK,UAAU,cAAc,CAAC,IAAY;IACxC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,gHAAgH;QAChH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;IACxG,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,IAAA,mBAAQ,EAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,uHAAuH;AACvH,KAAK,UAAU,YAAY,CAAC,UAA8B;IACxD,MAAM,MAAM,GAA2B,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;IACzE,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,CAAC,OAAO,GAAG,CAAC,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtI,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,sBAAc,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1E,MAAM,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAChC,CAAC;SAAM,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC7E,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,IAAI,KAAK,IAAI;YAAE,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;IAChD,CAAC;IACD,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS;QAAE,MAAM,CAAC,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC;IACvF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wGAAwG;AACxG,KAAK,UAAU,MAAM,CAAC,OAAsB;IAC1C,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7H,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACzD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IACnE,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS;QAAE,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;IACnD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACtD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAClE,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACrJ,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,KAAa,EAAE,KAAa;IACtD,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gDAAgD,CAAC,CAAC;AACpH,CAAC;AAED,0BAA0B;AAC1B,MAAa,eAAe;IAG1B,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CAAC,OAAsB;QAC/B,2GAA2G;QAC3G,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACnH,kBAAkB,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;QAC/D,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAChD,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;YAAE,kBAAkB,CAAC,OAAO,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;QAC5G,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;QAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,aAAa,EAAE,UAAU,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7H,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QACjG,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC;QACjF,KAAK,IAAI,KAAK,GAAG,CAAC,GAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9F,IAAI,MAAM,CAAC,EAAE;gBAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAClH,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,IAAI,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACvE,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF;AAzCD,0CAyCC"}

package/dist/agentAttachments.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview The attachment check of the pack's two agent surfaces, the `emailSend` tool and the channel adapter,
+ * whose arguments a model writes. `EmailService.sendEmail` reads a file path on this host, and through SMTP fetches an
+ * `http:` or `https:` address from this host, so text that steers an agent could have it mail any file the process can
+ * read, or the answer of an address only this host reaches. The two surfaces pass on only what neither transport reads
+ * or fetches here, and they send the copy the check made, so what is sent is what was checked.
+ */
+/** One attachment as the check read it: its own values, each read once, with a Buffer's bytes copied. */
+export interface CheckedAttachment {
+    /** The name the message gives the file. */
+    filename?: string;
+    /** The file's content: text, or a new Buffer holding the bytes the caller gave. */
+    content?: string | Buffer;
+    /** A `data:` address, or an `http(s)` address when the service sends through Resend. */
+    path?: string;
+    /** The content's type; the transport works it out from the filename or the path when it is not given. */
+    contentType?: string;
+}
+/**
+ * Checks the attachments an agent named and returns the copies the surface sends, or throws an `Error` when one would
+ * make this process read a file or fetch an address, before anything is sent and without reading the file or fetching
+ * the address. Each attachment must be an object, and the check reads its own `filename`, `content`, `path` and
+ * `contentType` once each, refusing one given through a getter or a setter: a copy holds those values alone, so a value
+ * read again later, or any other property, never reaches a transport. An attachment passes when its `content`, if
+ * given, is a string or a Buffer (copied into a new Buffer), its `path`, if given, is a `data:` address, or an `http:`
+ * or `https:` address while the service sends through Resend, whose servers fetch it, and its `filename` and
+ * `contentType`, if given, are strings (`null` leaves either out). A path is checked even next to `content`, since
+ * nodemailer reads `path` first, and `content` of any other kind is refused, since nodemailer reads the `path` or
+ * fetches the `href` of a content object. The message names the attachment's `filename`, or its place in the list when
+ * it has none, and the rule, never its path.
+ *
+ * @param attachments The attachments as the surface took them. `undefined` or `null` passes as `undefined`, since there
+ * is nothing to send. Any other value that is not a list is refused, since nodemailer takes a single attachment object
+ * as a list of one and reads its `path`.
+ * @param throughResend Whether the service sends through Resend, as `EmailService.transport` tells.
+ * @returns The copies, in the order given, or `undefined` for no attachments.
+ */
+export declare function requireAgentAttachments(attachments: unknown, throughResend: boolean): CheckedAttachment[] | undefined;
+//# sourceMappingURL=agentAttachments.d.ts.map

package/dist/agentAttachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentAttachments.d.ts","sourceRoot":"","sources":["../src/agentAttachments.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,yGAAyG;AACzG,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yGAAyG;IACzG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAG,iBAAiB,EAAE,GAAG,SAAS,CAMrH"}

package/dist/agentAttachments.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * @fileoverview The attachment check of the pack's two agent surfaces, the `emailSend` tool and the channel adapter,
+ * whose arguments a model writes. `EmailService.sendEmail` reads a file path on this host, and through SMTP fetches an
+ * `http:` or `https:` address from this host, so text that steers an agent could have it mail any file the process can
+ * read, or the answer of an address only this host reaches. The two surfaces pass on only what neither transport reads
+ * or fetches here, and they send the copy the check made, so what is sent is what was checked.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireAgentAttachments = requireAgentAttachments;
+const node_util_1 = require("node:util");
+const ResendTransport_js_1 = require("./ResendTransport.js");
+/**
+ * A `data:` address up to the comma that ends its header. nodemailer decodes a path only in this form, with `data:` in
+ * lowercase and a comma, and reads any other path that is not an `http(s)` address as a file.
+ */
+const DATA_ADDRESS = /^data:[^,]*,/;
+/** The rule a refusal names when the service sends through Resend. */
+const THROUGH_RESEND = 'an attachment takes its content as a string, a data: address or an http(s) address; files on this machine are not read';
+/** The rule a refusal names when the service sends through SMTP. */
+const THROUGH_SMTP = 'through SMTP an attachment takes its content as a string or a data: address; files on this machine are not read and addresses are not fetched';
+/** The properties the check reads from an attachment and copies, in this order; any other property is left out. */
+const COPIED = ['filename', 'content', 'path', 'contentType'];
+/** The error a refusal throws: it names the attachment and the reason, never a path. */
+function refused(named, reason) {
+    return new Error(`The attachment ${named} was refused: ${reason}`);
+}
+/** Checks one attachment and returns its copy, or throws the refusal. */
+function checkOne(attachment, index, throughResend) {
+    let named = `number ${index + 1}`;
+    if (typeof attachment !== 'object' || attachment === null || Array.isArray(attachment)) {
+        throw refused(named, 'give it as an object');
+    }
+    const own = {};
+    for (const field of COPIED) {
+        // An own data property is read once here; a getter could answer this check one value and the send another.
+        const descriptor = Object.getOwnPropertyDescriptor(attachment, field);
+        if (descriptor === undefined)
+            continue;
+        if (!('value' in descriptor)) {
+            throw refused(named, `give its ${field} as a value, not through a getter or a setter`);
+        }
+        own[field] = descriptor.value;
+        if (field === 'filename' && typeof own.filename === 'string' && own.filename !== '') {
+            named = JSON.stringify(own.filename);
+        }
+    }
+    const { filename, content, path, contentType } = own;
+    const rule = throughResend ? THROUGH_RESEND : THROUGH_SMTP;
+    const copy = {};
+    if (typeof filename === 'string')
+        copy.filename = filename;
+    else if (filename !== undefined && filename !== null)
+        throw refused(named, 'give its filename as a string');
+    // nodemailer reads the path of any content object, a Buffer's own included, so a Buffer is copied into a new one.
+    if (typeof content === 'string')
+        copy.content = content;
+    else if (Buffer.isBuffer(content) && node_util_1.types.isUint8Array(content))
+        copy.content = Buffer.from(content);
+    else if (content !== undefined)
+        throw refused(named, rule);
+    if (typeof path === 'string' && (DATA_ADDRESS.test(path) || (throughResend && ResendTransport_js_1.REMOTE_ADDRESS.test(path)))) {
+        copy.path = path;
+    }
+    else if (path !== undefined) {
+        throw refused(named, rule);
+    }
+    // nodemailer writes an object header value marked `prepared` into the part's headers as it is.
+    if (typeof contentType === 'string')
+        copy.contentType = contentType;
+    else if (contentType !== undefined && contentType !== null)
+        throw refused(named, 'give its contentType as a string');
+    return copy;
+}
+/**
+ * Checks the attachments an agent named and returns the copies the surface sends, or throws an `Error` when one would
+ * make this process read a file or fetch an address, before anything is sent and without reading the file or fetching
+ * the address. Each attachment must be an object, and the check reads its own `filename`, `content`, `path` and
+ * `contentType` once each, refusing one given through a getter or a setter: a copy holds those values alone, so a value
+ * read again later, or any other property, never reaches a transport. An attachment passes when its `content`, if
+ * given, is a string or a Buffer (copied into a new Buffer), its `path`, if given, is a `data:` address, or an `http:`
+ * or `https:` address while the service sends through Resend, whose servers fetch it, and its `filename` and
+ * `contentType`, if given, are strings (`null` leaves either out). A path is checked even next to `content`, since
+ * nodemailer reads `path` first, and `content` of any other kind is refused, since nodemailer reads the `path` or
+ * fetches the `href` of a content object. The message names the attachment's `filename`, or its place in the list when
+ * it has none, and the rule, never its path.
+ *
+ * @param attachments The attachments as the surface took them. `undefined` or `null` passes as `undefined`, since there
+ * is nothing to send. Any other value that is not a list is refused, since nodemailer takes a single attachment object
+ * as a list of one and reads its `path`.
+ * @param throughResend Whether the service sends through Resend, as `EmailService.transport` tells.
+ * @returns The copies, in the order given, or `undefined` for no attachments.
+ */
+function requireAgentAttachments(attachments, throughResend) {
+    if (attachments === undefined || attachments === null)
+        return undefined;
+    if (!Array.isArray(attachments))
+        throw new Error('The attachments were refused: give them as a list');
+    const checked = [];
+    for (const [index, attachment] of attachments.entries())
+        checked.push(checkOne(attachment, index, throughResend));
+    return checked;
+}
+//# sourceMappingURL=agentAttachments.js.map

package/dist/agentAttachments.js.map

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

package/dist/index.d.ts

@@ -2,7 +2,8 @@
  * @fileoverview Email Channel Extension for AgentOS.
  *
  * Provides an IChannelAdapter + 5 tools for sending, reading, searching,
- * extracting codes from, and replying to emails via SMTP/IMAP.
+ * extracting codes from, and replying to emails: it sends through SMTP or
+ * Resend's HTTPS API and reads through IMAP.
  *
  * @module @framers/agentos-ext-channel-email
  */
@@ -17,6 +18,18 @@ export interface EmailChannelOptions {
     imapPassword?: string;
     imapPort?: number;
     imapSecure?: boolean;
+    /**
+     * Resend's API key. With no SMTP host, mail is sent through Resend's HTTPS API. Falls back to the secret
+     * `email.resendApiKey`, then to `RESEND_API_KEY`.
+     */
+    resendApiKey?: string;
+    /** Resend's API origin, such as a proxy's; Resend's own when unset. */
+    resendBaseUrl?: string;
+    /**
+     * The From header, a display name allowed (`Example <hello@example.com>`). Falls back to `EMAIL_FROM`, then to the
+     * SMTP user; required when sending through Resend.
+     */
+    from?: string;
     secrets?: Record<string, string>;
 }
 export interface ExtensionContext {
@@ -38,6 +51,8 @@ export interface ExtensionPack {
 export declare function createExtensionPack(context: ExtensionContext): ExtensionPack;
 export { EmailService } from './EmailService.js';
 export type { EmailConfig, SendEmailOptions, EmailMessage, SearchEmailOptions } from './EmailService.js';
+export { ResendTransport, EmailApiError, retryWaitSeconds } from './ResendTransport.js';
+export type { ResendOptions, OutgoingEmail, OutgoingAttachment } from './ResendTransport.js';
 export { EmailChannelAdapter } from './EmailChannelAdapter.js';
 export { EmailSendTool } from './tools/send.js';
 export { EmailReadTool } from './tools/read.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAeH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AA2ED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtF,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAgC5E;AAMD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAeH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAkFD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtF,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAgC5E;AAMD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -4,12 +4,13 @@
  * @fileoverview Email Channel Extension for AgentOS.
  *
  * Provides an IChannelAdapter + 5 tools for sending, reading, searching,
- * extracting codes from, and replying to emails via SMTP/IMAP.
+ * extracting codes from, and replying to emails: it sends through SMTP or
+ * Resend's HTTPS API and reads through IMAP.
  *
  * @module @framers/agentos-ext-channel-email
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmailReplyTool = exports.EmailExtractCodesTool = exports.EmailSearchTool = exports.EmailReadTool = exports.EmailSendTool = exports.EmailChannelAdapter = exports.EmailService = void 0;
+exports.EmailReplyTool = exports.EmailExtractCodesTool = exports.EmailSearchTool = exports.EmailReadTool = exports.EmailSendTool = exports.EmailChannelAdapter = exports.retryWaitSeconds = exports.EmailApiError = exports.ResendTransport = exports.EmailService = void 0;
 exports.createExtensionPack = createExtensionPack;
 const EmailService_js_1 = require("./EmailService.js");
 const EmailChannelAdapter_js_1 = require("./EmailChannelAdapter.js");
@@ -40,6 +41,8 @@ function resolveConfig(opts, secrets) {
         process.env.SMTP_PASSWORD ??
         process.env.EMAIL_SMTP_PASSWORD ??
         '';
+    const resendApiKey = opts.resendApiKey ?? secrets['email.resendApiKey'] ?? process.env.RESEND_API_KEY;
+    const from = opts.from ?? process.env.EMAIL_FROM;
     const imapHost = opts.imapHost ??
         secrets['email.imapHost'] ??
         secrets['email.imap.host'] ??
@@ -55,15 +58,19 @@ function resolveConfig(opts, secrets) {
         secrets['email.imap.password'] ??
         process.env.IMAP_PASSWORD ??
         process.env.EMAIL_IMAP_PASSWORD;
-    const config = {
-        smtp: {
-            host: smtpHost,
-            user: smtpUser,
-            password: smtpPassword,
-            port: opts.smtpPort,
-            secure: opts.smtpSecure,
-        },
-    };
+    // SMTP stays the transport whenever a host is given; Resend sends only when a key is given and no SMTP host.
+    const config = smtpHost === '' && resendApiKey
+        ? { resend: { apiKey: resendApiKey, baseUrl: opts.resendBaseUrl }, from }
+        : {
+            smtp: {
+                host: smtpHost,
+                user: smtpUser,
+                password: smtpPassword,
+                port: opts.smtpPort,
+                secure: opts.smtpSecure,
+            },
+            from,
+        };
     if (imapHost && imapUser && imapPassword) {
         config.imap = {
             host: imapHost,
@@ -101,7 +108,7 @@ function createExtensionPack(context) {
             { id: 'emailChannel', kind: 'messaging-channel', priority: 50, payload: adapter },
         ],
         onActivate: async () => {
-            await adapter.initialize({ platform: 'email', credential: config.smtp.user });
+            await adapter.initialize({ platform: 'email', credential: config.smtp?.user ?? config.from ?? '' });
         },
         onDeactivate: async () => {
             await adapter.shutdown();
@@ -113,6 +120,10 @@ function createExtensionPack(context) {
 // ---------------------------------------------------------------------------
 var EmailService_js_2 = require("./EmailService.js");
 Object.defineProperty(exports, "EmailService", { enumerable: true, get: function () { return EmailService_js_2.EmailService; } });
+var ResendTransport_js_1 = require("./ResendTransport.js");
+Object.defineProperty(exports, "ResendTransport", { enumerable: true, get: function () { return ResendTransport_js_1.ResendTransport; } });
+Object.defineProperty(exports, "EmailApiError", { enumerable: true, get: function () { return ResendTransport_js_1.EmailApiError; } });
+Object.defineProperty(exports, "retryWaitSeconds", { enumerable: true, get: function () { return ResendTransport_js_1.retryWaitSeconds; } });
 var EmailChannelAdapter_js_2 = require("./EmailChannelAdapter.js");
 Object.defineProperty(exports, "EmailChannelAdapter", { enumerable: true, get: function () { return EmailChannelAdapter_js_2.EmailChannelAdapter; } });
 var send_js_2 = require("./tools/send.js");

package/dist/index.js.map

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