@scotthuang/agent-knock-knock 0.13.18 → 0.14.1

package/dist/src/desktop-response-service.js.map

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

package/dist/src/desktop-response-store.d.ts

@@ -0,0 +1,35 @@
+import { type NativeRecordRepository } from "./codex-native-record-store.js";
+import { type DesktopResponseValue } from "./desktop-response-value.js";
+import type { DesktopInteraction, DesktopThreadIdentity } from "./desktop-types.js";
+export interface DesktopResponseRecord extends DesktopResponseValue {
+    schema: "agent-knock-knock/desktop-response";
+    version: 1;
+    revision: number;
+    id: string;
+    created_at: string;
+    updated_at: string;
+    target: DesktopThreadIdentity;
+    desktop_id: string;
+    controller_session: string;
+    response_id: string;
+    interaction: DesktopInteraction;
+    client_user_message_id?: string;
+    operation_id?: string;
+    baseline_item_status?: string;
+    state: "reserved" | "uncertain" | "sent" | "confirmed" | "not_sent";
+    attempts: number;
+    not_sent_history?: {
+        attempt: number;
+        observed_at: string;
+        error_code?: string;
+        baseline_item_status?: string;
+    }[];
+    evidence?: "exact_async_answer_observed" | "exact_blocking_answer_observed" | "exact_approval_item_advanced";
+    error_code?: string;
+}
+export type DesktopResponseRepository = NativeRecordRepository<DesktopResponseRecord>;
+export declare function desktopResponseId(target: DesktopThreadIdentity, interactionId: string): string;
+export declare function assertDesktopResponseIdentity(desktopId: string, target: DesktopThreadIdentity): void;
+export declare function createDesktopResponseStore(storeDir: string, locks: {
+    acquire(lockPath: string): () => void;
+}): DesktopResponseRepository;

package/dist/src/desktop-response-store.js

@@ -0,0 +1,58 @@
+import { createHash } from "node:crypto";
+import { isDeepStrictEqual } from "node:util";
+import { createNativeRecordRepository } from "./codex-native-record-store.js";
+import { parseDesktopConversationId } from "./desktop-identity.js";
+import { desktopNonblank } from "./desktop-async-state.js";
+import { assertDesktopInteraction } from "./desktop-interaction-state.js";
+import { validateDesktopResponseValue } from "./desktop-response-value.js";
+export function desktopResponseId(target, interactionId) {
+    const identity = { codexHome: target.codexHome, hostId: target.hostId, threadId: target.threadId };
+    return `desktop-response:${createHash("sha256").update(JSON.stringify([identity, interactionId])).digest("hex")}`;
+}
+const validTime = (value) => typeof value === "string" && Number.isFinite(Date.parse(value));
+export function assertDesktopResponseIdentity(desktopId, target) {
+    if (!isDeepStrictEqual(parseDesktopConversationId(desktopId), target))
+        throw new Error("Desktop response identity does not match its target");
+}
+function assertResponseLifecycle(record) {
+    if (!["reserved", "uncertain", "sent", "confirmed", "not_sent"].includes(record.state) ||
+        !validTime(record.created_at) || !validTime(record.updated_at) ||
+        !Number.isSafeInteger(record.attempts) || record.attempts < 1)
+        throw new Error("Invalid Desktop response lifecycle");
+    if (record.state === "confirmed" && !["exact_async_answer_observed", "exact_blocking_answer_observed", "exact_approval_item_advanced"].includes(record.evidence ?? ""))
+        throw new Error("Desktop response requires native evidence");
+    if (record.not_sent_history !== undefined && (!Array.isArray(record.not_sent_history) || record.not_sent_history.some(attempt => !Number.isSafeInteger(attempt.attempt) || attempt.attempt < 1 || !validTime(attempt.observed_at))))
+        throw new Error("Invalid Desktop response attempt history");
+}
+function assertDesktopResponse(value) {
+    const record = value;
+    if (!record || record.schema !== "agent-knock-knock/desktop-response" || record.version !== 1 ||
+        !Number.isSafeInteger(record.revision) || record.revision < 1 || !/^desktop-response:[a-f0-9]{64}$/.test(record.id) ||
+        !desktopNonblank(record.controller_session) || !desktopNonblank(record.response_id))
+        throw new Error("Invalid Desktop response record");
+    assertDesktopResponseIdentity(record.desktop_id, record.target);
+    assertDesktopInteraction(record.interaction, record.target);
+    validateDesktopResponseValue(record.interaction, record);
+    if (record.interaction.kind === "async_question" ? !desktopNonblank(record.client_user_message_id) : !desktopNonblank(record.operation_id)) {
+        throw new Error("Desktop response requires a durable dispatch correlation ID");
+    }
+    if (record.id !== desktopResponseId(record.target, record.interaction.id))
+        throw new Error("Desktop response record has a different interaction identity");
+    assertResponseLifecycle(record);
+}
+export function createDesktopResponseStore(storeDir, locks) {
+    return createNativeRecordRepository({ storeDir, directory: "desktop-responses", prefix: "desktop-response:", acquire: locks.acquire,
+        assert: assertDesktopResponse,
+        assertUpdate: (previous, next) => {
+            for (const key of ["id", "created_at", "target", "desktop_id", "controller_session", "response_id", "interaction", "answer", "response", "client_user_message_id", "operation_id"]) {
+                if (!isDeepStrictEqual(previous[key], next[key]))
+                    throw new Error("Desktop response intent cannot change");
+            }
+            if (previous.baseline_item_status !== next.baseline_item_status && !(previous.state === "not_sent" &&
+                next.state === "reserved" && next.attempts === previous.attempts + 1))
+                throw new Error("Desktop response baseline can change only for a proven not-sent retry");
+            if (previous.state === "confirmed" && next.state !== "confirmed")
+                throw new Error("Desktop answer proof cannot regress");
+        } });
+}
+//# sourceMappingURL=desktop-response-store.js.map

package/dist/src/desktop-response-store.js.map

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

package/dist/src/desktop-response-types.d.ts

@@ -0,0 +1,20 @@
+import type { DesktopResponseRepository } from "./desktop-response-store.js";
+import type { DesktopResponseValue } from "./desktop-response-value.js";
+import type { DesktopStateRepository } from "./desktop-state-store.js";
+import type { DesktopThreadIdentity, DesktopTransportPort } from "./desktop-types.js";
+export interface DesktopResponseInput extends DesktopResponseValue {
+    target: DesktopThreadIdentity;
+    desktopId: string;
+    controllerSession: string;
+    interactionId: string;
+    responseId: string;
+}
+export interface DesktopResponseDependencies {
+    repository: DesktopResponseRepository;
+    tasks: DesktopStateRepository;
+    observe: DesktopTransportPort["observe"];
+    answerAsync: NonNullable<DesktopTransportPort["answerAsync"]>;
+    respondRequest?: NonNullable<DesktopTransportPort["respondRequest"]>;
+    now?(): Date;
+    randomUUID?(): string;
+}

package/dist/src/desktop-response-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=desktop-response-types.js.map

package/dist/src/desktop-response-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-response-types.js","sourceRoot":"","sources":["../../src/desktop-response-types.ts"],"names":[],"mappings":""}

package/dist/src/desktop-response-value.d.ts

@@ -0,0 +1,6 @@
+import type { DesktopInteraction, DesktopRequestResponse } from "./desktop-types.js";
+export interface DesktopResponseValue {
+    answer?: string;
+    response?: DesktopRequestResponse;
+}
+export declare function validateDesktopResponseValue(interaction: DesktopInteraction, value: DesktopResponseValue): void;

package/dist/src/desktop-response-value.js

@@ -0,0 +1,31 @@
+import { isDeepStrictEqual } from "node:util";
+import { desktopNonblank } from "./desktop-async-state.js";
+import { desktopRequestResponse } from "./desktop-request-interactions.js";
+export function validateDesktopResponseValue(interaction, value) {
+    if (interaction.kind === "async_question") {
+        if (!desktopNonblank(value.answer) || value.response !== undefined)
+            throw new Error("Desktop async question requires one answer");
+        return;
+    }
+    if (value.answer !== undefined || !value.response || typeof value.response !== "object")
+        throw new Error("Desktop native request requires a typed response");
+    if (interaction.kind === "command_approval" || interaction.kind === "file_approval") {
+        if (!("decision" in value.response) || !["accept", "decline"].includes(value.response.decision) ||
+            Object.keys(value.response).length !== 1)
+            throw new Error("Desktop approval requires accept or decline");
+        return;
+    }
+    validateBlockingAnswers(interaction, value.response);
+    desktopRequestResponse(interaction, value.response);
+}
+function validateBlockingAnswers(interaction, response) {
+    if (!("answers" in response) || !response.answers || typeof response.answers !== "object" ||
+        Array.isArray(response.answers) || Object.keys(response).length !== 1)
+        throw new Error("Desktop blocking question requires answers");
+    const expectedIds = interaction.questions.map(question => question.id).sort();
+    if (!isDeepStrictEqual(Object.keys(response.answers).sort(), expectedIds) ||
+        Object.values(response.answers).some(answers => !Array.isArray(answers) || !answers.length || answers.some(answer => !desktopNonblank(answer)))) {
+        throw new Error("Desktop answers must address the exact native question IDs");
+    }
+}
+//# sourceMappingURL=desktop-response-value.js.map

package/dist/src/desktop-response-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-response-value.js","sourceRoot":"","sources":["../../src/desktop-response-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAK3E,MAAM,UAAU,4BAA4B,CAAC,WAA+B,EAAE,KAA2B;IACvG,IAAI,WAAW,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC1C,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAClI,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAC7J,IAAI,WAAW,CAAC,IAAI,KAAK,kBAAkB,IAAI,WAAW,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACpF,IAAI,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC7F,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC3G,OAAO;IACT,CAAC;IACD,uBAAuB,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrD,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,uBAAuB,CAAC,WAA+B,EAAE,QAAgC;IAChG,IAAI,CAAC,CAAC,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;QACvF,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACvI,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9E,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC;QACvE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAClJ,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,153 @@
+import { DesktopSessionCatalog } from "./desktop-session-catalog.js";
+import type { DesktopCompatibility, DesktopThreadIdentity, DesktopTransportPort } from "./desktop-types.js";
+export interface DesktopRuntimeOptions {
+    storeDir: string;
+    codexHomes: string[];
+    openclawBin?: string;
+}
+/** Read the installed application, never substitute the globally installed CLI version. */
+export declare function installedDesktopCompatibility(): DesktopCompatibility;
+export declare function desktopWritesVerified(version: DesktopCompatibility): boolean;
+/** A command owns one connection per thread. No CLI resume or owner acquisition fallback. */
+export declare function createDesktopRuntime(options: DesktopRuntimeOptions): {
+    catalog: DesktopSessionCatalog;
+    compatibility: DesktopCompatibility;
+    tasks: import("./desktop-task-service.js").DesktopTaskService;
+    responses: {
+        respond: (input: import("./desktop-response-types.js").DesktopResponseInput) => Promise<import("./desktop-response-store.js").DesktopResponseRecord>;
+        reconcile: (id: string) => Promise<import("./desktop-response-store.js").DesktopResponseRecord>;
+        status: (id: string) => import("./desktop-response-store.js").DesktopResponseRecord;
+        list: () => import("./desktop-response-store.js").DesktopResponseRecord[];
+        respondWatch(watchId: string, input: Omit<import("./desktop-response-types.js").DesktopResponseInput, "target" | "desktopId">): Promise<import("./desktop-response-store.js").DesktopResponseRecord>;
+    };
+    transport: DesktopTransportPort;
+    controls: {
+        permissionOptions: (identity: DesktopThreadIdentity) => Promise<{
+            scope: string;
+            current: import("./desktop-session-controls.js").DesktopPermissionMode | null;
+            defaults_changed: boolean;
+            settings: {
+                activePermissionProfile: {
+                    id: string;
+                    extends?: string | null;
+                } | null | undefined;
+                approvalPolicy: string | Record<string, unknown> | undefined;
+                approvalsReviewer: string | undefined;
+                sandboxPolicy: Record<string, unknown> | undefined;
+                runtimeWorkspaceRoots: string[] | undefined;
+            } | undefined;
+            applies_to: string;
+            choices: {
+                id: import("./desktop-session-controls.js").DesktopPermissionMode;
+                mode: import("./desktop-session-controls.js").DesktopPermissionMode;
+                label: "Default" | "Full Access" | "Read Only";
+                description: string;
+            }[];
+        }>;
+        setPermissions: (identity: DesktopThreadIdentity, mode: import("./desktop-session-controls.js").DesktopPermissionMode) => Promise<{
+            scope: string;
+            defaults_changed: boolean;
+            requested: {
+                mode: import("./desktop-session-controls.js").DesktopPermissionMode;
+            };
+            applied: boolean;
+            do_not_retry: boolean;
+            outcome: string;
+            effective: {
+                mode: import("./desktop-session-controls.js").DesktopPermissionMode;
+            };
+        } | {
+            scope: string;
+            defaults_changed: boolean;
+            requested: {
+                mode: import("./desktop-session-controls.js").DesktopPermissionMode;
+            };
+            applied: boolean;
+            do_not_retry: boolean;
+            outcome: string;
+            error_code: string;
+        } | {
+            scope: string;
+            defaults_changed: boolean;
+            requested: {
+                mode: import("./desktop-session-controls.js").DesktopPermissionMode;
+            };
+            applied: boolean;
+            do_not_retry: boolean;
+            outcome: string;
+            effective: {
+                mode: import("./desktop-session-controls.js").DesktopPermissionMode;
+            };
+            applies_to: string;
+            settings: {
+                activePermissionProfile: {
+                    id: string;
+                    extends?: string | null;
+                } | null | undefined;
+                approvalPolicy: string | Record<string, unknown> | undefined;
+                approvalsReviewer: string | undefined;
+                sandboxPolicy: Record<string, unknown> | undefined;
+                runtimeWorkspaceRoots: string[] | undefined;
+            } | undefined;
+        }>;
+        modelOptions: (identity: DesktopThreadIdentity) => Promise<{
+            scope: string;
+            current: {
+                model: string | null;
+                reasoning_effort: string | null;
+                collaboration_mode: string | null;
+            };
+            model_provider: string | null | undefined;
+            catalog_available: boolean;
+            selection_mode: string;
+            collaboration_modes: string[];
+            limitations: string[];
+        }>;
+        setModel: (identity: DesktopThreadIdentity, selection: import("./desktop-session-controls.js").DesktopModelSelection) => Promise<{
+            scope: string;
+            defaults_changed: boolean;
+            requested: {
+                model: string;
+                reasoning_effort: string;
+                collaboration_mode?: "default" | "plan" | undefined;
+            };
+            applied: boolean;
+            do_not_retry: boolean;
+            outcome: string;
+            effective: {
+                model: string | null;
+                reasoning_effort: string | null;
+                collaboration_mode: string | null;
+            };
+        } | {
+            scope: string;
+            defaults_changed: boolean;
+            requested: {
+                model: string;
+                reasoning_effort: string;
+                collaboration_mode?: "default" | "plan" | undefined;
+            };
+            applied: boolean;
+            do_not_retry: boolean;
+            outcome: string;
+            error_code: string;
+        }>;
+        interrupt: (identity: DesktopThreadIdentity, expectedTurnId: string) => Promise<{
+            error_code?: undefined;
+            native_turn_id: string;
+            interrupted: boolean;
+            state: import("./desktop-types.js").DesktopTurnStatus;
+            outcome: string;
+            do_not_retry: boolean;
+        } | {
+            native_turn_id: string;
+            interrupted: boolean;
+            state: string;
+            outcome: string;
+            do_not_retry: boolean;
+            error_code: string;
+        }>;
+    };
+    close(): Promise<void>;
+};
+export type DesktopRuntime = ReturnType<typeof createDesktopRuntime>;

package/dist/src/desktop-runtime.js

@@ -0,0 +1,88 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { DesktopIpcClient, VERIFIED_DESKTOP_BUILD } from "./desktop-ipc-client.js";
+import { DesktopSessionCatalog } from "./desktop-session-catalog.js";
+import { createDesktopStateStore } from "./desktop-state-store.js";
+import { createDesktopTaskService } from "./desktop-task-service.js";
+import { createDesktopResponseStore } from "./desktop-response-store.js";
+import { createDesktopSessionControls } from "./desktop-session-controls.js";
+import { createDesktopResponseService } from "./desktop-response-service.js";
+import { createFileLockCliAdapter } from "./file-lock-cli-adapter.js";
+import { createOpenClawCallbackTransport } from "./openclaw-callback-transport.js";
+import { createHostProfileCallbackTransport } from "./host-profile-callback-transport.js";
+import { cliCwd, cliEnv, cliNow, cliNowMs, cliPid, cliSleepSync } from "./cli-runtime-context.js";
+/** Read the installed application, never substitute the globally installed CLI version. */
+export function installedDesktopCompatibility() {
+    const plist = "/Applications/ChatGPT.app/Contents/Info.plist";
+    if (process.platform !== "darwin" || !fs.existsSync(plist))
+        return { version: "unavailable", build: "unavailable" };
+    const read = (key) => execFileSync("/usr/libexec/PlistBuddy", ["-c", `Print :${key}`, plist], { encoding: "utf8", timeout: 3000 }).trim();
+    if (read("CFBundleIdentifier") !== "com.openai.codex")
+        return { version: "unavailable", build: "unavailable" };
+    return { version: read("CFBundleShortVersionString"), build: read("CFBundleVersion") };
+}
+export function desktopWritesVerified(version) {
+    return version.version === VERIFIED_DESKTOP_BUILD.version && version.build === VERIFIED_DESKTOP_BUILD.build;
+}
+/** A command owns one connection per thread. No CLI resume or owner acquisition fallback. */
+export function createDesktopRuntime(options) {
+    const compatibility = installedDesktopCompatibility();
+    const catalog = new DesktopSessionCatalog({ codexHomes: options.codexHomes });
+    const clients = new Map();
+    const homes = new Set(options.codexHomes.map(home => path.resolve(home)));
+    const clientFor = async (identity) => {
+        if (identity.hostId !== "local" || !homes.has(path.resolve(identity.codexHome))) {
+            throw new Error("Desktop target must belong to a configured local Codex home");
+        }
+        const key = JSON.stringify(identity);
+        let client = clients.get(key);
+        if (!client) {
+            client = DesktopIpcClient.connect({ socketPath: path.join(identity.codexHome, "ipc", "ipc.sock"), compatibility });
+            clients.set(key, client);
+        }
+        return client;
+    };
+    const transport = {
+        async observe(identity) {
+            const client = await clientFor(identity);
+            const owner = await client.discoverOwner(identity.threadId);
+            return client.observeThread({ threadId: identity.threadId, ownerClientId: owner.ownerClientId });
+        },
+        async start(identity, input) {
+            return (await clientFor(identity)).sendTurnOnce(input);
+        },
+        async answerAsync(identity, input) {
+            return (await clientFor(identity)).answerAsyncOnce(input);
+        },
+        async respondRequest(identity, input) {
+            return (await clientFor(identity)).respondRequestOnce(input);
+        }
+    };
+    const locks = createFileLockCliAdapter({ now: cliNow, nowMs: cliNowMs, pid: cliPid, sleepSync: cliSleepSync });
+    const repository = createDesktopStateStore(options.storeDir, { acquire: lock => locks.acquire(lock) });
+    const legacy = createOpenClawCallbackTransport({ now: cliNow, environment: cliEnv,
+        redactConversation: () => { throw new Error("Desktop callbacks do not use managed conversations"); },
+        recordCallbackProcessDelivery: () => { throw new Error("Desktop callbacks use their durable outbox"); } });
+    const callbacks = createHostProfileCallbackTransport({ legacyTransport: legacy, environment: cliEnv, cwd: cliCwd(), now: cliNow });
+    const tasks = createDesktopTaskService({ repository, ...transport, now: cliNow,
+        deliver: input => callbacks.deliver(input),
+        resolveCallbackContext: task => ({ legacyOptions: { gatewayMethod: "chat.send",
+                openclawSession: task.controller_session, gatewaySession: task.controller_session, openclawBin: options.openclawBin } }) });
+    const responses = createDesktopResponseService({ tasks: repository,
+        repository: createDesktopResponseStore(options.storeDir, { acquire: lock => locks.acquire(lock) }),
+        observe: transport.observe, answerAsync: transport.answerAsync, respondRequest: transport.respondRequest, now: cliNow });
+    const controls = createDesktopSessionControls({ observe: transport.observe,
+        readModelSettings: async (identity, target) => (await clientFor(identity)).readModelSettings(target),
+        updateSettings: async (identity, input) => (await clientFor(identity)).updateThreadSettingsOnce(input),
+        interruptTurn: async (identity, input) => (await clientFor(identity)).interruptTurnOnce(input) });
+    return { catalog, compatibility, tasks, responses, transport, controls,
+        async close() { for (const client of clients.values()) {
+            try {
+                (await client).close();
+            }
+            catch { /* failed connection */ }
+        } }
+    };
+}
+//# sourceMappingURL=desktop-runtime.js.map

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

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

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

@@ -0,0 +1,21 @@
+/** Separate Desktop addressing from all terminal/managed-turn authority paths. */
+export declare function desktopSendToolArgs(params: Record<string, unknown>, config: Record<string, unknown>, context: {
+    sessionKey?: unknown;
+}, messageId?: string): string[] | undefined;
+export declare function desktopWatchTarget(params: Record<string, unknown>): string | undefined;
+export declare function isDesktopWatchId(value: unknown): value is string;
+export declare function validatedDesktopWatchId(value: unknown): string | undefined;
+/** Desktop answers retain their own subject and never borrow terminal authority. */
+export declare function desktopInteractionToolArgs(api: object, params: Record<string, unknown>, config: Record<string, unknown>, context: {
+    sessionKey?: unknown;
+    sessionId?: unknown;
+}): string[] | undefined;
+export declare function desktopApprovalToolArgs(api: object, params: Record<string, unknown>, config: Record<string, unknown>, context: {
+    sessionKey?: unknown;
+    sessionId?: unknown;
+}): string[] | undefined;
+export declare function rememberDisplayedDesktopInteractionOffers(api: object, context: {
+    sessionKey?: unknown;
+    sessionId?: unknown;
+}, result: unknown): void;
+export declare function isDesktopInteractionResponseError(value: unknown): boolean;

package/dist/src/desktop-semantic.js

@@ -0,0 +1,140 @@
+import { consumeSemanticPrivateAuthorityOffer, rememberSemanticPrivateAuthorityOffer, semanticInteractionAuthorityOfferKey, invalidateSemanticInteractionAuthorityOffersForSubject } from "./semantic-private-authority-offers.js";
+import { desktopInteractionIsApproval, validateDesktopInteractionProjections, validateDesktopProjectedAnswer } from "./desktop-interaction-projection.js";
+import { isRecord } from "./value-guards.js";
+import { isDesktopConversationId, parseDesktopConversationId } from "./desktop-identity.js";
+import { requiredString, pushOptional, numberString, requiredTerminalInteractionIdentifier } from "./semantic-tool-arguments.js";
+import { resolvePluginStoreDir } from "./semantic-tool-command-helpers.js";
+/** Separate Desktop addressing from all terminal/managed-turn authority paths. */
+export function desktopSendToolArgs(params, config, context, messageId) {
+    if (!Object.hasOwn(params, "conversation_id"))
+        return undefined;
+    const id = requiredString(params.conversation_id, "conversation_id");
+    if (!isDesktopConversationId(id))
+        throw new Error("Send conversation_id must be an exact Desktop ID from List");
+    parseDesktopConversationId(id);
+    if (["turn_id", "terminal_id", "session_id"].some(key => Object.hasOwn(params, key))) {
+        throw new Error("Desktop Send accepts one conversation_id and no other target");
+    }
+    if (params.type !== undefined && params.type !== "task")
+        throw new Error("Desktop v1 sends tasks only");
+    const args = ["send", "--conversation", id, "--message", requiredString(params.request, "request"), "--background",
+        "--openclaw-session", requiredString(context.sessionKey, "controller session")];
+    args.push("--message-id", requiredString(messageId, "stable Desktop tool call identity"));
+    pushOptional(args, "--store-dir", resolvePluginStoreDir(config));
+    pushOptional(args, "--openclaw-bin", config.openclawBin);
+    pushOptional(args, "--codex-home", config.codexHome);
+    pushOptional(args, "--agent-hard-timeout-minutes", numberString(params.agentHardTimeoutMinutes) ?? numberString(config.agentHardTimeoutMinutes));
+    return args;
+}
+export function desktopWatchTarget(params) {
+    if (!Object.hasOwn(params, "conversation_id"))
+        return undefined;
+    if (Object.hasOwn(params, "terminal_id"))
+        throw new Error("Watch accepts one terminal_id or Desktop conversation_id");
+    const id = requiredString(params.conversation_id, "conversation_id");
+    parseDesktopConversationId(id);
+    return id;
+}
+export function isDesktopWatchId(value) {
+    return typeof value === "string" && /^desktop-watch:[A-Za-z0-9_-]{8,128}$/u.test(value);
+}
+export function validatedDesktopWatchId(value) {
+    if (typeof value !== "string" || !value.startsWith("desktop-watch:"))
+        return undefined;
+    if (!isDesktopWatchId(value))
+        throw new Error("Invalid Desktop Watch ID");
+    return value;
+}
+/** Desktop answers retain their own subject and never borrow terminal authority. */
+export function desktopInteractionToolArgs(api, params, config, context) {
+    const subject = desktopInteractionSubject(params);
+    if (!subject)
+        return undefined;
+    const sessionKey = requiredString(context.sessionKey, "controller session");
+    const sessionId = requiredString(context.sessionId, "controller conversation incarnation");
+    const interactionId = requiredTerminalInteractionIdentifier(params.interaction_id, "interaction_id");
+    if (Object.keys(params).some(key => !["conversation_id", "watch_id", "interaction_id", "answers", "delivery_mode"].includes(key))) {
+        throw new Error("Desktop answers accept only an exact subject and typed answer");
+    }
+    const { projection, fingerprint } = consumeDesktopOffer(api, subject, sessionKey, sessionId, interactionId);
+    const response = { interaction_id: interactionId, answers: params.answers,
+        ...(params.delivery_mode === undefined ? {} : { delivery_mode: params.delivery_mode }) };
+    validateDesktopProjectedAnswer(projection, response);
+    const args = ["respond-interaction", subject.kind === "desktop_watch" ? "--watch" : "--conversation", subject.id,
+        "--interaction", interactionId, "--response-json", JSON.stringify(response),
+        "--expected-interaction-fingerprint", fingerprint, "--expected-interaction-expires-at", projection.expires_at,
+        "--openclaw-session", sessionKey];
+    pushOptional(args, "--store-dir", resolvePluginStoreDir(config));
+    pushOptional(args, "--codex-home", config.codexHome);
+    return args;
+}
+export function desktopApprovalToolArgs(api, params, config, context) {
+    const subject = desktopInteractionSubject(params);
+    if (!subject)
+        return undefined;
+    if (Object.keys(params).some(key => !["conversation_id", "watch_id", "interaction_id", "decision"].includes(key)))
+        throw new Error("Unexpected Desktop approval parameters");
+    const decision = params.decision ?? "approve_once";
+    if (decision !== "approve_once" && decision !== "reject")
+        throw new Error("decision must be approve_once or reject");
+    const sessionKey = requiredString(context.sessionKey, "controller session");
+    const interactionId = requiredTerminalInteractionIdentifier(params.interaction_id, "interaction_id");
+    const { projection, fingerprint } = consumeDesktopOffer(api, subject, sessionKey, requiredString(context.sessionId, "controller conversation incarnation"), interactionId);
+    if (!desktopInteractionIsApproval(projection))
+        throw new Error("Current Desktop interaction is not an approval");
+    const args = ["approve", subject.kind === "desktop_watch" ? "--watch" : "--conversation", subject.id,
+        "--interaction", interactionId, "--decision", decision, "--expected-interaction-fingerprint", fingerprint,
+        "--expected-interaction-expires-at", projection.expires_at, "--openclaw-session", sessionKey];
+    pushOptional(args, "--store-dir", resolvePluginStoreDir(config));
+    pushOptional(args, "--codex-home", config.codexHome);
+    return args;
+}
+function consumeDesktopOffer(api, subject, sessionKey, sessionId, interactionId) {
+    const offer = consumeSemanticPrivateAuthorityOffer(api, semanticInteractionAuthorityOfferKey(sessionKey, sessionId, subject.kind, subject.id, interactionId));
+    if (!offer || typeof offer.fingerprint !== "string" || !/^[0-9a-f]{64}$/u.test(offer.fingerprint)) {
+        throw new Error("Refresh AKK Status for this Desktop conversation or Watch, then answer its current question or approval");
+    }
+    const projections = validateDesktopInteractionProjections([offer.interaction_state], offer.desktop_id, subject.kind === "desktop_watch" ? subject.id : undefined);
+    return { projection: projections[0], fingerprint: offer.fingerprint };
+}
+function desktopInteractionSubject(params) {
+    const conversation = typeof params.conversation_id === "string" && isDesktopConversationId(params.conversation_id)
+        ? params.conversation_id : undefined;
+    const watch = validatedDesktopWatchId(params.watch_id);
+    if (!conversation && !watch)
+        return undefined;
+    if (["terminal_id", "session_id", "turn_id"].some(key => Object.hasOwn(params, key))
+        || (conversation && Object.hasOwn(params, "watch_id")) || (watch && Object.hasOwn(params, "conversation_id"))) {
+        throw new Error("Desktop interaction accepts exactly one conversation_id or watch_id");
+    }
+    if (conversation)
+        parseDesktopConversationId(conversation);
+    return { kind: watch ? "desktop_watch" : "desktop_conversation", id: watch ?? conversation };
+}
+export function rememberDisplayedDesktopInteractionOffers(api, context, result) {
+    if (!isRecord(result) || result.source !== "codex_desktop" || !isDesktopConversationId(result.conversation_id)
+        || typeof context.sessionKey !== "string" || typeof context.sessionId !== "string")
+        return;
+    // Status Watch results include both identities; only its exact Watch is the response subject.
+    const watch = validatedDesktopWatchId(result.watch_id);
+    const kind = watch ? "desktop_watch" : "desktop_conversation";
+    const id = watch ?? String(result.conversation_id);
+    invalidateSemanticInteractionAuthorityOffersForSubject(api, context.sessionKey, context.sessionId, kind, id);
+    let projections;
+    try {
+        projections = validateDesktopInteractionProjections(result.interaction_state ?? [], result.conversation_id, watch, result.native_turn_id);
+    }
+    catch {
+        return;
+    }
+    for (const projection of projections) {
+        const fingerprint = projection.interaction_prompt_fingerprint;
+        if (!/^[0-9a-f]{64}$/u.test(fingerprint))
+            continue;
+        rememberSemanticPrivateAuthorityOffer(api, semanticInteractionAuthorityOfferKey(context.sessionKey, context.sessionId, kind, id, projection.interaction_id), { fingerprint, desktop_id: result.conversation_id, interaction_state: projection });
+    }
+}
+export function isDesktopInteractionResponseError(value) {
+    return isRecord(value) && value.source === "codex_desktop" && ["not_sent", "uncertain", "reserved"].includes(String(value.state));
+}
+//# sourceMappingURL=desktop-semantic.js.map