@agent-native/core 0.137.8 → 0.139.0

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

@@ -0,0 +1,79 @@
+/**
+ * Registry of the transactional emails an app can send.
+ *
+ * An app declares each email it sends here so the workspace can answer, without
+ * reading the app's source: what emails exist, what makes one send, who it goes
+ * to, who it comes from, and what it looks like. Dispatch aggregates these
+ * across every mounted app via the `list-transactional-emails` action.
+ *
+ * Declare emails next to the code that sends them, then import that module from
+ * a server plugin so registration happens at startup:
+ *
+ *   defineTransactionalEmail({
+ *     id: "calendar.booking-confirmed",
+ *     name: "Booking confirmed",
+ *     trigger: "A guest completes a booking on a public scheduling page.",
+ *     recipient: "The guest email captured on the booking form.",
+ *     sender: "EMAIL_FROM, with reply-to set to the event host.",
+ *     preview: () => renderBookingConfirmedEmail(SAMPLE_BOOKING),
+ *   });
+ *
+ * The `id` doubles as the SendGrid category `sendEmail` tags the message with,
+ * which is how per-email delivery and open metrics are attributed later.
+ */
+import type { RenderedEmailMessage } from "../server/email-templates.js";
+export interface TransactionalEmailDefinition {
+    /**
+     * Stable, globally unique id in `<app>.<email>` form, e.g.
+     * `calendar.booking-confirmed`. Used as the SendGrid category, so changing it
+     * orphans historical metrics for this email.
+     */
+    id: string;
+    /** Human-readable name, e.g. "Booking confirmed". */
+    name: string;
+    /**
+     * App slug this email belongs to. Defaults to the running app, which is
+     * correct for every app-declared email; core system emails set it explicitly.
+     */
+    app?: string;
+    /** Plain-language description of the condition that causes a send. */
+    trigger: string;
+    /** Plain-language description of how the recipient address is chosen. */
+    recipient: string;
+    /**
+     * Two-to-four word summary of the recipient for table cells, e.g.
+     * "Booking guest". The full `recipient` sentence is shown on the detail view.
+     */
+    recipientLabel: string;
+    /** Plain-language description of how From and Reply-To are chosen. */
+    sender: string;
+    /** Two-to-four word summary of the sender, e.g. "Default, reply-to host". */
+    senderLabel: string;
+    /**
+     * Render the email with representative dummy data. Must not read from the
+     * database or touch the network — previews are rendered on demand from
+     * Dispatch, for apps whose data the caller may not be able to see.
+     */
+    preview: () => RenderedEmailMessage;
+}
+/** A definition with its app resolved, as returned to callers. */
+export type RegisteredTransactionalEmail = TransactionalEmailDefinition & {
+    app: string;
+};
+/**
+ * Register a transactional email. Returns the definition so the call site can
+ * export it and reuse `id` when sending.
+ */
+export declare function defineTransactionalEmail(definition: TransactionalEmailDefinition): RegisteredTransactionalEmail;
+/** Every registered email, sorted by app then name. */
+export declare function listTransactionalEmails(): RegisteredTransactionalEmail[];
+export declare function getTransactionalEmail(id: string): RegisteredTransactionalEmail | undefined;
+/**
+ * Render one email's preview. Throws when the id is unknown or the renderer
+ * fails — a preview that silently returns an empty body would look like an
+ * email that legitimately renders blank.
+ */
+export declare function renderTransactionalEmailPreview(id: string): RenderedEmailMessage;
+/** Test seam — drops all registrations. */
+export declare function resetTransactionalEmailRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/email-catalog/registry.js

@@ -0,0 +1,71 @@
+/**
+ * Registry of the transactional emails an app can send.
+ *
+ * An app declares each email it sends here so the workspace can answer, without
+ * reading the app's source: what emails exist, what makes one send, who it goes
+ * to, who it comes from, and what it looks like. Dispatch aggregates these
+ * across every mounted app via the `list-transactional-emails` action.
+ *
+ * Declare emails next to the code that sends them, then import that module from
+ * a server plugin so registration happens at startup:
+ *
+ *   defineTransactionalEmail({
+ *     id: "calendar.booking-confirmed",
+ *     name: "Booking confirmed",
+ *     trigger: "A guest completes a booking on a public scheduling page.",
+ *     recipient: "The guest email captured on the booking form.",
+ *     sender: "EMAIL_FROM, with reply-to set to the event host.",
+ *     preview: () => renderBookingConfirmedEmail(SAMPLE_BOOKING),
+ *   });
+ *
+ * The `id` doubles as the SendGrid category `sendEmail` tags the message with,
+ * which is how per-email delivery and open metrics are attributed later.
+ */
+import { getAppSlug } from "../server/app-name.js";
+const registry = new Map();
+/** Source definitions, so re-registering the same one is a no-op rather than a clash. */
+const sources = new Map();
+/**
+ * Register a transactional email. Returns the definition so the call site can
+ * export it and reuse `id` when sending.
+ */
+export function defineTransactionalEmail(definition) {
+    const existing = sources.get(definition.id);
+    if (existing && existing !== definition) {
+        // Two emails sharing an id would silently merge their metrics and make the
+        // catalog claim one exists when the other actually sent.
+        throw new Error(`Duplicate transactional email id "${definition.id}". Ids must be unique across the app.`);
+    }
+    const resolved = {
+        ...definition,
+        app: definition.app ?? getAppSlug() ?? "unknown",
+    };
+    registry.set(definition.id, resolved);
+    sources.set(definition.id, definition);
+    return resolved;
+}
+/** Every registered email, sorted by app then name. */
+export function listTransactionalEmails() {
+    return [...registry.values()].sort((a, b) => a.app.localeCompare(b.app) || a.name.localeCompare(b.name));
+}
+export function getTransactionalEmail(id) {
+    return registry.get(id);
+}
+/**
+ * Render one email's preview. Throws when the id is unknown or the renderer
+ * fails — a preview that silently returns an empty body would look like an
+ * email that legitimately renders blank.
+ */
+export function renderTransactionalEmailPreview(id) {
+    const definition = registry.get(id);
+    if (!definition) {
+        throw new Error(`Unknown transactional email "${id}".`);
+    }
+    return definition.preview();
+}
+/** Test seam — drops all registrations. */
+export function resetTransactionalEmailRegistry() {
+    registry.clear();
+    sources.clear();
+}
+//# sourceMappingURL=registry.js.map

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/extensions/web-search-tool.js

@@ -209,7 +209,7 @@ export function createWebSearchToolEntry(opts = {}) {
     return {
         "web-search": {
             tool: {
-                description: "Search the public web. Use to find API documentation, endpoints, current information, or any topic. Returns ranked results from BYOK providers or a grounded Builder-managed summary. Follow up with web-request or provider-api-docs using responseMode:'markdown' or responseMode:'matches' to fetch clean text, links, or compact snippets from promising URLs. Requires either Connect Builder.io or one of: BRAVE_SEARCH_API_KEY, TAVILY_API_KEY, EXA_API_KEY, or FIRECRAWL_API_KEY.",
+                description: "Search the public web. Use to find API documentation, endpoints, current information, or any topic. Returns ranked results from BYOK providers or a grounded Builder-managed summary. Follow up with web-request or provider-api-docs using responseMode:'markdown' or responseMode:'matches' to fetch clean text, links, or compact snippets from promising URLs. Requires either Connect Builder.io (free tier available) or one of: BRAVE_SEARCH_API_KEY, TAVILY_API_KEY, EXA_API_KEY, or FIRECRAWL_API_KEY.",
                 parameters: {
                     type: "object",
                     properties: {
@@ -267,7 +267,7 @@ export function createWebSearchToolEntry(opts = {}) {
                     else {
                         return [
                             "No web-search backend configured.",
-                            "Connect Builder.io in Settings, or add one of the following keys via app settings or environment variables:",
+                            "Connect Builder.io (free tier available) in Settings, or add one of the following keys via app settings or environment variables:",
                             "  • BRAVE_SEARCH_API_KEY  — https://brave.com/search/api/",
                             "  • TAVILY_API_KEY        — https://tavily.com/",
                             "  • EXA_API_KEY           — https://exa.ai/",

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/file-upload/actions/upload-image.js

@@ -117,7 +117,7 @@ async function fetchRemote(url) {
 function uploadNotConfiguredError() {
     return [
         "Image uploads are not configured for this app.",
-        "Connect or reconnect Builder.io in Settings → File uploads, or register a custom provider (S3, R2, GCS, etc.) via registerFileUploadProvider().",
+        "Connect or reconnect Builder.io (free tier available) in Settings → File uploads, or register a custom provider (S3, R2, GCS, etc.) via registerFileUploadProvider().",
     ].join(" ");
 }
 export default defineAction({

package/dist/file-upload/registry.js

@@ -96,7 +96,7 @@ export async function uploadFile(input) {
     if (!warnedFallbackRef.value) {
         warnedFallbackRef.value = true;
         console.warn("[agent-native] No file upload provider configured. " +
-            "Connect or reconnect Builder.io in Settings → File uploads, " +
+            "Connect or reconnect Builder.io (free tier available) in Settings → File uploads, " +
             "or register a custom provider (S3, R2, GCS, …) via registerFileUploadProvider().");
     }
     return null;

package/dist/guards/index.d.ts

@@ -13,6 +13,9 @@ export { scanDbToolScoping } from "./db-tool-scoping.js";
 export type { DbToolScopingOptions } from "./db-tool-scoping.js";
 export { scanExplicitCollabAccess } from "./explicit-collab-access.js";
 export { scanDrizzlePush } from "./no-drizzle-push.js";
+export { scanEmptyMigrations } from "./no-empty-migrations.js";
+export type { EmptyMigrationsSourceOptions } from "./no-empty-migrations.js";
+export { analyzeEmptyMigrationsSource, shouldScanEmptyMigrationsFile, } from "./no-empty-migrations.js";
 export { scanEnvCredentials } from "./no-env-credentials.js";
 export { scanEnvMutation } from "./no-env-mutation.js";
 export { scanLocalhostFallback } from "./no-localhost-fallback.js";

package/dist/guards/index.js

@@ -12,6 +12,8 @@
 export { scanDbToolScoping } from "./db-tool-scoping.js";
 export { scanExplicitCollabAccess } from "./explicit-collab-access.js";
 export { scanDrizzlePush } from "./no-drizzle-push.js";
+export { scanEmptyMigrations } from "./no-empty-migrations.js";
+export { analyzeEmptyMigrationsSource, shouldScanEmptyMigrationsFile, } from "./no-empty-migrations.js";
 export { scanEnvCredentials } from "./no-env-credentials.js";
 export { scanEnvMutation } from "./no-env-mutation.js";
 export { scanLocalhostFallback } from "./no-localhost-fallback.js";

package/dist/guards/no-empty-migrations.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Refuse empty `runMigrations([])` plugins. The migration runner itself is
+ * safe for an empty list, but an empty plugin usually means a serverless boot
+ * is still paying for a database migration check that has no work to do.
+ */
+import type { GuardFinding, GuardResult, GuardScanOptions } from "./types.js";
+export interface EmptyMigrationsSourceOptions {
+    file: string;
+    source: string;
+}
+export declare function analyzeEmptyMigrationsSource({ file, source, }: EmptyMigrationsSourceOptions): GuardFinding[];
+export declare function shouldScanEmptyMigrationsFile(relativeFile: string): boolean;
+export declare function scanEmptyMigrations({ root }: GuardScanOptions): GuardResult;
+//# sourceMappingURL=no-empty-migrations.d.ts.map