@cat-factory/integrations 0.148.0 → 0.150.0

package/dist/modules/documents/DocumentImportService.d.ts

@@ -1,7 +1,8 @@
-import type { Clock, IdGenerator } from '@cat-factory/kernel';
+import type { Clock, IdGenerator, Logger } from '@cat-factory/kernel';
 import type { DocumentSourceRegistry } from '@cat-factory/kernel';
 import type { DocumentRecord, DocumentRepository } from '@cat-factory/kernel';
 import type { GroupCacheHandle, LinkedDocumentRefreshOutcome } from '@cat-factory/kernel';
+import type { ResolveBinaryArtifactStore } from '@cat-factory/kernel';
 import type { SourceDocument, DocumentSearchResult, DocumentSourceKind } from '@cat-factory/kernel';
 import { type ResolvedDocumentRef } from '@cat-factory/contracts';
 import type { WorkspaceRepository } from '@cat-factory/kernel';
@@ -21,6 +22,17 @@ export interface DocumentImportServiceDependencies {
      * is the fresh one and an invalidation would race the store it precedes.
      */
     versionCache?: GroupCacheHandle<LinkedDocumentRefreshOutcome>;
+    /**
+     * Where a design source's rendered frames are retained, resolved per workspace because the blob
+     * backend is an ACCOUNT choice rather than a boot-time one.
+     *
+     * Optional, and its absence is a first-class answer rather than a missing wire: a deployment that
+     * has configured no image storage imports the design textually and the row says
+     * `storage_unavailable`, which is a different fact from a source that offered no image.
+     */
+    resolveBinaryArtifactStore?: ResolveBinaryArtifactStore;
+    /** Where the best-effort render pass reports what it could not retain. */
+    logger?: Logger;
 }
 /** A document body supplied directly by a caller rather than fetched from a connected source. */
 export interface UploadedDocument {
@@ -47,6 +59,7 @@ export declare function assertUploadReadable(input: UploadedDocument): string;
 export declare function toSourceDocument(record: DocumentRecord): SourceDocument;
 export declare class DocumentImportService {
     private readonly deps;
+    private readonly log;
     constructor(deps: DocumentImportServiceDependencies);
     private requireProvider;
     /**
@@ -113,6 +126,40 @@ export declare class DocumentImportService {
     reimport(workspaceId: string, source: DocumentSourceKind, externalId: string, opts?: {
         fallbackVersion?: string;
     }): Promise<DocumentRecord>;
+    /**
+     * Re-retain the document's rendered images, returning what became of them.
+     *
+     * The order is prune-then-fetch, deliberately: a document's pictures are never a mix of two
+     * revisions, and the cost is a window where a failed download leaves it with none, which the
+     * returned status states. The reverse ordering is the trap, because it fails INVISIBLY — the
+     * body of the new revision lands beside last month's frames, and a row saying `failed` beside a
+     * full set of pictures reads to everyone as a transient blip rather than as a document
+     * illustrating something that no longer exists.
+     *
+     * Everything here is BEST-EFFORT — an image is an enrichment, and an import that already holds
+     * the body must not fail because a CDN did.
+     *
+     * The status is derived from what was RETAINED rather than from what was downloaded, so a store
+     * that rejects half the bytes reads as `partial` exactly like a source that rendered half the
+     * frames. What a caller does about either is the same, and claiming `stored` over an artifact
+     * that never landed is the one answer that would send them looking in the wrong place.
+     */
+    private refreshRenders;
+    /**
+     * The workspace's artifact store, or WHY there isn't one.
+     *
+     * Three outcomes rather than a nullable store, because the two empty ones are opposite facts
+     * that the same `null` would have stated identically. `none` is a settled deployment answer
+     * ("this account retains no images"), which the row records as `storage_unavailable` and a
+     * person fixes by configuring storage. `unreadable` is an OUTAGE in the account-settings read,
+     * and telling an operator their storage is unconfigured when it is configured sends them to
+     * change a setting that is already right; worse, the status is then carried forward untouched
+     * by every token-only re-import, so the misattribution outlives the outage that caused it.
+     *
+     * The failure is still swallowed rather than propagated: the caller is a best-effort enrichment
+     * on a path that already holds the document body.
+     */
+    private resolveArtifactStore;
     /**
      * Persist a document body the caller supplied directly, as an `upload`-origin projection.
      *

package/dist/modules/documents/DocumentImportService.d.ts.map

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

package/dist/modules/documents/DocumentImportService.js

@@ -1,4 +1,4 @@
-import { contentHash, redactSecrets, ValidationError } from '@cat-factory/kernel';
+import { contentHash, describeError, noopLogger, redactSecrets, ValidationError, } from '@cat-factory/kernel';
 import { orderSourcesByClaimConfidence, } from '@cat-factory/contracts';
 import { requireWorkspace } from '@cat-factory/kernel';
 import { buildExcerpt, probeCacheKey, sameAgentVisibleProjection } from './documents.logic.js';
@@ -36,12 +36,15 @@ export function toSourceDocument(record) {
         role: record.role,
         docKind: record.docKind,
         syncedAt: record.syncedAt,
+        renderStatus: record.renderStatus,
     };
 }
 export class DocumentImportService {
     deps;
+    log;
     constructor(deps) {
         this.deps = deps;
+        this.log = deps.logger ?? noopLogger;
     }
     requireProvider(source) {
         const provider = this.deps.registry.get(source);
@@ -166,6 +169,17 @@ export class DocumentImportService {
             sameAgentVisibleProjection(existing, { ...content, contentHash: hash });
         if (existing && unchangedForReaders && existing.sourceVersion === version)
             return existing;
+        // Renders belong to the BODY, so they are refreshed on exactly the writes that change one. A
+        // token-only write (below) carries the previous status forward untouched: a design file's
+        // version moves on any edit anywhere in it, and re-rasterising six frames because someone
+        // renamed a layer on another page is the cost this branch exists to avoid.
+        const renderStatus = unchangedForReaders
+            ? (existing?.renderStatus ?? null)
+            : // The credentials this import already opened, rather than a second `requireConnection`:
+                // the render pass runs against the very revision `fetchDocument` just read, so re-opening
+                // the sealed bag buys nothing and adds a decrypt plus a window in which the connection can
+                // vanish between the two reads.
+                await this.refreshRenders(workspaceId, provider, source, connection.credentials, content);
         // The write that remains, when `unchangedForReaders` still holds, exists ONLY to record the
         // moved token: a page whose version bumped without changing a byte (a Figma file version moves
         // on any edit in the file, including frames this document does not cover) would otherwise keep
@@ -188,6 +202,7 @@ export class DocumentImportService {
             // any existing tag across a re-import (the repo's upsert also leaves these columns alone).
             role: existing?.role ?? null,
             docKind: existing?.docKind ?? null,
+            renderStatus,
             // `syncedAt` is "when the body was last written", which is what every reader renders it as,
             // so a token-only write must NOT move it. Moving it would put a fresh timestamp on bytes
             // nobody changed, and the person reading it would conclude their edit had landed.
@@ -197,6 +212,141 @@ export class DocumentImportService {
         await this.deps.documentRepository.upsert(record);
         return record;
     }
+    /**
+     * Re-retain the document's rendered images, returning what became of them.
+     *
+     * The order is prune-then-fetch, deliberately: a document's pictures are never a mix of two
+     * revisions, and the cost is a window where a failed download leaves it with none, which the
+     * returned status states. The reverse ordering is the trap, because it fails INVISIBLY — the
+     * body of the new revision lands beside last month's frames, and a row saying `failed` beside a
+     * full set of pictures reads to everyone as a transient blip rather than as a document
+     * illustrating something that no longer exists.
+     *
+     * Everything here is BEST-EFFORT — an image is an enrichment, and an import that already holds
+     * the body must not fail because a CDN did.
+     *
+     * The status is derived from what was RETAINED rather than from what was downloaded, so a store
+     * that rejects half the bytes reads as `partial` exactly like a source that rendered half the
+     * frames. What a caller does about either is the same, and claiming `stored` over an artifact
+     * that never landed is the one answer that would send them looking in the wrong place.
+     */
+    async refreshRenders(workspaceId, provider, source, credentials, content) {
+        // A source with nothing to rasterise: not a failure and not an empty set, but a question that
+        // does not apply. NULL is the only value that says so.
+        if (!provider.fetchRenders)
+            return null;
+        const externalId = content.externalId;
+        const storage = await this.resolveArtifactStore(workspaceId);
+        // Asked BEFORE the download, so an unconfigured deployment spends no bandwidth on bytes it
+        // could not keep. An account that retains no images and a settings read that FAILED are
+        // deliberately different answers: the first is a deployment fact a person fixes by configuring
+        // storage, the second is an outage this import should be retried past.
+        if (storage.kind === 'unreadable')
+            return 'failed';
+        if (storage.kind === 'none')
+            return 'storage_unavailable';
+        const store = storage.store;
+        const document = { source, externalId };
+        try {
+            // The FIRST thing this does, so every later failure — a rate-limited source, a CDN outage,
+            // a store that will not take the bytes — can only ever leave the document with no pictures,
+            // never with the previous revision's beside the new body. A prune that itself throws lands
+            // in the same `catch` and records `failed`, which is honest for the one case where the old
+            // set may genuinely survive: nobody can then claim the set is current.
+            await store.pruneByDocument(workspaceId, document);
+            const result = await provider.fetchRenders(credentials, externalId, workspaceId, content.renderPlan);
+            let stored = 0;
+            // Frames the provider's own cap excluded were never going to be retained, so they count
+            // against completeness exactly like a failed download: six pictures of a twenty-frame design
+            // is a partly illustrated document, not a fully illustrated six-frame one.
+            let dropped = result.failed + result.capped;
+            for (const render of result.renders) {
+                try {
+                    await store.store({
+                        meta: {
+                            workspaceId,
+                            // No run and no block: an import happens before either exists, and the document's
+                            // own identity is what a later reader joins on.
+                            executionId: null,
+                            blockId: null,
+                            kind: 'reference',
+                            view: render.view,
+                            contentType: render.contentType,
+                            document,
+                        },
+                        blob: render.bytes,
+                    });
+                    stored += 1;
+                }
+                catch (error) {
+                    // A bespoke catch rather than `runBestEffort`: the failure is a VALUE here (it decides
+                    // between `stored` and `partial`), and the loop must go on to the next frame.
+                    dropped += 1;
+                    this.log.warn('document render could not be retained', {
+                        workspaceId,
+                        source,
+                        externalId,
+                        view: render.view,
+                        ...describeError(error),
+                    });
+                }
+            }
+            if (result.causes.length || result.capped > 0) {
+                this.log.warn('document renders were not fully retrieved', {
+                    workspaceId,
+                    source,
+                    externalId,
+                    retrieved: result.renders.length,
+                    failed: result.failed,
+                    // Named apart from `failed` on the line too: a retry fixes one and never the other.
+                    capped: result.capped,
+                    causes: result.causes.join(', '),
+                });
+            }
+            if (stored > 0)
+                return dropped > 0 ? 'partial' : 'stored';
+            return dropped > 0 ? 'failed' : 'none';
+        }
+        catch (error) {
+            this.log.warn('document render pass failed', {
+                workspaceId,
+                source,
+                externalId,
+                ...describeError(error),
+            });
+            return 'failed';
+        }
+    }
+    /**
+     * The workspace's artifact store, or WHY there isn't one.
+     *
+     * Three outcomes rather than a nullable store, because the two empty ones are opposite facts
+     * that the same `null` would have stated identically. `none` is a settled deployment answer
+     * ("this account retains no images"), which the row records as `storage_unavailable` and a
+     * person fixes by configuring storage. `unreadable` is an OUTAGE in the account-settings read,
+     * and telling an operator their storage is unconfigured when it is configured sends them to
+     * change a setting that is already right; worse, the status is then carried forward untouched
+     * by every token-only re-import, so the misattribution outlives the outage that caused it.
+     *
+     * The failure is still swallowed rather than propagated: the caller is a best-effort enrichment
+     * on a path that already holds the document body.
+     */
+    async resolveArtifactStore(workspaceId) {
+        const resolve = this.deps.resolveBinaryArtifactStore;
+        if (!resolve)
+            return { kind: 'none' };
+        try {
+            const store = await resolve(workspaceId);
+            return store ? { kind: 'store', store } : { kind: 'none' };
+        }
+        catch (error) {
+            this.log.warn('could not resolve artifact storage for document renders', {
+                workspaceId,
+                ...describeError(error),
+            });
+            return { kind: 'unreadable' };
+        }
+    }
     /**
      * Persist a document body the caller supplied directly, as an `upload`-origin projection.
      *
@@ -236,6 +386,9 @@ export class DocumentImportService {
             linkedBlockId: null,
             role: null,
             docKind: null,
+            // Markdown handed to the platform directly: there is no source to rasterise, which is the
+            // same "does not apply" the null states one field over.
+            renderStatus: null,
             syncedAt: this.deps.clock.now(),
             deletedAt: null,
         };

package/dist/modules/documents/DocumentImportService.js.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentImportService.js","sourceRoot":"","sources":["../../../src/modules/documents/DocumentImportService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DocumentImportService.js","sourceRoot":"","sources":["../../../src/modules/documents/DocumentImportService.ts"],"names":[],"mappings":"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"}

package/dist/modules/documents/FigmaProvider.d.ts

@@ -1,4 +1,4 @@
-import { type DocumentContent, type DocumentCredentials, type DocumentSourceProvider, type NormalizedConnection } from '@cat-factory/kernel';
+import { type DocumentContent, type DocumentCredentials, type DocumentRenderPlan, type DocumentRenderResult, type DocumentSourceProvider, type NormalizedConnection } from '@cat-factory/kernel';
 /** Carries the HTTP status so callers can surface a meaningful error. */
 export declare class FigmaApiError extends Error {
     readonly status: number;
@@ -35,6 +35,34 @@ export declare class FigmaProvider implements DocumentSourceProvider {
      */
     droppedScope(input: string, externalId: string): string | null;
     fetchDocument(credentials: DocumentCredentials, externalId: string, _workspaceId: string | null): Promise<DocumentContent>;
+    /**
+     * Rasterise the referenced frames and download the PNGs.
+     *
+     * Three hops, and the split matters: a STRUCTURAL read learns which frames to render and what
+     * they are called (the `view` a captured screenshot pairs with), the `/v1/images` endpoint turns
+     * those ids into short-lived signed URLs, and the URLs are downloaded from the asset host with no
+     * credential attached. A frame whose own download fails is counted rather than thrown, so one
+     * oversize artboard costs its own picture and not the other five.
+     *
+     * The first hop is SKIPPED when the caller hands over the plan its own `fetchDocument` produced,
+     * which is the normal path: an import fetches the body and the renders back to back off one
+     * revision, and the structural read is the same request twice against a rate-limited API.
+     */
+    fetchRenders(credentials: DocumentCredentials, externalId: string, _workspaceId: string | null, plan?: DocumentRenderPlan): Promise<DocumentRenderResult>;
+    /**
+     * The frames to rasterise, with their names, for a caller that supplied no plan.
+     *
+     * A node link renders the frame it names; a whole-file link renders the first
+     * {@link figmaLogic.MAX_RENDERS} top-level frames in document order — the same frames, in the
+     * same order, the text import covers, so the pictures and the prose describe the same screens.
+     * This is the FALLBACK: it repeats the structural read `fetchDocument` performs, which is why
+     * the import hands its own plan over instead.
+     */
+    private resolveRenderTargets;
+    /** `/v1/images` in ONE call for every target: id → signed URL, absent when Figma rendered none. */
+    private fetchRenderUrls;
+    /** Download one signed render. No credential is sent: the URL already carries its own. */
+    private downloadRender;
     /**
      * The cheap version probe: read the file's metadata at `depth=1` (no node tree)
      * for its `version` / `lastModified`, skipping the deep node fetch + variables +

package/dist/modules/documents/FigmaProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FigmaProvider.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/FigmaProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAA;AA0C5B,yEAAyE;AACzE,qBAAa,aAAc,SAAQ,KAAK;IAEpC,QAAQ,CAAC,MAAM,EAAE,MAAM;IADzB,YACW,MAAM,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EAIhB;CACF;AA2GD,qBAAa,aAAc,YAAW,sBAAsB;IAC1D,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAS;IAChC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;MAAmB;IACtC,QAAQ,CAAC,KAAK,wDAAc;IAE5B,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CAMpE;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAErC;IAED,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvC;IAED;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;IAEK,aAAa,CACjB,WAAW,EAAE,mBAAmB,EAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,eAAe,CAAC,CAuC1B;IAED;;;;OAIG;IACG,YAAY,CAChB,WAAW,EAAE,mBAAmB,EAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CAUjB;IAED,gGAAgG;YAClF,UAAU;IASxB;;;;;OAKG;YACW,gBAAgB;IAyB9B;;;;;;;;OAQG;YACW,eAAe;IAgE7B;;;;OAIG;YACW,kBAAkB;IAuChC;;;;;OAKG;YACW,cAAc;IAoB5B,gGAAgG;YAClF,eAAe;IAqB7B;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,KAAK;YAQC,GAAG;CAqBlB"}
+{"version":3,"file":"FigmaProvider.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/FigmaProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAA;AA2D5B,yEAAyE;AACzE,qBAAa,aAAc,SAAQ,KAAK;IAEpC,QAAQ,CAAC,MAAM,EAAE,MAAM;IADzB,YACW,MAAM,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EAIhB;CACF;AA2HD,qBAAa,aAAc,YAAW,sBAAsB;IAC1D,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAS;IAChC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;MAAmB;IACtC,QAAQ,CAAC,KAAK,wDAAc;IAE5B,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CAMpE;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAErC;IAED,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvC;IAED;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;IAEK,aAAa,CACjB,WAAW,EAAE,mBAAmB,EAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,eAAe,CAAC,CA2C1B;IAED;;;;;;;;;;;;OAYG;IACG,YAAY,CAChB,WAAW,EAAE,mBAAmB,EAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAkD/B;IAED;;;;;;;;OAQG;YACW,oBAAoB;IAsBlC,mGAAmG;YACrF,eAAe;IAkB7B,0FAA0F;YAC5E,cAAc;IAW5B;;;;OAIG;IACG,YAAY,CAChB,WAAW,EAAE,mBAAmB,EAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CAUjB;IAED,gGAAgG;YAClF,UAAU;IASxB;;;;;OAKG;YACW,gBAAgB;IA4B9B;;;;;;;;OAQG;YACW,eAAe;IAoE7B;;;;OAIG;YACW,kBAAkB;IAuChC;;;;;OAKG;YACW,cAAc;IAoB5B,gGAAgG;YAClF,eAAe;IAqB7B;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,KAAK;YAQC,GAAG;CAqBlB"}

package/dist/modules/documents/FigmaProvider.js

@@ -1,8 +1,8 @@
 import { describeError, documentOAuthAccessToken, ValidationError, } from '@cat-factory/kernel';
 import { renderDesignContext } from './design.logic.js';
-import { FIGMA_API_HOST, FIGMA_DESCRIPTOR, FIGMA_OAUTH } from './figma.logic.js';
+import { FIGMA_API_HOST, FIGMA_DESCRIPTOR, FIGMA_OAUTH, FIGMA_RENDER_HOSTS } from './figma.logic.js';
 import * as figmaLogic from './figma.logic.js';
-import { DocumentHttpError, createHostPinnedFetch, readCappedText } from './http.js';
+import { DocumentHttpError, createHostPinnedFetch, readCappedBytes, readCappedText, } from './http.js';
 // FigmaProvider: the document-source provider for Figma. It authenticates with
 // whichever credential the workspace connected — a personal access token (the
 // `X-Figma-Token` header) or an OAuth grant the platform holds (a `Bearer` token) —
@@ -37,6 +37,18 @@ const FRAME_DEPTH = figmaLogic.MAX_TREE_DEPTH + 3;
 const FRAME_CHUNK = 4;
 /** Hard cap on the bytes read off any response body, to protect the isolate. */
 const MAX_RESPONSE_BYTES = 5_000_000;
+/**
+ * Hard cap on one rendered PNG. A frame is rasterised at `scale=1`, so a phone screen lands well
+ * under this and a poster-sized artboard is dropped with a stated cause rather than pulled into
+ * the isolate.
+ */
+const MAX_RENDER_BYTES = 3_000_000;
+/**
+ * Renders downloaded concurrently. The images come from a signed-URL CDN rather than the rate-
+ * limited API, so a small fan-out is safe; bounded anyway because each holds its bytes in memory
+ * until the caller has stored them.
+ */
+const RENDER_DOWNLOAD_CONCURRENCY = 3;
 /** Carries the HTTP status so callers can surface a meaningful error. */
 export class FigmaApiError extends Error {
     status;
@@ -52,6 +64,15 @@ export class FigmaApiError extends Error {
  * capped-read are the shared documents `http` helpers; only the host/label differ.
  */
 const safeFetch = createHostPinnedFetch({ host: FIGMA_API_HOST, label: 'Figma' });
+/**
+ * `fetch` for a rendered image, pinned to Figma's signed-asset hosts. A SEPARATE client from
+ * {@link safeFetch} because the two carry different things: this one sends NO credential (the URL
+ * is already signed) and reaches a host the API token must never be offered to.
+ */
+const safeRenderFetch = createHostPinnedFetch({
+    host: FIGMA_RENDER_HOSTS,
+    label: 'Figma render',
+});
 function emptyMaps() {
     return { components: {}, componentSets: {}, styles: {} };
 }
@@ -120,7 +141,7 @@ export class FigmaProvider {
         if (!fileKey) {
             throw new FigmaApiError(400, `Figma ref is missing a file key: ${externalId}`);
         }
-        const { roots, maps, fileName, version, notes } = await this.fetchNodes(credentials, fileKey, nodeId);
+        const { roots, maps, fileName, version, notes, renderPlan } = await this.fetchNodes(credentials, fileKey, nodeId);
         // Design tokens are Enterprise-gated; on 403/404 the published styles carried by the
         // node tree are the fallback and the render says which one it used. A rendered preview
         // rides along as a reference (no download): best-effort, the short-lived URL may expire
@@ -146,8 +167,120 @@ export class FigmaProvider {
             url: context.url,
             body: renderDesignContext(context),
             version,
+            // The frames this same read already named. `fetchRenders` would otherwise re-issue the very
+            // request that produced them, against the rate-limited API, to relearn ids and names it had
+            // in hand a moment ago.
+            renderPlan,
         };
     }
+    /**
+     * Rasterise the referenced frames and download the PNGs.
+     *
+     * Three hops, and the split matters: a STRUCTURAL read learns which frames to render and what
+     * they are called (the `view` a captured screenshot pairs with), the `/v1/images` endpoint turns
+     * those ids into short-lived signed URLs, and the URLs are downloaded from the asset host with no
+     * credential attached. A frame whose own download fails is counted rather than thrown, so one
+     * oversize artboard costs its own picture and not the other five.
+     *
+     * The first hop is SKIPPED when the caller hands over the plan its own `fetchDocument` produced,
+     * which is the normal path: an import fetches the body and the renders back to back off one
+     * revision, and the structural read is the same request twice against a rate-limited API.
+     */
+    async fetchRenders(credentials, externalId, _workspaceId, plan) {
+        const { fileKey, nodeId } = figmaLogic.splitFigmaExternalId(externalId);
+        if (!fileKey) {
+            throw new FigmaApiError(400, `Figma ref is missing a file key: ${externalId}`);
+        }
+        const resolved = plan ?? (await this.resolveRenderTargets(credentials, fileKey, nodeId));
+        const targets = resolved.targets;
+        // The cap rides every return: frames excluded before the first request are just as absent
+        // from the stored set as ones whose download failed, and only this count says so.
+        if (!targets.length)
+            return { renders: [], failed: 0, capped: resolved.capped, causes: [] };
+        const urls = await this.fetchRenderUrls(credentials, fileKey, targets.map((t) => t.id));
+        const causes = new Set();
+        const renders = [];
+        let failed = 0;
+        // A target the images endpoint answered with no URL never had a picture to download, so it is
+        // counted with the same cause vocabulary rather than silently dropped: "Figma rendered nothing
+        // for this frame" and "the download failed" ask for different things of the person reading it.
+        const pending = targets.filter((target) => {
+            const url = urls.get(target.id);
+            if (url)
+                return true;
+            failed += 1;
+            causes.add('no render returned');
+            return false;
+        });
+        for (let i = 0; i < pending.length; i += RENDER_DOWNLOAD_CONCURRENCY) {
+            const chunk = pending.slice(i, i + RENDER_DOWNLOAD_CONCURRENCY);
+            const settled = await Promise.all(chunk.map(async (target) => {
+                try {
+                    return await this.downloadRender(urls.get(target.id), target.view);
+                }
+                catch (err) {
+                    // silent-catch-ok: REPORTED to the caller as `failed` + this cause, which is the honest
+                    // form of it. A single frame's picture may not fail the import that carries the text.
+                    return describeFetchCause(err);
+                }
+            }));
+            for (const result of settled) {
+                if (typeof result === 'string') {
+                    failed += 1;
+                    causes.add(result);
+                }
+                else
+                    renders.push(result);
+            }
+        }
+        return { renders, failed, capped: resolved.capped, causes: [...causes].sort() };
+    }
+    /**
+     * The frames to rasterise, with their names, for a caller that supplied no plan.
+     *
+     * A node link renders the frame it names; a whole-file link renders the first
+     * {@link figmaLogic.MAX_RENDERS} top-level frames in document order — the same frames, in the
+     * same order, the text import covers, so the pictures and the prose describe the same screens.
+     * This is the FALLBACK: it repeats the structural read `fetchDocument` performs, which is why
+     * the import hands its own plan over instead.
+     */
+    async resolveRenderTargets(credentials, fileKey, nodeId) {
+        if (nodeId) {
+            // `depth=1` is the node ALONE: this read wants its name, not its subtree.
+            const res = await this.get(credentials, `/files/${encodeURIComponent(fileKey)}/nodes` +
+                `?ids=${encodeURIComponent(nodeId)}&depth=1`);
+            const node = res.nodes?.[nodeId]?.document;
+            return node ? figmaLogic.figmaRenderTargets([node]) : { targets: [], capped: 0 };
+        }
+        const res = await this.get(credentials, `/files/${encodeURIComponent(fileKey)}?depth=${FILE_DEPTH}`);
+        return figmaLogic.figmaRenderTargets(figmaLogic.figmaTopLevelFrames(res.document));
+    }
+    /** `/v1/images` in ONE call for every target: id → signed URL, absent when Figma rendered none. */
+    async fetchRenderUrls(credentials, fileKey, ids) {
+        const res = await this.get(credentials, `/images/${encodeURIComponent(fileKey)}` +
+            `?ids=${encodeURIComponent(ids.join(','))}&format=png&scale=1`);
+        if (res.err)
+            throw new FigmaApiError(502, `Figma images endpoint reported: ${res.err}`);
+        const out = new Map();
+        for (const [id, url] of Object.entries(res.images ?? {})) {
+            if (typeof url === 'string' && url)
+                out.set(id, url);
+        }
+        return out;
+    }
+    /** Download one signed render. No credential is sent: the URL already carries its own. */
+    async downloadRender(url, view) {
+        const res = await safeRenderFetch(url, {
+            method: 'GET',
+            headers: { accept: 'image/png', 'user-agent': USER_AGENT },
+        });
+        if (!res.ok)
+            throw new FigmaApiError(res.status, `Figma render GET → ${res.status}`);
+        const bytes = await readCappedBytes(res, MAX_RENDER_BYTES, 'Figma render');
+        if (!bytes.byteLength)
+            throw new FigmaApiError(502, 'Figma returned an empty render');
+        return { view, contentType: 'image/png', bytes };
+    }
     /**
      * The cheap version probe: read the file's metadata at `depth=1` (no node tree)
      * for its `version` / `lastModified`, skipping the deep node fetch + variables +
@@ -188,6 +321,9 @@ export class FigmaProvider {
             fileName: res.name ?? fileKey,
             version: fileVersion(res),
             notes: [],
+            // A node link renders the frame it names, and nothing is capped: one frame was asked for and
+            // one is covered.
+            renderPlan: figmaLogic.figmaRenderTargets([entry.document]),
         };
     }
     /**
@@ -215,6 +351,10 @@ export class FigmaProvider {
             fileName: res.name ?? fileKey,
             version: fileVersion(res),
             notes: [],
+            // Resolved against the WHOLE outline rather than the text pass's own `selected` slice: the
+            // two caps are different numbers, and `capped` has to count frames this file has that no
+            // picture will cover, not frames the text budget happened to keep.
+            renderPlan: figmaLogic.figmaRenderTargets(outline),
         };
         if (!outline.length)
             return base;