@vibesdotdev/docs 0.0.0-stage → 1.0.0-rc.2

package/dist/documents/render/grid.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Foveated grid-geometry planner — pure, cloud-safe (no `node:*`, no deps).
+ *
+ * A SCHEMA read on a large/dense architectural sheet (e.g. a 34×44" E-size plan
+ * packing 6 small millwork details) fails when the page is rendered as ONE
+ * downscaled full-page image: each titled detail/elevation cell lands at ~800px,
+ * its text is illegible, and the structured extract returns ZERO rows. The fix is
+ * to split the page into a few square-ish HIGH-DPI cells, extract each, and merge.
+ *
+ * This module owns only the small geometry: given the full-page pixel size, choose
+ * a square-ish grid (`cols`×`rows`) bounded by a total-cell cap, and enumerate the
+ * cells. The actual per-cell pixel/DPI math lives INSIDE the render container
+ * (`apps/ai-web/containers/pdf-render/server.mjs#renderGridCell`), where the page's
+ * true point size is known — the worker only passes the `(col,row,cols,rows,overlap)`
+ * descriptor. We deliberately do NOT reuse `@vibesdotdev/ai`'s `planDescribeZoomGrid`:
+ * it works in PDF-point space and its public barrel re-exports `runVisionOcr`, which
+ * would drag the AI generation/logging graph into this package's cloud bundle. The
+ * geometry we need is tiny, so we replicate it here instead.
+ */
+/**
+ * Longest-edge threshold (px) above which a low-row full-page extract is treated
+ * as "downscale-capped and possibly illegible" → eligible for foveation.
+ */
+export declare const FOVEATE_MIN_LONGEST_EDGE_PX = 1600;
+/**
+ * Minimum row count from a full-page extract to consider the page "already
+ * legible" and skip foveation. < this on a large page triggers the grid read.
+ */
+export declare const FOVEATE_MIN_HEALTHY_ROWS = 3;
+/**
+ * Full-page pixels each grid cell maps to when choosing the grid shape. Smaller →
+ * MORE cells → the container renders each at a higher effective DPI (legibility).
+ * Tuned with FOVEATE_MAX_CELLS so an E-size sheet lands at ~6 cells (≈2×3 / 3×2).
+ */
+export declare const FOVEATE_TARGET_CELL_PX = 900;
+/**
+ * Hard cap on total cells per page. MUST cover a real detail sheet: an ARCH-D
+ * (36×24") interior-elevation sheet packs its details in a 3×2 grid (6 details) —
+ * measured on the Horizon Bay IFP set. At the old cap of 4, a 2400×1600 full-page
+ * render planned a 2×2 grid that sliced each detail across two cells (garbled
+ * extraction); 6 lets it plan the correct 3×2 so each cell ≈ one detail.
+ *
+ * Cost: 6 cells × ~20s serialized ≈ 120s, but the container renders all cells from
+ * ONE source fetch and the vision extracts run concurrently (CONCURRENCY=4 in
+ * foveatedExtract), so wall-clock is ~2 batches; the per-tool budget is 150s.
+ */
+export declare const FOVEATE_MAX_CELLS = 6;
+/** Default fractional overlap between adjacent cells (≈8%). */
+export declare const FOVEATE_DEFAULT_OVERLAP = 0.08;
+export interface GridDimensions {
+    cols: number;
+    rows: number;
+}
+export interface GridCellDescriptor {
+    /** 0-based column (left → right). */
+    col: number;
+    /** 0-based row (top → bottom). */
+    row: number;
+    /** Grid column count. */
+    cols: number;
+    /** Grid row count. */
+    rows: number;
+    /** Fractional overlap added around each cell. */
+    overlap: number;
+}
+/**
+ * Choose a square-ish grid for a page of the given pixel size.
+ *
+ * Rule: `cols ≈ round(width / FOVEATE_TARGET_CELL_PX)` (likewise rows), each at
+ * least 1, then scale the grid DOWN proportionally if `cols*rows` exceeds
+ * `maxCells` so cells stay square-ish while honoring the cost cap. A tiny page
+ * (≤ target on both edges) yields a 1×1 grid (no foveation benefit).
+ */
+export declare function planFoveationGrid(pageWidthPx: number, pageHeightPx: number, maxCells?: number, targetCellPx?: number): GridDimensions;
+/**
+ * Enumerate every cell of a `cols`×`rows` grid in row-major order, each carrying
+ * the full grid descriptor the renderer needs to crop it.
+ */
+export declare function enumerateGridCells(grid: GridDimensions, overlap?: number): GridCellDescriptor[];
+/**
+ * Decide whether a page should be foveated after a full-page extract.
+ *
+ * True only when the full-page extract returned FEW rows (< healthyRows) AND the
+ * page is large enough to have been downscale-capped (longest edge ≥ threshold).
+ * A page that already yields healthy rows, or a small/simple page, is left alone.
+ */
+export declare function shouldFoveate(fullPageRowCount: number, pageWidthPx: number | undefined, pageHeightPx: number | undefined, opts?: {
+    minHealthyRows?: number;
+    minLongestEdgePx?: number;
+}): boolean;
+/**
+ * Are two grid cells adjacent (or the same cell)? Used to scope the cross-cell
+ * duplicate flag to seams where overlap could legitimately double-read a row.
+ */
+export declare function cellsAreAdjacent(a: GridCellDescriptor, b: GridCellDescriptor): boolean;
+//# sourceMappingURL=grid.d.ts.map

package/dist/documents/render/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../src/documents/render/grid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;GAGG;AACH,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IAClC,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,MAA0B,EACpC,YAAY,GAAE,MAA+B,GAC3C,cAAc,CAkBhB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,MAAgC,GACvC,kBAAkB,EAAE,CAWtB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC5B,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAEtF"}

package/dist/documents/render/grid.js

@@ -0,0 +1,115 @@
+/**
+ * Foveated grid-geometry planner — pure, cloud-safe (no `node:*`, no deps).
+ *
+ * A SCHEMA read on a large/dense architectural sheet (e.g. a 34×44" E-size plan
+ * packing 6 small millwork details) fails when the page is rendered as ONE
+ * downscaled full-page image: each titled detail/elevation cell lands at ~800px,
+ * its text is illegible, and the structured extract returns ZERO rows. The fix is
+ * to split the page into a few square-ish HIGH-DPI cells, extract each, and merge.
+ *
+ * This module owns only the small geometry: given the full-page pixel size, choose
+ * a square-ish grid (`cols`×`rows`) bounded by a total-cell cap, and enumerate the
+ * cells. The actual per-cell pixel/DPI math lives INSIDE the render container
+ * (`apps/ai-web/containers/pdf-render/server.mjs#renderGridCell`), where the page's
+ * true point size is known — the worker only passes the `(col,row,cols,rows,overlap)`
+ * descriptor. We deliberately do NOT reuse `@vibesdotdev/ai`'s `planDescribeZoomGrid`:
+ * it works in PDF-point space and its public barrel re-exports `runVisionOcr`, which
+ * would drag the AI generation/logging graph into this package's cloud bundle. The
+ * geometry we need is tiny, so we replicate it here instead.
+ */
+/**
+ * Longest-edge threshold (px) above which a low-row full-page extract is treated
+ * as "downscale-capped and possibly illegible" → eligible for foveation.
+ */
+export const FOVEATE_MIN_LONGEST_EDGE_PX = 1600;
+/**
+ * Minimum row count from a full-page extract to consider the page "already
+ * legible" and skip foveation. < this on a large page triggers the grid read.
+ */
+export const FOVEATE_MIN_HEALTHY_ROWS = 3;
+/**
+ * Full-page pixels each grid cell maps to when choosing the grid shape. Smaller →
+ * MORE cells → the container renders each at a higher effective DPI (legibility).
+ * Tuned with FOVEATE_MAX_CELLS so an E-size sheet lands at ~6 cells (≈2×3 / 3×2).
+ */
+export const FOVEATE_TARGET_CELL_PX = 900;
+/**
+ * Hard cap on total cells per page. MUST cover a real detail sheet: an ARCH-D
+ * (36×24") interior-elevation sheet packs its details in a 3×2 grid (6 details) —
+ * measured on the Horizon Bay IFP set. At the old cap of 4, a 2400×1600 full-page
+ * render planned a 2×2 grid that sliced each detail across two cells (garbled
+ * extraction); 6 lets it plan the correct 3×2 so each cell ≈ one detail.
+ *
+ * Cost: 6 cells × ~20s serialized ≈ 120s, but the container renders all cells from
+ * ONE source fetch and the vision extracts run concurrently (CONCURRENCY=4 in
+ * foveatedExtract), so wall-clock is ~2 batches; the per-tool budget is 150s.
+ */
+export const FOVEATE_MAX_CELLS = 6;
+/** Default fractional overlap between adjacent cells (≈8%). */
+export const FOVEATE_DEFAULT_OVERLAP = 0.08;
+/**
+ * Choose a square-ish grid for a page of the given pixel size.
+ *
+ * Rule: `cols ≈ round(width / FOVEATE_TARGET_CELL_PX)` (likewise rows), each at
+ * least 1, then scale the grid DOWN proportionally if `cols*rows` exceeds
+ * `maxCells` so cells stay square-ish while honoring the cost cap. A tiny page
+ * (≤ target on both edges) yields a 1×1 grid (no foveation benefit).
+ */
+export function planFoveationGrid(pageWidthPx, pageHeightPx, maxCells = FOVEATE_MAX_CELLS, targetCellPx = FOVEATE_TARGET_CELL_PX) {
+    const safeW = Number.isFinite(pageWidthPx) && pageWidthPx > 0 ? pageWidthPx : 1;
+    const safeH = Number.isFinite(pageHeightPx) && pageHeightPx > 0 ? pageHeightPx : 1;
+    const cap = Math.max(1, Math.floor(maxCells));
+    const target = targetCellPx > 0 ? targetCellPx : FOVEATE_TARGET_CELL_PX;
+    let cols = Math.max(1, Math.round(safeW / target));
+    let rows = Math.max(1, Math.round(safeH / target));
+    // Honor the total-cell cap while keeping cells as square as possible: shrink
+    // the longer grid dimension first until cols*rows ≤ cap.
+    while (cols * rows > cap) {
+        if (cols >= rows && cols > 1)
+            cols -= 1;
+        else if (rows > 1)
+            rows -= 1;
+        else
+            break;
+    }
+    return { cols, rows };
+}
+/**
+ * Enumerate every cell of a `cols`×`rows` grid in row-major order, each carrying
+ * the full grid descriptor the renderer needs to crop it.
+ */
+export function enumerateGridCells(grid, overlap = FOVEATE_DEFAULT_OVERLAP) {
+    const cols = Math.max(1, Math.floor(grid.cols));
+    const rows = Math.max(1, Math.floor(grid.rows));
+    const clampedOverlap = Math.min(0.35, Math.max(0, overlap));
+    const cells = [];
+    for (let row = 0; row < rows; row++) {
+        for (let col = 0; col < cols; col++) {
+            cells.push({ col, row, cols, rows, overlap: clampedOverlap });
+        }
+    }
+    return cells;
+}
+/**
+ * Decide whether a page should be foveated after a full-page extract.
+ *
+ * True only when the full-page extract returned FEW rows (< healthyRows) AND the
+ * page is large enough to have been downscale-capped (longest edge ≥ threshold).
+ * A page that already yields healthy rows, or a small/simple page, is left alone.
+ */
+export function shouldFoveate(fullPageRowCount, pageWidthPx, pageHeightPx, opts = {}) {
+    const minHealthy = opts.minHealthyRows ?? FOVEATE_MIN_HEALTHY_ROWS;
+    const minEdge = opts.minLongestEdgePx ?? FOVEATE_MIN_LONGEST_EDGE_PX;
+    if (fullPageRowCount >= minHealthy)
+        return false;
+    const longest = Math.max(pageWidthPx ?? 0, pageHeightPx ?? 0);
+    return longest >= minEdge;
+}
+/**
+ * Are two grid cells adjacent (or the same cell)? Used to scope the cross-cell
+ * duplicate flag to seams where overlap could legitimately double-read a row.
+ */
+export function cellsAreAdjacent(a, b) {
+    return Math.abs(a.col - b.col) <= 1 && Math.abs(a.row - b.row) <= 1;
+}
+//# sourceMappingURL=grid.js.map

package/dist/documents/render/grid.js.map

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

package/dist/documents/render/index.d.ts

@@ -0,0 +1,2 @@
+export type { DocumentRenderer, RenderPageClipInput, RenderPageClipOutput, RenderOverviewInput } from './render.interface.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/documents/render/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/documents/render/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,MAAM,uBAAuB,CAAC"}

package/dist/documents/render/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/documents/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/documents/render/index.ts"],"names":[],"mappings":""}

package/dist/documents/render/render.impl.cloud.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cloud-scope DocumentRenderer implementation.
+ *
+ * Routes PDF rendering requests through the PdfRenderer Cloudflare Container
+ * Durable Object bound as `PDF_RENDERER` in ai-web's wrangler config.
+ * The Container wraps a Node.js HTTP server (apps/ai-web/containers/pdf-render/
+ * server.mjs) that uses pdftoppm (poppler-utils) to rasterise PDF pages and
+ * return base64-encoded PNG bytes.
+ *
+ * Calling pattern:
+ *   ns = runtime.getBinding('PDF_RENDERER', PdfRendererNamespaceSchema)
+ *   id = ns.idFromName('pdf-render')   // stable singleton for this worker
+ *   stub = ns.get(id)
+ *   stub.fetch('http://container/render', { method: 'POST', body: JSON.stringify({...}) })
+ *
+ * The Container base class routes the stub.fetch call to the container's HTTP
+ * server on its defaultPort (8080) — the 'http://container/' hostname is a
+ * Cloudflare convention for container-backed DOs.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { DocumentRenderer } from './render.interface.ts';
+/** The cloud renderer for the runtime a tool call was handed (a `DocumentRendererFactory`). */
+export declare function createCloudDocumentRenderer(runtime: VibesRuntime): DocumentRenderer;
+export default createCloudDocumentRenderer;
+//# sourceMappingURL=render.impl.cloud.d.ts.map

package/dist/documents/render/render.impl.cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.impl.cloud.d.ts","sourceRoot":"","sources":["../../../src/documents/render/render.impl.cloud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAA2E,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIjI,OAAO,KAAK,EACX,gBAAgB,EAQhB,MAAM,uBAAuB,CAAC;AAqP/B,+FAA+F;AAC/F,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAEnF;AAED,eAAe,2BAA2B,CAAC"}

package/dist/documents/render/render.impl.cloud.js

@@ -0,0 +1,245 @@
+/**
+ * Cloud-scope DocumentRenderer implementation.
+ *
+ * Routes PDF rendering requests through the PdfRenderer Cloudflare Container
+ * Durable Object bound as `PDF_RENDERER` in ai-web's wrangler config.
+ * The Container wraps a Node.js HTTP server (apps/ai-web/containers/pdf-render/
+ * server.mjs) that uses pdftoppm (poppler-utils) to rasterise PDF pages and
+ * return base64-encoded PNG bytes.
+ *
+ * Calling pattern:
+ *   ns = runtime.getBinding('PDF_RENDERER', PdfRendererNamespaceSchema)
+ *   id = ns.idFromName('pdf-render')   // stable singleton for this worker
+ *   stub = ns.get(id)
+ *   stub.fetch('http://container/render', { method: 'POST', body: JSON.stringify({...}) })
+ *
+ * The Container base class routes the stub.fetch call to the container's HTTP
+ * server on its defaultPort (8080) — the 'http://container/' hostname is a
+ * Cloudflare convention for container-backed DOs.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, isCapabilityError, settleNow, valueFreeFailure, settle } from '@vibesdotdev/kernel';
+import { serviceOrigin } from '@vibesdotdev/infra-core/service';
+import { AIServiceBindingSchema } from "../schemas/ai-service-binding.schema.js";
+import { DocumentOutlineSheetSchema, RenderPageClipInputSchema, RenderGridCellsInputSchema, DocumentOutlineInputSchema, createRenderPageClipResponseSchema, createDocumentOutlineMetadataSchema, RenderedGridCellSchema } from "./render.interface.js";
+import { buildOutlineFromPages } from "../outline/parse-outline.js";
+const LegacyOutlineSheetSchema = DocumentOutlineSheetSchema.extend({ page: DocumentOutlineSheetSchema.shape.page.default(0), number: DocumentOutlineSheetSchema.shape.number.default(''), title: DocumentOutlineSheetSchema.shape.title.default('') });
+const RawOutlinePageSchema = z.object({ page: z.number(), text: z.string() });
+const PdfRendererNamespaceMethodsSchema = z.object({ idFromName: z.function(), get: z.function() });
+/**
+ * The `PDF_RENDERER` binding's owning schema for `runtime.getBinding`. It
+ * admits the namespace itself, never a copy, so its methods keep their receiver.
+ */
+const PdfRendererNamespaceSchema = z.custom((value) => PdfRendererNamespaceMethodsSchema.safeParse(value).success);
+const ContainerRenderBodySchema = RenderPageClipInputSchema.omit({ clip: true, maxEdge: true }).extend({ clip: RenderPageClipInputSchema.shape.clipFrac, maxDim: RenderPageClipInputSchema.shape.maxEdge, gridCells: RenderGridCellsInputSchema.shape.cells.optional() });
+/**
+ * Remote pdf-render on ai-web. The origin is the declared `ai` `infra/service`
+ * internal origin in the handed runtime's configured service environment
+ * (rc04 §2.4) — no origin env, no literal default; an undeclared service
+ * fails `NOT_FOUND` `service-undeclared`. Bindings and the service token come
+ * from the same runtime.
+ */
+async function callRemotePdfRender(runtime, body, path = '/render') {
+    const binding = runtime.getBinding('AI_INTERNAL', AIServiceBindingSchema) ??
+        runtime.getBinding('AI_SERVICE', AIServiceBindingSchema);
+    const credential = await runtime.resolveCredential({
+        source: 'secret',
+        key: 'VIBES_INTERNAL_SERVICE_TOKEN'
+    });
+    // Only an absent credential yields an unauthenticated call; any other failure propagates.
+    if (!credential.ok && credential.error.reason !== 'credential-not-set')
+        throw credential.error;
+    const token = credential.ok ? credential.value.trim() : '';
+    const origin = (await serviceOrigin(runtime, 'ai', 'internal')).replace(/\/+$/, '');
+    const url = `${origin}/api/internal/pdf-render`;
+    const headers = token
+        ? { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` }
+        : { 'Content-Type': 'application/json' };
+    const reqInit = {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({ path, body })
+    };
+    const fetched = await settle(() => binding ? binding.fetch(url, reqInit) : fetch(url, reqInit));
+    if (!fetched.ok) {
+        if (isCapabilityError(fetched.cause))
+            throw fetched.cause;
+        throw new CapabilityError('PDF rendering service unavailable.', 'UNAVAILABLE', { reason: 'pdf-render-service-unavailable', cause: valueFreeFailure(fetched.cause) });
+    }
+    const response = fetched.value;
+    if (!response.ok)
+        throw new CapabilityError('PDF rendering service refused the request.', 'UNAVAILABLE', { reason: 'pdf-render-service-failed', details: { status: response.status } });
+    return response;
+}
+async function callContainer(runtime, body, path = '/render') {
+    // The CF container fetches the source over HTTP — it cannot resolve a
+    // providerId/path ref (which resolveSourceUrl turns into a non-fetchable
+    // vibes-storage:// URL). Fail with a clear, self-correcting message instead of
+    // the container's opaque "fetch failed" 500.
+    const src = body.sourceUrl;
+    if (!/^https?:\/\//i.test(src)) {
+        // Domain-neutral on purpose: this package is public framework and this string
+        // is MODEL-FACING. Naming one customer's tool here tells every other consumer
+        // to call a tool they do not have.
+        throw new CapabilityError('Document rendering requires a fetchable HTTP source URL.', 'INVALID_INPUT', { reason: 'pdf-render-source-invalid' });
+    }
+    const ns = runtime.getBinding('PDF_RENDERER', PdfRendererNamespaceSchema);
+    if (ns) {
+        // Use a stable singleton name so all requests within a colo share one
+        // container instance (the Container DO manages lifecycle and sleep/wake).
+        const id = ns.idFromName('pdf-render');
+        const stub = ns.get(id);
+        // 'http://container/' is the Cloudflare convention for routing stub.fetch()
+        // to the container's HTTP server (Container.defaultPort = 8080).
+        const fetched = await settle(() => stub.fetch(`http://container${path}`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) }));
+        if (!fetched.ok) {
+            if (isCapabilityError(fetched.cause))
+                throw fetched.cause;
+            throw new CapabilityError('PDF container unavailable.', 'UNAVAILABLE', { reason: 'pdf-render-container-unavailable', cause: valueFreeFailure(fetched.cause) });
+        }
+        const response = fetched.value;
+        if (!response.ok)
+            throw new CapabilityError('PDF container refused the request.', 'UNAVAILABLE', { reason: 'pdf-render-container-failed', details: { status: response.status } });
+        return response;
+    }
+    // When PDF_RENDERER is not bound in-process (e.g. chat-web running document.view/read),
+    // delegate to ai-web via AI_SERVICE/AI_INTERNAL or HTTP.
+    return callRemotePdfRender(runtime, body, path);
+}
+async function callContainerRender(runtime, body) {
+    const response = await callContainer(runtime, body);
+    const admitted = await settle(async () => createRenderPageClipResponseSchema(runtime, 'pdf-render-invalid-response').parse(await response.json()));
+    if (admitted.ok)
+        return admitted.value;
+    if (isCapabilityError(admitted.cause))
+        throw admitted.cause;
+    throw new CapabilityError('PDF render response is invalid.', 'INTERNAL', { reason: 'pdf-render-invalid-response', cause: valueFreeFailure(admitted.cause) });
+}
+class CloudDocumentRenderer {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async renderPageClip(input) {
+        const body = {
+            sourceUrl: input.sourceUrl,
+            page: input.page
+        };
+        if (input.clip) {
+            body.clip = {
+                x: input.clip.x,
+                y: input.clip.y,
+                w: input.clip.width,
+                h: input.clip.height
+            };
+        }
+        if (input.clipFrac) {
+            body.clipFrac = input.clipFrac;
+        }
+        if (input.dpi !== undefined) {
+            body.dpi = input.dpi;
+        }
+        if (input.maxEdge !== undefined) {
+            body.maxDim = input.maxEdge;
+        }
+        if (input.gridCell) {
+            body.gridCell = input.gridCell;
+        }
+        return callContainerRender(this.runtime, body);
+    }
+    async renderOverview(input) {
+        // page=0 signals the render server to render the full page at overview DPI.
+        const body = {
+            sourceUrl: input.sourceUrl,
+            page: 0
+        };
+        if (input.dpi !== undefined) {
+            body.dpi = input.dpi;
+        }
+        return callContainerRender(this.runtime, body);
+    }
+    async renderGridCells(input) {
+        // ONE container call → ONE source fetch → all cells cropped from it. This is
+        // the SharePoint-safe path: a pre-auth download token is rejected (401) when
+        // fetched repeatedly/concurrently, so foveation must not fetch per cell.
+        const raw = await callContainer(this.runtime, {
+            sourceUrl: input.sourceUrl,
+            page: input.page,
+            gridCells: input.cells
+        });
+        const imageSchema = createRenderPageClipResponseSchema(this.runtime, 'pdf-render-grid-cell-invalid');
+        const cellSchema = z.preprocess(value => {
+            const admitted = settleNow(() => ({ ...RenderedGridCellSchema.pick({ col: true, row: true }).parse(value), ...imageSchema.parse(value) }));
+            if (admitted.ok)
+                return admitted.value;
+            const failure = isCapabilityError(admitted.cause) ? admitted.cause : new CapabilityError('PDF grid cell is invalid.', 'INTERNAL', { reason: 'pdf-render-grid-cell-invalid', cause: valueFreeFailure(admitted.cause) });
+            settleNow(() => this.runtime.diagnostics.error('PDF grid cell refused', { scope: 'docs', plugin: 'docs', error: failure }));
+            return undefined;
+        }, RenderedGridCellSchema.optional());
+        const decoded = await settle(async () => z.object({ cells: z.array(cellSchema) }).parse(await raw.json()));
+        if (!decoded.ok) {
+            if (isCapabilityError(decoded.cause))
+                throw decoded.cause;
+            throw new CapabilityError('PDF grid response is invalid.', 'INTERNAL', { reason: 'pdf-render-grid-invalid-response', cause: valueFreeFailure(decoded.cause) });
+        }
+        return decoded.value.cells.filter(cell => cell !== undefined);
+    }
+    async outline(input) {
+        const response = await callContainer(this.runtime, { sourceUrl: input.sourceUrl }, '/outline');
+        const admitted = await settle(async () => {
+            const raw = await response.json();
+            const metadata = createDocumentOutlineMetadataSchema(this.runtime).parse(raw);
+            const sheetSchema = z.preprocess(value => {
+                const sheet = settleNow(() => LegacyOutlineSheetSchema.omit({ garbled: true }).parse(value));
+                if (sheet.ok) {
+                    const garbled = settleNow(() => LegacyOutlineSheetSchema.pick({ garbled: true }).parse(value));
+                    if (garbled.ok)
+                        return { ...sheet.value, ...garbled.value };
+                    const failure = isCapabilityError(garbled.cause) ? garbled.cause : new CapabilityError('Document outline metadata is invalid.', 'INTERNAL', { reason: 'pdf-render-metadata-invalid', cause: valueFreeFailure(garbled.cause) });
+                    settleNow(() => this.runtime.diagnostics.error('Document outline metadata refused', { scope: 'docs', plugin: 'docs', error: failure }));
+                    return sheet.value;
+                }
+                const failure = isCapabilityError(sheet.cause) ? sheet.cause : new CapabilityError('PDF outline sheet is invalid.', 'INTERNAL', { reason: 'pdf-render-outline-sheet-invalid', cause: valueFreeFailure(sheet.cause) });
+                settleNow(() => this.runtime.diagnostics.error('PDF outline sheet refused', { scope: 'docs', plugin: 'docs', error: failure }));
+                return undefined;
+            }, LegacyOutlineSheetSchema.optional());
+            const legacy = z.object({ sheets: z.array(sheetSchema) }).safeParse(raw);
+            if (legacy.success) {
+                const sheets = legacy.data.sheets.filter(sheet => sheet !== undefined).map(sheet => {
+                    const result = { page: sheet.page, number: sheet.number, title: sheet.title };
+                    if (sheet.garbled)
+                        result.garbled = true;
+                    return result;
+                });
+                if (sheets.length > 0)
+                    return { ...metadata, sheets };
+            }
+            const pageSchema = z.preprocess(value => {
+                const page = settleNow(() => RawOutlinePageSchema.parse(value));
+                if (page.ok)
+                    return page.value;
+                const failure = isCapabilityError(page.cause) ? page.cause : new CapabilityError('PDF outline page is invalid.', 'INTERNAL', { reason: 'pdf-render-outline-page-invalid', cause: valueFreeFailure(page.cause) });
+                settleNow(() => this.runtime.diagnostics.error('PDF outline page refused', { scope: 'docs', plugin: 'docs', error: failure }));
+                return undefined;
+            }, RawOutlinePageSchema.optional());
+            const pages = z.object({ pages: z.array(pageSchema) }).safeParse(raw);
+            if (!pages.success) {
+                if (legacy.success && legacy.data.sheets.length === 0 && z.object({ pages: z.undefined().optional() }).safeParse(raw).success)
+                    return buildOutlineFromPages({ ...metadata, pages: [] });
+                throw new CapabilityError('PDF outline response is invalid.', 'INTERNAL', { reason: 'pdf-render-outline-invalid-response', cause: valueFreeFailure(pages.error) });
+            }
+            return buildOutlineFromPages({ ...metadata, pages: pages.data.pages.filter(page => page !== undefined) });
+        });
+        if (admitted.ok)
+            return admitted.value;
+        if (isCapabilityError(admitted.cause))
+            throw admitted.cause;
+        throw new CapabilityError('PDF outline response is invalid.', 'INTERNAL', { reason: 'pdf-render-outline-invalid-response', cause: valueFreeFailure(admitted.cause) });
+    }
+}
+/** The cloud renderer for the runtime a tool call was handed (a `DocumentRendererFactory`). */
+export function createCloudDocumentRenderer(runtime) {
+    return new CloudDocumentRenderer(runtime);
+}
+export default createCloudDocumentRenderer;
+//# sourceMappingURL=render.impl.cloud.js.map

package/dist/documents/render/render.impl.cloud.js.map

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

package/dist/documents/render/render.impl.consumer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Consumer-scope DocumentRenderer implementation.
+ *
+ * Delegates page rendering to the PDF-OCR drainer process via HTTP.
+ * The drainer runs mupdf (native) and accepts internal render requests
+ * on its `/internal/render` endpoint.
+ *
+ * TODO(WS0): Wire VIBES_PDF_RENDER_ORIGIN in wrangler.toml / vibes config
+ *   for the consumer environment. The drainer already exposes the endpoint;
+ *   this impl just needs the origin bound.
+ *
+ * TODO(WS0): The drainer `/internal/render` request/response contract:
+ *   POST ${VIBES_PDF_RENDER_ORIGIN}/internal/render
+ *   Content-Type: application/json
+ *   Body: { sourceUrl: string, page: number, clip?: { x, y, width, height }, dpi?: number }
+ *   Response: { pngBase64: string }
+ *
+ *   For renderOverview:
+ *   POST ${VIBES_PDF_RENDER_ORIGIN}/internal/render
+ *   Body: { sourceUrl: string, page: 0, dpi?: number }   // page=0 = full overview
+ *   Response: { pngBase64: string }
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { DocumentRenderer, RenderOverviewInput, RenderPageClipInput, RenderPageClipOutput, RenderGridCellsInput, RenderedGridCell, DocumentOutlineInput, DocumentOutlineOutput } from './render.interface.ts';
+export declare class ConsumerDocumentRenderer implements DocumentRenderer {
+    private runtime;
+    constructor(runtime: VibesRuntime);
+    renderPageClip(input: RenderPageClipInput): Promise<RenderPageClipOutput>;
+    renderOverview(input: RenderOverviewInput): Promise<RenderPageClipOutput>;
+    renderGridCells(input: RenderGridCellsInput): Promise<RenderedGridCell[]>;
+    outline(_input: DocumentOutlineInput): Promise<DocumentOutlineOutput>;
+}
+export declare function createConsumerDocumentRenderer(runtime: VibesRuntime): DocumentRenderer;
+export default createConsumerDocumentRenderer;
+//# sourceMappingURL=render.impl.consumer.d.ts.map

package/dist/documents/render/render.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.impl.consumer.d.ts","sourceRoot":"","sources":["../../../src/documents/render/render.impl.consumer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAgE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGtH,OAAO,KAAK,EACX,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,MAAM,uBAAuB,CAAC;AAmC/B,qBAAa,wBAAyB,YAAW,gBAAgB;IACpD,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY;IAEnC,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAczE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAWzE,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAWzE,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAM3E;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAEtF;AAED,eAAe,8BAA8B,CAAC"}