forgebadger 0.1.0 → 0.1.2

package/dist/gateway/src/services/session-launch-plan.js

@@ -1,8 +1,11 @@
 import { createAdapterLaunchPlan } from "../adapters/index.js";
 import { isAdapterId } from "./adapter-discovery.js";
+import { checkCommand } from "../lib/dependency-check.js";
 import { ensureClaudeNotificationSettings } from "./claude-notification-settings.js";
 import { ensureCodexNotificationSettings, ensureKimiNotificationSettings, ensurePiNotificationSettings } from "./cli-notification-settings.js";
 import { ensureForgeBadgerOpenCodePlugin } from "./opencode-notification-settings.js";
+import { ensureMcodeNotificationPreference } from "./mcode-notification-preference.js";
+import { ensureClaudeTerminalNotificationSettings, ensureKimiTerminalNotificationSettings, ensureOpenCodeTerminalNotificationSettings } from "./terminal-notification-settings.js";
 /**
  * Internal launch-only material. Every session launches against the host
  * environment: provider/model/credential selection lives in each CLI's global
@@ -13,6 +16,13 @@ export function createLaunchPlan(input) {
         FORGEBADGER_SESSION_ID: input.sessionId,
         FORGEBADGER_GATEWAY_URL: getGatewayUrl()
     };
+    if (input.adapter === "kimi") {
+        // Kimi Code upgrades its bare BEL notifications to rich OSC 9 text only
+        // when TERM_PROGRAM hits its allowlist (iTerm.app/WezTerm/ghostty/
+        // WarpTerminal). A user-set TERM_PROGRAM survives the Session Server env
+        // sanitization allowlist, so only fall back to WezTerm when none is set.
+        env.TERM_PROGRAM = process.env.TERM_PROGRAM?.trim() || "WezTerm";
+    }
     return createAdapterLaunchPlan({
         adapter: input.adapter,
         projectRoot: input.projectRoot,
@@ -23,8 +33,14 @@ export function createLaunchPlan(input) {
     });
 }
 export async function prepareAdapterLaunchExtras(db, userId, adapter, projectRoot) {
+    const hooksDisabled = disabledCliHookAdapters();
     if (adapter === "opencode") {
-        await ensureForgeBadgerOpenCodePlugin(projectRoot);
+        // Native terminal notification config always runs — it is plain config,
+        // not a hook, so FORGEBADGER_DISABLE_CLI_HOOKS does not gate it.
+        await ensureOpenCodeTerminalNotificationSettings();
+        if (!hooksDisabled.has("opencode")) {
+            await ensureForgeBadgerOpenCodePlugin(projectRoot);
+        }
         return [];
     }
     if (adapter === "codex") {
@@ -32,7 +48,10 @@ export async function prepareAdapterLaunchExtras(db, userId, adapter, projectRoo
         return [];
     }
     if (adapter === "kimi") {
-        await ensureKimiNotificationSettings(projectRoot);
+        await ensureKimiTerminalNotificationSettings();
+        if (!hooksDisabled.has("kimi")) {
+            await ensureKimiNotificationSettings(projectRoot);
+        }
         return [];
     }
     if (adapter === "pi") {
@@ -41,9 +60,36 @@ export async function prepareAdapterLaunchExtras(db, userId, adapter, projectRoo
         await ensurePiNotificationSettings();
         return [];
     }
-    await ensureClaudeNotificationSettings(projectRoot, getGatewayUrl());
+    if (adapter === "mcode") {
+        // MiniMax Code has no hook surface at all, so the PTY OSC stream is the
+        // only channel. Under `auto` its notifier degrades to a bare BEL here (no
+        // TERM_PROGRAM allowlist hit, no KITTY_WINDOW_ID, no WT_SESSION) and the
+        // event kind is lost, so pin the payload-carrying method in config.yaml.
+        ensureMcodeNotificationPreference();
+        return [];
+    }
+    await ensureClaudeTerminalNotificationSettings();
+    if (!hooksDisabled.has("claude")) {
+        await ensureClaudeNotificationSettings(projectRoot, getGatewayUrl());
+    }
     return [];
 }
+/**
+ * FORGEBADGER_DISABLE_CLI_HOOKS: skip hook injection for claude/kimi/opencode.
+ * Disabling hooks removes structured lifecycle notifications; generic terminal
+ * bells cannot safely recover them. Codex/pi are silently ignored because
+ * those adapters require their managed hooks/extensions.
+ */
+export function disabledCliHookAdapters(value = process.env.FORGEBADGER_DISABLE_CLI_HOOKS) {
+    const disabled = new Set();
+    for (const entry of value?.split(",") ?? []) {
+        const name = entry.trim();
+        if (name === "claude" || name === "kimi" || name === "opencode") {
+            disabled.add(name);
+        }
+    }
+    return disabled;
+}
 export function normalizeAdapter(value) {
     return isAdapterId(value) ? value : undefined;
 }
@@ -52,4 +98,98 @@ function getGatewayUrl() {
         || process.env.NEXT_PUBLIC_GATEWAY_URL
         || `http://${process.env.FORGEBADGER_HOST || "127.0.0.1"}:${process.env.FORGEBADGER_PORT || "3000"}`);
 }
+/**
+ * Normalize a raw session-kind string. Returns undefined for anything that is
+ * neither a canonical adapter id nor the terminal kind.
+ */
+export function normalizeSessionKind(value) {
+    if (value === "terminal")
+        return "terminal";
+    return isAdapterId(value) ? value : undefined;
+}
+/** Shells offered for a terminal session, per platform. Single source of
+ * truth for the union type AND the zod route enum (keep both in lockstep). */
+export const TERMINAL_SHELLS = ["pwsh", "powershell", "cmd", "bash", "zsh", "sh"];
+/**
+ * Resolve the preferred shell without probing availability. Windows prefers
+ * pwsh; POSIX uses $SHELL then sh. Use resolveAvailableTerminalShell to launch.
+ */
+export function defaultTerminalShell(platform = process.platform, env = process.env) {
+    if (platform === "win32") {
+        return "pwsh";
+    }
+    const shell = env.SHELL?.trim();
+    if (shell === "/bin/zsh" || shell?.endsWith("/zsh"))
+        return "zsh";
+    if (shell === "/bin/bash" || shell?.endsWith("/bash"))
+        return "bash";
+    return "sh";
+}
+/** Resolve a launchable default, including Windows hosts without PowerShell 7. */
+export async function resolveAvailableTerminalShell(platform = process.platform, env = process.env, runner) {
+    const preferred = defaultTerminalShell(platform, env);
+    const fallback = platform === "win32" ? ["pwsh", "powershell", "cmd"] : ["bash", "zsh", "sh"];
+    for (const shell of new Set([preferred, ...fallback])) {
+        if ((await checkTerminalShell(shell, platform, env, runner)).available)
+            return shell;
+    }
+    throw new Error("TERMINAL_SHELL_UNAVAILABLE: no supported shell is installed");
+}
+/**
+ * Build a launch plan for a CLI-agnostic terminal (shell) session. Unlike the
+ * CLI adapter launch plans, no hooks/notifications are injected and no
+ * provider credentials are touched — env is host_environment + session id.
+ */
+export function createTerminalLaunchPlan(input) {
+    const platform = input.platform ?? process.platform;
+    const env = input.env ?? process.env;
+    const shell = input.shell ?? defaultTerminalShell(platform, env);
+    const { command, args } = resolveShellCommand(shell, platform, env);
+    return {
+        command,
+        args,
+        cwd: input.projectRoot,
+        env: {
+            FORGEBADGER_SESSION_ID: input.sessionId,
+            FORGEBADGER_GATEWAY_URL: getGatewayUrl()
+        },
+        secretEnvNames: [],
+        credentialMode: "host_environment"
+    };
+}
+function resolveShellCommand(shell, platform, env) {
+    switch (shell) {
+        case "pwsh":
+            return { command: "pwsh", args: [] };
+        case "powershell":
+            // Windows PowerShell 5.1 (powershell.exe, always present on Windows).
+            // Distinct from pwsh 7: a user who installed Oh My Posh into the 5.1
+            // profile needs this shell to see their prompt.
+            return { command: "powershell.exe", args: [] };
+        case "cmd":
+            return { command: env.ComSpec?.trim() || env.COMSPEC?.trim() || "cmd.exe", args: [] };
+        case "bash":
+            return { command: "bash", args: ["-l"] };
+        case "zsh":
+            return { command: "zsh", args: ["-l"] };
+        case "sh":
+            return { command: env.SHELL?.trim() || "sh", args: [] };
+    }
+}
+/**
+ * Probe whether a shell binary is launchable. Returns the resolved command on
+ * success, or an error message on failure. Used as the terminal equivalent of
+ * `getAdapterLaunchStatus` (no adapter discovery to lean on for shells).
+ */
+export async function checkTerminalShell(shell, platform = process.platform, env = process.env, runner = undefined) {
+    const { command, args } = resolveShellCommand(shell, platform, env);
+    // A cheap, universally-supported probe: print nothing and exit 0.
+    const probeArgs = shell === "cmd" ? ["/c", "exit", "0"] : [...args, "-c", "exit", "0"];
+    const status = await checkCommand(command, probeArgs, runner, { timeoutMs: 5000 });
+    return {
+        available: status.available,
+        command,
+        ...(status.error ? { error: status.error } : {})
+    };
+}
 //# sourceMappingURL=session-launch-plan.js.map

package/dist/gateway/src/services/session-launch-plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-launch-plan.js","sourceRoot":"","sources":["../../../src/services/session-launch-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAkB,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,4BAA4B,EAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAC;AAStF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,GAAG,GAA2B;QAClC,sBAAsB,EAAE,KAAK,CAAC,SAAS;QACvC,uBAAuB,EAAE,aAAa,EAAE;KACzC,CAAC;IACF,OAAO,uBAAuB,CAAC;QAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,kBAAkB;QAClC,GAAG;QACH,cAAc,EAAE,EAAE;QAClB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,EAAY,EACZ,MAAc,EACd,OAAkB,EAClB,WAAmB;IAEnB,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,MAAM,+BAA+B,CAAC,WAAW,CAAC,CAAC;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,MAAM,+BAA+B,CAAC,WAAW,CAAC,CAAC;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,8BAA8B,CAAC,WAAW,CAAC,CAAC;QAClD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,uEAAuE;QACvE,wEAAwE;QACxE,MAAM,4BAA4B,EAAE,CAAC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,gCAAgC,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;IACrE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,uBAAuB;WAChC,OAAO,CAAC,GAAG,CAAC,uBAAuB;WACnC,UAAU,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,EAAE,CACrG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"session-launch-plan.js","sourceRoot":"","sources":["../../../src/services/session-launch-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAkB,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAsB,MAAM,4BAA4B,CAAC;AAE9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,4BAA4B,EAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EACL,wCAAwC,EACxC,sCAAsC,EACtC,0CAA0C,EAC3C,MAAM,qCAAqC,CAAC;AAS7C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,GAAG,GAA2B;QAClC,sBAAsB,EAAE,KAAK,CAAC,SAAS;QACvC,uBAAuB,EAAE,aAAa,EAAE;KACzC,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC7B,wEAAwE;QACxE,mEAAmE;QACnE,yEAAyE;QACzE,yEAAyE;QACzE,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACnE,CAAC;IACD,OAAO,uBAAuB,CAAC;QAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,kBAAkB;QAClC,GAAG;QACH,cAAc,EAAE,EAAE;QAClB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,EAAY,EACZ,MAAc,EACd,OAAkB,EAClB,WAAmB;IAEnB,MAAM,aAAa,GAAG,uBAAuB,EAAE,CAAC;IAChD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,wEAAwE;QACxE,iEAAiE;QACjE,MAAM,0CAA0C,EAAE,CAAC;QACnD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,MAAM,+BAA+B,CAAC,WAAW,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,MAAM,+BAA+B,CAAC,WAAW,CAAC,CAAC;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,sCAAsC,EAAE,CAAC;QAC/C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,MAAM,8BAA8B,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,uEAAuE;QACvE,wEAAwE;QACxE,MAAM,4BAA4B,EAAE,CAAC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,wEAAwE;QACxE,0EAA0E;QAC1E,yEAAyE;QACzE,yEAAyE;QACzE,iCAAiC,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,wCAAwC,EAAE,CAAC;IACjD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,gCAAgC,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA4B,OAAO,CAAC,GAAG,CAAC,6BAA6B;IAErE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC3D,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAChE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,uBAAuB;WAChC,OAAO,CAAC,GAAG,CAAC,uBAAuB;WACnC,UAAU,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,EAAE,CACrG,CAAC;AACJ,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC5C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED;8EAC8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAU,CAAC;AAY3F;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAA4B,OAAO,CAAC,QAAQ,EAC5C,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAChC,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAClE,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,WAA4B,OAAO,CAAC,QAAQ,EAAE,MAAyB,OAAO,CAAC,GAAG,EAClF,MAAsB;IAEtB,MAAM,SAAS,GAAG,oBAAoB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAoB,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/G,KAAK,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,MAAM,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;IACvF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;AACjF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAA8B;IACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,oBAAoB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO;QACL,OAAO;QACP,IAAI;QACJ,GAAG,EAAE,KAAK,CAAC,WAAW;QACtB,GAAG,EAAE;YACH,sBAAsB,EAAE,KAAK,CAAC,SAAS;YACvC,uBAAuB,EAAE,aAAa,EAAE;SACzC;QACD,cAAc,EAAE,EAAE;QAClB,cAAc,EAAE,kBAAkB;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAoB,EACpB,QAAyB,EACzB,GAAsB;IAEtB,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACvC,KAAK,YAAY;YACf,sEAAsE;YACtE,qEAAqE;YACrE,gDAAgD;YAChD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACjD,KAAK,KAAK;YACR,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACxF,KAAK,MAAM;YACT,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,KAAK,KAAK;YACR,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,KAAK,IAAI;YACP,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAoB,EACpB,WAA4B,OAAO,CAAC,QAAQ,EAC5C,MAAyB,OAAO,CAAC,GAAG,EACpC,SAAoC,SAAS;IAE7C,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpE,kEAAkE;IAClE,MAAM,SAAS,GAAG,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnF,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO;QACP,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC;AACJ,CAAC"}

package/dist/gateway/src/services/session-manager.d.ts

@@ -65,6 +65,7 @@ export interface SessionManagerOptions {
     sessionPrefix?: string;
     runtimeInputAuthorizer?: (session: Readonly<GateASession>) => void;
     programmaticSubmitSettleMs?: Partial<Record<AdapterId, number>>;
+    programmaticReadyTimeoutMs?: number;
     sleep?: (ms: number) => Promise<void>;
     /**
      * One-shot probe consumed once per status-correction scan: returns true
@@ -77,6 +78,8 @@ export interface SessionManagerOptions {
 export interface ProgrammaticTaskInput {
     adapter: AdapterId;
     message: string;
+    authorize?: (() => void) | undefined;
+    beforeStage?: (() => void) | undefined;
 }
 export interface ProgrammaticTaskStageReceipt {
     adapter: AdapterId;
@@ -90,23 +93,40 @@ export interface ProgrammaticTaskStageReceipt {
  * session-output-buffer.ts).
  */
 export declare const MAX_BUFFERED_SESSIONS = 200;
+/** Handle for a workspace writer lease as seen by programmatic writers. */
+export interface WriterLeaseHandle {
+    userId: string;
+    sessionId: string;
+    workspace: string;
+    token: string;
+    fence: number;
+    expiresAt: number;
+}
 export declare class InMemorySessionManager {
     private readonly backend;
     private readonly recoveryStore;
     private readonly eventBus?;
+    private readonly stoppingSessions;
     private readonly db;
     private readonly writerLeases;
     private readonly writerGenerations;
     private readonly sessions;
     private readonly sessionOutputs;
-    private readonly sessionPrefix;
+    private sessionPrefix;
     private readonly runtimeInputAuthorizer;
     private readonly programmaticSubmitSettleMs;
+    private readonly programmaticReadyTimeoutMs;
     private readonly sleep;
     private readonly detectBackendRestart;
     private readonly sessionLocks;
     private correctionInterval;
     constructor(backend: TerminalBackendClient, recoveryStore?: SessionRecoveryStore, eventBus?: ForgeBadgerEventBus | undefined, options?: SessionManagerOptions);
+    /**
+     * Update the runtime session name prefix (runtime settings page).
+     * Affects newly created sessions only; existing sessions keep the name
+     * they were started with.
+     */
+    setSessionPrefix(prefix: string): void;
     /**
      * Serialize per-session lifecycle operations (create/start/stop/delete) using
      * a promise chain. Concurrent calls for the same sessionId run in arrival
@@ -135,7 +155,18 @@ export declare class InMemorySessionManager {
         available: boolean;
         message?: string;
     };
-    stopSession(id: string, runtimeSessionName?: string, userId?: string): Promise<GateASession>;
+    stopSession(id: string, runtimeSessionName?: string, userId?: string, writerLease?: WriterLeaseHandle): Promise<GateASession>;
+    /**
+     * Operator-forced stop for a session whose leader process has exited but
+     * whose confirmed-stop receipt cannot be obtained (a descendant still holds
+     * the process group, or the daemon that would sign the receipt is gone).
+     * Fails closed on purpose: a transiently unreachable backend or a runtime
+     * that may still be alive rejects the force — never turn a probe failure
+     * into a bypass.
+     */
+    forceStopSession(id: string, runtimeSessionName: string | undefined, userId: string): Promise<GateASession>;
+    /** Revokes a pending runtime confirmation; never blocks the caller. */
+    private revokePendingRuntimeConfirmation;
     /**
      * Read-only liveness probe: does this session currently have a live backing
      * terminal (pty)? A session whose DB/manager status still says `running` but
@@ -183,11 +214,42 @@ export declare class InMemorySessionManager {
      * does not use this — the attach ack already carries the snapshot.
      */
     captureHistory(id: string): Promise<string>;
+    /** Acquire a workspace writer lease (Copilot shell execution path). */
+    acquireWriterLease(scope: {
+        userId: string;
+        sessionId: string;
+        workspace: string;
+    }): WriterLeaseHandle;
+    /** Release a previously acquired workspace writer lease. */
+    releaseWriterLease(lease: WriterLeaseHandle): void;
+    /**
+     * Extend a still-held writer lease by one TTL. Returns the renewed handle;
+     * keep using the returned handle for assert/release afterwards.
+     */
+    renewWriterLease(lease: WriterLeaseHandle): WriterLeaseHandle;
+    /**
+     * Check that a workspace writer lease is still held. Throws
+     * SESSION_WRITER_FENCE_STALE when the owner took over (or the lease
+     * expired), which programmatic writers must treat as "the human wins".
+     */
+    assertWriterLeaseCurrent(lease: WriterLeaseHandle): void;
+    /** Stage programmatic (bracketed-paste) input for a session. */
+    stageProgrammaticInput(id: string, data: string): Promise<void>;
+    /** Stage one shell line without bracketed paste (bash 3/readline compatibility). */
+    stageShellCommand(id: string, data: string): Promise<void>;
+    /** Press Enter on a session (submit staged input). */
+    pressEnter(id: string): Promise<void>;
     resizeSession(id: string, cols: number, rows: number): Promise<void>;
     sendInput(id: string, data: string): Promise<void>;
     submitProgrammaticTask(id: string, input: ProgrammaticTaskInput): Promise<ProgrammaticTaskStageReceipt>;
+    captureScreen(userId: string, id: string): Promise<{
+        output: string;
+        live: boolean;
+    }>;
     assertManualInputAllowed(userId: string, id: string): void;
     takeoverSession(userId: string, id: string): void;
+    /** Called immediately before actual manual input; hooks after it are no longer task-specific evidence. */
+    noteManualInput(userId: string, id: string): void;
     cancelProgrammaticInput(userId: string, id: string): void;
     private invalidateWriter;
     private requireOwnedSession;