@scotthuang/agent-knock-knock 0.13.18 → 0.14.0

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

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

@@ -0,0 +1,26 @@
+type Row = Record<string, unknown>;
+export type ConversationRoutingHome = {
+    status: "verified";
+    codexHome: string;
+    evidence: "open_arg0_lock";
+} | {
+    status: "unavailable" | "ambiguous";
+    reason: string;
+};
+export interface ConversationRoutingHomePorts {
+    processBirth(pid: number): string;
+    openFiles(pid: number): {
+        status: number | null;
+        stdout: string;
+        error?: unknown;
+    };
+}
+/** Codex retains a .lock descriptor in its CODEX_HOME/tmp/arg0 entry for its lifetime.
+ * Inspect names and inode identity only;
+ * never read its environment, log contents, credentials, or chat history.
+ * Official implementation: codex-rs/arg0/src/lib.rs, prepare_path_entry_for_codex_aliases.
+ */
+export declare function readConversationRoutingHome(terminal: Row, ports?: Partial<ConversationRoutingHomePorts>): ConversationRoutingHome;
+/** Attach private physical evidence to a raw terminal row; scan configuration is not proof. */
+export declare function withConversationRoutingHome(terminal: Row, ports?: Partial<ConversationRoutingHomePorts>): Row;
+export {};

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

@@ -0,0 +1,105 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { resolveOptionalExecutable } from "./cli-command-runtime.js";
+import { codexProcessBirthForLifecycle } from "./codex-process-incarnation.js";
+import { parseLsofOpenFiles } from "./codex-open-rollout-inventory.js";
+const unavailable = (reason) => ({ status: "unavailable", reason });
+/** Codex retains a .lock descriptor in its CODEX_HOME/tmp/arg0 entry for its lifetime.
+ * Inspect names and inode identity only;
+ * never read its environment, log contents, credentials, or chat history.
+ * Official implementation: codex-rs/arg0/src/lib.rs, prepare_path_entry_for_codex_aliases.
+ */
+export function readConversationRoutingHome(terminal, ports = {}) {
+    const pid = terminal.pid, expectedBirth = terminal.native_agent_process_birth;
+    if (terminal.agent !== "codex" || terminal.process_state !== "active" || !Number.isSafeInteger(pid) || Number(pid) < 2 ||
+        typeof expectedBirth !== "string" || !expectedBirth.trim())
+        return unavailable("physical_process_incarnation_missing");
+    const birth = ports.processBirth ?? codexProcessBirthForLifecycle;
+    try {
+        if (birth(Number(pid)) !== expectedBirth)
+            return unavailable("physical_process_incarnation_changed");
+        const files = (ports.openFiles ?? processOpenFiles)(Number(pid));
+        if (files.status !== 0 || files.error)
+            return unavailable("process_open_files_unavailable");
+        const result = homeFromOpenFiles(Number(pid), files.stdout);
+        if (birth(Number(pid)) !== expectedBirth)
+            return unavailable("physical_process_incarnation_changed");
+        return result;
+    }
+    catch {
+        return unavailable("process_home_observation_failed");
+    }
+}
+/** Attach private physical evidence to a raw terminal row; scan configuration is not proof. */
+export function withConversationRoutingHome(terminal, ports = {}) {
+    if (terminal.agent !== "codex")
+        return terminal;
+    const observation = readConversationRoutingHome(terminal, ports);
+    return { ...terminal, native_agent_codex_home: observation.status === "verified" ? observation.codexHome : undefined,
+        native_agent_codex_home_observation: observation };
+}
+function processOpenFiles(pid) {
+    const result = spawnSync(resolveOptionalExecutable("lsof"), ["-a", "-p", String(pid), "-FnfDit"], {
+        encoding: "utf8", timeout: 5000, maxBuffer: 2 * 1024 * 1024
+    });
+    return { status: result.status, stdout: String(result.stdout ?? ""), error: result.error };
+}
+function homeFromOpenFiles(pid, output) {
+    const processes = output.split(/\r?\n/u).filter(line => line.startsWith("p"));
+    if (processes.length !== 1 || processes[0] !== `p${pid}`)
+        return unavailable("process_open_files_identity_mismatch");
+    const candidates = parseLsofOpenFiles(output).filter(file => file.path && arg0Home(file.path.replace(/ \(deleted\)$/u, "")));
+    if (!candidates.length)
+        return unavailable("codex_home_descriptor_missing");
+    if (candidates.length > 128)
+        return unavailable("codex_home_descriptor_limit");
+    const homes = [];
+    for (const file of candidates) {
+        const home = verifiedDescriptorHome(file);
+        if (!home)
+            return unavailable("codex_home_descriptor_unverifiable");
+        homes.push(home);
+    }
+    const unique = [...new Set(homes)];
+    return unique.length === 1 ? { status: "verified", codexHome: unique[0], evidence: "open_arg0_lock" }
+        : { status: "ambiguous", reason: "multiple_codex_home_descriptors" };
+}
+function arg0Home(filename) {
+    if (!path.isAbsolute(filename) || path.basename(filename) !== ".lock")
+        return undefined;
+    const entry = path.dirname(filename), arg0 = path.dirname(entry), temporary = path.dirname(arg0);
+    return /^codex-arg0[^/]+$/u.test(path.basename(entry)) && path.basename(arg0) === "arg0" && path.basename(temporary) === "tmp"
+        ? path.dirname(temporary) : undefined;
+}
+function verifiedDescriptorHome(file) {
+    if (file.type !== "REG" || !/^\d+$/u.test(file.fd ?? "") || !file.path || !file.device || !file.inode)
+        return undefined;
+    const device = integer(file.device), inode = integer(file.inode);
+    if (device === undefined || inode === undefined)
+        return undefined;
+    try {
+        const stat = fs.lstatSync(file.path, { bigint: true });
+        if (!stat.isFile() || stat.isSymbolicLink() || stat.dev !== device || stat.ino !== inode)
+            return undefined;
+        const real = fs.realpathSync(file.path), home = arg0Home(real);
+        if (!home || fs.realpathSync(file.path) !== real)
+            return undefined;
+        const confirmed = fs.statSync(real, { bigint: true });
+        return confirmed.dev === device && confirmed.ino === inode ? home : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function integer(value) {
+    if (!/^(?:[0-9]+|0x[0-9a-f]+)$/iu.test(value))
+        return undefined;
+    try {
+        return BigInt(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=conversation-routing-home.js.map

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

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

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

@@ -0,0 +1,40 @@
+type Row = Record<string, unknown>;
+export interface ConversationRoutingIdentityOptions {
+    /** @deprecated A configured scan home is not physical process evidence and is ignored. */
+    defaultCodexHome?: string;
+}
+export interface ConversationRouteAssociation {
+    terminalId: string;
+    nativeId: string;
+    threadId: string;
+    codexHome: string;
+    evidence: "resolved_native_identity" | "visible_status_card" | "closed_status_inspection";
+}
+type RejectedProof = {
+    status: "unavailable" | "conflict" | "ambiguous";
+    reason: string;
+};
+export type ConversationRouteProof = {
+    status: "exact";
+    association: ConversationRouteAssociation;
+} | RejectedProof;
+/** Legacy terminal IDs name the same exact provider, agent, endpoint and process. */
+export declare function canonicalTerminalRouteId(value: string): string;
+export declare function terminalRouteIdsMatch(left: unknown, right: string): boolean;
+/** Link only fresh physical identity evidence. A same-cwd or resume command match never participates. */
+export declare function associateConversationRoutes(terminals: readonly Row[], nativeRows: readonly Row[], options?: ConversationRoutingIdentityOptions): {
+    associations: ConversationRouteAssociation[];
+    unassociated: {
+        terminalId: string;
+        reason: string;
+    }[];
+};
+/** 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 declare function proveNativeTerminalRoute(nativeId: string, terminal: Row, options?: ConversationRoutingIdentityOptions): ConversationRouteProof;
+/** Multiple exact aliases are useful for List but cannot select a fallback terminal implicitly. */
+export declare function resolveNativeTerminalRoute(nativeId: string, terminals: readonly Row[], options?: ConversationRoutingIdentityOptions): ConversationRouteProof;
+/** The closed inspection transaction is internal evidence, never a user-supplied routing hint. */
+export declare function withClosedStatusInspection(before: Row, after: Row, observation: Row): Row;
+export {};