@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

package/dist/src/terminal-dispatch-receipt.js

@@ -0,0 +1,314 @@
+import { createHash } from "node:crypto";
+import { canonicalJson } from "./canonical-json.js";
+import { executorForConversation, sessionIdForConversation, turnIdForConversation } from "./protocol.js";
+import { hasCanonicalTerminalEndpoint, terminalControlEvidence } from "./terminal-control-ref.js";
+import { terminalBridgeSubmission, validateTerminalSubmissionAcceptanceEvidence } from "./terminal-submission-facts.js";
+import { isRecord, nonBlankString } from "./value-guards.js";
+export function withTerminalBridgeState({ conversation, message, requestText, startedAt, agentTimeoutMinutes, agentHardTimeoutMinutes, monitorLockVersion, preSendScreenFingerprint, codexRolloutAcceptanceAnchor, claudeTranscriptAnchor, claudeHome }) {
+    const takeover = isRecord(conversation.native_session_takeover)
+        ? conversation.native_session_takeover
+        : {};
+    return {
+        ...conversation,
+        native_session_takeover: {
+            ...takeover,
+            terminal_bridge: true,
+            terminal_bridge_started_at: startedAt,
+            terminal_bridge_message_id: message.id,
+            terminal_bridge_request_text: requestText,
+            terminal_bridge_request_hash: terminalBridgeRequestFingerprint(requestText),
+            terminal_bridge_pre_send_screen_fingerprint: preSendScreenFingerprint,
+            codex_rollout_acceptance_anchor: codexRolloutAcceptanceAnchor,
+            claude_transcript_anchor: claudeTranscriptAnchor,
+            claude_home: claudeHome,
+            terminal_bridge_completion_claim: undefined,
+            terminal_bridge_approval_dispatch: undefined,
+            terminal_bridge_detector_diagnostic: undefined,
+            terminal_bridge_monitor_lock_version: monitorLockVersion,
+            terminal_bridge_monitor_started_at: startedAt,
+            terminal_bridge_last_activity_at: startedAt,
+            terminal_bridge_inactivity_timeout_minutes: agentTimeoutMinutes,
+            terminal_bridge_hard_timeout_minutes: agentHardTimeoutMinutes,
+            terminal_bridge_inactivity_deadline_at: deadlineAt(startedAt, agentTimeoutMinutes),
+            terminal_bridge_hard_deadline_at: deadlineAt(startedAt, agentHardTimeoutMinutes)
+        },
+        updated_at: startedAt
+    };
+}
+export function applyTerminalBridgeSubmission(mutation, context) {
+    const { conversation, messageId, messageType, messageBody, requestText, status, preparedAt, textInjectedAt, enterDispatchedAt, agentAcceptedAt, notAcceptedAt, submittedAt, uncertainAt, abortedAt, error, acceptanceEvidence, lastProvenStage, safeToRetry } = mutation;
+    const takeover = isRecord(conversation.native_session_takeover)
+        ? conversation.native_session_takeover
+        : {};
+    const previousSubmission = isRecord(takeover.terminal_bridge_submission)
+        ? takeover.terminal_bridge_submission
+        : undefined;
+    const storedReceipts = storedTerminalBridgeSubmissionReceipts(takeover);
+    const storedReceiptIds = new Set(storedReceipts.map((receipt) => String(receipt.message_id)));
+    const previousSubmissionId = nonBlankString(previousSubmission?.message_id);
+    const previousReceipts = previousSubmissionId &&
+        !storedReceiptIds.has(previousSubmissionId)
+        ? [...storedReceipts, previousSubmission]
+        : storedReceipts;
+    const matchingReceipts = previousReceipts.filter((receipt) => nonBlankString(receipt.message_id) === messageId);
+    if (matchingReceipts.length > 1) {
+        throw new Error(`terminal submission receipt ${messageId} is duplicated`);
+    }
+    const previousReceipt = matchingReceipts[0];
+    const previousGenerationSubmission = previousSubmissionId === messageId
+        ? previousSubmission
+        : undefined;
+    if (previousReceipt &&
+        previousGenerationSubmission &&
+        canonicalJson(previousReceipt) !== canonicalJson(previousGenerationSubmission)) {
+        throw new Error(`terminal submission receipt ${messageId} conflicts with its current generation`);
+    }
+    const durableMessageType = messageType ?? storedMessageType(previousReceipt) ??
+        storedMessageType(previousGenerationSubmission);
+    const messageBodyHash = messageBody !== undefined
+        ? createHash("sha256").update(messageBody).digest("hex")
+        : nonBlankString(previousReceipt?.message_body_hash) ??
+            nonBlankString(previousGenerationSubmission?.message_body_hash);
+    const previousDispatcherPid = Number(previousGenerationSubmission?.dispatcher_pid);
+    const dispatcherPid = status === "prepared" ||
+        !Number.isSafeInteger(previousDispatcherPid) ||
+        previousDispatcherPid <= 1
+        ? context.dispatcherPid
+        : previousDispatcherPid;
+    const provenStage = lastProvenStage ?? terminalSubmissionLastProvenStage(status, nonBlankString(previousGenerationSubmission?.last_proven_stage));
+    const validatedAcceptanceEvidence = status === "agent_accepted"
+        ? terminalAcceptanceEvidenceForConversation(conversation, requestText, acceptanceEvidence)
+        : undefined;
+    const requestHash = terminalBridgeRequestFingerprint(requestText);
+    const control = context.terminalControl;
+    const candidateImmutableReceiptFields = {
+        session_id: sessionIdForConversation(conversation),
+        turn_id: turnIdForConversation(conversation),
+        message_id: messageId,
+        binding_id: nonBlankString(conversation.terminal_binding_id),
+        binding_generation: Number.isSafeInteger(Number(conversation.terminal_binding_generation))
+            ? Number(conversation.terminal_binding_generation)
+            : undefined,
+        ...(durableMessageType ? { message_type: durableMessageType } : {}),
+        ...(messageBodyHash ? { message_body_hash: messageBodyHash } : {}),
+        request_hash: requestHash,
+        executor_kind: executorForConversation(conversation).kind,
+        openclaw_session: conversation.openclaw_session,
+        store_dir: context.storeDir,
+        native_thread_id: nonBlankString(conversation.native_thread_id) ??
+            nonBlankString(takeover.terminal_agent_session_id) ??
+            nonBlankString(takeover.terminal_agent_expected_session_id),
+        terminal_target: control?.target,
+        terminal_socket_path: control?.socketPath ?? null,
+        terminal_pane_pid: control?.panePid,
+        terminal_endpoint: control && hasCanonicalTerminalEndpoint(control)
+            ? terminalControlEvidence(control)
+            : previousReceipt?.terminal_endpoint
+    };
+    const immutableReceiptFields = Object.fromEntries(Object.entries(candidateImmutableReceiptFields).map(([key, value]) => [
+        key,
+        value === undefined && previousReceipt?.[key] !== undefined
+            ? previousReceipt[key]
+            : value
+    ]));
+    assertImmutableReceiptFields(messageId, previousReceipt, candidateImmutableReceiptFields);
+    const nextSubmission = {
+        status,
+        ...immutableReceiptFields,
+        prepared_at: preparedAt,
+        dispatcher_pid: dispatcherPid,
+        last_proven_stage: provenStage,
+        ...(textInjectedAt ? { text_injected_at: textInjectedAt } : {}),
+        ...(enterDispatchedAt ? { enter_dispatched_at: enterDispatchedAt } : {}),
+        ...(agentAcceptedAt ? { agent_accepted_at: agentAcceptedAt } : {}),
+        ...(notAcceptedAt ? { not_accepted_at: notAcceptedAt } : {}),
+        ...(submittedAt ? { submitted_at: submittedAt } : {}),
+        ...(uncertainAt ? { uncertain_at: uncertainAt } : {}),
+        ...(abortedAt ? { aborted_at: abortedAt } : {}),
+        ...(error ? { error: terminalDispatchTextSummary(error) } : {}),
+        ...(safeToRetry !== undefined ? { safe_to_retry: safeToRetry } : {}),
+        ...(validatedAcceptanceEvidence
+            ? { acceptance_evidence: validatedAcceptanceEvidence }
+            : {})
+    };
+    const nextReceipts = previousReceipt
+        ? previousReceipts.map((receipt) => nonBlankString(receipt.message_id) === messageId
+            ? nextSubmission
+            : receipt)
+        : [...previousReceipts, nextSubmission];
+    return {
+        ...conversation,
+        native_session_takeover: {
+            ...takeover,
+            terminal_bridge_submission: nextSubmission,
+            terminal_bridge_submission_receipts: nextReceipts
+        },
+        updated_at: agentAcceptedAt ?? notAcceptedAt ?? uncertainAt ?? abortedAt ??
+            enterDispatchedAt ?? textInjectedAt ?? submittedAt ?? preparedAt
+    };
+}
+export function terminalAcceptanceEvidenceForConversation(conversation, requestText, evidence) {
+    return validateTerminalSubmissionAcceptanceEvidence(evidence, terminalAcceptanceEvidenceExpectation(conversation, requestText));
+}
+export function terminalAcceptanceEvidenceExpectation(conversation, requestText) {
+    const takeover = isRecord(conversation.native_session_takeover)
+        ? conversation.native_session_takeover
+        : undefined;
+    const nativeThreadId = nonBlankString(conversation.native_thread_id) ??
+        nonBlankString(takeover?.terminal_agent_session_id) ??
+        nonBlankString(takeover?.terminal_agent_expected_session_id);
+    if (!nativeThreadId) {
+        throw new Error("native acceptance evidence cannot be bound without an exact native thread");
+    }
+    const requestHash = terminalBridgeRequestFingerprint(requestText);
+    if (!requestHash) {
+        throw new Error("native acceptance evidence has no exact request hash");
+    }
+    return {
+        source: executorForConversation(conversation).kind === "codex"
+            ? "codex_rollout"
+            : "claude_transcript",
+        nativeThreadId,
+        requestHash
+    };
+}
+export function terminalSubmissionReplayReceipt(options) {
+    if (options.proofLevel !== "agent_accepted") {
+        return {
+            replayed: true,
+            delivered: false,
+            status: "submission_pending_acceptance",
+            submission_outcome: "pending_acceptance",
+            delivery_receipt: options.proofLevel,
+            do_not_retry: true
+        };
+    }
+    try {
+        validateTerminalSubmissionAcceptanceEvidence(options.evidence, options.expected);
+        return {
+            replayed: true,
+            delivered: true,
+            status: "async_pending",
+            submission_outcome: "agent_accepted",
+            delivery_receipt: "agent_accepted"
+        };
+    }
+    catch (error) {
+        return {
+            replayed: true,
+            delivered: false,
+            status: "submission_uncertain",
+            submission_outcome: "uncertain",
+            delivery_receipt: "enter_dispatched",
+            do_not_retry: true,
+            evidence_error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+function storedTerminalBridgeSubmissionReceipts(takeover) {
+    const value = takeover?.terminal_bridge_submission_receipts;
+    if (value !== undefined && !Array.isArray(value)) {
+        throw new Error("terminal submission receipt history is malformed");
+    }
+    const receipts = (Array.isArray(value) ? value : []).map((receipt) => {
+        if (!isRecord(receipt) || !nonBlankString(receipt.message_id)) {
+            throw new Error("terminal submission receipt history is malformed");
+        }
+        return receipt;
+    });
+    const ids = new Set();
+    for (const receipt of receipts) {
+        const id = String(receipt.message_id);
+        if (ids.has(id)) {
+            throw new Error(`terminal submission receipt ${id} is duplicated`);
+        }
+        ids.add(id);
+    }
+    return receipts;
+}
+function storedMessageType(receipt) {
+    const value = nonBlankString(receipt?.message_type);
+    return value === "task" || value === "answer" ? value : undefined;
+}
+function assertImmutableReceiptFields(messageId, previousReceipt, candidate) {
+    if (!previousReceipt) {
+        return;
+    }
+    for (const [key, value] of Object.entries(candidate)) {
+        if (previousReceipt[key] !== undefined &&
+            value !== undefined &&
+            canonicalJson(previousReceipt[key]) !== canonicalJson(value)) {
+            throw new Error(`terminal submission receipt ${messageId} changed immutable ${key}`);
+        }
+    }
+}
+function terminalSubmissionLastProvenStage(status, previous) {
+    if (status === "agent_accepted") {
+        return "agent_accepted";
+    }
+    if (["enter_dispatched", "submitted", "not_accepted"].includes(status)) {
+        return "enter_dispatched";
+    }
+    if (status === "uncertain" &&
+        ["prepared", "text_injected", "enter_dispatched", "agent_accepted"]
+            .includes(previous ?? "")) {
+        return previous;
+    }
+    return status === "text_injected" ? "text_injected" : "prepared";
+}
+export function terminalBridgeRequestFingerprint(value) {
+    const text = String(value ?? "");
+    return text
+        ? createHash("sha256").update(text).digest("hex")
+        : undefined;
+}
+export function terminalDispatchTextSummary(text, maxLength = 240) {
+    const value = String(text ?? "");
+    return {
+        length: value.length,
+        preview: value ? value.slice(0, maxLength) : undefined
+    };
+}
+function deadlineAt(startedAt, timeoutMinutes) {
+    const startedAtMs = Date.parse(String(startedAt ?? ""));
+    return Number.isFinite(startedAtMs) &&
+        Number.isFinite(timeoutMinutes) &&
+        timeoutMinutes > 0
+        ? new Date(startedAtMs + timeoutMinutes * 60 * 1000).toISOString()
+        : undefined;
+}
+export function terminalBridgeEnabled(conversation) {
+    const record = isRecord(conversation) ? conversation : undefined;
+    const takeover = isRecord(record?.native_session_takeover)
+        ? record.native_session_takeover
+        : undefined;
+    return takeover?.terminal_bridge === true;
+}
+export { terminalBridgeSubmission };
+export function terminalBridgeSubmissionReceipts(conversation) {
+    const takeover = isRecord(conversation.native_session_takeover)
+        ? conversation.native_session_takeover
+        : undefined;
+    const receipts = storedTerminalBridgeSubmissionReceipts(takeover);
+    const ids = new Set(receipts.map((receipt) => String(receipt.message_id)));
+    const current = terminalBridgeSubmission(conversation);
+    const currentId = nonBlankString(current?.message_id);
+    if (current && currentId && ids.has(currentId)) {
+        const historical = receipts.find((receipt) => nonBlankString(receipt.message_id) === currentId);
+        if (!historical || canonicalJson(historical) !== canonicalJson(current)) {
+            throw new Error(`terminal submission receipt ${currentId} conflicts with its current generation`);
+        }
+    }
+    return current && currentId && !ids.has(currentId)
+        ? [...receipts, current]
+        : receipts;
+}
+export function unresolvedTerminalBridgeSubmission(conversation) {
+    const submission = terminalBridgeSubmission(conversation);
+    return submission &&
+        ["prepared", "text_injected", "enter_dispatched", "not_accepted", "uncertain"]
+            .includes(String(submission.status))
+        ? submission
+        : undefined;
+}
+//# sourceMappingURL=terminal-dispatch-receipt.js.map

package/dist/src/terminal-dispatch-receipt.js.map

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

package/dist/src/terminal-dispatch-recovery-cli-adapter.d.ts

@@ -0,0 +1,132 @@
+import { type PreparedCallback } from "./callback-outbox-service.js";
+import { executorForConversation, type Conversation } from "./protocol.js";
+import type { TerminalCompletionEvidence, TerminalControlRef } from "./terminal-agent-adapter.js";
+import { type TerminalDispatchLedgerDocument } from "./terminal-dispatch-ledger-codec.js";
+import type { TerminalDispatchRepositoryCliAdapter } from "./terminal-dispatch-repository-cli-adapter.js";
+import { type LocalCompletionRecoveryResult, type TerminalCompletionPreparation, type VerifiedDeadRecoveryResult } from "./terminal-dispatch-recovery-service.js";
+import { type TranscriptEvent } from "./transcript.js";
+import { type BoundTerminalAgentProcessObservation, type VerifiedDeadAgentAuthorityDecision, type VerifiedDeadAgentCompletionObservation, type VerifiedDeadTerminalAgentProcessProof } from "./verified-dead-agent-policy.js";
+export interface TerminalDispatchRecoveryCliDependencies {
+    repository: TerminalDispatchRepositoryCliAdapter;
+    authority: {
+        terminalControl(value: unknown): TerminalControlRef | undefined;
+        assertNoDeferredTransfer(input: {
+            storeDir: string;
+            conversation: Conversation;
+            action: "approve" | "cancel";
+        }): void;
+        assertTurnBindingCurrent(conversation: Conversation, operation: string): void;
+        storeDirForConversation(conversation: Conversation): string | undefined;
+    };
+    observation: {
+        process(input: {
+            options: Record<string, any>;
+            conversation: Conversation;
+            terminalControl: TerminalControlRef;
+        }): Promise<BoundTerminalAgentProcessObservation>;
+        completion(input: {
+            options: Record<string, any>;
+            conversation: Conversation;
+            terminalControl: TerminalControlRef;
+        }): Promise<VerifiedDeadAgentCompletionObservation<TerminalCompletionEvidence>>;
+    };
+    completion: {
+        prepare(input: {
+            options: Record<string, any>;
+            statePath: string;
+            logPath: string;
+            conversation: Conversation;
+            executor: ReturnType<typeof executorForConversation>;
+            terminalControl: TerminalControlRef;
+            terminalMessageId: string;
+            completion: TerminalCompletionEvidence;
+            allowSupersedeRecovery?: boolean;
+            completionFingerprint?: string;
+        }): TerminalCompletionPreparation<PreparedCallback>;
+    };
+    runtime: {
+        isProcessAlive(pid: number): boolean;
+    };
+}
+export interface TerminalDispatchRecoveryCliFacade {
+    loadOwner(ledger: TerminalDispatchLedgerDocument): Conversation | undefined;
+    assertManagedOwner(input: {
+        storeDir: string;
+        conversation: Conversation;
+        terminalControl: TerminalControlRef;
+        action: "approve" | "cancel";
+    }): void;
+    assertNativeThreadStoreAuthority(input: {
+        terminalControl: TerminalControlRef;
+        nativeThreadId: string;
+        storeDir: string;
+    }): void;
+    orphanedForRecovery(terminalControl: TerminalControlRef): TerminalDispatchLedgerDocument | undefined;
+    bindingFields(conversation: Conversation): TerminalDispatchLedgerDocument;
+    reconcilePrepared(terminalControl: TerminalControlRef, ledger?: TerminalDispatchLedgerDocument): TerminalDispatchLedgerDocument | undefined;
+    isVerifiedDead(conversation: Conversation | Record<string, any>): boolean;
+    exactVerifiedDeadAuthority(input: {
+        conversation: Conversation;
+        storeDir: string;
+        terminalControl: TerminalControlRef;
+        logPath: string;
+    }): VerifiedDeadAgentAuthorityDecision;
+    ensureVerifiedDeadEvent(input: {
+        logPath: string;
+        proof: VerifiedDeadTerminalAgentProcessProof;
+        action: "managed_close" | "monitor_reconciliation";
+    }): {
+        proof: VerifiedDeadTerminalAgentProcessProof;
+        evidenceId: string;
+        recordedAt: string;
+    };
+    ensureVerifiedDeadClosedEvent(input: {
+        logPath: string;
+        conversation: Conversation;
+        evidenceId: string;
+    }): void;
+    assertVerifiedDeadDispatch(input: VerifiedDeadDispatchRequest): {
+        ledger: TerminalDispatchLedgerDocument;
+        resolved: boolean;
+    };
+    resolveVerifiedDeadDispatch(input: VerifiedDeadDispatchRequest & {
+        reason: string;
+    }): boolean;
+    stallAccepted(input: {
+        options: Record<string, any>;
+        storeDir: string;
+        statePath: string;
+        logPath: string;
+        expectedConversationId: string;
+        expectedMessageId?: string;
+    }): Promise<VerifiedDeadRecoveryResult<PreparedCallback>>;
+    settleLocalCompletion(input: {
+        storeDir: string;
+        statePath: string;
+        logPath: string;
+    }): LocalCompletionRecoveryResult;
+    prepareCompletion(input: {
+        options: Record<string, any>;
+        statePath: string;
+        logPath: string;
+        conversation: Conversation;
+        executor: ReturnType<typeof executorForConversation>;
+        terminalControl: TerminalControlRef;
+        terminalMessageId: string;
+        completion: TerminalCompletionEvidence;
+        allowSupersedeRecovery?: boolean;
+        completionFingerprint?: string;
+    }): TerminalCompletionPreparation<PreparedCallback>;
+    readEvents(logPath: string): TranscriptEvent[];
+}
+interface VerifiedDeadDispatchRequest {
+    terminalControl: TerminalControlRef;
+    conversation: Conversation;
+    storeDir: string;
+    statePath: string;
+    logPath: string;
+    expectedMessageId: string;
+}
+/** Bind typed recovery decisions to the existing CLI transaction boundary. */
+export declare function createTerminalDispatchRecoveryCliAdapter(dependencies: TerminalDispatchRecoveryCliDependencies): TerminalDispatchRecoveryCliFacade;
+export {};