@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

package/dist/src/terminal-monitor-poll-policy.d.ts

@@ -0,0 +1,48 @@
+export interface TerminalMonitorPollState {
+    previousScreenFingerprint: string | undefined;
+    previousDurableFingerprint?: string;
+    previousCompletionFingerprint?: string;
+}
+export interface TerminalMonitorActivityPollInput {
+    state: TerminalMonitorPollState;
+    activityState?: string;
+    activityReason?: string;
+    screenFingerprint?: string;
+    durableFingerprint?: string;
+}
+export interface TerminalMonitorActivityPollDecision {
+    state: TerminalMonitorPollState;
+    screenChanged: boolean;
+    durableChanged: boolean;
+    activityReasons: string[];
+    activityReason?: string;
+}
+export declare function reduceTerminalMonitorActivityPoll(input: TerminalMonitorActivityPollInput): TerminalMonitorActivityPollDecision;
+export interface TerminalMonitorCompletionPollInput {
+    state: TerminalMonitorPollState;
+    completionPresent: boolean;
+    completionFingerprint?: string;
+}
+export interface TerminalMonitorCompletionPollDecision {
+    state: TerminalMonitorPollState;
+    completionStable: boolean;
+    checkVerifiedDeadAgent: boolean;
+}
+export declare function reduceTerminalMonitorCompletionPoll(input: TerminalMonitorCompletionPollInput): TerminalMonitorCompletionPollDecision;
+export type TerminalMonitorTimeoutDecision = {
+    kind: "none";
+} | {
+    kind: "hard";
+    deadlineAtMs: number;
+} | {
+    kind: "inactivity";
+    deadlineAtMs: number;
+};
+export interface TerminalMonitorTimeoutInput {
+    nowMs: number;
+    taskStartedAtMs: number;
+    lastActivityAtMs: number;
+    hardTimeoutMinutes?: number;
+    inactivityTimeoutMinutes?: number;
+}
+export declare function decideTerminalMonitorTimeout(input: TerminalMonitorTimeoutInput): TerminalMonitorTimeoutDecision;

package/dist/src/terminal-monitor-poll-policy.js

@@ -0,0 +1,67 @@
+export function reduceTerminalMonitorActivityPoll(input) {
+    const screenChanged = input.state.previousScreenFingerprint !== undefined &&
+        input.screenFingerprint !== undefined &&
+        input.screenFingerprint !== input.state.previousScreenFingerprint;
+    const durableChanged = input.durableFingerprint !== undefined &&
+        input.durableFingerprint !== input.state.previousDurableFingerprint;
+    const activityReasons = [
+        input.activityState === "working" ? input.activityReason : undefined,
+        screenChanged ? "terminal screen changed" : undefined,
+        durableChanged ? "durable completion evidence changed" : undefined
+    ].filter((value) => Boolean(value));
+    return {
+        state: {
+            ...input.state,
+            previousScreenFingerprint: input.screenFingerprint,
+            previousDurableFingerprint: input.durableFingerprint
+        },
+        screenChanged,
+        durableChanged,
+        activityReasons,
+        ...(activityReasons.length > 0
+            ? { activityReason: activityReasons.join("; ") }
+            : {})
+    };
+}
+export function reduceTerminalMonitorCompletionPoll(input) {
+    return {
+        state: {
+            ...input.state,
+            previousCompletionFingerprint: input.completionFingerprint
+        },
+        completionStable: input.completionPresent &&
+            input.completionFingerprint !== undefined &&
+            input.completionFingerprint ===
+                input.state.previousCompletionFingerprint,
+        checkVerifiedDeadAgent: !input.completionPresent
+    };
+}
+function enabledTimeoutMs(startedAtMs, timeoutMinutes) {
+    if (timeoutMinutes === undefined ||
+        !Number.isFinite(timeoutMinutes) ||
+        timeoutMinutes <= 0) {
+        return undefined;
+    }
+    const timeoutMs = timeoutMinutes * 60 * 1000;
+    return {
+        deadlineAtMs: startedAtMs + timeoutMs,
+        timeoutMs
+    };
+}
+export function decideTerminalMonitorTimeout(input) {
+    const hardTimeout = enabledTimeoutMs(input.taskStartedAtMs, input.hardTimeoutMinutes);
+    if (hardTimeout !== undefined &&
+        input.nowMs - input.taskStartedAtMs >= hardTimeout.timeoutMs) {
+        return { kind: "hard", deadlineAtMs: hardTimeout.deadlineAtMs };
+    }
+    const inactivityTimeout = enabledTimeoutMs(input.lastActivityAtMs, input.inactivityTimeoutMinutes);
+    if (inactivityTimeout !== undefined &&
+        input.nowMs - input.lastActivityAtMs >= inactivityTimeout.timeoutMs) {
+        return {
+            kind: "inactivity",
+            deadlineAtMs: inactivityTimeout.deadlineAtMs
+        };
+    }
+    return { kind: "none" };
+}
+//# sourceMappingURL=terminal-monitor-poll-policy.js.map

package/dist/src/terminal-monitor-poll-policy.js.map

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

package/dist/src/terminal-monitor-reconciliation-eligibility.d.ts

@@ -0,0 +1,53 @@
+import type { DeferredForegroundTransfer } from "./deferred-foreground-transfer.js";
+import { type Conversation } from "./protocol.js";
+import type { TerminalControlRef, TerminalRuntimeIdentity } from "./terminal-agent-adapter.js";
+type JsonRecord = Record<string, unknown>;
+export type TerminalMonitorEligibilityRequest = {
+    kind: "control";
+    nativeTakeover: JsonRecord;
+} | {
+    kind: "dispatch";
+    terminalControl: TerminalControlRef;
+} | {
+    kind: "store";
+} | {
+    kind: "runtime";
+    terminalControl: TerminalControlRef;
+} | {
+    kind: "deferred";
+    storeDir: string;
+    transferId: string;
+};
+export type TerminalMonitorEligibilityObservation = {
+    kind: "control";
+    terminalControl?: TerminalControlRef;
+} | {
+    kind: "dispatch";
+    ledger?: JsonRecord;
+} | {
+    kind: "store";
+    storeDir?: string;
+} | {
+    kind: "runtime";
+    runtime: TerminalRuntimeIdentity;
+} | {
+    kind: "deferred";
+    transfer: DeferredForegroundTransfer;
+};
+export type TerminalMonitorEligibility = {
+    eligible: false;
+    reason: string;
+} | {
+    eligible: true;
+    nativeTakeover: JsonRecord;
+    terminalMessageId: string;
+    terminalControl: TerminalControlRef;
+    runtime: TerminalRuntimeIdentity;
+    inactivityTimeoutMinutes: number;
+    hardTimeoutMinutes: number;
+    inactivityDeadlineAtMs: number;
+    hardDeadlineAtMs: number;
+};
+/** Pure staged eligibility; callers perform only the observations yielded. */
+export declare function terminalMonitorReconciliationEligibility(conversation: Conversation): Generator<TerminalMonitorEligibilityRequest, TerminalMonitorEligibility, TerminalMonitorEligibilityObservation>;
+export {};

package/dist/src/terminal-monitor-reconciliation-eligibility.js

@@ -0,0 +1,114 @@
+import path from "node:path";
+import { isFinalDeferredForegroundTransferStatus } from "./deferred-foreground-transfer-policy.js";
+import { isWaitingForAgentStatus, sessionIdForConversation, turnIdForConversation } from "./protocol.js";
+import { terminalControlEvidenceMatches } from "./terminal-control-ref.js";
+import { sameCanonicalStatePath } from "./terminal-dispatch-ledger-codec.js";
+import { validTerminalMonitorTimestampMs as validTimestampMs } from "./terminal-monitor-decision-policy.js";
+import { terminalBridgeSubmission, validateCodexRolloutAcceptanceAnchor } from "./terminal-submission-facts.js";
+import { isRecord, nonBlankString } from "./value-guards.js";
+/** Pure staged eligibility; callers perform only the observations yielded. */
+export function* terminalMonitorReconciliationEligibility(conversation) {
+    const nativeTakeover = isRecord(conversation.native_session_takeover)
+        ? conversation.native_session_takeover
+        : undefined;
+    if (nativeTakeover?.terminal_bridge !== true) {
+        return ineligible("not_terminal_bridge");
+    }
+    if (!isWaitingForAgentStatus(conversation.status)) {
+        return ineligible(`conversation_status_${String(conversation.status ?? "missing")}`);
+    }
+    const terminalMessageId = nonBlankString(nativeTakeover.terminal_bridge_message_id);
+    const control = expectObservation("control", yield { kind: "control", nativeTakeover });
+    const terminalControl = control.terminalControl;
+    if (!terminalMessageId || !terminalControl) {
+        return ineligible("terminal_bridge_identity_missing");
+    }
+    const dispatch = expectObservation("dispatch", yield { kind: "dispatch", terminalControl });
+    const ledger = dispatch.ledger;
+    const statePath = nonBlankString(conversation.state_path);
+    const dispatchStore = expectObservation("store", yield { kind: "store" });
+    const bindingId = nonBlankString(conversation.terminal_binding_id);
+    const bindingGeneration = Number(conversation.terminal_binding_generation);
+    if (!ledger ||
+        nonBlankString(ledger.message_id) !== terminalMessageId ||
+        !terminalControlEvidenceMatches(ledger.terminal_endpoint !== undefined
+            ? ledger.terminal_endpoint
+            : ledger.terminal_control, terminalControl) ||
+        nonBlankString(ledger.conversation_id) !== conversation.conversation_id ||
+        nonBlankString(ledger.session_id) !== sessionIdForConversation(conversation) ||
+        nonBlankString(ledger.turn_id) !== turnIdForConversation(conversation) ||
+        !statePath || !sameCanonicalStatePath(ledger.state_path, statePath) ||
+        !dispatchStore.storeDir ||
+        path.resolve(nonBlankString(ledger.store_dir) ?? "") !==
+            path.resolve(dispatchStore.storeDir) ||
+        (bindingId !== undefined && nonBlankString(ledger.binding_id) !== bindingId) ||
+        (Number.isSafeInteger(bindingGeneration) &&
+            Number(ledger.binding_generation) !== bindingGeneration) ||
+        !["prepared", "text_injected", "enter_dispatched", "agent_accepted", "submitted"]
+            .includes(String(ledger.status))) {
+        return ineligible(`terminal_dispatch_${String(ledger?.status ?? "missing_or_generation_replaced")}`);
+    }
+    const submission = terminalBridgeSubmission(conversation);
+    if (submission &&
+        nonBlankString(submission.message_id) === terminalMessageId &&
+        ["not_accepted", "uncertain", "aborted"].includes(String(submission.status))) {
+        return ineligible(`terminal_submission_${submission.status}`);
+    }
+    const runtimeObservation = expectObservation("runtime", yield { kind: "runtime", terminalControl });
+    const runtime = runtimeObservation.runtime;
+    if (!Number.isInteger(runtime.pid) || Number(runtime.pid) <= 0 ||
+        !nonBlankString(runtime.cwd)) {
+        return ineligible("terminal_agent_identity_missing");
+    }
+    const deferredStore = expectObservation("store", yield { kind: "store" });
+    const transferId = nonBlankString(nativeTakeover.deferred_foreground_transfer_id);
+    if (deferredStore.storeDir && transferId) {
+        const deferred = expectObservation("deferred", yield {
+            kind: "deferred", storeDir: deferredStore.storeDir, transferId
+        });
+        const transfer = deferred.transfer;
+        if (!isFinalDeferredForegroundTransferStatus(transfer.status) && (validateCodexRolloutAcceptanceAnchor(nativeTakeover.codex_rollout_acceptance_anchor)?.version !== 3 ||
+            transfer.status !== "dispatch_started" ||
+            submission?.status !== "enter_dispatched" ||
+            transfer.turn_id !== turnIdForConversation(conversation) ||
+            transfer.message_id !== terminalMessageId ||
+            transfer.target_session_id !== sessionIdForConversation(conversation))) {
+            return ineligible(`deferred_foreground_transfer_${transfer.status}`);
+        }
+    }
+    const inactivityTimeoutMinutes = Number(nativeTakeover.terminal_bridge_inactivity_timeout_minutes);
+    const hardTimeoutMinutes = Number(nativeTakeover.terminal_bridge_hard_timeout_minutes);
+    const startedAtMs = validTimestampMs(nativeTakeover.terminal_bridge_started_at);
+    const lastActivityAtMs = validTimestampMs(nativeTakeover.terminal_bridge_last_activity_at);
+    const inactivityDeadlineAtMs = validTimestampMs(nativeTakeover.terminal_bridge_inactivity_deadline_at);
+    const hardDeadlineAtMs = validTimestampMs(nativeTakeover.terminal_bridge_hard_deadline_at);
+    if (!Number.isFinite(inactivityTimeoutMinutes) ||
+        inactivityTimeoutMinutes <= 0 ||
+        !Number.isFinite(hardTimeoutMinutes) ||
+        hardTimeoutMinutes <= 0 ||
+        startedAtMs === undefined ||
+        lastActivityAtMs === undefined ||
+        inactivityDeadlineAtMs === undefined ||
+        hardDeadlineAtMs === undefined) {
+        return ineligible("terminal_bridge_deadline_metadata_missing");
+    }
+    return {
+        eligible: true,
+        nativeTakeover,
+        terminalMessageId,
+        terminalControl,
+        runtime,
+        inactivityTimeoutMinutes,
+        hardTimeoutMinutes,
+        inactivityDeadlineAtMs,
+        hardDeadlineAtMs
+    };
+}
+const ineligible = (reason) => ({ eligible: false, reason });
+function expectObservation(kind, observation) {
+    if (observation === undefined || observation.kind !== kind) {
+        throw new Error(`terminal monitor eligibility expected ${kind} observation`);
+    }
+    return observation;
+}
+//# sourceMappingURL=terminal-monitor-reconciliation-eligibility.js.map

package/dist/src/terminal-monitor-reconciliation-eligibility.js.map

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

package/dist/src/terminal-monitor-state-cli-adapter.d.ts

@@ -0,0 +1,106 @@
+import { type Conversation } from "./protocol.js";
+import { type TerminalControlRef } from "./terminal-agent-adapter.js";
+import { type TerminalAgentBridge } from "./terminal-agent-bridge.js";
+import { type TerminalMonitorDeferralPorts } from "./terminal-monitor-application-service.js";
+import { type TerminalMonitorEligibility } from "./terminal-monitor-reconciliation-eligibility.js";
+import { type TerminalMonitorStatePaths, type TerminalMonitorStateReconciliation } from "./terminal-monitor-state-reconciliation-service.js";
+import type { TerminalDispatchRepositoryCliAdapter } from "./terminal-dispatch-repository-cli-adapter.js";
+import type { TerminalDispatchRecoveryCliFacade } from "./terminal-dispatch-recovery-cli-adapter.js";
+import type { TerminalAcceptanceCliFacade } from "./terminal-acceptance-cli-adapter.js";
+import type { TerminalHandoffCliFacade } from "./terminal-handoff-cli-adapter.js";
+import type { createTerminalIdentityAuthorityCliAdapter } from "./terminal-identity-authority-cli-adapter.js";
+import type { CallbackCliFacade } from "./callback-cli-adapter.js";
+type MonitorCliOptions = Record<string, unknown>;
+type IdentityAuthority = ReturnType<typeof createTerminalIdentityAuthorityCliAdapter>;
+export interface TerminalMonitorStateCliDependencies {
+    dispatch: {
+        repository: TerminalDispatchRepositoryCliAdapter;
+        recovery: TerminalDispatchRecoveryCliFacade;
+    };
+    acceptance: Pick<TerminalAcceptanceCliFacade, "markUncertain" | "reconcileMonitor" | "recoverVirgin" | "storeDirForConversation">;
+    authority: {
+        identity: Pick<IdentityAuthority, "migrateLegacyTerminalAgentIdentity" | "terminalRuntimeIdentityForConversation" | "terminalDurableRequestForConversation">;
+        handoff: Pick<TerminalHandoffCliFacade, "recoverDeferredCodexForegroundTransferBeforeMutation">;
+        assertBindingCurrent(conversation: Conversation, operation: string): void;
+        terminalControlForConversation(conversation: Conversation): TerminalControlRef | undefined;
+        createBridge(options: MonitorCliOptions): TerminalAgentBridge;
+    };
+    callbacks: Pick<CallbackCliFacade, "reconcileDelivery" | "prepareApprovalNotification" | "runPrepared" | "emitPreparedResult" | "deliverGatewayMethod" | "deliverChatSend">;
+    runtime: {
+        isProcessAlive(pid: number): boolean;
+        storeDir(options: MonitorCliOptions): string;
+        print(value: Record<string, unknown>): void;
+        bindingSuperseded(error: unknown): {
+            code: string;
+            message: string;
+        } | undefined;
+        approvalTtlMs: number;
+        callbackRetryLimit: number;
+    };
+}
+export interface TerminalMonitorStateCliAdapter {
+    runService(input: {
+        options: MonitorCliOptions;
+        statePath: string;
+        logPath: string;
+        initialConversation: Conversation;
+        expectedTerminalMessageId: string;
+        lifecycle: {
+            startedRecorded: boolean;
+        };
+        configuration(): {
+            pollIntervalMs: number;
+            timeoutMinutes: number;
+            hardTimeoutMinutes: number;
+        };
+        terminalBridge(): TerminalAgentBridge;
+    }): Promise<void>;
+    deferralPorts(paths: TerminalMonitorStatePaths): TerminalMonitorDeferralPorts;
+    reconcileCollateral(storeDir: string, conversationId?: string): Promise<TerminalBridgeCollateralStallReconciliation>;
+    stallOther(input: {
+        storeDir: string;
+        terminalControl: TerminalControlRef;
+        currentConversationId: string;
+        uncertainMessageId: string;
+    }): string[];
+    statePaths(listed: Conversation, storeDir: string): TerminalMonitorStatePaths;
+    reconcileState(input: {
+        options: MonitorCliOptions;
+        storeDir: string;
+        listed: Conversation;
+        paths: TerminalMonitorStatePaths;
+        includeCallbackRecovery: boolean;
+    }): Promise<TerminalMonitorStateReconciliation>;
+    eligibility(conversation: Conversation): TerminalMonitorEligibility;
+    prepareLaunch(input: {
+        statePath: string;
+        expectedMessageId: string;
+        requireWaitingForAgentStatus?: boolean;
+        activeOwner(statePath: string, terminalMessageId: string): {
+            ownerPid?: number;
+        } | undefined;
+        monitorLockVersion: number;
+    }): TerminalMonitorLaunchPreparation;
+}
+export type TerminalMonitorLaunchPreparation = {
+    prepared: false;
+    alreadyRunning: boolean;
+    reason: string;
+    ownerPid?: number;
+} | {
+    prepared: true;
+    conversation: Conversation;
+    terminalControl: TerminalControlRef;
+    inactivityTimeoutMinutes: number;
+    hardTimeoutMinutes: number;
+};
+interface TerminalBridgeCollateralStallReconciliation {
+    checked: number;
+    repaired: number;
+    skipped: number;
+    errors: string[];
+    items: Record<string, unknown>[];
+}
+/** Invocation-local monitor state and reconciliation CLI boundary. */
+export declare function createTerminalMonitorStateCliAdapter(dependencies: TerminalMonitorStateCliDependencies): TerminalMonitorStateCliAdapter;
+export {};