@wrongstack/webui 1.0.24 → 1.0.27

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

@@ -1,6 +1,7 @@
 import type { BrainConfigPatchWire } from './brain.js';
 import type { ChronicleFacet, ChronicleMetricsView, ChronicleQuery } from './chronicle.js';
 import type { WSCollabAnnotate, WSCollabGrantControl, WSCollabInjectTool, WSCollabJoin, WSCollabLeave, WSCollabRequestPause, WSCollabResolve, WSCollabResume } from './collab.js';
+import type { WSPromptQueueClientMessage } from './prompt-queue.js';
 import type { SessionScopedPayload, WSUserMessage } from './protocol-core.js';
 import type { ContextEditorMessage, ContextEditorRemoval, WSModelSwitch, WSToolConfirmResult, WSUserInputSubmit } from './runtime.js';
 import type { SageAnchor, SageScope, SageStatus, WSMemorySageForFileRequest } from './sage.js';
@@ -25,7 +26,12 @@ export interface ProviderCustomModelWire {
      */
     modelsDev?: Record<string, unknown> | undefined;
 }
-export type WSClientMessageCore = WSUserMessage | {
+export type WSClientMessageCore = WSUserMessage | WSPromptQueueClientMessage
+/** The user is typing; open the provider connection (`session.provider-warm`). */
+ | {
+    type: 'composer.warm';
+    payload: SessionScopedPayload;
+} | {
     type: 'topic.advice';
     payload: SessionScopedPayload & {
         requestId: string;
@@ -100,7 +106,9 @@ export type WSClientMessageCore = WSUserMessage | {
     payload: Record<string, never>;
 } | {
     type: 'goal.resume';
-    payload: Record<string, never>;
+    payload: {
+        graphId?: string | undefined;
+    };
 } | {
     type: 'goal.stop';
     payload: Record<string, never>;
@@ -113,9 +121,6 @@ export type WSClientMessageCore = WSUserMessage | {
 } | {
     type: 'goal.status';
     payload?: Record<string, never>;
-} | {
-    type: 'goal.state';
-    payload?: Record<string, never>;
 } | {
     type: 'goal.save';
     payload?: Record<string, never>;
@@ -125,12 +130,9 @@ export type WSClientMessageCore = WSUserMessage | {
 } | {
     type: 'goal.load';
     payload: {
-        graphId: string;
-    };
-} | {
-    type: 'goal.toggleAutonomous';
-    payload: {
-        autonomous?: boolean | undefined;
+        graphId?: string | undefined;
+        query?: string | undefined;
+        resume?: boolean | undefined;
     };
 } | {
     type: 'goal.selectPhase';
@@ -351,7 +353,7 @@ export type WSClientMessageCore = WSUserMessage | {
         worktrees?: boolean | undefined;
         /** Split non-atomic tasks before dispatch (planning-time decompose). */
         planDecompose?: boolean | undefined;
-    };
+    } & SessionScopedPayload;
 } | {
     type: 'sdd.run.from_graph';
     payload: {
@@ -362,7 +364,7 @@ export type WSClientMessageCore = WSUserMessage | {
         fallbackModels?: string[] | undefined;
         worktrees?: boolean | undefined;
         planDecompose?: boolean | undefined;
-    };
+    } & SessionScopedPayload;
 } | {
     type: 'sdd.run.from_spec';
     payload: {
@@ -373,7 +375,7 @@ export type WSClientMessageCore = WSUserMessage | {
         fallbackModels?: string[] | undefined;
         worktrees?: boolean | undefined;
         planDecompose?: boolean | undefined;
-    };
+    } & SessionScopedPayload;
 } | {
     type: 'abort';
     payload: SessionScopedPayload;
@@ -444,6 +446,13 @@ export type WSClientMessageCore = WSUserMessage | {
          * what a live lane already has.
          */
         replayFor?: string[];
+        /**
+         * Reconnect catch-up: the last numbered frame (`seq`) this page applied
+         * per tab, valid for the server process that issued `eventEpoch`. The
+         * server sends back the frames after it, then `session.frames_resumed`.
+         */
+        cursors?: Record<string, number>;
+        eventEpoch?: string;
     } & SessionScopedPayload;
 } | {
     type: 'context.clear';
@@ -939,6 +948,11 @@ export type WSClientMessageCore = WSUserMessage | {
     payload: {
         filePath: string;
     } & SessionScopedPayload;
+} | {
+    type: 'files.image';
+    payload: {
+        filePath: string;
+    } & SessionScopedPayload;
 } | {
     type: 'files.skeleton';
     payload: {
@@ -1022,6 +1036,23 @@ export type WSClientMessageCore = WSUserMessage | {
 } | {
     type: 'process.list';
     payload?: SessionScopedPayload;
+} | {
+    type: 'process.output';
+    payload: {
+        pid: number;
+        lines?: number;
+    } & SessionScopedPayload;
+} | {
+    type: 'browser.live.list';
+    payload?: SessionScopedPayload;
+} | {
+    type: 'browser.live.watch';
+    payload: {
+        id: string;
+    } & SessionScopedPayload;
+} | {
+    type: 'browser.live.unwatch';
+    payload?: SessionScopedPayload;
 } | {
     type: 'process.kill';
     payload: {
@@ -1086,6 +1117,23 @@ export type WSClientMessageCore = WSUserMessage | {
     type: 'goal.get';
 } | {
     type: 'goal-state.get';
+} | {
+    type: 'goal-state.set';
+    payload: {
+        goal: string;
+    } & SessionScopedPayload;
+} | {
+    type: 'goal-state.refine';
+    payload?: SessionScopedPayload;
+} | {
+    type: 'goal-state.pause';
+    payload?: Record<string, never>;
+} | {
+    type: 'goal-state.resume';
+    payload?: Record<string, never>;
+} | {
+    type: 'goal-state.clear';
+    payload?: Record<string, never>;
 } | {
     type: 'autonomy.switch';
     payload: {
@@ -1100,6 +1148,49 @@ export type WSClientMessageCore = WSUserMessage | {
 } | {
     type: 'system_prompt.get';
     payload?: SessionScopedPayload;
+} | {
+    type: 'system_prompt.presets.get';
+    payload?: SessionScopedPayload;
+} | {
+    type: 'system_prompt.presets.create';
+    payload: {
+        name: string;
+        baseVariant: 'lite' | 'default' | 'pro';
+    };
+} | {
+    type: 'system_prompt.presets.save';
+    payload: {
+        id: string;
+        revision: number;
+        name: string;
+        text: string;
+        reviewedCurrentSource?: boolean;
+    };
+} | {
+    type: 'system_prompt.presets.activate';
+    payload: {
+        baseVariant: 'lite' | 'default' | 'pro';
+        id?: string;
+        sessionId?: string;
+        scope: 'profile' | 'project';
+    };
+} | {
+    type: 'system_prompt.presets.delete';
+    payload: {
+        id: string;
+    };
+} | {
+    type: 'system_prompt.presets.validate';
+    payload: {
+        text: string;
+    };
+} | {
+    type: 'system_prompt.presets.preview';
+    payload: {
+        text: string;
+        sessionId?: string;
+        requestId: number;
+    };
 } | {
     type: 'projects.list';
 } | {
@@ -1392,6 +1483,23 @@ export type WSClientMessageCore = WSUserMessage | {
         prompt: string;
         arguments?: Record<string, string>;
     };
+} | {
+    type: 'mcp.auth.status';
+    payload: {
+        name: string;
+    };
+} | {
+    type: 'mcp.auth.login';
+    payload: {
+        name: string;
+        clientId?: string;
+        scopes?: string[];
+    };
+} | {
+    type: 'mcp.auth.logout';
+    payload: {
+        name: string;
+    };
 } | {
     type: 'terminal.create';
     payload: {

package/dist/types/jev.d.ts

@@ -7,6 +7,8 @@ export interface JevSettings {
     requestTimeoutMs: number;
     keySource: string;
     features: Record<string, boolean>;
+    /** Full request/response recording in the log file. Never sent to this view. */
+    logContent?: boolean;
     contextStrategy?: 'hybrid' | 'intelligent' | 'selective';
     recallTurnContext?: boolean;
     readiness?: Record<string, {

package/dist/types/prompt-queue.d.ts

@@ -0,0 +1,55 @@
+import type { SessionScopedPayload, WSUserMessageImage } from './protocol-core.js';
+/**
+ * The host-owned prompt queue (`session.prompt-queue` capability): prompts
+ * queued for a session live on the server, which runs them one after another
+ * as the session's turns end — whether or not this page is still open.
+ */
+/** One queued prompt as the server lists it (image bytes stay on the server). */
+export interface WSQueuedPromptView {
+    id: string;
+    text: string;
+    addedAt: number;
+    imageCount: number;
+}
+export type WSPromptQueueClientMessage = {
+    type: 'queue.add';
+    payload: SessionScopedPayload & {
+        text: string;
+        images?: WSUserMessageImage[] | undefined;
+    };
+} | {
+    type: 'queue.remove';
+    payload: SessionScopedPayload & {
+        id: string;
+    };
+} | {
+    type: 'queue.clear';
+    payload?: SessionScopedPayload;
+} | {
+    type: 'queue.get';
+    payload?: SessionScopedPayload;
+};
+/** The session's whole queue, after every change. */
+export interface WSQueueState {
+    type: 'queue.state';
+    payload: SessionScopedPayload & {
+        items: WSQueuedPromptView[];
+    };
+}
+/** A queued prompt just started its turn: render it as the user's message. */
+export interface WSQueueDrained {
+    type: 'queue.drained';
+    payload: SessionScopedPayload & {
+        item: {
+            id: string;
+            text: string;
+            addedAt: number;
+            images?: Array<{
+                data: string;
+                mediaType?: string | undefined;
+                name?: string | undefined;
+            }>;
+        };
+    };
+}
+//# sourceMappingURL=prompt-queue.d.ts.map

package/dist/types/protocol-core.d.ts

@@ -1,155 +1,7 @@
-import type { SessionMarker, SessionToolMeta, Usage } from '@wrongstack/core/types';
-export interface WSSessionStart {
-    type: 'session.start';
-    payload: {
-        sessionId: string;
-        /** Original session start timestamp; resume must not reset uptime. */
-        startedAt?: string | undefined;
-        model: string;
-        provider: string;
-        maxContext?: number | undefined;
-        projectName?: string | undefined;
-        cwd?: string | undefined;
-        mode?: string | undefined;
-        contextMode?: string | undefined;
-        inputCost?: number | undefined;
-        outputCost?: number | undefined;
-        cacheReadCost?: number | undefined;
-        reset?: boolean | undefined;
-        replayMessages?: Array<{
-            role: string | undefined;
-            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;
-        /** Per-tool timing/output metadata projected from `tool_call_end`, so a
-         *  replayed tool card shows the same duration and size chips it showed
-         *  live. */
-        replayToolMeta?: SessionToolMeta[] | undefined;
-        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;
-        /** Effort levels the ACTIVE model advertises (models.dev reasoningConfig).
-         *  Absent when the model has no explicit effort list — the UI then shows
-         *  the full canonical set, matching the resolver's conservative gate. */
-        reasoningEffortLevels?: string[] | undefined;
-    };
-}
-export interface WSSessionEnd {
-    type: 'session.end';
-    payload: {
-        sessionId: string;
-        usage: Usage;
-        totalCost: number;
-    };
-}
-export interface SessionScopedPayload {
-    sessionId?: string | undefined;
-}
-/** One image attached to a user message. `data` is bare base64 (no data-URL
- *  prefix); `mediaType` travels separately. */
-export interface WSUserMessageImage {
-    data: string;
-    mediaType: string;
-    /** Original filename when the image came from a picker or drop. */
-    name?: string;
-}
-export interface WSUserMessage {
-    type: 'user_message';
-    payload: SessionScopedPayload & {
-        id: string;
-        content: string;
-        timestamp: number;
-        /** Atomically replace only the provider-bound conversation before this run. */
-        freshContext?: boolean | undefined;
-        /** Images attached in the composer (paste / drop / file picker). The
-         *  server converts these to canonical ImageBlocks ahead of the text. */
-        images?: WSUserMessageImage[];
-        /** @deprecated Legacy single-image field (a full data-URL). Servers
-         *  still accept it; new clients send `images` instead. */
-        imageBase64?: string;
-    };
-}
-export interface WSTextDelta {
-    type: 'provider.text_delta';
-    payload: SessionScopedPayload & {
-        text: string;
-        messageId: string;
-    };
-}
-export interface WSThinkingDelta {
-    type: 'provider.thinking_delta';
-    payload: SessionScopedPayload & {
-        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;
-    };
-}
-export interface WSToolProgress {
-    type: 'tool.progress';
-    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;
-        };
-    };
-}
-export interface WSToolExecuted {
-    type: 'tool.executed';
-    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;
-        /**
-         * SAGE Memory Injector block (`--- SAGE: … ---` header first, then one line
-         * per memory) split off `output` by the backend before its preview cap.
-         * Rendered as a memory card — never appended back onto the tool body.
-         */
-        sage?: string[] | undefined;
-        outputBytes?: number | undefined;
-        outputTokens?: number | undefined;
-        outputLines?: number | undefined;
-    };
-}
+import type { Usage } from '@wrongstack/core/types';
+import type { SessionScopedPayload, WSCodeMapFileTarget } from '@wrongstack/webui-protocol';
+/** Moved to webui-protocol (conversation-core.ts), the single source the SDK shares. */
+export type { SessionScopedPayload, WSCodeMapFileTarget, WSIterationCompleted, WSIterationStarted, WSProviderError, WSProviderRetry, WSRunResult, WSSessionEnd, WSSessionFramesResumed, WSSessionRunState, WSSessionStart, WSTextDelta, WSThinkingDelta, WSToolExecuted, WSToolProgress, WSToolUseStart, WSUserMessage, WSUserMessageImage, } from '@wrongstack/webui-protocol';
 /** Subagent tool lifecycle dedicated to CodeMap; intentionally does not create chat bubbles. */
 export interface WSCodeMapToolStarted {
     type: 'codemap.tool_started';
@@ -183,20 +35,6 @@ export interface WSCodeMapToolExecuted {
         fileTargets?: WSCodeMapFileTarget[] | undefined;
     };
 }
-export interface WSIterationStarted {
-    type: 'iteration.started';
-    payload: SessionScopedPayload & {
-        index: number;
-        maxIterations?: number | undefined;
-    };
-}
-export interface WSIterationCompleted {
-    type: 'iteration.completed';
-    payload: SessionScopedPayload & {
-        index: number;
-        totalIterations: number;
-    };
-}
 export interface WSIterationLimitReached {
     type: 'iteration.limit_reached';
     payload: SessionScopedPayload & {
@@ -213,25 +51,6 @@ export interface WSProviderResponse {
         messageId: string;
     };
 }
-export interface WSProviderRetry {
-    type: 'provider.retry';
-    payload: SessionScopedPayload & {
-        providerId: string;
-        attempt: number;
-        delayMs: number;
-        status: number;
-        description: string;
-    };
-}
-export interface WSProviderError {
-    type: 'provider.error';
-    payload: SessionScopedPayload & {
-        providerId: string;
-        status: number;
-        description: string;
-        retryable: boolean;
-    };
-}
 export interface WSProviderFallback {
     type: 'provider.fallback';
     payload: SessionScopedPayload & {
@@ -344,21 +163,6 @@ export interface WSProviderStreamError {
         message: string;
     };
 }
-/**
- * Whether one session's run is live, answered per declared tab.
- *
- * A reconnect is the hole this closes. `run.result` is what clears a lane's
- * spinner, and it is broadcast once — a tab whose run finished while the
- * socket was down never hears it, so it spins forever, counts as busy, refuses
- * to be recycled and asks to abort a run that ended long ago. Only the tab in
- * front gets a `session.start` on reconnect; this answers for all four.
- */
-export interface WSSessionRunState {
-    type: 'session.run_state';
-    payload: SessionScopedPayload & {
-        isRunning: boolean;
-    };
-}
 export interface WSSessionResumeProgress {
     type: 'session.resume_progress';
     payload: SessionScopedPayload & {
@@ -367,20 +171,4 @@ export interface WSSessionResumeProgress {
         totalBytes: number;
     };
 }
-export interface WSRunResult {
-    type: 'run.result';
-    payload: SessionScopedPayload & {
-        /** Id of the user_message that initiated this run. */
-        requestId?: string | undefined;
-        status: 'done' | 'failed' | 'max_iterations' | 'aborted';
-        iterations: number;
-        finalText?: string | undefined;
-        error?: {
-            code: string;
-            message: string;
-            recoverable: boolean;
-        };
-    };
-}
-export {};
 //# sourceMappingURL=protocol-core.d.ts.map

package/dist/types/runtime.d.ts

@@ -1,5 +1,7 @@
 import type { UserInputRequest, UserInputResponse } from '@wrongstack/core/types';
 import type { SessionScopedPayload } from './protocol-core.js';
+/** Moved to webui-protocol (conversation-core.ts), the single source the SDK shares. */
+export type { WSError, WSToolConfirmNeeded, WSToolConfirmResolved, WSToolConfirmResult, } from '@wrongstack/webui-protocol';
 export interface WSUserInputRequested {
     type: 'user.input_requested';
     payload: SessionScopedPayload & {
@@ -11,7 +13,7 @@ export interface WSUserInputResolved {
     payload: SessionScopedPayload & {
         requestId: string;
         response: UserInputResponse;
-        source: 'user' | 'abort';
+        source: 'user' | 'abort' | 'unattended';
     };
 }
 export interface WSUserInputSubmit {
@@ -31,43 +33,6 @@ export interface WSSessionStats {
         duration: number;
     };
 }
-export interface WSError {
-    type: 'error';
-    payload: SessionScopedPayload & {
-        phase: string;
-        message: string;
-    };
-}
-export interface WSToolConfirmNeeded {
-    type: 'tool.confirm_needed';
-    payload: SessionScopedPayload & {
-        id: string;
-        toolName: string;
-        input: unknown;
-        suggestedPattern: string;
-        decisionSource?: string | undefined;
-        riskTier?: 'safe' | 'standard' | 'destructive' | undefined;
-        boundaryReason?: string | undefined;
-        deadlineAt?: number | undefined;
-    };
-}
-export interface WSToolConfirmResolved {
-    type: 'tool.confirm_resolved';
-    payload: SessionScopedPayload & {
-        id: string;
-        toolName: string;
-        decision: 'yes' | 'no' | 'always' | 'always-exact' | 'always-command' | 'always-tool' | 'deny' | 'abort';
-        source: 'brain_timeout' | 'abort';
-        rationale?: string | undefined;
-    };
-}
-export interface WSToolConfirmResult {
-    type: 'tool.confirm_result';
-    payload: SessionScopedPayload & {
-        id: string;
-        decision: 'yes' | 'no' | 'always' | 'always-exact' | 'always-command' | 'always-tool' | 'deny';
-    };
-}
 export interface WSTrustPersisted {
     type: 'trust.persisted';
     payload: SessionScopedPayload & {

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

@@ -1,4 +1,11 @@
 import type { SessionScopedPayload } from './protocol-core.js';
+/** Both sides of a changed image; a side is absent when the file was added or deleted. */
+export interface GitImageDiff {
+    old?: string | undefined;
+    new?: string | undefined;
+    oldBytes?: number | undefined;
+    newBytes?: number | undefined;
+}
 export type WSFilesGitServerMessage = {
     type: 'codebase.index.server.shutdown_result';
     payload: {
@@ -27,6 +34,19 @@ export type WSFilesGitServerMessage = {
         error?: string | undefined;
         sessionId?: string | undefined;
     };
+} | {
+    /** A project image as a data URL (see `lib/project-image.ts`). */
+    type: 'files.image';
+    payload: {
+        filePath: string;
+        dataUrl?: string | undefined;
+        bytes?: number | undefined;
+        /** The bytes are not a raster image the browser should show. */
+        notImage?: boolean | undefined;
+        tooLarge?: boolean | undefined;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+    };
 } | {
     type: 'files.skeleton_result';
     payload: {
@@ -188,6 +208,8 @@ export type WSFilesGitServerMessage = {
         binary?: boolean | undefined;
         tooLarge?: boolean | undefined;
         error?: string | undefined;
+        /** A changed image: HEAD and working-tree versions as data URLs. */
+        image?: GitImageDiff | undefined;
     };
 } | {
     type: 'projects.list';

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

@@ -122,9 +122,11 @@ export type WSMcpServerMessage = {
     };
 } | {
     type: 'mcp.server.disconnected';
+    /** `terminal`: connect/reconnect exhausted; only `/mcp restart` brings it back. */
     payload: {
         name: string;
         reason: string;
+        terminal?: boolean | undefined;
     };
 } | {
     type: 'mcp.server.error';
@@ -138,6 +140,36 @@ export type WSMcpServerMessage = {
         success: boolean;
         message: string;
     };
+} | {
+    type: 'mcp.auth.status';
+    payload: {
+        serverName: string;
+        resource: string;
+        state: 'not_authorized' | 'pending' | 'authorized' | 'expired';
+        expiresAt?: number;
+        scopes: string[];
+        canRefresh: boolean;
+    };
+} | {
+    type: 'mcp.auth.pending';
+    payload: {
+        name: string;
+        authorizationUrl: string;
+        redirectUri: string;
+        scopes: string[];
+        expiresAt: number;
+        clientIdSource: 'explicit' | 'stored' | 'registered';
+    };
+} | {
+    type: 'mcp.server.auth_state';
+    payload: {
+        name: string;
+        state: 'authorized' | 'refreshed' | 'reauth_required' | 'removed' | 'failed';
+        resource: string;
+        expiresAt?: number;
+        scopes?: string[];
+        message?: string;
+    };
 } | {
     type: 'mcp.resources';
     payload: {