@tangle-network/agent-app 0.10.1 → 0.11.1

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

@@ -1,5 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
+import { S as StepAgentActivity } from '../agent-activity-C8ZG0F0M.js';
+import { FlowTrace } from '../trace/index.js';
 import { C as CatalogModel } from '../model-catalog-BEAEVDaa.js';
 
 /**
@@ -119,6 +121,82 @@ declare function nextRevealCount(shown: number, targetLength: number, dtMs: numb
  */
 declare function useSmoothText(target: string, enabled: boolean, opts?: SmoothRevealOptions): string;
 
+type ActivityTone = 'live' | 'ok' | 'error' | 'neutral';
+/** Map a delegation status (free-form string on the wire) to a render tone. */
+declare function activityTone(status: string): ActivityTone;
+/** "$0.4000" under a cent shows 4 decimals; null when unknown/zero. */
+declare function formatActivityCost(costUsd?: number): string | null;
+/** "8s" / "2m 05s" / "1h 12m"; null when unknown. */
+declare function formatActivityDuration(durationMs?: number): string | null;
+/** A delegation record on the cross-context surface; `missionRef` links a
+ *  promoted delegation back to the mission/step that spawned it. */
+interface AgentActivityRecord extends StepAgentActivity {
+    missionRef?: {
+        missionId: string;
+        stepId?: string;
+        label?: string;
+    };
+}
+interface AgentActivityPage {
+    items: AgentActivityRecord[];
+    /** Opaque continuation token; absent ⇒ no further pages. */
+    nextCursor?: string;
+}
+/**
+ * Fold a fetched page into the held rows: dedupe by `taskId` with the
+ * incoming row winning (a refresh re-fetches the head page, so newer
+ * snapshots of in-flight runs replace stale ones), newest `startedAt` first.
+ */
+declare function mergeActivityPages(existing: AgentActivityRecord[], incoming: AgentActivityRecord[]): AgentActivityRecord[];
+interface WaterfallRow {
+    name: string;
+    kind: 'pipeline' | 'model' | 'tool';
+    /** Bar geometry as percentages of the trace's total span. */
+    offsetPct: number;
+    widthPct: number;
+    durationLabel: string;
+    approx: boolean;
+    /** False only when the span's meta carries an explicit failure. */
+    ok: boolean;
+}
+/** Project a FlowTrace into proportional bar geometry for {@link FlowWaterfall}. */
+declare function waterfallLayout(trace: FlowTrace): WaterfallRow[];
+interface FlowWaterfallProps {
+    trace: FlowTrace;
+}
+/** Compact proportional waterfall over a FlowTrace — span name, bar, duration
+ *  per row; total + cost in the footer. */
+declare function FlowWaterfall({ trace }: FlowWaterfallProps): react.JSX.Element | null;
+interface MissionActivityLaneProps {
+    /** The step's delegated-run snapshot (`MissionStepState.agentActivity`). */
+    activity: StepAgentActivity[];
+    /** Epoch ms origin for the expanded waterfall — usually the step start. */
+    startedAt?: number;
+    /** Wall clock for extending in-flight runs on the waterfall. */
+    nowMs?: number;
+}
+/**
+ * Collapsed sub-rows under a mission step — one row per delegated run —
+ * expanding to the step's waterfall. Renders nothing for an empty lane.
+ */
+declare function MissionActivityLane({ activity, startedAt, nowMs }: MissionActivityLaneProps): react.JSX.Element | null;
+interface AgentActivityPanelProps {
+    /** Data port — page through the product's delegation records. Called with
+     *  no cursor on mount/refresh, with `nextCursor` for older pages. */
+    fetchActivity: (cursor?: string) => Promise<AgentActivityPage>;
+    /** Render the mission link for a promoted delegation (chip, anchor, router
+     *  Link — the product's routing, not ours). */
+    renderMissionRef?: (ref: NonNullable<AgentActivityRecord['missionRef']>, record: AgentActivityRecord) => ReactNode;
+    title?: string;
+    emptyLabel?: string;
+}
+/**
+ * The standalone cross-context delegation surface: every agent run the
+ * product journaled, mission-spawned or not, with status, cost, drill-in, and
+ * a mission link slot for promoted delegations.
+ */
+declare function AgentActivityPanel({ fetchActivity, renderMissionRef, title, emptyLabel }: AgentActivityPanelProps): react.JSX.Element;
+
 interface ChatMessageMetrics {
     modelUsed?: string;
     promptTokens?: number;
@@ -239,4 +317,4 @@ type ToolDetailRenderers = Record<string, (call: ChatToolCallInfo, message: Chat
  */
 declare function ChatMessages({ messages, models, renderMarkdown, renderExtras, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, }: ChatMessagesProps): react.JSX.Element;
 
-export { type ChatMessageMetrics, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ConsumeChatStreamResult, EffortPicker, type EffortPickerProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, RunDrillIn, type RunDrillInProps, type SmoothRevealOptions, type StreamChatOptions, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, consumeChatStream, dispatchChatStreamLine, formatModelCost, formatTokensPerSecond, nextRevealCount, pendingApprovalOf, streamChatTurn, useSmoothText };
+export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, type ChatMessageMetrics, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ConsumeChatStreamResult, EffortPicker, type EffortPickerProps, FlowWaterfall, type FlowWaterfallProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, RunDrillIn, type RunDrillInProps, type SmoothRevealOptions, type StreamChatOptions, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type WaterfallRow, activityTone, consumeChatStream, dispatchChatStreamLine, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, mergeActivityPages, nextRevealCount, pendingApprovalOf, streamChatTurn, useSmoothText, waterfallLayout };