@scotthuang/agent-knock-knock 0.14.2 → 0.14.3

package/dist/src/claude-native-client.js

@@ -0,0 +1,197 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { randomUUID } from "node:crypto";
+import { CLAUDE_NATIVE_PEER_HELPER } from "./claude-native-peer-helper.js";
+import { discoverClaudeNativeSessions, inspectClaudeNativeSession } from "./claude-native-discovery.js";
+import { ClaudeNativeError, createClaudeNativeConversationId, isClaudeNativeUuid } from "./claude-native-identity.js";
+/** Parent AKK process owns the helper; the actual writer owns its native reply socket. */
+class MacPeerTransport {
+    options;
+    child;
+    starting;
+    closed = false;
+    pending = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    get senderPid() { return this.child?.pid; }
+    async start() {
+        if (this.closed)
+            throw new ClaudeNativeError("client_closed", "Claude native client is closed");
+        if (this.starting)
+            return this.starting;
+        this.starting = new Promise((resolve, reject) => {
+            const child = spawn(this.options.pythonPath ?? "python3", ["-I", "-u", "-c", CLAUDE_NATIVE_PEER_HELPER], { stdio: ["pipe", "pipe", "pipe"], env: { PATH: process.env.PATH, LANG: process.env.LANG,
+                    LC_ALL: process.env.LC_ALL, PYTHONIOENCODING: "utf-8" } });
+            this.child = child;
+            child.stdin.on("error", () => this.failPending());
+            const timer = setTimeout(() => { child.kill(); reject(new ClaudeNativeError("peer_helper_unavailable", "Claude peer credential helper did not start")); }, 3000);
+            const lines = createInterface({ input: child.stdout });
+            lines.on("line", line => {
+                if (line.length > 65536)
+                    return;
+                let value;
+                try {
+                    value = JSON.parse(line);
+                }
+                catch {
+                    return;
+                }
+                if (value.ready === true && value.pid === child.pid) {
+                    clearTimeout(timer);
+                    resolve();
+                    return;
+                }
+                if (value.event === "notice") {
+                    try {
+                        this.options.onNotice?.(value);
+                    }
+                    catch { /* Observer failures never retry input. */ }
+                    return;
+                }
+                const request = this.pending.get(value.id);
+                if (!request)
+                    return;
+                clearTimeout(request.timer);
+                this.pending.delete(value.id);
+                const r = value.result;
+                request.resolve(r && ["written", "not_sent", "uncertain"].includes(r.dispatchState)
+                    ? { ...r, ...(request.action === "send" ? { senderPid: child.pid } : {}) }
+                    : { dispatchState: request.action === "send" ? "uncertain" : "not_sent", errorCode: "invalid_peer_response",
+                        ...(request.action === "send" ? { senderPid: child.pid } : {}) });
+            });
+            child.stderr.resume();
+            child.once("error", () => { clearTimeout(timer); reject(new ClaudeNativeError("peer_helper_unavailable", "Python 3 is required for native macOS peer identity verification")); this.failPending(); });
+            child.once("exit", () => { clearTimeout(timer); reject(new ClaudeNativeError("peer_helper_exited", "Claude peer credential helper exited")); this.failPending(); this.closed = true; });
+        });
+        return this.starting;
+    }
+    failPending() {
+        for (const p of this.pending.values()) {
+            clearTimeout(p.timer);
+            p.resolve({ dispatchState: p.action === "send" ? "uncertain" : "not_sent", errorCode: "peer_helper_exited",
+                ...(p.action === "send" ? { senderPid: this.child?.pid } : {}) });
+        }
+        this.pending.clear();
+    }
+    async request(action, entry, input = {}) {
+        await this.start();
+        return new Promise(resolve => {
+            const id = randomUUID(), timer = setTimeout(() => {
+                this.pending.delete(id);
+                resolve({ dispatchState: action === "send" ? "uncertain" : "not_sent", errorCode: "peer_timeout",
+                    ...(action === "send" ? { senderPid: this.child?.pid } : {}) });
+            }, this.options.timeoutMs ?? 5000);
+            this.pending.set(id, { resolve, timer, action });
+            this.child.stdin.write(JSON.stringify({ id, action, entry, ...input }) + "\n", error => {
+                if (!error || !this.pending.has(id))
+                    return;
+                clearTimeout(timer);
+                this.pending.delete(id);
+                resolve({ dispatchState: action === "send" ? "uncertain" : "not_sent", errorCode: "peer_write_failed",
+                    ...(action === "send" ? { senderPid: this.child?.pid } : {}) });
+            });
+        });
+    }
+    async probe(entry) {
+        const result = await this.request("probe", entry);
+        if (result.errorCode)
+            throw new ClaudeNativeError(result.errorCode, "Claude native socket identity could not be verified");
+    }
+    async send(entry, input) {
+        try {
+            await this.start();
+        }
+        catch (error) {
+            return { dispatchState: "not_sent",
+                errorCode: error instanceof ClaudeNativeError ? error.code : "peer_helper_unavailable" };
+        }
+        return this.request("send", entry, input);
+    }
+    close() {
+        this.closed = true;
+        this.failPending();
+        this.child?.stdin.end();
+        const child = this.child;
+        if (child) {
+            const timer = setTimeout(() => { if (child.exitCode === null)
+                child.kill(); }, 2000);
+            timer.unref();
+        }
+    }
+}
+export class ClaudeNativeClient {
+    options;
+    peer;
+    closed = false;
+    inFlight = new Set();
+    constructor(options = {}) {
+        this.options = options;
+        this.peer = options.peerTransport ?? new MacPeerTransport(options);
+    }
+    get senderPid() { return this.peer.senderPid; }
+    async discover() {
+        this.assertOpen();
+        const found = await (this.options.discoverSessions?.() ?? discoverClaudeNativeSessions(this.options));
+        const sessions = [], errors = [...found.errors];
+        for (const entry of found.sessions) {
+            try {
+                await this.peer.probe(entry);
+                sessions.push(entry);
+            }
+            catch (error) {
+                errors.push({ configDir: entry.configDir,
+                    code: error instanceof ClaudeNativeError ? error.code : "peer_unavailable" });
+            }
+        }
+        return { sessions, errors };
+    }
+    async inspect(identity) {
+        this.assertOpen();
+        if ((this.options.platform ?? process.platform) !== "darwin")
+            throw new ClaudeNativeError("unsupported_platform", "Claude native peer verification is currently validated on macOS only");
+        const entry = await (this.options.inspectSession?.(identity) ?? inspectClaudeNativeSession(identity, this.options));
+        if (entry.nativeId !== createClaudeNativeConversationId(identity)
+            || createClaudeNativeConversationId(entry) !== entry.nativeId) {
+            throw new ClaudeNativeError("identity_changed", "Claude native inspection returned a different process/session");
+        }
+        await this.peer.probe(entry);
+        return entry;
+    }
+    async send(identity, input) {
+        this.assertOpen();
+        if (typeof input.text !== "string" || !input.text.trim() || Buffer.byteLength(input.text) > 256 * 1024
+            || !isClaudeNativeUuid(input.inputUuid) || !isClaudeNativeUuid(input.messageId))
+            throw new ClaudeNativeError("invalid_input", "Claude native message requires bounded text and UUID identifiers");
+        const key = `${identity.configDir}:${identity.pid}:${identity.processStart}:${identity.sessionId}`;
+        if (this.inFlight.has(key))
+            return { dispatchState: "not_sent", errorCode: "send_in_flight" };
+        this.inFlight.add(key);
+        let dispatchAttempted = false;
+        try {
+            let entry = await this.inspect(identity);
+            if (entry.status !== "idle")
+                return { dispatchState: "not_sent", errorCode: "session_not_idle" };
+            await input.beforeDispatch?.(entry, this.peer.senderPid);
+            entry = await this.inspect(identity);
+            if (entry.status !== "idle")
+                return { dispatchState: "not_sent", errorCode: "session_not_idle" };
+            dispatchAttempted = true;
+            const result = await this.peer.send(entry, input);
+            return { ...result, ...(this.peer.senderPid === undefined ? {} : { senderPid: this.peer.senderPid }) };
+        }
+        catch (error) {
+            return { dispatchState: dispatchAttempted ? "uncertain" : "not_sent",
+                errorCode: error instanceof ClaudeNativeError ? error.code : "native_unavailable",
+                ...(dispatchAttempted && this.peer.senderPid !== undefined ? { senderPid: this.peer.senderPid } : {}) };
+        }
+        finally {
+            this.inFlight.delete(key);
+        }
+    }
+    close() { this.closed = true; this.peer.close(); }
+    assertOpen() { if (this.closed)
+        throw new ClaudeNativeError("client_closed", "Claude native client is closed"); }
+}
+export function createClaudeNativeClient(options = {}) { return new ClaudeNativeClient(options); }
+//# sourceMappingURL=claude-native-client.js.map

package/dist/src/claude-native-client.js.map

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

package/dist/src/claude-native-discovery.d.ts

@@ -0,0 +1,20 @@
+import { type ClaudeNativeCatalogEntry, type ClaudeNativeIdentity } from "./claude-native-identity.js";
+export interface ClaudeNativeDiscoveryOptions {
+    configDirs?: string[];
+    claudePath?: string;
+    platform?: NodeJS.Platform;
+    /** Test seam: command output must retain the real agents/registry contract. */
+    run?: (file: string, args: string[], env?: NodeJS.ProcessEnv) => Promise<string>;
+}
+export interface ClaudeNativeDiscoveryResult {
+    sessions: ClaudeNativeCatalogEntry[];
+    errors: Array<{
+        configDir: string;
+        code: string;
+    }>;
+}
+export declare function runClaudeNativeCommand(file: string, args: string[], env?: NodeJS.ProcessEnv): Promise<string>;
+export declare function readClaudeNativeRegistry(configDir: string, pid: number): Promise<Record<string, unknown>>;
+export declare function validateClaudeNativeRegistry(configDir: string, row: Record<string, unknown>, options?: ClaudeNativeDiscoveryOptions): Promise<ClaudeNativeCatalogEntry>;
+export declare function discoverClaudeNativeSessions(options?: ClaudeNativeDiscoveryOptions): Promise<ClaudeNativeDiscoveryResult>;
+export declare function inspectClaudeNativeSession(identity: ClaudeNativeIdentity, options?: ClaudeNativeDiscoveryOptions): Promise<ClaudeNativeCatalogEntry>;

package/dist/src/claude-native-discovery.js

@@ -0,0 +1,111 @@
+import { execFile as execFileCallback } from "node:child_process";
+import { lstat, readFile, realpath } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+import { ClaudeNativeError, createClaudeNativeConversationId, validateClaudeNativeIdentity } from "./claude-native-identity.js";
+const execFile = promisify(execFileCallback);
+export async function runClaudeNativeCommand(file, args, env) {
+    const result = await execFile(file, args, { env, timeout: 10_000, maxBuffer: 2 * 1024 * 1024, encoding: "utf8" });
+    return result.stdout;
+}
+function record(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new ClaudeNativeError("invalid_registry", "Invalid native session metadata");
+    return value;
+}
+function absolute(value) {
+    return typeof value === "string" && path.isAbsolute(value) && value.length <= 4096 && !/[\u0000-\u001f\u007f]/u.test(value);
+}
+async function owned(p, kind) {
+    const s = await lstat(p);
+    if (s.uid !== process.getuid?.() || (s.mode & 0o022) !== 0 || s.isSymbolicLink()
+        || !(kind === "file" ? s.isFile() : kind === "socket" ? s.isSocket() : s.isDirectory())) {
+        throw new ClaudeNativeError("unsafe_metadata", "Claude native metadata or socket ownership is unsafe");
+    }
+    return s;
+}
+export async function readClaudeNativeRegistry(configDir, pid) {
+    if (!Number.isSafeInteger(pid) || pid < 1)
+        throw new ClaudeNativeError("invalid_identity", "Invalid native PID");
+    await owned(configDir, "directory");
+    await owned(path.join(configDir, "sessions"), "directory");
+    const file = path.join(configDir, "sessions", `${pid}.json`), stat = await owned(file, "file");
+    if (stat.size > 64 * 1024)
+        throw new ClaudeNativeError("invalid_registry", "Native registry entry exceeds limit");
+    return record(JSON.parse(await readFile(file, "utf8")));
+}
+/** The agent-list row and owned registry must describe the same supported inbox. */
+function catalogFields(m, row, identity) {
+    if (m.pid !== identity.pid || row.pid !== identity.pid || row.sessionId !== identity.sessionId || row.kind !== "interactive"
+        || !absolute(m.cwd) || row.cwd !== m.cwd || typeof m.version !== "string" || !/^\d+\.\d+\.\d+(?:[-+][\w.-]+)?$/u.test(m.version)
+        || m.peerProtocol !== 1 || !Array.isArray(m.peerFeatures) || !m.peerFeatures.every(x => typeof x === "string")
+        || !absolute(m.messagingSocketPath) || path.basename(m.messagingSocketPath) !== `${identity.pid}.sock`) {
+        throw new ClaudeNativeError("unsupported_contract", "Claude native registry and agent list do not prove a supported live identity");
+    }
+    return { cwd: m.cwd, version: m.version, socketPath: m.messagingSocketPath,
+        peerProtocol: 1, peerFeatures: m.peerFeatures };
+}
+export async function validateClaudeNativeRegistry(configDir, row, options = {}) {
+    const pid = Number(row.pid), m = await readClaudeNativeRegistry(configDir, pid);
+    const processStart = typeof m.procStart === "string" ? m.procStart.trim().replace(/\s+/gu, " ") : "";
+    const identity = validateClaudeNativeIdentity({ configDir, sessionId: String(m.sessionId), pid, processStart });
+    const fields = catalogFields(m, row, identity);
+    const run = options.run ?? runClaudeNativeCommand;
+    const processInfo = (await run("/bin/ps", ["-p", String(pid), "-o", "uid=", "-o", "lstart="], { ...process.env, LC_ALL: "C", TZ: "UTC" })).trim().replace(/\s+/gu, " ");
+    if (processInfo !== `${process.getuid?.()} ${processStart}`)
+        throw new ClaudeNativeError("process_changed", "Claude process identity changed");
+    const socketPath = fields.socketPath;
+    await owned(await realpath(path.dirname(socketPath)), "directory");
+    await owned(socketPath, "socket");
+    const statusMap = { idle: "idle", busy: "working", waiting: "waiting" };
+    // Both sources must agree. Unknown or racing state remains observable, never sendable.
+    const status = m.status === row.status && typeof m.status === "string"
+        ? statusMap[m.status] ?? "unknown" : "unknown";
+    return { ...identity, ...fields, nativeId: createClaudeNativeConversationId(identity),
+        ...(typeof row.name === "string" ? { name: row.name.slice(0, 512) } : {}), status,
+        ...(typeof row.waitingFor === "string" ? { waitingFor: row.waitingFor.slice(0, 256) } : {}), observedAt: new Date().toISOString() };
+}
+export async function discoverClaudeNativeSessions(options = {}) {
+    const errors = [], sessions = [];
+    const configDirs = [...new Set(options.configDirs ?? [process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude")])];
+    if ((options.platform ?? process.platform) !== "darwin")
+        return { sessions, errors: [{ configDir: "", code: "unsupported_platform" }] };
+    const run = options.run ?? runClaudeNativeCommand;
+    for (const configured of configDirs.slice(0, 16)) {
+        let configDir = path.resolve(configured);
+        try {
+            configDir = await realpath(configDir);
+            const raw = JSON.parse(await run(options.claudePath ?? "claude", ["agents", "--json", "--all"], { ...process.env, CLAUDE_CONFIG_DIR: configDir }));
+            if (!Array.isArray(raw) || raw.length > 4096)
+                throw new ClaudeNativeError("invalid_agent_list", "Invalid Claude agents list");
+            for (const value of raw) {
+                const row = record(value);
+                if (row.kind !== "interactive")
+                    continue;
+                try {
+                    const entry = await validateClaudeNativeRegistry(configDir, row, options);
+                    if (sessions.some(s => s.nativeId === entry.nativeId))
+                        throw new ClaudeNativeError("duplicate_identity", "Duplicate native agent identity");
+                    sessions.push(entry);
+                }
+                catch (error) {
+                    errors.push({ configDir, code: error instanceof ClaudeNativeError ? error.code : "registry_unavailable" });
+                }
+            }
+        }
+        catch (error) {
+            errors.push({ configDir, code: error instanceof ClaudeNativeError ? error.code : "discovery_unavailable" });
+        }
+    }
+    return { sessions, errors };
+}
+export async function inspectClaudeNativeSession(identity, options = {}) {
+    const wanted = validateClaudeNativeIdentity(identity);
+    const result = await discoverClaudeNativeSessions({ ...options, configDirs: [wanted.configDir] });
+    const found = result.sessions.find(s => s.nativeId === createClaudeNativeConversationId(wanted));
+    if (!found)
+        throw new ClaudeNativeError("identity_unavailable", "Exact Claude CLI process/session is no longer available");
+    return found;
+}
+//# sourceMappingURL=claude-native-discovery.js.map

package/dist/src/claude-native-discovery.js.map

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

package/dist/src/claude-native-identity.d.ts

@@ -0,0 +1,29 @@
+export interface ClaudeNativeIdentity {
+    configDir: string;
+    sessionId: string;
+    pid: number;
+    /** Native registry/OS `LC_ALL=C TZ=UTC ps lstart` value, whitespace normalized. */
+    processStart: string;
+}
+export interface ClaudeNativeCatalogEntry extends ClaudeNativeIdentity {
+    nativeId: string;
+    cwd: string;
+    name?: string;
+    version: string;
+    socketPath: string;
+    peerProtocol: number;
+    peerFeatures: string[];
+    status: "idle" | "working" | "waiting" | "unknown";
+    waitingFor?: string;
+    observedAt: string;
+}
+export declare class ClaudeNativeError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function isClaudeNativeUuid(value: unknown): value is string;
+export declare function validateClaudeNativeIdentity(value: ClaudeNativeIdentity): ClaudeNativeIdentity;
+export declare function createClaudeNativeConversationId(value: ClaudeNativeIdentity): string;
+export declare function isClaudeNativeConversationId(value: unknown): value is string;
+export declare function parseClaudeNativeConversationId(value: string): ClaudeNativeIdentity;
+export declare function isClaudeNativeWatchId(value: unknown): value is string;

package/dist/src/claude-native-identity.js

@@ -0,0 +1,54 @@
+import path from "node:path";
+export class ClaudeNativeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ClaudeNativeError";
+    }
+}
+const PREFIX = "claude-cli:v1:";
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u;
+export function isClaudeNativeUuid(value) {
+    return typeof value === "string" && UUID.test(value);
+}
+export function validateClaudeNativeIdentity(value) {
+    if (!value || typeof value.configDir !== "string" || !path.isAbsolute(value.configDir)
+        || value.configDir.length > 2048 || /[\u0000-\u001f\u007f]/u.test(value.configDir)
+        || !isClaudeNativeUuid(value.sessionId) || !Number.isSafeInteger(value.pid) || value.pid < 1
+        || typeof value.processStart !== "string" || value.processStart.length > 128
+        || !/^[A-Za-z]{3} [A-Za-z]{3} \d{1,2} \d{2}:\d{2}:\d{2} \d{4}$/u.test(value.processStart)) {
+        throw new ClaudeNativeError("invalid_identity", "Invalid Claude CLI native identity");
+    }
+    return { configDir: path.resolve(value.configDir), sessionId: value.sessionId,
+        pid: value.pid, processStart: value.processStart };
+}
+export function createClaudeNativeConversationId(value) {
+    const { configDir, sessionId, pid, processStart } = validateClaudeNativeIdentity(value);
+    return PREFIX + Buffer.from(JSON.stringify([configDir, sessionId, pid, processStart])).toString("base64url");
+}
+export function isClaudeNativeConversationId(value) {
+    return typeof value === "string" && value.startsWith(PREFIX);
+}
+export function parseClaudeNativeConversationId(value) {
+    if (!isClaudeNativeConversationId(value) || value.length > 4096 || !/^[\w-]+$/u.test(value.slice(PREFIX.length))) {
+        throw new ClaudeNativeError("invalid_identity", "Invalid Claude CLI conversation ID");
+    }
+    let tuple;
+    try {
+        tuple = JSON.parse(Buffer.from(value.slice(PREFIX.length), "base64url").toString("utf8"));
+    }
+    catch {
+        throw new ClaudeNativeError("invalid_identity", "Invalid Claude CLI conversation payload");
+    }
+    if (!Array.isArray(tuple) || tuple.length !== 4)
+        throw new ClaudeNativeError("invalid_identity", "Invalid Claude CLI identity tuple");
+    const identity = validateClaudeNativeIdentity({ configDir: tuple[0], sessionId: tuple[1], pid: tuple[2], processStart: tuple[3] });
+    if (createClaudeNativeConversationId(identity) !== value)
+        throw new ClaudeNativeError("invalid_identity", "Non-canonical Claude CLI identity");
+    return identity;
+}
+export function isClaudeNativeWatchId(value) {
+    return typeof value === "string" && /^claude-cli-watch:[A-Za-z0-9_-]{8,128}$/u.test(value);
+}
+//# sourceMappingURL=claude-native-identity.js.map

package/dist/src/claude-native-identity.js.map

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

package/dist/src/claude-native-monitor.d.ts

@@ -0,0 +1,13 @@
+import { type ClaudeNativeRuntimeOptions } from "./claude-native-runtime.js";
+export interface ClaudeNativeMonitorTasks {
+    reconcile(id: string): Promise<unknown>;
+    shouldMonitor(id: string): boolean;
+}
+/** Polling recovers missed events. Durable task/outbox state, never idle alone, decides when to stop. */
+export declare function pollClaudeNativeMonitor(watchId: string, tasks: ClaudeNativeMonitorTasks, options?: {
+    sleep?: (ms: number) => Promise<void>;
+    onError?: () => void;
+}): Promise<void>;
+export declare function launchClaudeNativeMonitor(watchId: string, options: ClaudeNativeRuntimeOptions): Promise<number>;
+/** Runtime fences the saved PID/start/session and cannot substitute a later resumed process. */
+export declare function runClaudeNativeMonitor(watchId: string, options: ClaudeNativeRuntimeOptions): Promise<void>;

package/dist/src/claude-native-monitor.js

@@ -0,0 +1,123 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+import { ensureDir } from "./store.js";
+import { cliCwd, cliEnv, cliNow, cliNowMs, cliPid, cliSleep, cliSleepSync } from "./cli-runtime-context.js";
+import { createFileLockCliAdapter } from "./file-lock-cli-adapter.js";
+import { isClaudeNativeWatchId } from "./claude-native-identity.js";
+import { createClaudeNativeRuntime } from "./claude-native-runtime.js";
+/** Polling recovers missed events. Durable task/outbox state, never idle alone, decides when to stop. */
+export async function pollClaudeNativeMonitor(watchId, tasks, options = {}) {
+    if (!isClaudeNativeWatchId(watchId))
+        throw new Error("Invalid Claude CLI Watch ID");
+    while (tasks.shouldMonitor(watchId)) {
+        try {
+            await tasks.reconcile(watchId);
+        }
+        catch {
+            options.onError?.();
+        }
+        if (!tasks.shouldMonitor(watchId))
+            return;
+        await (options.sleep ?? cliSleep)(2000);
+    }
+}
+export async function launchClaudeNativeMonitor(watchId, options) {
+    if (!isClaudeNativeWatchId(watchId))
+        throw new Error("Invalid Claude CLI Watch ID");
+    const args = [fileURLToPath(new URL("./cli.js", import.meta.url)), "monitor-claude-native", "--watch", watchId, "--store-dir", options.storeDir];
+    if (options.openclawBin)
+        args.push("--openclaw-bin", options.openclawBin);
+    const directory = path.join(options.storeDir, "claude-native-monitors");
+    ensureDir(directory);
+    const fd = fs.openSync(path.join(directory, `${watchId}.log`), fs.constants.O_CREAT | fs.constants.O_APPEND | fs.constants.O_WRONLY | fs.constants.O_NOFOLLOW, 0o600);
+    try {
+        fs.fchmodSync(fd, 0o600);
+        const child = spawn(process.execPath, args, { detached: true, cwd: cliCwd(),
+            env: { ...cliEnv(), AKK_NATIVE_CLAUDE_CONFIG_DIRS: JSON.stringify(options.claudeConfigDirs),
+                ...(options.claudeBin ? { AKK_NATIVE_CLAUDE_BIN: options.claudeBin } : {}),
+                ...(options.pythonBin ? { AKK_NATIVE_CLAUDE_PYTHON: options.pythonBin } : {}) }, stdio: ["ignore", fd, fd, "ipc"] });
+        return await new Promise((resolve, reject) => {
+            let finished = false;
+            const timer = setTimeout(() => finish(new Error("Claude CLI monitor readiness timed out")), 5000);
+            const finish = (error, pid) => {
+                if (finished)
+                    return;
+                finished = true;
+                clearTimeout(timer);
+                child.removeAllListeners("message");
+                child.removeAllListeners("exit");
+                child.removeAllListeners("error");
+                if (child.connected)
+                    child.disconnect();
+                child.unref();
+                if (error)
+                    reject(error);
+                else
+                    resolve(pid);
+            };
+            child.once("error", error => finish(error));
+            child.once("exit", () => finish(new Error("Claude CLI monitor exited before readiness")));
+            child.on("message", value => {
+                const message = value;
+                if (message?.watchId === watchId && message.ready === true && Number.isSafeInteger(message.pid) && message.pid > 1)
+                    finish(undefined, message.pid);
+            });
+        });
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+function announce(watchId, pid) {
+    // Losing the launching controller must not stop a durable observer.
+    if (!process.connected || !process.send)
+        return;
+    try {
+        process.send({ watchId, ready: true, pid }, () => { });
+    }
+    catch { /* Parent already disconnected. */ }
+}
+/** Runtime fences the saved PID/start/session and cannot substitute a later resumed process. */
+export async function runClaudeNativeMonitor(watchId, options) {
+    if (!isClaudeNativeWatchId(watchId))
+        throw new Error("Invalid Claude CLI Watch ID");
+    const directory = path.join(options.storeDir, "claude-native-monitors");
+    ensureDir(directory);
+    const locks = createFileLockCliAdapter({ now: cliNow, nowMs: cliNowMs, pid: cliPid, sleepSync: cliSleepSync });
+    const runtime = createClaudeNativeRuntime(options), lockPath = path.join(directory, `${watchId}.lock`);
+    let release;
+    try {
+        runtime.tasks.status(watchId);
+        try {
+            release = locks.acquire(lockPath, { timeoutMs: 100 });
+        }
+        catch (error) {
+            const owner = locks.owner(lockPath);
+            if (owner.pid && owner.pid !== cliPid() && !locks.stale(lockPath)) {
+                announce(watchId, owner.pid);
+                return;
+            }
+            throw error;
+        }
+        // This acknowledges observer ownership only, never native acceptance or success.
+        announce(watchId, cliPid());
+        let lastErrorAt = -Infinity;
+        await pollClaudeNativeMonitor(watchId, runtime.tasks, { onError: () => {
+                if (cliNowMs() - lastErrorAt < 30_000)
+                    return;
+                lastErrorAt = cliNowMs();
+                process.stderr.write("Claude CLI monitor could not reconcile; retrying the existing durable Watch.\n");
+            } });
+    }
+    finally {
+        try {
+            release?.();
+        }
+        finally {
+            await runtime.close();
+        }
+    }
+}
+//# sourceMappingURL=claude-native-monitor.js.map

package/dist/src/claude-native-monitor.js.map

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