@scotthuang/agent-knock-knock 0.13.18 → 0.14.0

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

@@ -0,0 +1,269 @@
+import { assertBackendRecoveryFields, assertBackendRecoveryUpdate } from "./backend-task-recovery.js";
+import fs from "node:fs";
+import path from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { assertRealDirectory, atomicSaveJsonFile, isNodeError, readJsonFileNoFollow } from "./durable-json-file.js";
+import { assertStoreReadable, ensureDir, withStoreWriterLease } from "./store.js";
+import { createCallbackEnvelope, parseCallbackAttemptOutcome, parseCallbackRoute } from "./callback-transport.js";
+import { parseDesktopConversationId } from "./desktop-identity.js";
+import { assertDesktopAsyncInteraction } from "./desktop-async-state.js";
+import { assertDesktopInteraction } from "./desktop-interaction-state.js";
+export const DESKTOP_TASKS_DIRECTORY = "desktop-tasks";
+function assertId(id) {
+    if (!/^desktop-watch:[a-zA-Z0-9_-]{8,128}$/.test(id))
+        throw new Error("invalid Desktop task id");
+}
+function nonblank(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function validTime(value) {
+    return typeof value === "string" && Number.isFinite(Date.parse(value));
+}
+function assertPrivate(filePath, directory) {
+    const stat = fs.lstatSync(filePath);
+    if (stat.isSymbolicLink() || (directory ? !stat.isDirectory() : !stat.isFile()) ||
+        (stat.mode & 0o077) !== 0 || (process.getuid && stat.uid !== process.getuid())) {
+        throw new Error("Desktop state path must be an owner-private regular " + (directory ? "directory" : "file"));
+    }
+}
+function assertTaskIdentity(r) {
+    assertId(r.id);
+    if (r.watch_id !== r.id || !nonblank(r.desktop_id) || !nonblank(r.controller_session) ||
+        !r.target || !nonblank(r.target.codexHome) || !path.isAbsolute(r.target.codexHome) ||
+        !nonblank(r.target.hostId) || !nonblank(r.target.threadId))
+        throw new Error("invalid Desktop task identity");
+    if (!isDeepStrictEqual(parseDesktopConversationId(r.desktop_id), r.target))
+        throw new Error("Desktop conversation ID does not match native target");
+}
+function assertTaskLifecycle(r) {
+    if (!["send", "watch"].includes(r.kind) ||
+        !["awaiting_acceptance", "watching", "completed", "failed", "interrupted", "timed_out", "cancelled"].includes(r.status) ||
+        !validTime(r.created_at) || !validTime(r.updated_at) || !validTime(r.deadline_at) ||
+        !Number.isSafeInteger(r.pending_manual_count) || r.pending_manual_count < 0 ||
+        !Array.isArray(r.notifications) || (r.native_turn_id !== undefined && !nonblank(r.native_turn_id)))
+        throw new Error("invalid Desktop task state");
+    if (["watching", "completed", "interrupted"].includes(r.status) && !r.native_turn_id)
+        throw new Error("Desktop task state requires an exact turn anchor");
+}
+function assertSendIntent(r) {
+    const i = r.send_intent;
+    if (!i || !nonblank(i.message_id) || !nonblank(i.client_user_message_id) || !nonblank(i.text) ||
+        !nonblank(i.owner_client_id) || !Array.isArray(i.baseline_turn_ids) ||
+        i.baseline_turn_ids.some(id => !nonblank(id)) || !validTime(i.dispatched_at) ||
+        !["reserved", "uncertain", "accepted", "not_sent"].includes(i.state) ||
+        (i.receipt_turn_id !== undefined && !nonblank(i.receipt_turn_id)) ||
+        (i.state === "accepted" && !r.native_turn_id) || (r.native_turn_id && i.state !== "accepted"))
+        throw new Error("invalid Desktop send intent");
+}
+function assertNotification(r, n, ids) {
+    if (!n || !nonblank(n.id) || ids.has(n.id) ||
+        !["ready", "leased", "retry_wait", "accepted", "failed", "uncertain"].includes(n.status) ||
+        !Number.isSafeInteger(n.attempts) || n.attempts < 0 || !r.callback_route)
+        throw new Error("invalid Desktop outbox");
+    ids.add(n.id);
+    const envelope = createCallbackEnvelope({ route: r.callback_route, source: n.envelope.source, event: n.envelope.event });
+    if (!isDeepStrictEqual(envelope, n.envelope) || envelope.source.kind !== "desktop_watch" ||
+        envelope.source.watch_id !== r.id || envelope.source.desktop_id !== r.desktop_id ||
+        envelope.event.id !== n.id)
+        throw new Error("Desktop callback identity mismatch");
+    if (envelope.event.requires_response)
+        assertInteractionNotification(r, n);
+    assertNotificationDelivery(n);
+}
+function assertInteractionNotification(record, notification) {
+    const event = notification.envelope.event;
+    const metadata = event.metadata;
+    if (event.type !== "desktop_watch.interaction" || !metadata || !nonblank(metadata.interaction_id) ||
+        !["respond", "approve"].includes(String(metadata.action)) || metadata.thread_id !== record.target.threadId || metadata.turn_id !== record.native_turn_id ||
+        notification.id !== `${record.id}:interaction:${metadata.interaction_id}` || !metadata.interaction || typeof metadata.interaction !== "object") {
+        throw new Error("Desktop response notification requires an exact interaction");
+    }
+    const interaction = metadata.interaction;
+    if (!["async_question", "blocking_question", "command_approval", "file_approval"].includes(String(interaction.kind)) || interaction.interaction_id !== metadata.interaction_id ||
+        interaction.native_thread_id !== record.target.threadId || interaction.native_turn_id !== record.native_turn_id) {
+        throw new Error("Desktop response notification has a different interaction identity");
+    }
+    if (metadata.action !== (String(interaction.kind).endsWith("approval") ? "approve" : "respond"))
+        throw new Error("Desktop notification action does not match its interaction");
+}
+function assertAsyncInteractions(record) {
+    if (record.pending_async_interactions === undefined)
+        return;
+    if (!Array.isArray(record.pending_async_interactions))
+        throw new Error("Invalid Desktop pending async questions");
+    const ids = new Set();
+    for (const interaction of record.pending_async_interactions) {
+        assertDesktopAsyncInteraction(interaction, record.target, record.native_turn_id);
+        if (!record.native_turn_id || ids.has(interaction.id))
+            throw new Error("Desktop async question lacks a unique task anchor");
+        ids.add(interaction.id);
+    }
+}
+function assertPendingInteractions(record) {
+    if (record.pending_interactions === undefined)
+        return;
+    if (!Array.isArray(record.pending_interactions))
+        throw new Error("Invalid Desktop pending interactions");
+    const ids = new Set();
+    for (const interaction of record.pending_interactions) {
+        assertDesktopInteraction(interaction, record.target, record.native_turn_id);
+        if (!record.native_turn_id || ids.has(interaction.id))
+            throw new Error("Desktop interaction lacks a unique task anchor");
+        ids.add(interaction.id);
+    }
+}
+function assertNotificationDelivery(n) {
+    if (n.retry_budget_until !== undefined && (!Number.isSafeInteger(n.retry_budget_until) || n.retry_budget_until < 1))
+        throw new Error("invalid Desktop delivery retry budget");
+    if (n.outcome)
+        parseCallbackAttemptOutcome(n.outcome);
+    if (n.status === "leased" && (!nonblank(n.attempt_id) || !validTime(n.lease_expires_at)))
+        throw new Error("invalid Desktop delivery lease");
+    if (n.status === "retry_wait" && (!validTime(n.retry_at) || n.outcome?.disposition !== "retryable_failure"))
+        throw new Error("invalid Desktop delivery retry");
+}
+export function assertDesktopTaskRecord(value) {
+    const r = value;
+    if (!r || typeof r !== "object" || r.schema !== "agent-knock-knock/desktop-task" ||
+        r.version !== 1 || !Number.isSafeInteger(r.revision) || r.revision < 1)
+        throw new Error("invalid Desktop task record");
+    assertTaskIdentity(r);
+    assertTaskLifecycle(r);
+    assertBackendRecoveryFields(r);
+    assertAsyncInteractions(r);
+    assertPendingInteractions(r);
+    if (r.kind === "send")
+        assertSendIntent(r);
+    else if (r.send_intent !== undefined || !r.native_turn_id)
+        throw new Error("invalid Desktop watch anchor");
+    if (r.callback_route) {
+        parseCallbackRoute(r.callback_route);
+        if (r.callback_route.controller_session_id !== r.controller_session || r.callback_route.capabilities?.respond === true)
+            throw new Error("Desktop callback must belong to its controller and be notification-only");
+    }
+    const ids = new Set();
+    for (const n of r.notifications)
+        assertNotification(r, n, ids);
+}
+export function createDesktopStateStore(storeDir, locks) {
+    const root = path.join(storeDir, DESKTOP_TASKS_DIRECTORY);
+    const statePath = (id) => { assertId(id); return path.join(root, `${id}.json`); };
+    const load = (id) => {
+        const filePath = statePath(id);
+        if (!fs.existsSync(storeDir))
+            return undefined;
+        assertStoreReadable(storeDir);
+        try {
+            assertRealDirectory(root, "Desktop tasks");
+            assertPrivate(root, true);
+            assertPrivate(filePath, false);
+            const record = readJsonFileNoFollow(filePath, "Desktop task");
+            assertDesktopTaskRecord(record);
+            if (record.id !== id)
+                throw new Error("Desktop record filename identity mismatch");
+            return record;
+        }
+        catch (error) {
+            if (isNodeError(error, "ENOENT"))
+                return undefined;
+            throw error;
+        }
+    };
+    const scan = (isolate) => {
+        const result = { tasks: [], errors: [] };
+        if (!fs.existsSync(storeDir))
+            return result;
+        assertStoreReadable(storeDir);
+        if (!fs.existsSync(root))
+            return result;
+        assertPrivate(root, true);
+        for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+            const filePath = path.join(root, entry.name);
+            try {
+                assertPrivate(filePath, false);
+            }
+            catch (error) {
+                // Another worker can release its lock or rename a temporary file
+                // between readdir and lstat. Do not mistake that normal race for corruption.
+                if (isNodeError(error, "ENOENT"))
+                    continue;
+                throw error;
+            }
+            if (/^desktop-watch:[a-zA-Z0-9_-]{8,128}\.json\.lock(?:\.reclaim)?$/.test(entry.name) ||
+                /^\.desktop-watch:[a-zA-Z0-9_-]{8,128}\.json\..+\.tmp$/.test(entry.name))
+                continue;
+            if (!entry.name.endsWith(".json"))
+                throw new Error("unknown Desktop state file");
+            const id = entry.name.slice(0, -5);
+            assertId(id);
+            // Security checks are outside content isolation: symlinks and access failures abort the scan.
+            let value;
+            try {
+                value = readJsonFileNoFollow(filePath, "Desktop task");
+            }
+            catch (error) {
+                if (!isolate || !(error instanceof SyntaxError))
+                    throw error;
+                result.errors.push({ id, error_code: "desktop_record_invalid" });
+                continue;
+            }
+            try {
+                assertDesktopTaskRecord(value);
+                if (value.id !== id)
+                    throw new Error("Desktop record filename identity mismatch");
+                result.tasks.push(value);
+            }
+            catch (error) {
+                if (!isolate)
+                    throw error;
+                result.errors.push({ id, error_code: "desktop_record_invalid" });
+            }
+        }
+        result.tasks.sort((a, b) => b.created_at.localeCompare(a.created_at) || a.id.localeCompare(b.id));
+        return result;
+    };
+    return {
+        load, list: () => scan(false).tasks, scanForReconciliation: () => scan(true),
+        withLock: (id, operation) => withStoreWriterLease(storeDir, () => {
+            statePath(id);
+            ensureDir(root);
+            assertPrivate(root, true);
+            const release = locks.acquire(`${statePath(id)}.lock`);
+            try {
+                return operation();
+            }
+            finally {
+                release();
+            }
+        }),
+        save: (record, expectedRevision) => withStoreWriterLease(storeDir, () => {
+            const current = load(record.id);
+            if ((current?.revision ?? null) !== expectedRevision)
+                throw new Error("Desktop task revision conflict");
+            if (current) {
+                for (const key of ["id", "watch_id", "desktop_id", "target", "controller_session", "kind", "created_at", "callback_route"]) {
+                    if (!isDeepStrictEqual(current[key], record[key]))
+                        throw new Error(`Desktop task immutable ${key} changed`);
+                }
+                assertBackendRecoveryUpdate(current, record);
+                if (current.native_turn_id && current.native_turn_id !== record.native_turn_id)
+                    throw new Error("Desktop exact turn anchor cannot change");
+                if (current.send_intent) {
+                    for (const key of ["message_id", "client_user_message_id", "text", "owner_client_id", "baseline_turn_ids", "dispatched_at"]) {
+                        if (!isDeepStrictEqual(current.send_intent[key], record.send_intent?.[key]))
+                            throw new Error("Desktop send intent cannot change");
+                    }
+                    if (current.send_intent.receipt_turn_id && current.send_intent.receipt_turn_id !== record.send_intent?.receipt_turn_id)
+                        throw new Error("Desktop send receipt cannot change");
+                }
+            }
+            const saved = { ...record, revision: (expectedRevision ?? 0) + 1 };
+            assertDesktopTaskRecord(saved);
+            atomicSaveJsonFile(statePath(saved.id), saved, {
+                rootLabel: "AKK store", directoryLabel: "Desktop tasks", fileLabel: "Desktop task", ensureDirectory: ensureDir
+            });
+            return saved;
+        })
+    };
+}
+//# sourceMappingURL=desktop-state-store.js.map

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

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

package/dist/src/desktop-task-interactions.d.ts

@@ -0,0 +1,10 @@
+import type { DesktopPendingRequest, DesktopSnapshot } from "./desktop-types.js";
+import type { DesktopTaskRecord } from "./desktop-state-store.js";
+/** Native pending requests and asynchronous questions have distinct completeness evidence. */
+export declare function updateDesktopInteractionAttention(task: DesktopTaskRecord, snapshot: DesktopSnapshot): void;
+/** Stopping observation never implies that the original task or native question stopped. */
+export declare function clearDesktopInteractionAttention(task: DesktopTaskRecord, errorCode: string): void;
+/** Keep unsupported special forms manual; supported requests already have actionable notifications. */
+export declare function desktopManualRequests(task: DesktopTaskRecord, snapshot: DesktopSnapshot): DesktopPendingRequest[];
+/** A request promoted to an actionable interaction must not also deliver an old manual-only notice. */
+export declare function revokeObsoleteDesktopManualAttention(task: DesktopTaskRecord): void;

package/dist/src/desktop-task-interactions.js

@@ -0,0 +1,93 @@
+import { createCallbackEnvelope } from "./callback-transport.js";
+import { desktopInteractions } from "./desktop-request-interactions.js";
+import { persistDesktopInteraction } from "./desktop-interaction-state.js";
+import { desktopInteractionProjection } from "./desktop-interaction-projection.js";
+function callbackInteraction(task, interaction) {
+    const projected = { ...desktopInteractionProjection(interaction, task.desktop_id, task.id) };
+    const output = { conversation_id: task.desktop_id, watch_id: task.id };
+    for (const key of ["interaction_id", "kind", "status", "native_thread_id", "native_turn_id", "questions",
+        "command", "reason", "cwd", "file_changes", "network", "available_decisions", "decisions"])
+        if (projected[key] !== undefined)
+            output[key] = projected[key];
+    return output;
+}
+function interactionBody(task, interaction) {
+    const approval = interaction.kind === "command_approval" || interaction.kind === "file_approval";
+    const summary = approval ? interaction.command ?? interaction.reason ?? "Review the pending file changes."
+        : interaction.questions.map(question => `${question.title}${question.options.length ? `\nOptions: ${question.options.join(" / ")}` : ""}`).join("\n");
+    const state = interaction.kind === "async_question" ? "has a question awaiting your reply. The task may continue working."
+        : approval ? "is waiting for approval." : "is waiting for an answer before it can continue.";
+    return `Desktop task ${task.id} ${state}\n${summary}\n` +
+        `Refresh AKK Status for this exact conversation or Watch to confirm that the interaction is still current, then ask the user. ` +
+        (approval ? "Use AKK Approve only with the user's decision; do not approve automatically.\n"
+            : "Only use AKK Respond after the user supplies an answer; do not choose an answer automatically.\n") +
+        JSON.stringify(callbackInteraction(task, interaction));
+}
+/** Native pending requests and asynchronous questions have distinct completeness evidence. */
+export function updateDesktopInteractionAttention(task, snapshot) {
+    const turn = snapshot.turns.find(candidate => candidate.turnId === task.native_turn_id);
+    // A partial history is missing evidence, not proof that a question was answered.
+    if (!turn || turn.status === "unknown") {
+        task.observation_error = "desktop_interactions_incomplete";
+        return;
+    }
+    const pending = turn.status === "inProgress" ? desktopInteractions(snapshot, task.native_turn_id)
+        .filter(interaction => interaction.threadId === task.target.threadId) : [];
+    if (turn.status === "inProgress" && !turn.itemsComplete) {
+        task.observation_error = "desktop_async_questions_incomplete";
+        pending.push(...(task.pending_async_interactions ?? []).filter(previous => !pending.some(current => current.id === previous.id)));
+    }
+    task.pending_interactions = pending.map(persistDesktopInteraction);
+    task.pending_async_interactions = task.pending_interactions.filter((interaction) => interaction.kind === "async_question");
+    revokeInteractionNotifications(task, pending, "desktop_interaction_resolved");
+    if (!task.callback_route)
+        return;
+    for (const interaction of pending) {
+        const id = `${task.id}:interaction:${interaction.id}`;
+        if (task.notifications.some(notification => notification.id === id))
+            continue;
+        task.notifications.push({ id, attempts: 0, status: "ready", envelope: createCallbackEnvelope({ route: task.callback_route,
+                source: { kind: "desktop_watch", watch_id: task.id, desktop_id: task.desktop_id },
+                event: { id, type: "desktop_watch.interaction", body: interactionBody(task, interaction), requires_response: true,
+                    metadata: { watch_id: task.id, desktop_id: task.desktop_id, thread_id: task.target.threadId, turn_id: task.native_turn_id,
+                        interaction_id: interaction.id, interaction: callbackInteraction(task, interaction),
+                        action: interaction.kind.endsWith("approval") ? "approve" : "respond" } }
+            }) });
+    }
+}
+function revokeInteractionNotifications(task, pending, errorCode) {
+    for (const notification of task.notifications) {
+        const interactionId = notification.envelope.event.metadata?.interaction_id;
+        if (notification.envelope.event.type === "desktop_watch.interaction" && typeof interactionId === "string" &&
+            !pending.some(interaction => interaction.id === interactionId) && ["ready", "retry_wait"].includes(notification.status)) {
+            notification.status = "failed";
+            notification.outcome = { disposition: "permanent_failure", error_code: errorCode };
+        }
+    }
+}
+/** Stopping observation never implies that the original task or native question stopped. */
+export function clearDesktopInteractionAttention(task, errorCode) {
+    task.pending_async_interactions = [];
+    task.pending_interactions = [];
+    revokeInteractionNotifications(task, [], errorCode);
+}
+/** Keep unsupported special forms manual; supported requests already have actionable notifications. */
+export function desktopManualRequests(task, snapshot) {
+    const turn = snapshot.turns.find(candidate => candidate.turnId === task.native_turn_id);
+    if (turn?.status !== "inProgress")
+        return [];
+    return snapshot.pendingRequests.filter(request => (request.turnId === task.native_turn_id ||
+        !request.turnId && snapshot.latestTurnId === task.native_turn_id) && !(task.pending_interactions ?? []).some(interaction => interaction.kind !== "async_question" && interaction.method === request.method && interaction.requestId === request.requestId));
+}
+/** A request promoted to an actionable interaction must not also deliver an old manual-only notice. */
+export function revokeObsoleteDesktopManualAttention(task) {
+    const currentId = task.pending_manual_fingerprint ? `${task.id}:manual:${task.pending_manual_fingerprint}` : undefined;
+    for (const notification of task.notifications) {
+        if (notification.envelope.event.type === "desktop_watch.manual" && notification.id !== currentId &&
+            ["ready", "retry_wait"].includes(notification.status)) {
+            notification.status = "failed";
+            notification.outcome = { disposition: "permanent_failure", error_code: "desktop_manual_attention_changed" };
+        }
+    }
+}
+//# sourceMappingURL=desktop-task-interactions.js.map

package/dist/src/desktop-task-interactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-task-interactions.js","sourceRoot":"","sources":["../../src/desktop-task-interactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAInF,SAAS,mBAAmB,CAAC,IAAuB,EAAE,WAA+B;IACnF,MAAM,SAAS,GAA4B,EAAE,GAAG,4BAA4B,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACtH,MAAM,MAAM,GAA4B,EAAE,eAAe,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAChG,KAAK,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW;QACtG,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,qBAAqB,EAAE,WAAW,CAAC;QAAE,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7J,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,IAAuB,EAAE,WAA+B;IAC/E,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,KAAK,kBAAkB,IAAI,WAAW,CAAC,IAAI,KAAK,eAAe,CAAC;IACjG,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,MAAM,IAAI,kCAAkC;QACxG,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxJ,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,oEAAoE;QACxH,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,kDAAkD,CAAC;IAC/F,OAAO,gBAAgB,IAAI,CAAC,EAAE,IAAI,KAAK,KAAK,OAAO,IAAI;QACrD,+HAA+H;QAC/H,CAAC,QAAQ,CAAC,CAAC,CAAC,gFAAgF;YAC1F,CAAC,CAAC,kGAAkG,CAAC;QACvG,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,iCAAiC,CAAC,IAAuB,EAAE,QAAyB;IAClG,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC,cAAc,CAAC,CAAC;IACxF,iFAAiF;IACjF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACvC,IAAI,CAAC,iBAAiB,GAAG,iCAAiC,CAAC;QAC3D,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9F,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QACxD,IAAI,CAAC,iBAAiB,GAAG,oCAAoC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpI,CAAC;IACD,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACnE,IAAI,CAAC,0BAA0B,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,WAAW,EAA0C,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;IACnK,8BAA8B,CAAC,IAAI,EAAE,OAAO,EAAE,8BAA8B,CAAC,CAAC;IAC9E,IAAI,CAAC,IAAI,CAAC,cAAc;QAAE,OAAO;IACjC,KAAK,MAAM,WAAW,IAAI,OAAO,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,EAAE,gBAAgB,WAAW,CAAC,EAAE,EAAE,CAAC;QACtD,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;YAAE,SAAS;QAC9E,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc;gBACvH,MAAM,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;gBACjF,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,2BAA2B,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,iBAAiB,EAAE,IAAI;oBAC/G,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc;wBACvH,cAAc,EAAE,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC;wBACnF,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE;aAC9E,CAAC,EAAE,CAAC,CAAC;IACR,CAAC;AACH,CAAC;AAED,SAAS,8BAA8B,CAAC,IAAuB,EAAE,OAA6B,EAAE,SAAiB;IAC/G,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,cAAc,CAAC;QAC3E,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,2BAA2B,IAAI,OAAO,aAAa,KAAK,QAAQ;YACvG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1H,YAAY,CAAC,MAAM,GAAG,QAAQ,CAAC;YAC/B,YAAY,CAAC,OAAO,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QACrF,CAAC;IACH,CAAC;AACH,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,gCAAgC,CAAC,IAAuB,EAAE,SAAiB;IACzF,IAAI,CAAC,0BAA0B,GAAG,EAAE,CAAC;IACrC,IAAI,CAAC,oBAAoB,GAAG,EAAE,CAAC;IAC/B,8BAA8B,CAAC,IAAI,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;AACtD,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,qBAAqB,CAAC,IAAuB,EAAE,QAAyB;IACtF,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC,cAAc,CAAC,CAAC;IACxF,IAAI,IAAI,EAAE,MAAM,KAAK,YAAY;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,cAAc;QACvF,CAAC,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,YAAY,KAAK,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CACzH,WAAW,CAAC,IAAI,KAAK,gBAAgB,IAAI,WAAW,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AACtI,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,oCAAoC,CAAC,IAAuB;IAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,WAAW,IAAI,CAAC,0BAA0B,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACvH,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,sBAAsB,IAAI,YAAY,CAAC,EAAE,KAAK,SAAS;YAC9F,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,YAAY,CAAC,MAAM,GAAG,QAAQ,CAAC;YAC/B,YAAY,CAAC,OAAO,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,EAAE,kCAAkC,EAAE,CAAC;QAC9G,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/desktop-task-recovery.d.ts

@@ -0,0 +1,38 @@
+import { backendObservationStopped } from "./backend-task-recovery.js";
+import type { DesktopNotification, DesktopTaskRecord } from "./desktop-state-store.js";
+import type { DesktopSnapshot, DesktopThreadIdentity } from "./desktop-types.js";
+export declare class DesktopTaskError extends Error {
+    readonly code: string;
+    readonly dispatchState?: "not_sent" | undefined;
+    constructor(code: string, message: string, dispatchState?: "not_sent" | undefined);
+}
+export interface DesktopRecoveryInput {
+    controllerSession: string;
+}
+export interface DesktopRecoveryHost {
+    status(id: string): DesktopTaskRecord;
+    update(id: string, operation: (task: DesktopTaskRecord) => void): DesktopTaskRecord;
+    observe(target: DesktopThreadIdentity): Promise<DesktopSnapshot>;
+    applySnapshot(task: DesktopTaskRecord, snapshot: DesktopSnapshot, recover?: boolean): void;
+    deliverPending(id: string, notificationId?: string): Promise<void>;
+    now(): Date;
+    expire(task: DesktopTaskRecord): void;
+}
+export declare const desktopObservationStopped: typeof backendObservationStopped;
+export declare const desktopLive: (task: DesktopTaskRecord) => boolean;
+export declare function desktopUnresolvedSend(task: DesktopTaskRecord): boolean;
+export declare function desktopNotificationObsolete(task: DesktopTaskRecord, notification: DesktopNotification): boolean;
+export declare function suppressDesktopNotifications(task: DesktopTaskRecord, code: string, predicate?: (_notification: DesktopNotification) => boolean): void;
+export declare function createDesktopTaskRecovery(host: DesktopRecoveryHost): {
+    close(id: string, input: DesktopRecoveryInput & {
+        reason?: string;
+    }): DesktopTaskRecord;
+    unwatch(id: string, input: DesktopRecoveryInput): DesktopTaskRecord;
+    recover(id: string, input: DesktopRecoveryInput): Promise<DesktopTaskRecord>;
+    renew(id: string, input: DesktopRecoveryInput & {
+        timeoutMs?: number;
+    }): Promise<DesktopTaskRecord>;
+    retryCallback(id: string, input: DesktopRecoveryInput & {
+        notificationId?: string;
+    }): Promise<DesktopTaskRecord>;
+};

package/dist/src/desktop-task-recovery.js

@@ -0,0 +1,171 @@
+import { backendObservationStopped, backendRenewalDeadline, prepareBackendCallbackRetry } from "./backend-task-recovery.js";
+import { clearDesktopInteractionAttention } from "./desktop-task-interactions.js";
+import { desktopInteractions } from "./desktop-request-interactions.js";
+export class DesktopTaskError extends Error {
+    code;
+    dispatchState;
+    constructor(code, message, dispatchState) {
+        super(message);
+        this.code = code;
+        this.dispatchState = dispatchState;
+        this.name = "DesktopTaskError";
+    }
+}
+export const desktopObservationStopped = backendObservationStopped;
+export const desktopLive = (task) => task.status === "awaiting_acceptance" || task.status === "watching";
+export function desktopUnresolvedSend(task) {
+    return task.kind === "send" && !task.closed_at && !task.native_turn_id &&
+        Boolean(task.send_intent && ["reserved", "uncertain"].includes(task.send_intent.state));
+}
+function owner(task, input) {
+    if (!input.controllerSession?.trim() || task.controller_session !== input.controllerSession) {
+        throw new DesktopTaskError("desktop_controller_mismatch", "Only the owning controller can manage this Desktop task");
+    }
+}
+function open(task) {
+    if (task.closed_at)
+        throw new DesktopTaskError("desktop_task_closed", "This Desktop task has been closed");
+}
+export function desktopNotificationObsolete(task, notification) {
+    const event = notification.envelope.event;
+    if (event.type === "desktop_watch.timed_out") {
+        const expected = `${task.id}:timed_out${task.renewal_count ? `:${task.renewal_count}` : ""}`;
+        return task.status !== "timed_out" || notification.id !== expected;
+    }
+    if (event.requires_response)
+        return !(task.pending_interactions ?? task.pending_async_interactions ?? [])
+            .some(interaction => interaction.id === event.metadata?.interaction_id && interaction.turnId === task.native_turn_id);
+    return false;
+}
+export function suppressDesktopNotifications(task, code, predicate = (_notification) => true) {
+    for (const notification of task.notifications)
+        if (predicate(notification) && ["ready", "retry_wait", "failed"].includes(notification.status)) {
+            notification.status = "failed";
+            notification.outcome = { disposition: "permanent_failure", error_code: code };
+            delete notification.retry_at;
+        }
+}
+function exactTurn(task, snapshot) {
+    if (snapshot.threadId !== task.target.threadId || !snapshot.ownerClientId || !Number.isSafeInteger(snapshot.revision) || snapshot.revision < 0) {
+        throw new DesktopTaskError("desktop_identity_mismatch", "Desktop observation did not match the original thread");
+    }
+    const matching = snapshot.turns.filter(turn => turn.turnId === task.native_turn_id);
+    return matching.length === 1 ? matching[0] : undefined;
+}
+function fresh(task, initial, input) {
+    owner(task, input);
+    open(task);
+    if (task.revision !== initial.revision)
+        throw new DesktopTaskError("desktop_task_changed", "Desktop task changed during recovery; refresh Status");
+}
+function timeoutMs(value) {
+    const timeout = value ?? 3_600_000;
+    if (!Number.isSafeInteger(timeout) || timeout < 1 || timeout > 7 * 24 * 3_600_000)
+        throw new DesktopTaskError("invalid_argument", "Desktop Watch timeout must be between 1 millisecond and 7 days");
+    return timeout;
+}
+function retryNotification(task, id) {
+    const eligible = task.notifications.filter(notification => (!id || notification.id === id) &&
+        ["failed", "retry_wait"].includes(notification.status) && notification.outcome?.disposition === "retryable_failure");
+    if (eligible.length !== 1)
+        throw new DesktopTaskError("desktop_callback_not_retryable", "Select one persisted callback with a retryable failure");
+    return eligible[0];
+}
+export function createDesktopTaskRecovery(host) {
+    const initial = (id, input) => { const task = host.status(id); owner(task, input); open(task); return task; };
+    return {
+        close(id, input) {
+            const task = host.status(id);
+            owner(task, input);
+            if (task.kind !== "send")
+                throw new DesktopTaskError("desktop_close_requires_send", "Observer Watches must use Unwatch");
+            if (input.reason !== undefined && !input.reason.trim())
+                throw new DesktopTaskError("invalid_argument", "Close reason must be non-empty");
+            return host.update(id, current => {
+                owner(current, input);
+                if (current.closed_at)
+                    return;
+                current.closed_at = host.now().toISOString();
+                if (input.reason !== undefined)
+                    current.close_reason = input.reason;
+                clearDesktopInteractionAttention(current, "desktop_task_closed");
+                suppressDesktopNotifications(current, "desktop_task_closed");
+            });
+        },
+        unwatch(id, input) {
+            owner(host.status(id), input);
+            return host.update(id, task => {
+                owner(task, input);
+                task.unwatched_at ??= host.now().toISOString();
+                clearDesktopInteractionAttention(task, "desktop_watch_unwatched");
+                suppressDesktopNotifications(task, "desktop_watch_unwatched");
+            });
+        },
+        async recover(id, input) {
+            const task = initial(id, input);
+            const snapshot = await host.observe(task.target);
+            return host.update(id, current => {
+                fresh(current, task, input);
+                host.applySnapshot(current, snapshot, true);
+                host.expire(current);
+                current.recovered_at = host.now().toISOString();
+            });
+        },
+        async renew(id, input) {
+            const task = initial(id, input);
+            const timeout = timeoutMs(input.timeoutMs);
+            const snapshot = await host.observe(task.target);
+            return host.update(id, current => {
+                fresh(current, task, input);
+                host.applySnapshot(current, snapshot, true);
+                const turn = exactTurn(current, snapshot);
+                if (["completed", "failed", "interrupted"].includes(current.status))
+                    return;
+                if (!turn || turn.status !== "inProgress" || snapshot.runtimeStatus !== "active") {
+                    throw new DesktopTaskError("desktop_exact_task_not_active", "Renew needs fresh active evidence for the original Desktop task");
+                }
+                current.deadline_at = backendRenewalDeadline(current, host.now(), timeout);
+                current.renewed_at = host.now().toISOString();
+                current.renewal_count = (current.renewal_count ?? 0) + 1;
+                current.status = "watching";
+                delete current.unwatched_at;
+                suppressDesktopNotifications(current, "desktop_timeout_superseded", notification => notification.envelope.event.type === "desktop_watch.timed_out");
+                host.applySnapshot(current, snapshot);
+            });
+        },
+        async retryCallback(id, input) {
+            const task = initial(id, input);
+            if (desktopObservationStopped(task))
+                throw new DesktopTaskError("desktop_watch_unwatched", "Renew observation before retrying its callback");
+            const notification = retryNotification(task, input.notificationId);
+            const interactionId = notification.envelope.event.metadata?.interaction_id;
+            const snapshot = notification.envelope.event.requires_response ? await host.observe(task.target) : undefined;
+            let obsolete = false;
+            host.update(id, current => {
+                fresh(current, task, input);
+                if (desktopObservationStopped(current))
+                    throw new DesktopTaskError("desktop_watch_unwatched", "This Desktop Watch was stopped");
+                const currentNotification = retryNotification(current, notification.id);
+                if (snapshot) {
+                    const turn = exactTurn(current, snapshot);
+                    if (!turn || turn.status !== "inProgress" || !turn.itemsComplete || !desktopInteractions(snapshot, current.native_turn_id)
+                        .some(interaction => interaction.id === interactionId && interaction.threadId === current.target.threadId && interaction.turnId === current.native_turn_id)) {
+                        currentNotification.status = "failed";
+                        currentNotification.outcome = { disposition: "permanent_failure", error_code: "desktop_interaction_not_pending" };
+                        delete currentNotification.retry_at;
+                        obsolete = true;
+                        return;
+                    }
+                }
+                if (snapshot)
+                    host.applySnapshot(current, snapshot, true);
+                prepareBackendCallbackRetry(current, { ...input, notificationId: currentNotification.id }, host.now());
+            });
+            if (obsolete)
+                throw new DesktopTaskError("desktop_interaction_not_pending", "The original Desktop interaction is no longer confirmed pending");
+            await host.deliverPending(id, notification.id);
+            return host.status(id);
+        }
+    };
+}
+//# sourceMappingURL=desktop-task-recovery.js.map