@fias/arche-sdk 2.11.0 → 2.13.0

package/dist/fias.js.map

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

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 = '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:read';
+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:read';
 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,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,CAAC;AAEhC,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAoBtD,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,CAuBrF,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,sBAAsB,GACtB,uBAAuB,GACvB,2BAA2B,CAAC;AAEhC,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAuBtD,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,CA6BrF,CAAC"}

package/dist/generated/permissions.js

@@ -14,6 +14,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PLUGIN_PERMISSION_DESCRIPTIONS = exports.VALID_PLUGIN_PERMISSIONS = void 0;
 exports.isValidPluginPermission = isValidPluginPermission;
 exports.VALID_PLUGIN_PERMISSIONS = [
+    'ai:actions',
+    'assets:community:publish',
+    'assets:community:read',
     'assets:read',
     'data:search',
     'data:store',
@@ -43,6 +46,9 @@ 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.",

package/dist/generated/permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/generated/permissions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AA6CH,0DAEC;AAxBY,QAAA,wBAAwB,GAAgC;IACnE,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;CACnB,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,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,gJAAgJ;CACnJ,CAAC"}
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/generated/permissions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAmDH,0DAEC;AA3BY,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;CACnB,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,gJAAgJ;CACnJ,CAAC"}

package/dist/hooks.d.ts

@@ -1,4 +1,4 @@
-import type { FiasUser, FiasTheme, FiasStorageApi, DataSubscriptionState, EntityInvocationApi, ClientEntityApi, ImageGenerationApi, ImageEntityFilter, ImageEntitySummary, NllbLanguageOption, AudioGenerationApi, FiasNavigationApi, StepNavigationApi, StepNavigationOptions, FiasDataStoreApi, FiasWorkspacesApi, FiasStoreApi, VaultDocumentsApi, VaultDocumentDownloadUrl, ArcheAssetsApi } from './types';
+import type { FiasUser, FiasTheme, FiasStorageApi, DataSubscriptionState, EntityInvocationApi, ClientEntityApi, ImageGenerationApi, ImageEntityFilter, ImageEntitySummary, NllbLanguageOption, AudioGenerationApi, FiasNavigationApi, StepNavigationApi, StepNavigationOptions, FiasDataStoreApi, FiasWorkspacesApi, FiasStoreApi, VaultDocumentsApi, VaultDocumentDownloadUrl, ArcheAssetsApi, CommunityAssetsApi, FiasAIActionsDeclaration } from './types';
 /**
  * Access the current user's profile information.
  * Requires the `user:profile:read` permission in fias-plugin.json.
@@ -455,4 +455,61 @@ export interface VaultUserDocumentsApi {
  * `useVaultDocuments` instead.
  */
 export declare function useVaultUserDocuments(): VaultUserDocumentsApi;
+/**
+ * Publish images to this arche's community, and browse what others published.
+ *
+ * The platform's only cross-user read path: an image published here is visible
+ * to every authenticated user of THIS arche (and no other), after it clears
+ * moderation. Publishing is free.
+ *
+ * Two things to design around:
+ *
+ *   1. **Publishing is not instant.** `publish` returns
+ *      `status: 'pending_moderation'`; the asset appears in `listCommunity`
+ *      only once it is approved. Show the author their own pending item via
+ *      `listMine` rather than optimistically adding it to the community feed.
+ *   2. **Store structure in the Data Store, not here.** Which asset belongs on
+ *      which page/level goes in a `shared`-scope collection holding `assetId`s.
+ *      Community Assets holds the bytes and nothing queryable.
+ *
+ * Permissions: `assets:community:read` for browsing and viewing;
+ * `assets:community:publish` additionally for publish / unpublish / listMine.
+ * A plugin that only DISPLAYS community content should declare only the former.
+ *
+ * @returns Community assets API.
+ */
+export declare function useCommunityAssets(): CommunityAssetsApi;
+/** Configuration for {@link useFiasAIActions}. */
+export interface FiasAIActionsConfig extends FiasAIActionsDeclaration {
+    /**
+     * The state snapshot the assistant sees, and `availableWhen` filters
+     * against. Keep it SMALL and flag-shaped (`{documentOpen: true}` — publish
+     * `hasPages: true`, not a page array): accepted snapshots are embedded in
+     * the assistant's system prompt every turn, and the host drops oversized
+     * ones outright.
+     */
+    state?: Record<string, unknown>;
+    /**
+     * Perform a dispatched action. Throw/reject to report failure — the
+     * assistant AWAITS this before telling the model the action applied, so a
+     * batch ("do X to each file") stops on the failing step instead of
+     * marching on. ALWAYS re-check preconditions here: `availableWhen`
+     * filtering is presentation, and a stale turn can dispatch a hidden verb.
+     */
+    onAction: (actionId: string, params: Record<string, unknown>) => void | Promise<unknown>;
+}
+/**
+ * Declare Fias AI actions at RUNTIME — the dynamic half of the plugin
+ * AI-action plane (`ai:actions` permission; TRUSTED arches only — the host
+ * silently ignores runtime declarations from non-trusted arches, whose lane
+ * is the manifest `fiasAI` block, fixed at publish and reviewed with the
+ * submission). Both lanes merge host-side; the manifest wins id collisions.
+ *
+ * Pass `null` to declare nothing (e.g. while loading). The declaration and
+ * the state snapshot are each re-sent only when their content changes; the
+ * host additionally coalesces rapid re-sends trailing-edge (latest wins,
+ * applied within ~1s / ~250ms for state) — nothing is lost, but drive
+ * declaration changes off real capability changes, not render churn.
+ */
+export declare function useFiasAIActions(config: FiasAIActionsConfig | null): void;
 //# sourceMappingURL=hooks.d.ts.map

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

@@ -23,6 +23,8 @@ exports.useArcheAssets = useArcheAssets;
 exports.useFiasPreviewState = useFiasPreviewState;
 exports.useDataSubscription = useDataSubscription;
 exports.useVaultUserDocuments = useVaultUserDocuments;
+exports.useCommunityAssets = useCommunityAssets;
+exports.useFiasAIActions = useFiasAIActions;
 const react_1 = require("react");
 const react_dom_1 = require("react-dom");
 const context_1 = require("./context");
@@ -731,6 +733,7 @@ function useFiasDataStore() {
             writeMinRole: options?.writeMinRole,
             readMinRole: options?.readMinRole,
             writePolicy: options?.writePolicy,
+            constraints: options?.constraints,
         });
         return res.collection;
     }, [bridge]);
@@ -742,12 +745,13 @@ function useFiasDataStore() {
         await (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.PLUGIN_DATASTORE_ENTITY_ID, 'delete_collection', { name });
     }, [bridge]);
     const put = (0, react_1.useCallback)(async (collection, key, data, options) => {
-        await (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.PLUGIN_DATASTORE_ENTITY_ID, 'put', {
+        const res = await (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.PLUGIN_DATASTORE_ENTITY_ID, 'put', {
             collection,
             key,
             data,
             workspaceId: options?.workspaceId,
         });
+        return { version: res?.version };
     }, [bridge]);
     const get = (0, react_1.useCallback)(async (collection, key, options) => {
         const res = await (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.PLUGIN_DATASTORE_ENTITY_ID, 'get', {
@@ -769,6 +773,7 @@ function useFiasDataStore() {
             key: res.key ?? key,
             data: res.data,
             updatedAt: res.updatedAt ?? '',
+            ...(res.version !== undefined ? { version: res.version } : {}),
             ...(res.authoredByCollaborator !== undefined
                 ? { authoredByCollaborator: res.authoredByCollaborator }
                 : {}),
@@ -797,8 +802,12 @@ function useFiasDataStore() {
             workspaceId: options?.workspaceId,
         });
     }, [bridge]);
-    const batch = (0, react_1.useCallback)(async (operations) => {
-        await (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.PLUGIN_DATASTORE_ENTITY_ID, 'batch', { operations });
+    const batch = (0, react_1.useCallback)(async (operations, options) => {
+        const res = await (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.PLUGIN_DATASTORE_ENTITY_ID, 'batch', {
+            operations,
+            ...(options?.preconditions?.length ? { preconditions: options.preconditions } : {}),
+        });
+        return { written: res?.written };
     }, [bridge]);
     return (0, react_1.useMemo)(() => ({
         createCollection,
@@ -1403,4 +1412,255 @@ function useVaultUserDocuments() {
     }, [bridge]);
     return (0, react_1.useMemo)(() => ({ pick, list, get, getDownloadUrl }), [pick, list, get, getDownloadUrl]);
 }
+/**
+ * Refresh a community-asset URL this many ms before it expires. Larger than the
+ * Vault buffer relative to the TTL (5 min vs 1 h) because a gallery render can
+ * start well before its `<img>` loads finish.
+ */
+const COMMUNITY_ASSET_URL_REFRESH_BUFFER_MS = 30000;
+/**
+ * Module-scoped cache of community-asset signed URLs, keyed by assetId.
+ *
+ * Same reasoning as the Vault download-URL cache above: a React render is not
+ * the right invalidation boundary for something valid for a fixed wall-clock
+ * window.
+ *
+ * Keyed by assetId ALONE, deliberately: this module is loaded inside one
+ * plugin iframe, which runs one arche, so there is no second arche to collide
+ * with. (The signature itself is still bound to the arche server-side — that
+ * boundary does not depend on this cache.)
+ *
+ * Because signatures last only ~5 minutes, this cache is what stops a gallery
+ * from re-minting on every render — while `unpublish` evicts eagerly so a
+ * removed asset stops resolving straight away rather than at TTL.
+ */
+const communityAssetUrlCache = new Map();
+const communityAssetUrlInflight = new Map();
+/**
+ * Batch resolver behind `getUrl` / `getUrls`.
+ *
+ * Serves what it can from cache, requests only the misses, and dedupes
+ * concurrent requests for the same asset so a burst of mounting `<img>`
+ * components collapses into one round-trip. Ids the server omits (taken down,
+ * not yet published, never existed) are simply absent from the result.
+ */
+async function fetchCommunityAssetUrls(bridge, assetIds) {
+    const now = Date.now();
+    const hits = [];
+    const misses = [];
+    for (const assetId of assetIds) {
+        const cached = communityAssetUrlCache.get(assetId);
+        if (cached && now < cached.expiresAt - COMMUNITY_ASSET_URL_REFRESH_BUFFER_MS) {
+            hits.push(cached);
+        }
+        else {
+            misses.push(assetId);
+        }
+    }
+    if (misses.length === 0)
+        return hits;
+    // Coalesce with any in-flight request covering the same asset.
+    const pending = [];
+    const toRequest = [];
+    for (const assetId of misses) {
+        const inflight = communityAssetUrlInflight.get(assetId);
+        if (inflight)
+            pending.push(inflight);
+        else
+            toRequest.push(assetId);
+    }
+    // CHUNKED to the server's cap. `get_urls` is `.max(COMMUNITY_ASSET_MAX_URL_BATCH)`
+    // server-side and Zod rejects the whole request when it is exceeded — so an
+    // un-chunked gallery of 60 images did not render 50 and drop 10, it rendered
+    // NONE. Chunking here rather than surfacing the limit keeps the natural usage
+    // (one book, every page at once) working, which is the case this hook exists
+    // for. Chunks run concurrently; each caches and clears its own ids.
+    for (let i = 0; i < toRequest.length; i += entity_ops_1.COMMUNITY_ASSET_MAX_URL_BATCH) {
+        const chunk = toRequest.slice(i, i + entity_ops_1.COMMUNITY_ASSET_MAX_URL_BATCH);
+        const promise = (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.COMMUNITY_ASSETS_ENTITY_ID, 'get_urls', { assetIds: chunk })
+            .then((res) => {
+            for (const url of res.urls) {
+                communityAssetUrlCache.set(url.assetId, url);
+            }
+            return res.urls;
+        })
+            .finally(() => {
+            for (const assetId of chunk) {
+                communityAssetUrlInflight.delete(assetId);
+            }
+        });
+        for (const assetId of chunk) {
+            communityAssetUrlInflight.set(assetId, promise);
+        }
+        pending.push(promise);
+    }
+    const settled = await Promise.all(pending);
+    const requested = new Set(assetIds);
+    const seen = new Set(hits.map((h) => h.assetId));
+    for (const batch of settled) {
+        for (const url of batch) {
+            // A coalesced in-flight request may cover assets we weren't asked about.
+            if (!requested.has(url.assetId) || seen.has(url.assetId))
+                continue;
+            seen.add(url.assetId);
+            hits.push(url);
+        }
+    }
+    return hits;
+}
+/**
+ * Publish images to this arche's community, and browse what others published.
+ *
+ * The platform's only cross-user read path: an image published here is visible
+ * to every authenticated user of THIS arche (and no other), after it clears
+ * moderation. Publishing is free.
+ *
+ * Two things to design around:
+ *
+ *   1. **Publishing is not instant.** `publish` returns
+ *      `status: 'pending_moderation'`; the asset appears in `listCommunity`
+ *      only once it is approved. Show the author their own pending item via
+ *      `listMine` rather than optimistically adding it to the community feed.
+ *   2. **Store structure in the Data Store, not here.** Which asset belongs on
+ *      which page/level goes in a `shared`-scope collection holding `assetId`s.
+ *      Community Assets holds the bytes and nothing queryable.
+ *
+ * Permissions: `assets:community:read` for browsing and viewing;
+ * `assets:community:publish` additionally for publish / unpublish / listMine.
+ * A plugin that only DISPLAYS community content should declare only the former.
+ *
+ * @returns Community assets API.
+ */
+function useCommunityAssets() {
+    const bridge = useBridge();
+    const publish = (0, react_1.useCallback)(async (input) => {
+        const res = await (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.COMMUNITY_ASSETS_ENTITY_ID, 'publish', {
+            fileId: input.fileId,
+            title: input.title,
+            caption: input.caption,
+            tags: input.tags,
+            clientRef: input.clientRef,
+            attributionName: input.attributionName,
+        });
+        return res.asset;
+    }, [bridge]);
+    const publishMany = (0, react_1.useCallback)(async (items) => {
+        // Chunked to the server's cap for the same reason as `getUrls` — over the
+        // limit, Zod rejects the entire call, so "publish this 30-page book"
+        // published nothing rather than the first 20.
+        //
+        // SEQUENTIAL, unlike the URL chunks: each publish normalizes an image,
+        // writes a row and stages bytes to S3, and firing several chunks at once
+        // would push a burst through the per-(user, arche) quota checks and turn
+        // a partial success into a wall of QUOTA_EXCEEDED entries. Items already
+        // fail independently server-side, so results stay per-item either way.
+        const results = [];
+        for (let i = 0; i < items.length; i += entity_ops_1.COMMUNITY_ASSET_MAX_PUBLISH_BATCH) {
+            const res = await (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.COMMUNITY_ASSETS_ENTITY_ID, 'publish_many', { items: items.slice(i, i + entity_ops_1.COMMUNITY_ASSET_MAX_PUBLISH_BATCH) });
+            results.push(...res.results);
+        }
+        return results;
+    }, [bridge]);
+    const unpublish = (0, react_1.useCallback)(async (assetId) => {
+        const res = await (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.COMMUNITY_ASSETS_ENTITY_ID, 'unpublish', { assetId });
+        // Evict eagerly so a removed asset stops resolving from cache now, rather
+        // than up to the signature TTL later.
+        communityAssetUrlCache.delete(assetId);
+        return res.asset;
+    }, [bridge]);
+    const listMine = (0, react_1.useCallback)(async (options) => (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.COMMUNITY_ASSETS_ENTITY_ID, 'list_mine', {
+        limit: options?.limit,
+        cursor: options?.cursor,
+    }), [bridge]);
+    const listCommunity = (0, react_1.useCallback)(async (options) => (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.COMMUNITY_ASSETS_ENTITY_ID, 'list_community', { limit: options?.limit, cursor: options?.cursor, tag: options?.tag }), [bridge]);
+    const get = (0, react_1.useCallback)(async (assetId) => {
+        const res = await (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.COMMUNITY_ASSETS_ENTITY_ID, 'get', { assetId });
+        return res.asset;
+    }, [bridge]);
+    const getUrls = (0, react_1.useCallback)((assetIds) => fetchCommunityAssetUrls(bridge, assetIds), [bridge]);
+    const getUrl = (0, react_1.useCallback)(async (assetId) => {
+        const [url] = await fetchCommunityAssetUrls(bridge, [assetId]);
+        if (!url) {
+            throw new Error(`Community asset ${assetId} is not available`);
+        }
+        return url;
+    }, [bridge]);
+    const report = (0, react_1.useCallback)(async (assetId, reason, details) => (0, entity_ops_1.invokeEntityOp)(bridge, entity_ops_1.COMMUNITY_ASSETS_ENTITY_ID, 'report', { assetId, reason, details }), [bridge]);
+    return (0, react_1.useMemo)(() => ({
+        publish,
+        publishMany,
+        unpublish,
+        listMine,
+        listCommunity,
+        get,
+        getUrl,
+        getUrls,
+        report,
+    }), [publish, publishMany, unpublish, listMine, listCommunity, get, getUrl, getUrls, report]);
+}
+/**
+ * Declare Fias AI actions at RUNTIME — the dynamic half of the plugin
+ * AI-action plane (`ai:actions` permission; TRUSTED arches only — the host
+ * silently ignores runtime declarations from non-trusted arches, whose lane
+ * is the manifest `fiasAI` block, fixed at publish and reviewed with the
+ * submission). Both lanes merge host-side; the manifest wins id collisions.
+ *
+ * Pass `null` to declare nothing (e.g. while loading). The declaration and
+ * the state snapshot are each re-sent only when their content changes; the
+ * host additionally coalesces rapid re-sends trailing-edge (latest wins,
+ * applied within ~1s / ~250ms for state) — nothing is lost, but drive
+ * declaration changes off real capability changes, not render churn.
+ */
+function useFiasAIActions(config) {
+    const bridge = useBridge();
+    // The handler is registered once per bridge and reads the latest onAction
+    // through a ref — a re-render must not tear down dispatch handling.
+    const onActionRef = (0, react_1.useRef)(config?.onAction ?? null);
+    onActionRef.current = config?.onAction ?? null;
+    (0, react_1.useEffect)(() => {
+        bridge.setAiActionHandler((actionId, params) => {
+            const handler = onActionRef.current;
+            if (!handler) {
+                throw new Error('no Fias AI action handler is currently registered');
+            }
+            return handler(actionId, params);
+        });
+        return () => bridge.setAiActionHandler(null);
+    }, [bridge]);
+    // Declaration — content-diffed via JSON so callers may pass fresh object
+    // literals each render without re-sending (the host throttles this lane).
+    const declarationJson = config
+        ? JSON.stringify({ description: config.description, actions: config.actions })
+        : null;
+    (0, react_1.useEffect)(() => {
+        let cancelled = false;
+        void bridge.waitForInit().then(() => {
+            if (cancelled)
+                return;
+            bridge.declareAiActions(declarationJson ? JSON.parse(declarationJson) : null);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [bridge, declarationJson]);
+    // Clear the declaration when the consumer unmounts — the assistant must
+    // not keep offering verbs nothing will handle.
+    (0, react_1.useEffect)(() => {
+        return () => bridge.declareAiActions(null);
+    }, [bridge]);
+    // State snapshot — content-diffed like the declaration.
+    const stateJson = config?.state ? JSON.stringify(config.state) : null;
+    (0, react_1.useEffect)(() => {
+        if (stateJson === null)
+            return;
+        let cancelled = false;
+        void bridge.waitForInit().then(() => {
+            if (!cancelled)
+                bridge.sendAiState(JSON.parse(stateJson));
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [bridge, stateJson]);
+}
 //# sourceMappingURL=hooks.js.map