@builder.io/ai-utils 0.95.0 → 0.96.1

package/src/organization.d.ts

@@ -121,6 +121,7 @@ interface OrganizationSettings {
     /** Default single tenancy config ID for this space. References a document in the singleTenancyConfigurations collection.
      *  Projects can override this with their own singleTenancyConfig setting. */
     defaultSingleTenancyConfig?: string;
+    aiFeatures?: boolean;
     controlModelAvailability?: boolean;
     allowedAiModels?: string[];
     autoModelOverride?: string;

package/src/projects.d.ts

@@ -251,6 +251,16 @@ export declare const matchesAgentNativeStarter: (repo: {
     repoName?: string | null;
     templateRepoUrl?: string | null;
 }) => boolean;
+export declare function getManagedDatabasePackageJsonError(content: string): string | undefined;
+export declare function getAgentNativeRootPackageJsonWriteError(args: {
+    repo: {
+        repoName?: string | null;
+        templateRepoUrl?: string | null;
+    };
+    repoPath: string;
+    resolvedPath: string;
+    content: string;
+}): string | undefined;
 export declare const EXAMPLE_OR_STARTER_REPOS: string[];
 export declare const EXAMPLE_OR_STARTER_REPOS_URLS: string[];
 export interface GitBackupUploadUrlResult {
@@ -981,10 +991,11 @@ export declare const ProjectSettingsSchema: z.ZodObject<{
             "org-worker": "org-worker";
             "project-configuration": "project-configuration";
             "projects-scheduler-memory-extraction": "projects-scheduler-memory-extraction";
+            "publish-agent": "publish-agent";
             "repo-indexing": "repo-indexing";
             "setup-project": "setup-project";
             unknown: "unknown";
-        }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
+        }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "publish-agent-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
         needDevServer: z.ZodOptional<z.ZodBoolean>;
         needValidation: z.ZodOptional<z.ZodBoolean>;
         includeMemories: z.ZodOptional<z.ZodBoolean>;
@@ -1321,10 +1332,11 @@ export declare const ProjectSettingsExternalSchema: z.ZodObject<{
             "org-worker": "org-worker";
             "project-configuration": "project-configuration";
             "projects-scheduler-memory-extraction": "projects-scheduler-memory-extraction";
+            "publish-agent": "publish-agent";
             "repo-indexing": "repo-indexing";
             "setup-project": "setup-project";
             unknown: "unknown";
-        }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
+        }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "publish-agent-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
         needDevServer: z.ZodOptional<z.ZodBoolean>;
         needValidation: z.ZodOptional<z.ZodBoolean>;
         includeMemories: z.ZodOptional<z.ZodBoolean>;
@@ -2522,10 +2534,11 @@ export declare const UpdateProjectOptionsSchema: z.ZodObject<{
                 "org-worker": "org-worker";
                 "project-configuration": "project-configuration";
                 "projects-scheduler-memory-extraction": "projects-scheduler-memory-extraction";
+                "publish-agent": "publish-agent";
                 "repo-indexing": "repo-indexing";
                 "setup-project": "setup-project";
                 unknown: "unknown";
-            }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
+            }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "publish-agent-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
             needDevServer: z.ZodOptional<z.ZodBoolean>;
             needValidation: z.ZodOptional<z.ZodBoolean>;
             includeMemories: z.ZodOptional<z.ZodBoolean>;
@@ -2800,6 +2813,62 @@ export type UpdateProjectOptions = z.infer<typeof UpdateProjectOptionsSchema>;
 /**
  * A single deploy record, stored at `deploys/{deployId}`. The Deploy.id is the document key.
  */
+/**
+ * Pipeline step a deploy died at. Set by the pod, the only place that still
+ * knows, so the server can attribute the failure without reading log text.
+ */
+export declare const DeployFailureStageSchema: z.ZodEnum<{
+    build: "build";
+    init: "init";
+    migrate: "migrate";
+    package: "package";
+    setup: "setup";
+    upload: "upload";
+}>;
+export type DeployFailureStage = z.infer<typeof DeployFailureStageSchema>;
+/** `app` is the only value that reaches the agent, so unknowns resolve away from it. */
+export declare const DeployFailureOwnerSchema: z.ZodEnum<{
+    app: "app";
+    platform: "platform";
+    unknown: "unknown";
+}>;
+export type DeployFailureOwner = z.infer<typeof DeployFailureOwnerSchema>;
+/** What the deploy pod reports about a failure. All optional: older pods send none of it. */
+export declare const DeployFailureReportSchema: z.ZodObject<{
+    stage: z.ZodOptional<z.ZodEnum<{
+        build: "build";
+        init: "init";
+        migrate: "migrate";
+        package: "package";
+        setup: "setup";
+        upload: "upload";
+    }>>;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    signal: z.ZodOptional<z.ZodString>;
+    excerpt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DeployFailureReport = z.infer<typeof DeployFailureReportSchema>;
+export declare const DeployFailureSchema: z.ZodObject<{
+    stage: z.ZodOptional<z.ZodEnum<{
+        build: "build";
+        init: "init";
+        migrate: "migrate";
+        package: "package";
+        setup: "setup";
+        upload: "upload";
+    }>>;
+    owner: z.ZodEnum<{
+        app: "app";
+        platform: "platform";
+        unknown: "unknown";
+    }>;
+    code: z.ZodString;
+    summary: z.ZodString;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    signal: z.ZodOptional<z.ZodString>;
+    fixRequested: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type DeployFailure = z.infer<typeof DeployFailureSchema>;
 export declare const DeploySchema: z.ZodObject<{
     id: z.ZodString;
     projectId: z.ZodString;
@@ -2829,11 +2898,38 @@ export declare const DeploySchema: z.ZodObject<{
     url: z.ZodOptional<z.ZodString>;
     migrationApplied: z.ZodOptional<z.ZodBoolean>;
     error: z.ZodOptional<z.ZodString>;
+    failure: z.ZodOptional<z.ZodObject<{
+        stage: z.ZodOptional<z.ZodEnum<{
+            build: "build";
+            init: "init";
+            migrate: "migrate";
+            package: "package";
+            setup: "setup";
+            upload: "upload";
+        }>>;
+        owner: z.ZodEnum<{
+            app: "app";
+            platform: "platform";
+            unknown: "unknown";
+        }>;
+        code: z.ZodString;
+        summary: z.ZodString;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        signal: z.ZodOptional<z.ZodString>;
+        fixRequested: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
     createdAt: z.ZodNumber;
     completedAt: z.ZodOptional<z.ZodNumber>;
     triggeredBy: z.ZodString;
 }, z.core.$strip>;
 export type Deploy = z.infer<typeof DeploySchema>;
+/**
+ * The user who asked for this deploy, or `undefined` when nobody did. Lives
+ * with the schema so every caller that needs a real user agrees on what counts.
+ */
+export declare function deployTriggeringUser(deploy: {
+    triggeredBy?: string;
+}): string | undefined;
 /**
  * Permanent slug reservation, stored at `hosting-slugs/{slug}` (slug is the document key).
  *
@@ -2928,6 +3024,26 @@ export declare const DeployListItemSchema: z.ZodObject<{
     }>;
     url: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
+    failure: z.ZodOptional<z.ZodObject<{
+        stage: z.ZodOptional<z.ZodEnum<{
+            build: "build";
+            init: "init";
+            migrate: "migrate";
+            package: "package";
+            setup: "setup";
+            upload: "upload";
+        }>>;
+        owner: z.ZodEnum<{
+            app: "app";
+            platform: "platform";
+            unknown: "unknown";
+        }>;
+        code: z.ZodString;
+        summary: z.ZodString;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        signal: z.ZodOptional<z.ZodString>;
+        fixRequested: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
     createdAt: z.ZodNumber;
     completedAt: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -2966,6 +3082,31 @@ export declare function builderConfigHostingToBuildOverrides(hosting: BuilderCon
 export declare function mergeBuildConfigOverrides(fromFile: BuildConfigOverrides, fromFirestore: BuildConfigOverrides | undefined): BuildConfigOverrides;
 /** True when merged hosting build config includes at least one build setting. */
 export declare function hasResolvableHostingBuildConfig(overrides?: BuildConfigOverrides): boolean;
+/**
+ * Env vars every hosted deploy gets unless the project sets them itself.
+ *
+ * Recurring jobs default off because Agent Native ships a Netlify scheduled function
+ * that wakes a background sweep every minute for the life of the deploy, even when the
+ * app defines no jobs — enough to keep a scale-to-zero database from ever suspending.
+ * Set `AGENT_NATIVE_DISABLE_RECURRING_JOBS=false` in the build env to opt back in.
+ */
+export declare const HOSTED_DEPLOY_ENV_DEFAULTS: Readonly<Record<string, string>>;
+/**
+ * Layer `HOSTED_DEPLOY_ENV_DEFAULTS` under a build config's env, project values winning.
+ *
+ * Call only after `hasResolvableHostingBuildConfig` — the defaults would otherwise make
+ * a project with no hosting config look deployable. Keys are trimmed so a padded project
+ * key still wins instead of sitting beside the default the build actually reads.
+ */
+export declare function applyHostedBuildEnvDefaults(overrides: BuildConfigOverrides): BuildConfigOverrides;
+/**
+ * What a build env resolved each `HOSTED_DEPLOY_ENV_DEFAULTS` key to. The deploy pod
+ * sends this to the service so the runtime env matches what the build compiled against.
+ *
+ * Keys outside `HOSTED_DEPLOY_ENV_DEFAULTS` are dropped, so this is safe to call on an
+ * env record that arrived in an event payload.
+ */
+export declare function resolveHostedEnvDefaults(environment: Record<string, string> | undefined): Record<string, string>;
 /**
  * Request body for `POST /_builder.io/api/build-and-upload` on the deploy pod.
  */
@@ -3128,6 +3269,26 @@ export declare const GetDeploysResponseSchema: z.ZodObject<{
         }>;
         url: z.ZodOptional<z.ZodString>;
         error: z.ZodOptional<z.ZodString>;
+        failure: z.ZodOptional<z.ZodObject<{
+            stage: z.ZodOptional<z.ZodEnum<{
+                build: "build";
+                init: "init";
+                migrate: "migrate";
+                package: "package";
+                setup: "setup";
+                upload: "upload";
+            }>>;
+            owner: z.ZodEnum<{
+                app: "app";
+                platform: "platform";
+                unknown: "unknown";
+            }>;
+            code: z.ZodString;
+            summary: z.ZodString;
+            exitCode: z.ZodOptional<z.ZodNumber>;
+            signal: z.ZodOptional<z.ZodString>;
+            fixRequested: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
         createdAt: z.ZodNumber;
         completedAt: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -3631,10 +3792,11 @@ export declare const ProjectTemplateSchema: z.ZodObject<{
                 "org-worker": "org-worker";
                 "project-configuration": "project-configuration";
                 "projects-scheduler-memory-extraction": "projects-scheduler-memory-extraction";
+                "publish-agent": "publish-agent";
                 "repo-indexing": "repo-indexing";
                 "setup-project": "setup-project";
                 unknown: "unknown";
-            }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
+            }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "publish-agent-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
             needDevServer: z.ZodOptional<z.ZodBoolean>;
             needValidation: z.ZodOptional<z.ZodBoolean>;
             includeMemories: z.ZodOptional<z.ZodBoolean>;
@@ -4081,10 +4243,11 @@ export declare const ProjectTemplateOverridesSchema: z.ZodObject<{
                 "org-worker": "org-worker";
                 "project-configuration": "project-configuration";
                 "projects-scheduler-memory-extraction": "projects-scheduler-memory-extraction";
+                "publish-agent": "publish-agent";
                 "repo-indexing": "repo-indexing";
                 "setup-project": "setup-project";
                 unknown: "unknown";
-            }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
+            }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "publish-agent-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
             needDevServer: z.ZodOptional<z.ZodBoolean>;
             needValidation: z.ZodOptional<z.ZodBoolean>;
             includeMemories: z.ZodOptional<z.ZodBoolean>;
@@ -4487,10 +4650,11 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodObject<
                     "org-worker": "org-worker";
                     "project-configuration": "project-configuration";
                     "projects-scheduler-memory-extraction": "projects-scheduler-memory-extraction";
+                    "publish-agent": "publish-agent";
                     "repo-indexing": "repo-indexing";
                     "setup-project": "setup-project";
                     unknown: "unknown";
-                }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
+                }>, z.ZodTemplateLiteral<"browser-testing-agent" | "builder-code-agent" | "builder-code-panel-agent" | "builder-publish-integration-agent" | "cli-agent" | "code-review-orchestrator-agent" | "create-app-firebase-agent" | "create-app-lovable-agent" | "design-system-indexer-agent" | "dsi-mcp-agent" | "editor-ai-agent" | "fusion-agent" | "org-agent-agent" | "org-worker-agent" | "project-configuration-agent" | "projects-scheduler-memory-extraction-agent" | "publish-agent-agent" | "repo-indexing-agent" | "setup-project-agent" | "unknown-agent">]>>;
                 needDevServer: z.ZodOptional<z.ZodBoolean>;
                 needValidation: z.ZodOptional<z.ZodBoolean>;
                 includeMemories: z.ZodOptional<z.ZodBoolean>;

package/src/projects.js

@@ -62,6 +62,43 @@ export const matchesAgentNativeStarter = (repo) => {
         return true;
     return !!((_a = repo.templateRepoUrl) === null || _a === void 0 ? void 0 : _a.includes(AGENT_NATIVE_STARTER_REPO));
 };
+function isStringRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function getManagedDatabasePackageJsonError(content) {
+    let packageJson;
+    try {
+        packageJson = JSON.parse(content);
+    }
+    catch (_a) {
+        return "The managed database root package.json must remain valid JSON.";
+    }
+    if (!isStringRecord(packageJson)) {
+        return "The managed database root package.json must contain a JSON object.";
+    }
+    const dependencies = packageJson.dependencies;
+    const devDependencies = packageJson.devDependencies;
+    const hasDrizzleOrm = isStringRecord(dependencies) &&
+        typeof dependencies["drizzle-orm"] === "string";
+    const hasDrizzleKit = isStringRecord(devDependencies) &&
+        typeof devDependencies["drizzle-kit"] === "string";
+    if (hasDrizzleOrm && hasDrizzleKit) {
+        return undefined;
+    }
+    return ("Managed database projects require drizzle-orm in root dependencies and drizzle-kit " +
+        "in root devDependencies. Preserve both declarations when editing package.json.");
+}
+export function getAgentNativeRootPackageJsonWriteError(args) {
+    if (!matchesAgentNativeStarter(args.repo)) {
+        return undefined;
+    }
+    const normalizePath = (value) => value.replace(/\\/g, "/").replace(/\/$/, "");
+    const rootPackageJsonPath = `${normalizePath(args.repoPath)}/package.json`;
+    if (normalizePath(args.resolvedPath) !== rootPackageJsonPath) {
+        return undefined;
+    }
+    return getManagedDatabasePackageJsonError(args.content);
+}
 export const EXAMPLE_OR_STARTER_REPOS = [
     ...EXAMPLE_REPOS,
     STARTER_REPO,
@@ -1193,6 +1230,44 @@ export const UpdateProjectOptionsSchema = z.object({
 /**
  * A single deploy record, stored at `deploys/{deployId}`. The Deploy.id is the document key.
  */
+/**
+ * Pipeline step a deploy died at. Set by the pod, the only place that still
+ * knows, so the server can attribute the failure without reading log text.
+ */
+export const DeployFailureStageSchema = z.enum([
+    "init",
+    "setup",
+    "migrate",
+    "build",
+    "package",
+    "upload",
+]);
+/** `app` is the only value that reaches the agent, so unknowns resolve away from it. */
+export const DeployFailureOwnerSchema = z.enum(["app", "platform", "unknown"]);
+/** What the deploy pod reports about a failure. All optional: older pods send none of it. */
+export const DeployFailureReportSchema = z.object({
+    stage: DeployFailureStageSchema.optional(),
+    exitCode: z.number().optional(),
+    signal: z.string().optional(),
+    excerpt: z.string().optional().meta({
+        description: "Head-and-tail excerpt of the failing output, cut on line boundaries. Event only, never persisted.",
+    }),
+});
+export const DeployFailureSchema = z.object({
+    stage: DeployFailureStageSchema.optional(),
+    owner: DeployFailureOwnerSchema,
+    code: z.string().meta({
+        description: "Classifier rule that produced the verdict, e.g. build-command-failed, build-killed, install-network.",
+    }),
+    summary: z.string().meta({
+        description: "One line naming the failure, safe to render in a list row.",
+    }),
+    exitCode: z.number().optional(),
+    signal: z.string().optional(),
+    fixRequested: z.boolean().optional().meta({
+        description: "Whether a Fusion agent fix was dispatched for this failure.",
+    }),
+});
 export const DeploySchema = z.object({
     id: z.string(),
     projectId: z.string(),
@@ -1247,7 +1322,10 @@ export const DeploySchema = z.object({
         description: "Whether Drizzle migrations were applied during this deploy. Absent when no migration ran.",
     }),
     error: z.string().optional().meta({
-        description: "Single human-readable line on failure; raw build logs not surfaced in v0",
+        description: "Head-and-tail excerpt of the failing step's output, ANSI stripped. Bounded because it rides in every deploy-list response.",
+    }),
+    failure: DeployFailureSchema.optional().meta({
+        description: "Structured verdict for a failed deploy: which stage failed and whether the failure is the app's or ours. Absent on deploys from pods that predate it.",
     }),
     createdAt: z.number(),
     completedAt: z.number().optional(),
@@ -1255,6 +1333,19 @@ export const DeploySchema = z.object({
         description: 'user ID for manual publish, or "auto-deploy" (v1)',
     }),
 });
+/** Values of `Deploy.triggeredBy` that name no real user. */
+const UNATTENDED_DEPLOY_TRIGGERS = new Set(["auto-deploy", "unknown"]);
+/**
+ * The user who asked for this deploy, or `undefined` when nobody did. Lives
+ * with the schema so every caller that needs a real user agrees on what counts.
+ */
+export function deployTriggeringUser(deploy) {
+    var _a;
+    const triggered = (_a = deploy.triggeredBy) === null || _a === void 0 ? void 0 : _a.trim();
+    return triggered && !UNATTENDED_DEPLOY_TRIGGERS.has(triggered)
+        ? triggered
+        : undefined;
+}
 /**
  * Permanent slug reservation, stored at `hosting-slugs/{slug}` (slug is the document key).
  *
@@ -1348,6 +1439,7 @@ export const DeployListItemSchema = DeploySchema.pick({
     createdAt: true,
     completedAt: true,
     error: true,
+    failure: true,
     checkoutBranch: true,
     checkoutCommit: true,
     builtCommit: true,
@@ -1482,6 +1574,60 @@ export function hasResolvableHostingBuildConfig(overrides) {
     }
     return false;
 }
+/**
+ * Env vars every hosted deploy gets unless the project sets them itself.
+ *
+ * Recurring jobs default off because Agent Native ships a Netlify scheduled function
+ * that wakes a background sweep every minute for the life of the deploy, even when the
+ * app defines no jobs — enough to keep a scale-to-zero database from ever suspending.
+ * Set `AGENT_NATIVE_DISABLE_RECURRING_JOBS=false` in the build env to opt back in.
+ */
+export const HOSTED_DEPLOY_ENV_DEFAULTS = {
+    AGENT_NATIVE_DISABLE_RECURRING_JOBS: "true",
+};
+/**
+ * Layer `HOSTED_DEPLOY_ENV_DEFAULTS` under a build config's env, project values winning.
+ *
+ * Call only after `hasResolvableHostingBuildConfig` — the defaults would otherwise make
+ * a project with no hosting config look deployable. Keys are trimmed so a padded project
+ * key still wins instead of sitting beside the default the build actually reads.
+ */
+export function applyHostedBuildEnvDefaults(overrides) {
+    return {
+        ...overrides,
+        environment: {
+            ...HOSTED_DEPLOY_ENV_DEFAULTS,
+            ...normalizeEnvRecordKeys(overrides.environment),
+        },
+    };
+}
+/** Trim env keys and drop blank ones, so both env scopes compare keys the same way. */
+function normalizeEnvRecordKeys(environment) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(environment !== null && environment !== void 0 ? environment : {})) {
+        const trimmed = key.trim();
+        if (trimmed) {
+            normalized[trimmed] = value;
+        }
+    }
+    return normalized;
+}
+/**
+ * What a build env resolved each `HOSTED_DEPLOY_ENV_DEFAULTS` key to. The deploy pod
+ * sends this to the service so the runtime env matches what the build compiled against.
+ *
+ * Keys outside `HOSTED_DEPLOY_ENV_DEFAULTS` are dropped, so this is safe to call on an
+ * env record that arrived in an event payload.
+ */
+export function resolveHostedEnvDefaults(environment) {
+    const resolved = {};
+    for (const [key, value] of Object.entries(normalizeEnvRecordKeys(environment))) {
+        if (Object.hasOwn(HOSTED_DEPLOY_ENV_DEFAULTS, key)) {
+            resolved[key] = value;
+        }
+    }
+    return resolved;
+}
 /**
  * Request body for `POST /_builder.io/api/build-and-upload` on the deploy pod.
  */

package/src/projects.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { AGENT_NATIVE_STARTER_REPO, matchesAgentNativeStarter, ProjectHostingExternalSchema, ProjectHostingSchema, } from "./projects";
+import { AGENT_NATIVE_STARTER_REPO, getAgentNativeRootPackageJsonWriteError, getManagedDatabasePackageJsonError, matchesAgentNativeStarter, ProjectHostingExternalSchema, ProjectHostingSchema, } from "./projects";
 describe("project hosting schemas", () => {
     it("accepts the canonical published branch route", () => {
         expect(ProjectHostingSchema.parse({ publishedBranchId: "branch-live" })).toEqual({ publishedBranchId: "branch-live" });
@@ -31,3 +31,59 @@ describe("matchesAgentNativeStarter", () => {
         expect(matchesAgentNativeStarter({})).toBe(false);
     });
 });
+describe("getManagedDatabasePackageJsonError", () => {
+    it("accepts the required root Drizzle dependencies", () => {
+        expect(getManagedDatabasePackageJsonError(JSON.stringify({
+            dependencies: { "drizzle-orm": "0.45.2" },
+            devDependencies: { "drizzle-kit": "0.31.10" },
+        }))).toBeUndefined();
+    });
+    it.each([
+        {
+            dependencies: {},
+            devDependencies: { "drizzle-kit": "0.31.10" },
+        },
+        {
+            dependencies: { "drizzle-orm": "0.45.2", "drizzle-kit": "0.31.10" },
+            devDependencies: {},
+        },
+        {
+            dependencies: {},
+            devDependencies: {
+                "drizzle-orm": "0.45.2",
+                "drizzle-kit": "0.31.10",
+            },
+        },
+    ])("rejects missing or misplaced dependencies", (packageJson) => {
+        expect(getManagedDatabasePackageJsonError(JSON.stringify(packageJson))).toContain("Preserve both declarations");
+    });
+    it("rejects invalid package.json content", () => {
+        expect(getManagedDatabasePackageJsonError("not json")).toContain("valid JSON");
+    });
+});
+describe("getAgentNativeRootPackageJsonWriteError", () => {
+    const repo = { repoName: AGENT_NATIVE_STARTER_REPO };
+    const invalidManifest = JSON.stringify({ dependencies: {} });
+    it("rejects an invalid resolved root manifest", () => {
+        expect(getAgentNativeRootPackageJsonWriteError({
+            repo,
+            repoPath: "/workspace",
+            resolvedPath: "/workspace/package.json",
+            content: invalidManifest,
+        })).toContain("drizzle-orm");
+    });
+    it("allows nested and unrelated repository manifests", () => {
+        expect(getAgentNativeRootPackageJsonWriteError({
+            repo,
+            repoPath: "/workspace",
+            resolvedPath: "/workspace/apps/web/package.json",
+            content: invalidManifest,
+        })).toBeUndefined();
+        expect(getAgentNativeRootPackageJsonWriteError({
+            repo: { repoName: "acme/dashboard" },
+            repoPath: "/workspace",
+            resolvedPath: "/workspace/package.json",
+            content: invalidManifest,
+        })).toBeUndefined();
+    });
+});