rivet-design 0.23.1 → 0.24.0

package/dist/services/profiles/DesignProfiles.d.ts

@@ -5,10 +5,27 @@ import { IntegrationsClient } from '../IntegrationsClient';
 import { type ProfileContext as RecordedContext } from '../../types/design-profile';
 import type { TelemetryService } from '../TelemetryService';
 import { type GuidanceUpload, type GuidanceUploadUpdate, type GuidanceSelection } from '../../types/guidance';
-import type { DesignLibrarySnapshot, DesignReferenceRequest, DesignReferenceSearchRequest, DesignReferenceSearchResult } from '../../types/design-library';
+import type { DesignLibrarySnapshot, DesignLibrarySource, DesignReferenceRequest, DesignReferenceSearchRequest, DesignReferenceSearchResult } from '../../types/design-library';
 import { type ReferencePlanRequest, type ReferenceOnboardingAction } from '../../types/reference-onboarding';
-import type { ProfileVariants } from './ProfileVariants';
+import { ProfileVariants } from './ProfileVariants';
 import { type ProfileVariantInput, type ProfileRuntime, type ProfilePreparationRequest as PreparationInput } from '../../types/design-profile';
+interface SavedReferenceInput {
+    title: string;
+    source: {
+        kind: 'text';
+        text: string;
+    } | {
+        kind: 'images';
+        files: string[];
+    } | {
+        kind: 'saved_direction';
+        projectId: string;
+        sessionId: string;
+        variantId: string;
+        imageFile: string;
+        note?: string;
+    };
+}
 interface DesignProfilesOptions {
     referenceConnectors?: ReferenceConnectorClient;
     referenceIntegrations?: Pick<IntegrationsClient, 'discoverCosmos' | 'fetchCosmos'>;
@@ -25,18 +42,222 @@ export declare class DesignProfiles {
     private current?;
     private opening;
     constructor(options: DesignProfilesOptions);
+    readDesignContext(input: {
+        includeChecks?: boolean;
+        includeDisabled?: boolean;
+        importPlanId?: string;
+        instructionIds?: string[];
+        referenceSelection?: {
+            profileId: string;
+            keys: string[];
+        };
+    }): Promise<{
+        profileId: null;
+        instructions: never[];
+        references: never[];
+    } | {
+        importPlan?: {
+            coverageBasis: "retained_job_references";
+            jobs: {
+                coverage: {
+                    references: number;
+                    downloaded: number;
+                    unsupported: number;
+                    failed: number;
+                    analyzed: number;
+                    indexed: number;
+                    pendingIndex: number;
+                };
+                failures: {
+                    jobId: string;
+                    referenceId: string;
+                    revision: number;
+                    stage: "download" | "analysis";
+                    error: string;
+                    attempts: number;
+                    updatedAt: string;
+                }[];
+                retryAt: string | null;
+                isEnumerated: boolean;
+                id: string;
+                sourceId: string;
+                runtime: "claude" | "codex" | "cursor";
+                state: "pending" | "failed" | "superseded" | "complete" | "paused";
+                cursor: string | null;
+                enumerated: number;
+                total: number | null;
+                error: string | null;
+                updatedAt: string;
+            }[];
+            id: string;
+            revision: string;
+            discoveryId: string;
+            profile: {
+                url: string;
+                title: string;
+                id: string;
+                username: string;
+            };
+            provider: "pinterest" | "arena" | "cosmos" | "x";
+            runtime: "claude" | "codex" | "cursor";
+            createdAt: string;
+            expiresAt: string;
+            approvedAt: string | null;
+            jobIds: string[];
+            collections: {
+                includedCollectionIds: string[];
+                referenceCount: number;
+                description: string | null;
+                url: string | null;
+                title: string;
+                id: string;
+                children: string[];
+                total: number | null;
+                parentId: string | null;
+            }[];
+            collectionCount: number;
+            referenceCount: number;
+            imageCount: number;
+            reusableCount: number;
+            analysisCount: number;
+            tokenEstimate: null;
+            durationEstimateMs: null;
+            scopeDisclosure: string;
+            unsupportedCount: number;
+            usageDisclosure: string;
+            approvalRequired: boolean;
+        } | undefined;
+        profileId: string;
+        instructions: {
+            verifier?: {
+                isStale: boolean;
+            } | {
+                package?: {
+                    runtime: "node";
+                    entrypoint: string;
+                    fileNames: string[];
+                } | undefined;
+                markdown: string;
+                sourceDigest: string;
+                isStale: boolean;
+            } | undefined;
+            sourceDigest: string;
+            title: string;
+            id: string;
+            markdown: string;
+            isEnabled: boolean;
+            attachments?: {
+                path: string;
+                source: string;
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
+                bytes: number;
+                representation: "variant" | "image" | "video-cover" | "page";
+                alt: string;
+                title?: string | undefined;
+                page?: number | undefined;
+            }[] | undefined;
+            references?: ({
+                path: string;
+                kind: "directory";
+                intent: string;
+            } | {
+                url: string;
+                kind: "url" | "repository";
+                intent: string;
+                digest?: string | undefined;
+                revision?: string | undefined;
+                files?: {
+                    name: string;
+                    content: string;
+                    path?: string | undefined;
+                    sha256?: string | undefined;
+                }[] | undefined;
+            })[] | undefined;
+        }[];
+        references: {
+            key: string;
+            title: string;
+            imageCount: number;
+            hasAnalysis: boolean;
+        }[];
+    }>;
+    private importPlanReceipt;
+    searchSavedReferences(input: {
+        query: string;
+        sourceId?: string;
+        limit?: number;
+    }): Promise<{
+        profileId: null;
+        query: string;
+        searchMode: "saved_text";
+        coverage: {
+            saved: number;
+            analyzed: number;
+            indexed: number;
+        };
+        results: never[];
+    } | {
+        searchMode: "saved_text";
+        profileId: string;
+        query: string;
+        coverage: {
+            saved: number;
+            analyzed: number;
+            indexed: number;
+        };
+        results: Array<{
+            id: string;
+            key: string;
+            title: string;
+            provider: import("../../types/design-profile").ProfileProvider;
+            url?: string;
+            description: string | null;
+            imageCount: number;
+            sources: DesignLibrarySource[];
+            isIncluded: boolean;
+        }>;
+    }>;
+    saveReference(input: SavedReferenceInput): Promise<{
+        analysis: "not_requested";
+        source: {
+            id: string;
+            provider: "variant" | "text" | "pinterest" | "arena" | "cosmos" | "x" | "image" | "pdf";
+            remoteId: string;
+            resolvedRemoteId: string | null;
+            title: string;
+            url: string | null;
+            isIncluded: boolean;
+            removedAt: string | null;
+        };
+        references: import("../../types/design-profile").ProfileReference[];
+        profileId: string;
+    }>;
+    private suppliedReferenceInput;
+    removeReference(input: {
+        profileId: string;
+        referenceId: string;
+    }): Promise<{
+        profileId: string;
+        referenceId: string;
+        isRemoved: boolean;
+    }>;
+    private withReadOnlyRecords;
     listGuidance(expectedAccountId?: string): Promise<{
         title: string;
         id: string;
         markdown: string;
         isEnabled: boolean;
+        verifier?: {
+            isStale: boolean;
+        } | undefined;
         attachments?: {
             path: string;
+            source: string;
             hash: string;
             mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
             bytes: number;
             representation: "variant" | "image" | "video-cover" | "page";
-            source: string;
             alt: string;
             title?: string | undefined;
             page?: number | undefined;
@@ -49,31 +270,31 @@ export declare class DesignProfiles {
             url: string;
             kind: "url" | "repository";
             intent: string;
+            digest?: string | undefined;
+            revision?: string | undefined;
             files?: {
                 name: string;
                 content: string;
                 path?: string | undefined;
                 sha256?: string | undefined;
             }[] | undefined;
-            digest?: string | undefined;
-            revision?: string | undefined;
         })[] | undefined;
-        verifier?: {
-            isStale: boolean;
-        } | undefined;
     }[]>;
     getGuidance(id: string, expectedAccountId?: string): Promise<{
         title: string;
         id: string;
         markdown: string;
         isEnabled: boolean;
+        verifier?: {
+            isStale: boolean;
+        } | undefined;
         attachments?: {
             path: string;
+            source: string;
             hash: string;
             mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
             bytes: number;
             representation: "variant" | "image" | "video-cover" | "page";
-            source: string;
             alt: string;
             title?: string | undefined;
             page?: number | undefined;
@@ -86,18 +307,15 @@ export declare class DesignProfiles {
             url: string;
             kind: "url" | "repository";
             intent: string;
+            digest?: string | undefined;
+            revision?: string | undefined;
             files?: {
                 name: string;
                 content: string;
                 path?: string | undefined;
                 sha256?: string | undefined;
             }[] | undefined;
-            digest?: string | undefined;
-            revision?: string | undefined;
         })[] | undefined;
-        verifier?: {
-            isStale: boolean;
-        } | undefined;
     }>;
     addGuidance(input: GuidanceUpload, expectedAccountId?: string): Promise<{
         guidanceWarning?: {
@@ -110,13 +328,16 @@ export declare class DesignProfiles {
         id: string;
         markdown: string;
         isEnabled: boolean;
+        verifier?: {
+            isStale: boolean;
+        } | undefined;
         attachments?: {
             path: string;
+            source: string;
             hash: string;
             mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
             bytes: number;
             representation: "variant" | "image" | "video-cover" | "page";
-            source: string;
             alt: string;
             title?: string | undefined;
             page?: number | undefined;
@@ -129,18 +350,15 @@ export declare class DesignProfiles {
             url: string;
             kind: "url" | "repository";
             intent: string;
+            digest?: string | undefined;
+            revision?: string | undefined;
             files?: {
                 name: string;
                 content: string;
                 path?: string | undefined;
                 sha256?: string | undefined;
             }[] | undefined;
-            digest?: string | undefined;
-            revision?: string | undefined;
         })[] | undefined;
-        verifier?: {
-            isStale: boolean;
-        } | undefined;
     }>;
     updateGuidance(input: GuidanceUploadUpdate & {
         id: string;
@@ -155,13 +373,16 @@ export declare class DesignProfiles {
         id: string;
         markdown: string;
         isEnabled: boolean;
+        verifier?: {
+            isStale: boolean;
+        } | undefined;
         attachments?: {
             path: string;
+            source: string;
             hash: string;
             mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
             bytes: number;
             representation: "variant" | "image" | "video-cover" | "page";
-            source: string;
             alt: string;
             title?: string | undefined;
             page?: number | undefined;
@@ -174,18 +395,15 @@ export declare class DesignProfiles {
             url: string;
             kind: "url" | "repository";
             intent: string;
+            digest?: string | undefined;
+            revision?: string | undefined;
             files?: {
                 name: string;
                 content: string;
                 path?: string | undefined;
                 sha256?: string | undefined;
             }[] | undefined;
-            digest?: string | undefined;
-            revision?: string | undefined;
         })[] | undefined;
-        verifier?: {
-            isStale: boolean;
-        } | undefined;
     }>;
     removeGuidance(id: string, expectedAccountId?: string): Promise<void>;
     private importGuidanceImages;
@@ -203,11 +421,11 @@ export declare class DesignProfiles {
             markdown: string;
             attachments?: {
                 path: string;
+                source: string;
                 hash: string;
                 mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
                 bytes: number;
                 representation: "variant" | "image" | "video-cover" | "page";
-                source: string;
                 alt: string;
                 title?: string | undefined;
                 page?: number | undefined;
@@ -220,14 +438,14 @@ export declare class DesignProfiles {
                 url: string;
                 kind: "url" | "repository";
                 intent: string;
+                digest?: string | undefined;
+                revision?: string | undefined;
                 files?: {
                     name: string;
                     content: string;
                     path?: string | undefined;
                     sha256?: string | undefined;
                 }[] | undefined;
-                digest?: string | undefined;
-                revision?: string | undefined;
             })[] | undefined;
         }[];
     }>;
@@ -235,17 +453,18 @@ export declare class DesignProfiles {
     private materializeGuidance;
     private guidanceAccount;
     private withGuidanceRecords;
-    discoverReferences({ signal, ...input }: ReferenceDiscoveryRequest & {
+    discoverReferences({ isAuthorizationAllowed, signal, ...input }: ReferenceDiscoveryRequest & {
         signal?: AbortSignal;
+        isAuthorizationAllowed?: boolean;
     }): Promise<{
-        provider: "arena" | "pinterest" | "x" | "cosmos";
+        provider: "pinterest" | "arena" | "cosmos" | "x";
         scopeDisclosure: string;
         id: string;
         total: number;
         collections: {
+            description: string | null;
             url: string | null;
             title: string;
-            description: string | null;
             id: string;
             children: string[];
             total: number | null;
@@ -263,7 +482,7 @@ export declare class DesignProfiles {
         message?: undefined;
     } | {
         status: "authorization_required";
-        provider: "arena" | "pinterest" | "x";
+        provider: "pinterest" | "arena" | "x";
         authUrl: string;
         message: string;
     }>;
@@ -277,7 +496,7 @@ export declare class DesignProfiles {
             id: string;
             username: string;
         };
-        provider: "arena" | "pinterest" | "x" | "cosmos";
+        provider: "pinterest" | "arena" | "cosmos" | "x";
         runtime: "claude" | "codex" | "cursor";
         createdAt: string;
         expiresAt: string;
@@ -286,9 +505,9 @@ export declare class DesignProfiles {
         collections: {
             includedCollectionIds: string[];
             referenceCount: number;
+            description: string | null;
             url: string | null;
             title: string;
-            description: string | null;
             id: string;
             children: string[];
             total: number | null;
@@ -316,7 +535,7 @@ export declare class DesignProfiles {
             id: string;
             username: string;
         };
-        provider: "arena" | "pinterest" | "x" | "cosmos";
+        provider: "pinterest" | "arena" | "cosmos" | "x";
         runtime: "claude" | "codex" | "cursor";
         createdAt: string;
         expiresAt: string;
@@ -325,9 +544,9 @@ export declare class DesignProfiles {
         collections: {
             includedCollectionIds: string[];
             referenceCount: number;
+            description: string | null;
             url: string | null;
             title: string;
-            description: string | null;
             id: string;
             children: string[];
             total: number | null;
@@ -347,7 +566,7 @@ export declare class DesignProfiles {
     }>;
     referenceOnboarding(action?: ReferenceOnboardingAction, provider?: ReferenceProvider): Promise<{
         providers: {
-            provider: "arena" | "pinterest" | "x" | "cosmos";
+            provider: "pinterest" | "arena" | "cosmos" | "x";
             state: "pending" | "complete" | "later" | "dismissed";
             offeredAt: string | null;
             remindAt: string | null;
@@ -355,7 +574,7 @@ export declare class DesignProfiles {
     }>;
     referenceNotice(): Promise<{
         providers: {
-            provider: "arena" | "pinterest" | "x" | "cosmos";
+            provider: "pinterest" | "arena" | "cosmos" | "x";
             message: string;
             command: string;
             laterCommand: string;
@@ -377,7 +596,7 @@ export declare class DesignProfiles {
             id: string;
             username: string;
         };
-        provider: "arena" | "pinterest" | "x" | "cosmos";
+        provider: "pinterest" | "arena" | "cosmos" | "x";
         runtime: "claude" | "codex" | "cursor";
         createdAt: string;
         expiresAt: string;
@@ -386,9 +605,9 @@ export declare class DesignProfiles {
         collections: {
             includedCollectionIds: string[];
             referenceCount: number;
+            description: string | null;
             url: string | null;
             title: string;
-            description: string | null;
             id: string;
             children: string[];
             total: number | null;
@@ -418,7 +637,7 @@ export declare class DesignProfiles {
         };
         sources: {
             id: string;
-            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "pinterest" | "arena" | "cosmos" | "x" | "image" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -432,7 +651,7 @@ export declare class DesignProfiles {
             id: string;
             sourceId: string;
             runtime: "claude" | "codex" | "cursor";
-            state: "pending" | "failed" | "complete" | "superseded" | "paused";
+            state: "pending" | "failed" | "superseded" | "complete" | "paused";
             cursor: string | null;
             enumerated: number;
             total: number | null;
@@ -456,7 +675,7 @@ export declare class DesignProfiles {
             pendingIndex: number;
         };
         referenceOnboarding: {
-            provider: "arena" | "pinterest" | "x" | "cosmos";
+            provider: "pinterest" | "arena" | "cosmos" | "x";
             state: "pending" | "complete" | "later" | "dismissed";
             offeredAt: string | null;
             remindAt: string | null;
@@ -489,7 +708,7 @@ export declare class DesignProfiles {
                 pendingIndex: number;
             };
             id: string;
-            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "pinterest" | "arena" | "cosmos" | "x" | "image" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -513,7 +732,7 @@ export declare class DesignProfiles {
             id: string;
             sourceId: string;
             runtime: "claude" | "codex" | "cursor";
-            state: "pending" | "failed" | "complete" | "superseded" | "paused";
+            state: "pending" | "failed" | "superseded" | "complete" | "paused";
             cursor: string | null;
             enumerated: number;
             total: number | null;
@@ -537,7 +756,7 @@ export declare class DesignProfiles {
             pendingIndex: number;
         };
         referenceOnboarding: {
-            provider: "arena" | "pinterest" | "x" | "cosmos";
+            provider: "pinterest" | "arena" | "cosmos" | "x";
             state: "pending" | "complete" | "later" | "dismissed";
             offeredAt: string | null;
             remindAt: string | null;
@@ -559,7 +778,7 @@ export declare class DesignProfiles {
         };
         sources: {
             id: string;
-            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "pinterest" | "arena" | "cosmos" | "x" | "image" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -573,7 +792,7 @@ export declare class DesignProfiles {
             id: string;
             sourceId: string;
             runtime: "claude" | "codex" | "cursor";
-            state: "pending" | "failed" | "complete" | "superseded" | "paused";
+            state: "pending" | "failed" | "superseded" | "complete" | "paused";
             cursor: string | null;
             enumerated: number;
             total: number | null;
@@ -597,7 +816,7 @@ export declare class DesignProfiles {
             pendingIndex: number;
         };
         referenceOnboarding: {
-            provider: "arena" | "pinterest" | "x" | "cosmos";
+            provider: "pinterest" | "arena" | "cosmos" | "x";
             state: "pending" | "complete" | "later" | "dismissed";
             offeredAt: string | null;
             remindAt: string | null;
@@ -612,7 +831,7 @@ export declare class DesignProfiles {
     }): Promise<{
         source: {
             id: string;
-            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "pinterest" | "arena" | "cosmos" | "x" | "image" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -629,7 +848,7 @@ export declare class DesignProfiles {
     }): Promise<{
         source: {
             id: string;
-            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "pinterest" | "arena" | "cosmos" | "x" | "image" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -649,7 +868,7 @@ export declare class DesignProfiles {
     addVariant(input: ProfileVariantInput): Promise<{
         source: {
             id: string;
-            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "pinterest" | "arena" | "cosmos" | "x" | "image" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -664,14 +883,14 @@ export declare class DesignProfiles {
         runtime: ProfileRuntime;
     }): Promise<{
         status: "approval_required";
-        provider: "arena" | "pinterest" | "x" | "cosmos";
+        provider: "pinterest" | "arena" | "cosmos" | "x";
         profileUrl: string;
         collectionId: string;
         message: string;
     } | {
         source: {
             id: string;
-            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "pinterest" | "arena" | "cosmos" | "x" | "image" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -685,7 +904,7 @@ export declare class DesignProfiles {
             id: string;
             sourceId: string;
             runtime: "claude" | "codex" | "cursor";
-            state: "pending" | "failed" | "complete" | "superseded" | "paused";
+            state: "pending" | "failed" | "superseded" | "complete" | "paused";
             cursor: string | null;
             enumerated: number;
             total: number | null;
@@ -709,7 +928,7 @@ export declare class DesignProfiles {
         };
         sources: {
             id: string;
-            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "pinterest" | "arena" | "cosmos" | "x" | "image" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -723,7 +942,7 @@ export declare class DesignProfiles {
             id: string;
             sourceId: string;
             runtime: "claude" | "codex" | "cursor";
-            state: "pending" | "failed" | "complete" | "superseded" | "paused";
+            state: "pending" | "failed" | "superseded" | "complete" | "paused";
             cursor: string | null;
             enumerated: number;
             total: number | null;
@@ -747,7 +966,7 @@ export declare class DesignProfiles {
             pendingIndex: number;
         };
         referenceOnboarding: {
-            provider: "arena" | "pinterest" | "x" | "cosmos";
+            provider: "pinterest" | "arena" | "cosmos" | "x";
             state: "pending" | "complete" | "later" | "dismissed";
             offeredAt: string | null;
             remindAt: string | null;
@@ -758,7 +977,7 @@ export declare class DesignProfiles {
         runtime: ProfileRuntime;
     }): Promise<{
         status: "approval_required";
-        provider: "arena" | "pinterest" | "x" | "cosmos";
+        provider: "pinterest" | "arena" | "cosmos" | "x";
         profileUrl: string;
         collectionId: string;
         message: string;
@@ -769,7 +988,7 @@ export declare class DesignProfiles {
             id: string;
             sourceId: string;
             runtime: "claude" | "codex" | "cursor";
-            state: "pending" | "failed" | "complete" | "superseded" | "paused";
+            state: "pending" | "failed" | "superseded" | "complete" | "paused";
             cursor: string | null;
             enumerated: number;
             total: number | null;
@@ -799,9 +1018,9 @@ export declare class DesignProfiles {
         } | null;
         id: string;
         revision: number;
-        provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
         title: string;
         text: string;
+        provider: "variant" | "text" | "pinterest" | "arena" | "cosmos" | "x" | "image" | "pdf";
         remoteId: string;
         media: {
             hash: string;
@@ -810,13 +1029,13 @@ export declare class DesignProfiles {
             representation: "variant" | "image" | "video-cover" | "page";
             page?: number | undefined;
         }[];
-        url?: string | undefined;
         variant?: {
             projectId: string;
             sessionId: string;
             variantId: string;
             treeSha?: string | undefined;
         } | undefined;
+        url?: string | undefined;
         note?: string | undefined;
         remoteImages?: string[] | undefined;
         remoteImageRepresentations?: ("image" | "video-cover")[] | undefined;
@@ -832,6 +1051,7 @@ export declare class DesignProfiles {
             hasAnalysis: boolean;
         }[];
     } | null>;
+    private readReferenceContexts;
     referenceMedia({ profileId, referenceId, hash, }: {
         profileId: string;
         referenceId: string;
@@ -855,14 +1075,14 @@ export declare class DesignProfiles {
             revision: number;
             id: string;
             sourceTitles: string[];
-            url?: string | undefined;
-            title?: string | undefined;
             variant?: {
                 projectId: string;
                 sessionId: string;
                 variantId: string;
                 treeSha?: string | undefined;
             } | undefined;
+            url?: string | undefined;
+            title?: string | undefined;
             mediaHashes?: string[] | undefined;
         }[];
         queries: string[];
@@ -883,8 +1103,8 @@ export declare class DesignProfiles {
         suppliedReferences?: {
             title: string;
             id: string;
-            url?: string | undefined;
             reason?: string | undefined;
+            url?: string | undefined;
             image?: {
                 hash: string;
                 mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";