@scotthuang/agent-knock-knock 0.14.4 → 0.14.5

package/dist/src/desktop-creation-rpc.d.ts

@@ -0,0 +1,25 @@
+import { spawn } from "node:child_process";
+export declare class DesktopCreationRpcError extends Error {
+    readonly code: string;
+    readonly requestDispatched: boolean;
+    readonly method?: string | undefined;
+    readonly requestId?: number | undefined;
+    readonly rpcCode?: number | undefined;
+    constructor(code: string, message: string, requestDispatched: boolean, method?: string | undefined, requestId?: number | undefined, rpcCode?: number | undefined);
+}
+export interface DesktopCreationRpc {
+    request(method: string, params: Record<string, unknown>, options?: {
+        beforeDispatch?: () => void | Promise<void>;
+    }): Promise<unknown>;
+    notifyInitialized(): void;
+    close(): Promise<void>;
+}
+export interface DesktopCreationRpcOptions {
+    binaryPath: string;
+    codexHome: string;
+    timeoutMs?: number;
+    environment?: NodeJS.ProcessEnv;
+    spawnProcess?: typeof spawn;
+}
+/** A dedicated, short-lived bundled process. Never attaches to or kills an existing server. */
+export declare function createDesktopCreationRpc(options: DesktopCreationRpcOptions): DesktopCreationRpc;

package/dist/src/desktop-creation-rpc.js

@@ -0,0 +1,198 @@
+import { spawn } from "node:child_process";
+export class DesktopCreationRpcError extends Error {
+    code;
+    requestDispatched;
+    method;
+    requestId;
+    rpcCode;
+    constructor(code, message, requestDispatched, method, requestId, rpcCode) {
+        super(message);
+        this.code = code;
+        this.requestDispatched = requestDispatched;
+        this.method = method;
+        this.requestId = requestId;
+        this.rpcCode = rpcCode;
+        this.name = "DesktopCreationRpcError";
+    }
+}
+const METHODS = new Set(["initialize", "project/list", "project/read", "thread/start", "thread/name/set", "thread/read"]);
+const MAX_LINE_BYTES = 4 * 1024 * 1024;
+/** A dedicated, short-lived bundled process. Never attaches to or kills an existing server. */
+export function createDesktopCreationRpc(options) {
+    return new DesktopCreationProcess(options);
+}
+class DesktopCreationProcess {
+    child;
+    timeoutMs;
+    pending = new Map();
+    sequence = 0;
+    buffer = Buffer.alloc(0);
+    ended = false;
+    closed = false;
+    processExited = false;
+    spawnFailed = false;
+    closePromise;
+    resolveExit;
+    exited = new Promise(resolve => { this.resolveExit = resolve; });
+    constructor(options) {
+        this.timeoutMs = options.timeoutMs ?? 30_000;
+        if (!Number.isSafeInteger(this.timeoutMs) || this.timeoutMs < 1 || this.timeoutMs > 60_000) {
+            throw new DesktopCreationRpcError("invalid_argument", "Invalid Desktop creation request timeout", false);
+        }
+        this.child = (options.spawnProcess ?? spawn)(options.binaryPath, ["-c", "features.code_mode_host=true", "app-server", "--listen", "stdio://"], {
+            cwd: options.codexHome, env: { ...(options.environment ?? process.env), CODEX_HOME: options.codexHome },
+            stdio: ["pipe", "pipe", "pipe"]
+        });
+        this.child.on("error", () => {
+            this.fail("process_failed", "Desktop creation process could not run");
+            if (this.child.pid === undefined) {
+                this.spawnFailed = true;
+                this.resolveExit();
+            }
+        });
+        this.child.on("exit", () => { this.processExited = true; this.fail("closed", "Desktop creation process exited"); this.resolveExit(); });
+        this.child.stdin.on("error", () => this.fail("write_failed", "Desktop creation input transport failed"));
+        this.child.stdout.on("error", () => this.fail("read_failed", "Desktop creation output transport failed"));
+        this.child.stderr.resume(); // Diagnostics may contain local paths; never project raw stderr into receipts.
+        this.child.stdout.on("data", (chunk) => this.receive(chunk));
+    }
+    fail(code, message) {
+        this.ended = true;
+        for (const [id, item] of this.pending) {
+            clearTimeout(item.timer);
+            item.reject(new DesktopCreationRpcError(code, message, item.dispatched, item.method, id));
+        }
+        this.pending.clear();
+    }
+    receive(chunk) {
+        if (this.ended)
+            return;
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        while (this.buffer.includes(10)) {
+            const index = this.buffer.indexOf(10), line = this.buffer.subarray(0, index);
+            this.buffer = this.buffer.subarray(index + 1);
+            if (line.length > MAX_LINE_BYTES) {
+                this.fail("invalid_response", "Desktop creation response exceeds its limit");
+                return;
+            }
+            let message;
+            try {
+                const value = JSON.parse(line.toString("utf8"));
+                if (!value || typeof value !== "object" || Array.isArray(value))
+                    throw new Error();
+                message = value;
+            }
+            catch {
+                this.fail("invalid_response", "Desktop creation returned malformed JSON");
+                return;
+            }
+            if (typeof message.method === "string") {
+                // Creation never starts a turn or authorizes server tool/approval requests.
+                if (message.id !== undefined) {
+                    this.fail("unexpected_request", "Desktop creation received an unexpected server request");
+                    return;
+                }
+                continue;
+            }
+            this.settle(message);
+        }
+        if (this.buffer.length > MAX_LINE_BYTES)
+            this.fail("invalid_response", "Desktop creation response exceeds its limit");
+    }
+    settle(message) {
+        const item = typeof message.id === "number" ? this.pending.get(message.id) : undefined;
+        if (!item)
+            return; // A late response never revives or repeats a timed-out mutation.
+        const requestId = message.id;
+        this.pending.delete(requestId);
+        clearTimeout(item.timer);
+        if (message.error && typeof message.error === "object") {
+            const rpcCode = message.error.code;
+            item.reject(new DesktopCreationRpcError("rpc_rejected", `Desktop ${item.method} returned an error`, item.dispatched, item.method, requestId, typeof rpcCode === "number" ? rpcCode : undefined));
+        }
+        else if (!Object.hasOwn(message, "result")) {
+            item.reject(new DesktopCreationRpcError("invalid_response", "Desktop creation response has no result", item.dispatched, item.method, requestId));
+        }
+        else
+            item.resolve(message.result);
+    }
+    async request(method, params, options) {
+        if (!METHODS.has(method))
+            throw new DesktopCreationRpcError("invalid_argument", "Desktop creation method is not permitted", false, method);
+        if (this.ended || this.closed)
+            throw new DesktopCreationRpcError("closed", "Desktop creation connection is closed", false, method);
+        // Serialize before the durable barrier, so malformed input cannot leave a false dispatch record.
+        const id = ++this.sequence, payload = `${JSON.stringify({ id, method, params })}\n`;
+        try {
+            await options?.beforeDispatch?.();
+        }
+        catch {
+            throw new DesktopCreationRpcError("dispatch_barrier_failed", "Desktop creation durable dispatch barrier failed", false, method, id);
+        }
+        if (this.ended || this.closed || this.child.stdin.destroyed || !this.child.stdin.writable) {
+            throw new DesktopCreationRpcError("closed", "Desktop creation connection closed before dispatch", false, method, id);
+        }
+        return new Promise((resolve, reject) => {
+            const item = { method, dispatched: false, resolve, reject,
+                timer: setTimeout(() => {
+                    this.pending.delete(id);
+                    reject(new DesktopCreationRpcError("timeout", "Desktop creation request timed out; no automatic retry", item.dispatched, method, id));
+                }, this.timeoutMs) };
+            this.pending.set(id, item);
+            try {
+                // Once write is called, a throwing/erroring pipe may still have submitted bytes.
+                item.dispatched = true;
+                this.child.stdin.write(payload);
+            }
+            catch {
+                this.pending.delete(id);
+                clearTimeout(item.timer);
+                reject(new DesktopCreationRpcError("write_failed", "Desktop creation dispatch outcome is unknown", true, method, id));
+            }
+        });
+    }
+    notifyInitialized() {
+        if (this.ended || this.closed)
+            throw new DesktopCreationRpcError("closed", "Desktop creation connection is closed", false);
+        this.child.stdin.write(`${JSON.stringify({ method: "initialized" })}\n`);
+    }
+    close() {
+        if (this.closePromise)
+            return this.closePromise;
+        this.closed = true;
+        this.fail("closed", "Desktop creation connection closed");
+        this.closePromise = this.closeProcess();
+        return this.closePromise;
+    }
+    async closeProcess() {
+        if (this.processExited || this.spawnFailed || this.child.exitCode !== null || this.child.signalCode !== null)
+            return;
+        const signal = (name) => {
+            if (this.processExited || this.spawnFailed)
+                return;
+            try {
+                this.child.kill(name);
+            }
+            catch { /* Exit must still be independently confirmed below. */ }
+        };
+        const terminate = setTimeout(() => signal("SIGTERM"), 1000);
+        const kill = setTimeout(() => signal("SIGKILL"), 3000);
+        let bound;
+        const deadline = new Promise((_resolve, reject) => {
+            bound = setTimeout(() => reject(new DesktopCreationRpcError("process_exit_unconfirmed", "Desktop creation process exit could not be confirmed; do not hand off its thread", false)), 4000);
+        });
+        try {
+            try {
+                this.child.stdin.end();
+            }
+            catch { /* Retain bounded signal cleanup if the input pipe fails. */ }
+            await Promise.race([this.exited, deadline]);
+        }
+        finally {
+            clearTimeout(terminate);
+            clearTimeout(kill);
+            clearTimeout(bound);
+        }
+    }
+}
+//# sourceMappingURL=desktop-creation-rpc.js.map

package/dist/src/desktop-creation-rpc.js.map

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

package/dist/src/desktop-creation-semantic.d.ts

@@ -0,0 +1,13 @@
+import type { SemanticToolCatalogEntry } from "./semantic-tool-catalog.js";
+/** Creation identity belongs to a controller invocation, never a project/cwd guess. */
+export declare function desktopCreationOperationId(params: Record<string, unknown>, context: {
+    sessionKey?: unknown;
+    sessionId?: unknown;
+}, toolCallId: unknown): string;
+export declare function desktopCreationToolArgs(params: Record<string, unknown>, config: Record<string, unknown>, context: {
+    sessionKey?: unknown;
+    sessionId?: unknown;
+}, toolCallId: unknown): string[];
+export declare function desktopCreationResultIsError(result: unknown): boolean;
+/** Keep Desktop resource creation separate from the terminal lifecycle catalog. */
+export declare function createDesktopCreationSemanticTool(api: object & Record<string, unknown>): SemanticToolCatalogEntry;

package/dist/src/desktop-creation-semantic.js

@@ -0,0 +1,89 @@
+import { createHash } from "node:crypto";
+import { requiredString, pushOptional, numberString } from "./semantic-tool-arguments.js";
+import { resolvePluginStoreDir } from "./semantic-tool-command-helpers.js";
+import { isRecord } from "./value-guards.js";
+import { semanticToolDescriptions } from "./semantic-tool-descriptions.js";
+import { desktopCreateParameters } from "./semantic-tool-schemas.js";
+import { runHostAwareCli, withHostBridgeInvocationSignal } from "./semantic-tool-relay.js";
+import { modelFacingErrorMessage, toolResult } from "./semantic-tool-presentation.js";
+const OPERATION_PATTERN = /^desktop-create:[0-9a-f]{64}$/u;
+const CREATION_FIELDS = ["project", "cwd", "title", "request", "agentHardTimeoutMinutes"];
+/** Creation identity belongs to a controller invocation, never a project/cwd guess. */
+export function desktopCreationOperationId(params, context, toolCallId) {
+    const sessionKey = requiredString(context.sessionKey, "controller session");
+    if (Object.hasOwn(params, "operation_id")) {
+        const id = requiredString(params.operation_id, "operation_id");
+        if (!OPERATION_PATTERN.test(id))
+            throw new Error("Invalid Desktop creation operation_id");
+        return id;
+    }
+    const callId = requiredString(toolCallId, "stable Desktop creation tool call identity");
+    const sessionId = typeof context.sessionId === "string" && context.sessionId.trim() ? context.sessionId : null;
+    return "desktop-create:" + createHash("sha256").update(JSON.stringify([
+        sessionKey, sessionId, "agent_knock_knock_desktop_create", callId
+    ])).digest("hex");
+}
+export function desktopCreationToolArgs(params, config, context, toolCallId) {
+    if (Object.keys(params).some(key => ![...CREATION_FIELDS, "operation_id"].includes(key))) {
+        throw new Error("Desktop creation accepts only project, cwd, title, request and monitor lifetime, or operation_id to continue");
+    }
+    const resume = Object.hasOwn(params, "operation_id");
+    if (resume && CREATION_FIELDS.some(key => Object.hasOwn(params, key))) {
+        throw new Error("Continuing Desktop creation accepts only operation_id; its original payload cannot change");
+    }
+    const args = ["desktop-create", "--operation-id", desktopCreationOperationId(params, context, toolCallId),
+        "--openclaw-session", requiredString(context.sessionKey, "controller session")];
+    if (resume)
+        args.push("--resume-creation");
+    else {
+        for (const [key, flag] of [["project", "--project"], ["cwd", "--cwd"], ["title", "--title"], ["request", "--message"]]) {
+            if (Object.hasOwn(params, key))
+                args.push(flag, requiredString(params[key], key));
+        }
+        if (Object.hasOwn(params, "agentHardTimeoutMinutes") && (typeof params.agentHardTimeoutMinutes !== "number"
+            || !Number.isFinite(params.agentHardTimeoutMinutes) || params.agentHardTimeoutMinutes <= 0)) {
+            throw new Error("agentHardTimeoutMinutes must be a positive finite number");
+        }
+        pushOptional(args, "--agent-hard-timeout-minutes", numberString(params.agentHardTimeoutMinutes) ?? numberString(config.agentHardTimeoutMinutes));
+    }
+    pushOptional(args, "--store-dir", resolvePluginStoreDir(config));
+    pushOptional(args, "--codex-home", config.codexHome);
+    pushOptional(args, "--openclaw-bin", config.openclawBin);
+    return args;
+}
+export function desktopCreationResultIsError(result) {
+    return !isRecord(result) || result.source !== "codex_desktop"
+        || !["ready", "opening"].includes(String(result.status))
+        || (Object.hasOwn(result, "request_state") && result.request_state !== "accepted");
+}
+/** Keep Desktop resource creation separate from the terminal lifecycle catalog. */
+export function createDesktopCreationSemanticTool(api) {
+    return {
+        label: "AKK Desktop Create",
+        name: "agent_knock_knock_desktop_create",
+        description: semanticToolDescriptions.desktop_create,
+        inputSchema: desktopCreateParameters,
+        async execute(toolContext, toolCallId, rawParams, signal) {
+            return withHostBridgeInvocationSignal(signal, async () => {
+                if (!isRecord(rawParams))
+                    throw new Error("Desktop creation parameters must be an object");
+                const params = rawParams;
+                const args = desktopCreationToolArgs(params, isRecord(api.pluginConfig) ? api.pluginConfig : {}, toolContext, toolCallId);
+                const operationId = desktopCreationOperationId(params, toolContext, toolCallId);
+                try {
+                    const result = await runHostAwareCli(api, args, { allowNonzeroJson: true });
+                    return toolResult(result, { normalizeTurnIdentity: false, forceError: desktopCreationResultIsError(result) });
+                }
+                catch (error) {
+                    // The child may already have persisted a thread or sent the first task.
+                    // Keep its exact identity even when the relay loses the receipt.
+                    return toolResult({ source: "codex_desktop", operation_id: operationId, status: "uncertain", created: null,
+                        error_code: "desktop_creation_receipt_unavailable", reason: modelFacingErrorMessage(error),
+                        next_action: { tool: "agent_knock_knock_desktop_create", input: { operation_id: operationId } },
+                        warning: "Continue this exact operation only; do not create a replacement or resend the task." }, { normalizeTurnIdentity: false, forceError: true });
+                }
+            });
+        }
+    };
+}
+//# sourceMappingURL=desktop-creation-semantic.js.map

package/dist/src/desktop-creation-semantic.js.map

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

package/dist/src/desktop-creation-service.d.ts

@@ -0,0 +1,27 @@
+import { type DesktopCreationNative } from "./desktop-creation-native.js";
+import type { DesktopCreationStore, DesktopCreationRecord, DesktopCreationRequest } from "./desktop-creation-store.js";
+import type { DesktopSnapshot, DesktopThreadIdentity } from "./desktop-types.js";
+import type { DesktopTaskService } from "./desktop-task-service.js";
+export interface DesktopCreationServiceDependencies {
+    store: DesktopCreationStore;
+    connect(codexHome: string): Promise<DesktopCreationNative>;
+    defaultDirectory(operationId: string): string;
+    open(threadId: string): Promise<void>;
+    observe(target: DesktopThreadIdentity): Promise<DesktopSnapshot>;
+    tasks: Pick<DesktopTaskService, "send" | "status">;
+    now?(): Date;
+    sleep?(ms: number): Promise<void>;
+    ownerAttempts?: number;
+    processId?: number;
+    isProcessAlive?(pid: number): boolean;
+}
+export interface DesktopCreationRun {
+    operationId: string;
+    controllerSession: string;
+    input?: DesktopCreationRequest;
+    resume?: boolean;
+}
+/** Each invocation owns a durable claim, but no file lock spans native I/O. */
+export declare function createDesktopCreationService(deps: DesktopCreationServiceDependencies): {
+    run: (input: DesktopCreationRun) => Promise<DesktopCreationRecord>;
+};

package/dist/src/desktop-creation-service.js

@@ -0,0 +1,268 @@
+import { isDeepStrictEqual } from "node:util";
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import { createDesktopConversationId } from "./desktop-identity.js";
+import { DesktopCreationNativeError } from "./desktop-creation-native.js";
+function errorCode(error) {
+    const code = error?.code;
+    return typeof code === "string" && /^[a-zA-Z0-9_-]{1,80}$/u.test(code) ? code : "desktop_creation_failed";
+}
+function processAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code !== "ESRCH";
+    }
+}
+function identity(r) {
+    if (!r.threadId)
+        throw new Error("Desktop creation has no native thread");
+    return { codexHome: r.input.codexHome, hostId: "local", threadId: r.threadId };
+}
+const identityErrors = new Set(["creation_identity_mismatch", "thread_target_mismatch", "desktop_identity_mismatch", "process_exit_unconfirmed"]);
+/** Each invocation owns a durable claim, but no file lock spans native I/O. */
+export function createDesktopCreationService(deps) {
+    return { run: (input) => new DesktopCreationInvocation(deps, input).run() };
+}
+class DesktopCreationInvocation {
+    deps;
+    input;
+    token = randomUUID();
+    r;
+    constructor(deps, input) {
+        this.deps = deps;
+        this.input = input;
+    }
+    now() { return (this.deps.now?.() ?? new Date()).toISOString(); }
+    current() {
+        const record = this.deps.store.load(this.r.id);
+        if (!record)
+            throw new Error("Desktop creation operation not found");
+        return record;
+    }
+    claim() {
+        let claimed = false;
+        const input = this.input;
+        this.r = this.deps.store.update(input.operationId, old => {
+            if (old) {
+                if (old.controllerSession !== input.controllerSession || (!input.resume && !isDeepStrictEqual(old.input, input.input))
+                    || (input.resume && input.input !== undefined && !isDeepStrictEqual(old.input, input.input))) {
+                    throw new Error("Desktop creation operation belongs to different immutable input or controller");
+                }
+                if (["failed", "uncertain"].includes(old.status)
+                    || old.worker && (this.deps.isProcessAlive ?? processAlive)(old.worker.pid))
+                    return old;
+            }
+            else if (input.resume || !input.input) {
+                throw new Error("Desktop creation operation not found; recovery cannot create a new conversation");
+            }
+            const next = old ?? { schema: "agent-knock-knock/desktop-creation", version: 1, id: input.operationId,
+                controllerSession: input.controllerSession, input: input.input, status: "prepared", createdAt: this.now(), updatedAt: this.now() };
+            next.worker = { token: this.token, pid: this.deps.processId ?? process.pid, startedAt: this.now() };
+            next.updatedAt = this.now();
+            claimed = true;
+            return next;
+        });
+        return claimed;
+    }
+    update(change) {
+        return this.deps.store.update(this.r.id, latest => {
+            if (!latest || latest.worker?.token !== this.token)
+                throw new Error("Desktop creation invocation lost its reservation");
+            change(latest);
+            latest.updatedAt = this.now();
+            return latest;
+        });
+    }
+    recordError(error, status) {
+        return this.update(latest => {
+            if (latest.status === "uncertain")
+                return;
+            latest.errorCode = errorCode(error);
+            if (identityErrors.has(latest.errorCode))
+                latest.status = "uncertain";
+            else if (status)
+                latest.status = status;
+        });
+    }
+    async run() {
+        if (!this.claim())
+            return this.r;
+        try {
+            if (this.r.status === "prepared")
+                await this.create();
+            else if (this.r.status === "creating" && !this.r.threadId) {
+                this.update(latest => { latest.status = "uncertain"; latest.errorCode = "creation_receipt_missing"; });
+            }
+            else if (["creating", "created", "opening"].includes(this.r.status))
+                await this.verifyCreated();
+            this.r = this.current();
+            if (["created", "opening"].includes(this.r.status) && !this.r.errorCode)
+                await this.handoff();
+            this.r = this.current();
+            if (this.r.status === "ready" && this.r.input.request && !this.r.watchId) {
+                try {
+                    this.update(latest => { latest.requestState = "uncertain"; });
+                    const task = await this.deps.tasks.send({ target: identity(this.r), desktopId: createDesktopConversationId(identity(this.r)),
+                        controllerSession: this.r.controllerSession, messageId: this.r.id, text: this.r.input.request,
+                        timeoutMs: this.r.input.timeoutMs, callbackRoute: this.r.input.callbackRoute, requireEmptyThread: true });
+                    this.update(latest => {
+                        latest.watchId = task.id;
+                        latest.requestState = task.send_intent?.state === "accepted" ? "accepted"
+                            : task.send_intent?.state === "not_sent" ? "not_sent" : "uncertain";
+                        delete latest.errorCode;
+                    });
+                }
+                catch (error) {
+                    this.update(latest => {
+                        latest.errorCode = errorCode(error);
+                        if (error?.dispatchState === "not_sent")
+                            latest.requestState = "not_sent";
+                    });
+                }
+            }
+        }
+        finally {
+            // If a process dies, its PID remains on disk and the next invocation can reconcile exactly this UUID.
+            this.update(latest => { delete latest.worker; });
+        }
+        return this.current();
+    }
+    async create() {
+        let native, dispatched = false, completed = false;
+        try {
+            native = await this.deps.connect(this.r.input.codexHome);
+            let cwd = this.r.input.cwd, projectId, projectName;
+            if (this.r.input.project) {
+                const selected = await native.resolveProject({ ...(/^[0-9a-f-]{36}$/iu.test(this.r.input.project)
+                        ? { projectId: this.r.input.project } : { projectName: this.r.input.project }), ...(cwd ? { cwd } : {}) });
+                cwd = selected.cwd;
+                projectId = selected.project.id;
+                projectName = selected.project.name;
+            }
+            cwd ??= this.deps.defaultDirectory(this.r.id);
+            cwd = fs.realpathSync(cwd);
+            const receipt = await native.create({ cwd, projectId, title: this.r.input.title,
+                sandbox: "workspace-write", approvalPolicy: "on-request",
+                beforeDispatch: () => {
+                    this.update(latest => {
+                        if (latest.status !== "prepared")
+                            throw new Error("Creation already reserved");
+                        latest.status = "creating";
+                        latest.cwd = cwd;
+                        latest.projectId = projectId ?? null;
+                        latest.projectName = projectName;
+                        delete latest.errorCode;
+                        dispatched = true;
+                    });
+                },
+                onCreated: receipt => {
+                    const latest = this.update(record => {
+                        record.threadId = receipt.threadId;
+                        record.nativeTitle = receipt.title;
+                        try {
+                            validateReceipt(record, receipt);
+                        }
+                        catch {
+                            record.status = "uncertain";
+                            record.errorCode = "creation_identity_mismatch";
+                        }
+                    });
+                    if (latest.status === "uncertain")
+                        throw new DesktopCreationNativeError("creation_identity_mismatch", "Created Desktop identity differs", "created", receipt.threadId);
+                }
+            });
+            this.update(latest => { validateReceipt(latest, receipt); latest.threadId = receipt.threadId; latest.nativeTitle = receipt.title; });
+            completed = true;
+        }
+        catch (error) {
+            const latest = this.current();
+            if (latest.status !== "uncertain")
+                this.update(record => {
+                    const stage = error?.dispatchState;
+                    record.errorCode = errorCode(error);
+                    const threadId = error?.threadId;
+                    if (!record.threadId && typeof threadId === "string" && /^[0-9a-f-]{36}$/iu.test(threadId))
+                        record.threadId = threadId;
+                    record.status = identityErrors.has(record.errorCode) ? "uncertain"
+                        : record.threadId ? "creating" : dispatched && stage !== "not_sent" ? "uncertain" : "failed";
+                });
+        }
+        finally {
+            try {
+                await native?.close();
+            }
+            catch (error) {
+                completed = false;
+                this.recordError(error);
+            }
+        }
+        if (completed)
+            this.update(latest => { latest.status = "created"; delete latest.errorCode; });
+    }
+    async verifyCreated() {
+        let native, verified = false;
+        try {
+            native = await this.deps.connect(this.r.input.codexHome);
+            const receipt = await native.read(this.r.threadId);
+            validateReceipt(this.r, receipt);
+            this.update(latest => { latest.nativeTitle = receipt.title; });
+            verified = true;
+        }
+        catch (error) {
+            this.recordError(error);
+        }
+        finally {
+            try {
+                await native?.close();
+            }
+            catch (error) {
+                verified = false;
+                this.recordError(error);
+            }
+        }
+        if (verified)
+            this.update(latest => { latest.status = latest.openedAt ? "opening" : "created"; delete latest.errorCode; });
+    }
+    async handoff() {
+        this.r = this.current();
+        if (!this.r.openedAt) {
+            this.update(latest => { latest.openedAt = this.now(); latest.status = "opening"; });
+            try {
+                await this.deps.open(this.r.threadId);
+            }
+            catch (error) {
+                this.recordError(error);
+                return;
+            }
+        }
+        for (let attempt = 0; attempt < (this.deps.ownerAttempts ?? 3); attempt++) {
+            try {
+                const snapshot = await this.deps.observe(identity(this.r));
+                if (snapshot.threadId !== this.r.threadId || snapshot.cwd !== undefined && snapshot.cwd !== this.r.cwd) {
+                    throw Object.assign(new Error("Desktop owner identity is not verified"), { code: "desktop_identity_mismatch" });
+                }
+                if (!snapshot.ownerClientId || !snapshot.cwd || !snapshot.tailKnown) {
+                    throw Object.assign(new Error("Desktop owner is still loading"), { code: "desktop_owner_not_ready" });
+                }
+                this.update(latest => { latest.status = "ready"; delete latest.errorCode; });
+                return;
+            }
+            catch (error) {
+                const latest = this.recordError(error);
+                if (latest.status === "uncertain")
+                    return;
+            }
+            if (attempt + 1 < (this.deps.ownerAttempts ?? 3))
+                await (this.deps.sleep ?? (ms => new Promise(resolve => setTimeout(resolve, ms))))(300);
+        }
+    }
+}
+function validateReceipt(r, receipt) {
+    if (receipt.cwd !== r.cwd || receipt.projectId !== r.projectId || r.threadId && r.threadId !== receipt.threadId) {
+        throw new DesktopCreationNativeError("creation_identity_mismatch", "Created Desktop thread identity or project differs", "created", r.threadId);
+    }
+}
+//# sourceMappingURL=desktop-creation-service.js.map