@wrongstack/webui 0.319.1 → 1.0.1

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

@@ -0,0 +1,124 @@
+/** 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' | 'brain:council_vote' | '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;
+}
+export interface VizState {
+    /** Ring buffer of recent events — newest first. */
+    events: VizEvent[];
+    /**
+     * Tool-only archive for slower UI surfaces such as Agent Office.
+     * Keeping it separate prevents chat/provider traffic from evicting a
+     * read/write action before a person has had time to see it.
+     */
+    toolEvents: 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 NODE_COLORS: Record<string, string>;
+export declare const EDGE_COLORS: Record<string, string>;
+//# sourceMappingURL=viz-types.d.ts.map

package/dist/types/brain.d.ts

@@ -166,6 +166,8 @@ export interface BrainConfigWire {
         distinctness: 'none' | 'model' | 'provider';
         voterMaxTokens?: number | undefined;
         judgeMaxTokens?: number | undefined;
+        /** Voting rounds; undefined = the product default (2). 1 disables it. */
+        deliberationRounds?: number | undefined;
         seats: BrainCouncilSeatWire[];
     };
     /**
@@ -234,6 +236,7 @@ export interface BrainConfigPatchWire {
         distinctness?: 'none' | 'model' | 'provider' | null | undefined;
         voterMaxTokens?: number | null | undefined;
         judgeMaxTokens?: number | null | undefined;
+        deliberationRounds?: number | null | undefined;
         seats?: BrainCouncilSeatWire[] | null | undefined;
     } | null | undefined;
     ledger?: {

package/dist/types/client-message.d.ts

@@ -389,8 +389,16 @@ export type WSClientMessageCore = WSUserMessage | {
     };
 } | {
     type: 'session.new';
+    /**
+     * `replaceSessionId` is the explicit "retire this session as part of
+     * the same operation" target — deliberately a DIFFERENT key from
+     * `sessionId`, which only says which session the request originated
+     * from. Omit it to open an ADDITIONAL session (a new tab) that touches
+     * nothing; send it to close that session and land its replacement.
+     */
     payload?: ({
         systemPromptVariant?: string;
+        replaceSessionId?: string;
     } & SessionScopedPayload) | SessionScopedPayload;
 } | {
     type: 'session.checkpoints';

package/dist/types/runtime.d.ts

@@ -352,6 +352,13 @@ export interface WSContextModeChanged {
 export interface WSToolsList {
     type: 'tools.list';
     payload: {
+        /**
+         * Echoed back from the request when the caller minted one
+         * (`withRequestId` on the server). `consumeSuppressedChatEcho` correlates
+         * on it to drop the chat echo for exactly the request that asked to be
+         * suppressed.
+         */
+        requestId?: string | undefined;
         tools: Array<{
             name: string;
             owner: string;

package/dist/types/sage.d.ts

@@ -55,6 +55,13 @@ export interface SageGraphEdge {
 export interface WSMemorySageList {
     type: 'memory.sage.list';
     payload: {
+        /**
+         * Echoed back from the request when the caller minted one
+         * (`withRequestId` on the server). `consumeSuppressedChatEcho` correlates
+         * on it to drop the chat echo for exactly the request that asked to be
+         * suppressed.
+         */
+        requestId?: string | undefined;
         memories?: SageEntry[] | undefined;
         stats?: SageStats | undefined;
         error?: string | undefined;

package/dist/types/server-message-chimera.d.ts

@@ -0,0 +1,161 @@
+export type WSChimeraServerMessage = {
+    type: 'chimera.report_available';
+    payload: {
+        reportId: string;
+        sessionId: string;
+        message: string;
+        fileCount: number;
+        findingCount: number;
+        hasActionableFindings: boolean;
+        messageId?: string | undefined;
+    };
+} | {
+    type: 'chimera.reports';
+    payload: {
+        sessionId: string;
+        isQuery?: boolean | undefined;
+        reports: Array<{
+            reportId: string;
+            sessionId?: string | undefined;
+            agentId?: string | undefined;
+            reviewedAt: string;
+            reviewerModel?: string | undefined;
+            source?: string | undefined;
+            reviewStatus?: 'success' | 'failed' | undefined;
+            lifecycleStatus: string;
+            counts?: {
+                critical: number;
+                high: number;
+                medium: number;
+                low: number;
+            } | undefined;
+            totalFindings: number;
+            fileCount?: number | undefined;
+            durationSeconds?: number | undefined;
+            cascadeDepth?: number | undefined;
+            evidenceStatus?: string | undefined;
+            hasActionableFindings?: boolean | undefined;
+        }>;
+    };
+} | {
+    type: 'chimera.report.detail';
+    payload: {
+        report: {
+            id: string;
+            reviewedAt: string;
+            sessionId: string;
+            agentId: string;
+            reviewerModel: string;
+            source: string;
+            reviewStatus: 'success' | 'failed';
+            lifecycle: string;
+            files: Array<{
+                path: string;
+                status: string;
+            }>;
+            counts: {
+                critical: number;
+                high: number;
+                medium: number;
+                low: number;
+            };
+            totalFindings: number;
+            unparseableCount: number;
+            durationSeconds?: number | undefined;
+            rawText: string;
+            cascadeDepth?: number | undefined;
+            evidenceStatus?: string | undefined;
+            evidenceChecks?: Array<{
+                name: string;
+                command: string;
+                ok: boolean;
+                claimedExitCode?: number | null;
+                actualExitCode?: number | null;
+            }> | undefined;
+        } | null;
+        findings: Array<{
+            finding: {
+                id: string;
+                fingerprint: string;
+                severity: 'critical' | 'high' | 'medium' | 'low';
+                source: string;
+                location?: {
+                    file: string;
+                    line?: number | undefined;
+                } | undefined;
+                category?: string | undefined;
+                confidence?: string | undefined;
+                verification?: {
+                    status: string;
+                    reason: string;
+                    evidence?: string | undefined;
+                } | undefined;
+                title: string;
+                description: string;
+                suggestedFix?: string | undefined;
+                createdAt: string;
+                status: string;
+                resolution?: {
+                    outcome: string;
+                    resolvedAt: string;
+                    resolvedBy: string;
+                    commitSha?: string | undefined;
+                    notes?: string | undefined;
+                } | undefined;
+                originReport: {
+                    reportId: string;
+                    sessionId: string;
+                    agentId: string;
+                    reviewerModel: string;
+                };
+            };
+            events: Array<{
+                id: string;
+                findingId: string;
+                eventType: string;
+                fromStatus: string | null;
+                toStatus: string;
+                actorId: string;
+                actorKind: string;
+                timestamp: string;
+                reason?: string | undefined;
+            }>;
+        }>;
+        events: Array<{
+            id: string;
+            reportId: string;
+            eventType: string;
+            fromLifecycle: string | null;
+            toLifecycle: string;
+            actorId: string;
+            actorKind: string;
+            timestamp: string;
+            reason?: string | undefined;
+        }>;
+        error?: string | undefined;
+    };
+} | {
+    type: 'chimera.report.updated';
+    payload: {
+        reportId: string;
+        lifecycle?: string | undefined;
+        success: boolean;
+        error?: string | undefined;
+    };
+} | {
+    type: 'chimera.report.note_added';
+    payload: {
+        reportId: string;
+        success: boolean;
+        error?: string | undefined;
+    };
+} | {
+    type: 'chimera.finding.updated';
+    payload: {
+        findingId: string;
+        status?: string | undefined;
+        success: boolean;
+        error?: string | undefined;
+    };
+};
+//# sourceMappingURL=server-message-chimera.d.ts.map

package/dist/types/server-message-files.d.ts

@@ -0,0 +1,195 @@
+import type { SessionScopedPayload } from './protocol-core.js';
+export type WSFilesGitServerMessage = {
+    type: 'codebase.index.server.shutdown_result';
+    payload: {
+        requestId?: string | undefined;
+        stopped: boolean;
+        pid?: number | undefined;
+        reason?: string | undefined;
+    };
+} | {
+    type: 'files.tree';
+    payload: {
+        root: string;
+        tree: unknown[];
+        error?: string | undefined;
+        sessionId?: string | undefined;
+    };
+} | {
+    type: 'files.read';
+    payload: {
+        filePath: string;
+        content: string;
+        /** Server refused content: NUL byte detected (see handleFilesRead). */
+        binary?: boolean | undefined;
+        /** Server refused content: file exceeds the 2 MB display cap. */
+        tooLarge?: boolean | undefined;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+    };
+} | {
+    type: 'files.skeleton_result';
+    payload: {
+        filePath: string;
+        lang?: string | undefined;
+        skeleton: string;
+        stats?: {
+            originalLines: number;
+            skeletonLines: number;
+            tokenSavingsPercent: number;
+            symbolCount: number;
+        } | undefined;
+        error?: string | undefined;
+    };
+} | {
+    type: 'files.written';
+    payload: {
+        filePath: string;
+        success: boolean;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+    };
+} | {
+    type: 'files.created';
+    payload: {
+        filePath: string;
+        success: boolean;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+    };
+} | {
+    type: 'files.deleted';
+    payload: {
+        filePath: string;
+        success: boolean;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+    };
+} | {
+    type: 'files.renamed';
+    payload: {
+        oldPath: string;
+        newPath: string;
+        success: boolean;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+    };
+} | {
+    type: 'files.moved';
+    payload: {
+        srcPath: string;
+        destPath: string;
+        success: boolean;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+    };
+} | {
+    type: 'git.info';
+    payload: {
+        branch: string;
+        added: number;
+        deleted: number;
+        untracked: number;
+        behind: number;
+        ahead: number;
+    };
+} | {
+    type: 'git.action_result';
+    payload: {
+        action: 'stage' | 'unstage' | 'discard' | 'commit';
+        ok: boolean;
+        paths?: string[] | undefined;
+        message?: string | undefined;
+        error?: string | undefined;
+    };
+} | {
+    type: 'git.changes';
+    payload: {
+        files: Array<{
+            path: string;
+            status: string;
+            added: number;
+            deleted: number;
+            staged: boolean;
+        }>;
+        /**
+         * Aggregate status per directory (repo-relative keys): the
+         * highest-ranked child status, computed server-side — replaces the
+         * old client-side prefix-scan heuristic in FileExplorer.
+         */
+        dirs?: Record<string, string> | undefined;
+        /** Repo→project path prefix ('' when equal) — see repoRelativePrefix. */
+        repoPrefix?: string | undefined;
+        error?: string | undefined;
+    };
+} | {
+    type: 'git.diff';
+    payload: {
+        path: string;
+        oldText?: string | undefined;
+        newText?: string | undefined;
+        binary?: boolean | undefined;
+        tooLarge?: boolean | undefined;
+        error?: string | undefined;
+    };
+} | {
+    type: 'projects.list';
+    payload: {
+        projects: Array<{
+            name: string;
+            root: string;
+            slug: string;
+            lastSeen?: string | undefined;
+        }>;
+    };
+} | {
+    type: 'projects.added';
+    payload: {
+        name: string;
+        root: string;
+        slug: string;
+        message: string;
+    };
+} | {
+    type: 'projects.selected';
+    payload: {
+        root: string;
+        name: string;
+        message: string;
+    };
+} | {
+    type: 'working_dir.changed';
+    payload: {
+        cwd: string;
+        projectRoot: string;
+    };
+} | {
+    type: 'file.saved';
+    payload: SessionScopedPayload & {
+        filePath: string;
+    };
+} | {
+    type: 'codemap.file_event';
+    payload: SessionScopedPayload & {
+        filePath: string;
+        operation: 'read' | 'write' | 'edit' | 'delete' | 'rename';
+        phase: 'started' | 'completed' | 'changed';
+        source: 'tool' | 'editor' | 'deterministic' | 'watcher' | 'external';
+        at: number;
+        traceId?: string | undefined;
+        agentId?: string | undefined;
+        agentName?: string | undefined;
+        toolUseId?: string | undefined;
+        toolName?: string | undefined;
+        line?: number | undefined;
+        endLine?: number | undefined;
+    };
+} | {
+    type: 'codemap.index_updated';
+    payload: {
+        at: number;
+        ready: boolean;
+        reason: 'index_complete';
+    };
+};
+//# sourceMappingURL=server-message-files.d.ts.map

package/dist/types/server-message-fleet.d.ts

@@ -0,0 +1,148 @@
+import type { SessionScopedPayload } from './protocol-core.js';
+export type WSFleetServerMessage = {
+    type: 'subagent.event';
+    payload: SessionScopedPayload & Record<string, unknown> & {
+        kind: string;
+    };
+} | {
+    type: 'coordinator.status';
+    payload: {
+        status: 'idle' | 'running' | 'draining' | 'stopped';
+        mode?: string;
+        subagentCount?: number;
+        taskQueue?: {
+            pending: number;
+            running: number;
+            completed: number;
+            failed: number;
+        };
+    };
+} | {
+    type: 'coordinator.stats';
+    payload: SessionScopedPayload & {
+        total: number;
+        running: number;
+        idle: number;
+        stopped: number;
+        inFlight: number;
+        pending: number;
+        completed: number;
+        subagentStatuses?: Array<{
+            id: string;
+            name: string;
+            status: string;
+            currentTask?: string;
+        }>;
+    };
+} | {
+    type: 'fleet.concurrency_update';
+    payload: SessionScopedPayload & {
+        fleetConcurrency: number;
+        fleetConcurrencyMax: number;
+        maxSpawns?: number;
+        usedSpawns?: number;
+        remainingSpawns?: number;
+        maxSpawnsSource?: string;
+        maxConcurrentSource?: string;
+        effectiveSource?: string;
+        checkpointMaxSpawns?: number;
+        ceilingMismatch?: boolean;
+    };
+} | {
+    type: 'budget.threshold_reached';
+    payload: SessionScopedPayload & {
+        subagentId: string;
+        taskId?: string;
+        ts: number;
+        kind: string;
+        used: number;
+        limit: number;
+        timeoutMs: number;
+    };
+} | {
+    type: 'budget.decision';
+    payload: {
+        subagentId: string;
+        kind: string;
+        decision: 'extend' | 'deny';
+        extended?: {
+            timeoutMs?: number;
+            maxIterations?: number;
+            maxToolCalls?: number;
+        };
+    };
+} | {
+    type: 'subagent.budget_extended';
+    payload: {
+        subagentId: string;
+        kind: string;
+        extendedMs?: number;
+        extendedTo?: number;
+    };
+} | {
+    type: 'consensus.vote_initiated';
+    payload: {
+        changeId: string;
+        title: string;
+        eligible: Array<{
+            agentId: string;
+            agentName: string;
+        }>;
+    };
+} | {
+    type: 'consensus.vote_cast';
+    payload: {
+        changeId: string;
+        voterId: string;
+        value: 'approve' | 'reject' | 'abstain';
+    };
+} | {
+    type: 'consensus.vote_resolved';
+    payload: {
+        changeId: string;
+        result: 'approved' | 'rejected' | 'vetoed' | 'quorum_not_met';
+        approveCount: number;
+        rejectCount: number;
+    };
+} | {
+    type: 'task.pending';
+    payload: {
+        taskId: string;
+        description: string;
+        priority?: number;
+    };
+} | {
+    type: 'task.started';
+    payload: {
+        taskId: string;
+        subagentId: string;
+    };
+} | {
+    type: 'task.completed';
+    payload: {
+        taskId: string;
+        subagentId: string;
+        status: string;
+        durationMs: number;
+    };
+} | {
+    type: 'task.failed';
+    payload: {
+        taskId: string;
+        subagentId: string;
+        error: string;
+    };
+} | {
+    type: 'tool.disabled';
+    payload: {
+        name: string;
+        ok: boolean;
+    };
+} | {
+    type: 'tool.enabled';
+    payload: {
+        name: string;
+        ok: boolean;
+    };
+};
+//# sourceMappingURL=server-message-fleet.d.ts.map