@scotthuang/agent-knock-knock 0.14.4 → 0.14.6

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

@@ -0,0 +1,249 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { createDesktopCreationRpc, DesktopCreationRpcError } from "./desktop-creation-rpc.js";
+export const VERIFIED_DESKTOP_CREATION_BUILD = Object.freeze({
+    version: "26.1007.30912", build: "20156", backendVersion: "0.162.0-alpha.17.2"
+});
+export class DesktopCreationNativeError extends Error {
+    code;
+    dispatchState;
+    threadId;
+    requestId;
+    method;
+    constructor(code, message, dispatchState = "not_sent", threadId, requestId, method) {
+        super(message);
+        this.code = code;
+        this.dispatchState = dispatchState;
+        this.threadId = threadId;
+        this.requestId = requestId;
+        this.method = method;
+        this.name = "DesktopCreationNativeError";
+    }
+}
+const uuid = (value) => typeof value === "string"
+    && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu.test(value);
+const record = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+function fail(code, message) { throw new DesktopCreationNativeError(code, message); }
+function directory(value, label) {
+    if (typeof value !== "string" || !path.isAbsolute(value))
+        fail("invalid_argument", `${label} must be an absolute existing directory`);
+    try {
+        if (fs.statSync(value).isDirectory())
+            return fs.realpathSync(value);
+    }
+    catch { /* fail closed below */ }
+    return fail("invalid_argument", `${label} must be an absolute existing directory`);
+}
+function within(root, cwd) {
+    const relative = path.relative(root, cwd);
+    return relative === "" || (!path.isAbsolute(relative) && relative !== ".." && !relative.startsWith(`..${path.sep}`));
+}
+function inspectApplication(appPath) {
+    if (process.platform !== "darwin")
+        fail("incompatible_desktop", "Desktop creation requires the verified macOS application");
+    appPath = directory(appPath, "Desktop application");
+    const plist = path.join(appPath, "Contents", "Info.plist");
+    const read = (key) => execFileSync("/usr/libexec/PlistBuddy", ["-c", `Print :${key}`, plist], { encoding: "utf8", timeout: 3000, stdio: ["ignore", "pipe", "ignore"] }).trim();
+    try {
+        if (read("CFBundleIdentifier") !== "com.openai.codex")
+            fail("incompatible_desktop", "Desktop application identity is not Codex");
+        const appVersion = read("CFBundleShortVersionString"), appBuild = read("CFBundleVersion");
+        const binaryPath = fs.realpathSync(path.join(appPath, "Contents/Resources/codex-cli/CodexCLI.app/Contents/MacOS/codex"));
+        if (!within(appPath, binaryPath))
+            fail("incompatible_desktop", "Desktop bundled binary escapes its application");
+        const output = execFileSync(binaryPath, ["--version"], { encoding: "utf8", timeout: 5000,
+            stdio: ["ignore", "pipe", "ignore"] }).trim();
+        const backendVersion = /^codex-cli (\S+)$/u.exec(output)?.[1];
+        if (!backendVersion)
+            fail("incompatible_desktop", "Desktop bundled version is unavailable");
+        return { appPath, binaryPath, appVersion, appBuild, backendVersion };
+    }
+    catch (error) {
+        if (error instanceof DesktopCreationNativeError)
+            throw error;
+        return fail("incompatible_desktop", "Could not verify the installed Desktop application and bundled binary");
+    }
+}
+function project(value) {
+    if (!record(value) || !uuid(value.id) || typeof value.name !== "string" || !value.name.trim()
+        || !Array.isArray(value.roots))
+        fail("invalid_response", "Invalid Desktop project identity or roots");
+    const roots = value.roots.map(root => {
+        if (!record(root) || typeof root.path !== "string" || !path.isAbsolute(root.path)) {
+            return fail("invalid_response", "Invalid Desktop project root");
+        }
+        return root.path;
+    });
+    return { id: value.id, name: value.name, roots };
+}
+function thread(value, expectedId) {
+    if (!record(value) || !record(value.thread))
+        fail("invalid_response", "Desktop creation has no thread receipt");
+    const t = value.thread;
+    if (!uuid(t.id) || (expectedId && t.id !== expectedId) || typeof t.cwd !== "string" || !path.isAbsolute(t.cwd)
+        || !(t.projectId === null || uuid(t.projectId)) || t.ephemeral !== false
+        || !(t.name == null || typeof t.name === "string"))
+        fail("invalid_response", "Desktop thread identity is invalid or changed");
+    return { threadId: t.id, cwd: t.cwd, projectId: t.projectId,
+        title: typeof t.name === "string" ? t.name : null };
+}
+/** Creates metadata only. A user task must be sent through the original Desktop owner after handoff. */
+export async function createDesktopCreationNative(options) {
+    const codexHome = directory(options.codexHome, "Codex home");
+    const inspected = (options.inspectApplication ?? inspectApplication)(options.appPath ?? "/Applications/ChatGPT.app");
+    const verified = VERIFIED_DESKTOP_CREATION_BUILD;
+    if (options.compatibility.version !== verified.version || options.compatibility.build !== verified.build
+        || inspected.appVersion !== verified.version || inspected.appBuild !== verified.build
+        || inspected.backendVersion !== verified.backendVersion) {
+        fail("incompatible_desktop", "Desktop creation requires the verified application build and bundled backend");
+    }
+    const metadata = { ...inspected, codexHome };
+    let rpc;
+    try {
+        rpc = (options.rpcFactory ?? createDesktopCreationRpc)({ binaryPath: metadata.binaryPath, codexHome, timeoutMs: options.timeoutMs });
+    }
+    catch {
+        return fail("connection_failed", "Could not start the dedicated Desktop creation process");
+    }
+    try {
+        const initialized = await rpc.request("initialize", { clientInfo: {
+                name: "agent-knock-knock-desktop-create", title: "AKK Desktop creation", version: "1"
+            }, capabilities: { experimentalApi: true } });
+        if (!record(initialized) || typeof initialized.codexHome !== "string"
+            || directory(initialized.codexHome, "Backend Codex home") !== codexHome
+            || typeof initialized.userAgent !== "string"
+            || !initialized.userAgent.startsWith(`agent-knock-knock-desktop-create/${metadata.backendVersion} `)) {
+            fail("incompatible_desktop", "Desktop creation backend identity or Codex home does not match");
+        }
+        rpc.notifyInitialized();
+    }
+    catch (error) {
+        await rpc.close();
+        throw error;
+    }
+    return new DesktopCreationConnection(metadata, rpc);
+}
+class DesktopCreationConnection {
+    metadata;
+    rpc;
+    attempted = false;
+    creating = false;
+    constructor(metadata, rpc) {
+        this.metadata = metadata;
+        this.rpc = rpc;
+    }
+    async projects() {
+        const all = [], cursors = new Set(), ids = new Set();
+        let cursor;
+        for (let page = 0; page < 20; page++) {
+            const result = await this.rpc.request("project/list", { limit: 100, ...(cursor ? { cursor } : {}) });
+            if (!record(result) || !Array.isArray(result.data)
+                || !(result.nextCursor == null || typeof result.nextCursor === "string" && !!result.nextCursor)) {
+                fail("invalid_response", "Invalid Desktop project page");
+            }
+            for (const raw of result.data) {
+                const entry = project(raw);
+                if (ids.has(entry.id))
+                    fail("invalid_response", "Desktop project pages contain duplicate identities");
+                ids.add(entry.id);
+                all.push(entry);
+            }
+            if (result.nextCursor == null)
+                return all;
+            cursor = result.nextCursor;
+            if (cursors.has(cursor))
+                fail("invalid_response", "Desktop project pagination did not advance");
+            cursors.add(cursor);
+        }
+        return fail("project_list_incomplete", "Desktop project discovery exceeded its bounded page limit");
+    }
+    async resolveProject(selector) {
+        if ((!selector.projectId && !selector.projectName) || (selector.projectId && !uuid(selector.projectId))) {
+            fail("invalid_argument", "An exact Desktop project ID or name is required");
+        }
+        const matches = (await this.projects()).filter(entry => (!selector.projectId || entry.id === selector.projectId)
+            && (!selector.projectName || entry.name === selector.projectName));
+        if (matches.length !== 1)
+            fail(matches.length ? "ambiguous_project" : "project_not_found", "Desktop project must match exactly one result");
+        const listed = matches[0], response = await this.rpc.request("project/read", { projectId: listed.id });
+        const exact = project(record(response) ? response.project : undefined);
+        if (exact.id !== listed.id || exact.name !== listed.name
+            || JSON.stringify([...exact.roots].sort()) !== JSON.stringify([...listed.roots].sort())) {
+            fail("project_changed", "Desktop project changed during exact discovery");
+        }
+        const roots = [...new Set(exact.roots.map(root => directory(root, "Desktop project root")))];
+        if (!roots.length)
+            fail("project_cwd_mismatch", "Desktop project has no local working directory");
+        if (!selector.cwd && roots.length !== 1)
+            fail("ambiguous_project_root", "A Desktop project with multiple roots requires an explicit working directory");
+        const cwd = directory(selector.cwd ?? roots[0], "Working directory");
+        if (!roots.some(root => within(root, cwd)))
+            fail("project_cwd_mismatch", "Working directory is outside the selected Desktop project roots");
+        return { project: exact, cwd };
+    }
+    async read(threadId) {
+        if (!uuid(threadId))
+            fail("invalid_argument", "A precise Desktop thread UUID is required");
+        return thread(await this.rpc.request("thread/read", { threadId, includeTurns: false }), threadId);
+    }
+    close() { return this.rpc.close(); }
+    async create(input) {
+        if (this.creating || this.attempted)
+            fail("duplicate_creation", "Desktop creation was already attempted; it will not be repeated");
+        this.creating = true;
+        let createdId;
+        try {
+            const cwd = directory(input.cwd, "Working directory");
+            validateCreationInput(input);
+            if (input.projectId !== undefined)
+                await this.resolveProject({ projectId: input.projectId, cwd });
+            const result = await this.rpc.request("thread/start", { cwd, projectId: input.projectId ?? null,
+                threadSource: "user", ephemeral: false,
+                ...(input.approvalPolicy ? { approvalPolicy: input.approvalPolicy } : {}),
+                ...(input.sandbox ? { sandbox: input.sandbox } : {})
+            }, { beforeDispatch: async () => { await input.beforeDispatch?.(); this.attempted = true; } });
+            if (record(result) && record(result.thread) && uuid(result.thread.id))
+                createdId = result.thread.id;
+            const created = thread(result);
+            // Persist the acknowledged identity before naming/readback can fail or this process exits.
+            await input.onCreated?.(created);
+            if (created.cwd !== cwd || created.projectId !== (input.projectId ?? null))
+                fail("thread_target_mismatch", "Created Desktop thread has an unexpected project or working directory");
+            if (input.title)
+                await this.rpc.request("thread/name/set", { threadId: created.threadId, name: input.title });
+            const confirmed = await this.read(created.threadId);
+            verifyReadback(confirmed, cwd, created.projectId, input.title);
+            return confirmed;
+        }
+        catch (error) {
+            throw creationError(error, this.attempted, createdId);
+        }
+        finally {
+            this.creating = false;
+        }
+    }
+}
+function validateCreationInput(input) {
+    if (input.title !== undefined && (typeof input.title !== "string" || !input.title.trim() || [...input.title].length > 200)) {
+        fail("invalid_argument", "Desktop thread title must contain 1 to 200 characters");
+    }
+    if ((input.approvalPolicy !== undefined && !["on-request", "untrusted"].includes(input.approvalPolicy))
+        || (input.sandbox !== undefined && !["read-only", "workspace-write"].includes(input.sandbox))) {
+        fail("invalid_argument", "Desktop creation does not accept permission-bypass settings");
+    }
+}
+function verifyReadback(confirmed, cwd, projectId, title) {
+    if (confirmed.cwd !== cwd || confirmed.projectId !== projectId || (title && confirmed.title !== title)) {
+        fail("thread_target_mismatch", "Desktop thread readback does not match its creation receipt");
+    }
+}
+function creationError(error, attempted, createdId) {
+    const dispatched = error instanceof DesktopCreationRpcError ? error.requestDispatched : attempted;
+    const state = createdId ? "created" : dispatched ? "unknown" : "not_sent";
+    if (error instanceof DesktopCreationNativeError) {
+        return new DesktopCreationNativeError(error.code, error.message, state, createdId);
+    }
+    return new DesktopCreationNativeError(error instanceof DesktopCreationRpcError ? error.code : "creation_failed", "Desktop creation did not complete; inspect the dispatch state before taking any further action", state, createdId, error instanceof DesktopCreationRpcError ? error.requestId : undefined, error instanceof DesktopCreationRpcError ? error.method : undefined);
+}
+//# sourceMappingURL=desktop-creation-native.js.map

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

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

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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"}