@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

package/dist/src/terminal-delegate-cli-adapter.js

@@ -0,0 +1,242 @@
+// CLI composition for delegate discovery and exact idempotent replay routing.
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { executorDefinitionForKind, resolveExecutor } from "./executors.js";
+import { executorForConversation } from "./protocol.js";
+import { isCompleteNativeRollout, terminalControlsShareIncarnation } from "./terminal-authority-policy.js";
+import { terminalBridgeRequestFingerprint, terminalBridgeSubmissionReceipts } from "./terminal-dispatch-receipt.js";
+import { terminalSubmissionPayload } from "./terminal-dispatch-execution.js";
+import { terminalControlFromTakeover } from "./terminal-runtime-cli-adapter.js";
+import { isRecord, nonBlankString as stringValue } from "./value-guards.js";
+function delegateEventMessage(dependencies, owner, messageId) {
+    const eventLogPath = stringValue(owner.event_log_path);
+    if (!eventLogPath) {
+        return undefined;
+    }
+    let matches;
+    try {
+        matches = dependencies.repository.readEvents(eventLogPath)
+            .filter((event) => isRecord(event.message) && event.message.id === messageId)
+            .map((event) => event.message);
+    }
+    catch {
+        matches = [];
+    }
+    if (matches.length > 1) {
+        throw new Error(`terminal idempotency key ${messageId} has duplicate durable messages`);
+    }
+    return matches[0];
+}
+function routedDelegateReceipt(dependencies, boundary, owner, receipt) {
+    const ownerStoreDir = dependencies.repository.storeDirForConversation(owner);
+    const takeover = isRecord(owner.native_session_takeover)
+        ? owner.native_session_takeover
+        : undefined;
+    const terminalControl = terminalControlFromTakeover(takeover);
+    const conversationId = stringValue(takeover?.native_session_id);
+    const eventMessage = delegateEventMessage(dependencies, owner, boundary.messageId);
+    const messageType = stringValue(receipt.message_type) ??
+        (isRecord(eventMessage) ? stringValue(eventMessage.type) : undefined);
+    const storedBodyHash = stringValue(receipt.message_body_hash) ??
+        (isRecord(eventMessage) && typeof eventMessage.body === "string"
+            ? createHash("sha256").update(eventMessage.body).digest("hex")
+            : undefined);
+    const ownerWorkspace = dependencies.runtime.canonicalWorkspace(owner.workspace);
+    if (!ownerStoreDir ||
+        path.resolve(ownerStoreDir) !== boundary.storeDir ||
+        (stringValue(receipt.store_dir) !== undefined &&
+            path.resolve(String(receipt.store_dir)) !== boundary.storeDir) ||
+        !terminalControl ||
+        !conversationId ||
+        stringValue(receipt.request_hash) !== boundary.requestHash ||
+        messageType !== "task" ||
+        storedBodyHash !== boundary.bodyHash ||
+        (boundary.requestedOpenClawSession &&
+            (stringValue(receipt.openclaw_session) ?? owner.openclaw_session) !==
+                boundary.requestedOpenClawSession) ||
+        (boundary.requestedAgent &&
+            executorForConversation(owner).kind !== boundary.requestedAgent) ||
+        (boundary.workspace && ownerWorkspace !== boundary.workspace)) {
+        throw new Error(`terminal idempotency key ${boundary.messageId} does not match its ` +
+            "original delegate request boundary; no terminal input was sent");
+    }
+    return { owner, receipt, conversationId, workspace: ownerWorkspace,
+        terminalControl };
+}
+function selectedStableDelegateRoute(dependencies, routed, storeDir, messageId) {
+    const authoritative = routed.filter(({ receipt }) => !(receipt.status === "aborted" && receipt.safe_to_retry === true));
+    if (authoritative.length > 1) {
+        throw new Error(`terminal idempotency key ${messageId} has multiple durable delegate receipts`);
+    }
+    const firstRoute = routed[0];
+    if (!firstRoute ||
+        routed.some((entry) => entry.conversationId !== firstRoute.conversationId ||
+            !terminalControlsShareIncarnation(entry.terminalControl, firstRoute.terminalControl))) {
+        throw new Error(`terminal idempotency key ${messageId} has conflicting terminal routes`);
+    }
+    const selected = authoritative[0] ?? routed.at(-1);
+    if (!selected) {
+        return undefined;
+    }
+    if (selected.receipt.status === "aborted" &&
+        selected.receipt.safe_to_retry === true) {
+        const ownerControl = terminalControlFromTakeover(isRecord(selected.owner.native_session_takeover)
+            ? selected.owner.native_session_takeover
+            : undefined);
+        if (!ownerControl) {
+            throw new Error(`terminal idempotency key ${messageId} has no durable terminal route`);
+        }
+        const retrySession = dependencies.authority.assertSafeAbortedTerminalRetryBinding({
+            owner: selected.owner,
+            receipt: selected.receipt,
+            storeDir,
+            terminalControl: ownerControl,
+            messageId
+        });
+        if (!retrySession) {
+            throw new Error(`terminal idempotency key ${messageId} has no restored retry Session`);
+        }
+        if (retrySession.agent === "codex" &&
+            isCompleteNativeRollout(retrySession.binding?.native_process.rollout)) {
+            // An unchanged safe-aborted binding still does not prove the Codex TUI
+            // foreground. Keep the terminal route so runSend captures fresh
+            // candidate authority and uses the v3 transfer instead of strict Session.
+            return { kind: "terminal", conversationId: selected.conversationId,
+                workspace: selected.workspace };
+        }
+        return { kind: "session", sessionId: retrySession.session_id,
+            workspace: selected.workspace };
+    }
+    return { kind: "terminal", conversationId: selected.conversationId,
+        workspace: selected.workspace };
+}
+function stableDelegateTerminalRoute(dependencies, boundary) {
+    const messageId = stringValue(boundary.options.messageId);
+    if (!messageId) {
+        return undefined;
+    }
+    const storeDir = path.resolve(dependencies.runtime.storeDir(boundary.options));
+    const requestHash = terminalBridgeRequestFingerprint(terminalSubmissionPayload(boundary.request));
+    const bodyHash = createHash("sha256").update(boundary.request).digest("hex");
+    const requestedOpenClawSession = stringValue(boundary.options.openclawSession);
+    const matches = dependencies.repository.listConversations(storeDir)
+        .flatMap((owner) => terminalBridgeSubmissionReceipts(owner)
+        .filter((receipt) => stringValue(receipt.message_id) === messageId)
+        .map((receipt) => ({ owner, receipt })));
+    if (matches.length === 0) {
+        return undefined;
+    }
+    const routed = matches.map(({ owner, receipt }) => routedDelegateReceipt(dependencies, { ...boundary, storeDir, requestHash, bodyHash,
+        requestedOpenClawSession, messageId }, owner, receipt));
+    return selectedStableDelegateRoute(dependencies, routed, storeDir, messageId);
+}
+function assertSingleDelegateCandidate(candidates, scopedCount, workspace, requestedAgent) {
+    if (candidates.length === 0) {
+        const observed = scopedCount > 0
+            ? ` Found ${scopedCount} matching pane(s), but none is idle.`
+            : "";
+        const requestedExecutor = requestedAgent
+            ? executorDefinitionForKind(requestedAgent)
+            : undefined;
+        const workspaceDetail = workspace ? ` in ${workspace}` : "";
+        throw new Error(`No idle ${requestedExecutor?.displayName ?? "Codex or Claude Code"} pane is available${workspaceDetail}.${observed} ` +
+            `Start ${requestedAgent ?? "codex or claude"} inside tmux or Herdr${workspaceDetail}, wait until it is idle, then retry.`);
+    }
+    if (candidates.length > 1) {
+        const rendered = candidates.map((candidate) => {
+            const identity = `${candidate.agent}, ${candidate.terminal_control?.target ?? candidate.id}`;
+            return workspace
+                ? `${candidate.short_ref} (${identity})`
+                : `${candidate.short_ref} (${identity}, ${candidate.workspace ?? "workspace unknown"})`;
+        }).join(", ");
+        const scope = requestedAgent
+            ? executorDefinitionForKind(requestedAgent).displayName
+            : "coding-agent";
+        const ambiguity = workspace
+            ? `match ${workspace}`
+            : "are available across workspaces";
+        throw new Error(`Multiple idle ${scope} panes ${ambiguity}: ${rendered}. ` +
+            "Use /akk codex: <task>, /akk claude: <task>, or /akk @short-ref: <message> to choose one explicitly.");
+    }
+    return candidates[0];
+}
+function createRunDelegate(dependencies) {
+    return async (options) => {
+        const request = dependencies.runtime.required(options.request, "--request is required");
+        const workspace = options.workspace === undefined
+            ? undefined
+            : dependencies.runtime.canonicalWorkspace(options.workspace);
+        const requestedAgent = options.agent === undefined
+            ? undefined
+            : resolveExecutor({ kind: options.agent }).kind;
+        const stableRoute = stableDelegateTerminalRoute(dependencies, {
+            options,
+            request,
+            workspace,
+            requestedAgent
+        });
+        if (stableRoute) {
+            await dependencies.terminalCommand.runSend(stableRoute.kind === "session"
+                ? {
+                    ...options,
+                    session: stableRoute.sessionId,
+                    conversation: undefined,
+                    message: request,
+                    workspace: stableRoute.workspace,
+                    background: true
+                }
+                : {
+                    ...options,
+                    conversation: stableRoute.conversationId,
+                    session: undefined,
+                    message: request,
+                    workspace: stableRoute.workspace,
+                    background: true
+                });
+            return;
+        }
+        const scan = await dependencies.terminalList.buildTerminalListGroup({
+            options: { ...options, workspace, noApprovalScan: false },
+            agentFilter: requestedAgent,
+            statusFilter: undefined
+        });
+        if (scan.summary.error) {
+            throw new Error(`terminal discovery failed: ${scan.summary.error}`);
+        }
+        const scopedCandidates = workspace === undefined
+            ? scan.terminalControlled
+            : scan.terminalControlled.filter((candidate) => {
+                try {
+                    return dependencies.runtime.canonicalWorkspace(candidate.workspace) ===
+                        workspace;
+                }
+                catch {
+                    return false;
+                }
+            });
+        const eligible = scopedCandidates.filter((candidate) => {
+            if (candidate.activity_state !== "idle") {
+                return false;
+            }
+            const terminalControl = isRecord(candidate.terminal_control)
+                ? candidate.terminal_control
+                : undefined;
+            return !terminalControl ||
+                dependencies.terminalList.terminalDispatchOwnership(terminalControl)
+                    .state === "none";
+        });
+        const selected = assertSingleDelegateCandidate(eligible, scopedCandidates.length, workspace, requestedAgent);
+        const selectedWorkspace = dependencies.runtime.canonicalWorkspace(selected.workspace);
+        await dependencies.terminalCommand.runSend({
+            ...options,
+            conversation: selected.id,
+            message: request,
+            workspace: selectedWorkspace,
+            background: true
+        });
+    };
+}
+export function createTerminalDelegateCliFacade(dependencies) {
+    return Object.freeze({ runDelegate: createRunDelegate(dependencies) });
+}
+//# sourceMappingURL=terminal-delegate-cli-adapter.js.map

package/dist/src/terminal-delegate-cli-adapter.js.map

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

package/dist/src/terminal-dispatch-abort.d.ts

@@ -0,0 +1,22 @@
+export type TerminalZeroInputFailureKind = "setup" | "transport";
+export type TerminalZeroInputAbortBlocker = "dispatch_ledger_restore" | "raw_attach_rollback" | "aborted_state_persistence";
+interface TerminalZeroInputAbortOutcomeBase {
+    failureKind: TerminalZeroInputFailureKind;
+}
+export type TerminalZeroInputAbortOutcome = (TerminalZeroInputAbortOutcomeBase & {
+    disposition: "retry";
+    safeToRetry: true;
+}) | (TerminalZeroInputAbortOutcomeBase & {
+    disposition: "inspect";
+    safeToRetry: false;
+    blocker: TerminalZeroInputAbortBlocker;
+});
+export interface ReduceTerminalZeroInputAbortOptions {
+    failureKind: TerminalZeroInputFailureKind;
+    dispatchLedgerRestored: boolean;
+    rawAttachRolledBack: boolean;
+    abortedStatePersisted: boolean;
+}
+/** Reduce durable zero-input evidence without performing recovery or writes. */
+export declare function reduceTerminalZeroInputAbort(options: ReduceTerminalZeroInputAbortOptions): TerminalZeroInputAbortOutcome;
+export {};

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

@@ -0,0 +1,30 @@
+/** Reduce durable zero-input evidence without performing recovery or writes. */
+export function reduceTerminalZeroInputAbort(options) {
+    const base = { failureKind: options.failureKind };
+    if (!options.dispatchLedgerRestored) {
+        return {
+            ...base,
+            disposition: "inspect",
+            safeToRetry: false,
+            blocker: "dispatch_ledger_restore"
+        };
+    }
+    if (!options.rawAttachRolledBack) {
+        return {
+            ...base,
+            disposition: "inspect",
+            safeToRetry: false,
+            blocker: "raw_attach_rollback"
+        };
+    }
+    if (!options.abortedStatePersisted) {
+        return {
+            ...base,
+            disposition: "inspect",
+            safeToRetry: false,
+            blocker: "aborted_state_persistence"
+        };
+    }
+    return { ...base, disposition: "retry", safeToRetry: true };
+}
+//# sourceMappingURL=terminal-dispatch-abort.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-dispatch-abort.js","sourceRoot":"","sources":["../../src/terminal-dispatch-abort.ts"],"names":[],"mappings":"AA6BA,gFAAgF;AAChF,MAAM,UAAU,4BAA4B,CAC1C,OAA4C;IAE5C,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;IAClD,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC;QACpC,OAAO;YACL,GAAG,IAAI;YACP,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,yBAAyB;SACnC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;QACjC,OAAO;YACL,GAAG,IAAI;YACP,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,qBAAqB;SAC/B,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC;QACnC,OAAO;YACL,GAAG,IAAI;YACP,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,2BAA2B;SACrC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC"}

package/dist/src/terminal-dispatch-application.d.ts

@@ -0,0 +1,115 @@
+import { type Conversation, type Executor } from "./protocol.js";
+import type { TerminalControlRef } from "./terminal-agent-adapter.js";
+import { type TerminalZeroInputAbortOutcome, type TerminalZeroInputFailureKind } from "./terminal-dispatch-abort.js";
+import { type TerminalDispatchLedgerDocument, type TerminalOrdinaryDispatchStatus } from "./terminal-dispatch-ledger-codec.js";
+import { terminalDispatchTextSummary as textSummary } from "./terminal-dispatch-receipt.js";
+import type { TerminalSubmissionAcceptanceEvidence } from "./terminal-submission-facts.js";
+export interface TerminalDispatchMessage {
+    id: string;
+    type: "task" | "answer";
+    body: string;
+}
+export interface TerminalDispatchAuditEvent {
+    ts: string;
+    conversation_id: string;
+    event: string;
+    message_id?: string;
+    executor?: Executor;
+    terminal_control?: TerminalControlRef;
+    source_conversation_id?: string;
+    agent?: Executor["kind"];
+    request_hash?: string;
+    dispatcher_pid?: number;
+    error?: ReturnType<typeof textSummary>;
+    delivered?: boolean;
+    do_not_retry?: boolean;
+    delivery_receipt?: TerminalOrdinaryDispatchStatus;
+    safe_to_retry?: boolean;
+    terminal_input_started?: false;
+    message?: ReturnType<typeof textSummary>;
+    payload?: ReturnType<typeof textSummary>;
+}
+export type TerminalDispatchAcceptance = {
+    outcome: "agent_accepted";
+    evidence: TerminalSubmissionAcceptanceEvidence;
+} | {
+    outcome: "pending_acceptance";
+} | {
+    outcome: "not_accepted";
+    reason: string;
+} | {
+    outcome: "uncertain";
+    reason: string;
+};
+export interface TerminalDispatchApplicationContext {
+    originalConversation: Conversation;
+    preparedConversation: Conversation;
+    message: TerminalDispatchMessage;
+    executor: Executor;
+    terminalControl: TerminalControlRef;
+    receiptTerminalControl: TerminalControlRef | undefined;
+    requestText: string;
+    requestHash: string;
+    preparedAt: string;
+    statePath: string;
+    eventLogPath: string;
+    previousGenerationId?: string;
+    dispatcherPid: number;
+    storeDir?: string;
+    recordRawAttachmentAfterSend: boolean;
+    ledgerBindingFields(conversation: Conversation): TerminalDispatchLedgerDocument;
+}
+export interface TerminalDispatchApplicationPorts {
+    synchronizeStageProgress(conversation: Conversation, stage: "text_injected" | "enter_dispatched", at: string): void;
+    state: {
+        save(conversation: Conversation): void;
+    };
+    ledger: {
+        save(ledger: TerminalDispatchLedgerDocument, phase?: "ordinary" | "final"): void;
+        restore(reason: string, terminalInputNotStartedAt?: string): void;
+    };
+    audit: {
+        append(event: TerminalDispatchAuditEvent): void;
+        appendPreparedMessage(): void;
+        log(level: "info" | "warn" | "error", event: string, fields: {
+            [key: string]: unknown;
+        }): void;
+        recordBookkeepingFailure(phase: string, error: unknown): void;
+        recordPersistenceFailure(phase: string, error: unknown, conversation: Conversation): void;
+    };
+    rollbackBeforeInput(): boolean;
+}
+export interface RecordedTerminalZeroInputAbort {
+    outcome: TerminalZeroInputAbortOutcome;
+    reportedConversation: Conversation;
+    receiptConversation: Conversation;
+    errorMessage: string;
+    dispatchLedgerRestored: boolean;
+    abortedStatePersisted: boolean;
+    rawAttachRolledBack: boolean;
+}
+/**
+ * Orders already-authorized ordinary dispatch writes. Locks, terminal I/O,
+ * acceptance observation, raw persistence adapters, and presentation stay in
+ * the composition root.
+ */
+export declare class TerminalDispatchApplication {
+    #private;
+    constructor(context: TerminalDispatchApplicationContext, ports: TerminalDispatchApplicationPorts);
+    persistPrepared(): void;
+    recordPreparedBookkeeping(recordPreparedEvent: boolean, injectFailure?: boolean, validatePreparedEvent?: () => void): void;
+    recordTransportStage(stage: "text_injected" | "enter_dispatched", at: string, afterDurable: () => Promise<void> | void): Promise<void>;
+    applyIdentityFailure(at: string, reason: string, beforePersist?: (conversation: Conversation) => void): Conversation;
+    applyAcceptance(submittedBase: Conversation, acceptance: TerminalDispatchAcceptance, resolvedAt: string): {
+        conversation: Conversation;
+        status: TerminalOrdinaryDispatchStatus;
+    };
+    applyUncertain(at: string, error: unknown): Conversation;
+    recordZeroInputAbort({ failureKind, error, abortedAt, injectStatePersistenceFailure }: {
+        failureKind: TerminalZeroInputFailureKind;
+        error: unknown;
+        abortedAt: string;
+        injectStatePersistenceFailure?: boolean;
+    }): RecordedTerminalZeroInputAbort;
+    recordPostSubmissionBookkeeping(conversation: Conversation, delivered: boolean, nowIso: () => string): string | undefined;
+}