@fias/create-fias-plugin 1.7.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fias/create-fias-plugin",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "publishConfig": {
     "access": "public"
   },

package/templates/default/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- fias-sdk-guide-version: 2.14.0 -->
+<!-- fias-sdk-guide-version: 2.16.0 -->
 
 # FIAS Plugin Development Guide
 
@@ -665,7 +665,7 @@ await invoke({ query: 'latest EU AI Act enforcement dates' });
 
 ### `useVaultDocuments()` — User-owned Vault documents
 
-**Permissions:** `vault:documents:read` (list / read / getDownloadUrl / search), `vault:documents:write` (write / update / delete / attach / detach / upload)
+**Permissions:** `vault:documents:read` (list / read / readBytes / getDownloadUrl / search), `vault:documents:write` (write / update / delete / attach / detach / upload)
 **Returns:** `VaultDocumentsApi`
 
 The Vault is the platform's persistent document store for the signed-in user. Distinct from `useFiasStorage` (per-plugin sandbox): Vault docs live in the user's My Data, survive plugin uninstall, and can be cross-referenced from other arches. Documents this arche creates are scoped to it (`source_arche_id`) and surfaced to the user under `/My-Fias/Arches/<archeId>/`.
@@ -698,6 +698,17 @@ const result = await vault.upload(bytes, {
 });
 // result.status transitions 'uploaded' → 'available' once indexed for search
 
+// Read back the raw bytes of a document THIS arche created (any content
+// type) — the reopen path for binary-processing plugins (e.g. a PDF editor
+// reloading a saved PDF). Capped at 15 MB (OWN_DOCUMENT_TOO_LARGE names the
+// cap) with its own tight per-minute budget: read sequentially and surface
+// a RATE_LIMIT error verbatim instead of retrying in a loop. Documents this
+// arche did NOT create reject with DOCUMENT_NOT_FOUND — the user's own
+// files are reachable only through useVaultUserDocuments (picker consent).
+// A document whose upload never finished rejects with OWN_DOCUMENT_NOT_READY
+// but still appears in list() — don't assume every listed doc has bytes.
+const { bytes: saved } = await vault.readBytes(documentId);
+
 // Semantic search across documents this arche owns
 // (burns user credits per the AI Markup Invariant — call sparingly)
 const { matches } = await vault.search('quarterly revenue', { topK: 5 });

package/templates/default/CLAUDE.md

@@ -1,4 +1,4 @@
-<!-- fias-sdk-guide-version: 2.14.0 -->
+<!-- fias-sdk-guide-version: 2.16.0 -->
 
 # FIAS Plugin Development Guide
 
@@ -665,7 +665,7 @@ await invoke({ query: 'latest EU AI Act enforcement dates' });
 
 ### `useVaultDocuments()` — User-owned Vault documents
 
-**Permissions:** `vault:documents:read` (list / read / getDownloadUrl / search), `vault:documents:write` (write / update / delete / attach / detach / upload)
+**Permissions:** `vault:documents:read` (list / read / readBytes / getDownloadUrl / search), `vault:documents:write` (write / update / delete / attach / detach / upload)
 **Returns:** `VaultDocumentsApi`
 
 The Vault is the platform's persistent document store for the signed-in user. Distinct from `useFiasStorage` (per-plugin sandbox): Vault docs live in the user's My Data, survive plugin uninstall, and can be cross-referenced from other arches. Documents this arche creates are scoped to it (`source_arche_id`) and surfaced to the user under `/My-Fias/Arches/<archeId>/`.
@@ -698,6 +698,17 @@ const result = await vault.upload(bytes, {
 });
 // result.status transitions 'uploaded' → 'available' once indexed for search
 
+// Read back the raw bytes of a document THIS arche created (any content
+// type) — the reopen path for binary-processing plugins (e.g. a PDF editor
+// reloading a saved PDF). Capped at 15 MB (OWN_DOCUMENT_TOO_LARGE names the
+// cap) with its own tight per-minute budget: read sequentially and surface
+// a RATE_LIMIT error verbatim instead of retrying in a loop. Documents this
+// arche did NOT create reject with DOCUMENT_NOT_FOUND — the user's own
+// files are reachable only through useVaultUserDocuments (picker consent).
+// A document whose upload never finished rejects with OWN_DOCUMENT_NOT_READY
+// but still appears in list() — don't assume every listed doc has bytes.
+const { bytes: saved } = await vault.readBytes(documentId);
+
 // Semantic search across documents this arche owns
 // (burns user credits per the AI Markup Invariant — call sparingly)
 const { matches } = await vault.search('quarterly revenue', { topK: 5 });