@5ss/ai-tools 2.11.1

package/dist/modules/email/index.d.ts

@@ -0,0 +1,311 @@
+import { a as ModuleDefinition, o as ToolContext, s as ToolDefinition } from "../../types-Ccb0DXY9.js";
+import "../../index-CZX5OeOF.js";
+import { s as HttpServiceOptions } from "../../http-service-T7E5UjP8.js";
+import { t as BatchResult } from "../../batch-BMM5dXqL.js";
+import { a as namedAddressSchema, i as attachmentSchema, n as MAX_EMAIL_BYTES, r as NamedAddress, t as MAX_BATCH_EMAILS } from "../../index-CLmTrcu5.js";
+import "../../index-BU4gmYO8.js";
+import { z } from "zod";
+//#region src/modules/email/contracts.d.ts
+declare const emailSenderSchema: z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+  email: z.ZodEmail;
+  name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+/** Host auth: vendor credentials, provider discriminator, and locked sender. */
+declare const resendEmailAuthSchema: z.ZodObject<{
+  api_key: z.ZodString;
+  provider: z.ZodLiteral<"resend">;
+  sender: z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>;
+}, z.core.$strip>;
+declare const cloudflareEmailSeamAuthSchema: z.ZodObject<{
+  account_id: z.ZodString;
+  api_token: z.ZodString;
+  provider: z.ZodLiteral<"cloudflare">;
+  sender: z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>;
+}, z.core.$strip>;
+type ResendEmailAuth = z.infer<typeof resendEmailAuthSchema>;
+type CloudflareEmailSeamAuth = z.infer<typeof cloudflareEmailSeamAuthSchema>;
+declare const emailAuthSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  api_key: z.ZodString;
+  provider: z.ZodLiteral<"resend">;
+  sender: z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>;
+}, z.core.$strip>, z.ZodObject<{
+  account_id: z.ZodString;
+  api_token: z.ZodString;
+  provider: z.ZodLiteral<"cloudflare">;
+  sender: z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>;
+}, z.core.$strip>], "provider">;
+type EmailAuth = z.infer<typeof emailAuthSchema>;
+/** Provider-neutral model input. Sender and raw headers remain host/vendor-only. */
+declare const emailSendInputSchema: z.ZodObject<{
+  to: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>>]>;
+  subject: z.ZodString;
+  html: z.ZodOptional<z.ZodString>;
+  text: z.ZodOptional<z.ZodString>;
+  cc: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>>]>>;
+  bcc: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>>]>>;
+  reply_to: z.ZodOptional<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>>;
+  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    content: z.ZodString;
+    filename: z.ZodString;
+    type: z.ZodString;
+    disposition: z.ZodOptional<z.ZodEnum<{
+      attachment: "attachment";
+      inline: "inline";
+    }>>;
+    content_id: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+type EmailSendInput = z.infer<typeof emailSendInputSchema>;
+/**
+ * Unified result; each provider fills what it has.
+ * Resend → id; Cloudflare → accepted/rejected.
+ */
+declare const emailSendOutputSchema: z.ZodObject<{
+  success: z.ZodBoolean;
+  id: z.ZodOptional<z.ZodString>;
+  accepted: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  rejected: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const emailSendBatchInputSchema: z.ZodObject<{
+  messages: z.ZodArray<z.ZodObject<{
+    to: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+      email: z.ZodEmail;
+      name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+      email: z.ZodEmail;
+      name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>]>;
+    subject: z.ZodString;
+    html: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    cc: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+      email: z.ZodEmail;
+      name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+      email: z.ZodEmail;
+      name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>]>>;
+    bcc: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+      email: z.ZodEmail;
+      name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+      email: z.ZodEmail;
+      name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>]>>;
+    reply_to: z.ZodOptional<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
+      email: z.ZodEmail;
+      name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      content: z.ZodString;
+      filename: z.ZodString;
+      type: z.ZodString;
+      disposition: z.ZodOptional<z.ZodEnum<{
+        attachment: "attachment";
+        inline: "inline";
+      }>>;
+      content_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const emailSendBatchOutputSchema: z.ZodObject<{
+  results: z.ZodArray<z.ZodObject<{
+    index: z.ZodInt;
+    ok: z.ZodBoolean;
+    value: z.ZodOptional<z.ZodObject<{
+      success: z.ZodBoolean;
+      id: z.ZodOptional<z.ZodString>;
+      accepted: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      rejected: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodObject<{
+      code: z.ZodString;
+      message: z.ZodString;
+      retryable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  succeeded: z.ZodInt;
+  failed: z.ZodInt;
+}, z.core.$strip>;
+type EmailSendOutput = z.infer<typeof emailSendOutputSchema>;
+type EmailSendBatchInput = z.infer<typeof emailSendBatchInputSchema>;
+type EmailSendBatchOutput = z.infer<typeof emailSendBatchOutputSchema>;
+/** Shared seam surface — provider classes implement this. */
+type EmailOps = {
+  send: (input: EmailSendInput) => Promise<EmailSendOutput>;
+  sendBatch: (input: EmailSendBatchInput) => Promise<EmailSendBatchOutput>;
+};
+//#endregion
+//#region src/modules/email/client.d.ts
+type EmailClientOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>;
+declare class EmailClient implements EmailOps {
+  #private;
+  constructor(auth: EmailAuth, options?: EmailClientOptions);
+  static fromContext(ctx: ToolContext): EmailClient;
+  static fromAuth(auth: EmailAuth, ctx?: ToolContext): EmailClient;
+  send(input: EmailSendInput): Promise<{
+    success: boolean;
+    id?: string | undefined;
+    accepted?: string[] | undefined;
+    rejected?: string[] | undefined;
+  }>;
+  sendBatch(input: EmailSendBatchInput): Promise<BatchResult<{
+    success: boolean;
+    id?: string | undefined;
+    accepted?: string[] | undefined;
+    rejected?: string[] | undefined;
+  }>>;
+}
+//#endregion
+//#region src/modules/email/module.d.ts
+declare const emailSendTool: ToolDefinition<{
+  to: string | (string | {
+    email: string;
+    name?: string | undefined;
+  })[] | {
+    email: string;
+    name?: string | undefined;
+  };
+  subject: string;
+  html?: string | undefined;
+  text?: string | undefined;
+  cc?: string | (string | {
+    email: string;
+    name?: string | undefined;
+  })[] | {
+    email: string;
+    name?: string | undefined;
+  } | undefined;
+  bcc?: string | (string | {
+    email: string;
+    name?: string | undefined;
+  })[] | {
+    email: string;
+    name?: string | undefined;
+  } | undefined;
+  reply_to?: string | {
+    email: string;
+    name?: string | undefined;
+  } | undefined;
+  attachments?: {
+    content: string;
+    filename: string;
+    type: string;
+    disposition?: "attachment" | "inline" | undefined;
+    content_id?: string | undefined;
+  }[] | undefined;
+}, {
+  success: boolean;
+  id?: string | undefined;
+  accepted?: string[] | undefined;
+  rejected?: string[] | undefined;
+}>;
+declare const emailSendBatchTool: ToolDefinition<{
+  messages: {
+    to: string | (string | {
+      email: string;
+      name?: string | undefined;
+    })[] | {
+      email: string;
+      name?: string | undefined;
+    };
+    subject: string;
+    html?: string | undefined;
+    text?: string | undefined;
+    cc?: string | (string | {
+      email: string;
+      name?: string | undefined;
+    })[] | {
+      email: string;
+      name?: string | undefined;
+    } | undefined;
+    bcc?: string | (string | {
+      email: string;
+      name?: string | undefined;
+    })[] | {
+      email: string;
+      name?: string | undefined;
+    } | undefined;
+    reply_to?: string | {
+      email: string;
+      name?: string | undefined;
+    } | undefined;
+    attachments?: {
+      content: string;
+      filename: string;
+      type: string;
+      disposition?: "attachment" | "inline" | undefined;
+      content_id?: string | undefined;
+    }[] | undefined;
+  }[];
+}, {
+  results: {
+    index: number;
+    ok: boolean;
+    value?: {
+      success: boolean;
+      id?: string | undefined;
+      accepted?: string[] | undefined;
+      rejected?: string[] | undefined;
+    } | undefined;
+    error?: {
+      code: string;
+      message: string;
+      retryable?: boolean | undefined;
+    } | undefined;
+  }[];
+  succeeded: number;
+  failed: number;
+}>;
+declare const emailModule: ModuleDefinition<{
+  api_key: string;
+  provider: "resend";
+  sender: string | {
+    email: string;
+    name?: string | undefined;
+  };
+} | {
+  account_id: string;
+  api_token: string;
+  provider: "cloudflare";
+  sender: string | {
+    email: string;
+    name?: string | undefined;
+  };
+}>;
+//#endregion
+export { type CloudflareEmailSeamAuth, type EmailAuth, EmailClient, type EmailClientOptions, type EmailSendBatchInput, type EmailSendBatchOutput, type EmailSendInput, type EmailSendOutput, MAX_BATCH_EMAILS, MAX_EMAIL_BYTES, type NamedAddress, type ResendEmailAuth, attachmentSchema, cloudflareEmailSeamAuthSchema, emailAuthSchema, emailModule, emailSendBatchInputSchema, emailSendBatchOutputSchema, emailSendBatchTool, emailSendInputSchema, emailSendOutputSchema, emailSendTool, emailSenderSchema, namedAddressSchema, resendEmailAuthSchema };
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/email/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/modules/email/contracts.ts","../../../src/modules/email/client.ts","../../../src/modules/email/module.ts"],"mappings":";;;;;;;;cAqBa,mBAAiB,EAAA,mBAAA,EAAA,UAAA,EAAA;;;GAE7B,EAAA,KAAA;;cAGY,uBAAqB,EAAA;;;;;;;GAGhC,EAAA,KAAA;cAEW,+BAA6B,EAAA;;;;;;;;GAGxC,EAAA,KAAA;KAEU,kBAAkB,EAAE,aAAa;KACjC,0BAA0B,EAAE,aAAa;cAExC,iBAAe,EAAA,uBAAA,EAAA;;;;;;;;;;;;;;;GAA2F,EAAA,KAAA;KAE3G,YAAY,EAAE,aAAa;;cAK1B,sBAAoB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAI9B,EAAA,KAAA;KACS,iBAAiB,EAAE,aAAa;;;;;cAO/B,uBAAqB,EAAA;;;;;GAKhC,EAAA,KAAA;cAEW,2BAAyB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEpC,EAAA,KAAA;cAEW,4BAA0B,EAAA;;;;;;;;;;;;;;;;;;GAA2C,EAAA,KAAA;KAEtE,kBAAkB,EAAE,aAAa;KACjC,sBAAsB,EAAE,aAAa;KACrC,uBAAuB,EAAE,aAAa;;KAGtC;EACX,OAAO,OAAO,mBAAmB,QAAQ;EACzC,YAAY,OAAO,wBAAwB,QAAQ;;;;KCzDxC,qBAAqB,KAAK;cAgCzB,uBAAuB;;EAInC,YAAY,MAAM,WAAW,UAAS;SAK/B,YAAY,KAAK,cAAc;SAK/B,SAAS,MAAM,WAAW,MAAK,cAAmB;EAInD,KAAK,OAAO,iBAAc;;;;;;EAQhC,UAAU,OAAO,sBAAmB,QAAnB;;;;;;;;;cClEL,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAYA,oBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAYA,aAAA"}

package/dist/modules/email/index.js

@@ -0,0 +1,167 @@
+import { n as isToolError, t as ToolError } from "../../errors-DoSpNHvs.js";
+import { n as defineModule, r as defineTool } from "../../define-CvpJ_pNP.js";
+import { n as requireAuth } from "../../provider-CgDAlg6K.js";
+import { n as runBatchItems, t as batchResultSchema } from "../../batch-Co1ujeAW.js";
+import { a as attachmentSchema, i as MAX_EMAIL_BYTES, o as namedAddressSchema, r as MAX_BATCH_EMAILS } from "../../limits-hjrO8zUG.js";
+import { a as cloudflareEmailAuthSchema, i as CloudflareEmailClient } from "../../cloudflare-email-Dy0KHeDf.js";
+import { a as resendAuthSchema, c as resendSendInputSchema, i as ResendClient } from "../../resend-BAC38_dA.js";
+import { z } from "zod";
+//#region src/modules/email/contracts.ts
+/**
+* Email seam contracts — vendor I/O + provider auth union.
+*/
+const emailSenderSchema = namedAddressSchema.describe("Verified sender locked to this provider binding. Model inputs cannot override it");
+/** Host auth: vendor credentials, provider discriminator, and locked sender. */
+const resendEmailAuthSchema = resendAuthSchema.extend({
+	provider: z.literal("resend"),
+	sender: emailSenderSchema
+});
+const cloudflareEmailSeamAuthSchema = cloudflareEmailAuthSchema.extend({
+	provider: z.literal("cloudflare"),
+	sender: emailSenderSchema
+});
+const emailAuthSchema = z.discriminatedUnion("provider", [resendEmailAuthSchema, cloudflareEmailSeamAuthSchema]);
+const { from: _from, headers: _headers, ...emailSendInputShape } = resendSendInputSchema.shape;
+/** Provider-neutral model input. Sender and raw headers remain host/vendor-only. */
+const emailSendInputSchema = z.object(emailSendInputShape).refine((input) => Boolean(input.html?.trim() || input.text?.trim()), { message: "Provide html and/or text body" });
+/**
+* Unified result; each provider fills what it has.
+* Resend → id; Cloudflare → accepted/rejected.
+*/
+const emailSendOutputSchema = z.object({
+	success: z.boolean().describe("Whether the provider accepted the request"),
+	id: z.string().optional().describe("Provider message id when available"),
+	accepted: z.array(z.string()).optional().describe("Addresses delivered and/or queued when known"),
+	rejected: z.array(z.string()).optional().describe("Addresses permanently rejected when known")
+});
+const emailSendBatchInputSchema = z.object({ messages: z.array(emailSendInputSchema).min(1).max(20).describe("Messages to send (max 20)") });
+const emailSendBatchOutputSchema = batchResultSchema(emailSendOutputSchema);
+//#endregion
+//#region src/modules/email/providers/cloudflare.ts
+var CloudflareEmailProvider = class {
+	#client;
+	constructor(auth, options = {}) {
+		const { provider: _provider, sender: _sender, ...vendorAuth } = auth;
+		this.#client = new CloudflareEmailClient(vendorAuth, options);
+	}
+	async send(input) {
+		const result = await this.#client.send(input);
+		return {
+			success: result.success,
+			...result.accepted && result.accepted.length > 0 && { accepted: result.accepted },
+			...result.rejected && result.rejected.length > 0 && { rejected: result.rejected }
+		};
+	}
+};
+//#endregion
+//#region src/modules/email/providers/resend.ts
+var ResendEmailProvider = class {
+	#client;
+	constructor(auth, options = {}) {
+		const { provider: _provider, sender: _sender, ...vendorAuth } = auth;
+		this.#client = new ResendClient(vendorAuth, options);
+	}
+	async send(input) {
+		const result = await this.#client.send(input);
+		return {
+			success: result.success,
+			...result.id && { id: result.id }
+		};
+	}
+};
+//#endregion
+//#region src/modules/email/client.ts
+/**
+* Email seam client — picks resend / cloudflare from host auth.
+*/
+function transportOptions(ctx) {
+	return {
+		...ctx.fetch && { fetch: ctx.fetch },
+		...ctx.signal && { signal: ctx.signal }
+	};
+}
+function providerFor(auth, options) {
+	switch (auth.provider) {
+		case "resend": return new ResendEmailProvider(auth, options);
+		case "cloudflare": return new CloudflareEmailProvider(auth, options);
+	}
+}
+function emailDeliveryError(error) {
+	if (isToolError(error)) return new ToolError("Email delivery was rejected", {
+		code: error.code,
+		retryable: error.retryable,
+		cause: error
+	});
+	return new ToolError("Email delivery was rejected", {
+		code: "upstream",
+		cause: error
+	});
+}
+var EmailClient = class EmailClient {
+	#provider;
+	#sender;
+	constructor(auth, options = {}) {
+		this.#provider = providerFor(auth, options);
+		this.#sender = auth.sender;
+	}
+	static fromContext(ctx) {
+		const auth = requireAuth(ctx, emailAuthSchema);
+		return new EmailClient(auth, transportOptions(ctx));
+	}
+	static fromAuth(auth, ctx = {}) {
+		return new EmailClient(auth, transportOptions(ctx));
+	}
+	async send(input) {
+		try {
+			return await this.#provider.send({
+				...input,
+				from: this.#sender
+			});
+		} catch (error) {
+			throw emailDeliveryError(error);
+		}
+	}
+	sendBatch(input) {
+		return runBatchItems(input.messages, (message) => this.send(message));
+	}
+};
+//#endregion
+//#region src/modules/email/module.ts
+const emailSendTool = defineTool({
+	id: "email-send",
+	name: "sendEmail",
+	description: "Send one email via the bound email provider. Subject plus html and/or text. Optional cc, bcc, reply_to, headers, base64 attachments. Total under 5 MiB.",
+	inputSchema: emailSendInputSchema,
+	outputSchema: emailSendOutputSchema,
+	sideEffect: "send",
+	runtime: "both",
+	execute: async (input, ctx) => EmailClient.fromContext(ctx).send(input)
+});
+const emailSendBatchTool = defineTool({
+	id: "email-send-batch",
+	name: "sendEmailBatch",
+	description: "Send up to 20 emails via the bound email provider. Per-message success or error without aborting the batch.",
+	inputSchema: emailSendBatchInputSchema,
+	outputSchema: emailSendBatchOutputSchema,
+	sideEffect: "send",
+	runtime: "both",
+	execute: async (input, ctx) => EmailClient.fromContext(ctx).sendBatch(input)
+});
+const emailModule = defineModule({
+	id: "email",
+	title: "Email",
+	description: "Send transactional email from the configured sender. The model supplies recipients and content, never the sender identity.",
+	runtime: "both",
+	auth: {
+		type: "custom",
+		schema: emailAuthSchema
+	},
+	categories: ["email", "messaging"],
+	classification: "pii",
+	tags: ["send"],
+	tools: [emailSendTool, emailSendBatchTool]
+});
+//#endregion
+export { EmailClient, MAX_BATCH_EMAILS, MAX_EMAIL_BYTES, attachmentSchema, cloudflareEmailSeamAuthSchema, emailAuthSchema, emailModule, emailSendBatchInputSchema, emailSendBatchOutputSchema, emailSendBatchTool, emailSendInputSchema, emailSendOutputSchema, emailSendTool, emailSenderSchema, namedAddressSchema, resendEmailAuthSchema };
+
+//# sourceMappingURL=index.js.map

package/dist/modules/email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["cloudflareEmailVendorAuthSchema","#client","#client","#provider","#sender"],"sources":["../../../src/modules/email/contracts.ts","../../../src/modules/email/providers/cloudflare.ts","../../../src/modules/email/providers/resend.ts","../../../src/modules/email/client.ts","../../../src/modules/email/module.ts"],"sourcesContent":["/**\n * Email seam contracts — vendor I/O + provider auth union.\n */\n\nimport { z } from 'zod'\n\nimport { batchResultSchema } from '../../shared/batch'\nimport { cloudflareEmailAuthSchema as cloudflareEmailVendorAuthSchema } from '../../vendors/cloudflare-email'\nimport {\n\tattachmentSchema,\n\tMAX_BATCH_EMAILS,\n\tMAX_EMAIL_BYTES,\n\tnamedAddressSchema,\n\tresendAuthSchema,\n\tresendSendInputSchema\n} from '../../vendors/resend'\nimport type { NamedAddress, ResendSendInput } from '../../vendors/resend'\n\nexport { attachmentSchema, MAX_BATCH_EMAILS, MAX_EMAIL_BYTES, namedAddressSchema }\nexport type { NamedAddress }\n\nexport const emailSenderSchema = namedAddressSchema.describe(\n\t'Verified sender locked to this provider binding. Model inputs cannot override it'\n)\n\n/** Host auth: vendor credentials, provider discriminator, and locked sender. */\nexport const resendEmailAuthSchema = resendAuthSchema.extend({\n\tprovider: z.literal('resend'),\n\tsender: emailSenderSchema\n})\n\nexport const cloudflareEmailSeamAuthSchema = cloudflareEmailVendorAuthSchema.extend({\n\tprovider: z.literal('cloudflare'),\n\tsender: emailSenderSchema\n})\n\nexport type ResendEmailAuth = z.infer<typeof resendEmailAuthSchema>\nexport type CloudflareEmailSeamAuth = z.infer<typeof cloudflareEmailSeamAuthSchema>\n\nexport const emailAuthSchema = z.discriminatedUnion('provider', [resendEmailAuthSchema, cloudflareEmailSeamAuthSchema])\n\nexport type EmailAuth = z.infer<typeof emailAuthSchema>\n\nconst { from: _from, headers: _headers, ...emailSendInputShape } = resendSendInputSchema.shape\n\n/** Provider-neutral model input. Sender and raw headers remain host/vendor-only. */\nexport const emailSendInputSchema = z\n\t.object(emailSendInputShape)\n\t.refine((input) => Boolean(input.html?.trim() || input.text?.trim()), {\n\t\tmessage: 'Provide html and/or text body'\n\t})\nexport type EmailSendInput = z.infer<typeof emailSendInputSchema>\nexport type EmailProviderSendInput = ResendSendInput\n\n/**\n * Unified result; each provider fills what it has.\n * Resend → id; Cloudflare → accepted/rejected.\n */\nexport const emailSendOutputSchema = z.object({\n\tsuccess: z.boolean().describe('Whether the provider accepted the request'),\n\tid: z.string().optional().describe('Provider message id when available'),\n\taccepted: z.array(z.string()).optional().describe('Addresses delivered and/or queued when known'),\n\trejected: z.array(z.string()).optional().describe('Addresses permanently rejected when known')\n})\n\nexport const emailSendBatchInputSchema = z.object({\n\tmessages: z.array(emailSendInputSchema).min(1).max(MAX_BATCH_EMAILS).describe('Messages to send (max 20)')\n})\n\nexport const emailSendBatchOutputSchema = batchResultSchema(emailSendOutputSchema)\n\nexport type EmailSendOutput = z.infer<typeof emailSendOutputSchema>\nexport type EmailSendBatchInput = z.infer<typeof emailSendBatchInputSchema>\nexport type EmailSendBatchOutput = z.infer<typeof emailSendBatchOutputSchema>\n\n/** Shared seam surface — provider classes implement this. */\nexport type EmailOps = {\n\tsend: (input: EmailSendInput) => Promise<EmailSendOutput>\n\tsendBatch: (input: EmailSendBatchInput) => Promise<EmailSendBatchOutput>\n}\n\n/** Internal seam provider surface after EmailClient injects the locked sender. */\nexport type EmailProviderOps = {\n\tsend: (input: EmailProviderSendInput) => Promise<EmailSendOutput>\n}\n","/**\n * Cloudflare Email provider for the email seam. Wraps `CloudflareEmailClient`.\n */\n\nimport type { HttpServiceOptions } from '../../../transport/http-service'\nimport { CloudflareEmailClient } from '../../../vendors/cloudflare-email'\nimport type { CloudflareEmailSeamAuth, EmailProviderOps, EmailProviderSendInput, EmailSendOutput } from '../contracts'\n\nexport type CloudflareEmailProviderOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>\n\nexport class CloudflareEmailProvider implements EmailProviderOps {\n\treadonly #client: CloudflareEmailClient\n\n\tconstructor(auth: CloudflareEmailSeamAuth, options: CloudflareEmailProviderOptions = {}) {\n\t\tconst { provider: _provider, sender: _sender, ...vendorAuth } = auth\n\t\tthis.#client = new CloudflareEmailClient(vendorAuth, options)\n\t}\n\n\tasync send(input: EmailProviderSendInput): Promise<EmailSendOutput> {\n\t\tconst result = await this.#client.send(input)\n\t\treturn {\n\t\t\tsuccess: result.success,\n\t\t\t...(result.accepted && result.accepted.length > 0 && { accepted: result.accepted }),\n\t\t\t...(result.rejected && result.rejected.length > 0 && { rejected: result.rejected })\n\t\t}\n\t}\n}\n","/**\n * Resend provider for the email seam. Wraps `ResendClient`.\n */\n\nimport type { HttpServiceOptions } from '../../../transport/http-service'\nimport { ResendClient } from '../../../vendors/resend'\nimport type { EmailProviderOps, EmailProviderSendInput, EmailSendOutput, ResendEmailAuth } from '../contracts'\n\nexport type ResendEmailProviderOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>\n\nexport class ResendEmailProvider implements EmailProviderOps {\n\treadonly #client: ResendClient\n\n\tconstructor(auth: ResendEmailAuth, options: ResendEmailProviderOptions = {}) {\n\t\tconst { provider: _provider, sender: _sender, ...vendorAuth } = auth\n\t\tthis.#client = new ResendClient(vendorAuth, options)\n\t}\n\n\tasync send(input: EmailProviderSendInput): Promise<EmailSendOutput> {\n\t\tconst result = await this.#client.send(input)\n\t\treturn {\n\t\t\tsuccess: result.success,\n\t\t\t...(result.id && { id: result.id })\n\t\t}\n\t}\n}\n","/**\n * Email seam client — picks resend / cloudflare from host auth.\n */\n\nimport { isToolError, ToolError } from '../../core/errors'\nimport { requireAuth } from '../../core/provider'\nimport type { ToolContext } from '../../core/types'\nimport { runBatchItems } from '../../shared/batch'\nimport type { HttpServiceOptions } from '../../transport/http-service'\nimport { emailAuthSchema } from './contracts'\nimport type {\n\tEmailAuth,\n\tEmailOps,\n\tEmailProviderOps,\n\tEmailSendBatchInput,\n\tEmailSendInput,\n\tNamedAddress\n} from './contracts'\nimport { CloudflareEmailProvider } from './providers/cloudflare'\nimport { ResendEmailProvider } from './providers/resend'\n\nexport type EmailClientOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>\n\nfunction transportOptions(ctx: ToolContext): EmailClientOptions {\n\treturn {\n\t\t...(ctx.fetch && { fetch: ctx.fetch }),\n\t\t...(ctx.signal && { signal: ctx.signal })\n\t}\n}\n\nfunction providerFor(auth: EmailAuth, options: EmailClientOptions): EmailProviderOps {\n\tswitch (auth.provider) {\n\t\tcase 'resend':\n\t\t\treturn new ResendEmailProvider(auth, options)\n\t\tcase 'cloudflare':\n\t\t\treturn new CloudflareEmailProvider(auth, options)\n\t}\n}\n\nfunction emailDeliveryError(error: unknown): ToolError {\n\tif (isToolError(error)) {\n\t\treturn new ToolError('Email delivery was rejected', {\n\t\t\tcode: error.code,\n\t\t\tretryable: error.retryable,\n\t\t\tcause: error\n\t\t})\n\t}\n\treturn new ToolError('Email delivery was rejected', {\n\t\tcode: 'upstream',\n\t\tcause: error\n\t})\n}\n\nexport class EmailClient implements EmailOps {\n\treadonly #provider: EmailProviderOps\n\treadonly #sender: NamedAddress\n\n\tconstructor(auth: EmailAuth, options: EmailClientOptions = {}) {\n\t\tthis.#provider = providerFor(auth, options)\n\t\tthis.#sender = auth.sender\n\t}\n\n\tstatic fromContext(ctx: ToolContext): EmailClient {\n\t\tconst auth = requireAuth(ctx, emailAuthSchema)\n\t\treturn new EmailClient(auth, transportOptions(ctx))\n\t}\n\n\tstatic fromAuth(auth: EmailAuth, ctx: ToolContext = {}): EmailClient {\n\t\treturn new EmailClient(auth, transportOptions(ctx))\n\t}\n\n\tasync send(input: EmailSendInput) {\n\t\ttry {\n\t\t\treturn await this.#provider.send({ ...input, from: this.#sender })\n\t\t} catch (error) {\n\t\t\tthrow emailDeliveryError(error)\n\t\t}\n\t}\n\n\tsendBatch(input: EmailSendBatchInput) {\n\t\treturn runBatchItems(input.messages, (message) => this.send(message))\n\t}\n}\n","import { defineModule, defineTool } from '../../core/define'\nimport { EmailClient } from './client'\nimport {\n\temailAuthSchema,\n\temailSendBatchInputSchema,\n\temailSendBatchOutputSchema,\n\temailSendInputSchema,\n\temailSendOutputSchema\n} from './contracts'\n\nexport type { EmailAuth } from './contracts'\nexport { emailAuthSchema }\n\nexport const emailSendTool = defineTool({\n\tid: 'email-send',\n\tname: 'sendEmail',\n\tdescription:\n\t\t'Send one email via the bound email provider. Subject plus html and/or text. Optional cc, bcc, reply_to, headers, base64 attachments. Total under 5 MiB.',\n\tinputSchema: emailSendInputSchema,\n\toutputSchema: emailSendOutputSchema,\n\tsideEffect: 'send',\n\truntime: 'both',\n\texecute: async (input, ctx) => EmailClient.fromContext(ctx).send(input)\n})\n\nexport const emailSendBatchTool = defineTool({\n\tid: 'email-send-batch',\n\tname: 'sendEmailBatch',\n\tdescription:\n\t\t'Send up to 20 emails via the bound email provider. Per-message success or error without aborting the batch.',\n\tinputSchema: emailSendBatchInputSchema,\n\toutputSchema: emailSendBatchOutputSchema,\n\tsideEffect: 'send',\n\truntime: 'both',\n\texecute: async (input, ctx) => EmailClient.fromContext(ctx).sendBatch(input)\n})\n\nexport const emailModule = defineModule({\n\tid: 'email',\n\ttitle: 'Email',\n\tdescription:\n\t\t'Send transactional email from the configured sender. The model supplies recipients and content, never the sender identity.',\n\truntime: 'both',\n\tauth: { type: 'custom', schema: emailAuthSchema },\n\tcategories: ['email', 'messaging'],\n\tclassification: 'pii',\n\ttags: ['send'],\n\ttools: [emailSendTool, emailSendBatchTool]\n})\n"],"mappings":"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"}

package/dist/modules/email-message/index.d.ts

@@ -0,0 +1,95 @@
+import { a as ModuleDefinition, s as ToolDefinition } from "../../types-Ccb0DXY9.js";
+import "../../index-CZX5OeOF.js";
+//#region src/modules/email-message/module.d.ts
+declare const parseEmailMessageTool: ToolDefinition<{
+  raw: string;
+  encoding?: "base64" | "utf8" | undefined;
+}, {
+  subject?: string | undefined;
+  from?: {
+    address: string;
+    name?: string | undefined;
+  } | undefined;
+  to?: {
+    address: string;
+    name?: string | undefined;
+  }[] | undefined;
+  cc?: {
+    address: string;
+    name?: string | undefined;
+  }[] | undefined;
+  bcc?: {
+    address: string;
+    name?: string | undefined;
+  }[] | undefined;
+  reply_to?: {
+    address: string;
+    name?: string | undefined;
+  }[] | undefined;
+  message_id?: string | undefined;
+  in_reply_to?: string | undefined;
+  references?: string | undefined;
+  date?: string | undefined;
+  text?: string | undefined;
+  html?: string | undefined;
+  headers?: {
+    key: string;
+    value: string;
+  }[] | undefined;
+  attachments: {
+    filename?: string | undefined;
+    mime_type?: string | undefined;
+    size?: number | undefined;
+    disposition?: "attachment" | "inline" | undefined;
+    content_id?: string | undefined;
+    content_base64?: string | undefined;
+  }[];
+}>;
+declare const buildEmailMessageTool: ToolDefinition<{
+  from: string | {
+    address: string;
+    name?: string | undefined;
+  };
+  to: string | (string | {
+    address: string;
+    name?: string | undefined;
+  })[] | {
+    address: string;
+    name?: string | undefined;
+  };
+  subject: string;
+  text?: string | undefined;
+  html?: string | undefined;
+  cc?: string | (string | {
+    address: string;
+    name?: string | undefined;
+  })[] | {
+    address: string;
+    name?: string | undefined;
+  } | undefined;
+  bcc?: string | (string | {
+    address: string;
+    name?: string | undefined;
+  })[] | {
+    address: string;
+    name?: string | undefined;
+  } | undefined;
+  reply_to?: string | {
+    address: string;
+    name?: string | undefined;
+  } | undefined;
+  headers?: Record<string, string> | undefined;
+  attachments?: {
+    filename: string;
+    content_base64: string;
+    content_type?: string | undefined;
+    inline?: boolean | undefined;
+    content_id?: string | undefined;
+  }[] | undefined;
+}, {
+  raw: string;
+}>;
+declare const emailMessageModule: ModuleDefinition<unknown>;
+//#endregion
+export { buildEmailMessageTool, emailMessageModule, parseEmailMessageTool };
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/email-message/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/modules/email-message/module.ts"],"mappings":";;;cAiJa,uBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgEA,uBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAAA;;;;;;;;;;;cAsEA,oBAAA"}