@builder.io/ai-utils 0.108.0 → 0.109.1

package/package.json

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

package/src/codegen.d.ts

@@ -511,6 +511,56 @@ export declare const RecordFrameToolInputSchema: z.ZodObject<{
     pr_highlight: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type RecordFrameToolInput = z.infer<typeof RecordFrameToolInputSchema>;
+export declare const StartRecordingToolInputSchema: z.ZodObject<{
+    label: z.ZodString;
+}, z.core.$strip>;
+export type StartRecordingToolInput = z.infer<typeof StartRecordingToolInputSchema>;
+export declare const StopRecordingToolInputSchema: z.ZodObject<{}, z.core.$strip>;
+export type StopRecordingToolInput = z.infer<typeof StopRecordingToolInputSchema>;
+export declare const PublishEvidenceToolInputSchema: z.ZodObject<{
+    issues: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        verdict: z.ZodEnum<{
+            fixed: "fixed";
+            "needs-input": "needs-input";
+            "no-ui-change": "no-ui-change";
+            "not-reproduced": "not-reproduced";
+        }>;
+        summary: z.ZodString;
+        screenshots: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            caption: z.ZodString;
+        }, z.core.$strip>>;
+        recordings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            recording_id: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PublishEvidenceToolInput = z.infer<typeof PublishEvidenceToolInputSchema>;
+export declare const MAX_EVIDENCE_UPLOAD_BYTES: number;
+export declare const EvidenceUploadUrlOptionsSchema: z.ZodObject<{
+    contentType: z.ZodEnum<{
+        "image/webp": "image/webp";
+        "video/mp4": "video/mp4";
+    }>;
+    size: z.ZodNumber;
+}, z.core.$strip>;
+export type EvidenceUploadUrlOptions = z.infer<typeof EvidenceUploadUrlOptionsSchema>;
+/** What publishing evidence did to the branch's open pull request. */
+export type OpenPRRefresh = {
+    status: "no-open-pr";
+} | {
+    status: "updated";
+    prNumber: number;
+} | {
+    status: "failed";
+    reason: string;
+};
+export interface EvidenceUploadUrlResult {
+    upload_url: string;
+    public_url: string;
+    required_headers: Record<string, string>;
+}
 export declare const ReportTestOutcomeToolInputSchema: z.ZodObject<{
     outcome: z.ZodEnum<{
         couldnt_verify: "couldnt_verify";
@@ -569,12 +619,29 @@ export interface TimelineFrameMetadata {
     fileName?: string;
     image_url?: string;
     prHighlight?: boolean;
+    /** Index into `TimelineRecording.phases` for a frame that belongs to a recording tab. */
+    phaseIndex?: number;
     description?: string;
     cursorX?: number | null;
     cursorY?: number | null;
     viewportWidth?: number;
     viewportHeight?: number;
 }
+/** One agent's slice of a merged browser-testing run. */
+export interface TimelineAgentPhase {
+    label: string;
+    sessionId: string;
+    startEventId: number;
+    endEventId: number;
+    testCaseIds?: string[];
+    replayId?: string;
+}
+/** One screen recording published as evidence; the timeline shows a tab for each. */
+export interface TimelineVideoPhase {
+    label: string;
+    videoUrl: string;
+    testCaseIds: string[];
+}
 export interface TimelineRecording {
     version: 1;
     sessionId: string;
@@ -591,14 +658,7 @@ export interface TimelineRecording {
         description: string;
         debugInfo?: string;
     }>;
-    phases?: Array<{
-        label: string;
-        sessionId: string;
-        startEventId: number;
-        endEventId: number;
-        testCaseIds?: string[];
-        replayId?: string;
-    }>;
+    phases?: Array<TimelineAgentPhase | TimelineVideoPhase>;
 }
 export interface TimelineSubmissionMetadata {
     prNumber?: number;
@@ -1631,6 +1691,29 @@ export declare const CodeGenToolMapSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         pr_highlight: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
+    StartRecording: z.ZodObject<{
+        label: z.ZodString;
+    }, z.core.$strip>;
+    StopRecording: z.ZodObject<{}, z.core.$strip>;
+    PublishEvidence: z.ZodObject<{
+        issues: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            verdict: z.ZodEnum<{
+                fixed: "fixed";
+                "needs-input": "needs-input";
+                "no-ui-change": "no-ui-change";
+                "not-reproduced": "not-reproduced";
+            }>;
+            summary: z.ZodString;
+            screenshots: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                caption: z.ZodString;
+            }, z.core.$strip>>;
+            recordings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                recording_id: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
     SubmitPRReview: z.ZodObject<{
         summary: z.ZodString;
         comments: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -2001,6 +2084,7 @@ export declare const CodeGenToolsSchema: z.ZodEnum<{
     PowerShell: "PowerShell";
     ProposeConfig: "ProposeConfig";
     ProposeEnvVariable: "ProposeEnvVariable";
+    PublishEvidence: "PublishEvidence";
     PullPrototype: "PullPrototype";
     Read: "Read";
     ReadBranch: "ReadBranch";
@@ -2020,6 +2104,8 @@ export declare const CodeGenToolsSchema: z.ZodEnum<{
     SetFileOverride: "SetFileOverride";
     Skill: "Skill";
     SpawnBranch: "SpawnBranch";
+    StartRecording: "StartRecording";
+    StopRecording: "StopRecording";
     SubmitPRReview: "SubmitPRReview";
     TaskCreate: "TaskCreate";
     TaskList: "TaskList";
@@ -2893,6 +2979,7 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
         PowerShell: "PowerShell";
         ProposeConfig: "ProposeConfig";
         ProposeEnvVariable: "ProposeEnvVariable";
+        PublishEvidence: "PublishEvidence";
         PullPrototype: "PullPrototype";
         Read: "Read";
         ReadBranch: "ReadBranch";
@@ -2912,6 +2999,8 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
         SetFileOverride: "SetFileOverride";
         Skill: "Skill";
         SpawnBranch: "SpawnBranch";
+        StartRecording: "StartRecording";
+        StopRecording: "StopRecording";
         SubmitPRReview: "SubmitPRReview";
         TaskCreate: "TaskCreate";
         TaskList: "TaskList";

package/src/codegen.js

@@ -751,6 +751,62 @@ export const RecordFrameToolInputSchema = z
     }),
 })
     .meta({ title: "RecordFrameToolInput" });
+export const StartRecordingToolInputSchema = z
+    .object({
+    label: z.string().meta({
+        description: "Timeline tab label for this recording, e.g. 'Production before', 'Figma', 'Local after'.",
+    }),
+})
+    .meta({ title: "StartRecordingToolInput" });
+export const StopRecordingToolInputSchema = z
+    .object({})
+    .meta({ title: "StopRecordingToolInput" });
+export const PublishEvidenceToolInputSchema = z
+    .object({
+    issues: z
+        .array(z.object({
+        title: z.string().meta({
+            description: "The issue as the user would name it.",
+        }),
+        verdict: z
+            .enum(["fixed", "not-reproduced", "needs-input", "no-ui-change"])
+            .meta({
+            description: "Only 'fixed' issues reach the PR's Verified section; the others stay on the timeline. 'no-ui-change' is for a change with nothing to show in a browser.",
+        }),
+        summary: z.string().meta({
+            description: "One or two sentences: what changed, or why it was not fixed.",
+        }),
+        screenshots: z
+            .array(z.object({
+            path: z.string().meta({
+                description: "A .png, .jpg or .webp file in the workspace or under ~/.builder.",
+            }),
+            caption: z.string(),
+        }))
+            .meta({
+            description: "Stills that support the fix; the PR shows them under the recording.",
+        }),
+        recordings: z
+            .array(z.object({
+            recording_id: z.string().meta({
+                description: "The recording_id StopRecording returned.",
+            }),
+        }))
+            .optional()
+            .meta({
+            description: "Required for a 'fixed' issue: its verification, recorded on your current code. Older recordings stay on the timeline as comparisons. One timeline tab each.",
+        }),
+    }))
+        .min(1),
+})
+    .meta({ title: "PublishEvidenceToolInput" });
+export const MAX_EVIDENCE_UPLOAD_BYTES = 100 * 1024 * 1024;
+export const EvidenceUploadUrlOptionsSchema = z
+    .object({
+    contentType: z.enum(["video/mp4", "image/webp"]),
+    size: z.number().int().positive().max(MAX_EVIDENCE_UPLOAD_BYTES),
+})
+    .meta({ title: "EvidenceUploadUrlOptions" });
 export const ReportTestOutcomeToolInputSchema = z
     .object({
     outcome: TestOutcomeSchema.meta({
@@ -1643,6 +1699,9 @@ export const CodeGenToolMapSchema = z.object({
     ExitPlanMode: ExitPlanModeToolInputSchema,
     ReadMcpResource: ReadMcpResourceToolInputSchema,
     RecordFrame: RecordFrameToolInputSchema,
+    StartRecording: StartRecordingToolInputSchema,
+    StopRecording: StopRecordingToolInputSchema,
+    PublishEvidence: PublishEvidenceToolInputSchema,
     SubmitPRReview: SubmitPRReviewToolInputSchema,
     AddComment: AddCommentToolInputSchema,
     ProposeConfig: ProposeConfigToolInputSchema,

package/src/projects.d.ts

@@ -1924,7 +1924,14 @@ export interface Project {
     projectType?: "app" | "repo-indexing";
     /** Custom domains associated with this project. */
     domains?: string[];
-    /** Whether the project is publicly accessible. */
+    /**
+     * Which members of the owning space can access the project. `"public"` (shown
+     * as "Team" in the UI, and the behavior when absent) admits every space
+     * member, subject to any project limits on their org role; `"private"` admits
+     * only the roles and users in {@link Project.projectAccess}. Org admins and
+     * the project's creator always have access. Grants nothing outside the
+     * space — see {@link Project.isPublic}.
+     */
     accessMode?: "public" | "private";
     /** Fine-grained access control configuration for the project. */
     projectAccess?: ProjectAccessControl;
@@ -1934,7 +1941,12 @@ export interface Project {
     screenshot: string | null;
     /** When true, this project is a built-in example shown to new users. */
     isExample?: boolean;
-    /** When true, the project is publicly accessible without authentication. */
+    /**
+     * When true, signed-in users outside the owning space can view and clone the
+     * project. Only example projects and connected fusion-starter projects can be
+     * made public. Independent of {@link Project.accessMode}, which governs members
+     * of the owning space.
+     */
     isPublic?: boolean;
     /** Volume snapshot metadata for restoring container state. */
     snapshotVolume?: {
@@ -2258,6 +2270,11 @@ export declare const ProjectSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     templateId: z.ZodString;
 }, z.core.$strip>], "kind">;
 export type ProjectSource = z.infer<typeof ProjectSourceSchema>;
+/** Query string of `GET /projects`. Only `limit` is validated here so far. */
+export declare const GetProjectsQuerySchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type GetProjectsQuery = z.infer<typeof GetProjectsQuerySchema>;
 /**
  * Request body for `POST /projects/create`. Identity/credentials come from the
  * authenticated request context, never the body.
@@ -3225,6 +3242,12 @@ export declare const DeployFailureReportSchema: z.ZodObject<{
     excerpt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type DeployFailureReport = z.infer<typeof DeployFailureReportSchema>;
+export declare const DeployFixNotRequestedReasonSchema: z.ZodEnum<{
+    error: "error";
+    "no-branch": "no-branch";
+    "send-failed": "send-failed";
+}>;
+export type DeployFixNotRequestedReason = z.infer<typeof DeployFixNotRequestedReasonSchema>;
 export declare const DeployFailureSchema: z.ZodObject<{
     stage: z.ZodOptional<z.ZodEnum<{
         build: "build";
@@ -3244,6 +3267,11 @@ export declare const DeployFailureSchema: z.ZodObject<{
     exitCode: z.ZodOptional<z.ZodNumber>;
     signal: z.ZodOptional<z.ZodString>;
     fixRequested: z.ZodOptional<z.ZodBoolean>;
+    fixNotRequestedReason: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        "no-branch": "no-branch";
+        "send-failed": "send-failed";
+    }>>;
 }, z.core.$strip>;
 export type DeployFailure = z.infer<typeof DeployFailureSchema>;
 export declare const DeploySchema: z.ZodObject<{
@@ -3295,6 +3323,11 @@ export declare const DeploySchema: z.ZodObject<{
         exitCode: z.ZodOptional<z.ZodNumber>;
         signal: z.ZodOptional<z.ZodString>;
         fixRequested: z.ZodOptional<z.ZodBoolean>;
+        fixNotRequestedReason: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            "no-branch": "no-branch";
+            "send-failed": "send-failed";
+        }>>;
     }, z.core.$strip>>;
     createdAt: z.ZodNumber;
     completedAt: z.ZodOptional<z.ZodNumber>;
@@ -3421,6 +3454,11 @@ export declare const DeployListItemSchema: z.ZodObject<{
         exitCode: z.ZodOptional<z.ZodNumber>;
         signal: z.ZodOptional<z.ZodString>;
         fixRequested: z.ZodOptional<z.ZodBoolean>;
+        fixNotRequestedReason: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            "no-branch": "no-branch";
+            "send-failed": "send-failed";
+        }>>;
     }, z.core.$strip>>;
     createdAt: z.ZodNumber;
     completedAt: z.ZodOptional<z.ZodNumber>;
@@ -3681,6 +3719,11 @@ export declare const GetDeploysResponseSchema: z.ZodObject<{
             exitCode: z.ZodOptional<z.ZodNumber>;
             signal: z.ZodOptional<z.ZodString>;
             fixRequested: z.ZodOptional<z.ZodBoolean>;
+            fixNotRequestedReason: z.ZodOptional<z.ZodEnum<{
+                error: "error";
+                "no-branch": "no-branch";
+                "send-failed": "send-failed";
+            }>>;
         }, z.core.$strip>>;
         createdAt: z.ZodNumber;
         completedAt: z.ZodOptional<z.ZodNumber>;
@@ -3743,6 +3786,7 @@ export declare const HostingDomainSchema: z.ZodObject<{
     verifyingSince: z.ZodOptional<z.ZodNumber>;
     attemptId: z.ZodOptional<z.ZodString>;
     verifiedAt: z.ZodOptional<z.ZodNumber>;
+    verifiedBy: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
     failedStep: z.ZodOptional<z.ZodEnum<{
         dns: "dns";
@@ -3751,6 +3795,16 @@ export declare const HostingDomainSchema: z.ZodObject<{
     routeError: z.ZodOptional<z.ZodString>;
     routeErrorAt: z.ZodOptional<z.ZodNumber>;
     servingConfirmedAt: z.ZodOptional<z.ZodNumber>;
+    servingProbeConfirmedAt: z.ZodOptional<z.ZodNumber>;
+    servingProbeTimedOutAt: z.ZodOptional<z.ZodNumber>;
+    servingProbeAmbiguousAt: z.ZodOptional<z.ZodNumber>;
+    certTeardownStartedAt: z.ZodOptional<z.ZodNumber>;
+    certTeardownReason: z.ZodOptional<z.ZodString>;
+    removalStartedAt: z.ZodOptional<z.ZodNumber>;
+    promotionInProgressAttemptId: z.ZodOptional<z.ZodString>;
+    promotionInProgressCount: z.ZodOptional<z.ZodNumber>;
+    promotionStartedAt: z.ZodOptional<z.ZodNumber>;
+    promotionEpoch: z.ZodOptional<z.ZodString>;
     certIssue: z.ZodOptional<z.ZodString>;
     certIssueAt: z.ZodOptional<z.ZodNumber>;
     createdBy: z.ZodString;

package/src/projects.js

@@ -1102,6 +1102,11 @@ export const ProjectSourceSchema = z.discriminatedUnion("kind", [
     z.object({ kind: z.literal("repo"), repoUrl: z.string().url() }),
     z.object({ kind: z.literal("template"), templateId: z.string() }),
 ]);
+/** Query string of `GET /projects`. Only `limit` is validated here so far. */
+export const GetProjectsQuerySchema = z.object({
+    /** At most this many projects, counted after access, hidden and DSI filtering. */
+    limit: z.coerce.number().int().min(1).max(1000).optional(),
+});
 /**
  * Request body for `POST /projects/create`. Identity/credentials come from the
  * authenticated request context, never the body.
@@ -1495,6 +1500,11 @@ export const DeployFailureReportSchema = z.object({
         description: "Head-and-tail excerpt of the failing output, cut on line boundaries. Event only, never persisted.",
     }),
 });
+export const DeployFixNotRequestedReasonSchema = z.enum([
+    "no-branch",
+    "send-failed",
+    "error",
+]);
 export const DeployFailureSchema = z.object({
     stage: DeployFailureStageSchema.optional(),
     owner: DeployFailureOwnerSchema,
@@ -1509,6 +1519,9 @@ export const DeployFailureSchema = z.object({
     fixRequested: z.boolean().optional().meta({
         description: "Whether a Fusion agent fix was dispatched for this failure.",
     }),
+    fixNotRequestedReason: DeployFixNotRequestedReasonSchema.optional().meta({
+        description: "Why a fix this failure qualified for was not dispatched. Absent when the failure never qualified.",
+    }),
 });
 export const DeploySchema = z.object({
     id: z.string(),
@@ -2093,6 +2106,7 @@ export const HostingDomainSchema = z.object({
         description: "Per-verify-attempt nonce, set on entering `verifying`. Delegation-check polls whose attemptId no longer matches are stale (a newer retry superseded them) and stop early.",
     }),
     verifiedAt: z.number().optional(),
+    verifiedBy: z.string().optional(),
     error: z.string().optional(),
     failedStep: z.enum(["dns", "https"]).optional().meta({
         description: "Which setup step failed, set alongside `status: failed` so the UI can attribute the failure. `dns` = delegation verification, `https` = cert/route provisioning.",
@@ -2106,6 +2120,16 @@ export const HostingDomainSchema = z.object({
     servingConfirmedAt: z.number().optional().meta({
         description: "When the domain was confirmed serving over HTTPS: stamped by the serving-check loop once `https://<domain>/` answers over TLS through a Builder route (or by a healthy route recreate on deploy/repair on an `active` domain). Definitive 'serving confirmed' signal for the UI's third setup step, distinct from cert issuance (`status: active`). Never set while `provisioning`.",
     }),
+    servingProbeConfirmedAt: z.number().optional(),
+    servingProbeTimedOutAt: z.number().optional(),
+    servingProbeAmbiguousAt: z.number().optional(),
+    certTeardownStartedAt: z.number().optional(),
+    certTeardownReason: z.string().optional(),
+    removalStartedAt: z.number().optional(),
+    promotionInProgressAttemptId: z.string().optional(),
+    promotionInProgressCount: z.number().optional(),
+    promotionStartedAt: z.number().optional(),
+    promotionEpoch: z.string().optional(),
     certIssue: z.string().optional().meta({
         description: "Non-fatal, user-facing reason Google's latest certificate domain-authorization attempt failed while the domain is `provisioning` (e.g. the `_acme-challenge` CNAME wasn't found). Google keeps retrying, so `status` stays `provisioning`; this drives a warning on the HTTPS step instead of a silent spinner. Cleared when an attempt stops failing or the cert is issued.",
     }),