@tangle-network/agent-app 0.43.56 → 0.43.57

package/dist/assets/index.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 
+/** Define brand identity tokens including colors, font, logo, business name, and voice */
 interface BrandTokens {
     primaryColor: string;
     accentColor: string;
@@ -9,8 +10,11 @@ interface BrandTokens {
     businessName: string;
     voice: string;
 }
+/** Define valid asset format strings for various media and copy types */
 type AssetFormat = 'email' | 'image:feed' | 'image:story' | 'image:carousel' | 'video:reel' | 'video:feed' | 'copy:caption' | 'copy:headline' | 'copy:sms';
+/** Define possible states representing the lifecycle status of an asset */
 type AssetStatus = 'draft' | 'pending_review' | 'approved' | 'rejected' | 'scheduled' | 'published';
+/** Define the structure for a hero section in an email with headline, image, and call-to-action fields */
 interface EmailHeroSection {
     type: 'hero';
     headline: string;
@@ -19,16 +23,19 @@ interface EmailHeroSection {
     ctaLabel?: string;
     ctaUrl?: string;
 }
+/** Define the structure for the body section of an email containing plain text content */
 interface EmailBodySection {
     type: 'body';
     text: string;
 }
+/** Define a feature section with headline, description, and optional image for email content */
 interface EmailFeatureSection {
     type: 'feature';
     headline: string;
     description: string;
     imageUrl?: string;
 }
+/** Define the structure for an email testimonial section with quote, author, and optional details */
 interface EmailTestimonialSection {
     type: 'testimonial';
     quote: string;
@@ -36,22 +43,28 @@ interface EmailTestimonialSection {
     role?: string;
     avatarUrl?: string;
 }
+/** Define a call-to-action section with label, URL, and optional subtext for email content */
 interface EmailCtaSection {
     type: 'cta';
     label: string;
     url: string;
     subtext?: string;
 }
+/** Define a section representing a divider in an email layout */
 interface EmailDividerSection {
     type: 'divider';
 }
+/** Define a union type representing different sections of an email template */
 type EmailSection = EmailHeroSection | EmailBodySection | EmailFeatureSection | EmailTestimonialSection | EmailCtaSection | EmailDividerSection;
+/** Define the structure for email content including subject, optional preheader, and sections */
 interface EmailContent {
     subject: string;
     preheader?: string;
     sections: EmailSection[];
 }
+/** Define image layer categories for text, image, shape, or logo elements */
 type ImageLayerType = 'text' | 'image' | 'shape' | 'logo';
+/** Define properties for a text layer with position, style, and alignment options in an image */
 interface ImageTextLayer {
     type: 'text';
     text: string;
@@ -63,6 +76,7 @@ interface ImageTextLayer {
     width?: number;
     align?: 'left' | 'center' | 'right';
 }
+/** Define properties for an image layer including position, size, URL, and optional opacity */
 interface ImageImageLayer {
     type: 'image';
     url: string;
@@ -72,6 +86,7 @@ interface ImageImageLayer {
     height: number;
     opacity?: number;
 }
+/** Define properties for a shape layer representing rectangular or circular image elements */
 interface ImageShapeLayer {
     type: 'shape';
     shape: 'rect' | 'circle' | 'rounded-rect';
@@ -82,13 +97,16 @@ interface ImageShapeLayer {
     fill?: string;
     opacity?: number;
 }
+/** Define properties for positioning and sizing a logo image layer in a layout */
 interface ImageLogoLayer {
     type: 'logo';
     x: number;
     y: number;
     width?: number;
 }
+/** Resolve a union type representing different kinds of image layers */
 type ImageLayer = ImageTextLayer | ImageImageLayer | ImageShapeLayer | ImageLogoLayer;
+/** Define image background styles as color, gradient, or image with optional overlay settings */
 type ImageBackground = {
     type: 'color';
     value: string;
@@ -103,13 +121,16 @@ type ImageBackground = {
     overlay?: string;
     overlayOpacity?: number;
 };
+/** Define the structure for an image slide with a background and multiple layers */
 interface ImageSlide {
     background: ImageBackground;
     layers: ImageLayer[];
 }
+/** Define the structure for image content containing an array of image slides */
 interface ImageContent {
     slides: ImageSlide[];
 }
+/** Define properties for a video scene displaying animated text with optional background and effects */
 interface VideoTextAnimationScene {
     type: 'text-animation';
     durationSeconds: number;
@@ -118,29 +139,35 @@ interface VideoTextAnimationScene {
     animation?: 'fade' | 'slide-up' | 'typewriter';
     background?: ImageBackground;
 }
+/** Define a scene that reveals an image with optional caption over a specified duration */
 interface VideoImageRevealScene {
     type: 'image-reveal';
     durationSeconds: number;
     imageUrl: string;
     caption?: string;
 }
+/** Define a video slide scene with duration and associated image slide details */
 interface VideoSlideScene {
     type: 'slide';
     durationSeconds: number;
     slide: ImageSlide;
 }
+/** Define a countdown scene with duration, start time, and optional label for video sequences */
 interface VideoCountdownScene {
     type: 'countdown';
     durationSeconds: number;
     from: number;
     label?: string;
 }
+/** Resolve a video scene as one of several specific animation or reveal types */
 type VideoScene = VideoTextAnimationScene | VideoImageRevealScene | VideoSlideScene | VideoCountdownScene;
+/** Define video caption segments with start and end times and associated text content */
 interface VideoCaption {
     startSeconds: number;
     endSeconds: number;
     text: string;
 }
+/** Describe video content including duration, scenes, optional audio, captions, and rendered URL */
 interface VideoContent {
     durationSeconds: number;
     scenes: VideoScene[];
@@ -148,7 +175,9 @@ interface VideoContent {
     captions?: VideoCaption[];
     renderedUrl?: string;
 }
+/** Define platform options for copy content across various social media and communication channels */
 type CopyPlatform = 'instagram' | 'tiktok' | 'x' | 'linkedin' | 'sms' | 'email-subject';
+/** Define the structure for content with headline, body, platform, and optional hashtags and character count */
 interface CopyContent {
     headline: string;
     body: string;
@@ -156,6 +185,7 @@ interface CopyContent {
     platform: CopyPlatform;
     characterCount?: number;
 }
+/** Map asset keys to their corresponding content types for various media and copy formats */
 type AssetContentMap = {
     email: EmailContent;
     'image:feed': ImageContent;
@@ -167,6 +197,7 @@ type AssetContentMap = {
     'copy:headline': CopyContent;
     'copy:sms': CopyContent;
 };
+/** Define the structure and metadata for an asset including its format, brand, content, and status */
 interface AssetSpec<F extends AssetFormat = AssetFormat> {
     id: string;
     workspaceId: string;
@@ -179,6 +210,7 @@ interface AssetSpec<F extends AssetFormat = AssetFormat> {
     createdAt: string;
     updatedAt: string;
 }
+/** Describe an asset variant with identification, approval status, and edit history details */
 interface AssetVariant {
     id: string;
     parentId: string;
@@ -188,6 +220,7 @@ interface AssetVariant {
     rejectedAt?: string;
     editLog: ApprovalEvent[];
 }
+/** Describe an approval event with action details, user info, and optional edited fields */
 interface ApprovalEvent {
     assetId: string;
     variantId?: string;
@@ -196,6 +229,7 @@ interface ApprovalEvent {
     userId: string;
     timestamp: string;
 }
+/** Define metrics for tracking impressions, clicks, conversions, and related rates */
 interface ConversionMetrics {
     impressions: number;
     clicks: number;
@@ -204,6 +238,7 @@ interface ConversionMetrics {
     cvr: number;
 }
 
+/** Validate brand token properties including colors, font, logo URL, business name, and voice */
 declare const BrandTokensSchema: z.ZodObject<{
     primaryColor: z.ZodString;
     accentColor: z.ZodString;
@@ -213,6 +248,7 @@ declare const BrandTokensSchema: z.ZodObject<{
     businessName: z.ZodString;
     voice: z.ZodString;
 }, z.core.$strip>;
+/** Validate and parse email content objects with subject, optional preheader, and sections */
 declare const EmailContentSchema: z.ZodObject<{
     subject: z.ZodString;
     preheader: z.ZodOptional<z.ZodString>;
@@ -246,6 +282,7 @@ declare const EmailContentSchema: z.ZodObject<{
         type: z.ZodLiteral<"divider">;
     }, z.core.$strip>], "type">>;
 }, z.core.$strip>;
+/** Validate image content with an array of one or more slides containing background details */
 declare const ImageContentSchema: z.ZodObject<{
     slides: z.ZodArray<z.ZodObject<{
         background: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -308,6 +345,7 @@ declare const ImageContentSchema: z.ZodObject<{
         }, z.core.$strip>], "type">>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/** Define the schema for validating video content including duration, scenes, audio, captions, and rendered URL */
 declare const VideoContentSchema: z.ZodObject<{
     durationSeconds: z.ZodNumber;
     scenes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -416,6 +454,7 @@ declare const VideoContentSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     renderedUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/** Validate and parse copy content with headline, body, optional hashtags, platform, and character count */
 declare const CopyContentSchema: z.ZodObject<{
     headline: z.ZodString;
     body: z.ZodString;
@@ -430,6 +469,7 @@ declare const CopyContentSchema: z.ZodObject<{
     }>;
     characterCount: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+/** Validate approval event data including asset, action, user, timestamp, and optional fields */
 declare const ApprovalEventSchema: z.ZodObject<{
     assetId: z.ZodString;
     variantId: z.ZodOptional<z.ZodString>;
@@ -443,6 +483,7 @@ declare const ApprovalEventSchema: z.ZodObject<{
     userId: z.ZodString;
     timestamp: z.ZodString;
 }, z.core.$strip>;
+/** Validate conversion metrics with nonnegative impressions, clicks, conversions, CTR, and CVR fields */
 declare const ConversionMetricsSchema: z.ZodObject<{
     impressions: z.ZodNumber;
     clicks: z.ZodNumber;

package/dist/assets/index.js

@@ -8,7 +8,7 @@ import {
   VideoContentSchema,
   parseAssetSpec,
   safeParseAssetSpec
-} from "../chunk-5PTGEJZL.js";
+} from "../chunk-5SD6HT2V.js";
 export {
   ApprovalEventSchema,
   BrandTokensSchema,

package/dist/assistant/index.d.ts

@@ -1,17 +1,17 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { ToolDetailRenderers, ChatUiMessage } from '../web-react/index.js';
-import '../contract-KfqJh_au.js';
+import '../contract-TjB68uqA.js';
 import '@tangle-network/agent-interface';
 import '../plans/index.js';
-import '../parts-1sRYSPjF.js';
+import '../parts-n9XUon0a.js';
 import '../agent-activity-C8ZG0F0M.js';
-import '../flow-types-Cb_AblZs.js';
-import '../sandbox-terminal-BIIC__CP.js';
+import '../flow-types-CqomVAUN.js';
+import '../sandbox-terminal-ChNEdHF8.js';
 import '../catalog/index.js';
 import '../harness/index.js';
-import '../attachment-validation-D0csjCvz.js';
-import '../stream-normalizer-DWvtmY6F.js';
+import '../attachment-validation-tPRp-PP1.js';
+import '../stream-normalizer-C3M--r6y.js';
 
 /**
  * Wire + UI types for the in-app assistant panel. The wire shapes mirror the
@@ -20,6 +20,7 @@ import '../stream-normalizer-DWvtmY6F.js';
  * is the source of truth for what it accepts and emits.
  */
 
+/** Define delivery modes for assistant interaction as either steering or queue */
 type AssistantDeliveryMode = "steering" | "queue";
 /** Request body for `POST /api/v1/assistant/chat`. */
 interface ChatRequest {
@@ -33,12 +34,14 @@ interface ChatRequest {
     /** Per-turn idempotency key — guards against double-charge on retry. */
     turnKey?: string;
 }
+/** Describe the structure of data representing a thread event with optional model information */
 interface ThreadEventData {
     threadId: string;
     turnId: string;
     /** The model slug this turn ran against, when the server reports it. */
     model?: string | null;
 }
+/** Define data structure representing a delta event with associated text content */
 interface DeltaEventData {
     text: string;
 }
@@ -57,6 +60,7 @@ interface ToolCallEventData {
      *  exactly what was called. Omitted by servers predating the field. */
     args?: Record<string, unknown>;
 }
+/** Describe event data emitted after a tool execution completes with success or error details */
 interface ToolResultEventData {
     callId: string;
     name: string;
@@ -100,6 +104,7 @@ interface ConnectionRequirement {
 interface ConnectRequirementResult {
     connected: boolean;
 }
+/** Describe the data structure for events proposing tool usage with optional integration requirements */
 interface ToolProposalEventData {
     /** Null only if the server has no proposal store wired (tools then unusable). */
     proposalId: string | null;
@@ -110,6 +115,7 @@ interface ToolProposalEventData {
      *  and their current connection status. Omitted for non-authoring tools. */
     requirements?: ConnectionRequirement[];
 }
+/** Describe usage event data including tokens, cost, balance, duration, and replay status */
 interface UsageEventData {
     promptTokens: number | null;
     completionTokens: number | null;
@@ -121,6 +127,7 @@ interface UsageEventData {
     /** True when a completed turn was replayed from storage (no charge). */
     replayed?: boolean;
 }
+/** Describe the data emitted when a process turn completes including status and optional flags */
 interface DoneEventData {
     turnId: string;
     status: string;
@@ -129,6 +136,7 @@ interface DoneEventData {
     /** True when the agentic loop hit its tool-round cap. */
     capped?: boolean;
 }
+/** Describe error event data including code and message fields */
 interface ErrorEventData {
     code: string;
     message: string;
@@ -202,6 +210,7 @@ interface ConfirmedResult {
      *  (e.g. the key's name). */
     args?: unknown;
 }
+/** Define the structure and properties of a chat message including optional tool activity details */
 interface ChatMessage {
     id: string;
     role: ChatRole;
@@ -234,6 +243,7 @@ interface PendingProposal {
      *  confirm again. Null/absent when the card has not failed a retry. */
     retryError?: string | null;
 }
+/** Describe usage cost, balance, token counts, duration, and replay status for a settled turn */
 interface UsageInfo {
     costUsd: number | null;
     balanceUsd: number | null;
@@ -312,6 +322,7 @@ interface AssistantClientConfig {
      */
     headers?: () => Record<string, string>;
 }
+/** Define options for an assistant model including identifier, label, pricing, and context tokens */
 interface AssistantModelOption {
     slug: string;
     label: string;
@@ -320,6 +331,7 @@ interface AssistantModelOption {
     /** Context window in tokens, when known. */
     contextTokens?: number;
 }
+/** Define the structure for assistant model options including a default model slug and available models */
 interface AssistantModels {
     /** The slug the server uses when a turn selects no model. */
     default: string | null;
@@ -360,6 +372,7 @@ type ThreadHistoryResult = {
 } | {
     status: "error";
 };
+/** Represent the outcome of a confirmation process with success or failure details */
 type ConfirmResult = {
     ok: true;
     output: unknown;
@@ -368,6 +381,7 @@ type ConfirmResult = {
     ok: false;
     error: string;
 };
+/** Represent invalid client input errors with a specific code INVALID_REQUEST */
 declare class AssistantClientInputError extends Error {
     readonly code = "INVALID_REQUEST";
 }
@@ -460,6 +474,7 @@ interface AssistantState {
  * helpers; this hook is the glue between them and the network.
  */
 
+/** Define options for configuring how the assistant sends messages */
 interface AssistantSendOptions {
     deliveryMode?: AssistantDeliveryMode;
 }
@@ -484,6 +499,7 @@ interface UseAssistantChatOptions {
      */
     onConnectRequirement?: (requirement: ConnectionRequirement) => Promise<ConnectRequirementResult>;
 }
+/** Define the structure and behavior of an assistant chat session with state, model selection, and message handling */
 interface AssistantChat {
     state: AssistantState;
     /** Proposal ids whose confirmation is currently in flight (for disabling). */
@@ -511,6 +527,7 @@ interface AssistantChat {
      *  held closed until it resolves so a turn can't run against hidden context. */
     restoring: boolean;
 }
+/** Manage assistant chat state and interactions for a given user ID with optional configurations */
 declare function useAssistantChat(userId: string | null, options?: UseAssistantChatOptions): AssistantChat;
 
 /**
@@ -533,6 +550,7 @@ declare function useAssistantChat(userId: string | null, options?: UseAssistantC
  * dedup holds, no torn state.
  */
 
+/** Resolve and return the current assistant models from the per-client cache with immediate client swap updates */
 declare function useAssistantModels(): AssistantModels;
 
 /**
@@ -550,6 +568,7 @@ declare function useAssistantModels(): AssistantModels;
  * user or the client changed, and the request is aborted on the swap.
  */
 
+/** Manage and interact with a list of assistant threads including loading, refreshing, and removing threads */
 interface AssistantThreads {
     threads: AssistantThreadSummary[];
     loading: boolean;
@@ -568,6 +587,7 @@ interface AssistantThreads {
      *  shows the delete affordance. */
     canRemove: boolean;
 }
+/** Resolve and manage assistant threads state for a given user including pending deletions and refresh logic */
 declare function useAssistantThreads(userId: string | null): AssistantThreads;
 
 interface AssistantDockProps {

package/dist/assistant/index.js

@@ -3,15 +3,15 @@ import {
   ChatMessages,
   ModelPicker,
   ProviderLogo
-} from "../chunk-RVUISYUE.js";
-import "../chunk-65P3HJY3.js";
-import "../chunk-K63OWUDJ.js";
-import "../chunk-2QI7XV2T.js";
-import "../chunk-XKBIYSSM.js";
-import "../chunk-5MG74GVQ.js";
-import "../chunk-XAWFPMAR.js";
-import "../chunk-SIXYZ2FB.js";
-import "../chunk-MCJSS6SM.js";
+} from "../chunk-C3NSB66C.js";
+import "../chunk-HCOROIRT.js";
+import "../chunk-BPSV5AA2.js";
+import "../chunk-FBVLEGEG.js";
+import "../chunk-DTSPS2HV.js";
+import "../chunk-IG46XCZM.js";
+import "../chunk-YKOM4ZLQ.js";
+import "../chunk-YJMCRXQQ.js";
+import "../chunk-CQZSAR77.js";
 
 // src/assistant/sse.ts
 var SSEChunkParser = class {