@agent-native/core 0.138.0 → 0.139.0

package/dist/email-catalog/schema.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Drizzle schema for the transactional email send log.
+ *
+ * One row per `sendEmail` attempt, written by the transport itself so every
+ * send is recorded regardless of which app or code path triggered it. This is
+ * the durable record of "did we send it": the provider's own activity feed ages
+ * out (SendGrid keeps 3 days without the extended-retention add-on), so send
+ * counts and last-sent must not depend on it.
+ *
+ * Engagement (opens, clicks, bounces) is deliberately NOT stored here. Only the
+ * provider knows it, and mirroring it would go stale the moment a recipient
+ * opens an old message. Dispatch reads engagement live from the provider and
+ * joins on `template_id`.
+ */
+export declare const emailLog: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "email_log";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "email_log";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        templateId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "template_id";
+            tableName: "email_log";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        app: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "app";
+            tableName: "email_log";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        recipient: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "recipient";
+            tableName: "email_log";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        sender: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "sender";
+            tableName: "email_log";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        subject: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "subject";
+            tableName: "email_log";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "status";
+            tableName: "email_log";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "failed" | "sent";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["sent", "failed"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        error: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "error";
+            tableName: "email_log";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        provider: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "provider";
+            tableName: "email_log";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "email_log";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'sqlite';
+}>;
+export declare const EMAIL_LOG_CREATE_SQL = "CREATE TABLE IF NOT EXISTS email_log (\n  id TEXT PRIMARY KEY,\n  template_id TEXT,\n  app TEXT,\n  recipient TEXT NOT NULL,\n  sender TEXT NOT NULL,\n  subject TEXT NOT NULL,\n  status TEXT NOT NULL,\n  error TEXT,\n  provider TEXT NOT NULL,\n  created_at INTEGER NOT NULL\n)";
+export declare const EMAIL_LOG_TEMPLATE_INDEX_SQL = "CREATE INDEX IF NOT EXISTS email_log_template_created_idx\n  ON email_log (template_id, created_at)";
+//# sourceMappingURL=schema.d.ts.map

package/dist/email-catalog/schema.js

@@ -0,0 +1,49 @@
+/**
+ * Drizzle schema for the transactional email send log.
+ *
+ * One row per `sendEmail` attempt, written by the transport itself so every
+ * send is recorded regardless of which app or code path triggered it. This is
+ * the durable record of "did we send it": the provider's own activity feed ages
+ * out (SendGrid keeps 3 days without the extended-retention add-on), so send
+ * counts and last-sent must not depend on it.
+ *
+ * Engagement (opens, clicks, bounces) is deliberately NOT stored here. Only the
+ * provider knows it, and mirroring it would go stale the moment a recipient
+ * opens an old message. Dispatch reads engagement live from the provider and
+ * joins on `template_id`.
+ */
+import { table, text, integer } from "../db/schema.js";
+export const emailLog = table("email_log", {
+    id: text("id").primaryKey(),
+    /** Registered transactional email id, e.g. "calendar.booking-confirmed". */
+    templateId: text("template_id"),
+    /** App slug that sent it. */
+    app: text("app"),
+    /** Recipient address. */
+    recipient: text("recipient").notNull(),
+    /** Resolved From address, after app-sender branding is applied. */
+    sender: text("sender").notNull(),
+    subject: text("subject").notNull(),
+    /** "sent" once the provider accepted it, or "failed". Never optimistic. */
+    status: text("status", { enum: ["sent", "failed"] }).notNull(),
+    /** Provider error text when status is "failed". */
+    error: text("error"),
+    /** "resend" | "sendgrid" | "dev". */
+    provider: text("provider").notNull(),
+    createdAt: integer("created_at").notNull(),
+});
+export const EMAIL_LOG_CREATE_SQL = `CREATE TABLE IF NOT EXISTS email_log (
+  id TEXT PRIMARY KEY,
+  template_id TEXT,
+  app TEXT,
+  recipient TEXT NOT NULL,
+  sender TEXT NOT NULL,
+  subject TEXT NOT NULL,
+  status TEXT NOT NULL,
+  error TEXT,
+  provider TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+)`;
+export const EMAIL_LOG_TEMPLATE_INDEX_SQL = `CREATE INDEX IF NOT EXISTS email_log_template_created_idx
+  ON email_log (template_id, created_at)`;
+//# sourceMappingURL=schema.js.map

package/dist/email-catalog/system-emails.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Catalog entries for the framework's own system emails.
+ *
+ * These ship with every app rather than belonging to one, so they register
+ * under the `core` app instead of the running app's slug. Importing this module
+ * performs the registration; `register-system-emails.ts` is the single import
+ * site so the emails appear in every app's catalog without each template
+ * remembering to opt in.
+ */
+export declare const CORE_INVITE_EMAIL_ID = "core.organization-invite";
+export declare const CORE_VERIFY_SIGNUP_EMAIL_ID = "core.verify-signup";
+export declare const CORE_RESET_PASSWORD_EMAIL_ID = "core.reset-password";
+export declare function registerCoreSystemEmails(): void;
+//# sourceMappingURL=system-emails.d.ts.map

package/dist/email-catalog/system-emails.js

@@ -0,0 +1,68 @@
+/**
+ * Catalog entries for the framework's own system emails.
+ *
+ * These ship with every app rather than belonging to one, so they register
+ * under the `core` app instead of the running app's slug. Importing this module
+ * performs the registration; `register-system-emails.ts` is the single import
+ * site so the emails appear in every app's catalog without each template
+ * remembering to opt in.
+ */
+import { renderInviteEmail, renderResetPasswordEmail, renderVerifySignupEmail, } from "../server/email-templates.js";
+import { defineTransactionalEmail } from "./registry.js";
+/** Obviously-fake sample data — these render in a preview pane, never send. */
+const SAMPLE_URL = "https://example.com/accept/sample-token";
+const SAMPLE_EMAIL = "sam.rivera@example.com";
+export const CORE_INVITE_EMAIL_ID = "core.organization-invite";
+export const CORE_VERIFY_SIGNUP_EMAIL_ID = "core.verify-signup";
+export const CORE_RESET_PASSWORD_EMAIL_ID = "core.reset-password";
+let registered = false;
+export function registerCoreSystemEmails() {
+    if (registered)
+        return;
+    registered = true;
+    defineTransactionalEmail({
+        id: CORE_INVITE_EMAIL_ID,
+        app: "core",
+        name: "Organization invitation",
+        trigger: "A member invites someone to their organization from the team settings page.",
+        recipientLabel: "Invited address",
+        recipient: "The address typed into the invite form. One email per invited address.",
+        senderLabel: "Default, app-branded",
+        sender: "The configured EMAIL_FROM. On first-party agent-native.com deployments the display name becomes the app's own, with reply-to agent-native@builder.io.",
+        preview: () => renderInviteEmail({
+            invitee: SAMPLE_EMAIL,
+            orgName: "Northwind Design",
+            acceptUrl: SAMPLE_URL,
+            inviter: "alex.chen@example.com",
+        }),
+    });
+    defineTransactionalEmail({
+        id: CORE_VERIFY_SIGNUP_EMAIL_ID,
+        app: "core",
+        name: "Verify signup",
+        trigger: "A new account is created with email and password, before the account can be used.",
+        recipientLabel: "New account address",
+        recipient: "The address the account was registered with.",
+        senderLabel: "Default, app-branded",
+        sender: "The configured EMAIL_FROM, branded with the app name the signup happened in.",
+        preview: () => renderVerifySignupEmail({
+            email: SAMPLE_EMAIL,
+            verifyUrl: SAMPLE_URL,
+        }),
+    });
+    defineTransactionalEmail({
+        id: CORE_RESET_PASSWORD_EMAIL_ID,
+        app: "core",
+        name: "Reset password",
+        trigger: "A user requests a password reset from the sign-in screen. The link expires after one hour.",
+        recipientLabel: "Account address",
+        recipient: "The account address the reset was requested for, never an address supplied in the request body.",
+        senderLabel: "Default, app-branded",
+        sender: "The configured EMAIL_FROM, branded with the app name the reset was requested from.",
+        preview: () => renderResetPasswordEmail({
+            email: SAMPLE_EMAIL,
+            resetUrl: SAMPLE_URL,
+        }),
+    });
+}
+//# sourceMappingURL=system-emails.js.map

package/dist/file-upload/actions/upload-image.d.ts

@@ -17,12 +17,12 @@ declare const _default: import("../../action.js").ActionDefinition<{
     id?: undefined;
     provider?: undefined;
 } | {
-    error?: undefined;
     configured?: undefined;
     connectPath?: undefined;
     url: string;
     id: string;
     provider: string;
+    error?: undefined;
 }>;
 export default _default;
 //# sourceMappingURL=upload-image.d.ts.map

package/dist/localization/default-messages.d.ts

@@ -175,6 +175,7 @@ declare const messages: {
             resources: string;
             messaging: string;
             destinations: string;
+            transactionalEmail: string;
             identities: string;
             approvals: string;
             automations: string;
@@ -205,6 +206,50 @@ declare const messages: {
             suggestionRouteSlack: string;
             suggestionGrantKey: string;
         };
+        transactionalEmail: {
+            title: string;
+            description: string;
+            retentionTitle: string;
+            retentionNote: string;
+            openRatesUnavailable: string;
+            sharedProviderMetricsUnavailable: string;
+            catalogFanoutFailed: string;
+            retry: string;
+            noApps: string;
+            catalogUnreadable: string;
+            countsUnreadable: string;
+            appSendsNoEmail: string;
+            emailNotFound: string;
+            emailNotFoundDescription: string;
+            sharedTitle: string;
+            sharedSubtitle: string;
+            email: string;
+            trigger: string;
+            sends: string;
+            openRate: string;
+            lastSent: string;
+            sendLogUnread: string;
+            failedCount: string;
+            failuresUnknown: string;
+            noProviderRecord: string;
+            noDeliveredMail: string;
+            neverSent: string;
+            lastSentUnknown: string;
+            preview: string;
+            previewDescription: string;
+            previewFailed: string;
+            previewFrameTitle: string;
+            subject: string;
+            activityLink: string;
+            activityTitle: string;
+            activityUnavailable: string;
+            activityEmpty: string;
+            recipient: string;
+            sender: string;
+            status: string;
+            opens: string;
+            lastEvent: string;
+        };
         pages: {
             appsDescription: string;
             appsDescriptionWithWorkspace: string;

package/dist/localization/default-messages.js

@@ -180,6 +180,7 @@ const messages = {
             resources: "Resources",
             messaging: "Messaging",
             destinations: "Destinations",
+            transactionalEmail: "Transactional email",
             identities: "Identities",
             approvals: "Approvals",
             automations: "Automations",
@@ -210,6 +211,50 @@ const messages = {
             suggestionRouteSlack: "Route Slack mentions to my analytics app",
             suggestionGrantKey: "Grant my OpenAI key to this app",
         },
+        transactionalEmail: {
+            title: "Transactional email",
+            description: "Every transactional email each app in this workspace can send, with its trigger, recipients, and delivery metrics.",
+            retentionTitle: "Activity feed retention is short",
+            retentionNote: "The email provider's activity feed only retains recent messages, so an empty activity list does not mean nothing was sent.",
+            openRatesUnavailable: "Open rates unavailable",
+            sharedProviderMetricsUnavailable: "Provider metrics vary by sending app. Expand an app to see its provider data.",
+            catalogFanoutFailed: "Could not load app email catalogs",
+            retry: "Retry",
+            noApps: "No ready apps reported a transactional email catalog.",
+            catalogUnreadable: "This app's email catalog could not be read",
+            countsUnreadable: "Send counts could not be read",
+            appSendsNoEmail: "This app sends no transactional email of its own.",
+            emailNotFound: "Email not found",
+            emailNotFoundDescription: "This email is not in the app's catalog.",
+            sharedTitle: "Shared system email",
+            sharedSubtitle: "sent by every app",
+            email: "Email",
+            trigger: "Trigger",
+            sends: "Sends",
+            openRate: "Open rate",
+            lastSent: "Last sent",
+            sendLogUnread: "The send log could not be read, so the number of sends is unknown.",
+            failedCount: "{{count}} failed",
+            failuresUnknown: "failures unknown",
+            noProviderRecord: "The provider reported no record for this email in the window.",
+            noDeliveredMail: "No delivered mail yet",
+            neverSent: "Never sent",
+            lastSentUnknown: "The send log could not be read, so the last send time is unknown.",
+            preview: "Preview",
+            previewDescription: "Rendered with dummy data. Scripts are disabled in this preview.",
+            previewFailed: "Preview could not be rendered",
+            previewFrameTitle: "Preview of {{name}}",
+            subject: "Subject",
+            activityLink: "Activity log",
+            activityTitle: "Activity for {{name}}",
+            activityUnavailable: "Activity feed unavailable",
+            activityEmpty: "No recent activity in the provider's retention window.",
+            recipient: "Recipient",
+            sender: "Sender",
+            status: "Status",
+            opens: "Opens",
+            lastEvent: "Last event",
+        },
         pages: {
             appsDescription: "Open workspace apps and start new app creation from Dispatch.",
             appsDescriptionWithWorkspace: 'Apps in the "{{workspace}}" workspace. Each app gets its own route under this workspace and shares its database, auth, and agent chat.',

package/dist/notifications/routes.d.ts

@@ -13,22 +13,22 @@
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
     count: number;
     updated?: undefined;
-    ok?: undefined;
     error?: undefined;
+    ok?: undefined;
 } | {
+    count?: undefined;
     updated: number;
-    ok?: undefined;
     error?: undefined;
-    count?: undefined;
+    ok?: undefined;
 } | {
+    count?: undefined;
     updated?: undefined;
     error: string;
     ok?: undefined;
-    count?: undefined;
 } | {
+    count?: undefined;
     updated?: undefined;
     ok: boolean;
     error?: undefined;
-    count?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/org/handlers.js

@@ -28,6 +28,7 @@ function extractMemberEmail(event) {
 const nanoid = () => globalThis.crypto?.randomUUID?.().replace(/-/g, "") ??
     Math.random().toString(36).slice(2) + Date.now().toString(36);
 import { getDbExec, isPostgres } from "../db/client.js";
+import { CORE_INVITE_EMAIL_ID } from "../email-catalog/system-emails.js";
 import { ssrfSafeFetch } from "../extensions/url-safety.js";
 import { getAppProductionUrl } from "../server/app-url.js";
 import { getSession } from "../server/auth.js";
@@ -275,7 +276,13 @@ async function inviteOne(ctx, rawEmail, role, event) {
                 acceptUrl: getInviteAppUrl(event),
                 inviter: ctx.email,
             });
-            await sendEmail({ to: email, subject, html, text });
+            await sendEmail({
+                to: email,
+                subject,
+                html,
+                text,
+                templateId: CORE_INVITE_EMAIL_ID,
+            });
             emailSent = true;
         }
         catch (err) {

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -75,9 +75,9 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         user: "user";
     }>>;
 }, z.core.$strip>>, {
+    deleted?: undefined;
     id?: undefined;
     provider?: undefined;
-    deleted?: undefined;
     found?: undefined;
     providers: {
         id: string;
@@ -93,41 +93,41 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
-    id?: undefined;
     deleted?: undefined;
-    providers?: undefined;
     count?: undefined;
+    id?: undefined;
+    providers?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
-    provider?: undefined;
     deleted?: undefined;
-    providers?: undefined;
     count?: undefined;
+    provider?: undefined;
+    providers?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
+    count?: undefined;
     provider?: undefined;
     found?: undefined;
     providers?: undefined;
-    count?: undefined;
     deleted: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
-    provider?: undefined;
     deleted?: undefined;
+    count?: undefined;
+    provider?: undefined;
     found?: undefined;
     providers?: undefined;
-    count?: undefined;
     registered: boolean;
     id: string;
     label: string;

package/dist/provider-api/actions/provider-api.d.ts

@@ -311,11 +311,10 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         notes?: string | undefined;
         scope?: "org" | "user" | undefined;
     }, {
+        message?: undefined;
         id?: undefined;
-        provider?: undefined;
         deleted?: undefined;
         found?: undefined;
-        message?: undefined;
         providers: {
             id: string;
             label: string;
@@ -326,44 +325,45 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
             updatedAt: number;
         }[];
         count: number;
+        provider?: undefined;
         registered?: undefined;
         label?: undefined;
     } | {
+        message?: undefined;
         id?: undefined;
-        count?: undefined;
         deleted?: undefined;
-        message?: undefined;
+        count?: undefined;
         providers?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
         registered?: undefined;
         label?: undefined;
     } | {
-        count?: undefined;
-        provider?: undefined;
-        deleted?: undefined;
         message?: undefined;
+        deleted?: undefined;
+        count?: undefined;
         providers?: undefined;
+        provider?: undefined;
         found: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
     } | {
-        count?: undefined;
-        provider?: undefined;
-        found?: undefined;
         message?: undefined;
+        found?: undefined;
+        count?: undefined;
         providers?: undefined;
+        provider?: undefined;
         deleted: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
     } | {
-        count?: undefined;
-        provider?: undefined;
         deleted?: undefined;
         found?: undefined;
+        count?: undefined;
         providers?: undefined;
+        provider?: undefined;
         registered: boolean;
         id: string;
         label: string;