@scotthuang/agent-knock-knock 0.13.16 → 0.13.18

package/dist/src/terminal-watch-response-cli-adapter.js

@@ -0,0 +1,230 @@
+/** Watch interaction response transaction; retains terminal, Store, and Watch lock order. */
+import { respondCodexPaginatedAsyncQuestion } from "./codex-paginated-async-response.js";
+import { publicTerminalWatch, terminalWatchCapturedAgentVersion } from "./terminal-watch-presentation.js";
+import { refreshPaginatedResponseForeground } from "./codex-paginated-watch.js";
+import { respondCodexPaginatedBlockingQuestion } from "./codex-paginated-questionnaire-runtime.js";
+import { TerminalInteractionDispatchReservedError, TerminalInteractionInputNotStartedError } from "./terminal-agent-bridge.js";
+import { hashTerminalInteractionResponse, reduceTerminalInteractionAggregate } from "./terminal-interaction-core.js";
+import { validateTerminalInteractionSubjectResponse } from "./terminal-interaction-protocol.js";
+import { executeTerminalInteractionResponseTransaction } from "./terminal-interaction-response-transaction.js";
+import { terminalInteractionRuntimeForWatch } from "./terminal-watch-interaction-runtime.js";
+import { consumeWatchInteractionResponse, settleWatchInteractionResponseFailure } from "./terminal-watch-interaction-response-store.js";
+import { createTerminalWatchStore, terminalWatchRevision } from "./terminal-watch-store.js";
+import { exactTerminalForWatch, terminalControlForWatch, terminalMatchesWatch, requiredWatchId, requiredString, requiredSha256, requiredTimestamp, parseWatchInteractionResponse, assertWatchControllerSession, requiredExecutableWatchInteraction, sha256 } from "./terminal-watch-terminal-identity.js";
+import { terminalWatchResponseDecision } from "./terminal-watch-response-authority.js";
+export function createTerminalWatchInteractionResponder(dependencies, serviceFor) {
+    return async function runRespondInteraction(options) {
+        const watchId = requiredWatchId(options.watch);
+        const interactionId = requiredString(options.interaction, "--interaction is required");
+        const expectedFingerprint = requiredSha256(options.expectedInteractionFingerprint, "interaction prompt fingerprint");
+        const expectedExpiresAt = requiredTimestamp(options.expectedInteractionExpiresAt, "--expected-interaction-expires-at");
+        const responseValue = parseWatchInteractionResponse(options.responseJson);
+        const storeDir = dependencies.storeDirFromOptions(options);
+        const repository = createTerminalWatchStore(storeDir, {
+            acquire: dependencies.acquireFileLock
+        });
+        const service = serviceFor(options);
+        const displayed = await service.reconcile(watchId);
+        assertWatchControllerSession(displayed, options.openclawSession);
+        const displayedInteraction = requiredExecutableWatchInteraction(displayed, interactionId, expectedFingerprint);
+        const response = validateTerminalInteractionSubjectResponse(responseValue, displayedInteraction.projection, { now: dependencies.now(), allowExpiredForLiveRecapture: true });
+        if (response.subject.kind !== "terminal_watch" ||
+            response.subject.watch_id !== watchId) {
+            throw new Error("--response-json subject watch_id does not match --watch");
+        }
+        const exact = await exactTerminalForWatch(displayed.terminal.terminal_id, options, dependencies);
+        if (!terminalMatchesWatch(exact.rawTerminal, displayed)) {
+            throw new Error("terminal Watch identity changed before interaction response; refresh status");
+        }
+        const terminalControl = terminalControlForWatch(exact.rawTerminal);
+        const releaseTerminal = dependencies.acquireTerminalLock(storeDir, terminalControl);
+        try {
+            const withWriterLease = dependencies.withStoreWriterLeaseAsync ??
+                (async (_storeDir, operation) => operation());
+            await withWriterLease(storeDir, async () => {
+                let current = repository.load(watchId);
+                assertWatchControllerSession(current, options.openclawSession);
+                const executableInteraction = requiredExecutableWatchInteraction(current, interactionId, expectedFingerprint);
+                const decision = terminalWatchResponseDecision(current, exact.rawTerminal, executableInteraction.projection.surface_id, executableInteraction.projection.prompt_fingerprint, options, dependencies);
+                if (!decision.executable || decision.suppress) {
+                    throw new Error("a higher-priority terminal interaction responder owns this live questionnaire; refresh status");
+                }
+                const version = terminalWatchCapturedAgentVersion(current) ??
+                    requiredString(exact.rawTerminal.agent_version, "running coding-agent version");
+                const runtime = terminalInteractionRuntimeForWatch({
+                    watch: current,
+                    rawTerminal: exact.rawTerminal,
+                    checkpoint: current.observation_checkpoint,
+                    version,
+                    terminalTarget: terminalControl.target,
+                    responseAuthority: "executable"
+                });
+                const bridge = dependencies.createBridge?.(options);
+                if (!bridge) {
+                    throw new Error("terminal interaction bridge is unavailable");
+                }
+                if (runtime.codexPaginatedThread && executableInteraction.projection.kind === "async_question") {
+                    await refreshPaginatedResponseForeground(bridge, terminalControl, runtime, dependencies.now);
+                }
+                const attemptId = dependencies.randomUUID();
+                const responseHash = hashTerminalInteractionResponse(response);
+                const reservation = { attemptId, responseHash };
+                const result = await executeTerminalInteractionResponseTransaction({
+                    reservationFailureFence: "confirmed",
+                    dispatch: (hooks) => "schema" in current.observation_checkpoint &&
+                        current.observation_checkpoint.schema === "agent-knock-knock/codex-paginated-task-checkpoint" &&
+                        executableInteraction.projection.kind === "questionnaire"
+                        ? respondCodexPaginatedBlockingQuestion({
+                            watch: current, checkpoint: current.observation_checkpoint, terminalControl,
+                            response, expectedFingerprint, now: dependencies.now,
+                            authorize: hooks.authorize, beforeDispatch: hooks.beforeDispatch,
+                            persistDraft: (draft) => {
+                                current = repository.withWriterLease((scope) => scope.withWatchLock(watchId, () => {
+                                    const latest = scope.load(watchId);
+                                    const checkpoint = latest.observation_checkpoint;
+                                    if (!("schema" in checkpoint) || checkpoint.schema !== "agent-knock-knock/codex-paginated-task-checkpoint") {
+                                        throw new Error("Codex blocking question checkpoint changed");
+                                    }
+                                    const nextCheckpoint = { ...checkpoint };
+                                    if (draft)
+                                        nextCheckpoint.blocking_question_draft = draft;
+                                    else
+                                        delete nextCheckpoint.blocking_question_draft;
+                                    return scope.save({ ...latest,
+                                        observation_checkpoint: nextCheckpoint,
+                                        updated_at: dependencies.now().toISOString()
+                                    }, { expectedRevision: terminalWatchRevision(latest) });
+                                }));
+                            }
+                        })
+                        : runtime.codexPaginatedThread && executableInteraction.projection.kind === "async_question"
+                            ? respondCodexPaginatedAsyncQuestion({
+                                bridge, terminalControl, terminalEvidence: current.terminal.terminal_endpoint,
+                                runtime, response, now: dependencies.now,
+                                options: { agentVersion: version, expectedFingerprint, expectedExpiresAt,
+                                    scrollbackLines: Number(options.scrollbackLines ?? 120), runtime,
+                                    authorize: hooks.authorize, beforeDispatch: hooks.beforeDispatch }
+                            })
+                            : bridge.respondInteraction(current.agent, terminalControl, response, {
+                                agentVersion: version,
+                                expectedFingerprint,
+                                expectedExpiresAt,
+                                scrollbackLines: Number(options.scrollbackLines ?? 120),
+                                runtime,
+                                authorize: hooks.authorize,
+                                beforeDispatch: hooks.beforeDispatch
+                            }),
+                    authorize: ({ projection, fingerprint }) => {
+                        const latest = repository.load(watchId);
+                        const interaction = requiredExecutableWatchInteraction(latest, interactionId, expectedFingerprint);
+                        const latestDecision = terminalWatchResponseDecision(latest, exact.rawTerminal, interaction.projection.surface_id, interaction.projection.prompt_fingerprint, options, dependencies);
+                        return projection.interaction_id === interactionId &&
+                            fingerprint === expectedFingerprint &&
+                            interaction.projection.subject.kind === "terminal_watch" &&
+                            projection.version === 2 &&
+                            projection.subject.kind === "terminal_watch" &&
+                            projection.subject.watch_id === watchId &&
+                            latestDecision.executable && !latestDecision.suppress
+                            ? { approved: true }
+                            : {
+                                approved: false,
+                                reason: "terminal Watch interaction authority changed before response"
+                            };
+                    },
+                    createReservation: () => reservation,
+                    reserve: ({ projection, fingerprint }, receipt, confirm) => {
+                        current = repository.withWriterLease((scope) => scope.withWatchLock(watchId, () => {
+                            const latest = scope.load(watchId);
+                            const interaction = requiredExecutableWatchInteraction(latest, interactionId, expectedFingerprint);
+                            if (projection.interaction_id !== interactionId ||
+                                fingerprint !== expectedFingerprint ||
+                                interaction.aggregate.state !== "pending") {
+                                throw new Error("terminal Watch interaction authority changed before dispatch");
+                            }
+                            const dispatchDecision = terminalWatchResponseDecision(latest, exact.rawTerminal, interaction.projection.surface_id, interaction.projection.prompt_fingerprint, options, dependencies);
+                            if (!dispatchDecision.executable || dispatchDecision.suppress) {
+                                throw new TerminalInteractionInputNotStartedError("terminal Watch interaction ownership changed before dispatch");
+                            }
+                            const reservedAt = dependencies.now().toISOString();
+                            const aggregate = reduceTerminalInteractionAggregate(interaction.aggregate, {
+                                type: "reserve",
+                                attempt_id: receipt.attemptId,
+                                response_hash: receipt.responseHash,
+                                at: reservedAt
+                            });
+                            const saved = scope.save({
+                                ...latest,
+                                current_interaction: {
+                                    projection: interaction.projection,
+                                    aggregate
+                                },
+                                updated_at: reservedAt
+                            }, { expectedRevision: terminalWatchRevision(latest) });
+                            // Match the predecessor's commit boundary: a later lock
+                            // release failure must still settle this durable receipt.
+                            confirm();
+                            return saved;
+                        }));
+                    },
+                    release: (receipt) => {
+                        current = settleWatchInteractionResponseFailure(repository, {
+                            watchId,
+                            interactionId,
+                            reservation: receipt,
+                            state: "release",
+                            now: dependencies.now
+                        });
+                    },
+                    releaseFailure: (_receipt, _error, releaseError) => releaseError,
+                    markUncertain: (receipt) => {
+                        current = settleWatchInteractionResponseFailure(repository, {
+                            watchId,
+                            interactionId,
+                            reservation: receipt,
+                            state: "response_uncertain",
+                            now: dependencies.now
+                        });
+                    },
+                    consume: (receipt) => {
+                        current = consumeWatchInteractionResponse(repository, {
+                            watchId,
+                            interactionId,
+                            reservation: receipt,
+                            now: dependencies.now,
+                            notificationFingerprint: sha256
+                        });
+                    },
+                    responded: (execution) => execution.responded,
+                    isInputNotStarted: (error) => error instanceof TerminalInteractionInputNotStartedError,
+                    duplicateReservationError: () => new Error("terminal Watch interaction response was already reserved"),
+                    inputNotStartedError: (error) => error,
+                    missingReservationError: () => new TerminalInteractionDispatchReservedError("reservation_uncertain", "terminal Watch response was dispatched without a durable reservation")
+                });
+                const execution = result.execution;
+                if (result.state === "blocked") {
+                    dependencies.printJson({
+                        watch: publicTerminalWatch(current, [], true),
+                        interaction_id: interactionId,
+                        responded: false,
+                        blocked: execution.blocked,
+                        reason: execution.reason
+                    });
+                    return;
+                }
+                dependencies.printJson({
+                    watch: publicTerminalWatch(current, [], true),
+                    interaction_id: interactionId,
+                    responded: true,
+                    blocked: false,
+                    question_id: execution.questionId,
+                    response_kind: execution.responseKind,
+                    outcome: execution.outcome
+                });
+            });
+        }
+        finally {
+            releaseTerminal();
+        }
+    };
+}
+//# sourceMappingURL=terminal-watch-response-cli-adapter.js.map

package/dist/src/terminal-watch-response-cli-adapter.js.map

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

package/dist/src/terminal-watch-terminal-identity.d.ts

@@ -0,0 +1,39 @@
+import type { ExecutorKind } from "./executors.js";
+import type { CodexRolloutAcceptanceIdentity } from "./terminal-submission-acceptance.js";
+import { type TerminalControlRef } from "./terminal-control-ref.js";
+import { type TerminalWatch, type TerminalWatchAnchor, type TerminalWatchCurrentInteraction, type TerminalWatchTerminalIdentity, type TerminalActivityState } from "./terminal-watch-store.js";
+import type { TerminalWatchCliOptions, UserExplicitFallbackWatchTarget, PreparedUserExplicitFallbackWatch, ExactTerminalWatchObservation, TerminalWatchCliDependencies } from "./terminal-watch-cli-contract.js";
+export declare function assertSameUserExplicitFallbackTerminal(expected: UserExplicitFallbackWatchTarget, observed: Record<string, unknown>): void;
+export declare function assertPreparedFallbackTerminal(prepared: PreparedUserExplicitFallbackWatch, observed: Record<string, unknown>): void;
+export declare function exactTerminalForWatch(terminalId: string, options: TerminalWatchCliOptions, dependencies: TerminalWatchCliDependencies): Promise<Extract<ExactTerminalWatchObservation, {
+    state: "available";
+}>>;
+export declare function bestEffortBindingTokenForWatch(terminal: Record<string, unknown>): {
+    token: string;
+    warning?: string;
+};
+export declare function terminalActivityState(terminal: Record<string, unknown>): TerminalActivityState;
+export declare function sameManualWatchTarget(watch: TerminalWatch, agent: ExecutorKind, terminal: TerminalWatchTerminalIdentity, anchor: TerminalWatchAnchor): boolean;
+export declare function safeDiagnostic(error: unknown): string;
+export declare function terminalControlForWatch(terminal: Record<string, unknown>): TerminalControlRef;
+export declare function terminalWatchCandidateMatchesLiveContext(watch: TerminalWatch, terminal: Record<string, unknown>): boolean;
+export declare function currentTerminalForWatch(watch: TerminalWatch, options: TerminalWatchCliOptions, dependencies: TerminalWatchCliDependencies): Promise<ExactTerminalWatchObservation>;
+export declare function terminalMatchesWatch(terminal: Record<string, unknown>, watch: TerminalWatch): boolean;
+export type TerminalActivityWatchIdentityMatch = "match" | "mismatch" | "unavailable";
+export declare function terminalActivityWatchIdentityMatch(terminal: Record<string, unknown>, watch: TerminalWatch): TerminalActivityWatchIdentityMatch;
+export declare function terminalMatchesUserExplicitFallbackWatch(terminal: Record<string, unknown>, watch: TerminalWatch): boolean;
+export declare function terminalWatchIdentity(terminal: Record<string, unknown>, bindingToken: string): TerminalWatchTerminalIdentity;
+export declare function codexIdentity(terminal: Record<string, unknown>): CodexRolloutAcceptanceIdentity;
+export declare function codexIdentityForWatch(watch: TerminalWatch): CodexRolloutAcceptanceIdentity;
+export declare function terminalAgent(terminal: Record<string, unknown>): ExecutorKind;
+export declare function terminalWorkspace(terminal: Record<string, unknown>): string;
+export declare function requiredWatchId(value: unknown): string;
+export declare function requiredString(value: unknown, label: string): string;
+export declare function requiredSha256(value: unknown, label: string): string;
+export declare function requiredTimestamp(value: unknown, label: string): string;
+export declare function parseWatchInteractionResponse(value: unknown): unknown;
+export declare function assertWatchControllerSession(watch: TerminalWatch, requestedValue: unknown): void;
+export declare function requiredExecutableWatchInteraction(watch: TerminalWatch, interactionId: string, expectedFingerprint: string): TerminalWatchCurrentInteraction;
+export declare function positiveInteger(value: unknown, label: string): number;
+export declare function positiveMinutes(value: unknown, fallback: number): number;
+export declare function sha256(value: unknown): string;