@builder.io/ai-utils 0.107.0 → 0.108.0

package/package.json

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

package/src/codegen.d.ts

@@ -140,6 +140,7 @@ export declare const GlobSearchToolInputSchema: z.ZodObject<{
 export type GlobSearchToolInput = z.infer<typeof GlobSearchToolInputSchema>;
 export declare const GrepSearchToolInputSchema: z.ZodObject<{
     query: z.ZodString;
+    node_modules_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     include_glob: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     exclude_glob: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     case_sensitive: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
@@ -1515,6 +1516,7 @@ export declare const CodeGenToolMapSchema: z.ZodObject<{
     }, z.core.$strip>;
     Grep: z.ZodObject<{
         query: z.ZodString;
+        node_modules_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         include_glob: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         exclude_glob: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         case_sensitive: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

package/src/codegen.js

@@ -143,7 +143,9 @@ export function readToolImageMediaType(filePath) {
 }
 export const GlobSearchToolInputSchema = z
     .object({
-    pattern: z.string().meta({ description: "The pattern to search for" }),
+    pattern: z.string().meta({
+        description: "The pattern to search for. node_modules and dist folders are skipped unless the pattern starts with a path inside node_modules (e.g. 'node_modules/@tabler/icons-react/**/*.d.ts').",
+    }),
 })
     .meta({ title: "GlobSearchToolInput" });
 export const GrepSearchToolInputSchema = z
@@ -151,6 +153,9 @@ export const GrepSearchToolInputSchema = z
     query: z.string().meta({
         description: 'A string literal or a JavaScript-flavored regex to search for in all project files. Only escape special characters such as {} and () in string literals to avoid confusion with regex patterns (e.g. "import \\{ foo \\}"). Avoid over-escaping as that will cause errors. Do NOT use inline regex flags like (?i) or (?s) — they are not supported. The search is case-insensitive by default; use the case_sensitive parameter to control this.',
     }),
+    node_modules_path: z.string().nullish().meta({
+        description: "Searches an installed package instead of the project. node_modules and dist folders are skipped by default; set this to a directory or file inside node_modules (e.g. 'node_modules/@tabler/icons-react') to search that package, including its dist folder and .d.ts files.",
+    }),
     include_glob: z.string().nullish().meta({
         description: "An optional single glob pattern to include only specific files (e.g. '**/*.(ts|tsx)' for all TypeScript files)",
     }),

package/src/projects.d.ts

@@ -472,7 +472,13 @@ export declare const ProjectSkillSchema: z.ZodUnion<readonly [z.ZodObject<{
     url: z.ZodString;
 }, z.core.$strip>]>;
 export type ProjectSkill = z.infer<typeof ProjectSkillSchema>;
-export type FusionExecutionEnvironment = "containerized" | "container-less" | "cloud" | "cloud-v2";
+export declare const FusionExecutionEnvironmentSchema: z.ZodEnum<{
+    cloud: "cloud";
+    "cloud-v2": "cloud-v2";
+    "container-less": "container-less";
+    containerized: "containerized";
+}>;
+export type FusionExecutionEnvironment = z.infer<typeof FusionExecutionEnvironmentSchema>;
 export type AgentType = "setup-project" | "project-configuration" | "org-agent" | "code-review-orchestrator" | "design-system-indexer" | "repo-indexer" | "builder-publish-integration";
 export interface PartialBranchData {
     name?: string;
@@ -725,6 +731,19 @@ export interface NewBranch extends BranchSharedData, RequiredBranchSharedData {
  */
 export type Branch = NewBranch | LegacyBranch;
 export declare const checkIsNewBranch: (branch: Branch) => branch is NewBranch;
+/** Identifies a single branch by its project and branch name. */
+export declare const BranchIdentifierSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    branchName: z.ZodString;
+}, z.core.$strip>;
+export type BranchIdentifier = z.infer<typeof BranchIdentifierSchema>;
+/** Query params for `DELETE /projects/branches`. */
+export declare const DeleteBranchOptionsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    branchName: z.ZodString;
+    hard: z.ZodDefault<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
+}, z.core.$strip>;
+export type DeleteBranchOptions = z.input<typeof DeleteBranchOptionsSchema>;
 /**
  * Request options for `GET /projects/branches/list`. Owner/org scope comes from
  * the authenticated request context; `ownerId` here is a superuser-only override.
@@ -829,6 +848,11 @@ export declare const ShapeOptionSchema: z.ZodObject<{
             designSystemName: z.ZodString;
         }, z.core.$strip>], "kind">>>;
     }, z.core.$strip>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        delegate: "delegate";
+        "figma-link": "figma-link";
+        upload: "upload";
+    }>>;
 }, z.core.$strip>;
 export type ShapeOption = z.infer<typeof ShapeOptionSchema>;
 export declare const ShapeQuestionSchema: z.ZodObject<{
@@ -853,14 +877,32 @@ export declare const ShapeQuestionSchema: z.ZodObject<{
                 designSystemName: z.ZodString;
             }, z.core.$strip>], "kind">>>;
         }, z.core.$strip>>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            delegate: "delegate";
+            "figma-link": "figma-link";
+            upload: "upload";
+        }>>;
     }, z.core.$strip>>;
     guessOptionId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ShapeQuestion = z.infer<typeof ShapeQuestionSchema>;
+/**
+ * The link in canonical form, or undefined when it is not an https link to a
+ * file on figma.com. Deliberately strict: the result is written into the
+ * user's repo and handed to the agent as a requirement.
+ */
+export declare function parseFigmaFileUrl(value: string): string | undefined;
+/**
+ * The first Figma file link in `text`, canonicalized by `parseFigmaFileUrl`.
+ * Bare and `http:` mentions count as https; trailing punctuation is dropped.
+ */
+export declare function findFigmaFileUrl(text: string): string | undefined;
+export declare function mentionsFigmaFileUrl(text: string): boolean;
 export declare const ShapeAnswerSchema: z.ZodObject<{
     questionId: z.ZodString;
     optionId: z.ZodOptional<z.ZodString>;
     designSystemId: z.ZodOptional<z.ZodString>;
+    figmaUrl: z.ZodOptional<z.ZodString>;
     designSystemName: z.ZodOptional<z.ZodString>;
     skipped: z.ZodBoolean;
     delegated: z.ZodBoolean;
@@ -878,6 +920,7 @@ export declare const ShapeAnswerInputSchema: z.ZodObject<{
     questionId: z.ZodString;
     optionId: z.ZodOptional<z.ZodString>;
     designSystemId: z.ZodOptional<z.ZodString>;
+    figmaUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ShapeAnswerInput = z.infer<typeof ShapeAnswerInputSchema>;
 export declare const GetShapeQuestionnaireOptionsSchema: z.ZodObject<{
@@ -893,6 +936,7 @@ export declare const SubmitShapeAnswersOptionsSchema: z.ZodObject<{
         questionId: z.ZodString;
         optionId: z.ZodOptional<z.ZodString>;
         designSystemId: z.ZodOptional<z.ZodString>;
+        figmaUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type SubmitShapeAnswersOptions = z.infer<typeof SubmitShapeAnswersOptionsSchema>;
@@ -968,6 +1012,11 @@ export declare const ShapeSessionSchema: z.ZodObject<{
                     designSystemName: z.ZodString;
                 }, z.core.$strip>], "kind">>>;
             }, z.core.$strip>>;
+            kind: z.ZodOptional<z.ZodEnum<{
+                delegate: "delegate";
+                "figma-link": "figma-link";
+                upload: "upload";
+            }>>;
         }, z.core.$strip>>;
         guessOptionId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
@@ -976,6 +1025,7 @@ export declare const ShapeSessionSchema: z.ZodObject<{
         questionId: z.ZodString;
         optionId: z.ZodOptional<z.ZodString>;
         designSystemId: z.ZodOptional<z.ZodString>;
+        figmaUrl: z.ZodOptional<z.ZodString>;
         designSystemName: z.ZodOptional<z.ZodString>;
         skipped: z.ZodBoolean;
         delegated: z.ZodBoolean;
@@ -1041,6 +1091,11 @@ export declare const ShapeSessionDocSchema: z.ZodObject<{
                     designSystemName: z.ZodString;
                 }, z.core.$strip>], "kind">>>;
             }, z.core.$strip>>;
+            kind: z.ZodOptional<z.ZodEnum<{
+                delegate: "delegate";
+                "figma-link": "figma-link";
+                upload: "upload";
+            }>>;
         }, z.core.$strip>>;
         guessOptionId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
@@ -1049,6 +1104,7 @@ export declare const ShapeSessionDocSchema: z.ZodObject<{
         questionId: z.ZodString;
         optionId: z.ZodOptional<z.ZodString>;
         designSystemId: z.ZodOptional<z.ZodString>;
+        figmaUrl: z.ZodOptional<z.ZodString>;
         designSystemName: z.ZodOptional<z.ZodString>;
         skipped: z.ZodBoolean;
         delegated: z.ZodBoolean;
@@ -3936,6 +3992,24 @@ export declare const EnsureMainBranchExistsOptionsSchema: z.ZodObject<{
     branchName: z.ZodString;
 }, z.core.$strip>;
 export type EnsureMainBranchExistsOptions = z.infer<typeof EnsureMainBranchExistsOptionsSchema>;
+/** Request body for `POST /projects/ensure-fusion-config`. */
+export declare const EnsureFusionConfigParamsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    branchName: z.ZodString;
+    includeBackupMetadata: z.ZodOptional<z.ZodBoolean>;
+    volumeMountPath: z.ZodOptional<z.ZodString>;
+    isLocal: z.ZodOptional<z.ZodBoolean>;
+    nativeApp: z.ZodOptional<z.ZodBoolean>;
+    miseLocationPath: z.ZodOptional<z.ZodString>;
+    _useNI: z.ZodOptional<z.ZodBoolean>;
+    fusionEnvironment: z.ZodOptional<z.ZodEnum<{
+        cloud: "cloud";
+        "cloud-v2": "cloud-v2";
+        "container-less": "container-less";
+        containerized: "containerized";
+    }>>;
+}, z.core.$strip>;
+export type EnsureFusionConfigParams = z.infer<typeof EnsureFusionConfigParamsSchema>;
 /**
  * `settings.environmentVariables` is stored with **plaintext** secret values;
  * secrets are masked before this shape leaves ai-services, same as

package/src/projects.js

@@ -200,9 +200,27 @@ export const ProjectSkillSchema = z
     ProjectSkillUrlSchema,
 ])
     .meta({ title: "ProjectSkill" });
+export const FusionExecutionEnvironmentSchema = z.enum([
+    "containerized",
+    "container-less",
+    "cloud",
+    "cloud-v2",
+]);
 export const checkIsNewBranch = (branch) => {
     return "projectId" in branch;
 };
+/** Identifies a single branch by its project and branch name. */
+export const BranchIdentifierSchema = z.object({
+    projectId: z.string().min(1),
+    branchName: z.string().min(1),
+});
+/** Query params for `DELETE /projects/branches`. */
+export const DeleteBranchOptionsSchema = z.object({
+    ...BranchIdentifierSchema.shape,
+    hard: z.stringbool().default(false).meta({
+        description: 'Permanently delete the branch instead of soft-deleting it ("true" / "false").',
+    }),
+});
 /**
  * Request options for `GET /projects/branches/list`. Owner/org scope comes from
  * the authenticated request context; `ownerId` here is a superuser-only override.
@@ -310,6 +328,11 @@ export const ShapeOptionSchema = z.object({
     id: z.string(),
     label: z.string(),
     effect: ShapeOptionEffectSchema.optional(),
+    /**
+     * How the client renders an option that is not a plain choice. Absent means
+     * a choice when `effect` is set, delegation otherwise.
+     */
+    kind: z.enum(["upload", "delegate", "figma-link"]).optional(),
 });
 export const ShapeQuestionSchema = z.object({
     id: z.string(),
@@ -318,10 +341,57 @@ export const ShapeQuestionSchema = z.object({
     options: z.array(ShapeOptionSchema),
     guessOptionId: z.string().optional(),
 });
+/** Figma paths that name a file, which is what the Builder Design tools read. */
+const FIGMA_FILE_PATH = /^\/(?:design|file|proto|board|slides|make)\/[A-Za-z0-9]+/;
+/**
+ * The link in canonical form, or undefined when it is not an https link to a
+ * file on figma.com. Deliberately strict: the result is written into the
+ * user's repo and handed to the agent as a requirement.
+ */
+export function parseFigmaFileUrl(value) {
+    let url;
+    try {
+        url = new URL(value.trim());
+    }
+    catch (_a) {
+        return undefined;
+    }
+    const isFigmaHost = url.hostname === "figma.com" || url.hostname === "www.figma.com";
+    if (url.protocol !== "https:" ||
+        !isFigmaHost ||
+        url.port ||
+        url.username ||
+        url.password ||
+        !FIGMA_FILE_PATH.test(url.pathname)) {
+        return undefined;
+    }
+    return url.href;
+}
+/**
+ * Lenient on purpose: users paste bare links, so any mention counts. Not one
+ * inside another URL's path or after an `@`, which would name a different host.
+ */
+const FIGMA_FILE_MENTION = /(?:^|[^a-z0-9.\/@-])(?:https?:\/\/)?((?:www\.)?figma\.com\/(?:design|file|proto|board|slides|make)\/[a-z0-9]+[^\s<>()[\]{}"'`]*)/i;
+/**
+ * The first Figma file link in `text`, canonicalized by `parseFigmaFileUrl`.
+ * Bare and `http:` mentions count as https; trailing punctuation is dropped.
+ */
+export function findFigmaFileUrl(text) {
+    var _a;
+    const mention = (_a = FIGMA_FILE_MENTION.exec(text)) === null || _a === void 0 ? void 0 : _a[1];
+    if (!mention)
+        return undefined;
+    return parseFigmaFileUrl(`https://${mention.replace(/[.,;:!?]+$/, "")}`);
+}
+export function mentionsFigmaFileUrl(text) {
+    return findFigmaFileUrl(text) !== undefined;
+}
 export const ShapeAnswerSchema = z.object({
     questionId: z.string(),
     optionId: z.string().optional(),
     designSystemId: z.string().optional(),
+    /** Set only for the Figma link option, canonicalized by `parseFigmaFileUrl`. */
+    figmaUrl: z.string().optional(),
     /**
      * Server-resolved from `designSystemId` against the caller's accessible
      * design systems. `settings.designSystems` is matched by name downstream, so
@@ -338,6 +408,7 @@ const ShapeAnswerInputBaseSchema = ShapeAnswerSchema.pick({
     questionId: true,
     optionId: true,
     designSystemId: true,
+    figmaUrl: true,
     skipped: true,
     delegated: true,
 });
@@ -354,6 +425,14 @@ export const ShapeAnswerInputSchema = z.object({
         .trim()
         .min(1)
         .optional(),
+    figmaUrl: ShapeAnswerInputBaseSchema.shape.figmaUrl
+        .unwrap()
+        .trim()
+        .max(2048)
+        .refine((value) => parseFigmaFileUrl(value) !== undefined, {
+        message: "Must be a link to a Figma file",
+    })
+        .optional(),
 });
 export const GetShapeQuestionnaireOptionsSchema = z.object({
     projectId: z.string().trim().min(1),
@@ -2214,6 +2293,32 @@ export const EnsureMainBranchExistsOptionsSchema = z.object({
         description: "Branch whose head ref seeds the main branch when it doesn't exist yet. No-op for non-internalHost projects.",
     }),
 });
+/** Request body for `POST /projects/ensure-fusion-config`. */
+export const EnsureFusionConfigParamsSchema = z.object({
+    projectId: z.string().min(1),
+    branchName: z.string().min(1),
+    includeBackupMetadata: z.boolean().optional().meta({
+        description: "Whether to include backup metadata in the fusion config. This involves checking backup data and generating download URLs. Defaults to false.",
+    }),
+    volumeMountPath: z.string().optional().meta({
+        description: 'Volume mount path for the container. Defaults to "/app" if not specified.',
+    }),
+    isLocal: z.boolean().optional().meta({
+        description: "Flag for local execution mode. When true, adjusts paths for local execution (e.g., ./workspace instead of /app/workspace).",
+    }),
+    nativeApp: z.boolean().optional().meta({
+        description: "Flag for native app projects. When true, adds nativeApp: true to fusion config.",
+    }),
+    miseLocationPath: z.string().optional().meta({
+        description: "Path to mise installation. Provided by client from desktop app system info.",
+    }),
+    _useNI: z.boolean().optional().meta({
+        description: "Flag to use NI for package management. When true, uses NI for package management. Defaults to true.",
+    }),
+    fusionEnvironment: FusionExecutionEnvironmentSchema.optional().meta({
+        description: "Fusion environment type override. When not provided, the environment is resolved from branch/project settings.",
+    }),
+});
 /**
  * `settings.environmentVariables` is stored with **plaintext** secret values;
  * secrets are masked before this shape leaves ai-services, same as

package/src/projects.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/src/projects.spec.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from "vitest";
+import { DeleteBranchOptionsSchema, EnsureFusionConfigParamsSchema, } from "./projects.js";
+describe("DeleteBranchOptionsSchema", () => {
+    const ids = { projectId: "p1", branchName: "main" };
+    it("defaults hard to false", () => {
+        expect(DeleteBranchOptionsSchema.parse(ids)).toEqual({
+            ...ids,
+            hard: false,
+        });
+    });
+    it("parses hard from its query-string form", () => {
+        expect(DeleteBranchOptionsSchema.parse({ ...ids, hard: "true" }).hard).toBe(true);
+        expect(DeleteBranchOptionsSchema.parse({ ...ids, hard: "false" }).hard).toBe(false);
+    });
+    it("rejects a hard value that isn't a boolean string", () => {
+        expect(DeleteBranchOptionsSchema.safeParse({ ...ids, hard: "maybe" }).success).toBe(false);
+    });
+    it("requires a non-empty projectId and branchName", () => {
+        expect(DeleteBranchOptionsSchema.safeParse({}).success).toBe(false);
+        expect(DeleteBranchOptionsSchema.safeParse({ projectId: "", branchName: "main" })
+            .success).toBe(false);
+    });
+});
+describe("EnsureFusionConfigParamsSchema", () => {
+    const ids = { projectId: "p1", branchName: "main" };
+    it("accepts just the identifiers", () => {
+        expect(EnsureFusionConfigParamsSchema.parse(ids)).toEqual(ids);
+    });
+    it("requires a non-empty projectId and branchName", () => {
+        expect(EnsureFusionConfigParamsSchema.safeParse({ ...ids, projectId: "" })
+            .success).toBe(false);
+        expect(EnsureFusionConfigParamsSchema.safeParse({ projectId: "p1" }).success).toBe(false);
+    });
+    it("rejects an unknown fusionEnvironment", () => {
+        expect(EnsureFusionConfigParamsSchema.safeParse({
+            ...ids,
+            fusionEnvironment: "mainframe",
+        }).success).toBe(false);
+    });
+});

package/src/projects.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { AGENT_NATIVE_STARTER_REPO, getAgentNativeRootPackageJsonWriteError, getManagedDatabasePackageJsonError, getProjectState, GetShapeQuestionnaireOptionsSchema, InitialPromptSchema, isProjectDeleted, matchesAgentNativeStarter, ProjectHostingExternalSchema, ProjectHostingSchema, ProjectSettingsExternalSchema, ProjectTemplateOverridesSchema, ShapeSessionSchema, SubmitShapeAnswersOptionsSchema, } from "./projects";
+import { AGENT_NATIVE_STARTER_REPO, getAgentNativeRootPackageJsonWriteError, getManagedDatabasePackageJsonError, getProjectState, GetShapeQuestionnaireOptionsSchema, InitialPromptSchema, isProjectDeleted, matchesAgentNativeStarter, findFigmaFileUrl, mentionsFigmaFileUrl, parseFigmaFileUrl, ProjectHostingExternalSchema, ProjectHostingSchema, ProjectSettingsExternalSchema, 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" });
@@ -112,6 +112,92 @@ describe("guided onboarding project settings", () => {
             answers: [],
         })).toThrow();
     });
+    it("accepts a Figma file link on an answer and rejects anything else", () => {
+        var _a, _b;
+        const submit = (figmaUrl) => SubmitShapeAnswersOptionsSchema.safeParse({
+            projectId: "project-1",
+            questionnaireId: "questionnaire-1",
+            answers: [
+                {
+                    questionId: "visual-style",
+                    optionId: "figma-link",
+                    figmaUrl,
+                    skipped: false,
+                    delegated: false,
+                },
+            ],
+        });
+        expect((_b = (_a = submit(" https://www.figma.com/design/AbC123/App ").data) === null || _a === void 0 ? void 0 : _a.answers[0]) === null || _b === void 0 ? void 0 : _b.figmaUrl).toBe("https://www.figma.com/design/AbC123/App");
+        expect(submit("https://example.com/design/AbC123").success).toBe(false);
+        expect(submit("").success).toBe(false);
+    });
+});
+describe("parseFigmaFileUrl", () => {
+    it.each([
+        "https://www.figma.com/design/AbC123/My-App?node-id=1-2",
+        "https://figma.com/file/AbC123/Old-Style",
+        "  https://www.figma.com/proto/AbC123/Flow  ",
+    ])("accepts %s", (value) => {
+        expect(parseFigmaFileUrl(value)).toBe(new URL(value.trim()).href);
+    });
+    it.each([
+        "",
+        "not a url",
+        "http://www.figma.com/design/AbC123/My-App",
+        "https://evil.com/figma.com/design/AbC123",
+        "https://www.figma.com.evil.com/design/AbC123",
+        "https://www.figma.com/community/file/123",
+        "https://www.figma.com/design/",
+        "https://user:pass@www.figma.com/design/AbC123",
+        "https://www.figma.com:8443/design/AbC123",
+        "javascript:alert(1)",
+    ])("rejects %j", (value) => {
+        expect(parseFigmaFileUrl(value)).toBeUndefined();
+    });
+});
+describe("mentionsFigmaFileUrl", () => {
+    it.each([
+        "Build this https://www.figma.com/design/AbC123/My-App please",
+        "from figma.com/file/AbC123",
+        "(https://figma.com/proto/AbC123)",
+    ])("finds a link in %j", (text) => {
+        expect(mentionsFigmaFileUrl(text)).toBe(true);
+    });
+    it.each([
+        "Make it look like our Figma mockups",
+        "https://notfigma.com/design/AbC123",
+        "https://www.figma.com/community",
+        "https://evil.com/figma.com/design/AbC123",
+        "https://evil.com/?next=//figma.com/design/AbC123",
+        "user@figma.com/design/AbC123",
+    ])("finds nothing in %j", (text) => {
+        expect(mentionsFigmaFileUrl(text)).toBe(false);
+    });
+});
+describe("findFigmaFileUrl", () => {
+    it.each([
+        [
+            "Build this https://www.figma.com/design/AbC123/App?node-id=1-2.",
+            "https://www.figma.com/design/AbC123/App?node-id=1-2",
+        ],
+        [
+            "from figma.com/file/AbC123/Old, thanks",
+            "https://figma.com/file/AbC123/Old",
+        ],
+        [
+            "(http://www.figma.com/proto/AbC123/Flow)",
+            "https://www.figma.com/proto/AbC123/Flow",
+        ],
+        [
+            "first https://www.figma.com/design/One/A then https://www.figma.com/design/Two/B",
+            "https://www.figma.com/design/One/A",
+        ],
+    ])("reads the link out of %j", (text, expected) => {
+        expect(findFigmaFileUrl(text)).toBe(expected);
+    });
+    it("finds nothing without a file link", () => {
+        expect(findFigmaFileUrl("Make it like our Figma mockups")).toBeUndefined();
+    });
 });
 describe("matchesAgentNativeStarter", () => {
     it("matches when repoName is the starter", () => {