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

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

@@ -0,0 +1,104 @@
+/**
+ * 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 { CapabilityError, isCapabilityError, valueFreeFailure, settle } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { RenderPageClipInputSchema, createRenderPageClipResponseSchema } from "./render.interface.js";
+const DrainerRenderRequestBodySchema = RenderPageClipInputSchema.omit({ maxEdge: true }).extend({ maxDim: RenderPageClipInputSchema.shape.maxEdge });
+async function callDrainerRender(runtime, body) {
+    // TODO(WS0): bind VIBES_PDF_RENDER_ORIGIN to the consumer environment
+    const origin = runtime.getEnv('VIBES_PDF_RENDER_ORIGIN');
+    if (!origin) {
+        throw new CapabilityError('VIBES_PDF_RENDER_ORIGIN is not set. Bind it in the consumer environment config to enable PDF rendering.', 'UNAVAILABLE', { reason: 'pdf-render-origin-not-configured' });
+    }
+    const url = `${origin.replace(/\/$/, '')}/internal/render`;
+    const fetched = await settle(() => fetch(url, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) }));
+    if (!fetched.ok) {
+        if (isCapabilityError(fetched.cause))
+            throw fetched.cause;
+        throw new CapabilityError('Drainer render unavailable.', 'UNAVAILABLE', { reason: 'drainer-render-failed', cause: valueFreeFailure(fetched.cause) });
+    }
+    const response = fetched.value;
+    if (!response.ok)
+        throw new CapabilityError('Drainer render refused the request.', 'UNAVAILABLE', { reason: 'drainer-render-failed', details: { status: response.status } });
+    const decoded = await settle(async () => createRenderPageClipResponseSchema(runtime, 'drainer-render-invalid-response').parse(await response.json()));
+    if (!decoded.ok) {
+        if (isCapabilityError(decoded.cause))
+            throw decoded.cause;
+        throw new CapabilityError('Drainer render response is invalid.', 'INTERNAL', { reason: 'drainer-render-invalid-response', cause: valueFreeFailure(decoded.cause) });
+    }
+    return decoded.value;
+}
+export class ConsumerDocumentRenderer {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async renderPageClip(input) {
+        const body = {
+            sourceUrl: input.sourceUrl,
+            page: input.page
+        };
+        if (input.clip)
+            body.clip = input.clip;
+        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 callDrainerRender(this.runtime, body);
+    }
+    async renderOverview(input) {
+        // page=0 signals the drainer to render a full-document overview composite.
+        const body = {
+            sourceUrl: input.sourceUrl,
+            page: 0
+        };
+        if (input.dpi !== undefined)
+            body.dpi = input.dpi;
+        return callDrainerRender(this.runtime, body);
+    }
+    async renderGridCells(input) {
+        // Consumer/drainer scope has no single-fetch batch endpoint; render each cell
+        // via the per-cell path (the cloud impl is the SharePoint-safe single-fetch one).
+        const out = [];
+        for (const cell of input.cells) {
+            const r = await this.renderPageClip({ sourceUrl: input.sourceUrl, page: input.page, gridCell: cell });
+            out.push({ col: cell.col, row: cell.row, ...r });
+        }
+        return out;
+    }
+    async outline(_input) {
+        // The drainer-backed consumer renderer has no text-layer outline endpoint; the
+        // outline (index-first targeting) is a cloud-container capability. Consumer/CLI
+        // surfaces read pages directly, so this returns an empty index rather than throw.
+        return { pageCount: 0, pageWidthIn: null, pageHeightIn: null, sheets: [] };
+    }
+}
+export function createConsumerDocumentRenderer(runtime) {
+    return new ConsumerDocumentRenderer(runtime);
+}
+export default createConsumerDocumentRenderer;
+//# sourceMappingURL=render.impl.consumer.js.map

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

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

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

@@ -0,0 +1,147 @@
+/**
+ * DocumentRenderer interface.
+ *
+ * Internal (non-tool) contract for rendering page images from a document URL.
+ * Two implementations exist:
+ *   - render.impl.consumer.ts — HTTP delegate to the PDF-OCR drainer
+ *   - render.impl.cloud.ts   — container binding or declared remote PDF service
+ *
+ * The plugin selects the correct impl at load time based on runtime scope.
+ * Neither impl is exported from the package's public surface — only the plugin
+ * and the document-read impl import them directly.
+ */
+import * as z from 'zod/v4';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+/** JSON wire shapes owned by the renderer boundary. Geometry is unchanged. */
+export declare const RenderGridCellSpecSchema: z.ZodObject<{
+    col: z.ZodNumber;
+    row: z.ZodNumber;
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+    overlap: z.ZodNumber;
+}, z.core.$strip>;
+export declare const RenderPageClipInputSchema: z.ZodObject<{
+    sourceUrl: z.ZodString;
+    page: z.ZodNumber;
+    clip: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    clipFrac: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>>;
+    dpi: z.ZodOptional<z.ZodNumber>;
+    maxEdge: z.ZodOptional<z.ZodNumber>;
+    gridCell: z.ZodOptional<z.ZodObject<{
+        col: z.ZodNumber;
+        row: z.ZodNumber;
+        cols: z.ZodNumber;
+        rows: z.ZodNumber;
+        overlap: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const RenderPageClipOutputSchema: z.ZodObject<{
+    pngBase64: z.ZodString;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const RenderOverviewInputSchema: z.ZodObject<{
+    sourceUrl: z.ZodString;
+    dpi: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const RenderGridCellsInputSchema: z.ZodObject<{
+    sourceUrl: z.ZodString;
+    page: z.ZodNumber;
+    cells: z.ZodArray<z.ZodObject<{
+        col: z.ZodNumber;
+        row: z.ZodNumber;
+        cols: z.ZodNumber;
+        rows: z.ZodNumber;
+        overlap: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const RenderedGridCellSchema: z.ZodObject<{
+    pngBase64: z.ZodString;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    col: z.ZodNumber;
+    row: z.ZodNumber;
+}, z.core.$strip>;
+export declare const DocumentOutlineInputSchema: z.ZodObject<{
+    sourceUrl: z.ZodString;
+}, z.core.$strip>;
+export declare const DocumentOutlineSheetSchema: z.ZodObject<{
+    page: z.ZodNumber;
+    number: z.ZodString;
+    title: z.ZodString;
+    garbled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const DocumentOutlineOutputSchema: z.ZodObject<{
+    pageCount: z.ZodNumber;
+    pageWidthIn: z.ZodNullable<z.ZodNumber>;
+    pageHeightIn: z.ZodNullable<z.ZodNumber>;
+    sheets: z.ZodArray<z.ZodObject<{
+        page: z.ZodNumber;
+        number: z.ZodString;
+        title: z.ZodString;
+        garbled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    textLayerReliable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RenderGridCellSpec = z.infer<typeof RenderGridCellSpecSchema>;
+export type RenderPageClipInput = z.infer<typeof RenderPageClipInputSchema>;
+export type RenderPageClipOutput = z.infer<typeof RenderPageClipOutputSchema>;
+export type RenderOverviewInput = z.infer<typeof RenderOverviewInputSchema>;
+export type RenderGridCellsInput = z.infer<typeof RenderGridCellsInputSchema>;
+export type RenderedGridCell = z.infer<typeof RenderedGridCellSchema>;
+export type DocumentOutlineInput = z.infer<typeof DocumentOutlineInputSchema>;
+export type DocumentOutlineSheet = z.infer<typeof DocumentOutlineSheetSchema>;
+export type DocumentOutlineOutput = z.infer<typeof DocumentOutlineOutputSchema>;
+/** Selected image fields admit independently of optional metadata. */
+export declare function createRenderPageClipResponseSchema(runtime: VibesRuntime, reason: 'pdf-render-invalid-response' | 'pdf-render-grid-cell-invalid' | 'drainer-render-invalid-response'): z.ZodPreprocess<z.ZodObject<{
+    pngBase64: z.ZodString;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, unknown>;
+/** Optional outline facts cannot invalidate admitted sheet/page content. */
+export declare function createDocumentOutlineMetadataSchema(runtime: VibesRuntime): z.ZodPreprocess<z.ZodObject<{
+    pageCount: z.ZodNumber;
+    pageWidthIn: z.ZodNullable<z.ZodNumber>;
+    pageHeightIn: z.ZodNullable<z.ZodNumber>;
+    textLayerReliable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, unknown>;
+/**
+ * Builds the renderer for the runtime a tool call was handed, so a renderer
+ * resolves its declared services (e.g. the cloud renderer's remote pdf-render
+ * origin) on that runtime, never an ambient one.
+ */
+export type DocumentRendererFactory = (runtime: VibesRuntime) => DocumentRenderer;
+export interface DocumentRenderer {
+    /**
+     * Render a clip (or full page) of a document page to a PNG.
+     */
+    renderPageClip(input: RenderPageClipInput): Promise<RenderPageClipOutput>;
+    /**
+     * Render a low-DPI overview of the full document (all pages tiled or
+     * single composite) suitable for TOC/structure extraction.
+     */
+    renderOverview(input: RenderOverviewInput): Promise<RenderPageClipOutput>;
+    /**
+     * Render MANY foveated grid cells from a SINGLE source fetch. The source URL
+     * (e.g. a SharePoint pre-auth token) is fetched ONCE and all cells are cropped
+     * from it — fetching it once per cell concurrently gets the token rejected (401).
+     */
+    renderGridCells(input: RenderGridCellsInput): Promise<RenderedGridCell[]>;
+    /**
+     * Read the document's sheet index from its TEXT LAYER (pdfinfo + pdftotext, NO
+     * vision/render). The "read the index first" step: the agent uses this to target
+     * only the casework sheets instead of vision-scanning every page.
+     */
+    outline(input: DocumentOutlineInput): Promise<DocumentOutlineOutput>;
+}
+//# sourceMappingURL=render.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.interface.d.ts","sourceRoot":"","sources":["../../../src/documents/render/render.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAmE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzH,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB;;;;;;iBAA0G,CAAC;AAChJ,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;iBAKpC,CAAC;AACH,eAAO,MAAM,0BAA0B;;;;iBAAmG,CAAC;AAC3I,eAAO,MAAM,yBAAyB;;;iBAAkE,CAAC;AACzG,eAAO,MAAM,0BAA0B;;;;;;;;;;iBAAkG,CAAC;AAC1I,eAAO,MAAM,sBAAsB;;;;;;iBAA0E,CAAC;AAC9G,eAAO,MAAM,0BAA0B;;iBAAsC,CAAC;AAC9E,eAAO,MAAM,0BAA0B;;;;;iBAAyG,CAAC;AACjJ,eAAO,MAAM,2BAA2B;;;;;;;;;;;iBAAuM,CAAC;AAChP,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,sEAAsE;AACtE,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,6BAA6B,GAAG,8BAA8B,GAAG,iCAAiC;;;;4BAsBnL;AAED,4EAA4E;AAC5E,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,YAAY;;;;;4BA4BxE;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,gBAAgB,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE1E;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE1E;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE1E;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrE"}

package/dist/documents/render/render.interface.js

@@ -0,0 +1,90 @@
+/**
+ * DocumentRenderer interface.
+ *
+ * Internal (non-tool) contract for rendering page images from a document URL.
+ * Two implementations exist:
+ *   - render.impl.consumer.ts — HTTP delegate to the PDF-OCR drainer
+ *   - render.impl.cloud.ts   — container binding or declared remote PDF service
+ *
+ * The plugin selects the correct impl at load time based on runtime scope.
+ * Neither impl is exported from the package's public surface — only the plugin
+ * and the document-read impl import them directly.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, isCapabilityError, settleNow, valueFreeFailure } from '@vibesdotdev/kernel';
+/** JSON wire shapes owned by the renderer boundary. Geometry is unchanged. */
+export const RenderGridCellSpecSchema = z.object({ col: z.number(), row: z.number(), cols: z.number(), rows: z.number(), overlap: z.number() });
+export const RenderPageClipInputSchema = z.object({
+    sourceUrl: z.string(), page: z.number(),
+    clip: z.object({ x: z.number(), y: z.number(), width: z.number(), height: z.number() }).optional(),
+    clipFrac: z.object({ x: z.number(), y: z.number(), w: z.number(), h: z.number() }).optional(),
+    dpi: z.number().optional(), maxEdge: z.number().optional(), gridCell: RenderGridCellSpecSchema.optional()
+});
+export const RenderPageClipOutputSchema = z.object({ pngBase64: z.string(), width: z.number().optional(), height: z.number().optional() });
+export const RenderOverviewInputSchema = z.object({ sourceUrl: z.string(), dpi: z.number().optional() });
+export const RenderGridCellsInputSchema = z.object({ sourceUrl: z.string(), page: z.number(), cells: z.array(RenderGridCellSpecSchema) });
+export const RenderedGridCellSchema = RenderPageClipOutputSchema.extend({ col: z.number(), row: z.number() });
+export const DocumentOutlineInputSchema = z.object({ sourceUrl: z.string() });
+export const DocumentOutlineSheetSchema = z.object({ page: z.number(), number: z.string(), title: z.string(), garbled: z.boolean().optional() });
+export const DocumentOutlineOutputSchema = z.object({ pageCount: z.number(), pageWidthIn: z.number().nullable(), pageHeightIn: z.number().nullable(), sheets: z.array(DocumentOutlineSheetSchema), textLayerReliable: z.boolean().optional() });
+/** Selected image fields admit independently of optional metadata. */
+export function createRenderPageClipResponseSchema(runtime, reason) {
+    return z.preprocess(value => {
+        const required = settleNow(() => RenderPageClipOutputSchema.pick({ pngBase64: true }).parse(value));
+        if (!required.ok) {
+            if (isCapabilityError(required.cause))
+                throw required.cause;
+            throw new CapabilityError('Document render response is invalid.', 'INTERNAL', { reason, cause: valueFreeFailure(required.cause) });
+        }
+        const image = required.value;
+        for (const metadata of [
+            { key: 'width', schema: RenderPageClipOutputSchema.pick({ width: true }).transform(data => data.width) },
+            { key: 'height', schema: RenderPageClipOutputSchema.pick({ height: true }).transform(data => data.height) }
+        ]) {
+            const admitted = settleNow(() => metadata.schema.parse(value));
+            if (admitted.ok) {
+                if (admitted.value !== undefined)
+                    image[metadata.key] = admitted.value;
+            }
+            else {
+                const failure = isCapabilityError(admitted.cause) ? admitted.cause : new CapabilityError('Document render metadata is invalid.', 'INTERNAL', { reason: 'pdf-render-metadata-invalid', cause: valueFreeFailure(admitted.cause) });
+                settleNow(() => runtime.diagnostics.error('Document render metadata refused', { scope: 'docs', plugin: 'docs', error: failure }));
+            }
+        }
+        return image;
+    }, RenderPageClipOutputSchema);
+}
+/** Optional outline facts cannot invalidate admitted sheet/page content. */
+export function createDocumentOutlineMetadataSchema(runtime) {
+    const metadataSchema = DocumentOutlineOutputSchema.omit({ sheets: true });
+    return z.preprocess(value => {
+        const metadata = {
+            pageCount: DocumentOutlineOutputSchema.pick({ pageCount: true }).extend({ pageCount: DocumentOutlineOutputSchema.shape.pageCount.default(0) }).parse(value).pageCount,
+            pageWidthIn: null,
+            pageHeightIn: null
+        };
+        for (const geometry of [
+            { key: 'pageWidthIn', schema: metadataSchema.pick({ pageWidthIn: true }).extend({ pageWidthIn: metadataSchema.shape.pageWidthIn.default(null) }).transform(data => data.pageWidthIn) },
+            { key: 'pageHeightIn', schema: metadataSchema.pick({ pageHeightIn: true }).extend({ pageHeightIn: metadataSchema.shape.pageHeightIn.default(null) }).transform(data => data.pageHeightIn) }
+        ]) {
+            const admitted = settleNow(() => geometry.schema.parse(value));
+            if (admitted.ok)
+                metadata[geometry.key] = admitted.value;
+            else {
+                const failure = isCapabilityError(admitted.cause) ? admitted.cause : new CapabilityError('Document outline metadata is invalid.', 'INTERNAL', { reason: 'pdf-render-metadata-invalid', cause: valueFreeFailure(admitted.cause) });
+                settleNow(() => runtime.diagnostics.error('Document outline metadata refused', { scope: 'docs', plugin: 'docs', error: failure }));
+            }
+        }
+        const reliability = settleNow(() => metadataSchema.pick({ textLayerReliable: true }).parse(value));
+        if (reliability.ok) {
+            if (reliability.value.textLayerReliable !== undefined)
+                metadata.textLayerReliable = reliability.value.textLayerReliable;
+        }
+        else {
+            const failure = isCapabilityError(reliability.cause) ? reliability.cause : new CapabilityError('Document outline metadata is invalid.', 'INTERNAL', { reason: 'pdf-render-metadata-invalid', cause: valueFreeFailure(reliability.cause) });
+            settleNow(() => runtime.diagnostics.error('Document outline metadata refused', { scope: 'docs', plugin: 'docs', error: failure }));
+        }
+        return metadata;
+    }, metadataSchema);
+}
+//# sourceMappingURL=render.interface.js.map

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

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

package/dist/documents/schemas/ai-service-binding.schema.d.ts

@@ -0,0 +1,11 @@
+import * as z from 'zod/v4';
+/** The ai worker's service binding (`AI_INTERNAL`, `AI_SERVICE`): a worker-to-worker fetcher. */
+export interface AIServiceBinding {
+    fetch(input: string, init?: RequestInit): Promise<Response>;
+}
+/**
+ * The ai service bindings' owning schema for `runtime.getBinding`. It admits
+ * the native binding itself, never a copy, so `fetch` keeps its receiver.
+ */
+export declare const AIServiceBindingSchema: z.ZodCustom<AIServiceBinding, AIServiceBinding>;
+//# sourceMappingURL=ai-service-binding.schema.d.ts.map

package/dist/documents/schemas/ai-service-binding.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-service-binding.schema.d.ts","sourceRoot":"","sources":["../../../src/documents/schemas/ai-service-binding.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,iGAAiG;AACjG,MAAM,WAAW,gBAAgB;IAChC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5D;AAID;;;GAGG;AACH,eAAO,MAAM,sBAAsB,iDAElC,CAAC"}

package/dist/documents/schemas/ai-service-binding.schema.js

@@ -0,0 +1,8 @@
+import * as z from 'zod/v4';
+const AIServiceBindingMethodsSchema = z.object({ fetch: z.function() });
+/**
+ * The ai service bindings' owning schema for `runtime.getBinding`. It admits
+ * the native binding itself, never a copy, so `fetch` keeps its receiver.
+ */
+export const AIServiceBindingSchema = z.custom((value) => AIServiceBindingMethodsSchema.safeParse(value).success);
+//# sourceMappingURL=ai-service-binding.schema.js.map

package/dist/documents/schemas/ai-service-binding.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-service-binding.schema.js","sourceRoot":"","sources":["../../../src/documents/schemas/ai-service-binding.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAO5B,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC7C,CAAC,KAAK,EAAE,EAAE,CAAC,6BAA6B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CACjE,CAAC"}

package/dist/documents/schemas/document-read.schema.d.ts

@@ -0,0 +1,107 @@
+/**
+ * document.read tool schemas.
+ *
+ * Input/output schemas for the `document.read` tool. These schemas are
+ * MCP-safe: no .refine(), .transform(), .pipe(), or .preprocess() — the
+ * MCP JSON-schema adapter (z.toJSONSchema) rejects those. Validation and
+ * business logic live in the impl.
+ */
+import * as z from 'zod/v4';
+/**
+ * Minimal document ref — identifies the source document.
+ *
+ * Deliberately NOT imported from @vibesdotdev/storage to avoid a dep cycle
+ * (storage depends on runtime; documents depends on storage; importing the
+ * storage ref type back into the schema layer would close that cycle on the
+ * schema surface which must stay dep-free).
+ */
+export declare const DocumentRefSchema: z.ZodObject<{
+    providerId: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    documentId: z.ZodOptional<z.ZodString>;
+    sourceRefreshUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DocumentRef = z.infer<typeof DocumentRefSchema>;
+export declare const DocumentReadInputSchema: z.ZodObject<{
+    ref: z.ZodObject<{
+        providerId: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        documentId: z.ZodOptional<z.ZodString>;
+        sourceRefreshUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    pages: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    question: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    schemaId: z.ZodOptional<z.ZodString>;
+    vocabulary: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    rowContainerKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    instructions: z.ZodOptional<z.ZodString>;
+    modelName: z.ZodOptional<z.ZodString>;
+    visionFocusHint: z.ZodOptional<z.ZodString>;
+    promptVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DocumentReadInput = z.infer<typeof DocumentReadInputSchema>;
+export declare const DocumentPageResultSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    title: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+    cacheHit: z.ZodBoolean;
+    status: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        ready: "ready";
+        processing: "processing";
+    }>>;
+    cacheKey: z.ZodOptional<z.ZodString>;
+    jobId: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DocumentPageResult = z.infer<typeof DocumentPageResultSchema>;
+export declare const DocumentReadMarkdownOutputSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"markdown">;
+    pages: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        title: z.ZodOptional<z.ZodString>;
+        text: z.ZodString;
+        cacheHit: z.ZodBoolean;
+        status: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            ready: "ready";
+            processing: "processing";
+        }>>;
+        cacheKey: z.ZodOptional<z.ZodString>;
+        jobId: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const DocumentReadStructuredOutputSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"structured">;
+    rows: z.ZodArray<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+    diagnostics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+}, z.core.$strip>;
+export declare const DocumentReadOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"markdown">;
+    pages: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        title: z.ZodOptional<z.ZodString>;
+        text: z.ZodString;
+        cacheHit: z.ZodBoolean;
+        status: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            ready: "ready";
+            processing: "processing";
+        }>>;
+        cacheKey: z.ZodOptional<z.ZodString>;
+        jobId: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"structured">;
+    rows: z.ZodArray<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+    diagnostics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+}, z.core.$strip>], "kind">;
+export type DocumentReadMarkdownOutput = z.infer<typeof DocumentReadMarkdownOutputSchema>;
+export type DocumentReadStructuredOutput = z.infer<typeof DocumentReadStructuredOutputSchema>;
+export type DocumentReadOutput = z.infer<typeof DocumentReadOutputSchema>;
+//# sourceMappingURL=document-read.schema.d.ts.map

package/dist/documents/schemas/document-read.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-read.schema.d.ts","sourceRoot":"","sources":["../../../src/documents/schemas/document-read.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;;;iBAW5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;iBAiElC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;iBAiBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;iBAG3C,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;iBAI7C,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;2BAGnC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAC9F,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/documents/schemas/document-read.schema.js

@@ -0,0 +1,124 @@
+/**
+ * document.read tool schemas.
+ *
+ * Input/output schemas for the `document.read` tool. These schemas are
+ * MCP-safe: no .refine(), .transform(), .pipe(), or .preprocess() — the
+ * MCP JSON-schema adapter (z.toJSONSchema) rejects those. Validation and
+ * business logic live in the impl.
+ */
+import * as z from 'zod/v4';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+/**
+ * Minimal document ref — identifies the source document.
+ *
+ * Deliberately NOT imported from @vibesdotdev/storage to avoid a dep cycle
+ * (storage depends on runtime; documents depends on storage; importing the
+ * storage ref type back into the schema layer would close that cycle on the
+ * schema surface which must stay dep-free).
+ */
+export const DocumentRefSchema = z.object({
+    /** Storage provider id (e.g. a SharePoint or Vibes-R2 provider id). */
+    providerId: z.string().optional(),
+    /** Path within the provider (relative key or object path). */
+    path: z.string().optional(),
+    /** Fully-qualified URL for externally-hosted documents. */
+    url: z.string().optional(),
+    /** Owning document id, when the producer can refresh short-lived URLs. */
+    documentId: z.string().optional(),
+    /** Internal endpoint that mints a fresh source URL for async reads. */
+    sourceRefreshUrl: z.string().optional()
+});
+// ---------------------------------------------------------------------------
+// document.read — input
+// ---------------------------------------------------------------------------
+export const DocumentReadInputSchema = z.object({
+    /** Identifies the source document. One of providerId+path or url is required. */
+    ref: DocumentRefSchema,
+    /**
+     * 1-based page numbers to read. When omitted the tool reads a TOC/overview
+     * pass first, then returns guidance on which pages to target.
+     */
+    pages: z.array(z.number().int().positive()).optional(),
+    /** Free-form question to answer from the document. */
+    question: z.string().optional(),
+    /**
+     * JSON-schema for structured extraction. When present the tool returns
+     * `kind: 'structured'` output with typed rows instead of raw markdown.
+     * Inline schema takes precedence over schemaId when both are provided.
+     */
+    schema: z.record(z.string(), z.unknown()).optional(),
+    /**
+     * Runtime-registered schema id for structured extraction. When set and
+     * `schema` is not provided, the impl resolves the schema from the runtime
+     * via `runtime.query('ai/extraction-schema').withId(schemaId)` and uses its
+     * `descriptor.jsonSchema` as the extract schema.
+     *
+     * Example: `'casework.cabinet'` resolves the casework cabinet-row schema.
+     */
+    schemaId: z.string().optional(),
+    /**
+     * Domain-specific vocabulary hints for the OCR/vision model (e.g. trade
+     * names, part numbers, abbreviations). Improves recognition accuracy.
+     */
+    vocabulary: z.array(z.string()).optional(),
+    /**
+     * Extra object keys the vision model may wrap the extracted row array under,
+     * declared by the schema's owner (filled from the resolved extraction-schema
+     * descriptor's `rowContainerKeys`). Forwarded to the extractor as data.
+     */
+    rowContainerKeys: z.array(z.string()).optional(),
+    /** Additional freeform instructions forwarded to the OCR/extract model. */
+    instructions: z.string().optional(),
+    /**
+     * Optional OCR/vision model override (resolver name, e.g. 'google/gemini-2.5-flash').
+     * Normally left unset by callers — `document.read` fills it from the resolved
+     * extraction-schema descriptor's `preferredModelName` so a DOMAIN declares the model
+     * it needs. An explicit caller value takes precedence; both override the global default.
+     */
+    modelName: z.string().optional(),
+    /**
+     * Hint for the vision tiling step — "dense text", "large drawing", "table",
+     * etc. Controls foveation parameters in the drainer.
+     */
+    visionFocusHint: z.string().optional(),
+    /**
+     * Prompt version string used as a cache-key component. Bump this to
+     * invalidate cached OCR for a given ref+page combination.
+     */
+    promptVersion: z.string().optional()
+});
+// ---------------------------------------------------------------------------
+// document.read — output (discriminated union on `kind`)
+// ---------------------------------------------------------------------------
+export const DocumentPageResultSchema = z.object({
+    /** 1-based page index. */
+    index: z.number().int().positive(),
+    /** Optional section title extracted from the TOC or heading. */
+    title: z.string().optional(),
+    /** OCR / vision markdown text for this page. */
+    text: z.string(),
+    /** True when the result was served from the documents.page-cache. */
+    cacheHit: z.boolean(),
+    /** Async read status for large foveated sheets. */
+    status: z.enum(['ready', 'processing', 'error']).optional(),
+    /** Cache key to re-read after an async foveated read completes. */
+    cacheKey: z.string().optional(),
+    /** Queue job id, when this call started a background foveated read. */
+    jobId: z.string().optional(),
+    /** Human-readable status for the model/caller. */
+    message: z.string().optional()
+});
+export const DocumentReadMarkdownOutputSchema = z.object({
+    kind: z.literal('markdown'),
+    pages: z.array(DocumentPageResultSchema)
+});
+export const DocumentReadStructuredOutputSchema = z.object({
+    kind: z.literal('structured'),
+    rows: z.array(JsonValueSchema),
+    diagnostics: z.record(z.string(), JsonValueSchema).optional()
+});
+export const DocumentReadOutputSchema = z.discriminatedUnion('kind', [
+    DocumentReadMarkdownOutputSchema,
+    DocumentReadStructuredOutputSchema
+]);
+//# sourceMappingURL=document-read.schema.js.map

package/dist/documents/schemas/document-read.schema.js.map

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