@scotthuang/agent-knock-knock 0.13.17 → 0.14.0

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":"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"}

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 {};

package/dist/src/conversation-routing-cli-adapter.js

@@ -0,0 +1,211 @@
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { cliDependencies, cliEnv, cliNow, cliNowMs, cliPid, cliSleepSync, writeCliStdout, runCliCommandExecution, setCliExitCode } from "./cli-runtime-context.js";
+import { codexNativeRuntimeOptions } from "./codex-native-cli-adapter.js";
+import { createCodexNativeRuntime } from "./codex-native-runtime.js";
+import { isCodexNativeConversationId, parseCodexNativeConversationId } from "./codex-native-identity.js";
+import { nativeErrorCode } from "./codex-native-task-service.js";
+import { parseTerminalConversationId } from "./terminal-agent-adapter.js";
+import { associateConversationRoutes, resolveNativeTerminalRoute, proveNativeTerminalRoute, withClosedStatusInspection, canonicalTerminalRouteId, terminalRouteIdsMatch } from "./conversation-routing-identity.js";
+import { createConversationRuntimeRouteStore } from "./conversation-runtime-route-store.js";
+import { dispatchConversationRoute } from "./conversation-route-dispatch.js";
+import { createFileLockCliAdapter } from "./file-lock-cli-adapter.js";
+import { recordValue, nonBlankString } from "./value-guards.js";
+import { terminalSubmissionPayload } from "./terminal-dispatch-execution.js";
+import { isCodexPaginatedReadCandidate } from "./codex-lifecycle-compatibility.js";
+import { selectLegacyConversationRoute } from "./conversation-route-legacy.js";
+import { defaultStoreDir } from "./store.js";
+import { expandHome } from "./cli-command-runtime.js";
+import { conversationCommandPolicy, conversationRoutedOptions, prepareConversationTerminalOptions, routedCommand } from "./conversation-routing-commands.js";
+const preflightUnavailable = new Set(["ENOENT", "ECONNREFUSED", "ECONNRESET", "ENOTSOCK", "ETIMEDOUT", "closed", "timeout", "unsupported_capability", "thread_not_loaded"]);
+export async function executeConversationCommand(command, options, terminals, execute) {
+    if (await dispatchRoutedConversationCli(command, options, {
+        terminals: cliDependencies().conversationRoutingTerminals ?? terminals,
+        execute: async (selectedCommand, selectedOptions) => {
+            const result = await runCliCommandExecution(selectedCommand, selectedOptions, { ...cliDependencies(), stdout: undefined }, () => execute(selectedCommand, selectedOptions));
+            setCliExitCode(result.exitCode);
+            return JSON.parse(result.stdout);
+        }
+    }))
+        return;
+    await execute(command, options);
+}
+/** A read failure is fallback evidence only here, before either task transport is invoked. */
+export function backendPreflightUnavailable(error) {
+    const value = recordValue(error);
+    return preflightUnavailable.has(nativeErrorCode(error)) && value?.dispatchState !== "unknown" && value?.dispatchState !== "accepted";
+}
+export async function dispatchRoutedConversationCli(command, original, ports) {
+    const target = routingTarget(command, original);
+    if (!target || !command)
+        return false;
+    const options = { ...original };
+    if (command === "send")
+        options.messageId ??= randomUUID();
+    const configuration = codexNativeRuntimeOptions(options);
+    const runtime = (cliDependencies().createCodexNativeRuntime ?? createCodexNativeRuntime)(configuration);
+    const identityOptions = {};
+    const input = command === "send" ? {
+        controllerSession: nonBlankString(options.openclawSession) ?? "agent:main:main",
+        messageId: String(options.messageId), requestText: String(options.message ?? options.request ?? ""), canonicalTarget: target
+    } : undefined;
+    const terminalRuntimeDir = cliEnv().AKK_RUNTIME_DIR ? path.resolve(expandHome(cliEnv().AKK_RUNTIME_DIR)) : path.join(path.dirname(defaultStoreDir()), "runtime-v2");
+    const locks = createFileLockCliAdapter({ now: cliNow, nowMs: cliNowMs, pid: cliPid, sleepSync: cliSleepSync });
+    try {
+        const result = await dispatchConversationRoute({ command, input,
+            store: input ? createConversationRuntimeRouteStore(configuration.storeDir, terminalRuntimeDir, locks, { now: cliNow }) : undefined,
+            select: async () => canonicalRouteSelection(await ((input ? selectLegacyConversationRoute({ input, nativeTasks: runtime.tasks,
+                expectedTerminalToken: nonBlankString(options.expectedTerminalToken), managedOnly: options.managedOnly === true,
+                terminalRuntimeDir }) : undefined)
+                ?? selectConversationRoute({ command, target, options, runtime, ports, identityOptions }))),
+            execute: async (choice) => {
+                const selectedOptions = conversationRoutedOptions(command, options, choice.route, choice.targetId);
+                const selectedCommand = routedCommand(command, options, choice.route);
+                if (choice.route === "terminal")
+                    await prepareTerminalFallback({ command: selectedCommand, target, choice, selectedOptions, options, ports, identityOptions });
+                return ports.execute(selectedCommand, selectedOptions);
+            }
+        });
+        writeCliStdout(JSON.stringify(result, null, 2) + "\n");
+        return true;
+    }
+    finally {
+        await runtime.close();
+    }
+}
+function canonicalRouteSelection(choice) {
+    return choice.route === "terminal" ? { ...choice, targetId: canonicalTerminalRouteId(choice.targetId) } : choice;
+}
+function routingTarget(command, original) {
+    const target = nonBlankString(original.conversation ?? original.conversationId ?? original.terminal ?? original.session);
+    if (!command || !target || !conversationCommandPolicy(command, original))
+        return undefined;
+    const native = isCodexNativeConversationId(target);
+    const terminal = native ? undefined : parseTerminalConversationId(target);
+    if (!native && terminal?.agent !== "codex")
+        return undefined;
+    // Diagnostic managed-only sends intentionally bypass physical inventory and routing.
+    if (terminal && original.managedOnly === true)
+        return undefined;
+    assertRoutedInput(command, original, native);
+    return target;
+}
+function assertRoutedInput(command, original, native) {
+    if (!native && command === "send")
+        terminalSubmissionPayload(String(original.message ?? original.request ?? ""));
+    if (["conversation", "conversationId", "terminal", "session"].filter(key => original[key] !== undefined).length !== 1) {
+        throw new Error("Conversation routing accepts exactly one conversation or terminal target");
+    }
+    if (command === "send" && (original.type ?? "task") !== "task")
+        throw new Error("ordinary send only accepts message type task");
+}
+async function prepareTerminalFallback(input) {
+    const { command, target, choice, selectedOptions, options, ports, identityOptions } = input;
+    const rows = await ports.terminals(options, canonicalTerminalRouteId(choice.targetId));
+    if (rows.length !== 1 || !terminalRouteIdsMatch(rows[0].id, choice.targetId) || isCodexNativeConversationId(target) && proveNativeTerminalRoute(target, rows[0], identityOptions).status !== "exact") {
+        throw new Error("The selected conversation no longer has its exact terminal fallback; no input was sent");
+    }
+    prepareConversationTerminalOptions(command, selectedOptions, rows[0]);
+}
+async function selectConversationRoute(input) {
+    const { target, options, runtime, ports, identityOptions } = input;
+    if (isCodexNativeConversationId(target))
+        return selectNativeConversationRoute(input);
+    const terminalId = canonicalTerminalRouteId(target);
+    const terminals = await ports.terminals(options, terminalId);
+    if (terminals.length !== 1 || !terminalRouteIdsMatch(terminals[0].id, target))
+        throw new Error("The exact selected terminal is unavailable");
+    const policy = conversationCommandPolicy(input.command, options);
+    if (!policy.backend)
+        return { route: "terminal", targetId: terminalId, reason: "backend_operation_unavailable" };
+    const discovery = await runtime.catalog.discover();
+    const unsafe = discovery.errors.find(error => !preflightUnavailable.has(error.error_code));
+    if (unsafe)
+        throw new Error(`Backend discovery failed verification: ${unsafe.error_code}; no terminal fallback was attempted`);
+    const rows = discovery.sessions.map(entry => ({ id: entry.nativeId, conversation_id: entry.nativeId,
+        native_thread_id: entry.threadId, source: "codex_cli", agent: "codex", connection_state: "loaded_backend_verified" }));
+    let match = associateConversationRoutes(terminals, rows, identityOptions).associations[0];
+    // All supported conversation operations share identity acquisition. The existing closed transaction
+    // may briefly inspect an idle CLI; a working/blocked terminal is never disturbed to learn its thread.
+    if (!match && rows.length && mayInspectMissingAlias(terminals[0])) {
+        match = await inspectMissingAlias(input, terminals[0], rows);
+    }
+    if (!match) {
+        if (policy.requireBackend)
+            throw new Error("The native interaction requires its exact backend identity; no terminal response was sent");
+        return { route: "terminal", targetId: terminalId, reason: rows.length ? "native_identity_unresolved" : "backend_unavailable" };
+    }
+    try {
+        const snapshot = await runtime.read(parseCodexNativeConversationId(match.nativeId));
+        if (snapshot.threadId !== match.threadId || snapshot.thread.id !== match.threadId)
+            throw new Error("Backend conversation identity mismatch");
+        if (snapshot.loaded)
+            return { route: "native", targetId: match.nativeId, reason: "exact_terminal_alias" };
+    }
+    catch (error) {
+        if (!backendPreflightUnavailable(error))
+            throw error;
+    }
+    if (policy.requireBackend)
+        throw new Error("The native interaction backend is unavailable; no terminal response was sent");
+    return { route: "terminal", targetId: terminalId, reason: "backend_unavailable" };
+}
+async function selectNativeConversationRoute(input) {
+    const { target, options, runtime, ports, identityOptions } = input;
+    const identity = parseCodexNativeConversationId(target);
+    const policy = conversationCommandPolicy(input.command, options);
+    if (policy.backend) {
+        try {
+            const snapshot = await runtime.read(identity);
+            if (snapshot.threadId !== identity.threadId || snapshot.thread.id !== identity.threadId)
+                throw new Error("Backend conversation identity mismatch");
+            if (snapshot.loaded)
+                return { route: "native", targetId: target, reason: "backend_available" };
+        }
+        catch (error) {
+            if (!backendPreflightUnavailable(error))
+                throw error;
+        }
+    }
+    if (policy.requireBackend)
+        throw new Error("The native interaction backend is unavailable; no terminal response was sent");
+    const proof = resolveNativeTerminalRoute(target, await ports.terminals(options), identityOptions);
+    if (proof.status !== "exact")
+        throw new Error(`${policy.backend ? "Backend unavailable" : "AKK has no equivalent backend operation"}; no unique verified terminal fallback: ${proof.reason}`);
+    return { route: "terminal", targetId: canonicalTerminalRouteId(proof.association.terminalId), reason: policy.backend ? "backend_unavailable" : "backend_operation_unavailable" };
+}
+function mayInspectMissingAlias(terminal) {
+    if (terminal.activity_state !== "idle" || recordValue(terminal.approval_state)?.blocked === true)
+        return false;
+    if (!nonBlankString(terminal.native_agent_codex_home ?? terminal.codex_home))
+        return false;
+    if (!isCodexPaginatedReadCandidate(terminal.agent_version) || nonBlankString(terminal.native_agent_session_id))
+        return false;
+    const observation = recordValue(terminal.native_agent_identity_observation);
+    return (observation?.status ?? terminal.native_identity_state) === "verified_absent";
+}
+async function inspectMissingAlias(input, before, rows) {
+    const prior = { ...before };
+    if (!terminalRouteIdsMatch(prior.id, input.target))
+        throw new Error("Native status inspection did not find the exact selected terminal; no task input was sent");
+    const terminalId = canonicalTerminalRouteId(input.target);
+    const action = recordValue(recordValue(before.available_actions)?.native_inspect);
+    const args = recordValue(action?.arguments);
+    if (action?.tool !== "agent_knock_knock_native_inspect" || !nonBlankString(args?.expected_binding_token))
+        return undefined;
+    const observation = await input.ports.execute("native-inspect", inspectionOptions(input.options, terminalId, String(args.expected_binding_token)));
+    const after = await input.ports.terminals(input.options, terminalId);
+    if (after.length !== 1)
+        throw new Error("Native status inspection lost its exact terminal; no task input was sent");
+    const inspected = withClosedStatusInspection(prior, after[0], observation);
+    const result = associateConversationRoutes([inspected], rows, input.identityOptions);
+    const ambiguous = result.unassociated.find(item => item.reason !== "matching_loaded_backend_not_found");
+    if (ambiguous)
+        throw new Error(`Native status inspection could not safely resolve its backend: ${ambiguous.reason}; no task input was sent`);
+    return result.associations[0];
+}
+function inspectionOptions(options, target, token) {
+    return { storeDir: options.storeDir, logDir: options.logDir, codexHome: options.codexHome,
+        terminal: target, inspection: "status", expectedBindingToken: token };
+}
+//# sourceMappingURL=conversation-routing-cli-adapter.js.map

package/dist/src/conversation-routing-cli-adapter.js.map

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

package/dist/src/conversation-routing-commands.d.ts

@@ -0,0 +1,11 @@
+type Options = Record<string, unknown>;
+/** Provider support, not a version allowlist. Bound Turn/Watch operations never change provider. */
+export declare function conversationCommandPolicy(command: string, options: Options): {
+    backend: boolean;
+    requireBackend: boolean;
+} | undefined;
+export declare function routedCommand(command: string, options: Options, route: "native" | "terminal"): string;
+/** Read/catalog authority may be refreshed. A displayed mutation offer must never be invented. */
+export declare function prepareConversationTerminalOptions(command: string, selected: Options, row: Options): void;
+export declare function conversationRoutedOptions(command: string, options: Options, route: "native" | "terminal", targetId: string): Options;
+export {};

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

@@ -0,0 +1,85 @@
+import { nonBlankString, recordValue } from "./value-guards.js";
+import { isCodexNativeConversationId } from "./codex-native-identity.js";
+const backendCommands = new Set(["send", "status", "watch-terminal", "native-status", "permission-options", "set-permissions"]);
+const terminalCommands = new Set(["model-options", "set-model", "cancel", "new-thread", "clear-thread", "resume-thread",
+    "list-resumable-threads", "threads", "identify-foreground", "repair-model-control", "reconcile-binding", "close"]);
+const interactionCommands = new Set(["approve", "respond-interaction"]);
+const nativeInteraction = /^codex-native-interaction:[0-9a-f]{64}$/u;
+const nativePermissionModes = { read_only: "read-only", ask_for_approval: "default", full_access: "full-access" };
+/** Provider support, not a version allowlist. Bound Turn/Watch operations never change provider. */
+export function conversationCommandPolicy(command, options) {
+    if (options.watch || options.turn || options.respond)
+        return undefined;
+    if (interactionCommands.has(command)) {
+        const backend = isCodexNativeConversationId(options.conversation ?? options.conversationId ?? options.terminal ?? options.session)
+            || nativeInteraction.test(String(options.interaction ?? "")) || String(options.interaction ?? "").startsWith("codex-native-interaction:");
+        return { backend, requireBackend: backend };
+    }
+    if (command === "native-inspect")
+        return {
+            backend: ["status", "permissions"].includes(String(options.action ?? options.inspection ?? "status")), requireBackend: false
+        };
+    if (command === "set-permissions" && options.mode === "approve_for_me")
+        return { backend: false, requireBackend: false };
+    if (backendCommands.has(command))
+        return { backend: true, requireBackend: options.routingRequireNative === true };
+    if (terminalCommands.has(command))
+        return { backend: false, requireBackend: false };
+    return undefined;
+}
+export function routedCommand(command, options, route) {
+    if (command === "native-status")
+        return "native-inspect";
+    if (route === "terminal" && command === "native-inspect" && (options.action ?? options.inspection) === "permissions")
+        return "permission-options";
+    return command;
+}
+/** Read/catalog authority may be refreshed. A displayed mutation offer must never be invented. */
+export function prepareConversationTerminalOptions(command, selected, row) {
+    const actions = recordValue(row.available_actions);
+    const action = command === "send" ? "send" : command === "native-inspect" ? "native_inspect" : command.replaceAll("-", "_");
+    const args = recordValue(recordValue(actions?.[action])?.arguments);
+    if (command === "send") {
+        if (!nonBlankString(selected.expectedTerminalToken) && !nonBlankString(args?.expected_terminal_token)) {
+            throw new Error("Exact terminal fallback cannot currently accept this task");
+        }
+        // Existing explicit Send authority is revalidated by the dispatch boundary, even when List
+        // cannot advertise a new offer. Never turn this routing preflight into a second UI veto.
+        selected.expectedTerminalToken ??= args?.expected_terminal_token;
+        selected.expectedManagedTerminalToken ??= args?.expected_managed_terminal_token;
+    }
+    else if (["native-inspect", "permission-options", "model-options", "new-thread", "clear-thread", "repair-model-control"].includes(command)) {
+        if (!nonBlankString(selected.expectedBindingToken)) {
+            const authority = command === "clear-thread" ? recordValue(recordValue(actions?.new_thread)?.arguments) : args;
+            if (!nonBlankString(authority?.expected_binding_token))
+                throw new Error(`Exact terminal fallback cannot currently perform ${command}; refresh AKK List`);
+            selected.expectedBindingToken = authority.expected_binding_token;
+        }
+    }
+    else if (["set-permissions", "set-model"].includes(command)) {
+        if (!nonBlankString(selected.expectedBindingToken) || !nonBlankString(selected.expectedCatalogFingerprint)) {
+            throw new Error(`Backend operation is unavailable; refresh ${command === "set-model" ? "model-options" : "permission-options"} before using its terminal fallback`);
+        }
+    }
+    if (command === "native-inspect")
+        selected.inspection ??= "status";
+}
+export function conversationRoutedOptions(command, options, route, targetId) {
+    const result = { ...options };
+    for (const key of ["conversation", "conversationId", "terminal", "session", "routingRequireNative"])
+        delete result[key];
+    result.conversation = targetId;
+    if (route === "native") {
+        for (const key of ["expectedTerminalToken", "expectedManagedTerminalToken", "expectedBindingToken", "expectedCatalogFingerprint"])
+            delete result[key];
+        result.openclawSession ??= "agent:main:main";
+        result.action ??= result.inspection;
+        if (command === "set-permissions" && Object.hasOwn(nativePermissionModes, String(result.mode))) {
+            result.mode = nativePermissionModes[String(result.mode)];
+        }
+    }
+    else
+        result.inspection ??= result.action;
+    return result;
+}
+//# sourceMappingURL=conversation-routing-commands.js.map

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

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