@agent-native/core 0.141.2 → 0.141.4

package/dist/server/email.js

@@ -10,8 +10,11 @@
  * so the reset-password flow still works end-to-end for local development.
  */
 import { FAVICON_PNG_BASE64 } from "../assets/branding/favicon-base64.js";
+import { getScopedEmailProviderCategory, 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";
+import { getRequestOrgId } from "./request-context.js";
 let cachedAgentNativeLogo;
 function getAgentNativeLogoAttachment() {
     cachedAgentNativeLogo ??= Buffer.from(FAVICON_PNG_BASE64, "base64");
@@ -154,7 +157,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 +209,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 +230,19 @@ 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 orgId = args.orgId ?? getRequestOrgId();
+        const categories = [
+            args.templateId,
+            args.app ?? getAppSlug(),
+            args.templateId && orgId
+                ? getScopedEmailProviderCategory(args.templateId, orgId)
+                : undefined,
+        ].filter((value) => Boolean(value));
+        if (categories.length)
+            sgPayload.categories = categories;
         const sgHeaders = {};
         if (args.inReplyTo)
             sgHeaders["In-Reply-To"] = args.inReplyTo;
@@ -258,7 +274,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 +286,41 @@ 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",
+            orgId: args.orgId ?? getRequestOrgId(),
+            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",
+        orgId: args.orgId ?? getRequestOrgId(),
+        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

@@ -1,5 +1,5 @@
 export { createServer, type CreateServerOptions, type EnvKeyConfig, } from "./create-server.js";
-export { AGENT_BACKGROUND_PROCESSOR_FIELD, AGENT_BACKGROUND_PROCESSOR_ROUTE, AGENT_BACKGROUND_PROCESSOR_ROUTE_FIELD, dispatchPathTargetsNetlifyBackgroundFunction, resolveDurableBackgroundDispatchPath, } from "../agent/durable-background.js";
+export { AGENT_BACKGROUND_PROCESSOR_FIELD, AGENT_BACKGROUND_PROCESSOR_ROUTE, AGENT_BACKGROUND_PROCESSOR_ROUTE_FIELD, dispatchPathTargetsNetlifyBackgroundFunction, isInBackgroundFunctionRuntime, resolveDurableBackgroundDispatchPath, } from "../agent/durable-background.js";
 export { readBody, readBodyWithSizeLimit, streamFile, DEFAULT_CHAT_MAX_BODY_BYTES, DEFAULT_UPLOAD_MAX_FILE_BYTES, MAX_CHAT_ATTACHMENTS_PER_MESSAGE, isAllowedUploadMimeType, } from "./h3-helpers.js";
 export { buildDeepLink, toAbsoluteOpenUrl, toDesktopOpenUrl, toVsCodeOpenUrl, OPEN_ROUTE_SUBPATH, DESKTOP_OPEN_URL, VSCODE_OPEN_URL, type DeepLinkInput, } from "./deep-link.js";
 export { createOpenRouteHandler, type OpenRouteOptions } from "./open-route.js";
@@ -65,7 +65,8 @@ export { FeatureNotConfiguredError, hasBuilderPrivateKey, isBuilderEnvManaged, g
 export { builderDesignSystemUrl, builderProjectBranchUrl, buildBuilderDesignSystemIndexFiles, createBuilderDesignSystemProxyFields, fetchBuilderDesignSystemDecodeJobStatus, fetchBuilderDesignSystemDocs, getBuilderDesignSystemsBaseUrl, hydrateBuilderDesignSystemReference, indexBuilderDesignSystem, localBuilderDesignSystemId, mimeTypeForBuilderDesignSystemFilename, parseBuilderDesignSystemProxyReference, startBuilderDesignSystemIndex, startBuilderDesignSystemUpload, type BuildBuilderDesignSystemIndexFilesOptions, type BuilderDesignSystemCodeFileInput, type BuilderDesignSystemDecodeJobStatus, type BuilderDesignSystemDocsOptions, type BuilderDesignSystemDocument, type BuilderDesignSystemHydratedReference, type BuilderDesignSystemIndexFile, type BuilderDesignSystemIndexFromSourcesOptions, type BuilderDesignSystemIndexOptions, type BuilderDesignSystemIndexResult, type BuilderDesignSystemUploadAttachment, type BuilderDesignSystemUploadSlot, type BuilderDesignSystemProxyFields, type BuilderDesignSystemProxyFieldsOptions, type BuilderDesignSystemProxyReference, type BuilderDesignSystemSourceKind, } from "./builder-design-systems.js";
 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 { sendEmail, isEmailConfigured, getEmailReadiness, getEmailProvider, type EmailAttachment, type EmailReadiness, 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

@@ -1,5 +1,5 @@
 export { createServer, } from "./create-server.js";
-export { AGENT_BACKGROUND_PROCESSOR_FIELD, AGENT_BACKGROUND_PROCESSOR_ROUTE, AGENT_BACKGROUND_PROCESSOR_ROUTE_FIELD, dispatchPathTargetsNetlifyBackgroundFunction, resolveDurableBackgroundDispatchPath, } from "../agent/durable-background.js";
+export { AGENT_BACKGROUND_PROCESSOR_FIELD, AGENT_BACKGROUND_PROCESSOR_ROUTE, AGENT_BACKGROUND_PROCESSOR_ROUTE_FIELD, dispatchPathTargetsNetlifyBackgroundFunction, isInBackgroundFunctionRuntime, resolveDurableBackgroundDispatchPath, } from "../agent/durable-background.js";
 export { readBody, readBodyWithSizeLimit, streamFile, DEFAULT_CHAT_MAX_BODY_BYTES, DEFAULT_UPLOAD_MAX_FILE_BYTES, MAX_CHAT_ATTACHMENTS_PER_MESSAGE, isAllowedUploadMimeType, } from "./h3-helpers.js";
 export { buildDeepLink, toAbsoluteOpenUrl, toDesktopOpenUrl, toVsCodeOpenUrl, OPEN_ROUTE_SUBPATH, DESKTOP_OPEN_URL, VSCODE_OPEN_URL, } from "./deep-link.js";
 export { createOpenRouteHandler } from "./open-route.js";
@@ -66,7 +66,8 @@ export { FeatureNotConfiguredError, hasBuilderPrivateKey, isBuilderEnvManaged, g
 export { builderDesignSystemUrl, builderProjectBranchUrl, buildBuilderDesignSystemIndexFiles, createBuilderDesignSystemProxyFields, fetchBuilderDesignSystemDecodeJobStatus, fetchBuilderDesignSystemDocs, getBuilderDesignSystemsBaseUrl, hydrateBuilderDesignSystemReference, indexBuilderDesignSystem, localBuilderDesignSystemId, mimeTypeForBuilderDesignSystemFilename, parseBuilderDesignSystemProxyReference, startBuilderDesignSystemIndex, startBuilderDesignSystemUpload, } from "./builder-design-systems.js";
 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 { sendEmail, isEmailConfigured, getEmailReadiness, 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/dist/vite/client.js

@@ -2944,6 +2944,18 @@ function createAgentNativeConfig(options = {}, command, userConfig = {}, mode =
         },
     };
 }
+function createAgentNativeConfigPlugin(options) {
+    return {
+        name: "agent-native-config",
+        enforce: "pre",
+        async config(config, env) {
+            const projectConfig = options.agentNativeConfig === undefined
+                ? await loadAgentNativeConfigFile(process.cwd())
+                : undefined;
+            return createAgentNativeConfig(options, env.command, config, env.mode, projectConfig);
+        },
+    };
+}
 /**
  * Agent-Native's Vite plugin preset.
  *
@@ -2962,16 +2974,7 @@ function createAgentNativeConfig(options = {}, command, userConfig = {}, mode =
  */
 export function agentNative(options = {}) {
     return [
-        {
-            name: "agent-native-config",
-            enforce: "pre",
-            async config(config, env) {
-                const projectConfig = options.agentNativeConfig === undefined
-                    ? await loadAgentNativeConfigFile(process.cwd())
-                    : undefined;
-                return createAgentNativeConfig(options, env.command, config, env.mode, projectConfig);
-            },
-        },
+        createAgentNativeConfigPlugin(options),
         ...createAgentNativePlugins(options, {
             includeReactTransform: options.legacySpa === true,
             useServeOnlyNitroPlugin: true,
@@ -2988,10 +2991,13 @@ export function defineConfig(options = {}) {
     const includeReactTransform = !hasReactRouterPlugin(options.plugins) && !options.reactRouter;
     return {
         ...createAgentNativeConfig(options),
-        plugins: createAgentNativePlugins(options, {
-            includeReactTransform,
-            userPlugins: options.plugins,
-        }),
+        plugins: [
+            createAgentNativeConfigPlugin(options),
+            ...createAgentNativePlugins(options, {
+                includeReactTransform,
+                userPlugins: options.plugins,
+            }),
+        ],
     };
 }
 export { getClientDedupe as _getClientDedupe, getDefaultOptimizeDeps as _getDefaultOptimizeDeps, findCorePackageRoot as _findCorePackageRoot, getReactRouterAliases as _getReactRouterAliases, nitroStartupGate as _nitroStartupGate, nitroStartupRecovery as _nitroStartupRecovery, nitroModuleGraphSignature as _nitroModuleGraphSignature, debounceNitroFullReloadHotUpdate as _debounceNitroFullReloadHotUpdate, installReactRouterVirtualInvalidationMirror as _installReactRouterVirtualInvalidationMirror, mirrorReactRouterVirtualInvalidation as _mirrorReactRouterVirtualInvalidation, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.141.2",
+  "version": "0.141.4",
   "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": {
@@ -314,6 +314,7 @@
     "./code-agents/transcript-normalizer": "./dist/code-agents/transcript-normalizer.js",
     "./workspace-connections": "./dist/workspace-connections/index.js",
     "./notifications": "./dist/notifications/index.js",
+    "./jobs": "./dist/jobs/index.js",
     "./client/notifications": "./dist/client/notifications/index.js",
     "./progress": "./dist/progress/index.js",
     "./client/progress": "./dist/client/progress/index.js",