@scotthuang/agent-knock-knock 0.2.51 → 0.3.0-beta.2

package/dist/src/doctor-capabilities.d.ts

@@ -1,22 +1,73 @@
+export type DoctorMode = "tmux" | "acpx" | "all";
+export type DoctorReadiness = "ready" | "partially_ready" | "not_ready";
+export type DoctorProbeCommand = "openclaw" | "tmux" | "acpx" | "codex" | "claude" | "cursor";
+export type DoctorProbeStatus = "ok" | "not_found" | "not_executable" | "version_failed" | "timeout" | "malformed_output";
 export interface DoctorCommandCheck {
     command: string;
     available: boolean;
     version_supported?: boolean;
+    status?: DoctorProbeStatus;
+}
+export interface DoctorCommandProbe extends DoctorCommandCheck {
+    command: DoctorProbeCommand;
+    status: DoctorProbeStatus;
+    executable: string;
+    args: readonly string[];
+    found: boolean;
+    executable_ok: boolean;
+    duration_ms: number;
+    version?: string;
+    output?: string;
+    error?: string;
+    exit_code?: number | null;
+    signal?: NodeJS.Signals | null;
+}
+export interface DoctorProbeOptions {
+    /**
+     * Timeout for each command. Values above 30 seconds are clamped so a doctor
+     * run cannot become unbounded through configuration.
+     */
+    timeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    executables?: Partial<Record<DoctorProbeCommand, string>>;
+}
+interface DoctorModeCapability {
+    available: boolean;
+    status: DoctorReadiness;
+    agents: string[];
+    requires: string[];
+    missing: string[];
+}
+interface DoctorTmuxCapability extends DoctorModeCapability {
+    recommended: true;
+}
+interface DoctorAcpxCapability extends DoctorModeCapability {
+    client: "acpx";
 }
 export interface DoctorCapabilitySummary {
     coreOk: boolean;
     transportOk: boolean;
-    tmux: {
-        available: boolean;
-        recommended: true;
-        agents: string[];
-        requires: string[];
-    };
-    acp: {
-        available: boolean;
-        client: "acpx";
-        agents: string[];
-        requires: string[];
-    };
+    mode: DoctorMode;
+    readiness: DoctorReadiness;
+    tmux: DoctorTmuxCapability;
+    acpx: DoctorAcpxCapability;
+    /**
+     * Backwards-compatible alias retained for existing CLI consumers.
+     */
+    acp: DoctorAcpxCapability;
 }
-export declare function evaluateDoctorCapabilities(checks: readonly DoctorCommandCheck[]): DoctorCapabilitySummary;
+export declare const DOCTOR_PROBE_COMMANDS: readonly DoctorProbeCommand[];
+/**
+ * Run a bounded, non-interactive version probe for one doctor dependency.
+ *
+ * This deliberately does not invoke a shell. Successful process execution is
+ * not enough: the output must also contain a recognizable version.
+ */
+export declare function probeDoctorCommand(command: DoctorProbeCommand, options?: DoctorProbeOptions): DoctorCommandProbe;
+/**
+ * Probe every external command used by the tmux and ACPX execution modes.
+ */
+export declare function runDoctorCapabilityProbes(options?: DoctorProbeOptions, mode?: DoctorMode): DoctorCommandProbe[];
+export declare function evaluateDoctorCapabilities(checks: readonly DoctorCommandCheck[], mode?: DoctorMode): DoctorCapabilitySummary;
+export {};

package/dist/src/doctor-capabilities.js

@@ -1,29 +1,258 @@
-export function evaluateDoctorCapabilities(checks) {
+import { spawnSync } from "node:child_process";
+const DEFAULT_PROBE_TIMEOUT_MS = 3_000;
+const MAX_PROBE_TIMEOUT_MS = 30_000;
+const MAX_PROBE_BUFFER_BYTES = 64 * 1024;
+const MAX_REPORTED_OUTPUT_CHARS = 2_000;
+const PROBE_ARGUMENTS = {
+    openclaw: ["--version"],
+    tmux: ["-V"],
+    acpx: ["--version"],
+    codex: ["--version"],
+    claude: ["--version"],
+    cursor: ["--version"]
+};
+const DEFAULT_PROBE_EXECUTABLES = {
+    openclaw: "openclaw",
+    tmux: "tmux",
+    acpx: "acpx",
+    codex: "codex",
+    claude: "claude",
+    // ACPX's built-in Cursor adapter launches `cursor-agent acp`. The desktop
+    // `cursor` shim may exist while no ACP-capable Cursor agent is available.
+    cursor: "cursor-agent"
+};
+export const DOCTOR_PROBE_COMMANDS = Object.freeze(Object.keys(PROBE_ARGUMENTS));
+const MODE_PROBE_COMMANDS = {
+    tmux: ["openclaw", "tmux", "codex", "claude"],
+    acpx: ["openclaw", "acpx", "codex", "claude", "cursor"],
+    all: DOCTOR_PROBE_COMMANDS
+};
+/**
+ * Run a bounded, non-interactive version probe for one doctor dependency.
+ *
+ * This deliberately does not invoke a shell. Successful process execution is
+ * not enough: the output must also contain a recognizable version.
+ */
+export function probeDoctorCommand(command, options = {}) {
+    const executable = options.executables?.[command] ?? DEFAULT_PROBE_EXECUTABLES[command];
+    const args = PROBE_ARGUMENTS[command];
+    const timeoutMs = boundedTimeout(options.timeoutMs);
+    const startedAt = Date.now();
+    const result = spawnSync(executable, args, {
+        cwd: options.cwd,
+        env: {
+            ...process.env,
+            CI: "1",
+            NO_COLOR: "1",
+            FORCE_COLOR: "0",
+            TERM: "dumb",
+            PAGER: "cat",
+            GIT_PAGER: "cat",
+            ...options.env
+        },
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+        timeout: timeoutMs,
+        killSignal: "SIGKILL",
+        maxBuffer: MAX_PROBE_BUFFER_BYTES,
+        windowsHide: true
+    });
+    const durationMs = Date.now() - startedAt;
+    const output = cleanProbeOutput([result.stdout, result.stderr].filter(Boolean).join("\n"));
+    const processError = result.error;
+    if (processError) {
+        const status = classifySpawnError(processError);
+        return buildProbeResult({
+            command,
+            executable,
+            args,
+            status,
+            durationMs,
+            output,
+            error: processError.message,
+            exitCode: result.status,
+            signal: result.signal
+        });
+    }
+    if (result.status !== 0) {
+        return buildProbeResult({
+            command,
+            executable,
+            args,
+            status: "version_failed",
+            durationMs,
+            output,
+            error: output || `${command} version probe exited with status ${result.status}`,
+            exitCode: result.status,
+            signal: result.signal
+        });
+    }
+    const version = parseVersion(output);
+    if (!version) {
+        return buildProbeResult({
+            command,
+            executable,
+            args,
+            status: "malformed_output",
+            durationMs,
+            output,
+            error: `${command} version probe did not return a recognizable version`,
+            exitCode: result.status,
+            signal: result.signal
+        });
+    }
+    return buildProbeResult({
+        command,
+        executable,
+        args,
+        status: "ok",
+        durationMs,
+        output,
+        version,
+        exitCode: result.status,
+        signal: result.signal
+    });
+}
+/**
+ * Probe every external command used by the tmux and ACPX execution modes.
+ */
+export function runDoctorCapabilityProbes(options = {}, mode = "all") {
+    return MODE_PROBE_COMMANDS[mode].map((command) => probeDoctorCommand(command, options));
+}
+export function evaluateDoctorCapabilities(checks, mode = "all") {
     const checkByCommand = new Map(checks.map((check) => [check.command, check]));
     const nodeCheck = checkByCommand.get("node");
-    const coreOk = nodeCheck?.available === true &&
-        nodeCheck.version_supported === true &&
-        checkByCommand.get("openclaw")?.available === true;
+    const nodeOk = isUsable(nodeCheck) &&
+        nodeCheck?.version_supported === true;
+    const openclawOk = isUsable(checkByCommand.get("openclaw"));
+    const coreOk = nodeOk && openclawOk;
+    const missingCore = [
+        ...(!nodeOk ? ["node"] : []),
+        ...(!openclawOk ? ["openclaw"] : [])
+    ];
     const availableAgents = ["codex", "claude", "cursor"]
-        .filter((agent) => checkByCommand.get(agent)?.available === true);
+        .filter((agent) => isUsable(checkByCommand.get(agent)));
     const tmuxAgents = availableAgents.filter((agent) => agent !== "cursor");
+    const tmuxTransportOk = isUsable(checkByCommand.get("tmux"));
+    const acpxTransportOk = isUsable(checkByCommand.get("acpx"));
     const tmux = {
-        available: checkByCommand.get("tmux")?.available === true && tmuxAgents.length > 0,
+        available: tmuxTransportOk && tmuxAgents.length > 0,
+        status: readinessFromParts([coreOk, tmuxTransportOk, tmuxAgents.length > 0]),
         recommended: true,
         agents: tmuxAgents,
-        requires: ["tmux", "codex or claude"]
+        requires: ["node", "openclaw", "tmux", "codex or claude"],
+        missing: [
+            ...missingCore,
+            ...(!tmuxTransportOk ? ["tmux"] : []),
+            ...(tmuxAgents.length === 0 ? ["codex or claude"] : [])
+        ]
     };
-    const acp = {
-        available: checkByCommand.get("acpx")?.available === true && availableAgents.length > 0,
+    const acpx = {
+        available: acpxTransportOk && availableAgents.length > 0,
+        status: readinessFromParts([coreOk, acpxTransportOk, availableAgents.length > 0]),
         client: "acpx",
         agents: availableAgents,
-        requires: ["acpx", "codex, claude, or cursor"]
+        requires: ["node", "openclaw", "acpx", "codex, claude, or cursor"],
+        missing: [
+            ...missingCore,
+            ...(!acpxTransportOk ? ["acpx"] : []),
+            ...(availableAgents.length === 0 ? ["codex, claude, or cursor"] : [])
+        ]
     };
     return {
         coreOk,
-        transportOk: tmux.available || acp.available,
+        transportOk: tmux.available || acpx.available,
+        mode,
+        readiness: selectedReadiness(mode, tmux.status, acpx.status),
         tmux,
-        acp
+        acpx,
+        acp: acpx
+    };
+}
+function buildProbeResult({ command, executable, args, status, durationMs, version, output, error, exitCode, signal }) {
+    return {
+        command,
+        executable,
+        args,
+        status,
+        available: status === "ok",
+        found: status !== "not_found",
+        executable_ok: !["not_found", "not_executable"].includes(status),
+        duration_ms: durationMs,
+        ...(version ? { version } : {}),
+        ...(output ? { output } : {}),
+        ...(error ? { error } : {}),
+        ...(exitCode !== undefined ? { exit_code: exitCode } : {}),
+        ...(signal !== undefined ? { signal } : {})
     };
 }
+function classifySpawnError(error) {
+    if (error.code === "ENOENT" || error.code === "ENOTDIR") {
+        return "not_found";
+    }
+    if (error.code === "EACCES" ||
+        error.code === "EPERM" ||
+        error.code === "EISDIR" ||
+        error.code === "ENOEXEC") {
+        return "not_executable";
+    }
+    if (error.code === "ETIMEDOUT") {
+        return "timeout";
+    }
+    return "version_failed";
+}
+function cleanProbeOutput(value) {
+    const cleaned = value
+        .replace(/\u001B\[[0-?]*[ -/]*[@-~]/g, "")
+        .replace(/\r/g, "")
+        .trim();
+    if (!cleaned) {
+        return undefined;
+    }
+    return cleaned.slice(0, MAX_REPORTED_OUTPUT_CHARS);
+}
+function parseVersion(output) {
+    if (!output) {
+        return undefined;
+    }
+    const match = output.match(/(?:^|[^0-9A-Za-z])v?(\d+\.\d+(?:\.\d+)?(?:[-+][0-9A-Za-z.-]+|[A-Za-z]\d*)?)(?=$|[^0-9A-Za-z])/m);
+    return match?.[1];
+}
+function boundedTimeout(value) {
+    if (value === undefined) {
+        return DEFAULT_PROBE_TIMEOUT_MS;
+    }
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new RangeError("doctor probe timeoutMs must be a positive finite number");
+    }
+    return Math.min(Math.ceil(value), MAX_PROBE_TIMEOUT_MS);
+}
+function isUsable(check) {
+    return check?.available === true && (check.status === undefined || check.status === "ok");
+}
+function readinessFromParts(parts) {
+    const readyParts = parts.filter(Boolean).length;
+    if (readyParts === parts.length) {
+        return "ready";
+    }
+    return readyParts === 0 ? "not_ready" : "partially_ready";
+}
+function selectedReadiness(mode, tmux, acpx) {
+    if (mode === "tmux") {
+        return tmux;
+    }
+    if (mode === "acpx") {
+        return acpx;
+    }
+    // "all" inspects both execution modes, but the product only requires one
+    // usable transport. Per-mode status still shows which optional mode needs
+    // attention.
+    if (tmux === "ready" || acpx === "ready") {
+        return "ready";
+    }
+    if (tmux === "not_ready" && acpx === "not_ready") {
+        return "not_ready";
+    }
+    return "partially_ready";
+}
 //# sourceMappingURL=doctor-capabilities.js.map

package/dist/src/doctor-capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor-capabilities.js","sourceRoot":"","sources":["../../src/doctor-capabilities.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,0BAA0B,CACxC,MAAqC;IAErC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,SAAS,EAAE,SAAS,KAAK,IAAI;QAC1C,SAAS,CAAC,iBAAiB,KAAK,IAAI;QACpC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;IACrD,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;SAClD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG;QACX,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,IAAI,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAClF,WAAW,EAAE,IAAa;QAC1B,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC;KACtC,CAAC;IACF,MAAM,GAAG,GAAG;QACV,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,IAAI,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC;QACvF,MAAM,EAAE,MAAe;QACvB,MAAM,EAAE,eAAe;QACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,0BAA0B,CAAC;KAC/C,CAAC;IACF,OAAO;QACL,MAAM;QACN,WAAW,EAAE,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS;QAC5C,IAAI;QACJ,GAAG;KACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"doctor-capabilities.js","sourceRoot":"","sources":["../../src/doctor-capabilities.ts"],"names":[],"mappings":"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"}

package/dist/src/openclaw-doctor.d.ts

@@ -0,0 +1,28 @@
+export type OpenClawDiagnosticStatus = "ok" | "failed" | "missing" | "invalid" | "unreachable";
+export interface OpenClawDiagnosticCheck {
+    name: "config" | "plugin_entry" | "plugin_installed" | "plugin_enabled" | "plugin_runtime" | "skill" | "workspace" | "gateway";
+    ok: boolean;
+    status: OpenClawDiagnosticStatus;
+    detail: string;
+    remediation?: string[];
+}
+export interface OpenClawChainDiagnostics {
+    ready: boolean;
+    package_ready: boolean;
+    gateway_ready: boolean;
+    default_agent?: "codex" | "claude" | "cursor";
+    workspace?: string;
+    checks: OpenClawDiagnosticCheck[];
+}
+export interface OpenClawChainDiagnosticOptions {
+    openclawBin: string;
+    workspace?: string;
+    timeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+}
+/**
+ * Verify the complete OpenClaw-side AKK chain without returning config values
+ * other than the explicitly non-secret workspace path.
+ */
+export declare function runOpenClawChainDiagnostics(options: OpenClawChainDiagnosticOptions): OpenClawChainDiagnostics;