@scotthuang/agent-knock-knock 0.12.10 → 0.12.12

package/dist/src/openclaw-plugin-schemas.js

@@ -0,0 +1,394 @@
+import { EXECUTOR_KINDS } from "./executors.js";
+export const sendParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: ["request"],
+    not: {
+        anyOf: [
+            { required: ["session_id", "selector"] },
+            { required: ["session_id", "expected_terminal_token"] }
+        ]
+    },
+    properties: {
+        session_id: {
+            type: "string",
+            minLength: 1,
+            description: "Strict session-scoped AKK id only when the current list action prefills it. This preserves that exact native context and never follows the pane after a human switches threads. A rollout-backed Codex Session is a continuing context label but is not a direct ordinary-send target; use that terminal row's selector/token action instead. Discovery selectors, terminal ids, and turn ids are never session_id destinations."
+        },
+        selector: {
+            type: "string",
+            minLength: 1,
+            description: "Terminal-scoped selector: codex, claude, only, latest, an @short-ref, or a live terminal id. Use one only when explicitly named by the user or prefilled by list; never infer it. A follow-current handoff action uses the exact full terminal id together with expected_terminal_token. Legacy discovery selectors remain supported. Omit both target fields only when AKK should attach the unique eligible idle pane."
+        },
+        expected_terminal_token: {
+            type: "string",
+            minLength: 1,
+            description: "Fresh terminal snapshot token prefilled by the same terminal row's follow-current send action. Preserve it exactly with that action's full terminal selector; never infer, copy, reuse, or combine it with session_id."
+        },
+        request: {
+            type: "string",
+            minLength: 1,
+            description: "Message for the coding agent. Each accepted ordinary send creates a new turn inside the selected session without clearing native agent context."
+        },
+        type: {
+            type: "string",
+            enum: ["task"],
+            description: "Ordinary sends always create a task turn. Use agent_knock_knock_respond for an answer to an in-flight turn."
+        },
+        idleTimeoutMinutes: {
+            type: "number",
+            description: "Minutes an idle or completed AKK Turn record is retained before controlled reconciliation closes it."
+        },
+        agentTimeoutMinutes: {
+            type: "number",
+            description: "Callback timeout in minutes; terminal bridge tasks treat it as an inactivity timeout."
+        },
+        agentHardTimeoutMinutes: {
+            type: "number",
+            exclusiveMinimum: 0,
+            description: "Maximum terminal monitor lifetime in minutes."
+        }
+    }
+};
+export const respondParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: ["turn_id", "request"],
+    properties: {
+        turn_id: {
+            type: "string",
+            description: "Authoritative AKK turn id from a question or blocked callback, never a discovery selector or terminal id. A response continues this exact in-flight turn and does not create a new turn."
+        },
+        request: {
+            type: "string",
+            description: "Answer or decision for the coding agent's exact in-flight turn."
+        }
+    }
+};
+export const listParameters = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        agent: {
+            type: "string",
+            enum: EXECUTOR_KINDS
+        },
+        status: {
+            type: "string"
+        },
+        all: {
+            type: "boolean"
+        },
+        noApprovalScan: {
+            type: "boolean",
+            description: "When true, list live terminals without scanning their panes for approval prompts."
+        },
+        terminalDebug: {
+            type: "boolean",
+            description: "When true, include terminal-provider discovery diagnostics for debugging Gateway environment issues."
+        },
+        idleTimeoutMinutes: {
+            type: "number"
+        }
+    }
+};
+export const listResumableThreadsParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: ["terminal_id"],
+    properties: {
+        terminal_id: {
+            type: "string",
+            minLength: 1,
+            pattern: "^terminal:v[0-9]+:\\S+$",
+            description: "Exact full terminal_id from the selected terminal row's current available_actions. Do not use a short ref, session id, turn id, or constructed selector."
+        }
+    }
+};
+export const nativeInspectParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: ["terminal_id", "inspection", "expected_binding_token"],
+    properties: {
+        terminal_id: {
+            type: "string",
+            minLength: 1,
+            pattern: "^terminal:v[0-9]+:\\S+$",
+            description: "Exact full terminal_id from the same current native_inspect action as expected_binding_token. Never use a short ref, Session id, Turn id, or constructed selector."
+        },
+        inspection: {
+            type: "string",
+            enum: ["status"],
+            description: "Closed adapter-owned inspection kind. Exact Codex 0.146.0/0.146.1/0.147.0/0.148.0 and Claude Code 2.1.218/2.1.226/2.1.237 /status profiles are supported; this is never an arbitrary native command string."
+        },
+        expected_binding_token: {
+            type: "string",
+            minLength: 1,
+            description: "Fresh snapshot-bound terminal and binding token prefilled by this terminal's current native_inspect action. Never guess, construct, or reuse it after another terminal action."
+        }
+    }
+};
+export const newThreadParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: ["terminal_id", "expected_binding_token"],
+    properties: {
+        terminal_id: {
+            type: "string",
+            minLength: 1,
+            pattern: "^terminal:v[0-9]+:\\S+$",
+            description: "Exact full terminal_id from the same current lifecycle snapshot as expected_binding_token."
+        },
+        expected_binding_token: {
+            type: "string",
+            minLength: 1,
+            description: "Fresh compare-and-swap token prefilled by this terminal's available new_thread action or returned by agent_knock_knock_list_resumable_threads. Never guess, construct, or reuse it after another terminal action."
+        }
+    }
+};
+export const reconcileBindingParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: [
+        "terminal_id",
+        "conflicting_session_id",
+        "expected_session_revision",
+        "expected_binding_token",
+        "expected_terminal_token"
+    ],
+    properties: {
+        terminal_id: {
+            type: "string",
+            minLength: 1,
+            pattern: "^terminal:v[0-9]+:\\S+$",
+            description: "Exact full terminal_id from the same current reconcile_binding action as every expected token."
+        },
+        conflicting_session_id: {
+            type: "string",
+            minLength: 1,
+            description: "Exact conflicting managed Session id prefilled by AKK list. Never choose or construct one independently."
+        },
+        expected_session_revision: {
+            type: "integer",
+            minimum: 1,
+            description: "Exact managed Session revision from the advertised reconcile_binding action."
+        },
+        expected_binding_token: {
+            type: "string",
+            minLength: 1,
+            description: "Fresh fingerprint of the conflicting binding from the advertised action."
+        },
+        expected_terminal_token: {
+            type: "string",
+            minLength: 1,
+            description: "Fresh fingerprint of the live terminal process incarnation from the same advertised action."
+        }
+    }
+};
+export const resumeThreadParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: [
+        "terminal_id",
+        "native_thread_id",
+        "expected_binding_token",
+        "candidate_token"
+    ],
+    properties: {
+        terminal_id: {
+            type: "string",
+            minLength: 1,
+            pattern: "^terminal:v[0-9]+:\\S+$",
+            description: "Exact full terminal_id passed to agent_knock_knock_list_resumable_threads."
+        },
+        native_thread_id: {
+            type: "string",
+            pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
+            description: "Complete native thread UUID from a resumable=true row returned for this exact terminal. Never truncate, guess, or select an unavailable row."
+        },
+        expected_binding_token: {
+            type: "string",
+            minLength: 1,
+            description: "Fresh compare-and-swap token from the same agent_knock_knock_list_resumable_threads result as native_thread_id."
+        },
+        candidate_token: {
+            type: "string",
+            minLength: 1,
+            description: "Opaque fingerprint from the selected resumable thread row in the same current list result. It binds resume to that exact historical file/evidence snapshot; never construct or reuse it."
+        }
+    }
+};
+export const renewParameters = {
+    type: "object",
+    additionalProperties: false,
+    not: { required: ["turn_id", "conversation_id"] },
+    anyOf: [
+        { required: ["turn_id"] },
+        { required: ["conversation_id"] }
+    ],
+    properties: {
+        turn_id: {
+            type: "string",
+            description: "Authoritative AKK turn id whose monitoring should be renewed."
+        },
+        conversation_id: {
+            type: "string",
+            deprecated: true,
+            description: "Deprecated compatibility alias for turn_id."
+        },
+        minutes: {
+            type: "number",
+            exclusiveMinimum: 0,
+            description: "New terminal inactivity timeout in minutes."
+        }
+    }
+};
+export const retryCallbackParameters = {
+    type: "object",
+    additionalProperties: false,
+    not: { required: ["turn_id", "conversation_id"] },
+    anyOf: [
+        { required: ["turn_id"] },
+        { required: ["conversation_id"] }
+    ],
+    properties: {
+        turn_id: {
+            type: "string",
+            description: "Authoritative AKK turn id whose persisted callback should be retried."
+        },
+        conversation_id: {
+            type: "string",
+            deprecated: true,
+            description: "Deprecated compatibility alias for turn_id."
+        }
+    }
+};
+export const statusParameters = {
+    type: "object",
+    additionalProperties: false,
+    not: { required: ["turn_id", "conversation_id"] },
+    anyOf: [
+        { required: ["turn_id"] },
+        { required: ["conversation_id"] }
+    ],
+    properties: {
+        turn_id: {
+            type: "string",
+            description: "Authoritative AKK turn id to inspect."
+        },
+        conversation_id: {
+            type: "string",
+            deprecated: true,
+            description: "Deprecated legacy Turn alias, or the exact raw-terminal selector prefilled by that terminal row's available status action. Managed Turn status must use turn_id; never construct or guess a raw-terminal selector."
+        },
+        idleTimeoutMinutes: {
+            type: "number"
+        },
+        trace: {
+            type: "boolean",
+            description: "Include a safe executor trace summary with tool calls, permission requests, monitor events, and redacted thinking markers."
+        }
+    }
+};
+export const cancelParameters = {
+    type: "object",
+    additionalProperties: false,
+    not: { required: ["turn_id", "conversation_id"] },
+    anyOf: [
+        { required: ["turn_id"] },
+        { required: ["conversation_id"] }
+    ],
+    properties: {
+        turn_id: {
+            type: "string",
+            description: "Authoritative AKK turn id to interrupt."
+        },
+        conversation_id: {
+            type: "string",
+            deprecated: true,
+            description: "Deprecated legacy Turn alias, or the exact raw-terminal selector prefilled by that terminal row's available cancel action. Managed Turn cancellation must use turn_id; never construct or guess a raw-terminal selector."
+        },
+        idleTimeoutMinutes: {
+            type: "number"
+        }
+    }
+};
+export const closeParameters = {
+    type: "object",
+    additionalProperties: false,
+    not: {
+        anyOf: [
+            { required: ["turn_id", "conversation_id"] },
+            { required: ["expected_message_id", "expected_transition_id"] },
+            { required: ["expected_handoff_token", "conversation_id"] },
+            { required: ["expected_handoff_token", "expected_message_id"] },
+            { required: ["expected_handoff_token", "expected_transition_id"] }
+        ]
+    },
+    anyOf: [
+        { required: ["turn_id"] },
+        { required: ["conversation_id"] }
+    ],
+    properties: {
+        turn_id: {
+            type: "string",
+            description: "Authoritative AKK turn id whose managed record should be closed."
+        },
+        conversation_id: {
+            type: "string",
+            deprecated: true,
+            description: "Deprecated legacy Turn alias, or an exact list-prefilled raw-terminal/orphan recovery selector. Managed Turn close must use turn_id; never construct or guess a raw-terminal selector."
+        },
+        reason: {
+            type: "string"
+        },
+        expected_message_id: {
+            type: "string",
+            description: "Required only to clear an orphaned terminal dispatch shown by AKK list. Must exactly match that entry's current message_id and must not be combined with expected_transition_id."
+        },
+        expected_transition_id: {
+            type: "string",
+            description: "Required only to recover an unresolved native-thread lifecycle transition shown by AKK list. Must exactly match that entry's current transition_id and must not be combined with expected_message_id."
+        },
+        expected_handoff_token: {
+            type: "string",
+            description: "Snapshot fence for the exact managed Turn close advertised only by terminals[].handoff_decision.choices.take_over_current.action. Copy that complete action only after explicit user confirmation; it requires turn_id and reason=superseded_by_human_context_switch, and cannot be combined with a raw-terminal target or another close fence."
+        }
+    }
+};
+export const approveParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: ["expected_approval_fingerprint"],
+    not: { required: ["turn_id", "conversation_id"] },
+    anyOf: [
+        { required: ["turn_id"] },
+        { required: ["conversation_id"] }
+    ],
+    allOf: [
+        {
+            if: { required: ["expected_terminal_token"] },
+            then: { required: ["conversation_id"] }
+        }
+    ],
+    properties: {
+        turn_id: {
+            type: "string",
+            description: "Authoritative AKK turn id containing the approval prompt."
+        },
+        conversation_id: {
+            type: "string",
+            deprecated: true,
+            description: "Deprecated legacy Turn alias, or the exact raw-terminal selector prefilled by that terminal row's available approval action. Managed Turn approval must use turn_id; never construct or guess a raw-terminal selector."
+        },
+        expected_approval_fingerprint: {
+            type: "string",
+            description: "Exact approval fingerprint returned by the latest status or approval-required callback. The prompt is captured again and must still match before keys are sent."
+        },
+        expected_terminal_token: {
+            type: "string",
+            description: "Only for a terminal-scoped manual Codex approval prefilled by the latest AKK list action. Preserve it exactly with that action's full conversation_id; never construct, reuse, or use it for automatic approval."
+        }
+    }
+};
+//# sourceMappingURL=openclaw-plugin-schemas.js.map

package/dist/src/openclaw-plugin-schemas.js.map

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

package/dist/src/openclaw-plugin-supervisor.d.ts

@@ -0,0 +1,6 @@
+export declare const MONITOR_SUPERVISOR_INTERVAL_MS = 5000;
+export declare function createMonitorReconciliationService(api: any, configuredIntervalMs: number): {
+    id: string;
+    start(): void;
+    stop(): Promise<void>;
+};

package/dist/src/openclaw-plugin-supervisor.js

@@ -0,0 +1,85 @@
+import { pushOptional, runCli, runCliAsync } from "./openclaw-plugin-command-adapter.js";
+import { resolvePluginStoreDir } from "./openclaw-plugin-helpers.js";
+import { isRecord } from "./value-guards.js";
+export const MONITOR_SUPERVISOR_INTERVAL_MS = 5_000;
+export function createMonitorReconciliationService(api, configuredIntervalMs) {
+    const intervalMs = Number.isFinite(configuredIntervalMs) &&
+        configuredIntervalMs > 0
+        ? Math.max(50, Math.ceil(configuredIntervalMs))
+        : MONITOR_SUPERVISOR_INTERVAL_MS;
+    let stopped = true;
+    let timer;
+    let inFlight;
+    const reconciliationArgs = (reason) => {
+        const config = isRecord(api.pluginConfig) ? api.pluginConfig : {};
+        const args = ["reconcile-monitors", "--reason", reason];
+        if (reason === "monitor_supervision") {
+            args.push("--terminal-monitors-only");
+        }
+        pushOptional(args, "--store-dir", resolvePluginStoreDir(config));
+        return args;
+    };
+    const report = (result, reason) => {
+        if (reason === "startup_reconciliation" ||
+            Number(result.launched ?? 0) > 0 ||
+            Number(result.errors ?? 0) > 0) {
+            const label = reason === "startup_reconciliation"
+                ? "monitor reconciliation"
+                : `monitor ${reason}`;
+            api.logger.info?.(`agent-knock-knock ${label}: ` +
+                `checked=${result.checked ?? 0} launched=${result.launched ?? 0} ` +
+                `already_running=${result.already_running ?? 0} skipped=${result.skipped ?? 0} ` +
+                `errors=${result.errors ?? 0}`);
+        }
+    };
+    const schedule = () => {
+        if (stopped) {
+            return;
+        }
+        timer = setTimeout(() => {
+            timer = undefined;
+            inFlight = supervise().finally(() => {
+                inFlight = undefined;
+                schedule();
+            });
+        }, intervalMs);
+        timer.unref?.();
+    };
+    const supervise = async () => {
+        try {
+            const result = await runCliAsync(api, reconciliationArgs("monitor_supervision"));
+            report(result, "monitor_supervision");
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            api.logger.warn?.(`agent-knock-knock monitor supervision deferred after error: ${message}`);
+        }
+    };
+    return {
+        id: "agent-knock-knock-monitor-reconciliation",
+        start() {
+            if (!stopped) {
+                return;
+            }
+            stopped = false;
+            try {
+                const result = runCli(api, reconciliationArgs("startup_reconciliation"));
+                report(result, "startup_reconciliation");
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                api.logger.warn?.(`agent-knock-knock monitor reconciliation skipped after startup error: ${message}`);
+            }
+            schedule();
+        },
+        async stop() {
+            stopped = true;
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+            await inFlight;
+        }
+    };
+}
+//# sourceMappingURL=openclaw-plugin-supervisor.js.map

package/dist/src/openclaw-plugin-supervisor.js.map

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