@scotthuang/agent-knock-knock 0.13.17 → 0.14.0

package/dist/src/desktop-async-state.d.ts

@@ -0,0 +1,5 @@
+import type { DesktopAsyncInteraction, DesktopThreadIdentity } from "./desktop-types.js";
+export declare function desktopNonblank(value: unknown): value is string;
+/** Persist native question identity, not a connection-local owner or a UI position. */
+export declare function assertDesktopAsyncInteraction(value: unknown, target?: DesktopThreadIdentity, turnId?: string): asserts value is DesktopAsyncInteraction;
+export declare function persistDesktopAsyncInteraction(interaction: DesktopAsyncInteraction): DesktopAsyncInteraction;

package/dist/src/desktop-async-state.js

@@ -0,0 +1,53 @@
+import { createHash } from "node:crypto";
+export function desktopNonblank(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function assertAsyncIdentity(value) {
+    const interaction = value;
+    if (!interaction || interaction.kind !== "async_question" || interaction.method !== "request_user_input_async" ||
+        !desktopNonblank(interaction.id) || !desktopNonblank(interaction.threadId) || !desktopNonblank(interaction.turnId) ||
+        !desktopNonblank(interaction.itemId) || !Array.isArray(interaction.questions) || interaction.questions.length !== 1) {
+        throw new Error("Invalid Desktop async interaction");
+    }
+}
+function assertAsyncQuestion(interaction) {
+    const question = interaction.questions[0];
+    if (!question || !desktopNonblank(question.id) || !desktopNonblank(question.title) ||
+        question.isOther !== true || !Array.isArray(question.options) || question.options.some(option => !desktopNonblank(option))) {
+        throw new Error("Invalid Desktop async question");
+    }
+}
+function assertNativeQuestionTuple(interaction) {
+    const question = interaction.questions[0];
+    let nativeId;
+    try {
+        nativeId = JSON.parse(question.id);
+    }
+    catch {
+        throw new Error("Invalid Desktop native question identity");
+    }
+    if (!Array.isArray(nativeId) || nativeId.length !== 3 || nativeId[0] !== "request_user_input_async" ||
+        nativeId[1] !== interaction.itemId || !Number.isSafeInteger(nativeId[2]) || nativeId[2] < 0 ||
+        JSON.stringify(nativeId) !== question.id)
+        throw new Error("Desktop native question identity does not match its item");
+}
+/** Persist native question identity, not a connection-local owner or a UI position. */
+export function assertDesktopAsyncInteraction(value, target, turnId) {
+    assertAsyncIdentity(value);
+    const interaction = value;
+    if (target && interaction.threadId !== target.threadId || turnId && interaction.turnId !== turnId) {
+        throw new Error("Desktop async interaction belongs to a different native task");
+    }
+    assertAsyncQuestion(interaction);
+    assertNativeQuestionTuple(interaction);
+    const question = interaction.questions[0];
+    const hash = createHash("sha256").update(JSON.stringify([interaction.threadId, interaction.turnId, interaction.itemId,
+        question.id, question.title, question.options])).digest("hex");
+    if (interaction.id !== `desktop-async-interaction:${hash}`)
+        throw new Error("Desktop async interaction payload does not match its identity");
+}
+export function persistDesktopAsyncInteraction(interaction) {
+    assertDesktopAsyncInteraction(interaction);
+    return structuredClone(interaction);
+}
+//# sourceMappingURL=desktop-async-state.js.map

package/dist/src/desktop-async-state.js.map

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

package/dist/src/desktop-cli-adapter.d.ts

@@ -0,0 +1,7 @@
+import { type DesktopRuntimeOptions } from "./desktop-runtime.js";
+type Options = Record<string, unknown>;
+export declare function desktopRuntimeOptions(options: Options): DesktopRuntimeOptions;
+export declare function desktopListForCli(options: Options): Promise<Record<string, unknown>>;
+/** Return false only for non-Desktop targets. Unsupported Desktop actions never fall through to terminals. */
+export declare function dispatchDesktopCli(command: string | undefined, options: Options): Promise<boolean>;
+export {};

package/dist/src/desktop-cli-adapter.js

@@ -0,0 +1,322 @@
+import { assertBackendRecoveryCliTarget } from "./backend-recovery-semantic.js";
+import { desktopObservationStopped } from "./desktop-task-recovery.js";
+import { desktopControlForCli } from "./desktop-cli-controls.js";
+import os from "node:os";
+import path from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+import { cliCwd, cliEnv, cliDependencies, writeCliStdout } from "./cli-runtime-context.js";
+import { isDesktopConversationId, parseDesktopConversationId } from "./desktop-identity.js";
+import { isDesktopWatchId } from "./desktop-semantic.js";
+import { createDesktopRuntime, desktopWritesVerified } from "./desktop-runtime.js";
+import { createTerminalWatchOpenClawCallbackRoute, parseCallbackRoute } from "./callback-transport.js";
+import { desktopResponseId } from "./desktop-response-store.js";
+import { desktopInteractionFingerprint, desktopInteractionIsApproval, desktopQuestionAnswer, desktopQuestionResponse } from "./desktop-interaction-projection.js";
+import { desktopSessionProjection, desktopTaskProjection } from "./desktop-public-projection.js";
+import { desktopTaskNeedsReconciliation } from "./desktop-task-service.js";
+import { listDesktopSessions } from "./desktop-list.js";
+import { launchDesktopMonitor, runDesktopMonitor } from "./desktop-monitor.js";
+import { DesktopIpcError } from "./desktop-types.js";
+const NATIVE_COMMANDS = ["desktop-list", "monitor-desktop", "reconcile-desktop-watches"];
+const RECOVERY_COMMANDS = ["close", "renew", "recover", "retry-callback"];
+const SUPPORTED_COMMANDS = [...NATIVE_COMMANDS, ...RECOVERY_COMMANDS, "send", "status", "watch-terminal", "watch-status", "unwatch-terminal", "respond-interaction", "approve", "native-inspect", "permission-options", "set-permissions", "model-options", "set-model", "cancel"];
+const str = (value) => typeof value === "string" && value.trim() ? value : undefined;
+const required = (value, label) => {
+    const result = str(value);
+    if (!result)
+        throw new Error(`Desktop ${label} is required`);
+    return result;
+};
+const output = (value) => writeCliStdout(JSON.stringify(value, null, 2) + "\n");
+export function desktopRuntimeOptions(options) {
+    const env = cliEnv();
+    const home = env.HOME ?? os.homedir();
+    const resolve = (value) => path.resolve(cliCwd(), value.startsWith("~/") ? path.join(home, value.slice(2)) : value);
+    let homes = [path.join(home, ".codex"), ...(str(options.codexHome) ? [str(options.codexHome)] : env.CODEX_HOME ? [env.CODEX_HOME] : [])];
+    if (env.AKK_DESKTOP_CODEX_HOMES) {
+        const saved = JSON.parse(env.AKK_DESKTOP_CODEX_HOMES);
+        if (!Array.isArray(saved) || !saved.length || saved.some(item => typeof item !== "string" || !path.isAbsolute(item))) {
+            throw new Error("Invalid configured Desktop homes");
+        }
+        homes = saved;
+    }
+    return { storeDir: resolve(str(options.storeDir ?? options.logDir) ?? path.join(home, ".agent-knock-knock", "store")),
+        codexHomes: [...new Set(homes.map(resolve))], openclawBin: str(options.openclawBin) };
+}
+export async function desktopListForCli(options) {
+    if (options.agent && options.agent !== "codex")
+        return { desktop_sessions: [], desktop_watches: [], desktop_scan: { status: "filtered" } };
+    const runtime = (cliDependencies().createDesktopRuntime ?? createDesktopRuntime)(desktopRuntimeOptions(options));
+    try {
+        return await listDesktopSessions(runtime, options);
+    }
+    finally {
+        await runtime.close();
+    }
+}
+async function reconcileDesktopWatches(runtime) {
+    const before = new Map();
+    try {
+        for (const task of runtime.tasks.list())
+            before.set(task.id, task);
+    }
+    catch { /* reconcileAll isolates damaged records */ }
+    const result = await runtime.tasks.reconcileAll();
+    const callbacksDelivered = result.tasks.reduce((count, task) => count + task.notifications.filter(note => note.status === "accepted" && !before.get(task.id)?.notifications.some(old => old.id === note.id && old.status === "accepted")).length, 0);
+    output({
+        checked: result.tasks.length + result.errors.length,
+        changed: result.tasks.filter(task => task.status !== before.get(task.id)?.status).length,
+        callbacks_delivered: callbacksDelivered,
+        errors: result.errors.length,
+        diagnostics: result.errors
+    });
+}
+async function inspectOrStopDesktopWatch(runtime, command, options, watch, target) {
+    if (target || options.turn && (options.watch !== undefined || options.turn !== watch))
+        throw new Error("Desktop Watch accepts exactly one target");
+    const task = runtime.tasks.status(watch);
+    const controller = str(options.openclawSession);
+    if (controller && controller !== task.controller_session)
+        throw new Error("Desktop Watch belongs to a different controller");
+    if (command === "cancel") {
+        if (desktopObservationStopped(task))
+            throw new Error("Desktop Watch observation has stopped");
+        if (!task.native_turn_id)
+            throw new Error("Desktop Watch has no exact native task to interrupt");
+        required(controller, "controller session");
+        const result = await desktopControlForCli(runtime, command, { ...options, expectedNativeTurnId: task.native_turn_id }, { id: task.desktop_id, identity: task.target }, watch);
+        output(result);
+    }
+    else if (command === "unwatch-terminal") {
+        output(desktopTaskProjection(runtime.tasks.unwatch(watch, { controllerSession: required(controller, "controller session") })));
+    }
+    else if (command === "watch-status" || command === "status") {
+        const current = await runtime.tasks.reconcile(watch);
+        output({ ...desktopTaskProjection(current, desktopWritesVerified(runtime.compatibility)),
+            response_state: await desktopResponseStates(runtime, current.desktop_id, current.native_turn_id, controller) });
+    }
+    else
+        throw new Error("Desktop Watch ID is only valid for status or unwatch");
+}
+async function getDesktopConversation(runtime, options, target) {
+    const id = required(target, "conversation ID");
+    const identity = parseDesktopConversationId(id);
+    if (["conversation", "conversationId", "session", "terminal"].filter(key => options[key] !== undefined).length !== 1 || options.turn) {
+        throw new Error("Desktop command accepts exactly one conversation target");
+    }
+    const entry = await runtime.catalog.get(identity);
+    if (!entry)
+        throw new Error("Desktop conversation is absent from the configured local catalog; refresh List");
+    return { id, identity, entry };
+}
+function latestTurnProjection(turn) {
+    if (!turn)
+        return null;
+    const text = turn.items.filter(item => item.type === "agentMessage" &&
+        item.phase !== "analysis" && item.phase !== "commentary" && item.delivery !== "async").map(item => item.text ?? "").join("\n\n");
+    const isFinal = turn.itemsComplete && ["completed", "failed", "interrupted"].includes(turn.status);
+    return { id: turn.turnId, status: turn.status, items_complete: turn.itemsComplete,
+        ...(isFinal ? { final_text: text } : { response_text: text }) };
+}
+async function inspectDesktopConversation(runtime, { identity, entry }, options) {
+    try {
+        const snapshot = await runtime.transport.observe(identity);
+        const current = snapshot.turns.find(turn => turn.turnId === snapshot.latestTurnId);
+        output({ ...desktopSessionProjection(entry, snapshot, desktopWritesVerified(runtime.compatibility)),
+            source: "codex_desktop", latest_turn: latestTurnProjection(current),
+            response_state: await desktopResponseStates(runtime, entry.conversationId, snapshot.latestTurnId ?? undefined, str(options.openclawSession)) });
+    }
+    catch (error) {
+        output(desktopSessionProjection(entry, undefined, false, error instanceof DesktopIpcError ? error.code : "live_owner_not_confirmed"));
+    }
+}
+async function sendOrWatchDesktopTask(runtime, command, options, config, { id, identity }) {
+    const controllerSession = required(options.openclawSession, "controller session");
+    const route = options.callbackRoute ? parseCallbackRoute(options.callbackRoute)
+        : createTerminalWatchOpenClawCallbackRoute({ controllerSessionId: controllerSession, openclawBin: config.openclawBin });
+    const timeout = Number(options.hardTimeoutMinutes ?? options.agentHardTimeoutMinutes ?? 60) * 60_000;
+    const input = { target: identity, desktopId: id, controllerSession, timeoutMs: timeout,
+        callbackRoute: { ...route, capabilities: { wake: true, respond: false } } };
+    const task = command === "send" ? await runtime.tasks.send({ ...input,
+        text: required(options.message ?? options.request, "message"), messageId: str(options.messageId) ?? randomUUID() })
+        : await runtime.tasks.watch(input);
+    const result = desktopTaskProjection(task, desktopWritesVerified(runtime.compatibility));
+    if (desktopTaskNeedsReconciliation(task)) {
+        try {
+            result.monitor_pid = await (cliDependencies().launchDesktopMonitor ?? launchDesktopMonitor)(task.id, config);
+        }
+        catch {
+            result.monitor_error = "desktop_monitor_launch_failed";
+            result.callback_expected = false;
+        }
+    }
+    output(result);
+}
+function desktopCliTarget(command, options) {
+    const target = str(options.conversation ?? options.conversationId ?? options.session ?? options.terminal);
+    const recovery = RECOVERY_COMMANDS.includes(command ?? "");
+    if (recovery)
+        assertBackendRecoveryCliTarget(command, options);
+    const turn = str(options.turn);
+    const taskAlias = recovery || command === "status" || command === "watch-status";
+    const watch = str(options.watch) ?? (taskAlias && turn?.startsWith("desktop-watch:") ? turn : undefined);
+    if (!isDesktopConversationId(target) && !watch?.startsWith("desktop-watch:") && !NATIVE_COMMANDS.includes(command ?? ""))
+        return undefined;
+    return { target, watch, recovery };
+}
+/** Return false only for non-Desktop targets. Unsupported Desktop actions never fall through to terminals. */
+export async function dispatchDesktopCli(command, options) {
+    const resolved = desktopCliTarget(command, options);
+    if (!resolved)
+        return false;
+    const { target, watch, recovery } = resolved;
+    if (!SUPPORTED_COMMANDS.includes(command ?? "")) {
+        throw new Error("Desktop supports List, Send, Status, Watch, typed interactions, current-thread settings and exact task cancellation; new/resume are unsupported.");
+    }
+    if (command === "desktop-list") {
+        output(await desktopListForCli(options));
+        return true;
+    }
+    const config = desktopRuntimeOptions(options);
+    if (command === "monitor-desktop") {
+        await runDesktopMonitor(required(watch, "Watch ID"), config);
+        return true;
+    }
+    const runtime = (cliDependencies().createDesktopRuntime ?? createDesktopRuntime)(config);
+    try {
+        if (recovery) {
+            await recoverDesktopTaskForCli(runtime, command, options, config, watch);
+            return true;
+        }
+        if (command === "reconcile-desktop-watches") {
+            await reconcileDesktopWatches(runtime);
+            return true;
+        }
+        if (command === "respond-interaction" || command === "approve") {
+            await respondToDesktopInteraction(runtime, options, target, watch, command);
+            return true;
+        }
+        if (watch) {
+            await inspectOrStopDesktopWatch(runtime, command, options, watch, target);
+            return true;
+        }
+        await dispatchDesktopConversation(runtime, command, options, config, await getDesktopConversation(runtime, options, target));
+        return true;
+    }
+    finally {
+        await runtime.close();
+    }
+}
+/** Once the exact conversation is resolved, route its read, setting, or task operation. */
+async function dispatchDesktopConversation(runtime, command, options, config, conversation) {
+    if (command === "status" || command === "native-inspect" && (options.action ?? options.inspection) === "status") {
+        await inspectDesktopConversation(runtime, conversation, options);
+        return;
+    }
+    const control = await desktopControlForCli(runtime, command, options, conversation);
+    if (control) {
+        output(control);
+        return;
+    }
+    if (command !== "send" && command !== "watch-terminal")
+        throw new Error("Unsupported Desktop command or inspection");
+    await sendOrWatchDesktopTask(runtime, command, options, config, conversation);
+}
+async function desktopResponseSubject(runtime, options, target, watch, controllerSession) {
+    if (!watch)
+        return getDesktopConversation(runtime, options, target);
+    if (["conversation", "conversationId", "session", "terminal", "turn"].some(key => options[key] !== undefined)) {
+        throw new Error("Desktop response accepts exactly one target");
+    }
+    const task = runtime.tasks.status(watch);
+    if (task.controller_session !== controllerSession)
+        throw new Error("Desktop Watch belongs to a different controller");
+    if (desktopObservationStopped(task))
+        throw new Error("Desktop Watch observation has stopped");
+    return { id: task.desktop_id, identity: task.target };
+}
+function desktopResponseFingerprint(interaction, options) {
+    const fingerprint = options.expectedInteractionFingerprint;
+    const expiresAt = options.expectedInteractionExpiresAt;
+    if (fingerprint === undefined && expiresAt === undefined)
+        return;
+    if (typeof fingerprint !== "string" || fingerprint !== desktopInteractionFingerprint(interaction)
+        || typeof expiresAt !== "string" || !Number.isFinite(Date.parse(expiresAt)))
+        throw new Error("Desktop question changed; refresh Status before answering");
+    // Expiry triggers live revalidation by the response service, not refusal of the same pending question.
+}
+async function respondToDesktopInteraction(runtime, options, target, watch, command) {
+    const controllerSession = required(options.openclawSession, "controller session");
+    const subject = await desktopResponseSubject(runtime, options, target, watch, controllerSession);
+    const interactionId = required(options.interaction, "interaction ID");
+    const previous = runtime.responses.list().find(record => record.id === desktopResponseId(subject.identity, interactionId));
+    if (previous && previous.controller_session !== controllerSession)
+        throw new Error("Desktop response belongs to a different controller");
+    const snapshot = previous && previous.state !== "not_sent" ? undefined : await runtime.transport.observe(subject.identity);
+    const freshInteraction = (snapshot?.pendingInteractions ?? snapshot?.asyncQuestions)?.find(item => item.id === interactionId);
+    const interaction = previous?.state === "not_sent" ? freshInteraction : previous?.interaction ?? freshInteraction;
+    if (!interaction)
+        throw new Error("Desktop interaction is no longer pending; refresh Status");
+    desktopResponseFingerprint(interaction, options);
+    const response = desktopTypedResponse(interaction, command, options);
+    const responseId = str(options.responseId) ?? previous?.response_id ?? createHash("sha256").update(JSON.stringify([controllerSession, subject.id, interactionId, response])).digest("hex");
+    const input = { controllerSession, interactionId, responseId, ...response };
+    const record = watch ? await runtime.responses.respondWatch(watch, input)
+        : await runtime.responses.respond({ ...input, desktopId: subject.id, target: subject.identity });
+    output({ source: "codex_desktop", conversation_id: subject.id, ...(watch ? { watch_id: watch } : {}),
+        native_thread_id: subject.identity.threadId, ...desktopResponseProjection(record) });
+}
+function desktopTypedResponse(interaction, command, options) {
+    if (command === "approve") {
+        if (!desktopInteractionIsApproval(interaction))
+            throw new Error("Desktop interaction is not an approval");
+        const decision = options.decision ?? "approve_once";
+        if (decision !== "approve_once" && decision !== "reject")
+            throw new Error("decision must be approve_once or reject");
+        return { response: { decision: decision === "approve_once" ? "accept" : "decline" } };
+    }
+    const value = JSON.parse(required(options.responseJson, "typed response JSON"));
+    return interaction.kind === "async_question" ? { answer: desktopQuestionAnswer(interaction, value) }
+        : { response: desktopQuestionResponse(interaction, value) };
+}
+function desktopResponseProjection(record) {
+    return { interaction_id: record.interaction.id, response_id: record.id, state: record.state, evidence: record.evidence,
+        native_turn_id: record.interaction.turnId, attempts: record.attempts,
+        not_sent_history: record.not_sent_history, error_code: record.error_code, resend_allowed: record.state === "not_sent" };
+}
+/** Status recovers response evidence without re-dispatching an answer that may already have arrived. */
+async function desktopResponseStates(runtime, desktopId, turnId, controller) {
+    if (!turnId)
+        return [];
+    const records = runtime.responses.list().filter(record => record.desktop_id === desktopId
+        && record.interaction.turnId === turnId && (!controller || record.controller_session === controller));
+    const projections = [];
+    for (const record of records) {
+        const current = ["sent", "uncertain"].includes(record.state) ? await runtime.responses.reconcile(record.id) : record;
+        projections.push(desktopResponseProjection(current));
+    }
+    return projections;
+}
+/** Recovery has an exact persisted task address, never a catalog or latest-turn selector. */
+async function recoverDesktopTaskForCli(runtime, command, options, config, id) {
+    if (!isDesktopWatchId(id) || ["watch", "turn", "conversation", "conversationId", "session", "terminal"]
+        .filter(key => options[key] !== undefined).length !== 1)
+        throw new Error("Desktop recovery accepts exactly one --watch or --turn Desktop Watch ID");
+    const controllerSession = required(options.openclawSession, "controller session");
+    const minutes = options.minutes ?? options.hardTimeoutMinutes ?? options.agentHardTimeoutMinutes;
+    const task = command === "close" ? runtime.tasks.close(id, { controllerSession, reason: str(options.reason) })
+        : command === "renew" ? await runtime.tasks.renew(id, { controllerSession, ...(minutes === undefined ? {} : { timeoutMs: Number(minutes) * 60_000 }) })
+            : command === "recover" ? await runtime.tasks.recover(id, { controllerSession })
+                : await runtime.tasks.retryCallback(id, { controllerSession, notificationId: str(options.notificationId) });
+    const result = desktopTaskProjection(task, desktopWritesVerified(runtime.compatibility));
+    if (["renew", "recover", "retry-callback"].includes(command) && desktopTaskNeedsReconciliation(task)) {
+        try {
+            result.monitor_pid = await (cliDependencies().launchDesktopMonitor ?? launchDesktopMonitor)(task.id, config);
+        }
+        catch {
+            result.monitor_error = "desktop_monitor_launch_failed";
+            result.callback_expected = false;
+        }
+    }
+    output(result);
+}
+//# sourceMappingURL=desktop-cli-adapter.js.map

package/dist/src/desktop-cli-adapter.js.map

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

package/dist/src/desktop-cli-controls.d.ts

@@ -0,0 +1,9 @@
+import type { DesktopRuntime } from "./desktop-runtime.js";
+import type { DesktopThreadIdentity } from "./desktop-types.js";
+type Options = Record<string, unknown>;
+/** Typed controls operate on the original Desktop owner; they never launch or resume a CLI. */
+export declare function desktopControlForCli(runtime: DesktopRuntime, command: string, options: Options, subject: {
+    id: string;
+    identity: DesktopThreadIdentity;
+}, watchId?: string): Promise<Record<string, unknown> | undefined>;
+export {};

package/dist/src/desktop-cli-controls.js

@@ -0,0 +1,45 @@
+const required = (value, label) => {
+    if (typeof value !== "string" || !value.trim())
+        throw new Error(`Desktop ${label} is required`);
+    return value;
+};
+/** Typed controls operate on the original Desktop owner; they never launch or resume a CLI. */
+export async function desktopControlForCli(runtime, command, options, subject, watchId) {
+    let result;
+    if (command === "permission-options" || command === "native-inspect" && options.action === "permissions") {
+        result = await runtime.controls.permissionOptions(subject.identity);
+    }
+    else if (command === "set-permissions") {
+        const mode = required(options.mode, "permission mode");
+        if (mode !== "read-only" && mode !== "default" && mode !== "full-access")
+            throw new Error("Invalid Desktop permission mode");
+        result = await runtime.controls.setPermissions(subject.identity, mode);
+    }
+    else if (command === "model-options") {
+        result = await runtime.controls.modelOptions(subject.identity);
+    }
+    else if (command === "set-model") {
+        result = await runtime.controls.setModel(subject.identity, { model: required(options.model, "model"),
+            reasoningEffort: required(options.reasoningEffort, "reasoning effort"),
+            ...(options.collaborationMode === undefined ? {} : { collaborationMode: desktopMode(options.collaborationMode) }) });
+    }
+    else if (command === "cancel") {
+        result = await runtime.controls.interrupt(subject.identity, required(options.expectedNativeTurnId, "expected native turn ID"));
+        if (watchId)
+            await runtime.tasks.reconcile(watchId);
+    }
+    else
+        return undefined;
+    const input = { conversation_id: subject.id };
+    const available_actions = command === "permission-options" || command === "native-inspect" && options.action === "permissions"
+        ? { set_permissions: { tool: "agent_knock_knock_set_permissions", input } }
+        : command === "model-options" ? { set_model: { tool: "agent_knock_knock_set_model", input } } : undefined;
+    return { ...result, ...(available_actions ? { available_actions } : {}), source: "codex_desktop", conversation_id: subject.id, native_thread_id: subject.identity.threadId,
+        ...(watchId ? { watch_id: watchId } : {}) };
+}
+function desktopMode(value) {
+    if (value !== "plan" && value !== "default")
+        throw new Error("Desktop collaboration_mode must be plan or default");
+    return value;
+}
+//# sourceMappingURL=desktop-cli-controls.js.map

package/dist/src/desktop-cli-controls.js.map

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

package/dist/src/desktop-command-presentation.d.ts

@@ -0,0 +1,2 @@
+/** Desktop commands have native task identities, never fabricated managed Session or Turn ids. */
+export declare function formatDesktopCommandResult(result: Record<string, unknown>, action: string): string;

package/dist/src/desktop-command-presentation.js

@@ -0,0 +1,31 @@
+import { isRecord, nonBlankString } from "./value-guards.js";
+/** Desktop commands have native task identities, never fabricated managed Session or Turn ids. */
+export function formatDesktopCommandResult(result, action) {
+    const state = nonBlankString(result.state) ?? nonBlankString(result.status) ?? nonBlankString(result.outcome) ?? nonBlankString(result.activity_state) ?? "unknown";
+    return [`AKK Desktop ${action}: ${state}`,
+        `conversation: ${nonBlankString(result.conversation_id) ?? "unknown"}`,
+        ...optionalLine(result, "watch_id", "watch"), ...optionalLine(result, "native_turn_id", "native task"),
+        ...modelLines(result), ...effectLines(result, state), ...optionalLine(result, "final_text", "result")].join("\n");
+}
+function optionalLine(result, field, label) {
+    const value = nonBlankString(result[field]);
+    return value ? [`${label}: ${value}`] : [];
+}
+function modelLines(result) {
+    if (result.catalog_available !== false)
+        return [];
+    const current = isRecord(result.current) ? result.current : {};
+    return ["The Desktop owner exposes current settings, not an available model catalog.",
+        `current model: ${nonBlankString(current.model) ?? "unknown"}`,
+        `current reasoning: ${nonBlankString(current.reasoning_effort) ?? "unknown"}`,
+        `current collaboration mode: ${nonBlankString(current.collaboration_mode) ?? "unknown"}`,
+        "Use only a model/effort explicitly requested by the user."];
+}
+function effectLines(result, state) {
+    const effective = isRecord(result.effective) ? result.effective : {};
+    return [...(Object.keys(effective).length ? [`verified effective settings: ${JSON.stringify(effective)}`] : []),
+        ...optionalLine(result, "evidence", "evidence"),
+        ...(result.do_not_retry === true || state === "uncertain" ? ["The native effect is unconfirmed. Refresh Status; do not retry automatically."] : []),
+        ...(state === "sent" ? ["The response was dispatched; native acceptance has not yet been confirmed."] : [])];
+}
+//# sourceMappingURL=desktop-command-presentation.js.map

package/dist/src/desktop-command-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-command-presentation.js","sourceRoot":"","sources":["../../src/desktop-command-presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE7D,kGAAkG;AAClG,MAAM,UAAU,0BAA0B,CAAC,MAA+B,EAAE,MAAc;IACxF,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;IACpK,OAAO,CAAC,eAAe,MAAM,KAAK,KAAK,EAAE;QACvC,iBAAiB,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,SAAS,EAAE;QACtE,GAAG,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,aAAa,CAAC;QACtG,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtH,CAAC;AACD,SAAS,YAAY,CAAC,MAA+B,EAAE,KAAa,EAAE,KAAa;IACjF,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7C,CAAC;AACD,SAAS,UAAU,CAAC,MAA+B;IACjD,IAAI,MAAM,CAAC,iBAAiB,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,OAAO,CAAC,6EAA6E;QACnF,kBAAkB,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE;QAC9D,sBAAsB,cAAc,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,SAAS,EAAE;QAC7E,+BAA+B,cAAc,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,SAAS,EAAE;QACxF,2DAA2D,CAAC,CAAC;AACjE,CAAC;AACD,SAAS,WAAW,CAAC,MAA+B,EAAE,KAAa;IACjE,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,gCAAgC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7G,GAAG,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC;QAC/C,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,IAAI,IAAI,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,+EAA+E,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnJ,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,4EAA4E,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjH,CAAC"}

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

@@ -0,0 +1,8 @@
+type Params = Record<string, unknown>;
+type Context = {
+    sessionKey?: unknown;
+};
+export declare function desktopConversationTarget(params: Params): string | undefined;
+export declare function desktopControlToolArgs(params: Params, config: Params, context: Context, action: "status" | "permissions" | "set-permissions" | "model-options" | "set-model"): string[] | undefined;
+export declare function desktopCancelToolArgs(params: Params, config: Params, context: Context): string[] | undefined;
+export {};

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

@@ -0,0 +1,68 @@
+import { isDesktopConversationId, parseDesktopConversationId } from "./desktop-identity.js";
+import { isDesktopWatchId } from "./desktop-semantic.js";
+import { pushOptional, requiredString, requiredTerminalInteractionIdentifier } from "./semantic-tool-arguments.js";
+import { resolvePluginStoreDir } from "./semantic-tool-command-helpers.js";
+export function desktopConversationTarget(params) {
+    if (!isDesktopConversationId(params.conversation_id))
+        return undefined;
+    const id = String(params.conversation_id);
+    parseDesktopConversationId(id);
+    if (["terminal_id", "session_id", "turn_id", "watch_id"].some(key => Object.hasOwn(params, key))) {
+        throw new Error("Desktop conversation_id cannot be combined with another target");
+    }
+    return id;
+}
+function scoped(command, id, config, context, watch = false) {
+    const args = [command, watch ? "--watch" : "--conversation", id,
+        "--openclaw-session", requiredString(context.sessionKey, "controller session")];
+    pushOptional(args, "--store-dir", resolvePluginStoreDir(config));
+    pushOptional(args, "--codex-home", config.codexHome);
+    return args;
+}
+function only(params, allowed) {
+    if (Object.keys(params).some(key => !allowed.includes(key)))
+        throw new Error("Unexpected Desktop control parameters");
+}
+export function desktopControlToolArgs(params, config, context, action) {
+    const id = desktopConversationTarget(params);
+    if (!id)
+        return undefined;
+    const fields = action === "set-model" ? ["model", "reasoning_effort", "collaboration_mode"]
+        : action === "set-permissions" ? ["mode"] : action === "status" ? ["inspection"] : [];
+    only(params, ["conversation_id", ...fields]);
+    const args = scoped(action === "status" ? "native-inspect" : action === "permissions" ? "permission-options" : action, id, config, context);
+    if (action === "status")
+        args.push("--action", "status");
+    if (action === "set-permissions") {
+        if (!["read-only", "default", "full-access"].includes(String(params.mode)))
+            throw new Error("mode must be read-only, default, or full-access");
+        args.push("--mode", String(params.mode));
+    }
+    if (action === "set-model")
+        appendModel(args, params);
+    return args;
+}
+function appendModel(args, params) {
+    const model = requiredString(params.model, "model"), effort = requiredString(params.reasoning_effort, "reasoning_effort");
+    if (!/^[A-Za-z0-9][A-Za-z0-9._:/+\-]{0,159}$/u.test(model) || !/^[a-z][a-z0-9_-]{0,63}$/u.test(effort))
+        throw new Error("Invalid Desktop model/effort tuple");
+    args.push("--model", model, "--reasoning-effort", effort);
+    if (params.collaboration_mode !== undefined) {
+        if (params.collaboration_mode !== "plan" && params.collaboration_mode !== "default")
+            throw new Error("Desktop collaboration_mode must be plan or default");
+        args.push("--collaboration-mode", params.collaboration_mode);
+    }
+}
+export function desktopCancelToolArgs(params, config, context) {
+    const id = desktopConversationTarget(params);
+    if (id) {
+        only(params, ["conversation_id", "expected_native_turn_id"]);
+        return [...scoped("cancel", id, config, context), "--expected-native-turn-id",
+            requiredTerminalInteractionIdentifier(params.expected_native_turn_id, "expected_native_turn_id")];
+    }
+    if (!isDesktopWatchId(params.watch_id))
+        return undefined;
+    only(params, ["watch_id"]);
+    return scoped("cancel", params.watch_id, config, context, true);
+}
+//# sourceMappingURL=desktop-control-semantic.js.map