@wrongstack/webui 0.293.0 → 0.295.1

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { Usage } from '@wrongstack/core';
+import type { SessionMarker, Usage } from '@wrongstack/core/types';
 import type { KanbanBoard, KanbanBoardPresence, KanbanBoardSummary, KanbanEvent, KanbanTask } from '@wrongstack/kanban';
 export interface WSMessage {
     type: string;
@@ -24,6 +24,10 @@ export interface WSSessionStart {
             content: unknown;
             ts?: string | undefined;
         }>;
+        /** Audit markers (compaction, mode/skill switches, subagent lifecycle,
+         *  provider retries, truncation) projected server-side. Replayed alongside
+         *  the conversation so a reconnect shows what the live stream showed. */
+        replayMarkers?: SessionMarker[] | undefined;
         replayUsage?: Usage | undefined;
         /** True when no provider+model is configured yet — show the setup screen. */
         needsSetup?: boolean | undefined;
@@ -389,6 +393,90 @@ export interface ChronicleGraphResult {
     }>;
     truncated: boolean;
 }
+/** Derived aggregates served from the server-side Chronicle metrics store
+ *  (metrics.db) — no raw journal scan on the request path. */
+export type ChronicleMetricsView = 'summary' | 'providers' | 'tasks' | 'files';
+export interface ChronicleMetricsRefresh {
+    ingestedEvents: number;
+    ingestedBytes: number;
+    sourceFiles: number;
+    invalidLines: number;
+}
+export interface ChronicleProviderDailyRow {
+    day: string;
+    providerId: string;
+    modelId: string;
+    attempts: number;
+    completed: number;
+    failed: number;
+    retries: number;
+    fallbacks: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    avgDurationMs: number;
+    maxDurationMs: number;
+}
+export interface ChronicleTaskOutcomeRow {
+    taskId: string;
+    runId: string;
+    boardId: string;
+    sessionId: string;
+    agentId: string;
+    status: string;
+    startedAt: string | null;
+    endedAt: string | null;
+    durationMs: number | null;
+    retries: number;
+    verificationFailures: number;
+    filesTouched: number;
+}
+export interface ChronicleFileLineageRow {
+    path: string;
+    operation: string;
+    occurredAt: string;
+    sessionId: string;
+    agentId: string;
+    taskId: string;
+    boardId: string;
+    runId: string;
+    toolName: string;
+    providerId: string;
+    modelId: string;
+    source: string;
+}
+export interface ChronicleMetricsSummaryView {
+    providers: {
+        attempts: number;
+        completed: number;
+        failed: number;
+        successRate: number;
+    };
+    tasks: Record<string, number>;
+    files: {
+        mutations: number;
+        uniquePaths: number;
+    };
+    estimatedCostUsd: number;
+}
+export type ChronicleMetricsResultPayload = {
+    view: 'summary';
+    refreshed: ChronicleMetricsRefresh;
+    data: ChronicleMetricsSummaryView;
+} | {
+    view: 'providers';
+    refreshed: ChronicleMetricsRefresh;
+    data: ChronicleProviderDailyRow[];
+} | {
+    view: 'tasks';
+    refreshed: ChronicleMetricsRefresh;
+    data: ChronicleTaskOutcomeRow[];
+} | {
+    view: 'files';
+    refreshed: ChronicleMetricsRefresh;
+    data: ChronicleFileLineageRow[];
+};
 export interface WSSessionStats {
     type: 'session.stats';
     payload: {
@@ -441,6 +529,8 @@ export interface WSToolLoopDetected {
         repeatCount: number;
         iteration: number;
         kind?: 'tool' | 'message' | 'mixed' | undefined;
+        action?: 'steer' | 'cut' | undefined;
+        scope?: 'iteration' | 'call' | undefined;
     };
 }
 export interface WSDelegateStarted {
@@ -617,22 +707,23 @@ 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';
+export type SageScope = 'project' | 'user' | 'session' | 'file' | 'symbol';
+export type SageStatus = 'active' | 'stale' | 'superseded' | 'contradicted' | 'archived' | 'deleted';
+export interface SageAnchor {
+    type: 'file' | 'directory' | 'symbol' | 'package' | 'command' | 'test' | 'git' | 'agent';
     path?: string | undefined;
     symbol?: string | undefined;
     command?: string | undefined;
+    role?: string | undefined;
     lineStart?: number | undefined;
     lineEnd?: number | undefined;
 }
-export interface SuperMemoryEntry {
+export interface SageEntry {
     id: string;
     revision: number;
-    scope: SuperMemoryScope;
+    scope: SageScope;
     kind: string;
-    status: SuperMemoryStatus;
+    status: SageStatus;
     contextPolicy?: 'eligible' | 'never' | undefined;
     text: string;
     summary?: string | undefined;
@@ -640,7 +731,7 @@ export interface SuperMemoryEntry {
     confidence: number;
     freshness: number;
     tags: string[];
-    anchors: SuperMemoryAnchor[];
+    anchors: SageAnchor[];
     audience?: {
         roles?: string[];
         taskTypes?: string[];
@@ -655,13 +746,13 @@ export interface SuperMemoryEntry {
     lastVerifiedAt?: string | undefined;
     expiresAt?: string | undefined;
 }
-export interface SuperMemoryStats {
+export interface SageStats {
     total: number;
     byStatus: Record<string, number>;
     byKind: Record<string, number>;
     edges: number;
 }
-export interface SuperMemoryGraphEdge {
+export interface SageGraphEdge {
     id: string;
     from: string;
     to: string;
@@ -670,57 +761,57 @@ export interface SuperMemoryGraphEdge {
     evidence?: string[] | undefined;
     createdAt: string;
 }
-export interface WSMemorySuperList {
-    type: 'memory.super.list';
+export interface WSMemorySageList {
+    type: 'memory.sage.list';
     payload: {
-        memories?: SuperMemoryEntry[] | undefined;
-        stats?: SuperMemoryStats | undefined;
+        memories?: SageEntry[] | undefined;
+        stats?: SageStats | undefined;
         error?: string | undefined;
     };
 }
-export interface WSMemorySuperListPage {
-    type: 'memory.super.listPage';
+export interface WSMemorySageListPage {
+    type: 'memory.sage.listPage';
     payload: {
-        memories?: SuperMemoryEntry[] | undefined;
+        memories?: SageEntry[] | undefined;
         nextCursor?: string | null | undefined;
         total?: number | undefined;
         statusCounts?: Record<string, number> | undefined;
-        stats?: SuperMemoryStats | undefined;
+        stats?: SageStats | undefined;
         error?: string | undefined;
     };
 }
-export interface WSMemorySuperGet {
-    type: 'memory.super.get';
+export interface WSMemorySageGet {
+    type: 'memory.sage.get';
     payload: {
-        memory?: SuperMemoryEntry | undefined;
+        memory?: SageEntry | undefined;
         error?: string | undefined;
     };
 }
-export interface WSMemorySuperGraph {
-    type: 'memory.super.graph';
+export interface WSMemorySageGraph {
+    type: 'memory.sage.graph';
     payload: {
         query: string;
-        edges?: SuperMemoryGraphEdge[] | undefined;
-        memories?: SuperMemoryEntry[] | undefined;
+        edges?: SageGraphEdge[] | undefined;
+        memories?: SageEntry[] | undefined;
         error?: string | undefined;
     };
 }
-export interface WSMemorySuperUpdate {
-    type: 'memory.super.update';
+export interface WSMemorySageUpdate {
+    type: 'memory.sage.update';
     payload: {
-        memory?: SuperMemoryEntry | undefined;
+        memory?: SageEntry | undefined;
         error?: string | undefined;
     };
 }
-export interface WSMemorySuperRemember {
-    type: 'memory.super.remember';
+export interface WSMemorySageRemember {
+    type: 'memory.sage.remember';
     payload: {
-        memory?: SuperMemoryEntry | undefined;
+        memory?: SageEntry | undefined;
         error?: string | undefined;
     };
 }
-export interface WSMemorySuperDelete {
-    type: 'memory.super.delete';
+export interface WSMemorySageDelete {
+    type: 'memory.sage.delete';
     payload: {
         success: boolean;
         message: string;
@@ -728,9 +819,9 @@ export interface WSMemorySuperDelete {
 }
 /**
  * Why a memory matched the file/drawer query. Mirrors
- * `MemoryMatchVia` from `@wrongstack/super-memory` (see PR #4 backend).
+ * `MemoryMatchVia` from `@wrongstack/sage` (see PR #4 backend).
  * Kept as a local re-declaration so the webui types module doesn't have to
- * import from super-memory directly.
+ * import from sage directly.
  */
 export type MemoryMatchVia = 'scope_file' | 'scope_symbol' | 'anchor_file' | 'anchor_symbol' | 'anchor_directory' | 'mention';
 export interface MemoryPendingReview {
@@ -741,7 +832,7 @@ export interface MemoryPendingReview {
 }
 /** Web-side mirror of `MemoryForFileMatch` — superset kept local for layering. */
 export interface MemoryForFileMatch {
-    memory: SuperMemoryEntry;
+    memory: SageEntry;
     matchedVia: MemoryMatchVia;
     /** 0..1; higher = stronger match signal. */
     matchStrength: number;
@@ -761,11 +852,11 @@ export interface MemoryForFileResponse {
     reviewPendingCount: number;
 }
 /**
- * Request payload for `memory.super.forFile`. Cursor fields are optional —
+ * Request payload for `memory.sage.forFile`. Cursor fields are optional —
  * when both are provided, symbol-anchored memories overlapping the cursor
  * range surface first (cursor-aware boost).
  */
-export interface WSMemorySuperForFileRequest {
+export interface WSMemorySageForFileRequest {
     /** Project-relative file path. */
     filePath: string;
     /** Optional caret line (1-indexed). */
@@ -779,18 +870,18 @@ export interface WSMemorySuperForFileRequest {
     /** Default false. Show recoverable deleted memories for one-click recovery. */
     showDeleted?: boolean;
 }
-export interface WSMemorySuperForFile {
-    type: 'memory.super.forFile';
+export interface WSMemorySageForFile {
+    type: 'memory.sage.forFile';
     payload: {
         response?: MemoryForFileResponse | undefined;
         error?: string | undefined;
     };
 }
-export interface WSMemorySuperRecover {
-    type: 'memory.super.recover';
+export interface WSMemorySageRecover {
+    type: 'memory.sage.recover';
     payload: {
         /** The restored memory (active status). */
-        memory?: SuperMemoryEntry | undefined;
+        memory?: SageEntry | 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. */
@@ -798,8 +889,8 @@ export interface WSMemorySuperRecover {
         error?: string | undefined;
     };
 }
-export interface WSMemorySuperCandidateResolve {
-    type: 'memory.super.candidateResolve';
+export interface WSMemorySageCandidateResolve {
+    type: 'memory.sage.candidateResolve';
     payload: {
         /** The resolved candidate (with updated status). */
         candidate?: MemoryCandidateEntry | undefined;
@@ -808,7 +899,7 @@ export interface WSMemorySuperCandidateResolve {
         error?: string | undefined;
     };
 }
-/** Local mirror of super-memory's `MemoryCandidate`. */
+/** Local mirror of sage's `MemoryCandidate`. */
 export interface MemoryCandidateEntry {
     schemaVersion: 1;
     id: string;
@@ -818,7 +909,7 @@ export interface MemoryCandidateEntry {
     confidence: number;
     importance: number;
     tags: string[];
-    anchors: SuperMemoryAnchor[];
+    anchors: SageAnchor[];
     sources: Array<{
         type: 'user' | 'session' | 'tool_result' | 'project_instruction' | 'file' | 'test' | 'command' | 'legacy_memory';
         sessionId?: string;
@@ -830,8 +921,8 @@ export interface MemoryCandidateEntry {
     createdAt: string;
     updatedAt: string;
 }
-export interface WSMemorySuperBackfillRecoverable {
-    type: 'memory.super.backfillRecoverable';
+export interface WSMemorySageBackfillRecoverable {
+    type: 'memory.sage.backfillRecoverable';
     payload: {
         /** Records that were backfilled into a fresh active version (dryRun=false). */
         recoveredRecords?: Array<{
@@ -934,6 +1025,31 @@ export interface WSDesignSet {
         error?: string | undefined;
     };
 }
+export interface WSDesignTune {
+    type: 'design.tune';
+    payload: {
+        ok: boolean;
+        /** The concrete token overrides the knobs resolved to. */
+        resolved?: Record<string, string> | undefined;
+        overrides?: Record<string, string> | undefined;
+        error?: string | undefined;
+    };
+}
+export interface WSDesignSwap {
+    type: 'design.swap';
+    payload: {
+        ok: boolean;
+        kit?: string | undefined;
+        name?: string | undefined;
+        aesthetic?: string | undefined;
+        stack?: string | undefined;
+        body?: string | undefined;
+        overrides?: Record<string, string> | undefined;
+        light?: Record<string, string> | undefined;
+        dark?: Record<string, string> | undefined;
+        error?: string | undefined;
+    };
+}
 export interface WSDesignMaterialize {
     type: 'design.materialize';
     payload: {
@@ -1464,6 +1580,134 @@ export interface BrainCouncilVoterWire extends BrainModelEntryWire {
     weight?: number | undefined;
     veto?: boolean | undefined;
 }
+/** Predicate half of a deterministic Brain rule on the wire (mirrors BrainRuleMatch). */
+export interface BrainRuleMatchWire {
+    source?: string | string[] | undefined;
+    risk?: string | string[] | undefined;
+    minRisk?: string | undefined;
+    maxRisk?: string | undefined;
+    fallback?: string | string[] | undefined;
+    hasOptions?: boolean | undefined;
+    offersOption?: string | undefined;
+    question?: string | undefined;
+    context?: string | undefined;
+    notQuestion?: string | undefined;
+    notContext?: string | undefined;
+}
+/** Action half of a deterministic Brain rule on the wire (mirrors BrainRuleAction). */
+export type BrainRuleActionWire = {
+    action: 'answer';
+    optionId?: string | undefined;
+    text?: string | undefined;
+    rationale?: string | undefined;
+} | {
+    action: 'deny';
+    reason?: string | undefined;
+} | {
+    action: 'escalate';
+    prompt?: string | undefined;
+} | {
+    action: 'defer';
+};
+/** One deterministic Brain rule on the wire (mirrors core's BrainRule). */
+export interface BrainRuleWire {
+    id: string;
+    enabled?: boolean | undefined;
+    description?: string | undefined;
+    when: BrainRuleMatchWire;
+    then: BrainRuleActionWire;
+}
+/** Built-in pattern-heuristic toggles on the wire (mirrors BrainHeuristicsConfig). */
+export interface BrainHeuristicsWire {
+    lowRiskAutoAnswer: boolean;
+    blockedResolved: boolean;
+    deadlockSkip: boolean;
+    retryExhausted: boolean;
+    continuePing: boolean;
+    blockedResolvedMarkers?: string[] | undefined;
+}
+/** Writable form of the heuristic toggles (every field optional, `null` clears the block). */
+export interface BrainHeuristicsPatchWire {
+    lowRiskAutoAnswer?: boolean | undefined;
+    blockedResolved?: boolean | undefined;
+    deadlockSkip?: boolean | undefined;
+    retryExhausted?: boolean | undefined;
+    continuePing?: boolean | undefined;
+    blockedResolvedMarkers?: string[] | undefined;
+}
+/** Effective single-LLM tier quality gate. */
+export interface BrainLlmWire {
+    maxTokens: number;
+    rejectUncertain: boolean;
+    minConfidence: number;
+    denyIsTerminal: 'never' | 'when-decided' | 'always';
+}
+/** Writable single-LLM tier quality gate. */
+export interface BrainLlmPatchWire {
+    maxTokens?: number | undefined;
+    rejectUncertain?: boolean | undefined;
+    minConfidence?: number | undefined;
+    denyIsTerminal?: 'never' | 'when-decided' | 'always' | undefined;
+    circuitBreaker?: {
+        failureThreshold?: number | undefined;
+        cooldownMs?: number | undefined;
+    } | undefined;
+}
+/** Effective replay-trace settings. */
+export interface BrainTraceWire {
+    enabled: boolean;
+    content: 'none' | 'redacted' | 'full';
+    path?: string | undefined;
+}
+/** Writable replay-trace settings. */
+export interface BrainTracePatchWire {
+    enabled?: boolean | undefined;
+    content?: 'none' | 'redacted' | 'full' | undefined;
+    path?: string | undefined;
+    maxOpenRecords?: number | undefined;
+}
+/** BrainMonitor distress-signal settings (same shape read + written). */
+export interface BrainMonitorWire {
+    enabled?: boolean | undefined;
+    policy?: 'llm' | 'steer' | 'observe' | undefined;
+    signals?: {
+        toolFailureStreak?: boolean | undefined;
+        errorStorm?: boolean | undefined;
+        agentStall?: boolean | undefined;
+        fileChurn?: boolean | undefined;
+    } | undefined;
+    toolFailureStreak?: number | undefined;
+    errorStormCount?: number | undefined;
+    errorStormWindowMs?: number | undefined;
+    stallMs?: number | undefined;
+    stallCheckIntervalMs?: number | undefined;
+    fileChurnThreshold?: number | undefined;
+    fileChurnWindowMs?: number | undefined;
+    fileEditTools?: string[] | undefined;
+    cooldownMs?: number | undefined;
+}
+/** Effective decision-cache settings plus live counters (`hits`/`misses`/`size` are read-only). */
+export interface BrainCacheWire {
+    enabled: boolean;
+    ttlMs: number;
+    maxEntries: number;
+    hits: number;
+    misses: number;
+    size: number;
+}
+/** Writable decision-cache settings. */
+export interface BrainCachePatchWire {
+    enabled?: boolean | undefined;
+    ttlMs?: number | undefined;
+    maxEntries?: number | undefined;
+}
+/** One council seat template on the wire. */
+export interface BrainCouncilSeatWire {
+    persona: string;
+    veto?: boolean | undefined;
+}
+/** Headless escalation variant. */
+export type BrainTerminalPolicyWire = 'conservative' | 'deny-all' | 'continue-on-recommended';
 /** JSON-safe snapshot of the live Brain config (mirrors core's BrainConfigSnapshot). */
 export interface BrainConfigWire {
     mode: 'headless' | 'interactive';
@@ -1481,14 +1725,44 @@ export interface BrainConfigWire {
         quorum?: number | undefined;
         approval?: number | undefined;
         judge?: BrainModelEntryWire | undefined;
+        perCallTimeoutMs?: number | undefined;
+        maxConcurrency?: number | undefined;
+        distinctness: 'none' | 'model' | 'provider';
+        judgeMaxTokens?: number | undefined;
+        seats: BrainCouncilSeatWire[];
     };
     ledger: {
         enabled: boolean;
         autoDenyAfterFailures?: number | undefined;
         path?: string | undefined;
-    };
+        /** Writable via the patch; core's snapshot does not echo these back yet. */
+        maxMemoryEntries?: number | undefined;
+        interventionRetryWindowMs?: number | undefined;
+    };
+    /** Configured deterministic rules, in evaluation order (read-only here). */
+    rules: BrainRuleWire[];
+    /** Compile diagnostics from the last assembly — one per dropped rule. */
+    ruleErrors: string[];
+    heuristics: BrainHeuristicsWire;
+    llm: BrainLlmWire;
+    trace: BrainTraceWire;
+    monitor: BrainMonitorWire;
+    terminalPolicy: BrainTerminalPolicyWire;
+    decisionLogMaxEntries: number;
+    /** Live LLM circuit-breaker state, when a breaker is wired (read-only). */
+    circuit?: {
+        state: string;
+        consecutiveFailures: number;
+    } | undefined;
+    cache: BrainCacheWire;
     poolLabels: string[];
     councilLabels: string[];
+    /**
+     * EFFECTIVE council judge, undefined when no council is wired. Distinct from
+     * `council.judge` (the CONFIGURED one, usually absent): the derived judge is
+     * the one that can silently also be a seated voter.
+     */
+    judgeLabel?: string | undefined;
     usingSessionModel: boolean;
 }
 /** Partial Brain config update: omitted = untouched, null = clear, arrays replace. */
@@ -1506,11 +1780,28 @@ export interface BrainConfigPatchWire {
         quorum?: number | null | undefined;
         approval?: number | null | undefined;
         judge?: string | BrainModelEntryWire | null | undefined;
+        perCallTimeoutMs?: number | null | undefined;
+        maxConcurrency?: number | null | undefined;
+        distinctness?: 'none' | 'model' | 'provider' | null | undefined;
+        judgeMaxTokens?: number | null | undefined;
+        seats?: BrainCouncilSeatWire[] | null | undefined;
     } | null | undefined;
     ledger?: {
         enabled?: boolean | undefined;
         autoDenyAfterFailures?: number | null | undefined;
+        maxMemoryEntries?: number | null | undefined;
+        interventionRetryWindowMs?: number | null | undefined;
     } | null | undefined;
+    /** Replaces the whole rule table; `null` clears it. */
+    rules?: BrainRuleWire[] | null | undefined;
+    /** Merged field-by-field; `null` clears the block back to all-defaults. */
+    heuristics?: BrainHeuristicsPatchWire | null | undefined;
+    llm?: BrainLlmPatchWire | null | undefined;
+    trace?: BrainTracePatchWire | null | undefined;
+    monitor?: BrainMonitorWire | null | undefined;
+    terminalPolicy?: BrainTerminalPolicyWire | null | undefined;
+    decisionLogMaxEntries?: number | null | undefined;
+    cache?: BrainCachePatchWire | null | undefined;
 }
 export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
     type: 'side_effects.list';
@@ -1939,9 +2230,12 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
 } | {
     type: 'memory.list';
 } | {
-    type: 'memory.super.list';
+    type: `agent-roster.${string}`;
+    payload?: Record<string, unknown> | undefined;
+} | {
+    type: 'memory.sage.list';
 } | {
-    type: 'memory.super.listPage';
+    type: 'memory.sage.listPage';
     payload: {
         statuses?: string[] | undefined;
         kind?: string | undefined;
@@ -1950,29 +2244,29 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
         cursor?: string | undefined;
     };
 } | {
-    type: 'memory.super.get';
+    type: 'memory.sage.get';
     payload: {
         id: string;
     };
 } | {
-    type: 'memory.super.graph';
+    type: 'memory.sage.graph';
     payload: {
         query: string;
         maxDepth?: number;
         limit?: number;
     };
 } | {
-    type: 'memory.super.update';
+    type: 'memory.sage.update';
     payload: {
         id: string;
         text?: string | undefined;
         tags?: string[] | undefined;
         kind?: string | undefined;
-        status?: SuperMemoryStatus | undefined;
+        status?: SageStatus | undefined;
         importance?: number | undefined;
         confidence?: number | undefined;
         freshness?: number | undefined;
-        anchors?: SuperMemoryAnchor[] | undefined;
+        anchors?: SageAnchor[] | undefined;
         audience?: {
             roles?: string[];
             taskTypes?: string[];
@@ -1982,27 +2276,27 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
         contradicts?: string[] | undefined;
     };
 } | {
-    type: 'memory.super.delete';
+    type: 'memory.sage.delete';
     payload: {
         id: string;
         reason?: string | undefined;
         neverInject?: boolean | undefined;
     };
 } | {
-    type: 'memory.super.recover';
+    type: 'memory.sage.recover';
     payload: {
         id: string;
         reason?: string | undefined;
     };
 } | {
-    type: 'memory.super.candidateResolve';
+    type: 'memory.sage.candidateResolve';
     payload: {
         candidateId: string;
         action: 'accept' | 'reject';
         reason?: string | undefined;
     };
 } | {
-    type: 'memory.super.backfillRecoverable';
+    type: 'memory.sage.backfillRecoverable';
     payload: {
         apply: boolean;
         kinds?: string[] | undefined;
@@ -2011,19 +2305,19 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
         updatedBefore?: string | undefined;
     };
 } | {
-    type: 'memory.super.forFile';
-    payload: WSMemorySuperForFileRequest;
+    type: 'memory.sage.forFile';
+    payload: WSMemorySageForFileRequest;
 } | {
-    type: 'memory.super.remember';
+    type: 'memory.sage.remember';
     payload: {
         text: string;
         kind?: string | undefined;
-        scope?: SuperMemoryScope | undefined;
+        scope?: SageScope | undefined;
         tags?: string[] | undefined;
         importance?: number | undefined;
         confidence?: number | undefined;
         freshness?: number | undefined;
-        anchors?: SuperMemoryAnchor[] | undefined;
+        anchors?: SageAnchor[] | undefined;
         audience?: {
             roles?: string[];
             taskTypes?: string[];
@@ -2100,6 +2394,13 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
         query?: ChronicleQuery | undefined;
         limit?: number | undefined;
     };
+} | {
+    type: 'chronicle.facets';
+    payload: {
+        fields: ChronicleFacet[];
+        query?: ChronicleQuery | undefined;
+        limit?: number | undefined;
+    };
 } | {
     type: 'chronicle.graph';
     payload: {
@@ -2107,6 +2408,19 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
         hops?: number;
         maxNodes?: number;
     };
+} | {
+    type: 'chronicle.metrics';
+    payload: {
+        view?: ChronicleMetricsView | undefined;
+        from?: string | undefined;
+        to?: string | undefined;
+        path?: string | undefined;
+        taskId?: string | undefined;
+        boardId?: string | undefined;
+        sessionId?: string | undefined;
+        status?: string | undefined;
+        limit?: number | undefined;
+    };
 } | {
     type: 'session.save';
     payload?: SessionScopedPayload;
@@ -2253,6 +2567,18 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
         target: 'terminal' | 'file-manager';
     };
 } | WSCollabJoin | WSCollabLeave | WSCollabAnnotate | WSCollabResolve | WSCollabRequestPause | WSCollabResume | WSCollabGrantControl | WSCollabInjectTool | {
+    type: 'mailbox.send';
+    payload: {
+        requestId: string;
+        to: string;
+        type: 'note' | 'ask' | 'assign' | 'steer' | 'btw' | 'broadcast' | 'status' | 'result' | 'review';
+        audience: 'all' | 'leaders';
+        subject: string;
+        body: string;
+        priority: 'low' | 'normal' | 'high';
+        replyTo?: string | undefined;
+    };
+} | {
     type: 'mailbox.messages';
     payload: {
         limit?: number | undefined;
@@ -2370,6 +2696,22 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
     payload: {
         overrides: Record<string, string>;
     };
+} | {
+    type: 'design.tune';
+    payload: {
+        tune: {
+            radius?: string | undefined;
+            density?: string | undefined;
+            font?: string | undefined;
+            motion?: string | undefined;
+        };
+    };
+} | {
+    type: 'design.swap';
+    payload: {
+        kit: string;
+        stack?: string | undefined;
+    };
 } | {
     type: 'design.materialize';
     payload?: {
@@ -2378,6 +2720,11 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
     } | undefined;
 } | {
     type: 'design.verify';
+} | {
+    type: 'config.doctor';
+    payload?: {
+        apply?: boolean;
+    } | undefined;
 } | {
     type: 'mcp.list';
 } | {
@@ -2391,6 +2738,9 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
         args?: string[];
         env?: Record<string, string>;
         allowedTools?: string[];
+        url?: string;
+        headers?: Record<string, string>;
+        lazy?: boolean;
     };
 } | {
     type: 'mcp.remove';
@@ -2408,6 +2758,9 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
         args?: string[];
         env?: Record<string, string>;
         allowedTools?: string[];
+        url?: string;
+        headers?: Record<string, string>;
+        lazy?: boolean;
     };
 } | {
     type: 'mcp.wake';
@@ -2513,7 +2866,7 @@ export type WSClientMessageCore = WSUserMessage | WSToolConfirmResult | {
     type: 'webui.shutdown';
 };
 export type WSClientMessage = WSClientMessageCore;
-export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSThinkingDelta | WSToolUseStart | WSToolProgress | WSToolExecuted | WSCodeMapToolStarted | WSCodeMapToolExecuted | WSIterationStarted | WSIterationCompleted | WSIterationLimitReached | WSProviderResponse | WSProviderRetry | WSProviderError | WSProviderFallback | WSProviderStatusChanged | WSProviderActiveBlocked | WSProviderStreamError | WSRunResult | WSSessionStats | WSError | WSToolConfirmNeeded | WSTrustPersisted | WSToolLoopDetected | WSDelegateStarted | WSDelegateCompleted | WSContextDebug | WSContextCompacted | WSCompactionFailed | WSContextRepaired | WSContextPct | WSContextMaxContext | WSTokenThreshold | WSTokenCostEstimateUnavailable | WSContextModesList | WSContextModeChanged | WSToolsList | WSMemoryList | WSMemorySuperList | WSMemorySuperListPage | WSMemorySuperGet | WSMemorySuperGraph | WSMemorySuperUpdate | WSMemorySuperRemember | WSMemorySuperDelete | WSMemorySuperRecover | WSMemorySuperCandidateResolve | WSMemorySuperBackfillRecoverable | WSMemorySuperForFile | WSSkillsList | WSSkillContent | WSDesignList | WSDesignUse | WSDesignState | WSDesignSet | WSDesignMaterialize | WSDesignVerify | WSSkillsInstalled | WSSkillsUninstalled | WSSkillsUpdated | WSSkillsCreated | WSSkillsEdited | WSSkillsExported | WSDiagGet | WSStatsGet | {
+export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSThinkingDelta | WSToolUseStart | WSToolProgress | WSToolExecuted | WSCodeMapToolStarted | WSCodeMapToolExecuted | WSIterationStarted | WSIterationCompleted | WSIterationLimitReached | WSProviderResponse | WSProviderRetry | WSProviderError | WSProviderFallback | WSProviderStatusChanged | WSProviderActiveBlocked | WSProviderStreamError | WSRunResult | WSSessionStats | WSError | WSToolConfirmNeeded | WSTrustPersisted | WSToolLoopDetected | WSDelegateStarted | WSDelegateCompleted | WSContextDebug | WSContextCompacted | WSCompactionFailed | WSContextRepaired | WSContextPct | WSContextMaxContext | WSTokenThreshold | WSTokenCostEstimateUnavailable | WSContextModesList | WSContextModeChanged | WSToolsList | WSMemoryList | WSMemorySageList | WSMemorySageListPage | WSMemorySageGet | WSMemorySageGraph | WSMemorySageUpdate | WSMemorySageRemember | WSMemorySageDelete | WSMemorySageRecover | WSMemorySageCandidateResolve | WSMemorySageBackfillRecoverable | WSMemorySageForFile | WSSkillsList | WSSkillContent | WSDesignList | WSDesignUse | WSDesignState | WSDesignSet | WSDesignTune | WSDesignSwap | WSDesignMaterialize | WSDesignVerify | WSSkillsInstalled | WSSkillsUninstalled | WSSkillsUpdated | WSSkillsCreated | WSSkillsEdited | WSSkillsExported | WSDiagGet | WSStatsGet | {
     type: 'chronicle.query_result';
     payload: ChronicleQueryResult;
 } | {
@@ -2526,9 +2879,21 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
             invalidLines: number;
         };
     };
+} | {
+    type: 'chronicle.facets_result';
+    payload: {
+        values: Partial<Record<ChronicleFacet, ChronicleFacetValue[]>>;
+        diagnostics: {
+            sourceFiles: number;
+            invalidLines: number;
+        };
+    };
 } | {
     type: 'chronicle.graph_result';
     payload: ChronicleGraphResult;
+} | {
+    type: 'chronicle.metrics_result';
+    payload: ChronicleMetricsResultPayload;
 } | {
     type: 'chronicle.error';
     payload: {
@@ -2716,6 +3081,16 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
         agents: Array<Record<string, unknown>>;
         error?: string | undefined;
     };
+} | {
+    type: 'mailbox.sent';
+    payload: {
+        requestId: string;
+        success: boolean;
+        messageId?: string | undefined;
+        to?: string | undefined;
+        audience?: 'all' | 'leaders' | undefined;
+        error?: string | undefined;
+    };
 } | {
     type: 'pong';
     payload?: Record<string, unknown> | undefined;
@@ -2729,6 +3104,7 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
             startedAt: number;
             status: 'running' | 'exited' | 'killed';
             protected?: boolean | undefined;
+            background?: boolean | undefined;
         }>;
     };
 } | WSSideEffects | {
@@ -2808,6 +3184,8 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
         mode?: 'headless' | 'interactive' | undefined;
         poolLabels?: string[] | undefined;
         councilLabels?: string[] | undefined;
+        /** EFFECTIVE council judge — undefined when no council is wired. */
+        judgeLabel?: string | undefined;
         ledgerPath?: string | undefined;
     };
 } | {
@@ -2861,6 +3239,13 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
         line?: number | undefined;
         endLine?: number | undefined;
     };
+} | {
+    type: 'codemap.index_updated';
+    payload: {
+        at: number;
+        ready: boolean;
+        reason: 'index_complete';
+    };
 } | {
     type: 'session.damaged';
     payload: {
@@ -3044,6 +3429,20 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
         name: string;
         ok: boolean;
     };
+} | {
+    type: 'config.doctor.result';
+    payload: {
+        success: boolean;
+        applied: boolean;
+        changed: boolean;
+        changes: Array<{
+            path: string;
+            action: 'added' | 'replaced';
+        }>;
+        configPath: string;
+        backupPath?: string;
+        error?: string;
+    };
 } | {
     type: 'mcp.list';
     payload: {
@@ -3056,6 +3455,11 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
             tools?: string[];
             error?: string;
             pid?: number;
+            lazy?: boolean;
+            command?: string;
+            args?: string[];
+            env?: Record<string, string>;
+            url?: string;
             health?: {
                 healthState: 'disabled' | 'dormant' | 'connecting' | 'healthy' | 'degraded' | 'failed';
                 consecutiveFailures: number;
@@ -3089,6 +3493,11 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
             enabled: boolean;
             description?: string;
             tools?: string[];
+            lazy?: boolean;
+            command?: string;
+            args?: string[];
+            env?: Record<string, string>;
+            url?: string;
         };
     };
 } | {
@@ -3106,6 +3515,11 @@ export type WSServerMessage = WSSessionStart | WSSessionEnd | WSTextDelta | WSTh
             enabled: boolean;
             description?: string;
             tools?: string[];
+            lazy?: boolean;
+            command?: string;
+            args?: string[];
+            env?: Record<string, string>;
+            url?: string;
         };
     };
 } | {