@scotthuang/agent-knock-knock 0.13.17 → 0.14.0

package/dist/src/desktop-public-projection.js

@@ -0,0 +1,134 @@
+import { backendTaskRecoveryProjection } from "./backend-task-recovery.js";
+import { desktopObservationStopped } from "./desktop-task-recovery.js";
+import { desktopInteractionIsApproval, desktopInteractionProjection } from "./desktop-interaction-projection.js";
+export function desktopSessionProjection(entry, snapshot, writesVerified = false, observationError) {
+    const live = snapshot !== undefined;
+    const activeTurn = activeDesktopTurn(snapshot);
+    const watch = Boolean(activeTurn);
+    const send = Boolean(snapshot?.canSend && writesVerified);
+    const interactions = writesVerified && activeTurn ? (snapshot?.pendingInteractions ?? snapshot?.asyncQuestions ?? [])
+        .filter(item => item.turnId === activeTurn) : [];
+    const settings = Boolean(writesVerified && snapshot?.canSend && snapshot.runtimeStatus === "idle");
+    const capabilities = { status: true, send, watch, interaction_notify: watch, ...interactionCapabilities(interactions),
+        set_permissions: settings, set_model: settings, cancel: writesVerified && watch };
+    return {
+        id: entry.conversationId, conversation_id: entry.conversationId, source: "codex_desktop", agent: "codex",
+        title: snapshot?.title ?? entry.title, cwd: snapshot?.cwd ?? entry.cwd,
+        native_thread_id: entry.threadId, host_id: entry.hostId, updated_at: new Date(entry.updatedAtMs).toISOString(),
+        catalog_membership: entry.catalogMembership, creator_originator: entry.originator,
+        ...(entry.sidebar ? { sidebar_section: entry.sidebar.section, sidebar_project_id: entry.sidebar.projectId,
+            sidebar_project_name: entry.sidebar.projectName } : {}),
+        connection_state: live ? "live_owner_verified" : "unconfirmed",
+        activity_state: snapshot?.runtimeStatus ?? "unknown",
+        ...sessionObservation(snapshot, writesVerified),
+        ...sessionSendAvailability(snapshot, writesVerified, observationError),
+        ...(observationError ? { observation_error: observationError } : {}), capabilities,
+        pending_async_count: interactions.filter(item => item.kind === "async_question").length,
+        pending_interaction_count: interactions.length,
+        interaction_state: interactions.map(item => desktopInteractionProjection(item, entry.conversationId)),
+        available_actions: sessionActions(entry.conversationId, { live, send, watch, cancel: writesVerified && watch }, activeTurn)
+    };
+}
+function sessionSendAvailability(snapshot, writesVerified, observationError) {
+    if (!snapshot)
+        return { can_send_reason: observationError ?? "live_owner_not_confirmed",
+            ...(observationError === "no_live_owner" ? {
+                manual_action: "Open this conversation in Desktop, then refresh AKK List. It is listed but cannot currently receive tasks."
+            } : {}) };
+    return { can_send_reason: !writesVerified ? "desktop_write_contract_unverified"
+            : snapshot.canSend ? "ready" : snapshot.idleBlockedReason ?? "desktop_not_sendable" };
+}
+/** Do not export prompts, internal owner IDs, callback configuration or raw native state. */
+export function desktopTaskProjection(task, writesVerified = true) {
+    const terminal = desktopObservationStopped(task) || ["completed", "failed", "interrupted", "timed_out", "cancelled"].includes(task.status);
+    const interactions = writesVerified && !terminal ? actionableTaskInteractions(task) : [];
+    const notifications = notificationProjection(task);
+    const canCancel = writesVerified && !terminal && Boolean(task.native_turn_id);
+    const { recovery_actions, ...recovery } = backendTaskRecoveryProjection(task);
+    return {
+        watch_id: task.watch_id, conversation_id: task.desktop_id, source: "codex_desktop",
+        status: task.closed_at ? "closed" : task.status, observation_status: task.status,
+        ...recovery,
+        observation_mode: task.native_turn_id ? "exact_task" : "pending_acceptance",
+        anchor_state: task.native_turn_id ? "verified" : "pending", native_thread_id: task.target.threadId,
+        native_turn_id: task.native_turn_id ?? null, created_at: task.created_at, updated_at: task.updated_at,
+        observed_at: task.observed_at, observation_error: task.observation_error,
+        pending_manual_count: task.pending_manual_count, final_text: task.final_text,
+        ...taskInteractionCounts(task, interactions),
+        interaction_state: interactions.map(item => desktopInteractionProjection(item, task.desktop_id, task.watch_id)),
+        callback_expected: callbackExpected(task, terminal),
+        callback_configured: Boolean(task.callback_route), callback_notifications: notifications,
+        ...desktopSendReceiptProjection(task.send_intent),
+        capabilities: { callback: Boolean(task.callback_route), interaction_notify: Boolean(task.callback_route),
+            ...interactionCapabilities(interactions), cancel: canCancel, ...desktopRecoveryCapabilities(task) },
+        available_actions: { ...recovery_actions, status: { tool: "agent_knock_knock_status", input: { watch_id: task.watch_id } },
+            ...(canCancel ? { cancel: { tool: "agent_knock_knock_cancel", input: { watch_id: task.watch_id } } } : {}) },
+        ...(task.pending_manual_count ? { manual_action: terminal
+                ? "Handle any remaining question or approval in Desktop; this Watch has stopped."
+                : "Answer the question or approval in Desktop; AKK continues watching this task." } : {})
+    };
+}
+/** Keep task delivery evidence distinct from current interaction availability. */
+function desktopSendReceiptProjection(intent) {
+    if (!intent)
+        return {};
+    const accepted = intent.state === "accepted";
+    return { message_id: intent.message_id, delivery_receipt: accepted ? "native_task_verified"
+            : intent.state === "not_sent" ? "not_sent" : "acceptance_unproven",
+        delivered: accepted, agent_acceptance: accepted ? "proven" : "unproven",
+        send_state: intent.state, send_error: intent.error_code, resend_allowed: false };
+}
+function actionableTaskInteractions(task) {
+    const items = task.pending_interactions ?? task.pending_async_interactions ?? [];
+    if (!task.observation_error)
+        return items;
+    // The owner request list is independently fresh even when async turn history is partial.
+    return task.observation_error === "desktop_async_questions_incomplete" ? items.filter(item => item.kind !== "async_question") : [];
+}
+function activeDesktopTurn(snapshot) {
+    if (!snapshot || snapshot.runtimeStatus !== "active" || !snapshot.tailKnown)
+        return undefined;
+    const active = snapshot.turns.filter(turn => turn.status === "inProgress");
+    return active.length === 1 && snapshot.latestTurnId === active[0].turnId ? active[0].turnId : undefined;
+}
+function interactionCapabilities(interactions) {
+    return { interaction_respond: interactions.some(item => !desktopInteractionIsApproval(item)),
+        approve: interactions.some(desktopInteractionIsApproval) };
+}
+function sessionObservation(snapshot, writesVerified) {
+    if (!snapshot)
+        return {};
+    const actionable = writesVerified ? (snapshot.pendingInteractions ?? []).filter(item => item.kind !== "async_question").length : 0;
+    return { native_turn_id: snapshot.latestTurnId, pending_manual_count: Math.max(0, snapshot.pendingRequestCount - actionable),
+        observed_revision: snapshot.revision };
+}
+function sessionActions(id, capabilities, activeTurn) {
+    const input = { conversation_id: id };
+    return { status: { tool: "agent_knock_knock_status", input },
+        ...(capabilities.send ? { send: { tool: "agent_knock_knock_send", input } } : {}),
+        ...(capabilities.watch ? { watch: { tool: "agent_knock_knock_watch", input } } : {}),
+        ...(capabilities.cancel ? { cancel: { tool: "agent_knock_knock_cancel", input: { ...input, expected_native_turn_id: activeTurn } } } : {}),
+        ...(capabilities.live ? { native_inspect: { tool: "agent_knock_knock_native_inspect", input: { ...input, inspection: "status" } },
+            permission_options: { tool: "agent_knock_knock_permission_options", input },
+            model_options: { tool: "agent_knock_knock_model_options", input } } : {}) };
+}
+function notificationProjection(task) {
+    return task.notifications.map(note => ({ id: note.id, notification_id: note.id, status: note.status, attempts: note.attempts,
+        ...(note.outcome && "error_code" in note.outcome ? { error_code: note.outcome.error_code } : {}) }));
+}
+function callbackExpected(task, terminal) {
+    return Boolean(task.callback_route && !desktopObservationStopped(task) &&
+        (!terminal || task.notifications.some(note => ["ready", "retry_wait", "leased"].includes(note.status))));
+}
+function taskInteractionCounts(task, items) {
+    return { pending_async_count: task.observation_error ? null : (task.pending_async_interactions ?? []).length,
+        async_interactions_state: task.observation_error ? "unknown" : "current",
+        pending_interaction_count: task.observation_error ? null : items.length };
+}
+function desktopRecoveryCapabilities(task) {
+    const stopped = desktopObservationStopped(task);
+    return { close: task.kind === "send" && !task.closed_at, unwatch: !stopped,
+        recover: !task.closed_at, renew: !task.closed_at && !["completed", "failed", "interrupted"].includes(task.status),
+        retry_callback: !stopped && task.notifications.some(notification => ["failed", "retry_wait"].includes(notification.status) && notification.outcome?.disposition === "retryable_failure") };
+}
+//# sourceMappingURL=desktop-public-projection.js.map

package/dist/src/desktop-public-projection.js.map

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

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

@@ -0,0 +1,14 @@
+import { type DesktopInteraction, type DesktopRequestInteraction, type DesktopRequestResponse, type DesktopSnapshot, type DesktopTurn } from "./desktop-types.js";
+export declare const desktopObject: (value: unknown) => value is Record<string, unknown>;
+export declare function desktopNativeRequestId(value: unknown): string | number;
+export declare function desktopRequestInteractionId(value: Omit<DesktopRequestInteraction, "id">): string;
+export declare function parseDesktopRequestInteraction(raw: unknown, threadId: string, turns: DesktopTurn[]): DesktopRequestInteraction | null;
+export declare function desktopInteractions(snapshot: DesktopSnapshot, turnId?: string): DesktopInteraction[];
+export declare function desktopRequestResponse(interaction: DesktopRequestInteraction, response: DesktopRequestResponse): Record<string, unknown>;
+export declare function findDesktopRequestEffect(snapshot: DesktopSnapshot, input: {
+    interaction: DesktopRequestInteraction;
+    response: DesktopRequestResponse;
+}): {
+    evidence: "exact_blocking_answer_observed" | "exact_approval_item_advanced";
+    itemId: string;
+} | null;

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

@@ -0,0 +1,144 @@
+import { createHash } from "node:crypto";
+import { isDeepStrictEqual } from "node:util";
+import { desktopAsyncQuestions } from "./desktop-async-interactions.js";
+import { DesktopIpcError } from "./desktop-types.js";
+export const desktopObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+function invalid(message) { throw new DesktopIpcError("invalid_response", message); }
+function text(value) {
+    if (typeof value !== "string" || !value || value.length > 16_384)
+        invalid("Invalid Desktop request string");
+    return value;
+}
+export function desktopNativeRequestId(value) {
+    if (typeof value === "string" && value.length > 0 && value.length <= 512)
+        return value;
+    if (typeof value === "number" && Number.isSafeInteger(value))
+        return value;
+    return invalid("Invalid Desktop native request identity");
+}
+export function desktopRequestInteractionId(value) {
+    const fields = [value.kind, value.threadId, value.turnId, value.itemId, value.method, value.requestId, value.questions,
+        value.command, value.reason, value.cwd, value.availableDecisions, value.approvalId, value.nativeApprovalKind, value.networkApprovalContext];
+    return `desktop-request-interaction:${createHash("sha256").update(JSON.stringify(fields)).digest("hex")}`;
+}
+function parseQuestions(value) {
+    if (!Array.isArray(value) || !value.length || value.length > 64)
+        invalid("Invalid Desktop blocking questions");
+    const ids = new Set();
+    return value.map(raw => {
+        if (!desktopObject(raw))
+            invalid("Invalid Desktop blocking question");
+        const id = text(raw.id);
+        if (ids.has(id))
+            invalid("Duplicate Desktop blocking question");
+        ids.add(id);
+        if (raw.options != null && (!Array.isArray(raw.options) || raw.options.length > 128))
+            invalid("Invalid Desktop blocking options");
+        const options = (raw.options ?? []).map(option => {
+            if (!desktopObject(option))
+                invalid("Invalid Desktop blocking option");
+            return text(option.label);
+        });
+        return { id, title: text(raw.question), options, isOther: raw.isOther === true, isSecret: raw.isSecret === true };
+    });
+}
+function approvalDetails(params, result) {
+    for (const key of ["command", "reason", "cwd", "approvalId"]) {
+        const value = params[key];
+        if (value == null)
+            continue;
+        if (typeof value !== "string" || value.length > 16_384)
+            invalid("Invalid Desktop approval detail");
+        result[key] = value;
+    }
+    if (params.availableDecisions != null) {
+        if (!Array.isArray(params.availableDecisions))
+            invalid("Invalid Desktop approval decisions");
+        result.availableDecisions = params.availableDecisions.filter((value) => typeof value === "string");
+    }
+    if (result.kind !== "command_approval")
+        return;
+    result.nativeApprovalKind = params.kind == null ? "command" : text(params.kind);
+    if (params.networkApprovalContext != null) {
+        if (!desktopObject(params.networkApprovalContext))
+            invalid("Invalid Desktop network approval");
+        result.networkApprovalContext = { host: text(params.networkApprovalContext.host), protocol: text(params.networkApprovalContext.protocol) };
+    }
+}
+const requestKinds = new Map([
+    ["item/commandExecution/requestApproval", "command_approval"], ["item/fileChange/requestApproval", "file_approval"],
+    ["item/tool/requestUserInput", "blocking_question"]
+]);
+export function parseDesktopRequestInteraction(raw, threadId, turns) {
+    if (!desktopObject(raw) || typeof raw.method !== "string")
+        return null;
+    const kind = requestKinds.get(raw.method);
+    if (!kind)
+        return null;
+    if (!desktopObject(raw.params))
+        return null;
+    const params = raw.params;
+    if (params.threadId === undefined || typeof params.turnId !== "string" || typeof params.itemId !== "string")
+        return null;
+    if (params.threadId !== threadId)
+        invalid("Desktop request belongs to a different thread");
+    const result = { id: "", kind, method: raw.method, requestId: desktopNativeRequestId(raw.id),
+        threadId, turnId: text(params.turnId), itemId: text(params.itemId), questions: kind === "blocking_question" ? parseQuestions(params.questions) : [] };
+    approvalDetails(params, result);
+    result.id = desktopRequestInteractionId(result);
+    const item = turns.find(turn => turn.turnId === result.turnId)?.items.find(item => item.id === result.itemId);
+    if (kind === "file_approval" && item?.type === "fileChange" && item.changes)
+        result.changes = item.changes;
+    return result;
+}
+export function desktopInteractions(snapshot, turnId) {
+    const requests = (snapshot.pendingInteractions ?? []).filter((item) => item.kind !== "async_question");
+    return [...requests, ...desktopAsyncQuestions(snapshot, turnId)].filter(item => turnId === undefined || item.turnId === turnId);
+}
+export function desktopRequestResponse(interaction, response) {
+    if (interaction.kind !== "blocking_question" && "decision" in response && ["accept", "decline", "cancel"].includes(response.decision)) {
+        return { decision: response.decision };
+    }
+    if (interaction.kind !== "blocking_question" || !("answers" in response) || !desktopObject(response.answers)
+        || Object.keys(response.answers).length !== interaction.questions.length)
+        throw new DesktopIpcError("invalid_argument", "Response does not match Desktop request");
+    const answers = Object.create(null);
+    for (const question of interaction.questions) {
+        answers[question.id] = { answers: blockingAnswer(question, response.answers[question.id]) };
+    }
+    return { answers };
+}
+function blockingAnswer(question, values) {
+    if (!Array.isArray(values) || !values.length || values.length > 100 || values.some(value => typeof value !== "string"
+        || !value.trim() || value.length > 16_384 || (!question.isOther && question.options.length > 0 && !question.options.includes(value)))) {
+        throw new DesktopIpcError("invalid_argument", "Invalid Desktop blocking answer");
+    }
+    return values;
+}
+function blockingEffect(turn, interaction, answers) {
+    const matches = turn.items.filter(item => item.type === "userInputResponse" && item.completed === true
+        && item.requestId === interaction.requestId && item.turnId === interaction.turnId && item.answers !== undefined
+        && isDeepStrictEqual(Object.entries(item.answers).sort(), Object.entries(answers).sort()));
+    return matches.length === 1 ? matches[0].id : undefined;
+}
+export function findDesktopRequestEffect(snapshot, input) {
+    const { interaction, response } = input;
+    if (snapshot.threadId !== interaction.threadId)
+        return null;
+    const turn = snapshot.turns.find(turn => turn.turnId === interaction.turnId);
+    if (!turn?.itemsComplete)
+        return null;
+    if (snapshot.pendingRequests.some(request => request.requestId === interaction.requestId && request.method === interaction.method))
+        return null;
+    if (interaction.kind === "blocking_question" && "answers" in response) {
+        const itemId = blockingEffect(turn, interaction, response.answers);
+        return itemId ? { evidence: "exact_blocking_answer_observed", itemId } : null;
+    }
+    if (!("decision" in response))
+        return null;
+    const item = turn.items.find(item => item.id === interaction.itemId
+        && item.type === (interaction.kind === "command_approval" ? "commandExecution" : "fileChange"));
+    const expected = response.decision === "accept" ? ["completed", "failed"] : ["declined"];
+    return item?.status && expected.includes(item.status) ? { evidence: "exact_approval_item_advanced", itemId: item.id } : null;
+}
+//# sourceMappingURL=desktop-request-interactions.js.map

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

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

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

@@ -0,0 +1,14 @@
+import type { DesktopResponseDependencies } from "./desktop-response-types.js";
+import type { DesktopResponseRecord } from "./desktop-response-store.js";
+import type { DesktopSnapshot, DesktopThreadIdentity } from "./desktop-types.js";
+interface DispatchOptions {
+    threadId: string;
+    ownerClientId: string;
+    expectedRevision: number;
+    expectedTurnId: string;
+    interactionId: string;
+    beforeDispatch(snapshot: DesktopSnapshot): Promise<void>;
+}
+/** These acknowledgements mean sent; the durable service separately verifies native effects. */
+export declare function dispatchDesktopResponse(deps: DesktopResponseDependencies, target: DesktopThreadIdentity, record: DesktopResponseRecord, options: DispatchOptions): Promise<void>;
+export {};

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

@@ -0,0 +1,19 @@
+import { DesktopTaskError } from "./desktop-task-service.js";
+/** These acknowledgements mean sent; the durable service separately verifies native effects. */
+export async function dispatchDesktopResponse(deps, target, record, options) {
+    if (record.interaction.kind === "async_question") {
+        const receipt = await deps.answerAsync(target, { ...options, answer: record.answer, clientUserMessageId: record.client_user_message_id });
+        if (receipt.turnId !== record.interaction.turnId || receipt.clientUserMessageId !== record.client_user_message_id) {
+            throw new Error("Desktop async response receipt changed exact task identity");
+        }
+        return;
+    }
+    if (!deps.respondRequest)
+        throw new DesktopTaskError("unsupported_capability", "Desktop request responses are unavailable", "not_sent");
+    const receipt = await deps.respondRequest(target, { ...options, operationId: record.operation_id, response: record.response });
+    if (receipt.turnId !== record.interaction.turnId || receipt.interactionId !== record.interaction.id ||
+        receipt.requestId !== record.interaction.requestId || receipt.acknowledged !== true) {
+        throw new Error("Desktop native response receipt changed exact request identity");
+    }
+}
+//# sourceMappingURL=desktop-response-dispatch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-response-dispatch.js","sourceRoot":"","sources":["../../src/desktop-response-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAc7D,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAiC,EAAE,MAA6B,EAC5G,MAA6B,EAAE,OAAwB;IACvD,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,sBAAuB,EAAE,CAAC,CAAC;QAC5I,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,WAAW,CAAC,MAAM,IAAI,OAAO,CAAC,mBAAmB,KAAK,MAAM,CAAC,sBAAsB,EAAE,CAAC;YAClH,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,cAAc;QAAE,MAAM,IAAI,gBAAgB,CAAC,wBAAwB,EAAE,2CAA2C,EAAE,UAAU,CAAC,CAAC;IACxI,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,YAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAS,EAAE,CAAC,CAAC;IACjI,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,WAAW,CAAC,MAAM,IAAI,OAAO,CAAC,aAAa,KAAK,MAAM,CAAC,WAAW,CAAC,EAAE;QACjG,OAAO,CAAC,SAAS,KAAK,MAAM,CAAC,WAAW,CAAC,SAAS,IAAI,OAAO,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;QACtF,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { DesktopResponseRecord } from "./desktop-response-store.js";
+import type { DesktopSnapshot } from "./desktop-types.js";
+/** A transport acknowledgement or disappearing prompt alone never confirms a response. */
+export declare function desktopResponseEvidence(record: DesktopResponseRecord, snapshot: DesktopSnapshot): DesktopResponseRecord["evidence"];

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

@@ -0,0 +1,19 @@
+import { findDesktopAsyncAnswer } from "./desktop-async-interactions.js";
+import { findDesktopRequestEffect } from "./desktop-request-interactions.js";
+/** A transport acknowledgement or disappearing prompt alone never confirms a response. */
+export function desktopResponseEvidence(record, snapshot) {
+    if (record.interaction.kind === "async_question") {
+        return findDesktopAsyncAnswer(snapshot, { turnId: record.interaction.turnId, interaction: record.interaction,
+            answer: record.answer, clientUserMessageId: record.client_user_message_id }) ? "exact_async_answer_observed" : undefined;
+    }
+    const effect = findDesktopRequestEffect(snapshot, { interaction: record.interaction, response: record.response });
+    if (!effect)
+        return undefined;
+    if (effect.evidence === "exact_blocking_answer_observed")
+        return effect.evidence;
+    const turn = snapshot.turns.find(candidate => candidate.turnId === record.interaction.turnId);
+    const item = turn?.items.find(candidate => candidate.id === effect.itemId);
+    // The item must actually advance after this answer intent, not merely have an old terminal status.
+    return item?.status !== undefined && item.status !== record.baseline_item_status ? effect.evidence : undefined;
+}
+//# sourceMappingURL=desktop-response-evidence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-response-evidence.js","sourceRoot":"","sources":["../../src/desktop-response-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAI7E,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB,CAAC,MAA6B,EAAE,QAAyB;IAC9F,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACjD,OAAO,sBAAsB,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW;YAC1G,MAAM,EAAE,MAAM,CAAC,MAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,sBAAuB,EAAE,CAAC,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/H,CAAC;IACD,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAS,EAAE,CAAC,CAAC;IACnH,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,MAAM,CAAC,QAAQ,KAAK,gCAAgC;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IACjF,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9F,MAAM,IAAI,GAAG,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3E,mGAAmG;IACnG,OAAO,IAAI,EAAE,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACjH,CAAC"}

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

@@ -0,0 +1,11 @@
+import { type DesktopResponseRecord } from "./desktop-response-store.js";
+import type { DesktopResponseDependencies, DesktopResponseInput } from "./desktop-response-types.js";
+export type { DesktopResponseDependencies, DesktopResponseInput } from "./desktop-response-types.js";
+/** One durable answer per native question, shared across direct and Watch response routes. */
+export declare function createDesktopResponseService(deps: DesktopResponseDependencies): {
+    respond: (input: DesktopResponseInput) => Promise<DesktopResponseRecord>;
+    reconcile: (id: string) => Promise<DesktopResponseRecord>;
+    status: (id: string) => DesktopResponseRecord;
+    list: () => DesktopResponseRecord[];
+    respondWatch(watchId: string, input: Omit<DesktopResponseInput, "target" | "desktopId">): Promise<DesktopResponseRecord>;
+};

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

@@ -0,0 +1,188 @@
+import { backendObservationStopped } from "./backend-task-recovery.js";
+import { randomUUID } from "node:crypto";
+import { isDeepStrictEqual } from "node:util";
+import { desktopNonblank } from "./desktop-async-state.js";
+import { desktopInteractions } from "./desktop-request-interactions.js";
+import { assertDesktopInteraction, persistDesktopInteraction } from "./desktop-interaction-state.js";
+import { desktopResponseEvidence } from "./desktop-response-evidence.js";
+import { dispatchDesktopResponse } from "./desktop-response-dispatch.js";
+import { validateDesktopResponseValue } from "./desktop-response-value.js";
+import { assertDesktopResponseIdentity, desktopResponseId } from "./desktop-response-store.js";
+import { DesktopTaskError } from "./desktop-task-service.js";
+function errorCode(error) {
+    const code = error?.code;
+    return typeof code === "string" && /^[a-zA-Z0-9_-]{1,100}$/.test(code) ? code : "desktop_response_observation_unavailable";
+}
+function currentInteraction(snapshot, input, expectedTurnId) {
+    const interactions = desktopInteractions(snapshot).filter(candidate => candidate.id === input.interactionId && candidate.threadId === input.target.threadId);
+    const interaction = interactions.length === 1 ? interactions[0] : undefined;
+    const active = snapshot.turns.filter(turn => turn.status === "inProgress");
+    if (snapshot.threadId !== input.target.threadId || !snapshot.ownerClientId || snapshot.runtimeStatus !== "active" ||
+        !snapshot.tailKnown || !interaction || active.length !== 1 || active[0].turnId !== interaction.turnId ||
+        snapshot.latestTurnId !== interaction.turnId || expectedTurnId && interaction.turnId !== expectedTurnId) {
+        throw new DesktopTaskError("stale_interaction", "The exact Desktop interaction is no longer active", "not_sent");
+    }
+    assertDesktopInteraction(interaction, input.target, expectedTurnId);
+    return interaction;
+}
+function assertInput(input) {
+    assertDesktopResponseIdentity(input.desktopId, input.target);
+    if (![input.controllerSession, input.interactionId, input.responseId].every(desktopNonblank)) {
+        throw new DesktopTaskError("invalid_argument", "Desktop response requires controller, interaction and response ID");
+    }
+}
+function assertDuplicate(record, input, expectedTurnId) {
+    if (record.controller_session !== input.controllerSession || record.desktop_id !== input.desktopId ||
+        record.interaction.id !== input.interactionId || record.answer !== input.answer || !isDeepStrictEqual(record.response, input.response) ||
+        expectedTurnId && record.interaction.turnId !== expectedTurnId) {
+        throw new DesktopTaskError("desktop_response_conflict", "This Desktop interaction already has a different response intent");
+    }
+}
+function itemStatus(snapshot, interaction) {
+    return snapshot.turns.find(turn => turn.turnId === interaction.turnId)?.items.find(item => item.id === interaction.itemId)?.status;
+}
+/** One durable answer per native question, shared across direct and Watch response routes. */
+export function createDesktopResponseService(deps) {
+    const repo = deps.repository;
+    const now = deps.now ?? (() => new Date());
+    const uuid = deps.randomUUID ?? randomUUID;
+    function status(id) {
+        const record = repo.load(id);
+        if (!record)
+            throw new DesktopTaskError("desktop_response_not_found", "Desktop response was not found");
+        return record;
+    }
+    function update(id, operation) {
+        return repo.withLock(id, () => {
+            const record = status(id);
+            operation(record);
+            record.updated_at = now().toISOString();
+            return repo.save(record, record.revision);
+        });
+    }
+    async function reconcile(id) {
+        const previous = status(id);
+        if (["confirmed", "not_sent", "reserved"].includes(previous.state))
+            return previous;
+        let snapshot;
+        try {
+            snapshot = await deps.observe(previous.target);
+        }
+        catch (error) {
+            return update(id, record => { if (record.state !== "confirmed")
+                record.error_code = errorCode(error); });
+        }
+        if (snapshot.threadId !== previous.target.threadId)
+            throw new DesktopTaskError("desktop_identity_mismatch", "Desktop response observation changed thread");
+        const evidence = desktopResponseEvidence(previous, snapshot);
+        return update(id, record => {
+            if (!evidence || !["sent", "uncertain"].includes(record.state))
+                return;
+            record.state = "confirmed";
+            record.evidence = evidence;
+            delete record.error_code;
+        });
+    }
+    function reserve(input, interaction, snapshot) {
+        const id = desktopResponseId(input.target, input.interactionId);
+        const date = now().toISOString();
+        return repo.withLock(id, () => {
+            const existing = repo.load(id);
+            if (existing) {
+                assertDuplicate(existing, input);
+                if (existing.state !== "not_sent")
+                    return { record: existing, claimed: false };
+                existing.not_sent_history = [...(existing.not_sent_history ?? []), { attempt: existing.attempts, observed_at: existing.updated_at,
+                        ...(existing.error_code ? { error_code: existing.error_code } : {}),
+                        ...(existing.baseline_item_status !== undefined ? { baseline_item_status: existing.baseline_item_status } : {}) }];
+                if (interaction.kind !== "async_question")
+                    existing.baseline_item_status = itemStatus(snapshot, interaction);
+                existing.state = "reserved";
+                existing.attempts++;
+                existing.updated_at = date;
+                delete existing.error_code;
+                return { record: repo.save(existing, existing.revision), claimed: true };
+            }
+            const record = { schema: "agent-knock-knock/desktop-response", version: 1, revision: 1, id,
+                created_at: date, updated_at: date, target: structuredClone(input.target), desktop_id: input.desktopId,
+                controller_session: input.controllerSession, response_id: input.responseId, interaction: persistDesktopInteraction(interaction),
+                ...(interaction.kind === "async_question" ? { answer: input.answer, client_user_message_id: uuid() }
+                    : { response: structuredClone(input.response), operation_id: uuid(), baseline_item_status: itemStatus(snapshot, interaction) }),
+                state: "reserved", attempts: 1 };
+            return { record: repo.save(record, null), claimed: true };
+        });
+    }
+    function withWatch(watchId, input, operation) {
+        if (!watchId)
+            return operation();
+        return deps.tasks.withLock(watchId, () => {
+            const task = deps.tasks.load(watchId);
+            if (!task || task.controller_session !== input.controllerSession)
+                throw new DesktopTaskError("desktop_controller_mismatch", "Watch response requires its owning controller", "not_sent");
+            if (backendObservationStopped(task))
+                throw new DesktopTaskError("desktop_watch_stopped", "Desktop Watch observation has stopped", "not_sent");
+            return operation();
+        });
+    }
+    async function dispatch(input, snapshot, record, watchId) {
+        try {
+            const options = { threadId: input.target.threadId, ownerClientId: snapshot.ownerClientId,
+                expectedRevision: snapshot.revision, expectedTurnId: record.interaction.turnId, interactionId: record.interaction.id,
+                beforeDispatch: async (fresh) => {
+                    const question = currentInteraction(fresh, input, record.interaction.turnId);
+                    if (fresh.ownerClientId !== snapshot.ownerClientId || fresh.revision < snapshot.revision || question.id !== record.interaction.id) {
+                        throw new DesktopTaskError("snapshot_changed", "Desktop interaction changed before response dispatch", "not_sent");
+                    }
+                    withWatch(watchId, input, () => update(record.id, current => {
+                        if (current.state !== "reserved")
+                            throw new DesktopTaskError("desktop_response_already_claimed", "Desktop response was already dispatched", "not_sent");
+                        current.state = "uncertain";
+                    }));
+                } };
+            await dispatchDesktopResponse(deps, input.target, record, options);
+            update(record.id, current => { if (current.state !== "confirmed")
+                current.state = "sent"; });
+        }
+        catch (error) {
+            update(record.id, current => {
+                if (current.state === "confirmed")
+                    return;
+                current.state = error?.dispatchState === "not_sent" ? "not_sent" : "uncertain";
+                current.error_code = errorCode(error);
+            });
+        }
+    }
+    async function respond(input, expectedTurnId, watchId) {
+        assertInput(input);
+        withWatch(watchId, input, () => undefined);
+        const id = desktopResponseId(input.target, input.interactionId);
+        const previous = repo.load(id);
+        if (previous) {
+            assertDuplicate(previous, input, expectedTurnId);
+            if (previous.state !== "not_sent")
+                return reconcile(id);
+        }
+        const snapshot = await deps.observe(input.target);
+        const interaction = currentInteraction(snapshot, input, expectedTurnId);
+        validateDesktopResponseValue(interaction, input);
+        const reserved = withWatch(watchId, input, () => reserve(input, interaction, snapshot));
+        if (!reserved.claimed)
+            return reserved.record;
+        await dispatch(input, snapshot, reserved.record, watchId);
+        return reconcile(id);
+    }
+    return {
+        respond: (input) => respond(input), reconcile, status, list: () => repo.list(),
+        async respondWatch(watchId, input) {
+            const task = deps.tasks.load(watchId);
+            if (!task || task.controller_session !== input.controllerSession)
+                throw new DesktopTaskError("desktop_controller_mismatch", "Watch response requires its owning controller");
+            if (backendObservationStopped(task))
+                throw new DesktopTaskError("desktop_watch_stopped", "Desktop Watch observation has stopped", "not_sent");
+            if (!task.native_turn_id)
+                throw new DesktopTaskError("stale_interaction", "Desktop Watch has no exact task anchor");
+            return respond({ ...input, target: task.target, desktopId: task.desktop_id }, task.native_turn_id, watchId);
+        }
+    };
+}
+//# sourceMappingURL=desktop-response-service.js.map