@senpiper/sp-agent 0.1.6 → 0.1.7

package/node_modules/@senpiper/sp-agent-extensions/dist/sp-web-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sp-web-launcher.js","sourceRoot":"","sources":["../src/sp-web-launcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ChildProcess, type SpawnOptions, spawn } from \"node:child_process\";\nimport {\n\tchmodSync,\n\tcloseSync,\n\tconstants,\n\topenSync,\n\treadFileSync,\n\ttype Stats,\n\tstatSync,\n\tunlinkSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { join } from \"node:path\";\n\nconst SIDECAR_VERSION = 1;\nconst SIDECAR_STATE_FILE = \"sp-web-sidecar.json\";\nconst LEGACY_STATE_FILE = \"pi-web-sidecar.json\";\n// Keep one lock namespace while older SP launchers are still running.\nconst SIDECAR_LOCK_FILE = \"pi-web-sidecar.lock\";\n\nexport interface SpWebSidecarState {\n\tversion: 1;\n\tpid: number;\n\texecutable: string;\n\targs: string[];\n\tstartedAt: string;\n}\n\nexport interface SpWebLaunchResult {\n\tstatus: \"disabled\" | \"reused\" | \"launched\" | \"pending\" | \"failed\";\n\tpid?: number;\n\terror?: string;\n}\n\nexport interface SpWebLauncherOptions {\n\tenv?: NodeJS.ProcessEnv;\n\tspawnProcess?: (executable: string, args: readonly string[], options: SpawnOptions) => ChildProcess;\n\tisProcessRunning?: (pid: number) => boolean;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction readState(path: string): SpWebSidecarState | undefined {\n\ttry {\n\t\tconst value = JSON.parse(readFileSync(path, \"utf8\")) as unknown;\n\t\tif (\n\t\t\t!isRecord(value) ||\n\t\t\tvalue.version !== SIDECAR_VERSION ||\n\t\t\ttypeof value.pid !== \"number\" ||\n\t\t\t!Number.isSafeInteger(value.pid) ||\n\t\t\tvalue.pid <= 0 ||\n\t\t\ttypeof value.executable !== \"string\" ||\n\t\t\t!Array.isArray(value.args) ||\n\t\t\t!value.args.every((entry) => typeof entry === \"string\") ||\n\t\t\ttypeof value.startedAt !== \"string\"\n\t\t) {\n\t\t\treturn undefined;\n\t\t}\n\t\treturn {\n\t\t\tversion: SIDECAR_VERSION,\n\t\t\tpid: value.pid,\n\t\t\texecutable: value.executable,\n\t\t\targs: value.args,\n\t\t\tstartedAt: value.startedAt,\n\t\t};\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction processIsRunning(pid: number) {\n\ttry {\n\t\tprocess.kill(pid, 0);\n\t\treturn true;\n\t} catch (error) {\n\t\treturn isRecord(error) && error.code === \"EPERM\";\n\t}\n}\n\nfunction removeFile(path: string) {\n\ttry {\n\t\tunlinkSync(path);\n\t} catch (error) {\n\t\tif (!isRecord(error) || error.code !== \"ENOENT\") throw error;\n\t}\n}\n\nfunction writePrivateState(path: string, state: SpWebSidecarState) {\n\twriteFileSync(path, `${JSON.stringify(state, null, \"\\t\")}\\n`, {\n\t\tencoding: \"utf8\",\n\t\tmode: 0o600,\n\t});\n\tif (process.platform !== \"win32\") chmodSync(path, 0o600);\n}\n\nfunction parseArgs(env: NodeJS.ProcessEnv): string[] {\n\tconst raw = env.SP_WEB_ARGS_JSON ?? env.SP_PI_WEB_ARGS_JSON;\n\tif (!raw) return [];\n\tconst value = JSON.parse(raw) as unknown;\n\tif (!Array.isArray(value) || !value.every((entry) => typeof entry === \"string\")) {\n\t\tthrow new Error(\"SP_WEB_ARGS_JSON must be a JSON array of strings.\");\n\t}\n\treturn value;\n}\n\nfunction disabled(env: NodeJS.ProcessEnv) {\n\treturn /^(?:1|true|yes)$/iu.test(env.SP_WEB_DISABLE ?? env.SP_PI_WEB_DISABLE ?? \"\");\n}\n\nexport function resolveSpWebLaunch(\n\tenv: NodeJS.ProcessEnv,\n\truntime = { moduleUrl: import.meta.url, execPath: process.execPath, bun: !!process.versions.bun },\n): { executable: string; args: string[] } {\n\tconst args = parseArgs(env);\n\tif (!args.includes(\"--no-open\")) args.push(\"--no-open\");\n\tconst explicit = (env.SP_WEB_EXECUTABLE ?? env.SP_PI_WEB_EXECUTABLE)?.trim();\n\tif (explicit) return { executable: explicit, args };\n\n\t// The module anchor handles Node installs. The executable anchor also handles\n\t// compiled Bun binaries inside the npm package, whose module URL is virtual.\n\tfor (const anchor of [runtime.moduleUrl, runtime.execPath]) {\n\t\ttry {\n\t\t\tconst entry = createRequire(anchor).resolve(\"@senpiper/sp-web/bin/sp-web.js\");\n\t\t\treturn { executable: runtime.bun ? \"node\" : runtime.execPath, args: [entry, ...args] };\n\t\t} catch (error) {\n\t\t\tif (!isRecord(error) || error.code !== \"MODULE_NOT_FOUND\") throw error;\n\t\t}\n\t}\n\t// Standalone archives do not necessarily contain an npm dependency tree.\n\treturn { executable: \"sp-web\", args };\n}\n\nfunction lockIsStale(path: string, stat: (path: string) => Stats = statSync) {\n\ttry {\n\t\treturn Date.now() - stat(path).mtimeMs > 30_000;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nexport function ensureSpWebSidecar(discoveryDir: string, options: SpWebLauncherOptions = {}): SpWebLaunchResult {\n\tconst env = options.env ?? process.env;\n\tif (disabled(env)) return { status: \"disabled\" };\n\n\tconst statePath = join(discoveryDir, SIDECAR_STATE_FILE);\n\tconst legacyPath = join(discoveryDir, LEGACY_STATE_FILE);\n\tconst lockPath = join(discoveryDir, SIDECAR_LOCK_FILE);\n\tconst isRunning = options.isProcessRunning ?? processIsRunning;\n\tconst liveState = () => [readState(statePath), readState(legacyPath)].find((state) => state && isRunning(state.pid));\n\tconst current = liveState();\n\tif (current) return { status: \"reused\", pid: current.pid };\n\n\tlet lockFd: number | undefined;\n\tlet ownsLock = false;\n\ttry {\n\t\ttry {\n\t\t\tlockFd = openSync(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY, 0o600);\n\t\t\townsLock = true;\n\t\t\twriteFileSync(lockFd, `${process.pid}\\n`, \"utf8\");\n\t\t} catch (error) {\n\t\t\tif (!isRecord(error) || error.code !== \"EEXIST\") throw error;\n\t\t\tconst racedState = liveState();\n\t\t\tif (racedState) return { status: \"reused\", pid: racedState.pid };\n\t\t\tif (!lockIsStale(lockPath)) return { status: \"pending\" };\n\t\t\tremoveFile(lockPath);\n\t\t\tlockFd = openSync(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY, 0o600);\n\t\t\townsLock = true;\n\t\t\twriteFileSync(lockFd, `${process.pid}\\n`, \"utf8\");\n\t\t}\n\n\t\tconst racedState = liveState();\n\t\tif (racedState) return { status: \"reused\", pid: racedState.pid };\n\t\tconst { executable, args } = resolveSpWebLaunch(env);\n\t\tconst childEnv: NodeJS.ProcessEnv = {\n\t\t\t...env,\n\t\t\tSP_WEB_NO_OPEN: \"1\",\n\t\t\tSP_TERMINAL_BRIDGE_ONLY: \"1\",\n\t\t\tSP_TERMINAL_BRIDGE_DISCOVERY_DIR: discoveryDir,\n\t\t\tSP_TERMINAL_BRIDGE_PROTOCOL: \"sp-terminal-bridge-v1\",\n\t\t};\n\t\tconst spawnProcess =\n\t\t\toptions.spawnProcess ?? ((command, commandArgs, spawnOptions) => spawn(command, commandArgs, spawnOptions));\n\t\tconst child = spawnProcess(executable, args, {\n\t\t\tdetached: true,\n\t\t\tstdio: \"ignore\",\n\t\t\tshell: false,\n\t\t\tenv: childEnv,\n\t\t});\n\t\tchild.once(\"error\", () => {});\n\t\tif (child.pid === undefined) {\n\t\t\treturn {\n\t\t\t\tstatus: \"failed\",\n\t\t\t\terror: `Could not start SP Web with ${executable}. Install Node and the bundled @senpiper/sp-web package, or set SP_WEB_EXECUTABLE to an installed sp-web executable.`,\n\t\t\t};\n\t\t}\n\t\tconst state: SpWebSidecarState = {\n\t\t\tversion: SIDECAR_VERSION,\n\t\t\tpid: child.pid,\n\t\t\texecutable,\n\t\t\targs,\n\t\t\tstartedAt: new Date().toISOString(),\n\t\t};\n\t\twritePrivateState(statePath, state);\n\t\t// Older cooperating launchers must see the new process too.\n\t\twritePrivateState(legacyPath, state);\n\t\tchild.unref();\n\t\treturn { status: \"launched\", pid: child.pid };\n\t} catch (error) {\n\t\treturn { status: \"failed\", error: error instanceof Error ? error.message : String(error) };\n\t} finally {\n\t\tif (lockFd !== undefined) closeSync(lockFd);\n\t\tif (ownsLock) removeFile(lockPath);\n\t}\n}\n\nexport function getSpWebSidecarStatePath(discoveryDir: string) {\n\treturn join(discoveryDir, SIDECAR_STATE_FILE);\n}\n"]}

package/node_modules/@senpiper/sp-agent-extensions/dist/startup-header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"startup-header.d.ts","sourceRoot":"","sources":["../src/startup-header.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAYrF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,gBAAgB,UAAQ,YAyB5G;AAED,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,cAAc,sBAEpE;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,QAWvD","sourcesContent":["import type { ExtensionAPI, StartupMessage, Theme } from \"@senpiper/pi-coding-agent\";\nimport { truncateToWidth } from \"@senpiper/pi-coding-agent/runtime-deps\";\nimport { readSpGatewayState } from \"./gateway.ts\";\n\nconst LLM_IN_A_BOX_BANNER = [\n\t\" _     _     __  __   ___ _   _      _      ____   ___  __  __\",\n\t\"| |   | |   |  \\\\/  | |_ _| \\\\ | |    / \\\\    | __ ) / _ \\\\ \\\\ \\\\/ /\",\n\t\"| |   | |   | |\\\\/| |  | ||  \\\\| |   / _ \\\\   |  _ \\\\| | | | \\\\  /\",\n\t\"| |___| |___| |  | |  | || |\\\\  |  / ___ \\\\  | |_) | |_| | /  \\\\ \",\n\t\"|_____|_____|_|  |_| |___|_| \\\\_| /_/   \\\\_\\\\ |____/ \\\\___/ /_/\\\\_\\\\\",\n];\n\nexport function renderSpStartupHeader(theme: Theme, width: number, modelId?: string, gatewayConnected = false) {\n\tconst availableWidth = Math.max(1, width);\n\tconst truncateLine = (line: string) => truncateToWidth(line, availableWidth);\n\tconst status = `sp-gateway: ${gatewayConnected ? \"connected\" : \"not configured\"} · model: ${modelId ?? \"not selected\"}`;\n\tconst loginPrompt = gatewayConnected\n\t\t? []\n\t\t: [truncateLine(theme.bold(theme.fg(\"warning\", \"Not logged in. Run /login to continue.\")))];\n\tconst commands = \"/login · /model · /onboarding · /btw\";\n\n\tif (availableWidth < 68) {\n\t\treturn [\n\t\t\ttruncateLine(theme.bold(theme.fg(\"accent\", \"LLM IN A BOX\")) + theme.fg(\"dim\", \" · powered by Senpiper\")),\n\t\t\ttruncateLine(theme.fg(\"muted\", status)),\n\t\t\t...loginPrompt,\n\t\t\ttruncateLine(theme.fg(\"dim\", commands)),\n\t\t];\n\t}\n\n\treturn [\n\t\t...LLM_IN_A_BOX_BANNER.map((line) => truncateLine(theme.bold(theme.fg(\"accent\", line)))),\n\t\ttruncateLine(theme.fg(\"dim\", \"powered by Senpiper\")),\n\t\ttruncateLine(theme.fg(\"muted\", status)),\n\t\t...loginPrompt,\n\t\ttruncateLine(theme.fg(\"dim\", commands)),\n\t];\n}\n\nexport function filterSpStartupMessage(startupMessage: StartupMessage) {\n\treturn startupMessage.type === \"no-model\" ? undefined : startupMessage.message;\n}\n\nexport function registerSpStartupHeader(pi: ExtensionAPI) {\n\tpi.registerStartupMessageFilter(filterSpStartupMessage);\n\tpi.on(\"session_start\", async (_event, context) => {\n\t\tif (context.mode !== \"tui\") return;\n\t\tcontext.ui.setHeader((_tui, theme) => ({\n\t\t\trender(width) {\n\t\t\t\treturn renderSpStartupHeader(theme, width, context.model?.id, readSpGatewayState() !== undefined);\n\t\t\t},\n\t\t\tinvalidate() {},\n\t\t}));\n\t});\n}\n"]}
+{"version":3,"file":"startup-header.d.ts","sourceRoot":"","sources":["../src/startup-header.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAYrF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,gBAAgB,UAAQ,YAyB5G;AAED,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,cAAc,sBAEpE;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,QAWvD","sourcesContent":["import type { ExtensionAPI, StartupMessage, Theme } from \"@senpiper/pi-coding-agent\";\nimport { truncateToWidth } from \"@senpiper/pi-coding-agent/runtime-deps\";\nimport { readSpGatewayState } from \"./gateway.ts\";\n\nconst LLM_IN_A_BOX_BANNER = [\n\t\" _     _     __  __   ___ _   _      _      ____   ___  __  __\",\n\t\"| |   | |   |  \\\\/  | |_ _| \\\\ | |    / \\\\    | __ ) / _ \\\\ \\\\ \\\\/ /\",\n\t\"| |   | |   | |\\\\/| |  | ||  \\\\| |   / _ \\\\   |  _ \\\\| | | | \\\\  /\",\n\t\"| |___| |___| |  | |  | || |\\\\  |  / ___ \\\\  | |_) | |_| | /  \\\\ \",\n\t\"|_____|_____|_|  |_| |___|_| \\\\_| /_/   \\\\_\\\\ |____/ \\\\___/ /_/\\\\_\\\\\",\n];\n\nexport function renderSpStartupHeader(theme: Theme, width: number, modelId?: string, gatewayConnected = false) {\n\tconst availableWidth = Math.max(1, width);\n\tconst truncateLine = (line: string) => truncateToWidth(line, availableWidth);\n\tconst status = `sp-gateway: ${gatewayConnected ? \"connected\" : \"not configured\"} · model: ${modelId ?? \"not selected\"}`;\n\tconst loginPrompt = gatewayConnected\n\t\t? []\n\t\t: [truncateLine(theme.bold(theme.fg(\"warning\", \"Not logged in. Run /login to continue.\")))];\n\tconst commands = \"/login · /model · /onboarding\";\n\n\tif (availableWidth < 68) {\n\t\treturn [\n\t\t\ttruncateLine(theme.bold(theme.fg(\"accent\", \"LLM IN A BOX\")) + theme.fg(\"dim\", \" · powered by Senpiper\")),\n\t\t\ttruncateLine(theme.fg(\"muted\", status)),\n\t\t\t...loginPrompt,\n\t\t\ttruncateLine(theme.fg(\"dim\", commands)),\n\t\t];\n\t}\n\n\treturn [\n\t\t...LLM_IN_A_BOX_BANNER.map((line) => truncateLine(theme.bold(theme.fg(\"accent\", line)))),\n\t\ttruncateLine(theme.fg(\"dim\", \"powered by Senpiper\")),\n\t\ttruncateLine(theme.fg(\"muted\", status)),\n\t\t...loginPrompt,\n\t\ttruncateLine(theme.fg(\"dim\", commands)),\n\t];\n}\n\nexport function filterSpStartupMessage(startupMessage: StartupMessage) {\n\treturn startupMessage.type === \"no-model\" ? undefined : startupMessage.message;\n}\n\nexport function registerSpStartupHeader(pi: ExtensionAPI) {\n\tpi.registerStartupMessageFilter(filterSpStartupMessage);\n\tpi.on(\"session_start\", async (_event, context) => {\n\t\tif (context.mode !== \"tui\") return;\n\t\tcontext.ui.setHeader((_tui, theme) => ({\n\t\t\trender(width) {\n\t\t\t\treturn renderSpStartupHeader(theme, width, context.model?.id, readSpGatewayState() !== undefined);\n\t\t\t},\n\t\t\tinvalidate() {},\n\t\t}));\n\t});\n}\n"]}

package/node_modules/@senpiper/sp-agent-extensions/dist/startup-header.js

@@ -14,7 +14,7 @@ export function renderSpStartupHeader(theme, width, modelId, gatewayConnected =
     const loginPrompt = gatewayConnected
         ? []
         : [truncateLine(theme.bold(theme.fg("warning", "Not logged in. Run /login to continue.")))];
-    const commands = "/login · /model · /onboarding · /btw";
+    const commands = "/login · /model · /onboarding";
     if (availableWidth < 68) {
         return [
             truncateLine(theme.bold(theme.fg("accent", "LLM IN A BOX")) + theme.fg("dim", " · powered by Senpiper")),

package/node_modules/@senpiper/sp-agent-extensions/dist/startup-header.js.map

@@ -1 +1 @@
-{"version":3,"file":"startup-header.js","sourceRoot":"","sources":["../src/startup-header.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExtensionAPI, StartupMessage, Theme } from \"@senpiper/pi-coding-agent\";\nimport { truncateToWidth } from \"@senpiper/pi-coding-agent/runtime-deps\";\nimport { readSpGatewayState } from \"./gateway.ts\";\n\nconst LLM_IN_A_BOX_BANNER = [\n\t\" _     _     __  __   ___ _   _      _      ____   ___  __  __\",\n\t\"| |   | |   |  \\\\/  | |_ _| \\\\ | |    / \\\\    | __ ) / _ \\\\ \\\\ \\\\/ /\",\n\t\"| |   | |   | |\\\\/| |  | ||  \\\\| |   / _ \\\\   |  _ \\\\| | | | \\\\  /\",\n\t\"| |___| |___| |  | |  | || |\\\\  |  / ___ \\\\  | |_) | |_| | /  \\\\ \",\n\t\"|_____|_____|_|  |_| |___|_| \\\\_| /_/   \\\\_\\\\ |____/ \\\\___/ /_/\\\\_\\\\\",\n];\n\nexport function renderSpStartupHeader(theme: Theme, width: number, modelId?: string, gatewayConnected = false) {\n\tconst availableWidth = Math.max(1, width);\n\tconst truncateLine = (line: string) => truncateToWidth(line, availableWidth);\n\tconst status = `sp-gateway: ${gatewayConnected ? \"connected\" : \"not configured\"} · model: ${modelId ?? \"not selected\"}`;\n\tconst loginPrompt = gatewayConnected\n\t\t? []\n\t\t: [truncateLine(theme.bold(theme.fg(\"warning\", \"Not logged in. Run /login to continue.\")))];\n\tconst commands = \"/login · /model · /onboarding · /btw\";\n\n\tif (availableWidth < 68) {\n\t\treturn [\n\t\t\ttruncateLine(theme.bold(theme.fg(\"accent\", \"LLM IN A BOX\")) + theme.fg(\"dim\", \" · powered by Senpiper\")),\n\t\t\ttruncateLine(theme.fg(\"muted\", status)),\n\t\t\t...loginPrompt,\n\t\t\ttruncateLine(theme.fg(\"dim\", commands)),\n\t\t];\n\t}\n\n\treturn [\n\t\t...LLM_IN_A_BOX_BANNER.map((line) => truncateLine(theme.bold(theme.fg(\"accent\", line)))),\n\t\ttruncateLine(theme.fg(\"dim\", \"powered by Senpiper\")),\n\t\ttruncateLine(theme.fg(\"muted\", status)),\n\t\t...loginPrompt,\n\t\ttruncateLine(theme.fg(\"dim\", commands)),\n\t];\n}\n\nexport function filterSpStartupMessage(startupMessage: StartupMessage) {\n\treturn startupMessage.type === \"no-model\" ? undefined : startupMessage.message;\n}\n\nexport function registerSpStartupHeader(pi: ExtensionAPI) {\n\tpi.registerStartupMessageFilter(filterSpStartupMessage);\n\tpi.on(\"session_start\", async (_event, context) => {\n\t\tif (context.mode !== \"tui\") return;\n\t\tcontext.ui.setHeader((_tui, theme) => ({\n\t\t\trender(width) {\n\t\t\t\treturn renderSpStartupHeader(theme, width, context.model?.id, readSpGatewayState() !== undefined);\n\t\t\t},\n\t\t\tinvalidate() {},\n\t\t}));\n\t});\n}\n"]}
+{"version":3,"file":"startup-header.js","sourceRoot":"","sources":["../src/startup-header.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,mBAAmB,GAAG;IAC3B,gEAAgE;IAChE,sEAAsE;IACtE,oEAAoE;IACpE,mEAAmE;IACnE,sEAAsE;CACtE,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,KAAY,EAAE,KAAa,EAAE,OAAgB,EAAE,gBAAgB,GAAG,KAAK,EAAE;IAC9G,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,eAAe,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,cAAa,OAAO,IAAI,cAAc,EAAE,CAAC;IACxH,MAAM,WAAW,GAAG,gBAAgB;QACnC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,wCAAwC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,MAAM,QAAQ,GAAG,iCAA+B,CAAC;IAEjD,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;QACzB,OAAO;YACN,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAwB,CAAC,CAAC;YACxG,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,GAAG,WAAW;YACd,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;SACvC,CAAC;IACH,CAAC;IAED,OAAO;QACN,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACxF,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;QACpD,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvC,GAAG,WAAW;QACd,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;KACvC,CAAC;AAAA,CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,cAA8B,EAAE;IACtE,OAAO,cAAc,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC;AAAA,CAC/E;AAED,MAAM,UAAU,uBAAuB,CAAC,EAAgB,EAAE;IACzD,EAAE,CAAC,4BAA4B,CAAC,sBAAsB,CAAC,CAAC;IACxD,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO;QACnC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACtC,MAAM,CAAC,KAAK,EAAE;gBACb,OAAO,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,SAAS,CAAC,CAAC;YAAA,CAClG;YACD,UAAU,GAAG,EAAC,CAAC;SACf,CAAC,CAAC,CAAC;IAAA,CACJ,CAAC,CAAC;AAAA,CACH","sourcesContent":["import type { ExtensionAPI, StartupMessage, Theme } from \"@senpiper/pi-coding-agent\";\nimport { truncateToWidth } from \"@senpiper/pi-coding-agent/runtime-deps\";\nimport { readSpGatewayState } from \"./gateway.ts\";\n\nconst LLM_IN_A_BOX_BANNER = [\n\t\" _     _     __  __   ___ _   _      _      ____   ___  __  __\",\n\t\"| |   | |   |  \\\\/  | |_ _| \\\\ | |    / \\\\    | __ ) / _ \\\\ \\\\ \\\\/ /\",\n\t\"| |   | |   | |\\\\/| |  | ||  \\\\| |   / _ \\\\   |  _ \\\\| | | | \\\\  /\",\n\t\"| |___| |___| |  | |  | || |\\\\  |  / ___ \\\\  | |_) | |_| | /  \\\\ \",\n\t\"|_____|_____|_|  |_| |___|_| \\\\_| /_/   \\\\_\\\\ |____/ \\\\___/ /_/\\\\_\\\\\",\n];\n\nexport function renderSpStartupHeader(theme: Theme, width: number, modelId?: string, gatewayConnected = false) {\n\tconst availableWidth = Math.max(1, width);\n\tconst truncateLine = (line: string) => truncateToWidth(line, availableWidth);\n\tconst status = `sp-gateway: ${gatewayConnected ? \"connected\" : \"not configured\"} · model: ${modelId ?? \"not selected\"}`;\n\tconst loginPrompt = gatewayConnected\n\t\t? []\n\t\t: [truncateLine(theme.bold(theme.fg(\"warning\", \"Not logged in. Run /login to continue.\")))];\n\tconst commands = \"/login · /model · /onboarding\";\n\n\tif (availableWidth < 68) {\n\t\treturn [\n\t\t\ttruncateLine(theme.bold(theme.fg(\"accent\", \"LLM IN A BOX\")) + theme.fg(\"dim\", \" · powered by Senpiper\")),\n\t\t\ttruncateLine(theme.fg(\"muted\", status)),\n\t\t\t...loginPrompt,\n\t\t\ttruncateLine(theme.fg(\"dim\", commands)),\n\t\t];\n\t}\n\n\treturn [\n\t\t...LLM_IN_A_BOX_BANNER.map((line) => truncateLine(theme.bold(theme.fg(\"accent\", line)))),\n\t\ttruncateLine(theme.fg(\"dim\", \"powered by Senpiper\")),\n\t\ttruncateLine(theme.fg(\"muted\", status)),\n\t\t...loginPrompt,\n\t\ttruncateLine(theme.fg(\"dim\", commands)),\n\t];\n}\n\nexport function filterSpStartupMessage(startupMessage: StartupMessage) {\n\treturn startupMessage.type === \"no-model\" ? undefined : startupMessage.message;\n}\n\nexport function registerSpStartupHeader(pi: ExtensionAPI) {\n\tpi.registerStartupMessageFilter(filterSpStartupMessage);\n\tpi.on(\"session_start\", async (_event, context) => {\n\t\tif (context.mode !== \"tui\") return;\n\t\tcontext.ui.setHeader((_tui, theme) => ({\n\t\t\trender(width) {\n\t\t\t\treturn renderSpStartupHeader(theme, width, context.model?.id, readSpGatewayState() !== undefined);\n\t\t\t},\n\t\t\tinvalidate() {},\n\t\t}));\n\t});\n}\n"]}

package/node_modules/@senpiper/sp-agent-extensions/dist/terminal-web-bridge.d.ts

@@ -1,10 +1,16 @@
 import type { ExtensionAPI, ExtensionContext } from "@senpiper/pi-coding-agent";
-import { type PiWebLauncherOptions, type PiWebLaunchResult } from "./pi-web-launcher.ts";
+import { type SpWebLauncherOptions, type SpWebLaunchResult } from "./sp-web-launcher.ts";
 export declare const TERMINAL_BRIDGE_PROTOCOL = "sp-terminal-bridge-v1";
 export declare const TERMINAL_BRIDGE_VERSION = 1;
 export declare const DEFAULT_TERMINAL_BRIDGE_MAX_FRAME_BYTES: number;
 export declare const DEFAULT_TERMINAL_BRIDGE_MAX_BUFFERED_BYTES: number;
 export declare const DEFAULT_TERMINAL_BRIDGE_MAX_CLIENTS = 8;
+export declare const TERMINAL_BRIDGE_IMAGE_LIMITS: {
+    readonly mimeTypes: readonly ["image/png", "image/jpeg", "image/webp", "image/gif"];
+    readonly maxImages: 8;
+    readonly maxBase64BytesPerImage: number;
+    readonly maxBase64BytesTotal: number;
+};
 export interface TerminalBridgeDescriptor {
     version: 1;
     protocol: typeof TERMINAL_BRIDGE_PROTOCOL;
@@ -17,19 +23,44 @@ export interface TerminalBridgeDescriptor {
     authToken: string;
     generation: number;
     startedAt: string;
+    writerLeaseVersion?: 1;
     frame: {
         encoding: "newline-delimited-json";
         maxBytes: number;
     };
 }
 export interface TerminalWebBridgeOptions {
+    /** Set only by a distribution that installed the lifetime writer provider before file opening. */
+    writerLeaseVersion?: 1;
+    /** Supplied by the verified SP distribution, shared across terminal replacements. */
+    sessions?: {
+        create(cwd: string): Promise<{
+            sessionId: string;
+        }>;
+        resume(sessionFile: string): Promise<{
+            sessionId: string;
+        }>;
+        deleteSession?(request: {
+            sessionId: string;
+            sessionFile?: string;
+            confirmed: true;
+        }, requester?: TerminalWebBridge): Promise<{
+            sessionId: string;
+            deleted: true;
+        }>;
+        terminalStarted(context: ExtensionContext): void;
+        bridgeStopped?(bridge: TerminalWebBridge): void;
+        dispose(): Promise<void>;
+    };
+    webOwned?: boolean;
+    onReady?: (bridge: TerminalWebBridge) => void;
     agentDir?: string;
     maxFrameBytes?: number;
     maxBufferedBytes?: number;
     maxClients?: number;
-    launchPiWeb?: boolean;
-    launcherOptions?: PiWebLauncherOptions;
-    titleGenerator?: (context: ExtensionContext, pi: ExtensionAPI) => Promise<unknown>;
+    launchSpWeb?: boolean;
+    launcherOptions?: SpWebLauncherOptions;
+    titleGenerator?: (context: ExtensionContext, pi: ExtensionAPI, signal: AbortSignal) => Promise<unknown>;
 }
 interface EventFrame {
     v: 1;
@@ -37,10 +68,17 @@ interface EventFrame {
     generation: number;
     sequence: number;
     event: string;
-    category: "message" | "agent" | "tool" | "model" | "thinking" | "session";
+    category: "message" | "agent" | "tool" | "model" | "thinking" | "session" | "interaction";
     payload: unknown;
 }
 export declare class TerminalWebBridge {
+    private pendingCommands;
+    private deleting;
+    private readonly requestContext;
+    private deletionOwner;
+    /** Gate new commands synchronously before the owner checks/disposes its idle writer. */
+    reserveDeletion(preserveConnection: boolean): () => void;
+    finishDeletion(): Promise<void>;
     private readonly pi;
     private readonly options;
     private readonly instanceId;
@@ -48,6 +86,8 @@ export declare class TerminalWebBridge {
     private readonly startedAt;
     private readonly clients;
     private readonly eventHistory;
+    private eventHistoryBytes;
+    private lastUnreplayableSequence;
     private readonly maxFrameBytes;
     private readonly maxBufferedBytes;
     private readonly maxClients;
@@ -58,17 +98,25 @@ export declare class TerminalWebBridge {
     private generation;
     private sequence;
     private commandQueue;
+    private lifecycleQueue;
+    private binding;
     private sidecarResult;
+    private readonly questions;
+    private unsubscribeQuestions;
     constructor(pi: ExtensionAPI, options?: TerminalWebBridgeOptions);
     getDescriptor(): TerminalBridgeDescriptor | undefined;
-    getSidecarResult(): PiWebLaunchResult | undefined;
+    getSidecarResult(): SpWebLaunchResult | undefined;
     start(context: ExtensionContext): Promise<void>;
+    private startServer;
     updateContext(context: ExtensionContext): void;
     advanceGeneration(context: ExtensionContext): void;
     publish(category: EventFrame["category"], event: {
         type: string;
     }, context: ExtensionContext): void;
     stop(): Promise<void>;
+    /** Synchronous fallback for process.exit, which cannot await socket shutdown. */
+    cleanupOnExit(): void;
+    private stopServer;
     private acceptClient;
     private receive;
     private authenticate;
@@ -77,10 +125,12 @@ export declare class TerminalWebBridge {
     private stateSnapshot;
     private transcriptPage;
     private sendRequestError;
+    private successFrame;
     private sendSuccess;
     private encode;
     private send;
     private writeEncoded;
+    private writeReplay;
 }
 export declare function registerTerminalWebBridge(pi: ExtensionAPI, options?: TerminalWebBridgeOptions): TerminalWebBridge;
 export declare function readTerminalBridgeDescriptor(path: string): TerminalBridgeDescriptor;

package/node_modules/@senpiper/sp-agent-extensions/dist/terminal-web-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-web-bridge.d.ts","sourceRoot":"","sources":["../src/terminal-web-bridge.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomBytes, randomUUID, timingSafeEqual } from \"node:crypto\";\nimport { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from \"node:fs\";\nimport { createServer, type Server, type Socket } from \"node:net\";\nimport { join } from \"node:path\";\nimport type { ExtensionAPI, ExtensionContext } from \"@senpiper/pi-coding-agent\";\nimport { completeSimple } from \"@senpiper/pi-coding-agent/runtime-deps\";\nimport { getSpAgentDir } from \"./gateway.ts\";\nimport { ensurePiWebSidecar, type PiWebLauncherOptions, type PiWebLaunchResult } from \"./pi-web-launcher.ts\";\n\nexport const TERMINAL_BRIDGE_PROTOCOL = \"sp-terminal-bridge-v1\";\nexport const TERMINAL_BRIDGE_VERSION = 1;\nexport const DEFAULT_TERMINAL_BRIDGE_MAX_FRAME_BYTES = 1024 * 1024;\nexport const DEFAULT_TERMINAL_BRIDGE_MAX_BUFFERED_BYTES = 1024 * 1024;\nexport const DEFAULT_TERMINAL_BRIDGE_MAX_CLIENTS = 8;\n\nconst MAX_REQUEST_ID_LENGTH = 128;\nconst MAX_PENDING_REQUESTS = 32;\nconst MAX_SEEN_REQUEST_IDS = 1024;\nconst MAX_EVENT_HISTORY = 256;\nconst MAX_TRANSCRIPT_PAGE_SIZE = 100;\nconst MAX_TITLE_CONTEXT_BYTES = 32 * 1024;\nconst MAX_TITLE_LENGTH = 80;\nconst THINKING_LEVELS = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\", \"max\"] as const;\n\ntype ThinkingLevel = (typeof THINKING_LEVELS)[number];\ntype JsonRecord = Record<string, unknown>;\n\nexport interface TerminalBridgeDescriptor {\n\tversion: 1;\n\tprotocol: typeof TERMINAL_BRIDGE_PROTOCOL;\n\tinstanceId: string;\n\tpid: number;\n\tsessionId: string;\n\tsessionFile?: string;\n\tcwd: string;\n\tsocketPath: string;\n\tauthToken: string;\n\tgeneration: number;\n\tstartedAt: string;\n\tframe: {\n\t\tencoding: \"newline-delimited-json\";\n\t\tmaxBytes: number;\n\t};\n}\n\nexport interface TerminalWebBridgeOptions {\n\tagentDir?: string;\n\tmaxFrameBytes?: number;\n\tmaxBufferedBytes?: number;\n\tmaxClients?: number;\n\tlaunchPiWeb?: boolean;\n\tlauncherOptions?: PiWebLauncherOptions;\n\ttitleGenerator?: (context: ExtensionContext, pi: ExtensionAPI) => Promise<unknown>;\n}\n\ninterface BridgePaths {\n\trootDir: string;\n\tdiscoveryDir: string;\n\tsocketDir: string;\n\tdescriptorPath: string;\n\tsocketPath: string;\n}\n\ninterface ClientState {\n\tsocket: Socket;\n\tbuffer: Buffer;\n\tauthenticated: boolean;\n\tsubscribed: boolean;\n\tpendingRequests: number;\n\tseenRequestIds: Set<string>;\n}\n\ninterface RequestFrame {\n\tv: 1;\n\ttype: \"request\";\n\tid: string;\n\tgeneration: number;\n\tcommand: string;\n\tparams?: JsonRecord;\n}\n\ninterface EventFrame {\n\tv: 1;\n\ttype: \"event\";\n\tgeneration: number;\n\tsequence: number;\n\tevent: string;\n\tcategory: \"message\" | \"agent\" | \"tool\" | \"model\" | \"thinking\" | \"session\";\n\tpayload: unknown;\n}\n\nclass RequestError extends Error {\n\treadonly code: string;\n\n\tconstructor(code: string, message: string) {\n\t\tsuper(message);\n\t\tthis.code = code;\n\t}\n}\n\nfunction isRecord(value: unknown): value is JsonRecord {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isMissingFileError(error: unknown) {\n\treturn isRecord(error) && error.code === \"ENOENT\";\n}\n\nfunction requireString(value: unknown, name: string, maximumLength = 100_000) {\n\tif (typeof value !== \"string\" || !value.trim()) throw new RequestError(\"invalid_params\", `${name} is required.`);\n\tif (Buffer.byteLength(value, \"utf8\") > maximumLength) {\n\t\tthrow new RequestError(\"invalid_params\", `${name} is too long.`);\n\t}\n\treturn value;\n}\n\nfunction optionalInteger(value: unknown, name: string, fallback: number) {\n\tif (value === undefined) return fallback;\n\tif (!Number.isSafeInteger(value) || (value as number) < 0) {\n\t\tthrow new RequestError(\"invalid_params\", `${name} must be a non-negative integer.`);\n\t}\n\treturn value as number;\n}\n\nfunction normalizeForJson(value: unknown): unknown {\n\treturn JSON.parse(\n\t\tJSON.stringify(value, (_key, entry: unknown) => {\n\t\t\tif (typeof entry === \"bigint\") return entry.toString();\n\t\t\tif (entry instanceof Error) return { name: entry.name, message: entry.message };\n\t\t\treturn entry;\n\t\t}),\n\t) as unknown;\n}\n\nfunction availableModels(context: ExtensionContext) {\n\tconst scoped = context.scopedModels.map((entry) => entry.model);\n\tconst models = scoped.length > 0 ? scoped : context.modelRegistry.getAvailable();\n\treturn models.filter((model) => model.provider === \"sp-gateway\").map((model) => ({\n\t\tprovider: model.provider,\n\t\tid: model.id,\n\t\tname: model.name,\n\t\treasoning: model.reasoning,\n\t\tcontextWindow: model.contextWindow,\n\t\tmaxTokens: model.maxTokens,\n\t\t...(model.thinkingLevelMap ? { thinkingLevelMap: model.thinkingLevelMap } : {}),\n\t\t}));\n}\n\nfunction parseGeneratedTitle(raw: string) {\n\tlet title = raw.trim().split(/\\r?\\n/u, 1)[0] ?? \"\";\n\ttitle = title.replace(/^(?:session\\s+title|title)\\s*[:-]\\s*/iu, \"\");\n\ttitle = title\n\t\t.replace(/^[\"'`]|[\"'`]$/gu, \"\")\n\t\t.replace(/\\s+/gu, \" \")\n\t\t.replace(/[.!]+$/u, \"\")\n\t\t.trim();\n\tif (!/[\\p{L}\\p{N}]/u.test(title))\n\t\tthrow new RequestError(\"title_generation_failed\", \"The model returned no usable title.\");\n\treturn Array.from(title).slice(0, MAX_TITLE_LENGTH).join(\"\").trim();\n}\n\nasync function generateTitle(context: ExtensionContext, pi: ExtensionAPI) {\n\tif (!context.isIdle()) throw new RequestError(\"busy\", \"A title can only be generated while the agent is idle.\");\n\tconst activeModel = context.model;\n\tif (!activeModel || activeModel.provider !== \"sp-gateway\") {\n\t\tthrow new RequestError(\"model_unavailable\", \"Title generation requires an active sp-gateway model.\");\n\t}\n\tconst model = context.modelRegistry.find(activeModel.provider, activeModel.id);\n\tif (!model) throw new RequestError(\"model_unavailable\", \"The active sp-gateway model is unavailable.\");\n\tconst auth = await context.modelRegistry.getApiKeyAndHeaders(model);\n\tif (!auth.ok || !auth.apiKey) {\n\t\tthrow new RequestError(\"model_auth_unavailable\", auth.ok ? \"sp-gateway has no API key available.\" : auth.error);\n\t}\n\tconst serialized = Buffer.from(JSON.stringify(normalizeForJson(context.sessionManager.getEntries())), \"utf8\");\n\tconst transcript =\n\t\tserialized.length <= MAX_TITLE_CONTEXT_BYTES\n\t\t\t? serialized.toString(\"utf8\")\n\t\t\t: serialized.subarray(-MAX_TITLE_CONTEXT_BYTES).toString(\"utf8\");\n\tconst response = await completeSimple(\n\t\tmodel,\n\t\t{\n\t\t\tsystemPrompt: [\n\t\t\t\t\"Create a concise English title for this coding session.\",\n\t\t\t\t\"Use 4-12 words. Describe the concrete task or result.\",\n\t\t\t\t\"Return only the title as plain text. Do not use tools, quotes, labels, or punctuation at the end.\",\n\t\t\t].join(\"\\n\"),\n\t\t\tmessages: [\n\t\t\t\t{\n\t\t\t\t\trole: \"user\",\n\t\t\t\t\tcontent: `Session transcript entries:\\n${transcript}`,\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t},\n\t\t\t],\n\t\t\ttools: [],\n\t\t},\n\t\t{ apiKey: auth.apiKey, headers: auth.headers, env: auth.env },\n\t);\n\tif (response.stopReason === \"error\") {\n\t\tthrow new RequestError(\"title_generation_failed\", response.errorMessage ?? \"The title model request failed.\");\n\t}\n\tconst rawTitle = response.content\n\t\t.filter((part): part is { type: \"text\"; text: string } => part.type === \"text\")\n\t\t.map((part) => part.text)\n\t\t.join(\"\\n\");\n\tconst title = parseGeneratedTitle(rawTitle);\n\tpi.setSessionName(title);\n\treturn {\n\t\ttitle,\n\t\tusage: {\n\t\t\tinput: response.usage.input,\n\t\t\toutput: response.usage.output,\n\t\t\tcacheRead: response.usage.cacheRead,\n\t\t\tcacheWrite: response.usage.cacheWrite,\n\t\t\ttotal: response.usage.totalTokens,\n\t\t},\n\t};\n}\n\nfunction makePaths(agentDir: string, instanceId: string): BridgePaths {\n\tconst rootDir = join(agentDir, \"web-bridge\");\n\tconst discoveryDir = join(rootDir, \"discovery\");\n\tconst socketDir = join(rootDir, \"sockets\");\n\treturn {\n\t\trootDir,\n\t\tdiscoveryDir,\n\t\tsocketDir,\n\t\tdescriptorPath: join(discoveryDir, `${instanceId}.json`),\n\t\tsocketPath: join(socketDir, `${instanceId}.sock`),\n\t};\n}\n\nfunction ensurePrivateDirectory(path: string) {\n\tmkdirSync(path, { recursive: true, mode: 0o700 });\n\tif (process.platform !== \"win32\") chmodSync(path, 0o700);\n}\n\nfunction removeFile(path: string) {\n\ttry {\n\t\tunlinkSync(path);\n\t} catch (error) {\n\t\tif (!isMissingFileError(error)) throw error;\n\t}\n}\n\nfunction tokenMatches(expected: string, received: unknown) {\n\tif (typeof received !== \"string\") return false;\n\tconst expectedBytes = Buffer.from(expected, \"utf8\");\n\tconst receivedBytes = Buffer.from(received, \"utf8\");\n\treturn expectedBytes.length === receivedBytes.length && timingSafeEqual(expectedBytes, receivedBytes);\n}\n\nfunction parseRequest(value: JsonRecord): RequestFrame {\n\tif (\n\t\tvalue.v !== TERMINAL_BRIDGE_VERSION ||\n\t\tvalue.type !== \"request\" ||\n\t\ttypeof value.id !== \"string\" ||\n\t\t!value.id ||\n\t\tvalue.id.length > MAX_REQUEST_ID_LENGTH ||\n\t\t!Number.isSafeInteger(value.generation) ||\n\t\ttypeof value.command !== \"string\" ||\n\t\t!value.command\n\t) {\n\t\tthrow new RequestError(\"invalid_request\", \"Invalid request envelope.\");\n\t}\n\tif (value.params !== undefined && !isRecord(value.params)) {\n\t\tthrow new RequestError(\"invalid_request\", \"params must be an object.\");\n\t}\n\treturn {\n\t\tv: TERMINAL_BRIDGE_VERSION,\n\t\ttype: \"request\",\n\t\tid: value.id,\n\t\tgeneration: value.generation as number,\n\t\tcommand: value.command,\n\t\tparams: value.params,\n\t};\n}\n\nexport class TerminalWebBridge {\n\tprivate readonly pi: ExtensionAPI;\n\tprivate readonly options: TerminalWebBridgeOptions;\n\tprivate readonly instanceId = randomUUID().replaceAll(\"-\", \"\").slice(0, 24);\n\tprivate readonly authToken = randomBytes(32).toString(\"base64url\");\n\tprivate readonly startedAt = new Date().toISOString();\n\tprivate readonly clients = new Set<ClientState>();\n\tprivate readonly eventHistory: EventFrame[] = [];\n\tprivate readonly maxFrameBytes: number;\n\tprivate readonly maxBufferedBytes: number;\n\tprivate readonly maxClients: number;\n\tprivate server: Server | undefined;\n\tprivate context: ExtensionContext | undefined;\n\tprivate paths: BridgePaths | undefined;\n\tprivate descriptor: TerminalBridgeDescriptor | undefined;\n\tprivate generation = 0;\n\tprivate sequence = 0;\n\tprivate commandQueue: Promise<void> = Promise.resolve();\n\tprivate sidecarResult: PiWebLaunchResult | undefined;\n\n\tconstructor(pi: ExtensionAPI, options: TerminalWebBridgeOptions = {}) {\n\t\tthis.pi = pi;\n\t\tthis.options = options;\n\t\tthis.maxFrameBytes = options.maxFrameBytes ?? DEFAULT_TERMINAL_BRIDGE_MAX_FRAME_BYTES;\n\t\tthis.maxBufferedBytes = options.maxBufferedBytes ?? DEFAULT_TERMINAL_BRIDGE_MAX_BUFFERED_BYTES;\n\t\tthis.maxClients = options.maxClients ?? DEFAULT_TERMINAL_BRIDGE_MAX_CLIENTS;\n\t}\n\n\tgetDescriptor() {\n\t\treturn this.descriptor;\n\t}\n\n\tgetSidecarResult() {\n\t\treturn this.sidecarResult;\n\t}\n\n\tasync start(context: ExtensionContext) {\n\t\tthis.context = context;\n\t\tif (context.mode !== \"tui\") return;\n\t\tif (process.platform === \"win32\") throw new Error(\"The SP terminal bridge requires Unix sockets.\");\n\t\tif (this.server) {\n\t\t\tthis.advanceGeneration(context);\n\t\t\treturn;\n\t\t}\n\n\t\tconst agentDir = this.options.agentDir ?? getSpAgentDir();\n\t\tthis.paths = makePaths(agentDir, this.instanceId);\n\t\tensurePrivateDirectory(this.paths.rootDir);\n\t\tensurePrivateDirectory(this.paths.discoveryDir);\n\t\tensurePrivateDirectory(this.paths.socketDir);\n\t\tif (Buffer.byteLength(this.paths.socketPath, \"utf8\") > 103) {\n\t\t\tthrow new Error(`SP terminal bridge socket path is too long: ${this.paths.socketPath}`);\n\t\t}\n\t\tremoveFile(this.paths.socketPath);\n\n\t\tconst server = createServer((socket) => this.acceptClient(socket));\n\t\tserver.on(\"error\", () => {});\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tconst onError = (error: Error) => {\n\t\t\t\tserver.off(\"listening\", onListening);\n\t\t\t\treject(error);\n\t\t\t};\n\t\t\tconst onListening = () => {\n\t\t\t\tserver.off(\"error\", onError);\n\t\t\t\tresolve();\n\t\t\t};\n\t\t\tserver.once(\"error\", onError);\n\t\t\tserver.once(\"listening\", onListening);\n\t\t\tserver.listen(this.paths?.socketPath);\n\t\t});\n\t\tthis.server = server;\n\t\ttry {\n\t\t\tchmodSync(this.paths.socketPath, 0o600);\n\t\t\tthis.advanceGeneration(context);\n\t\t\tif (this.options.launchPiWeb !== false) {\n\t\t\t\tthis.sidecarResult = ensurePiWebSidecar(this.paths.discoveryDir, this.options.launcherOptions);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tawait this.stop();\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tupdateContext(context: ExtensionContext) {\n\t\tthis.context = context;\n\t}\n\n\tadvanceGeneration(context: ExtensionContext) {\n\t\tthis.context = context;\n\t\tif (!this.paths) return;\n\t\tthis.generation += 1;\n\t\tthis.sequence = 0;\n\t\tthis.eventHistory.splice(0);\n\t\tfor (const client of this.clients) client.socket.destroy();\n\t\tthis.descriptor = {\n\t\t\tversion: TERMINAL_BRIDGE_VERSION,\n\t\t\tprotocol: TERMINAL_BRIDGE_PROTOCOL,\n\t\t\tinstanceId: this.instanceId,\n\t\t\tpid: process.pid,\n\t\t\tsessionId: context.sessionManager.getSessionId(),\n\t\t\tsessionFile: context.sessionManager.getSessionFile(),\n\t\t\tcwd: context.cwd,\n\t\t\tsocketPath: this.paths.socketPath,\n\t\t\tauthToken: this.authToken,\n\t\t\tgeneration: this.generation,\n\t\t\tstartedAt: this.startedAt,\n\t\t\tframe: { encoding: \"newline-delimited-json\", maxBytes: this.maxFrameBytes },\n\t\t};\n\t\tconst temporaryPath = `${this.paths.descriptorPath}.${process.pid}.tmp`;\n\t\twriteFileSync(temporaryPath, `${JSON.stringify(this.descriptor, null, \"\\t\")}\\n`, {\n\t\t\tencoding: \"utf8\",\n\t\t\tmode: 0o600,\n\t\t});\n\t\tchmodSync(temporaryPath, 0o600);\n\t\trenameSync(temporaryPath, this.paths.descriptorPath);\n\t\tchmodSync(this.paths.descriptorPath, 0o600);\n\t}\n\n\tpublish(category: EventFrame[\"category\"], event: { type: string }, context: ExtensionContext) {\n\t\tthis.context = context;\n\t\tif (!this.server) return;\n\t\tconst frame: EventFrame = {\n\t\t\tv: TERMINAL_BRIDGE_VERSION,\n\t\t\ttype: \"event\",\n\t\t\tgeneration: this.generation,\n\t\t\tsequence: ++this.sequence,\n\t\t\tevent: event.type,\n\t\t\tcategory,\n\t\t\tpayload: normalizeForJson(event),\n\t\t};\n\t\ttry {\n\t\t\tthis.encode(frame);\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\t\tthis.eventHistory.push(frame);\n\t\tif (this.eventHistory.length > MAX_EVENT_HISTORY) this.eventHistory.shift();\n\t\tfor (const client of this.clients) {\n\t\t\tif (client.authenticated && client.subscribed) this.send(client, frame);\n\t\t}\n\t}\n\n\tasync stop() {\n\t\tconst server = this.server;\n\t\tthis.server = undefined;\n\t\tfor (const client of this.clients) client.socket.destroy();\n\t\tthis.clients.clear();\n\t\tif (server) {\n\t\t\tawait new Promise<void>((resolve) => server.close(() => resolve()));\n\t\t}\n\t\tconst paths = this.paths;\n\t\tif (paths) {\n\t\t\ttry {\n\t\t\t\tconst value = JSON.parse(readFileSync(paths.descriptorPath, \"utf8\")) as unknown;\n\t\t\t\tif (isRecord(value) && value.instanceId === this.instanceId) removeFile(paths.descriptorPath);\n\t\t\t} catch (error) {\n\t\t\t\tif (!isMissingFileError(error) && !(error instanceof SyntaxError)) throw error;\n\t\t\t}\n\t\t\tremoveFile(paths.socketPath);\n\t\t}\n\t\tthis.descriptor = undefined;\n\t}\n\n\tprivate acceptClient(socket: Socket) {\n\t\tif (this.clients.size >= this.maxClients) {\n\t\t\tsocket.on(\"error\", () => {});\n\t\t\tsocket.end(`${JSON.stringify({ v: 1, type: \"error\", code: \"too_many_clients\" })}\\n`, () => socket.destroy());\n\t\t\treturn;\n\t\t}\n\t\tsocket.setNoDelay(true);\n\t\tconst client: ClientState = {\n\t\t\tsocket,\n\t\t\tbuffer: Buffer.alloc(0),\n\t\t\tauthenticated: false,\n\t\t\tsubscribed: false,\n\t\t\tpendingRequests: 0,\n\t\t\tseenRequestIds: new Set(),\n\t\t};\n\t\tthis.clients.add(client);\n\t\tsocket.on(\"data\", (chunk: Buffer) => this.receive(client, chunk));\n\t\tsocket.on(\"error\", () => {});\n\t\tsocket.on(\"close\", () => this.clients.delete(client));\n\t}\n\n\tprivate receive(client: ClientState, chunk: Buffer) {\n\t\tclient.buffer = Buffer.concat([client.buffer, chunk]);\n\t\tif (client.buffer.length > this.maxFrameBytes && client.buffer.indexOf(0x0a) === -1) {\n\t\t\tclient.socket.destroy();\n\t\t\treturn;\n\t\t}\n\t\tlet newline = client.buffer.indexOf(0x0a);\n\t\twhile (newline !== -1) {\n\t\t\tconst frame = client.buffer.subarray(0, newline);\n\t\t\tclient.buffer = client.buffer.subarray(newline + 1);\n\t\t\tif (frame.length > this.maxFrameBytes || frame.length === 0) {\n\t\t\t\tclient.socket.destroy();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tlet value: unknown;\n\t\t\ttry {\n\t\t\t\tvalue = JSON.parse(frame.toString(\"utf8\")) as unknown;\n\t\t\t} catch {\n\t\t\t\tclient.socket.destroy();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (!isRecord(value)) {\n\t\t\t\tclient.socket.destroy();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (!client.authenticated) {\n\t\t\t\tthis.authenticate(client, value);\n\t\t\t\tif (!client.authenticated) return;\n\t\t\t} else {\n\t\t\t\tthis.acceptRequest(client, value);\n\t\t\t}\n\t\t\tnewline = client.buffer.indexOf(0x0a);\n\t\t}\n\t}\n\n\tprivate authenticate(client: ClientState, value: JsonRecord) {\n\t\tif (value.v !== TERMINAL_BRIDGE_VERSION || value.type !== \"hello\" || !tokenMatches(this.authToken, value.token)) {\n\t\t\tthis.send(client, { v: 1, type: \"hello\", ok: false, error: \"authentication_failed\" });\n\t\t\tclient.socket.end();\n\t\t\treturn;\n\t\t}\n\t\tclient.authenticated = true;\n\t\tthis.send(client, {\n\t\t\tv: TERMINAL_BRIDGE_VERSION,\n\t\t\ttype: \"hello\",\n\t\t\tok: true,\n\t\t\tprotocol: TERMINAL_BRIDGE_PROTOCOL,\n\t\t\tgeneration: this.generation,\n\t\t\tsequence: this.sequence,\n\t\t\tinstanceId: this.instanceId,\n\t\t});\n\t}\n\n\tprivate acceptRequest(client: ClientState, value: JsonRecord) {\n\t\tlet request: RequestFrame;\n\t\ttry {\n\t\t\trequest = parseRequest(value);\n\t\t} catch (error) {\n\t\t\tthis.sendRequestError(client, typeof value.id === \"string\" ? value.id : null, error);\n\t\t\treturn;\n\t\t}\n\t\tif (client.seenRequestIds.has(request.id)) {\n\t\t\tthis.sendRequestError(\n\t\t\t\tclient,\n\t\t\t\trequest.id,\n\t\t\t\tnew RequestError(\"duplicate_request\", \"Request ID was already used.\"),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\tclient.seenRequestIds.add(request.id);\n\t\tif (client.seenRequestIds.size > MAX_SEEN_REQUEST_IDS) {\n\t\t\tconst oldest = client.seenRequestIds.values().next().value as string | undefined;\n\t\t\tif (oldest) client.seenRequestIds.delete(oldest);\n\t\t}\n\t\tif (client.pendingRequests >= MAX_PENDING_REQUESTS) {\n\t\t\tthis.sendRequestError(client, request.id, new RequestError(\"too_many_requests\", \"Too many pending requests.\"));\n\t\t\treturn;\n\t\t}\n\t\tclient.pendingRequests += 1;\n\t\tthis.commandQueue = this.commandQueue\n\t\t\t.then(async () => {\n\t\t\t\tconst result = await this.execute(request, client);\n\t\t\t\tthis.sendSuccess(client, request.id, result);\n\t\t\t})\n\t\t\t.catch((error: unknown) => this.sendRequestError(client, request.id, error))\n\t\t\t.finally(() => {\n\t\t\t\tclient.pendingRequests -= 1;\n\t\t\t});\n\t}\n\n\tprivate async execute(request: RequestFrame, client: ClientState): Promise<unknown> {\n\t\tif (request.generation !== this.generation) {\n\t\t\tthrow new RequestError(\"stale_generation\", `Current generation is ${this.generation}.`);\n\t\t}\n\t\tconst context = this.context;\n\t\tif (!context) throw new RequestError(\"not_ready\", \"Session context is not ready.\");\n\t\tconst params = request.params ?? {};\n\t\tswitch (request.command) {\n\t\t\tcase \"snapshot\": {\n\t\t\t\tconst entries = context.sessionManager.getEntries();\n\t\t\t\treturn {\n\t\t\t\t\tstate: this.stateSnapshot(context),\n\t\t\t\t\ttranscript: this.transcriptPage(entries, 0, Math.min(entries.length, MAX_TRANSCRIPT_PAGE_SIZE)),\n\t\t\t\t};\n\t\t\t}\n\t\t\tcase \"state\":\n\t\t\t\treturn this.stateSnapshot(context);\n\t\t\tcase \"transcript\": {\n\t\t\t\tconst entries = context.sessionManager.getEntries();\n\t\t\t\tconst cursor = optionalInteger(params.cursor, \"cursor\", 0);\n\t\t\t\tconst limit = Math.min(optionalInteger(params.limit, \"limit\", 50), MAX_TRANSCRIPT_PAGE_SIZE);\n\t\t\t\treturn this.transcriptPage(entries, cursor, limit);\n\t\t\t}\n\t\t\tcase \"models\":\n\t\t\t\treturn {\n\t\t\t\t\tmodels: availableModels(context),\n\t\t\t\t\tcurrent: context.model ? { provider: context.model.provider, modelId: context.model.id } : null,\n\t\t\t\t};\n\t\t\tcase \"generate_title\":\n\t\t\t\treturn (this.options.titleGenerator ?? generateTitle)(context, this.pi);\n\t\t\tcase \"subscribe\": {\n\t\t\t\tconst afterSequence = optionalInteger(params.afterSequence, \"afterSequence\", this.sequence);\n\t\t\t\tconst earliestSequence = this.eventHistory[0]?.sequence ?? this.sequence + 1;\n\t\t\t\tif (afterSequence < earliestSequence - 1) {\n\t\t\t\t\tthrow new RequestError(\"event_gap\", `Earliest retained sequence is ${earliestSequence}.`);\n\t\t\t\t}\n\t\t\t\tclient.subscribed = true;\n\t\t\t\tfor (const event of this.eventHistory) {\n\t\t\t\t\tif (event.sequence > afterSequence) this.send(client, event);\n\t\t\t\t}\n\t\t\t\treturn { subscribed: true, sequence: this.sequence };\n\t\t\t}\n\t\t\tcase \"prompt\":\n\t\t\t\tif (!context.isIdle()) throw new RequestError(\"busy\", \"Use steer or follow_up while the agent is running.\");\n\t\t\t\tthis.pi.sendUserMessage(requireString(params.text, \"text\"), {\n\t\t\t\t\texpandPromptTemplates: params.expandPromptTemplates === true,\n\t\t\t\t});\n\t\t\t\treturn { accepted: true };\n\t\t\tcase \"steer\":\n\t\t\t\tif (context.isIdle()) throw new RequestError(\"idle\", \"There is no running turn to steer.\");\n\t\t\t\tthis.pi.sendUserMessage(requireString(params.text, \"text\"), { deliverAs: \"steer\" });\n\t\t\t\treturn { accepted: true };\n\t\t\tcase \"follow_up\":\n\t\t\t\tif (context.isIdle()) throw new RequestError(\"idle\", \"There is no running turn to queue a follow-up for.\");\n\t\t\t\tthis.pi.sendUserMessage(requireString(params.text, \"text\"), { deliverAs: \"followUp\" });\n\t\t\t\treturn { accepted: true };\n\t\t\tcase \"abort\":\n\t\t\t\tif (context.isIdle()) throw new RequestError(\"idle\", \"There is no running turn to abort.\");\n\t\t\t\tcontext.abort();\n\t\t\t\treturn { accepted: true };\n\t\t\tcase \"set_thinking\": {\n\t\t\t\tif (!context.isIdle()) throw new RequestError(\"busy\", \"Thinking level can only change while idle.\");\n\t\t\t\tconst level = requireString(params.level, \"level\", 16);\n\t\t\t\tif (!THINKING_LEVELS.includes(level as ThinkingLevel)) {\n\t\t\t\t\tthrow new RequestError(\"invalid_params\", `Unsupported thinking level: ${level}`);\n\t\t\t\t}\n\t\t\t\tthis.pi.setThinkingLevel(level as ThinkingLevel);\n\t\t\t\treturn { accepted: true, level: this.pi.getThinkingLevel() };\n\t\t\t}\n\t\t\tcase \"set_model\": {\n\t\t\t\tif (!context.isIdle()) throw new RequestError(\"busy\", \"Model can only change while idle.\");\n\t\t\t\tconst provider = requireString(params.provider, \"provider\", 256);\n\t\t\t\tconst modelId = requireString(params.modelId, \"modelId\", 512);\n\t\t\t\tif (provider !== \"sp-gateway\") {\n\t\t\t\t\tthrow new RequestError(\"model_out_of_scope\", \"Only sp-gateway models are available in SP.\");\n\t\t\t\t}\n\t\t\t\tconst model = context.modelRegistry.find(provider, modelId);\n\t\t\t\tif (!model) throw new RequestError(\"model_unavailable\", `Model is not available: ${provider}/${modelId}`);\n\t\t\t\tif (\n\t\t\t\t\tcontext.scopedModels.length > 0 &&\n\t\t\t\t\t!context.scopedModels.some((entry) => entry.model.provider === provider && entry.model.id === modelId)\n\t\t\t\t) {\n\t\t\t\t\tthrow new RequestError(\n\t\t\t\t\t\t\"model_out_of_scope\",\n\t\t\t\t\t\t`Model is outside this session's model scope: ${provider}/${modelId}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tif (!(await this.pi.setModel(model))) {\n\t\t\t\t\tthrow new RequestError(\"model_auth_unavailable\", `No usable credentials for ${provider}/${modelId}.`);\n\t\t\t\t}\n\t\t\t\treturn { accepted: true, model: { provider: model.provider, id: model.id, name: model.name } };\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\tthrow new RequestError(\"unsupported_command\", `Unsupported command: ${request.command}`);\n\t\t}\n\t}\n\n\tprivate stateSnapshot(context: ExtensionContext) {\n\t\tconst model = context.model;\n\t\treturn {\n\t\t\tprotocol: TERMINAL_BRIDGE_PROTOCOL,\n\t\t\tgeneration: this.generation,\n\t\t\tsequence: this.sequence,\n\t\t\tsession: {\n\t\t\t\tid: context.sessionManager.getSessionId(),\n\t\t\t\tfile: context.sessionManager.getSessionFile(),\n\t\t\t\tname: context.sessionManager.getSessionName(),\n\t\t\t\tcwd: context.cwd,\n\t\t\t\tentryCount: context.sessionManager.getEntries().length,\n\t\t\t},\n\t\t\tstatus: {\n\t\t\t\tidle: context.isIdle(),\n\t\t\t\thasPendingMessages: context.hasPendingMessages(),\n\t\t\t\tcontextUsage: context.getContextUsage(),\n\t\t\t},\n\t\t\tmodel: model ? { provider: model.provider, id: model.id, name: model.name } : null,\n\t\t\tthinkingLevel: this.pi.getThinkingLevel(),\n\t\t\tcapabilities: {\n\t\t\t\tsnapshot: true,\n\t\t\t\tstate: true,\n\t\t\t\ttranscript: { paginated: true, maximumPageSize: MAX_TRANSCRIPT_PAGE_SIZE },\n\t\t\t\teventStream: { replayLimit: MAX_EVENT_HISTORY },\n\t\t\t\tprompt: true,\n\t\t\t\tsteer: true,\n\t\t\t\tfollowUp: true,\n\t\t\t\tabort: true,\n\t\t\t\tsetThinking: true,\n\t\t\t\tsetModel: \"available-and-session-scoped-models-only\",\n\t\t\t\tmodels: true,\n\t\t\t\tgenerateTitle: true,\n\t\t\t\tnewSession: false,\n\t\t\t\tresumeSession: false,\n\t\t\t\tforkSession: false,\n\t\t\t\tdirectJsonlAccess: false,\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate transcriptPage(entries: unknown[], cursor: number, limit: number) {\n\t\treturn {\n\t\t\tcursor,\n\t\t\tnextCursor: cursor + limit < entries.length ? cursor + limit : null,\n\t\t\ttotal: entries.length,\n\t\t\tentries: normalizeForJson(entries.slice(cursor, cursor + limit)),\n\t\t};\n\t}\n\n\tprivate sendRequestError(client: ClientState, id: string | null, error: unknown) {\n\t\tconst code = error instanceof RequestError ? error.code : \"internal_error\";\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthis.send(client, {\n\t\t\tv: TERMINAL_BRIDGE_VERSION,\n\t\t\ttype: \"response\",\n\t\t\tid,\n\t\t\tgeneration: this.generation,\n\t\t\tok: false,\n\t\t\terror: { code, message },\n\t\t});\n\t}\n\n\tprivate sendSuccess(client: ClientState, id: string, result: unknown) {\n\t\tconst frame = {\n\t\t\tv: TERMINAL_BRIDGE_VERSION,\n\t\t\ttype: \"response\",\n\t\t\tid,\n\t\t\tgeneration: this.generation,\n\t\t\tok: true,\n\t\t\tresult,\n\t\t};\n\t\ttry {\n\t\t\tthis.writeEncoded(client, this.encode(frame));\n\t\t} catch (error) {\n\t\t\tthis.sendRequestError(client, id, error);\n\t\t}\n\t}\n\n\tprivate encode(value: unknown) {\n\t\tconst encoded = Buffer.from(`${JSON.stringify(value)}\\n`, \"utf8\");\n\t\tif (encoded.length > this.maxFrameBytes) throw new RequestError(\"frame_too_large\", \"Frame exceeds the limit.\");\n\t\treturn encoded;\n\t}\n\n\tprivate send(client: ClientState, value: unknown) {\n\t\tif (client.socket.destroyed) return;\n\t\ttry {\n\t\t\tthis.writeEncoded(client, this.encode(value));\n\t\t} catch {\n\t\t\tclient.socket.destroy();\n\t\t}\n\t}\n\n\tprivate writeEncoded(client: ClientState, encoded: Buffer) {\n\t\tif (client.socket.destroyed) return;\n\t\tif (client.socket.writableLength + encoded.length > this.maxBufferedBytes) {\n\t\t\tclient.socket.destroy();\n\t\t\treturn;\n\t\t}\n\t\tclient.socket.write(encoded);\n\t}\n}\n\nexport function registerTerminalWebBridge(pi: ExtensionAPI, options: TerminalWebBridgeOptions = {}) {\n\tconst bridge = new TerminalWebBridge(pi, options);\n\tpi.on(\"session_start\", async (event, context) => {\n\t\ttry {\n\t\t\tawait bridge.start(context);\n\t\t\tbridge.publish(\"session\", event, context);\n\t\t\tconst sidecar = bridge.getSidecarResult();\n\t\t\tif (sidecar?.status === \"failed\") context.ui.notify(`pi-web sidecar failed: ${sidecar.error}`, \"warning\");\n\t\t} catch (error) {\n\t\t\tcontext.ui.notify(\n\t\t\t\t`SP terminal bridge failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\"warning\",\n\t\t\t);\n\t\t}\n\t});\n\tpi.on(\"session_info_changed\", (event, context) => bridge.publish(\"session\", event, context));\n\tpi.on(\"session_compact\", (event, context) => bridge.publish(\"session\", event, context));\n\tpi.on(\"session_compact_failed\", (event, context) => bridge.publish(\"session\", event, context));\n\tpi.on(\"session_tree\", (event, context) => bridge.publish(\"session\", event, context));\n\tpi.on(\"agent_start\", (event, context) => bridge.publish(\"agent\", event, context));\n\tpi.on(\"agent_end\", (event, context) => bridge.publish(\"agent\", event, context));\n\tpi.on(\"agent_settled\", (event, context) => bridge.publish(\"agent\", event, context));\n\tpi.on(\"message_start\", (event, context) => bridge.publish(\"message\", event, context));\n\tpi.on(\"message_update\", (event, context) => bridge.publish(\"message\", event, context));\n\tpi.on(\"message_end\", (event, context) => bridge.publish(\"message\", event, context));\n\tpi.on(\"tool_execution_start\", (event, context) => bridge.publish(\"tool\", event, context));\n\tpi.on(\"tool_execution_update\", (event, context) => bridge.publish(\"tool\", event, context));\n\tpi.on(\"tool_execution_end\", (event, context) => bridge.publish(\"tool\", event, context));\n\tpi.on(\"model_select\", (event, context) => bridge.publish(\"model\", event, context));\n\tpi.on(\"thinking_level_select\", (event, context) => bridge.publish(\"thinking\", event, context));\n\tpi.on(\"session_shutdown\", async (event, context) => {\n\t\tbridge.publish(\"session\", event, context);\n\t\ttry {\n\t\t\tawait bridge.stop();\n\t\t} catch {\n\t\t\t// Cleanup failures must not stop SP shutdown.\n\t\t}\n\t});\n\treturn bridge;\n}\n\nexport function readTerminalBridgeDescriptor(path: string): TerminalBridgeDescriptor {\n\tconst value = JSON.parse(readFileSync(path, \"utf8\")) as TerminalBridgeDescriptor;\n\treturn value;\n}\n\nexport function terminalBridgeDescriptorExists(path: string) {\n\treturn existsSync(path);\n}\n"]}
+{"version":3,"file":"terminal-web-bridge.d.ts","sourceRoot":"","sources":["../src/terminal-web-bridge.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIhF,OAAO,EAAsB,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE7G,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAChE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,uCAAuC,QAAmB,CAAC;AACxE,eAAO,MAAM,0CAA0C,QAAmB,CAAC;AAC3E,eAAO,MAAM,mCAAmC,IAAI,CAAC;AACrD,eAAO,MAAM,4BAA4B;;;;;CAK/B,CAAC;AAeX,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,OAAO,wBAAwB,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACvB,KAAK,EAAE;QACN,QAAQ,EAAE,wBAAwB,CAAC;QACnC,QAAQ,EAAE,MAAM,CAAC;KACjB,CAAC;CACF;AAED,MAAM,WAAW,wBAAwB;IACxC,kGAAkG;IAClG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACvB,qFAAqF;IACrF,QAAQ,CAAC,EAAE;QACV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC5D,aAAa,CAAC,CACb,OAAO,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,IAAI,CAAA;SAAE,EACrE,SAAS,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,IAAI,CAAA;SAAE,CAAC,CAAC;QACjD,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;QACjD,aAAa,CAAC,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxG;AA4BD,UAAU,UAAU;IACnB,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;IAC1F,OAAO,EAAE,OAAO,CAAC;CACjB;AA+OD,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2E;IAC1G,OAAO,CAAC,aAAa,CAA6D;IAElF,wFAAwF;IACxF,eAAe,CAAC,kBAAkB,EAAE,OAAO,GAAG,MAAM,IAAI,CAcvD;IAEK,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpC;IACD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiD;IAC5E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+C;IAC5E,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,wBAAwB,CAAK;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,oBAAoB,CAA2B;IAEvD,YAAY,EAAE,EAAE,YAAY,EAAE,OAAO,GAAE,wBAA6B,EAQnE;IAED,aAAa,yCAEZ;IAED,gBAAgB,kCAEf;IAED,KAAK,CAAC,OAAO,EAAE,gBAAgB,iBAI9B;YAEa,WAAW;IAqDzB,aAAa,CAAC,OAAO,EAAE,gBAAgB,QAEtC;IAED,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,QAoC1C;IAED,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,EAAE,gBAAgB,QA6C3F;IAED,IAAI,kBAWH;IAED,iFAAiF;IACjF,aAAa,SAaZ;YAEa,UAAU;IA8BxB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,OAAO;IAqCf,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,aAAa;YAkEP,OAAO;IAwIrB,OAAO,CAAC,aAAa;IA+CrB,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;CAuBnB;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,GAAE,wBAA6B,qBAyCjG;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAGnF;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,WAE1D","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport { randomBytes, randomUUID, timingSafeEqual } from \"node:crypto\";\nimport { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from \"node:fs\";\nimport { createServer, type Server, type Socket } from \"node:net\";\nimport { join } from \"node:path\";\nimport type { ExtensionAPI, ExtensionContext } from \"@senpiper/pi-coding-agent\";\nimport { completeSimple } from \"@senpiper/pi-coding-agent/runtime-deps\";\nimport { getSpAgentDir } from \"./gateway.ts\";\nimport { getQuestionInteraction, type QuestionInteraction, QuestionResponseError } from \"./question-interaction.ts\";\nimport { ensureSpWebSidecar, type SpWebLauncherOptions, type SpWebLaunchResult } from \"./sp-web-launcher.ts\";\n\nexport const TERMINAL_BRIDGE_PROTOCOL = \"sp-terminal-bridge-v1\";\nexport const TERMINAL_BRIDGE_VERSION = 1;\nexport const DEFAULT_TERMINAL_BRIDGE_MAX_FRAME_BYTES = 10 * 1024 * 1024;\nexport const DEFAULT_TERMINAL_BRIDGE_MAX_BUFFERED_BYTES = 10 * 1024 * 1024;\nexport const DEFAULT_TERMINAL_BRIDGE_MAX_CLIENTS = 8;\nexport const TERMINAL_BRIDGE_IMAGE_LIMITS = {\n\tmimeTypes: [\"image/png\", \"image/jpeg\", \"image/webp\", \"image/gif\"],\n\tmaxImages: 8,\n\tmaxBase64BytesPerImage: 4 * 1024 * 1024,\n\tmaxBase64BytesTotal: 8 * 1024 * 1024,\n} as const;\n\nconst MAX_REQUEST_ID_LENGTH = 128;\nconst MAX_PENDING_REQUESTS = 32;\nconst MAX_SEEN_REQUEST_IDS = 1024;\nconst MAX_EVENT_HISTORY = 256;\nconst MAX_EVENT_HISTORY_BYTES = 32 * 1024 * 1024;\nconst MAX_TRANSCRIPT_PAGE_SIZE = 100;\nconst MAX_TITLE_CONTEXT_BYTES = 32 * 1024;\nconst MAX_TITLE_LENGTH = 80;\nconst THINKING_LEVELS = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\", \"max\"] as const;\n\ntype ThinkingLevel = (typeof THINKING_LEVELS)[number];\ntype JsonRecord = Record<string, unknown>;\n\nexport interface TerminalBridgeDescriptor {\n\tversion: 1;\n\tprotocol: typeof TERMINAL_BRIDGE_PROTOCOL;\n\tinstanceId: string;\n\tpid: number;\n\tsessionId: string;\n\tsessionFile?: string;\n\tcwd: string;\n\tsocketPath: string;\n\tauthToken: string;\n\tgeneration: number;\n\tstartedAt: string;\n\twriterLeaseVersion?: 1;\n\tframe: {\n\t\tencoding: \"newline-delimited-json\";\n\t\tmaxBytes: number;\n\t};\n}\n\nexport interface TerminalWebBridgeOptions {\n\t/** Set only by a distribution that installed the lifetime writer provider before file opening. */\n\twriterLeaseVersion?: 1;\n\t/** Supplied by the verified SP distribution, shared across terminal replacements. */\n\tsessions?: {\n\t\tcreate(cwd: string): Promise<{ sessionId: string }>;\n\t\tresume(sessionFile: string): Promise<{ sessionId: string }>;\n\t\tdeleteSession?(\n\t\t\trequest: { sessionId: string; sessionFile?: string; confirmed: true },\n\t\t\trequester?: TerminalWebBridge,\n\t\t): Promise<{ sessionId: string; deleted: true }>;\n\t\tterminalStarted(context: ExtensionContext): void;\n\t\tbridgeStopped?(bridge: TerminalWebBridge): void;\n\t\tdispose(): Promise<void>;\n\t};\n\twebOwned?: boolean;\n\tonReady?: (bridge: TerminalWebBridge) => void;\n\tagentDir?: string;\n\tmaxFrameBytes?: number;\n\tmaxBufferedBytes?: number;\n\tmaxClients?: number;\n\tlaunchSpWeb?: boolean;\n\tlauncherOptions?: SpWebLauncherOptions;\n\ttitleGenerator?: (context: ExtensionContext, pi: ExtensionAPI, signal: AbortSignal) => Promise<unknown>;\n}\n\ninterface BridgePaths {\n\trootDir: string;\n\tdiscoveryDir: string;\n\tsocketDir: string;\n\tdescriptorPath: string;\n\tsocketPath: string;\n}\n\ninterface ClientState {\n\tsocket: Socket;\n\tbuffer: Buffer;\n\tauthenticated: boolean;\n\tsubscribed: boolean;\n\tpendingRequests: number;\n\tseenRequestIds: Set<string>;\n}\n\ninterface RequestFrame {\n\tv: 1;\n\ttype: \"request\";\n\tid: string;\n\tgeneration: number;\n\tcommand: string;\n\tparams?: JsonRecord;\n}\n\ninterface EventFrame {\n\tv: 1;\n\ttype: \"event\";\n\tgeneration: number;\n\tsequence: number;\n\tevent: string;\n\tcategory: \"message\" | \"agent\" | \"tool\" | \"model\" | \"thinking\" | \"session\" | \"interaction\";\n\tpayload: unknown;\n}\n\nclass RequestError extends Error {\n\treadonly code: string;\n\n\tconstructor(code: string, message: string) {\n\t\tsuper(message);\n\t\tthis.code = code;\n\t}\n}\n\nfunction isRecord(value: unknown): value is JsonRecord {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isMissingFileError(error: unknown) {\n\treturn isRecord(error) && error.code === \"ENOENT\";\n}\n\nfunction requireString(value: unknown, name: string, maximumLength = 100_000) {\n\tif (typeof value !== \"string\" || !value.trim()) throw new RequestError(\"invalid_params\", `${name} is required.`);\n\tif (Buffer.byteLength(value, \"utf8\") > maximumLength) {\n\t\tthrow new RequestError(\"invalid_params\", `${name} is too long.`);\n\t}\n\treturn value;\n}\n\nfunction userMessageContent(params: JsonRecord): Parameters<ExtensionAPI[\"sendUserMessage\"]>[0] {\n\tconst images = params.images;\n\tif (images === undefined || (Array.isArray(images) && images.length === 0)) {\n\t\treturn requireString(params.text, \"text\");\n\t}\n\tif (!Array.isArray(images) || images.length > TERMINAL_BRIDGE_IMAGE_LIMITS.maxImages) {\n\t\tthrow new RequestError(\"invalid_params\", \"images must be an array of at most 8 images.\");\n\t}\n\tconst content: Exclude<Parameters<ExtensionAPI[\"sendUserMessage\"]>[0], string> = [];\n\tif (params.text !== undefined) {\n\t\tif (typeof params.text !== \"string\" || Buffer.byteLength(params.text, \"utf8\") > 100_000) {\n\t\t\tthrow new RequestError(\"invalid_params\", \"text must be a string of at most 100000 UTF-8 bytes.\");\n\t\t}\n\t\tif (params.text.length > 0) content.push({ type: \"text\", text: params.text });\n\t}\n\tlet total = 0;\n\tfor (const image of images) {\n\t\tif (\n\t\t\t!isRecord(image) ||\n\t\t\tObject.keys(image).some((key) => key !== \"mimeType\" && key !== \"data\") ||\n\t\t\ttypeof image.mimeType !== \"string\" ||\n\t\t\t!TERMINAL_BRIDGE_IMAGE_LIMITS.mimeTypes.some((mimeType) => mimeType === image.mimeType) ||\n\t\t\ttypeof image.data !== \"string\" ||\n\t\t\timage.data.length === 0\n\t\t) {\n\t\t\tthrow new RequestError(\"invalid_params\", \"Each image requires a supported mimeType and base64 data only.\");\n\t\t}\n\t\ttotal += image.data.length;\n\t\tif (\n\t\t\timage.data.length > TERMINAL_BRIDGE_IMAGE_LIMITS.maxBase64BytesPerImage ||\n\t\t\ttotal > TERMINAL_BRIDGE_IMAGE_LIMITS.maxBase64BytesTotal\n\t\t) {\n\t\t\tthrow new RequestError(\"invalid_params\", \"Image base64 exceeds the per-image or aggregate byte limit.\");\n\t\t}\n\t\t// Buffer's decoder alone accepts paths, whitespace, URL-safe and malformed base64.\n\t\tif (/[^A-Za-z0-9+/=]/u.test(image.data) || Buffer.from(image.data, \"base64\").toString(\"base64\") !== image.data) {\n\t\t\tthrow new RequestError(\"invalid_params\", \"Image data must be canonical padded base64, not a path or URL.\");\n\t\t}\n\t\tcontent.push({ type: \"image\", mimeType: image.mimeType, data: image.data });\n\t}\n\treturn content;\n}\n\nfunction optionalInteger(value: unknown, name: string, fallback: number) {\n\tif (value === undefined) return fallback;\n\tif (!Number.isSafeInteger(value) || (value as number) < 0) {\n\t\tthrow new RequestError(\"invalid_params\", `${name} must be a non-negative integer.`);\n\t}\n\treturn value as number;\n}\n\nfunction normalizeForJson(value: unknown, omitImageData = false): unknown {\n\treturn JSON.parse(\n\t\tJSON.stringify(value, (_key, entry: unknown) => {\n\t\t\tif (omitImageData && isRecord(entry) && entry.type === \"image\") {\n\t\t\t\treturn { type: \"image\", mimeType: entry.mimeType };\n\t\t\t}\n\t\t\tif (typeof entry === \"bigint\") return entry.toString();\n\t\t\tif (entry instanceof Error) return { name: entry.name, message: entry.message };\n\t\t\treturn entry;\n\t\t}),\n\t) as unknown;\n}\n\nfunction availableModels(context: ExtensionContext) {\n\tconst scoped = context.scopedModels.map((entry) => entry.model);\n\tconst models = scoped.length > 0 ? scoped : context.modelRegistry.getAvailable();\n\treturn models\n\t\t.filter((model) => model.provider === \"sp-gateway\")\n\t\t.map((model) => ({\n\t\t\tprovider: model.provider,\n\t\t\tid: model.id,\n\t\t\tname: model.name,\n\t\t\tinput: model.input,\n\t\t\treasoning: model.reasoning,\n\t\t\tcontextWindow: model.contextWindow,\n\t\t\tmaxTokens: model.maxTokens,\n\t\t\t...(model.thinkingLevelMap ? { thinkingLevelMap: model.thinkingLevelMap } : {}),\n\t\t}));\n}\n\nfunction parseGeneratedTitle(raw: string) {\n\tlet title = raw.trim().split(/\\r?\\n/u, 1)[0] ?? \"\";\n\ttitle = title.replace(/^(?:session\\s+title|title)\\s*[:-]\\s*/iu, \"\");\n\ttitle = title\n\t\t.replace(/^[\"'`]|[\"'`]$/gu, \"\")\n\t\t.replace(/\\s+/gu, \" \")\n\t\t.replace(/[.!]+$/u, \"\")\n\t\t.trim();\n\tif (!/[\\p{L}\\p{N}]/u.test(title))\n\t\tthrow new RequestError(\"title_generation_failed\", \"The model returned no usable title.\");\n\treturn Array.from(title).slice(0, MAX_TITLE_LENGTH).join(\"\").trim();\n}\n\nasync function generateTitle(context: ExtensionContext, pi: ExtensionAPI, signal: AbortSignal) {\n\tif (!context.isIdle()) throw new RequestError(\"busy\", \"A title can only be generated while the agent is idle.\");\n\tconst activeModel = context.model;\n\tif (!activeModel || activeModel.provider !== \"sp-gateway\") {\n\t\tthrow new RequestError(\"model_unavailable\", \"Title generation requires an active sp-gateway model.\");\n\t}\n\tconst model = context.modelRegistry.find(activeModel.provider, activeModel.id);\n\tif (!model) throw new RequestError(\"model_unavailable\", \"The active sp-gateway model is unavailable.\");\n\tconst auth = await context.modelRegistry.getApiKeyAndHeaders(model);\n\tsignal.throwIfAborted();\n\tif (!auth.ok || !auth.apiKey) {\n\t\tthrow new RequestError(\"model_auth_unavailable\", auth.ok ? \"sp-gateway has no API key available.\" : auth.error);\n\t}\n\tconst serialized = Buffer.from(JSON.stringify(normalizeForJson(context.sessionManager.getEntries(), true)), \"utf8\");\n\tconst transcript =\n\t\tserialized.length <= MAX_TITLE_CONTEXT_BYTES\n\t\t\t? serialized.toString(\"utf8\")\n\t\t\t: serialized.subarray(-MAX_TITLE_CONTEXT_BYTES).toString(\"utf8\");\n\tconst response = await completeSimple(\n\t\tmodel,\n\t\t{\n\t\t\tsystemPrompt: [\n\t\t\t\t\"Create a concise English title for this coding session.\",\n\t\t\t\t\"Use 4-12 words. Describe the concrete task or result.\",\n\t\t\t\t\"Return only the title as plain text. Do not use tools, quotes, labels, or punctuation at the end.\",\n\t\t\t].join(\"\\n\"),\n\t\t\tmessages: [\n\t\t\t\t{\n\t\t\t\t\trole: \"user\",\n\t\t\t\t\tcontent: `Session transcript entries:\\n${transcript}`,\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t},\n\t\t\t],\n\t\t\ttools: [],\n\t\t},\n\t\t{ apiKey: auth.apiKey, headers: auth.headers, env: auth.env, signal },\n\t);\n\tsignal.throwIfAborted();\n\tif (response.stopReason === \"error\") {\n\t\tthrow new RequestError(\"title_generation_failed\", response.errorMessage ?? \"The title model request failed.\");\n\t}\n\tconst rawTitle = response.content\n\t\t.filter((part): part is { type: \"text\"; text: string } => part.type === \"text\")\n\t\t.map((part) => part.text)\n\t\t.join(\"\\n\");\n\tconst title = parseGeneratedTitle(rawTitle);\n\tpi.setSessionName(title);\n\treturn {\n\t\ttitle,\n\t\tusage: {\n\t\t\tinput: response.usage.input,\n\t\t\toutput: response.usage.output,\n\t\t\tcacheRead: response.usage.cacheRead,\n\t\t\tcacheWrite: response.usage.cacheWrite,\n\t\t\ttotal: response.usage.totalTokens,\n\t\t},\n\t};\n}\n\nfunction makePaths(agentDir: string, instanceId: string): BridgePaths {\n\tconst rootDir = join(agentDir, \"web-bridge\");\n\tconst discoveryDir = join(rootDir, \"discovery\");\n\tconst socketDir = join(rootDir, \"sockets\");\n\treturn {\n\t\trootDir,\n\t\tdiscoveryDir,\n\t\tsocketDir,\n\t\tdescriptorPath: join(discoveryDir, `${instanceId}.json`),\n\t\tsocketPath: join(socketDir, `${instanceId}.sock`),\n\t};\n}\n\nfunction ensurePrivateDirectory(path: string) {\n\tmkdirSync(path, { recursive: true, mode: 0o700 });\n\tif (process.platform !== \"win32\") chmodSync(path, 0o700);\n}\n\nfunction removeFile(path: string) {\n\ttry {\n\t\tunlinkSync(path);\n\t} catch (error) {\n\t\tif (!isMissingFileError(error)) throw error;\n\t}\n}\n\nfunction tokenMatches(expected: string, received: unknown) {\n\tif (typeof received !== \"string\") return false;\n\tconst expectedBytes = Buffer.from(expected, \"utf8\");\n\tconst receivedBytes = Buffer.from(received, \"utf8\");\n\treturn expectedBytes.length === receivedBytes.length && timingSafeEqual(expectedBytes, receivedBytes);\n}\n\nfunction parseRequest(value: JsonRecord): RequestFrame {\n\tif (\n\t\tvalue.v !== TERMINAL_BRIDGE_VERSION ||\n\t\tvalue.type !== \"request\" ||\n\t\ttypeof value.id !== \"string\" ||\n\t\t!value.id ||\n\t\tvalue.id.length > MAX_REQUEST_ID_LENGTH ||\n\t\t!Number.isSafeInteger(value.generation) ||\n\t\ttypeof value.command !== \"string\" ||\n\t\t!value.command\n\t) {\n\t\tthrow new RequestError(\"invalid_request\", \"Invalid request envelope.\");\n\t}\n\tif (value.params !== undefined && !isRecord(value.params)) {\n\t\tthrow new RequestError(\"invalid_request\", \"params must be an object.\");\n\t}\n\treturn {\n\t\tv: TERMINAL_BRIDGE_VERSION,\n\t\ttype: \"request\",\n\t\tid: value.id,\n\t\tgeneration: value.generation as number,\n\t\tcommand: value.command,\n\t\tparams: value.params,\n\t};\n}\n\nexport class TerminalWebBridge {\n\tprivate pendingCommands = 0;\n\tprivate deleting = false;\n\tprivate readonly requestContext = new AsyncLocalStorage<{ request: RequestFrame; client: ClientState }>();\n\tprivate deletionOwner: { request: RequestFrame; client: ClientState } | undefined;\n\n\t/** Gate new commands synchronously before the owner checks/disposes its idle writer. */\n\treserveDeletion(preserveConnection: boolean): () => void {\n\t\tconst owner = preserveConnection ? this.requestContext.getStore() : undefined;\n\t\tif (preserveConnection && owner?.request.command !== \"delete_session\") {\n\t\t\tthrow new RequestError(\"invalid_request\", \"Connection preservation requires its deletion request.\");\n\t\t}\n\t\tif (this.deleting || this.pendingCommands > (preserveConnection ? 1 : 0) || this.questions.getPending()) {\n\t\t\tthrow new RequestError(\"busy\", \"Session has pending bridge commands or a question.\");\n\t\t}\n\t\tthis.deleting = true;\n\t\tthis.deletionOwner = owner;\n\t\treturn () => {\n\t\t\tthis.deleting = false;\n\t\t\tthis.deletionOwner = undefined;\n\t\t};\n\t}\n\n\tasync finishDeletion(): Promise<void> {\n\t\tthis.deletionOwner = undefined;\n\t\tawait this.stop();\n\t}\n\tprivate readonly pi: ExtensionAPI;\n\tprivate readonly options: TerminalWebBridgeOptions;\n\tprivate readonly instanceId = randomUUID().replaceAll(\"-\", \"\").slice(0, 24);\n\tprivate readonly authToken = randomBytes(32).toString(\"base64url\");\n\tprivate readonly startedAt = new Date().toISOString();\n\tprivate readonly clients = new Set<ClientState>();\n\tprivate readonly eventHistory: { sequence: number; encoded: Buffer }[] = [];\n\tprivate eventHistoryBytes = 0;\n\tprivate lastUnreplayableSequence = 0;\n\tprivate readonly maxFrameBytes: number;\n\tprivate readonly maxBufferedBytes: number;\n\tprivate readonly maxClients: number;\n\tprivate server: Server | undefined;\n\tprivate context: ExtensionContext | undefined;\n\tprivate paths: BridgePaths | undefined;\n\tprivate descriptor: TerminalBridgeDescriptor | undefined;\n\tprivate generation = 0;\n\tprivate sequence = 0;\n\tprivate commandQueue: Promise<void> = Promise.resolve();\n\tprivate lifecycleQueue: Promise<void> = Promise.resolve();\n\tprivate binding = new AbortController();\n\tprivate sidecarResult: SpWebLaunchResult | undefined;\n\tprivate readonly questions: QuestionInteraction;\n\tprivate unsubscribeQuestions: (() => void) | undefined;\n\n\tconstructor(pi: ExtensionAPI, options: TerminalWebBridgeOptions = {}) {\n\t\tthis.pi = pi;\n\t\tthis.questions = getQuestionInteraction(pi);\n\t\tthis.questions.webOnly = options.webOwned === true;\n\t\tthis.options = options;\n\t\tthis.maxFrameBytes = options.maxFrameBytes ?? DEFAULT_TERMINAL_BRIDGE_MAX_FRAME_BYTES;\n\t\tthis.maxBufferedBytes = options.maxBufferedBytes ?? DEFAULT_TERMINAL_BRIDGE_MAX_BUFFERED_BYTES;\n\t\tthis.maxClients = options.maxClients ?? DEFAULT_TERMINAL_BRIDGE_MAX_CLIENTS;\n\t}\n\n\tgetDescriptor() {\n\t\treturn this.descriptor;\n\t}\n\n\tgetSidecarResult() {\n\t\treturn this.sidecarResult;\n\t}\n\n\tstart(context: ExtensionContext) {\n\t\tconst task = this.lifecycleQueue.then(() => this.startServer(context));\n\t\tthis.lifecycleQueue = task.catch(() => {});\n\t\treturn task;\n\t}\n\n\tprivate async startServer(context: ExtensionContext) {\n\t\tif (context.mode !== \"tui\" && !this.options.webOwned) {\n\t\t\tawait this.stopServer();\n\t\t\treturn;\n\t\t}\n\t\tthis.context = context;\n\t\tif (process.platform === \"win32\") throw new Error(\"The SP terminal bridge requires Unix sockets.\");\n\t\tif (this.server) {\n\t\t\tthis.advanceGeneration(context);\n\t\t\tthis.options.onReady?.(this);\n\t\t\treturn;\n\t\t}\n\n\t\tconst agentDir = this.options.agentDir ?? getSpAgentDir();\n\t\tthis.paths = makePaths(agentDir, this.instanceId);\n\t\tensurePrivateDirectory(this.paths.rootDir);\n\t\tensurePrivateDirectory(this.paths.discoveryDir);\n\t\tensurePrivateDirectory(this.paths.socketDir);\n\t\tif (Buffer.byteLength(this.paths.socketPath, \"utf8\") > 103) {\n\t\t\tthrow new Error(`SP terminal bridge socket path is too long: ${this.paths.socketPath}`);\n\t\t}\n\t\tremoveFile(this.paths.socketPath);\n\n\t\tconst server = createServer((socket) => this.acceptClient(socket));\n\t\tserver.on(\"error\", () => {});\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tconst onError = (error: Error) => {\n\t\t\t\tserver.off(\"listening\", onListening);\n\t\t\t\treject(error);\n\t\t\t};\n\t\t\tconst onListening = () => {\n\t\t\t\tserver.off(\"error\", onError);\n\t\t\t\tresolve();\n\t\t\t};\n\t\t\tserver.once(\"error\", onError);\n\t\t\tserver.once(\"listening\", onListening);\n\t\t\tserver.listen(this.paths?.socketPath);\n\t\t});\n\t\tthis.server = server;\n\t\ttry {\n\t\t\tchmodSync(this.paths.socketPath, 0o600);\n\t\t\tthis.advanceGeneration(context);\n\t\t\tthis.unsubscribeQuestions = this.questions.subscribe((event, ctx) => this.publish(\"interaction\", event, ctx));\n\t\t\tthis.options.onReady?.(this);\n\t\t\tif (this.options.launchSpWeb !== false) {\n\t\t\t\tthis.sidecarResult = ensureSpWebSidecar(this.paths.discoveryDir, this.options.launcherOptions);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tawait this.stopServer();\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tupdateContext(context: ExtensionContext) {\n\t\tthis.context = context;\n\t}\n\n\tadvanceGeneration(context: ExtensionContext) {\n\t\tthis.binding.abort();\n\t\tthis.binding = new AbortController();\n\t\tthis.questions.cancel();\n\t\tthis.context = context;\n\t\tif (!this.paths) return;\n\t\tthis.generation += 1;\n\t\tthis.commandQueue = Promise.resolve();\n\t\tthis.sequence = 0;\n\t\tthis.eventHistory.splice(0);\n\t\tthis.eventHistoryBytes = 0;\n\t\tthis.lastUnreplayableSequence = 0;\n\t\tfor (const client of this.clients) client.socket.destroy();\n\t\tthis.descriptor = {\n\t\t\tversion: TERMINAL_BRIDGE_VERSION,\n\t\t\tprotocol: TERMINAL_BRIDGE_PROTOCOL,\n\t\t\tinstanceId: this.instanceId,\n\t\t\tpid: process.pid,\n\t\t\tsessionId: context.sessionManager.getSessionId(),\n\t\t\tsessionFile: context.sessionManager.getSessionFile(),\n\t\t\tcwd: context.cwd,\n\t\t\tsocketPath: this.paths.socketPath,\n\t\t\tauthToken: this.authToken,\n\t\t\tgeneration: this.generation,\n\t\t\tstartedAt: this.startedAt,\n\t\t\t...(this.options.writerLeaseVersion ? { writerLeaseVersion: this.options.writerLeaseVersion } : {}),\n\t\t\tframe: { encoding: \"newline-delimited-json\", maxBytes: this.maxFrameBytes },\n\t\t};\n\t\tconst temporaryPath = `${this.paths.descriptorPath}.${process.pid}.tmp`;\n\t\twriteFileSync(temporaryPath, `${JSON.stringify(this.descriptor, null, \"\\t\")}\\n`, {\n\t\t\tencoding: \"utf8\",\n\t\t\tmode: 0o600,\n\t\t});\n\t\tchmodSync(temporaryPath, 0o600);\n\t\trenameSync(temporaryPath, this.paths.descriptorPath);\n\t\tchmodSync(this.paths.descriptorPath, 0o600);\n\t}\n\n\tpublish(category: EventFrame[\"category\"], event: { type: string }, context: ExtensionContext) {\n\t\tthis.context = context;\n\t\tif (!this.server) return;\n\t\tconst frame: EventFrame = {\n\t\t\tv: TERMINAL_BRIDGE_VERSION,\n\t\t\ttype: \"event\",\n\t\t\tgeneration: this.generation,\n\t\t\tsequence: ++this.sequence,\n\t\t\tevent: event.type,\n\t\t\tcategory,\n\t\t\tpayload: normalizeForJson(event),\n\t\t};\n\t\tlet encoded: Buffer;\n\t\ttry {\n\t\t\tencoded = this.encode(frame);\n\t\t} catch {\n\t\t\t// Never claim that replay can cross an event we could not forward.\n\t\t\tthis.lastUnreplayableSequence = frame.sequence;\n\t\t\tframe.event = \"event_gap\";\n\t\t\tframe.category = \"session\";\n\t\t\tframe.payload = { type: \"event_gap\", code: \"event_gap\", resyncRequired: true };\n\t\t\ttry {\n\t\t\t\tencoded = this.encode(frame);\n\t\t\t} catch {\n\t\t\t\tfor (const client of this.clients) {\n\t\t\t\t\tif (client.subscribed) client.socket.destroy();\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t\tthis.eventHistory.push({ sequence: frame.sequence, encoded });\n\t\tthis.eventHistoryBytes += encoded.length;\n\t\twhile (this.eventHistory.length > MAX_EVENT_HISTORY || this.eventHistoryBytes > MAX_EVENT_HISTORY_BYTES) {\n\t\t\tthis.eventHistoryBytes -= this.eventHistory.shift()!.encoded.length;\n\t\t}\n\t\tfor (const client of this.clients) {\n\t\t\tif (client.authenticated && client.subscribed) {\n\t\t\t\tthis.writeEncoded(client, encoded);\n\t\t\t\tif (frame.event === \"event_gap\") {\n\t\t\t\t\tclient.subscribed = false;\n\t\t\t\t\t// Older clients also recover through their connection-close snapshot path.\n\t\t\t\t\tclient.socket.end();\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tstop() {\n\t\t// The native delete response must drain before session_shutdown closes its socket.\n\t\tif (this.deletionOwner) return Promise.resolve();\n\t\t// Invalidate commands immediately, even if socket startup has not settled.\n\t\tthis.questions.cancel();\n\t\tthis.binding.abort();\n\t\tthis.context = undefined;\n\t\tfor (const client of this.clients) client.socket.destroy();\n\t\tconst task = this.lifecycleQueue.then(() => this.stopServer());\n\t\tthis.lifecycleQueue = task.catch(() => {});\n\t\treturn task;\n\t}\n\n\t/** Synchronous fallback for process.exit, which cannot await socket shutdown. */\n\tcleanupOnExit() {\n\t\tthis.binding.abort();\n\t\tthis.questions.cancel();\n\t\tfor (const client of this.clients) client.socket.destroy();\n\t\tif (this.paths) {\n\t\t\ttry {\n\t\t\t\tconst value = JSON.parse(readFileSync(this.paths.descriptorPath, \"utf8\")) as unknown;\n\t\t\t\tif (isRecord(value) && value.instanceId === this.instanceId) removeFile(this.paths.descriptorPath);\n\t\t\t} catch (error) {\n\t\t\t\tif (!isMissingFileError(error) && !(error instanceof SyntaxError)) throw error;\n\t\t\t}\n\t\t\tremoveFile(this.paths.socketPath);\n\t\t}\n\t}\n\n\tprivate async stopServer() {\n\t\tthis.binding.abort();\n\t\tthis.questions.cancel();\n\t\tthis.context = undefined;\n\t\tthis.commandQueue = Promise.resolve();\n\t\tthis.unsubscribeQuestions?.();\n\t\tthis.unsubscribeQuestions = undefined;\n\t\tconst server = this.server;\n\t\tthis.server = undefined;\n\t\tfor (const client of this.clients) client.socket.destroy();\n\t\tthis.clients.clear();\n\t\tthis.eventHistory.splice(0);\n\t\tthis.eventHistoryBytes = 0;\n\t\tif (server) {\n\t\t\tawait new Promise<void>((resolve) => server.close(() => resolve()));\n\t\t}\n\t\tconst paths = this.paths;\n\t\tif (paths) {\n\t\t\ttry {\n\t\t\t\tconst value = JSON.parse(readFileSync(paths.descriptorPath, \"utf8\")) as unknown;\n\t\t\t\tif (isRecord(value) && value.instanceId === this.instanceId) removeFile(paths.descriptorPath);\n\t\t\t} catch (error) {\n\t\t\t\tif (!isMissingFileError(error) && !(error instanceof SyntaxError)) throw error;\n\t\t\t}\n\t\t\tremoveFile(paths.socketPath);\n\t\t}\n\t\tthis.descriptor = undefined;\n\t\tthis.options.sessions?.bridgeStopped?.(this);\n\t}\n\n\tprivate acceptClient(socket: Socket) {\n\t\tif (this.clients.size >= this.maxClients) {\n\t\t\tsocket.on(\"error\", () => {});\n\t\t\tsocket.end(`${JSON.stringify({ v: 1, type: \"error\", code: \"too_many_clients\" })}\\n`, () => socket.destroy());\n\t\t\treturn;\n\t\t}\n\t\tsocket.setNoDelay(true);\n\t\tconst client: ClientState = {\n\t\t\tsocket,\n\t\t\tbuffer: Buffer.alloc(0),\n\t\t\tauthenticated: false,\n\t\t\tsubscribed: false,\n\t\t\tpendingRequests: 0,\n\t\t\tseenRequestIds: new Set(),\n\t\t};\n\t\tthis.clients.add(client);\n\t\tsocket.on(\"data\", (chunk: Buffer) => this.receive(client, chunk));\n\t\tsocket.on(\"error\", () => {});\n\t\tsocket.on(\"close\", () => this.clients.delete(client));\n\t}\n\n\tprivate receive(client: ClientState, chunk: Buffer) {\n\t\tif (client.socket.destroyed || client.socket.writableEnded) return;\n\t\tclient.buffer = Buffer.concat([client.buffer, chunk]);\n\t\tif (client.buffer.length > this.maxFrameBytes && client.buffer.indexOf(0x0a) === -1) {\n\t\t\tclient.socket.destroy();\n\t\t\treturn;\n\t\t}\n\t\tlet newline = client.buffer.indexOf(0x0a);\n\t\twhile (newline !== -1) {\n\t\t\tconst frame = client.buffer.subarray(0, newline);\n\t\t\tclient.buffer = client.buffer.subarray(newline + 1);\n\t\t\tif (frame.length + 1 > this.maxFrameBytes || frame.length === 0) {\n\t\t\t\tclient.socket.destroy();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tlet value: unknown;\n\t\t\ttry {\n\t\t\t\tvalue = JSON.parse(frame.toString(\"utf8\")) as unknown;\n\t\t\t} catch {\n\t\t\t\tclient.socket.destroy();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (!isRecord(value)) {\n\t\t\t\tclient.socket.destroy();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (!client.authenticated) {\n\t\t\t\tthis.authenticate(client, value);\n\t\t\t\tif (!client.authenticated) return;\n\t\t\t} else {\n\t\t\t\tthis.acceptRequest(client, value);\n\t\t\t}\n\t\t\tnewline = client.buffer.indexOf(0x0a);\n\t\t}\n\t\tif (client.buffer.length >= this.maxFrameBytes) client.socket.destroy();\n\t}\n\n\tprivate authenticate(client: ClientState, value: JsonRecord) {\n\t\tif (value.v !== TERMINAL_BRIDGE_VERSION || value.type !== \"hello\" || !tokenMatches(this.authToken, value.token)) {\n\t\t\tthis.send(client, { v: 1, type: \"hello\", ok: false, error: \"authentication_failed\" });\n\t\t\tclient.socket.end();\n\t\t\treturn;\n\t\t}\n\t\tclient.authenticated = true;\n\t\tthis.send(client, {\n\t\t\tv: TERMINAL_BRIDGE_VERSION,\n\t\t\ttype: \"hello\",\n\t\t\tok: true,\n\t\t\tprotocol: TERMINAL_BRIDGE_PROTOCOL,\n\t\t\tgeneration: this.generation,\n\t\t\tsequence: this.sequence,\n\t\t\tinstanceId: this.instanceId,\n\t\t});\n\t}\n\n\tprivate acceptRequest(client: ClientState, value: JsonRecord) {\n\t\tlet request: RequestFrame;\n\t\ttry {\n\t\t\trequest = parseRequest(value);\n\t\t} catch (error) {\n\t\t\tthis.sendRequestError(client, typeof value.id === \"string\" ? value.id : null, error);\n\t\t\treturn;\n\t\t}\n\t\tif (client.seenRequestIds.has(request.id)) {\n\t\t\tthis.sendRequestError(\n\t\t\t\tclient,\n\t\t\t\trequest.id,\n\t\t\t\tnew RequestError(\"duplicate_request\", \"Request ID was already used.\"),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\tclient.seenRequestIds.add(request.id);\n\t\tif (client.seenRequestIds.size > MAX_SEEN_REQUEST_IDS) {\n\t\t\tconst oldest = client.seenRequestIds.values().next().value as string | undefined;\n\t\t\tif (oldest) client.seenRequestIds.delete(oldest);\n\t\t}\n\t\tif (client.pendingRequests >= MAX_PENDING_REQUESTS) {\n\t\t\tthis.sendRequestError(client, request.id, new RequestError(\"too_many_requests\", \"Too many pending requests.\"));\n\t\t\treturn;\n\t\t}\n\t\tclient.pendingRequests += 1;\n\t\tthis.pendingCommands++;\n\t\t// Reads and turn cancellation/answers must not wait for model auth or title inference.\n\t\tconst independent = [\n\t\t\t\"state\",\n\t\t\t\"snapshot\",\n\t\t\t\"transcript\",\n\t\t\t\"models\",\n\t\t\t\"subscribe\",\n\t\t\t\"respond_to_question\",\n\t\t\t\"abort\",\n\t\t\t\"create_session\",\n\t\t\t\"resume_session\",\n\t\t\t\"delete_session\",\n\t\t].includes(request.command);\n\t\tconst task = (independent ? Promise.resolve() : this.commandQueue)\n\t\t\t.then(async () => {\n\t\t\t\tconst result = await this.requestContext.run({ request, client }, () => this.execute(request, client));\n\t\t\t\tif (request.command === \"delete_session\") {\n\t\t\t\t\tawait this.writeReplay(client, this.encode(this.successFrame(request.id, result)));\n\t\t\t\t} else {\n\t\t\t\t\tthis.sendSuccess(client, request.id, result);\n\t\t\t\t}\n\t\t\t})\n\t\t\t.catch(async (error: unknown) => {\n\t\t\t\tthis.sendRequestError(client, request.id, error);\n\t\t\t\tif (request.command === \"delete_session\") {\n\t\t\t\t\t// Drain error acknowledgements as well when disposal succeeded but unlink failed.\n\t\t\t\t\tawait this.writeReplay(client, Buffer.alloc(0)).catch(() => {});\n\t\t\t\t}\n\t\t\t})\n\t\t\t.finally(() => {\n\t\t\t\tclient.pendingRequests -= 1;\n\t\t\t\tthis.pendingCommands--;\n\t\t\t\tif (this.deletionOwner?.request === request && this.deletionOwner.client === client) {\n\t\t\t\t\tvoid this.finishDeletion().catch(() => {});\n\t\t\t\t}\n\t\t\t});\n\t\tif (!independent) this.commandQueue = task;\n\t}\n\n\tprivate async execute(request: RequestFrame, client: ClientState): Promise<unknown> {\n\t\tif (!this.server || client.socket.destroyed || client.socket.writableEnded) {\n\t\t\tthrow new RequestError(\"not_ready\", \"Connection is closed.\");\n\t\t}\n\t\tif (request.generation !== this.generation) {\n\t\t\tthrow new RequestError(\"stale_generation\", `Current generation is ${this.generation}.`);\n\t\t}\n\t\tconst context = this.context;\n\t\tif (!context) throw new RequestError(\"not_ready\", \"Session context is not ready.\");\n\t\tif (this.deleting) throw new RequestError(\"busy\", \"Session deletion is reserved.\");\n\t\tconst params = request.params ?? {};\n\t\tswitch (request.command) {\n\t\t\tcase \"delete_session\":\n\t\t\t\tif (!this.options.sessions?.deleteSession) {\n\t\t\t\t\tthrow new RequestError(\"unsupported_command\", \"No deletion provider available.\");\n\t\t\t\t}\n\t\t\t\tif (params.confirmed !== true) throw new RequestError(\"invalid_params\", \"confirmed must be true.\");\n\t\t\t\treturn this.options.sessions.deleteSession(\n\t\t\t\t\t{\n\t\t\t\t\t\tsessionId: requireString(params.sessionId, \"sessionId\", 256),\n\t\t\t\t\t\t...(params.sessionFile !== undefined\n\t\t\t\t\t\t\t? { sessionFile: requireString(params.sessionFile, \"sessionFile\", 4096) }\n\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\tconfirmed: true,\n\t\t\t\t\t},\n\t\t\t\t\tthis,\n\t\t\t\t);\n\t\t\tcase \"create_session\":\n\t\t\t\tif (!this.options.sessions) throw new RequestError(\"unsupported_command\", \"No session factory available.\");\n\t\t\t\treturn this.options.sessions.create(requireString(params.cwd, \"cwd\", 4096));\n\t\t\tcase \"resume_session\":\n\t\t\t\tif (!this.options.sessions) throw new RequestError(\"unsupported_command\", \"No session factory available.\");\n\t\t\t\treturn this.options.sessions.resume(requireString(params.sessionFile, \"sessionFile\", 4096));\n\t\t\tcase \"respond_to_question\":\n\t\t\t\tthis.questions.respond(requireString(params.interactionId, \"interactionId\", 128), params.response);\n\t\t\t\treturn { accepted: true };\n\t\t\tcase \"snapshot\": {\n\t\t\t\tconst entries = context.sessionManager.getEntries();\n\t\t\t\tconst state = this.stateSnapshot(context);\n\t\t\t\treturn this.transcriptPage(request.id, entries, 0, MAX_TRANSCRIPT_PAGE_SIZE, state);\n\t\t\t}\n\t\t\tcase \"state\":\n\t\t\t\treturn this.stateSnapshot(context);\n\t\t\tcase \"transcript\": {\n\t\t\t\tconst entries = context.sessionManager.getEntries();\n\t\t\t\tconst cursor = optionalInteger(params.cursor, \"cursor\", 0);\n\t\t\t\tconst limit = Math.min(optionalInteger(params.limit, \"limit\", 50), MAX_TRANSCRIPT_PAGE_SIZE);\n\t\t\t\treturn this.transcriptPage(request.id, entries, cursor, limit);\n\t\t\t}\n\t\t\tcase \"models\":\n\t\t\t\treturn {\n\t\t\t\t\tmodels: availableModels(context),\n\t\t\t\t\tcurrent: context.model ? { provider: context.model.provider, modelId: context.model.id } : null,\n\t\t\t\t};\n\t\t\tcase \"generate_title\":\n\t\t\t\treturn (this.options.titleGenerator ?? generateTitle)(context, this.pi, this.binding.signal);\n\t\t\tcase \"subscribe\": {\n\t\t\t\tlet afterSequence = optionalInteger(params.afterSequence, \"afterSequence\", this.sequence);\n\t\t\t\tclient.subscribed = false;\n\t\t\t\tfor (;;) {\n\t\t\t\t\t// Recheck after each drained write: publishing can evict history while replay waits.\n\t\t\t\t\tconst earliestSequence = this.eventHistory[0]?.sequence ?? this.sequence + 1;\n\t\t\t\t\tif (\n\t\t\t\t\t\tafterSequence < earliestSequence - 1 ||\n\t\t\t\t\t\tafterSequence < this.lastUnreplayableSequence ||\n\t\t\t\t\t\tafterSequence > this.sequence\n\t\t\t\t\t) {\n\t\t\t\t\t\tthrow new RequestError(\"event_gap\", `Earliest retained sequence is ${earliestSequence}.`);\n\t\t\t\t\t}\n\t\t\t\t\tconst event = this.eventHistory.find((entry) => entry.sequence > afterSequence);\n\t\t\t\t\tif (!event) break;\n\t\t\t\t\tawait this.writeReplay(client, event.encoded);\n\t\t\t\t\tafterSequence = event.sequence;\n\t\t\t\t}\n\t\t\t\tclient.subscribed = true;\n\t\t\t\treturn { subscribed: true, sequence: this.sequence };\n\t\t\t}\n\t\t\tcase \"prompt\":\n\t\t\t\tif (!context.isIdle()) throw new RequestError(\"busy\", \"Use steer or follow_up while the agent is running.\");\n\t\t\t\tthis.pi.sendUserMessage(userMessageContent(params), {\n\t\t\t\t\texpandPromptTemplates: params.expandPromptTemplates === true,\n\t\t\t\t});\n\t\t\t\treturn { accepted: true };\n\t\t\tcase \"steer\":\n\t\t\t\tif (context.isIdle()) throw new RequestError(\"idle\", \"There is no running turn to steer.\");\n\t\t\t\tthis.pi.sendUserMessage(userMessageContent(params), { deliverAs: \"steer\" });\n\t\t\t\treturn { accepted: true };\n\t\t\tcase \"follow_up\":\n\t\t\t\tif (context.isIdle()) throw new RequestError(\"idle\", \"There is no running turn to queue a follow-up for.\");\n\t\t\t\tthis.pi.sendUserMessage(userMessageContent(params), { deliverAs: \"followUp\" });\n\t\t\t\treturn { accepted: true };\n\t\t\tcase \"abort\":\n\t\t\t\tif (context.isIdle()) throw new RequestError(\"idle\", \"There is no running turn to abort.\");\n\t\t\t\tthis.questions.cancel();\n\t\t\t\tcontext.abort();\n\t\t\t\treturn { accepted: true };\n\t\t\tcase \"set_thinking\": {\n\t\t\t\tif (!context.isIdle()) throw new RequestError(\"busy\", \"Thinking level can only change while idle.\");\n\t\t\t\tconst level = requireString(params.level, \"level\", 16);\n\t\t\t\tif (!THINKING_LEVELS.includes(level as ThinkingLevel)) {\n\t\t\t\t\tthrow new RequestError(\"invalid_params\", `Unsupported thinking level: ${level}`);\n\t\t\t\t}\n\t\t\t\tthis.pi.setThinkingLevel(level as ThinkingLevel);\n\t\t\t\treturn { accepted: true, level: this.pi.getThinkingLevel() };\n\t\t\t}\n\t\t\tcase \"set_model\": {\n\t\t\t\tif (!context.isIdle()) throw new RequestError(\"busy\", \"Model can only change while idle.\");\n\t\t\t\tconst provider = requireString(params.provider, \"provider\", 256);\n\t\t\t\tconst modelId = requireString(params.modelId, \"modelId\", 512);\n\t\t\t\tif (provider !== \"sp-gateway\") {\n\t\t\t\t\tthrow new RequestError(\"model_out_of_scope\", \"Only sp-gateway models are available in SP.\");\n\t\t\t\t}\n\t\t\t\tconst model = context.modelRegistry.find(provider, modelId);\n\t\t\t\tif (!model) throw new RequestError(\"model_unavailable\", `Model is not available: ${provider}/${modelId}`);\n\t\t\t\tif (\n\t\t\t\t\tcontext.scopedModels.length > 0 &&\n\t\t\t\t\t!context.scopedModels.some((entry) => entry.model.provider === provider && entry.model.id === modelId)\n\t\t\t\t) {\n\t\t\t\t\tthrow new RequestError(\n\t\t\t\t\t\t\"model_out_of_scope\",\n\t\t\t\t\t\t`Model is outside this session's model scope: ${provider}/${modelId}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tif (!(await this.pi.setModel(model))) {\n\t\t\t\t\tthrow new RequestError(\"model_auth_unavailable\", `No usable credentials for ${provider}/${modelId}.`);\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\taccepted: true,\n\t\t\t\t\tmodel: { provider: model.provider, id: model.id, name: model.name, input: model.input },\n\t\t\t\t};\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\tthrow new RequestError(\"unsupported_command\", `Unsupported command: ${request.command}`);\n\t\t}\n\t}\n\n\tprivate stateSnapshot(context: ExtensionContext) {\n\t\tconst model = context.model;\n\t\treturn {\n\t\t\tprotocol: TERMINAL_BRIDGE_PROTOCOL,\n\t\t\tgeneration: this.generation,\n\t\t\tsequence: this.sequence,\n\t\t\tsession: {\n\t\t\t\tid: context.sessionManager.getSessionId(),\n\t\t\t\tfile: context.sessionManager.getSessionFile(),\n\t\t\t\tname: context.sessionManager.getSessionName(),\n\t\t\t\tcwd: context.cwd,\n\t\t\t\tentryCount: context.sessionManager.getEntries().length,\n\t\t\t\tactiveLeafId: context.sessionManager.getLeafId(),\n\t\t\t},\n\t\t\tstatus: {\n\t\t\t\tidle: context.isIdle(),\n\t\t\t\thasPendingMessages: context.hasPendingMessages(),\n\t\t\t\tcontextUsage: context.getContextUsage(),\n\t\t\t},\n\t\t\tmodel: model ? { provider: model.provider, id: model.id, name: model.name, input: model.input } : null,\n\t\t\tthinkingLevel: this.pi.getThinkingLevel(),\n\t\t\tpendingQuestion: this.questions.getPending(),\n\t\t\tcapabilities: {\n\t\t\t\tsnapshot: true,\n\t\t\t\tstate: true,\n\t\t\t\ttranscript: { paginated: true, maximumPageSize: MAX_TRANSCRIPT_PAGE_SIZE },\n\t\t\t\teventStream: { replayLimit: MAX_EVENT_HISTORY, replayByteLimit: MAX_EVENT_HISTORY_BYTES },\n\t\t\t\tprompt: true,\n\t\t\t\timages: true,\n\t\t\t\timageLimits: TERMINAL_BRIDGE_IMAGE_LIMITS,\n\t\t\t\tsteer: true,\n\t\t\t\tfollowUp: true,\n\t\t\t\tabort: true,\n\t\t\t\tsetThinking: true,\n\t\t\t\tsetModel: \"available-and-session-scoped-models-only\",\n\t\t\t\tmodels: true,\n\t\t\t\tgenerateTitle: true,\n\t\t\t\trespondToQuestion: true,\n\t\t\t\tnewSession: !!this.options.sessions,\n\t\t\t\tresumeSession: !!this.options.sessions,\n\t\t\t\tforkSession: false,\n\t\t\t\tdeleteSession: !!this.options.sessions?.deleteSession,\n\t\t\t\tdirectJsonlAccess: false,\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate transcriptPage(id: string, entries: unknown[], cursor: number, limit: number, state?: unknown) {\n\t\tconst page = {\n\t\t\tcursor,\n\t\t\tnextCursor: (cursor < entries.length ? cursor : null) as number | null,\n\t\t\ttotal: entries.length,\n\t\t\tentries: [] as unknown[],\n\t\t};\n\t\tconst result = state === undefined ? page : { state, transcript: page };\n\t\t// Count the exact envelope, including escaped request ID, state and newline.\n\t\tlet bytes = this.encode(this.successFrame(id, result)).length;\n\t\tfor (const entry of entries.slice(cursor, cursor + limit)) {\n\t\t\tconst normalized = normalizeForJson(entry);\n\t\t\tconst nextCursor = cursor + page.entries.length + 1 < entries.length ? cursor + page.entries.length + 1 : null;\n\t\t\tconst addedBytes =\n\t\t\t\tBuffer.byteLength(JSON.stringify(normalized), \"utf8\") +\n\t\t\t\t(page.entries.length > 0 ? 1 : 0) +\n\t\t\t\tJSON.stringify(nextCursor).length -\n\t\t\t\tJSON.stringify(page.nextCursor).length;\n\t\t\tif (bytes + addedBytes > this.maxFrameBytes) {\n\t\t\t\tif (page.entries.length === 0) {\n\t\t\t\t\tthrow new RequestError(\n\t\t\t\t\t\t\"frame_too_large\",\n\t\t\t\t\t\t`Transcript entry at cursor ${cursor} cannot fit in the response.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tpage.entries.push(normalized);\n\t\t\tpage.nextCursor = nextCursor;\n\t\t\tbytes += addedBytes;\n\t\t}\n\t\treturn result;\n\t}\n\n\tprivate sendRequestError(client: ClientState, id: string | null, error: unknown) {\n\t\tconst code =\n\t\t\terror instanceof RequestError || error instanceof QuestionResponseError\n\t\t\t\t? error.code\n\t\t\t\t: error instanceof Error && \"code\" in error && typeof error.code === \"string\"\n\t\t\t\t\t? error.code\n\t\t\t\t\t: \"internal_error\";\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthis.send(client, {\n\t\t\tv: TERMINAL_BRIDGE_VERSION,\n\t\t\ttype: \"response\",\n\t\t\tid,\n\t\t\tgeneration: this.generation,\n\t\t\tok: false,\n\t\t\terror: { code, message },\n\t\t});\n\t}\n\n\tprivate successFrame(id: string, result: unknown) {\n\t\treturn {\n\t\t\tv: TERMINAL_BRIDGE_VERSION,\n\t\t\ttype: \"response\",\n\t\t\tid,\n\t\t\tgeneration: this.generation,\n\t\t\tok: true,\n\t\t\tresult,\n\t\t};\n\t}\n\n\tprivate sendSuccess(client: ClientState, id: string, result: unknown) {\n\t\ttry {\n\t\t\tthis.writeEncoded(client, this.encode(this.successFrame(id, result)));\n\t\t} catch (error) {\n\t\t\tthis.sendRequestError(client, id, error);\n\t\t}\n\t}\n\n\tprivate encode(value: unknown) {\n\t\tconst encoded = Buffer.from(`${JSON.stringify(value)}\\n`, \"utf8\");\n\t\tif (encoded.length > this.maxFrameBytes) throw new RequestError(\"frame_too_large\", \"Frame exceeds the limit.\");\n\t\treturn encoded;\n\t}\n\n\tprivate send(client: ClientState, value: unknown) {\n\t\tif (client.socket.destroyed) return;\n\t\ttry {\n\t\t\tthis.writeEncoded(client, this.encode(value));\n\t\t} catch {\n\t\t\tclient.socket.destroy();\n\t\t}\n\t}\n\n\tprivate writeEncoded(client: ClientState, encoded: Buffer) {\n\t\tif (client.socket.destroyed) return;\n\t\tif (client.socket.writableLength + encoded.length > this.maxBufferedBytes) {\n\t\t\tclient.socket.destroy();\n\t\t\treturn;\n\t\t}\n\t\tclient.socket.write(encoded);\n\t}\n\n\tprivate writeReplay(client: ClientState, encoded: Buffer) {\n\t\treturn new Promise<void>((resolve, reject) => {\n\t\t\tconst socket = client.socket;\n\t\t\tif (\n\t\t\t\tsocket.destroyed ||\n\t\t\t\tsocket.writableEnded ||\n\t\t\t\tsocket.writableLength + encoded.length > this.maxBufferedBytes\n\t\t\t) {\n\t\t\t\tsocket.destroy();\n\t\t\t\treject(new RequestError(\"not_ready\", \"Replay connection is closed or exceeds the output limit.\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst onClose = () => reject(new RequestError(\"not_ready\", \"Replay connection is closed.\"));\n\t\t\tsocket.once(\"close\", onClose);\n\t\t\t// Drain one frame before enqueueing the next, rather than overflowing the client\n\t\t\t// buffer with an otherwise valid multi-image replay.\n\t\t\tsocket.write(encoded, (error) => {\n\t\t\t\tsocket.off(\"close\", onClose);\n\t\t\t\tif (error) reject(error);\n\t\t\t\telse resolve();\n\t\t\t});\n\t\t});\n\t}\n}\n\nexport function registerTerminalWebBridge(pi: ExtensionAPI, options: TerminalWebBridgeOptions = {}) {\n\tconst bridge = new TerminalWebBridge(pi, options);\n\tpi.on(\"session_start\", async (event, context) => {\n\t\ttry {\n\t\t\tif (context.mode === \"tui\" && !options.webOwned) options.sessions?.terminalStarted(context);\n\t\t\tawait bridge.start(context);\n\t\t\tbridge.publish(\"session\", event, context);\n\t\t\tconst sidecar = bridge.getSidecarResult();\n\t\t\tif (sidecar?.status === \"failed\") context.ui.notify(`SP Web sidecar failed: ${sidecar.error}`, \"warning\");\n\t\t} catch (error) {\n\t\t\tcontext.ui.notify(\n\t\t\t\t`SP terminal bridge failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\"warning\",\n\t\t\t);\n\t\t}\n\t});\n\tpi.on(\"session_info_changed\", (event, context) => bridge.publish(\"session\", event, context));\n\tpi.on(\"session_compact\", (event, context) => bridge.publish(\"session\", event, context));\n\tpi.on(\"session_compact_failed\", (event, context) => bridge.publish(\"session\", event, context));\n\tpi.on(\"session_tree\", (event, context) => bridge.publish(\"session\", event, context));\n\tpi.on(\"agent_start\", (event, context) => bridge.publish(\"agent\", event, context));\n\tpi.on(\"agent_end\", (event, context) => bridge.publish(\"agent\", event, context));\n\tpi.on(\"agent_settled\", (event, context) => bridge.publish(\"agent\", event, context));\n\tpi.on(\"message_start\", (event, context) => bridge.publish(\"message\", event, context));\n\tpi.on(\"message_update\", (event, context) => bridge.publish(\"message\", event, context));\n\tpi.on(\"message_end\", (event, context) => bridge.publish(\"message\", event, context));\n\tpi.on(\"tool_execution_start\", (event, context) => bridge.publish(\"tool\", event, context));\n\tpi.on(\"tool_execution_update\", (event, context) => bridge.publish(\"tool\", event, context));\n\tpi.on(\"tool_execution_end\", (event, context) => bridge.publish(\"tool\", event, context));\n\tpi.on(\"model_select\", (event, context) => bridge.publish(\"model\", event, context));\n\tpi.on(\"thinking_level_select\", (event, context) => bridge.publish(\"thinking\", event, context));\n\tpi.on(\"session_shutdown\", async (event, context) => {\n\t\tbridge.publish(\"session\", event, context);\n\t\ttry {\n\t\t\tawait bridge.stop();\n\t\t\tif (event.reason === \"quit\" && !options.webOwned) await options.sessions?.dispose();\n\t\t} catch {\n\t\t\t// Cleanup failures must not stop SP shutdown.\n\t\t}\n\t});\n\treturn bridge;\n}\n\nexport function readTerminalBridgeDescriptor(path: string): TerminalBridgeDescriptor {\n\tconst value = JSON.parse(readFileSync(path, \"utf8\")) as TerminalBridgeDescriptor;\n\treturn value;\n}\n\nexport function terminalBridgeDescriptorExists(path: string) {\n\treturn existsSync(path);\n}\n"]}