@scotthuang/agent-knock-knock 0.13.18 → 0.14.0

package/dist/src/desktop-snapshot-details.js.map

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

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

@@ -0,0 +1,11 @@
+import { type DesktopSnapshot, type DesktopTurn, type DesktopTurnItem } from "./desktop-types.js";
+export declare function desktopRecord(value: unknown): value is Record<string, unknown>;
+type SnapshotIdentity = Pick<DesktopSnapshot, "threadId" | "ownerClientId" | "revision">;
+export declare function reduceDesktopSnapshot(raw: unknown, identity: SnapshotIdentity): DesktopSnapshot;
+/** AKK submits exactly one text input; other content shapes are not an exact submission proof. */
+export declare function desktopUserMessageText(item: DesktopTurnItem): string | null;
+export declare function findDesktopSubmission(snapshot: DesktopSnapshot, clientUserMessageId: string, prompt: string): {
+    turn: DesktopTurn;
+    item: DesktopTurnItem;
+} | null;
+export {};

package/dist/src/desktop-snapshot.js

@@ -0,0 +1,276 @@
+import { DesktopIpcError } from "./desktop-types.js";
+import { desktopAsyncQuestions } from "./desktop-async-interactions.js";
+import { parseDesktopRequestInteraction } from "./desktop-request-interactions.js";
+import { desktopSettingsSnapshot, projectDesktopItemDetails } from "./desktop-snapshot-details.js";
+export function desktopRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function invalid(message) { throw new DesktopIpcError("invalid_response", message); }
+function identifier(value, name) {
+    if (typeof value !== "string" || !value.length || value.length > 512)
+        invalid(`Invalid Desktop ${name}`);
+    return value;
+}
+const statuses = new Set(["inProgress", "completed", "failed", "interrupted"]);
+const approvals = new Set(["item/commandExecution/requestApproval", "item/fileChange/requestApproval",
+    "item/permissions/requestApproval"]);
+const questions = new Set(["item/tool/requestUserInput", "item/tool/requestOptionPicker",
+    "mcpServer/elicitation/request", "item/plan/requestImplementation"]);
+function content(value) {
+    if (!Array.isArray(value))
+        invalid("Invalid Desktop message content");
+    return value.map(part => {
+        if (!desktopRecord(part))
+            invalid("Invalid Desktop message content part");
+        const type = identifier(part.type, "content type");
+        if (type === "text" && typeof part.text !== "string")
+            invalid("Invalid Desktop user message text");
+        return { type, ...(typeof part.text === "string" ? { text: part.text } : {}) };
+    });
+}
+function asyncQuestions(value) {
+    if (!Array.isArray(value) || value.length > 64)
+        invalid("Invalid Desktop async questions");
+    return value.map(question => {
+        if (!desktopRecord(question) || typeof question.title !== "string" || question.title.length > 16_384) {
+            invalid("Invalid Desktop async question title");
+        }
+        if (question.options == null)
+            return { title: question.title };
+        if (!Array.isArray(question.options) || question.options.length > 128
+            || question.options.some(option => typeof option !== "string" || option.length > 16_384)) {
+            invalid("Invalid Desktop async question options");
+        }
+        return { title: question.title, options: [...question.options] };
+    });
+}
+function projectItemStringFields(value, result) {
+    for (const key of ["text", "status"]) {
+        if (value[key] !== undefined && typeof value[key] !== "string")
+            invalid(`Invalid Desktop item ${key}`);
+        if (typeof value[key] === "string")
+            result[key] = value[key];
+    }
+    for (const key of ["clientId", "phase", "serverUserMessageId", "serverClientUserMessageId",
+        "clientUserMessageId", "targetTurnId", "delivery"]) {
+        if (value[key] !== undefined && value[key] !== null && typeof value[key] !== "string")
+            invalid(`Invalid Desktop item ${key}`);
+        if (value[key] !== undefined)
+            result[key] = value[key];
+    }
+}
+function item(value) {
+    if (!desktopRecord(value))
+        invalid("Invalid Desktop turn item");
+    const result = { id: identifier(value.id, "item id"), type: identifier(value.type, "item type") };
+    projectItemStringFields(value, result);
+    projectDesktopItemDetails(value, result);
+    if (value.content !== undefined)
+        result.content = content(value.content);
+    if (result.type === "steeringUserMessage" && value.input !== undefined)
+        result.input = content(value.input);
+    if (result.type === "agentMessage" && value.questions !== undefined) {
+        result.questions = value.questions === null ? null : asyncQuestions(value.questions);
+    }
+    if (result.type === "userMessage" && !result.content)
+        invalid("Desktop user message has no content");
+    if (result.type === "agentMessage" && typeof result.text !== "string")
+        invalid("Desktop agent message has no text");
+    return result;
+}
+function parseTurn(value) {
+    if (!desktopRecord(value) || !Array.isArray(value.items))
+        invalid("Invalid Desktop turn shape");
+    const result = {
+        turnId: identifier(value.turnId, "turn id"),
+        status: statuses.has(String(value.status)) ? value.status : "unknown",
+        items: value.items.map(item),
+        itemsComplete: true
+    };
+    const ids = new Set();
+    for (const entry of result.items) {
+        if (ids.has(entry.id))
+            invalid("Duplicate Desktop item id in one turn");
+        ids.add(entry.id);
+    }
+    if (value.itemsView !== undefined && value.itemsView !== "full")
+        result.itemsComplete = false;
+    if (value.itemsPagination !== undefined && value.itemsPagination !== null) {
+        const p = value.itemsPagination;
+        result.itemsComplete = result.itemsComplete && desktopRecord(p) && p.hasLoadedOldest === true && p.isLoadingOlder === false
+            && p.olderCursor == null && p.reconnect == null && p.summaryItemIds == null && p.evicted !== true;
+    }
+    if (desktopRecord(value.error) && typeof value.error.message === "string")
+        result.error = value.error.message;
+    return result;
+}
+/** Live turns overlay canonical history by identity, without dropping canonical items. */
+function overlayTurn(canonical, live) {
+    if (canonical.status !== live.status && canonical.status !== "inProgress") {
+        invalid("Conflicting Desktop terminal turn status");
+    }
+    const items = new Map(canonical.items.map((entry) => [entry.id, entry]));
+    for (const entry of live.items) {
+        const previous = items.get(entry.id);
+        if (previous && (previous.type !== entry.type || (entry.type === "userMessage"
+            && (previous.clientId !== entry.clientId || JSON.stringify(previous.content) !== JSON.stringify(entry.content))))) {
+            invalid("Conflicting Desktop item identity");
+        }
+        items.set(entry.id, entry);
+    }
+    return { ...canonical, ...live, items: [...items.values()], itemsComplete: canonical.itemsComplete && live.itemsComplete };
+}
+function pendingRequest(value) {
+    if (!desktopRecord(value))
+        return { kind: "unknown" };
+    const method = typeof value.method === "string" ? value.method : undefined;
+    return {
+        kind: method && approvals.has(method) ? "approval" : method && questions.has(method) ? "user_input" : "unknown",
+        ...(method ? { method } : {}),
+        ...(typeof value.id === "string" || typeof value.id === "number" ? { requestId: value.id } : {}),
+        ...(desktopRecord(value.params) && typeof value.params.turnId === "string" ? { turnId: value.params.turnId } : {})
+    };
+}
+function canonicalHistory(raw) {
+    if (raw == null)
+        return { turns: [], tailKnown: true };
+    if (!desktopRecord(raw))
+        invalid("Invalid Desktop turn history");
+    if (raw.kind === "legacy")
+        return { turns: [], tailKnown: true };
+    if (raw.kind !== "canonical")
+        invalid("Unknown Desktop history representation");
+    const history = raw.history;
+    if (!desktopRecord(history) || !desktopRecord(history.entitiesByKey) || !Array.isArray(history.islands)) {
+        invalid("Invalid Desktop canonical history");
+    }
+    const turns = [];
+    for (const island of history.islands) {
+        if (!desktopRecord(island) || !Array.isArray(island.entries))
+            invalid("Invalid Desktop history island");
+        for (const entry of island.entries) {
+            if (!desktopRecord(entry) || typeof entry.value !== "string" || !Object.hasOwn(history.entitiesByKey, entry.value)) {
+                invalid("Missing Desktop canonical turn entity");
+            }
+            turns.push(history.entitiesByKey[entry.value]);
+        }
+    }
+    const last = history.islands.at(-1);
+    const tailKnown = history.islands.length === 0 ? history.isComplete === true
+        : desktopRecord(last) && desktopRecord(last.newerBoundary) && last.newerBoundary.status === "exhausted";
+    return { turns, tailKnown };
+}
+function mergeHistoryTurns(canonical, live) {
+    const turns = new Map();
+    let unidentifiedTurn = false, tailId = null;
+    const readTurn = (value) => {
+        if (desktopRecord(value) && value.turnId == null) {
+            unidentifiedTurn = true;
+            return null;
+        }
+        return parseTurn(value);
+    };
+    for (const value of canonical) {
+        const turn = readTurn(value);
+        if (!turn)
+            continue;
+        if (turns.has(turn.turnId))
+            invalid("Duplicate Desktop canonical turn identity");
+        turns.set(turn.turnId, turn);
+        tailId = turn.turnId;
+    }
+    const liveIds = new Set();
+    for (const value of live) {
+        const turn = readTurn(value);
+        if (!turn)
+            continue;
+        if (liveIds.has(turn.turnId))
+            invalid("Duplicate Desktop live turn identity");
+        liveIds.add(turn.turnId);
+        const previous = turns.get(turn.turnId);
+        turns.set(turn.turnId, previous ? overlayTurn(previous, turn) : turn);
+        // An overlay of an older canonical turn must not move the known tail backwards.
+        if (!previous)
+            tailId = turn.turnId;
+    }
+    return { turns: [...turns.values()], tailId, unidentifiedTurn };
+}
+function sendBlockedReason(raw, state) {
+    if (raw.mode !== "default")
+        return "unsupported_thread_mode";
+    if (raw.resumeState !== "resumed")
+        return "thread_not_resumed";
+    if (state.runtimeStatus !== "idle")
+        return "runtime_not_idle";
+    if (desktopRecord(raw.threadGoal) && raw.threadGoal.status === "active")
+        return "active_thread_goal";
+    if (state.requests)
+        return "pending_desktop_request";
+    if (state.unconfirmed)
+        return "unconfirmed_submission";
+    if (state.unidentifiedTurn)
+        return "unidentified_turn";
+    if (!state.tailKnown)
+        return "unknown_history_tail";
+    if (state.turns.some((turn) => turn.status === "inProgress" || turn.status === "unknown"))
+        return "nonterminal_or_unknown_turn";
+    return undefined;
+}
+function assertSnapshotEnvelope(raw, identity) {
+    if (!desktopRecord(raw) || raw.id !== identity.threadId || raw.hostId !== "local"
+        || !Number.isSafeInteger(identity.revision) || identity.revision < 0)
+        invalid("Desktop snapshot identity/revision mismatch");
+    if (!Array.isArray(raw.turns) || !Array.isArray(raw.requests))
+        invalid("Unsupported Desktop snapshot shape");
+    if (raw.unconfirmedTurnSubmissions != null && !Array.isArray(raw.unconfirmedTurnSubmissions)) {
+        invalid("Unsupported Desktop unconfirmed submissions shape");
+    }
+}
+export function reduceDesktopSnapshot(raw, identity) {
+    assertSnapshotEnvelope(raw, identity);
+    const canonical = canonicalHistory(raw.turnHistory);
+    const history = mergeHistoryTurns(canonical.turns, raw.turns);
+    const runtime = desktopRecord(raw.threadRuntimeStatus) ? raw.threadRuntimeStatus.type : undefined;
+    const runtimeStatus = runtime === "idle" || runtime === "active"
+        || runtime === "notLoaded" || runtime === "systemError" ? runtime : "unknown";
+    const requests = raw.requests.map(pendingRequest);
+    const unconfirmed = Array.isArray(raw.unconfirmedTurnSubmissions) ? raw.unconfirmedTurnSubmissions.length : 0;
+    const blocked = sendBlockedReason(raw, { ...history, runtimeStatus, requests: requests.length, unconfirmed, tailKnown: canonical.tailKnown });
+    const async = desktopAsyncQuestions({ threadId: identity.threadId, turns: history.turns });
+    const interactions = raw.requests.flatMap(request => {
+        const interaction = parseDesktopRequestInteraction(request, identity.threadId, history.turns);
+        return interaction ? [interaction] : [];
+    });
+    return {
+        threadId: identity.threadId, ownerClientId: identity.ownerClientId, revision: identity.revision,
+        ...(typeof raw.title === "string" ? { title: raw.title } : {}),
+        ...(typeof raw.cwd === "string" ? { cwd: raw.cwd } : {}),
+        ...(typeof raw.mode === "string" ? { mode: raw.mode } : {}),
+        ...(typeof raw.originator === "string" ? { originator: raw.originator } : {}),
+        ...(typeof raw.resumeState === "string" ? { resumeState: raw.resumeState } : {}),
+        runtimeStatus, pendingRequests: requests, pendingRequestCount: requests.length,
+        asyncQuestions: async, pendingInteractions: [...interactions, ...async], ...desktopSettingsSnapshot(raw),
+        unconfirmedSubmissionCount: unconfirmed, tailKnown: canonical.tailKnown,
+        latestTurnId: canonical.tailKnown && !history.unidentifiedTurn ? history.tailId : null,
+        turns: history.turns, canSend: blocked === undefined, ...(blocked ? { idleBlockedReason: blocked } : {})
+    };
+}
+/** AKK submits exactly one text input; other content shapes are not an exact submission proof. */
+export function desktopUserMessageText(item) {
+    return item.type === "userMessage" && item.content?.length === 1 && item.content[0].type === "text"
+        && typeof item.content[0].text === "string" ? item.content[0].text : null;
+}
+export function findDesktopSubmission(snapshot, clientUserMessageId, prompt) {
+    const matches = snapshot.turns.flatMap((turn) => turn.items
+        .filter((entry) => entry.type === "userMessage" && entry.clientId === clientUserMessageId)
+        .map((entry) => ({ turn, item: entry })));
+    if (matches.length !== 1)
+        return null;
+    const match = matches[0];
+    // The native follower API may steer if a human starts a turn after preflight.
+    // Do not establish new-task ownership from one matching item in a mixed turn.
+    return match.turn.itemsComplete && desktopUserMessageText(match.item) === prompt
+        && match.turn.items.filter((entry) => entry.type === "userMessage").length === 1
+        && !match.turn.items.some((entry) => entry.type === "steeringUserMessage" || entry.type === "steered") ? match : null;
+}
+//# sourceMappingURL=desktop-snapshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-snapshot.js","sourceRoot":"","sources":["../../src/desktop-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAC8B,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAEnG,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AACD,SAAS,OAAO,CAAC,OAAe,IAAW,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACpG,SAAS,UAAU,CAAC,KAAc,EAAE,IAAY;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IACzG,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;AAC/E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,uCAAuC,EAAE,iCAAiC;IACnG,kCAAkC,CAAC,CAAC,CAAC;AACvC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,4BAA4B,EAAE,+BAA+B;IACtF,+BAA+B,EAAE,iCAAiC,CAAC,CAAC,CAAC;AAEvE,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,iCAAiC,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACtB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,sCAAsC,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACnD,IAAI,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,mCAAmC,CAAC,CAAC;QACnG,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAC3F,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;QAC1B,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;YACrG,OAAO,CAAC,sCAAsC,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI;YAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC/D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG;eAChE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;YAC3F,OAAO,CAAC,wCAAwC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAa,EAAE,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAAC,KAA8B,EAAE,MAAuB;IACtF,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAU,EAAE,CAAC;QAC9C,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;QACvG,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,qBAAqB,EAAE,2BAA2B;QACxF,qBAAqB,EAAE,cAAc,EAAE,UAAU,CAAU,EAAE,CAAC;QAC9D,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;QAC9H,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,SAAS,IAAI,CAAC,KAAc;IAC1B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAChE,MAAM,MAAM,GAAoB,EAAE,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC;IACnH,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5G,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,CAAC,qCAAqC,CAAC,CAAC;IACrG,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,mCAAmC,CAAC,CAAC;IACpH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAChG,MAAM,MAAM,GAAgB;QAC1B,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC;QAC3C,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAA2B,CAAC,CAAC,CAAC,SAAS;QAC1F,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAC5B,aAAa,EAAE,IAAI;KACpB,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,OAAO,CAAC,uCAAuC,CAAC,CAAC;QACxE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM;QAAE,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC;IAC9F,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;QAC1E,MAAM,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;QAChC,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI,IAAI,CAAC,CAAC,cAAc,KAAK,KAAK;eACtH,CAAC,CAAC,WAAW,IAAI,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,CAAC,cAAc,IAAI,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC;IACtG,CAAC;IACD,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;IAC9G,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0FAA0F;AAC1F,SAAS,WAAW,CAAC,SAAsB,EAAE,IAAiB;IAC5D,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QAC1E,OAAO,CAAC,0CAA0C,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa;eACzE,CAAC,QAAQ,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpH,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,SAAS,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;AAC7H,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,OAAO;QACL,IAAI,EAAE,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QAC/G,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnH,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAY;IACpC,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACjE,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACjE,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,CAAC,wCAAwC,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACxG,OAAO,CAAC,mCAAmC,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO,CAAC,gCAAgC,CAAC,CAAC;QACxG,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnH,OAAO,CAAC,uCAAuC,CAAC,CAAC;YACnD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI;QAC1E,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,WAAW,CAAC;IAC1G,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAoB,EAAE,IAAe;IAG9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC7C,IAAI,gBAAgB,GAAG,KAAK,EAAE,MAAM,GAAkB,IAAI,CAAC;IAC3D,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAsB,EAAE;QACtD,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YAAC,gBAAgB,GAAG,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QAC3F,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,CAAC,2CAA2C,CAAC,CAAC;QACjF,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACrD,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,CAAC,sCAAsC,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtE,gFAAgF;QAChF,IAAI,CAAC,QAAQ;YAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,iBAAiB,CAAC,GAA4B,EAAE,KAGxD;IACC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,yBAAyB,CAAC;IAC7D,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,oBAAoB,CAAC;IAC/D,IAAI,KAAK,CAAC,aAAa,KAAK,MAAM;QAAE,OAAO,kBAAkB,CAAC;IAC9D,IAAI,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,oBAAoB,CAAC;IACrG,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO,yBAAyB,CAAC;IACrD,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,wBAAwB,CAAC;IACvD,IAAI,KAAK,CAAC,gBAAgB;QAAE,OAAO,mBAAmB,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,OAAO,sBAAsB,CAAC;IACpD,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;QAAE,OAAO,6BAA6B,CAAC;IAChI,OAAO,SAAS,CAAC;AACnB,CAAC;AAKD,SAAS,sBAAsB,CAAC,GAAY,EAAE,QAA0B;IACtE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO;WAC5E,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,CAAC,6CAA6C,CAAC,CAAC;IAC/H,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAC7G,IAAI,GAAG,CAAC,0BAA0B,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC7F,OAAO,CAAC,mDAAmD,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAY,EAAE,QAA0B;IAC5E,sBAAsB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,MAAM,aAAa,GAAqC,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ;WAC7F,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9G,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9I,MAAM,KAAK,GAAG,qBAAqB,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3F,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QAClD,MAAM,WAAW,GAAG,8BAA8B,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9F,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IACH,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC/F,GAAG,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,CAAC,MAAM;QAC9E,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,KAAK,CAAC,EAAE,GAAG,uBAAuB,CAAC,GAAG,CAAC;QACxG,0BAA0B,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS;QACvE,YAAY,EAAE,SAAS,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QACtF,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzG,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,sBAAsB,CAAC,IAAqB;IAC1D,OAAO,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM;WAC9F,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAyB,EAAE,mBAA2B,EAAE,MAAc;IAG1G,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK;SACxD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,QAAQ,KAAK,mBAAmB,CAAC;SACzF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,8EAA8E;IAC9E,8EAA8E;IAC9E,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM;WAC3E,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC;WAC7E,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,qBAAqB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1H,CAAC"}

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

@@ -0,0 +1,72 @@
+import { type BackendRecoveryFields, type BackendRetryFields } from "./backend-task-recovery.js";
+import { type CallbackAttemptOutcome, type CallbackEnvelopeV1, type CallbackRouteV1 } from "./callback-transport.js";
+import type { DesktopAsyncInteraction, DesktopInteraction, DesktopThreadIdentity } from "./desktop-types.js";
+export declare const DESKTOP_TASKS_DIRECTORY = "desktop-tasks";
+export type DesktopTaskStatus = "awaiting_acceptance" | "watching" | "completed" | "failed" | "interrupted" | "timed_out" | "cancelled";
+export interface DesktopSendIntent {
+    message_id: string;
+    client_user_message_id: string;
+    text: string;
+    owner_client_id: string;
+    baseline_turn_ids: string[];
+    state: "reserved" | "uncertain" | "accepted" | "not_sent";
+    dispatched_at: string;
+    receipt_turn_id?: string;
+    error_code?: string;
+}
+export interface DesktopNotification extends BackendRetryFields {
+    id: string;
+    envelope: CallbackEnvelopeV1;
+    status: "ready" | "leased" | "retry_wait" | "accepted" | "failed" | "uncertain";
+    attempts: number;
+    attempt_id?: string;
+    lease_expires_at?: string;
+    retry_at?: string;
+    outcome?: CallbackAttemptOutcome;
+}
+export interface DesktopTaskRecord extends BackendRecoveryFields {
+    schema: "agent-knock-knock/desktop-task";
+    version: 1;
+    revision: number;
+    id: string;
+    watch_id: string;
+    desktop_id: string;
+    target: DesktopThreadIdentity;
+    controller_session: string;
+    kind: "send" | "watch";
+    status: DesktopTaskStatus;
+    created_at: string;
+    updated_at: string;
+    deadline_at: string;
+    native_turn_id?: string;
+    send_intent?: DesktopSendIntent;
+    callback_route?: CallbackRouteV1;
+    observed_at?: string;
+    observation_error?: string;
+    pending_manual_count: number;
+    pending_manual_fingerprint?: string;
+    /** Older v1 records omit this field; absence means no observed async questions. */
+    pending_async_interactions?: DesktopAsyncInteraction[];
+    /** All executable interactions; old async-only records remain readable. */
+    pending_interactions?: DesktopInteraction[];
+    final_text?: string;
+    notifications: DesktopNotification[];
+}
+export interface DesktopStateScan {
+    tasks: DesktopTaskRecord[];
+    errors: {
+        id: string;
+        error_code: "desktop_record_invalid";
+    }[];
+}
+export interface DesktopStateRepository {
+    load(id: string): DesktopTaskRecord | undefined;
+    list(): DesktopTaskRecord[];
+    scanForReconciliation(): DesktopStateScan;
+    save(record: DesktopTaskRecord, expectedRevision: number | null): DesktopTaskRecord;
+    withLock<T>(id: string, operation: () => T): T;
+}
+export declare function assertDesktopTaskRecord(value: unknown): asserts value is DesktopTaskRecord;
+export declare function createDesktopStateStore(storeDir: string, locks: {
+    acquire(lockPath: string): () => void;
+}): DesktopStateRepository;