@scotthuang/agent-knock-knock 0.13.18 → 0.14.1

package/dist/src/codex-native-types.d.ts

@@ -0,0 +1,92 @@
+import type { CodexAppServerReadTransport } from "./codex-app-server-transport.js";
+import type { CodexAppServerMetadata, CodexAppServerThread, CodexAppServerThreadItem } from "./codex-app-server-read-client.js";
+export interface CodexNativeIdentity {
+    codexHome: string;
+    threadId: string;
+}
+export type CodexNativeThread = CodexAppServerThread;
+export interface CodexNativeTurn {
+    id: string;
+    status: "inProgress" | "completed" | "failed" | "interrupted";
+    items: CodexAppServerThreadItem[];
+    itemsComplete: boolean;
+    error?: string;
+}
+export interface NativeQuestion {
+    id: string;
+    title: string;
+    options: string[];
+    isOther?: boolean;
+    isSecret?: boolean;
+}
+/** Request IDs belong to a single connection. Persist id, threadId, turnId and itemId instead. */
+export interface NativeInteraction {
+    id: string;
+    kind: "command_approval" | "file_approval" | "blocking_question" | "async_question";
+    threadId: string;
+    turnId: string;
+    itemId: string;
+    method: string;
+    requestId?: number | string;
+    approvalId?: string;
+    nativeApprovalKind?: string;
+    networkApprovalContext?: {
+        host: string;
+        protocol: string;
+    };
+    questions: NativeQuestion[];
+    command?: string;
+    reason?: string;
+    cwd?: string;
+    availableDecisions?: string[];
+    changes?: {
+        path: string;
+        kind?: string;
+        diff?: string;
+        diffTruncated?: boolean;
+    }[];
+}
+export interface CodexNativeSnapshot {
+    threadId: string;
+    thread: CodexNativeThread;
+    loaded: boolean;
+    latestTurnId: string | null;
+    turns: CodexNativeTurn[];
+    selectedTurn?: CodexNativeTurn;
+    pendingInteractions: NativeInteraction[];
+    canSend: boolean;
+}
+export type CodexNativePermissionPreset = "read-only" | "default" | "full-access";
+export interface CodexNativePermissions {
+    preset: CodexNativePermissionPreset | "custom";
+    profileId: string | null;
+    approvalPolicy: unknown;
+    approvalsReviewer: string;
+    sandbox: Record<string, unknown>;
+}
+export type NativeInteractionResponse = {
+    decision: "accept" | "decline" | "cancel";
+} | {
+    answers: Record<string, string[]>;
+};
+export interface CodexNativeClientOptions {
+    codexHome: string;
+    timeoutMs?: number;
+    transportFactory?: (options: {
+        socketPath: string;
+        timeoutMs: number;
+    }) => Promise<CodexAppServerReadTransport>;
+}
+export type CodexNativeDispatchState = "not_sent" | "unknown" | "accepted";
+export declare class CodexNativeError extends Error {
+    readonly code: "invalid_response" | "invalid_argument" | "timeout" | "closed" | "rpc_error" | "thread_not_loaded" | "thread_not_idle" | "unsupported_thread" | "stale_interaction" | "unsupported_capability" | "pagination_limit" | "duplicate_submission" | "unmaterialized_thread";
+    readonly dispatchState: CodexNativeDispatchState;
+    readonly rpcCode?: number | undefined;
+    readonly acceptedTurnId?: string | undefined;
+    constructor(code: "invalid_response" | "invalid_argument" | "timeout" | "closed" | "rpc_error" | "thread_not_loaded" | "thread_not_idle" | "unsupported_thread" | "stale_interaction" | "unsupported_capability" | "pagination_limit" | "duplicate_submission" | "unmaterialized_thread", message: string, dispatchState?: CodexNativeDispatchState, rpcCode?: number | undefined, acceptedTurnId?: string | undefined);
+}
+export interface CodexNativeReceipt {
+    turnId: string;
+    clientUserMessageId: string;
+}
+export type CodexNativeMetadata = CodexAppServerMetadata;

package/dist/src/codex-native-types.js

@@ -0,0 +1,15 @@
+export class CodexNativeError extends Error {
+    code;
+    dispatchState;
+    rpcCode;
+    acceptedTurnId;
+    constructor(code, message, dispatchState = "not_sent", rpcCode, acceptedTurnId) {
+        super(message);
+        this.code = code;
+        this.dispatchState = dispatchState;
+        this.rpcCode = rpcCode;
+        this.acceptedTurnId = acceptedTurnId;
+        this.name = "CodexNativeError";
+    }
+}
+//# sourceMappingURL=codex-native-types.js.map

package/dist/src/codex-native-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-native-types.js","sourceRoot":"","sources":["../../src/codex-native-types.ts"],"names":[],"mappings":"AAgEA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACb,IAAI;IAGC,aAAa;IAC9B,OAAO;IAA2B,cAAc;IAJhE,YAA4B,IAEwE,EACpG,OAAe,EAAkB,aAAa,GAA6B,UAAU,EACrE,OAAgB,EAAkB,cAAuB;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;oBALW,IAAI;6BAGC,aAAa;uBAC9B,OAAO;8BAA2B,cAAc;QAC9C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjD,CAAC;CACF"}

package/dist/src/conversation-list.d.ts

@@ -0,0 +1,12 @@
+import { type ConversationRoutingIdentityOptions } from "./conversation-routing-identity.js";
+type Row = Record<string, unknown>;
+/** Public conversation inventory; legacy endpoint arrays remain private-action/diagnostic inputs. */
+export declare function unifiedConversationList(result: Row, terminals: readonly Row[], identityOptions?: ConversationRoutingIdentityOptions): {
+    conversations: Row[];
+    conversation_routing: {
+        policy: string;
+        exact_associations: number;
+        unresolved_terminals: number;
+    };
+};
+export {};

package/dist/src/conversation-list.js

@@ -0,0 +1,30 @@
+import { associateConversationRoutes } from "./conversation-routing-identity.js";
+import { recordValue } from "./value-guards.js";
+const rows = (value) => Array.isArray(value) ? value.filter(item => recordValue(item)) : [];
+/** Public conversation inventory; legacy endpoint arrays remain private-action/diagnostic inputs. */
+export function unifiedConversationList(result, terminals, identityOptions = {}) {
+    const native = rows(result.codex_cli_sessions);
+    const association = associateConversationRoutes(terminals, native, identityOptions);
+    const linked = new Set(association.associations.map(item => item.terminalId));
+    const conversations = native.map(row => ({ ...row, route_preference: "codex_backend",
+        route_status: row.connection_state === "loaded_backend_verified" ? "backend_available" : "backend_unavailable",
+        terminal_aliases: association.associations.filter(item => item.nativeId === row.conversation_id).map(item => item.terminalId),
+        terminal_controls: rows(result.terminals).filter(terminal => association.associations.some(item => item.nativeId === row.conversation_id && item.terminalId === terminal.id)) }));
+    for (const terminal of rows(result.terminals)) {
+        if (linked.has(String(terminal.id)))
+            continue;
+        const actions = { ...recordValue(terminal.available_actions) };
+        for (const name of ["send", "status", "watch", "native_inspect", "permission_options", "model_options"]) {
+            const action = recordValue(actions[name]);
+            if (action)
+                actions[name] = { tool: action.tool, input: { conversation_id: terminal.id,
+                        ...(name === "native_inspect" ? { inspection: "status" } : {}) } };
+        }
+        conversations.push({ ...terminal, conversation_id: terminal.id, title: terminal.workspace ?? terminal.cwd ?? terminal.id,
+            route_preference: terminal.agent === "codex" ? "codex_backend" : "terminal", route_status: terminal.agent === "codex" ? "identity_unresolved" : "terminal_only", available_actions: actions });
+    }
+    conversations.push(...rows(result.desktop_sessions).map(row => ({ ...row, route_preference: "desktop_ipc" })));
+    return { ...result, conversations, conversation_routing: { policy: "backend_first", exact_associations: association.associations.length,
+            unresolved_terminals: association.unassociated.filter(item => terminals.some(t => t.id === item.terminalId && t.agent === "codex")).length } };
+}
+//# sourceMappingURL=conversation-list.js.map

package/dist/src/conversation-list.js.map

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

package/dist/src/conversation-route-dispatch.d.ts

@@ -0,0 +1,13 @@
+import { type ConversationRouteChoice, type ConversationRouteInput, type ConversationRouteStore } from "./conversation-route-store.js";
+export type ConversationRouteSelection = ConversationRouteChoice & {
+    reason?: string;
+};
+export interface ConversationRouteDispatchOptions {
+    command: string;
+    input?: ConversationRouteInput;
+    select(): Promise<ConversationRouteSelection>;
+    execute(choice: ConversationRouteSelection): Promise<Record<string, unknown>>;
+    store?: ConversationRouteStore;
+}
+/** Fallback belongs to preflight selection. Once chosen, delivery errors never switch transports. */
+export declare function dispatchConversationRoute(options: ConversationRouteDispatchOptions): Promise<Record<string, unknown>>;

package/dist/src/conversation-route-dispatch.js

@@ -0,0 +1,66 @@
+import { ConversationRouteError } from "./conversation-route-store.js";
+function choiceFromRecord(record) {
+    return { route: record.route, targetId: record.target_id };
+}
+function sameChoice(left, right) {
+    return left.route === right.route && left.targetId === right.targetId;
+}
+function resultWithRoute(result, choice, input, replayed = false) {
+    return { ...result, ...(replayed ? { replayed: true } : {}),
+        ...(input ? { message_id: input.messageId, requested_conversation_id: input.canonicalTarget } : {}),
+        routing: { policy: "backend_first", transport: choice.route === "native" ? "codex_backend" : "terminal",
+            selected_target: choice.targetId, ...(choice.reason ? { reason: choice.reason } : {}) } };
+}
+function errorCode(error) {
+    const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
+    return typeof code === "string" && /^[a-zA-Z0-9_-]{1,100}$/.test(code) ? code : undefined;
+}
+function saveReceipt(store, input, choice, result) {
+    try {
+        return { receipt: store.recordReceipt(input, choice, result).receipt, replayed: false };
+    }
+    catch (error) {
+        if (!(error instanceof ConversationRouteError) || error.code !== "conversation_route_conflict")
+            throw error;
+        // Concurrent same-message executions are deduplicated by the provider. Their observations can differ;
+        // preserve the first receipt only after the journal revalidates immutable input and route identity.
+        const existing = store.load(input);
+        if (!existing?.receipt || !sameChoice(choice, choiceFromRecord(existing)))
+            throw error;
+        return { receipt: existing.receipt, replayed: true };
+    }
+}
+/** Fallback belongs to preflight selection. Once chosen, delivery errors never switch transports. */
+export async function dispatchConversationRoute(options) {
+    if (options.command !== "send") {
+        const choice = await options.select();
+        return resultWithRoute(await options.execute(choice), choice, options.input);
+    }
+    const { input, store } = options;
+    if (!input || !store)
+        throw new Error("Send routing requires immutable input and a durable route store");
+    let record = store.load(input);
+    if (record?.receipt)
+        return resultWithRoute(record.receipt, choiceFromRecord(record), input, true);
+    let choice;
+    if (record)
+        choice = choiceFromRecord(record);
+    else {
+        const selected = await options.select();
+        record = store.reserve(input, selected).record;
+        choice = sameChoice(selected, choiceFromRecord(record)) ? selected : choiceFromRecord(record);
+        if (record.receipt)
+            return resultWithRoute(record.receipt, choice, input, true);
+    }
+    try {
+        // The executor must pass the original stable message ID to its selected provider's dispatch ledger.
+        const result = await options.execute(choice);
+        const saved = saveReceipt(store, input, choice, result);
+        return resultWithRoute(saved.receipt, choice, input, saved.replayed);
+    }
+    catch (error) {
+        store.markUncertain(input, choice, errorCode(error));
+        throw error;
+    }
+}
+//# sourceMappingURL=conversation-route-dispatch.js.map

package/dist/src/conversation-route-dispatch.js.map

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

package/dist/src/conversation-route-legacy.d.ts

@@ -0,0 +1,18 @@
+import { type CodexNativeTaskService } from "./codex-native-task-service.js";
+import { type ConversationRouteInput } from "./conversation-route-store.js";
+import type { ConversationRouteSelection } from "./conversation-route-dispatch.js";
+export interface LegacyConversationRouteOptions {
+    input: ConversationRouteInput;
+    nativeTasks: Pick<CodexNativeTaskService, "status">;
+    /** The same host runtime directory used by explicit terminal Send. */
+    terminalRuntimeDir: string;
+    /** Required to keep an old explicit Send in the provider that owns its ledger. */
+    expectedTerminalToken?: string;
+    managedOnly?: boolean;
+}
+/** Consult only the two exact old message ledgers, before backend discovery or input.
+ * An old reservation remains a route pin even when its outcome is uncertain.
+ * Terminal receipts predate public target storage; their provider must still
+ * validate runtime key and physical token before replay or any input.
+ */
+export declare function selectLegacyConversationRoute(options: LegacyConversationRouteOptions): ConversationRouteSelection | undefined;

package/dist/src/conversation-route-legacy.js

@@ -0,0 +1,54 @@
+import { createHash } from "node:crypto";
+import { assertCodexNativeTaskRecord } from "./codex-native-state-store.js";
+import { nativeDigest, nativeErrorCode } from "./codex-native-task-service.js";
+import { ConversationRouteError } from "./conversation-route-store.js";
+import { parseTerminalConversationId } from "./terminal-agent-adapter.js";
+import { terminalSubmissionPayload } from "./terminal-dispatch-execution.js";
+import { createTerminalUserSendIntentRepository } from "./terminal-user-send-intent.js";
+function conflict(detail) {
+    throw new ConversationRouteError("conversation_route_conflict", `Message ID is already bound to different immutable request input or a different legacy route: ${detail}`);
+}
+/** Consult only the two exact old message ledgers, before backend discovery or input.
+ * An old reservation remains a route pin even when its outcome is uncertain.
+ * Terminal receipts predate public target storage; their provider must still
+ * validate runtime key and physical token before replay or any input.
+ */
+export function selectLegacyConversationRoute(options) {
+    const { input, nativeTasks, terminalRuntimeDir } = options;
+    const id = `codex-cli-watch:${nativeDigest([input.controllerSession, input.messageId])}`;
+    let native;
+    try {
+        native = nativeTasks.status(id);
+    }
+    catch (error) {
+        if (nativeErrorCode(error) !== "codex_native_watch_not_found")
+            throw error;
+    }
+    if (native) {
+        assertCodexNativeTaskRecord(native);
+        if (native.id !== id || native.kind !== "send" || native.controller_session !== input.controllerSession ||
+            native.send_intent?.message_id !== input.messageId || native.send_intent.text !== input.requestText) {
+            conflict("native message identity or request changed");
+        }
+        if (native.native_id !== input.canonicalTarget)
+            conflict("native conversation changed or terminal alias is unproven");
+    }
+    const terminal = createTerminalUserSendIntentRepository({ runtimeDir: terminalRuntimeDir }).loadMessage({ messageId: input.messageId });
+    if (native && terminal)
+        conflict("both transport ledgers already exist; automatic routing is ambiguous");
+    if (native)
+        return { route: "native", targetId: native.native_id, reason: "legacy_native_message" };
+    if (!terminal)
+        return undefined;
+    const requestHash = createHash("sha256").update(terminalSubmissionPayload(input.requestText)).digest("hex");
+    if (terminal.request_hash !== requestHash)
+        conflict("terminal request changed");
+    const target = parseTerminalConversationId(input.canonicalTarget);
+    if (target?.agent !== "codex")
+        conflict("legacy terminal receipt cannot identify a terminal from a backend alias");
+    if (options.managedOnly || options.expectedTerminalToken !== terminal.physical_token) {
+        conflict("legacy terminal Send requires its exact explicit terminal authority");
+    }
+    return { route: "terminal", targetId: input.canonicalTarget, reason: "legacy_terminal_message" };
+}
+//# sourceMappingURL=conversation-route-legacy.js.map

package/dist/src/conversation-route-legacy.js.map

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

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

@@ -0,0 +1,51 @@
+export interface ConversationRouteInput {
+    controllerSession: string;
+    messageId: string;
+    requestText: string;
+    /** The selected public target. A retry through a different alias conflicts instead of authorizing another send. */
+    canonicalTarget: string;
+}
+export interface ConversationRouteChoice {
+    route: "native" | "terminal";
+    targetId: string;
+}
+export interface ConversationRouteRecord {
+    schema: "agent-knock-knock/conversation-route";
+    version: 1;
+    revision: number;
+    id: string;
+    controller_session: string;
+    message_id: string;
+    request_text: string;
+    canonical_target: string;
+    route: ConversationRouteChoice["route"];
+    target_id: string;
+    created_at: string;
+    updated_at: string;
+    /** A recorded receipt is an observation, not proof of delivery or task acceptance. */
+    state: "reserved" | "uncertain" | "recorded";
+    receipt?: Record<string, unknown>;
+    error_code?: string;
+}
+export interface ConversationRouteStore {
+    load(input: ConversationRouteInput): ConversationRouteRecord | undefined;
+    reserve(input: ConversationRouteInput, choice: ConversationRouteChoice): {
+        record: ConversationRouteRecord;
+        created: boolean;
+    };
+    recordReceipt(input: ConversationRouteInput, choice: ConversationRouteChoice, receipt: Record<string, unknown>): ConversationRouteRecord;
+    markUncertain(input: ConversationRouteInput, choice: ConversationRouteChoice, errorCode?: string): ConversationRouteRecord;
+}
+export declare class ConversationRouteError extends Error {
+    readonly code: "conversation_route_conflict" | "conversation_route_missing" | "conversation_route_invalid";
+    constructor(code: "conversation_route_conflict" | "conversation_route_missing" | "conversation_route_invalid", message: string);
+}
+export declare function conversationRouteId(controllerSession: string, messageId: string): string;
+/** Select once after preflight; crashes and uncertain delivery never authorize a different route.
+ * This journal does not replace the selected provider's stable-message-ID dispatch ledger.
+ */
+export declare function createConversationRouteStore(storeDir: string, locks: {
+    acquire(lockPath: string): () => void;
+}, options?: {
+    now?(): Date;
+}): ConversationRouteStore;

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

@@ -0,0 +1,126 @@
+import { createHash } from "node:crypto";
+import { isDeepStrictEqual } from "node:util";
+import { createNativeRecordRepository } from "./codex-native-record-store.js";
+export class ConversationRouteError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ConversationRouteError";
+    }
+}
+const nonblank = (value) => typeof value === "string" && value.trim().length > 0;
+const recordValue = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const validTime = (value) => typeof value === "string" && Number.isFinite(Date.parse(value));
+function invalid(message) { throw new ConversationRouteError("conversation_route_invalid", message); }
+function conflict() { throw new ConversationRouteError("conversation_route_conflict", "Message ID is already bound to different immutable request input or a different conversation route"); }
+export function conversationRouteId(controllerSession, messageId) {
+    if (!nonblank(controllerSession) || !nonblank(messageId))
+        invalid("Conversation route requires a controller and message ID");
+    return `conversation-route:${createHash("sha256").update(JSON.stringify([controllerSession, messageId])).digest("hex")}`;
+}
+function assertInput(input) {
+    if (!input || !nonblank(input.controllerSession) || !nonblank(input.messageId) ||
+        !nonblank(input.requestText) || !nonblank(input.canonicalTarget))
+        invalid("Invalid conversation route input");
+}
+function assertChoice(choice) {
+    if (!choice || !["native", "terminal"].includes(choice.route) || !nonblank(choice.targetId))
+        invalid("Invalid conversation route choice");
+}
+function assertMatches(record, input) {
+    if (record.controller_session !== input.controllerSession || record.message_id !== input.messageId ||
+        record.request_text !== input.requestText || record.canonical_target !== input.canonicalTarget)
+        conflict();
+}
+function assertRecord(value) {
+    const r = value;
+    if (!r || r.schema !== "agent-knock-knock/conversation-route" || r.version !== 1 ||
+        !Number.isSafeInteger(r.revision) || r.revision < 1 || !nonblank(r.request_text) || !nonblank(r.canonical_target) ||
+        !validTime(r.created_at) || !validTime(r.updated_at) || !["reserved", "uncertain", "recorded"].includes(r.state)) {
+        invalid("Invalid conversation route record");
+    }
+    if (r.id !== conversationRouteId(r.controller_session, r.message_id))
+        invalid("Conversation route record identity mismatch");
+    assertChoice({ route: r.route, targetId: r.target_id });
+    if ((r.state === "recorded") !== (r.receipt !== undefined) || r.receipt !== undefined && !recordValue(r.receipt) ||
+        r.error_code !== undefined && !/^[a-zA-Z0-9_-]{1,100}$/.test(r.error_code))
+        invalid("Invalid conversation route outcome");
+}
+function assertUpdate(previous, next) {
+    for (const key of ["id", "controller_session", "message_id", "request_text", "canonical_target", "route", "target_id", "created_at"]) {
+        if (previous[key] !== next[key])
+            conflict();
+    }
+    if (previous.receipt && !isDeepStrictEqual(previous.receipt, next.receipt))
+        conflict();
+    if (previous.state !== "reserved" && next.state === "reserved")
+        conflict();
+}
+/** Select once after preflight; crashes and uncertain delivery never authorize a different route.
+ * This journal does not replace the selected provider's stable-message-ID dispatch ledger.
+ */
+export function createConversationRouteStore(storeDir, locks, options = {}) {
+    const now = options.now ?? (() => new Date());
+    const repository = createNativeRecordRepository({ storeDir, directory: "conversation-routes",
+        prefix: "conversation-route:", acquire: locks.acquire, assert: assertRecord, assertUpdate });
+    const load = (input) => {
+        assertInput(input);
+        const found = repository.load(conversationRouteId(input.controllerSession, input.messageId));
+        if (found)
+            assertMatches(found, input);
+        return found;
+    };
+    const update = (input, choice, operation) => {
+        assertInput(input);
+        assertChoice(choice);
+        return repository.withLock(conversationRouteId(input.controllerSession, input.messageId), () => {
+            const current = load(input);
+            if (!current)
+                throw new ConversationRouteError("conversation_route_missing", "Conversation route must be reserved before recording an outcome");
+            if (current.route !== choice.route || current.target_id !== choice.targetId)
+                conflict();
+            const next = operation(current);
+            return next === current ? current : repository.save({ ...next, updated_at: now().toISOString() }, current.revision);
+        });
+    };
+    return {
+        load,
+        reserve(input, choice) {
+            assertInput(input);
+            assertChoice(choice);
+            return repository.withLock(conversationRouteId(input.controllerSession, input.messageId), () => {
+                const previous = load(input);
+                if (previous)
+                    return { record: previous, created: false };
+                const date = now().toISOString();
+                return { created: true, record: repository.save({ schema: "agent-knock-knock/conversation-route", version: 1,
+                        revision: 1, id: conversationRouteId(input.controllerSession, input.messageId), controller_session: input.controllerSession,
+                        message_id: input.messageId, request_text: input.requestText, canonical_target: input.canonicalTarget,
+                        route: choice.route, target_id: choice.targetId, created_at: date, updated_at: date, state: "reserved" }, null) };
+            });
+        },
+        recordReceipt(input, choice, receipt) {
+            if (!recordValue(receipt))
+                invalid("Conversation route receipt must be an object");
+            const saved = JSON.parse(JSON.stringify(receipt));
+            if (!recordValue(saved))
+                invalid("Conversation route receipt must serialize to an object");
+            return update(input, choice, current => {
+                if (current.receipt) {
+                    if (!isDeepStrictEqual(current.receipt, saved))
+                        conflict();
+                    return current;
+                }
+                return { ...current, state: "recorded", receipt: saved };
+            });
+        },
+        markUncertain(input, choice, errorCode) {
+            if (errorCode !== undefined && !/^[a-zA-Z0-9_-]{1,100}$/.test(errorCode))
+                invalid("Invalid conversation route error code");
+            return update(input, choice, current => current.state !== "reserved" ? current :
+                { ...current, state: "uncertain", ...(errorCode ? { error_code: errorCode } : {}) });
+        }
+    };
+}
+//# sourceMappingURL=conversation-route-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-route-store.js","sourceRoot":"","sources":["../../src/conversation-route-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAkC9E,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACnB,IAAI;IAAhC,YAA4B,IAAiG,EAAE,OAAe;QAC5I,KAAK,CAAC,OAAO,CAAC,CAAC;oBADW,IAAI;QACd,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvD,CAAC;CACF;AACD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3G,MAAM,WAAW,GAAG,CAAC,KAAc,EAAoC,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC/I,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACtG,SAAS,OAAO,CAAC,OAAe,IAAW,MAAM,IAAI,sBAAsB,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACrH,SAAS,QAAQ,KAAY,MAAM,IAAI,sBAAsB,CAAC,6BAA6B,EAAE,oGAAoG,CAAC,CAAC,CAAC,CAAC;AAErM,MAAM,UAAU,mBAAmB,CAAC,iBAAyB,EAAE,SAAiB;IAC9E,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,CAAC,yDAAyD,CAAC,CAAC;IAC7H,OAAO,sBAAsB,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC3H,CAAC;AACD,SAAS,WAAW,CAAC,KAA6B;IAChD,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5E,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC;QAAE,OAAO,CAAC,kCAAkC,CAAC,CAAC;AAClH,CAAC;AACD,SAAS,YAAY,CAAC,MAA+B;IACnD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,mCAAmC,CAAC,CAAC;AAC5I,CAAC;AACD,SAAS,aAAa,CAAC,MAA+B,EAAE,KAA6B;IACnF,IAAI,MAAM,CAAC,kBAAkB,KAAK,KAAK,CAAC,iBAAiB,IAAI,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS;QAChG,MAAM,CAAC,YAAY,KAAK,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,gBAAgB,KAAK,KAAK,CAAC,eAAe;QAAE,QAAQ,EAAE,CAAC;AAC/G,CAAC;AACD,SAAS,YAAY,CAAC,KAAc;IAClC,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,sCAAsC,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC;QAC9E,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC;QACjH,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACnH,OAAO,CAAC,mCAAmC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,CAAC,EAAE,KAAK,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,6CAA6C,CAAC,CAAC;IAC7H,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9G,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,oCAAoC,CAAC,CAAC;AAC9H,CAAC;AACD,SAAS,YAAY,CAAC,QAAiC,EAAE,IAA6B;IACpF,KAAK,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,CAAU,EAAE,CAAC;QAC9I,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC;YAAE,QAAQ,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;QAAE,QAAQ,EAAE,CAAC;IACvF,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU;QAAE,QAAQ,EAAE,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAgB,EAAE,KAAgD,EAC7G,OAAO,GAAqB,EAAE;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,4BAA4B,CAA0B,EAAE,QAAQ,EAAE,SAAS,EAAE,qBAAqB;QACnH,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC;IAC/F,MAAM,IAAI,GAAG,CAAC,KAA6B,EAAE,EAAE;QAC7C,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7F,IAAI,KAAK;YAAE,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,KAA6B,EAAE,MAA+B,EAC5E,SAAuE,EAAE,EAAE;QAC3E,WAAW,CAAC,KAAK,CAAC,CAAC;QAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE;YAC7F,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,sBAAsB,CAAC,4BAA4B,EAAE,iEAAiE,CAAC,CAAC;YAChJ,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,CAAC,QAAQ;gBAAE,QAAQ,EAAE,CAAC;YACxF,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YAChC,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,OAAO;QACL,IAAI;QACJ,OAAO,CAAC,KAAK,EAAE,MAAM;YACnB,WAAW,CAAC,KAAK,CAAC,CAAC;YAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE;gBAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC7B,IAAI,QAAQ;oBAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;gBAC1D,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;gBACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,sCAAsC,EAAE,OAAO,EAAE,CAAC;wBAC1G,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,mBAAmB,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,KAAK,CAAC,iBAAiB;wBAC3H,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE,gBAAgB,EAAE,KAAK,CAAC,eAAe;wBACrG,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;YACtH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO;YAClC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,8CAA8C,CAAC,CAAC;YACnF,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3D,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,wDAAwD,CAAC,CAAC;YAC3F,OAAO,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;gBACrC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;wBAAE,QAAQ,EAAE,CAAC;oBAAC,OAAO,OAAO,CAAC;gBAAC,CAAC;gBACpG,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC3D,CAAC,CAAC,CAAC;QACL,CAAC;QACD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS;YACpC,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC;gBAAE,OAAO,CAAC,uCAAuC,CAAC,CAAC;YAC3H,OAAO,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC9E,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/conversation-routing-cli-adapter.d.ts

@@ -0,0 +1,12 @@
+type Options = Record<string, unknown>;
+type Row = Record<string, unknown>;
+export interface ConversationRoutingCliPorts {
+    terminals(options: Options, terminalId?: string): Promise<Row[]>;
+    /** Executes the existing command without entering this router again. */
+    execute(command: string, options: Options): Promise<Row>;
+}
+export declare function executeConversationCommand(command: string | undefined, options: Options, terminals: ConversationRoutingCliPorts["terminals"], execute: (command: string | undefined, options: Options) => Promise<void>): Promise<void>;
+/** A read failure is fallback evidence only here, before either task transport is invoked. */
+export declare function backendPreflightUnavailable(error: unknown): boolean;
+export declare function dispatchRoutedConversationCli(command: string | undefined, original: Options, ports: ConversationRoutingCliPorts): Promise<boolean>;
+export {};