@khotan/cli 0.8.0 → 0.9.0

package/README.md

@@ -142,7 +142,7 @@ documented surface and the executable surface cannot drift. Run `khotan help` or
 | App env   | `apps env list <id>`, `apps env set <id> <KEY> --value V`, `apps env reveal <id> <KEY>`, `apps env unset <id> <KEY>`, `apps env bulk-set <id> --var A=1 --var B=2` |
 | Pipelines | same shape as apps under `pipelines …` |
 | Databases | `databases list`, `databases create --name db`, `databases connection <id>`, `databases rotate-credentials <id>`, `databases delete <id>` |
-| Files     | `files list`, `files get <id>`, `files upload <path>`, `files download <id> --output <path>`, `files update <id> --name new.txt`, `files delete <id>` |
+| Files     | `files list`, `files get <id>`, `files upload <path>`, `files download <id> --output <path>`, `files download-url <id>`, `files preview-url <id>`, `files update <id> --name new.txt`, `files delete <id>` |
 | Folders   | `folders list`, `folders create --name docs`, `folders rename <id> --name new`, `folders delete <id>` |
 | Context   | `context list`, `context get <slug>`, `context raw <slug>`, `context create --title T --kind knowledge --content '...'`, `context update <slug> --expected-revision 3 --content '...'`, `context delete <slug>` |
 
@@ -173,6 +173,17 @@ khotan files upload ./report.pdf --folder-path /reports/2026
 khotan files download file_123 --output ./report.pdf
 ```
 
+To hand a file to a browser instead of saving it locally, mint a short-lived
+presigned URL and load it directly (no API key on the URL; expires in ~5 minutes):
+
+```bash
+khotan files preview-url file_123     # inline disposition, images and PDFs only
+khotan files download-url file_123    # attachment disposition, any file type
+```
+
+See [Serving file attachments](../../docs/files-api-attachments.md) for the full
+preview/download flow and the receiver wiring guidance.
+
 ## MCP server
 
 `khotan mcp serve` starts a local stdio MCP server that reuses the same profile,

package/dist/khotan.js

@@ -906,6 +906,19 @@ var init_catalog = __esm(() => {
       cli: { command: ["files", "download-url"], summary: "Get a file download URL", defaultOutput: "detail" },
       mcp: { tool: { name: "khotan_files_download", title: "Get a file download URL", description: "Return a short-lived presigned GET URL for a ready file." } }
     },
+    {
+      id: "files.preview",
+      kind: "operation",
+      domain: "files",
+      safety: "read",
+      auth: true,
+      title: "Get a file preview URL",
+      description: "Return a short-lived presigned inline GET URL for a ready, preview-eligible file (images and PDFs).",
+      input: [idField("fileId", "The file id.")],
+      http: { method: "GET", path: "/api/v1/files/{fileId}/preview", operationId: "getFilePreviewUrl" },
+      cli: { command: ["files", "preview-url"], summary: "Get a file preview URL", defaultOutput: "detail" },
+      mcp: { tool: { name: "khotan_files_preview", title: "Get a file preview URL", description: "Return a short-lived presigned inline GET URL for a ready, preview-eligible file (images and PDFs)." } }
+    },
     {
       id: "files.resource",
       kind: "resource",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@khotan/cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "type": "module",
   "description": "Khotan CLI and MCP server: human- and agent-facing adapters over the Khotan /api/v1 surface.",
   "license": "SEE LICENSE IN LICENSE.md",