@wrongstack/webui 0.284.0 → 0.285.0

package/dist/stores/viz-store.d.ts

@@ -0,0 +1,126 @@
+/**
+ * VizStore — Real-time cinematic event stream for the AgentFlow visualization.
+ *
+ * Holds a ring buffer of structured events from the entire agent ecosystem:
+ * provider calls, agent spawns, tool executions, mailbox messages, etc.
+ * Every event is typed with a `vizKind` for the renderer to pattern-match on.
+ */
+/** Categories the cinematic renderer understands. */
+export type VizEventKind = 'provider:call' | 'provider:delta' | 'provider:response' | 'agent:spawned' | 'agent:tool' | 'agent:status' | 'agent:ctx' | 'agent:text' | 'tool:started' | 'tool:executed' | 'tool:progress' | 'mailbox:send' | 'mailbox:deliver' | 'collab:event' | 'memory:event' | 'session:start' | 'session:end' | 'iteration:start' | 'iteration:end' | 'eternal:iteration' | 'error' | 'context:compacted' | 'context:repaired' | 'budget:warning' | 'budget:extended' | 'cost:update' | 'fleet:snapshot';
+export interface VizEvent {
+    id: string;
+    kind: VizEventKind;
+    timestamp: number;
+    /** Source node id (e.g. provider id, agent id, tool name) */
+    source: string;
+    /** Target node id (optional — e.g. provider for tool calls) */
+    target?: string | undefined;
+    /** Display label */
+    label: string;
+    /** Numeric magnitude (tokens, cost, duration) for size/color mapping */
+    magnitude?: number | undefined;
+    /** Extra structured payload for the renderer */
+    data?: Record<string, unknown> | undefined;
+    /** The raw WS payload for drill-down in detail panels */
+    raw?: unknown;
+    /** Grouping key for the flow (e.g. 'iteration:3', 'agent:leader') */
+    flowGroup?: string | undefined;
+    /** Color hint for the renderer */
+    color?: string | undefined;
+}
+/** Active connection between two nodes in the flow graph. */
+export interface VizEdge {
+    id: string;
+    source: string;
+    target: string;
+    kind: VizEventKind;
+    label: string;
+    /** Flow intensity 0–1 for animation speed/opacity */
+    intensity: number;
+    /** Color for the edge */
+    color: string;
+    /** When this edge was last active */
+    lastActiveAt: number;
+    /** Cumulative magnitude (tokens, calls, etc.) */
+    totalMagnitude: number;
+}
+/** Node in the flow graph — represents a live entity. */
+export interface VizNode {
+    id: string;
+    kind: 'provider' | 'agent' | 'tool' | 'mailbox' | 'session' | 'system' | 'error' | 'coordinator';
+    label: string;
+    sublabel?: string | undefined;
+    status: 'idle' | 'active' | 'streaming' | 'completed' | 'error';
+    /** 0–1 activity level for glow/pulse */
+    activity: number;
+    /** Color theme */
+    color: string;
+    /** Provider/model info */
+    provider?: string | undefined;
+    model?: string | undefined;
+    /** For agents: stats */
+    iterations?: number | undefined;
+    toolCalls?: number | undefined;
+    costUsd?: number | undefined;
+    ctxPct?: number | undefined;
+    ctxTokens?: number | undefined;
+    maxContext?: number | undefined;
+    /** For agents: current tool name */
+    currentTool?: string | undefined;
+    /** For agents: session id */
+    sessionId?: string | undefined;
+    /** Magnitude for sizing */
+    magnitude?: number | undefined;
+    /** When this node was last updated */
+    lastSeenAt: number;
+    /** Position hints for the layout engine */
+    positionHint?: {
+        zone: 'left' | 'center' | 'right' | 'top' | 'bottom';
+        order: number;
+    } | undefined;
+}
+interface VizState {
+    /** Ring buffer of recent events — newest first. */
+    events: VizEvent[];
+    /** Live nodes in the flow graph. */
+    nodes: Map<string, VizNode>;
+    /** Active edges between nodes. */
+    edges: Map<string, VizEdge>;
+    /** Whether the visualization is actively running. */
+    isActive: boolean;
+    /** Max events to keep in the ring buffer. */
+    maxEvents: number;
+    /** Counters for the HUD */
+    counters: {
+        totalTokens: number;
+        totalCost: number;
+        totalToolCalls: number;
+        activeAgents: number;
+        completedTasks: number;
+        errors: number;
+        mailboxMessages: number;
+    };
+    pushEvent: (event: VizEvent) => void;
+    upsertNode: (node: Partial<VizNode> & {
+        id: string;
+        kind: VizNode['kind'];
+        label: string;
+    }) => void;
+    removeNode: (id: string) => void;
+    upsertEdge: (edge: Partial<VizEdge> & {
+        id: string;
+        source: string;
+        target: string;
+        kind: VizEdge['kind'];
+        label: string;
+    }) => void;
+    removeEdge: (id: string) => void;
+    clear: () => void;
+    setActive: (active: boolean) => void;
+    decayActivity: () => void;
+    prunesStale: (olderThan: number) => void;
+}
+export declare const useVizStore: import("zustand").UseBoundStore<import("zustand").StoreApi<VizState>>;
+export declare function wsToVizEvent(wsType: string, payload: Record<string, unknown>): VizEvent | null;
+export {};
+//# sourceMappingURL=viz-store.d.ts.map

package/dist/stores/viz-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viz-store.d.ts","sourceRoot":"","sources":["../../src/stores/viz-store.ts"],"names":[],"mappings":"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"}

package/dist/stores/worktree-store.d.ts

@@ -0,0 +1,47 @@
+import type { WorktreeDiffSummary, WorktreeHandleView, WorktreeOrphanView } from '../types.js';
+interface WorktreeActivity {
+    handleId: string;
+    kind: string;
+    text: string;
+    at: number;
+}
+interface WorktreeCleanResult {
+    ok: boolean;
+    removed: number;
+    reason?: string;
+    at: number;
+}
+interface WorktreeMergeResult {
+    ok: boolean;
+    branch: string;
+    conflict?: boolean;
+    conflictFiles?: string[];
+    reason?: string;
+    at: number;
+}
+interface WorktreeState {
+    worktrees: WorktreeHandleView[];
+    baseBranch: string;
+    activity: WorktreeActivity[];
+    /** Disk-scanned orphans left by previous/crashed runs. */
+    orphans: WorktreeOrphanView[];
+    /** Whether cleaning is currently allowed (no live run). */
+    canClean: boolean;
+    /** Why cleaning is blocked, when canClean is false. */
+    cleanBlockedReason?: string;
+    /** Outcome of the last cleanup. */
+    cleanResult: WorktreeCleanResult | null;
+    /** Outcome of the last per-worktree merge. */
+    mergeResult: WorktreeMergeResult | null;
+    /** Compact change summary per worktree dir (lazy, from "View changes"). */
+    diffByDir: Record<string, WorktreeDiffSummary | null>;
+    setSnapshot: (worktrees: WorktreeHandleView[], baseBranch: string) => void;
+    pushEvent: (e: WorktreeActivity) => void;
+    setOrphans: (orphans: WorktreeOrphanView[], canClean: boolean, reason?: string) => void;
+    setCleanResult: (r: WorktreeCleanResult | null) => void;
+    setMergeResult: (r: WorktreeMergeResult | null) => void;
+    setDiff: (dir: string, summary: WorktreeDiffSummary | null) => void;
+}
+export declare const useWorktreeStore: import("zustand").UseBoundStore<import("zustand").StoreApi<WorktreeState>>;
+export {};
+//# sourceMappingURL=worktree-store.d.ts.map

package/dist/stores/worktree-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-store.d.ts","sourceRoot":"","sources":["../../src/stores/worktree-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAI/F,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,mBAAmB;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,mBAAmB;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,aAAa;IACrB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mCAAmC;IACnC,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,8CAA8C;IAC9C,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACtD,WAAW,EAAE,CAAC,SAAS,EAAE,kBAAkB,EAAE,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3E,SAAS,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzC,UAAU,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxF,cAAc,EAAE,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;IACxD,cAAc,EAAE,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;IACxD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;CACrE;AAED,eAAO,MAAM,gBAAgB,4EAgB1B,CAAC"}