@builder.io/ai-utils 0.69.0 → 0.71.0

package/package.json

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

package/src/codegen.d.ts

@@ -221,6 +221,8 @@ export declare const DevServerControlInputSchema: z.ZodObject<{
 export type DevServerControlInput = z.infer<typeof DevServerControlInputSchema>;
 export declare const DevServerLogsInputSchema: z.ZodObject<{}, z.core.$strip>;
 export type DevServerLogsInput = z.infer<typeof DevServerLogsInputSchema>;
+export declare const GenerateDesignSystemAgentMdInputSchema: z.ZodObject<{}, z.core.$strip>;
+export type GenerateDesignSystemAgentMdInput = z.infer<typeof GenerateDesignSystemAgentMdInputSchema>;
 export declare const DevServerRestartInputSchema: z.ZodObject<{}, z.core.$strip>;
 export type DevServerRestartInput = z.infer<typeof DevServerRestartInputSchema>;
 export declare const BashToolInputSchema: z.ZodObject<{
@@ -486,6 +488,7 @@ export declare const TimelineEventCategorySchema: z.ZodEnum<{
     milestone: "milestone";
     navigation: "navigation";
     observation: "observation";
+    verified: "verified";
 }>;
 export type TimelineEventCategory = z.infer<typeof TimelineEventCategorySchema>;
 export declare const TestOutcomeSchema: z.ZodEnum<{
@@ -519,8 +522,10 @@ export declare const RecordFrameToolInputSchema: z.ZodObject<{
         milestone: "milestone";
         navigation: "navigation";
         observation: "observation";
+        verified: "verified";
     }>>;
     description: z.ZodOptional<z.ZodString>;
+    pr_highlight: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type RecordFrameToolInput = z.infer<typeof RecordFrameToolInputSchema>;
 export declare const ReportTestOutcomeToolInputSchema: z.ZodObject<{
@@ -580,6 +585,8 @@ export interface TimelineFrameMetadata {
     displayDurationMs: number;
     fileName?: string;
     image_url?: string;
+    prHighlight?: boolean;
+    description?: string;
     cursorX?: number | null;
     cursorY?: number | null;
     viewportWidth?: number;
@@ -1587,8 +1594,10 @@ export declare const CodeGenToolMapSchema: z.ZodObject<{
             milestone: "milestone";
             navigation: "navigation";
             observation: "observation";
+            verified: "verified";
         }>>;
         description: z.ZodOptional<z.ZodString>;
+        pr_highlight: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     SubmitPRReview: z.ZodObject<{
         summary: z.ZodString;
@@ -1901,6 +1910,7 @@ export declare const CodeGenToolMapSchema: z.ZodObject<{
         builder_user_id: z.ZodOptional<z.ZodString>;
         draft: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
+    GenerateDesignSystemAgentMd: z.ZodObject<{}, z.core.$strip>;
 }, z.core.$strip>;
 export type CodeGenToolMap = z.infer<typeof CodeGenToolMapSchema>;
 export declare const CodeGenToolsSchema: z.ZodEnum<{
@@ -1923,6 +1933,7 @@ export declare const CodeGenToolsSchema: z.ZodEnum<{
     ExitPlanMode: "ExitPlanMode";
     ExplorationMetadata: "ExplorationMetadata";
     FindMedia: "FindMedia";
+    GenerateDesignSystemAgentMd: "GenerateDesignSystemAgentMd";
     GetAvailableRepos: "GetAvailableRepos";
     GetLastBrowserTest: "GetLastBrowserTest";
     GetScreenshot: "GetScreenshot";
@@ -2639,6 +2650,7 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
         ExitPlanMode: "ExitPlanMode";
         ExplorationMetadata: "ExplorationMetadata";
         FindMedia: "FindMedia";
+        GenerateDesignSystemAgentMd: "GenerateDesignSystemAgentMd";
         GetAvailableRepos: "GetAvailableRepos";
         GetLastBrowserTest: "GetLastBrowserTest";
         GetScreenshot: "GetScreenshot";

package/src/codegen.js

@@ -190,6 +190,15 @@ export const DevServerControlInputSchema = z
 export const DevServerLogsInputSchema = z
     .object({})
     .meta({ title: "DevServerLogsInput" });
+export const GenerateDesignSystemAgentMdInputSchema = z.object({}).meta({
+    title: "GenerateDesignSystemAgentMdInput",
+    description: "Generates and writes `.builder/output/AGENT.md` from the token and component" +
+        " CSS files produced during DSI approximation indexing. Reads" +
+        " `.builder/sources/figma/manifest.json` for the design system name," +
+        " `.builder/output/_index/tokens-report.json` for token categories, and" +
+        " globs `.builder/output/tokens/components/*.css` for component slugs." +
+        " Call this as the final step after all CSS files have been written.",
+});
 export const DevServerRestartInputSchema = z.object({}).meta({
     title: "DevServerRestartInput",
     description: "Restarts the dev server with current configuration.",
@@ -609,6 +618,7 @@ export const TimelineEventCategorySchema = z
     "milestone",
     "code-change",
     "observation",
+    "verified",
 ])
     .meta({ title: "TimelineEventCategory" });
 export const TestOutcomeSchema = z
@@ -642,6 +652,9 @@ export const RecordFrameToolInputSchema = z
     description: z.string().optional().meta({
         description: "Optional longer description providing context about what this frame shows.",
     }),
+    pr_highlight: z.boolean().optional().meta({
+        description: "Set true to mark this as a 'verified screenshot' worth showing in the PR description — i.e. visual proof of how the fix/feature behaves. Use sparingly (1–3 per session) for the key moments that demonstrate the feature working. The title is used as the caption.",
+    }),
 })
     .meta({ title: "RecordFrameToolInput" });
 export const ReportTestOutcomeToolInputSchema = z
@@ -1485,6 +1498,7 @@ export const CodeGenToolMapSchema = z.object({
     PullPrototype: PullPrototypeToolInputSchema,
     ConnectMCP: ConnectMCPToolInputSchema,
     EnsurePR: EnsurePRToolInputSchema,
+    GenerateDesignSystemAgentMd: GenerateDesignSystemAgentMdInputSchema,
 });
 export const CodeGenToolsSchema = CodeGenToolMapSchema.keyof().meta({
     title: "CodeGenTools",

package/src/design-systems.d.ts

@@ -25,6 +25,8 @@ export interface GenerateDesignSystemFormFields {
      */
     selection?: Record<string, string[]>;
     githubRepoUrl?: string;
+    /** Id of a connected Fusion project whose repo is cloned as supplementary context. Takes precedence over `githubRepoUrl`. */
+    connectedProjectId?: string;
 }
 /**
  * Accepts `https://github.com/<owner>/<repo>` (optionally with a trailing
@@ -68,5 +70,6 @@ export declare const generateDesignSystemBodySchema: z.ZodObject<{
     devToolsVersion: z.ZodOptional<z.ZodString>;
     selection: z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
     githubRepoUrl: z.ZodOptional<z.ZodString>;
+    connectedProjectId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type GenerateDesignSystemBody = z.infer<typeof generateDesignSystemBodySchema>;

package/src/design-systems.js

@@ -38,4 +38,5 @@ export const generateDesignSystemBodySchema = z.object({
         .trim()
         .regex(GITHUB_REPO_URL_REGEX, "must be a public github.com repo URL")
         .optional(),
+    connectedProjectId: z.string().trim().min(1).max(128).optional(),
 });

package/src/events.d.ts

@@ -1058,6 +1058,8 @@ export type FigmaDecodeJobV1 = FusionEventVariant<"figma.decode.job", {
      * `.builder/sources/<repo>/` at hydration time.
      */
     githubRepoUrl?: string;
+    /** Id of a connected Fusion project whose repo is cloned at hydration time. Takes precedence over `githubRepoUrl`. */
+    connectedProjectId?: string;
     devToolsVersion?: string;
     /**
      * Optional map of `.fig` filename → page/frame GUID keys
@@ -1087,6 +1089,10 @@ export interface FigmaDecodeJobDoc {
     branchName: string | null;
     branchUrl: string | null;
     error: string | null;
+    /** Worker failure count; the handler retries while this is under the cap. */
+    attempts?: number;
+    /** True if any frame chunk upload failed but the job still completed. */
+    partialFailure?: boolean;
     createdAt: number;
     updatedAt: number;
 }
@@ -1096,6 +1102,8 @@ export interface FigmaFrameManifestEntry {
     htmlGcsPath: string;
     screenshotGcsPath: string | null;
     htmlSizeBytes: number;
+    /** True if this frame's HTML upload failed after retry; HTML may be missing. */
+    uploadError?: boolean;
 }
 export interface FigmaFrameAsset {
     /** Bucket-relative GCS path. */
@@ -1116,9 +1124,16 @@ export interface FigmaTextSource {
     sizeBytes: number;
 }
 export interface FigmaGithubRepoSource {
+    /** Clone URL. For connected repos, an authenticated URL is swapped in at hydration time; no token is persisted. */
     url: string;
     /** Directory name under `.builder/sources/` to clone into. */
     localDir: string;
+    /** Set for connected Fusion projects; used at hydration to mint an authenticated clone URL. */
+    connectedProjectId?: string;
+    /** Git provider of a connected repo (e.g. "github", "gitlab"). */
+    provider?: string;
+    /** "owner/repo" of a connected repo. */
+    repoFullName?: string;
 }
 export interface FigmaFrameManifest {
     jobId: string;
@@ -1128,8 +1143,10 @@ export interface FigmaFrameManifest {
     assets?: FigmaFrameAsset[];
     /** Uploaded plain-text / markdown supplementary sources. */
     textSources?: FigmaTextSource[];
-    /** Optional public GitHub repo to clone as supplementary context. */
+    /** Optional public or connected repo to clone as supplementary context. */
     githubRepo?: FigmaGithubRepoSource;
+    /** True if one or more frame chunk uploads failed; some frames may be missing. */
+    partialFailure?: boolean;
 }
 export type PrReviewRequestedV1 = FusionEventVariant<"pr.review.requested", {
     repoFullName: string;

package/src/projects.d.ts

@@ -880,6 +880,8 @@ export interface ProjectDatabase {
     role: string;
     /** @internal Plaintext credential — Firestore IAM enforces access. Never serialize to client responses. */
     password: string;
+    /** Database name (white-labeled to "main"); needed to build connection URIs. */
+    database: string;
     region: string;
     createdAt: number;
     createdBy: string;