pi2web 0.2.0 → 0.2.1

package/dist/session-namer.js

@@ -0,0 +1,114 @@
+import { EventEmitter } from 'node:events';
+import { assistantText, authHeaders, clipSummaryField, deadline, endpoint, prepareSummaryInput } from './voice.js';
+export const DEFAULT_SESSION_NAMER = {
+    baseUrl: 'http://localhost:8313/', model: 'gpt-5-mini', language: 'zh-CN',
+    // Reasoning models (gpt-5-mini and friends) burn this budget on hidden reasoning tokens before they
+    // emit the name, so a tight cap yields an empty message with finish_reason "length".
+    maxInputChars: 8000, maxOutputTokens: 2000, requestTimeoutMs: 60000
+};
+export function parseSessionName(text) {
+    const trimmed = text.trim().replace(/^```(?:json)?\s*/i, '').replace(/\s*```$/, '');
+    let candidate = trimmed;
+    const start = trimmed.indexOf('{'), end = trimmed.lastIndexOf('}');
+    if (start >= 0 && end > start) {
+        try {
+            const value = JSON.parse(trimmed.slice(start, end + 1));
+            if (typeof value?.sessionName === 'string')
+                candidate = value.sessionName;
+        }
+        catch { /* fall back to the raw text below */ }
+    }
+    const name = candidate.replace(/[\r\n\t]+/g, ' ').replace(/\s{2,}/g, ' ').replace(/^["'“”‘’]|["'“”‘’]$/g, '').trim().slice(0, 60).trim();
+    return name || undefined;
+}
+export class SessionNamer {
+    fetcher;
+    emitter = new EventEmitter();
+    lastAssistant = new Map();
+    lastPrompt = new Map();
+    pending = new Set();
+    closed = false;
+    config;
+    constructor(config = {}, fetcher = fetch) {
+        this.fetcher = fetcher;
+        this.config = { apiKey: '', ...DEFAULT_SESSION_NAMER, ...strip(config) };
+    }
+    subscribe(listener) { this.emitter.on('event', listener); return () => this.emitter.off('event', listener); }
+    close() { this.closed = true; this.emitter.removeAllListeners(); this.lastAssistant.clear(); this.lastPrompt.clear(); }
+    recordUserPrompt(agentId, prompt) { const value = prompt.trim(); if (value)
+        this.lastPrompt.set(agentId, value); }
+    emit(agentId, event) { this.emitter.emit('event', agentId, event); }
+    handleAgentEvent(agentId, event, context = {}) {
+        if (this.closed)
+            return;
+        if (event.type === 'before_agent_start' && typeof event.prompt === 'string')
+            return void this.recordUserPrompt(agentId, event.prompt);
+        if (event.type === 'agent_start') {
+            if (typeof event.message === 'string')
+                this.recordUserPrompt(agentId, event.message);
+            return;
+        }
+        if (event.type === 'message_end') {
+            const text = assistantText(event.message);
+            if (text)
+                this.lastAssistant.set(agentId, text);
+            return;
+        }
+        if (event.type !== 'agent_settled')
+            return;
+        const finalOutput = this.lastAssistant.get(agentId) ?? '', userPrompt = this.lastPrompt.get(agentId) ?? '';
+        this.lastAssistant.delete(agentId);
+        this.lastPrompt.delete(agentId);
+        if (context.sessionName?.trim() || !context.setSessionName)
+            return;
+        if (!userPrompt && !finalOutput)
+            return;
+        void this.nameSession(agentId, userPrompt, finalOutput, context.setSessionName);
+    }
+    /** Generates and applies a name. Exposed so callers can trigger naming outside the event stream. */
+    async nameSession(agentId, userPrompt, finalOutput, apply) {
+        if (this.pending.has(agentId))
+            return;
+        this.pending.add(agentId);
+        try {
+            const name = await this.requestName(userPrompt, finalOutput);
+            if (!name)
+                throw new Error('Naming endpoint returned no session name');
+            await apply(name);
+            this.emit(agentId, { type: 'session_name_generated', name });
+        }
+        catch (error) {
+            this.emit(agentId, { type: 'session_name_error', message: error.message });
+        }
+        finally {
+            this.pending.delete(agentId);
+        }
+    }
+    async requestName(userPrompt, finalOutput) {
+        const promptBudget = Math.max(1, Math.floor(this.config.maxInputChars * 0.6));
+        const body = JSON.stringify({
+            userPrompt: clipSummaryField(userPrompt, promptBudget),
+            piFinalOutput: prepareSummaryInput(finalOutput, Math.max(1, this.config.maxInputChars - promptBudget))
+        });
+        const response = await this.fetcher(endpoint(this.config.baseUrl, '/chat/completions'), {
+            method: 'POST', signal: deadline(this.config.requestTimeoutMs),
+            headers: { 'content-type': 'application/json', ...authHeaders(this.config.apiKey || undefined) },
+            body: JSON.stringify({ model: this.config.model, stream: false, temperature: 0.2, max_tokens: this.config.maxOutputTokens,
+                messages: [{ role: 'system', content: this.prompt() }, { role: 'user', content: body }] })
+        });
+        if (!response.ok)
+            throw new Error(`Session naming request failed (${response.status}): ${(await response.text()).slice(0, 300)}`);
+        const value = await response.json();
+        const choice = value?.choices?.[0];
+        const content = choice?.message?.content;
+        const text = typeof content === 'string' ? content : Array.isArray(content) ? content.filter((part) => part?.type === 'text' && typeof part.text === 'string').map((part) => part.text).join('') : '';
+        if (!text.trim())
+            throw new Error(choice?.finish_reason === 'length' ? `Naming endpoint returned no content: the model hit the ${this.config.maxOutputTokens}-token output budget (raise --session-name-max-output-tokens)` : 'Naming endpoint returned no content');
+        return parseSessionName(text);
+    }
+    prompt() {
+        const language = this.config.language.toLowerCase().startsWith('zh') ? '简体中文' : '与用户输入相同的主要语言';
+        return `你负责为一次 Pi 编程会话生成标题。\n\n输入是一个 JSON 对象：\n- userPrompt：用户本轮真正想完成的任务。\n- piFinalOutput：Pi 最后一次回复。\n\n主要依据 userPrompt 概括任务主题，必要时参考 piFinalOutput。标题使用${language}：中文 6 到 18 个字，英文 3 到 8 个词；具体、便于检索，不写“新会话”“任务总结”等空泛名称，不带句号、引号、Emoji、代码或路径。\n\n只输出一个合法 JSON 对象：{"sessionName":"简短标题"}，不要输出 Markdown 代码块、解释或任何额外文字。`;
+    }
+}
+const strip = (value) => Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined && v !== ''));

package/dist/voice.js

@@ -2,12 +2,12 @@ import { EventEmitter } from 'node:events';
 import { randomUUID } from 'node:crypto';
 const punctuation = new Set(['。', '！', '？', '!', '?', '.']);
 const closing = new Set(['”', '’', '"', '\'', '）', ')', '】', ']']);
-const endpoint = (base, path) => `${base.replace(/\/$/, '')}${base.replace(/\/$/, '').endsWith('/v1') ? '' : '/v1'}${path}`;
-const authHeaders = (key) => key ? { authorization: `Bearer ${key}` } : {};
+export const endpoint = (base, path) => `${base.replace(/\/$/, '')}${base.replace(/\/$/, '').endsWith('/v1') ? '' : '/v1'}${path}`;
+export const authHeaders = (key) => key ? { authorization: `Bearer ${key}` } : {};
 const abortError = (error) => error instanceof Error && error.name === 'AbortError';
 const timeoutError = (error) => error instanceof Error && error.name === 'TimeoutError';
 /** Combines caller cancellation with a hard timeout so a stalled speech server cannot block the announcement queue forever. */
-const deadline = (ms, signal) => signal ? AbortSignal.any([signal, AbortSignal.timeout(ms)]) : AbortSignal.timeout(ms);
+export const deadline = (ms, signal) => signal ? AbortSignal.any([signal, AbortSignal.timeout(ms)]) : AbortSignal.timeout(ms);
 export function assistantText(message) {
     if (typeof message === 'string')
         return message.trim() || undefined;
@@ -42,7 +42,7 @@ export function prepareSummaryInput(text, maxChars = 32000) {
     cleaned = `${cleaned.slice(0, head)}\n\n[中间内容已省略]\n\n${cleaned.slice(-tail)}`;
     return cleaned;
 }
-function clipSummaryField(text, maxChars) {
+export function clipSummaryField(text, maxChars) {
     const normalized = text.replace(/[ \t]+/g, ' ').replace(/\n{3,}/g, '\n\n').trim();
     if (normalized.length <= maxChars)
         return normalized;
@@ -169,10 +169,12 @@ export class VoiceManager {
     generations = new Map();
     announcementQueue = Promise.resolve();
     closed = false;
+    /** Some backends rename or reject optional sampling parameters; the working shape is learned once and reused. */
+    summaryParams = { temperature: true, tokenLimitField: 'max_tokens' };
     config;
     constructor(config, fetcher = fetch) {
         this.fetcher = fetcher;
-        this.config = { language: 'zh-CN', maxInputChars: 32000, maxOutputTokens: 160, sampleRate: 24000, ttsFormat: 'pcm', requestTimeoutMs: 120000, ...config };
+        this.config = { language: 'zh-CN', maxInputChars: 32000, sampleRate: 24000, ttsFormat: 'pcm', requestTimeoutMs: 120000, ...config };
     }
     subscribe(listener) { this.emitter.on('event', listener); return () => this.emitter.off('event', listener); }
     capabilities() { return { tts: true, stt: !!this.config.sttModel }; }
@@ -200,7 +202,8 @@ export class VoiceManager {
             const finalOutput = this.lastAssistant.get(agentId), userPrompt = this.lastPrompt.get(agentId) ?? '';
             this.lastAssistant.delete(agentId);
             this.lastPrompt.delete(agentId);
-            if (finalOutput)
+            // A run the user cancelled has no result worth speaking; Pi 0.99+ reports that as `aborted`.
+            if (finalOutput && event.aborted !== true)
                 void this.announce(agentId, { userPrompt, finalOutput, ...context });
         }
     }
@@ -244,9 +247,7 @@ export class VoiceManager {
         let rawResult = '', spokenSummary = '';
         try {
             const summaryInput = prepareSummaryContext(input, this.config.maxInputChars);
-            const response = await this.fetcher(endpoint(this.config.summaryBaseUrl, '/chat/completions'), { method: 'POST', signal: deadline(this.config.requestTimeoutMs, controller.signal), headers: { 'content-type': 'application/json', ...authHeaders(this.config.summaryApiKey) }, body: JSON.stringify({ model: this.config.summaryModel, stream: true, temperature: 0.2, max_tokens: this.config.maxOutputTokens, messages: [{ role: 'system', content: this.summaryPrompt() }, { role: 'user', content: summaryInput }] }) });
-            if (!response.ok)
-                throw new Error(`Summary request failed (${response.status}): ${(await response.text()).slice(0, 500)}`);
+            const response = await this.requestSummary(summaryInput, controller.signal);
             for await (const delta of sseText(response))
                 rawResult += delta;
             const result = parseSummaryResult(rawResult), sessionName = input.sessionName?.trim() || result.sessionName;
@@ -288,6 +289,43 @@ export class VoiceManager {
                 controller.abort();
         }
     }
+    /** Retries once per unsupported parameter so a strict model still produces a summary instead of failing the announcement. */
+    async requestSummary(summaryInput, signal) {
+        for (let attempt = 0;; attempt++) {
+            const body = { model: this.config.summaryModel, stream: true, messages: [{ role: 'system', content: this.summaryPrompt() }, { role: 'user', content: summaryInput }] };
+            if (this.summaryParams.temperature && typeof this.config.summaryTemperature === 'number')
+                body.temperature = this.config.summaryTemperature;
+            if (this.summaryParams.tokenLimitField && this.config.maxOutputTokens)
+                body[this.summaryParams.tokenLimitField] = this.config.maxOutputTokens;
+            const response = await this.fetcher(endpoint(this.config.summaryBaseUrl, '/chat/completions'), { method: 'POST', signal: deadline(this.config.requestTimeoutMs, signal), headers: { 'content-type': 'application/json', ...authHeaders(this.config.summaryApiKey) }, body: JSON.stringify(body) });
+            if (response.ok)
+                return response;
+            const detail = (await response.text()).slice(0, 500);
+            if (response.status === 400 && attempt < 2 && this.relaxSummaryParams(detail))
+                continue;
+            throw new Error(`Summary request failed (${response.status}): ${detail}`);
+        }
+    }
+    relaxSummaryParams(detail) {
+        const text = detail.toLowerCase();
+        if (!/unsupported|not supported|unrecognized|unknown|invalid/.test(text))
+            return false;
+        let changed = false;
+        if (this.summaryParams.temperature && text.includes('temperature')) {
+            this.summaryParams.temperature = false;
+            changed = true;
+        }
+        const field = this.summaryParams.tokenLimitField;
+        if (field === 'max_tokens' && text.includes('max_tokens')) {
+            this.summaryParams.tokenLimitField = text.includes('max_completion_tokens') ? 'max_completion_tokens' : null;
+            changed = true;
+        }
+        else if (field === 'max_completion_tokens' && text.includes('max_completion_tokens')) {
+            this.summaryParams.tokenLimitField = null;
+            changed = true;
+        }
+        return changed;
+    }
     summaryPrompt() { const language = this.config.language.toLowerCase().startsWith('zh') ? '简体中文' : '与用户输入相同的主要语言'; return `你负责把一次 Pi 编程任务压缩成准确、自然、可直接朗读的完成通知，并在需要时为 Session 命名。\n\n输入是一个 JSON 对象：\n- userPrompt：用户本轮真正想完成的任务。\n- piFinalOutput：Pi 最后一次回复，包含完成情况、改动、验证结果和后续事项。\n- sessionNeedsName：只有为 true 时才需要生成 Session 名称。\n\n先结合 userPrompt 判断目标，再以 piFinalOutput 为事实依据总结。不要把用户的要求误说成已经完成；没有明确证据时不要声称测试通过或任务成功。摘要使用${language}，写 2 到 4 个短句，最多 120 个中文字符或 70 个英文单词。优先交代：是否完成、最重要的结果或修改、测试/验证结果、失败原因，以及用户必须采取的下一步。省略代码、命令、URL、完整路径、哈希、冗长文件清单、日志和 Markdown；不要使用标题、列表、“总结如下”等套话。\n\n如果 sessionNeedsName 为 true，请根据 userPrompt 生成一个具体、简短、便于检索的名称：中文建议 6 到 18 个字，英文建议 3 到 8 个词；使用任务主题或目标，不写“新会话”“任务总结”等空泛名称，不带句号、引号、Emoji 或路径。如果 sessionNeedsName 为 false，sessionName 必须为 null。\n\n只输出一个合法 JSON 对象，不要输出 Markdown 代码块、解释或任何额外文字。有名称时使用 {"summary":"适合直接朗读的摘要","sessionName":"简短名称"}；无需命名时使用 {"summary":"适合直接朗读的摘要","sessionName":null}。summary 必须是 JSON 字符串，sessionName 必须是 JSON 字符串或 null。`; }
     async speak(agentId, playbackId, text, signal) {
         const response = await this.fetcher(endpoint(this.config.speechBaseUrl, '/audio/speech'), { method: 'POST', signal: deadline(this.config.requestTimeoutMs, signal), headers: { 'content-type': 'application/json', ...authHeaders(this.config.speechApiKey) }, body: JSON.stringify({ model: this.config.ttsModel, voice: this.config.ttsVoice, input: text, response_format: this.config.ttsFormat, sample_rate: this.config.sampleRate, stream_format: 'audio' }) });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi2web",
-  "version": "0.2.0",
-  "description": "Secure remote web and Android client server for Pi coding agent",
+  "version": "0.2.1",
+  "description": "Secure remote web client server for Pi coding agent",
   "type": "module",
   "author": "sxwxs",
   "license": "MIT",
@@ -25,7 +25,6 @@
     "packages/edge-tts-server/README.md",
     "README.md",
     "VOICE_SERVER_SETUP.md",
-    "ANDROID_APP_FEATURES.md",
     "LICENSE"
   ],
   "publishConfig": {
@@ -34,25 +33,28 @@
   },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "npm run clean && tsc -p tsconfig.json",
+    "build": "npm run clean && tsc -p tsconfig.json && chmod +x dist/main.js",
     "check": "npm run build",
     "test": "vitest run",
     "dev": "tsx src/main.ts",
+    "dev:watch": "tsx watch src/main.ts",
     "start": "node dist/main.js",
     "prepack": "npm run build",
     "prepublishOnly": "npm run build && npm test"
   },
   "engines": {
-    "node": ">=20.10"
+    "node": ">=22.19.0"
   },
   "dependencies": {
-    "@earendil-works/pi-coding-agent": "0.80.6",
+    "@earendil-works/pi-ai": "1.1.0",
+    "@earendil-works/pi-coding-agent": "1.1.0",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",
     "better-sqlite3": "^12.11.1",
     "dompurify": "^3.4.12",
     "marked": "^18.0.6",
     "node-pty": "^1.1.0",
+    "typebox": "1.3.27",
     "ws": "^8.18.0"
   },
   "devDependencies": {

package/packages/protocol/openapi.yaml

@@ -22,6 +22,8 @@ paths:
   /agents/{id}/{action}:
     get: {operationId: getAgentResource, parameters: [{$ref: '#/components/parameters/Id'}, {name: action, in: path, required: true, schema: {enum: [state,messages,capabilities,session]}}], responses: {'200': {$ref: '#/components/responses/Success'}}}
     post: {operationId: agentCommand, parameters: [{$ref: '#/components/parameters/Id'}, {name: action, in: path, required: true, schema: {enum: [prompt,steer,follow-up,abort,compact,model,thinking,session-name,navigate,fork,extension-response]}}], requestBody: {$ref: '#/components/requestBodies/Json'}, responses: {'200': {$ref: '#/components/responses/Success'}}}
+  /draft:
+    post: {operationId: draftText, description: 'Insert text into the currently displayed Web UI input box on this backend, without sending it to an Agent. Body {text, mode?: append|replace, source?}; explicit agent/slot targets are rejected. Pending text is kept in memory until a page acknowledges it.', requestBody: {$ref: '#/components/requestBodies/Json'}, responses: {'200': {$ref: '#/components/responses/Success'}}}
 components:
   securitySchemes: {bearerAuth: {type: http, scheme: bearer}}
   parameters:

package/packages/protocol/websocket.schema.json

@@ -4,14 +4,55 @@
   "title": "Remote Pi WebSocket v1",
   "oneOf": [
     {"$ref":"#/$defs/subscribe"}, {"$ref":"#/$defs/command"}, {"$ref":"#/$defs/subscribed"},
-    {"$ref":"#/$defs/commandResult"}, {"$ref":"#/$defs/agentEvent"}, {"$ref":"#/$defs/agentSnapshot"}
+    {"$ref":"#/$defs/commandResult"}, {"$ref":"#/$defs/agentEvent"}, {"$ref":"#/$defs/agentSnapshot"}, {"$ref":"#/$defs/agentStateUpdate"},
+    {"$ref":"#/$defs/subscribeDrafts"}, {"$ref":"#/$defs/subscribedDrafts"}, {"$ref":"#/$defs/draftAck"}, {"$ref":"#/$defs/draftEvent"}
   ],
   "$defs": {
-    "subscribe": {"type":"object","additionalProperties":false,"required":["type","agentId"],"properties":{"type":{"const":"subscribe"},"agentId":{"type":"string"},"lastSequence":{"type":"integer","minimum":0},"fromNow":{"type":"boolean"}}},
-    "command": {"type":"object","additionalProperties":false,"required":["type","requestId","agentId"],"properties":{"type":{"enum":["prompt","steer","follow-up","abort"]},"requestId":{"type":"string"},"agentId":{"type":"string"},"message":{"type":"string","maxLength":2097152}}},
+    "subscribeDrafts": {"type":"object","additionalProperties":false,"required":["type"],"properties":{"type":{"const":"subscribe_drafts"}},"description":"Full pairing code only: receive pending drafts from voice clients."},
+    "subscribedDrafts": {"type":"object","required":["type","protocolVersion"],"properties":{"type":{"const":"subscribed_drafts"},"protocolVersion":{"const":1}}},
+    "draftAck": {"type":"object","additionalProperties":false,"required":["type","id"],"properties":{"type":{"const":"draft_ack"},"id":{"type":"string"}}},
+    "draftEvent": {"type":"object","required":["type","draft"],"properties":{"type":{"const":"draft_event"},"replay":{"type":"boolean"},"draft":{"type":"object","required":["id","text","mode","createdAt"],"properties":{"id":{"type":"string"},"text":{"type":"string"},"mode":{"enum":["append","replace"]},"source":{"type":"string"},"createdAt":{"type":"string"}}}}},
+    "subscribe": {"type":"object","additionalProperties":false,"required":["type","agentId"],"properties":{"type":{"const":"subscribe"},"agentId":{"type":"string"},"lastSequence":{"type":"integer","minimum":0},"fromNow":{"type":"boolean"},"messageLimit":{"type":"integer","minimum":1,"maximum":200}}},
+    "command": {"type":"object","additionalProperties":false,"required":["type","requestId","agentId"],"properties":{"type":{"enum":["prompt","steer","follow-up","abort","clear-queue"]},"requestId":{"type":"string"},"agentId":{"type":"string"},"message":{"type":"string","maxLength":2097152}}},
     "subscribed": {"type":"object","required":["type","agentId","protocolVersion"],"properties":{"type":{"const":"subscribed"},"agentId":{"type":"string"},"protocolVersion":{"const":1},"currentSequence":{"type":"integer","minimum":0}}},
-    "commandResult": {"type":"object","required":["type","success"],"properties":{"type":{"const":"command_result"},"requestId":{"type":"string"},"success":{"type":"boolean"},"error":{"type":"object"}}},
-    "agentEvent": {"type":"object","required":["type","agentId","eventId","sequence","event"],"properties":{"type":{"const":"agent_event"},"agentId":{"type":"string"},"eventId":{"type":"string"},"sequence":{"type":"integer","minimum":1},"timestamp":{"type":"integer","minimum":0},"event":{"type":"object","required":["type"]}}},
-    "agentSnapshot": {"type":"object","required":["type","agentId","lastSequence","state","messages"],"properties":{"type":{"const":"agent_snapshot"},"agentId":{"type":"string"},"lastSequence":{"type":"integer","minimum":0},"state":{"type":"object"},"messages":{"type":"array"}}}
+    "commandResult": {"type":"object","required":["type","success"],"properties":{"type":{"const":"command_result"},"requestId":{"type":"string"},"success":{"type":"boolean"},"error":{"type":"object"},"disposition":{"enum":["handled","queued"],"description":"For steer and follow-up: whether the running turn took the message or it waits in the queue. Omitted by older servers."},"queue":{"$ref":"#/$defs/queue"}}},
+    "queue": {"type":"object","required":["steering","followUp"],"description":"Messages waiting for the running turn.","properties":{"steering":{"type":"array","items":{"type":"string"}},"followUp":{"type":"array","items":{"type":"string"}}}},
+    "agentEvent": {"type":"object","required":["type","agentId","eventId","sequence","event"],"properties":{"type":{"const":"agent_event"},"agentId":{"type":"string"},"eventId":{"type":"string"},"sequence":{"type":"integer","minimum":1},"timestamp":{"type":"integer","minimum":0},"status":{"$ref":"#/$defs/agentStatus","description":"Agent status after this event. Omitted by older servers."},"event":{"type":"object","required":["type"]}}},
+    "agentStatus": {"enum":["unloaded","starting","idle","streaming","waiting_for_user","error","stopping","stopped"]},
+    "agentSnapshot": {"type":"object","required":["type","agentId","lastSequence","state","messages"],"properties":{"type":{"const":"agent_snapshot"},"agentId":{"type":"string"},"lastSequence":{"type":"integer","minimum":0},"state":{"$ref":"#/$defs/agentState"},"messages":{"type":"array"}}},
+    "agentStateUpdate": {"type":"object","required":["type","agentId","sequence","state"],"description":"Current state after initial replay/snapshot and before live events, also sent for fromNow or empty replay. Does not replace transcript messages.","properties":{"type":{"const":"agent_state"},"agentId":{"type":"string"},"sequence":{"type":"integer","minimum":0},"state":{"$ref":"#/$defs/agentState"}}},
+    "agentState": {
+      "type":"object","required":["status","agentId","sessionId","cwd"],
+      "properties":{
+        "status":{"$ref":"#/$defs/agentStatus"},
+        "agentId":{"type":"string"},
+        "sessionId":{"type":"string"},
+        "sessionFile":{"type":"string"},
+        "sessionName":{"type":"string"},
+        "cwd":{"type":"string"},
+        "activity":{
+          "type":"object","required":["bashIds","dialogIds"],
+          "description":"Runtime operations independent of LLM status. Omitted by older servers; never persisted.",
+          "properties":{
+            "bashIds":{"type":"array","uniqueItems":true,"items":{"type":"string"}},
+            "dialogIds":{"type":"array","uniqueItems":true,"items":{"type":"string"}},
+            "dialogRequests":{
+              "type":"array","description":"Pending request payloads for rebuilding dialog controls, without submitted answers. Omitted by older servers.",
+              "items":{
+                "type":"object","required":["type","requestId","kind"],
+                "properties":{
+                  "type":{"const":"extension_ui_request"},"requestId":{"type":"string"},
+                  "kind":{"enum":["select","confirm","input","editor"]},
+                  "title":{"type":"string"},"message":{"type":"string"},
+                  "options":{"type":"array","items":{"type":"string"}},
+                  "placeholder":{"type":"string"},"prefill":{"type":"string"},"opts":{"type":"object"}
+                }
+              }
+            },
+            "queue":{"$ref":"#/$defs/queue"}
+          }
+        }
+      }
+    }
   }
 }