@scotthuang/agent-knock-knock 0.11.6 → 0.12.0

package/dist/src/terminal-control-ref.js

@@ -0,0 +1,557 @@
+/**
+ * Provider-neutral terminal identity and routing primitives.
+ *
+ * Persisted/public terminal control records intentionally keep their current
+ * provider-owned shape. Generic lifecycle code must project those records
+ * through the helpers in this module instead of rebuilding identity from
+ * route fields such as a selector or socket path.
+ */
+const associatedEndpoints = new WeakMap();
+export function createTerminalEndpointRef(value) {
+    const terminal = {
+        identity: { ...value.identity },
+        route: { ...value.route },
+        processAnchorPid: value.processAnchorPid,
+        capabilities: [...value.capabilities],
+        providerRef: value.providerRef
+    };
+    if (isObject(value.providerRef)) {
+        associatedEndpoints.set(value.providerRef, terminal);
+    }
+    return terminal;
+}
+export function terminalEndpointFromControlRef(terminalControl) {
+    const associated = associatedEndpoints.get(terminalControl);
+    if (associated) {
+        return associated;
+    }
+    switch (terminalControl.kind) {
+        case "tmux": {
+            assertTmuxControlIdentity(terminalControl);
+            const endpointKey = terminalControl.socketPath
+                ? `socket:${terminalControl.socketPath}`
+                : "default-server-route";
+            const routeKey = tmuxTerminalRouteKey(endpointKey, terminalControl.target, terminalControl.socketPath);
+            return {
+                identity: {
+                    providerKind: "tmux",
+                    endpointKey,
+                    // Modern discovery reports tmux's stable pane id. Legacy persisted
+                    // refs deliberately retain their complete route+PID identity; a PID
+                    // alone is never sufficient because it can be reused.
+                    resourceKey: `legacy:${routeKey}:pane-pid:${terminalControl.panePid}`
+                },
+                route: {
+                    routeKey,
+                    label: terminalControl.target,
+                    currentCommand: terminalControl.currentCommand,
+                    currentPath: terminalControl.currentPath
+                },
+                processAnchorPid: terminalControl.panePid,
+                capabilities: [...terminalControl.capabilities],
+                providerRef: terminalControl
+            };
+        }
+        case "herdr": {
+            assertHerdrControlIdentity(terminalControl);
+            const endpointKey = `socket:${terminalControl.socketPath}`;
+            return {
+                identity: {
+                    providerKind: "herdr",
+                    endpointKey,
+                    resourceKey: `terminal-id:${terminalControl.terminalId}`
+                },
+                route: {
+                    routeKey: herdrTerminalRouteKey(endpointKey, terminalControl.session, terminalControl.paneId),
+                    label: terminalControl.target,
+                    currentCommand: terminalControl.currentCommand,
+                    currentPath: terminalControl.currentPath
+                },
+                processAnchorPid: terminalControl.panePid,
+                capabilities: [...terminalControl.capabilities],
+                providerRef: terminalControl
+            };
+        }
+    }
+}
+export function hasCanonicalTerminalEndpoint(terminalControl) {
+    if (associatedEndpoints.has(terminalControl)) {
+        return true;
+    }
+    if (terminalControl.kind !== "herdr") {
+        return false;
+    }
+    try {
+        terminalEndpointFromControlRef(terminalControl);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function terminalEndpointIdentityKey(value) {
+    const identity = isTerminalEndpointRef(value)
+        ? value.identity
+        : isTerminalEndpointIdentity(value)
+            ? value
+            : terminalEndpointFromControlRef(value).identity;
+    return JSON.stringify({
+        version: 1,
+        provider_kind: identity.providerKind,
+        endpoint_key: identity.endpointKey,
+        resource_key: identity.resourceKey
+    });
+}
+export function sameTerminalEndpointIdentity(left, right) {
+    return terminalEndpointIdentityKey(left) === terminalEndpointIdentityKey(right);
+}
+export function sameTerminalControlRoute(left, right) {
+    if (!isTerminalEndpointRef(left) &&
+        !isTerminalEndpointRef(right) &&
+        (!hasCanonicalTerminalEndpoint(left) || !hasCanonicalTerminalEndpoint(right))) {
+        return sameLegacyTerminalRoute(left, right);
+    }
+    if (!sameTerminalEndpointIdentity(left, right)) {
+        return false;
+    }
+    const leftRoute = isTerminalEndpointRef(left)
+        ? left.route.routeKey
+        : terminalEndpointFromControlRef(left).route.routeKey;
+    const rightRoute = isTerminalEndpointRef(right)
+        ? right.route.routeKey
+        : terminalEndpointFromControlRef(right).route.routeKey;
+    return leftRoute === rightRoute;
+}
+export function sameTerminalControlIncarnation(left, right) {
+    if (!isTerminalEndpointRef(left) &&
+        !isTerminalEndpointRef(right) &&
+        (!hasCanonicalTerminalEndpoint(left) || !hasCanonicalTerminalEndpoint(right))) {
+        return sameLegacyTerminalIncarnation(left, right);
+    }
+    const leftEndpoint = isTerminalEndpointRef(left)
+        ? left
+        : terminalEndpointFromControlRef(left);
+    const rightEndpoint = isTerminalEndpointRef(right)
+        ? right
+        : terminalEndpointFromControlRef(right);
+    return sameTerminalEndpointIdentity(leftEndpoint, rightEndpoint) &&
+        leftEndpoint.processAnchorPid === rightEndpoint.processAnchorPid;
+}
+export function terminalControlEvidence(terminalControl) {
+    const endpoint = terminalEndpointFromControlRef(terminalControl);
+    switch (terminalControl.kind) {
+        case "tmux":
+            return {
+                schema: "agent-knock-knock/terminal-endpoint",
+                version: 1,
+                kind: endpoint.identity.providerKind,
+                endpoint_key: endpoint.identity.endpointKey,
+                resource_key: endpoint.identity.resourceKey,
+                route_key: endpoint.route.routeKey,
+                process_anchor_pid: endpoint.processAnchorPid ?? null,
+                target: terminalControl.target,
+                socket_path: terminalControl.socketPath ?? null,
+                pane_pid: terminalControl.panePid ?? null,
+                server_socket_path: endpoint.identity.endpointKey.startsWith("socket:")
+                    ? endpoint.identity.endpointKey.slice("socket:".length)
+                    : null,
+                pane_id: endpoint.identity.resourceKey.startsWith("pane-id:")
+                    ? endpoint.identity.resourceKey.slice("pane-id:".length)
+                    : null,
+                current_path: terminalControl.currentPath ?? null
+            };
+        case "herdr":
+            return {
+                schema: "agent-knock-knock/terminal-endpoint",
+                version: 1,
+                kind: endpoint.identity.providerKind,
+                endpoint_key: endpoint.identity.endpointKey,
+                resource_key: endpoint.identity.resourceKey,
+                route_key: endpoint.route.routeKey,
+                process_anchor_pid: endpoint.processAnchorPid ?? null,
+                target: terminalControl.target,
+                socket_path: terminalControl.socketPath ?? null,
+                pane_pid: terminalControl.panePid,
+                server_socket_path: terminalControl.socketPath ?? null,
+                pane_id: terminalControl.paneId,
+                session_name: terminalControl.session,
+                session_dir: terminalControl.sessionDir ?? null,
+                workspace_id: terminalControl.workspaceId,
+                tab_id: terminalControl.tabId,
+                terminal_id: terminalControl.terminalId,
+                current_path: terminalControl.currentPath ?? null
+            };
+    }
+}
+/**
+ * Read canonical identity from a new evidence record or derive it from the
+ * exact v0.11.x tmux fields. Unknown/malformed evidence fails closed.
+ */
+export function terminalEndpointIdentityFromEvidence(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const providerKind = nonEmptyString(value.kind);
+    const endpointKey = nonEmptyString(value.endpoint_key);
+    const resourceKey = nonEmptyString(value.resource_key);
+    if (providerKind && endpointKey && resourceKey) {
+        if (providerKind === "tmux") {
+            const legacy = tmuxIdentityFromEvidence(value);
+            if (!legacy ||
+                legacy.identity.endpointKey !== endpointKey ||
+                legacy.identity.resourceKey !== resourceKey ||
+                (nonEmptyString(value.route_key) !== undefined &&
+                    nonEmptyString(value.route_key) !== legacy.routeKey)) {
+                return undefined;
+            }
+        }
+        else if (providerKind === "herdr") {
+            const herdr = herdrIdentityFromEvidence(value);
+            if (!herdr ||
+                herdr.identity.endpointKey !== endpointKey ||
+                herdr.identity.resourceKey !== resourceKey ||
+                (nonEmptyString(value.route_key) !== undefined &&
+                    nonEmptyString(value.route_key) !== herdr.routeKey)) {
+                return undefined;
+            }
+        }
+        else {
+            return undefined;
+        }
+        return { providerKind, endpointKey, resourceKey };
+    }
+    const legacy = tmuxIdentityFromEvidence(value);
+    const legacyKind = providerKind ?? (legacy ? "tmux" : undefined);
+    if (legacyKind !== "tmux" || !legacy) {
+        return undefined;
+    }
+    return legacy.identity;
+}
+export function terminalRouteKeyFromEvidence(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const canonical = nonEmptyString(value.route_key);
+    if (canonical) {
+        const derived = value.kind === "herdr"
+            ? herdrIdentityFromEvidence(value)
+            : tmuxIdentityFromEvidence(value);
+        if (derived?.routeKey !== canonical) {
+            return undefined;
+        }
+        return canonical;
+    }
+    return tmuxIdentityFromEvidence(value)?.routeKey;
+}
+export function terminalControlEvidenceMatches(evidence, terminalControl, options = {}) {
+    if (!hasCanonicalEvidence(evidence)) {
+        const legacy = legacyTerminalEvidence(evidence);
+        if (!legacy ||
+            (options.requireProcessAnchor === false
+                ? !sameLegacyTerminalRoute(legacy, terminalControl)
+                : !sameLegacyTerminalIncarnation(legacy, terminalControl))) {
+            return false;
+        }
+        return options.requireCurrentRoute !== true ||
+            sameLegacyTerminalRoute(legacy, terminalControl);
+    }
+    const evidenceIdentity = terminalEndpointIdentityFromEvidence(evidence);
+    if (!evidenceIdentity ||
+        !sameTerminalEndpointIdentity(evidenceIdentity, terminalControl)) {
+        return false;
+    }
+    const endpoint = terminalEndpointFromControlRef(terminalControl);
+    const evidenceAnchor = isRecord(evidence)
+        ? positiveInteger(evidence.process_anchor_pid ?? evidence.pane_pid ?? evidence.panePid)
+        : undefined;
+    if (options.requireProcessAnchor !== false &&
+        evidenceAnchor !== undefined &&
+        endpoint.processAnchorPid !== evidenceAnchor) {
+        return false;
+    }
+    if (options.requireCurrentRoute === true) {
+        return terminalRouteKeyFromEvidence(evidence) ===
+            endpoint.route.routeKey;
+    }
+    return true;
+}
+export function sameTerminalControlEvidenceIncarnation(left, right) {
+    if (hasCanonicalEvidence(left) && hasCanonicalEvidence(right)) {
+        const leftIdentity = terminalEndpointIdentityFromEvidence(left);
+        const rightIdentity = terminalEndpointIdentityFromEvidence(right);
+        const leftAnchor = isRecord(left)
+            ? positiveInteger(left.process_anchor_pid ?? left.pane_pid ?? left.panePid)
+            : undefined;
+        const rightAnchor = isRecord(right)
+            ? positiveInteger(right.process_anchor_pid ?? right.pane_pid ?? right.panePid)
+            : undefined;
+        return Boolean(leftIdentity &&
+            rightIdentity &&
+            leftAnchor !== undefined &&
+            leftAnchor === rightAnchor &&
+            sameTerminalEndpointIdentity(leftIdentity, rightIdentity));
+    }
+    const leftLegacy = legacyTerminalEvidence(left);
+    const rightLegacy = legacyTerminalEvidence(right);
+    return Boolean(leftLegacy &&
+        rightLegacy &&
+        sameLegacyTerminalIncarnation(leftLegacy, rightLegacy));
+}
+/**
+ * Restore a persisted additive endpoint record onto its legacy public control
+ * ref. The association is deliberately non-enumerable and never rewrites the
+ * Store object. Conflicting canonical and legacy fields fail closed.
+ */
+export function associateTerminalEndpointEvidence(terminalControl, evidence) {
+    if (!hasCanonicalEvidence(evidence) || !isRecord(evidence)) {
+        throw new Error("terminal endpoint evidence is not canonical");
+    }
+    const identity = terminalEndpointIdentityFromEvidence(evidence);
+    const routeKey = terminalRouteKeyFromEvidence(evidence);
+    if (terminalControl.kind === "herdr") {
+        const endpoint = terminalEndpointFromControlRef(terminalControl);
+        if (!identity ||
+            !routeKey ||
+            !sameTerminalEndpointIdentity(identity, endpoint) ||
+            routeKey !== endpoint.route.routeKey ||
+            positiveInteger(evidence.process_anchor_pid ?? evidence.pane_pid) !==
+                endpoint.processAnchorPid) {
+            throw new Error("terminal endpoint evidence conflicts with its Herdr control reference");
+        }
+        createTerminalEndpointRef({
+            identity,
+            route: {
+                routeKey,
+                label: terminalControl.target,
+                currentCommand: terminalControl.currentCommand,
+                currentPath: nonEmptyString(evidence.current_path) ??
+                    terminalControl.currentPath
+            },
+            processAnchorPid: endpoint.processAnchorPid,
+            capabilities: terminalControl.capabilities,
+            providerRef: terminalControl
+        });
+        return terminalControl;
+    }
+    const legacy = legacyTerminalEvidence(evidence);
+    if (!identity ||
+        !routeKey ||
+        !legacy ||
+        !sameLegacyTerminalIncarnation(legacy, terminalControl)) {
+        throw new Error("terminal endpoint evidence conflicts with its legacy control reference");
+    }
+    createTerminalEndpointRef({
+        identity,
+        route: {
+            routeKey,
+            label: terminalControl.target,
+            currentCommand: terminalControl.currentCommand,
+            currentPath: nonEmptyString(evidence.current_path) ??
+                terminalControl.currentPath
+        },
+        processAnchorPid: positiveInteger(evidence.process_anchor_pid ?? evidence.pane_pid),
+        capabilities: terminalControl.capabilities,
+        providerRef: terminalControl
+    });
+    return terminalControl;
+}
+/** Exact v0.11.x selector/incarnation tuple for compatibility artifacts. */
+export function terminalLegacyControlEvidence(terminalControl) {
+    return {
+        kind: terminalControl.kind,
+        target: terminalControl.target,
+        socket_path: terminalControl.socketPath ?? null,
+        pane_pid: terminalControl.panePid
+    };
+}
+/** Exact legacy runtime route serialized by v0.11.x ledgers and locks. */
+export function terminalLegacyRuntimeRoute(terminalControl) {
+    if (terminalControl.kind === "herdr") {
+        return {
+            kind: "herdr",
+            target: terminalControl.target,
+            socket_path: terminalControl.socketPath ?? null
+        };
+    }
+    return {
+        target: terminalControl.target,
+        socket_path: terminalControl.socketPath ?? null
+    };
+}
+export function terminalControlWithCapabilities(terminalControl, capabilities) {
+    const next = {
+        ...terminalControl,
+        capabilities: [...capabilities]
+    };
+    const endpoint = associatedEndpoints.get(terminalControl);
+    if (endpoint) {
+        createTerminalEndpointRef({
+            ...endpoint,
+            capabilities,
+            providerRef: next
+        });
+    }
+    return next;
+}
+export function tmuxTerminalRouteKey(endpointKey, target, socketPath) {
+    return JSON.stringify({
+        provider_kind: "tmux",
+        endpoint_key: endpointKey,
+        target,
+        socket_path: socketPath ?? null
+    });
+}
+export function herdrTerminalRouteKey(endpointKey, session, paneId) {
+    return JSON.stringify({
+        provider_kind: "herdr",
+        endpoint_key: endpointKey,
+        session,
+        pane_id: paneId
+    });
+}
+function tmuxIdentityFromEvidence(value) {
+    const target = nonEmptyString(value.target);
+    const panePid = positiveInteger(value.pane_pid ?? value.panePid);
+    const processAnchorPid = positiveInteger(value.process_anchor_pid);
+    if (!target ||
+        panePid === undefined ||
+        (processAnchorPid !== undefined && processAnchorPid !== panePid)) {
+        return undefined;
+    }
+    const socketPath = nonEmptyString(value.socket_path ?? value.socketPath);
+    const serverSocketPath = nonEmptyString(value.server_socket_path ?? value.serverSocketPath);
+    const paneId = nonEmptyString(value.pane_id ?? value.paneId);
+    const endpointKey = serverSocketPath
+        ? `socket:${serverSocketPath}`
+        : socketPath
+            ? `socket:${socketPath}`
+            : "default-server-route";
+    const routeKey = tmuxTerminalRouteKey(endpointKey, target, socketPath);
+    return {
+        identity: {
+            providerKind: "tmux",
+            endpointKey,
+            resourceKey: paneId
+                ? `pane-id:${paneId}`
+                : `legacy:${routeKey}:pane-pid:${panePid}`
+        },
+        routeKey
+    };
+}
+function herdrIdentityFromEvidence(value) {
+    const socketPath = nonEmptyString(value.server_socket_path ?? value.socket_path ?? value.socketPath);
+    const session = nonEmptyString(value.session_name ?? value.session);
+    const paneId = nonEmptyString(value.pane_id ?? value.paneId);
+    const terminalId = nonEmptyString(value.terminal_id ?? value.terminalId);
+    const panePid = positiveInteger(value.pane_pid ?? value.panePid);
+    const processAnchorPid = positiveInteger(value.process_anchor_pid);
+    if (!socketPath ||
+        !session ||
+        !paneId ||
+        !terminalId ||
+        panePid === undefined ||
+        (processAnchorPid !== undefined && processAnchorPid !== panePid)) {
+        return undefined;
+    }
+    const endpointKey = `socket:${socketPath}`;
+    return {
+        identity: {
+            providerKind: "herdr",
+            endpointKey,
+            resourceKey: `terminal-id:${terminalId}`
+        },
+        routeKey: herdrTerminalRouteKey(endpointKey, session, paneId)
+    };
+}
+function hasCanonicalEvidence(value) {
+    return isRecord(value) &&
+        value.schema === "agent-knock-knock/terminal-endpoint" &&
+        value.version === 1 &&
+        Boolean(nonEmptyString(value.kind)) &&
+        Boolean(nonEmptyString(value.endpoint_key)) &&
+        Boolean(nonEmptyString(value.resource_key)) &&
+        Boolean(nonEmptyString(value.route_key)) &&
+        Object.prototype.hasOwnProperty.call(value, "process_anchor_pid") &&
+        (value.process_anchor_pid === null ||
+            positiveInteger(value.process_anchor_pid) !== undefined);
+}
+function legacyTerminalEvidence(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const target = nonEmptyString(value.target);
+    const panePid = positiveInteger(value.pane_pid ?? value.panePid);
+    if (!target || panePid === undefined) {
+        return undefined;
+    }
+    const [session = target, route = "0.0"] = target.split(":", 2);
+    const [windowText = "0", paneText = "0"] = route.split(".", 2);
+    return {
+        kind: "tmux",
+        target,
+        socketPath: nonEmptyString(value.socket_path ?? value.socketPath),
+        session,
+        window: Number.parseInt(windowText, 10) || 0,
+        pane: Number.parseInt(paneText, 10) || 0,
+        panePid,
+        capabilities: []
+    };
+}
+function sameLegacyTerminalRoute(left, right) {
+    return left.kind === right.kind &&
+        left.target === right.target &&
+        left.socketPath === right.socketPath;
+}
+function sameLegacyTerminalIncarnation(left, right) {
+    return sameLegacyTerminalRoute(left, right) &&
+        left.panePid === right.panePid;
+}
+function assertTmuxControlIdentity(value) {
+    if (!value.target ||
+        !Number.isSafeInteger(value.panePid) ||
+        value.panePid <= 0) {
+        throw new Error("tmux terminal control requires a target and positive pane PID");
+    }
+}
+function assertHerdrControlIdentity(value) {
+    if (!value.target ||
+        !value.socketPath ||
+        !value.session ||
+        !value.workspaceId ||
+        !value.tabId ||
+        !value.paneId ||
+        !value.terminalId ||
+        !Number.isSafeInteger(value.panePid) ||
+        value.panePid <= 0) {
+        throw new Error("Herdr terminal control requires a session socket, stable terminal ID, " +
+            "current pane route, and positive shell PID");
+    }
+}
+function isTerminalEndpointRef(value) {
+    return isRecord(value) &&
+        isTerminalEndpointIdentity(value.identity) &&
+        isRecord(value.route) &&
+        typeof value.route.routeKey === "string";
+}
+function isTerminalEndpointIdentity(value) {
+    return isRecord(value) &&
+        Boolean(nonEmptyString(value.providerKind)) &&
+        Boolean(nonEmptyString(value.endpointKey)) &&
+        Boolean(nonEmptyString(value.resourceKey));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isObject(value) {
+    return value !== null && typeof value === "object";
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0
+        ? value
+        : undefined;
+}
+function positiveInteger(value) {
+    const parsed = Number(value);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : undefined;
+}
+//# sourceMappingURL=terminal-control-ref.js.map

package/dist/src/terminal-control-ref.js.map

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

package/docs/quickstart-herdr.md

@@ -0,0 +1,37 @@
+# Quick Start with Herdr
+
+AKK supports local Herdr `0.8.0` (socket protocol 19) as a terminal provider alongside tmux. AKK does not start Herdr or a coding agent.
+
+Install and open Herdr, then start Codex or Claude Code in a pane:
+
+```bash
+brew install herdr
+herdr
+```
+
+Inside a Herdr pane, run one of:
+
+```bash
+codex --yolo
+# or
+claude
+```
+
+Wait for the empty idle composer. After the AKK OpenClaw plugin is installed and its Gateway restarted, use:
+
+```text
+/akk list
+/akk inspect this repository and summarize it
+```
+
+AKK enumerates every running local Herdr session, identifies a terminal by its session socket plus stable `terminal_id`, and treats the current `pane_id` only as a refreshable route. Moving a live pane does not silently rebind ownership. Every side effect revalidates the terminal resource, shell PID, agent PID, cwd, native-session evidence, and current composer first.
+
+Herdr's raw `pane send-text` command is not used for task delivery. AKK uses the Unix-socket `pane.send_input` method so multiline text follows Herdr's bracketed-paste-aware path, persists the text-injected stage, resolves the stable terminal again, and then dispatches one separate Enter.
+
+Current boundary:
+
+- local Unix-domain sockets only;
+- exact Herdr `0.8.0`, protocol 19;
+- Codex and Claude Code versions listed in the main compatibility matrix;
+- remote/SSH Herdr sessions and Windows named pipes are not yet supported;
+- Herdr's agent status is diagnostic only—AKK's existing screen, transcript, rollout, and native identity fences remain authoritative.

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "agent-knock-knock",
   "name": "Agent Knock Knock",
-  "description": "Control local Codex and Claude Code through shared tmux terminals, with exact-version native status inspection, native-thread lifecycle controls, live monitoring, approvals, and human takeover.",
+  "description": "Control local Codex and Claude Code through shared tmux or Herdr terminals, with exact-version native status inspection, native-thread lifecycle controls, live monitoring, approvals, and human takeover.",
   "icon": "https://raw.githubusercontent.com/scotthuang/agent-knock-knock/main/docs/assets/agent-knock-knock-icon.png",
   "activation": {
     "onStartup": true,
@@ -92,7 +92,7 @@
       },
       "codexHome": {
         "type": "string",
-        "description": "Optional CODEX_HOME path used to correlate Codex session metadata with eligible tmux terminals."
+        "description": "Optional CODEX_HOME path used to correlate Codex session metadata with eligible terminal panes."
       },
       "idleTimeoutMinutes": {
         "type": "number",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@scotthuang/agent-knock-knock",
-  "version": "0.11.6",
-  "description": "Control local Codex and Claude Code from OpenClaw through shared tmux terminals, with seamless human-agent handoff.",
+  "version": "0.12.0",
+  "description": "Control local Codex and Claude Code from OpenClaw through shared tmux or Herdr terminals, with seamless human-agent handoff.",
   "license": "MIT",
   "type": "module",
   "homepage": "https://github.com/scotthuang/agent-knock-knock#readme",
@@ -58,6 +58,7 @@
     "templates",
     "docs/assets/agent-knock-knock-cover.jpg",
     "docs/assets/agent-knock-knock-icon.png",
+    "docs/quickstart-herdr.md",
     "docs/quickstart-tmux.md",
     "openclaw.plugin.json",
     "README.md",
@@ -76,6 +77,7 @@
     "test:fast": "npm run build && node scripts/run-test-tier.js fast",
     "test:integration": "npm run build && node scripts/run-test-tier.js integration",
     "test:full": "npm run build && node scripts/run-test-tier.js full",
+    "test:affected": "npm run build && node scripts/run-affected-tests.js",
     "test:profile": "npm run build && node scripts/profile-test-tier.js",
     "test:release": "node scripts/run-release-tests.js",
     "test:release:live": "node scripts/run-release-tests.js --live",