@scotthuang/agent-knock-knock 0.13.18 → 0.14.1

package/dist/src/conversation-routing-identity.js

@@ -0,0 +1,174 @@
+import path from "node:path";
+import { parseCodexNativeConversationId } from "./codex-native-identity.js";
+import { formatTerminalConversationId, parseTerminalConversationId } from "./terminal-agent-adapter.js";
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
+/** Legacy terminal IDs name the same exact provider, agent, endpoint and process. */
+export function canonicalTerminalRouteId(value) {
+    const identity = parseTerminalConversationId(value);
+    if (!identity)
+        throw new Error("Invalid exact terminal route identity");
+    return formatTerminalConversationId(identity);
+}
+export function terminalRouteIdsMatch(left, right) {
+    if (typeof left !== "string")
+        return false;
+    try {
+        return canonicalTerminalRouteId(left) === canonicalTerminalRouteId(right);
+    }
+    catch {
+        return false;
+    }
+}
+/** Link only fresh physical identity evidence. A same-cwd or resume command match never participates. */
+export function associateConversationRoutes(terminals, nativeRows, options = {}) {
+    const associations = [];
+    const unassociated = [];
+    for (const terminal of terminals) {
+        const identity = terminalIdentity(terminal, options);
+        const terminalId = text(terminal.id) ?? text(terminal.terminal_id) ?? "";
+        if ("status" in identity) {
+            unassociated.push({ terminalId, reason: identity.reason });
+            continue;
+        }
+        const candidates = nativeRows.flatMap(row => {
+            const id = liveNativeId(row);
+            if (!id)
+                return [];
+            const proof = proveIdentity(id, identity);
+            return proof.status === "exact" ? [proof.association] : [];
+        });
+        if (candidates.length === 1)
+            associations.push(candidates[0]);
+        else
+            unassociated.push({ terminalId, reason: candidates.length ? "ambiguous_native_identity" : "matching_loaded_backend_not_found" });
+    }
+    return { associations, unassociated };
+}
+/** Native-offline fallback still requires the exact fresh terminal thread and home.
+ * This proves identity only; dispatch certainty and terminal input safety remain separate gates.
+ */
+export function proveNativeTerminalRoute(nativeId, terminal, options = {}) {
+    const identity = terminalIdentity(terminal, options);
+    return "status" in identity ? identity : proveIdentity(nativeId, identity);
+}
+/** Multiple exact aliases are useful for List but cannot select a fallback terminal implicitly. */
+export function resolveNativeTerminalRoute(nativeId, terminals, options = {}) {
+    const matches = terminals.map(terminal => proveNativeTerminalRoute(nativeId, terminal, options))
+        .filter((proof) => proof.status === "exact");
+    if (matches.length === 1)
+        return matches[0];
+    return { status: matches.length ? "ambiguous" : "unavailable",
+        reason: matches.length ? "multiple_exact_terminal_aliases" : "no_exact_terminal_alias" };
+}
+/** The closed inspection transaction is internal evidence, never a user-supplied routing hint. */
+export function withClosedStatusInspection(before, after, observation) {
+    const beforeId = liveTerminalId(before), afterId = liveTerminalId(after);
+    if (typeof beforeId !== "string" || typeof afterId !== "string" || !terminalRouteIdsMatch(beforeId, afterId)) {
+        throw new Error("Native status inspection lost its exact terminal identity; no task input was sent");
+    }
+    for (const key of ["pid", "native_agent_process_uuid", "native_agent_process_birth"]) {
+        if (before[key] !== after[key])
+            throw new Error("Native status inspection changed terminal process incarnation; no task input was sent");
+    }
+    const threadId = uuid(observation.native_thread_id);
+    if (observation.status !== "observed" || observation.inspection !== "status" || observation.agent !== "codex" ||
+        !terminalRouteIdsMatch(observation.terminal_id, beforeId) || !threadId) {
+        throw new Error("Native status inspection did not prove the exact selected Codex thread; no task input was sent");
+    }
+    const row = { ...after, _routing_inspection_thread_id: threadId };
+    const proof = currentThreadIdentity(row);
+    if ("status" in proof || proof.evidence !== "closed_status_inspection") {
+        throw new Error("Native status inspection conflicted with current terminal identity or readiness; no task input was sent");
+    }
+    return row;
+}
+function terminalIdentity(terminal, options) {
+    const terminalId = liveTerminalId(terminal);
+    if (typeof terminalId !== "string")
+        return terminalId;
+    const home = terminalHome(terminal, options);
+    if (typeof home !== "string")
+        return home;
+    const thread = currentThreadIdentity(terminal);
+    return "status" in thread ? thread : { terminalId, codexHome: home, ...thread };
+}
+function currentThreadIdentity(terminal) {
+    const nativeId = uuid(terminal.native_agent_session_id), cardId = uuid(terminal.native_agent_status_card_session_id);
+    const inspected = uuid(terminal._routing_inspection_thread_id);
+    const conflict = threadIdentityConflict(nativeId, cardId, inspected);
+    if (conflict)
+        return conflict;
+    const ready = terminal.activity_state === "idle" && record(terminal.approval_state)?.blocked !== true;
+    if (inspected && ready)
+        return { threadId: inspected, evidence: "closed_status_inspection" };
+    const observation = record(terminal.native_agent_identity_observation);
+    const resolved = observation?.status === "resolved" || !observation && terminal.native_identity_state === "resolved";
+    if (nativeId && resolved)
+        return { threadId: nativeId, evidence: "resolved_native_identity" };
+    if (cardId && ready)
+        return { threadId: cardId, evidence: "visible_status_card" };
+    return unavailable("current_native_thread_identity_missing");
+}
+function threadIdentityConflict(nativeId, cardId, inspected) {
+    if (nativeId && cardId && nativeId !== cardId)
+        return { status: "conflict", reason: "native_identity_status_card_conflict" };
+    if (inspected && [nativeId, cardId].some(id => id !== undefined && id !== inspected)) {
+        return { status: "conflict", reason: "native_identity_inspection_conflict" };
+    }
+    return undefined;
+}
+function liveTerminalId(terminal) {
+    const terminalId = text(terminal.id) ?? text(terminal.terminal_id);
+    if (terminal.agent !== "codex" || terminal.process_state !== "active" || !terminalId?.startsWith("terminal:")) {
+        return unavailable("not_a_live_codex_terminal");
+    }
+    if (!Number.isSafeInteger(terminal.pid) || Number(terminal.pid) < 2 ||
+        !text(terminal.native_agent_process_uuid) || !text(terminal.native_agent_process_birth)) {
+        return unavailable("physical_process_incarnation_missing");
+    }
+    return terminalId;
+}
+function terminalHome(terminal, _options) {
+    const supplied = [terminal.codex_home, terminal.native_agent_codex_home, terminal._codex_home].filter(value => value !== undefined);
+    const homes = supplied.map(normalizeHome);
+    if (homes.some(home => home === undefined))
+        return unavailable("invalid_codex_home_evidence");
+    const unique = [...new Set(homes)];
+    if (unique.length > 1)
+        return { status: "conflict", reason: "codex_home_evidence_conflict" };
+    const home = unique[0];
+    return home ?? unavailable("codex_home_evidence_missing");
+}
+function proveIdentity(nativeId, identity) {
+    let native;
+    try {
+        native = parseCodexNativeConversationId(nativeId);
+    }
+    catch {
+        return unavailable("invalid_native_conversation_id");
+    }
+    if (native.codexHome !== identity.codexHome || uuid(native.threadId) !== identity.threadId) {
+        return { status: "conflict", reason: "native_terminal_identity_mismatch" };
+    }
+    return { status: "exact", association: { ...identity, nativeId, threadId: native.threadId } };
+}
+function liveNativeId(row) {
+    if (row.agent !== "codex" || row.source !== "codex_cli" || row.connection_state !== "loaded_backend_verified")
+        return undefined;
+    const id = text(row.conversation_id) ?? text(row.id);
+    if (!id)
+        return undefined;
+    try {
+        const identity = parseCodexNativeConversationId(id);
+        return uuid(row.native_thread_id) === uuid(identity.threadId) ? id : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizeHome(value) { return typeof value === "string" && path.isAbsolute(value) ? path.resolve(value) : undefined; }
+function uuid(value) { return typeof value === "string" && UUID.test(value) ? value.toLowerCase() : undefined; }
+function text(value) { return typeof value === "string" && value.trim() ? value : undefined; }
+function record(value) { return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined; }
+function unavailable(reason) { return { status: "unavailable", reason }; }
+//# sourceMappingURL=conversation-routing-identity.js.map

package/dist/src/conversation-routing-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-routing-identity.js","sourceRoot":"","sources":["../../src/conversation-routing-identity.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAiBxG,MAAM,IAAI,GAAG,kEAAkE,CAAC;AAEhF,qFAAqF;AACrF,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,MAAM,QAAQ,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACxE,OAAO,4BAA4B,CAAC,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAa,EAAE,KAAa;IAChE,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC;QAAC,OAAO,wBAAwB,CAAC,IAAI,CAAC,KAAK,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAClF,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACzB,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,2BAA2B,CAAC,SAAyB,EAAE,UAA0B,EAC/F,OAAO,GAAuC,EAAE;IAChD,MAAM,YAAY,GAAmC,EAAE,CAAC;IACxD,MAAM,YAAY,GAAkD,EAAE,CAAC;IACvE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACzE,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAAC,YAAY,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACnG,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YAC1C,MAAM,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,EAAE;gBAAE,OAAO,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC1C,OAAO,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,CAAC,CAAC,CAAC;QACH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;;YACzD,YAAY,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,mCAAmC,EAAE,CAAC,CAAC;IACxI,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB,EAAE,QAAa,EACtE,OAAO,GAAuC,EAAE;IAChD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,OAAO,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC7E,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,0BAA0B,CAAC,QAAgB,EAAE,SAAyB,EACpF,OAAO,GAAuC,EAAE;IAChD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;SAC7F,MAAM,CAAC,CAAC,KAAK,EAAiE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;IAC9G,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa;QAC3D,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,yBAAyB,EAAE,CAAC;AAC7F,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,0BAA0B,CAAC,MAAW,EAAE,KAAU,EAAE,WAAgB;IAClF,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACzE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QAC7G,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACvG,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,2BAA2B,EAAE,4BAA4B,CAAC,EAAE,CAAC;QACrF,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;IAC3I,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IACpD,IAAI,WAAW,CAAC,MAAM,KAAK,UAAU,IAAI,WAAW,CAAC,UAAU,KAAK,QAAQ,IAAI,WAAW,CAAC,KAAK,KAAK,OAAO;QAC3G,CAAC,qBAAqB,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,gGAAgG,CAAC,CAAC;IACpH,CAAC;IACD,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,EAAE,6BAA6B,EAAE,QAAQ,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,QAAQ,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,0BAA0B,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,yGAAyG,CAAC,CAAC;IAC7H,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAa,EAAE,OAA2C;IAClF,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC;IACtD,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;AAClF,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAa;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC;IACrH,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACrE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,cAAc,KAAK,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACtG,IAAI,SAAS,IAAI,KAAK;QAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IAC7F,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,WAAW,EAAE,MAAM,KAAK,UAAU,IAAI,CAAC,WAAW,IAAI,QAAQ,CAAC,qBAAqB,KAAK,UAAU,CAAC;IACrH,IAAI,QAAQ,IAAI,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IAC9F,IAAI,MAAM,IAAI,KAAK;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClF,OAAO,WAAW,CAAC,wCAAwC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAiB,EAAE,MAAe,EAAE,SAAkB;IACpF,IAAI,QAAQ,IAAI,MAAM,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,sCAAsC,EAAE,CAAC;IAC7H,IAAI,SAAS,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC;QACrF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,qCAAqC,EAAE,CAAC;IAC/E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,QAAa;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnE,IAAI,QAAQ,CAAC,KAAK,KAAK,OAAO,IAAI,QAAQ,CAAC,aAAa,KAAK,QAAQ,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9G,OAAO,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QACjE,CAAC,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC1F,OAAO,WAAW,CAAC,sCAAsC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,YAAY,CAAC,QAAa,EAAE,QAA4C;IAC/E,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,uBAAuB,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IACpI,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC;QAAE,OAAO,WAAW,CAAC,6BAA6B,CAAC,CAAC;IAC9F,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;IAC7F,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,IAAI,IAAI,WAAW,CAAC,6BAA6B,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,QAA0B;IACjE,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QAAC,MAAM,GAAG,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IAAC,CAAC;IAC1D,MAAM,CAAC;QAAC,OAAO,WAAW,CAAC,gCAAgC,CAAC,CAAC;IAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC3F,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,mCAAmC,EAAE,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AAChG,CAAC;AACD,SAAS,YAAY,CAAC,GAAQ;IAC5B,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,gBAAgB,KAAK,yBAAyB;QAAE,OAAO,SAAS,CAAC;IAChI,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrD,IAAI,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,8BAA8B,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AAC/B,CAAC;AACD,SAAS,aAAa,CAAC,KAAc,IAAwB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5J,SAAS,IAAI,CAAC,KAAc,IAAwB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC7I,SAAS,IAAI,CAAC,KAAc,IAAwB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3H,SAAS,MAAM,CAAC,KAAc,IAAqB,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5J,SAAS,WAAW,CAAC,MAAc,IAAmB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC"}

package/dist/src/conversation-runtime-route-store.d.ts

@@ -0,0 +1,11 @@
+import { type ConversationRouteStore } from "./conversation-route-store.js";
+/** New reservations never acquire the managed Store writer lease. Existing development
+ * journals remain read-only authority; migration preserves their provider and outcome.
+ * Writers using this wrapper share a message lock. Older binaries that write only the
+ * legacy journal are not coordinated; any observed disagreement fails closed.
+ */
+export declare function createConversationRuntimeRouteStore(storeDir: string, runtimeDir: string, locks: {
+    acquire(lockPath: string): () => void;
+}, options?: {
+    now?(): Date;
+}): ConversationRouteStore;

package/dist/src/conversation-runtime-route-store.js

@@ -0,0 +1,118 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { isNodeError } from "./durable-json-file.js";
+import { ensureDir } from "./store.js";
+import { ConversationRouteError, conversationRouteId, createConversationRouteStore } from "./conversation-route-store.js";
+/** Resolve aliases even before the configured directory itself exists. */
+function canonicalPath(directory) {
+    let current = path.resolve(directory);
+    const suffix = [];
+    while (true) {
+        try {
+            return path.join(fs.realpathSync(current), ...suffix);
+        }
+        catch (error) {
+            if (!isNodeError(error, "ENOENT"))
+                throw error;
+            const parent = path.dirname(current);
+            if (parent === current)
+                throw error;
+            suffix.unshift(path.basename(current));
+            current = parent;
+        }
+    }
+}
+function privateDirectory(directory) {
+    try {
+        const stat = fs.lstatSync(directory);
+        if (!stat.isDirectory() || stat.isSymbolicLink() || (stat.mode & 0o077) !== 0 ||
+            process.getuid && stat.uid !== process.getuid()) {
+            throw new Error("Conversation routing runtime must be an owner-private real directory");
+        }
+    }
+    catch (error) {
+        if (!isNodeError(error, "ENOENT"))
+            throw error;
+        ensureDir(directory);
+    }
+}
+function reconcileRecords(legacy, current) {
+    if (!legacy || !current)
+        return legacy ?? current;
+    const immutable = ["id", "controller_session", "message_id", "request_text", "canonical_target", "route", "target_id"];
+    if (immutable.some(key => legacy[key] !== current[key]) ||
+        legacy.receipt !== undefined && current.receipt !== undefined && !isDeepStrictEqual(legacy.receipt, current.receipt)) {
+        throw new ConversationRouteError("conversation_route_conflict", "Managed Store and runtime journals disagree on this message's immutable route or receipt");
+    }
+    if (legacy.receipt)
+        return legacy;
+    if (current.receipt || current.state === "uncertain")
+        return current;
+    return legacy.state === "uncertain" ? legacy : current;
+}
+const choiceOf = (record) => ({ route: record.route, targetId: record.target_id });
+/** New reservations never acquire the managed Store writer lease. Existing development
+ * journals remain read-only authority; migration preserves their provider and outcome.
+ * Writers using this wrapper share a message lock. Older binaries that write only the
+ * legacy journal are not coordinated; any observed disagreement fails closed.
+ */
+export function createConversationRuntimeRouteStore(storeDir, runtimeDir, locks, options = {}) {
+    const runtimeRoot = canonicalPath(runtimeDir);
+    const routingRoot = path.join(runtimeRoot, "conversation-routing");
+    const scope = path.join(routingRoot, createHash("sha256").update(canonicalPath(storeDir)).digest("hex"));
+    const legacy = createConversationRouteStore(storeDir, locks, options);
+    const current = createConversationRouteStore(path.join(scope, "state"), locks, options);
+    const read = (input) => reconcileRecords(legacy.load(input), current.load(input));
+    const locked = (input, action) => {
+        const id = conversationRouteId(input.controllerSession, input.messageId);
+        for (const directory of [runtimeRoot, routingRoot, scope])
+            privateDirectory(directory);
+        const release = locks.acquire(path.join(scope, `${id}.lock`));
+        try {
+            return action();
+        }
+        finally {
+            release();
+        }
+    };
+    const copyPin = (input, record) => {
+        const choice = choiceOf(record);
+        current.reserve(input, choice);
+        read(input); // Never overwrite a conflicting reservation or a newly observed legacy outcome.
+        if (record.receipt)
+            current.recordReceipt(input, choice, record.receipt);
+        else if (record.state === "uncertain")
+            current.markUncertain(input, choice, record.error_code);
+    };
+    const update = (input, action) => locked(input, () => {
+        const record = read(input);
+        if (record)
+            copyPin(input, record);
+        const result = action();
+        read(input);
+        return result;
+    });
+    return {
+        load: input => locked(input, () => {
+            const record = read(input);
+            if (record && !record.receipt)
+                copyPin(input, record);
+            return read(input);
+        }),
+        reserve: (input, choice) => locked(input, () => {
+            const previous = read(input);
+            if (previous) {
+                if (!previous.receipt)
+                    copyPin(input, previous);
+                return { record: read(input), created: false };
+            }
+            const result = current.reserve(input, choice);
+            return { record: read(input), created: result.created };
+        }),
+        recordReceipt: (input, choice, receipt) => update(input, () => current.recordReceipt(input, choice, receipt)),
+        markUncertain: (input, choice, errorCode) => update(input, () => current.markUncertain(input, choice, errorCode))
+    };
+}
+//# sourceMappingURL=conversation-runtime-route-store.js.map

package/dist/src/conversation-runtime-route-store.js.map

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

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

@@ -0,0 +1,15 @@
+import { type DesktopAsyncInteraction, type DesktopSnapshot, type DesktopTurn, type DesktopTurnItem } from "./desktop-types.js";
+/** Match Desktop's accepted reply history; pending or rejected steering is not an answer. */
+export declare function desktopAsyncQuestions(snapshot: Pick<DesktopSnapshot, "threadId" | "turns">, turnId?: string): DesktopAsyncInteraction[];
+export declare function buildDesktopAsyncReply(interaction: DesktopAsyncInteraction, answer: string): string;
+export interface DesktopAsyncAnswerEvidence {
+    turnId: string;
+    interaction: DesktopAsyncInteraction;
+    answer: string;
+    clientUserMessageId: string;
+}
+/** Native correlation proves receipt, including steering-to-canonical item materialization. */
+export declare function findDesktopAsyncAnswer(snapshot: DesktopSnapshot, input: DesktopAsyncAnswerEvidence): {
+    turn: DesktopTurn;
+    item: DesktopTurnItem;
+} | null;

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

@@ -0,0 +1,88 @@
+import { createHash } from "node:crypto";
+import { DesktopIpcError } from "./desktop-types.js";
+const opening = "<send_user_message_question_reply>", closing = "</send_user_message_question_reply>";
+function messageText(item, turnId) {
+    if (item.type === "steeringUserMessage" && (item.status !== "accepted" || item.targetTurnId !== turnId))
+        return;
+    if (item.type !== "steeringUserMessage" && item.type !== "userMessage")
+        return;
+    const content = item.type === "userMessage" ? item.content : item.input;
+    return content?.length === 1 && content[0].type === "text" ? content[0].text : undefined;
+}
+function replies(item, turnId) {
+    const text = messageText(item, turnId)?.trim();
+    if (!text?.startsWith(opening) || !text.endsWith(closing) || text.length > 1024 * 1024)
+        return [];
+    try {
+        const parsed = JSON.parse(text.slice(opening.length, -closing.length));
+        const values = Array.isArray(parsed) ? parsed : [parsed];
+        if (values.length < 1 || values.length > 64)
+            return [];
+        return values.every((value) => Boolean(value && typeof value === "object"
+            && !Array.isArray(value) && typeof value.questionItemId === "string"
+            && typeof value.question === "string" && typeof value.answer === "string")) ? values : [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Match Desktop's accepted reply history; pending or rejected steering is not an answer. */
+export function desktopAsyncQuestions(snapshot, turnId) {
+    return snapshot.turns.flatMap(turn => {
+        if (!turn.itemsComplete || turn.status !== "inProgress" || (turnId !== undefined && turn.turnId !== turnId))
+            return [];
+        const answered = new Set(turn.items.flatMap(item => replies(item, turn.turnId).map(reply => reply.questionItemId)));
+        return turn.items.flatMap(item => item.type === "agentMessage" && item.delivery === "async"
+            ? (item.questions ?? []).flatMap((question, index) => {
+                const nativeId = JSON.stringify(["request_user_input_async", item.id, index]);
+                if (answered.has(nativeId) || answered.has(item.id))
+                    return [];
+                const options = question.options ?? [];
+                const digest = createHash("sha256").update(JSON.stringify([
+                    snapshot.threadId, turn.turnId, item.id, nativeId, question.title, options
+                ])).digest("hex");
+                return [{ id: `desktop-async-interaction:${digest}`, kind: "async_question", threadId: snapshot.threadId,
+                        turnId: turn.turnId, itemId: item.id, method: "request_user_input_async",
+                        questions: [{ id: nativeId, title: question.title, options: [...options], isOther: true }] }];
+            }) : []);
+    });
+}
+export function buildDesktopAsyncReply(interaction, answer) {
+    if (interaction.kind !== "async_question" || interaction.questions.length !== 1 || typeof answer !== "string"
+        || !answer.trim() || answer.length > 16_384)
+        throw new DesktopIpcError("invalid_argument", "Invalid Desktop asynchronous answer");
+    const question = interaction.questions[0];
+    return `${opening}\n${JSON.stringify([{ questionItemId: question.id, question: question.title, answer }])}\n${closing}`;
+}
+function hasClientId(item, clientId) {
+    if (item.type === "userMessage")
+        return item.clientId === clientId;
+    return item.type === "steeringUserMessage" && item.clientUserMessageId === clientId
+        && (item.serverClientUserMessageId == null || item.serverClientUserMessageId === clientId);
+}
+function sameReply(item, input) {
+    const matches = replies(item, input.turnId);
+    const question = input.interaction.questions[0];
+    return matches.length === 1 && matches[0].questionItemId === question.id
+        && matches[0].question === question.title && matches[0].answer === input.answer;
+}
+/** Native correlation proves receipt, including steering-to-canonical item materialization. */
+export function findDesktopAsyncAnswer(snapshot, input) {
+    if (snapshot.threadId !== input.interaction.threadId || input.turnId !== input.interaction.turnId)
+        return null;
+    const correlated = snapshot.turns.flatMap(turn => turn.items.filter(item => hasClientId(item, input.clientUserMessageId))
+        .map(item => ({ turn, item })));
+    if (!correlated.length || correlated.some(({ turn, item }) => turn.turnId !== input.turnId
+        || !turn.itemsComplete || !sameReply(item, input)))
+        return null;
+    if (correlated.length === 1)
+        return correlated[0];
+    // Desktop can retain the accepted steering item alongside its canonical user message.
+    if (correlated.length !== 2)
+        return null;
+    const steering = correlated.find(({ item }) => item.type === "steeringUserMessage");
+    const canonical = correlated.find(({ item }) => item.type === "userMessage");
+    return steering && canonical && (steering.item.serverUserMessageId == null
+        || steering.item.serverUserMessageId === canonical.item.id) ? canonical : null;
+}
+//# sourceMappingURL=desktop-async-interactions.js.map

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

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

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

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

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

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

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

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

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

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