@tangle-network/agent-app 0.46.2 → 0.46.3

package/dist/stories/studio/StudioProviders.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from 'react';
+import type { Generation } from '../../studio';
+import type { StudioMediaActions } from '../../studio/ports';
+export declare function StudioProviders({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare const storyMediaActions: StudioMediaActions;
+/** Composer screens need their model catalog without pretending generation works. */
+export declare function installStudioComposerFetchStub(): void;
+export declare const noOpGenerated: (generation: Generation) => void;

package/dist/stories/studio/fixtures.d.ts

@@ -1,9 +1,12 @@
-import type { Generation } from '../../studio';
+import type { FetchGenerationsPage, Generation, GenerationPage } from '../../studio';
+/** Tiny browser-native silent WAV used by stories that exercise real playback. */
+export declare function silentWavDataUri(seconds: number): string;
 export declare const teaserA: Generation;
 export declare const storyboardGeneration: Generation;
 export declare const videoGeneration: Generation;
 export declare const avatarGeneration: Generation;
 export declare const speechGeneration: Generation;
+export declare const speechGenerationPlayable: Generation;
 export declare const transcriptionGeneration: Generation;
 export declare const queuedGeneration: Generation;
 export declare const runningGeneration: Generation;
@@ -14,5 +17,10 @@ export declare const teaserBatch: Generation[];
 /** Populated library: the newest batch first, every type and status represented. */
 export declare const libraryGenerations: Generation[];
 export declare const libraryTotalCost = 1.87;
-/** Mirrors StudioWorkspace's default vaultHref (see generation-detail.test.tsx). */
+/** Large enough to exercise search, filtering, and a second cursor page. */
+export declare const historyGenerations: Generation[];
+export declare function makeGenerationPage(items: Generation[], nextCursor?: string): GenerationPage;
+/** In-memory version of the history endpoint, including abortable latency. */
+export declare function fakeFetchGenerationsPage(all: Generation[]): FetchGenerationsPage;
+/** Demo story route for opening a persisted generation in the vault. */
 export declare const demoVaultHref: (filePath?: string | null) => string;

package/dist/studio/audio-preview.d.ts

@@ -0,0 +1,12 @@
+/** A deterministic waveform bar used when decoded audio is unavailable. */
+export interface WaveformBar {
+    /** 7–100, % of tile height. */
+    heightPct: number;
+    opacity: number;
+}
+export declare const GRID_WAVEFORM_BARS = 26;
+export declare const WIDE_WAVEFORM_BARS = 72;
+/** Hash a string with FNV-1a into an unsigned 32-bit seed. */
+export declare function hashSeed(value: string): number;
+/** Build stable pseudo-waveform bars for a media preview. */
+export declare function previewWaveformBars(seed: string, count: number): readonly WaveformBar[];

package/dist/studio/generation.d.ts

@@ -114,8 +114,29 @@ export declare function optimisticGeneration({ type, prompt, model, clientReques
     clientRequestId: string;
     outputIndex?: number;
     outputCount?: number;
-}): Generation;
+}, aspectRatio?: number): Generation;
 /** Mark a generation as failed with updated status and error information */
 export declare function failedOptimisticGeneration(generation: Generation): Generation;
 /** Normalize a value to a finite integer within the allowed image count range */
 export declare function normalizeImageCount(value: unknown): number;
+/** Resolve a generation's batch identity, preferring the server batch id. */
+export declare function generationBatchKey(generation: Generation): string;
+/** Resolve the stored media asset id, when present. */
+export declare function generationAssetId(generation: Generation): string | null;
+/** Select and order all outputs belonging to a generation batch. */
+export declare function generationsInBatch(generations: readonly Generation[], batchKey: string): Generation[];
+/** Resolve the best available aspect ratio for a generation row. */
+export declare function generationAspectRatio(generation: Generation): number;
+/** Resolve a requested lane's aspect ratio from its selected options. */
+export declare function aspectRatioFromOptions(type: GenerationType, options: {
+    size?: string;
+    aspectRatio?: string;
+}): number | undefined;
+/** Choose the default vault folder shared by a homogeneous media selection. */
+export declare function defaultVaultPathFor(generations: readonly Generation[]): string;
+/** Normalize a user-entered relative vault folder or reject an unsafe path. */
+export declare function normalizeVaultPath(input: string): string | null;
+/** Append a page while preserving the first row seen for each id. */
+export declare function mergeGenerationPages(prev: readonly Generation[], next: readonly Generation[]): Generation[];
+/** Resolve only the human-readable media specification fields a row carries. */
+export declare function generationSpecSegments(generation: Generation): string[];

package/dist/studio/index.d.ts

@@ -10,3 +10,5 @@
  */
 export * from './generation';
 export * from './model-options';
+export * from './ports';
+export * from './audio-preview';

package/dist/studio/index.js

@@ -2,29 +2,43 @@ import {
   FALLBACK_VIDEO_MODEL_OPTIONS,
   GENERATION_TYPES,
   GPT_IMAGE_2_CUSTOM_SIZE,
+  GRID_WAVEFORM_BARS,
   IMAGE_TO_VIDEO_SIBLINGS,
   MAX_IMAGE_COUNT,
+  MEDIA_TYPE_FILTERS,
   MIN_IMAGE_COUNT,
+  WIDE_WAVEFORM_BARS,
+  aspectRatioFromOptions,
   buildGenerationRequestBody,
   curateComposerModels,
+  defaultVaultPathFor,
   failedOptimisticGeneration,
+  generationAspectRatio,
+  generationAssetId,
+  generationBatchKey,
   generationError,
   generationMergeKey,
+  generationSpecSegments,
   generationStatus,
   generationVaultPath,
+  generationsInBatch,
+  hashSeed,
   imageToVideoSibling,
   isGenerationType,
   isLocalGeneration,
   latestBatchOf,
+  mergeGenerationPages,
   mergeLiveGeneration,
   mergeLoaderAndLive,
   modelMessage,
   normalizeImageCount,
+  normalizeVaultPath,
   optimisticGeneration,
   optionChoices,
   optionDefault,
   outputPathFor,
   preferredModelId,
+  previewWaveformBars,
   reconcileOptionValues,
   relativeTime,
   resolveComposerOptions,
@@ -33,34 +47,48 @@ import {
   textToVideoSibling,
   userSafeGenerationMessage,
   validateCustomImageSize
-} from "../chunk-2RTYQU4W.js";
+} from "../chunk-LEGZX5MQ.js";
 export {
   FALLBACK_VIDEO_MODEL_OPTIONS,
   GENERATION_TYPES,
   GPT_IMAGE_2_CUSTOM_SIZE,
+  GRID_WAVEFORM_BARS,
   IMAGE_TO_VIDEO_SIBLINGS,
   MAX_IMAGE_COUNT,
+  MEDIA_TYPE_FILTERS,
   MIN_IMAGE_COUNT,
+  WIDE_WAVEFORM_BARS,
+  aspectRatioFromOptions,
   buildGenerationRequestBody,
   curateComposerModels,
+  defaultVaultPathFor,
   failedOptimisticGeneration,
+  generationAspectRatio,
+  generationAssetId,
+  generationBatchKey,
   generationError,
   generationMergeKey,
+  generationSpecSegments,
   generationStatus,
   generationVaultPath,
+  generationsInBatch,
+  hashSeed,
   imageToVideoSibling,
   isGenerationType,
   isLocalGeneration,
   latestBatchOf,
+  mergeGenerationPages,
   mergeLiveGeneration,
   mergeLoaderAndLive,
   modelMessage,
   normalizeImageCount,
+  normalizeVaultPath,
   optimisticGeneration,
   optionChoices,
   optionDefault,
   outputPathFor,
   preferredModelId,
+  previewWaveformBars,
   reconcileOptionValues,
   relativeTime,
   resolveComposerOptions,

package/dist/studio/ports.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Product seams for the studio media library. A product such as gtm-agent
+ * implements these against its `/api/generations`, `/api/media/save`, and
+ * `/api/generations/bulk-delete` routes. The ports themselves are never fetched
+ * by the shell; note the assembled screens ALSO require the host to serve
+ * `StudioComposer`'s `/api/generate` and `/api/media-models` (see
+ * `../studio-react/index.tsx`), and `useStudioGenerations` polls its
+ * `generationsEndpoint` (default `/api/generations`).
+ */
+import type { Generation } from './generation';
+export type MediaTypeFilter = 'all' | 'image' | 'video' | 'speech';
+export declare const MEDIA_TYPE_FILTERS: readonly {
+    value: MediaTypeFilter;
+    label: string;
+}[];
+export interface GenerationPageQuery {
+    /** Trimmed prompt search; '' means no filter. Goes on the wire as `q`. */
+    q: string;
+    type: MediaTypeFilter;
+    /** null for the first page; otherwise the server's opaque cursor. */
+    cursor: string | null;
+    signal: AbortSignal;
+}
+export interface GenerationPage {
+    items: Generation[];
+    nextCursor?: string;
+}
+export type FetchGenerationsPage = (query: GenerationPageQuery) => Promise<GenerationPage>;
+export interface VaultSaveResult {
+    generationId: string;
+    vaultPath: string;
+}
+export type SaveGenerationsToVault = (input: {
+    generations: readonly Generation[];
+    path: string;
+    signal?: AbortSignal;
+}) => Promise<readonly VaultSaveResult[]>;
+/** The shell may invoke this during page teardown (the `pagehide`/unmount flush
+ *  of a deferred delete). Implementations must use unload-survivable transport
+ *  such as `fetch(..., { keepalive: true })` or `navigator.sendBeacon`, and keep
+ *  the payload within the keepalive transport's approximately 64 KB bound. */
+export type DeleteGenerations = (ids: readonly string[]) => Promise<void>;
+export type DownloadGenerations = (generations: readonly Generation[]) => void | Promise<void>;
+/** Every media action a tile / viewer / batch bar can offer. An ABSENT member
+ *  hides its control — a product with no vault endpoint must not render a
+ *  "Save to vault" button that does nothing. */
+export interface StudioMediaActions {
+    download?: DownloadGenerations;
+    save?: SaveGenerationsToVault;
+    remove?: DeleteGenerations;
+    vaultHref?: (filePath?: string | null) => string;
+    /** Intercept the vault link for SPA nav; the href stays for middle-click. */
+    onOpenVault?: (generation: Generation) => void;
+}

package/dist/studio-react/composer-option-controls.d.ts

@@ -13,7 +13,7 @@
  * the band no longer points at anything, so it closes when the pill's
  * horizontal CENTRE leaves the band's box.
  */
-import { type ReactNode, type RefObject } from 'react';
+import { type JSX, type ReactNode, type RefObject } from 'react';
 import { type LucideIcon } from 'lucide-react';
 import { type MediaModelOption, type ModelOptionValue } from '../studio';
 /** One media lane's segment: the icon it shows collapsed, the word it shows
@@ -32,7 +32,7 @@ export declare function MediaTypeSegments<T extends string>({ value, segments, o
     value: T;
     segments: readonly MediaTypeSegment<T>[];
     onChange: (type: T) => void;
-}): import("react").JSX.Element;
+}): JSX.Element;
 /**
  * The middle scroller. It hides its scrollbar and fades whichever edge has
  * content behind it, at the DEPTH of what is actually hidden (capped at
@@ -46,12 +46,23 @@ export declare function ComposerBand({ bandRef, resetKey, children, }: {
     /** Changing this scrolls the band back to the start. */
     resetKey: string;
     children: ReactNode;
-}): import("react").JSX.Element;
+}): JSX.Element;
 /** One renderable value: the wire value, untouched, and how it reads. */
 export interface OptionChoice {
     value: ModelOptionValue;
     label: string;
 }
+/** A standalone enum picker using the studio composer's pill and menu grammar. */
+export declare function MenuPill<T extends string>({ label, value, choices, onSelect, className, }: {
+    label: string;
+    value: T;
+    choices: readonly {
+        value: T;
+        label: string;
+    }[];
+    onSelect: (value: T) => void;
+    className?: string;
+}): JSX.Element;
 /**
  * A value pill and the menu it opens.
  *
@@ -74,7 +85,7 @@ export declare function OptionPill({ label, value, choices, onSelect, bandRef, c
             close: () => void;
         }) => ReactNode;
     };
-}): import("react").JSX.Element;
+}): JSX.Element;
 /**
  * The custom-size form the Size menu swaps to.
  *
@@ -86,7 +97,7 @@ export declare function CustomSizeForm({ initial, onApply, onCancel, }: {
     initial?: string;
     onApply: (size: string) => void;
     onCancel: () => void;
-}): import("react").JSX.Element;
+}): JSX.Element;
 /**
  * The audio switch. It is a toggle rather than a menu because the parameter has
  * exactly two states, and a two-row menu to say "on" is a menu that costs a
@@ -95,7 +106,7 @@ export declare function CustomSizeForm({ initial, onApply, onCancel, }: {
 export declare function AudioTogglePill({ on, onToggle }: {
     on: boolean;
     onToggle: (on: boolean) => void;
-}): import("react").JSX.Element;
+}): JSX.Element;
 /**
  * The reference-image pill: the only control that changes which MODEL runs, so
  * the swap to the image-to-video sibling is the caller's (`onAttach`/`onRemove`)
@@ -112,7 +123,7 @@ export declare function ReferencePill({ url, onAttach, onRemove, pick, bandRef,
     onRemove: () => void;
     pick?: () => Promise<string | null>;
     bandRef: RefObject<HTMLDivElement | null>;
-}): import("react").JSX.Element;
+}): JSX.Element;
 /**
  * The model pill — first in the band on every lane, and the only pill that is
  * always there. A model with no published option metadata renders this and
@@ -128,7 +139,7 @@ export declare function ModelPill({ models, value, displayName, provider, onSele
     provider?: string;
     onSelect: (id: string) => void;
     bandRef: RefObject<HTMLDivElement | null>;
-}): import("react").JSX.Element;
+}): JSX.Element;
 /**
  * How a wire value reads, with the wire value itself untouched underneath.
  *

package/dist/studio-react/download-generations.d.ts

@@ -0,0 +1,4 @@
+import type { DownloadGenerations } from '../studio/ports';
+/** Same-origin anchor download, staggered so the browser does not swallow
+ *  every request after the first. Default when no `download` port is given. */
+export declare const downloadGenerationsViaAnchor: DownloadGenerations;

package/dist/studio-react/index.d.ts

@@ -1,29 +1,45 @@
 /**
  * `@tangle-network/agent-app/studio-react` — the media-generation studio
- * surface: `StudioComposer`, a chat-shaped card over three generation types
- * (image / video / speech) whose option pills are the SELECTED MODEL's own
- * published parameters, plus a result canvas and a right-side asset-library
- * drawer with card + detail views. `StudioWorkspace` is the ready-to-mount shell (header +
- * composer + canvas + drawer + the merge/poll/revalidate orchestrator); the
- * leaf components are exported so a product can compose its own shell.
+ * surface: three screens over injected ports plus the pieces they compose.
  *
- * The host route owns the loader (auth / RBAC / generation query) and the
- * server endpoints it talks to (`/api/generate`, `/api/media-models`,
- * `/api/generations`). Styling: Tailwind against the shared design tokens via
- * `@tangle-network/sandbox-ui` primitives; the slide/bloom/shimmer animations
- * ship at `./studio-react/styles` (apps that lack those classes import it once).
+ * - `StudioHomeScreen` — the centered `StudioComposer` above a full-bleed
+ *   "Recent media" grid.
+ * - `StudioGenerationScreen` — one prompt's batch: shimmer skeletons at the
+ *   chosen aspect, results, and the docked composer on an opaque band.
+ * - `StudioHistoryScreen` — server-side search + media-type filter, select
+ *   mode with batch actions, cursor-paginated lazy loading.
+ * - `MediaTile` / `MediaViewerModal` — the shared tile (hover scrim, vault
+ *   state, select circle, audio badge) and the viewer with the audio
+ *   transport.
+ * - `StudioToastProvider` + `StudioPlaybackProvider` — required above every
+ *   screen: bottom-centre toasts with Undo, and ONE audio playback state
+ *   shared by tiles and the viewer.
+ * - `useDeferredDelete` / `useGenerationHistory` / `useBatchNavigation` —
+ *   the undo-window delete, cursor paging, and once-per-batch navigation.
+ *
+ * The host route owns the loader (auth / RBAC / generation query), the server
+ * endpoints (`/api/generate`, `/api/media-models`, `/api/generations`, save /
+ * delete routes), navigation between the screens, and the providers;
+ * `useStudioGenerations` is the merge/poll/revalidate orchestrator a host
+ * route drives. Data and actions reach the screens only through the seams in
+ * `../studio/ports` — an absent action hides its control. This subpath is
+ * sandbox-ui-free and Radix-free; styling is Tailwind against the shared
+ * design tokens, with studio-specific rules at `./studio-react/styles`.
  */
-export * from './studio-workspace';
 export * from './use-studio-generations';
 export * from './studio-composer';
+export * from './composer-option-controls';
 export * from './generation-notice';
-export * from './studio-header';
-export * from './studio-sheet';
-export * from './result-canvas';
-export * from './library-drawer';
-export * from './library-panel';
-export * from './generation-grid';
-export * from './generation-card';
-export * from './generation-detail';
-export * from './generation-detail-modal';
-export * from './type-config';
+export * from './media-tile';
+export * from './media-viewer';
+export * from './studio-home-screen';
+export * from './studio-generation-screen';
+export * from './studio-history-screen';
+export * from './studio-toasts';
+export * from './studio-confirm';
+export * from './vault-path-popover';
+export * from './studio-playback';
+export * from './use-batch-navigation';
+export * from './use-generation-history';
+export * from './use-deferred-delete';
+export * from './download-generations';