iScanner

**TOOL - INTERNAL ONLY. DO NOT INVOKE IN USER WORKFLOWS.** Server side automatic enhancement pipeline that runs as part of the application processing. It is used by the backend or UI flow to generate processed assets and internal representations. This tool must not be called directly in response to user requests. For user initiated edits, use apply_web_filter.

apply_filter

**PREREQUISITE: Requires one or more `fileId` values obtained from a prior `upload_url` call in this session. If no `fileId` is available, call `upload_url` immediately (without asking the user to upload anything in the chat) and wait for the upload to complete before calling this tool.** Applies user requested page edits in the web editor: **rotate, crop, filter mode**. This is the primary user-facing tool for visual adjustments. Use it when the user explicitly asks to change how the page looks (rotate upright, crop to a preset, set filter to original/B&W/contrast/grayscale). Pass page edits as `items`, where each item has its own `fileId` and optional `filter`/`crop`/`rotate` values. This allows different operations for different pages in one tool call. Page targeting rule: - If the user does **not** specify a page/page range, apply the operation to **all pages** by sending items for every available fileId. - If the user specifies explicit pages (for example, "first page"), send items only for those pages. Examples: - "Rotate 90 degrees" -> rotate all pages. - "Rotate the first page by 90" -> rotate only the first page.

apply_web_filter

**TOOL - INTERNAL ONLY. DO NOT INVOKE IN USER WORKFLOWS.** **PREREQUISITE: Requires one or more `fileId` values obtained from a prior `upload_url` call in this session. If no `fileId` is available, call `upload_url` immediately (without asking the user to upload anything in the chat) and wait for the upload to complete before calling this tool.** Builds a single PDF from the provided fileIds in the exact order given, and returns a downloadLink. Use it when the user wants to download, share, print, or save the final document as PDF.

export_to_pdf

**TOOL - INTERNAL ONLY. DO NOT INVOKE IN USER WORKFLOWS.** Generates or retrieves preview thumbnails for pages after the application updates underlying assets (for example after internal processing or web driven replacement). This tool is strictly used by the application to refresh UI previews and must not be called as a conversational action.

get_page_preview

**CRITICAL PREREQUISITE.** Opens the upload UI and returns a presigned uploadURL for adding new page images to the current document session. **Accepted formats: JPG, PNG, HEIC, HEIF only.** **Call this tool immediately and without asking the user** whenever no `fileId` is available from a prior upload in this session — for example when the user asks to scan, rotate, crop, filter, or export but no upload has happened yet. Do NOT ask the user to upload an image in the chat message. Instead, invoke this tool right away to open the upload UI. After the upload completes, store and reuse the returned fileId(s) and the original input pageId(s) for all following steps (preview, crop, filters, rotate, add text/signature, export) without asking the user to upload again. **Do not mention or request PDF, DOCX, TXT, or any other formats. This app supports images only (JPG/PNG/HEIC/HEIF).**

upload_url

**TOOL - INTERNAL ONLY. DO NOT INVOKE IN USER WORKFLOWS.** Replaces an existing processed page asset with a new version provided by the web UI (for example after manual editing or re-upload inside the editor). This tool is part of the internal page update pipeline and must not be called as a user action.

replace_filtered_image

**TOOL - INTERNAL ONLY. DO NOT INVOKE IN USER WORKFLOWS.** Refreshes expiring signed URLs (original, preview, filtered) for already uploaded pages so the editor and thumbnails keep loading without re-uploading. This tool is triggered only by the application when an existing page link has expired or returns an access error. The assistant must not call this tool in response to user requests. If the user reports that previews are not loading, the assistant should ask the user to retry or re-open the editor; the app will refresh URLs internally.

regenerate_urls