@civitai/blocks-react 0.28.0 → 0.30.0

package/README.md

@@ -293,6 +293,36 @@ if (error instanceof WildcardPackError && error.code === 'busy') void refetch();
 if (!loading && pack) console.log(Object.keys(pack.lists));
 ```
 
+### `useAppWorkflows(params?)`
+
+The calling app's **own** generator subqueue — the tag-scoped list of generations
+**this app** produced for the viewer (newest-first), plus a fail-closed `cancel`.
+The host self-binds the account off the block token and **forces** the per-app tag
+filter, so a block only ever sees the queue it produced — never the viewer's
+personal queue or another app's. Returns `{ workflows, cursor, loading, error,
+refetch, cancel }`; each `AppWorkflow` is `{ workflowId, status, images[], cost,
+createdAt }`. Pass the returned `cursor` back as `params.cursor` to page forward.
+Requires `ai:write:budgeted` (same trust boundary as submit); host-mediated over
+`QUERY_APP_WORKFLOWS` / `CANCEL_APP_WORKFLOW`.
+
+`cancel(workflowId)` sends `CANCEL_APP_WORKFLOW`, resolves once the host confirms
+the terminal state (which is optimistically spliced into `workflows` in place — no
+refetch round-trip), and rejects with the host's error on failure.
+
+```tsx
+const { workflows, cursor, loading, error, refetch, cancel } = useAppWorkflows({ limit: 20 });
+if (!loading && !error) {
+  workflows.forEach((w) => console.log(w.workflowId, w.status, w.images.length, w.cost));
+}
+async function onCancel(id: string) {
+  try {
+    await cancel(id); // optimistically flips the row to `canceled`
+  } catch (err) {
+    console.error('cancel failed', err);
+  }
+}
+```
+
 ### `useAppStorage()`
 
 Per-(block instance, viewer) KV datastore, host-mediated. 64 KB per value,
@@ -583,7 +613,8 @@ Runnable, minimal blocks — one per feature, each with its own README:
 
 | `@civitai/blocks-react` | pairs with `@civitai/app-sdk` | adds |
 |---|---|---|
-| `0.27.x` | `^0.23.0` | async-scan image upload; transport validators for all `SHARED_*` / `APP_STORAGE_*` / picker replies |
+| `0.29.x` | `^0.24.0` | `useAppWorkflows()` — app generator subqueue read + cancel (`QUERY_APP_WORKFLOWS` / `CANCEL_APP_WORKFLOW`) |
+| `0.27.x`–`0.28.x` | `^0.23.0` | async-scan image upload; transport validators for all `SHARED_*` / `APP_STORAGE_*` / picker replies |
 | `0.26.x` | `^0.22.0` | `useViewer()` (`GET_VIEWER`) |
 | `0.25.x` | `^0.21.0` | `useBuzzTransactions`, `useBuzzAccounts`, `useDailyCompensation`, `useWildcardPack` |
 | `0.5.0` | `^0.7.0` | `useBuzzWorkflow().cancel()` (real server-side cancel, gotcha #51) |

package/dist/hooks/useAppWorkflows.d.ts

@@ -0,0 +1,54 @@
+import type { AppWorkflow, AppWorkflowsParams } from '@civitai/app-sdk/blocks';
+export type { AppWorkflow, AppWorkflowsParams };
+/**
+ * What {@link useAppWorkflows} returns.
+ */
+export interface UseAppWorkflows {
+    /** The current page's workflows (newest-first). `[]` until the first successful fetch. */
+    workflows: AppWorkflow[];
+    /**
+     * The next-page cursor, or `null` when there's no further page. Pass it back as
+     * `params.cursor` on a subsequent call to page forward.
+     */
+    cursor: string | null;
+    /** `true` while a fetch (initial or `refetch`) is in flight. */
+    loading: boolean;
+    /**
+     * The last fetch's failure — a host-reported error (anon viewer / missing
+     * `ai:write:budgeted` scope / rate-limit / host failure) or the transport
+     * timeout. Free-text. Cleared at the start of the next fetch. A failed
+     * {@link cancel} does NOT set this (it rejects its own promise instead).
+     */
+    error: Error | null;
+    /** Re-request the current page. */
+    refetch: () => void;
+    /**
+     * Cancel ONE workflow in this app's subqueue (host `CANCEL_APP_WORKFLOW`). The
+     * host is FAIL-CLOSED — it verifies the viewer/app own the workflow before the
+     * orchestrator cancel — so a block can only cancel a gen it submitted. Resolves
+     * once the host confirms the terminal state, which is OPTIMISTICALLY spliced
+     * into `workflows` in place (no refetch round-trip); rejects with the host's
+     * free-text error on failure (FORBIDDEN / transport). Unmount-safe.
+     */
+    cancel: (workflowId: string) => Promise<void>;
+}
+/**
+ * Read (and cancel within) the calling app's OWN generator SUBQUEUE — the
+ * tag-scoped list of generations THIS app produced for the viewer, newest-first —
+ * through the host-mediated `QUERY_APP_WORKFLOWS` → `APP_WORKFLOWS_RESULT` and
+ * `CANCEL_APP_WORKFLOW` → `CANCEL_APP_WORKFLOW_RESULT` bridges. Token-bound: the
+ * host self-binds the account off the block token and FORCES the per-app tag
+ * filter (scope `ai:write:budgeted`, same trust boundary as submit) — the block
+ * can never widen the filter or reach another user's / their personal queue.
+ *
+ * Fetches on mount and whenever `params` change (by value), and exposes `refetch`.
+ * A host that never answers surfaces as an `error` after the transport's request
+ * timeout — the hook never hangs. Late responses that arrive after unmount are
+ * ignored.
+ *
+ * @example
+ * const { workflows, cursor, loading, error, cancel } = useAppWorkflows({ limit: 20 });
+ * // …render each workflow's images; await cancel(w.workflowId) on a Cancel click.
+ */
+export declare function useAppWorkflows(params?: AppWorkflowsParams): UseAppWorkflows;
+//# sourceMappingURL=useAppWorkflows.d.ts.map

package/dist/hooks/useAppWorkflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppWorkflows.d.ts","sourceRoot":"","sources":["../../src/hooks/useAppWorkflows.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAK/E,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0FAA0F;IAC1F,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;;;OAOG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAyE5E"}

package/dist/hooks/useAppWorkflows.js

@@ -0,0 +1,82 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { getTransport } from '../internal/singleton.js';
+import { sendTypedRequest } from '../internal/transport.js';
+/**
+ * Read (and cancel within) the calling app's OWN generator SUBQUEUE — the
+ * tag-scoped list of generations THIS app produced for the viewer, newest-first —
+ * through the host-mediated `QUERY_APP_WORKFLOWS` → `APP_WORKFLOWS_RESULT` and
+ * `CANCEL_APP_WORKFLOW` → `CANCEL_APP_WORKFLOW_RESULT` bridges. Token-bound: the
+ * host self-binds the account off the block token and FORCES the per-app tag
+ * filter (scope `ai:write:budgeted`, same trust boundary as submit) — the block
+ * can never widen the filter or reach another user's / their personal queue.
+ *
+ * Fetches on mount and whenever `params` change (by value), and exposes `refetch`.
+ * A host that never answers surfaces as an `error` after the transport's request
+ * timeout — the hook never hangs. Late responses that arrive after unmount are
+ * ignored.
+ *
+ * @example
+ * const { workflows, cursor, loading, error, cancel } = useAppWorkflows({ limit: 20 });
+ * // …render each workflow's images; await cancel(w.workflowId) on a Cancel click.
+ */
+export function useAppWorkflows(params) {
+    const [workflows, setWorkflows] = useState([]);
+    const [cursor, setCursor] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    // Serialize the params to a stable key so `refetch`'s identity only changes
+    // when the params VALUE changes (not on every render's fresh object). The
+    // callback re-parses the key so it closes over NOTHING but the key.
+    const paramsKey = params ? JSON.stringify(params) : '';
+    const refetch = useCallback(() => {
+        setLoading(true);
+        setError(null);
+        const parsed = paramsKey ? JSON.parse(paramsKey) : undefined;
+        const payload = parsed ? { params: parsed } : {};
+        sendTypedRequest(getTransport(), { type: 'QUERY_APP_WORKFLOWS', payload }, 'APP_WORKFLOWS_RESULT')
+            .then((result) => {
+            if (!mountedRef.current)
+                return;
+            if (result.error || !result.result) {
+                setError(new Error(result.error ?? 'failed to fetch app workflows'));
+                setLoading(false);
+                return;
+            }
+            setWorkflows(result.result.workflows);
+            setCursor(result.result.cursor ?? null);
+            setLoading(false);
+        })
+            .catch((err) => {
+            if (!mountedRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+            setLoading(false);
+        });
+    }, [paramsKey]);
+    useEffect(() => {
+        refetch();
+    }, [refetch]);
+    const cancel = useCallback(async (workflowId) => {
+        const reply = await sendTypedRequest(getTransport(), { type: 'CANCEL_APP_WORKFLOW', payload: { workflowId } }, 'CANCEL_APP_WORKFLOW_RESULT');
+        if (reply.error || !reply.result) {
+            throw new Error(reply.error ?? 'failed to cancel workflow');
+        }
+        const canceled = reply.result.workflow;
+        // Optimistically splice the terminal (canceled) projection into the current
+        // page in place — no refetch round-trip. Functional update so it never races
+        // a concurrent refetch's stale closure. Only touches the row if it's present
+        // (the host returns the canceled workflow regardless).
+        if (mountedRef.current) {
+            setWorkflows((prev) => prev.map((w) => (w.workflowId === canceled.workflowId ? canceled : w)));
+        }
+    }, []);
+    return { workflows, cursor, loading, error, refetch, cancel };
+}
+//# sourceMappingURL=useAppWorkflows.js.map

package/dist/hooks/useAppWorkflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppWorkflows.js","sourceRoot":"","sources":["../../src/hooks/useAppWorkflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIjE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAqC5D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAAC,MAA2B;IACzD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,EAAE,CAAC,CAAC;IAC9D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,4EAA4E;IAC5E,0EAA0E;IAC1E,oEAAoE;IACpE,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAwB,CAAC,CAAC,CAAC,SAAS,CAAC;QACrF,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,gBAAgB,CACd,YAAY,EAAE,EACd,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,EACxC,sBAAsB,CACvB;aACE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAChC,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,+BAA+B,CAAC,CAAC,CAAC;gBACrE,UAAU,CAAC,KAAK,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACtC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;YACxC,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAChC,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,CAAC;IACZ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,UAAkB,EAAiB,EAAE;QACrE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAClC,YAAY,EAAE,EACd,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,EACxD,4BAA4B,CAC7B,CAAC;QACF,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QACvC,4EAA4E;QAC5E,6EAA6E;QAC7E,6EAA6E;QAC7E,uDAAuD;QACvD,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CACpB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACvE,CAAC;QACJ,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAChE,CAAC"}

package/dist/hooks/useGatedImages.d.ts

@@ -0,0 +1,45 @@
+import type { BlockGatedImage } from '@civitai/app-sdk/blocks';
+export type { BlockGatedImage };
+/**
+ * What {@link useGatedImages} returns.
+ */
+export interface UseGatedImages {
+    /**
+     * Ask the host for per-VIEWER gated display data for a list of image ids, and
+     * resolve with a {@link BlockGatedImage} per resolvable id.
+     *
+     * The host applies the REQUESTING VIEWER's browsing-level clamp server-side, so
+     * the shape a viewer receives depends on THEIR ceiling:
+     *  - `status: 'visible'` — scanned clean + within ceiling + unflagged: the full
+     *    moderated projection incl. `url` and `width`/`height` for grid layout.
+     *  - `status: 'hidden'` — the image exists but is withheld from THIS viewer
+     *    (above ceiling / not-yet-scanned / flagged): NO `url` is ever returned, so
+     *    the block MUST render a blurred/placeholder cell for it. The block can
+     *    never obtain an unclamped url for an image the viewer isn't allowed to see.
+     *
+     * Ids the host can't resolve to a benchmark-eligible bare `Image` row are
+     * OMITTED entirely (neither visible nor hidden), so the returned array MAY be
+     * shorter than `imageIds`. Rejects with the host's free-text error on failure,
+     * or the transport timeout — the hook never hangs.
+     */
+    getImages: (imageIds: number[]) => Promise<BlockGatedImage[]>;
+}
+/**
+ * Read per-viewer gated display data for a list of image ids via the
+ * host-mediated `GET_IMAGES_BY_IDS` → `IMAGES_RESULT` bridge — the read side of
+ * a cross-user image grid (e.g. ids stored via `useSharedStorage()`).
+ *
+ * The host applies the requesting viewer's browsing-level clamp server-side and
+ * returns each image as `visible` (moderated projection incl. url) or `hidden`
+ * (NO url — above ceiling / unscanned / flagged). This is the load-bearing
+ * cross-user moderation boundary: an unclamped edge URL never crosses to a viewer
+ * who can't see the image, and the block must render a placeholder for any
+ * `hidden` entry.
+ *
+ * @example
+ * const { getImages } = useGatedImages();
+ * const images = await getImages([101, 102, 103]);
+ * // …render `visible` cells with their url; `hidden` cells as a blurred placeholder.
+ */
+export declare function useGatedImages(): UseGatedImages;
+//# sourceMappingURL=useGatedImages.d.ts.map

package/dist/hooks/useGatedImages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGatedImages.d.ts","sourceRoot":"","sources":["../../src/hooks/useGatedImages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK/D,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,IAAI,cAAc,CAc/C"}

package/dist/hooks/useGatedImages.js

@@ -0,0 +1,31 @@
+import { useCallback } from 'react';
+import { getTransport } from '../internal/singleton.js';
+import { sendTypedRequest } from '../internal/transport.js';
+/**
+ * Read per-viewer gated display data for a list of image ids via the
+ * host-mediated `GET_IMAGES_BY_IDS` → `IMAGES_RESULT` bridge — the read side of
+ * a cross-user image grid (e.g. ids stored via `useSharedStorage()`).
+ *
+ * The host applies the requesting viewer's browsing-level clamp server-side and
+ * returns each image as `visible` (moderated projection incl. url) or `hidden`
+ * (NO url — above ceiling / unscanned / flagged). This is the load-bearing
+ * cross-user moderation boundary: an unclamped edge URL never crosses to a viewer
+ * who can't see the image, and the block must render a placeholder for any
+ * `hidden` entry.
+ *
+ * @example
+ * const { getImages } = useGatedImages();
+ * const images = await getImages([101, 102, 103]);
+ * // …render `visible` cells with their url; `hidden` cells as a blurred placeholder.
+ */
+export function useGatedImages() {
+    const getImages = useCallback(async (imageIds) => {
+        const reply = await sendTypedRequest(getTransport(), { type: 'GET_IMAGES_BY_IDS', payload: { imageIds } }, 'IMAGES_RESULT');
+        if (reply.error || !reply.result) {
+            throw new Error(reply.error ?? 'failed to fetch gated images');
+        }
+        return reply.result.images;
+    }, []);
+    return { getImages };
+}
+//# sourceMappingURL=useGatedImages.js.map

package/dist/hooks/useGatedImages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGatedImages.js","sourceRoot":"","sources":["../../src/hooks/useGatedImages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAIpC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA6B5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,QAAkB,EAA8B,EAAE;QACrF,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAClC,YAAY,EAAE,EACd,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EACpD,eAAe,CAChB,CAAC;QACF,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,8BAA8B,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAC7B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}

package/dist/hooks/usePublishGenerationOutputs.d.ts

@@ -0,0 +1,50 @@
+/**
+ * What {@link usePublishGenerationOutputs} returns.
+ */
+export interface UsePublishGenerationOutputs {
+    /**
+     * Ask the host to PUBLISH selected outputs of ONE of this app's OWN workflows
+     * (from its generator subqueue) as bare, REAL-SCANNED public `Image` rows, and
+     * resolve with the created image ids (order matches the resolved outputs).
+     *
+     * The block sends the `workflowId` + optional `imageIndexes` (indexes into the
+     * workflow's `images` as seen via `useAppWorkflows()`) — NEVER urls. The host
+     * resolves the orchestrator urls server-side from the ownership-verified
+     * workflow, so the iframe can't inject an arbitrary blob. FAIL-CLOSED
+     * server-side: the host re-derives (viewer, app, workflowId) ownership before
+     * reading the workflow, re-uploads each selected output to civitai storage, and
+     * runs the FULL image-scan pipeline (no skip) — the returned ids are bare
+     * (post-less), scanned `Image` rows with no Post / gallery attach / rewards /
+     * notifications. Host-chrome shows a consent confirm before publishing. Omit
+     * `imageIndexes` to publish all available outputs; `title` is an optional
+     * advisory label the host MAY ignore.
+     *
+     * Rejects with the host's free-text error on failure (anon viewer / missing
+     * scope / not-owned workflow / rate-limit / upload or scan failure) or the
+     * transport timeout — the hook never hangs.
+     */
+    publish: (args: {
+        workflowId: string;
+        imageIndexes?: number[];
+        title?: string;
+    }) => Promise<number[]>;
+}
+/**
+ * Publish selected outputs of one of the calling app's OWN generations into bare,
+ * real-scanned public `Image` rows via the host-mediated
+ * `PUBLISH_GENERATION_OUTPUTS` → `PUBLISH_RESULT` bridge.
+ *
+ * Token-bound + fail-closed: the host self-binds the account off the block token,
+ * re-derives (viewer, app, workflowId) ownership before reading the workflow, and
+ * re-uploads + FULL-scans each selected output server-side (no url ever crosses
+ * from the iframe). The result is a set of bare (post-less) scanned `Image` row
+ * ids — no Post, no gallery attach, no rewards/notifications. Host-chrome shows a
+ * consent confirm before anything is published.
+ *
+ * @example
+ * const { publish } = usePublishGenerationOutputs();
+ * const imageIds = await publish({ workflowId: w.workflowId, imageIndexes: [0, 2] });
+ * // …store imageIds via useSharedStorage() so the grid can read them back gated.
+ */
+export declare function usePublishGenerationOutputs(): UsePublishGenerationOutputs;
+//# sourceMappingURL=usePublishGenerationOutputs.d.ts.map

package/dist/hooks/usePublishGenerationOutputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePublishGenerationOutputs.d.ts","sourceRoot":"","sources":["../../src/hooks/usePublishGenerationOutputs.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACvG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,IAAI,2BAA2B,CAwBzE"}

package/dist/hooks/usePublishGenerationOutputs.js

@@ -0,0 +1,38 @@
+import { useCallback } from 'react';
+import { getTransport } from '../internal/singleton.js';
+import { sendTypedRequest } from '../internal/transport.js';
+/**
+ * Publish selected outputs of one of the calling app's OWN generations into bare,
+ * real-scanned public `Image` rows via the host-mediated
+ * `PUBLISH_GENERATION_OUTPUTS` → `PUBLISH_RESULT` bridge.
+ *
+ * Token-bound + fail-closed: the host self-binds the account off the block token,
+ * re-derives (viewer, app, workflowId) ownership before reading the workflow, and
+ * re-uploads + FULL-scans each selected output server-side (no url ever crosses
+ * from the iframe). The result is a set of bare (post-less) scanned `Image` row
+ * ids — no Post, no gallery attach, no rewards/notifications. Host-chrome shows a
+ * consent confirm before anything is published.
+ *
+ * @example
+ * const { publish } = usePublishGenerationOutputs();
+ * const imageIds = await publish({ workflowId: w.workflowId, imageIndexes: [0, 2] });
+ * // …store imageIds via useSharedStorage() so the grid can read them back gated.
+ */
+export function usePublishGenerationOutputs() {
+    const publish = useCallback(async (args) => {
+        const reply = await sendTypedRequest(getTransport(), {
+            type: 'PUBLISH_GENERATION_OUTPUTS',
+            payload: {
+                workflowId: args.workflowId,
+                ...(args.imageIndexes !== undefined ? { imageIndexes: args.imageIndexes } : {}),
+                ...(args.title !== undefined ? { title: args.title } : {}),
+            },
+        }, 'PUBLISH_RESULT');
+        if (reply.error || !reply.result) {
+            throw new Error(reply.error ?? 'failed to publish generation outputs');
+        }
+        return reply.result.imageIds;
+    }, []);
+    return { publish };
+}
+//# sourceMappingURL=usePublishGenerationOutputs.js.map

package/dist/hooks/usePublishGenerationOutputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePublishGenerationOutputs.js","sourceRoot":"","sources":["../../src/hooks/usePublishGenerationOutputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA8B5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,OAAO,GAAG,WAAW,CACzB,KAAK,EAAE,IAAqE,EAAqB,EAAE;QACjG,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAClC,YAAY,EAAE,EACd;YACE,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE;gBACP,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/E,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3D;SACF,EACD,gBAAgB,CACjB,CAAC;QACF,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,sCAAsC,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC/B,CAAC,EACD,EAAE,CACH,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

@@ -32,7 +32,13 @@ export { useDailyCompensation } from './hooks/useDailyCompensation.js';
 export type { UseDailyCompensation } from './hooks/useDailyCompensation.js';
 export { useWildcardPack, WildcardPackError } from './hooks/useWildcardPack.js';
 export type { UseWildcardPack } from './hooks/useWildcardPack.js';
-export type { BlockBuzzTransaction, BlockBuzzAccount, BlockDailyCompensationResource, BlockWildcardPack, BlockWildcardPackErrorCode, } from '@civitai/app-sdk/blocks';
+export { useAppWorkflows } from './hooks/useAppWorkflows.js';
+export type { UseAppWorkflows } from './hooks/useAppWorkflows.js';
+export { usePublishGenerationOutputs } from './hooks/usePublishGenerationOutputs.js';
+export type { UsePublishGenerationOutputs } from './hooks/usePublishGenerationOutputs.js';
+export { useGatedImages } from './hooks/useGatedImages.js';
+export type { UseGatedImages } from './hooks/useGatedImages.js';
+export type { BlockBuzzTransaction, BlockBuzzAccount, BlockDailyCompensationResource, BlockWildcardPack, BlockWildcardPackErrorCode, AppWorkflow, AppWorkflowImage, AppWorkflowsParams, BlockGatedImage, } from '@civitai/app-sdk/blocks';
 export { useCheckpointPicker } from './hooks/useCheckpointPicker.js';
 export { useResourcePicker } from './hooks/useResourcePicker.js';
 export { useImageUpload } from './hooks/useImageUpload.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -24,6 +24,9 @@ export { useBuzzTransactions } from './hooks/useBuzzTransactions.js';
 export { useBuzzAccounts } from './hooks/useBuzzAccounts.js';
 export { useDailyCompensation } from './hooks/useDailyCompensation.js';
 export { useWildcardPack, WildcardPackError } from './hooks/useWildcardPack.js';
+export { useAppWorkflows } from './hooks/useAppWorkflows.js';
+export { usePublishGenerationOutputs } from './hooks/usePublishGenerationOutputs.js';
+export { useGatedImages } from './hooks/useGatedImages.js';
 export { useCheckpointPicker } from './hooks/useCheckpointPicker.js';
 export { useResourcePicker } from './hooks/useResourcePicker.js';
 export { useImageUpload } from './hooks/useImageUpload.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAG3F,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAO3D,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAShF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAOzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAG3F,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAO3D,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAErF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAa3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAOzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/internal/liveHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"liveHost.d.ts","sourceRoot":"","sources":["../../src/internal/liveHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,OAAO,EACL,KAAK,YAAY,EAGjB,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,KAAK,UAAU,EAGhB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,QAAQ,EAAyC,MAAM,eAAe,CAAC;AACrF,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAK5B;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAChE,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,UAAU,CAAC;IACpC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACvD;AAQD;;;;;GAKG;AACH,UAAU,wBAAwB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB,CAgB/E;AAyHD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAssCjE"}
+{"version":3,"file":"liveHost.d.ts","sourceRoot":"","sources":["../../src/internal/liveHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,OAAO,EACL,KAAK,YAAY,EAGjB,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,KAAK,UAAU,EAGhB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,QAAQ,EAAyC,MAAM,eAAe,CAAC;AACrF,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAK5B;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAChE,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,UAAU,CAAC;IACpC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACvD;AAQD;;;;;GAKG;AACH,UAAU,wBAAwB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB,CAgB/E;AAyHD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CA+yCjE"}

package/dist/internal/liveHost.js

@@ -696,6 +696,93 @@ export function createLiveHost(options) {
                         });
                         return;
                     }
+                    case 'QUERY_APP_WORKFLOWS': {
+                        // App generator SUBQUEUE read via the token-bound
+                        // `blocks.queryAppWorkflows` MUTATION (POST). params (cursor/limit) are
+                        // spread FIRST so the host-authoritative `blockToken` (spread LAST) can
+                        // never be overridden — mirrors the real host; the host also forces the
+                        // per-app tag filter server-side (the input carries no `tags`). It
+                        // returns a plain `{ workflows, cursor }`, unwrapped with `callTrpcData`.
+                        // FREE-TEXT error on failure. Unroutable without requestId.
+                        if (typeof requestId !== 'string')
+                            return;
+                        void callTrpcData('blocks.queryAppWorkflows', { ...(typed.payload?.params ?? {}), blockToken: rawToken }, 'POST').then((r) => {
+                            dispatchToBlock({
+                                type: 'APP_WORKFLOWS_RESULT',
+                                payload: r.data
+                                    ? { requestId, result: r.data }
+                                    : { requestId, error: r.error ?? 'app workflows unavailable' },
+                            });
+                        });
+                        return;
+                    }
+                    case 'CANCEL_APP_WORKFLOW': {
+                        // Cancel ONE subqueue workflow via the token-bound
+                        // `blocks.cancelAppWorkflow` MUTATION (POST). FAIL-CLOSED server-side
+                        // (ownership + app-tag guard). Returns a plain `{ workflow }` (the
+                        // terminal projection), unwrapped with `callTrpcData`. FREE-TEXT error
+                        // on failure (FORBIDDEN / transport). Drop a request with no requestId
+                        // or a missing/empty workflowId (mirrors the real host).
+                        if (typeof requestId !== 'string')
+                            return;
+                        const cancelId = typed.payload?.workflowId;
+                        if (typeof cancelId !== 'string' || cancelId.length === 0)
+                            return;
+                        void callTrpcData('blocks.cancelAppWorkflow', { blockToken: rawToken, workflowId: cancelId }, 'POST').then((r) => {
+                            dispatchToBlock({
+                                type: 'CANCEL_APP_WORKFLOW_RESULT',
+                                payload: r.data
+                                    ? { requestId, result: r.data }
+                                    : { requestId, error: r.error ?? 'cancel failed' },
+                            });
+                        });
+                        return;
+                    }
+                    case 'PUBLISH_GENERATION_OUTPUTS': {
+                        // Publish selected outputs of one of the app's OWN workflows as bare,
+                        // real-scanned public Image rows via the token-bound
+                        // `blocks.publishGenerationOutputs` MUTATION (POST). The block sends
+                        // `workflowId` + optional `imageIndexes` (NEVER urls); the host
+                        // re-derives ownership, re-uploads + FULL-scans server-side. Returns a
+                        // plain `{ imageIds }`, unwrapped with `callTrpcData`. FREE-TEXT error
+                        // on failure. Unroutable without requestId.
+                        if (typeof requestId !== 'string')
+                            return;
+                        void callTrpcData('blocks.publishGenerationOutputs', {
+                            blockToken: rawToken,
+                            workflowId: typed.payload?.workflowId,
+                            ...(typed.payload?.imageIndexes !== undefined
+                                ? { imageIndexes: typed.payload.imageIndexes }
+                                : {}),
+                            ...(typed.payload?.title !== undefined ? { title: typed.payload.title } : {}),
+                        }, 'POST').then((r) => {
+                            dispatchToBlock({
+                                type: 'PUBLISH_RESULT',
+                                payload: r.data
+                                    ? { requestId, result: r.data }
+                                    : { requestId, error: r.error ?? 'publish unavailable' },
+                            });
+                        });
+                        return;
+                    }
+                    case 'GET_IMAGES_BY_IDS': {
+                        // Per-viewer gated image read via the token-bound `blocks.getImagesByIds`
+                        // MUTATION (POST). The host applies the requesting viewer's
+                        // browsing-level clamp server-side and returns a plain `{ images }`
+                        // (`BlockGatedImage[]` — visible/hidden), unwrapped with `callTrpcData`.
+                        // FREE-TEXT error on failure. Unroutable without requestId.
+                        if (typeof requestId !== 'string')
+                            return;
+                        void callTrpcData('blocks.getImagesByIds', { blockToken: rawToken, imageIds: typed.payload?.imageIds ?? [] }, 'POST').then((r) => {
+                            dispatchToBlock({
+                                type: 'IMAGES_RESULT',
+                                payload: r.data
+                                    ? { requestId, result: r.data }
+                                    : { requestId, error: r.error ?? 'gated images unavailable' },
+                            });
+                        });
+                        return;
+                    }
                     case 'OPEN_CHECKPOINT_PICKER': {
                         // Serve the picker locally: open the in-harness catalog browser
                         // filtered to Checkpoints in the requested ecosystem, pre-highlight