@builder.io/ai-utils 0.70.0 → 0.71.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.70.0",
+  "version": "0.71.1",
   "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<{
@@ -1908,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<{
@@ -1930,6 +1933,7 @@ export declare const CodeGenToolsSchema: z.ZodEnum<{
     ExitPlanMode: "ExitPlanMode";
     ExplorationMetadata: "ExplorationMetadata";
     FindMedia: "FindMedia";
+    GenerateDesignSystemAgentMd: "GenerateDesignSystemAgentMd";
     GetAvailableRepos: "GetAvailableRepos";
     GetLastBrowserTest: "GetLastBrowserTest";
     GetScreenshot: "GetScreenshot";
@@ -2646,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/AGENTS.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.",
@@ -1489,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
@@ -42,7 +44,7 @@ export interface GenerateDesignSystemRequest extends GenerateDesignSystemFormFie
 export interface GenerateDesignSystemResponse {
     projectId: string;
     /**
-     * Decode job id. The .fig file is decoded asynchronously in the
+     * Decode job id. Attachments are processed asynchronously in the
      * `ai-queue-subscribers` worker. Clients should listen on the
      * `figmaDecodeJobs/{jobId}` Firestore document for progress and the
      * resolved `branchName` / `branchUrl`.
@@ -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;