@fias/arche-sdk 2.19.2 → 2.20.0

package/dist/generated/permissions.d.ts

@@ -9,7 +9,7 @@
  * `tests/architecture/sdk-permissions-match-db-types.test.ts` ensures
  * this file stays in lockstep with the canonical source.
  */
-export type PluginPermission = 'ai:actions' | 'assets:community:publish' | 'assets:community:read' | 'assets:read' | 'data:search' | 'data:store' | 'data:workspace' | 'entities:audio_generate' | 'entities:client_invoke' | 'entities:image_edit' | 'entities:image_generate' | 'entities:invoke' | 'entities:web_search' | 'navigation:open_arche' | 'sandbox:vendored-libraries' | 'storage:sandbox' | 'store:purchase' | 'theme:read' | 'user:profile:read' | 'vault:documents:read' | 'vault:documents:write' | 'vault:user-documents:edit' | 'vault:user-documents:read' | 'vault:user-documents:write';
+export type PluginPermission = 'ai:actions' | 'assets:community:publish' | 'assets:community:read' | 'assets:read' | 'data:search' | 'data:store' | 'data:workspace' | 'entities:audio_generate' | 'entities:client_invoke' | 'entities:image_edit' | 'entities:image_generate' | 'entities:invoke' | 'entities:web_search' | 'navigation:open_arche' | 'sandbox:vendored-libraries' | 'storage:sandbox' | 'store:purchase' | 'theme:read' | 'user:profile:read' | 'vault:arche-saves:write' | 'vault:documents:read' | 'vault:documents:write' | 'vault:user-documents:edit' | 'vault:user-documents:read' | 'vault:user-documents:write';
 export declare const VALID_PLUGIN_PERMISSIONS: readonly PluginPermission[];
 export declare function isValidPluginPermission(perm: string): perm is PluginPermission;
 /**

package/dist/generated/permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/generated/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,0BAA0B,GAC1B,uBAAuB,GACvB,aAAa,GACb,aAAa,GACb,YAAY,GACZ,gBAAgB,GAChB,yBAAyB,GACzB,wBAAwB,GACxB,qBAAqB,GACrB,yBAAyB,GACzB,iBAAiB,GACjB,qBAAqB,GACrB,uBAAuB,GACvB,4BAA4B,GAC5B,iBAAiB,GACjB,gBAAgB,GAChB,YAAY,GACZ,mBAAmB,GACnB,sBAAsB,GACtB,uBAAuB,GACvB,2BAA2B,GAC3B,2BAA2B,GAC3B,4BAA4B,CAAC;AAEjC,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAyBtD,CAAC;AAEX,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,gBAAgB,CAE9E;AAED;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAiCrF,CAAC"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/generated/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,0BAA0B,GAC1B,uBAAuB,GACvB,aAAa,GACb,aAAa,GACb,YAAY,GACZ,gBAAgB,GAChB,yBAAyB,GACzB,wBAAwB,GACxB,qBAAqB,GACrB,yBAAyB,GACzB,iBAAiB,GACjB,qBAAqB,GACrB,uBAAuB,GACvB,4BAA4B,GAC5B,iBAAiB,GACjB,gBAAgB,GAChB,YAAY,GACZ,mBAAmB,GACnB,yBAAyB,GACzB,sBAAsB,GACtB,uBAAuB,GACvB,2BAA2B,GAC3B,2BAA2B,GAC3B,4BAA4B,CAAC;AAEjC,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EA0BtD,CAAC;AAEX,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,gBAAgB,CAE9E;AAED;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAkCrF,CAAC"}

package/dist/generated/permissions.js

@@ -33,6 +33,7 @@ exports.VALID_PLUGIN_PERMISSIONS = [
     'store:purchase',
     'theme:read',
     'user:profile:read',
+    'vault:arche-saves:write',
     'vault:documents:read',
     'vault:documents:write',
     'vault:user-documents:edit',
@@ -48,12 +49,12 @@ function isValidPluginPermission(perm) {
  * PLUGIN_PERMISSION_DESCRIPTIONS.
  */
 exports.PLUGIN_PERMISSION_DESCRIPTIONS = {
-    'ai:actions': 'Let Fias AI operate this app for you — only actions you could do yourself in its interface, and risky ones ask you first.',
-    'assets:community:publish': 'Share images you made here so other people using this app can see them, and manage what you have shared.',
-    'assets:community:read': 'Show you images that other people using this app have shared. Everything shared is checked before anyone can see it.',
-    'assets:read': "Show images from this app's published asset library.",
-    'data:search': "Search this app's own data semantically — costs credits per search.",
-    'data:store': "Save structured data in this app's own private database.",
+    'ai:actions': 'Let Fias AI operate this arche for you — only actions you could do yourself in its interface, and risky ones ask you first.',
+    'assets:community:publish': 'Share images you made here so other people using this arche can see them, and manage what you have shared.',
+    'assets:community:read': 'Show you images that other people using this arche have shared. Everything shared is checked before anyone can see it.',
+    'assets:read': "Show images from this arche's published asset library.",
+    'data:search': "Search this arche's own data semantically — costs credits per search.",
+    'data:store': "Save structured data in this arche's own private database.",
     'data:workspace': 'Create team workspaces and manage their members.',
     'entities:audio_generate': 'Generate audio with platform AI — costs credits.',
     'entities:client_invoke': 'Use free on-device tools (grammar check, translation) in your browser.',
@@ -63,14 +64,15 @@ exports.PLUGIN_PERMISSION_DESCRIPTIONS = {
     'entities:web_search': 'Search the live web on your behalf — costs credits.',
     'navigation:open_arche': 'Open other arches for you (navigation only).',
     'sandbox:vendored-libraries': 'Load platform-hosted libraries (like the PDF renderer) from the trusted CDN.',
-    'storage:sandbox': "Save files in this app's own private storage.",
-    'store:purchase': 'Offer in-app purchases (you approve each purchase).',
+    'storage:sandbox': "Save files in this arche's own private storage.",
+    'store:purchase': 'Offer purchases inside the arche (you approve each purchase).',
     'theme:read': 'Match your platform theme.',
     'user:profile:read': 'See your display name and avatar.',
-    'vault:documents:read': 'Read documents this app itself created in your Vault.',
-    'vault:documents:write': 'Create and manage its own documents in your Vault.',
-    'vault:user-documents:edit': 'Save changes to files of yours that you let it edit — you choose each file, earlier versions are kept, and you can remove access any time in Vault → App Access.',
-    'vault:user-documents:read': 'Read documents YOU choose to share with it from your Vault — you pick each document, and you can remove access any time in Vault → App Access.',
-    'vault:user-documents:write': 'Save its work to your Fias files, where you can find and reuse it. You confirm each save.',
+    'vault:arche-saves:write': 'Saves files to your Arche Saves automatically.',
+    'vault:documents:read': 'Read files this arche itself created, in its own folders of your Vault.',
+    'vault:documents:write': 'Create and manage its own files, in its own folder of your Vault.',
+    'vault:user-documents:edit': 'Save changes to files of yours that you let it edit — you choose each file, earlier versions are kept unless you turned version history off, and you can remove access any time in Vault → Arche Access.',
+    'vault:user-documents:read': 'Read documents YOU choose to share with it from your Vault — you pick each document, and you can remove access any time in Vault → Arche Access.',
+    'vault:user-documents:write': 'Save its work to your Documents — you choose the folder and the name each time.',
 };
 //# sourceMappingURL=permissions.js.map

package/dist/generated/permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/generated/permissions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAuDH,0DAEC;AA7BY,QAAA,wBAAwB,GAAgC;IACnE,YAAY;IACZ,0BAA0B;IAC1B,uBAAuB;IACvB,aAAa;IACb,aAAa;IACb,YAAY;IACZ,gBAAgB;IAChB,yBAAyB;IACzB,wBAAwB;IACxB,qBAAqB;IACrB,yBAAyB;IACzB,iBAAiB;IACjB,qBAAqB;IACrB,uBAAuB;IACvB,4BAA4B;IAC5B,iBAAiB;IACjB,gBAAgB;IAChB,YAAY;IACZ,mBAAmB;IACnB,sBAAsB;IACtB,uBAAuB;IACvB,2BAA2B;IAC3B,2BAA2B;IAC3B,4BAA4B;CACpB,CAAC;AAEX,SAAgB,uBAAuB,CAAC,IAAY;IAClD,OAAQ,gCAA8C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACU,QAAA,8BAA8B,GAA+C;IACxF,YAAY,EACV,2HAA2H;IAC7H,0BAA0B,EACxB,0GAA0G;IAC5G,uBAAuB,EACrB,sHAAsH;IACxH,aAAa,EAAE,sDAAsD;IACrE,aAAa,EAAE,qEAAqE;IACpF,YAAY,EAAE,0DAA0D;IACxE,gBAAgB,EAAE,kDAAkD;IACpE,yBAAyB,EAAE,kDAAkD;IAC7E,wBAAwB,EACtB,wEAAwE;IAC1E,qBAAqB,EAAE,+CAA+C;IACtE,yBAAyB,EAAE,mDAAmD;IAC9E,iBAAiB,EAAE,wDAAwD;IAC3E,qBAAqB,EAAE,qDAAqD;IAC5E,uBAAuB,EAAE,8CAA8C;IACvE,4BAA4B,EAC1B,8EAA8E;IAChF,iBAAiB,EAAE,+CAA+C;IAClE,gBAAgB,EAAE,qDAAqD;IACvE,YAAY,EAAE,4BAA4B;IAC1C,mBAAmB,EAAE,mCAAmC;IACxD,sBAAsB,EAAE,uDAAuD;IAC/E,uBAAuB,EAAE,oDAAoD;IAC7E,2BAA2B,EACzB,kKAAkK;IACpK,2BAA2B,EACzB,gJAAgJ;IAClJ,4BAA4B,EAC1B,2FAA2F;CAC9F,CAAC"}
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/generated/permissions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAyDH,0DAEC;AA9BY,QAAA,wBAAwB,GAAgC;IACnE,YAAY;IACZ,0BAA0B;IAC1B,uBAAuB;IACvB,aAAa;IACb,aAAa;IACb,YAAY;IACZ,gBAAgB;IAChB,yBAAyB;IACzB,wBAAwB;IACxB,qBAAqB;IACrB,yBAAyB;IACzB,iBAAiB;IACjB,qBAAqB;IACrB,uBAAuB;IACvB,4BAA4B;IAC5B,iBAAiB;IACjB,gBAAgB;IAChB,YAAY;IACZ,mBAAmB;IACnB,yBAAyB;IACzB,sBAAsB;IACtB,uBAAuB;IACvB,2BAA2B;IAC3B,2BAA2B;IAC3B,4BAA4B;CACpB,CAAC;AAEX,SAAgB,uBAAuB,CAAC,IAAY;IAClD,OAAQ,gCAA8C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACU,QAAA,8BAA8B,GAA+C;IACxF,YAAY,EACV,6HAA6H;IAC/H,0BAA0B,EACxB,4GAA4G;IAC9G,uBAAuB,EACrB,wHAAwH;IAC1H,aAAa,EAAE,wDAAwD;IACvE,aAAa,EAAE,uEAAuE;IACtF,YAAY,EAAE,4DAA4D;IAC1E,gBAAgB,EAAE,kDAAkD;IACpE,yBAAyB,EAAE,kDAAkD;IAC7E,wBAAwB,EACtB,wEAAwE;IAC1E,qBAAqB,EAAE,+CAA+C;IACtE,yBAAyB,EAAE,mDAAmD;IAC9E,iBAAiB,EAAE,wDAAwD;IAC3E,qBAAqB,EAAE,qDAAqD;IAC5E,uBAAuB,EAAE,8CAA8C;IACvE,4BAA4B,EAC1B,8EAA8E;IAChF,iBAAiB,EAAE,iDAAiD;IACpE,gBAAgB,EAAE,+DAA+D;IACjF,YAAY,EAAE,4BAA4B;IAC1C,mBAAmB,EAAE,mCAAmC;IACxD,yBAAyB,EAAE,gDAAgD;IAC3E,sBAAsB,EAAE,yEAAyE;IACjG,uBAAuB,EAAE,mEAAmE;IAC5F,2BAA2B,EACzB,0MAA0M;IAC5M,2BAA2B,EACzB,kJAAkJ;IACpJ,4BAA4B,EAC1B,iFAAiF;CACpF,CAAC"}

package/dist/hooks.d.ts

@@ -1,4 +1,4 @@
-import type { ArcheHandoffPayload, FiasUser, FiasTheme, FiasStorageApi, DataSubscriptionState, EntityInvocationApi, ClientEntityApi, ImageGenerationApi, ImageEntityFilter, ImageEntitySummary, NllbLanguageOption, AudioGenerationApi, FiasNavigationApi, StepNavigationApi, StepNavigationOptions, FiasDataStoreApi, FiasWorkspacesApi, FiasStoreApi, VaultDocumentsApi, VaultDocumentDownloadUrl, VaultUserDocumentSaveContentResult, ArcheAssetsApi, CommunityAssetsApi, FiasAIActionsDeclaration } from './types';
+import type { ArcheHandoffPayload, FiasUser, FiasTheme, FiasStorageApi, DataSubscriptionState, EntityInvocationApi, ClientEntityApi, ImageGenerationApi, ImageEntityFilter, ImageEntitySummary, NllbLanguageOption, AudioGenerationApi, FiasNavigationApi, StepNavigationApi, StepNavigationOptions, FiasDataStoreApi, FiasWorkspacesApi, FiasStoreApi, VaultDocumentsApi, VaultDocumentDownloadUrl, VaultUserDocumentSaveContentResult, ArcheAssetsApi, FiasContentApi, FiasContentErrorCode, CommunityAssetsApi, FiasAIActionsDeclaration } from './types';
 /**
  * Access the current user's profile information.
  * Requires the `user:profile:read` permission in fias-plugin.json.
@@ -342,6 +342,46 @@ export declare function useVaultDocuments(): VaultDocumentsApi;
  *   // entries[i].signedUrl is a short-lived URL you can use as <img src>
  */
 export declare function useArcheAssets(): ArcheAssetsApi;
+/**
+ * Entity ID of the plugin content pack client-side entity (ADR-021) — the
+ * host-side reader behind {@link useFiasContent}. Literal here so the SDK
+ * stays bundle-clean (no `@fias/entities` runtime dep).
+ *
+ * SYNC NOTE: must match `PLUGIN_CONTENT_ENTITY_ID` in
+ * `packages/entities/src/integrations/plugin-content/config.ts`. The
+ * architecture test `sdk-entity-id-constants-match.test.ts` pins this.
+ */
+export declare const PLUGIN_CONTENT_ENTITY_ID = "ent_intg_plugin_content_00000000";
+/** A failed content read: `code` says why, `path` names the file when there is one. */
+export declare class FiasContentError extends Error {
+    readonly code: FiasContentErrorCode;
+    readonly path?: string | undefined;
+    constructor(message: string, code: FiasContentErrorCode, path?: string | undefined);
+}
+/**
+ * Read this plugin's own content pack — the reviewed `content/` directory it
+ * was published with (lessons, data, images, audio, fonts).
+ *
+ * The host page reads the pack from the Fias content CDN, verifies every file
+ * against its hash, and caches it; nothing here touches the network, and a
+ * plugin can only read its own pack. Reads are free for your users; the
+ * contributor pays the pack's storage and bandwidth, and cached repeat reads
+ * cost nothing.
+ *
+ * Paths are relative to `content/`. In the Arche Builder and developer
+ * previews there is no published pack: calls fail with
+ * `CONTENT_UNAVAILABLE_IN_PREVIEW` (the dev harness serves your local
+ * `content/` instead).
+ *
+ * Permission: `entities:client_invoke`.
+ *
+ * @example
+ *   const content = useFiasContent();
+ *   const lessons = await content.list('lessons/');
+ *   const markdown = await content.getText(lessons[0].path);
+ *   const cover = await content.getObjectUrl('img/cover.webp'); // <img src={cover}>
+ */
+export declare function useFiasContent(): FiasContentApi;
 /**
  * Preserve transient UI state across a builder-preview rebuild.
  *
@@ -463,6 +503,13 @@ export interface VaultUserDocumentsApi {
          *  `:read`, and every method of this hook (this one included) is gated
          *  on `:read`. */
         access?: 'read' | 'write';
+        /**
+         * The types you can open: MIME types (`'application/pdf'`), MIME
+         * families (`'image/*'`) or extensions (`'.docx'`), up to 20. The host
+         * offers matching files; the user can still reveal the rest, shown
+         * disabled. Omitted: every type.
+         */
+        accept?: readonly string[];
     }): Promise<VaultUserDocumentPickResult>;
     /**
      * Ask the user to let you EDIT a document you can already open. The host
@@ -499,7 +546,7 @@ export interface VaultUserDocumentsApi {
      *
      * Rejects `EDIT_ACCESS_REQUIRED` when you hold view-only access (call
      * `requestEditAccess`), and `DOCUMENT_NOT_FOUND` once the user removes your
-     * access in Vault → App Access — which takes effect on your very next save.
+     * access in Vault → Arche Access — which takes effect on your very next save.
      * Handle both. Debounce (a few seconds idle, plus blur and close) and
      * surface `RATE_LIMIT` rather than looping: this lane allows fewer saves per
      * minute than your own documents do. Every save is recorded with your app's
@@ -515,7 +562,7 @@ export interface VaultUserDocumentsApi {
      * Read one granted document. `includeContent: true` returns UTF-8 text
      * for text documents (a binary document rejects with BINARY_DOCUMENT —
      * use getDownloadUrl for those). Rejects with DOCUMENT_NOT_FOUND once
-     * the user revokes access in Vault → App Access — handle that path.
+     * the user revokes access in Vault → Arche Access — handle that path.
      */
     get(documentId: string, options?: {
         includeContent?: boolean;
@@ -541,7 +588,7 @@ export interface VaultUserDocumentsApi {
      * the family, because it is the only one that can move megabytes: call
      * sequentially and surface a RATE_LIMIT error to the user/assistant
      * verbatim rather than retrying in a loop. Rejects with
-     * DOCUMENT_NOT_FOUND once the user revokes access in Vault → App Access
+     * DOCUMENT_NOT_FOUND once the user revokes access in Vault → Arche Access
      * — unlike a presigned URL from getDownloadUrl, which stays valid for
      * its TTL, every getBytes call re-checks the grant.
      */
@@ -556,7 +603,7 @@ export interface VaultUserDocumentsApi {
  * surface that reaches data your plugin did not create. Requires the
  * `vault:user-documents:read` permission. Every access is user-consented
  * (per-document grants created in the host picker, revocable any time in
- * Vault → App Access) and audited by the platform.
+ * Vault → Arche Access) and audited by the platform.
  *
  * The picker offers the files of the workspace the user is acting in (the
  * host's workspace switcher — Personal, or an org workspace they belong to)
@@ -631,7 +678,7 @@ export interface FiasAIActionsConfig extends FiasAIActionsDeclaration {
  * You get a document REFERENCE, not bytes. Read it with
  * `useVaultUserDocuments().getBytes(documentId)`: the host grants you that one
  * document as it relays the handoff, so no `pick()` is needed first. The grant
- * is per-document and revocable in Vault → App Access exactly like a picked
+ * is per-document and revocable in Vault → Arche Access exactly like a picked
  * one, and it needs `vault:user-documents:read` — declare it, or the grant is
  * refused and the file never arrives.
  *

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/hooks.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GRAMMAR_CHECK_ENTITY_ID = exports.NLLB_LANGUAGES = exports.NLLB_TRANSLATION_ENTITY_ID = void 0;
+exports.FiasContentError = exports.PLUGIN_CONTENT_ENTITY_ID = exports.GRAMMAR_CHECK_ENTITY_ID = exports.NLLB_LANGUAGES = exports.NLLB_TRANSLATION_ENTITY_ID = void 0;
 exports.useFiasUser = useFiasUser;
 exports.useFiasTheme = useFiasTheme;
 exports.useFiasVendoredAssets = useFiasVendoredAssets;
@@ -20,6 +20,7 @@ exports.useFiasStore = useFiasStore;
 exports.fetchVaultDocumentDownloadUrl = fetchVaultDocumentDownloadUrl;
 exports.useVaultDocuments = useVaultDocuments;
 exports.useArcheAssets = useArcheAssets;
+exports.useFiasContent = useFiasContent;
 exports.useFiasPreviewState = useFiasPreviewState;
 exports.useDataSubscription = useDataSubscription;
 exports.useVaultUserDocuments = useVaultUserDocuments;
@@ -1179,18 +1180,6 @@ function useVaultDocuments() {
         // drop any cached URL for this document.
         downloadUrlCache.delete(documentId);
     }, [bridge]);
-    const promoteToUserFiles = (0, react_1.useCallback)(async (documentId) => {
-        // Rides the existing update op with a host-only flag. The HOST
-        // intercepts it, shows the user its own confirmation, and performs the
-        // promote from the user's session — nothing here (or anywhere in the
-        // iframe) can promote a file without the user agreeing.
-        const res = await bridge.request('vault_documents_update', {
-            documentId,
-            userVisible: true,
-        });
-        downloadUrlCache.delete(documentId);
-        return res;
-    }, [bridge]);
     const deleteDocument = (0, react_1.useCallback)(async (documentId) => {
         await bridge.request('vault_documents_delete', { documentId });
         downloadUrlCache.delete(documentId);
@@ -1215,9 +1204,9 @@ function useVaultDocuments() {
         await bridge.request('vault_documents_detach', { documentId, referenceId });
     }, [bridge]);
     const uploadInit = (0, react_1.useCallback)(async (params) => {
-        // No `userVisible` here by construction: a user-visible save needs the
-        // host's confirmation, which it can only run when it orchestrates the
-        // whole upload. The host REJECTS a `visibility` on this op.
+        // No destination here by construction: a save into the user's
+        // Documents needs the host's Save dialog, which it can only show when it
+        // orchestrates the whole upload. The host REJECTS a `visibility` here.
         return bridge.request('vault_documents_upload_init', {
             name: params.name,
             mimeType: params.mimeType,
@@ -1252,13 +1241,22 @@ function useVaultDocuments() {
             sensitivity: params.sensitivity,
             folderPath: params.folderPath,
             replacesDocumentId: params.replacesDocumentId,
-            // Opt-in user-visible save. The host turns this into a confirmation
-            // the user sees and the iframe cannot script; the server independently
-            // requires `vault:user-documents:write` plus a registered folder for
-            // this arche. Omitted (the common case) keeps the arche-private default.
+            // A save into the user's Documents. The host turns this into its Save
+            // dialog, which the iframe cannot see or script, and performs the
+            // write itself from the user's session. Omitted (the common case)
+            // keeps the arche-private default.
+            destination: params.destination,
             userVisible: params.userVisible,
         });
     }, [bridge]);
+    const saveCopy = (0, react_1.useCallback)(async (documentId, options) => {
+        // Rides the update op, intercepted by the host: it reads the bytes and
+        // shows the Save dialog. Never forwarded — the original is unchanged.
+        return bridge.request('vault_documents_update', {
+            documentId,
+            saveCopy: { ...(options?.suggestedName ? { suggestedName: options.suggestedName } : {}) },
+        });
+    }, [bridge]);
     return (0, react_1.useMemo)(() => ({
         list,
         read,
@@ -1267,12 +1265,12 @@ function useVaultDocuments() {
         getDownloadUrl,
         write,
         update,
-        promoteToUserFiles,
         delete: deleteDocument,
         search,
         attach,
         detach,
         upload,
+        saveCopy,
         uploadInit,
         uploadFinalize,
     }), [
@@ -1283,12 +1281,12 @@ function useVaultDocuments() {
         getDownloadUrl,
         write,
         update,
-        promoteToUserFiles,
         deleteDocument,
         search,
         attach,
         detach,
         upload,
+        saveCopy,
         uploadInit,
         uploadFinalize,
     ]);
@@ -1425,6 +1423,134 @@ function useArcheAssets() {
     }, [bridge]);
     return (0, react_1.useMemo)(() => ({ list, index, getUrl }), [list, index, getUrl]);
 }
+/**
+ * Entity ID of the plugin content pack client-side entity (ADR-021) — the
+ * host-side reader behind {@link useFiasContent}. Literal here so the SDK
+ * stays bundle-clean (no `@fias/entities` runtime dep).
+ *
+ * SYNC NOTE: must match `PLUGIN_CONTENT_ENTITY_ID` in
+ * `packages/entities/src/integrations/plugin-content/config.ts`. The
+ * architecture test `sdk-entity-id-constants-match.test.ts` pins this.
+ */
+exports.PLUGIN_CONTENT_ENTITY_ID = 'ent_intg_plugin_content_00000000';
+/** A failed content read: `code` says why, `path` names the file when there is one. */
+class FiasContentError extends Error {
+    constructor(message, code, path) {
+        super(message);
+        this.code = code;
+        this.path = path;
+        this.name = 'FiasContentError';
+    }
+}
+exports.FiasContentError = FiasContentError;
+function toContentError(err) {
+    if (err instanceof FiasContentError)
+        return err;
+    const message = err instanceof Error ? err.message : String(err);
+    const code = err?.code;
+    if (/permission denied/i.test(message))
+        return new FiasContentError(message, 'PERMISSION_DENIED');
+    if (code === 'RATE_LIMITED' || /rate limit/i.test(message)) {
+        return new FiasContentError(message, 'RATE_LIMIT');
+    }
+    return new FiasContentError(message, 'CONTENT_UNAVAILABLE');
+}
+function fileResult(results, path) {
+    const result = results?.[path];
+    if (!result) {
+        throw new FiasContentError(`No result for content/${path}`, 'CONTENT_UNAVAILABLE', path);
+    }
+    if ('error' in result)
+        throw new FiasContentError(result.error.message, result.error.code, path);
+    return result;
+}
+/**
+ * `blob:` URLs built in this iframe, per path. A published pack is immutable,
+ * so one URL per path serves the plugin for its whole life.
+ */
+const contentObjectUrls = new Map();
+/**
+ * Read this plugin's own content pack — the reviewed `content/` directory it
+ * was published with (lessons, data, images, audio, fonts).
+ *
+ * The host page reads the pack from the Fias content CDN, verifies every file
+ * against its hash, and caches it; nothing here touches the network, and a
+ * plugin can only read its own pack. Reads are free for your users; the
+ * contributor pays the pack's storage and bandwidth, and cached repeat reads
+ * cost nothing.
+ *
+ * Paths are relative to `content/`. In the Arche Builder and developer
+ * previews there is no published pack: calls fail with
+ * `CONTENT_UNAVAILABLE_IN_PREVIEW` (the dev harness serves your local
+ * `content/` instead).
+ *
+ * Permission: `entities:client_invoke`.
+ *
+ * @example
+ *   const content = useFiasContent();
+ *   const lessons = await content.list('lessons/');
+ *   const markdown = await content.getText(lessons[0].path);
+ *   const cover = await content.getObjectUrl('img/cover.webp'); // <img src={cover}>
+ */
+function useFiasContent() {
+    const bridge = useBridge();
+    const call = (0, react_1.useCallback)(async (input) => {
+        let response;
+        try {
+            response = await bridge.request('client_entity_invoke', { entityId: exports.PLUGIN_CONTENT_ENTITY_ID, input }, CLIENT_ENTITY_INVOKE_TIMEOUT_MS);
+        }
+        catch (err) {
+            throw toContentError(err);
+        }
+        if (response?.error) {
+            throw new FiasContentError(response.error.message, response.error.code);
+        }
+        return response ?? {};
+    }, [bridge]);
+    const list = (0, react_1.useCallback)(async (prefix) => (await call({ verb: 'list', ...(prefix !== undefined ? { prefix } : {}) })).files ?? [], [call]);
+    const getText = (0, react_1.useCallback)(async (path) => {
+        const { results } = await call({ verb: 'read', paths: [path], as: 'text' });
+        return fileResult(results, path).text;
+    }, [call]);
+    const getJson = (0, react_1.useCallback)(async (path) => JSON.parse(await getText(path)), [getText]);
+    const readBytes = (0, react_1.useCallback)(async (path) => {
+        const { results } = await call({ verb: 'read', paths: [path], as: 'bytes' });
+        return fileResult(results, path);
+    }, [call]);
+    const getBytes = (0, react_1.useCallback)(async (path) => (await readBytes(path)).bytes, [readBytes]);
+    const getMany = (0, react_1.useCallback)(async (paths, as) => {
+        const { results } = await call({ verb: 'read', paths, as });
+        const out = {};
+        for (const path of paths) {
+            try {
+                const result = fileResult(results, path);
+                out[path] =
+                    as === 'text'
+                        ? result.text
+                        : result.bytes;
+            }
+            catch (err) {
+                out[path] = toContentError(err);
+            }
+        }
+        return out;
+    }, [call]);
+    const getObjectUrl = (0, react_1.useCallback)(async (path) => {
+        const cached = contentObjectUrls.get(path);
+        if (cached)
+            return cached;
+        const pending = readBytes(path).then(({ bytes, mimeType }) => URL.createObjectURL(new Blob([bytes], { type: mimeType })));
+        contentObjectUrls.set(path, pending);
+        pending.catch(() => contentObjectUrls.delete(path));
+        return pending;
+    }, [readBytes]);
+    const getUrl = (0, react_1.useCallback)(async (path) => {
+        const { results } = await call({ verb: 'url', paths: [path] });
+        const { url, expiresAt } = fileResult(results, path);
+        return { url, expiresAt };
+    }, [call]);
+    return (0, react_1.useMemo)(() => ({ list, getText, getJson, getBytes, getMany, getObjectUrl, getUrl }), [list, getText, getJson, getBytes, getMany, getObjectUrl, getUrl]);
+}
 /**
  * Preserve transient UI state across a builder-preview rebuild.
  *
@@ -1581,7 +1707,7 @@ function useDataSubscription(collection, onInvalidate, options) {
  * surface that reaches data your plugin did not create. Requires the
  * `vault:user-documents:read` permission. Every access is user-consented
  * (per-document grants created in the host picker, revocable any time in
- * Vault → App Access) and audited by the platform.
+ * Vault → Arche Access) and audited by the platform.
  *
  * The picker offers the files of the workspace the user is acting in (the
  * host's workspace switcher — Personal, or an org workspace they belong to)
@@ -1599,6 +1725,7 @@ function useVaultUserDocuments() {
         return bridge.request('vault_documents_pick', {
             maxDocuments: options?.maxDocuments,
             access: options?.access,
+            ...(options?.accept ? { accept: [...options.accept] } : {}),
         });
     }, [bridge]);
     const requestEditAccess = (0, react_1.useCallback)(async (documentId) => {
@@ -1862,7 +1989,7 @@ function useCommunityAssets() {
  * You get a document REFERENCE, not bytes. Read it with
  * `useVaultUserDocuments().getBytes(documentId)`: the host grants you that one
  * document as it relays the handoff, so no `pick()` is needed first. The grant
- * is per-document and revocable in Vault → App Access exactly like a picked
+ * is per-document and revocable in Vault → Arche Access exactly like a picked
  * one, and it needs `vault:user-documents:read` — declare it, or the grant is
  * refused and the file never arrives.
  *