npm - @builder.io/ai-utils - Versions diffs - 0.86.1 → 0.87.0 - Mend

@builder.io/ai-utils 0.86.1 → 0.87.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/src/projects.d.ts CHANGED Viewed

@@ -1,8 +1,7 @@
 import { z } from "zod";
 import type { BuilderConfigHosting } from "./builder-config.js";
 import type { ConnectivityErrorCode, CheckType, LikelyCause } from "./connectivity/types.js";
-import { type EnvironmentVariable, type SetupDependency } from "./common-schemas";
-import type { FileOverride, LaunchServerState, LaunchServerStatus, BranchBackup, CommitMode, CustomInstruction, CustomAgentDefinition, GitSnapshot, AutoPushMode, GenerateUserMessage, CodeGenToolMap, GenerateCompletionStep, ReviewEffort, ExitState } from "./codegen";
+import type { LaunchServerState, LaunchServerStatus, BranchBackup, CommitMode, GitSnapshot, GenerateUserMessage, CodeGenToolMap, GenerateCompletionStep, ExitState } from "./codegen";
 import type { FallbackTokensPrivate } from "./organization";
 /**
  * Temporary type for date fields during migration.
@@ -344,51 +343,89 @@ export type ShutdownResponse = {
 export type ShutdownResponseSerialized = Omit<ShutdownResponse, "error"> & {
     error?: string;
 };
-interface ProjectSkillBase {
-    /** Stable identifier for the entry (used for logs/dedup, not by the CLI). */
-    key: string;
-    /** Specific skill names to install (--skill). Omit to install all. */
-    skills?: string[];
-    /** Target agents (--agent). Defaults to ["claude-code"]. */
-    agents?: string[];
-}
 /**
- * A skill source passed directly to `skills add`.
- * Supports GitHub shorthand, Git/GitHub URLs, local paths, npm: sources, etc.
+ * A skill source passed directly to `skills add`. Supports GitHub shorthand,
+ * Git/GitHub URLs, local paths, npm: sources, etc.
  */
-export interface ProjectSkillSource extends ProjectSkillBase {
-    source: string;
-}
+export declare const ProjectSkillSourceSchema: z.ZodObject<{
+    key: z.ZodString;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    source: z.ZodString;
+}, z.core.$strip>;
+export type ProjectSkillSource = z.infer<typeof ProjectSkillSourceSchema>;
 /**
- * A skill sourced from an npm package.
- * The package must contain a SKILL.md at its root (or a skills/<name>/SKILL.md).
+ * A skill sourced from an npm package. The package must contain a SKILL.md at
+ * its root (or a skills/<name>/SKILL.md).
  */
-export interface ProjectSkillNpm extends ProjectSkillBase {
-    type: "npm";
-    package: string;
-    version?: string;
-}
+export declare const ProjectSkillNpmSchema: z.ZodObject<{
+    key: z.ZodString;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    type: z.ZodLiteral<"npm">;
+    package: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProjectSkillNpm = z.infer<typeof ProjectSkillNpmSchema>;
 /**
- * A skill sourced from a GitHub repository that follows the Claude Code plugin layout
- * (skills/<name>/SKILL.md) or contains a SKILL.md at root.
- * ref can be a branch, tag, or commit SHA.
+ * A skill sourced from a GitHub repository following the Claude Code plugin
+ * layout (skills/<name>/SKILL.md) or containing a SKILL.md at root.
  */
-export interface ProjectSkillGithub extends ProjectSkillBase {
-    type: "github";
-    repo: string;
-    ref?: string;
-    /** Sub-path inside the repo to treat as the plugin root (default: repo root) */
-    path?: string;
-}
+export declare const ProjectSkillGithubSchema: z.ZodObject<{
+    key: z.ZodString;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    type: z.ZodLiteral<"github">;
+    repo: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProjectSkillGithub = z.infer<typeof ProjectSkillGithubSchema>;
 /**
  * A skill sourced from a URL supported by `skills add`, such as a GitHub/GitLab
  * tree URL, a direct git URL, or a well-known skills index URL.
  */
-export interface ProjectSkillUrl extends ProjectSkillBase {
-    type: "url";
-    url: string;
-}
-export type ProjectSkill = ProjectSkillSource | ProjectSkillNpm | ProjectSkillGithub | ProjectSkillUrl;
+export declare const ProjectSkillUrlSchema: z.ZodObject<{
+    key: z.ZodString;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    type: z.ZodLiteral<"url">;
+    url: z.ZodString;
+}, z.core.$strip>;
+export type ProjectSkillUrl = z.infer<typeof ProjectSkillUrlSchema>;
+/**
+ * A project-level skill to install during Fusion initialization. A plain
+ * `z.union` (not `discriminatedUnion`) because the `source` variant has no
+ * `type` tag to discriminate on.
+ */
+export declare const ProjectSkillSchema: z.ZodUnion<readonly [z.ZodObject<{
+    key: z.ZodString;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    source: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    key: z.ZodString;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    type: z.ZodLiteral<"npm">;
+    package: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    key: z.ZodString;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    type: z.ZodLiteral<"github">;
+    repo: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    key: z.ZodString;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    type: z.ZodLiteral<"url">;
+    url: z.ZodString;
+}, z.core.$strip>]>;
+export type ProjectSkill = z.infer<typeof ProjectSkillSchema>;
 export type FusionExecutionEnvironment = "containerized" | "container-less" | "cloud" | "cloud-v2";
 export type AgentType = "setup-project" | "project-configuration" | "org-agent" | "code-review-orchestrator" | "design-system-indexer" | "repo-indexer" | "builder-publish-integration";
 export interface PartialBranchData {
@@ -705,24 +742,745 @@ export interface ListBranchesResult {
 }
 export type CpuKind = "performance" | "standard" | "shared";
 export type MachineAutoStop = "stop" | "off" | "suspend";
-export interface ProjectRolePermissions {
-    view?: boolean;
-    editCode?: boolean;
-    sendPullRequests?: boolean;
-    createBranches?: boolean;
-    modifyMcpServers?: boolean;
-    modifyWorkflowIntegrations?: boolean;
-    modifyProjectSettings?: boolean;
-    fusionHostingPublish?: boolean;
-}
-export interface ProjectAccessControl {
-    roles: Record<string, ProjectRolePermissions | null>;
-    users: Record<string, ProjectRolePermissions>;
-}
+export declare const ProjectRolePermissionsSchema: z.ZodObject<{
+    view: z.ZodOptional<z.ZodBoolean>;
+    editCode: z.ZodOptional<z.ZodBoolean>;
+    sendPullRequests: z.ZodOptional<z.ZodBoolean>;
+    createBranches: z.ZodOptional<z.ZodBoolean>;
+    modifyMcpServers: z.ZodOptional<z.ZodBoolean>;
+    modifyWorkflowIntegrations: z.ZodOptional<z.ZodBoolean>;
+    modifyProjectSettings: z.ZodOptional<z.ZodBoolean>;
+    fusionHostingPublish: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ProjectRolePermissions = z.infer<typeof ProjectRolePermissionsSchema>;
+export declare const ProjectAccessControlSchema: z.ZodObject<{
+    roles: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodObject<{
+        view: z.ZodOptional<z.ZodBoolean>;
+        editCode: z.ZodOptional<z.ZodBoolean>;
+        sendPullRequests: z.ZodOptional<z.ZodBoolean>;
+        createBranches: z.ZodOptional<z.ZodBoolean>;
+        modifyMcpServers: z.ZodOptional<z.ZodBoolean>;
+        modifyWorkflowIntegrations: z.ZodOptional<z.ZodBoolean>;
+        modifyProjectSettings: z.ZodOptional<z.ZodBoolean>;
+        fusionHostingPublish: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    users: z.ZodRecord<z.ZodString, z.ZodObject<{
+        view: z.ZodOptional<z.ZodBoolean>;
+        editCode: z.ZodOptional<z.ZodBoolean>;
+        sendPullRequests: z.ZodOptional<z.ZodBoolean>;
+        createBranches: z.ZodOptional<z.ZodBoolean>;
+        modifyMcpServers: z.ZodOptional<z.ZodBoolean>;
+        modifyWorkflowIntegrations: z.ZodOptional<z.ZodBoolean>;
+        modifyProjectSettings: z.ZodOptional<z.ZodBoolean>;
+        fusionHostingPublish: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProjectAccessControl = z.infer<typeof ProjectAccessControlSchema>;
 export interface PreviewPasswordProtection {
     enabled: boolean;
     password?: string;
 }
+/**
+ * Runtime schema for {@link Project.settings} — the full stored shape, including
+ * `@internal` (system/agent-managed) fields. Plain `z.object` strips unknown
+ * keys on parse.
+ *
+ * For client-writable payloads use {@link ProjectSettingsExternalSchema}, which
+ * is derived from this schema with the internal fields omitted so external
+ * callers can't set them through the public update API.
+ */
+export declare const ProjectSettingsSchema: z.ZodObject<{
+    isNativeApp: z.ZodOptional<z.ZodBoolean>;
+    autoDetectDevServer: z.ZodOptional<z.ZodBoolean>;
+    autoDetectDevServerPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fusionEnvironment: z.ZodOptional<z.ZodEnum<{
+        cloud: "cloud";
+        "cloud-v2": "cloud-v2";
+        "container-less": "container-less";
+        containerized: "containerized";
+    }>>;
+    devServerPort: z.ZodOptional<z.ZodNumber>;
+    devServerUrl: z.ZodOptional<z.ZodString>;
+    refreshPreview: z.ZodOptional<z.ZodBoolean>;
+    installCommand: z.ZodOptional<z.ZodString>;
+    installNpmrc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    validateCommand: z.ZodOptional<z.ZodString>;
+    proxyOrigin: z.ZodOptional<z.ZodString>;
+    proxyDefaultOrigin: z.ZodOptional<z.ZodString>;
+    defaultAutoPush: z.ZodOptional<z.ZodEnum<{
+        "ff-push": "ff-push";
+        "force-push": "force-push";
+        "merge-push": "merge-push";
+        none: "none";
+        "safe-push": "safe-push";
+    }>>;
+    gitBranchNamingStrategy: z.ZodOptional<z.ZodEnum<{
+        "ai-session": "ai-session";
+        "branch-name": "branch-name";
+        custom: "custom";
+    }>>;
+    setupDependencies: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodLiteral<"mise">;
+        tool: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodLiteral<"script">;
+        name: z.ZodString;
+        script: z.ZodString;
+    }, z.core.$strip>], "type">>>;
+    hostRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        checkScript: z.ZodString;
+        installScript: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        installLink: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        platform: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            linux: "linux";
+            macos: "macos";
+            windows: "windows";
+        }>>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        key: z.ZodString;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        source: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        key: z.ZodString;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        type: z.ZodLiteral<"npm">;
+        package: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        key: z.ZodString;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        type: z.ZodLiteral<"github">;
+        repo: z.ZodString;
+        ref: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        key: z.ZodString;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        type: z.ZodLiteral<"url">;
+        url: z.ZodString;
+    }, z.core.$strip>]>>>;
+    gitBranchNamingCustom: z.ZodOptional<z.ZodString>;
+    askUserForBranchName: z.ZodOptional<z.ZodBoolean>;
+    allowBranchFromRemote: z.ZodOptional<z.ZodBoolean>;
+    devServerCommand: z.ZodOptional<z.ZodString>;
+    screenshotCommand: z.ZodOptional<z.ZodString>;
+    interactCommand: z.ZodOptional<z.ZodString>;
+    serverTimeout: z.ZodOptional<z.ZodNumber>;
+    cpuKind: z.ZodOptional<z.ZodEnum<{
+        performance: "performance";
+        shared: "shared";
+        standard: "standard";
+    }>>;
+    cpus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<4>]>>;
+    memory: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<2048>, z.ZodLiteral<4096>, z.ZodLiteral<8192>, z.ZodLiteral<16384>]>>;
+    memoryLimit: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1024>, z.ZodLiteral<2048>, z.ZodLiteral<4096>, z.ZodLiteral<8192>, z.ZodLiteral<16384>]>>;
+    autoStop: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        stop: "stop";
+        suspend: "suspend";
+    }>>;
+    mainBranchName: z.ZodOptional<z.ZodString>;
+    minMachinesRunning: z.ZodOptional<z.ZodNumber>;
+    volumeSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<5>, z.ZodLiteral<10>, z.ZodLiteral<12>, z.ZodLiteral<15>, z.ZodLiteral<20>, z.ZodLiteral<25>, z.ZodLiteral<30>, z.ZodLiteral<50>]>>;
+    includePath: z.ZodOptional<z.ZodString>;
+    includePatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    errorIgnorePatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    environmentVariables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+        isSecret: z.ZodBoolean;
+        placeholder: z.ZodOptional<z.ZodBoolean>;
+        explanation: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    requiredEnvironmentVariables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        optional: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$strip>>>;
+    fileOverrides: z.ZodOptional<z.ZodArray<z.ZodXor<readonly [z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        base64: z.ZodString;
+    }, z.core.$strip>]>>>;
+    customInstructions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        content: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            "agent-mode": "agent-mode";
+            always: "always";
+        }>>;
+        filePath: z.ZodOptional<z.ZodString>;
+        glob: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        hideUI: z.ZodOptional<z.ZodBoolean>;
+        isSkill: z.ZodOptional<z.ZodBoolean>;
+        disableModelInvocation: z.ZodOptional<z.ZodBoolean>;
+        userInvocable: z.ZodOptional<z.ZodBoolean>;
+        scope: z.ZodOptional<z.ZodEnum<{
+            builtin: "builtin";
+            plugin: "plugin";
+            project: "project";
+            user: "user";
+        }>>;
+        pluginName: z.ZodOptional<z.ZodString>;
+        ownedAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    customAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        model: z.ZodOptional<z.ZodString>;
+        roundRobinModels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        position: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            "browser-testing": "browser-testing";
+            "builder-code": "builder-code";
+            "builder-code-panel": "builder-code-panel";
+            "builder-publish-integration": "builder-publish-integration";
+            cli: "cli";
+            "code-review-orchestrator": "code-review-orchestrator";
+            "create-app-firebase": "create-app-firebase";
+            "create-app-lovable": "create-app-lovable";
+            "design-system-indexer": "design-system-indexer";
+            "dsi-mcp": "dsi-mcp";
+            "editor-ai": "editor-ai";
+            fusion: "fusion";
+            "org-agent": "org-agent";
+            "org-worker": "org-worker";
+            "project-configuration": "project-configuration";
+            "projects-scheduler-memory-extraction": "projects-scheduler-memory-extraction";
+            "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">]>>;
+        needDevServer: z.ZodOptional<z.ZodBoolean>;
+        needValidation: z.ZodOptional<z.ZodBoolean>;
+        includeMemories: z.ZodOptional<z.ZodBoolean>;
+        resetAfterRun: z.ZodOptional<z.ZodBoolean>;
+        mcpServers: z.ZodOptional<z.ZodBoolean>;
+        asyncSubAgents: z.ZodOptional<z.ZodBoolean>;
+        queueBehavior: z.ZodOptional<z.ZodObject<{
+            schedule: z.ZodEnum<{
+                interrupt: "interrupt";
+                "interrupt-clear": "interrupt-clear";
+                "interrupt-replace": "interrupt-replace";
+                "next-turn": "next-turn";
+                "until-idle": "until-idle";
+            }>;
+            coalesce: z.ZodEnum<{
+                merge: "merge";
+                "preserve-order": "preserve-order";
+                "replace-latest": "replace-latest";
+            }>;
+        }, z.core.$strip>>;
+        queueMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"next-turn">, z.ZodLiteral<"until-idle">, z.ZodObject<{
+            schedule: z.ZodEnum<{
+                interrupt: "interrupt";
+                "interrupt-clear": "interrupt-clear";
+                "interrupt-replace": "interrupt-replace";
+                "next-turn": "next-turn";
+                "until-idle": "until-idle";
+            }>;
+            coalesce: z.ZodEnum<{
+                merge: "merge";
+                "preserve-order": "preserve-order";
+                "replace-latest": "replace-latest";
+            }>;
+        }, z.core.$strip>]>>;
+        softContextWindow: z.ZodOptional<z.ZodNumber>;
+        filePath: z.ZodOptional<z.ZodString>;
+        maxTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxCompletions: z.ZodOptional<z.ZodNumber>;
+        reasoning: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            high: "high";
+            low: "low";
+            max: "max";
+            medium: "medium";
+            minimal: "minimal";
+            none: "none";
+            xhigh: "xhigh";
+        }>>;
+        defaultSyncChanges: z.ZodOptional<z.ZodObject<{
+            remoteBranches: z.ZodOptional<z.ZodEnum<{
+                ai: "ai";
+                both: "both";
+                main: "main";
+            }>>;
+            fastForward: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                never: "never";
+                required: "required";
+            }>>;
+            canPush: z.ZodOptional<z.ZodBoolean>;
+            uncommittedChanges: z.ZodOptional<z.ZodEnum<{
+                commit: "commit";
+                fail: "fail";
+                stash: "stash";
+            }>>;
+            requestRefresh: z.ZodOptional<z.ZodBoolean>;
+            allowUnrelatedHistory: z.ZodOptional<z.ZodBoolean>;
+            resetToBase: z.ZodOptional<z.ZodBoolean>;
+            updateLastCommits: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        scope: z.ZodOptional<z.ZodEnum<{
+            plugin: "plugin";
+            project: "project";
+            user: "user";
+        }>>;
+        pluginName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        envFile: z.ZodOptional<z.ZodString>;
+        retries: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    commitMode: z.ZodOptional<z.ZodEnum<{
+        commits: "commits";
+        "draft-prs": "draft-prs";
+        prs: "prs";
+    }>>;
+    autoCloseBranchOnMerge: z.ZodOptional<z.ZodBoolean>;
+    enableMergePR: z.ZodOptional<z.ZodBoolean>;
+    minRequiredApprovals: z.ZodOptional<z.ZodNumber>;
+    requireApprovalBeforePR: z.ZodOptional<z.ZodBoolean>;
+    requiredApproverRoleIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredApproverRoleId: z.ZodOptional<z.ZodString>;
+    defaultBranchType: z.ZodOptional<z.ZodEnum<{
+        private: "private";
+        shared: "shared";
+    }>>;
+    dockerImagePath: z.ZodOptional<z.ZodString>;
+    ghcrUsername: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ghcrToken: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    nodeVersion: z.ZodOptional<z.ZodString>;
+    designSystems: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    designTokenStrictMode: z.ZodOptional<z.ZodBoolean>;
+    designModeSelector: z.ZodOptional<z.ZodString>;
+    useNI: z.ZodOptional<z.ZodBoolean>;
+    folders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        remoteUrl: z.ZodString;
+        mainBranchName: z.ZodOptional<z.ZodString>;
+        includePath: z.ZodOptional<z.ZodString>;
+        addedBy: z.ZodOptional<z.ZodString>;
+        repoProvider: z.ZodOptional<z.ZodString>;
+        repoProtocol: z.ZodOptional<z.ZodString>;
+        enableGit: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    agentsMD: z.ZodOptional<z.ZodString>;
+    initializationCommand: z.ZodOptional<z.ZodString>;
+    repoSubpath: z.ZodOptional<z.ZodString>;
+    recommendedRoot: z.ZodOptional<z.ZodString>;
+    https: z.ZodOptional<z.ZodBoolean>;
+    localHttpsDomain: z.ZodOptional<z.ZodString>;
+    browserAutomation: z.ZodOptional<z.ZodObject<{
+        backgroundAgents: z.ZodOptional<z.ZodBoolean>;
+        builderApp: z.ZodOptional<z.ZodBoolean>;
+        instructions: z.ZodOptional<z.ZodString>;
+        authUser: z.ZodOptional<z.ZodString>;
+        authPassword: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    prReviewer: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        instructions: z.ZodOptional<z.ZodString>;
+        reviewEffort: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            low: "low";
+            medium: "medium";
+        }>>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    enableSnapshots: z.ZodOptional<z.ZodBoolean>;
+    postMergeMemories: z.ZodOptional<z.ZodBoolean>;
+    commitInstructions: z.ZodOptional<z.ZodString>;
+    maxAgentCompletions: z.ZodOptional<z.ZodNumber>;
+    enableAgentMode: z.ZodOptional<z.ZodBoolean>;
+    allowPreviewAutoSubmit: z.ZodOptional<z.ZodBoolean>;
+    enforceDesktopAppOnly: z.ZodOptional<z.ZodBoolean>;
+    disableDesktopProxying: z.ZodOptional<z.ZodBoolean>;
+    previewUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    recentUrls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        timestamp: z.ZodNumber;
+        starred: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    skipCommandSecurity: z.ZodOptional<z.ZodBoolean>;
+    httpsServerKeyPath: z.ZodOptional<z.ZodString>;
+    httpsServerCertPath: z.ZodOptional<z.ZodString>;
+    httpsServerCaPath: z.ZodOptional<z.ZodString>;
+    httpsServerKeyContent: z.ZodOptional<z.ZodString>;
+    httpsServerCertContent: z.ZodOptional<z.ZodString>;
+    httpsServerCaContent: z.ZodOptional<z.ZodString>;
+    httpsServerPfx: z.ZodOptional<z.ZodString>;
+    httpsServerPassphrase: z.ZodOptional<z.ZodString>;
+    httpsServerSecureProtocol: z.ZodOptional<z.ZodString>;
+    httpsServerSecureOptions: z.ZodOptional<z.ZodNumber>;
+    httpsServerCiphers: z.ZodOptional<z.ZodString>;
+    httpsServerHonorCipherOrder: z.ZodOptional<z.ZodBoolean>;
+    httpsServerRequestCert: z.ZodOptional<z.ZodBoolean>;
+    httpsServerRejectUnauthorized: z.ZodOptional<z.ZodBoolean>;
+    isPreferredForRepo: z.ZodOptional<z.ZodBoolean>;
+    singleTenancyConfig: z.ZodOptional<z.ZodString>;
+    previewPasswordProtection: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        password: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProjectSettings = z.infer<typeof ProjectSettingsSchema>;
+/**
+ * Runtime schema for the client-writable subset of {@link Project.settings},
+ * derived from {@link ProjectSettingsSchema} by omitting the `@internal`
+ * (system/agent-managed) fields. Use this for public update/PATCH payloads so
+ * external callers can't set internal-only fields.
+ */
+export declare const ProjectSettingsExternalSchema: z.ZodObject<{
+    isNativeApp: z.ZodOptional<z.ZodBoolean>;
+    autoDetectDevServer: z.ZodOptional<z.ZodBoolean>;
+    autoDetectDevServerPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fusionEnvironment: z.ZodOptional<z.ZodEnum<{
+        cloud: "cloud";
+        "cloud-v2": "cloud-v2";
+        "container-less": "container-less";
+        containerized: "containerized";
+    }>>;
+    devServerPort: z.ZodOptional<z.ZodNumber>;
+    installCommand: z.ZodOptional<z.ZodString>;
+    installNpmrc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gitBranchNamingStrategy: z.ZodOptional<z.ZodEnum<{
+        "ai-session": "ai-session";
+        "branch-name": "branch-name";
+        custom: "custom";
+    }>>;
+    hostRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        checkScript: z.ZodString;
+        installScript: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        installLink: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        platform: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            linux: "linux";
+            macos: "macos";
+            windows: "windows";
+        }>>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        key: z.ZodString;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        source: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        key: z.ZodString;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        type: z.ZodLiteral<"npm">;
+        package: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        key: z.ZodString;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        type: z.ZodLiteral<"github">;
+        repo: z.ZodString;
+        ref: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        key: z.ZodString;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        type: z.ZodLiteral<"url">;
+        url: z.ZodString;
+    }, z.core.$strip>]>>>;
+    gitBranchNamingCustom: z.ZodOptional<z.ZodString>;
+    askUserForBranchName: z.ZodOptional<z.ZodBoolean>;
+    allowBranchFromRemote: z.ZodOptional<z.ZodBoolean>;
+    devServerCommand: z.ZodOptional<z.ZodString>;
+    screenshotCommand: z.ZodOptional<z.ZodString>;
+    interactCommand: z.ZodOptional<z.ZodString>;
+    serverTimeout: z.ZodOptional<z.ZodNumber>;
+    cpuKind: z.ZodOptional<z.ZodEnum<{
+        performance: "performance";
+        shared: "shared";
+        standard: "standard";
+    }>>;
+    cpus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<4>]>>;
+    memory: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<2048>, z.ZodLiteral<4096>, z.ZodLiteral<8192>, z.ZodLiteral<16384>]>>;
+    memoryLimit: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1024>, z.ZodLiteral<2048>, z.ZodLiteral<4096>, z.ZodLiteral<8192>, z.ZodLiteral<16384>]>>;
+    autoStop: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        stop: "stop";
+        suspend: "suspend";
+    }>>;
+    mainBranchName: z.ZodOptional<z.ZodString>;
+    minMachinesRunning: z.ZodOptional<z.ZodNumber>;
+    volumeSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<5>, z.ZodLiteral<10>, z.ZodLiteral<12>, z.ZodLiteral<15>, z.ZodLiteral<20>, z.ZodLiteral<25>, z.ZodLiteral<30>, z.ZodLiteral<50>]>>;
+    includePatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    errorIgnorePatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    environmentVariables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+        isSecret: z.ZodBoolean;
+        placeholder: z.ZodOptional<z.ZodBoolean>;
+        explanation: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    requiredEnvironmentVariables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        optional: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$strip>>>;
+    fileOverrides: z.ZodOptional<z.ZodArray<z.ZodXor<readonly [z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        base64: z.ZodString;
+    }, z.core.$strip>]>>>;
+    customInstructions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        content: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            "agent-mode": "agent-mode";
+            always: "always";
+        }>>;
+        filePath: z.ZodOptional<z.ZodString>;
+        glob: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        hideUI: z.ZodOptional<z.ZodBoolean>;
+        isSkill: z.ZodOptional<z.ZodBoolean>;
+        disableModelInvocation: z.ZodOptional<z.ZodBoolean>;
+        userInvocable: z.ZodOptional<z.ZodBoolean>;
+        scope: z.ZodOptional<z.ZodEnum<{
+            builtin: "builtin";
+            plugin: "plugin";
+            project: "project";
+            user: "user";
+        }>>;
+        pluginName: z.ZodOptional<z.ZodString>;
+        ownedAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    customAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        model: z.ZodOptional<z.ZodString>;
+        roundRobinModels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        position: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            "browser-testing": "browser-testing";
+            "builder-code": "builder-code";
+            "builder-code-panel": "builder-code-panel";
+            "builder-publish-integration": "builder-publish-integration";
+            cli: "cli";
+            "code-review-orchestrator": "code-review-orchestrator";
+            "create-app-firebase": "create-app-firebase";
+            "create-app-lovable": "create-app-lovable";
+            "design-system-indexer": "design-system-indexer";
+            "dsi-mcp": "dsi-mcp";
+            "editor-ai": "editor-ai";
+            fusion: "fusion";
+            "org-agent": "org-agent";
+            "org-worker": "org-worker";
+            "project-configuration": "project-configuration";
+            "projects-scheduler-memory-extraction": "projects-scheduler-memory-extraction";
+            "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">]>>;
+        needDevServer: z.ZodOptional<z.ZodBoolean>;
+        needValidation: z.ZodOptional<z.ZodBoolean>;
+        includeMemories: z.ZodOptional<z.ZodBoolean>;
+        resetAfterRun: z.ZodOptional<z.ZodBoolean>;
+        mcpServers: z.ZodOptional<z.ZodBoolean>;
+        asyncSubAgents: z.ZodOptional<z.ZodBoolean>;
+        queueBehavior: z.ZodOptional<z.ZodObject<{
+            schedule: z.ZodEnum<{
+                interrupt: "interrupt";
+                "interrupt-clear": "interrupt-clear";
+                "interrupt-replace": "interrupt-replace";
+                "next-turn": "next-turn";
+                "until-idle": "until-idle";
+            }>;
+            coalesce: z.ZodEnum<{
+                merge: "merge";
+                "preserve-order": "preserve-order";
+                "replace-latest": "replace-latest";
+            }>;
+        }, z.core.$strip>>;
+        queueMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"next-turn">, z.ZodLiteral<"until-idle">, z.ZodObject<{
+            schedule: z.ZodEnum<{
+                interrupt: "interrupt";
+                "interrupt-clear": "interrupt-clear";
+                "interrupt-replace": "interrupt-replace";
+                "next-turn": "next-turn";
+                "until-idle": "until-idle";
+            }>;
+            coalesce: z.ZodEnum<{
+                merge: "merge";
+                "preserve-order": "preserve-order";
+                "replace-latest": "replace-latest";
+            }>;
+        }, z.core.$strip>]>>;
+        softContextWindow: z.ZodOptional<z.ZodNumber>;
+        filePath: z.ZodOptional<z.ZodString>;
+        maxTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxCompletions: z.ZodOptional<z.ZodNumber>;
+        reasoning: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            high: "high";
+            low: "low";
+            max: "max";
+            medium: "medium";
+            minimal: "minimal";
+            none: "none";
+            xhigh: "xhigh";
+        }>>;
+        defaultSyncChanges: z.ZodOptional<z.ZodObject<{
+            remoteBranches: z.ZodOptional<z.ZodEnum<{
+                ai: "ai";
+                both: "both";
+                main: "main";
+            }>>;
+            fastForward: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                never: "never";
+                required: "required";
+            }>>;
+            canPush: z.ZodOptional<z.ZodBoolean>;
+            uncommittedChanges: z.ZodOptional<z.ZodEnum<{
+                commit: "commit";
+                fail: "fail";
+                stash: "stash";
+            }>>;
+            requestRefresh: z.ZodOptional<z.ZodBoolean>;
+            allowUnrelatedHistory: z.ZodOptional<z.ZodBoolean>;
+            resetToBase: z.ZodOptional<z.ZodBoolean>;
+            updateLastCommits: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        scope: z.ZodOptional<z.ZodEnum<{
+            plugin: "plugin";
+            project: "project";
+            user: "user";
+        }>>;
+        pluginName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        envFile: z.ZodOptional<z.ZodString>;
+        retries: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    commitMode: z.ZodOptional<z.ZodEnum<{
+        commits: "commits";
+        "draft-prs": "draft-prs";
+        prs: "prs";
+    }>>;
+    enableMergePR: z.ZodOptional<z.ZodBoolean>;
+    minRequiredApprovals: z.ZodOptional<z.ZodNumber>;
+    requireApprovalBeforePR: z.ZodOptional<z.ZodBoolean>;
+    requiredApproverRoleIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredApproverRoleId: z.ZodOptional<z.ZodString>;
+    defaultBranchType: z.ZodOptional<z.ZodEnum<{
+        private: "private";
+        shared: "shared";
+    }>>;
+    dockerImagePath: z.ZodOptional<z.ZodString>;
+    ghcrUsername: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ghcrToken: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    nodeVersion: z.ZodOptional<z.ZodString>;
+    designSystems: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    designTokenStrictMode: z.ZodOptional<z.ZodBoolean>;
+    designModeSelector: z.ZodOptional<z.ZodString>;
+    folders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        remoteUrl: z.ZodString;
+        mainBranchName: z.ZodOptional<z.ZodString>;
+        includePath: z.ZodOptional<z.ZodString>;
+        addedBy: z.ZodOptional<z.ZodString>;
+        repoProvider: z.ZodOptional<z.ZodString>;
+        repoProtocol: z.ZodOptional<z.ZodString>;
+        enableGit: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    agentsMD: z.ZodOptional<z.ZodString>;
+    initializationCommand: z.ZodOptional<z.ZodString>;
+    https: z.ZodOptional<z.ZodBoolean>;
+    localHttpsDomain: z.ZodOptional<z.ZodString>;
+    browserAutomation: z.ZodOptional<z.ZodObject<{
+        backgroundAgents: z.ZodOptional<z.ZodBoolean>;
+        builderApp: z.ZodOptional<z.ZodBoolean>;
+        instructions: z.ZodOptional<z.ZodString>;
+        authUser: z.ZodOptional<z.ZodString>;
+        authPassword: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    prReviewer: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        instructions: z.ZodOptional<z.ZodString>;
+        reviewEffort: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            low: "low";
+            medium: "medium";
+        }>>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    enableSnapshots: z.ZodOptional<z.ZodBoolean>;
+    postMergeMemories: z.ZodOptional<z.ZodBoolean>;
+    maxAgentCompletions: z.ZodOptional<z.ZodNumber>;
+    enableAgentMode: z.ZodOptional<z.ZodBoolean>;
+    allowPreviewAutoSubmit: z.ZodOptional<z.ZodBoolean>;
+    enforceDesktopAppOnly: z.ZodOptional<z.ZodBoolean>;
+    disableDesktopProxying: z.ZodOptional<z.ZodBoolean>;
+    previewUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    recentUrls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        timestamp: z.ZodNumber;
+        starred: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    httpsServerKeyPath: z.ZodOptional<z.ZodString>;
+    httpsServerCertPath: z.ZodOptional<z.ZodString>;
+    httpsServerCaPath: z.ZodOptional<z.ZodString>;
+    httpsServerKeyContent: z.ZodOptional<z.ZodString>;
+    httpsServerCertContent: z.ZodOptional<z.ZodString>;
+    httpsServerCaContent: z.ZodOptional<z.ZodString>;
+    httpsServerPfx: z.ZodOptional<z.ZodString>;
+    httpsServerPassphrase: z.ZodOptional<z.ZodString>;
+    httpsServerSecureProtocol: z.ZodOptional<z.ZodString>;
+    httpsServerSecureOptions: z.ZodOptional<z.ZodNumber>;
+    httpsServerCiphers: z.ZodOptional<z.ZodString>;
+    httpsServerHonorCipherOrder: z.ZodOptional<z.ZodBoolean>;
+    httpsServerRequestCert: z.ZodOptional<z.ZodBoolean>;
+    httpsServerRejectUnauthorized: z.ZodOptional<z.ZodBoolean>;
+    isPreferredForRepo: z.ZodOptional<z.ZodBoolean>;
+    singleTenancyConfig: z.ZodOptional<z.ZodString>;
+    previewPasswordProtection: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        password: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProjectSettingsExternal = z.infer<typeof ProjectSettingsExternalSchema>;
 export interface Project {
     /** Unique project identifier. */
     id: string;
@@ -776,186 +1534,8 @@ export interface Project {
     accessMode?: "public" | "private";
     /** Fine-grained access control configuration for the project. */
     projectAccess?: ProjectAccessControl;
-    settings: {
-        /** When true, this is a native (mobile/desktop) app with no web dev server. */
-        isNativeApp?: boolean;
-        /** When true, automatically detect the dev server URL from command output (Desktop app only). */
-        autoDetectDevServer?: boolean;
-        /** Regex patterns matched against dev command output to detect the server URL. */
-        autoDetectDevServerPatterns?: string[];
-        /** Execution environment for the Fusion runtime (cloud, containerized, container-less). */
-        fusionEnvironment?: FusionExecutionEnvironment;
-        /** Port the dev server listens on inside the container. Use 0 for auto-assign. Default: 3000. */
-        devServerPort?: number;
-        /** @internal Explicit dev server URL; overrides auto-detection. Set by the system, not user-configurable. */
-        devServerUrl?: string;
-        /** @internal Whether to reload the preview when files change. Managed by the app UI. */
-        refreshPreview?: boolean;
-        /** Commands to install dependencies before starting the dev server (e.g. "npm install"). */
-        installCommand?: string;
-        /** @internal Command to run validation checks. Used internally by the setup agent. */
-        validateCommand?: string;
-        /** @internal URL origin used for the dev server proxy. Related to Electron proxy configuration. Exposed via specific UI; not a free-text field. */
-        proxyOrigin?: string;
-        /** @internal Default proxy origin, resolved at runtime. */
-        proxyDefaultOrigin?: string;
-        /** @internal Mode for automatically pushing AI commits. Managed by the app. */
-        defaultAutoPush?: AutoPushMode;
-        /** How branch names are generated: ai-session ID, descriptive name, or a custom pattern. */
-        gitBranchNamingStrategy?: "ai-session" | "branch-name" | "custom";
-        /** @internal Mise tools and custom scripts run before the setup command. Managed via builder.config.json. */
-        setupDependencies?: SetupDependency[];
-        /** Project-level skills to install during Fusion initialization. */
-        skills?: ProjectSkill[];
-        gitBranchNamingCustom?: string;
-        /** When true, the user is prompted to provide a branch name before a new branch is created. */
-        askUserForBranchName?: boolean;
-        /** Command to start the dev server (e.g. "npm run dev"). */
-        devServerCommand?: string;
-        /** CPU tier for the container: "performance", "standard", or "shared". */
-        cpuKind?: CpuKind;
-        /** Number of vCPUs allocated to the container: 1, 2, or 4. */
-        cpus?: 1 | 2 | 4;
-        /** RAM allocated to the container in MB. Higher values (8192/16384) are enterprise-only. Default: 4096. */
-        memory?: 2048 | 4096 | 8192 | 16384;
-        /** @deprecated Use {@link memory} instead. */
-        memoryLimit?: 1024 | 2048 | 4096 | 8192 | 16384;
-        /** Idle behavior for the container: stop, suspend, or stay on. Default: "suspend". */
-        autoStop?: MachineAutoStop;
-        /** Base branch used when cloning and creating new branches. Default: "main". */
-        mainBranchName?: string;
-        /** Minimum number of machines kept alive at all times. Default: 0. */
-        minMachinesRunning?: number;
-        /** Persistent disk size in GB. Default: 5. */
-        volumeSize?: 5 | 10 | 12 | 15 | 20 | 25 | 30 | 50;
-        /** @internal Subpath within the repository to use as the working root. */
-        includePath?: string;
-        /** Glob patterns limiting which paths are included when cloning or processing. */
-        includePatterns?: string[];
-        /** Environment variables injected into the dev container. */
-        environmentVariables?: EnvironmentVariable[];
-        /** Files injected into the container during setup, written before installCommand runs. */
-        fileOverrides?: FileOverride[];
-        /** Structured instruction rules applied to AI sessions (name, content, scope, tool allowlists). */
-        customInstructions?: CustomInstruction[];
-        /** Definitions for specialized sub-agents with custom system prompts, tools, and model overrides. */
-        customAgents?: CustomAgentDefinition[];
-        /** How the AI commits changes: direct commits, draft PRs, or ready-for-review PRs. Default: "draft-prs". */
-        commitMode?: CommitMode;
-        /** @internal Default for new branches' autoCloseBranchOnMerge. When false, merging a PR does not archive the branch. Read only at branch-creation time. Default: true. */
-        autoCloseBranchOnMerge?: boolean;
-        /** Whether merging the PR from the editor is enabled. */
-        enableMergePR?: boolean;
-        /** Default visibility for new branches: shared (team-visible) or private. Default: "private". */
-        defaultBranchType?: "shared" | "private";
-        /** Custom container image path (e.g. ghcr.io/org/image:tag). Overrides nodeVersion when set. */
-        dockerImagePath?: string;
-        /** Node.js version to use in the container (e.g. "22"). Ignored when dockerImagePath is set. */
-        nodeVersion?: string;
-        /** Named design systems to expose for AI assistance. */
-        designSystems?: string[];
-        /** @internal Use @antfu/ni for package management instead of direct npm/yarn/pnpm commands. */
-        useNI?: boolean;
-        /** Additional repositories cloned alongside the main repo for extra AI context. */
-        folders?: Array<{
-            /** Identifier for this workspace folder (kebab/snake case recommended). */
-            name: string;
-            /** Full clone URL of the repository (must end in .git for GitHub/GitLab). */
-            remoteUrl: string;
-            /** Base branch to clone. Default: "main". */
-            mainBranchName?: string;
-            /** Subpath within this repo to use as the working root. */
-            includePath?: string;
-            /** User ID of whoever added this folder. */
-            addedBy?: string;
-            /** Detected or specified git provider. */
-            repoProvider?: string;
-            /** Clone protocol: "https" or "ssh". */
-            repoProtocol?: string;
-            /** Whether to track git history for this folder. */
-            enableGit?: boolean;
-        }>;
-        /** Freeform workspace-level AI instructions, equivalent to an AGENTS.md file. */
-        agentsMD?: string;
-        /** One-time command run after the repo is first cloned, before installCommand. */
-        initializationCommand?: string;
-        /** @internal Subpath within the repo recommended by auto-detection as the project root. */
-        repoSubpath?: string;
-        /** @internal Workspace root recommended by auto-setup analysis; not user-configurable. */
-        recommendedRoot?: string;
-        /** Enable HTTPS for the dev server proxy. Default: false. */
-        https?: boolean;
-        /** Custom local domain for HTTPS (e.g. "myapp.local"). */
-        localHttpsDomain?: string;
-        /** Browser automation configuration for AI-driven end-to-end testing and visual verification. */
-        browserAutomation?: {
-            /** Run browser automation tasks as background agents. */
-            backgroundAgents?: boolean;
-            /** Custom instructions for the browser agent. */
-            instructions?: string;
-            /** Username for sites requiring authentication. */
-            authUser?: string;
-            /** Password for sites requiring authentication. */
-            authPassword?: string;
-        };
-        /** Automated PR reviewer configuration. */
-        prReviewer?: {
-            /** Whether the automated reviewer is enabled. */
-            enabled: boolean;
-            /** Custom review guidelines for the reviewer. */
-            instructions?: string;
-            /** How deeply to review: "low", "medium" (default), or "high". */
-            reviewEffort?: ReviewEffort;
-        };
-        /** Enable volume snapshots so session state can be saved and restored. */
-        enableSnapshots?: boolean;
-        /** When true, the AI captures memories after a branch is merged for use in future sessions. */
-        postMergeMemories?: boolean;
-        /** @internal Custom instructions for AI-generated commit messages. */
-        commitInstructions?: string;
-        /** Maximum number of AI completions allowed per agent session. */
-        maxAgentCompletions?: number;
-        /** @internal Bypass command security restrictions. Admin use only. */
-        skipCommandSecurity?: boolean;
-        /** File path to the HTTPS private key. */
-        httpsServerKeyPath?: string;
-        /** File path to the HTTPS certificate. */
-        httpsServerCertPath?: string;
-        /** File path to the HTTPS CA certificate. */
-        httpsServerCaPath?: string;
-        /** HTTPS private key content as a string (alternative to httpsServerKeyPath). */
-        httpsServerKeyContent?: string;
-        /** HTTPS certificate content as a string (alternative to httpsServerCertPath). */
-        httpsServerCertContent?: string;
-        /** HTTPS CA certificate content as a string (alternative to httpsServerCaPath). */
-        httpsServerCaContent?: string;
-        /** PFX/PKCS12 bundle for HTTPS. */
-        httpsServerPfx?: string;
-        /** Passphrase for an encrypted HTTPS private key or PFX. */
-        httpsServerPassphrase?: string;
-        /** Secure protocol string passed to Node.js https.createServer (e.g. "TLSv1_2_method"). */
-        httpsServerSecureProtocol?: string;
-        /** Numeric TLS options bitmask passed to Node.js https.createServer. */
-        httpsServerSecureOptions?: number;
-        /** Cipher suite string (OpenSSL format) for the HTTPS server. */
-        httpsServerCiphers?: string;
-        /** When true, the server's cipher order takes precedence over the client's. */
-        httpsServerHonorCipherOrder?: boolean;
-        /** When true, the server requests a client certificate. */
-        httpsServerRequestCert?: boolean;
-        /** When false, self-signed or untrusted client certificates are accepted. */
-        httpsServerRejectUnauthorized?: boolean;
-        /**
-         * When true, this project is the preferred project for its connected repository.
-         * Agents will pick this project when asked to do something with the connected repository.
-         */
-        isPreferredForRepo?: boolean;
-        /** Single tenancy config ID for this project. Overrides the space-level defaultSingleTenancyConfig.
-         *  References a document in the singleTenancyConfigurations collection. */
-        singleTenancyConfig?: string;
-        /** Password-protect the preview URL. */
-        previewPasswordProtection?: PreviewPasswordProtection;
-    };
+    /** Project-level configuration. Source of truth is {@link ProjectSettingsSchema}. */
+    settings: ProjectSettings;
     /** URL of the project's screenshot thumbnail, or null if none has been captured. */
     screenshot: string | null;
     /** When true, this project is a built-in example shown to new users. */
@@ -1571,17 +2151,483 @@ export declare const ProjectHostingSchema: z.ZodObject<{
         user: "user";
     }>>;
     systemUnpublishReason: z.ZodOptional<z.ZodEnum<{
-        "bandwidth-cap": "bandwidth-cap";
-        "web-request-cap": "web-request-cap";
+        "zero-credits": "zero-credits";
     }>>;
     domainIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type ProjectHosting = z.infer<typeof ProjectHostingSchema>;
+/**
+ * Client-writable subset of {@link ProjectHostingSchema}. Used for `PATCH`
+ * payloads so external callers can't write system-owned hosting fields.
+ */
+export declare const ProjectHostingExternalSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    buildConfig: z.ZodOptional<z.ZodObject<{
+        buildCommand: z.ZodOptional<z.ZodString>;
+        buildOutputDir: z.ZodOptional<z.ZodString>;
+        nodeVersion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    environment: z.ZodOptional<z.ZodObject<{
+        build: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodString;
+            isSecret: z.ZodBoolean;
+            placeholder: z.ZodOptional<z.ZodBoolean>;
+            explanation: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        prod: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodString;
+            isSecret: z.ZodBoolean;
+            placeholder: z.ZodOptional<z.ZodBoolean>;
+            explanation: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    autoDeploy: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ProjectHostingExternal = z.infer<typeof ProjectHostingExternalSchema>;
 /**
  * Canonical "is this project hostable" predicate. Keys off the explicit
  * `hosting.enabled` flag rather than inferring from build-config presence.
  */
 export declare const isProjectHostable: (hosting: Pick<ProjectHosting, "enabled"> | undefined | null) => boolean;
+/**
+ * Validates the body of `PATCH /projects/:projectId`. The schema's field set is
+ * the allowlist of client-writable fields: unknown keys are stripped on parse,
+ * so callers can't write arbitrary `Project` fields. `settings` and `hosting`
+ * are partial — a PATCH can touch a subset of sub-fields.
+ */
+export declare const UpdateProjectOptionsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    settings: z.ZodOptional<z.ZodObject<{
+        isNativeApp: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        autoDetectDevServer: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        autoDetectDevServerPatterns: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        fusionEnvironment: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            cloud: "cloud";
+            "cloud-v2": "cloud-v2";
+            "container-less": "container-less";
+            containerized: "containerized";
+        }>>>;
+        devServerPort: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        installCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        installNpmrc: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        gitBranchNamingStrategy: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            "ai-session": "ai-session";
+            "branch-name": "branch-name";
+            custom: "custom";
+        }>>>;
+        hostRequirements: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            checkScript: z.ZodString;
+            installScript: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            installLink: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            platform: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                linux: "linux";
+                macos: "macos";
+                windows: "windows";
+            }>>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+        skills: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            key: z.ZodString;
+            skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            source: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            key: z.ZodString;
+            skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            type: z.ZodLiteral<"npm">;
+            package: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            key: z.ZodString;
+            skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            type: z.ZodLiteral<"github">;
+            repo: z.ZodString;
+            ref: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            key: z.ZodString;
+            skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            type: z.ZodLiteral<"url">;
+            url: z.ZodString;
+        }, z.core.$strip>]>>>>;
+        gitBranchNamingCustom: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        askUserForBranchName: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        allowBranchFromRemote: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        devServerCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        screenshotCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        interactCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        serverTimeout: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        cpuKind: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            performance: "performance";
+            shared: "shared";
+            standard: "standard";
+        }>>>;
+        cpus: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<4>]>>>;
+        memory: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<2048>, z.ZodLiteral<4096>, z.ZodLiteral<8192>, z.ZodLiteral<16384>]>>>;
+        memoryLimit: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1024>, z.ZodLiteral<2048>, z.ZodLiteral<4096>, z.ZodLiteral<8192>, z.ZodLiteral<16384>]>>>;
+        autoStop: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            stop: "stop";
+            suspend: "suspend";
+        }>>>;
+        mainBranchName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        minMachinesRunning: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        volumeSize: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<5>, z.ZodLiteral<10>, z.ZodLiteral<12>, z.ZodLiteral<15>, z.ZodLiteral<20>, z.ZodLiteral<25>, z.ZodLiteral<30>, z.ZodLiteral<50>]>>>;
+        includePatterns: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        errorIgnorePatterns: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        environmentVariables: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodString;
+            isSecret: z.ZodBoolean;
+            placeholder: z.ZodOptional<z.ZodBoolean>;
+            explanation: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+        requiredEnvironmentVariables: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            optional: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, z.core.$strip>>>>;
+        fileOverrides: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodXor<readonly [z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            path: z.ZodString;
+            base64: z.ZodString;
+        }, z.core.$strip>]>>>>;
+        customInstructions: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            content: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<{
+                "agent-mode": "agent-mode";
+                always: "always";
+            }>>;
+            filePath: z.ZodOptional<z.ZodString>;
+            glob: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            hideUI: z.ZodOptional<z.ZodBoolean>;
+            isSkill: z.ZodOptional<z.ZodBoolean>;
+            disableModelInvocation: z.ZodOptional<z.ZodBoolean>;
+            userInvocable: z.ZodOptional<z.ZodBoolean>;
+            scope: z.ZodOptional<z.ZodEnum<{
+                builtin: "builtin";
+                plugin: "plugin";
+                project: "project";
+                user: "user";
+            }>>;
+            pluginName: z.ZodOptional<z.ZodString>;
+            ownedAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>>;
+        customAgents: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+            tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            model: z.ZodOptional<z.ZodString>;
+            roundRobinModels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            position: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                "browser-testing": "browser-testing";
+                "builder-code": "builder-code";
+                "builder-code-panel": "builder-code-panel";
+                "builder-publish-integration": "builder-publish-integration";
+                cli: "cli";
+                "code-review-orchestrator": "code-review-orchestrator";
+                "create-app-firebase": "create-app-firebase";
+                "create-app-lovable": "create-app-lovable";
+                "design-system-indexer": "design-system-indexer";
+                "dsi-mcp": "dsi-mcp";
+                "editor-ai": "editor-ai";
+                fusion: "fusion";
+                "org-agent": "org-agent";
+                "org-worker": "org-worker";
+                "project-configuration": "project-configuration";
+                "projects-scheduler-memory-extraction": "projects-scheduler-memory-extraction";
+                "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">]>>;
+            needDevServer: z.ZodOptional<z.ZodBoolean>;
+            needValidation: z.ZodOptional<z.ZodBoolean>;
+            includeMemories: z.ZodOptional<z.ZodBoolean>;
+            resetAfterRun: z.ZodOptional<z.ZodBoolean>;
+            mcpServers: z.ZodOptional<z.ZodBoolean>;
+            asyncSubAgents: z.ZodOptional<z.ZodBoolean>;
+            queueBehavior: z.ZodOptional<z.ZodObject<{
+                schedule: z.ZodEnum<{
+                    interrupt: "interrupt";
+                    "interrupt-clear": "interrupt-clear";
+                    "interrupt-replace": "interrupt-replace";
+                    "next-turn": "next-turn";
+                    "until-idle": "until-idle";
+                }>;
+                coalesce: z.ZodEnum<{
+                    merge: "merge";
+                    "preserve-order": "preserve-order";
+                    "replace-latest": "replace-latest";
+                }>;
+            }, z.core.$strip>>;
+            queueMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"next-turn">, z.ZodLiteral<"until-idle">, z.ZodObject<{
+                schedule: z.ZodEnum<{
+                    interrupt: "interrupt";
+                    "interrupt-clear": "interrupt-clear";
+                    "interrupt-replace": "interrupt-replace";
+                    "next-turn": "next-turn";
+                    "until-idle": "until-idle";
+                }>;
+                coalesce: z.ZodEnum<{
+                    merge: "merge";
+                    "preserve-order": "preserve-order";
+                    "replace-latest": "replace-latest";
+                }>;
+            }, z.core.$strip>]>>;
+            softContextWindow: z.ZodOptional<z.ZodNumber>;
+            filePath: z.ZodOptional<z.ZodString>;
+            maxTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            maxCompletions: z.ZodOptional<z.ZodNumber>;
+            reasoning: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                high: "high";
+                low: "low";
+                max: "max";
+                medium: "medium";
+                minimal: "minimal";
+                none: "none";
+                xhigh: "xhigh";
+            }>>;
+            defaultSyncChanges: z.ZodOptional<z.ZodObject<{
+                remoteBranches: z.ZodOptional<z.ZodEnum<{
+                    ai: "ai";
+                    both: "both";
+                    main: "main";
+                }>>;
+                fastForward: z.ZodOptional<z.ZodEnum<{
+                    auto: "auto";
+                    never: "never";
+                    required: "required";
+                }>>;
+                canPush: z.ZodOptional<z.ZodBoolean>;
+                uncommittedChanges: z.ZodOptional<z.ZodEnum<{
+                    commit: "commit";
+                    fail: "fail";
+                    stash: "stash";
+                }>>;
+                requestRefresh: z.ZodOptional<z.ZodBoolean>;
+                allowUnrelatedHistory: z.ZodOptional<z.ZodBoolean>;
+                resetToBase: z.ZodOptional<z.ZodBoolean>;
+                updateLastCommits: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            scope: z.ZodOptional<z.ZodEnum<{
+                plugin: "plugin";
+                project: "project";
+                user: "user";
+            }>>;
+            pluginName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+        mcpServers: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            envFile: z.ZodOptional<z.ZodString>;
+            retries: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>>;
+        commitMode: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            commits: "commits";
+            "draft-prs": "draft-prs";
+            prs: "prs";
+        }>>>;
+        enableMergePR: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        minRequiredApprovals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        requireApprovalBeforePR: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        requiredApproverRoleIds: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        requiredApproverRoleId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        defaultBranchType: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            private: "private";
+            shared: "shared";
+        }>>>;
+        dockerImagePath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        ghcrUsername: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        ghcrToken: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        nodeVersion: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        designSystems: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        designTokenStrictMode: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        designModeSelector: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        folders: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            remoteUrl: z.ZodString;
+            mainBranchName: z.ZodOptional<z.ZodString>;
+            includePath: z.ZodOptional<z.ZodString>;
+            addedBy: z.ZodOptional<z.ZodString>;
+            repoProvider: z.ZodOptional<z.ZodString>;
+            repoProtocol: z.ZodOptional<z.ZodString>;
+            enableGit: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>>;
+        agentsMD: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        initializationCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        https: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        localHttpsDomain: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        browserAutomation: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            backgroundAgents: z.ZodOptional<z.ZodBoolean>;
+            builderApp: z.ZodOptional<z.ZodBoolean>;
+            instructions: z.ZodOptional<z.ZodString>;
+            authUser: z.ZodOptional<z.ZodString>;
+            authPassword: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        prReviewer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            instructions: z.ZodOptional<z.ZodString>;
+            reviewEffort: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                low: "low";
+                medium: "medium";
+            }>>;
+            model: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        enableSnapshots: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        postMergeMemories: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        maxAgentCompletions: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        enableAgentMode: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        allowPreviewAutoSubmit: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        enforceDesktopAppOnly: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        disableDesktopProxying: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        previewUrl: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        recentUrls: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            timestamp: z.ZodNumber;
+            starred: z.ZodBoolean;
+        }, z.core.$strip>>>>;
+        httpsServerKeyPath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        httpsServerCertPath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        httpsServerCaPath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        httpsServerKeyContent: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        httpsServerCertContent: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        httpsServerCaContent: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        httpsServerPfx: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        httpsServerPassphrase: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        httpsServerSecureProtocol: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        httpsServerSecureOptions: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        httpsServerCiphers: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        httpsServerHonorCipherOrder: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        httpsServerRequestCert: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        httpsServerRejectUnauthorized: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        isPreferredForRepo: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        singleTenancyConfig: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        previewPasswordProtection: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            password: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    hosting: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        buildConfig: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            buildCommand: z.ZodOptional<z.ZodString>;
+            buildOutputDir: z.ZodOptional<z.ZodString>;
+            nodeVersion: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        environment: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            build: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                value: z.ZodString;
+                isSecret: z.ZodBoolean;
+                placeholder: z.ZodOptional<z.ZodBoolean>;
+                explanation: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            prod: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                value: z.ZodString;
+                isSecret: z.ZodBoolean;
+                placeholder: z.ZodOptional<z.ZodBoolean>;
+                explanation: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+        autoDeploy: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>>>;
+    deleteEnvironmentVariableKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    deleteHostingEnvironmentVariableKeys: z.ZodOptional<z.ZodObject<{
+        build: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        prod: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    snapshotVolume: z.ZodOptional<z.ZodObject<{
+        volumeId: z.ZodString;
+        appName: z.ZodString;
+        createdAt: z.ZodNumber;
+    }, z.core.$strip>>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+    pinOrder: z.ZodOptional<z.ZodNumber>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    needSetup: z.ZodOptional<z.ZodBoolean>;
+    repoFullName: z.ZodOptional<z.ZodString>;
+    repoUrl: z.ZodOptional<z.ZodString>;
+    repoAddedBy: z.ZodOptional<z.ZodString>;
+    templateRepoUrl: z.ZodOptional<z.ZodString>;
+    repoProvider: z.ZodOptional<z.ZodString>;
+    repoPrivate: z.ZodOptional<z.ZodBoolean>;
+    repoDescription: z.ZodOptional<z.ZodString>;
+    screenshot: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isExample: z.ZodOptional<z.ZodBoolean>;
+    isPublic: z.ZodOptional<z.ZodBoolean>;
+    localPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    accessMode: z.ZodOptional<z.ZodEnum<{
+        private: "private";
+        public: "public";
+    }>>;
+    projectAccess: z.ZodOptional<z.ZodObject<{
+        roles: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodObject<{
+            view: z.ZodOptional<z.ZodBoolean>;
+            editCode: z.ZodOptional<z.ZodBoolean>;
+            sendPullRequests: z.ZodOptional<z.ZodBoolean>;
+            createBranches: z.ZodOptional<z.ZodBoolean>;
+            modifyMcpServers: z.ZodOptional<z.ZodBoolean>;
+            modifyWorkflowIntegrations: z.ZodOptional<z.ZodBoolean>;
+            modifyProjectSettings: z.ZodOptional<z.ZodBoolean>;
+            fusionHostingPublish: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        users: z.ZodRecord<z.ZodString, z.ZodObject<{
+            view: z.ZodOptional<z.ZodBoolean>;
+            editCode: z.ZodOptional<z.ZodBoolean>;
+            sendPullRequests: z.ZodOptional<z.ZodBoolean>;
+            createBranches: z.ZodOptional<z.ZodBoolean>;
+            modifyMcpServers: z.ZodOptional<z.ZodBoolean>;
+            modifyWorkflowIntegrations: z.ZodOptional<z.ZodBoolean>;
+            modifyProjectSettings: z.ZodOptional<z.ZodBoolean>;
+            fusionHostingPublish: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    codeOnlyMode: z.ZodOptional<z.ZodBoolean>;
+    codeOnlyReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        "code-change-required": "code-change-required";
+        "empty-project": "empty-project";
+        failed: "failed";
+        "mobile-project": "mobile-project";
+        "no-frontend": "no-frontend";
+        other: "other";
+        started: "started";
+        "user-question": "user-question";
+    }>>>;
+    mobileOnlyDetected: z.ZodOptional<z.ZodBoolean>;
+    autoSetupStatus: z.ZodOptional<z.ZodEnum<{
+        completed: "completed";
+        error: "error";
+        idle: "idle";
+        "needs-input": "needs-input";
+        running: "running";
+    }>>;
+    userInitiatedAutoSetup: z.ZodOptional<z.ZodBoolean>;
+    autoApplySetup: z.ZodOptional<z.ZodBoolean>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type UpdateProjectOptions = z.infer<typeof UpdateProjectOptionsSchema>;
 /**
  * A single deploy record, stored at `deploys/{deployId}`. The Deploy.id is the document key.
  */