@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

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

@@ -0,0 +1,366 @@
+import { EXECUTOR_KINDS } from "./executors.js";
+export const sendParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: ["request"],
+    not: { required: ["session_id", "terminal_id"] },
+    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 follow-current selector action instead. Discovery selectors, terminal ids, and turn ids are never session_id destinations."
+        },
+        terminal_id: {
+            type: "string",
+            minLength: 1,
+            pattern: "^terminal:v[0-9]+:\\S+$",
+            description: "Exact full terminal_id from the current terminal-scoped send action. AKK derives and revalidates current terminal authority internally. Human discovery selectors remain slash-command inputs and are not structured-tool authority. Omit both target fields only when AKK should attach the unique eligible idle pane."
+        },
+        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 watchParameters = {
+    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 current watch action. The task must already have been started by the human in this terminal. AKK resolves and revalidates current observation authority internally."
+        },
+        hardTimeoutMinutes: {
+            type: "number",
+            exclusiveMinimum: 0,
+            description: "Optional maximum lifetime for observing this external terminal task."
+        }
+    }
+};
+export const unwatchParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: ["watch_id"],
+    properties: {
+        watch_id: {
+            type: "string",
+            minLength: 1,
+            description: "Authoritative Terminal Watch id returned by watch or prefilled by list/status."
+        }
+    }
+};
+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"],
+    properties: {
+        terminal_id: {
+            type: "string",
+            minLength: 1,
+            pattern: "^terminal:v[0-9]+:\\S+$",
+            description: "Exact full terminal_id from the current native_inspect action. Never use a short ref, Session id, Turn id, or constructed selector. AKK refreshes and revalidates the binding internally."
+        },
+        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."
+        }
+    }
+};
+export const newThreadParameters = {
+    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 current new_thread action. AKK refreshes and revalidates the lifecycle binding internally."
+        }
+    }
+};
+export const reconcileBindingParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: [
+        "terminal_id",
+        "conflicting_session_id"
+    ],
+    properties: {
+        terminal_id: {
+            type: "string",
+            minLength: 1,
+            pattern: "^terminal:v[0-9]+:\\S+$",
+            description: "Exact full terminal_id from the current reconcile_binding action."
+        },
+        conflicting_session_id: {
+            type: "string",
+            minLength: 1,
+            description: "Exact conflicting managed Session id prefilled by AKK list. Never choose or construct one independently."
+        }
+    }
+};
+export const resumeThreadParameters = {
+    type: "object",
+    additionalProperties: false,
+    required: [
+        "terminal_id",
+        "native_thread_id"
+    ],
+    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."
+        }
+    }
+};
+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: {
+        anyOf: [
+            { required: ["turn_id", "conversation_id"] },
+            { required: ["turn_id", "watch_id"] },
+            { required: ["conversation_id", "watch_id"] }
+        ]
+    },
+    anyOf: [
+        { required: ["turn_id"] },
+        { required: ["conversation_id"] },
+        { required: ["watch_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."
+        },
+        watch_id: {
+            type: "string",
+            minLength: 1,
+            description: "Authoritative Terminal Watch id prefilled by a current watch row. This inspects externally started work and is mutually exclusive with Turn targets."
+        },
+        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"] }
+        ]
+    },
+    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."
+        }
+    }
+};
+export const approveParameters = {
+    type: "object",
+    additionalProperties: false,
+    not: { required: ["turn_id", "terminal_id"] },
+    anyOf: [
+        { required: ["turn_id"] },
+        { required: ["terminal_id"] }
+    ],
+    properties: {
+        turn_id: {
+            type: "string",
+            description: "Authoritative AKK turn id containing the approval prompt."
+        },
+        terminal_id: {
+            type: "string",
+            minLength: 1,
+            pattern: "^terminal:v[0-9]+:\\S+$",
+            description: "Exact full terminal_id from the current terminal-scoped approval action. Managed Turn approval must use turn_id. AKK binds the user's reviewed prompt and revalidates terminal authority internally."
+        }
+    }
+};
+//# 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,123 @@
+import { pushOptional, 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 watchReconciliationArgs = () => {
+        const config = isRecord(api.pluginConfig) ? api.pluginConfig : {};
+        const args = ["reconcile-watches"];
+        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 reportWatches = (result, reason) => {
+        if (reason === "startup_reconciliation" ||
+            Number(result.changed ?? 0) > 0 ||
+            Number(result.callbacks_delivered ?? 0) > 0 ||
+            Number(result.errors ?? 0) > 0) {
+            api.logger.info?.(`agent-knock-knock Terminal Watch ${reason}: ` +
+                `checked=${result.checked ?? 0} changed=${result.changed ?? 0} ` +
+                `callbacks_delivered=${result.callbacks_delivered ?? 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}`);
+        }
+        try {
+            const watches = await runCliAsync(api, watchReconciliationArgs());
+            reportWatches(watches, "watch_supervision");
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            api.logger.warn?.(`agent-knock-knock Terminal Watch supervision deferred after error: ${message}`);
+        }
+    };
+    const reconcileStartup = async () => {
+        try {
+            const result = await runCliAsync(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}`);
+        }
+        try {
+            const watches = await runCliAsync(api, watchReconciliationArgs());
+            reportWatches(watches, "startup_reconciliation");
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            api.logger.warn?.(`agent-knock-knock Terminal Watch reconciliation skipped after startup error: ${message}`);
+        }
+    };
+    return {
+        id: "agent-knock-knock-monitor-reconciliation",
+        start() {
+            if (!stopped) {
+                return;
+            }
+            stopped = false;
+            inFlight = reconcileStartup().finally(() => {
+                inFlight = undefined;
+                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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"}