@scotthuang/agent-knock-knock 0.13.18 → 0.14.1

package/dist/src/backend-recovery-semantic.js

@@ -0,0 +1,113 @@
+import { resolveMonitorHardTimeoutMinutes } from "./monitor-deadline-policy.js";
+import { pushOptional, requiredControllerSessionKey, requiredString } from "./semantic-tool-arguments.js";
+import { isRecord, nonBlankString } from "./value-guards.js";
+const commands = new Set(["renew", "close", "recover", "retry-callback"]);
+const backendIdentity = /^(?:desktop|codex-cli):/u;
+const backendWatchPrefix = /^(?:desktop-watch|codex-cli-watch):/u;
+const backendWatch = /^(?:desktop-watch|codex-cli-watch):[A-Za-z0-9_-]{8,128}$/u;
+export function isBackendTaskWatchId(value) {
+    return typeof value === "string" && backendWatch.test(value);
+}
+export function normalizeBackendStatusTarget(params) {
+    if (typeof params.turn_id !== "string" || !backendWatchPrefix.test(params.turn_id.trim()))
+        return params;
+    if (Object.hasOwn(params, "watch_id") || Object.hasOwn(params, "conversation_id"))
+        throw new Error("status accepts exactly one of turn_id, conversation_id, or watch_id");
+    if (!backendWatch.test(params.turn_id))
+        throw new Error("status requires an exact backend Watch ID");
+    const { turn_id, ...rest } = params;
+    return { ...rest, watch_id: turn_id };
+}
+/** Backend maintenance is anchored to one persisted task, never the thread's current task. */
+export function backendRecoveryTarget(params, command) {
+    const targets = ["watch_id", "turn_id", "conversation_id"].filter(key => Object.hasOwn(params, key));
+    if (targets.length !== 1)
+        throw new Error(`${command} accepts exactly one of watch_id, turn_id or conversation_id`);
+    const field = targets[0];
+    const id = requiredString(params[field], field);
+    if (backendIdentity.test(id.trim()) || field === "conversation_id" && backendWatchPrefix.test(id.trim())) {
+        throw new Error(`${command} requires the exact backend watch_id or send-produced turn_id; conversation_id cannot select a backend task`);
+    }
+    if (backendWatchPrefix.test(id.trim()) || field === "watch_id" || command === "recover") {
+        if (!backendWatch.test(id))
+            throw new Error(`${command} requires an exact backend Watch ID`);
+        return id;
+    }
+    return undefined;
+}
+export function backendRecoveryToolArgs(command, params, context, options = {}) {
+    const id = backendRecoveryTarget(params, command);
+    if (!id) {
+        if (Object.hasOwn(params, "notification_id"))
+            throw new Error("notification_id is supported only for backend callback recovery");
+        return undefined;
+    }
+    const fields = command === "renew" ? ["minutes"] : command === "close" ? ["reason"] : command === "retry-callback" ? ["notification_id"] : [];
+    const allowed = new Set(["watch_id", "turn_id", ...fields]);
+    const extra = Object.keys(params).filter(key => !allowed.has(key));
+    if (extra.length)
+        throw new Error(`Unsupported backend ${command} parameters: ${extra.join(", ")}`);
+    const args = [command, "--watch", id, "--openclaw-session", requiredControllerSessionKey(context.sessionKey)];
+    pushOptional(args, "--store-dir", options.storeDir);
+    pushOptional(args, "--codex-home", options.codexHome);
+    if (command === "renew") {
+        const supplied = params.minutes ?? options.defaultMinutes;
+        if (supplied !== undefined && (typeof supplied !== "number" || !Number.isFinite(supplied) || supplied <= 0)) {
+            throw new Error("minutes must be a positive number");
+        }
+        args.push("--minutes", String(resolveMonitorHardTimeoutMinutes(params.minutes, options.defaultMinutes)));
+    }
+    if (Object.hasOwn(params, "reason"))
+        args.push("--reason", requiredString(params.reason, "reason"));
+    if (Object.hasOwn(params, "notification_id"))
+        args.push("--notification-id", requiredString(params.notification_id, "notification_id"));
+    return args;
+}
+/** Run before conversation routing, which must never reinterpret a backend recovery target. */
+export function assertBackendRecoveryCliTarget(command, options) {
+    if (!command || !commands.has(command))
+        return;
+    const fields = ["watch", "turn", "conversation", "conversationId", "terminal", "session"];
+    const targets = fields.filter(key => Object.hasOwn(options, key));
+    const hasBackend = targets.some(key => typeof options[key] === "string" &&
+        (backendIdentity.test(options[key].trim()) || backendWatchPrefix.test(options[key].trim())));
+    if (command !== "recover" && !hasBackend && !Object.hasOwn(options, "watch")) {
+        if (Object.hasOwn(options, "notificationId"))
+            throw new Error("--notification-id is supported only for backend callback recovery");
+        return;
+    }
+    if (targets.length !== 1 || !["watch", "turn"].includes(targets[0]) || !backendWatch.test(String(options[targets[0]]))) {
+        throw new Error(`${command} requires exactly one --watch or --turn containing an exact backend Watch ID`);
+    }
+    requiredControllerSessionKey(options.openclawSession);
+    const fences = Object.keys(options).filter(key => /^expected/u.test(key));
+    if (fences.length)
+        throw new Error(`Backend ${command} does not accept terminal recovery fences: ${fences.join(", ")}`);
+    if (command !== "retry-callback" && Object.hasOwn(options, "notificationId")) {
+        throw new Error("--notification-id is supported only by retry-callback");
+    }
+    if (Object.hasOwn(options, "notificationId"))
+        requiredString(options.notificationId, "notification-id");
+}
+/** Report observed delivery state without turning a retry attempt into a delivery receipt. */
+export function formatBackendRecoveryCommandResult(result, command) {
+    if (!isRecord(result) || !backendWatch.test(String(result.watch_id)))
+        return undefined;
+    const fields = ["watch_id", "turn_id", "task_kind", "native_turn_id", "status", "management_state", "observation_state", "closed_at", "unwatched_at", "hard_timeout_at", "deadline_at"];
+    const lines = fields.flatMap(field => {
+        const value = nonBlankString(result[field]);
+        return value ? [`${field}: ${value}`] : [];
+    });
+    if (Array.isArray(result.callback_notifications)) {
+        for (const notification of result.callback_notifications) {
+            if (!isRecord(notification))
+                continue;
+            const id = nonBlankString(notification.notification_id) ?? nonBlankString(notification.id);
+            const status = nonBlankString(notification.status);
+            if (id && status)
+                lines.push(`callback ${id}: ${status}`);
+        }
+    }
+    return [`AKK backend ${command}.`, ...lines].join("\n");
+}
+//# sourceMappingURL=backend-recovery-semantic.js.map

package/dist/src/backend-recovery-semantic.js.map

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

package/dist/src/backend-task-recovery.d.ts

@@ -0,0 +1,103 @@
+import type { CallbackAttemptOutcome } from "./callback-transport.js";
+/** Additive fields keep existing v1 backend records readable. Management and observation are separate. */
+export interface BackendRecoveryFields {
+    closed_at?: string;
+    close_reason?: string;
+    unwatched_at?: string;
+    renewed_at?: string;
+    renewal_count?: number;
+    recovered_at?: string;
+}
+export interface BackendRetryFields {
+    /** Highest cumulative attempt explicitly authorized by a manual retry. */
+    retry_budget_until?: number;
+    retry_requested_at?: string;
+}
+export interface BackendRecoveryNotification extends BackendRetryFields {
+    id: string;
+    status: string;
+    attempts: number;
+    retry_at?: string;
+    outcome?: CallbackAttemptOutcome;
+}
+export interface BackendRecoveryTask extends BackendRecoveryFields {
+    id: string;
+    kind: "send" | "watch";
+    status: string;
+    controller_session: string;
+    deadline_at: string;
+    notifications: BackendRecoveryNotification[];
+}
+export declare class BackendRecoveryError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function assertBackendRecoveryOwner(task: BackendRecoveryTask, input: {
+    controllerSession: string;
+}): void;
+export declare function backendObservationStopped(task: BackendRecoveryFields & {
+    status: string;
+}): boolean;
+export declare function assertBackendRecoveryFields(task: BackendRecoveryTask): void;
+export declare function assertBackendRecoveryUpdate(previous: BackendRecoveryTask, next: BackendRecoveryTask): void;
+export declare function backendRenewalDeadline(task: BackendRecoveryTask, now: Date, timeoutMs?: number): string;
+export declare function suppressBackendNotifications(task: BackendRecoveryTask, code: string): void;
+export declare function closeBackendManagement(task: BackendRecoveryTask, input: {
+    controllerSession: string;
+    reason?: string;
+}, now: Date): void;
+export declare function stopBackendObservation(task: BackendRecoveryTask, now: Date): void;
+export declare function isBackendCallbackRetryable(task: BackendRecoveryTask, note: BackendRecoveryNotification): boolean;
+export declare function prepareBackendCallbackRetry(task: BackendRecoveryTask, input: {
+    controllerSession: string;
+    notificationId?: string;
+}, now: Date): string;
+export declare function backendCallbackMaxAttempts(note: BackendRetryFields, defaultMax: number): number;
+export declare function backendTaskRecoveryProjection(task: BackendRecoveryTask): {
+    task_kind: "send" | "watch";
+    turn_id?: string | undefined;
+    management_state: string;
+    observation_state: string;
+    deadline_at: string;
+    renewal_count: number;
+    closed_at: string | undefined;
+    close_reason: string | undefined;
+    unwatched_at: string | undefined;
+    renewed_at: string | undefined;
+    recovered_at: string | undefined;
+    callback_in_flight: boolean;
+    retryable_callback_ids: string[];
+    recovery_actions: {
+        recover?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        renew?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        unwatch?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        close?: {
+            tool: string;
+            input: {
+                turn_id: string;
+            };
+        } | undefined;
+        retry_callback?: {
+            tool: string;
+            input: {
+                watch_id: string;
+                notification_id: string;
+            };
+        } | undefined;
+    };
+};

package/dist/src/backend-task-recovery.js

@@ -0,0 +1,143 @@
+import { resolveMonitorHardTimeoutMs } from "./monitor-deadline-policy.js";
+export class BackendRecoveryError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "BackendRecoveryError";
+    }
+}
+export function assertBackendRecoveryOwner(task, input) {
+    if (!input.controllerSession?.trim() || input.controllerSession !== task.controller_session) {
+        throw new BackendRecoveryError("backend_controller_mismatch", "Only the owning controller can recover this exact task");
+    }
+}
+export function backendObservationStopped(task) {
+    return Boolean(task.closed_at || task.unwatched_at || task.status === "cancelled");
+}
+export function assertBackendRecoveryFields(task) {
+    assertRecoveryTimes(task);
+    if (task.closed_at && task.kind !== "send")
+        throw new Error("Only a managed send can be closed");
+    if (task.close_reason !== undefined && (!task.closed_at || typeof task.close_reason !== "string" || !task.close_reason.trim()))
+        throw new Error("Invalid backend close reason");
+    if (task.renewal_count !== undefined && (!Number.isSafeInteger(task.renewal_count) || task.renewal_count < 0))
+        throw new Error("Invalid backend renewal count");
+    if (Boolean(task.renewed_at) !== Boolean(task.renewal_count))
+        throw new Error("Backend renewal must include its time and generation");
+    for (const note of task.notifications)
+        assertRetryFields(note);
+}
+function assertRecoveryTimes(task) {
+    for (const field of ["closed_at", "unwatched_at", "renewed_at", "recovered_at"]) {
+        if (task[field] !== undefined && (typeof task[field] !== "string" || !Number.isFinite(Date.parse(task[field])))) {
+            throw new Error(`Invalid backend recovery ${field}`);
+        }
+    }
+}
+function assertRetryFields(note) {
+    if (note.retry_budget_until !== undefined && (!Number.isSafeInteger(note.retry_budget_until) || note.retry_budget_until < 1))
+        throw new Error("Invalid backend callback retry budget");
+    if (note.retry_requested_at !== undefined && (typeof note.retry_requested_at !== "string" || !Number.isFinite(Date.parse(note.retry_requested_at))))
+        throw new Error("Invalid backend callback retry time");
+}
+export function assertBackendRecoveryUpdate(previous, next) {
+    if (previous.closed_at && (next.closed_at !== previous.closed_at || next.close_reason !== previous.close_reason))
+        throw new Error("Closed backend management cannot be reopened");
+    const before = previous.renewal_count ?? 0;
+    const after = next.renewal_count ?? 0;
+    if (after !== before && after !== before + 1)
+        throw new Error("Backend renewal generation must advance once");
+    if (previous.deadline_at !== next.deadline_at && (after !== before + 1 ||
+        Date.parse(next.deadline_at) < Date.parse(previous.deadline_at) || !next.renewed_at || next.closed_at)) {
+        throw new Error("Backend deadline change requires an explicit monotonic renewal");
+    }
+    if (previous.unwatched_at && !next.unwatched_at && after !== before + 1)
+        throw new Error("Only renewal can resume stopped observation");
+    assertNotificationHistory(previous.notifications, next.notifications);
+}
+function assertNotificationHistory(previous, next) {
+    for (const old of previous) {
+        const current = next.find(note => note.id === old.id);
+        if (!current || current.attempts < old.attempts || (current.retry_budget_until ?? 0) < (old.retry_budget_until ?? 0))
+            throw new Error("Backend callback history cannot be reset");
+    }
+}
+export function backendRenewalDeadline(task, now, timeoutMs = resolveMonitorHardTimeoutMs()) {
+    if (task.closed_at)
+        throw new BackendRecoveryError("backend_task_closed", "Closed management cannot be renewed");
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 7 * 24 * 3_600_000) {
+        throw new BackendRecoveryError("invalid_argument", "Renewal must be between one millisecond and seven days");
+    }
+    return new Date(Math.max(Date.parse(task.deadline_at), now.getTime() + timeoutMs)).toISOString();
+}
+export function suppressBackendNotifications(task, code) {
+    for (const note of task.notifications)
+        if (["ready", "retry_wait"].includes(note.status)) {
+            note.status = "failed";
+            note.outcome = { disposition: "permanent_failure", error_code: code };
+            delete note.retry_at;
+        }
+}
+export function closeBackendManagement(task, input, now) {
+    assertBackendRecoveryOwner(task, input);
+    if (task.kind !== "send")
+        throw new BackendRecoveryError("backend_watch_not_managed", "Close requires a managed send; use Unwatch to stop an observation-only Watch");
+    if (task.closed_at)
+        return;
+    task.closed_at = now.toISOString();
+    if (input.reason?.trim())
+        task.close_reason = input.reason.trim();
+    suppressBackendNotifications(task, "backend_management_closed");
+}
+export function stopBackendObservation(task, now) {
+    task.unwatched_at ??= now.toISOString();
+    suppressBackendNotifications(task, "backend_watch_stopped");
+}
+export function isBackendCallbackRetryable(task, note) {
+    return !backendObservationStopped(task) && ["failed", "retry_wait"].includes(note.status) && note.outcome?.disposition === "retryable_failure";
+}
+export function prepareBackendCallbackRetry(task, input, now) {
+    assertBackendRecoveryOwner(task, input);
+    if (backendObservationStopped(task))
+        throw new BackendRecoveryError("backend_observation_stopped", "Stopped or closed observation cannot retry callbacks");
+    const selected = input.notificationId
+        ? task.notifications.filter(note => note.id === input.notificationId)
+        : task.notifications.filter(note => isBackendCallbackRetryable(task, note));
+    if (selected.length !== 1 || !isBackendCallbackRetryable(task, selected[0]))
+        throw new BackendRecoveryError("backend_callback_not_retryable", "Select exactly one known retryable callback; accepted, uncertain, in-flight and obsolete notifications cannot be replayed");
+    const note = selected[0];
+    note.retry_budget_until = Math.max(note.retry_budget_until ?? 0, note.attempts + 1);
+    note.retry_requested_at = now.toISOString();
+    note.status = "ready";
+    delete note.retry_at;
+    return note.id;
+}
+export function backendCallbackMaxAttempts(note, defaultMax) {
+    return Math.max(defaultMax, note.retry_budget_until ?? 0);
+}
+export function backendTaskRecoveryProjection(task) {
+    const stopped = backendObservationStopped(task);
+    const settled = ["completed", "failed", "interrupted"].includes(task.status);
+    const input = { watch_id: task.id };
+    const retryable = task.notifications.filter(note => isBackendCallbackRetryable(task, note));
+    return {
+        task_kind: task.kind,
+        ...(task.kind === "send" ? { turn_id: task.id } : {}),
+        management_state: task.kind === "watch" ? "unmanaged" : task.closed_at ? "closed" : "managed",
+        observation_state: stopped ? "stopped" : task.status === "timed_out" ? "expired" : settled ? "settled" : "watching",
+        deadline_at: task.deadline_at, renewal_count: task.renewal_count ?? 0,
+        closed_at: task.closed_at, close_reason: task.close_reason, unwatched_at: task.unwatched_at,
+        renewed_at: task.renewed_at, recovered_at: task.recovered_at,
+        callback_in_flight: task.notifications.some(note => note.status === "leased"),
+        retryable_callback_ids: retryable.map(note => note.id),
+        recovery_actions: {
+            ...(!task.closed_at ? { recover: { tool: "agent_knock_knock_recover", input } } : {}),
+            ...(!task.closed_at && !settled ? { renew: { tool: "agent_knock_knock_renew", input } } : {}),
+            ...(!stopped ? { unwatch: { tool: "agent_knock_knock_unwatch", input } } : {}),
+            ...(task.kind === "send" && !task.closed_at ? { close: { tool: "agent_knock_knock_close", input: { turn_id: task.id } } } : {}),
+            ...(retryable.length === 1 ? { retry_callback: { tool: "agent_knock_knock_retry_callback", input: { ...input, notification_id: retryable[0].id } } } : {})
+        }
+    };
+}
+//# sourceMappingURL=backend-task-recovery.js.map

package/dist/src/backend-task-recovery.js.map

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

package/dist/src/callback-transport.d.ts

@@ -29,6 +29,14 @@ export type CallbackEnvelopeSourceV1 = {
     kind: "terminal_watch";
     watch_id: string;
     terminal_id: string;
+} | {
+    kind: "desktop_watch";
+    watch_id: string;
+    desktop_id: string;
+} | {
+    kind: "codex_native_watch";
+    watch_id: string;
+    native_id: string;
 };
 export interface CallbackEnvelopeEventV1 {
     id: string;

package/dist/src/callback-transport.js

@@ -203,6 +203,20 @@ function parseEnvelopeSource(value) {
             terminal_id: requiredRouteString(value.terminal_id, "source.terminal_id")
         };
     }
+    if (value.kind === "desktop_watch") {
+        return {
+            kind: "desktop_watch",
+            watch_id: requiredRouteString(value.watch_id, "source.watch_id"),
+            desktop_id: requiredRouteString(value.desktop_id, "source.desktop_id")
+        };
+    }
+    if (value.kind === "codex_native_watch") {
+        return {
+            kind: "codex_native_watch",
+            watch_id: requiredRouteString(value.watch_id, "source.watch_id"),
+            native_id: requiredRouteString(value.native_id, "source.native_id")
+        };
+    }
     throw new Error(`unsupported callback envelope source ${JSON.stringify(value.kind)}`);
 }
 function parseEnvelopeEvent(value) {

package/dist/src/callback-transport.js.map

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

package/dist/src/cli-core.js

@@ -1,3 +1,7 @@
+import { DEFAULT_MONITOR_HARD_TIMEOUT_MINUTES } from "./monitor-deadline-policy.js";
+import { dispatchLocalCodexCli, localCodexListForCli } from "./local-codex-cli-adapter.js";
+import { assertBackendRecoveryCliTarget } from "./backend-recovery-semantic.js";
+import { executeConversationCommand } from "./conversation-routing-cli-adapter.js";
 import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
 import fs from "node:fs";
@@ -81,7 +85,6 @@ const resolveTerminalDispatchLedgerPaneIncarnation = terminalDispatchRepository.
 const terminalDispatchRecordMatchesControl = terminalDispatchRepository.matchesControl;
 const terminalDispatchRecordProcessAnchor = terminalDispatchRepository.processAnchor;
 const DEFAULT_AGENT_TIMEOUT_MINUTES = 60;
-const DEFAULT_AGENT_HARD_TIMEOUT_MINUTES = 720;
 const CLAUDE_SCREEN_APPROVAL_TTL_MS = 10 * 60 * 1000;
 const CALLBACK_ATTEMPT_LEASE_MS = 2 * 60 * 1000;
 const CALLBACK_RETRY_DELAYS_MS = [5000, 15000, 60000, 60000];
@@ -181,6 +184,7 @@ const STORE_MUTATION_COMMANDS = new Set([
     "approve",
     "cancel",
     "renew",
+    "recover",
     "reconcile-monitors",
     "reconcile-watches",
     "watch-terminal",
@@ -226,9 +230,15 @@ export function parseCliCommand(argv) {
     };
 }
 export async function executeCliCommand(commandName, options = {}, dependencies = {}) {
-    return runCliCommandExecution(commandName, options, dependencies, () => dispatchCliCommand(commandName, applyTrustedHostProfileCliOptions(commandName, options, cliEnv(), cliCwd())));
+    return runCliCommandExecution(commandName, options, dependencies, () => {
+        const scopedOptions = applyTrustedHostProfileCliOptions(commandName, options, cliEnv(), cliCwd());
+        assertBackendRecoveryCliTarget(commandName, scopedOptions);
+        return executeConversationCommand(commandName, scopedOptions, (request, terminalId) => terminalListCliFacade.buildTerminalListGroup({ options: request, agentFilter: "codex", terminalId }).then(scan => scan.terminalControlled), dispatchCliCommand);
+    });
 }
 async function dispatchCliCommand(commandName, options) {
+    if (await dispatchLocalCodexCli(commandName, options))
+        return;
     if (commandName === "host-profile") {
         runHostProfileCommand(options);
         return;
@@ -245,9 +255,7 @@ async function dispatchCliCommand(commandName, options) {
     if (((commandName === "send" && !stringValue(options.turn)) ||
         commandName === "respond") &&
         typeof (options.message ?? options.request) === "string") {
-        // This pure syntax fence must run before selector discovery. Native
-        // lifecycle commands never need terminal, process, or Store observation.
-        // runSend retains the same check at the execution boundary.
+        // Reject native slash input before terminal discovery; runSend repeats this fence.
         terminalSubmissionPayload(options.message ?? options.request);
     }
     if (!(commandName === "send" && options.turn)) {
@@ -787,6 +795,7 @@ const terminalListCliFacade = createTerminalListCliFacade({
         reconcileMonitors: (options, request) => terminalMonitorSupervisionCliFacade.reconcileMonitors(options, request)
     },
     discovery: {
+        localCodexList: localCodexListForCli,
         agentVersionForRunningProcess,
         codexLatentClearResumeObservation,
         codexManagedIdentityResolutionContext,
@@ -986,7 +995,7 @@ const terminalInteractionCliFacade = createTerminalInteractionCliAdapter({
 const terminalMaintenanceCliFacade = createTerminalMaintenanceCliFacade({
     runtime: {
         defaultAgentTimeoutMinutes: DEFAULT_AGENT_TIMEOUT_MINUTES,
-        defaultAgentHardTimeoutMinutes: DEFAULT_AGENT_HARD_TIMEOUT_MINUTES,
+        defaultAgentHardTimeoutMinutes: DEFAULT_MONITOR_HARD_TIMEOUT_MINUTES,
         monitorLockVersion: terminalMonitorSupervisionCliFacade.monitorLockVersion,
         loadConversation: loadConversationFromOptions,
         storeDir: storeDirFromOptions,
@@ -1247,7 +1256,7 @@ function usage() {
   agent-knock-knock --help
   agent-knock-knock --version
   agent-knock-knock delegate --request <text> [--agent ${agentList}] [--workspace <path>] [--store-dir <dir>]
-  agent-knock-knock list [--store-dir <dir>] [--agent ${agentList}] [--status <status>] [--all] [--reconcile] [--no-approval-scan] [--terminal-debug]
+  agent-knock-knock list [--store-dir <dir>] [--agent ${agentList}] [--status <status>] [--all] [--reconcile] [--no-approval-scan] [--terminal-debug] [--desktop-view sidebar|history] [--desktop-search <text>] [--desktop-project <id|path>] [--desktop-limit <1-100>] [--desktop-cursor <cursor>]
   agent-knock-knock watch-terminal --terminal <exact-terminal-id> --openclaw-session <session> [--hard-timeout-minutes <minutes>] [--store-dir <dir>] [--openclaw-bin <path>]
   agent-knock-knock watch-status --watch <terminal-watch-id> [--store-dir <dir>]
   agent-knock-knock unwatch-terminal --watch <terminal-watch-id> [--store-dir <dir>]
@@ -1271,9 +1280,10 @@ function usage() {
   agent-knock-knock respond-interaction (--turn <turn-id|selector> | --watch <watch-id>) --interaction <id> --response-json <json> --expected-interaction-fingerprint <fingerprint> --expected-interaction-expires-at <timestamp>  # async_question defaults to advertised steer_current_turn (delivery_mode may select queue_next_turn); questionnaire forbids it; never use raw keys or menu indexes
   agent-knock-knock approve [--turn <turn-id|selector>] [--conversation <selector>] [--decision approve_once|reject] [--expected-terminal-token <token>] --expected-approval-fingerprint <fingerprint>
   agent-knock-knock cancel [--turn <turn-id|selector>] [--conversation <selector>]
-  agent-knock-knock renew [--turn <turn-id|selector>] [--conversation <selector>]
-  agent-knock-knock retry-callback [--turn <turn-id|selector>] [--conversation <selector>]
-  agent-knock-knock close [--turn <turn-id|selector>] [--conversation <selector>] [--reason <text>] [--expected-message-id <message-id> | --expected-transition-id <transition-id> | --expected-handoff-token <token>]
+  agent-knock-knock renew (--watch <backend-watch-id> | --turn <turn-id|selector> | --conversation <legacy-selector>) [--minutes <positive-minutes>] [--openclaw-session <originating-controller>]
+  agent-knock-knock recover (--watch <backend-watch-id> | --turn <backend-watch-id>) --openclaw-session <originating-controller>
+  agent-knock-knock retry-callback (--watch <backend-watch-id> | --turn <turn-id|selector> | --conversation <legacy-selector>) [--notification-id <backend-notification-id>] [--openclaw-session <originating-controller>]
+  agent-knock-knock close (--watch <backend-watch-id> | --turn <turn-id|selector> | --conversation <legacy-selector>) [--openclaw-session <originating-controller>] [--reason <text>] [--expected-message-id <message-id> | --expected-transition-id <transition-id> | --expected-handoff-token <token>]  # recovery fences are terminal-only; passive backend Watches use unwatch-terminal
   agent-knock-knock install-openclaw [--verify] [--openclaw-bin <path>] [--skill-path <path>] [--skill-only] [--no-restart]
   agent-knock-knock doctor [--openclaw-bin <path>] [--tmux-bin <path>] [--herdr-bin <path>]
   agent-knock-knock host-profile example