@scotthuang/agent-knock-knock 0.13.17 → 0.14.0

package/dist/src/desktop-ipc-transport.js

@@ -0,0 +1,123 @@
+import net from "node:net";
+import fs from "node:fs";
+import path from "node:path";
+import { DesktopIpcError } from "./desktop-types.js";
+const MAX_FRAME_BYTES = 32 * 1024 * 1024;
+/** A private parent prevents another OS user replacing a trusted socket path. */
+export function readDesktopSocketIdentity(socketPath) {
+    if (!path.isAbsolute(socketPath) || !process.getuid) {
+        throw new DesktopIpcError("unsafe_socket", "Desktop IPC requires an owner-local Unix socket");
+    }
+    const uid = BigInt(process.getuid());
+    const parent = fs.lstatSync(path.dirname(socketPath), { bigint: true });
+    const socket = fs.lstatSync(socketPath, { bigint: true });
+    if (parent.isSymbolicLink() || !parent.isDirectory() || parent.uid !== uid || (parent.mode & 63n) !== 0n
+        || socket.isSymbolicLink() || !socket.isSocket() || socket.uid !== uid || (socket.mode & 63n) !== 0n) {
+        throw new DesktopIpcError("unsafe_socket", "Desktop IPC socket and parent must be private to the current user and must not be symlinks");
+    }
+    return [parent.dev, parent.ino, socket.dev, socket.ino, socket.ctimeNs].join(":");
+}
+/** Desktop's private IPC uses a uint32 little-endian length followed by UTF-8 JSON. */
+export class DesktopFrameDecoder {
+    buffered = Buffer.alloc(0);
+    push(chunk) {
+        if (this.buffered.length + chunk.length > MAX_FRAME_BYTES * 2 + 8) {
+            throw new DesktopIpcError("invalid_response", "Desktop IPC receive buffer exceeded limit");
+        }
+        this.buffered = Buffer.concat([this.buffered, chunk]);
+        const messages = [];
+        while (this.buffered.length >= 4) {
+            const length = this.buffered.readUInt32LE(0);
+            if (length === 0 || length > MAX_FRAME_BYTES)
+                throw new DesktopIpcError("invalid_response", "Invalid Desktop IPC frame length");
+            if (this.buffered.length < length + 4)
+                break;
+            const payload = this.buffered.subarray(4, length + 4);
+            this.buffered = this.buffered.subarray(length + 4);
+            try {
+                messages.push(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(payload)));
+            }
+            catch {
+                throw new DesktopIpcError("invalid_response", "Invalid Desktop IPC JSON frame");
+            }
+        }
+        return messages;
+    }
+}
+export function encodeDesktopFrame(message) {
+    const payload = Buffer.from(JSON.stringify(message), "utf8");
+    if (!payload.length || payload.length > MAX_FRAME_BYTES)
+        throw new DesktopIpcError("invalid_argument", "Desktop IPC frame exceeds limit");
+    const frame = Buffer.allocUnsafe(payload.length + 4);
+    frame.writeUInt32LE(payload.length, 0);
+    payload.copy(frame, 4);
+    return frame;
+}
+export async function connectDesktopIpcTransport(options) {
+    const identity = readDesktopSocketIdentity(options.socketPath);
+    const assertIdentity = () => {
+        if (readDesktopSocketIdentity(options.socketPath) !== identity) {
+            throw new DesktopIpcError("unsafe_socket", "Desktop IPC socket identity changed; reconnect required");
+        }
+    };
+    const socket = net.createConnection({ path: options.socketPath });
+    const messages = new Set();
+    const disconnects = new Set();
+    const decoder = new DesktopFrameDecoder();
+    let ended;
+    const finish = (error) => {
+        if (ended)
+            return;
+        ended = error;
+        socket.destroy();
+        for (const listener of disconnects)
+            listener(error);
+        disconnects.clear();
+        messages.clear();
+    };
+    socket.on("data", (chunk) => {
+        try {
+            for (const message of decoder.push(chunk))
+                for (const listener of messages)
+                    listener(message);
+        }
+        catch (error) {
+            finish(error instanceof Error ? error : new Error("Desktop IPC decode failure"));
+        }
+    });
+    socket.on("error", (error) => finish(error));
+    socket.on("close", () => finish(new DesktopIpcError("closed", "Desktop IPC connection closed")));
+    try {
+        await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => { cleanup(); reject(new DesktopIpcError("timeout", "Desktop IPC connection timeout")); }, options.timeoutMs);
+            const connected = () => { cleanup(); resolve(); };
+            const failed = (error) => { cleanup(); reject(error); };
+            const cleanup = () => { clearTimeout(timer); socket.off("connect", connected); disconnects.delete(failed); };
+            socket.once("connect", connected);
+            disconnects.add(failed);
+        });
+        assertIdentity();
+    }
+    catch (error) {
+        finish(error instanceof Error ? error : new Error("Desktop IPC connection failed"));
+        throw error;
+    }
+    return {
+        send(message) {
+            if (ended || socket.destroyed || !socket.writable)
+                throw new DesktopIpcError("closed", "Desktop IPC socket is unavailable");
+            assertIdentity();
+            socket.write(encodeDesktopFrame(message));
+        },
+        onMessage(listener) { messages.add(listener); return () => messages.delete(listener); },
+        onDisconnect(listener) {
+            if (ended)
+                queueMicrotask(() => listener(ended));
+            else
+                disconnects.add(listener);
+            return () => disconnects.delete(listener);
+        },
+        close() { finish(new DesktopIpcError("closed", "Desktop IPC client closed")); }
+    };
+}
+//# sourceMappingURL=desktop-ipc-transport.js.map

package/dist/src/desktop-ipc-transport.js.map

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

package/dist/src/desktop-list.d.ts

@@ -0,0 +1,25 @@
+import type { DesktopRuntime } from "./desktop-runtime.js";
+export declare function listDesktopSessions(runtime: DesktopRuntime, options: Record<string, unknown>): Promise<{
+    desktop_sessions: Record<string, unknown>[];
+    desktop_watches: Record<string, unknown>[];
+    desktop_scan: {
+        view: string;
+        total_candidates: number;
+        history_candidates: number | undefined;
+        returned: number;
+        next_cursor: string | undefined;
+        sidebar_status: "partial" | "supported" | "unavailable" | "unsupported" | undefined;
+        sidebar_mode: string | undefined;
+        sidebar_selection_scope: "persisted_expanded_membership" | undefined;
+        limitations: string[] | undefined;
+        live_probe_scope: string;
+        catalog_complete: boolean;
+        live_count: number;
+        application_version: string;
+        application_build: string;
+        write_contract_verified: boolean;
+        watch_error: string | undefined;
+        sources: import("./desktop-metadata-reader.js").DesktopMetadataSource[];
+        membership_is_not_live_identity: boolean;
+    };
+}>;

package/dist/src/desktop-list.js

@@ -0,0 +1,55 @@
+import fs from "node:fs";
+import path from "node:path";
+import { desktopWritesVerified } from "./desktop-runtime.js";
+import { desktopSessionProjection, desktopTaskProjection } from "./desktop-public-projection.js";
+import { DesktopIpcError } from "./desktop-types.js";
+export async function listDesktopSessions(runtime, options) {
+    const limit = options.desktopLimit === undefined ? 30 : Number(options.desktopLimit);
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+        throw new Error("desktop-limit must be between 1 and 100");
+    const view = options.desktopView ?? "sidebar";
+    if (view !== "sidebar" && view !== "history")
+        throw new Error("desktop-view must be sidebar or history");
+    const page = await runtime.catalog.list({ view, limit, cursor: text(options.desktopCursor),
+        search: text(options.desktopSearch), project: text(options.desktopProject) });
+    const sessions = new Array(page.sessions.length);
+    // Bounded parallel read-only probes. Missing owners remain visible, never implicitly loaded.
+    let index = 0;
+    await Promise.all(Array.from({ length: Math.min(16, page.sessions.length) }, async () => {
+        while (index < page.sessions.length) {
+            const position = index++;
+            const entry = page.sessions[position];
+            if (!entry.localVerifiable || !fs.existsSync(path.join(entry.codexHome, "ipc", "ipc.sock"))) {
+                sessions[position] = desktopSessionProjection(entry, undefined, false, entry.localVerifiable ? "desktop_not_running" : "unsupported_desktop_host");
+                continue;
+            }
+            try {
+                const snapshot = await runtime.transport.observe(entry);
+                sessions[position] = desktopSessionProjection(entry, snapshot, desktopWritesVerified(runtime.compatibility));
+            }
+            catch (error) {
+                sessions[position] = desktopSessionProjection(entry, undefined, false, error instanceof DesktopIpcError ? error.code : "live_owner_not_confirmed");
+            }
+        }
+    }));
+    let watches = [];
+    let watchError;
+    try {
+        watches = runtime.tasks.list().map(task => desktopTaskProjection(task, desktopWritesVerified(runtime.compatibility)));
+    }
+    catch {
+        watchError = "desktop_watch_store_unavailable";
+    }
+    return { desktop_sessions: sessions, desktop_watches: watches,
+        desktop_scan: { view, total_candidates: page.total, history_candidates: page.historyTotal,
+            returned: sessions.length, next_cursor: page.nextCursor,
+            sidebar_status: page.sidebar?.status, sidebar_mode: page.sidebar?.mode,
+            sidebar_selection_scope: page.sidebar?.selectionScope, limitations: page.sidebar?.limitations,
+            live_probe_scope: "returned_page",
+            catalog_complete: page.complete, live_count: sessions.filter(row => row.connection_state === "live_owner_verified").length,
+            application_version: runtime.compatibility.version, application_build: runtime.compatibility.build,
+            write_contract_verified: desktopWritesVerified(runtime.compatibility), watch_error: watchError,
+            sources: page.sources, membership_is_not_live_identity: true } };
+}
+function text(value) { return typeof value === "string" ? value : undefined; }
+//# sourceMappingURL=desktop-list.js.map

package/dist/src/desktop-list.js.map

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

package/dist/src/desktop-metadata-reader.d.ts

@@ -0,0 +1,30 @@
+export type DesktopMetadataRow = Record<string, unknown>;
+export type DesktopMetadataKind = "desktop_catalog" | "state";
+export interface DesktopMetadataSource {
+    database: string;
+    codexHome: string;
+    kind: DesktopMetadataKind;
+    status: "ok" | "absent" | "error";
+    rowCount?: number;
+    pageCount?: number;
+    columns?: string[];
+    error?: string;
+    snapshot?: "stable_copy";
+}
+export interface DesktopMetadataBatch {
+    source: DesktopMetadataSource;
+    rows: DesktopMetadataRow[];
+    hosts?: Record<string, string>;
+}
+export type DesktopMetadataReader = (codexHome: string) => Promise<DesktopMetadataBatch[]>;
+export type DesktopSnapshotQuery = (database: string, sql: string) => Promise<DesktopMetadataRow[]>;
+export interface DesktopMetadataReaderOptions {
+    querySnapshot?: DesktopSnapshotQuery;
+    temporaryRoot?: string;
+    maxRows?: number;
+}
+/** Reads metadata only. Original SQLite files are never opened by SQLite. */
+export declare function readDesktopMetadata(codexHome: string, options?: DesktopMetadataReaderOptions): Promise<DesktopMetadataBatch[]>;
+/** Sequential DB/WAL copy with stat guards, not an atomic SQLite backup. */
+export declare function withDesktopMetadataSnapshot<T>(database: string, read: (copy: string) => Promise<T>, temporaryRoot?: string): Promise<T | undefined>;
+export declare function queryDesktopSnapshot(database: string, sql: string): Promise<DesktopMetadataRow[]>;

package/dist/src/desktop-metadata-reader.js

@@ -0,0 +1,182 @@
+import { execFile } from "node:child_process";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { latestStateDbPath } from "./codex-sqlite-thread-query.js";
+const PAGE_SIZE = 100;
+const STATE_COLUMNS = [
+    "id", "cwd", "title", "name", "updated_at", "updated_at_ms", "originator",
+    "archived", "source", "thread_source", "project_id", "parent_thread_id",
+    "is_pinned", "thread_section_id", "section_position", "recency_at_ms"
+];
+const CATALOG_COLUMNS = [
+    "host_id", "thread_id", "display_title", "cwd", "source_updated_at",
+    "source_kind", "thread_source", "missing_candidate", "project_id"
+];
+/** Reads metadata only. Original SQLite files are never opened by SQLite. */
+export async function readDesktopMetadata(codexHome, options = {}) {
+    const home = path.resolve(codexHome);
+    const statePath = latestStateDbPath(home);
+    const sources = [
+        { database: path.join(home, "sqlite", "codex.db"), kind: "desktop_catalog" },
+        { database: path.join(home, "sqlite", "codex-dev.db"), kind: "desktop_catalog" },
+        { database: statePath ?? path.join(home, "state_*.sqlite"), kind: "state" }
+    ];
+    const result = [];
+    for (const source of sources) {
+        const metadata = { ...source, codexHome: home, status: "absent" };
+        if (source.kind === "state" && !statePath) {
+            result.push({ source: metadata, rows: [] });
+            continue;
+        }
+        try {
+            const batch = await withDesktopMetadataSnapshot(source.database, async (copy) => {
+                const query = options.querySnapshot ?? queryDesktopSnapshot;
+                const checks = await query(copy, "PRAGMA quick_check");
+                if (checks.length !== 1 || Object.values(checks[0])[0] !== "ok") {
+                    throw new Error("Metadata snapshot failed SQLite quick_check");
+                }
+                return readSnapshot(copy, metadata, query, options.maxRows ?? 100_000);
+            }, options.temporaryRoot);
+            result.push(batch ?? { source: metadata, rows: [] });
+        }
+        catch (error) {
+            result.push({ source: { ...metadata, status: "error", error: error instanceof Error ? error.message : String(error) }, rows: [] });
+        }
+    }
+    return result;
+}
+async function readSnapshot(copy, source, query, maxRows) {
+    if (!Number.isSafeInteger(maxRows) || maxRows < 1)
+        throw new Error("Invalid metadata row limit");
+    const isState = source.kind === "state";
+    const table = isState ? "threads" : "local_thread_catalog";
+    const columns = await schemaColumns(copy, table, query);
+    const required = isState
+        ? ["id", "cwd", "title", "archived", "source"]
+        : ["host_id", "thread_id", "display_title", "cwd", "source_updated_at", "source_kind", "missing_candidate"];
+    if (isState && !columns.includes("updated_at") && !columns.includes("updated_at_ms")) {
+        throw new Error("Unsupported threads schema: missing update timestamp");
+    }
+    requireColumns(table, columns, required);
+    const selected = selectedColumns(isState ? STATE_COLUMNS : CATALOG_COLUMNS, columns);
+    // Archived metadata is needed to reject stale sidebar assignments and pins.
+    // Content/history tables are never read; the catalog filters these rows later.
+    const predicate = isState ? "1 = 1" : "missing_candidate = 0";
+    const order = isState ? "id" : "host_id, thread_id";
+    const { rows, pageCount } = await scanSnapshotRows(copy, query, { table, selected, predicate, order, maxRows });
+    const hosts = isState ? Object.create(null) : await readCatalogHosts(copy, query);
+    return { source: { ...source, status: "ok", rowCount: rows.length, pageCount, columns, snapshot: "stable_copy" }, rows, hosts };
+}
+function selectedColumns(wanted, available) {
+    return wanted.map((column) => {
+        if (!available.includes(column))
+            return `NULL AS "${column}"`;
+        if (["title", "name", "display_title"].includes(column))
+            return `substr("${column}",1,160) AS "${column}"`;
+        return `"${column}"`;
+    }).join(", ");
+}
+async function scanSnapshotRows(copy, query, { table, selected, predicate, order, maxRows }) {
+    const counts = await query(copy, `SELECT count(*) AS count FROM "${table}" WHERE ${predicate}`);
+    const count = counts[0]?.count;
+    if (!Number.isSafeInteger(count) || Number(count) < 0 || Number(count) > maxRows) {
+        throw new Error(`Metadata row count is invalid or exceeds ${maxRows}; discovery is incomplete`);
+    }
+    const rows = [];
+    let pageCount = 0;
+    while (rows.length < Number(count)) {
+        const page = await query(copy, `SELECT ${selected} FROM "${table}" WHERE ${predicate} ORDER BY ${order} LIMIT ${PAGE_SIZE} OFFSET ${rows.length}`);
+        if (page.length === 0 || page.length > PAGE_SIZE)
+            throw new Error("Metadata page count mismatch");
+        rows.push(...page);
+        pageCount += 1;
+    }
+    if (rows.length !== count)
+        throw new Error("Metadata scan count mismatch");
+    return { rows, pageCount };
+}
+async function readCatalogHosts(copy, query) {
+    const hosts = Object.create(null);
+    const hostColumns = await schemaColumns(copy, "local_thread_catalog_hosts", query);
+    requireColumns("local_thread_catalog_hosts", hostColumns, ["host_id", "host_kind"]);
+    for (const row of await query(copy, "SELECT host_id, host_kind FROM local_thread_catalog_hosts")) {
+        if (typeof row.host_id !== "string" || typeof row.host_kind !== "string")
+            throw new Error("Invalid catalog host metadata");
+        hosts[row.host_id] = row.host_kind;
+    }
+    return hosts;
+}
+async function schemaColumns(copy, table, query) {
+    return (await query(copy, `PRAGMA table_info("${table}")`)).map((row) => String(row.name));
+}
+function requireColumns(table, actual, required) {
+    const missing = required.filter((column) => !actual.includes(column));
+    if (missing.length)
+        throw new Error(`Unsupported ${table} schema: missing ${missing.join(", ")}`);
+}
+async function signature(file) {
+    try {
+        const stat = await fs.stat(file, { bigint: true });
+        if (!stat.isFile())
+            throw new Error("Metadata path is not a regular file");
+        return [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
+    }
+    catch (error) {
+        if (error?.code === "ENOENT")
+            return null;
+        throw error;
+    }
+}
+/** Sequential DB/WAL copy with stat guards, not an atomic SQLite backup. */
+export async function withDesktopMetadataSnapshot(database, read, temporaryRoot = os.tmpdir()) {
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+        const files = [database, `${database}-wal`];
+        const before = await Promise.all(files.map(signature));
+        if (before[0] === null)
+            return undefined;
+        const directory = await fs.mkdtemp(path.join(temporaryRoot, "akk-desktop-metadata-"));
+        try {
+            await fs.chmod(directory, 0o700);
+            const copy = path.join(directory, path.basename(database));
+            for (let index = 0; index < files.length; index += 1) {
+                if (before[index] === null)
+                    continue;
+                const destination = `${copy}${index === 0 ? "" : "-wal"}`;
+                await fs.copyFile(files[index], destination);
+                await fs.chmod(destination, 0o600);
+            }
+            const after = await Promise.all(files.map(signature));
+            if (before.some((value, index) => value !== after[index]))
+                continue;
+            return await read(copy);
+        }
+        finally {
+            await fs.rm(directory, { recursive: true, force: true });
+        }
+    }
+    throw new Error("Metadata database/WAL changed during every snapshot attempt");
+}
+export function queryDesktopSnapshot(database, sql) {
+    return new Promise((resolve, reject) => {
+        execFile("sqlite3", ["-batch", "-bail", "-readonly", "-json", "-cmd", "PRAGMA query_only=ON", database, sql], {
+            encoding: "utf8", timeout: 10_000, maxBuffer: 10 * 1024 * 1024
+        }, (error, stdout) => {
+            if (error) {
+                reject(new Error(`SQLite metadata query failed (${error.code ?? "unknown"})`));
+                return;
+            }
+            try {
+                const rows = stdout.trim() ? JSON.parse(stdout) : [];
+                if (!Array.isArray(rows) || rows.some((row) => !row || typeof row !== "object" || Array.isArray(row))) {
+                    throw new Error("SQLite metadata output is not an array of records");
+                }
+                resolve(rows);
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    });
+}
+//# sourceMappingURL=desktop-metadata-reader.js.map

package/dist/src/desktop-metadata-reader.js.map

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

package/dist/src/desktop-monitor.d.ts

@@ -0,0 +1,4 @@
+import { type DesktopRuntimeOptions } from "./desktop-runtime.js";
+export declare function launchDesktopMonitor(watchId: string, options: DesktopRuntimeOptions): Promise<number>;
+/** One detached observer per Watch; host sweeps independently repair missed work. */
+export declare function runDesktopMonitor(watchId: string, options: DesktopRuntimeOptions): Promise<void>;

package/dist/src/desktop-monitor.js

@@ -0,0 +1,101 @@
+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 { desktopTaskNeedsReconciliation } from "./desktop-task-service.js";
+import { createDesktopRuntime } from "./desktop-runtime.js";
+import { isDesktopWatchId } from "./desktop-semantic.js";
+export async function launchDesktopMonitor(watchId, options) {
+    if (!isDesktopWatchId(watchId))
+        throw new Error("Invalid Desktop Watch ID");
+    const args = [fileURLToPath(new URL("./cli.js", import.meta.url)), "monitor-desktop", "--watch", watchId,
+        "--store-dir", options.storeDir];
+    if (options.openclawBin)
+        args.push("--openclaw-bin", options.openclawBin);
+    const directory = path.join(options.storeDir, "desktop-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 {
+        const child = spawn(process.execPath, args, { detached: true, cwd: cliCwd(),
+            env: { ...cliEnv(), AKK_DESKTOP_CODEX_HOMES: JSON.stringify(options.codexHomes) }, stdio: ["ignore", fd, fd, "ipc"] });
+        const pid = await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => finish(new Error("Desktop monitor readiness timed out")), 5000);
+            const finish = (error, pid) => {
+                clearTimeout(timer);
+                child.removeAllListeners("message");
+                child.removeAllListeners("exit");
+                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("Desktop 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);
+                }
+            });
+        });
+        return pid;
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+/** One detached observer per Watch; host sweeps independently repair missed work. */
+export async function runDesktopMonitor(watchId, options) {
+    if (!isDesktopWatchId(watchId))
+        throw new Error("Invalid Desktop Watch ID");
+    const directory = path.join(options.storeDir, "desktop-monitors");
+    ensureDir(directory);
+    const locks = createFileLockCliAdapter({ now: cliNow, nowMs: cliNowMs, pid: cliPid, sleepSync: cliSleepSync });
+    const initial = createDesktopRuntime(options);
+    try {
+        initial.tasks.status(watchId);
+    }
+    finally {
+        await initial.close();
+    }
+    const lockPath = path.join(directory, `${watchId}.lock`);
+    let release;
+    try {
+        release = locks.acquire(lockPath, { timeoutMs: 100 });
+    }
+    catch (error) {
+        const owner = locks.owner(lockPath);
+        if (owner.pid && owner.pid !== cliPid() && !locks.stale(lockPath)) {
+            process.send?.({ watchId, ready: true, pid: owner.pid });
+            return;
+        }
+        throw error;
+    }
+    try {
+        process.send?.({ watchId, ready: true, pid: cliPid() });
+        for (;;) {
+            const runtime = createDesktopRuntime(options);
+            let pending;
+            try {
+                pending = desktopTaskNeedsReconciliation(await runtime.tasks.reconcile(watchId));
+            }
+            finally {
+                await runtime.close();
+            }
+            if (!pending)
+                return;
+            await cliSleep(2000);
+        }
+    }
+    finally {
+        release();
+    }
+}
+//# sourceMappingURL=desktop-monitor.js.map

package/dist/src/desktop-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-monitor.js","sourceRoot":"","sources":["../../src/desktop-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC5G,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAA8B,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAe,EAAE,OAA8B;IACxF,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO;QACtG,aAAa,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,OAAO,CAAC,WAAW;QAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAClE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrB,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,OAAO,MAAM,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ;QACzG,EAAE,CAAC,SAAS,CAAC,QAAQ,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE;YACzE,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,uBAAuB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QACzH,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAC/F,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,GAAY,EAAE,EAAE;gBAC7C,YAAY,CAAC,KAAK,CAAC,CAAC;gBAAC,KAAK,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;gBAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;gBAC3F,IAAI,KAAK,CAAC,SAAS;oBAAE,KAAK,CAAC,UAAU,EAAE,CAAC;gBAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACvD,IAAI,KAAK;oBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;oBAAM,OAAO,CAAC,GAAI,CAAC,CAAC;YAC/C,CAAC,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAC,CAAC;YACvF,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;gBAC1B,MAAM,OAAO,GAAG,KAA4D,CAAC;gBAC7E,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAI,GAAG,CAAC,EAAE,CAAC;oBACnH,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC;YAAS,CAAC;QAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;AACjC,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,OAA8B;IACrF,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAClE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrB,MAAM,KAAK,GAAG,wBAAwB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;IAC/G,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC;QAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC;YAAS,CAAC;QAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;IACzD,IAAI,OAAmB,CAAC;IACxB,IAAI,CAAC;QAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAAC,CAAC;IAC9D,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YAAC,OAAO;QACnE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACxD,SAAS,CAAC;YACR,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,OAAgB,CAAC;YACrB,IAAI,CAAC;gBAAC,OAAO,GAAG,8BAA8B,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAAC,CAAC;oBACjF,CAAC;gBAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;YAClC,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;YAAS,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AAC1B,CAAC"}

package/dist/src/desktop-public-projection.d.ts

@@ -0,0 +1,6 @@
+import type { DesktopCatalogEntry } from "./desktop-session-catalog.js";
+import type { DesktopSnapshot } from "./desktop-types.js";
+import type { DesktopTaskRecord } from "./desktop-state-store.js";
+export declare function desktopSessionProjection(entry: DesktopCatalogEntry, snapshot?: DesktopSnapshot, writesVerified?: boolean, observationError?: string): Record<string, unknown>;
+/** Do not export prompts, internal owner IDs, callback configuration or raw native state. */
+export declare function desktopTaskProjection(task: DesktopTaskRecord, writesVerified?: boolean): Record<string, unknown>;