@builder.io/ai-utils 0.100.0 → 0.100.1

package/package.json

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

package/src/codegen.d.ts

@@ -385,8 +385,21 @@ export declare const GetScreenshotToolInputSchema: z.ZodObject<{
     height: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type GetScreenshotToolInput = z.infer<typeof GetScreenshotToolInputSchema>;
+/**
+ * `projectId` and `routedBy` are telemetry only and never reach the model or
+ * the classification path — they exist so an audit of real traffic
+ * (`scripts/judge-safety-audit.ts`) can say which project a verdict belonged
+ * to and whether the legacy ACL would have blocked the command. Both are
+ * optional because a pod running an older dev-tools build won't send them.
+ */
 export declare const JudgeCommandSafetyInputSchema: z.ZodObject<{
     command: z.ZodString;
+    projectId: z.ZodOptional<z.ZodString>;
+    routedBy: z.ZodOptional<z.ZodEnum<{
+        "allowlist-miss": "allowlist-miss";
+        "network-client": "network-client";
+        tier2: "tier2";
+    }>>;
 }, z.core.$strip>;
 export type JudgeCommandSafetyInput = z.infer<typeof JudgeCommandSafetyInputSchema>;
 export declare const JudgeCommandSafetyResultSchema: z.ZodObject<{

package/src/codegen.js

@@ -583,6 +583,13 @@ export const GetScreenshotToolInputSchema = z
     height: z.number().optional(),
 })
     .meta({ title: "GetScreenshotToolInput" });
+/**
+ * `projectId` and `routedBy` are telemetry only and never reach the model or
+ * the classification path — they exist so an audit of real traffic
+ * (`scripts/judge-safety-audit.ts`) can say which project a verdict belonged
+ * to and whether the legacy ACL would have blocked the command. Both are
+ * optional because a pod running an older dev-tools build won't send them.
+ */
 export const JudgeCommandSafetyInputSchema = z
     .object({
     // Bounded so a caller can't force multi-megabyte payloads through this
@@ -591,6 +598,18 @@ export const JudgeCommandSafetyInputSchema = z
     command: z.string().max(20000).meta({
         description: "The shell command to classify.",
     }),
+    projectId: z.string().max(200).optional().meta({
+        description: "Diagnostic only: the Fusion project the command was run in. Never used in classification.",
+    }),
+    // Reported as a single value with the client's own precedence — a command
+    // can trip more than one of these, and only the first two mean the legacy
+    // ACL would have denied it.
+    routedBy: z
+        .enum(["tier2", "allowlist-miss", "network-client"])
+        .optional()
+        .meta({
+        description: "Diagnostic only: why the sandbox sent this command to the judge. Never used in classification.",
+    }),
 })
     .meta({ title: "JudgeCommandSafetyInput" });
 export const JudgeCommandSafetyResultSchema = z

package/src/events.d.ts

@@ -767,6 +767,37 @@ export declare const FusionShapeAssembledV1: {
     eventName: "fusion.shape.assembled";
     version: "1";
 };
+export type FusionShapeResolvedV1 = FusionEventVariant<"fusion.shape.resolved", {
+    projectId: string;
+    questionnaireId: string;
+    catalogVersion: string;
+    resolvedAt: string;
+}, {}, 1>;
+export declare const FusionShapeResolvedV1: {
+    eventName: "fusion.shape.resolved";
+    version: "1";
+};
+type FusionShapeQuestionEventData = {
+    projectId: string;
+    questionnaireId: string;
+    catalogVersion: string;
+    questionId: string;
+    chosenOptionId: string;
+    skipped: boolean;
+    delegated: boolean;
+    llmOptionId?: string;
+    guessOptionId?: string;
+};
+export type FusionShapeQuestionAnsweredV1 = FusionEventVariant<"fusion.shape.question.answered", FusionShapeQuestionEventData, {}, 1>;
+export declare const FusionShapeQuestionAnsweredV1: {
+    eventName: "fusion.shape.question.answered";
+    version: "1";
+};
+export type FusionShapeQuestionSkippedV1 = FusionEventVariant<"fusion.shape.question.skipped", FusionShapeQuestionEventData, {}, 1>;
+export declare const FusionShapeQuestionSkippedV1: {
+    eventName: "fusion.shape.question.skipped";
+    version: "1";
+};
 export type SetupAgentCompletedV1 = FusionEventVariant<"fusion.setup.completed", {
     proposedConfigId: string;
     projectId: string;
@@ -1398,7 +1429,7 @@ export declare const HostingCustomDomainDelegationCheckV1: {
     eventName: "hosting.custom-domain.delegation-check";
     version: "1";
 };
-export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | ClientDevtoolsBuildMigratedV1 | ClientDevtoolsBuildCompletedV1 | ClientDevtoolsBuildUploadedV1 | ClientDevtoolsBuildFailedV1 | FusionProjectCreatedV1 | FusionShapeIssuedV1 | FusionShapeAssembledV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionGitHubExternalPrV1 | BotMentionGitHubInternalPrV1 | BotMentionGitLabPrV1 | BotMentionBitbucketPrV1 | BotMentionAzurePrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1 | McpPrototypePulledV1 | HostingCustomDomainCertCheckV1 | HostingCustomDomainServingCheckV1 | HostingCustomDomainDelegationCheckV1;
+export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | ClientDevtoolsBuildMigratedV1 | ClientDevtoolsBuildCompletedV1 | ClientDevtoolsBuildUploadedV1 | ClientDevtoolsBuildFailedV1 | FusionProjectCreatedV1 | FusionShapeIssuedV1 | FusionShapeAssembledV1 | FusionShapeResolvedV1 | FusionShapeQuestionAnsweredV1 | FusionShapeQuestionSkippedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionGitHubExternalPrV1 | BotMentionGitHubInternalPrV1 | BotMentionGitLabPrV1 | BotMentionBitbucketPrV1 | BotMentionAzurePrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1 | McpPrototypePulledV1 | HostingCustomDomainCertCheckV1 | HostingCustomDomainServingCheckV1 | HostingCustomDomainDelegationCheckV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -54,6 +54,18 @@ export const FusionShapeAssembledV1 = {
     eventName: "fusion.shape.assembled",
     version: "1",
 };
+export const FusionShapeResolvedV1 = {
+    eventName: "fusion.shape.resolved",
+    version: "1",
+};
+export const FusionShapeQuestionAnsweredV1 = {
+    eventName: "fusion.shape.question.answered",
+    version: "1",
+};
+export const FusionShapeQuestionSkippedV1 = {
+    eventName: "fusion.shape.question.skipped",
+    version: "1",
+};
 export const SetupAgentCompletedV1 = {
     eventName: "fusion.setup.completed",
     version: "1",

package/src/projects.d.ts

@@ -774,6 +774,7 @@ export declare const ShapeEffectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"attach-design-system">;
     designSystemId: z.ZodString;
+    designSystemName: z.ZodString;
 }, z.core.$strip>], "kind">;
 export type ShapeEffect = z.infer<typeof ShapeEffectSchema>;
 export declare const ShapeOptionEffectSchema: z.ZodObject<{
@@ -785,6 +786,7 @@ export declare const ShapeOptionEffectSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"attach-design-system">;
         designSystemId: z.ZodString;
+        designSystemName: z.ZodString;
     }, z.core.$strip>], "kind">>>;
 }, z.core.$strip>;
 export type ShapeOptionEffect = z.infer<typeof ShapeOptionEffectSchema>;
@@ -800,6 +802,7 @@ export declare const ShapeOptionSchema: z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"attach-design-system">;
             designSystemId: z.ZodString;
+            designSystemName: z.ZodString;
         }, z.core.$strip>], "kind">>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -823,6 +826,7 @@ export declare const ShapeQuestionSchema: z.ZodObject<{
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"attach-design-system">;
                 designSystemId: z.ZodString;
+                designSystemName: z.ZodString;
             }, z.core.$strip>], "kind">>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
@@ -833,6 +837,7 @@ export declare const ShapeAnswerSchema: z.ZodObject<{
     questionId: z.ZodString;
     optionId: z.ZodOptional<z.ZodString>;
     designSystemId: z.ZodOptional<z.ZodString>;
+    designSystemName: z.ZodOptional<z.ZodString>;
     skipped: z.ZodBoolean;
     delegated: z.ZodBoolean;
     resolvedFrom: z.ZodEnum<{
@@ -843,6 +848,49 @@ export declare const ShapeAnswerSchema: z.ZodObject<{
     guessOptionId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ShapeAnswer = z.infer<typeof ShapeAnswerSchema>;
+export declare const ShapeAnswerInputSchema: z.ZodObject<{
+    skipped: z.ZodBoolean;
+    delegated: z.ZodBoolean;
+    questionId: z.ZodString;
+    optionId: z.ZodOptional<z.ZodString>;
+    designSystemId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ShapeAnswerInput = z.infer<typeof ShapeAnswerInputSchema>;
+export declare const GetShapeQuestionnaireOptionsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, z.core.$strip>;
+export type GetShapeQuestionnaireOptions = z.infer<typeof GetShapeQuestionnaireOptionsSchema>;
+export declare const SubmitShapeAnswersOptionsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    questionnaireId: z.ZodString;
+    answers: z.ZodArray<z.ZodObject<{
+        skipped: z.ZodBoolean;
+        delegated: z.ZodBoolean;
+        questionId: z.ZodString;
+        optionId: z.ZodOptional<z.ZodString>;
+        designSystemId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SubmitShapeAnswersOptions = z.infer<typeof SubmitShapeAnswersOptionsSchema>;
+/**
+ * A file the client writes into the container's working tree over the
+ * launch-server RPC. The server renders the body; the container performs the
+ * write; the agent only reads it.
+ */
+export declare const ShapeDecisionsFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    contents: z.ZodString;
+}, z.core.$strip>;
+export type ShapeDecisionsFile = z.infer<typeof ShapeDecisionsFileSchema>;
+export declare const SubmitShapeAnswersResponseSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    instructionBlock: z.ZodOptional<z.ZodString>;
+    decisionsFile: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        contents: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SubmitShapeAnswersResponse = z.infer<typeof SubmitShapeAnswersResponseSchema>;
 export declare const ShapeQuestionDecisionSchema: z.ZodObject<{
     questionId: z.ZodString;
     ask: z.ZodBoolean;
@@ -893,6 +941,7 @@ export declare const ShapeSessionSchema: z.ZodObject<{
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"attach-design-system">;
                     designSystemId: z.ZodString;
+                    designSystemName: z.ZodString;
                 }, z.core.$strip>], "kind">>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
@@ -903,6 +952,7 @@ export declare const ShapeSessionSchema: z.ZodObject<{
         questionId: z.ZodString;
         optionId: z.ZodOptional<z.ZodString>;
         designSystemId: z.ZodOptional<z.ZodString>;
+        designSystemName: z.ZodOptional<z.ZodString>;
         skipped: z.ZodBoolean;
         delegated: z.ZodBoolean;
         resolvedFrom: z.ZodEnum<{
@@ -1374,6 +1424,7 @@ export declare const ProjectSettingsSchema: z.ZodObject<{
                     }, z.core.$strip>, z.ZodObject<{
                         kind: z.ZodLiteral<"attach-design-system">;
                         designSystemId: z.ZodString;
+                        designSystemName: z.ZodString;
                     }, z.core.$strip>], "kind">>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
@@ -1384,6 +1435,7 @@ export declare const ProjectSettingsSchema: z.ZodObject<{
             questionId: z.ZodString;
             optionId: z.ZodOptional<z.ZodString>;
             designSystemId: z.ZodOptional<z.ZodString>;
+            designSystemName: z.ZodOptional<z.ZodString>;
             skipped: z.ZodBoolean;
             delegated: z.ZodBoolean;
             resolvedFrom: z.ZodEnum<{
@@ -4261,6 +4313,7 @@ export declare const ProjectTemplateSchema: z.ZodObject<{
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"attach-design-system">;
                             designSystemId: z.ZodString;
+                            designSystemName: z.ZodString;
                         }, z.core.$strip>], "kind">>>;
                     }, z.core.$strip>>;
                 }, z.core.$strip>>;
@@ -4271,6 +4324,7 @@ export declare const ProjectTemplateSchema: z.ZodObject<{
                 questionId: z.ZodString;
                 optionId: z.ZodOptional<z.ZodString>;
                 designSystemId: z.ZodOptional<z.ZodString>;
+                designSystemName: z.ZodOptional<z.ZodString>;
                 skipped: z.ZodBoolean;
                 delegated: z.ZodBoolean;
                 resolvedFrom: z.ZodEnum<{

package/src/projects.js

@@ -279,7 +279,10 @@ export const ShapeEffectSchema = z.discriminatedUnion("kind", [
     }),
     z.object({
         kind: z.literal("attach-design-system"),
+        /** The permanent join key. */
         designSystemId: z.string(),
+        /** What actually gets written: the field is matched by name downstream. */
+        designSystemName: z.string(),
     }),
 ]);
 export const ShapeOptionEffectSchema = z.object({
@@ -302,12 +305,62 @@ export const ShapeAnswerSchema = z.object({
     questionId: z.string(),
     optionId: z.string().optional(),
     designSystemId: z.string().optional(),
+    /**
+     * Server-resolved from `designSystemId` against the caller's accessible
+     * design systems. `settings.designSystems` is matched by name downstream, so
+     * the id alone cannot be written there.
+     */
+    designSystemName: z.string().optional(),
     skipped: z.boolean(),
     delegated: z.boolean(),
     resolvedFrom: z.enum(["user", "llm"]),
     llmOptionId: z.string().optional(),
     guessOptionId: z.string().optional(),
 });
+const ShapeAnswerInputBaseSchema = ShapeAnswerSchema.pick({
+    questionId: true,
+    optionId: true,
+    designSystemId: true,
+    skipped: true,
+    delegated: true,
+});
+export const ShapeAnswerInputSchema = z.object({
+    ...ShapeAnswerInputBaseSchema.shape,
+    questionId: ShapeAnswerInputBaseSchema.shape.questionId.trim().min(1),
+    optionId: ShapeAnswerInputBaseSchema.shape.optionId
+        .unwrap()
+        .trim()
+        .min(1)
+        .optional(),
+    designSystemId: ShapeAnswerInputBaseSchema.shape.designSystemId
+        .unwrap()
+        .trim()
+        .min(1)
+        .optional(),
+});
+export const GetShapeQuestionnaireOptionsSchema = z.object({
+    projectId: z.string().trim().min(1),
+});
+export const SubmitShapeAnswersOptionsSchema = z.object({
+    projectId: z.string().trim().min(1),
+    questionnaireId: z.string().trim().min(1),
+    answers: z.array(ShapeAnswerInputSchema).min(1),
+});
+/**
+ * A file the client writes into the container's working tree over the
+ * launch-server RPC. The server renders the body; the container performs the
+ * write; the agent only reads it.
+ */
+export const ShapeDecisionsFileSchema = z.object({
+    /** Repository-root relative. */
+    path: z.string().min(1),
+    contents: z.string().min(1),
+});
+export const SubmitShapeAnswersResponseSchema = z.object({
+    prompt: z.string().min(1),
+    instructionBlock: z.string().min(1).optional(),
+    decisionsFile: ShapeDecisionsFileSchema.optional(),
+});
 export const ShapeQuestionDecisionSchema = z.object({
     questionId: z.string(),
     ask: z.boolean(),

package/src/projects.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { AGENT_NATIVE_STARTER_REPO, getAgentNativeRootPackageJsonWriteError, getManagedDatabasePackageJsonError, getProjectState, InitialPromptSchema, isProjectDeleted, matchesAgentNativeStarter, ProjectHostingExternalSchema, ProjectHostingSchema, ProjectSettingsExternalSchema, ProjectSettingsSchema, ProjectTemplateOverridesSchema, ShapeSessionSchema, } from "./projects";
+import { AGENT_NATIVE_STARTER_REPO, getAgentNativeRootPackageJsonWriteError, getManagedDatabasePackageJsonError, getProjectState, GetShapeQuestionnaireOptionsSchema, InitialPromptSchema, isProjectDeleted, matchesAgentNativeStarter, ProjectHostingExternalSchema, ProjectHostingSchema, ProjectSettingsExternalSchema, ProjectSettingsSchema, ProjectTemplateOverridesSchema, ShapeSessionSchema, SubmitShapeAnswersOptionsSchema, } from "./projects";
 describe("project hosting schemas", () => {
     it("accepts the canonical published branch route", () => {
         expect(ProjectHostingSchema.parse({ publishedBranchId: "branch-live" })).toEqual({ publishedBranchId: "branch-live" });
@@ -79,6 +79,42 @@ describe("guided onboarding project settings", () => {
         expect(ProjectSettingsExternalSchema.parse({ shapeSession })).toEqual({});
         expect(ProjectTemplateOverridesSchema.parse({ settings: { shapeSession } })).toEqual({ settings: {} });
     });
+    it("parses questionnaire endpoint inputs without accepting server fields", () => {
+        expect(GetShapeQuestionnaireOptionsSchema.parse({ projectId: "project-1" })).toEqual({ projectId: "project-1" });
+        expect(SubmitShapeAnswersOptionsSchema.parse({
+            projectId: "project-1",
+            questionnaireId: "questionnaire-1",
+            answers: [
+                {
+                    questionId: "authentication",
+                    optionId: "required",
+                    skipped: false,
+                    delegated: false,
+                    resolvedFrom: "llm",
+                    llmOptionId: "not-required",
+                    guessOptionId: "not-required",
+                },
+            ],
+        })).toEqual({
+            projectId: "project-1",
+            questionnaireId: "questionnaire-1",
+            answers: [
+                {
+                    questionId: "authentication",
+                    optionId: "required",
+                    skipped: false,
+                    delegated: false,
+                },
+            ],
+        });
+    });
+    it("requires non-empty questionnaire ids and at least one answer", () => {
+        expect(() => SubmitShapeAnswersOptionsSchema.parse({
+            projectId: "",
+            questionnaireId: "",
+            answers: [],
+        })).toThrow();
+    });
 });
 describe("matchesAgentNativeStarter", () => {
     it("matches when repoName is the starter", () => {