@fias/create-fias-plugin 1.10.0 → 1.11.0

package/package.json

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

package/templates/default/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- fias-sdk-guide-version: 2.17.0 -->
+<!-- fias-sdk-guide-version: 2.18.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 / readBytes / getDownloadUrl / search), `vault:documents:write` (write / update / delete / attach / detach / upload)
+**Permissions:** `vault:documents:read` (list / read / readBytes / getDownloadUrl / search), `vault:documents:write` (write / saveContent / 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>/`.
@@ -709,6 +709,15 @@ const result = await vault.upload(bytes, {
 // but still appears in list() — don't assume every listed doc has bytes.
 const { bytes: saved } = await vault.readBytes(documentId);
 
+// Overwrite a document THIS arche created IN PLACE — same documentId, bytes
+// replaced, no version history. The autosave path (a spreadsheet saving as
+// the user works); to publish a distinct new version use write({
+// replacesDocumentId }) instead. UTF-8 text, ≤ 200 KB (OWN_DOCUMENT_SAVE_TOO_LARGE
+// names the cap). Debounce: a few seconds of idle plus blur/close — never per
+// keystroke — and surface RATE_LIMIT verbatim rather than retrying. A save
+// drops the document's search index and does not re-run extraction.
+await vault.saveContent({ documentId, content: JSON.stringify(sheet) });
+
 // 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.17.0 -->
+<!-- fias-sdk-guide-version: 2.18.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 / readBytes / getDownloadUrl / search), `vault:documents:write` (write / update / delete / attach / detach / upload)
+**Permissions:** `vault:documents:read` (list / read / readBytes / getDownloadUrl / search), `vault:documents:write` (write / saveContent / 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>/`.
@@ -709,6 +709,15 @@ const result = await vault.upload(bytes, {
 // but still appears in list() — don't assume every listed doc has bytes.
 const { bytes: saved } = await vault.readBytes(documentId);
 
+// Overwrite a document THIS arche created IN PLACE — same documentId, bytes
+// replaced, no version history. The autosave path (a spreadsheet saving as
+// the user works); to publish a distinct new version use write({
+// replacesDocumentId }) instead. UTF-8 text, ≤ 200 KB (OWN_DOCUMENT_SAVE_TOO_LARGE
+// names the cap). Debounce: a few seconds of idle plus blur/close — never per
+// keystroke — and surface RATE_LIMIT verbatim rather than retrying. A save
+// drops the document's search index and does not re-run extraction.
+await vault.saveContent({ documentId, content: JSON.stringify(sheet) });
+
 // 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 });