@scotthuang/agent-knock-knock 0.11.2 → 0.11.4

package/dist/src/terminal-agent-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-agent-adapter.js","sourceRoot":"","sources":["../../src/terminal-agent-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"terminal-agent-adapter.js","sourceRoot":"","sources":["../../src/terminal-agent-adapter.ts"],"names":[],"mappings":"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"}

package/dist/src/terminal-agent-bridge.d.ts

@@ -1,6 +1,29 @@
 import type { ExecutorKind } from "./executors.js";
-import { type ActiveTerminalProcess, type TerminalAgentAdapter, type TerminalAgentAdapterCapabilities, type TerminalAgentAdapterRegistry, type TerminalCompletionEvidence, type TerminalControlRef, type TerminalDurableCompletionRequest, type TerminalProcessSnapshot, type TerminalRuntimeIdentity, type TerminalScreenInspection } from "./terminal-agent-adapter.js";
+import { type ActiveTerminalProcess, type TerminalAgentAdapter, type TerminalAgentAdapterCapabilities, type TerminalAgentAdapterRegistry, type TerminalCompletionEvidence, type TerminalControlRef, type TerminalDurableCompletionRequest, type TerminalNativeInspectionEvidenceInventoryEntry, type TerminalNativeInspectionObservation, type TerminalNativeInspectionObservationRequest, type TerminalNativeInspectionPlan, type TerminalProcessSnapshot, type TerminalRuntimeIdentity, type TerminalScreenInspection } from "./terminal-agent-adapter.js";
 import { type TerminalControlProvider } from "./terminal-control-provider.js";
+/** A terminal send failed at a boundary that proves input never started. */
+export declare class TerminalInputNotStartedError extends Error {
+    readonly code = "AKK_TERMINAL_INPUT_NOT_STARTED";
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export type NativeInspectionSubmissionStage = "not_started" | "text_injected" | "enter_uncertain";
+/**
+ * A fail-closed native-inspection submission result.
+ *
+ * Only `not_started` proves that a caller may safely retry. Once text has
+ * reached the composer, or Enter has been attempted, automated retries could
+ * duplicate input or execute a different command after terminal drift.
+ */
+export declare class NativeInspectionSubmissionError extends Error {
+    readonly stage: NativeInspectionSubmissionStage;
+    readonly code = "AKK_NATIVE_INSPECTION_SUBMISSION_FAILED";
+    readonly doNotRetry: boolean;
+    constructor(stage: NativeInspectionSubmissionStage, message: string, options?: {
+        cause?: unknown;
+    });
+}
 export interface TerminalBridgeStatus {
     provider: "tmux";
     target: string;
@@ -98,6 +121,47 @@ export interface TerminalSendResult {
     terminalControl: TerminalControlRef;
     multiline: boolean;
 }
+export type TerminalNativeInspectionMaterializationKind = "exact_slash_composer" | "exact_slash_popup";
+export interface TerminalNativeInspectionMaterializationEvidence {
+    kind: TerminalNativeInspectionMaterializationKind;
+    digest: string;
+    stableForMs: number;
+    stableCaptures: number;
+}
+export interface TerminalNativeInspectionBeforeEnterContext {
+    agent: "codex";
+    terminalControl: TerminalControlRef;
+    plan: TerminalNativeInspectionPlan;
+    preEnterScreenDigest: string;
+    materialization: TerminalNativeInspectionMaterializationEvidence;
+}
+export interface TerminalNativeInspectionOptions {
+    runtime?: TerminalRuntimeIdentity;
+    /**
+     * Gives the CLI one final in-lock authorization point for its Store binding
+     * and action-token fences. The bridge recaptures the exact composer and
+     * revalidates terminal identity again after this hook before pressing Enter.
+     */
+    beforeEnter?: (context: TerminalNativeInspectionBeforeEnterContext) => void | Promise<void>;
+}
+export interface TerminalNativeInspectionResult {
+    stage: "enter_dispatched";
+    agent: "codex";
+    terminalControl: TerminalControlRef;
+    command: "/status";
+    behaviorProfile: string;
+    preEnterScreenDigest: string;
+    preEnterEvidenceInventory: readonly TerminalNativeInspectionEvidenceInventoryEntry[];
+    materialization: TerminalNativeInspectionMaterializationEvidence;
+    enterCount: 1;
+}
+export interface TerminalNativeInspectionObservationResult {
+    terminalControl: TerminalControlRef;
+    status: TerminalBridgeStatus;
+    /** Same raw-screen fingerprint format used by adapter stale checks. */
+    screenDigest: string;
+    observation: TerminalNativeInspectionObservation;
+}
 export interface TerminalApprovalAuthorizationContext {
     agent: ExecutorKind;
     terminalControl: TerminalControlRef;
@@ -145,6 +209,20 @@ export declare class TerminalAgentBridge {
         runtime?: TerminalRuntimeIdentity;
     }): Promise<TerminalBridgeStatus>;
     send(agent: ExecutorKind, terminalControl: TerminalControlRef, text: string, options?: TerminalSendOptions): Promise<TerminalSendResult>;
+    /**
+     * Submit one closed, adapter-owned native inspection command.
+     *
+     * This intentionally does not use `send()`: native slash commands need a
+     * stricter composer proof, and failures after text injection must leave the
+     * draft untouched instead of issuing the legacy best-effort C-u cleanup.
+     */
+    submitNativeInspection(agent: ExecutorKind, terminalControl: TerminalControlRef, plan: TerminalNativeInspectionPlan, options?: TerminalNativeInspectionOptions): Promise<TerminalNativeInspectionResult>;
+    observeNativeInspection(agent: ExecutorKind, terminalControl: TerminalControlRef, request: TerminalNativeInspectionObservationRequest, options?: {
+        runtime?: TerminalRuntimeIdentity;
+        scrollbackLines?: number;
+    }): Promise<TerminalNativeInspectionObservationResult>;
+    private settleCodexNativeInspectionComposer;
+    private revalidateCodexNativeInspectionComposer;
     private settleCodexMultilineComposer;
     /**
      * Prove that the exact managed draft is still present after Enter dispatch.

package/dist/src/terminal-agent-bridge.js

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 import { formatTerminalConversationId, parseTerminalConversationId, terminalControlCapabilitiesForAdapter } from "./terminal-agent-adapter.js";
-import { enrichActiveProcessesWithTerminalControl, terminalRefFromPane } from "./terminal-control-provider.js";
+import { enrichActiveProcessesWithTerminalControl, TerminalControlInputNotSentError, terminalRefFromPane } from "./terminal-control-provider.js";
 // Codex 0.146.x keeps Enter in paste/newline mode for 120ms after burst input.
 // Cross that boundary rather than landing on it, and also require observable
 // composer stability instead of treating this delay alone as acceptance.
@@ -11,7 +11,40 @@ const CODEX_MULTILINE_STABLE_CAPTURES = 2;
 const CODEX_MULTILINE_SETTLE_SCROLLBACK_LINES = 240;
 const CODEX_COMPOSER_MARKER = /^[›»](?:\s|$)/u;
 const CODEX_COMPOSER_FOOTER = /^(?:gpt-[\w.-]+(?:\s|$)|[-\w.]+ default ·)/u;
+// Codex 0.146.0 and 0.146.1 render the same verified slash-completion row.
+// Keep it closed per behavior profile so changed text cannot silently become
+// a newly authorized native command surface.
+const CODEX_NATIVE_STATUS_POPUP_BY_PROFILE = {
+    "codex-tui-0.146.0": "  /status  show current session configuration and token usage",
+    "codex-tui-0.146.1": "  /status  show current session configuration and token usage"
+};
 const CODEX_LARGE_PASTE_CHAR_THRESHOLD = 1_000;
+/** A terminal send failed at a boundary that proves input never started. */
+export class TerminalInputNotStartedError extends Error {
+    code = "AKK_TERMINAL_INPUT_NOT_STARTED";
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "TerminalInputNotStartedError";
+    }
+}
+/**
+ * A fail-closed native-inspection submission result.
+ *
+ * Only `not_started` proves that a caller may safely retry. Once text has
+ * reached the composer, or Enter has been attempted, automated retries could
+ * duplicate input or execute a different command after terminal drift.
+ */
+export class NativeInspectionSubmissionError extends Error {
+    stage;
+    code = "AKK_NATIVE_INSPECTION_SUBMISSION_FAILED";
+    doNotRetry;
+    constructor(stage, message, options = {}) {
+        super(message, options);
+        this.stage = stage;
+        this.name = "NativeInspectionSubmissionError";
+        this.doNotRetry = stage !== "not_started";
+    }
+}
 export class TerminalAgentBridge {
     registry;
     terminalProvider;
@@ -139,17 +172,33 @@ export class TerminalAgentBridge {
     async send(agent, terminalControl, text, options = {}) {
         const adapter = this.registry.require(agent);
         if (!terminalControl.capabilities.includes("send_keys")) {
-            throw new Error(`${adapter.displayName} terminal input is not supported`);
+            throw new TerminalInputNotStartedError(`${adapter.displayName} terminal input is not supported`);
         }
         const normalized = text.trimEnd();
         if (!normalized) {
-            throw new Error("terminal message is empty");
+            throw new TerminalInputNotStartedError("terminal message is empty");
         }
         const multiline = /[\r\n]/u.test(normalized);
-        const verifiedForText = await this.verifyTerminalIdentity(adapter.agent, terminalControl, options.runtime);
-        await this.terminalProvider.sendText(verifiedForText.target, normalized, {
-            socketPath: verifiedForText.socketPath
-        });
+        let verifiedForText;
+        try {
+            verifiedForText = await this.verifyTerminalIdentity(adapter.agent, terminalControl, options.runtime);
+        }
+        catch (error) {
+            throw new TerminalInputNotStartedError(error instanceof Error ? error.message : String(error), { cause: error });
+        }
+        try {
+            await this.terminalProvider.sendText(verifiedForText.target, normalized, {
+                socketPath: verifiedForText.socketPath
+            });
+        }
+        catch (error) {
+            if (error instanceof TerminalControlInputNotSentError) {
+                throw new TerminalInputNotStartedError(error.message, {
+                    cause: error
+                });
+            }
+            throw error;
+        }
         await options.onTransportStage?.({
             stage: "text_injected",
             agent: adapter.agent,
@@ -195,6 +244,184 @@ export class TerminalAgentBridge {
             multiline
         };
     }
+    /**
+     * Submit one closed, adapter-owned native inspection command.
+     *
+     * This intentionally does not use `send()`: native slash commands need a
+     * stricter composer proof, and failures after text injection must leave the
+     * draft untouched instead of issuing the legacy best-effort C-u cleanup.
+     */
+    async submitNativeInspection(agent, terminalControl, plan, options = {}) {
+        const adapter = this.registry.require(agent);
+        try {
+            assertCodexStatusInspectionPlan(adapter, terminalControl, plan);
+        }
+        catch (error) {
+            throw nativeInspectionSubmissionError("not_started", error);
+        }
+        let verifiedForText;
+        try {
+            verifiedForText = await this.verifyTerminalIdentity(adapter.agent, terminalControl, options.runtime);
+        }
+        catch (error) {
+            throw nativeInspectionSubmissionError("not_started", error);
+        }
+        try {
+            await this.terminalProvider.sendText(verifiedForText.target, plan.command, { socketPath: verifiedForText.socketPath });
+        }
+        catch (error) {
+            if (error instanceof TerminalControlInputNotSentError) {
+                throw nativeInspectionSubmissionError("not_started", error);
+            }
+            // The transport cannot prove whether an untyped failure happened before
+            // or after tmux accepted the literal input. Fail closed as injected.
+            throw nativeInspectionSubmissionError("text_injected", error);
+        }
+        let settled;
+        try {
+            settled = await this.settleCodexNativeInspectionComposer(adapter, terminalControl, plan, options.runtime);
+            await options.beforeEnter?.({
+                agent: "codex",
+                terminalControl: settled.terminalControl,
+                plan,
+                preEnterScreenDigest: settled.screenDigest,
+                materialization: settled.materialization
+            });
+            settled = await this.revalidateCodexNativeInspectionComposer(adapter, settled.terminalControl, plan, settled.materialization, options.runtime);
+        }
+        catch (error) {
+            throw nativeInspectionSubmissionError("text_injected", error);
+        }
+        try {
+            // Exactly one Enter attempt. Any error is submission-uncertain and must
+            // never trigger a fallback executable or a blind second Enter.
+            await this.terminalProvider.sendKeys(settled.terminalControl.target, ["C-m"], { socketPath: settled.terminalControl.socketPath });
+        }
+        catch (error) {
+            throw nativeInspectionSubmissionError("enter_uncertain", error);
+        }
+        return {
+            stage: "enter_dispatched",
+            agent: "codex",
+            terminalControl: settled.terminalControl,
+            command: "/status",
+            behaviorProfile: plan.behaviorProfile,
+            preEnterScreenDigest: settled.screenDigest,
+            preEnterEvidenceInventory: settled.evidenceInventory,
+            materialization: settled.materialization,
+            enterCount: 1
+        };
+    }
+    async observeNativeInspection(agent, terminalControl, request, options = {}) {
+        const adapter = this.registry.require(agent);
+        if (!adapter.observeNativeInspection) {
+            throw new Error(`${adapter.displayName} native inspection observation is not supported`);
+        }
+        const captured = await this.captureInspection(adapter, terminalControl, {
+            runtime: options.runtime,
+            scrollbackLines: options.scrollbackLines
+        });
+        const screenDigest = nativeInspectionScreenFingerprint(captured.screen);
+        const observation = adapter.observeNativeInspection({
+            operation: request.operation,
+            previousScreenFingerprint: request.previousScreenFingerprint,
+            preEnterEvidenceInventory: request.preEnterEvidenceInventory,
+            expectedNativeThreadId: request.expectedNativeThreadId,
+            expectedAgentVersion: request.expectedAgentVersion,
+            screen: captured.screen
+        });
+        return {
+            terminalControl: captured.terminalControl,
+            status: statusFromInspection(adapter, captured.terminalControl, captured.inspection, { screen: captured.screen, runtime: options.runtime }),
+            screenDigest,
+            observation
+        };
+    }
+    async settleCodexNativeInspectionComposer(adapter, terminalControl, plan, runtime) {
+        const startedAt = performance.now();
+        let stableDigest;
+        let stableKind;
+        let stableSince;
+        let stableCaptures = 0;
+        while (performance.now() - startedAt <= CODEX_MULTILINE_SETTLE_TIMEOUT_MS) {
+            const captured = await this.captureInspection(adapter, terminalControl, {
+                runtime,
+                scrollbackLines: CODEX_MULTILINE_SETTLE_SCROLLBACK_LINES
+            });
+            assertNativeInspectionComposerSafe(captured.inspection);
+            const materialized = exactCodexNativeInspectionComposerCapture(captured.screen, plan);
+            const now = performance.now();
+            if (materialized) {
+                if (materialized.digest === stableDigest &&
+                    materialized.kind === stableKind) {
+                    stableCaptures += 1;
+                }
+                else {
+                    stableDigest = materialized.digest;
+                    stableKind = materialized.kind;
+                    stableSince = now;
+                    stableCaptures = 1;
+                }
+                const stableForMs = stableSince === undefined ? 0 : now - stableSince;
+                if (stableCaptures >= CODEX_MULTILINE_STABLE_CAPTURES &&
+                    stableForMs >= plan.composer.minimumStableMs) {
+                    const evidence = {
+                        kind: materialized.kind,
+                        digest: materialized.digest,
+                        stableForMs,
+                        stableCaptures
+                    };
+                    return this.revalidateCodexNativeInspectionComposer(adapter, captured.terminalControl, plan, evidence, runtime);
+                }
+            }
+            else {
+                stableDigest = undefined;
+                stableKind = undefined;
+                stableSince = undefined;
+                stableCaptures = 0;
+            }
+            const elapsed = performance.now() - startedAt;
+            const remaining = CODEX_MULTILINE_SETTLE_TIMEOUT_MS - elapsed;
+            if (remaining <= 0) {
+                break;
+            }
+            await terminalSettleDelay(Math.min(CODEX_MULTILINE_SETTLE_POLL_MS, remaining));
+        }
+        throw new Error("Codex /status composer did not become exact, idle, and stable before the bounded submit deadline");
+    }
+    async revalidateCodexNativeInspectionComposer(adapter, terminalControl, plan, expected, runtime) {
+        const captured = await this.captureInspection(adapter, terminalControl, {
+            runtime,
+            scrollbackLines: CODEX_MULTILINE_SETTLE_SCROLLBACK_LINES
+        });
+        assertNativeInspectionComposerSafe(captured.inspection);
+        const materialized = exactCodexNativeInspectionComposerCapture(captured.screen, plan);
+        if (!materialized ||
+            materialized.digest !== expected.digest ||
+            materialized.kind !== expected.kind) {
+            throw new Error("Codex /status composer changed after its stable pre-submit capture");
+        }
+        const baseline = adapter.observeNativeInspection?.({
+            operation: plan.operation,
+            screen: captured.screen
+        });
+        if (!baseline ||
+            baseline.status === "ambiguous" ||
+            !Array.isArray(baseline.evidenceInventory)) {
+            throw new Error(baseline?.reason ??
+                "Codex /status pre-Enter evidence inventory was not proven");
+        }
+        const verifiedImmediatelyBeforeEnter = await this.verifyTerminalIdentity(adapter.agent, captured.terminalControl, runtime);
+        if (!sameTerminalControlIdentity(captured.terminalControl, verifiedImmediatelyBeforeEnter)) {
+            throw new Error("terminal control identity changed after the final Codex /status composer capture");
+        }
+        return {
+            terminalControl: verifiedImmediatelyBeforeEnter,
+            screenDigest: nativeInspectionScreenFingerprint(captured.screen),
+            evidenceInventory: baseline.evidenceInventory,
+            materialization: expected
+        };
+    }
     async settleCodexMultilineComposer(adapter, terminalControl, expectedText, runtime) {
         const startedAt = performance.now();
         let stableDigest;
@@ -715,6 +942,104 @@ export class TerminalAgentBridge {
         return result?.terminalControl ?? terminalControl;
     }
 }
+function nativeInspectionSubmissionError(stage, error) {
+    if (error instanceof NativeInspectionSubmissionError) {
+        const stageRank = {
+            not_started: 0,
+            text_injected: 1,
+            enter_uncertain: 2
+        };
+        if (stageRank[error.stage] >= stageRank[stage]) {
+            return error;
+        }
+        return new NativeInspectionSubmissionError(stage, error.message, {
+            cause: error
+        });
+    }
+    return new NativeInspectionSubmissionError(stage, error instanceof Error ? error.message : String(error), { cause: error });
+}
+function assertCodexStatusInspectionPlan(adapter, terminalControl, plan) {
+    if (adapter.agent !== "codex") {
+        throw new Error("native /status inspection is currently supported only for Codex");
+    }
+    if (!terminalControl.capabilities.includes("send_keys")) {
+        throw new Error("Codex terminal input is not supported");
+    }
+    if (!terminalControl.capabilities.includes("screen_status")) {
+        throw new Error("Codex terminal screen inspection is not supported");
+    }
+    if (plan.operation.kind !== "status" ||
+        plan.command !== "/status" ||
+        plan.effect !== "read_only" ||
+        plan.requiresIdle !== true ||
+        plan.composer.kind !== "exact" ||
+        !Number.isFinite(plan.composer.minimumStableMs) ||
+        plan.composer.minimumStableMs < CODEX_PASTE_ENTER_SETTLE_MS ||
+        plan.expectedResult.kind !== "native_status" ||
+        ![
+            "codex-tui-0.146.0",
+            "codex-tui-0.146.1"
+        ].includes(plan.behaviorProfile)) {
+        throw new Error("refusing a non-closed or unverified native inspection plan");
+    }
+}
+function assertNativeInspectionComposerSafe(inspection) {
+    if (inspection.approval.blocked ||
+        inspection.activity.state === "awaiting_approval" ||
+        inspection.activity.state === "working") {
+        throw new Error("Codex became busy or blocked while its /status composer was settling");
+    }
+    // Codex's generic activity parser deliberately reports a non-empty slash
+    // composer as unknown. At this stage the caller has already proved an idle,
+    // empty styled composer under the terminal lock; the exact-current composer
+    // capture below is the stronger continuation proof after AKK injected only
+    // the adapter-owned /status command.
+}
+function exactCodexNativeInspectionComposerCapture(screen, plan) {
+    const lines = screen.replace(/\r\n?/gu, "\n").split("\n");
+    let currentComposerIndex = -1;
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        if (CODEX_COMPOSER_MARKER.test(lines[index])) {
+            currentComposerIndex = index;
+            break;
+        }
+    }
+    if (currentComposerIndex < 0) {
+        return undefined;
+    }
+    const composerText = lines[currentComposerIndex]
+        .replace(/^[›»]\s?/u, "")
+        .trimEnd();
+    if (composerText !== plan.command) {
+        return undefined;
+    }
+    const footerIndex = lines.findIndex((line, candidateIndex) => candidateIndex > currentComposerIndex &&
+        CODEX_COMPOSER_FOOTER.test(line.trim()));
+    const region = lines.slice(currentComposerIndex, footerIndex < 0 ? lines.length : footerIndex);
+    while (region.length > 1 && region.at(-1)?.trim() === "") {
+        region.pop();
+    }
+    const popupRows = region.slice(1).filter((line) => line.trim().length > 0);
+    let kind;
+    if (popupRows.length === 0) {
+        kind = "exact_slash_composer";
+    }
+    else if (popupRows.length === 1 &&
+        popupRows[0].trimEnd() ===
+            CODEX_NATIVE_STATUS_POPUP_BY_PROFILE[plan.behaviorProfile]) {
+        kind = "exact_slash_popup";
+    }
+    else {
+        return undefined;
+    }
+    return {
+        kind,
+        digest: createHash("sha256").update(region.join("\n")).digest("hex")
+    };
+}
+function nativeInspectionScreenFingerprint(screen) {
+    return `sha256:${createHash("sha256").update(screen).digest("hex")}`;
+}
 function exactCodexComposerCapture(screen, expectedText) {
     const lines = screen.replace(/\r\n?/gu, "\n").split("\n");
     const expectedComparable = composerComparableText(expectedText);