@tangle-network/agent-app 0.35.0 → 0.37.1

package/dist/studio/index.d.ts

@@ -0,0 +1,132 @@
+interface StudioIntegrationConnection {
+    status: string;
+    providerId: string;
+    connectorId: string;
+}
+type GenerationType = 'image' | 'video' | 'speech' | 'avatar' | 'transcription';
+type GenerationStatus = 'pending' | 'running' | 'succeeded' | 'failed';
+type MediaModelStatus = 'available' | 'limited' | 'unavailable';
+interface Generation {
+    id: string;
+    type: string;
+    prompt: string;
+    result: string | null;
+    model: string | null;
+    cost: number | null;
+    createdAt: Date | null;
+    metadata: Record<string, unknown> | null;
+}
+interface MediaModelOption {
+    id: string;
+    name: string;
+    provider?: string;
+    type: GenerationType;
+    status: MediaModelStatus;
+    reason?: string;
+}
+interface MediaModelCatalogResponse {
+    defaults: Record<GenerationType, string>;
+    models: Record<GenerationType, MediaModelOption[]>;
+    error?: string;
+}
+interface PublishPackage {
+    caption: string;
+    description: string;
+    mentions: string[];
+    destinations: string[];
+    cadence: string;
+    workflowDraft: boolean;
+    evalContract: {
+        artifactType: string;
+        deterministicChecks: string[];
+    };
+}
+interface PublishDestination {
+    id: string;
+    label: string;
+    providerIds: string[];
+    fields: string;
+}
+declare const GENERATION_TYPES: readonly GenerationType[];
+declare function isGenerationType(value: string): value is GenerationType;
+declare const DESTINATIONS: PublishDestination[];
+declare const CADENCES: string[];
+declare const MIN_IMAGE_COUNT = 1;
+declare const MAX_IMAGE_COUNT = 4;
+declare function relativeTime(date: Date | null): string;
+declare function outputPathFor(type: GenerationType): string;
+declare function generationVaultPath(generation: Generation): string | null;
+declare function buildPublishPackage({ caption, postDescription, mentions, cadence, destinations, }: {
+    caption: string;
+    postDescription: string;
+    mentions: string;
+    cadence: string;
+    destinations: string[];
+}): PublishPackage | null;
+declare function isPublishPackage(value: unknown): value is {
+    caption?: string;
+    description?: string;
+    mentions?: string[];
+    destinations?: string[];
+    cadence?: string;
+};
+declare function isDestinationConnected(destination: PublishDestination, connections: StudioIntegrationConnection[]): boolean;
+declare function selectedModelsWithDefaults(current: Partial<Record<GenerationType, string>>, catalog: MediaModelCatalogResponse): Partial<Record<GenerationType, string>>;
+declare function preferredModelId(type: GenerationType, catalog: MediaModelCatalogResponse | null): string | undefined;
+declare function modelMessage(model: MediaModelOption | undefined, loading: boolean, count: number): string | null;
+interface GenerationRequestFields {
+    workspaceId: string;
+    clientRequestId: string;
+    type: GenerationType;
+    model: string;
+    prompt: string;
+    negativePrompt: string;
+    outputPath: string;
+    publishPackage: PublishPackage | null;
+    image: {
+        size: string;
+        quality: string;
+        count: number;
+    };
+    video: {
+        duration: string;
+        resolution: string;
+        aspectRatio: string;
+        referenceImageUrl: string;
+    };
+    speech: {
+        voice: string;
+    };
+    avatar: {
+        audioUrl: string;
+        imageUrl: string;
+        avatarId: string;
+    };
+    transcription: {
+        audioUrl: string;
+        language: string;
+        responseFormat: string;
+        temperature: string;
+    };
+}
+declare function buildGenerationRequestBody(fields: GenerationRequestFields): Record<string, unknown>;
+declare function generationStatus(generation: Generation): GenerationStatus;
+declare function generationError(generation: Generation): string | null;
+declare function generationMergeKey(generation: Generation): string | null;
+declare function mergeLiveGeneration(current: Generation[], generation: Generation): Generation[];
+declare function mergeLoaderAndLive(loader: Generation[], live: Generation[]): Generation[];
+declare function isLocalGeneration(generation: Generation): boolean;
+declare function latestBatchOf(generations: Generation[]): Generation[];
+declare function userSafeGenerationMessage(message?: string): string;
+declare function optimisticGeneration({ type, prompt, model, clientRequestId, outputIndex, outputCount, }: {
+    type: GenerationType;
+    prompt: string;
+    model?: string;
+    clientRequestId: string;
+    outputIndex?: number;
+    outputCount?: number;
+}): Generation;
+declare function failedOptimisticGeneration(generation: Generation): Generation;
+declare function normalizeImageCount(value: unknown): number;
+
+export { CADENCES, DESTINATIONS, GENERATION_TYPES, type Generation, type GenerationRequestFields, type GenerationStatus, type GenerationType, MAX_IMAGE_COUNT, MIN_IMAGE_COUNT, type MediaModelCatalogResponse, type MediaModelOption, type MediaModelStatus, type PublishDestination, type PublishPackage, type StudioIntegrationConnection, buildGenerationRequestBody, buildPublishPackage, failedOptimisticGeneration, generationError, generationMergeKey, generationStatus, generationVaultPath, isDestinationConnected, isGenerationType, isLocalGeneration, isPublishPackage, latestBatchOf, mergeLiveGeneration, mergeLoaderAndLive, modelMessage, normalizeImageCount, optimisticGeneration, outputPathFor, preferredModelId, relativeTime, selectedModelsWithDefaults, userSafeGenerationMessage };

package/dist/studio/index.js

@@ -0,0 +1,59 @@
+import {
+  CADENCES,
+  DESTINATIONS,
+  GENERATION_TYPES,
+  MAX_IMAGE_COUNT,
+  MIN_IMAGE_COUNT,
+  buildGenerationRequestBody,
+  buildPublishPackage,
+  failedOptimisticGeneration,
+  generationError,
+  generationMergeKey,
+  generationStatus,
+  generationVaultPath,
+  isDestinationConnected,
+  isGenerationType,
+  isLocalGeneration,
+  isPublishPackage,
+  latestBatchOf,
+  mergeLiveGeneration,
+  mergeLoaderAndLive,
+  modelMessage,
+  normalizeImageCount,
+  optimisticGeneration,
+  outputPathFor,
+  preferredModelId,
+  relativeTime,
+  selectedModelsWithDefaults,
+  userSafeGenerationMessage
+} from "../chunk-DTS5TZRN.js";
+export {
+  CADENCES,
+  DESTINATIONS,
+  GENERATION_TYPES,
+  MAX_IMAGE_COUNT,
+  MIN_IMAGE_COUNT,
+  buildGenerationRequestBody,
+  buildPublishPackage,
+  failedOptimisticGeneration,
+  generationError,
+  generationMergeKey,
+  generationStatus,
+  generationVaultPath,
+  isDestinationConnected,
+  isGenerationType,
+  isLocalGeneration,
+  isPublishPackage,
+  latestBatchOf,
+  mergeLiveGeneration,
+  mergeLoaderAndLive,
+  modelMessage,
+  normalizeImageCount,
+  optimisticGeneration,
+  outputPathFor,
+  preferredModelId,
+  relativeTime,
+  selectedModelsWithDefaults,
+  userSafeGenerationMessage
+};
+//# sourceMappingURL=index.js.map

package/dist/studio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,193 @@
+import * as react from 'react';
+import { ReactNode, SelectHTMLAttributes } from 'react';
+import { Generation } from '../studio/index.js';
+import { IntegrationConnection } from '@tangle-network/sandbox-ui/integrations';
+import { Image } from 'lucide-react';
+
+type StudioRole = 'owner' | 'admin' | 'editor' | 'viewer';
+interface StudioWorkspaceProps {
+    generations: Generation[];
+    totalCost: number;
+    workspaceId?: string;
+    role: StudioRole;
+    /** Polling endpoint override (default `/api/generations`). */
+    generationsEndpoint?: string;
+    /** Build a vault link, optionally to a specific file. Defaults to `/app/<workspaceId>/vault`. */
+    vaultHref?: (filePath?: string | null) => string;
+    /** Integrations page href for the publish-package "Connect" link. Defaults to `/app/<workspaceId>/integrations`. */
+    integrationsHref?: string;
+}
+/**
+ * The full studio surface: header + composer + result canvas + library drawer,
+ * with the generation orchestrator (merge/poll/revalidate) wired in. The host
+ * route owns the loader (auth, RBAC, the generation query) and the server
+ * endpoints (`/api/generate`, `/api/media-models`, `/api/generations`); this
+ * shell renders that data and drives the live UI. Role gates the composer
+ * (viewers get a read-only library) and the integration-management affordances.
+ */
+declare function StudioWorkspace({ generations, totalCost, workspaceId, role, generationsEndpoint, vaultHref, integrationsHref, }: StudioWorkspaceProps): react.JSX.Element;
+
+/**
+ * The generation orchestrator behind a studio surface: it merges the loader's
+ * rows with in-flight live generations, computes the latest batch for the
+ * canvas, polls running generations until they settle, and revalidates the
+ * route loader when a status changes.
+ *
+ * The merge keeps the canvas, the library, and the polling path looking at the
+ * same full list. Polling hits `generationsEndpoint` (default `/api/generations`,
+ * the convention both apps already serve); pass an override if a product routes
+ * it elsewhere. `onGenerated` is wired to the composer's per-result callback.
+ */
+declare function useStudioGenerations(loaderGenerations: Generation[], options?: {
+    workspaceId?: string;
+    generationsEndpoint?: string;
+}): {
+    mergedGenerations: Generation[];
+    latestBatch: Generation[];
+    onGenerated: (generation: Generation) => void;
+};
+
+declare function ComposerHero({ workspaceId, integrationsHref, canManageIntegrations, onGenerated, }: {
+    workspaceId?: string;
+    integrationsHref?: string;
+    canManageIntegrations: boolean;
+    onGenerated: (generation: Generation) => void;
+}): react.JSX.Element;
+
+declare function Field({ label, htmlFor, className, children, }: {
+    label: string;
+    htmlFor?: string;
+    className?: string;
+    children: ReactNode;
+}): react.JSX.Element;
+declare function ComposerDisclosure({ summary, children }: {
+    summary: ReactNode;
+    children: ReactNode;
+}): react.JSX.Element;
+declare function NativeSelect(props: SelectHTMLAttributes<HTMLSelectElement>): react.JSX.Element;
+
+declare function StudioHeader({ count, onOpenLibrary, canGenerate, }: {
+    count: number;
+    onOpenLibrary: () => void;
+    canGenerate: boolean;
+}): react.JSX.Element;
+
+/**
+ * Right-side overlay sheet built on Radix Dialog — gives focus-trap, scroll-lock,
+ * and Escape-to-close for free. Slide/fade come from the studio-sheet-* classes in
+ * ./studio.css (driven by Radix data-state), not tailwindcss-animate.
+ */
+declare function StudioSheet({ open, onOpenChange, title, children, }: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    title: string;
+    children: ReactNode;
+}): react.JSX.Element;
+
+declare function ResultCanvas({ batch, onOpenLibrary, onSelect, }: {
+    batch: Generation[];
+    onOpenLibrary: () => void;
+    onSelect: (generation: Generation) => void;
+}): react.JSX.Element;
+
+declare function LibraryDrawer({ open, onOpenChange, generations, totalCost, typeFilter, onFilterChange, vaultHref, selected, onSelect, }: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    generations: Generation[];
+    totalCost: number;
+    typeFilter: string | null;
+    onFilterChange: (type: string | null) => void;
+    vaultHref?: (filePath?: string | null) => string;
+    selected: Generation | null;
+    onSelect: (generation: Generation | null) => void;
+}): react.JSX.Element;
+
+declare function GenerationCard({ generation, onSelect, }: {
+    generation: Generation;
+    onSelect: (generation: Generation) => void;
+}): react.JSX.Element;
+declare function GenerationStatusBadge({ generation, inline, }: {
+    generation: Generation;
+    inline?: boolean;
+}): react.JSX.Element | null;
+
+declare function GenerationDetail({ generation, vaultHref, onNavigate, }: {
+    generation: Generation;
+    vaultHref?: (filePath?: string | null) => string;
+    onNavigate?: () => void;
+}): react.JSX.Element;
+
+declare function PublishPackageComposer({ caption, postDescription, mentions, cadence, selectedDestinations, connections, connectionError, connectionsLoading, integrationsHref, canManageIntegrations, onCaptionChange, onDescriptionChange, onMentionsChange, onCadenceChange, onDestinationToggle, }: {
+    caption: string;
+    postDescription: string;
+    mentions: string;
+    cadence: string;
+    selectedDestinations: string[];
+    connections: IntegrationConnection[];
+    connectionError: Error | null;
+    connectionsLoading: boolean;
+    integrationsHref?: string;
+    canManageIntegrations: boolean;
+    onCaptionChange: (value: string) => void;
+    onDescriptionChange: (value: string) => void;
+    onMentionsChange: (value: string) => void;
+    onCadenceChange: (value: string) => void;
+    onDestinationToggle: (destination: string) => void;
+}): react.JSX.Element;
+
+interface TypeConfig {
+    label: string;
+    icon: typeof Image;
+    color: string;
+}
+declare const TYPE_CONFIG: Record<string, TypeConfig>;
+declare function typeConfigFor(type: string): TypeConfig;
+
+declare function ImageComposer({ size, quality, imageCount, onSizeChange, onQualityChange, onImageCountChange, }: {
+    size: string;
+    quality: string;
+    imageCount: number;
+    onSizeChange: (value: string) => void;
+    onQualityChange: (value: string) => void;
+    onImageCountChange: (value: number) => void;
+}): react.JSX.Element;
+
+declare function VideoComposer({ duration, resolution, aspectRatio, referenceImageUrl, onDurationChange, onResolutionChange, onAspectRatioChange, onReferenceImageUrlChange, }: {
+    duration: string;
+    resolution: string;
+    aspectRatio: string;
+    referenceImageUrl: string;
+    onDurationChange: (value: string) => void;
+    onResolutionChange: (value: string) => void;
+    onAspectRatioChange: (value: string) => void;
+    onReferenceImageUrlChange: (value: string) => void;
+}): react.JSX.Element;
+
+declare function SpeechComposer({ voice, onVoiceChange, }: {
+    voice: string;
+    onVoiceChange: (value: string) => void;
+}): react.JSX.Element;
+
+declare function AvatarComposer({ audioUrl, imageUrl, avatarId, onAudioUrlChange, onImageUrlChange, onAvatarIdChange, }: {
+    audioUrl: string;
+    imageUrl: string;
+    avatarId: string;
+    onAudioUrlChange: (value: string) => void;
+    onImageUrlChange: (value: string) => void;
+    onAvatarIdChange: (value: string) => void;
+}): react.JSX.Element;
+
+declare function TranscriptionComposer({ audioUrl, language, onAudioUrlChange, onLanguageChange, }: {
+    audioUrl: string;
+    language: string;
+    onAudioUrlChange: (value: string) => void;
+    onLanguageChange: (value: string) => void;
+}): react.JSX.Element;
+declare function TranscriptionOptions({ responseFormat, temperature, onResponseFormatChange, onTemperatureChange, }: {
+    responseFormat: string;
+    temperature: string;
+    onResponseFormatChange: (value: string) => void;
+    onTemperatureChange: (value: string) => void;
+}): react.JSX.Element;
+
+export { AvatarComposer, ComposerDisclosure, ComposerHero, Field, GenerationCard, GenerationDetail, GenerationStatusBadge, ImageComposer, LibraryDrawer, NativeSelect, PublishPackageComposer, ResultCanvas, SpeechComposer, StudioHeader, type StudioRole, StudioSheet, StudioWorkspace, type StudioWorkspaceProps, TYPE_CONFIG, TranscriptionComposer, TranscriptionOptions, type TypeConfig, VideoComposer, typeConfigFor, useStudioGenerations };