@tangle-network/sandbox-ui 2.0.7 → 2.0.8

package/dist/index-D70BfRTV.d.ts

@@ -1,308 +0,0 @@
-import { d as AgentGraphNode, n as AgentGraphProps } from "./AgentGraph-DzdpPFEI.js";
-import { ReactNode } from "react";
-import { ApprovalCard, ApprovalCardProps, ApprovalDiffFile, ApprovalDiffSummary, ApprovalPlanStep, ExpandedToolDetail, ExpandedToolDetailProps, FeedSegment, InlineThinkingItem as InlineThinkingItem$1, InlineThinkingItemProps, InlineToolItem, InlineToolItemProps, LiveDuration, RunGroup, RunGroupProps, RunPhase, RunPhaseList, RunRowShell as RunRowShell$1, RunRowShellProps, RunRowStatus, RunRowStatusDot, RunStatus, RunStatusIcon as RunStatusIcon$1, RunStatusIconProps, StatusMeta, TaskList, TaskListItem, TaskListProps, TaskStatus, ToolCallData, ToolCallData as ToolCallData$1, ToolCallFeed, ToolCallFeedProps, ToolCallStatus, ToolCallType, parseToolEvent, runStatus as runStatus$1, showsTaskPriority, statusMeta as statusMeta$1, taskProgress, taskStatus } from "@tangle-network/ui/run";
-import { FlowWaterfallProps } from "@tangle-network/charts/react";
-import { FlowMarker, FlowSpan, FlowTrace } from "@tangle-network/charts";
-/** Agent and model spans show their lab/host mark; tool spans show their provider's mark. Unknown keeps the kind glyph. */
-declare function traceSpanMark(span: FlowSpan): ReactNode;
-type TraceWaterfallProps = FlowWaterfallProps;
-/**
- * The run inspector: the agent timeline (`defaultView="agents"`) and the span waterfall over one clock, from
- * `@tangle-network/charts`, with Sandbox UI's brand marks. Feed it `otlpFlowTrace(spans)` from the
- * `traces convert` contract. Import `@tangle-network/charts/react/flow-waterfall.css` once.
- */
-declare function TraceWaterfall({ renderIcon, ...props }: TraceWaterfallProps): import("react").JSX.Element;
-/** A moment on the run's event track: a release, a check verdict, a spawn, a crash or a steer. */
-interface TraceEvent extends FlowMarker {}
-interface TraceWorkspaceProps extends Omit<TraceWaterfallProps, "trace" | "markers" | "onSelect" | "onTimeChange" | "selectedId" | "onDeselect" | "graph" | "latestEvents"> {
-  trace: FlowTrace;
-  /** The selected agent's message stream (Server-Sent Events: rows, reset, end; reconnects with ?after=lastSeq). */
-  streamUrl?: (agentId: string) => string;
-  events?: TraceEvent[];
-  /** The time the reader moved to, in trace ms; null while following live or showing the whole run. */
-  onTimeChange?: (t: number | null) => void;
-  /**
-   * The code workspace as of the cursor and scoped to the selected agent, usually a WorkspaceFilesPane: the page answers
-   * the as-of query. It spans the full width and at least 70% of the viewport. Keep its key on the commit so a scrub
-   * keeps its state.
-   */
-  files?: ReactNode;
-  /** The scoreboard as of the cursor, under the code workspace; omitted when not given. */
-  scoreboard?: ReactNode;
-  selectedAgentId?: string;
-  /** Called with the agent the reader selected, or undefined when they close its drawer or press Escape. */
-  onSelectAgent?: (agentId: string | undefined) => void;
-  /**
-   * What the trace cannot say about a live agent, by agent id: its activity, thinking line, latest events, commits or
-   * result. Timed agents follow the trace cursor. Workers without recorded timing retain their live identity and metadata.
-   */
-  agentCards?: Readonly<Record<string, Partial<AgentGraphNode>>>;
-  /** Existing graph layouts and recorded edges/tools; node identity and clock stay with this workspace. */
-  agentGraph?: Partial<Pick<AgentGraphProps, "edges" | "tools" | "calls" | "you" | "direction" | "title" | "className">> & {
-    defaultLayout?: AgentGraphProps["layout"];
-  };
-  className?: string;
-}
-/**
- * The run workspace: the agent timeline and span waterfall over one clock, the selected agent's conversation
- * streaming in a right-hand drawer, and the page's code workspace and scoreboard following the time cursor. Scrubbing is time travel:
- * every panel shows what was true at the cursor, and the conversation shows what had been said by then.
- */
-declare function TraceWorkspace({ trace, streamUrl, events, onTimeChange, files, scoreboard, selectedAgentId, onSelectAgent, agentCards, agentGraph, className, ...waterfall }: TraceWorkspaceProps): import("react").JSX.Element;
-/** One row of an agent's message stream (tangle-tools `/api/discovery/runs/<run>/agents/<agent>/stream`). */
-interface AgentStreamRow {
-  seq: number;
-  /** ISO time the event happened. */
-  at: string;
-  stream?: string;
-  attempt?: number;
-  event: {
-    kind: "text" | "reasoning" | "tool-call" | "tool-result" | "user" | "notice" | (string & {});
-    text?: string;
-    /** A notice's origin: the agent's `delegated-input`, its `recorded-result`, or a capture fact such as `capture-unavailable`. */
-    provenance?: string;
-    toolCallId?: string;
-    toolName?: string;
-    args?: unknown;
-    result?: unknown;
-  };
-}
-/** A transcript entry with the time it began, so a time cursor can show the conversation as of any moment. */
-type AgentTranscriptEntry = {
-  id: string;
-  at: number;
-  kind: "message";
-  role: "assistant" | "user";
-  content: string;
-  sealed?: true;
-} | {
-  id: string;
-  at: number;
-  kind: "reasoning";
-  text: string;
-} | {
-  id: string;
-  at: number;
-  kind: "tool";
-  call: ToolCallData;
-} | {
-  id: string;
-  at: number;
-  kind: "notice";
-  text: string;
-};
-interface AgentStreamState {
-  generation?: string | number;
-  entries: AgentTranscriptEntry[];
-  lastSeq: number;
-  /** The agent is still producing output. */
-  alive: boolean;
-  /** Why the stream shows nothing new; a reconnect that delivers rows clears it. */
-  error?: string;
-}
-/** Fold stream rows into transcript entries: text of one turn merges, a tool call becomes a row its result completes. */
-declare function foldAgentRows(entries: AgentTranscriptEntry[], rows: readonly AgentStreamRow[]): AgentTranscriptEntry[];
-/**
- * Follow one agent's message stream over Server-Sent Events: `rows`, `reset` and `end` events, reconnecting with
- * `?after=<lastSeq>` when the server closes the connection, so a long turn streams without gaps or repeats.
- */
-declare function useAgentStream(url: string | undefined): AgentStreamState;
-interface LatestEventsProps {
-  agents: readonly AgentGraphNode[];
-  n?: number;
-  now?: number;
-  /** Observe incoming status changes. Disable when scrubbing a trace without an epoch. */
-  live?: boolean;
-  selectedId?: string | null;
-  onSelect?: (id: string) => void;
-}
-/** Recorded events and locally observed state changes. Hover or focus holds the reading position. */
-declare function LatestEvents({ agents, n, now, live, selectedId, onSelect }: LatestEventsProps): import("react").JSX.Element;
-/** Presentation inputs, not a wire schema. Producers validate retained data before rendering it. */
-interface ConversationNode {
-  id: string;
-  label: string;
-  parent: string | null;
-  kind: string;
-  role?: string;
-  assignment?: string;
-  model?: string | null;
-  servedModel?: string | null;
-  start?: string;
-  status?: string;
-  nativeSessionId?: string;
-  agentId?: string;
-  joinBasis?: string;
-  joinProof?: Record<string, unknown>;
-  capture?: {
-    status: string;
-  };
-  [field: string]: unknown;
-}
-interface ConversationEvent {
-  id: string;
-  node: string;
-  at: string;
-  end?: string;
-  kind: string;
-  category: string;
-  label: string;
-  source?: {
-    path: string;
-    sha256?: string;
-    line?: number;
-    pointer?: string;
-    [field: string]: unknown;
-  } | null;
-  detail: {
-    role?: string;
-    publicText?: string;
-    publicationNote?: string | null;
-    contentOmitted?: string;
-    publicToolCalls?: {
-      id: string;
-      name: string;
-      input?: string;
-      publicationNote?: string | null;
-    }[];
-    toolCallIds?: string[];
-    toolNames?: string[];
-    toolCallId?: string;
-    isError?: boolean;
-    responseStatus?: string;
-    recordedClaim?: string;
-    assessment?: string;
-    usage?: {
-      input?: number;
-      output?: number;
-      cacheRead?: number;
-      cacheWrite?: number;
-      [field: string]: unknown;
-    } | null;
-    reasoning?: string;
-    reasoningOmitted?: number;
-    reasoningRedacted?: number;
-    durationMs?: number;
-    costListUsd?: number;
-    clip?: {
-      bytes: number;
-      sha256: string | null;
-    };
-    [field: string]: unknown;
-  };
-  [field: string]: unknown;
-}
-interface ConversationRecord {
-  runId: string;
-  nodes: ConversationNode[];
-  events: ConversationEvent[];
-}
-declare namespace model_d_exports {
-  export { RecordIndex, ToolCall, TooltipSection, agentState, callsOf, compact, eventMatches, eventSource, fmt, hostless, hoverLines, indexRecord, interval, measuredUsage, modelIdentity, ms, preview, roleOf, textOf, toolKey, tooltipSections, utcTime };
-}
-interface ToolCall {
-  id: string;
-  name: string;
-  input?: string;
-  publicationNote?: string | null;
-}
-declare const ms: (value: string) => number;
-/** Normalize labels to UTC without rewriting the source timestamp. */
-declare function utcTime(value: string, includeDate?: boolean): string;
-declare const compact: (value: string) => string;
-declare function hostless(text: string): string;
-declare function hostless(text: string | undefined): string | undefined;
-declare const fmt: (value: number) => string;
-declare const interval: (value: number) => string;
-declare const roleOf: (node?: ConversationNode) => string;
-declare const textOf: (event: ConversationEvent) => string;
-declare const toolKey: (node: string, id: string) => string;
-declare function callsOf(event: ConversationEvent): ToolCall[];
-/** A tool call's subject: its command, path or question, never its JSON. */
-declare function preview(call: ToolCall): string;
-/** Identity is established by the importer, never inferred from labels or timestamps. */
-declare function indexRecord<R extends ConversationRecord>(record: R): {
-  nodes: Map<string, ConversationNode>;
-  canonical: (id: string) => string;
-  actors: ConversationNode[];
-  events: ConversationEvent[];
-  byEvent: Map<string, ConversationEvent>;
-  recordedOrder: Map<string, number>;
-  byActor: Map<string, R["events"][number][]>;
-  calls: Map<string, {
-    event: R["events"][number];
-    call: ToolCall;
-  }[]>;
-  results: Map<string, R["events"][number][]>;
-  start: number;
-  end: number;
-};
-type RecordIndex<R extends ConversationRecord = ConversationRecord> = ReturnType<typeof indexRecord<R>>;
-/** Whether any event of this agent recorded token usage or a list price: a status alone measures nothing. */
-declare function measuredUsage(index: RecordIndex, id: string): boolean;
-/** An agent's recorded state, qualified when nothing about it was measured or captured. A live agent has no terminal
- * state yet: `live` is its state while the run runs (Runtime's progress document), and it reads as working. */
-declare function agentState(node: ConversationNode | undefined, measured: boolean, live?: string | null): string;
-declare function eventMatches(event: ConversationEvent, index: RecordIndex, query: string, category: string): boolean;
-declare function eventSource(event: ConversationEvent, record: ConversationRecord, index: RecordIndex): {
-  path?: string | undefined;
-  sha256?: string;
-  line?: number;
-  pointer?: string;
-  runId: string;
-  at: string;
-  observedNodeId: string;
-  agentId: string | null;
-  nativeSessionId: string | null;
-  joinBasis: string | null;
-  joinProof: Record<string, unknown> | null;
-};
-declare function hoverLines(event: ConversationEvent, index: RecordIndex, cutoff: number): string[];
-/** A declared model is configuration; only response metadata shows which model served. */
-declare function modelIdentity(node: ConversationNode | undefined, record: ConversationRecord): string | null;
-interface TooltipSection {
-  kind: 'header' | 'body' | 'usage' | 'status' | 'note';
-  label?: string;
-  value: string;
-  tone?: 'default' | 'error' | 'ok' | 'warn' | 'muted' | 'accent';
-}
-declare function tooltipSections(event: ConversationEvent, index: RecordIndex, cutoff: number): {
-  title: string;
-  category: string;
-  tone: string;
-  sections: TooltipSection[];
-};
-interface EventFlag {
-  dimension: string;
-  label: string;
-  polarity: string;
-  title: string;
-}
-interface ConversationProps {
-  index: RecordIndex;
-  actor: string;
-  cutoff: number;
-  query: string;
-  category: string;
-  selected?: string;
-  /** Open the full text of a clipped body by its source hash. */
-  openSource?: (sha256: string, event: ConversationEvent) => void;
-  /** Assessment labels that cite an event, drawn in the message gutter. */
-  flags?: ReadonlyMap<string, readonly EventFlag[]>;
-  onFlag?: (flag: EventFlag, event: ConversationEvent) => void;
-  /** Show lifecycle events (spawn, pause, settle) between messages. */
-  lifecycle?: boolean;
-  /** The agent can still act: a call without a result is pending, not uncaptured. */
-  live?: boolean;
-  /** Suspend following while the reader browses earlier pages of a live agent. */
-  follow?: boolean;
-  /** The prompt the agent was started with, when its record holds no prompt of its own (a root's run input). */
-  opening?: {
-    text: string;
-    at: string;
-  };
-}
-declare function Conversation({ index, actor, cutoff, query, category, selected, openSource, flags, onFlag, lifecycle, live, follow, opening }: ConversationProps): import("react").JSX.Element;
-/** The conversation needs an opening prompt even when the provider did not retain its first user turn. */
-declare function withPrompts<T extends ConversationRecord>(record: T): T;
-export { AgentStreamRow as $, ToolCallData$1 as A, taskStatus as B, RunStatusIcon$1 as C, TaskListItem as D, TaskList as E, parseToolEvent as F, RecordIndex as G, Conversation as H, runStatus$1 as I, ConversationEvent as J, indexRecord as K, showsTaskPriority as L, ToolCallFeedProps as M, ToolCallStatus as N, TaskListProps as O, ToolCallType as P, LatestEventsProps as Q, statusMeta$1 as R, RunStatus as S, StatusMeta as T, ConversationProps as U, withPrompts as V, EventFlag as W, ConversationRecord as X, ConversationNode as Y, LatestEvents as Z, RunPhaseList as _, ApprovalPlanStep as a, TraceWorkspace as at, RunRowStatus as b, FeedSegment as c, TraceWaterfallProps as ct, InlineToolItem as d, AgentStreamState as et, InlineToolItemProps as f, RunPhase as g, RunGroupProps as h, ApprovalDiffSummary as i, TraceEvent as it, ToolCallFeed as j, TaskStatus as k, InlineThinkingItem$1 as l, traceSpanMark as lt, RunGroup as m, ApprovalCardProps as n, foldAgentRows as nt, ExpandedToolDetail as o, TraceWorkspaceProps as ot, LiveDuration as p, model_d_exports as q, ApprovalDiffFile as r, useAgentStream as rt, ExpandedToolDetailProps as s, TraceWaterfall as st, ApprovalCard as t, AgentTranscriptEntry as tt, InlineThinkingItemProps as u, RunRowShell$1 as v, RunStatusIconProps as w, RunRowStatusDot as x, RunRowShellProps as y, taskProgress as z };