@builder.io/ai-utils 0.96.1 → 0.97.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.96.1",
+  "version": "0.97.0",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/codegen.d.ts

@@ -384,6 +384,18 @@ export declare const GetScreenshotToolInputSchema: z.ZodObject<{
     height: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type GetScreenshotToolInput = z.infer<typeof GetScreenshotToolInputSchema>;
+export declare const JudgeCommandSafetyInputSchema: z.ZodObject<{
+    command: z.ZodString;
+}, z.core.$strip>;
+export type JudgeCommandSafetyInput = z.infer<typeof JudgeCommandSafetyInputSchema>;
+export declare const JudgeCommandSafetyResultSchema: z.ZodObject<{
+    verdict: z.ZodEnum<{
+        destructive: "destructive";
+        safe: "safe";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type JudgeCommandSafetyResult = z.infer<typeof JudgeCommandSafetyResultSchema>;
 export declare const NavigatePreviewToolInputSchema: z.ZodObject<{
     href: z.ZodString;
 }, z.core.$strip>;
@@ -2694,6 +2706,7 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
         v1: "v1";
         v2: "v2";
         v3: "v3";
+        v4: "v4";
     }>>;
     reasoning: z.ZodOptional<z.ZodEnum<{
         auto: "auto";
@@ -4563,6 +4576,14 @@ export interface FusionConfig {
      * This is a dangerous setting that removes safety guardrails - equivalent to full shell access.
      */
     skipCommandSecurity?: boolean;
+    /**
+     * LaunchDarkly `command-safety-judge-enabled` flag, resolved server-side at
+     * session start and threaded down since the sandbox has no LaunchDarkly
+     * access of its own. When true, `executeShellCommand` routes Tier 2
+     * judgment-requiring commands to the `JudgeCommandSafety` endpoint instead
+     * of hard-blocking them.
+     */
+    commandSafetyJudgeEnabled?: boolean;
     /** @deprecated use devCommand */
     command?: string;
 }

package/src/codegen.js

@@ -580,6 +580,26 @@ export const GetScreenshotToolInputSchema = z
     height: z.number().optional(),
 })
     .meta({ title: "GetScreenshotToolInput" });
+export const JudgeCommandSafetyInputSchema = z
+    .object({
+    // Bounded so a caller can't force multi-megabyte payloads through this
+    // directly-callable, AI-credit-exempt endpoint into every completionLLM
+    // call — real shell commands are nowhere near this size.
+    command: z.string().max(20000).meta({
+        description: "The shell command to classify.",
+    }),
+})
+    .meta({ title: "JudgeCommandSafetyInput" });
+export const JudgeCommandSafetyResultSchema = z
+    .object({
+    verdict: z.enum(["safe", "destructive"]).meta({
+        description: "Whether the command is safe to run in this ephemeral, fully-writable sandbox, or destructive and should be denied.",
+    }),
+    reason: z.string().optional().meta({
+        description: "Required when verdict is destructive: a short, non-scary explanation shown to the user. Omit when safe.",
+    }),
+})
+    .meta({ title: "JudgeCommandSafetyResult" });
 export const NavigatePreviewToolInputSchema = z
     .object({
     href: z.string().meta({
@@ -1962,7 +1982,7 @@ export const CodeGenInputOptionsSchema = z
     modelOverride: z.string().optional(),
     errorIfHadCompaction: z.boolean().optional(),
     softContextWindow: z.number().optional(),
-    promptVersion: z.enum(["v1", "v2", "v3"]).optional(),
+    promptVersion: z.enum(["v1", "v2", "v3", "v4"]).optional(),
     reasoning: ReasoningEffortSchema.optional(),
     redactUserMessages: z.boolean().optional(),
     redactLLMMessages: z.boolean().optional(),

package/src/projects.d.ts

@@ -767,6 +767,140 @@ export interface ListBranchesResult {
 }
 export type CpuKind = "performance" | "standard" | "shared";
 export type MachineAutoStop = "stop" | "off" | "suspend";
+export declare const ShapeEffectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"remove-env">;
+    scope: z.ZodLiteral<"hosting-prod">;
+    key: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"attach-design-system">;
+    designSystemId: z.ZodString;
+}, z.core.$strip>], "kind">;
+export type ShapeEffect = z.infer<typeof ShapeEffectSchema>;
+export declare const ShapeOptionEffectSchema: z.ZodObject<{
+    instruction: z.ZodOptional<z.ZodString>;
+    effects: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"remove-env">;
+        scope: z.ZodLiteral<"hosting-prod">;
+        key: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"attach-design-system">;
+        designSystemId: z.ZodString;
+    }, z.core.$strip>], "kind">>>;
+}, z.core.$strip>;
+export type ShapeOptionEffect = z.infer<typeof ShapeOptionEffectSchema>;
+export declare const ShapeOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    effect: z.ZodOptional<z.ZodObject<{
+        instruction: z.ZodOptional<z.ZodString>;
+        effects: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"remove-env">;
+            scope: z.ZodLiteral<"hosting-prod">;
+            key: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"attach-design-system">;
+            designSystemId: z.ZodString;
+        }, z.core.$strip>], "kind">>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ShapeOption = z.infer<typeof ShapeOptionSchema>;
+export declare const ShapeQuestionSchema: z.ZodObject<{
+    id: z.ZodString;
+    question: z.ZodString;
+    kind: z.ZodEnum<{
+        "figma-upload": "figma-upload";
+        select: "select";
+    }>;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        effect: z.ZodOptional<z.ZodObject<{
+            instruction: z.ZodOptional<z.ZodString>;
+            effects: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"remove-env">;
+                scope: z.ZodLiteral<"hosting-prod">;
+                key: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"attach-design-system">;
+                designSystemId: z.ZodString;
+            }, z.core.$strip>], "kind">>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    guessOptionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ShapeQuestion = z.infer<typeof ShapeQuestionSchema>;
+export declare const ShapeAnswerSchema: z.ZodObject<{
+    questionId: z.ZodString;
+    optionId: z.ZodOptional<z.ZodString>;
+    designSystemId: z.ZodOptional<z.ZodString>;
+    skipped: z.ZodBoolean;
+    delegated: z.ZodBoolean;
+    resolvedFrom: z.ZodEnum<{
+        llm: "llm";
+        user: "user";
+    }>;
+    llmOptionId: z.ZodOptional<z.ZodString>;
+    guessOptionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ShapeAnswer = z.infer<typeof ShapeAnswerSchema>;
+export declare const ShapeSessionSchema: z.ZodObject<{
+    questionnaireId: z.ZodString;
+    catalogVersion: z.ZodString;
+    source: z.ZodEnum<{
+        agent: "agent";
+        static: "static";
+    }>;
+    status: z.ZodEnum<{
+        assembling: "assembling";
+        pending: "pending";
+        resolved: "resolved";
+    }>;
+    selection: z.ZodEnum<{
+        fallback: "fallback";
+        llm: "llm";
+    }>;
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        question: z.ZodString;
+        kind: z.ZodEnum<{
+            "figma-upload": "figma-upload";
+            select: "select";
+        }>;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            effect: z.ZodOptional<z.ZodObject<{
+                instruction: z.ZodOptional<z.ZodString>;
+                effects: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"remove-env">;
+                    scope: z.ZodLiteral<"hosting-prod">;
+                    key: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"attach-design-system">;
+                    designSystemId: z.ZodString;
+                }, z.core.$strip>], "kind">>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        guessOptionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    initialPromptId: z.ZodString;
+    answers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        questionId: z.ZodString;
+        optionId: z.ZodOptional<z.ZodString>;
+        designSystemId: z.ZodOptional<z.ZodString>;
+        skipped: z.ZodBoolean;
+        delegated: z.ZodBoolean;
+        resolvedFrom: z.ZodEnum<{
+            llm: "llm";
+            user: "user";
+        }>;
+        llmOptionId: z.ZodOptional<z.ZodString>;
+        guessOptionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    assembledAt: z.ZodOptional<z.ZodString>;
+    resolvedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ShapeSession = z.infer<typeof ShapeSessionSchema>;
 export declare const ProjectRolePermissionsSchema: z.ZodObject<{
     view: z.ZodOptional<z.ZodBoolean>;
     editCode: z.ZodOptional<z.ZodBoolean>;
@@ -1171,6 +1305,63 @@ export declare const ProjectSettingsSchema: z.ZodObject<{
         enabled: z.ZodBoolean;
         password: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    shapeSession: z.ZodOptional<z.ZodObject<{
+        questionnaireId: z.ZodString;
+        catalogVersion: z.ZodString;
+        source: z.ZodEnum<{
+            agent: "agent";
+            static: "static";
+        }>;
+        status: z.ZodEnum<{
+            assembling: "assembling";
+            pending: "pending";
+            resolved: "resolved";
+        }>;
+        selection: z.ZodEnum<{
+            fallback: "fallback";
+            llm: "llm";
+        }>;
+        questions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            question: z.ZodString;
+            kind: z.ZodEnum<{
+                "figma-upload": "figma-upload";
+                select: "select";
+            }>;
+            options: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                effect: z.ZodOptional<z.ZodObject<{
+                    instruction: z.ZodOptional<z.ZodString>;
+                    effects: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        kind: z.ZodLiteral<"remove-env">;
+                        scope: z.ZodLiteral<"hosting-prod">;
+                        key: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        kind: z.ZodLiteral<"attach-design-system">;
+                        designSystemId: z.ZodString;
+                    }, z.core.$strip>], "kind">>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            guessOptionId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        initialPromptId: z.ZodString;
+        answers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            questionId: z.ZodString;
+            optionId: z.ZodOptional<z.ZodString>;
+            designSystemId: z.ZodOptional<z.ZodString>;
+            skipped: z.ZodBoolean;
+            delegated: z.ZodBoolean;
+            resolvedFrom: z.ZodEnum<{
+                llm: "llm";
+                user: "user";
+            }>;
+            llmOptionId: z.ZodOptional<z.ZodString>;
+            guessOptionId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        assembledAt: z.ZodOptional<z.ZodString>;
+        resolvedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ProjectSettings = z.infer<typeof ProjectSettingsSchema>;
 /**
@@ -1935,6 +2126,7 @@ export interface CreateBranchOptions {
     branchFriendlyName?: string;
     agentType?: AgentType;
     actor: string;
+    isPublic?: boolean;
     hidden?: boolean;
     featureFlags?: Record<string, boolean>;
     checkoutBranch?: string | null;
@@ -1992,6 +2184,7 @@ export interface CreateBranchOptions {
      */
     sessionId?: string;
 }
+export declare function resolveBranchIsPublic(isPublic: boolean | undefined, defaultBranchType: "shared" | "private" | undefined): boolean;
 interface BaseCreateBranchMessage {
 }
 export interface CreatingBranchMessage extends BaseCreateBranchMessage {
@@ -3444,6 +3637,20 @@ export declare const CloneProjectOptionsSchema: z.ZodObject<{
     useKube: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type CloneProjectOptions = z.infer<typeof CloneProjectOptionsSchema>;
+export declare const GetPreferredProjectForRepoOptionsSchema: z.ZodObject<{
+    repoUrl: z.ZodString;
+    repoFullName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GetPreferredProjectForRepoOptions = z.infer<typeof GetPreferredProjectForRepoOptionsSchema>;
+/** Identity only — this powers a "currently preferred: X" label, not a project read. */
+export declare const GetPreferredProjectForRepoResultSchema: z.ZodObject<{
+    status: z.ZodLiteral<"success">;
+    project: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GetPreferredProjectForRepoResult = z.infer<typeof GetPreferredProjectForRepoResultSchema>;
 /**
  * Write-time contract for a single hosted-site access rule. Mirrors the stored
  * {@link SiteAccessRule} in `organization.ts`, except a password rule carries a
@@ -3972,6 +4179,63 @@ export declare const ProjectTemplateSchema: z.ZodObject<{
             enabled: z.ZodBoolean;
             password: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
+        shapeSession: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            questionnaireId: z.ZodString;
+            catalogVersion: z.ZodString;
+            source: z.ZodEnum<{
+                agent: "agent";
+                static: "static";
+            }>;
+            status: z.ZodEnum<{
+                assembling: "assembling";
+                pending: "pending";
+                resolved: "resolved";
+            }>;
+            selection: z.ZodEnum<{
+                fallback: "fallback";
+                llm: "llm";
+            }>;
+            questions: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                question: z.ZodString;
+                kind: z.ZodEnum<{
+                    "figma-upload": "figma-upload";
+                    select: "select";
+                }>;
+                options: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodString;
+                    effect: z.ZodOptional<z.ZodObject<{
+                        instruction: z.ZodOptional<z.ZodString>;
+                        effects: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            kind: z.ZodLiteral<"remove-env">;
+                            scope: z.ZodLiteral<"hosting-prod">;
+                            key: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            kind: z.ZodLiteral<"attach-design-system">;
+                            designSystemId: z.ZodString;
+                        }, z.core.$strip>], "kind">>>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                guessOptionId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            initialPromptId: z.ZodString;
+            answers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                questionId: z.ZodString;
+                optionId: z.ZodOptional<z.ZodString>;
+                designSystemId: z.ZodOptional<z.ZodString>;
+                skipped: z.ZodBoolean;
+                delegated: z.ZodBoolean;
+                resolvedFrom: z.ZodEnum<{
+                    llm: "llm";
+                    user: "user";
+                }>;
+                llmOptionId: z.ZodOptional<z.ZodString>;
+                guessOptionId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            assembledAt: z.ZodOptional<z.ZodString>;
+            resolvedAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
     hosting: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -4077,36 +4341,13 @@ export declare const ProjectTemplateOverridesSchema: z.ZodObject<{
             containerized: "containerized";
         }>>>;
         devServerPort: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-        devServerUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        refreshPreview: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         installCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         installNpmrc: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        validateCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        proxyOrigin: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        proxyDefaultOrigin: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        defaultAutoPush: z.ZodOptional<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.ZodOptional<z.ZodEnum<{
             "ai-session": "ai-session";
             "branch-name": "branch-name";
             custom: "custom";
         }>>>;
-        setupDependencies: z.ZodOptional<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.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             checkScript: z.ZodString;
@@ -4169,7 +4410,6 @@ export declare const ProjectTemplateOverridesSchema: z.ZodObject<{
         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>]>>>;
-        includePath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         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<{
@@ -4337,7 +4577,6 @@ export declare const ProjectTemplateOverridesSchema: z.ZodObject<{
             "draft-prs": "draft-prs";
             prs: "prs";
         }>>>;
-        autoCloseBranchOnMerge: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         enableMergePR: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         minRequiredApprovals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         requireApprovalBeforePR: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -4354,7 +4593,6 @@ export declare const ProjectTemplateOverridesSchema: z.ZodObject<{
         designSystems: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
         designTokenStrictMode: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         designModeSelector: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        useNI: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         folders: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             remoteUrl: z.ZodString;
@@ -4367,8 +4605,6 @@ export declare const ProjectTemplateOverridesSchema: z.ZodObject<{
         }, z.core.$strip>>>>;
         agentsMD: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         initializationCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        repoSubpath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        recommendedRoot: 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<{
@@ -4390,7 +4626,6 @@ export declare const ProjectTemplateOverridesSchema: z.ZodObject<{
         }, z.core.$strip>>>;
         enableSnapshots: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         postMergeMemories: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
-        commitInstructions: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         maxAgentCompletions: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         enableAgentMode: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         allowPreviewAutoSubmit: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -4402,7 +4637,6 @@ export declare const ProjectTemplateOverridesSchema: z.ZodObject<{
             timestamp: z.ZodNumber;
             starred: z.ZodBoolean;
         }, z.core.$strip>>>>;
-        skipCommandSecurity: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         httpsServerKeyPath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         httpsServerCertPath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         httpsServerCaPath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
@@ -4484,36 +4718,13 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodObject<
                 containerized: "containerized";
             }>>>;
             devServerPort: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-            devServerUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            refreshPreview: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
             installCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             installNpmrc: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-            validateCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            proxyOrigin: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            proxyDefaultOrigin: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            defaultAutoPush: z.ZodOptional<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.ZodOptional<z.ZodEnum<{
                 "ai-session": "ai-session";
                 "branch-name": "branch-name";
                 custom: "custom";
             }>>>;
-            setupDependencies: z.ZodOptional<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.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 checkScript: z.ZodString;
@@ -4576,7 +4787,6 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodObject<
             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>]>>>;
-            includePath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             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<{
@@ -4744,7 +4954,6 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodObject<
                 "draft-prs": "draft-prs";
                 prs: "prs";
             }>>>;
-            autoCloseBranchOnMerge: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
             enableMergePR: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
             minRequiredApprovals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
             requireApprovalBeforePR: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -4761,7 +4970,6 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodObject<
             designSystems: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
             designTokenStrictMode: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
             designModeSelector: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            useNI: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
             folders: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 remoteUrl: z.ZodString;
@@ -4774,8 +4982,6 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodObject<
             }, z.core.$strip>>>>;
             agentsMD: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             initializationCommand: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            repoSubpath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            recommendedRoot: 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<{
@@ -4797,7 +5003,6 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodObject<
             }, z.core.$strip>>>;
             enableSnapshots: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
             postMergeMemories: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
-            commitInstructions: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             maxAgentCompletions: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
             enableAgentMode: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
             allowPreviewAutoSubmit: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -4809,7 +5014,6 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodObject<
                 timestamp: z.ZodNumber;
                 starred: z.ZodBoolean;
             }, z.core.$strip>>>>;
-            skipCommandSecurity: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
             httpsServerKeyPath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             httpsServerCertPath: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             httpsServerCaPath: z.ZodOptional<z.ZodOptional<z.ZodString>>;

package/src/projects.js

@@ -271,6 +271,55 @@ export const ListBranchesOptionsSchema = z.object({
         description: "Superuser-only: list branches for a different owner/org.",
     }),
 });
+export const ShapeEffectSchema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("remove-env"),
+        scope: z.literal("hosting-prod"),
+        key: z.string(),
+    }),
+    z.object({
+        kind: z.literal("attach-design-system"),
+        designSystemId: z.string(),
+    }),
+]);
+export const ShapeOptionEffectSchema = z.object({
+    instruction: z.string().optional(),
+    effects: z.array(ShapeEffectSchema).optional(),
+});
+export const ShapeOptionSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    effect: ShapeOptionEffectSchema.optional(),
+});
+export const ShapeQuestionSchema = z.object({
+    id: z.string(),
+    question: z.string(),
+    kind: z.enum(["select", "figma-upload"]),
+    options: z.array(ShapeOptionSchema),
+    guessOptionId: z.string().optional(),
+});
+export const ShapeAnswerSchema = z.object({
+    questionId: z.string(),
+    optionId: z.string().optional(),
+    designSystemId: z.string().optional(),
+    skipped: z.boolean(),
+    delegated: z.boolean(),
+    resolvedFrom: z.enum(["user", "llm"]),
+    llmOptionId: z.string().optional(),
+    guessOptionId: z.string().optional(),
+});
+export const ShapeSessionSchema = z.object({
+    questionnaireId: z.string(),
+    catalogVersion: z.string().regex(/^\d{4}-\d{2}-\d{2}\.\d+$/),
+    source: z.enum(["static", "agent"]),
+    status: z.enum(["assembling", "pending", "resolved"]),
+    selection: z.enum(["llm", "fallback"]),
+    questions: z.array(ShapeQuestionSchema),
+    initialPromptId: z.string(),
+    answers: z.array(ShapeAnswerSchema).optional(),
+    assembledAt: z.string().optional(),
+    resolvedAt: z.string().optional(),
+});
 export const ProjectRolePermissionsSchema = z
     .object({
     view: z.boolean().optional(),
@@ -758,6 +807,9 @@ export const ProjectSettingsSchema = z
     })
         .optional()
         .meta({ description: "Password-protect the preview URL." }),
+    shapeSession: ShapeSessionSchema.optional().meta({
+        description: "@internal Guided-onboarding questionnaire issued for this project.",
+    }),
 })
     .meta({ title: "ProjectSettings" });
 /**
@@ -781,6 +833,7 @@ const INTERNAL_PROJECT_SETTINGS_MASK = {
     commitInstructions: true,
     skipCommandSecurity: true,
     autoCloseBranchOnMerge: true,
+    shapeSession: true,
 };
 /**
  * Runtime schema for the client-writable subset of {@link Project.settings},
@@ -885,6 +938,13 @@ export const CreateProjectRequestSchema = z.object({
     /** Design system ids to seed into project settings at creation. */
     designSystems: z.array(z.string()).optional(),
 });
+export function resolveBranchIsPublic(isPublic, defaultBranchType) {
+    if (isPublic !== undefined)
+        return isPublic;
+    if (defaultBranchType === undefined)
+        return true;
+    return defaultBranchType === "shared";
+}
 export const MEMORY_PICKED_FIELDS = [
     "id",
     "updatedAt",
@@ -1897,6 +1957,24 @@ export const CloneProjectOptionsSchema = z.object({
         description: "Whether to provision on cloud-v2 (Kubernetes). Defaults to false.",
     }),
 });
+export const GetPreferredProjectForRepoOptionsSchema = z.object({
+    repoUrl: z.string().min(1).meta({
+        description: "Full clone URL of the repository to look up.",
+    }),
+    repoFullName: z.string().optional().meta({
+        description: 'Repo in "owner/repo" form; derived from `repoUrl` when omitted.',
+    }),
+});
+/** Identity only — this powers a "currently preferred: X" label, not a project read. */
+export const GetPreferredProjectForRepoResultSchema = z.object({
+    status: z.literal("success"),
+    project: z
+        .object({
+        id: z.string(),
+        name: z.string(),
+    })
+        .nullable(),
+});
 /**
  * Write-time contract for a single hosted-site access rule. Mirrors the stored
  * {@link SiteAccessRule} in `organization.ts`, except a password rule carries a
@@ -2039,6 +2117,7 @@ export const ProjectTemplateOverridesSchema = z.object({
         sourceProjectId: true,
         sourceBranchName: true,
     }).partial().shape,
+    settings: ProjectSettingsExternalSchema.partial().optional(),
     hosting: ProjectHostingExternalSchema.optional(),
 });
 export const CreateProjectTemplateFromProjectOptionsSchema = z.object({

package/src/projects.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { AGENT_NATIVE_STARTER_REPO, getAgentNativeRootPackageJsonWriteError, getManagedDatabasePackageJsonError, matchesAgentNativeStarter, ProjectHostingExternalSchema, ProjectHostingSchema, } from "./projects";
+import { AGENT_NATIVE_STARTER_REPO, getAgentNativeRootPackageJsonWriteError, getManagedDatabasePackageJsonError, matchesAgentNativeStarter, ProjectHostingExternalSchema, ProjectHostingSchema, ProjectSettingsExternalSchema, ProjectSettingsSchema, ProjectTemplateOverridesSchema, ShapeSessionSchema, } from "./projects";
 describe("project hosting schemas", () => {
     it("accepts the canonical published branch route", () => {
         expect(ProjectHostingSchema.parse({ publishedBranchId: "branch-live" })).toEqual({ publishedBranchId: "branch-live" });
@@ -11,6 +11,55 @@ describe("project hosting schemas", () => {
         })).toEqual({ enabled: true });
     });
 });
+describe("guided onboarding project settings", () => {
+    const shapeSession = {
+        questionnaireId: "questionnaire-1",
+        catalogVersion: "2026-09-03.1",
+        source: "static",
+        status: "pending",
+        selection: "llm",
+        questions: [
+            {
+                id: "authentication",
+                question: "Will users need to login to use your app?",
+                kind: "select",
+                options: [
+                    {
+                        id: "required",
+                        label: "Yes",
+                        effect: {
+                            instruction: "Require users to sign in.",
+                            effects: [
+                                {
+                                    kind: "remove-env",
+                                    scope: "hosting-prod",
+                                    key: "AUTH_DISABLED",
+                                },
+                            ],
+                        },
+                    },
+                ],
+            },
+        ],
+        initialPromptId: "prompt-1",
+    };
+    it("parses a snapshotted questionnaire session", () => {
+        expect(ShapeSessionSchema.parse(shapeSession)).toEqual(shapeSession);
+        expect(ProjectSettingsSchema.parse({ shapeSession })).toEqual({
+            shapeSession,
+        });
+    });
+    it("requires a dated catalog version", () => {
+        expect(() => ShapeSessionSchema.parse({
+            ...shapeSession,
+            catalogVersion: "v1",
+        })).toThrow();
+    });
+    it("does not allow clients to write a shape session", () => {
+        expect(ProjectSettingsExternalSchema.parse({ shapeSession })).toEqual({});
+        expect(ProjectTemplateOverridesSchema.parse({ settings: { shapeSession } })).toEqual({ settings: {} });
+    });
+});
 describe("matchesAgentNativeStarter", () => {
     it("matches when repoName is the starter", () => {
         expect(matchesAgentNativeStarter({ repoName: AGENT_NATIVE_STARTER_REPO })).toBe(true);