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

package/dist/src/session-selector.js

@@ -0,0 +1,330 @@
+import { createHash } from "node:crypto";
+import { isExecutorKind } from "./executors.js";
+const SHORT_REF_DOMAIN = "agent-knock-knock/session-ref/v1\0";
+export const DEFAULT_SESSION_SHORT_REF_LENGTH = 10;
+export class SessionSelectorError extends Error {
+    code;
+    selector;
+    candidates;
+    constructor(options) {
+        super(options.message);
+        this.name = "SessionSelectorError";
+        this.code = options.code;
+        this.selector = options.selector;
+        this.candidates = Object.freeze([...(options.candidates ?? [])]);
+    }
+}
+/**
+ * Produce a stable, opaque reference that does not depend on list order or on
+ * the other currently visible sessions.
+ */
+export function sessionShortRef(id, length = DEFAULT_SESSION_SHORT_REF_LENGTH) {
+    const normalizedId = requireNonEmptyString(id, "session id");
+    if (!Number.isInteger(length) || length < 6 || length > 64) {
+        throw new TypeError("short reference length must be an integer between 6 and 64");
+    }
+    const digest = createHash("sha256")
+        .update(SHORT_REF_DOMAIN, "utf8")
+        .update(normalizedId, "utf8")
+        .digest("hex");
+    return `@${digest.slice(0, length)}`;
+}
+/**
+ * Return display-ready candidate details in a deterministic order.
+ */
+export function sessionSelectorCandidateDetails(candidates, options = {}) {
+    const normalized = normalizeCandidates(candidates);
+    const shortRefLength = normalizedShortRefLength(options.shortRefLength);
+    return [...normalized]
+        .sort(compareCandidates)
+        .map((candidate) => detailFor(candidate, shortRefLength));
+}
+/**
+ * Resolve a user-facing selector to one authoritative id.
+ *
+ * This function only resolves identity. The caller must still revalidate any
+ * PID, tmux pane/socket, native session id, or process identity immediately
+ * before performing a side effect.
+ */
+export function resolveSessionSelector(selector, candidates, options = {}) {
+    const normalizedCandidates = normalizeCandidates(candidates);
+    const shortRefLength = normalizedShortRefLength(options.shortRefLength);
+    const operation = normalizedOperation(options.operation);
+    const trimmedSelector = typeof selector === "string" ? selector.trim() : "";
+    const selectorForError = trimmedSelector || undefined;
+    // Complete ids are authoritative and case-sensitive. Check them before
+    // reserved selector words so even an unusual id such as "latest" remains
+    // addressable by its complete id.
+    if (trimmedSelector) {
+        const fullIdMatches = normalizedCandidates.filter((candidate) => candidate.id === trimmedSelector);
+        if (fullIdMatches.length > 0) {
+            return resolveExactMatches({
+                matches: fullIdMatches,
+                selector: trimmedSelector,
+                matchedBy: "full_id",
+                operation,
+                shortRefLength
+            });
+        }
+    }
+    const actionable = normalizedCandidates.filter((candidate) => candidate.actionable);
+    if (!trimmedSelector || trimmedSelector.toLowerCase() === "only") {
+        const matchedBy = trimmedSelector ? "only" : "implicit_only";
+        return resolveOnly({
+            matches: actionable,
+            allCandidates: normalizedCandidates,
+            selector: selectorForError,
+            matchedBy,
+            operation,
+            shortRefLength
+        });
+    }
+    const normalizedSelector = trimmedSelector.toLowerCase();
+    if (normalizedSelector === "latest") {
+        return resolveLatest({
+            matches: actionable,
+            allCandidates: normalizedCandidates,
+            selector: trimmedSelector,
+            matchedBy: "latest",
+            operation,
+            shortRefLength
+        });
+    }
+    if (isExecutorKind(normalizedSelector)) {
+        const allAgentMatches = normalizedCandidates.filter((candidate) => candidate.agent === normalizedSelector);
+        return resolveOnly({
+            matches: allAgentMatches.filter((candidate) => candidate.actionable),
+            allCandidates: allAgentMatches,
+            selector: trimmedSelector,
+            matchedBy: "agent",
+            operation,
+            shortRefLength
+        });
+    }
+    const agentLatestMatch = /^(codex|claude|cursor):latest$/u.exec(normalizedSelector);
+    if (agentLatestMatch) {
+        const agent = agentLatestMatch[1];
+        const allAgentMatches = normalizedCandidates.filter((candidate) => candidate.agent === agent);
+        return resolveLatest({
+            matches: allAgentMatches.filter((candidate) => candidate.actionable),
+            allCandidates: allAgentMatches,
+            selector: trimmedSelector,
+            matchedBy: "agent_latest",
+            operation,
+            shortRefLength
+        });
+    }
+    if (/^@[0-9a-f]+$/iu.test(trimmedSelector)) {
+        const shortRefMatches = normalizedCandidates.filter((candidate) => sessionShortRef(candidate.id, shortRefLength).toLowerCase() === normalizedSelector);
+        if (shortRefMatches.length > 0) {
+            return resolveExactMatches({
+                matches: shortRefMatches,
+                selector: trimmedSelector,
+                matchedBy: "short_ref",
+                operation,
+                shortRefLength
+            });
+        }
+    }
+    const details = candidateDetails(actionable, shortRefLength);
+    throw new SessionSelectorError({
+        code: "not_found",
+        selector: trimmedSelector,
+        candidates: details,
+        message: [
+            `Session selector ${quote(trimmedSelector)} did not match an actionable target${operationSuffix(operation)}.`,
+            candidateHint(details)
+        ].filter(Boolean).join(" ")
+    });
+}
+function resolveExactMatches(options) {
+    if (options.matches.length > 1) {
+        const details = candidateDetails(options.matches, options.shortRefLength);
+        throw new SessionSelectorError({
+            code: "ambiguous",
+            selector: options.selector,
+            candidates: details,
+            message: [
+                `Session selector ${quote(options.selector)} is ambiguous.`,
+                candidateHint(details)
+            ].join(" ")
+        });
+    }
+    const candidate = options.matches[0];
+    if (!candidate.actionable) {
+        const details = candidateDetails(options.matches, options.shortRefLength);
+        throw new SessionSelectorError({
+            code: "not_actionable",
+            selector: options.selector,
+            candidates: details,
+            message: `Session ${quote(candidate.id)} is not actionable${operationSuffix(options.operation)}.`
+        });
+    }
+    return resolution(candidate, options.selector, options.matchedBy, options.shortRefLength);
+}
+function resolveOnly(options) {
+    if (options.matches.length === 1) {
+        return resolution(options.matches[0], options.selector, options.matchedBy, options.shortRefLength);
+    }
+    if (options.matches.length === 0) {
+        throwNoActionable(options);
+    }
+    throwAmbiguous(options);
+}
+function resolveLatest(options) {
+    if (options.matches.length === 0) {
+        throwNoActionable(options);
+    }
+    if (options.matches.length === 1) {
+        return resolution(options.matches[0], options.selector, options.matchedBy, options.shortRefLength);
+    }
+    // If any candidate lacks recency, choosing another candidate as "latest"
+    // would be a guess. Equal newest timestamps are also intentionally ambiguous.
+    if (options.matches.some((candidate) => candidate.updatedAtMs === undefined)) {
+        throwAmbiguous(options, "latest cannot be determined because recency is missing");
+    }
+    const newestTimestamp = Math.max(...options.matches.map((candidate) => candidate.updatedAtMs));
+    const newest = options.matches.filter((candidate) => candidate.updatedAtMs === newestTimestamp);
+    if (newest.length !== 1) {
+        throwAmbiguous({ ...options, matches: newest }, "latest is tied between multiple targets");
+    }
+    return resolution(newest[0], options.selector, options.matchedBy, options.shortRefLength);
+}
+function throwNoActionable(options) {
+    const details = candidateDetails(options.allCandidates, options.shortRefLength);
+    const hasCandidates = options.allCandidates.length > 0;
+    throw new SessionSelectorError({
+        code: hasCandidates ? "not_actionable" : "no_actionable_targets",
+        selector: options.selector,
+        candidates: details,
+        message: hasCandidates
+            ? `No matching session is actionable${operationSuffix(options.operation)}. ${candidateHint(details)}`
+            : `There are no actionable sessions${operationSuffix(options.operation)}.`
+    });
+}
+function throwAmbiguous(options, reason = "multiple actionable targets match") {
+    const details = candidateDetails(options.matches, options.shortRefLength);
+    const subject = options.selector
+        ? `Session selector ${quote(options.selector)}`
+        : "The omitted session selector";
+    throw new SessionSelectorError({
+        code: "ambiguous",
+        selector: options.selector,
+        candidates: details,
+        message: `${subject} is ambiguous: ${reason}. ${candidateHint(details)}`
+    });
+}
+function resolution(candidate, selector, matchedBy, shortRefLength) {
+    return {
+        candidate,
+        id: candidate.id,
+        shortRef: sessionShortRef(candidate.id, shortRefLength),
+        selector,
+        matchedBy
+    };
+}
+function normalizeCandidates(candidates) {
+    if (!Array.isArray(candidates)) {
+        throw new TypeError("session selector candidates must be an array");
+    }
+    return candidates.map((candidate, index) => {
+        if (!candidate || typeof candidate !== "object") {
+            throw new TypeError(`session selector candidate ${index} must be an object`);
+        }
+        requireNonEmptyString(candidate.id, `session selector candidate ${index} id`);
+        if (!isExecutorKind(candidate.agent)) {
+            throw new TypeError(`session selector candidate ${index} has unsupported agent ${quote(String(candidate.agent))}`);
+        }
+        if (typeof candidate.actionable !== "boolean") {
+            throw new TypeError(`session selector candidate ${index} actionable must be a boolean`);
+        }
+        if (candidate.updatedAtMs !== undefined &&
+            !Number.isFinite(candidate.updatedAtMs)) {
+            throw new TypeError(`session selector candidate ${index} updatedAtMs must be finite when provided`);
+        }
+        return candidate;
+    });
+}
+function candidateDetails(candidates, shortRefLength) {
+    return [...candidates]
+        .sort(compareCandidates)
+        .map((candidate) => detailFor(candidate, shortRefLength));
+}
+function detailFor(candidate, shortRefLength) {
+    return {
+        id: candidate.id,
+        shortRef: sessionShortRef(candidate.id, shortRefLength),
+        agent: candidate.agent,
+        actionable: candidate.actionable,
+        updatedAtMs: candidate.updatedAtMs,
+        source: candidate.source,
+        status: candidate.status,
+        workspace: candidate.workspace,
+        label: candidate.label
+    };
+}
+function compareCandidates(left, right) {
+    const leftHasTime = left.updatedAtMs !== undefined;
+    const rightHasTime = right.updatedAtMs !== undefined;
+    if (leftHasTime && rightHasTime && left.updatedAtMs !== right.updatedAtMs) {
+        return right.updatedAtMs - left.updatedAtMs;
+    }
+    if (leftHasTime !== rightHasTime) {
+        return leftHasTime ? -1 : 1;
+    }
+    const agentOrder = compareStrings(left.agent, right.agent);
+    return agentOrder || compareStrings(left.id, right.id);
+}
+function compareStrings(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function candidateHint(details) {
+    if (details.length === 0) {
+        return "";
+    }
+    return `Candidates: ${details.map((detail) => {
+        const context = [
+            detail.shortRef,
+            detail.agent,
+            detail.status,
+            detail.source,
+            detail.workspace,
+            detail.label ? bounded(detail.label, 80) : undefined,
+            detail.id
+        ].filter((value) => Boolean(value));
+        return `[${context.join(" | ")}]`;
+    }).join(", ")}`;
+}
+function normalizedShortRefLength(value) {
+    const length = value ?? DEFAULT_SESSION_SHORT_REF_LENGTH;
+    // Reuse the public validation without making a meaningless hash allocation.
+    if (!Number.isInteger(length) || length < 6 || length > 64) {
+        throw new TypeError("short reference length must be an integer between 6 and 64");
+    }
+    return length;
+}
+function normalizedOperation(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return requireNonEmptyString(value, "session selector operation");
+}
+function requireNonEmptyString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new TypeError(`${label} must be a non-empty string`);
+    }
+    return value;
+}
+function operationSuffix(operation) {
+    return operation ? ` for ${operation}` : "";
+}
+function bounded(value, maximum) {
+    const normalized = value.replace(/\s+/gu, " ").trim();
+    return normalized.length <= maximum
+        ? normalized
+        : `${normalized.slice(0, maximum - 1)}…`;
+}
+function quote(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=session-selector.js.map

package/dist/src/session-selector.js.map

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

package/dist/src/terminal-process-source.d.ts

@@ -30,5 +30,9 @@ export declare class SystemTerminalProcessSource implements TerminalProcessSourc
     }): Promise<TerminalProcessSnapshot[]>;
 }
 export declare function parsePsProcessSnapshots(output: string): TerminalProcessSnapshot[];
+/**
+ * Parse `ps etime` (`[[DD-]HH:]MM:SS`) into elapsed seconds.
+ */
+export declare function parseProcessElapsedSeconds(value: unknown): number | undefined;
 export declare function parseLsofCwdMap(output: string): Map<number, string>;
 export declare function runProcessCommand(command: string, args: string[]): ProcessCommandResult;

package/dist/src/terminal-process-source.js

@@ -83,6 +83,26 @@ export function parsePsProcessSnapshots(output) {
         command: match[4]
     }));
 }
+/**
+ * Parse `ps etime` (`[[DD-]HH:]MM:SS`) into elapsed seconds.
+ */
+export function parseProcessElapsedSeconds(value) {
+    const match = /^(?:(\d+)-)?(?:(\d{1,2}):)?(\d{1,2}):(\d{2})$/u.exec(String(value ?? "").trim());
+    if (!match) {
+        return undefined;
+    }
+    const days = Number(match[1] ?? 0);
+    const hours = Number(match[2] ?? 0);
+    const minutes = Number(match[3]);
+    const seconds = Number(match[4]);
+    if (![days, hours, minutes, seconds].every(Number.isSafeInteger) ||
+        hours > 23 ||
+        minutes > 59 ||
+        seconds > 59) {
+        return undefined;
+    }
+    return (((days * 24 + hours) * 60 + minutes) * 60) + seconds;
+}
 export function parseLsofCwdMap(output) {
     const cwdByPid = new Map();
     for (const line of output.split(/\r?\n/).slice(1)) {

package/dist/src/terminal-process-source.js.map

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

package/docs/quickstart-managed-acpx.md

@@ -0,0 +1,43 @@
+# Managed ACPX in 5 Minutes
+
+Use this path for managed background Codex, Claude Code, or Cursor tasks with durable AKK state and callbacks. You need Node.js 24.15+ on the 24.x line, OpenClaw `2026.7.1-2`+, and an authenticated coding-agent CLI.
+
+## 1. Install and configure
+
+From the project the agent may edit:
+
+```bash
+npm install -g acpx@latest @scotthuang/agent-knock-knock@next && agent-knock-knock install-openclaw --workspace "$PWD" --default-agent codex --mode acpx --verify
+```
+
+Use `--default-agent claude` or `cursor` when preferred. Existing AKK approval policy remains intact, and the Gateway restarts at most once.
+
+## 2. Run doctor
+
+```bash
+agent-knock-knock doctor --mode acpx
+```
+
+Success means `readiness` is `ready`, ACPX and the selected agent CLI can return versions, the AKK runtime and skill are loaded, the workspace is canonical, and the Gateway is healthy. Doctor does not make a credentialed model call.
+
+## 3. Start one managed task
+
+From any configured OpenClaw channel:
+
+```text
+/akk codex inspect this repository and summarize it
+```
+
+Use `/akk claude ...` or `/akk cursor ...` to override the configured default.
+
+## 4. Continue it without copying an ID
+
+```text
+/akk send only: run the tests and explain any failures
+```
+
+`only` succeeds only when exactly one session is actionable. Otherwise AKK stops and lists stable short references instead of choosing a session.
+
+## Boundary and recovery
+
+Managed ACPX runs separately from the shared-terminal permission policy; tmux prompt inspection and AKK's exact-command `autoApprove` rules do not apply. Keep work inside the configured workspace. Use `/akk status only`, `/akk cancel only`, or `/akk recover only` when the task needs intervention.

package/docs/quickstart-tmux.md

@@ -0,0 +1,43 @@
+# tmux Bridge in 5 Minutes
+
+Use this path when you want OpenClaw and a human to share the same live Codex or Claude Code terminal. You need Node.js 24.15+ on the 24.x line, OpenClaw `2026.7.1-2`+, tmux, and an authenticated `codex` or `claude` CLI, all running as the same OS user.
+
+## 1. Install and configure
+
+From the project the agent may edit:
+
+```bash
+npm install -g @scotthuang/agent-knock-knock@next && agent-knock-knock install-openclaw --workspace "$PWD" --default-agent codex --mode tmux --verify
+```
+
+The installer updates only AKK's enabled flag, workspace, default agent, and mode. Existing plugin settings—including `autoApprove` rules—remain intact, and the Gateway restarts at most once.
+
+## 2. Run doctor
+
+```bash
+agent-knock-knock doctor --mode tmux
+```
+
+Success means `readiness` is `ready`, the selected CLI can return a version, the AKK runtime and skill are loaded, the workspace is canonical, and the Gateway is healthy. Doctor does not make a credentialed model call.
+
+## 3. Start the shared terminal
+
+```bash
+tmux new-session -s akk-work -c "$PWD" codex
+```
+
+Use `claude` instead of `codex` if that is your configured agent. Detach with `Ctrl-b`, then `d`.
+
+## 4. Send one chat command
+
+From any configured OpenClaw channel:
+
+```text
+/akk send codex: inspect this repository and summarize it
+```
+
+AKK must find exactly one actionable Codex target; otherwise it stops and shows candidate short references instead of guessing. Success returns a managed conversation while the same tmux pane remains available for takeover.
+
+## Boundary and recovery
+
+AKK keeps the coding agent's own permission mode. Trusted, exact `autoApprove` rules may approve a supported prompt; everything else remains manual. Reattach with `tmux attach -t akk-work`, inspect the terminal, and use `/akk status only` or `/akk recover only` if the managed turn needs recovery.

package/openclaw.plugin.json

@@ -1,14 +1,19 @@
 {
   "id": "agent-knock-knock",
   "name": "Agent Knock Knock",
-  "description": "Agent Knock Knock (AKK/akk) delegates OpenClaw coding work to local Codex, Claude, or Cursor agents. Use this plugin when the user says AKK, akk, Agent Knock Knock, asks to hand work to Codex, Claude, or Cursor, asks what agent tasks are running, asks what an AKK, Codex, or Claude session is about, sends a follow-up to an agent task, renews monitoring for a stalled terminal task, recovers an unavailable agent session, cancels a running agent task, or closes an agent task. Default delegation target comes from plugin config defaultAgent and falls back to Codex when unset; explicit user agent requests override it.",
+  "description": "Delegate OpenClaw coding tasks to local Codex, Claude Code, or Cursor agents, then take over the same live terminal session.",
+  "icon": "https://raw.githubusercontent.com/scotthuang/agent-knock-knock/main/docs/assets/agent-knock-knock-icon.png",
   "activation": {
-    "onStartup": true
+    "onStartup": true,
+    "onCommands": ["akk"]
   },
+  "commandAliases": [
+    {
+      "name": "akk",
+      "kind": "runtime-slash"
+    }
+  ],
   "contracts": {
-    "commands": [
-      "akk"
-    ],
     "tools": [
       "agent_knock_knock_delegate",
       "agent_knock_knock_list",
@@ -21,7 +26,6 @@
       "agent_knock_knock_recover",
       "agent_knock_knock_close",
       "agent_knock_knock_approve",
-      "agent_knock_knock_agent_discover",
       "agent_knock_knock_agent_takeover"
     ]
   },
@@ -59,13 +63,13 @@
     "agent_knock_knock_approve": {
       "optional": true
     },
-    "agent_knock_knock_agent_discover": {
-      "optional": true
-    },
     "agent_knock_knock_agent_takeover": {
       "optional": true
     }
   },
+  "skills": [
+    "templates/openclaw-skills/agent-knock-knock"
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -99,6 +103,11 @@
         "enum": ["claude", "codex", "cursor"],
         "description": "Default coding agent for unspecified AKK delegations. If unset, Agent Knock Knock falls back to codex."
       },
+      "mode": {
+        "type": "string",
+        "enum": ["tmux", "acpx", "all"],
+        "description": "Execution mode checked by /akk doctor. tmux shares live Codex or Claude terminals; acpx runs managed Codex, Claude, or Cursor tasks."
+      },
       "defaultClaudeSession": {
         "type": "string",
         "description": "Default Claude Code session name. claudeSession remains supported as a compatibility alias."
@@ -151,6 +160,10 @@
         "type": "string",
         "description": "Path to the OpenClaw CLI used by callback delivery. Defaults to PATH plus common user install locations."
       },
+      "codexHome": {
+        "type": "string",
+        "description": "Optional CODEX_HOME path used when resolving native Codex sessions for agent takeover."
+      },
       "callbackCommand": {
         "type": "string",
         "description": "Optional callback command template. {statePath} and {state_path} are replaced with the shell-quoted state path."

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@scotthuang/agent-knock-knock",
-  "version": "0.2.51",
-  "description": "Local-first OpenClaw orchestration for coding agents through shared tmux sessions or ACPX/ACP.",
+  "version": "0.3.0-beta.2",
+  "description": "Control local Codex and Claude Code from OpenClaw, take over the same live tmux session, and run managed ACP tasks through ACPX with Cursor support.",
   "license": "MIT",
   "type": "module",
   "homepage": "https://github.com/scotthuang/agent-knock-knock#readme",
@@ -29,9 +29,26 @@
     "extensions": [
       "./dist/src/openclaw-plugin.js"
     ],
+    "runtimeExtensions": [
+      "./dist/src/openclaw-plugin.js"
+    ],
+    "install": {
+      "clawhubSpec": "clawhub:@scotthuang/agent-knock-knock",
+      "npmSpec": "@scotthuang/agent-knock-knock",
+      "defaultChoice": "clawhub",
+      "minHostVersion": ">=2026.7.1-2"
+    },
     "compat": {
-      "pluginApi": ">=2026.3.24-beta.2",
-      "minGatewayVersion": "2026.3.24-beta.2"
+      "pluginApi": ">=2026.7.1-2",
+      "minGatewayVersion": "2026.7.1-2"
+    },
+    "build": {
+      "openclawVersion": "2026.7.1-2",
+      "pluginSdkVersion": "2026.7.1-2"
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
     }
   },
   "bin": {
@@ -41,6 +58,11 @@
     "dist/src",
     "templates",
     "docs/assets/agent-knock-knock-cover.jpg",
+    "docs/assets/agent-knock-knock-icon.png",
+    "docs/quickstart-managed-acpx.md",
+    "docs/quickstart-tmux.md",
+    "scripts/smoke-acpx.js",
+    "scripts/smoke-tmux.js",
     "openclaw.plugin.json",
     "README.md",
     "LICENSE",
@@ -55,6 +77,10 @@
     "prepack": "npm run build",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "npm run build && node --test dist/test/*.test.js",
+    "clawhub:validate": "npm run build && clawhub package validate . --out .clawhub-validation --openclaw node_modules/openclaw --runtime --allow-execute --no-mock-sdk",
+    "clawhub:dry-run": "npm run build && clawhub package publish . --family code-plugin --owner scotthuang --tags beta --dry-run",
+    "smoke:acpx": "npm run build && node scripts/smoke-acpx.js",
+    "smoke:tmux": "npm run build && node scripts/smoke-tmux.js",
     "simulate:architecture": "node scripts/two-claude-weather-test.js --scenario architecture-questions",
     "simulate:weather": "node scripts/two-claude-weather-test.js --scenario weather",
     "transcript": "node dist/src/cli.js transcript"
@@ -62,8 +88,18 @@
   "engines": {
     "node": ">=22.14.0"
   },
+  "peerDependencies": {
+    "openclaw": ">=2026.7.1-2"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^22.20.1",
+    "clawhub": "0.23.1",
+    "openclaw": "2026.7.1-2",
     "typescript": "^7.0.2"
   }
 }