rivet-design 0.22.0 → 0.23.1

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

@@ -1,3 +1,4 @@
+import type { GuidanceVerification } from '../../types/guidance-verifier';
 import { type ReferenceDiscoveryRequest, type ReferenceProvider } from '../../types/reference-connectors';
 import type { ReferenceConnectorClient } from './ReferenceReader';
 import { IntegrationsClient } from '../IntegrationsClient';
@@ -25,17 +26,17 @@ export declare class DesignProfiles {
     private opening;
     constructor(options: DesignProfilesOptions);
     listGuidance(expectedAccountId?: string): Promise<{
-        id: 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: "image" | "variant" | "video-cover" | "page";
+            representation: "variant" | "image" | "video-cover" | "page";
+            source: string;
             alt: string;
             title?: string | undefined;
             page?: number | undefined;
@@ -48,28 +49,31 @@ export declare class DesignProfiles {
             url: string;
             kind: "url" | "repository";
             intent: string;
-            digest?: 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<{
-        id: 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: "image" | "variant" | "video-cover" | "page";
+            representation: "variant" | "image" | "video-cover" | "page";
+            source: string;
             alt: string;
             title?: string | undefined;
             page?: number | undefined;
@@ -82,15 +86,18 @@ export declare class DesignProfiles {
             url: string;
             kind: "url" | "repository";
             intent: string;
-            digest?: 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?: {
@@ -99,17 +106,17 @@ export declare class DesignProfiles {
             documentCount: number;
             byteCount: number;
         } | undefined;
-        id: 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: "image" | "variant" | "video-cover" | "page";
+            representation: "variant" | "image" | "video-cover" | "page";
+            source: string;
             alt: string;
             title?: string | undefined;
             page?: number | undefined;
@@ -122,15 +129,18 @@ export declare class DesignProfiles {
             url: string;
             kind: "url" | "repository";
             intent: string;
-            digest?: 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;
@@ -141,17 +151,17 @@ export declare class DesignProfiles {
             documentCount: number;
             byteCount: number;
         } | undefined;
-        id: 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: "image" | "variant" | "video-cover" | "page";
+            representation: "variant" | "image" | "video-cover" | "page";
+            source: string;
             alt: string;
             title?: string | undefined;
             page?: number | undefined;
@@ -164,15 +174,18 @@ export declare class DesignProfiles {
             url: string;
             kind: "url" | "repository";
             intent: string;
-            digest?: 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;
@@ -185,16 +198,16 @@ export declare class DesignProfiles {
         } | undefined;
         accountId: string;
         guidance: {
-            id: string;
             title: string;
+            id: string;
             markdown: string;
             attachments?: {
                 path: string;
-                source: string;
                 hash: string;
                 mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
                 bytes: number;
-                representation: "image" | "variant" | "video-cover" | "page";
+                representation: "variant" | "image" | "video-cover" | "page";
+                source: string;
                 alt: string;
                 title?: string | undefined;
                 page?: number | undefined;
@@ -207,17 +220,19 @@ export declare class DesignProfiles {
                 url: string;
                 kind: "url" | "repository";
                 intent: string;
-                digest?: string | undefined;
                 files?: {
                     name: string;
                     content: string;
                     path?: string | undefined;
                     sha256?: string | undefined;
                 }[] | undefined;
+                digest?: string | undefined;
                 revision?: string | undefined;
             })[] | undefined;
         }[];
     }>;
+    prepareGuidanceVerification(id: string, expectedAccountId?: string): Promise<GuidanceVerification>;
+    private materializeGuidance;
     private guidanceAccount;
     private withGuidanceRecords;
     discoverReferences({ signal, ...input }: ReferenceDiscoveryRequest & {
@@ -228,18 +243,18 @@ export declare class DesignProfiles {
         id: string;
         total: number;
         collections: {
-            id: string;
-            description: string | null;
             url: string | null;
             title: string;
+            description: string | null;
+            id: string;
             children: string[];
             total: number | null;
             parentId: string | null;
         }[];
         profile: {
-            id: string;
             url: string;
             title: string;
+            id: string;
             username: string;
         };
         createdAt: string;
@@ -257,9 +272,9 @@ export declare class DesignProfiles {
         revision: string;
         discoveryId: string;
         profile: {
-            id: string;
             url: string;
             title: string;
+            id: string;
             username: string;
         };
         provider: "arena" | "pinterest" | "x" | "cosmos";
@@ -271,10 +286,10 @@ export declare class DesignProfiles {
         collections: {
             includedCollectionIds: string[];
             referenceCount: number;
-            id: string;
-            description: string | null;
             url: string | null;
             title: string;
+            description: string | null;
+            id: string;
             children: string[];
             total: number | null;
             parentId: string | null;
@@ -296,9 +311,9 @@ export declare class DesignProfiles {
         revision: string;
         discoveryId: string;
         profile: {
-            id: string;
             url: string;
             title: string;
+            id: string;
             username: string;
         };
         provider: "arena" | "pinterest" | "x" | "cosmos";
@@ -310,10 +325,10 @@ export declare class DesignProfiles {
         collections: {
             includedCollectionIds: string[];
             referenceCount: number;
-            id: string;
-            description: string | null;
             url: string | null;
             title: string;
+            description: string | null;
+            id: string;
             children: string[];
             total: number | null;
             parentId: string | null;
@@ -357,9 +372,9 @@ export declare class DesignProfiles {
         revision: string;
         discoveryId: string;
         profile: {
-            id: string;
             url: string;
             title: string;
+            id: string;
             username: string;
         };
         provider: "arena" | "pinterest" | "x" | "cosmos";
@@ -371,10 +386,10 @@ export declare class DesignProfiles {
         collections: {
             includedCollectionIds: string[];
             referenceCount: number;
-            id: string;
-            description: string | null;
             url: string | null;
             title: string;
+            description: string | null;
+            id: string;
             children: string[];
             total: number | null;
             parentId: string | null;
@@ -403,7 +418,7 @@ export declare class DesignProfiles {
         };
         sources: {
             id: string;
-            provider: "text" | "image" | "variant" | "arena" | "pinterest" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -474,7 +489,7 @@ export declare class DesignProfiles {
                 pendingIndex: number;
             };
             id: string;
-            provider: "text" | "image" | "variant" | "arena" | "pinterest" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -544,7 +559,7 @@ export declare class DesignProfiles {
         };
         sources: {
             id: string;
-            provider: "text" | "image" | "variant" | "arena" | "pinterest" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -597,7 +612,7 @@ export declare class DesignProfiles {
     }): Promise<{
         source: {
             id: string;
-            provider: "text" | "image" | "variant" | "arena" | "pinterest" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -614,7 +629,7 @@ export declare class DesignProfiles {
     }): Promise<{
         source: {
             id: string;
-            provider: "text" | "image" | "variant" | "arena" | "pinterest" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -634,7 +649,7 @@ export declare class DesignProfiles {
     addVariant(input: ProfileVariantInput): Promise<{
         source: {
             id: string;
-            provider: "text" | "image" | "variant" | "arena" | "pinterest" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -656,7 +671,7 @@ export declare class DesignProfiles {
     } | {
         source: {
             id: string;
-            provider: "text" | "image" | "variant" | "arena" | "pinterest" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -694,7 +709,7 @@ export declare class DesignProfiles {
         };
         sources: {
             id: string;
-            provider: "text" | "image" | "variant" | "arena" | "pinterest" | "x" | "cosmos" | "pdf";
+            provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
             remoteId: string;
             resolvedRemoteId: string | null;
             title: string;
@@ -773,8 +788,8 @@ export declare class DesignProfiles {
             description: string;
             revision: number;
             runtime: "claude" | "codex" | "cursor" | "user";
-            referenceId: string;
             evidence: "observation" | "preference";
+            referenceId: string;
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
@@ -784,15 +799,15 @@ export declare class DesignProfiles {
         } | null;
         id: string;
         revision: number;
+        provider: "variant" | "text" | "arena" | "pinterest" | "image" | "x" | "cosmos" | "pdf";
         title: string;
         text: string;
-        provider: "text" | "image" | "variant" | "arena" | "pinterest" | "x" | "cosmos" | "pdf";
         remoteId: string;
         media: {
             hash: string;
             mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
             bytes: number;
-            representation: "image" | "variant" | "video-cover" | "page";
+            representation: "variant" | "image" | "video-cover" | "page";
             page?: number | undefined;
         }[];
         url?: string | undefined;
@@ -836,9 +851,9 @@ export declare class DesignProfiles {
         status: "timeout" | "off" | "selected" | "empty" | "unavailable";
         requestId: string;
         selected: {
-            id: string;
             reason: string;
             revision: number;
+            id: string;
             sourceTitles: string[];
             url?: string | undefined;
             title?: string | undefined;
@@ -866,14 +881,14 @@ export declare class DesignProfiles {
             allocation?: "equal-share" | undefined;
         } | undefined;
         suppliedReferences?: {
-            id: string;
             title: string;
+            id: string;
             url?: string | undefined;
+            reason?: string | undefined;
             image?: {
                 hash: string;
                 mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
             } | undefined;
-            reason?: string | undefined;
         }[] | undefined;
         failedUploadCount?: number | undefined;
     }>;

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

@@ -1 +1 @@
-{"version":3,"file":"DesignProfiles.d.ts","sourceRoot":"","sources":["../../../src/services/profiles/DesignProfiles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DesignProfiles.d.ts","sourceRoot":"","sources":["../../../src/services/profiles/DesignProfiles.ts"],"names":[],"mappings":"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"}

package/dist/services/profiles/DesignProfiles.js

@@ -15,6 +15,7 @@ const design_profile_2 = require("../../types/design-profile");
 const guidance_1 = require("../../types/guidance");
 const guidanceImages_1 = require("../guidanceImages");
 const guidanceReferences_1 = require("../guidanceReferences");
+const retainedTextFiles_1 = require("../retainedTextFiles");
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
@@ -123,23 +124,7 @@ class DesignProfiles {
         if (selection.mode === 'off')
             return { accountId, guidance: [] };
         return this.withGuidanceRecords(async (records) => {
-            const guidance = await (0, guidanceReferences_1.materializeGuidanceReferences)({
-                documents: records.resolveGuidance(selection),
-                dataDirectory: records.directory,
-            });
-            const media = new ProfileMedia_1.ProfileMedia(records.directory);
-            const paths = new Map();
-            for (const document of guidance) {
-                for (const image of document.attachments ?? []) {
-                    try {
-                        image.path = paths.get(image.hash) ?? (await media.resolve(image));
-                        paths.set(image.hash, image.path);
-                    }
-                    catch {
-                        throw (0, guidanceImages_1.guidanceAssetError)(image.source, `Required image for "${document.title}" is missing or unreadable. Update the document to restore it.`);
-                    }
-                }
-            }
+            const guidance = await this.materializeGuidance(records, records.resolveGuidance(selection));
             const warning = (0, guidance_1.guidanceWarning)(guidance);
             return {
                 accountId,
@@ -148,6 +133,75 @@ class DesignProfiles {
             };
         }, accountId);
     }
+    async prepareGuidanceVerification(id, expectedAccountId) {
+        return this.withGuidanceRecords(async (records) => {
+            const { source, sourceDigest, verifier } = records.getGuidanceVerifier(id);
+            const [resolvedSource] = await this.materializeGuidance(records, [
+                source,
+            ]);
+            const resolved = {
+                source: resolvedSource,
+                sourceDigest,
+                execution: 'host_required',
+            };
+            if (!verifier)
+                return {
+                    ...resolved,
+                    verifierState: 'missing',
+                    nextAction: {
+                        action: 'create_context_verifier',
+                        instructions: 'Author and execute a focused verifier against this source and the user-selected target. Record observable checks and evidence before offering to save it for reuse.',
+                    },
+                };
+            if (verifier.sourceDigest !== sourceDigest)
+                return {
+                    ...resolved,
+                    verifier,
+                    verifierState: 'stale',
+                    nextAction: {
+                        action: 'revise_context_verifier',
+                        instructions: 'The source changed after this verifier was saved. Revise and execute a temporary recipe against the supplied source before offering to replace the saved verifier.',
+                    },
+                };
+            return {
+                ...resolved,
+                verifier,
+                verifierState: 'ready',
+                ...(verifier.package
+                    ? {
+                        packageDirectory: await (0, retainedTextFiles_1.materializeTextFiles)({
+                            files: verifier.package.files,
+                            directory: path_1.default.join(records.directory, 'guidance-verifiers'),
+                        }),
+                    }
+                    : {}),
+                nextAction: {
+                    action: 'run_context_verifier',
+                    instructions: 'Execute the saved verifier against this source and the user-selected target. Report pass, fail, or unable to verify with evidence. Retrieval has not executed any checks.',
+                },
+            };
+        }, expectedAccountId);
+    }
+    async materializeGuidance(records, documents) {
+        const guidance = await (0, guidanceReferences_1.materializeGuidanceReferences)({
+            documents,
+            dataDirectory: records.directory,
+        });
+        const media = new ProfileMedia_1.ProfileMedia(records.directory);
+        const paths = new Map();
+        for (const document of guidance) {
+            for (const image of document.attachments ?? []) {
+                try {
+                    image.path = paths.get(image.hash) ?? (await media.resolve(image));
+                    paths.set(image.hash, image.path);
+                }
+                catch {
+                    throw (0, guidanceImages_1.guidanceAssetError)(image.source, `Required image for "${document.title}" is missing or unreadable. Update the document to restore it.`);
+                }
+            }
+        }
+        return guidance;
+    }
     guidanceAccount(expectedAccountId) {
         const accountId = this.options.accountId();
         if (expectedAccountId && expectedAccountId !== accountId)