@wrongstack/webui 0.286.0 → 0.289.0

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { Usage } from '@wrongstack/core';
-import type { KanbanBoard, KanbanBoardSummary, KanbanTask } from '@wrongstack/kanban';
+import type { KanbanBoard, KanbanBoardPresence, KanbanBoardSummary, KanbanEvent, KanbanTask } from '@wrongstack/kanban';
 export interface WSMessage {
     type: string;
     payload: unknown;
@@ -27,6 +27,8 @@ export interface WSSessionStart {
         replayUsage?: Usage | undefined;
         /** True when no provider+model is configured yet — show the setup screen. */
         needsSetup?: boolean | undefined;
+        /** Feature negotiation prevents a newer WebUI from sending messages to an older backend. */
+        protocolCapabilities?: string[] | undefined;
     };
 }
 export interface WSSessionEnd {
@@ -75,12 +77,22 @@ export interface WSThinkingDelta {
         text: string;
     };
 }
+export interface WSCodeMapFileTarget {
+    filePath: string;
+    operation: 'read' | 'write' | 'edit' | 'delete' | 'search';
+    line?: number | undefined;
+    endLine?: number | undefined;
+}
 export interface WSToolUseStart {
     type: 'tool.started';
     payload: SessionScopedPayload & {
         id: string;
         name: string;
+        traceId?: string | undefined;
+        agentId?: string | undefined;
+        agentName?: string | undefined;
         input?: unknown | undefined;
+        fileTargets?: WSCodeMapFileTarget[] | undefined;
         messageId: string;
     };
 }
@@ -89,10 +101,17 @@ export interface WSToolProgress {
     payload: SessionScopedPayload & {
         name: string;
         id: string;
+        traceId?: string | undefined;
+        agentId?: string | undefined;
+        agentName?: string | undefined;
         event: {
             type: 'log' | 'warning' | 'metric' | 'file_changed' | 'partial_output';
             text?: string | undefined;
             data?: Record<string, unknown>;
+            path?: string | undefined;
+            operation?: 'write' | 'edit' | 'delete' | 'rename' | undefined;
+            line?: number | undefined;
+            endLine?: number | undefined;
         };
     };
 }
@@ -101,10 +120,50 @@ export interface WSToolExecuted {
     payload: SessionScopedPayload & {
         id: string;
         name: string;
+        traceId?: string | undefined;
+        agentId?: string | undefined;
+        agentName?: string | undefined;
         durationMs: number;
         ok: boolean;
         input?: unknown | undefined;
+        fileTargets?: WSCodeMapFileTarget[] | undefined;
         output?: string | undefined;
+        outputBytes?: number | undefined;
+        outputTokens?: number | undefined;
+        outputLines?: number | undefined;
+    };
+}
+/** Subagent tool lifecycle dedicated to CodeMap; intentionally does not create chat bubbles. */
+export interface WSCodeMapToolStarted {
+    type: 'codemap.tool_started';
+    payload: SessionScopedPayload & {
+        parentSessionId?: string | undefined;
+        traceId?: string | undefined;
+        agentId: string;
+        agentName: string;
+        id: string;
+        name: string;
+        input?: unknown | undefined;
+        fileTargets?: WSCodeMapFileTarget[] | undefined;
+        output?: string | undefined;
+        outputBytes?: number | undefined;
+        outputTokens?: number | undefined;
+        outputLines?: number | undefined;
+    };
+}
+export interface WSCodeMapToolExecuted {
+    type: 'codemap.tool_executed';
+    payload: SessionScopedPayload & {
+        parentSessionId?: string | undefined;
+        traceId?: string | undefined;
+        agentId: string;
+        agentName: string;
+        id?: string | undefined;
+        name: string;
+        durationMs: number;
+        ok: boolean;
+        input?: unknown | undefined;
+        fileTargets?: WSCodeMapFileTarget[] | undefined;
     };
 }
 export interface WSIterationStarted {
@@ -191,6 +250,121 @@ export interface WSRunResult {
         };
     };
 }
+export interface ChronicleEventView {
+    schemaVersion: number;
+    eventId: string;
+    eventType: string;
+    occurredAt?: string | undefined;
+    observedAt: string;
+    persistedAt: string;
+    sequence: number;
+    hash: string;
+    previousHash: string;
+    outcome?: string | undefined;
+    durationNs?: string | undefined;
+    scope: Record<string, string | undefined>;
+    correlation: Record<string, string | undefined>;
+    runtime?: {
+        providerId?: string;
+        modelId?: string;
+        processId?: number;
+        parentProcessId?: number;
+    } | undefined;
+    resource?: {
+        kind: string;
+        id: string;
+        path?: string;
+        lineStart?: number;
+        lineEnd?: number;
+    } | undefined;
+    attributes?: Record<string, unknown> | undefined;
+    tags?: Record<string, string> | undefined;
+}
+export interface ChronicleQuery {
+    eventId?: string;
+    eventTypes?: string[];
+    outcomes?: string[];
+    from?: string;
+    to?: string;
+    projectId?: string;
+    sessionId?: string;
+    agentId?: string;
+    taskId?: string;
+    providerId?: string;
+    modelId?: string;
+    traceId?: string;
+    logicalRequestId?: string;
+    attemptId?: string;
+    toolCallId?: string;
+    resourceKind?: string;
+    resourceId?: string;
+    path?: string;
+    line?: number;
+    text?: string;
+    order?: 'asc' | 'desc';
+    limit?: number;
+    cursor?: string;
+    tags?: Record<string, string>;
+    attributes?: Record<string, unknown>;
+}
+export type ChronicleFacet = 'eventType' | 'outcome' | 'projectId' | 'sessionId' | 'agentId' | 'taskId' | 'providerId' | 'modelId' | 'resourceKind' | 'resourcePath' | 'toolCallId';
+export interface ChronicleFacetValue {
+    value: string;
+    count: number;
+}
+export interface ChronicleQueryResult {
+    events: ChronicleEventView[];
+    total: number;
+    nextCursor?: string;
+    scannedEvents: number;
+    sourceFiles: number;
+    invalidLines: number;
+    summary: ChronicleSummary;
+}
+export interface ChronicleSummary {
+    logicalRequests: number;
+    modelAttempts: number;
+    completedAttempts: number;
+    failedAttempts: number;
+    scheduledRetries: number;
+    fallbacks: number;
+    providers: number;
+    models: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    estimatedCostUsd: number;
+    providerAvgDurationMs: number;
+    providerP95DurationMs: number;
+    toolCalls: number;
+    completedTools: number;
+    failedTools: number;
+    toolAvgDurationMs: number;
+    processes: number;
+    failedProcesses: number;
+    fileEvents: number;
+    uniqueFiles: number;
+    agentEvents: number;
+    uniqueAgents: number;
+    decisions: number;
+    escalations: number;
+    failures: number;
+    cancellations: number;
+    families: Record<ChronicleSignalFamily, number>;
+    failuresByFamily: Record<ChronicleSignalFamily, number>;
+}
+export type ChronicleSignalFamily = 'llm' | 'agent' | 'tool' | 'file' | 'memory' | 'task' | 'decision' | 'runtime';
+export interface ChronicleGraphResult {
+    nodes: ChronicleEventView[];
+    edges: Array<{
+        from: string;
+        to: string;
+        kind: string;
+        confidence: 'explicit' | 'correlated' | 'inferred';
+    }>;
+    truncated: boolean;
+}
 export interface WSSessionStats {
     type: 'session.stats';
     payload: {
@@ -418,6 +592,212 @@ export interface WSMemoryList {
         error?: string | undefined;
     };
 }
+export type SuperMemoryScope = 'project' | 'user' | 'session' | 'file' | 'symbol';
+export type SuperMemoryStatus = 'active' | 'stale' | 'superseded' | 'contradicted' | 'archived' | 'deleted';
+export interface SuperMemoryAnchor {
+    type: 'file' | 'directory' | 'symbol' | 'package' | 'command' | 'test' | 'git';
+    path?: string | undefined;
+    symbol?: string | undefined;
+    command?: string | undefined;
+    lineStart?: number | undefined;
+    lineEnd?: number | undefined;
+}
+export interface SuperMemoryEntry {
+    id: string;
+    revision: number;
+    scope: SuperMemoryScope;
+    kind: string;
+    status: SuperMemoryStatus;
+    contextPolicy?: 'eligible' | 'never' | undefined;
+    text: string;
+    summary?: string | undefined;
+    importance: number;
+    confidence: number;
+    freshness: number;
+    tags: string[];
+    anchors: SuperMemoryAnchor[];
+    audience?: {
+        roles?: string[];
+        taskTypes?: string[];
+        modes?: string[];
+    } | undefined;
+    supersedes?: string[] | undefined;
+    supersededBy?: string | undefined;
+    contradicts?: string[] | undefined;
+    createdAt: string;
+    updatedAt: string;
+    lastAccessedAt?: string | undefined;
+    lastVerifiedAt?: string | undefined;
+    expiresAt?: string | undefined;
+}
+export interface SuperMemoryStats {
+    total: number;
+    byStatus: Record<string, number>;
+    byKind: Record<string, number>;
+    edges: number;
+}
+export interface WSMemorySuperList {
+    type: 'memory.super.list';
+    payload: {
+        memories?: SuperMemoryEntry[] | undefined;
+        stats?: SuperMemoryStats | undefined;
+        error?: string | undefined;
+    };
+}
+export interface WSMemorySuperGet {
+    type: 'memory.super.get';
+    payload: {
+        memory?: SuperMemoryEntry | undefined;
+        error?: string | undefined;
+    };
+}
+export interface WSMemorySuperUpdate {
+    type: 'memory.super.update';
+    payload: {
+        memory?: SuperMemoryEntry | undefined;
+        error?: string | undefined;
+    };
+}
+export interface WSMemorySuperRemember {
+    type: 'memory.super.remember';
+    payload: {
+        memory?: SuperMemoryEntry | undefined;
+        error?: string | undefined;
+    };
+}
+export interface WSMemorySuperDelete {
+    type: 'memory.super.delete';
+    payload: {
+        success: boolean;
+        message: string;
+    };
+}
+/**
+ * Why a memory matched the file/drawer query. Mirrors
+ * `MemoryMatchVia` from `@wrongstack/super-memory` (see PR #4 backend).
+ * Kept as a local re-declaration so the webui types module doesn't have to
+ * import from super-memory directly.
+ */
+export type MemoryMatchVia = 'scope_file' | 'scope_symbol' | 'anchor_file' | 'anchor_symbol' | 'anchor_directory' | 'mention';
+export interface MemoryPendingReview {
+    candidateId: string;
+    reason: string;
+    suggestedAction: 'delete' | 'archive' | 'update' | 'investigate';
+    ageDays: number;
+}
+/** Web-side mirror of `MemoryForFileMatch` — superset kept local for layering. */
+export interface MemoryForFileMatch {
+    memory: SuperMemoryEntry;
+    matchedVia: MemoryMatchVia;
+    /** 0..1; higher = stronger match signal. */
+    matchStrength: number;
+    /** Populated for `status='superseded'` records when a head-of-chain exists. */
+    supersededByActiveId?: string | undefined;
+    /** Populated when hygiene has emitted a pending review candidate. */
+    pendingReview?: MemoryPendingReview | undefined;
+}
+export interface MemoryForFileResponse {
+    filePath: string;
+    primaryMatches: MemoryForFileMatch[];
+    symbolMatches: MemoryForFileMatch[];
+    relatedMatches: MemoryForFileMatch[];
+    totalCount: number;
+    activeCount: number;
+    supersededCount: number;
+    reviewPendingCount: number;
+}
+/**
+ * Request payload for `memory.super.forFile`. Cursor fields are optional —
+ * when both are provided, symbol-anchored memories overlapping the cursor
+ * range surface first (cursor-aware boost).
+ */
+export interface WSMemorySuperForFileRequest {
+    /** Project-relative file path. */
+    filePath: string;
+    /** Optional caret line (1-indexed). */
+    lineStart?: number;
+    /** Optional last caret line. Pair with `lineStart`. */
+    lineEnd?: number;
+    /** Per-bucket cap. Default 50. */
+    limit?: number;
+    /** Default true. Include superseded memories (with supersededByActiveId). */
+    showSuperseded?: boolean;
+    /** Default false. Show recoverable deleted memories for one-click recovery. */
+    showDeleted?: boolean;
+}
+export interface WSMemorySuperForFile {
+    type: 'memory.super.forFile';
+    payload: {
+        response?: MemoryForFileResponse | undefined;
+        error?: string | undefined;
+    };
+}
+export interface WSMemorySuperRecover {
+    type: 'memory.super.recover';
+    payload: {
+        /** The restored memory (active status). */
+        memory?: SuperMemoryEntry | undefined;
+        /** True when the requested id was already active/superseded (no-op write). */
+        noop?: boolean | undefined;
+        /** Head-of-chain id when the requested id was superseded. */
+        activeId?: string | undefined;
+        error?: string | undefined;
+    };
+}
+export interface WSMemorySuperCandidateResolve {
+    type: 'memory.super.candidateResolve';
+    payload: {
+        /** The resolved candidate (with updated status). */
+        candidate?: MemoryCandidateEntry | undefined;
+        /** The user-facing action that was applied: accept | reject. */
+        resolvedAction?: 'accept' | 'reject' | undefined;
+        error?: string | undefined;
+    };
+}
+/** Local mirror of super-memory's `MemoryCandidate`. */
+export interface MemoryCandidateEntry {
+    schemaVersion: 1;
+    id: string;
+    status: 'pending' | 'accepted' | 'rejected' | 'merged';
+    text: string;
+    kind: string;
+    confidence: number;
+    importance: number;
+    tags: string[];
+    anchors: SuperMemoryAnchor[];
+    sources: Array<{
+        type: 'user' | 'session' | 'tool_result' | 'project_instruction' | 'file' | 'test' | 'command' | 'legacy_memory';
+        sessionId?: string;
+        toolUseId?: string;
+        path?: string;
+        command?: string;
+        excerptHash?: string;
+    }>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WSMemorySuperBackfillRecoverable {
+    type: 'memory.super.backfillRecoverable';
+    payload: {
+        /** Records that were backfilled into a fresh active version (dryRun=false). */
+        recoveredRecords?: Array<{
+            originalId: string;
+            newActiveId: string;
+            kind: string;
+            scope: string;
+            textPreview: string;
+            deletedAt: string;
+            persistence: string;
+        }> | undefined;
+        /** Total count of records recovered in this run. */
+        recovered?: number | undefined;
+        /** Total count examined. */
+        examined?: number | undefined;
+        /** True when the request was a dry-run (no writes). */
+        dryRun?: boolean | undefined;
+        error?: string | undefined;
+    };
+}
 export interface WSSkillsList {
     type: 'skills.list';
     payload: {
@@ -664,10 +1044,19 @@ export interface WSSessionsList {
         sessions: Array<{
             id: string;
             title: string;
+            name?: string | undefined;
             startedAt: string;
+            endedAt?: string | undefined;
             model: string;
             provider: string;
             tokenTotal: number;
+            iterationCount?: number | undefined;
+            toolCallCount?: number | undefined;
+            toolErrorCount?: number | undefined;
+            fileChangeCount?: number | undefined;
+            toolBreakdown?: Record<string, number> | undefined;
+            compactionCount?: number | undefined;
+            outcome?: 'completed' | 'error' | 'timeout' | 'aborted' | undefined;
             isCurrent: boolean;
         }>;
         error?: string | undefined;
@@ -841,21 +1230,21 @@ export interface WSModesList {
         activeId: string;
     };
 }
-/** AutoPhase live state broadcast (see server/autophase-ws-handler.ts). */
-export interface WSAutoPhaseState {
-    type: 'autophase.state';
+/** Goal live state broadcast (see server/goal-ws-handler.ts). */
+export interface WSGoalState {
+    type: 'goal.state';
     payload: Record<string, unknown>;
 }
-export interface WSAutoPhaseProgress {
-    type: 'autophase.progress';
+export interface WSGoalProgress {
+    type: 'goal.progress';
     payload: Record<string, unknown>;
 }
-export interface WSAutoPhaseLifecycle {
-    type: 'autophase.paused' | 'autophase.resumed' | 'autophase.stopped' | 'autophase.saved' | 'autophase.completed' | 'autophase.failed' | 'autophase.error' | 'autophase.cleared' | 'autophase.reverted';
+export interface WSGoalLifecycle {
+    type: 'goal.paused' | 'goal.resumed' | 'goal.stopped' | 'goal.saved' | 'goal.completed' | 'goal.failed' | 'goal.error' | 'goal.cleared' | 'goal.reverted';
     payload: Record<string, unknown>;
 }
-export interface WSAutoPhaseList {
-    type: 'autophase.list';
+export interface WSGoalList {
+    type: 'goal.list';
     payload: {
         graphs: unknown[];
     };
@@ -876,6 +1265,7 @@ export interface WSAgentTimelineMessage {
         iteration: number;
         ts: string;
         toolName?: string | undefined;
+        toolOk?: boolean | undefined;
         costUsd?: number | undefined;
     };
 }
@@ -894,7 +1284,20 @@ export interface WSKanbanResult {
     type: `kanban.${string}`;
     payload: {
         success: boolean;
-        data?: KanbanBoard | KanbanBoardSummary[] | KanbanTask | KanbanTask[] | Record<string, unknown> | null;
+        data?: KanbanBoard | KanbanBoardSummary[] | KanbanTask | KanbanTask[] | KanbanEvent[] | Record<string, unknown> | null;
+        error?: string | undefined;
+    };
+}
+export interface WSKanbanTaskActivity {
+    type: 'kanban.task.activity';
+    payload: {
+        success: boolean;
+        data?: {
+            boardId: string;
+            taskId: string;
+            events: KanbanEvent[];
+            presence?: KanbanBoardPresence[] | undefined;
+        } | undefined;
         error?: string | undefined;
     };
 }
@@ -1055,79 +1458,82 @@ export interface BrainConfigPatchWire {
         autoDenyAfterFailures?: number | null | undefined;
     } | null | undefined;
 }
-export type WSClientMessage = WSUserMessage | WSToolConfirmResult | {
-    type: 'autophase.start';
+export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
+    type: 'side_effects.list';
+    payload?: Record<string, never>;
+} | {
+    type: 'goal.start';
     payload: {
         title: string;
         phases?: unknown[] | undefined;
         autonomous?: boolean | undefined;
         /** Per-run override of git-worktree isolation. Omitted → env default
-         *  (WRONGSTACK_AUTOPHASE_WORKTREES). false → run on the current branch. */
+         *  (WRONGSTACK_GOAL_WORKTREES). false → run on the current branch. */
         worktrees?: boolean | undefined;
     };
 } | {
-    type: 'autophase.pause';
+    type: 'goal.pause';
     payload: Record<string, never>;
 } | {
-    type: 'autophase.resume';
+    type: 'goal.resume';
     payload: Record<string, never>;
 } | {
-    type: 'autophase.stop';
+    type: 'goal.stop';
     payload: Record<string, never>;
 } | {
-    type: 'autophase.clear';
+    type: 'goal.clear';
     payload?: Record<string, never>;
 } | {
-    type: 'autophase.revert';
+    type: 'goal.revert';
     payload?: Record<string, never>;
 } | {
-    type: 'autophase.status';
+    type: 'goal.status';
     payload?: Record<string, never>;
 } | {
-    type: 'autophase.state';
+    type: 'goal.state';
     payload?: Record<string, never>;
 } | {
-    type: 'autophase.save';
+    type: 'goal.save';
     payload?: Record<string, never>;
 } | {
-    type: 'autophase.list';
+    type: 'goal.list';
     payload?: Record<string, never>;
 } | {
-    type: 'autophase.load';
+    type: 'goal.load';
     payload: {
         graphId: string;
     };
 } | {
-    type: 'autophase.toggleAutonomous';
+    type: 'goal.toggleAutonomous';
     payload: {
         autonomous?: boolean | undefined;
     };
 } | {
-    type: 'autophase.selectPhase';
+    type: 'goal.selectPhase';
     payload: {
         phaseId: string;
     };
 } | {
-    type: 'autophase.taskStatus';
+    type: 'goal.taskStatus';
     payload: {
         taskId: string;
         status: string;
     };
 } | {
-    type: 'autophase.moveTask';
+    type: 'goal.moveTask';
     payload: {
         taskId: string;
         toPhaseId: string;
     };
 } | {
-    type: 'autophase.assignTask';
+    type: 'goal.assignTask';
     payload: {
         taskId: string;
         agentId?: string | undefined;
         agentName?: string | undefined;
     };
 } | {
-    type: 'autophase.addTask';
+    type: 'goal.addTask';
     payload: {
         phaseId: string;
         title: string;
@@ -1136,12 +1542,12 @@ export type WSClientMessage = WSUserMessage | WSToolConfirmResult | {
         priority?: string | undefined;
     };
 } | {
-    type: 'autophase.retryTask';
+    type: 'goal.retryTask';
     payload: {
         taskId: string;
     };
 } | {
-    type: 'autophase.runTask';
+    type: 'goal.runTask';
     payload: {
         taskId: string;
     };
@@ -1478,16 +1884,82 @@ export type WSClientMessage = WSUserMessage | WSToolConfirmResult | {
 } | {
     type: 'memory.list';
 } | {
-    type: 'memory.remember';
+    type: 'memory.super.list';
+} | {
+    type: 'memory.super.get';
     payload: {
-        text: string;
-        scope?: MemoryScope | undefined;
+        id: string;
+    };
+} | {
+    type: 'memory.super.update';
+    payload: {
+        id: string;
+        text?: string | undefined;
+        tags?: string[] | undefined;
+        kind?: string | undefined;
+        status?: SuperMemoryStatus | undefined;
+        importance?: number | undefined;
+        confidence?: number | undefined;
+        freshness?: number | undefined;
+        anchors?: SuperMemoryAnchor[] | undefined;
+        audience?: {
+            roles?: string[];
+            taskTypes?: string[];
+            modes?: string[];
+        } | undefined;
+        supersedes?: string[] | undefined;
+        contradicts?: string[] | undefined;
     };
 } | {
-    type: 'memory.forget';
+    type: 'memory.super.delete';
+    payload: {
+        id: string;
+        reason?: string | undefined;
+        neverInject?: boolean | undefined;
+    };
+} | {
+    type: 'memory.super.recover';
+    payload: {
+        id: string;
+        reason?: string | undefined;
+    };
+} | {
+    type: 'memory.super.candidateResolve';
+    payload: {
+        candidateId: string;
+        action: 'accept' | 'reject';
+        reason?: string | undefined;
+    };
+} | {
+    type: 'memory.super.backfillRecoverable';
+    payload: {
+        apply: boolean;
+        kinds?: string[] | undefined;
+        scopes?: string[] | undefined;
+        updatedAfter?: string | undefined;
+        updatedBefore?: string | undefined;
+    };
+} | {
+    type: 'memory.super.forFile';
+    payload: WSMemorySuperForFileRequest;
+} | {
+    type: 'memory.super.remember';
     payload: {
         text: string;
-        scope?: MemoryScope | undefined;
+        kind?: string | undefined;
+        scope?: SuperMemoryScope | undefined;
+        tags?: string[] | undefined;
+        importance?: number | undefined;
+        confidence?: number | undefined;
+        freshness?: number | undefined;
+        anchors?: SuperMemoryAnchor[] | undefined;
+        audience?: {
+            roles?: string[];
+            taskTypes?: string[];
+            modes?: string[];
+        } | undefined;
+        supersedes?: string[] | undefined;
+        contradicts?: string[] | undefined;
     };
 } | {
     type: 'skills.list';
@@ -1545,6 +2017,25 @@ export type WSClientMessage = WSUserMessage | WSToolConfirmResult | {
 } | {
     type: 'stats.get';
     payload?: SessionScopedPayload;
+} | {
+    type: 'chronicle.query';
+    payload: {
+        query?: ChronicleQuery | undefined;
+    };
+} | {
+    type: 'chronicle.facet';
+    payload: {
+        field: ChronicleFacet;
+        query?: ChronicleQuery | undefined;
+        limit?: number | undefined;
+    };
+} | {
+    type: 'chronicle.graph';
+    payload: {
+        seed: ChronicleQuery;
+        hops?: number;
+        maxNodes?: number;
+    };
 } | {
     type: 'session.save';
     payload?: SessionScopedPayload;
@@ -1653,6 +2144,8 @@ export type WSClientMessage = WSUserMessage | WSToolConfirmResult | {
     };
 } | {
     type: 'goal.get';
+} | {
+    type: 'goal-state.get';
 } | {
     type: 'autonomy.switch';
     payload: {
@@ -1738,6 +2231,15 @@ export type WSClientMessage = WSUserMessage | WSToolConfirmResult | {
     type: 'model.refine';
     payload: {
         text: string;
+        /** Retry window override (ms). Set on the auto-retry after a timeout. */
+        timeoutMs?: number | undefined;
+        /** Refine on this provider/model instead of the session's — ephemeral, no session switch. */
+        provider?: string | undefined;
+        model?: string | undefined;
+        /** Previous refinement when the user asks the preview to try again better. */
+        previousRefined?: string | undefined;
+        previousEnglish?: string | undefined;
+        retryFeedback?: string | undefined;
     };
 } | {
     type: 'skills.list';
@@ -1939,7 +2441,29 @@ export type WSClientMessage = WSUserMessage | WSToolConfirmResult | {
 } | {
     type: 'webui.shutdown';
 };
-export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSThinkingDelta | WSToolUseStart | WSToolProgress | WSToolExecuted | WSIterationStarted | WSIterationCompleted | WSIterationLimitReached | WSProviderResponse | WSProviderRetry | WSProviderError | WSProviderFallback | WSProviderStreamError | WSRunResult | WSSessionStats | WSError | WSToolConfirmNeeded | WSTrustPersisted | WSToolLoopDetected | WSDelegateStarted | WSDelegateCompleted | WSContextDebug | WSContextCompacted | WSCompactionFailed | WSContextRepaired | WSContextPct | WSContextMaxContext | WSTokenThreshold | WSTokenCostEstimateUnavailable | WSContextModesList | WSContextModeChanged | WSToolsList | WSMemoryList | WSSkillsList | WSSkillContent | WSDesignList | WSDesignUse | WSDesignState | WSDesignSet | WSDesignMaterialize | WSDesignVerify | WSSkillsInstalled | WSSkillsUninstalled | WSSkillsUpdated | WSSkillsCreated | WSSkillsEdited | WSSkillsExported | WSDiagGet | WSStatsGet | WSSessionsList | WSProviderCatalog | WSProviderModels | WSSavedProviders | WSProviderProbe | WSKeyOperationResult | WSAuthOAuthStatus | WSFilesList | {
+export type WSClientMessage = WSClientMessageCore;
+export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSThinkingDelta | WSToolUseStart | WSToolProgress | WSToolExecuted | WSCodeMapToolStarted | WSCodeMapToolExecuted | WSIterationStarted | WSIterationCompleted | WSIterationLimitReached | WSProviderResponse | WSProviderRetry | WSProviderError | WSProviderFallback | WSProviderStreamError | WSRunResult | WSSessionStats | WSError | WSToolConfirmNeeded | WSTrustPersisted | WSToolLoopDetected | WSDelegateStarted | WSDelegateCompleted | WSContextDebug | WSContextCompacted | WSCompactionFailed | WSContextRepaired | WSContextPct | WSContextMaxContext | WSTokenThreshold | WSTokenCostEstimateUnavailable | WSContextModesList | WSContextModeChanged | WSToolsList | WSMemoryList | WSMemorySuperList | WSMemorySuperGet | WSMemorySuperUpdate | WSMemorySuperRemember | WSMemorySuperDelete | WSMemorySuperRecover | WSMemorySuperCandidateResolve | WSMemorySuperBackfillRecoverable | WSMemorySuperForFile | WSSkillsList | WSSkillContent | WSDesignList | WSDesignUse | WSDesignState | WSDesignSet | WSDesignMaterialize | WSDesignVerify | WSSkillsInstalled | WSSkillsUninstalled | WSSkillsUpdated | WSSkillsCreated | WSSkillsEdited | WSSkillsExported | WSDiagGet | WSStatsGet | {
+    type: 'chronicle.query_result';
+    payload: ChronicleQueryResult;
+} | {
+    type: 'chronicle.facet_result';
+    payload: {
+        field: ChronicleFacet;
+        values: ChronicleFacetValue[];
+        diagnostics: {
+            sourceFiles: number;
+            invalidLines: number;
+        };
+    };
+} | {
+    type: 'chronicle.graph_result';
+    payload: ChronicleGraphResult;
+} | {
+    type: 'chronicle.error';
+    payload: {
+        message: string;
+    };
+} | WSSessionsList | WSProviderCatalog | WSProviderModels | WSSavedProviders | WSProviderProbe | WSKeyOperationResult | WSAuthOAuthStatus | WSFilesList | {
     type: 'files.tree';
     payload: {
         root: string;
@@ -1972,7 +2496,7 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
         plan: unknown | null;
         error?: string | undefined;
     };
-} | WSModesList | WSAutoPhaseState | WSAutoPhaseProgress | WSAutoPhaseLifecycle | WSAutoPhaseList | {
+} | WSModesList | WSGoalState | WSGoalProgress | WSGoalLifecycle | WSGoalList | {
     type: 'specs.list';
     payload: {
         specs: unknown[];
@@ -2016,7 +2540,7 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
     payload: {
         runId: string;
     };
-} | WSEternalIteration | WSAgentTimelineMessage | WSAgentStatusChanged | WSKanbanResult | {
+} | WSEternalIteration | WSAgentTimelineMessage | WSAgentStatusChanged | WSKanbanResult | WSKanbanTaskActivity | {
     type: 'subagent.event';
     payload: SessionScopedPayload & Record<string, unknown> & {
         kind: string;
@@ -2034,11 +2558,62 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
         }>;
     };
 } | {
-    type: 'goal.updated';
+    type: 'goal-state.updated';
     payload: Record<string, unknown> | null;
 } | {
     type: 'prefs.updated';
     payload: Record<string, unknown>;
+} | {
+    type: 'techstack.job.started';
+    payload: {
+        jobId: string;
+        kind: 'inventory' | 'analyze';
+    };
+} | {
+    type: 'techstack.job.progress';
+    payload: {
+        jobId: string;
+        phase: string;
+        completed: number;
+        total: number;
+    };
+} | {
+    type: 'techstack.workspace.completed';
+    payload: {
+        jobId: string;
+        workspaceId: string;
+        ecosystem: string;
+        dependencyCount: number;
+    };
+} | {
+    type: 'techstack.snapshot.updated';
+    payload: {
+        snapshot: import('@/stores/techstack-store').TechStackSnapshot;
+        stale?: boolean | undefined;
+    };
+} | {
+    type: 'techstack.report.ready';
+    payload: {
+        reportId: string;
+        summary?: string | undefined;
+    };
+} | {
+    type: 'techstack.report.delivered';
+    payload: {
+        deliveryId: string;
+        sessionId: string;
+    };
+} | {
+    type: 'techstack.job.failed';
+    payload: {
+        jobId: string;
+        error: string;
+    };
+} | {
+    type: 'techstack.job.cancelled';
+    payload: {
+        jobId: string;
+    };
 } | {
     type: 'client.status_update';
     payload: Record<string, unknown>;
@@ -2194,6 +2769,27 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
     payload: SessionScopedPayload & Record<string, unknown> & {
         event: 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: 'session.damaged';
     payload: {
@@ -2233,6 +2829,17 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
         refined: string;
         english: string;
         error?: string | undefined;
+        /** Machine-readable failure class driving client recovery (undefined on success). */
+        errorKind?: 'timeout' | 'empty' | 'provider_error' | undefined;
+        /** Suggested window (ms) for a retry after a timeout. */
+        retryTimeoutMs?: number | undefined;
+        /** One-key "retry with another model" offer (provider/model), if any. */
+        fallbackRef?: string | undefined;
+        /** The provider/model that produced this result (echoes an ephemeral retry). */
+        refinedWith?: {
+            provider: string;
+            model: string;
+        } | undefined;
     };
 } | {
     type: 'coordinator.status';
@@ -2544,6 +3151,30 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
     payload: Record<string, unknown> & {
         error?: string | undefined;
     };
+} | {
+    type: 'cron.snapshot';
+    payload: {
+        count: number;
+        maxConcurrent: number;
+        jobs: Array<{
+            name: string;
+            intervalMs: number;
+            action: string;
+            enabled: boolean;
+            lastRun: string | null;
+            nextRun: string;
+            runCount: number;
+            overdue: boolean;
+        }>;
+    };
+} | {
+    type: 'cron.job_fired';
+    payload: {
+        name: string;
+        action: string;
+        runCount: number;
+        ts: string;
+    };
 } | {
     type: 'terminal.output';
     payload: {