@holon-run/agentinbox 0.7.0 → 1.0.0-beta.0

package/dist/src/runtime_gate.js

@@ -12,33 +12,35 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_os_1 = __importDefault(require("node:os"));
 const logging_1 = require("./logging");
 const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
-const DEFAULT_ITERM2_SAMPLE_DELAY_MS = 900;
-const DEFAULT_TMUX_SAMPLE_DELAY_MS = 900;
-const NORMALIZED_BUFFER_TAIL_LINES = 20;
-const ACTIVE_BUFFER_MARKERS = [
-    "esc to interrupt",
-    "Working (",
-    "⠼ ",
-];
-const TYPING_PROMPT_PREFIXES = [
-    "› ",
-    "> ",
-];
+const DEFAULT_GATING_POLICY = {
+    iTerm2SampleDelayMs: 900,
+    tmuxSampleDelayMs: 900,
+    normalizedBufferTailLines: 20,
+    activeBufferMarkers: [
+        "esc to interrupt",
+        "Working (",
+        "⠼ ",
+    ],
+    typingPromptPrefixes: [
+        "› ",
+        "> ",
+    ],
+};
 class DefaultActivationGate {
     runtimeProbes;
     terminalProbes;
     logger;
-    constructor(runtimeProbes, terminalProbes, logger = new logging_1.NoopLogger()) {
+    constructor(runtimeProbes, terminalProbes, logger = new logging_1.NoopLogger(), gatingPolicy = DEFAULT_GATING_POLICY) {
         this.logger = logger.child("activation_gate");
         this.runtimeProbes = runtimeProbes ?? [
             new CodexRuntimePresenceProbe(undefined, undefined, this.logger.child("codex_runtime")),
             new ClaudeCodeRuntimePresenceProbe(undefined, undefined, this.logger.child("claude_runtime")),
         ];
         this.terminalProbes = terminalProbes ?? [
-            new CodexTerminalStateProbe(undefined, undefined, undefined, undefined, undefined, this.logger.child("codex_terminal")),
-            new Iterm2TerminalStateProbe(undefined, {}, this.logger.child("iterm2_terminal")),
+            new CodexTerminalStateProbe(undefined, undefined, undefined, undefined, undefined, this.logger.child("codex_terminal"), gatingPolicy),
+            new Iterm2TerminalStateProbe(undefined, {}, this.logger.child("iterm2_terminal"), gatingPolicy),
             new ClaudeCodeTerminalStateProbe(undefined, undefined, undefined, this.logger.child("claude_terminal")),
-            new TmuxTerminalStateProbe(undefined, {}, this.logger.child("tmux_terminal")),
+            new TmuxTerminalStateProbe(undefined, {}, this.logger.child("tmux_terminal"), gatingPolicy),
         ];
     }
     async evaluate(target) {
@@ -178,13 +180,15 @@ class CodexTerminalStateProbe {
     statReader;
     nowFn;
     logger;
-    constructor(iTermProbe = new Iterm2TerminalStateProbe(), tmuxProbe = new TmuxTerminalStateProbe(), sessionFileReader, statReader, nowFn = () => Date.now(), logger = new logging_1.NoopLogger()) {
+    gatingPolicy;
+    constructor(iTermProbe = new Iterm2TerminalStateProbe(undefined, {}, new logging_1.NoopLogger(), DEFAULT_GATING_POLICY), tmuxProbe = new TmuxTerminalStateProbe(undefined, {}, new logging_1.NoopLogger(), DEFAULT_GATING_POLICY), sessionFileReader, statReader, nowFn = () => Date.now(), logger = new logging_1.NoopLogger(), gatingPolicy = DEFAULT_GATING_POLICY) {
         this.iTermProbe = iTermProbe;
         this.tmuxProbe = tmuxProbe;
         this.sessionFileReader = sessionFileReader;
         this.statReader = statReader;
         this.nowFn = nowFn;
         this.logger = logger;
+        this.gatingPolicy = gatingPolicy;
     }
     supports(target) {
         return target.runtimeKind === "codex";
@@ -269,10 +273,12 @@ class Iterm2TerminalStateProbe {
     execAsync;
     options;
     logger;
-    constructor(execAsync = execFileAsync, options = {}, logger = new logging_1.NoopLogger()) {
+    gatingPolicy;
+    constructor(execAsync = execFileAsync, options = {}, logger = new logging_1.NoopLogger(), gatingPolicy = DEFAULT_GATING_POLICY) {
         this.execAsync = execAsync;
         this.options = options;
         this.logger = logger;
+        this.gatingPolicy = gatingPolicy;
     }
     supports(target) {
         // Only support iTerm2 targets that are NOT Claude Code
@@ -337,7 +343,7 @@ class Iterm2TerminalStateProbe {
             if (data.status === "available") {
                 // If we have cursor and lines data, use cursor-aware detection
                 if (data.cursor && Array.isArray(data.lines)) {
-                    const bufferTail = normalizeProbeTailFromLines(data.lines);
+                    const bufferTail = normalizeProbeTailFromLines(data.lines, this.gatingPolicy.normalizedBufferTailLines);
                     if (!bufferTail) {
                         this.logger.trace("probe_python_result", {
                             sessionId,
@@ -363,13 +369,13 @@ class Iterm2TerminalStateProbe {
                     // If cursor-aware detection is certain it's not busy, don't apply prompt heuristics
                     if (busyStatus === "not_busy") {
                         // Still check for buffer changes and active markers
-                        await (this.options.sleep ?? sleep)(this.options.sampleDelayMs ?? DEFAULT_ITERM2_SAMPLE_DELAY_MS);
+                        await (this.options.sleep ?? sleep)(this.options.sampleDelayMs ?? this.gatingPolicy.iTerm2SampleDelayMs);
                         const secondResult = await this.execAsync("python3", [scriptPath, sessionId], {
                             env: { ...process.env, PYTHONIOENCODING: "utf-8" }
                         });
                         const secondData = JSON.parse(secondResult.stdout);
                         if (secondData.status === "available" && Array.isArray(secondData.lines)) {
-                            const secondBufferTail = normalizeProbeTailFromLines(secondData.lines);
+                            const secondBufferTail = normalizeProbeTailFromLines(secondData.lines, this.gatingPolicy.normalizedBufferTailLines);
                             if (secondBufferTail && bufferTail !== secondBufferTail) {
                                 this.logger.trace("probe_python_result", {
                                     sessionId,
@@ -380,7 +386,7 @@ class Iterm2TerminalStateProbe {
                             }
                         }
                         // Check for active buffer markers
-                        if (containsActiveBufferMarker(bufferTail)) {
+                        if (containsActiveBufferMarker(bufferTail, this.gatingPolicy.activeBufferMarkers)) {
                             this.logger.trace("probe_python_result", {
                                 sessionId,
                                 result: { presence: "available", busy: "busy" },
@@ -398,13 +404,13 @@ class Iterm2TerminalStateProbe {
                     // If cursor-aware detection is uncertain, fall back to buffer change detection only
                     // Do NOT use generic typing prompts to avoid false positives (see #116)
                     if (busyStatus === "unknown") {
-                        await (this.options.sleep ?? sleep)(this.options.sampleDelayMs ?? DEFAULT_ITERM2_SAMPLE_DELAY_MS);
+                        await (this.options.sleep ?? sleep)(this.options.sampleDelayMs ?? this.gatingPolicy.iTerm2SampleDelayMs);
                         const secondResult = await this.execAsync("python3", [scriptPath, sessionId], {
                             env: { ...process.env, PYTHONIOENCODING: "utf-8" }
                         });
                         const secondData = JSON.parse(secondResult.stdout);
                         if (secondData.status === "available" && Array.isArray(secondData.lines)) {
-                            const secondBufferTail = normalizeProbeTailFromLines(secondData.lines);
+                            const secondBufferTail = normalizeProbeTailFromLines(secondData.lines, this.gatingPolicy.normalizedBufferTailLines);
                             if (secondBufferTail && bufferTail !== secondBufferTail) {
                                 this.logger.trace("probe_python_result", {
                                     sessionId,
@@ -415,7 +421,7 @@ class Iterm2TerminalStateProbe {
                             }
                         }
                         // Check for active buffer markers
-                        if (containsActiveBufferMarker(bufferTail)) {
+                        if (containsActiveBufferMarker(bufferTail, this.gatingPolicy.activeBufferMarkers)) {
                             this.logger.trace("probe_python_result", {
                                 sessionId,
                                 result: { presence: "available", busy: "busy" },
@@ -493,7 +499,7 @@ class Iterm2TerminalStateProbe {
         if (!first) {
             return { presence: "available", busy: "unknown" };
         }
-        await (this.options.sleep ?? sleep)(this.options.sampleDelayMs ?? DEFAULT_ITERM2_SAMPLE_DELAY_MS);
+        await (this.options.sleep ?? sleep)(this.options.sampleDelayMs ?? this.gatingPolicy.iTerm2SampleDelayMs);
         const second = await this.readBufferTail(it2api, sessionId);
         if (!second) {
             return { presence: "available", busy: "unknown" };
@@ -506,7 +512,7 @@ class Iterm2TerminalStateProbe {
             });
             return { presence: "available", busy: "busy" };
         }
-        if (containsActiveBufferMarker(second)) {
+        if (containsActiveBufferMarker(second, this.gatingPolicy.activeBufferMarkers)) {
             this.logger.trace("probe_cli_result", {
                 sessionId,
                 result: { presence: "available", busy: "busy" },
@@ -549,7 +555,7 @@ class Iterm2TerminalStateProbe {
     async readBufferTail(it2api, sessionId) {
         try {
             const result = await this.execAsync(it2api, ["get-buffer", sessionId]);
-            return normalizeBufferTail(result.stdout);
+            return normalizeBufferTail(result.stdout, this.gatingPolicy.normalizedBufferTailLines);
         }
         catch {
             return null;
@@ -561,10 +567,12 @@ class TmuxTerminalStateProbe {
     execAsync;
     options;
     logger;
-    constructor(execAsync = execFileAsync, options = {}, logger = new logging_1.NoopLogger()) {
+    gatingPolicy;
+    constructor(execAsync = execFileAsync, options = {}, logger = new logging_1.NoopLogger(), gatingPolicy = DEFAULT_GATING_POLICY) {
         this.execAsync = execAsync;
         this.options = options;
         this.logger = logger;
+        this.gatingPolicy = gatingPolicy;
     }
     supports(target) {
         return target.backend === "tmux" && typeof target.tmuxPaneId === "string" && target.tmuxPaneId.trim().length > 0;
@@ -611,7 +619,7 @@ class TmuxTerminalStateProbe {
         if (!first) {
             return { presence: "available", busy: "unknown" };
         }
-        await (this.options.sleep ?? sleep)(this.options.sampleDelayMs ?? DEFAULT_TMUX_SAMPLE_DELAY_MS);
+        await (this.options.sleep ?? sleep)(this.options.sampleDelayMs ?? this.gatingPolicy.tmuxSampleDelayMs);
         const second = await this.readBufferTail(paneId);
         if (!second) {
             return { presence: "available", busy: "unknown" };
@@ -625,7 +633,7 @@ class TmuxTerminalStateProbe {
             });
             return { presence: "available", busy: "busy" };
         }
-        if (containsActiveBufferMarker(second)) {
+        if (containsActiveBufferMarker(second, this.gatingPolicy.activeBufferMarkers)) {
             this.logger.trace("probe_result", {
                 targetId: target.targetId,
                 paneId,
@@ -684,8 +692,8 @@ class TmuxTerminalStateProbe {
     }
     async readBufferTail(paneId) {
         try {
-            const result = await this.execAsync("tmux", ["capture-pane", "-p", "-t", paneId, "-S", `-${NORMALIZED_BUFFER_TAIL_LINES}`]);
-            return normalizeBufferTail(result.stdout);
+            const result = await this.execAsync("tmux", ["capture-pane", "-p", "-t", paneId, "-S", `-${this.gatingPolicy.normalizedBufferTailLines}`]);
+            return normalizeBufferTail(result.stdout, this.gatingPolicy.normalizedBufferTailLines);
         }
         catch {
             return null;
@@ -693,10 +701,10 @@ class TmuxTerminalStateProbe {
     }
 }
 exports.TmuxTerminalStateProbe = TmuxTerminalStateProbe;
-function containsActiveBufferMarker(bufferTail) {
-    return ACTIVE_BUFFER_MARKERS.some((marker) => bufferTail.includes(marker));
+function containsActiveBufferMarker(bufferTail, markers = DEFAULT_GATING_POLICY.activeBufferMarkers) {
+    return markers.some((marker) => bufferTail.includes(marker));
 }
-function hasVisibleTypingPrompt(bufferTail, prefixes = TYPING_PROMPT_PREFIXES) {
+function hasVisibleTypingPrompt(bufferTail, prefixes = DEFAULT_GATING_POLICY.typingPromptPrefixes) {
     const lines = bufferTail
         .split("\n")
         .map((line) => line.trimEnd())
@@ -754,7 +762,7 @@ function typingPromptPrefixesForRuntime(runtimeKind) {
     if (runtimeKind === "claude_code") {
         return ["❯ ", "› "];
     }
-    return TYPING_PROMPT_PREFIXES;
+    return DEFAULT_GATING_POLICY.typingPromptPrefixes;
 }
 function parseOptionalInt(value) {
     if (!value) {
@@ -763,18 +771,18 @@ function parseOptionalInt(value) {
     const parsed = Number.parseInt(value, 10);
     return Number.isFinite(parsed) ? parsed : null;
 }
-function normalizeBufferTail(buffer) {
+function normalizeBufferTail(buffer, tailLines = DEFAULT_GATING_POLICY.normalizedBufferTailLines) {
     const normalized = buffer
         .replace(/\r/g, "")
         .split("\n")
         .map((line) => line.trimEnd())
-        .slice(-NORMALIZED_BUFFER_TAIL_LINES)
+        .slice(-tailLines)
         .join("\n")
         .trim();
     return normalized.length > 0 ? normalized : null;
 }
-function normalizeProbeTailFromLines(lines) {
-    return normalizeBufferTail(lines.join("\n"));
+function normalizeProbeTailFromLines(lines, tailLines = DEFAULT_GATING_POLICY.normalizedBufferTailLines) {
+    return normalizeBufferTail(lines.join("\n"), tailLines);
 }
 function resolveIterm2ApiPath(override) {
     if (override) {