@code-yeongyu/senpi-pty 2026.10.19 → 2026.10.20-1

package/dist/pipe-fallback.d.ts

@@ -39,7 +39,7 @@ export declare function shouldUsePipeFallback(nativeLoadResult: NativePtyLoadRes
  * the group is already gone, it still falls back to a direct kill, so the
  * child is never left running.
  */
-export declare function terminateChildTree(child: Pick<ChildProcessHandle, "pid" | "kill">, signal: NodeJS.Signals): "group" | "direct";
+export declare function terminateChildTree(child: Pick<ChildProcessHandle, "pid" | "kill">, signal: NodeJS.Signals): "group" | "direct" | "none";
 export declare class PipeFallbackSession {
     readonly backend = "pipe-fallback";
     readonly note = "Running with child_process pipe fallback because no PTY backend is active; terminal screen state and resize are unavailable.";

package/dist/pipe-fallback.js

@@ -18,7 +18,10 @@ export function shouldUsePipeFallback(nativeLoadResult, env = process.env) {
  */
 export function terminateChildTree(child, signal) {
     const pid = child.pid;
-    if (pid !== undefined && process.platform !== "win32") {
+    // A child that never started has no pid; on Node < 24.22 / 26.10 its kill() signals our own process group.
+    if (pid === undefined)
+        return "none";
+    if (process.platform !== "win32") {
         try {
             process.kill(-pid, signal);
             return "group";
@@ -208,7 +211,15 @@ export class PipeFallbackSession {
                 return { ok: true, note: `Sent ${signal} to child_process pipe fallback session.` };
             }
         }
-        if (terminateChildTree(this.child, signal) === "group") {
+        const route = terminateChildTree(this.child, signal);
+        if (route === "none") {
+            return {
+                ok: false,
+                code: "not_started",
+                note: "Cannot kill pipe fallback session: its process never started.",
+            };
+        }
+        if (route === "group") {
             return { ok: true, note: `Sent ${signal} to child_process pipe fallback process group (pgid ${pid}).` };
         }
         return { ok: true, note: `Sent ${signal} to child_process pipe fallback session.` };

package/dist/registry-types.d.ts

@@ -62,6 +62,11 @@ export interface SessionRegistrySweepOptions {
 }
 export interface SessionRegistryOptions<TSession extends SessionRegistrySession = SessionRegistrySession> {
     readonly maxSessions?: number;
+    /**
+     * Inserted between the command prefix and the counter (`bash_<scope>_1`), so two registries whose ids reach the same
+     * caller - a host's and its tool child's - never hand out the same id. Letters and digits only.
+     */
+    readonly idScope?: string;
     readonly initialSessions?: readonly InitialSessionRegistryEntry<TSession>[];
     readonly createSession?: (options: SessionRegistryCreateContext) => MaybePromise<TSession>;
     readonly killProcess?: (target: number, signal: TerminalSessionSignal) => void;

package/dist/registry.d.ts

@@ -11,6 +11,7 @@ export declare class SessionRegistry<TSession extends SessionRegistrySession = S
     private readonly platform;
     private sequence;
     readonly maxSessions: number;
+    private readonly idScope;
     private readonly stopExitGraceMs;
     private readonly forcedExitGraceMs;
     private readonly detachedExitGraceMs;

package/dist/registry.js

@@ -14,6 +14,9 @@ export class SessionRegistry {
         this.idCounters = new Map();
         this.sequence = 0;
         this.maxSessions = normalizeMaxSessions(options.maxSessions);
+        if (options.idScope !== undefined && !/^[A-Za-z0-9]+$/.test(options.idScope))
+            throw new Error("idScope must be letters and digits only.");
+        this.idScope = options.idScope;
         this.stopExitGraceMs =
             options.stopExitGraceMs !== undefined &&
                 Number.isFinite(options.stopExitGraceMs) &&
@@ -229,7 +232,8 @@ export class SessionRegistry {
         this.entries.delete(id);
     }
     allocateId(command) {
-        const prefix = sessionIdPrefix(command);
+        const commandPrefix = sessionIdPrefix(command);
+        const prefix = this.idScope === undefined ? commandPrefix : `${commandPrefix}_${this.idScope}`;
         let next = (this.idCounters.get(prefix) ?? 0) + 1;
         while (this.entries.has(`${prefix}_${next}`))
             next += 1;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/senpi-pty",
-	"version": "2026.10.19",
+	"version": "2026.10.20-1",
 	"description": "Typed PTY session loader for Senpi persistent terminals",
 	"type": "module",
 	"main": "./dist/index.js",