@volter/supercode-terminal 0.2.69 → 0.2.71

package/README.md

@@ -42,6 +42,16 @@ the fleet tool package dependency. Advanced hosts and legacy adapters may import
 subpaths are exported only for compatibility. Prefer the controller/client APIs
 above this layer for new applications.
 
+`TmuxTerminalHost`, `PtyTerminalHost` and `PaneServerHost` expose
+`hasLiveContext(contextKey)` for decisions that require a complete presence
+reading. Tmux reads all session IDs and context values in one command, without
+the ordinary option reader's best-effort fallback. Failed, incomplete or
+malformed identity reads reject; only an explicit no-server answer establishes
+emptiness after a failed command. Other connection errors remain unknown. The
+PTY host reads its own live catalog; an older pane server refuses this operation.
+This is a host observation, not a physical window/tab reading or an existence
+lock against a subsequent launch.
+
 The substrate was moved from a retired package without behavioral changes.
 Its existing home paths, environment variables, and tmux ownership markers stay
 compatible. Those files retain Apache-2.0 licensing; see `NOTICE-SUBSTRATE` and

package/index.d.ts

@@ -49,6 +49,8 @@ export type TmuxTerminalHostOptions = {
 export class TmuxTerminalHost {
   constructor(options?: TmuxTerminalHostOptions);
   listSessions(): Promise<TerminalSession[]>;
+  /** Complete context observation; failures reject rather than report absence. */
+  hasLiveContext(contextKey: string): Promise<boolean>;
   createSession(input: {
     command: TmuxCommand;
     contextKey?: string;
@@ -87,6 +89,8 @@ export class TmuxTerminalHost {
 export class PaneServerHost {
   constructor(options: { pipe: string; serverScript?: string });
   listSessions(): Promise<TerminalSession[]>;
+  /** Requires a compatible pane server; an unsupported operation rejects. */
+  hasLiveContext(contextKey: string): Promise<boolean>;
   createSession(input: { command: TmuxCommand; contextKey?: string; cwd?: string; env?: Record<string, string>; name?: string }): Promise<TerminalSession>;
   capture(sessionId: string, options?: { lines?: number; preserveEscapes?: boolean }): Promise<string>;
   sendInput(sessionId: string, data: string, options?: { deadlineMs?: number; submitMode?: 'retry' | 'single' | 'none'; inputOwner?: string }): Promise<TerminalInputDelivery>;
@@ -112,6 +116,8 @@ export class PaneServerHost {
 export class PtyTerminalHost {
   constructor(options?: { attachmentTtlMs?: number });
   listSessions(): Promise<TerminalSession[]>;
+  /** Live context membership in this host's own pane catalog. */
+  hasLiveContext(contextKey: string): boolean;
   createSession(input: {
     command: TmuxCommand;
     contextKey?: string;

package/index.mjs

@@ -215,6 +215,12 @@ export class TmuxTerminalHost {
     return listing.promise;
   }
 
+  /** Complete context observation for callers deciding whether a pane has ended. */
+  hasLiveContext(contextKey) {
+    assertContextKey(contextKey);
+    return this.#tmux.hasSessionContextAsync(this.#contextOption, contextKey, this.#socket);
+  }
+
   async #listSessions() {
     this.#pruneAttachments();
     const names = this.#sessionNames();
@@ -637,6 +643,11 @@ export class PtyTerminalHost {
     return [...this.#sessions.values()].map((entry) => this.#describe(entry, table));
   }
 
+  hasLiveContext(contextKey) {
+    assertContextKey(contextKey);
+    return [...this.#sessions.values()].some((entry) => entry.contextKey === contextKey && entry.exit === null);
+  }
+
   async createSession(input) {
     const name = input.name ?? `supercode-${this.#randomToken().slice(0, 16)}`;
     if (!SESSION_NAME.test(name)) {
@@ -1105,6 +1116,7 @@ export class PaneServerHost {
   }
 
   listSessions() { return this.#request('listSessions', []); }
+  hasLiveContext(contextKey) { assertContextKey(contextKey); return this.#request('hasLiveContext', [contextKey]); }
   createSession(input) { return this.#request('createSession', [input]); }
   capture(sessionId, options = {}) { return this.#request('capture', [sessionId, options]); }
   sendInput(sessionId, data, options = {}) { return this.#request('sendInput', [sessionId, data, options]); }
@@ -1908,7 +1920,11 @@ export function composerText(kind, screen) {
     // the live bottom (model/cwd and shortcuts can occupy separate rows).
     if (kind === 'codex' && (plain.slice(end + 1).some((line) => line.trim() && !footer.test(line)) ||
       /\bmodel:\s+loading\b/iu.test(plain.findLast((line) => /\bmodel:/iu.test(line)) ?? ''))) return null;
-    if (kind === 'claude-code' && (row === 0 || !rule.test(plain[row - 1]))) return null;
+    if (kind === 'claude-code' && (row === 0 || !rule.test(plain[row - 1]) ||
+      // Prompt-history search keeps the editor's caret and enclosing rules,
+      // but its input is a search query. Its live footer can wrap on a narrow
+      // pane; inspect only rows below this editor, never transcript text.
+      /(?:^|\n)\s*search\s+prompts\s*:/iu.test(plain.slice(end + 1).join('\n')))) return null;
     const first = plain[row].match(caret)[0].length;
     const value = lines.slice(row, end).map((cells, index) => cells
       .slice(index === 0 || /^\s*$/u.test(plain[row + index].slice(0, first)) ? first : 0).filter((cell) => !cell.placeholder)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-terminal",
-  "version": "0.2.69",
+  "version": "0.2.71",
   "type": "module",
   "description": "Optional leak-safe terminal and tmux host adapter for Volter Harness frontends",
   "exports": {

package/substrate/pane-server.mjs

@@ -32,7 +32,7 @@ function leave() {
   setTimeout(() => { server.close(); for (const connection of clients) connection.end(); setTimeout(done, 500); }, 3_000).unref?.();
 }
 
-const OPS = new Set(['listSessions', 'createSession', 'capture', 'sendInput', 'acquireInput', 'ownsInput', 'releaseInput', 'closeSession', 'renameWindow', 'issueAttachment', 'bindContext']);
+const OPS = new Set(['listSessions', 'hasLiveContext', 'createSession', 'capture', 'sendInput', 'acquireInput', 'ownsInput', 'releaseInput', 'closeSession', 'renameWindow', 'issueAttachment', 'bindContext']);
 
 function scheduleIdleExit() {
   clearTimeout(idleTimer);

package/substrate/tmux.d.ts

@@ -34,6 +34,8 @@ export declare function createSession({ command, cwd, env, name, owner, ownerOpt
     name: string;
     panes: number;
 }>;
+/** A complete context reading for absence decisions; ordinary option listings are best-effort. */
+export declare function hasSessionContextAsync(option: string, contextKey: string, socket?: string): Promise<boolean>;
 /** Read one namespaced user option for every live session in one tmux call. */
 export declare function sessionOptionValuesAsync(option: string, socket?: string): Promise<Map<string, string>>;
 /** Set one of tmux's own session options on one session. */

package/substrate/tmux.js

@@ -151,6 +151,39 @@ function assertUserOption(option) {
 // value (opaque, colons allowed) takes the whole remainder. Same rule as
 // `listPanesFormat`: printable separator, free-text field last.
 const sessionValueSeparator = ":";
+/** A complete context reading for absence decisions; ordinary option listings are best-effort. */
+export async function hasSessionContextAsync(option, contextKey, socket) {
+    assertTmux();
+    assertUserOption(option);
+    let output;
+    try {
+        output = await runAsync("tmux", tmuxArgs(socket, ["list-sessions", "-F", `#{session_id}${sessionValueSeparator}#{${option}}`]), { timeoutMs: 5_000 });
+    }
+    catch (error) {
+        // Only tmux's explicit no-server answer establishes emptiness. Connection,
+        // permission, missing-command and timeout errors remain unread observations.
+        if (error instanceof Error && /\nno server running on [^\r\n]+$/.test(error.message))
+            return false;
+        throw error;
+    }
+    // Successful list-sessions has at least one complete row. Include unbound
+    // sessions, reject malformed/duplicate identities, and inspect every row even
+    // after a match so partial identity output cannot establish absence.
+    if (!output.endsWith("\n"))
+        throw new Error("tmux context reading is incomplete");
+    const ids = new Set();
+    let present = false;
+    for (const line of output.slice(0, -1).split("\n")) {
+        const separator = line.indexOf(sessionValueSeparator);
+        const id = line.slice(0, separator);
+        if (separator < 1 || !/^\$\d+$/.test(id) || ids.has(id))
+            throw new Error("tmux context reading has an invalid session identity");
+        ids.add(id);
+        if (line.slice(separator + 1) === contextKey)
+            present = true;
+    }
+    return present;
+}
 /** Read one namespaced user option for every live session in one tmux call. */
 export async function sessionOptionValuesAsync(option, socket) {
     assertTmux();