@proveanything/smartlinks 2.0.28 → 2.0.29

package/dist/ai-tools.d.ts

@@ -29,6 +29,8 @@ export declare const AI_TOOL_NAMES: {
     readonly PDF_INSPECT: "pdf.inspect";
     readonly PDF_RENDER: "pdf.render";
     readonly PDF_EXTRACT: "pdf.extract";
+    readonly PDF_DECODE_BARCODES: "pdf.decodeBarcodes";
+    readonly PDF_INSPECT_GRAPHICS: "pdf.inspectGraphics";
     readonly HTTP_REQUEST: "http.request";
     readonly TRANSLATE: "translate";
 };

package/dist/ai-tools.js

@@ -26,6 +26,8 @@ export const AI_TOOL_NAMES = {
     PDF_INSPECT: 'pdf.inspect',
     PDF_RENDER: 'pdf.render',
     PDF_EXTRACT: 'pdf.extract',
+    PDF_DECODE_BARCODES: 'pdf.decodeBarcodes',
+    PDF_INSPECT_GRAPHICS: 'pdf.inspectGraphics',
     HTTP_REQUEST: 'http.request',
     TRANSLATE: 'translate',
 };
@@ -66,7 +68,11 @@ export const BUILTIN_AI_TOOLS = [
     { name: 'pdf.render', group: 'media', capabilities: ['web:read'],
         description: 'Rasterize a single PDF page to a PNG at a controllable DPI (e.g. 300 for small print) and return a hosted image URL — feed to a vision call or screenshot a page.' },
     { name: 'pdf.extract', group: 'media', capabilities: ['web:read', 'ai:vision'],
-        description: 'Extract typed JSON from a PDF in one call given a schema and/or prompt. Auto-routes: text-layer pages use cheap text extraction; curve-only/raster pages are rendered and read with vision.' },
+        description: 'Extract typed JSON from a PDF in one call given a schema and/or prompt. Auto-routes: text-layer pages use cheap text extraction; curve-only/raster pages are rendered and read with vision. Optional per-field confidence/source (includeConfidence) and bounding boxes (includeBoxes).' },
+    { name: 'pdf.decodeBarcodes', group: 'media', capabilities: ['web:read'],
+        description: 'Deterministically decode 1D/2D barcodes (EAN/UPC/QR/Code128/DataMatrix/…) on a PDF page by rasterizing and running a WASM decoder — reliable barcode/QR values where vision hallucinates. Returns value, symbology, page, bbox, confidence. No AI.' },
+    { name: 'pdf.inspectGraphics', group: 'media', capabilities: ['web:read'],
+        description: 'Prepress structural inspection: per-page vector-path/image/outlined-text counts + colour spaces used, plus document-level named SPOT colours (e.g. "PANTONE 871 C"). Answers whether spot/foil plates survived. Deterministic, no AI.' },
     { name: 'http.request', group: 'net', capabilities: ['net:http'],
         description: 'SSRF-guarded outbound HTTP(S) request to a public URL; returns status/headers/body.' },
     { name: 'translate', group: 'text', capabilities: ['ai:text'],

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.28  |  Generated: 2026-09-28T13:20:09.049Z
+Version: 2.0.29  |  Generated: 2026-09-29T10:33:46.286Z
 
 This is a concise summary of all available API functions and types.
 
@@ -1485,7 +1485,21 @@ interface PdfRenderArgs {
 **PdfExtractArgs** (interface)
 ```typescript
 interface PdfExtractArgs {
-  url: string; schema?: Record<string, any>; prompt?: string; maxPages?: number; dpi?: number
+  url: string; schema?: Record<string, any>; prompt?: string; maxPages?: number; dpi?: number; includeConfidence?: boolean; includeBoxes?: boolean
+}
+```
+
+**PdfDecodeBarcodesArgs** (interface)
+```typescript
+interface PdfDecodeBarcodesArgs {
+  url: string; page?: number; dpi?: number
+}
+```
+
+**PdfInspectGraphicsArgs** (interface)
+```typescript
+interface PdfInspectGraphicsArgs {
+  url: string; page?: number
 }
 ```
 
@@ -1524,6 +1538,8 @@ interface AiToolArgsMap {
   'pdf.inspect': PdfInspectArgs
   'pdf.render': PdfRenderArgs
   'pdf.extract': PdfExtractArgs
+  'pdf.decodeBarcodes': PdfDecodeBarcodesArgs
+  'pdf.inspectGraphics': PdfInspectGraphicsArgs
   'http.request': HttpRequestArgs
   'translate': TranslateArgs
 }
@@ -1613,10 +1629,45 @@ interface PdfRenderResult {
 }
 ```
 
+**PdfFieldMeta** (interface)
+```typescript
+interface PdfFieldMeta {
+  confidence?: number | null; source?: 'text' | 'vision' | 'inferred'; bbox?: { x: number; y: number; w: number; h: number; page: number }
+}
+```
+
 **PdfExtractResult** (interface)
 ```typescript
 interface PdfExtractResult {
-  url: string; method: 'text' | 'vision'; pagesRead: number; fields: Record<string, any>
+  url: string; method: 'text' | 'vision'; pagesRead: number; fields: Record<string, any>; fieldsMeta?: Record<string, PdfFieldMeta>
+}
+```
+
+**PdfBarcode** (interface)
+```typescript
+interface PdfBarcode {
+  type: string; format: string; value: string; page: number; bbox?: { x: number; y: number; w: number; h: number }; confidence: number
+}
+```
+
+**PdfDecodeBarcodesResult** (interface)
+```typescript
+interface PdfDecodeBarcodesResult {
+  url: string; pagesScanned: number; codes: PdfBarcode[]
+}
+```
+
+**PdfGraphicsPage** (interface)
+```typescript
+interface PdfGraphicsPage {
+  page: number; paths: number; images: number; textRuns: number; colourSpaces: string[]
+}
+```
+
+**PdfInspectGraphicsResult** (interface)
+```typescript
+interface PdfInspectGraphicsResult {
+  url: string; pages: PdfGraphicsPage[]; spotColours: string[]; note: string
 }
 ```
 

package/dist/docs/ai.md

@@ -324,15 +324,40 @@ in `input`.
 | `image.searchStock` | Search real stock photos (Unsplash). |
 | `image.transform` | Resize / crop / rotate / grayscale / format-convert / compress → hosted URL. |
 | `pdf.create` | Render HTML → PDF → hosted URL. |
-| `pdf.fill` | Fill an AcroForm PDF's fields → hosted URL. |
-| `pdf.merge` | Merge several PDFs into one → hosted URL. |
+| `pdf.fill` | Fill an AcroForm PDF's fields (`{ field: value }`) → hosted URL. |
+| `pdf.merge` | Merge several PDFs into one, in order → hosted URL. |
+| `pdf.inspect` | Cheap, no-AI introspection: page count/sizes, which pages have a real text layer, raster present, and a routing hint (`text` vs `vision`). |
+| `pdf.render` | Rasterize one page to a PNG at a chosen DPI → hosted image URL (feed to vision, or screenshot a page). |
+| `pdf.extract` | PDF → typed JSON in one call (schema and/or prompt). Auto-routes text vs vision. Optional per-field `confidence`/`source` (`includeConfidence`) and `bbox` (`includeBoxes`) in `fieldsMeta`. |
+| `pdf.decodeBarcodes` | Deterministically decode barcodes/QR on a page (WASM, no AI) → value + symbology + page + bbox + confidence. Use this for barcode digits, never vision. |
+| `pdf.inspectGraphics` | Prepress inspection: per-page path/image/outlined-text counts + colour spaces, plus named SPOT colours (e.g. "PANTONE 871 C"). No AI. |
 | `http.request` | SSRF-guarded outbound HTTP(S) to a public URL (call a REST API). |
 | `translate` | Translate text into one or more languages (generic, model-based). |
 
+**Working with PDFs.** The PDF tools split into *read/analyse* and *produce*:
+
+- **Read a whole PDF as text** → `document.read` (Firecrawl; good for prose/decks).
+- **Turn a PDF into structured fields** → `pdf.extract` (give it a JSON schema and/or a prompt; it
+  returns typed JSON). It routes itself, but you can drive the route yourself: call `pdf.inspect`
+  first (deterministic, no AI) to see whether each page has a real text layer, then `pdf.extract`
+  (cheap text path) or `pdf.render` → `image.describe`/vision for curve-only or raster artwork.
+- **Zoom in on small print** (INCI/allergen lists) → `pdf.render` at a high DPI (e.g. 300), then read
+  the PNG with vision.
+- **Barcodes / QR** → `pdf.decodeBarcodes` (deterministic WASM decode) — never trust vision for barcode
+  digits; it hallucinates them.
+- **Prepress / print QA** (spot colours, colour spaces, vector vs raster) → `pdf.inspectGraphics`.
+- **A review UI that flags guessed fields** → `pdf.extract` with `includeConfidence` (per-field
+  confidence + source) and `includeBoxes` (per-field bbox on text-native pages) in `fieldsMeta`.
+- **Produce a PDF** → `pdf.create` (HTML → PDF), `pdf.fill` (populate an AcroForm's fields),
+  `pdf.merge` (combine several). These return a hosted `hostedUrl`.
+
+Every tool is also directly callable without the model loop via `ai.tools.run(collectionId, name,
+args)` — e.g. render a page or extract fields straight from a UI, no agent round-trip.
+
 Discover tools two ways:
 - **Design time (typed):** import `BUILTIN_AI_TOOLS`, `AI_TOOL_NAMES`, and the per-tool arg types
-  (`WebSearchArgs`, `DataExtractArgs`, …) from the SDK. This is the core set — stable, versioned,
-  documented here.
+  (`WebSearchArgs`, `DataExtractArgs`, `PdfExtractArgs`, …) from the SDK. This is the core set —
+  stable, versioned, documented here.
 - **Runtime (live):** `await ai.catalog(collectionId)` returns the registry as the server sees it,
   including any future app-contributed tools. The built-in set above is always present.
 

package/dist/docs/server-functions.md

@@ -400,6 +400,12 @@ Prefer the platform primitives above over a dependency; when you do need one, pi
 | Schema validation of inputs | no | `zod` |
 | JWT (sign/verify for a third-party API) | Web Crypto can, verbosely | `jose` |
 | Hash / HMAC / encrypt | **native** — `crypto.subtle` | — |
+| PDF **text** extraction (cheap first-pass, no AI) | no | `unpdf` — a serverless/WASM pdf.js build with no Node deps; `import { extractText } from 'unpdf'`. Text only. |
+
+> **PDFs in a server function:** for a cheap text-layer check use `unpdf` (edge-safe, WASM). For
+> anything heavier — rendering pages, vision extraction, **barcode/QR decode**, or prepress/spot-colour
+> inspection — call the platform tools `pdf.render` / `pdf.extract` / `pdf.decodeBarcodes` /
+> `pdf.inspectGraphics` via `ai.tools.run`; those run in the full platform runtime, not the sandbox.
 
 **The common actions, and how to do each:**
 

package/dist/openapi.yaml

@@ -17064,6 +17064,22 @@ components:
           additionalProperties: true
       required:
         - url
+    PdfDecodeBarcodesArgs:
+      type: object
+      properties:
+        url:
+          type: object
+          additionalProperties: true
+      required:
+        - url
+    PdfInspectGraphicsArgs:
+      type: object
+      properties:
+        url:
+          type: object
+          additionalProperties: true
+      required:
+        - url
     HttpRequestArgs:
       type: object
       properties:
@@ -17125,6 +17141,10 @@ components:
           $ref: "#/components/schemas/PdfRenderArgs"
         pdf.extract:
           $ref: "#/components/schemas/PdfExtractArgs"
+        pdf.decodeBarcodes:
+          $ref: "#/components/schemas/PdfDecodeBarcodesArgs"
+        pdf.inspectGraphics:
+          $ref: "#/components/schemas/PdfInspectGraphicsArgs"
         http.request:
           $ref: "#/components/schemas/HttpRequestArgs"
         translate:
@@ -17148,6 +17168,8 @@ components:
         - pdf.inspect
         - pdf.render
         - pdf.extract
+        - pdf.decodeBarcodes
+        - pdf.inspectGraphics
         - http.request
         - translate
     WebSearchResultItem:
@@ -17256,6 +17278,12 @@ components:
           additionalProperties: true
       required:
         - url
+    PdfFieldMeta:
+      type: object
+      properties:
+        confidence:
+          type: object
+          additionalProperties: true
     PdfExtractResult:
       type: object
       properties:
@@ -17266,6 +17294,42 @@ components:
             - vision
       required:
         - url
+    PdfBarcode:
+      type: object
+      properties:
+        type:
+          type: object
+          additionalProperties: true
+      required:
+        - type
+    PdfDecodeBarcodesResult:
+      type: object
+      properties:
+        url:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+      required:
+        - url
+    PdfGraphicsPage:
+      type: object
+      properties:
+        page:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+      required:
+        - page
+    PdfInspectGraphicsResult:
+      type: object
+      properties:
+        url:
+          type: object
+          additionalProperties: true
+      required:
+        - url
     ResponsesAgentTrace:
       type: object
       properties:
@@ -17347,6 +17411,8 @@ components:
         - pdf.inspect
         - pdf.render
         - pdf.extract
+        - pdf.decodeBarcodes
+        - pdf.inspectGraphics
         - http.request
         - translate
     AgentStreamEvent:

package/dist/types/ai.d.ts

@@ -848,7 +848,7 @@ export interface CatalogResponse {
 /** Capability tags a tool requires; scope a run with `allowCapabilities`. */
 export type AiToolCapability = 'web:read' | 'ai:vision' | 'ai:image' | 'ai:text' | 'media:image' | 'media:pdf' | 'net:http';
 /** The names of the built-in server-side agent tools (run via `server_tools`). */
-export type AiToolName = 'web.fetchPage' | 'web.extractSchema' | 'web.screenshot' | 'web.search' | 'brand.assets' | 'document.read' | 'data.extract' | 'image.describe' | 'image.generate' | 'image.fromReference' | 'image.searchStock' | 'image.transform' | 'pdf.create' | 'pdf.fill' | 'pdf.merge' | 'pdf.inspect' | 'pdf.render' | 'pdf.extract' | 'http.request' | 'translate';
+export type AiToolName = 'web.fetchPage' | 'web.extractSchema' | 'web.screenshot' | 'web.search' | 'brand.assets' | 'document.read' | 'data.extract' | 'image.describe' | 'image.generate' | 'image.fromReference' | 'image.searchStock' | 'image.transform' | 'pdf.create' | 'pdf.fill' | 'pdf.merge' | 'pdf.inspect' | 'pdf.render' | 'pdf.extract' | 'pdf.decodeBarcodes' | 'pdf.inspectGraphics' | 'http.request' | 'translate';
 export interface WebFetchPageArgs {
     url: string;
     type?: string;
@@ -956,6 +956,17 @@ export interface PdfExtractArgs {
     prompt?: string;
     maxPages?: number;
     dpi?: number;
+    includeConfidence?: boolean;
+    includeBoxes?: boolean;
+}
+export interface PdfDecodeBarcodesArgs {
+    url: string;
+    page?: number;
+    dpi?: number;
+}
+export interface PdfInspectGraphicsArgs {
+    url: string;
+    page?: number;
 }
 export interface HttpRequestArgs {
     url: string;
@@ -988,6 +999,8 @@ export interface AiToolArgsMap {
     'pdf.inspect': PdfInspectArgs;
     'pdf.render': PdfRenderArgs;
     'pdf.extract': PdfExtractArgs;
+    'pdf.decodeBarcodes': PdfDecodeBarcodesArgs;
+    'pdf.inspectGraphics': PdfInspectGraphicsArgs;
     'http.request': HttpRequestArgs;
     'translate': TranslateArgs;
 }
@@ -1077,11 +1090,56 @@ export interface PdfRenderResult {
     width: number;
     height: number;
 }
+/** Per-field metadata from pdf.extract when includeConfidence / includeBoxes is set. */
+export interface PdfFieldMeta {
+    confidence?: number | null;
+    source?: 'text' | 'vision' | 'inferred';
+    bbox?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        page: number;
+    };
+}
 export interface PdfExtractResult {
     url: string;
     method: 'text' | 'vision';
     pagesRead: number;
     fields: Record<string, any>;
+    fieldsMeta?: Record<string, PdfFieldMeta>;
+}
+/** One decoded barcode/QR from pdf.decodeBarcodes. bbox is in PDF points (top-left origin). */
+export interface PdfBarcode {
+    type: string;
+    format: string;
+    value: string;
+    page: number;
+    bbox?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    confidence: number;
+}
+export interface PdfDecodeBarcodesResult {
+    url: string;
+    pagesScanned: number;
+    codes: PdfBarcode[];
+}
+export interface PdfGraphicsPage {
+    page: number;
+    paths: number;
+    images: number;
+    textRuns: number;
+    colourSpaces: string[];
+}
+export interface PdfInspectGraphicsResult {
+    url: string;
+    pages: PdfGraphicsPage[];
+    spotColours: string[];
+    note: string;
 }
 /** The `_agent` trace attached to an agentic Responses result. */
 export interface ResponsesAgentTrace {

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.28  |  Generated: 2026-09-28T13:20:09.049Z
+Version: 2.0.29  |  Generated: 2026-09-29T10:33:46.286Z
 
 This is a concise summary of all available API functions and types.
 
@@ -1485,7 +1485,21 @@ interface PdfRenderArgs {
 **PdfExtractArgs** (interface)
 ```typescript
 interface PdfExtractArgs {
-  url: string; schema?: Record<string, any>; prompt?: string; maxPages?: number; dpi?: number
+  url: string; schema?: Record<string, any>; prompt?: string; maxPages?: number; dpi?: number; includeConfidence?: boolean; includeBoxes?: boolean
+}
+```
+
+**PdfDecodeBarcodesArgs** (interface)
+```typescript
+interface PdfDecodeBarcodesArgs {
+  url: string; page?: number; dpi?: number
+}
+```
+
+**PdfInspectGraphicsArgs** (interface)
+```typescript
+interface PdfInspectGraphicsArgs {
+  url: string; page?: number
 }
 ```
 
@@ -1524,6 +1538,8 @@ interface AiToolArgsMap {
   'pdf.inspect': PdfInspectArgs
   'pdf.render': PdfRenderArgs
   'pdf.extract': PdfExtractArgs
+  'pdf.decodeBarcodes': PdfDecodeBarcodesArgs
+  'pdf.inspectGraphics': PdfInspectGraphicsArgs
   'http.request': HttpRequestArgs
   'translate': TranslateArgs
 }
@@ -1613,10 +1629,45 @@ interface PdfRenderResult {
 }
 ```
 
+**PdfFieldMeta** (interface)
+```typescript
+interface PdfFieldMeta {
+  confidence?: number | null; source?: 'text' | 'vision' | 'inferred'; bbox?: { x: number; y: number; w: number; h: number; page: number }
+}
+```
+
 **PdfExtractResult** (interface)
 ```typescript
 interface PdfExtractResult {
-  url: string; method: 'text' | 'vision'; pagesRead: number; fields: Record<string, any>
+  url: string; method: 'text' | 'vision'; pagesRead: number; fields: Record<string, any>; fieldsMeta?: Record<string, PdfFieldMeta>
+}
+```
+
+**PdfBarcode** (interface)
+```typescript
+interface PdfBarcode {
+  type: string; format: string; value: string; page: number; bbox?: { x: number; y: number; w: number; h: number }; confidence: number
+}
+```
+
+**PdfDecodeBarcodesResult** (interface)
+```typescript
+interface PdfDecodeBarcodesResult {
+  url: string; pagesScanned: number; codes: PdfBarcode[]
+}
+```
+
+**PdfGraphicsPage** (interface)
+```typescript
+interface PdfGraphicsPage {
+  page: number; paths: number; images: number; textRuns: number; colourSpaces: string[]
+}
+```
+
+**PdfInspectGraphicsResult** (interface)
+```typescript
+interface PdfInspectGraphicsResult {
+  url: string; pages: PdfGraphicsPage[]; spotColours: string[]; note: string
 }
 ```
 

package/docs/ai.md

@@ -324,15 +324,40 @@ in `input`.
 | `image.searchStock` | Search real stock photos (Unsplash). |
 | `image.transform` | Resize / crop / rotate / grayscale / format-convert / compress → hosted URL. |
 | `pdf.create` | Render HTML → PDF → hosted URL. |
-| `pdf.fill` | Fill an AcroForm PDF's fields → hosted URL. |
-| `pdf.merge` | Merge several PDFs into one → hosted URL. |
+| `pdf.fill` | Fill an AcroForm PDF's fields (`{ field: value }`) → hosted URL. |
+| `pdf.merge` | Merge several PDFs into one, in order → hosted URL. |
+| `pdf.inspect` | Cheap, no-AI introspection: page count/sizes, which pages have a real text layer, raster present, and a routing hint (`text` vs `vision`). |
+| `pdf.render` | Rasterize one page to a PNG at a chosen DPI → hosted image URL (feed to vision, or screenshot a page). |
+| `pdf.extract` | PDF → typed JSON in one call (schema and/or prompt). Auto-routes text vs vision. Optional per-field `confidence`/`source` (`includeConfidence`) and `bbox` (`includeBoxes`) in `fieldsMeta`. |
+| `pdf.decodeBarcodes` | Deterministically decode barcodes/QR on a page (WASM, no AI) → value + symbology + page + bbox + confidence. Use this for barcode digits, never vision. |
+| `pdf.inspectGraphics` | Prepress inspection: per-page path/image/outlined-text counts + colour spaces, plus named SPOT colours (e.g. "PANTONE 871 C"). No AI. |
 | `http.request` | SSRF-guarded outbound HTTP(S) to a public URL (call a REST API). |
 | `translate` | Translate text into one or more languages (generic, model-based). |
 
+**Working with PDFs.** The PDF tools split into *read/analyse* and *produce*:
+
+- **Read a whole PDF as text** → `document.read` (Firecrawl; good for prose/decks).
+- **Turn a PDF into structured fields** → `pdf.extract` (give it a JSON schema and/or a prompt; it
+  returns typed JSON). It routes itself, but you can drive the route yourself: call `pdf.inspect`
+  first (deterministic, no AI) to see whether each page has a real text layer, then `pdf.extract`
+  (cheap text path) or `pdf.render` → `image.describe`/vision for curve-only or raster artwork.
+- **Zoom in on small print** (INCI/allergen lists) → `pdf.render` at a high DPI (e.g. 300), then read
+  the PNG with vision.
+- **Barcodes / QR** → `pdf.decodeBarcodes` (deterministic WASM decode) — never trust vision for barcode
+  digits; it hallucinates them.
+- **Prepress / print QA** (spot colours, colour spaces, vector vs raster) → `pdf.inspectGraphics`.
+- **A review UI that flags guessed fields** → `pdf.extract` with `includeConfidence` (per-field
+  confidence + source) and `includeBoxes` (per-field bbox on text-native pages) in `fieldsMeta`.
+- **Produce a PDF** → `pdf.create` (HTML → PDF), `pdf.fill` (populate an AcroForm's fields),
+  `pdf.merge` (combine several). These return a hosted `hostedUrl`.
+
+Every tool is also directly callable without the model loop via `ai.tools.run(collectionId, name,
+args)` — e.g. render a page or extract fields straight from a UI, no agent round-trip.
+
 Discover tools two ways:
 - **Design time (typed):** import `BUILTIN_AI_TOOLS`, `AI_TOOL_NAMES`, and the per-tool arg types
-  (`WebSearchArgs`, `DataExtractArgs`, …) from the SDK. This is the core set — stable, versioned,
-  documented here.
+  (`WebSearchArgs`, `DataExtractArgs`, `PdfExtractArgs`, …) from the SDK. This is the core set —
+  stable, versioned, documented here.
 - **Runtime (live):** `await ai.catalog(collectionId)` returns the registry as the server sees it,
   including any future app-contributed tools. The built-in set above is always present.
 

package/docs/server-functions.md

@@ -400,6 +400,12 @@ Prefer the platform primitives above over a dependency; when you do need one, pi
 | Schema validation of inputs | no | `zod` |
 | JWT (sign/verify for a third-party API) | Web Crypto can, verbosely | `jose` |
 | Hash / HMAC / encrypt | **native** — `crypto.subtle` | — |
+| PDF **text** extraction (cheap first-pass, no AI) | no | `unpdf` — a serverless/WASM pdf.js build with no Node deps; `import { extractText } from 'unpdf'`. Text only. |
+
+> **PDFs in a server function:** for a cheap text-layer check use `unpdf` (edge-safe, WASM). For
+> anything heavier — rendering pages, vision extraction, **barcode/QR decode**, or prepress/spot-colour
+> inspection — call the platform tools `pdf.render` / `pdf.extract` / `pdf.decodeBarcodes` /
+> `pdf.inspectGraphics` via `ai.tools.run`; those run in the full platform runtime, not the sandbox.
 
 **The common actions, and how to do each:**
 

package/openapi.yaml

@@ -17064,6 +17064,22 @@ components:
           additionalProperties: true
       required:
         - url
+    PdfDecodeBarcodesArgs:
+      type: object
+      properties:
+        url:
+          type: object
+          additionalProperties: true
+      required:
+        - url
+    PdfInspectGraphicsArgs:
+      type: object
+      properties:
+        url:
+          type: object
+          additionalProperties: true
+      required:
+        - url
     HttpRequestArgs:
       type: object
       properties:
@@ -17125,6 +17141,10 @@ components:
           $ref: "#/components/schemas/PdfRenderArgs"
         pdf.extract:
           $ref: "#/components/schemas/PdfExtractArgs"
+        pdf.decodeBarcodes:
+          $ref: "#/components/schemas/PdfDecodeBarcodesArgs"
+        pdf.inspectGraphics:
+          $ref: "#/components/schemas/PdfInspectGraphicsArgs"
         http.request:
           $ref: "#/components/schemas/HttpRequestArgs"
         translate:
@@ -17148,6 +17168,8 @@ components:
         - pdf.inspect
         - pdf.render
         - pdf.extract
+        - pdf.decodeBarcodes
+        - pdf.inspectGraphics
         - http.request
         - translate
     WebSearchResultItem:
@@ -17256,6 +17278,12 @@ components:
           additionalProperties: true
       required:
         - url
+    PdfFieldMeta:
+      type: object
+      properties:
+        confidence:
+          type: object
+          additionalProperties: true
     PdfExtractResult:
       type: object
       properties:
@@ -17266,6 +17294,42 @@ components:
             - vision
       required:
         - url
+    PdfBarcode:
+      type: object
+      properties:
+        type:
+          type: object
+          additionalProperties: true
+      required:
+        - type
+    PdfDecodeBarcodesResult:
+      type: object
+      properties:
+        url:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+      required:
+        - url
+    PdfGraphicsPage:
+      type: object
+      properties:
+        page:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+      required:
+        - page
+    PdfInspectGraphicsResult:
+      type: object
+      properties:
+        url:
+          type: object
+          additionalProperties: true
+      required:
+        - url
     ResponsesAgentTrace:
       type: object
       properties:
@@ -17347,6 +17411,8 @@ components:
         - pdf.inspect
         - pdf.render
         - pdf.extract
+        - pdf.decodeBarcodes
+        - pdf.inspectGraphics
         - http.request
         - translate
     AgentStreamEvent:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "2.0.28",
+  "version": "2.0.29",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "type": "module",
   "main": "dist/index.js",