@senpiper/sp-agent 0.1.6 → 0.1.9

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

@@ -0,0 +1,192 @@
+import { spawn } from "node:child_process";
+import { chmodSync, closeSync, constants, openSync, readFileSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+const SIDECAR_VERSION = 1;
+const SIDECAR_STATE_FILE = "sp-web-sidecar.json";
+const LEGACY_STATE_FILE = "pi-web-sidecar.json";
+// Keep one lock namespace while older SP launchers are still running.
+const SIDECAR_LOCK_FILE = "pi-web-sidecar.lock";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readState(path) {
+    try {
+        const value = JSON.parse(readFileSync(path, "utf8"));
+        if (!isRecord(value) ||
+            value.version !== SIDECAR_VERSION ||
+            typeof value.pid !== "number" ||
+            !Number.isSafeInteger(value.pid) ||
+            value.pid <= 0 ||
+            typeof value.executable !== "string" ||
+            !Array.isArray(value.args) ||
+            !value.args.every((entry) => typeof entry === "string") ||
+            typeof value.startedAt !== "string") {
+            return undefined;
+        }
+        return {
+            version: SIDECAR_VERSION,
+            pid: value.pid,
+            executable: value.executable,
+            args: value.args,
+            startedAt: value.startedAt,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function processIsRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return isRecord(error) && error.code === "EPERM";
+    }
+}
+function removeFile(path) {
+    try {
+        unlinkSync(path);
+    }
+    catch (error) {
+        if (!isRecord(error) || error.code !== "ENOENT")
+            throw error;
+    }
+}
+function writePrivateState(path, state) {
+    writeFileSync(path, `${JSON.stringify(state, null, "\t")}\n`, {
+        encoding: "utf8",
+        mode: 0o600,
+    });
+    if (process.platform !== "win32")
+        chmodSync(path, 0o600);
+}
+function parseArgs(env) {
+    const raw = env.SP_WEB_ARGS_JSON ?? env.SP_PI_WEB_ARGS_JSON;
+    if (!raw)
+        return [];
+    const value = JSON.parse(raw);
+    if (!Array.isArray(value) || !value.every((entry) => typeof entry === "string")) {
+        throw new Error("SP_WEB_ARGS_JSON must be a JSON array of strings.");
+    }
+    return value;
+}
+function disabled(env) {
+    return /^(?:1|true|yes)$/iu.test(env.SP_WEB_DISABLE ?? env.SP_PI_WEB_DISABLE ?? "");
+}
+export function resolveSpWebLaunch(env, runtime = { moduleUrl: import.meta.url, execPath: process.execPath, bun: !!process.versions.bun }) {
+    const args = parseArgs(env);
+    if (!args.includes("--no-open"))
+        args.push("--no-open");
+    const explicit = (env.SP_WEB_EXECUTABLE ?? env.SP_PI_WEB_EXECUTABLE)?.trim();
+    if (explicit)
+        return { executable: explicit, args };
+    // The module anchor handles Node installs. The executable anchor also handles
+    // compiled Bun binaries inside the npm package, whose module URL is virtual.
+    for (const anchor of [runtime.moduleUrl, runtime.execPath]) {
+        try {
+            const entry = createRequire(anchor).resolve("@senpiper/sp-web/bin/sp-web.js");
+            return { executable: runtime.bun ? "node" : runtime.execPath, args: [entry, ...args] };
+        }
+        catch (error) {
+            if (!isRecord(error) || error.code !== "MODULE_NOT_FOUND")
+                throw error;
+        }
+    }
+    // Standalone archives do not necessarily contain an npm dependency tree.
+    return { executable: "sp-web", args };
+}
+function lockIsStale(path, stat = statSync) {
+    try {
+        return Date.now() - stat(path).mtimeMs > 30_000;
+    }
+    catch {
+        return false;
+    }
+}
+export function ensureSpWebSidecar(discoveryDir, options = {}) {
+    const env = options.env ?? process.env;
+    if (disabled(env))
+        return { status: "disabled" };
+    const statePath = join(discoveryDir, SIDECAR_STATE_FILE);
+    const legacyPath = join(discoveryDir, LEGACY_STATE_FILE);
+    const lockPath = join(discoveryDir, SIDECAR_LOCK_FILE);
+    const isRunning = options.isProcessRunning ?? processIsRunning;
+    const liveState = () => [readState(statePath), readState(legacyPath)].find((state) => state && isRunning(state.pid));
+    const current = liveState();
+    if (current)
+        return { status: "reused", pid: current.pid };
+    let lockFd;
+    let ownsLock = false;
+    try {
+        try {
+            lockFd = openSync(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY, 0o600);
+            ownsLock = true;
+            writeFileSync(lockFd, `${process.pid}\n`, "utf8");
+        }
+        catch (error) {
+            if (!isRecord(error) || error.code !== "EEXIST")
+                throw error;
+            const racedState = liveState();
+            if (racedState)
+                return { status: "reused", pid: racedState.pid };
+            if (!lockIsStale(lockPath))
+                return { status: "pending" };
+            removeFile(lockPath);
+            lockFd = openSync(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY, 0o600);
+            ownsLock = true;
+            writeFileSync(lockFd, `${process.pid}\n`, "utf8");
+        }
+        const racedState = liveState();
+        if (racedState)
+            return { status: "reused", pid: racedState.pid };
+        const { executable, args } = resolveSpWebLaunch(env);
+        const childEnv = {
+            ...env,
+            SP_WEB_NO_OPEN: "1",
+            SP_TERMINAL_BRIDGE_ONLY: "1",
+            SP_TERMINAL_BRIDGE_DISCOVERY_DIR: discoveryDir,
+            SP_TERMINAL_BRIDGE_PROTOCOL: "sp-terminal-bridge-v1",
+        };
+        const spawnProcess = options.spawnProcess ?? ((command, commandArgs, spawnOptions) => spawn(command, commandArgs, spawnOptions));
+        const child = spawnProcess(executable, args, {
+            detached: true,
+            stdio: "ignore",
+            shell: false,
+            env: childEnv,
+        });
+        child.once("error", () => { });
+        if (child.pid === undefined) {
+            return {
+                status: "failed",
+                error: `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.`,
+            };
+        }
+        const state = {
+            version: SIDECAR_VERSION,
+            pid: child.pid,
+            executable,
+            args,
+            startedAt: new Date().toISOString(),
+        };
+        writePrivateState(statePath, state);
+        // Older cooperating launchers must see the new process too.
+        writePrivateState(legacyPath, state);
+        child.unref();
+        return { status: "launched", pid: child.pid };
+    }
+    catch (error) {
+        return { status: "failed", error: error instanceof Error ? error.message : String(error) };
+    }
+    finally {
+        if (lockFd !== undefined)
+            closeSync(lockFd);
+        if (ownsLock)
+            removeFile(lockPath);
+    }
+}
+export function getSpWebSidecarStatePath(discoveryDir) {
+    return join(discoveryDir, SIDECAR_STATE_FILE);
+}
+//# sourceMappingURL=sp-web-launcher.js.map

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

@@ -1,5 +1,5 @@
 import type { ExtensionAPI, StartupMessage, Theme } from "@senpiper/pi-coding-agent";
-export declare function renderSpStartupHeader(theme: Theme, width: number, modelId?: string, gatewayConnected?: boolean): string[];
+export declare function renderSpStartupHeader(theme: Theme, width: number, modelId?: string, gatewayConnected?: boolean, webUrl?: string): string[];
 export declare function filterSpStartupMessage(startupMessage: StartupMessage): string | undefined;
 export declare function registerSpStartupHeader(pi: ExtensionAPI): void;
 //# sourceMappingURL=startup-header.d.ts.map

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;AAarF,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,gBAAgB,UAAQ,EACxB,MAAM,CAAC,EAAE,MAAM,YAmCf;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\";\nimport { getSpWebUrl } from \"./web-command.ts\";\n\nconst LLM_IN_A_BOX_BANNER = [\n\t\" _     _     __  __   ___ _   _      _      ____   ___  __  __\",\n\t\"| |   | |   |  \\\\/  | |_ _| \\\\ | |    / \\\\    | __ ) / _ \\\\ \\\\ \\\\/ /\",\n\t\"| |   | |   | |\\\\/| |  | ||  \\\\| |   / _ \\\\   |  _ \\\\| | | | \\\\  /\",\n\t\"| |___| |___| |  | |  | || |\\\\  |  / ___ \\\\  | |_) | |_| | /  \\\\ \",\n\t\"|_____|_____|_|  |_| |___|_| \\\\_| /_/   \\\\_\\\\ |____/ \\\\___/ /_/\\\\_\\\\\",\n];\n\nexport function renderSpStartupHeader(\n\ttheme: Theme,\n\twidth: number,\n\tmodelId?: string,\n\tgatewayConnected = false,\n\twebUrl?: string,\n) {\n\tif (webUrl === undefined) {\n\t\ttry {\n\t\t\twebUrl = getSpWebUrl();\n\t\t} catch {\n\t\t\twebUrl = \"Check SP_WEB configuration\";\n\t\t}\n\t}\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 = \"/web · /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(\"dim\", `SP Web: ${webUrl}`)),\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(\"dim\", `SP Web: ${webUrl}`)),\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

@@ -1,5 +1,6 @@
 import { truncateToWidth } from "@senpiper/pi-coding-agent/runtime-deps";
 import { readSpGatewayState } from "./gateway.js";
+import { getSpWebUrl } from "./web-command.js";
 const LLM_IN_A_BOX_BANNER = [
     " _     _     __  __   ___ _   _      _      ____   ___  __  __",
     "| |   | |   |  \\/  | |_ _| \\ | |    / \\    | __ ) / _ \\ \\ \\/ /",
@@ -7,17 +8,26 @@ const LLM_IN_A_BOX_BANNER = [
     "| |___| |___| |  | |  | || |\\  |  / ___ \\  | |_) | |_| | /  \\ ",
     "|_____|_____|_|  |_| |___|_| \\_| /_/   \\_\\ |____/ \\___/ /_/\\_\\",
 ];
-export function renderSpStartupHeader(theme, width, modelId, gatewayConnected = false) {
+export function renderSpStartupHeader(theme, width, modelId, gatewayConnected = false, webUrl) {
+    if (webUrl === undefined) {
+        try {
+            webUrl = getSpWebUrl();
+        }
+        catch {
+            webUrl = "Check SP_WEB configuration";
+        }
+    }
     const availableWidth = Math.max(1, width);
     const truncateLine = (line) => truncateToWidth(line, availableWidth);
     const status = `sp-gateway: ${gatewayConnected ? "connected" : "not configured"} · model: ${modelId ?? "not selected"}`;
     const loginPrompt = gatewayConnected
         ? []
         : [truncateLine(theme.bold(theme.fg("warning", "Not logged in. Run /login to continue.")))];
-    const commands = "/login · /model · /onboarding · /btw";
+    const commands = "/web · /login · /model · /onboarding";
     if (availableWidth < 68) {
         return [
             truncateLine(theme.bold(theme.fg("accent", "LLM IN A BOX")) + theme.fg("dim", " · powered by Senpiper")),
+            truncateLine(theme.fg("dim", `SP Web: ${webUrl}`)),
             truncateLine(theme.fg("muted", status)),
             ...loginPrompt,
             truncateLine(theme.fg("dim", commands)),
@@ -26,6 +36,7 @@ export function renderSpStartupHeader(theme, width, modelId, gatewayConnected =
     return [
         ...LLM_IN_A_BOX_BANNER.map((line) => truncateLine(theme.bold(theme.fg("accent", line)))),
         truncateLine(theme.fg("dim", "powered by Senpiper")),
+        truncateLine(theme.fg("dim", `SP Web: ${webUrl}`)),
         truncateLine(theme.fg("muted", status)),
         ...loginPrompt,
         truncateLine(theme.fg("dim", commands)),

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":"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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\";\nimport { getSpWebUrl } from \"./web-command.ts\";\n\nconst LLM_IN_A_BOX_BANNER = [\n\t\" _     _     __  __   ___ _   _      _      ____   ___  __  __\",\n\t\"| |   | |   |  \\\\/  | |_ _| \\\\ | |    / \\\\    | __ ) / _ \\\\ \\\\ \\\\/ /\",\n\t\"| |   | |   | |\\\\/| |  | ||  \\\\| |   / _ \\\\   |  _ \\\\| | | | \\\\  /\",\n\t\"| |___| |___| |  | |  | || |\\\\  |  / ___ \\\\  | |_) | |_| | /  \\\\ \",\n\t\"|_____|_____|_|  |_| |___|_| \\\\_| /_/   \\\\_\\\\ |____/ \\\\___/ /_/\\\\_\\\\\",\n];\n\nexport function renderSpStartupHeader(\n\ttheme: Theme,\n\twidth: number,\n\tmodelId?: string,\n\tgatewayConnected = false,\n\twebUrl?: string,\n) {\n\tif (webUrl === undefined) {\n\t\ttry {\n\t\t\twebUrl = getSpWebUrl();\n\t\t} catch {\n\t\t\twebUrl = \"Check SP_WEB configuration\";\n\t\t}\n\t}\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 = \"/web · /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(\"dim\", `SP Web: ${webUrl}`)),\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(\"dim\", `SP Web: ${webUrl}`)),\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;