@scotthuang/agent-knock-knock 0.13.3 → 0.13.4

package/dist/src/terminal-command-dispatch-preparation.js

@@ -0,0 +1,209 @@
+import path from "node:path";
+import { captureClaudeTranscriptAnchor, defaultClaudeHome } from "./claude-local-transcript-provider.js";
+import { isExactClaudeNativeInspectionIdleComposer } from "./terminal-agent-bridge.js";
+import { assertTerminalNativeBindingBeforeSend, assertTerminalPreSendStatus, terminalPreSendRuntime, terminalSendCandidateAcceptanceAnchor } from "./terminal-command-send-preflight.js";
+import { bindTerminalDispatchRoute } from "./terminal-dispatch-capability.js";
+import { terminalSubmissionPayload } from "./terminal-dispatch-execution.js";
+import { sameCanonicalStatePath, terminalDispatchLedgerLooksLifecycle } from "./terminal-dispatch-ledger-codec.js";
+import { presentTerminalDispatchReplay } from "./terminal-dispatch-presenter.js";
+import { terminalMonitorScreenFingerprint } from "./terminal-monitor-decision-policy.js";
+import { expandHome } from "./cli-command-runtime.js";
+import { isRecord, nonBlankString } from "./value-guards.js";
+/**
+ * Prepare one ordinary dispatch from a single locked route and live terminal
+ * observation. This phase never performs task text or Enter input.
+ */
+export async function prepareTerminalControlSend(request, ports, defaults) {
+    const { transaction, options, conversation, executor, message, recordRawAttachmentAfterSend = false, allowedPreMaterializationIdentity, allowedAdditionalIdentities = [], deferredCodexForegroundBinding, continuingTurnResponse = false } = request;
+    const bridge = ports.terminalBridgeEnabled(conversation);
+    const route = bindTerminalDispatchRoute(transaction.scopes, transaction.resources);
+    const { terminalControl, storeDir: lockedStoreDir, statePath, logPath } = route;
+    const terminalBridge = ports.createTerminalBridge(options);
+    const execution = ports.execution(options, terminalBridge);
+    const bridgeStartedAt = ports.now().toISOString();
+    const submissionPreparedAt = deferredCodexForegroundBinding?.preparedAt ??
+        bridgeStartedAt;
+    const agentTimeoutMinutes = Number(options.agentTimeoutMinutes ?? defaults.agentTimeoutMinutes);
+    const agentHardTimeoutMinutes = ports.positiveMinutes(options.agentHardTimeoutMinutes ?? defaults.agentHardTimeoutMinutes, "--agent-hard-timeout-minutes");
+    const terminalPayload = terminalSubmissionPayload(String(message.body ?? ""));
+    const terminalRequestHash = ports.required(ports.requestFingerprint(terminalPayload), "terminal request hash is unavailable");
+    const presentationContext = { message, executor, terminalControl };
+    const presentationPorts = ports.presentation;
+    let previousDispatchLedger = ports.resolveLedgerPaneIncarnation(terminalControl, ports.loadDispatchLedger(terminalControl));
+    previousDispatchLedger = ports.reconcilePreparedLedger(terminalControl, previousDispatchLedger);
+    const previousDispatchLifecycle = terminalDispatchLedgerLooksLifecycle(previousDispatchLedger);
+    const previousDispatchOwner = execution.preflightRequiresOwner(previousDispatchLedger, previousDispatchLifecycle)
+        ? ports.loadDispatchOwner(previousDispatchLedger)
+        : undefined;
+    const dispatchPreflight = execution.evaluatePreflight({
+        ledger: previousDispatchLedger,
+        owner: previousDispatchOwner,
+        conversation,
+        requestHash: terminalRequestHash,
+        requestText: terminalPayload,
+        messageId: message.id,
+        terminalTarget: terminalControl.target,
+        ledgerLifecycle: previousDispatchLifecycle,
+        statePathMatches: Boolean(previousDispatchOwner &&
+            sameCanonicalStatePath(previousDispatchLedger.state_path, statePath)),
+        continuingTurnResponse
+    });
+    if (dispatchPreflight.action === "replay") {
+        presentTerminalDispatchReplay(dispatchPreflight, presentationContext, presentationPorts);
+        return undefined;
+    }
+    if (bridge) {
+        ports.assertNoUnresolvedTerminalBridgeSubmission(lockedStoreDir, terminalControl, conversation.conversation_id, terminalPayload);
+    }
+    const sendTakeover = isRecord(conversation.native_session_takeover)
+        ? conversation.native_session_takeover
+        : undefined;
+    const terminalAgentPid = Number(sendTakeover?.terminal_agent_pid);
+    const expectedManagedNativeThreadId = nonBlankString(sendTakeover?.terminal_agent_expected_session_id) ?? nonBlankString(sendTakeover?.terminal_agent_session_id);
+    const candidateSetAnchor = terminalSendCandidateAcceptanceAnchor(request);
+    const currentNativeIdentity = candidateSetAnchor
+        ? undefined
+        : await execution.resolveCurrentNativeIdentity({
+            agent: executor.kind,
+            pid: terminalAgentPid,
+            cwd: terminalControl.currentPath,
+            preferredSessionId: allowedPreMaterializationIdentity
+                ? expectedManagedNativeThreadId
+                : undefined,
+            allowedCompanionIdentity: allowedPreMaterializationIdentity,
+            allowedAdditionalIdentities
+        });
+    const virginRawAttach = Boolean(recordRawAttachmentAfterSend &&
+        !nonBlankString(sendTakeover?.terminal_agent_session_id));
+    const pendingManagedNativeBinding = Boolean(!nonBlankString(sendTakeover?.terminal_agent_session_id) &&
+        nonBlankString(sendTakeover?.terminal_agent_expected_session_id));
+    const needsPostSendNativeBinding = virginRawAttach || pendingManagedNativeBinding;
+    assertTerminalNativeBindingBeforeSend({
+        execution,
+        conversation,
+        currentNativeIdentity,
+        needsPostSendNativeBinding,
+        allowedPreMaterializationIdentity
+    });
+    const preSendRuntime = terminalPreSendRuntime({
+        request,
+        terminalControl,
+        terminalAgentPid
+    }, {
+        terminalRuntimeForLiveIdentity: ports.terminalRuntimeForLiveIdentity,
+        terminalRuntimeIdentityForConversation: ports.terminalRuntimeIdentityForConversation
+    });
+    let preSendScreenFingerprint;
+    let codexRolloutAcceptanceAnchor;
+    let claudeTranscriptAnchor;
+    const claudeHome = executor.kind === "claude"
+        ? path.resolve(expandHome(options.claudeHome) ?? defaultClaudeHome())
+        : undefined;
+    try {
+        const status = await terminalBridge.status(executor.kind, terminalControl, {
+            scrollbackLines: options.identifyForeground === true
+                ? ports.foregroundProofs.current(options)
+                    ?.observationScrollbackLines ?? defaults.foregroundScrollbackLines
+                : Number(options.scrollbackLines ?? defaults.ordinaryScrollbackLines),
+            runtime: preSendRuntime
+        });
+        ports.foregroundProofs.assertCurrent({
+            options,
+            executor,
+            terminalControl,
+            terminalAgentPid,
+            status
+        });
+        assertTerminalPreSendStatus({ request, status }, {
+            assertSafeTerminalSend: ports.assertSafeTerminalSend
+        });
+        const userExplicitManagedCodexAttempt = Boolean(nonBlankString(options.expectedUserExplicitTerminalToken));
+        if (executor.kind === "claude" &&
+            userExplicitManagedCodexAttempt &&
+            !isExactClaudeNativeInspectionIdleComposer(status.screen.excerpt ?? "")) {
+            throw new Error("Claude composer is not exactly empty for managed user Send");
+        }
+        if (executor.kind === "codex" &&
+            (needsPostSendNativeBinding || userExplicitManagedCodexAttempt)) {
+            if (needsPostSendNativeBinding &&
+                (pendingManagedNativeBinding || allowedPreMaterializationIdentity)) {
+                const expectedForegroundId = nonBlankString(sendTakeover?.terminal_agent_expected_session_id);
+                const foreground = ports.createRegistry(options)
+                    .require("codex")
+                    .observeThreadLifecycle?.({
+                    operation: { kind: "new_thread" },
+                    phase: "before",
+                    screen: status.screen.excerpt ?? ""
+                });
+                if (!expectedForegroundId ||
+                    foreground?.status !== "observed" ||
+                    foreground.nativeThreadId !== expectedForegroundId) {
+                    throw new Error("Codex foreground thread changed after the managed /status proof; " +
+                        "refresh list before sending");
+                }
+            }
+            await ports.assertCodexComposerReadyForAutomatedInput({
+                options,
+                terminalControl
+            });
+        }
+        if (bridge) {
+            preSendScreenFingerprint = nonBlankString(status.screen.digest) ??
+                terminalMonitorScreenFingerprint(status.screen.excerpt);
+            if (executor.kind === "codex") {
+                codexRolloutAcceptanceAnchor = execution.captureCodexAcceptanceAnchor({
+                    currentIdentity: currentNativeIdentity,
+                    expectedNativeThreadId: expectedManagedNativeThreadId,
+                    boundProcessUuid: nonBlankString(sendTakeover?.terminal_agent_process_uuid),
+                    boundProcessBirth: nonBlankString(sendTakeover?.terminal_agent_process_birth),
+                    allowedPreMaterializationIdentity,
+                    needsPostSendNativeBinding,
+                    candidateSetAnchor
+                });
+            }
+            else {
+                claudeTranscriptAnchor = captureClaudeTranscriptAnchor({
+                    sessionId: preSendRuntime.sessionId,
+                    cwd: preSendRuntime.cwd,
+                    pid: preSendRuntime.pid,
+                    claudeHome,
+                    agentRows: ports.loadClaudeAgentRows(options)
+                });
+                if (!claudeTranscriptAnchor) {
+                    throw new Error("the completion monitor could not bind an owner-private Claude transcript boundary");
+                }
+            }
+        }
+    }
+    catch (error) {
+        throw new Error(`refusing to send to ${executor.display_name} without a verified idle terminal: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return {
+        route,
+        bridge,
+        terminalControl,
+        lockedStoreDir,
+        statePath,
+        logPath,
+        terminalBridge,
+        execution,
+        bridgeStartedAt,
+        submissionPreparedAt,
+        agentTimeoutMinutes,
+        agentHardTimeoutMinutes,
+        terminalPayload,
+        terminalRequestHash,
+        presentationContext,
+        presentationPorts,
+        previousDispatchLedger,
+        sendTakeover,
+        terminalAgentPid,
+        needsPostSendNativeBinding,
+        preSendRuntime,
+        preSendScreenFingerprint,
+        codexRolloutAcceptanceAnchor,
+        claudeTranscriptAnchor,
+        claudeHome
+    };
+}
+//# sourceMappingURL=terminal-command-dispatch-preparation.js.map

package/dist/src/terminal-command-dispatch-preparation.js.map

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

package/dist/src/terminal-command-dispatch-transport.d.ts

@@ -0,0 +1,35 @@
+import { type EventRecord } from "./store.js";
+import type { CodexForegroundProofAuthority } from "./terminal-command-foreground-proof.js";
+import type { TerminalCommandPortView } from "./terminal-command-cli-ports.js";
+import { prepareTerminalControlSend, type TerminalDispatchPreparationDefaults, type TerminalDispatchPreparationPorts } from "./terminal-command-dispatch-preparation.js";
+import type { TerminalControlSendRequest } from "./terminal-dispatch-composition.js";
+export type TerminalDispatchTransportCliPorts = TerminalCommandPortView<"assertDeferredCodexForegroundBindingBoundary" | "assertNativeThreadHasExclusiveOwnership" | "assertObservedHandoffTransportBoundary" | "assertVerifiedEmptyCodexTransportBoundary" | "deferredForegroundApplication" | "deferredForegroundRecoveryAdapterPorts" | "managedSessionStoreDirForConversation" | "persistManagedSessionNativeIdentity" | "prepareManagedSessionNativeIdentityClaim" | "quarantineManagedSessionBinding" | "required" | "stallOtherTerminalBridgeConversationsForUncertainDispatch" | "startTerminalBridgeMonitorForConversation" | "terminalBindingLedgerFields" | "terminalBridgeRuntimeKey" | "terminalControlFromTakeover" | "terminalDispatchCapabilityRepositories" | "terminalRuntimeIdentityForConversation" | "withTerminalBridgeSubmission">;
+export interface TerminalDispatchTransportRuntime {
+    appendEvent(logPath: string, event: EventRecord): void;
+    env(): NodeJS.ProcessEnv;
+    exit(code: number): never;
+    now(): Date;
+    pid(): number;
+    log(level: "info" | "warn" | "error", event: string, fields: Record<string, unknown>): void;
+}
+export interface TerminalDispatchTransportDependencies {
+    ports: TerminalDispatchTransportCliPorts;
+    prepare: typeof prepareTerminalControlSend;
+    preparationPorts: TerminalDispatchPreparationPorts;
+    defaults: TerminalDispatchPreparationDefaults & {
+        acceptanceTimeoutMs: number;
+        acceptancePollIntervalMs: number;
+    };
+    foregroundProofs: CodexForegroundProofAuthority;
+    runtime: TerminalDispatchTransportRuntime;
+}
+export type TerminalControlSendResult = {
+    outcome: "replayed";
+} | {
+    outcome: "zero_input";
+    failure: unknown;
+} | {
+    outcome: "input_started";
+    enterDispatched: boolean;
+};
+export declare function runTerminalControlSend(request: TerminalControlSendRequest, dependencies: TerminalDispatchTransportDependencies): Promise<TerminalControlSendResult>;