@cplieger/web-terminal-engine 6.2.0-dev.1 → 6.2.0-dev.5

package/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@cplieger/web-terminal-engine",
-  "version": "6.2.0-dev.1",
+  "version": "6.2.0-dev.5",
   "license": "MPL-2.0",
   "exports": {
     ".": "./src/index.ts"

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@cplieger/web-terminal-engine",
-  "version": "6.2.0-dev.1",
+  "version": "6.2.0-dev.5",
   "type": "module",
   "scripts": {
     "typecheck": "tsc -p tsconfig.json",
     "typecheck:tests": "tsc -p tsconfig.test.json",
     "test": "vitest --run",
     "test:e2e": "playwright test",
+    "test:mutation": "stryker run",
     "lint:eslint": "eslint .",
     "lint:prettier": "prettier --check .",
     "lint:knip": "knip",
@@ -21,18 +22,17 @@
     "@stryker-mutator/vitest-runner": "10.0.0",
     "@types/pngjs": "6.0.5",
     "@typescript/native": "npm:typescript@7.0.2",
-    "@vitest/browser": "5.0.3",
     "@vitest/browser-playwright": "5.0.3",
     "@vitest/coverage-v8": "5.0.3",
     "esbuild": "0.28.2",
     "eslint": "10.12.0",
     "fast-check": "4.10.2",
-    "knip": "6.39.0",
+    "knip": "6.40.0",
     "playwright": "1.63.0",
     "pngjs": "7.0.0",
     "prettier": "3.9.9",
     "typescript": "npm:@typescript/typescript6@6.0.2",
-    "typescript-eslint": "8.71.0",
+    "typescript-eslint": "8.71.1",
     "vitest": "5.0.3"
   },
   "overrides": {

package/src/connection.ts

@@ -40,7 +40,7 @@ type ConnState =
   // false: controls are 0x00-sentinel binary frames and input is leading-NUL-
   // split. true: controls are text frames and input is raw binary.
   | { status: "connected"; sock: WebSocket; abort: AbortController; upgraded: boolean }
-  | { status: "reconnecting"; timer: ReturnType<typeof setTimeout>; delayMs: number }
+  | { status: "reconnecting"; timer: ReturnType<typeof setTimeout> }
   | { status: "incompatible" };
 
 // The server's close code for "the child process has exited"
@@ -727,7 +727,7 @@ export function createConnection(opts: ConnectionOptions): Connection {
       connState = { status: "disconnected" };
       connect();
     }, step.scheduledMs);
-    connState = { status: "reconnecting", timer, delayMs: step.scheduledMs };
+    connState = { status: "reconnecting", timer };
   }
 
   function cancelScheduledReconnect(): void {

package/src/status-stream.ts

@@ -8,15 +8,12 @@
 import { nextBackoffDelay } from "./reconnect.js";
 
 /** SessionInfo is one session's wire shape: the JSON object the session REST
- *  API (GET/POST /api/sessions) returns per session. Mirrors the Go
- *  terminal.SessionInfo — the two are kept in lockstep by hand (single 8-field
- *  type; flip to wiregen if this surface grows).
+ *  API (GET/POST /api/sessions) returns per session, kept in lockstep with the Go
+ *  terminal.SessionInfo by hand.
  *
- *  Three of the fields are title-shaped and they are not interchangeable:
- *  `title` is the RESOLVED display title, `pinnedTitle` is the USER's name (set
- *  and cleared only by a human action, outranking everything else), and
- *  `clientTitle` is a CLIENT-DERIVED automatic title a client asked the server to
- *  remember. */
+ *  `title` is the RESOLVED display title, `pinnedTitle` the USER's name (set and
+ *  cleared only by a human action, outranking everything else), and `clientTitle`
+ *  a CLIENT-DERIVED automatic title a client asked the server to remember. */
 export interface SessionInfo {
   readonly id: string;
   /** the session's current status. "working"/"idle"/"exited"/"crashed" are
@@ -35,6 +32,13 @@ export interface SessionInfo {
   readonly status:
     "working" | "idle" | "input" | "done" | "exited" | "crashed" | "failed" | "warning";
   readonly title: string;
+  /** the session's short public name, safe to put in a URL: 1 to 64 characters
+   *  of `[A-Za-z0-9_-]`, unique among live sessions, and NOT a capability
+   *  (nothing attaches with it; only `id` does). The server mints a random one
+   *  and a host may replace it (web-terminal-kiro sets the kiro-cli thread id).
+   *  Absent from a server before 6.2 and from a status event carrying
+   *  `removed`. Untrusted wire text: validate it before use. */
+  readonly alias?: string;
   /** the raw client-derived automatic title (before the precedence baked into
    *  `title`); a consumer that treats the program's OSC window title as
    *  unreliable reads this instead of `title`. */

package/src/store.ts

@@ -810,11 +810,10 @@ export class LineStore {
    * Record the server's retained-history bounds from a resumeAck so the
    * renderer can tell a genuine trim from a still-loading state.
    *
-   * `committed` is deliberately NOT stored. The replay-jump prediction needs
-   * it, but it takes it as an argument from the ack being processed — reading a
-   * stored copy would risk predicting from a previous ack's value, which is the
-   * same class of defect as predicting from a mutated `highest`.
+   * `committed` is deliberately not stored: the replay-jump prediction takes it
+   * from the ack being processed, and a stored copy could carry a previous ack's.
    */
+  // deadset:ignore DS1801 -- published LineStore method; dropping the leading parameter would break its callers
   noteResumeBounds(_committed: number, oldestIndex: number): void {
     if (Number.isInteger(oldestIndex) && oldestIndex >= 0) {
       this.serverOldest = oldestIndex;