@volter/supercode-frontend-vscode 0.1.57 → 0.1.60

package/dist/view.js

@@ -195,11 +195,75 @@ export function shellCommand(toolName, argumentsText) {
     catch { /* not JSON */ }
     return undefined;
 }
-/** The summary line this view shows for a request payload. */
+/** The harness-supplied arguments of an approval; no files are read to reconstruct an edit. */
+function approvalArguments(fields) {
+    const value = fields.arguments ?? fields.raw_args ?? fields.input;
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+/** An approval preview is display text, never a patch to apply or an answer to the request. */
+function approvalSummary(fields) {
+    const args = approvalArguments(fields);
+    const tool = text(fields.tool ?? fields.tool_name);
+    const values = args && typeof args === 'object' && !Array.isArray(args) ? args : undefined;
+    const path = values ? text(values.file_path ?? values.path ?? values.file ?? values.notebook_path) : '';
+    const heading = [tool, path || text(fields.subject ?? fields.message ?? fields.reason)].filter(Boolean)
+        .map(value => plain(clamp(stripControls(value), VSCODE_CHAT_LIMITS.titleCharacters))).join(' · ');
+    // Bound before adding fences, so truncation cannot leave an open code block.
+    const preview = (value, language = '') => {
+        const cleaned = stripControls(value);
+        const limited = clamp(cleaned, 24 * 1024);
+        return fence(limited, language) + (limited !== cleaned ? '\n\n_Preview truncated; the harness request is unchanged._' : '');
+    };
+    const changes = [];
+    const edits = values && Array.isArray(values.edits) ? values.edits : values ? [values] : [];
+    for (const edit of edits.slice(0, 4)) {
+        if (!edit || typeof edit !== 'object' || Array.isArray(edit))
+            continue;
+        if (typeof edit.old_string === 'string' && typeof edit.new_string === 'string') {
+            changes.push(`**Replace${edit.replace_all === true ? ' every match' : ''}**\n\n${preview(edit.old_string)}\n\n**With**\n\n${preview(edit.new_string)}`);
+        }
+    }
+    if (edits.length > 4)
+        changes.push('_Additional edits omitted from this preview; the harness request is unchanged._');
+    if (!changes.length && values) {
+        const patch = values.patch ?? values.diff;
+        const contents = values.content ?? values.new_source;
+        if (typeof patch === 'string')
+            changes.push(preview(patch, 'diff'));
+        else if (typeof contents === 'string')
+            changes.push(`**Proposed contents**\n\n${preview(contents)}`);
+    }
+    if (!changes.length && args !== undefined && args !== null) {
+        changes.push(preview(typeof args === 'string' ? args : JSON.stringify(args, null, 2), typeof args === 'string' ? '' : 'json'));
+    }
+    if (!changes.length)
+        changes.push('_The harness supplied no change preview._');
+    // Each edit is separately bounded; the overall card is bounded too. Retain
+    // complete fenced sections rather than cutting through their markup.
+    let result = heading;
+    for (const change of changes) {
+        if (result.length + change.length > VSCODE_CHAT_LIMITS.partCharacters - 128) {
+            result += '\n\n_Additional preview omitted; the harness request is unchanged._';
+            break;
+        }
+        result += `\n\n${change}`;
+    }
+    return result;
+}
+/** The information this view shows for a request payload. */
 export function requestSummary(request) {
     const payload = request.payload;
     if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
         const fields = payload;
+        if (request.kind === 'approval')
+            return approvalSummary(fields);
         // `decide_approval` in crates/harness/src/server.rs publishes
         // `{tool, subject, raw_args}` and `ask_elicitation` publishes
         // `{message, requested_schema}`; the contract's own conformance fixture
@@ -348,11 +412,10 @@ export function requestSubject(request) {
     const tool = typeof fields.tool === 'string' ? fields.tool
         : typeof fields.tool_name === 'string' ? fields.tool_name
             : undefined;
+    const args = approvalArguments(fields);
     const subject = typeof fields.subject === 'string' ? fields.subject
-        : typeof fields.raw_args === 'string' ? fields.raw_args
-            : typeof fields.arguments === 'object' && fields.arguments !== null && !Array.isArray(fields.arguments)
-                ? toolSubject(JSON.stringify(fields.arguments))
-                : undefined;
+        : args && typeof args === 'object' ? toolSubject(JSON.stringify(args))
+            : undefined;
     if (tool && subject)
         return `${tool} on ${clamp(stripControls(subject), 120)}`;
     if (tool)
@@ -377,12 +440,26 @@ export function projectEvent(event, context) {
     const payload = payloadOf(event);
     switch (event.kind) {
         // crates/harness/src/server.rs `submit_claimed` — the runtime's echo of the
-        // prompt. VS Code already renders the request turn, so the live view drops
-        // its own echo; only the session-history projection reads it.
-        case 'user_message':
+        // initial prompt, before `turn_started`. VS Code renders that request turn.
+        // A rejoined turn has no submitting handler; later runtime input is visible
+        // within its live response and remains a user turn in canonical history.
+        case 'user_message': {
+            if (context.liveUserMessages) {
+                const body = text(payload.text);
+                const automatic = automaticPrompt(body);
+                if (automatic)
+                    return automatic.notice
+                        ? [stable({ part: 'markdown', value: `\n\n${automatic.notice}\n\n` })]
+                        : [];
+                const prefix = '\n\n**Additional input**\n\n';
+                const suffix = '\n\n';
+                const value = clamp(stripControls(body), VSCODE_CHAT_LIMITS.partCharacters - prefix.length - suffix.length);
+                return value ? [stable({ part: 'markdown', value: `${prefix}${value}${suffix}` })] : [];
+            }
             return context.echoOwnPrompts
                 ? [stable({ part: 'markdown', value: clamp(stripControls(text(payload.text)), VSCODE_CHAT_LIMITS.partCharacters) })]
                 : [];
+        }
         // crates/harness/src/server.rs `submit_claimed`, and
         // crates/runtime/src/event.rs `AgentEvent::TurnCompleted` (one model
         // round-trip). Lifecycle only — the turn resolves on these, never renders.
@@ -487,7 +564,7 @@ export function projectEvent(event, context) {
             const answers = requestAnswers(request, context.connectionId);
             const subject = requestSubject(request);
             const title = request.kind === 'approval'
-                ? 'Approval required'
+                ? subject ? `Allow ${stripControls(subject)}?` : 'Approval required'
                 : subject ? `Approve ${subject}` : `Assistant request #${request.id}`;
             // The host capability decides whether these original answers can use
             // a native in-turn confirmation card. Stock confirmation clicks start a
@@ -545,11 +622,11 @@ export function projectEvent(event, context) {
             return [stable({ part: 'warning', value: 'The turn was interrupted.' })];
         // crates/harness/src/server.rs `submit_claimed` emits `turn_failed`. The
         // other four are the error kinds the donor-neutral reader in
-        // crates/frontend-model/src/transcript.rs treats identically:
+        // sdk/interchange/frontend-transcript.mjs treats identically:
         // `transport_error` from crates/opencode-frontend/src/server.rs,
         // `watch_error` from crates/interchange/src/watch.rs, and
         // `runtime_disconnected`, which a frontend synthesizes for itself
-        // (crates/frontend-tui/src/app.rs). `stream_error` has no producer in this
+        // (sdk/interchange/frontend-app.mjs). `stream_error` has no producer in this
         // repository and is read only because that reader reads it.
         case 'turn_failed':
         case 'stream_error':
@@ -566,7 +643,7 @@ export function projectEvent(event, context) {
         }
         // Declared by the runtime descriptor's `display.event_kinds`
         // (crates/harness/src/server.rs `frontend_descriptor`); read here the way
-        // crates/frontend-model/src/transcript.rs reads them.
+        // sdk/interchange/frontend-transcript.mjs reads them.
         case 'scheduled_prompt_started':
         case 'scheduled_prompt_deferred':
         case 'scheduled_prompt_completed':
@@ -591,7 +668,7 @@ export function projectEvent(event, context) {
         case 'warning':
             return [stable({ part: 'warning', value: clamp(stripControls(text(payload.message)), VSCODE_CHAT_LIMITS.partCharacters) })];
         // Not in this runtime's declared set; read the way
-        // crates/frontend-model/src/transcript.rs reads a donor that emits them.
+        // sdk/interchange/frontend-transcript.mjs reads a donor that emits them.
         case 'reasoning':
         case 'thinking': {
             const body = clamp(stripControls(text(payload.text ?? payload.summary, opaqueText(event.payload))), VSCODE_CHAT_LIMITS.partCharacters);
@@ -641,8 +718,10 @@ function messageText(message) {
         if (!entry || typeof entry !== 'object' || Array.isArray(entry))
             return '';
         const part = entry;
+        // Opaque transcript parts can carry structured text. Use the same bounded
+        // JSON rendering as live payloads rather than JavaScript's object coercion.
         if (['text', 'input_text', 'output_text'].includes(String(part.type)))
-            return String(part.text ?? '');
+            return text(part.text);
         if (['image', 'image_url', 'input_image'].includes(String(part.type)))
             return '[image]';
         return '';
@@ -652,8 +731,8 @@ function messageText(message) {
 }
 /**
  * A "user" message no person typed: Claude Code's `<task-notification>` (a background task reporting back) or the
- * editor's automatic tripwire nudge. Neither is shown as the person's words. A task notification is said as one
- * short line ("Background task completed: <its summary>"); a nudge is not shown. Undefined for a person's message.
+ * editor's automatic tripwire nudge or Claude's unmarked interruption record. None is shown as the person's words.
+ * A task notification and interruption are short notices; a nudge is not shown. Undefined for a person's message.
  */
 export function automaticPrompt(body) {
     const trimmed = body.trimStart();
@@ -665,6 +744,9 @@ export function automaticPrompt(body) {
     }
     if (trimmed.startsWith('[Volter editor tripwire'))
         return {};
+    // Claude persists this reserved notice as an unmarked user-role record.
+    if (trimmed.trimEnd() === '[Request interrupted by user]')
+        return { notice: '_Turn interrupted._' };
     return undefined;
 }
 export function projectReplayTurns(events, granted, context, history = []) {
@@ -794,6 +876,11 @@ export function projectHistory(history, granted, pendingToolNames = new Set()) {
                     pushAssistant([{ part: 'markdown', value: `\n\n${automatic.notice}\n\n` }]);
                 continue;
             }
+            // The codec preserves the harness's provenance. Image-coordinate notes,
+            // compact summaries and injected context are not the person's words.
+            if (message.metadata?.isMeta === 'true' || message.metadata?.isCompactSummary === 'true' ||
+                message.metadata?.promptSource === 'system')
+                continue;
             toolRows.clear();
             turns.push({ role: 'user', prompt: clamp(stripControls(body), VSCODE_CHAT_LIMITS.partCharacters) });
             continue;

package/media/anthropic.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="-1 3.5 26 18" fill="#d97757"><path fill-rule="evenodd" d="M20.998 10.949H24v3.102h-3v3.028h-1.487V20H18v-2.921h-1.487V20H15v-2.921H9V20H7.488v-2.921H6V20H4.487v-2.921H3V14.05H0V10.95h3V5h17.998v5.949zM6 10.949h1.488V8.102H6v2.847zm10.51 0H18V8.102h-1.49v2.847z"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-1 3.5 26 18" fill="#d97757"><path fill-rule="evenodd" clip-rule="evenodd" d="M20.998 10.949H24v3.102h-3v3.028h-1.487V20H18v-2.921h-1.487V20H15v-2.921H9V20H7.488v-2.921H6V20H4.487v-2.921H3V14.05H0V10.95h3V5h17.998v5.949zM6 10.949h1.488V8.102H6v2.847zm10.51 0H18V8.102h-1.49v2.847z"/></svg>

package/media/google.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#8b8df8"><path fill-rule="evenodd" d="M12 24C12 17.373 6.627 12 0 12 6.627 12 12 6.627 12 0c0 6.627 5.373 12 12 12-6.627 0-12 5.373-12 12z"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#8b8df8"><path d="M12 24C12 17.373 6.627 12 0 12 6.627 12 12 6.627 12 0c0 6.627 5.373 12 12 12-6.627 0-12 5.373-12 12z"/></svg>

package/media/openai.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="-1 -1 26 26" fill="#aaaaaa"><path fill-rule="evenodd" d="M8.086.457a6.105 6.105 0 013.046-.415c1.333.153 2.521.72 3.564 1.7a.117.117 0 00.107.029c1.408-.346 2.762-.224 4.061.366l.063.03.154.076c1.357.703 2.33 1.77 2.918 3.198.278.679.418 1.388.421 2.126a5.655 5.655 0 01-.18 1.631.167.167 0 00.04.155 5.982 5.982 0 011.578 2.891c.385 1.901-.01 3.615-1.183 5.14l-.182.22a6.063 6.063 0 01-2.934 1.851.162.162 0 00-.108.102c-.255.736-.511 1.364-.987 1.992-1.199 1.582-2.962 2.462-4.948 2.451-1.583-.008-2.986-.587-4.21-1.736a.145.145 0 00-.14-.032c-.518.167-1.04.191-1.604.185a5.924 5.924 0 01-2.595-.622 6.058 6.058 0 01-2.146-1.781c-.203-.269-.404-.522-.551-.821a7.74 7.74 0 01-.495-1.283 6.11 6.11 0 01-.017-3.064.166.166 0 00.008-.074.115.115 0 00-.037-.064 5.958 5.958 0 01-1.38-2.202 5.196 5.196 0 01-.333-1.589 6.915 6.915 0 01.188-2.132c.45-1.484 1.309-2.648 2.577-3.493.282-.188.55-.334.802-.438.286-.12.573-.22.861-.304a.129.129 0 00.087-.087A6.016 6.016 0 015.635 2.31C6.315 1.464 7.132.846 8.086.457zm-.804 7.85a.848.848 0 00-1.473.842l1.694 2.965-1.688 2.848a.849.849 0 001.46.864l1.94-3.272a.849.849 0 00.007-.854l-1.94-3.393zm5.446 6.24a.849.849 0 000 1.695h4.848a.849.849 0 000-1.696h-4.848z"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-1 -1 26 26" fill="#aaaaaa"><path fill-rule="evenodd" clip-rule="evenodd" d="M8.086.457a6.105 6.105 0 013.046-.415c1.333.153 2.521.72 3.564 1.7a.117.117 0 00.107.029c1.408-.346 2.762-.224 4.061.366l.063.03.154.076c1.357.703 2.33 1.77 2.918 3.198.278.679.418 1.388.421 2.126a5.655 5.655 0 01-.18 1.631.167.167 0 00.04.155 5.982 5.982 0 011.578 2.891c.385 1.901-.01 3.615-1.183 5.14l-.182.22a6.063 6.063 0 01-2.934 1.851.162.162 0 00-.108.102c-.255.736-.511 1.364-.987 1.992-1.199 1.582-2.962 2.462-4.948 2.451-1.583-.008-2.986-.587-4.21-1.736a.145.145 0 00-.14-.032c-.518.167-1.04.191-1.604.185a5.924 5.924 0 01-2.595-.622 6.058 6.058 0 01-2.146-1.781c-.203-.269-.404-.522-.551-.821a7.74 7.74 0 01-.495-1.283 6.11 6.11 0 01-.017-3.064.166.166 0 00.008-.074.115.115 0 00-.037-.064 5.958 5.958 0 01-1.38-2.202 5.196 5.196 0 01-.333-1.589 6.915 6.915 0 01.188-2.132c.45-1.484 1.309-2.648 2.577-3.493.282-.188.55-.334.802-.438.286-.12.573-.22.861-.304a.129.129 0 00.087-.087A6.016 6.016 0 015.635 2.31C6.315 1.464 7.132.846 8.086.457zm-.804 7.85a.848.848 0 00-1.473.842l1.694 2.965-1.688 2.848a.849.849 0 001.46.864l1.94-3.272a.849.849 0 00.007-.854l-1.94-3.393zm5.446 6.24a.849.849 0 000 1.695h4.848a.849.849 0 000-1.696h-4.848z"/></svg>

package/media/xai.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-1 -1 26 26" fill="#aaaaaa"><path d="M9.27 15.29l7.978-5.897c.391-.29.95-.177 1.137.272.98 2.369.542 5.215-1.41 7.169-1.951 1.954-4.667 2.382-7.149 1.406l-2.711 1.257c3.889 2.661 8.611 2.003 11.562-.953 2.341-2.344 3.066-5.539 2.388-8.42l.006.007c-.983-4.232.242-5.924 2.75-9.383.06-.082.12-.164.179-.248l-3.301 3.305v-.01L9.267 15.292M7.623 16.723c-2.792-2.67-2.31-6.801.071-9.184 1.761-1.763 4.647-2.483 7.166-1.425l2.705-1.25a7.808 7.808 0 00-1.829-1A8.975 8.975 0 005.984 5.83c-2.533 2.536-3.33 6.436-1.962 9.764 1.022 2.487-.653 4.246-2.34 6.022-.599.63-1.199 1.259-1.682 1.925l7.62-6.815"/></svg>

package/package.json

@@ -1,9 +1,21 @@
 {
   "name": "@volter/supercode-frontend-vscode",
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": ">=12.15.0",
+      "onFail": "error"
+    }
+  },
   "displayName": "Volter Harness",
-  "version": "0.1.57",
+  "version": "0.1.60",
   "type": "module",
   "description": "VS Code chat-view frontend for an existing Volter Harness SDK runtime",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/volter-ai/supercode.git",
+    "directory": "sdk/frontend-vscode"
+  },
   "publisher": "volter-ai-dev",
   "icon": "media/icon.png",
   "main": "./dist/extension.js",
@@ -22,11 +34,6 @@
     "NOTICE.md",
     "media"
   ],
-  "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist', {recursive:true, force:true})\" && node scripts/sync-sdk.mjs && node scripts/fetch-icon.mjs && tsc -p tsconfig.build.json",
-    "extension": "npm run build && node scripts/pack-extension.mjs",
-    "prepack": "npm run build"
-  },
   "engines": {
     "node": ">=20",
     "vscode": "^1.138.0"
@@ -50,6 +57,20 @@
     "chatProvider"
   ],
   "contributes": {
+    "taskDefinitions": [
+      {
+        "type": "supercode-setup",
+        "required": [
+          "operation"
+        ],
+        "properties": {
+          "operation": {
+            "type": "string",
+            "description": "The identity of this coding-agent installation."
+          }
+        }
+      }
+    ],
     "chatParticipants": [
       {
         "id": "supercode.chat",
@@ -190,8 +211,12 @@
   },
   "supercodeFrontendContract": {
     "name": "@volter/supercode-frontend",
-    "version": "0.2.9",
+    "version": "0.2.12",
     "mode": "generated-artifact"
   },
-  "license": "MIT OR Apache-2.0"
-}
+  "license": "MIT OR Apache-2.0",
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', {recursive:true, force:true})\" && node scripts/sync-sdk.mjs && node scripts/fetch-icon.mjs && node scripts/sync-marks.mjs && tsc -p tsconfig.build.json",
+    "extension": "pnpm run build && node scripts/pack-extension.mjs"
+  }
+}

package/vendor/supercode-frontend/README.md

@@ -16,6 +16,33 @@ race; HTTP uses bearer authentication plus an opaque client id and permission
 narrowing. Dropping or detaching this client never closes the runtime;
 `close()` is a separate terminate-authorized action.
 
+Attachment snapshots may include `pending_requests`, the complete open-request
+set at the snapshot boundary. An empty array means no request remains open;
+absence denotes an older runtime with replay-derived state. IDs and payloads
+come from the runtime; responses still use its existing exactly-once door.
+
+`snapshot_cursor` is the full capture boundary of the descriptor and request
+set, taken under the native projection lock. It differs from `history_cursor`,
+which covers only canonical and retired display history. Transports return
+unfiltered snapshot replay even when an existing stream has advanced.
+`mergeFrontendSnapshot` joins later retained observations in sequence order;
+an evicted suffix refuses attachment with `event_gap`. The view installs the
+authoritative request set at capture before applying later requests, resolutions
+and native turn boundaries. Legacy snapshots without the added cursor retain
+their full replay boundary, and absence of the request set retains legacy
+replay-derived behavior. These display fields grant no response authority.
+
+`history_events` contains original sequenced events retired from replay since
+canonical history was last captured. `history_cursor` covers canonical history
+and these historical events; live/replay delivery begins after that boundary.
+Historical events are display data, not events to send back to a harness. Both
+native projection paths retain up to 4096 retired events plus 4096 replay events.
+`history_events_dropped` counts older events outside that display window. A
+frontend must show that omission rather than claim a complete transcript.
+Canonical message history remains bounded separately. Open requests survive
+independently of both event windows. Older clients need updating to render these
+additive snapshot fields. See the [source and compilation record](../../docs/evidence/frontend-pending-snapshot-2026-10-10.md).
+
 `FrontendWebSocketClient.connect()` requires a header-capable socket factory
 and passes the bearer token only in `Authorization`. It deliberately has no
 query-token fallback: browser clients that cannot set upgrade headers use the

package/vendor/supercode-frontend/client.d.mts

@@ -33,6 +33,12 @@ export class FrontendClientError extends Error {
   extensions: Record<string, unknown>;
 }
 
+/** Native snapshot plus contiguous later retained events; refuses an evicted suffix. */
+export function mergeFrontendSnapshot(snapshot: FrontendAttachSnapshot, observed?: readonly FrontendEvent[], cursor?: number): {
+  captureCursor: number; cursor: number; replay: FrontendEvent[]; later: FrontendEvent[];
+};
+export function projectFrontendDescriptor(descriptor: FrontendRuntimeDescriptor | null, event: FrontendEvent): FrontendRuntimeDescriptor | null;
+
 export class FrontendClient extends GeneratedFrontendClient<RequestOptions> {
   constructor(options: FrontendClientOptions);
   readonly clientId: string;
@@ -43,7 +49,7 @@ export class FrontendClient extends GeneratedFrontendClient<RequestOptions> {
   attach(limit?: number, options?: RequestOptions & {afterSequence?: number}): Promise<FrontendAttachSnapshot>;
   sendInput(prompt: string, options?: RequestOptions): Promise<{accepted:boolean}>;
   submit(prompt: string, options?: RequestOptions): Promise<{reply:string}>;
-  interrupt(options?: RequestOptions): Promise<{interrupted:boolean}>;
+  interrupt(options?: RequestOptions & {expectedTurn?: string}): Promise<{interrupted:boolean}>;
   steer(prompt: string, options?: RequestOptions): Promise<{queued:boolean}>;
   respond(response: FrontendResponse, options?: RequestOptions): Promise<{accepted:boolean}>;
   invoke(operation: FrontendOperationInvocation, options?: RequestOptions): Promise<FrontendOperationResult>;

package/vendor/supercode-frontend/client.mjs

@@ -69,6 +69,79 @@ function validateDescriptor(descriptor) {
   return descriptor;
 }
 
+function validateSnapshot(snapshot) {
+  validateDescriptor(snapshot?.descriptor);
+  if (!Array.isArray(snapshot.history) || !Array.isArray(snapshot.replay)
+    || !Number.isSafeInteger(snapshot.history_cursor) || snapshot.history_cursor < 0
+    || (snapshot.history_events !== undefined && !Array.isArray(snapshot.history_events))
+    || (snapshot.history_events_dropped !== undefined
+      && (!Number.isSafeInteger(snapshot.history_events_dropped) || snapshot.history_events_dropped < 0))) {
+    throw new FrontendClientError({name:'transport', message:'invalid frontend attachment snapshot'});
+  }
+  let previous = 0;
+  for (const event of snapshot.history_events ?? []) {
+    if (!Number.isSafeInteger(event?.sequence) || event.sequence <= previous
+      || (previous > 0 && event.sequence !== previous + 1)
+      || event.sequence > snapshot.history_cursor || typeof event.kind !== 'string') {
+      throw new FrontendClientError({name:'transport', message:'invalid frontend historical event boundary'});
+    }
+    previous = event.sequence;
+  }
+  if (previous > 0 && previous !== snapshot.history_cursor) {
+    throw new FrontendClientError({name:'transport', message:'incomplete frontend historical event boundary'});
+  }
+}
+
+/** Join a captured snapshot to retained later observations without changing
+ * the native capture point. A missing bounded suffix refuses attachment. */
+export function mergeFrontendSnapshot(snapshot, observed = [], cursor = 0) {
+  validateSnapshot(snapshot);
+  const captureCursor = snapshot.snapshot_cursor ?? Math.max(snapshot.history_cursor,
+    ...snapshot.replay.map(event => event.sequence));
+  if (!Number.isSafeInteger(captureCursor) || captureCursor < snapshot.history_cursor
+    || !Number.isSafeInteger(cursor) || cursor < 0) {
+    throw new FrontendClientError({name:'transport', message:'invalid frontend snapshot capture boundary'});
+  }
+  const events = new Map();
+  for (const event of snapshot.replay) {
+    if (!Number.isSafeInteger(event?.sequence) || event.sequence <= snapshot.history_cursor
+      || event.sequence > captureCursor || typeof event.kind !== 'string') {
+      throw new FrontendClientError({name:'transport', message:'invalid frontend snapshot replay boundary'});
+    }
+    events.set(event.sequence, event);
+  }
+  for (const event of observed) {
+    if (event.sequence > captureCursor) events.set(event.sequence, event);
+  }
+  const replay = [...events.values()].sort((a, b) => a.sequence - b.sequence);
+  const later = replay.filter(event => event.sequence > captureCursor);
+  let projected = captureCursor;
+  for (const event of later) {
+    if (!Number.isSafeInteger(event.sequence) || event.sequence !== projected + 1) {
+      throw new FrontendClientError({name:'event_gap', message:`frontend snapshot needs event ${projected + 1}, received ${event.sequence}`});
+    }
+    projected = event.sequence;
+  }
+  if (projected < cursor) {
+    throw new FrontendClientError({name:'event_gap', message:`frontend snapshot lost retained events ${projected + 1} through ${cursor}`});
+  }
+  return {captureCursor, cursor:projected, replay, later};
+}
+
+/** Project only native lifecycle events; a model round-trip does not idle a turn. */
+export function projectFrontendDescriptor(descriptor, event) {
+  if (!descriptor) return descriptor;
+  if (event.kind === 'runtime_disconnected') {
+    return {...descriptor, connection_state:'shutting_down', turn_state:'idle',
+      actions:{...descriptor.actions, submit:false, steer:false, interrupt:false, respond:false}};
+  }
+  if (['turn_succeeded', 'turn_failed', 'turn_interrupted'].includes(event.kind)) {
+    return {...descriptor, turn_state:'idle'};
+  }
+  if (['turn_started', 'user_message'].includes(event.kind)) return {...descriptor, turn_state:'busy'};
+  return descriptor;
+}
+
 export class FrontendClient extends FrontendEmitter {
   #baseUrl;
   #token;
@@ -132,13 +205,12 @@ export class FrontendClient extends FrontendEmitter {
       this.stopEvents();
       throw error;
     }
-    validateDescriptor(snapshot?.descriptor);
-    if (!Array.isArray(snapshot.history) || !Array.isArray(snapshot.replay) || !Number.isSafeInteger(snapshot.history_cursor)) {
-      throw new FrontendClientError({ name: 'transport', message: 'invalid frontend attachment snapshot' });
-    }
-    this.#lastSequence = Math.max(this.#lastSequence, afterSequence, snapshot.history_cursor);
-    snapshot.replay = snapshot.replay.filter((event) => event.sequence > this.#lastSequence);
-    for (const event of snapshot.replay) this.#lastSequence = Math.max(this.#lastSequence, event.sequence);
+    validateSnapshot(snapshot);
+    // Replay remains the native snapshot's, even if a running stream already
+    // delivered some of it. View adapters need that capture boundary to merge
+    // their later observations; the stream's delivery cursor cannot erase it.
+    const {captureCursor} = mergeFrontendSnapshot(snapshot);
+    this.#lastSequence = Math.max(this.#lastSequence, afterSequence, captureCursor);
     return snapshot;
   }
   async #openEventStream(afterSequence, signal) {
@@ -288,10 +360,12 @@ export class FrontendWebSocketClient extends FrontendEmitter {
   async describe() { return validateDescriptor(await this.rpc(FRONTEND_METHODS.describe)); }
   async attach(limit = 1000, {afterSequence = 0} = {}) {
     const snapshot = await this.rpc(FRONTEND_METHODS.attach, {limit, after_sequence:afterSequence});
-    validateDescriptor(snapshot?.descriptor);
-    this.#lastSequence = Math.max(this.#lastSequence, afterSequence, snapshot.history_cursor);
-    snapshot.replay = snapshot.replay.filter((event) => event.sequence > this.#lastSequence);
-    for (const event of snapshot.replay) this.#lastSequence = Math.max(this.#lastSequence, event.sequence);
+    validateSnapshot(snapshot);
+    // Replay remains the native snapshot's, even if a running stream already
+    // delivered some of it. View adapters need that capture boundary to merge
+    // their later observations; the stream's delivery cursor cannot erase it.
+    const {captureCursor} = mergeFrontendSnapshot(snapshot);
+    this.#lastSequence = Math.max(this.#lastSequence, afterSequence, captureCursor);
     return snapshot;
   }
   async detach() { const result = await this.rpc(FRONTEND_METHODS.detach); this.closeTransport(); return result; }

package/vendor/supercode-frontend/contract.json

@@ -28,6 +28,7 @@
   "types": {
     "JsonValue": {"kind": "json"},
     "Empty": {"kind": "object", "fields": {}},
+    "InterruptParams": {"kind": "object", "fields": {"expected_turn": {"type": "string", "optional": true}}},
     "ChatRole": {"kind": "enum", "values": ["system", "user", "assistant", "tool"]},
     "FunctionCall": {
       "kind": "object",
@@ -143,7 +144,11 @@
         "descriptor": {"type": "FrontendRuntimeDescriptor"},
         "history": {"type": {"kind": "array", "items": "ChatMessage"}},
         "history_cursor": {"type": "u64"},
-        "replay": {"type": {"kind": "array", "items": "FrontendEvent"}}
+        "snapshot_cursor": {"type": "u64", "optional": true, "nullable": true},
+        "history_events": {"type": {"kind": "array", "items": "FrontendEvent"}, "optional": true},
+        "history_events_dropped": {"type": "u64", "optional": true},
+        "replay": {"type": {"kind": "array", "items": "FrontendEvent"}},
+        "pending_requests": {"type": {"kind": "array", "items": "FrontendRequest"}, "optional": true, "nullable": true}
       }
     },
     "FrontendApprovalDecision": {"kind": "enum", "values": ["deny", "allow", "allow_for_session"]},
@@ -260,7 +265,7 @@
     {"id": "attach", "wire": "frontend.v2.attach", "sdk_action": "events", "params": "AttachParams", "result": "FrontendAttachSnapshot", "transports": ["local", "http", "websocket", "acp"]},
     {"id": "send_input", "wire": "frontend.v2.send_input", "sdk_action": "input", "params": "MultimodalPromptParams", "result": "Accepted", "transports": ["local", "http", "websocket", "acp"]},
     {"id": "submit", "wire": "frontend.v2.submit", "sdk_action": "input", "params": "MultimodalPromptParams", "result": "Reply", "compatibility": "completion_waiting_alias", "transports": ["local", "http", "websocket", "acp"]},
-    {"id": "interrupt", "wire": "frontend.v2.interrupt", "sdk_action": "interrupt", "params": "Empty", "result": "Interrupted", "transports": ["local", "http", "websocket", "acp"]},
+    {"id": "interrupt", "wire": "frontend.v2.interrupt", "sdk_action": "interrupt", "params": "InterruptParams", "result": "Interrupted", "transports": ["local", "http", "websocket", "acp"]},
     {"id": "steer", "wire": "frontend.v2.steer", "sdk_action": "steer", "params": "PromptParams", "result": "Queued", "transports": ["local", "http", "websocket", "acp"]},
     {"id": "stop_task", "wire": "frontend.v2.stop_task", "sdk_action": "stop_task", "params": "TaskParams", "result": "Stopped", "transports": ["local", "http", "websocket", "acp"]},
     {"id": "respond", "wire": "frontend.v2.respond", "sdk_action": "respond", "params": "RespondParams", "result": "Accepted", "transports": ["local", "http", "websocket", "acp"]},

package/vendor/supercode-frontend/generated-client.d.mts

@@ -6,7 +6,7 @@ export abstract class GeneratedFrontendClient<Options = unknown> {
   attach(limit?: number, options?: Options & {afterSequence?: number}): Promise<FrontendAttachSnapshot>;
   sendInput(prompt: string, options?: Options & {imageUrls?: string[]}): Promise<Accepted>;
   submit(prompt: string, options?: Options & {imageUrls?: string[]}): Promise<Reply>;
-  interrupt(options?: Options): Promise<Interrupted>;
+  interrupt(options?: Options & {expectedTurn?: string}): Promise<Interrupted>;
   steer(prompt: string, options?: Options): Promise<Queued>;
   stopTask(taskId: string, options?: Options): Promise<Stopped>;
   respond(response: FrontendResponse, options?: Options): Promise<Accepted>;

package/vendor/supercode-frontend/generated-client.mjs

@@ -7,7 +7,7 @@ export class GeneratedFrontendClient {
   attach(limit = 1000, { afterSequence, ...options } = {}) { return this.rpc(FRONTEND_METHODS.attach, { limit, ...(afterSequence === undefined ? {} : {after_sequence:afterSequence}) }, options); }
   sendInput(prompt, { imageUrls, ...options } = {}) { return this.rpc(FRONTEND_METHODS.send_input, { prompt, ...(imageUrls?.length ? {image_urls:imageUrls} : {}) }, options); }
   submit(prompt, { imageUrls, ...options } = {}) { return this.rpc(FRONTEND_METHODS.submit, { prompt, ...(imageUrls?.length ? {image_urls:imageUrls} : {}) }, options); }
-  interrupt(options) { return this.rpc(FRONTEND_METHODS.interrupt, {}, options); }
+  interrupt({ expectedTurn, ...options } = {}) { return this.rpc(FRONTEND_METHODS.interrupt, { ...(expectedTurn === undefined ? {} : { expected_turn: expectedTurn }) }, options); }
   steer(prompt, options) { return this.rpc(FRONTEND_METHODS.steer, { prompt }, options); }
   stopTask(taskId, options) { return this.rpc(FRONTEND_METHODS.stop_task, { task_id: taskId }, options); }
   respond(response, options) { return this.rpc(FRONTEND_METHODS.respond, { response }, options); }

package/vendor/supercode-frontend/generated.d.mts

@@ -2,6 +2,9 @@
 export type JsonPrimitive = string | number | boolean | null;
 export type JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };
 export type Empty = Record<string, never>;
+export interface InterruptParams {
+  expected_turn?: string;
+}
 export type ChatRole = "system" | "user" | "assistant" | "tool";
 export interface FunctionCall {
   name: string;
@@ -79,7 +82,11 @@ export interface FrontendAttachSnapshot {
   descriptor: FrontendRuntimeDescriptor;
   history: ChatMessage[];
   history_cursor: number;
+  snapshot_cursor?: number | null;
+  history_events?: FrontendEvent[];
+  history_events_dropped?: number;
   replay: FrontendEvent[];
+  pending_requests?: FrontendRequest[] | null;
 }
 export type FrontendApprovalDecision = "deny" | "allow" | "allow_for_session";
 export type FrontendElicitationAction = "accept" | "decline" | "cancel";

package/vendor/supercode-frontend/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@volter/supercode-frontend",
-  "version": "0.2.9",
+  "devEngines": { "packageManager": { "name": "pnpm", "version": ">=12.15.0", "onFail": "error" } },
+  "version": "0.2.12",
   "type": "module",
   "description": "Generated language-neutral attachment client for Volter Harness SDK runtimes",
   "exports": {