@agent-native/core 0.138.0 → 0.139.0

package/dist/server/action-discovery.js

@@ -517,6 +517,28 @@ export async function mergeCoreSharingActions(registry) {
             () => import("../sharing/actions/create-agent-resource-link.js"),
         ],
         ["upload-image", () => import("../file-upload/actions/upload-image.js")],
+        // Transactional email catalog — mounted everywhere so Dispatch can ask any
+        // app what it sends without that app opting in.
+        [
+            "list-transactional-emails",
+            () => import("../email-catalog/actions/list-transactional-emails.js"),
+        ],
+        [
+            "render-transactional-email-preview",
+            () => import("../email-catalog/actions/render-transactional-email-preview.js"),
+        ],
+        [
+            "list-email-log",
+            () => import("../email-catalog/actions/list-email-log.js"),
+        ],
+        [
+            "list-email-activity",
+            () => import("../email-catalog/actions/list-email-activity.js"),
+        ],
+        [
+            "list-email-engagement",
+            () => import("../email-catalog/actions/list-email-engagement.js"),
+        ],
         [
             "get-feature-flags",
             () => import("../feature-flags/actions/get-feature-flags.js"),

package/dist/server/agent-engine-api-key-route.d.ts

@@ -27,11 +27,11 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
+    error?: undefined;
 }>>;
 export {};
 //# sourceMappingURL=agent-engine-api-key-route.d.ts.map

package/dist/server/better-auth-instance.js

@@ -18,6 +18,7 @@ import { TEMPLATES } from "../cli/templates-meta.js";
 import { getDbExec, isPostgres } from "../db/client.js";
 import { getDialect, getDatabaseUrl, getDatabaseAuthToken, closePgliteClients, getPgliteClient, isPgliteUrl, loadPgliteDrizzle, pgPoolOptions, neonPoolMax, attachNeonPoolErrorLogger, sharedDbPool, onSharedDbPoolsClosed, onSharedDbPoolReplaced, } from "../db/client.js";
 import { ensureTableExists } from "../db/ddl-guard.js";
+import { CORE_RESET_PASSWORD_EMAIL_ID, CORE_VERIFY_SIGNUP_EMAIL_ID, } from "../email-catalog/system-emails.js";
 import { saveOAuthTokens } from "../oauth-tokens/store.js";
 import { acceptPendingInvitationsForEmail } from "../org/accept-pending.js";
 import { getAuthEmailForUserId, getRequiredAuthProviderForEmail, } from "../org/auth-policy.js";
@@ -918,7 +919,14 @@ async function createBetterAuthInstance(config) {
                     email: user.email,
                     resetUrl,
                 });
-                await sendEmail({ to: user.email, subject, html, text, appSender });
+                await sendEmail({
+                    to: user.email,
+                    subject,
+                    html,
+                    text,
+                    appSender,
+                    templateId: CORE_RESET_PASSWORD_EMAIL_ID,
+                });
             },
         },
         emailVerification: {
@@ -942,7 +950,14 @@ async function createBetterAuthInstance(config) {
                     email: user.email,
                     verifyUrl,
                 });
-                await sendEmail({ to: user.email, subject, html, text, appSender });
+                await sendEmail({
+                    to: user.email,
+                    subject,
+                    html,
+                    text,
+                    appSender,
+                    templateId: CORE_VERIFY_SIGNUP_EMAIL_ID,
+                });
             },
         },
         socialProviders,

package/dist/server/email.d.ts

@@ -58,6 +58,15 @@ export interface SendEmailArgs {
     references?: string;
     attachments?: EmailAttachment[];
     timeoutMs?: number;
+    /**
+     * Registered transactional email id (see `defineTransactionalEmail`), e.g.
+     * `calendar.booking-confirmed`. Tags the message at the provider so delivery
+     * and open metrics attribute to one email instead of to the whole account,
+     * and keys the row written to `email_log`. Omit for genuinely one-off sends.
+     */
+    templateId?: string;
+    /** App slug that owns the send. Defaults to the running app. */
+    app?: string;
 }
 export declare function isEmailConfigured(): Promise<boolean>;
 /**

package/dist/server/email.js

@@ -10,6 +10,8 @@
  * so the reset-password flow still works end-to-end for local development.
  */
 import { FAVICON_PNG_BASE64 } from "../assets/branding/favicon-base64.js";
+import { recordEmailSend } from "../email-catalog/log.js";
+import { getAppSlug } from "./app-name.js";
 import { resolveSecret } from "./credential-provider.js";
 import { AGENT_NATIVE_EMAIL_LOGO_CONTENT_ID } from "./email-template.js";
 let cachedAgentNativeLogo;
@@ -154,7 +156,7 @@ function resolveAppSender(configuredFrom, appSender) {
         replyTo: appSender.replyTo,
     };
 }
-async function sendEmailWithSignal(args, signal) {
+async function deliverEmail(args, signal) {
     const config = await resolveEmailTransport();
     signal?.throwIfAborted();
     const provider = config.provider;
@@ -206,7 +208,7 @@ async function sendEmailWithSignal(args, signal) {
             const body = await res.text().catch(() => "");
             throw new Error(`Resend error ${res.status}: ${body}`);
         }
-        return;
+        return { provider, from };
     }
     if (provider === "sendgrid") {
         const personalization = {
@@ -227,6 +229,12 @@ async function sendEmailWithSignal(args, signal) {
         };
         if (replyTo)
             sgPayload.reply_to = parseSendGridFrom(replyTo);
+        // Categories are how per-email delivery/open stats are attributed. Without
+        // them every send lands in one undifferentiated account-wide bucket, which
+        // is indistinguishable from an email that never sent.
+        const categories = [args.templateId, args.app ?? getAppSlug()].filter((value) => Boolean(value));
+        if (categories.length)
+            sgPayload.categories = categories;
         const sgHeaders = {};
         if (args.inReplyTo)
             sgHeaders["In-Reply-To"] = args.inReplyTo;
@@ -258,7 +266,7 @@ async function sendEmailWithSignal(args, signal) {
             const body = await res.text().catch(() => "");
             throw new Error(`SendGrid error ${res.status}: ${body}`);
         }
-        return;
+        return { provider, from };
     }
     // Dev fallback — no provider configured. Logging the full body exposes
     // reset tokens, so only do it outside production. In production, refuse
@@ -270,6 +278,39 @@ async function sendEmailWithSignal(args, signal) {
         `Save RESEND_API_KEY or SENDGRID_API_KEY in settings to send real emails.\n` +
         `---\nTo: ${args.to}\nFrom: ${from}\nSubject: ${args.subject}\n\n` +
         `${args.text || stripHtml(args.html)}\n---\n`);
+    return { provider, from };
+}
+/**
+ * Deliver, then record the attempt. Recording lives here rather than in each
+ * provider branch so a new transport cannot be added without being logged.
+ */
+async function sendEmailWithSignal(args, signal) {
+    let outcome;
+    try {
+        outcome = await deliverEmail(args, signal);
+    }
+    catch (error) {
+        await recordEmailSend({
+            templateId: args.templateId,
+            app: args.app ?? getAppSlug() ?? "unknown",
+            recipient: args.to,
+            sender: outcome?.from ?? args.from ?? "unknown",
+            subject: args.subject,
+            status: "failed",
+            error: error instanceof Error ? error.message : String(error),
+            provider: outcome?.provider ?? "unknown",
+        });
+        throw error;
+    }
+    await recordEmailSend({
+        templateId: args.templateId,
+        app: args.app ?? getAppSlug() ?? "unknown",
+        recipient: args.to,
+        sender: outcome.from,
+        subject: args.subject,
+        status: "sent",
+        provider: outcome.provider,
+    });
 }
 export async function sendEmail(args) {
     const requestedTimeoutMs = Number(args.timeoutMs);

package/dist/server/index.d.ts

@@ -66,6 +66,7 @@ export { builderDesignSystemUrl, builderProjectBranchUrl, buildBuilderDesignSyst
 export { getBuilderBranchProjectId, isBuilderBranchingEnabled, requestBuilderBrowserConnection, resolveBuilderBranchProjectId, resolveIsBuilderBranchingEnabled, runBuilderAgent, type RunBuilderAgentResult, } from "./builder-browser.js";
 export { ensureFusionContainer, sendFusionBranchMessage, pushFusionBranch, reserveFusionHostingSlug, deployFusionProject, getFusionDeploys, getFusionBranchEditorUrl, getFusionHostingUrl, type FusionBranchRef, type EnsureFusionContainerResult, type SendFusionMessageResult, } from "./fusion-app.js";
 export { sendEmail, isEmailConfigured, getEmailProvider, type EmailAttachment, type EmailProvider, type SendEmailArgs, } from "./email.js";
+export { defineTransactionalEmail, listTransactionalEmails, getTransactionalEmail, renderTransactionalEmailPreview, type TransactionalEmailDefinition, type RegisteredTransactionalEmail, } from "../email-catalog/registry.js";
 export { notifyActivity, runActivityNotification, resolveActivityRecipients, type ActivityDeliveryFailure, type ActivityNotificationResult, type ActivityNotificationStatus, type NotifyActivityInput, type ResolveActivityRecipientsInput, } from "./activity-notifications.js";
 export { renderEmail, emailStrong, emailLink, type RenderEmailArgs, type RenderedEmail, type EmailCta, } from "./email-template.js";
 export { getAppProductionUrl, getFirstPartyProdUrl } from "./app-url.js";

package/dist/server/index.js

@@ -67,6 +67,7 @@ export { builderDesignSystemUrl, builderProjectBranchUrl, buildBuilderDesignSyst
 export { getBuilderBranchProjectId, isBuilderBranchingEnabled, requestBuilderBrowserConnection, resolveBuilderBranchProjectId, resolveIsBuilderBranchingEnabled, runBuilderAgent, } from "./builder-browser.js";
 export { ensureFusionContainer, sendFusionBranchMessage, pushFusionBranch, reserveFusionHostingSlug, deployFusionProject, getFusionDeploys, getFusionBranchEditorUrl, getFusionHostingUrl, } from "./fusion-app.js";
 export { sendEmail, isEmailConfigured, getEmailProvider, } from "./email.js";
+export { defineTransactionalEmail, listTransactionalEmails, getTransactionalEmail, renderTransactionalEmailPreview, } from "../email-catalog/registry.js";
 export { notifyActivity, runActivityNotification, resolveActivityRecipients, } from "./activity-notifications.js";
 export { renderEmail, emailStrong, emailLink, } from "./email-template.js";
 export { getAppProductionUrl, getFirstPartyProdUrl } from "./app-url.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.138.0",
+  "version": "0.139.0",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -240,6 +240,7 @@
     "./comments-review/actions/get-review-feedback": "./dist/review/actions/get-review-feedback.js",
     "./comments-review/actions/set-review-status": "./dist/review/actions/set-review-status.js",
     "./comments-review/actions/send-review-thread-to-agent": "./dist/review/actions/send-review-thread-to-agent.js",
+    "./email-catalog": "./dist/email-catalog/registry.js",
     "./sharing": "./dist/sharing/index.js",
     "./sharing/actions/share-resource": "./dist/sharing/actions/share-resource.js",
     "./sharing/actions/unshare-resource": "./dist/sharing/actions/unshare-resource.js",