@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

package/dist/src/terminal-scoped-approval-authority.js

@@ -0,0 +1,281 @@
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { isExactNativeThreadId, managedSessionBindingToken, managedSessionRevision, unmanagedTerminalBindingToken } from "./managed-session.js";
+import { sessionIdForConversation, turnIdForConversation } from "./protocol.js";
+import { terminalActionFingerprint } from "./native-thread-resume-snapshot-policy.js";
+import { hasCanonicalTerminalEndpoint, sameTerminalControlIncarnation, terminalEndpointFromControlRef } from "./terminal-control-ref.js";
+import { isRecord, nonBlankString as nonEmptyString } from "./value-guards.js";
+export function terminalScopedCodexApprovalPromptSnapshot(approvalState) {
+    if (!isRecord(approvalState) || approvalState.approvable !== true)
+        return;
+    const fingerprint = nonEmptyString(approvalState.fingerprint);
+    const fallbackKey = nonEmptyString(approvalState.key);
+    const rawKeys = Array.isArray(approvalState.keys) ? approvalState.keys : fallbackKey ? [fallbackKey] : [];
+    const keys = rawKeys.filter((value) => typeof value === "string" && value.length > 0);
+    if (!fingerprint || !/^[0-9a-f]{64}$/u.test(fingerprint) ||
+        keys.length === 0 || keys.length !== rawKeys.length ||
+        nonEmptyString(approvalState.decision_mode) !== "keys")
+        return;
+    const requestId = nonEmptyString(approvalState.request_id) ?? null;
+    return {
+        fingerprint, keys, requestId,
+        digest: terminalActionFingerprint({
+            version: 1,
+            kind: "terminal_scoped_codex_approval_prompt",
+            fingerprint, keys,
+            request_id: requestId
+        })
+    };
+}
+/** One fresh decision; lazy checks retain fail-closed I/O/error precedence. */
+export function decideTerminalScopedCodexApprovalAuthority(request) {
+    const terminal = terminalSnapshot(request.terminal);
+    if (!isExactTerminalSnapshot(terminal) || !request.approval) {
+        throw new Error(request.kind === "current_dispatch_owner"
+            ? "terminal-scoped Codex approval requires an exact terminal and process incarnation"
+            : "terminal-scoped Codex approval requires an exact terminal, process, and prompt incarnation");
+    }
+    return request.kind === "current_dispatch_owner"
+        ? decideCurrentOwner(request, terminal, request.approval)
+        : decideNoOwner(request, terminal, request.approval);
+}
+function decideCurrentOwner(request, terminal, approval) {
+    const { session, owner, ledger, checks } = request;
+    const binding = exactSessionBinding(session, terminal);
+    if (!binding ||
+        sessionIdForConversation(owner) !== session.session_id ||
+        !["waiting_for_agent", "waiting_for_openclaw"].includes(owner.status)) {
+        throw new Error("terminal-scoped Codex approval has no single current managed owner");
+    }
+    assertSoleSession(checks.relatedBoundSessionIds(), session.session_id);
+    const blockingTurnIds = checks.blockingTurnIds();
+    if (blockingTurnIds.length !== 1 ||
+        blockingTurnIds[0] !== turnIdForConversation(owner)) {
+        throw new Error("terminal-scoped Codex approval has collateral unresolved Turn state");
+    }
+    assertNoRecovery(checks.hasNativeTransition() || checks.hasDeferredRecovery());
+    checks.assertDispatchOwner();
+    if (!checks.ledgerMatchesTerminal() ||
+        !["submitted", "agent_accepted"].includes(String(ledger.status))) {
+        throw new Error(`terminal-scoped Codex approval cannot use ${String(ledger.status)} dispatch ownership`);
+    }
+    assertNativeIdentity(terminal, binding);
+    const identity = terminal.nativeSessionId
+        ? {
+            sessionId: terminal.nativeSessionId, processUuid: terminal.processUuid,
+            processBirth: terminal.processBirth, rollout: terminal.rollout
+        }
+        : undefined;
+    if (checks.ownerMatchesNativeIdentity(identity)) {
+        throw new Error("the Codex managed identity is exact; use the managed Turn approval action");
+    }
+    return boundaryFor(request, terminal, approval);
+}
+function decideNoOwner(request, terminal, approval) {
+    const { session, ledger, checks } = request;
+    const binding = exactSessionBinding(session, terminal);
+    if (!binding || !isExactNativeThreadId(binding.native_thread_id)) {
+        throw new Error("terminal-scoped Codex approval has no single exact managed Session");
+    }
+    assertSoleSession(checks.relatedBoundSessionIds(), session.session_id);
+    if (!checks.dispatchOwnershipIsNone()) {
+        throw new Error("terminal-scoped Codex approval acquired a current or conflicted dispatch owner");
+    }
+    if (ledger &&
+        (ledger.status !== "resolved" || !checks.ledgerMatchesTerminal())) {
+        throw new Error(`terminal-scoped Codex approval cannot use ${String(ledger.status)} dispatch ownership`);
+    }
+    if (checks.blockingTurnIds().length > 0) {
+        throw new Error("terminal-scoped Codex approval has unresolved managed Turn state");
+    }
+    assertNoRecovery(checks.hasNativeTransition() ||
+        checks.hasOrphanedDispatch() ||
+        checks.hasDeferredRecovery());
+    assertNativeIdentity(terminal, binding);
+    return boundaryFor(request, terminal, approval);
+}
+function exactSessionBinding(session, terminal) {
+    const binding = session.binding;
+    return (session.status === "bound" &&
+        session.agent === "codex" &&
+        binding &&
+        binding.native_process.pid === terminal.pid &&
+        binding.native_process.process_uuid === terminal.processUuid &&
+        binding.native_process.process_birth === terminal.processBirth &&
+        terminalControlAliasMatches(binding.terminal_id, binding.terminal_control, terminal.rawId, terminal.terminalControl) &&
+        path.resolve(session.workspace) === path.resolve(terminal.workspace)) ? binding : undefined;
+}
+function assertSoleSession(sessionIds, expectedSessionId) {
+    if (sessionIds.length !== 1 || sessionIds[0] !== expectedSessionId) {
+        throw new Error("terminal-scoped Codex approval has ambiguous managed Session ownership");
+    }
+}
+function assertNoRecovery(blocked) {
+    if (blocked) {
+        throw new Error("terminal-scoped Codex approval is blocked by managed recovery state");
+    }
+}
+function assertNativeIdentity(terminal, binding) {
+    for (const knownSessionId of [
+        terminal.nativeSessionId,
+        terminal.statusCardSessionId
+    ]) {
+        if (knownSessionId &&
+            knownSessionId.toLowerCase() !==
+                String(binding.native_thread_id ?? "").toLowerCase()) {
+            throw new Error("terminal-scoped Codex approval observed a different native thread");
+        }
+    }
+    if (terminal.nativeSessionId &&
+        (terminal.processUuid !== binding.native_process.process_uuid ||
+            terminal.processBirth !== binding.native_process.process_birth ||
+            (binding.native_process.rollout &&
+                !exactNativeRolloutMatches(binding.native_process.rollout, terminal.rollout)))) {
+        throw new Error("terminal-scoped Codex approval observed a changed native rollout incarnation");
+    }
+}
+function boundaryFor(request, terminal, approval) {
+    return {
+        authority: { kind: request.kind },
+        approval,
+        token: approvalToken(request, terminal, approval)
+    };
+}
+function approvalToken(request, terminal, approval) {
+    const terminalToken = unmanagedTerminalBindingToken({
+        terminalId: terminal.id,
+        terminalControl: terminal.terminalControl,
+        agent: "codex",
+        pid: terminal.pid,
+        workspace: terminal.workspace,
+        processUuid: terminal.processUuid,
+        processBirth: terminal.processBirth
+    });
+    const owner = request.kind === "current_dispatch_owner"
+        ? request.owner
+        : undefined;
+    const takeover = owner && isRecord(owner.native_session_takeover)
+        ? owner.native_session_takeover
+        : undefined;
+    return createHash("sha256").update(JSON.stringify({
+        version: 2,
+        kind: "terminal_scoped_codex_manual_approval",
+        store_dir: path.resolve(request.storeDir),
+        terminal_token: terminalToken,
+        observation: terminalObservation(terminal),
+        authority: request.kind,
+        owner_session_id: request.session.session_id,
+        owner_session_revision: managedSessionRevision(request.session),
+        owner_binding_token: managedSessionBindingToken(request.session),
+        owner_turn_id: owner ? turnIdForConversation(owner) : null,
+        owner_turn_status: owner?.status ?? null,
+        owner_turn_updated_at: owner?.updated_at ?? null,
+        owner_message_id: nonEmptyString(takeover?.terminal_bridge_message_id) ?? null,
+        dispatch_snapshot: request.ledger
+            ? {
+                status: nonEmptyString(request.ledger.status),
+                fingerprint: terminalActionFingerprint(request.ledger)
+            }
+            : { status: "none", fingerprint: null },
+        approval_snapshot_digest: approval.digest,
+        approval_fingerprint: approval.fingerprint,
+        approval_keys: approval.keys,
+        approval_request_id: approval.requestId
+    })).digest("hex");
+}
+function terminalSnapshot(value) {
+    const terminal = isRecord(value) ? value : {};
+    const terminalControl = isRecord(terminal.terminal_control)
+        ? terminal.terminal_control
+        : undefined;
+    const observation = isRecord(terminal.native_agent_identity_observation)
+        ? terminal.native_agent_identity_observation
+        : undefined;
+    const observationValue = nonEmptyString(observation?.status);
+    const observationStatus = observationValue === "resolved" ||
+        observationValue === "verified_absent" ||
+        observationValue === "unavailable"
+        ? observationValue
+        : undefined;
+    return {
+        id: String(terminal.id),
+        rawId: terminal.id,
+        agent: nonEmptyString(terminal.agent),
+        pid: Number(terminal.pid),
+        workspace: nonEmptyString(terminal.workspace ?? terminal.cwd),
+        terminalControl,
+        nativeSessionId: nonEmptyString(terminal.native_agent_session_id),
+        statusCardSessionId: nonEmptyString(terminal.native_agent_status_card_session_id),
+        processUuid: nonEmptyString(terminal.native_agent_process_uuid),
+        processBirth: nonEmptyString(terminal.native_agent_process_birth),
+        rollout: nativeRollout(terminal.native_agent_rollout),
+        observationStatus
+    };
+}
+function isExactTerminalSnapshot(value) {
+    return value.agent === "codex" &&
+        Boolean(value.terminalControl) &&
+        hasCanonicalTerminalEndpoint(value.terminalControl) &&
+        Number.isSafeInteger(value.pid) && value.pid > 1 &&
+        Boolean(value.workspace) &&
+        Boolean(value.processUuid) &&
+        Boolean(value.processBirth) &&
+        Boolean(value.observationStatus);
+}
+function terminalObservation(terminal) {
+    if (terminal.observationStatus !== "resolved") {
+        return { status: terminal.observationStatus };
+    }
+    return {
+        status: terminal.observationStatus,
+        session_id: terminal.nativeSessionId ?? null,
+        process_uuid: terminal.processUuid ?? null,
+        process_birth: terminal.processBirth ?? null,
+        rollout: terminal.rollout
+            ? {
+                fd: terminal.rollout.fd,
+                device: terminal.rollout.device,
+                inode: terminal.rollout.inode,
+                path: terminal.rollout.path
+            }
+            : null
+    };
+}
+function terminalControlAliasMatches(storedTerminalId, storedControl, currentTerminalId, currentControl) {
+    if (!terminalControlsShareIncarnation(storedControl, currentControl)) {
+        return false;
+    }
+    return (hasCanonicalTerminalEndpoint(storedControl) &&
+        hasCanonicalTerminalEndpoint(currentControl)) || nonEmptyString(storedTerminalId) === nonEmptyString(currentTerminalId);
+}
+function terminalControlsShareIncarnation(left, right) {
+    try {
+        const leftPid = Number(terminalEndpointFromControlRef(left).processAnchorPid);
+        const rightPid = Number(terminalEndpointFromControlRef(right).processAnchorPid);
+        return Number.isSafeInteger(leftPid) && leftPid > 1 &&
+            Number.isSafeInteger(rightPid) && rightPid > 1 &&
+            sameTerminalControlIncarnation(left, right);
+    }
+    catch {
+        return false;
+    }
+}
+function exactNativeRolloutMatches(left, right) {
+    return Boolean(right &&
+        left.fd === right.fd &&
+        left.device === right.device &&
+        left.inode === right.inode &&
+        left.path === right.path);
+}
+function nativeRollout(value) {
+    if (!isRecord(value))
+        return;
+    const fd = nonEmptyString(value.fd);
+    const device = nonEmptyString(value.device);
+    const inode = nonEmptyString(value.inode);
+    const rolloutPath = nonEmptyString(value.path);
+    return fd && device && inode && rolloutPath
+        ? { fd, device, inode, path: rolloutPath }
+        : undefined;
+}
+//# sourceMappingURL=terminal-scoped-approval-authority.js.map

package/dist/src/terminal-scoped-approval-authority.js.map

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

package/dist/src/terminal-selector-projection-service.d.ts

@@ -0,0 +1,26 @@
+import type { SessionSelectorCandidate } from "./session-selector.js";
+export interface TerminalSelectorEntry {
+    agent?: string;
+    available_actions?: unknown;
+    command?: unknown;
+    created_at?: unknown;
+    cwd?: unknown;
+    elapsed?: unknown;
+    executor?: unknown;
+    id?: unknown;
+    managed?: unknown;
+    process_state?: unknown;
+    request?: unknown;
+    source?: unknown;
+    status?: unknown;
+    updated_at?: unknown;
+    workspace?: unknown;
+    [field: string]: unknown;
+}
+export interface TerminalSelectorProjectionPolicy {
+    isActiveStatus(status: string): boolean;
+}
+export declare function projectSessionSelectorCandidate(entry: TerminalSelectorEntry, commandName: string, observedAtMs: number, { defaultActionable, mutationsAllowed }: {
+    defaultActionable: boolean;
+    mutationsAllowed: boolean;
+}, policy: TerminalSelectorProjectionPolicy): SessionSelectorCandidate;

package/dist/src/terminal-selector-projection-service.js

@@ -0,0 +1,81 @@
+import { resolveExecutor } from "./protocol.js";
+import { parseProcessElapsedSeconds } from "./terminal-process-facts.js";
+import { isRecord, nonBlankString as stringValue } from "./value-guards.js";
+function managedTurnCanEnterApprovalPath(entry, policy) {
+    const executor = isRecord(entry.executor) ? entry.executor : undefined;
+    return (entry.source === "managed_turn" &&
+        executor?.transport === "tmux" &&
+        policy.isActiveStatus(String(entry.status)));
+}
+function actionForCommand(entry, commandName, policy) {
+    const actions = isRecord(entry.available_actions)
+        ? entry.available_actions
+        : {};
+    const actionName = commandName === "retry-callback"
+        ? "retry_callback"
+        : commandName;
+    if (isRecord(actions[actionName])) {
+        return actions[actionName];
+    }
+    if (commandName !== "approve") {
+        return undefined;
+    }
+    if (managedTurnCanEnterApprovalPath(entry, policy)) {
+        return {
+            tool: "agent_knock_knock_approve",
+            arguments: { conversation_id: String(entry.id) }
+        };
+    }
+    const managed = isRecord(entry.managed) ? entry.managed : undefined;
+    const currentTurn = isRecord(managed?.current_turn)
+        ? managed.current_turn
+        : undefined;
+    if (currentTurn &&
+        managedTurnCanEnterApprovalPath(currentTurn, policy)) {
+        return {
+            tool: "agent_knock_knock_approve",
+            arguments: {
+                conversation_id: String(currentTurn.conversation_id ?? currentTurn.id)
+            }
+        };
+    }
+    return undefined;
+}
+function actionTargetId(action) {
+    const actionArguments = isRecord(action?.arguments)
+        ? action.arguments
+        : undefined;
+    return stringValue(actionArguments?.session_id ??
+        actionArguments?.turn_id ??
+        actionArguments?.selector ??
+        actionArguments?.conversation_id);
+}
+function entryRecency(entry, observedAtMs) {
+    const timestamp = Date.parse(String(entry.updated_at ?? entry.created_at ?? ""));
+    if (Number.isFinite(timestamp)) {
+        return { updatedAtMs: timestamp };
+    }
+    const elapsedSeconds = parseProcessElapsedSeconds(entry.elapsed);
+    return elapsedSeconds === undefined
+        ? {}
+        : { updatedAtMs: observedAtMs - elapsedSeconds * 1000 };
+}
+export function projectSessionSelectorCandidate(entry, commandName, observedAtMs, { defaultActionable, mutationsAllowed }, policy) {
+    const action = mutationsAllowed || commandName === "status"
+        ? actionForCommand(entry, commandName, policy)
+        : undefined;
+    const targetId = actionTargetId(action);
+    return {
+        id: String(entry.id),
+        ...(targetId && targetId !== entry.id ? { targetId } : {}),
+        agent: resolveExecutor({ kind: entry.agent }).kind,
+        actionable: action !== undefined,
+        defaultActionable,
+        ...entryRecency(entry, observedAtMs),
+        source: stringValue(entry.source),
+        status: stringValue(entry.status ?? entry.process_state),
+        workspace: stringValue(entry.workspace ?? entry.cwd),
+        label: stringValue(entry.request ?? entry.command)
+    };
+}
+//# sourceMappingURL=terminal-selector-projection-service.js.map

package/dist/src/terminal-selector-projection-service.js.map

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

package/dist/src/terminal-status-cli-adapter.d.ts

@@ -0,0 +1,126 @@
+import type { CodingAgentSessionProvider } from "./agent-session-provider.js";
+import type { ActiveCodexProcess, ForkContextPackage } from "./codex-session-provider.js";
+import type { ExecutorKind } from "./executors.js";
+import { type Conversation } from "./protocol.js";
+import type { ResolvedTerminalConversation, TerminalBridgeStatus } from "./terminal-agent-bridge.js";
+import { type TerminalControlRef, type TerminalRuntimeIdentity } from "./terminal-agent-adapter.js";
+import { type TerminalStatusJsonObject, type TerminalStatusSummaryPorts } from "./terminal-status-facts.js";
+import type { TranscriptEvent } from "./transcript.js";
+export interface TerminalStatusCliOptions {
+    conversation?: unknown;
+    conversationId?: unknown;
+    idleTimeoutMinutes?: unknown;
+    logDir?: unknown;
+    maxCommands?: unknown;
+    maxMessages?: unknown;
+    maxTextLength?: unknown;
+    reconcile?: unknown;
+    scrollbackLines?: unknown;
+    state?: unknown;
+    storeDir?: unknown;
+    trace?: unknown;
+    turn?: unknown;
+    workspace?: unknown;
+    [option: string]: unknown;
+}
+interface StatusStoreSelection {
+    storeDir: string;
+    reconciliationConversationId?: string;
+}
+interface LoadedStatusConversation {
+    conversation: Conversation;
+    statePath: string;
+    logPath: string;
+}
+interface TerminalStatusMonitorItem {
+    status?: string;
+    [field: string]: unknown;
+}
+interface TerminalStatusMonitorReconciliation {
+    checked: number;
+    launched: number;
+    repaired: number;
+    collateral_stalls_checked: number;
+    collateral_stalls_skipped: number;
+    already_running: number;
+    skipped: number;
+    errors: number;
+    items: TerminalStatusMonitorItem[];
+}
+export interface TerminalStatusSelectionPorts {
+    statusStoreSelection(options: TerminalStatusCliOptions): StatusStoreSelection;
+    resolveTerminalConversation(options: TerminalStatusCliOptions): Promise<ResolvedTerminalConversation | undefined>;
+    assertExpectedTerminalSelector(request: {
+        options: TerminalStatusCliOptions;
+        terminal: ResolvedTerminalConversation;
+    }): void;
+    loadConversation(options: TerminalStatusCliOptions): LoadedStatusConversation;
+    terminalControlFromTakeover(value: unknown): TerminalControlRef | undefined;
+    terminalRuntimeIdentity(conversation: Conversation, terminalControl: TerminalControlRef): TerminalRuntimeIdentity;
+}
+export interface TerminalStatusObservationPorts {
+    readEvents(logPath: string): TranscriptEvent[];
+    createCodexProvider(options: TerminalStatusCliOptions): CodingAgentSessionProvider;
+    listActiveCodexSessions(options: TerminalStatusCliOptions, provider: CodingAgentSessionProvider): Promise<ActiveCodexProcess[]>;
+    createTerminalBridge(options: TerminalStatusCliOptions): TerminalStatusBridgePort;
+    terminalAdapter(options: TerminalStatusCliOptions, agent: ExecutorKind): {
+        readonly displayName: string;
+    };
+}
+export interface TerminalStatusBridgePort {
+    status(agent: ExecutorKind, terminalControl: TerminalControlRef, options?: {
+        scrollbackLines?: number;
+        runtime?: TerminalRuntimeIdentity;
+    }): Promise<TerminalBridgeStatus>;
+}
+export interface TerminalStatusReconciliationPorts {
+    reconcileMonitors(options: TerminalStatusCliOptions, request: {
+        includeCallbackRecovery: false;
+        reason: "status_reconciliation";
+        conversationId?: string;
+    }): Promise<TerminalStatusMonitorReconciliation>;
+    workspaceMatches(configured: unknown, observed: unknown): boolean;
+    acquireStateLock(statePath: string): () => void;
+    terminalBridgeEnabled(conversation: Conversation): boolean;
+}
+export interface TerminalStatusWatchHintAuthorityPorts {
+    terminalListObservation(options: TerminalStatusCliOptions, terminalId: string): Promise<TerminalStatusListObservation | undefined>;
+}
+export interface TerminalStatusListObservation {
+    activityState: TerminalBridgeStatus["activity_state"];
+    activityReason: string;
+    watchActionAvailable: boolean;
+    terminalStatus?: TerminalBridgeStatus;
+}
+export interface TerminalStatusCliDependencies {
+    selection: TerminalStatusSelectionPorts;
+    observation: TerminalStatusObservationPorts;
+    reconciliation: TerminalStatusReconciliationPorts;
+    watchAuthority: TerminalStatusWatchHintAuthorityPorts;
+    projection: TerminalStatusSummaryPorts;
+}
+export interface TerminalStatusIdleReconciliation {
+    checked: number;
+    closed: number;
+    skipped: number;
+    idle_timeout_minutes: number;
+}
+export interface TerminalStatusCliFacade {
+    runStatus(options: TerminalStatusCliOptions): Promise<void>;
+    reconcileIdleConversations(storeDir: string, options?: TerminalStatusCliOptions, now?: Date, conversationId?: string): TerminalStatusIdleReconciliation;
+    terminalStatusForControl(agent: ExecutorKind, terminalControl: TerminalControlRef, options: TerminalStatusCliOptions, runtime?: TerminalRuntimeIdentity): Promise<TerminalBridgeStatus>;
+    activeCodexProcessForPid(options: TerminalStatusCliOptions, pid: number | undefined): Promise<ActiveCodexProcess | undefined>;
+    loadCodexCompletionContexts(input: {
+        nativeTakeover?: Readonly<Record<string, unknown>>;
+        options: TerminalStatusCliOptions;
+    }): Promise<readonly CodexCompletionContextMatch[]>;
+    summarizeConversation(conversation: Conversation): TerminalStatusJsonObject;
+}
+export interface CodexCompletionContextMatch {
+    context: ForkContextPackage;
+    process: ActiveCodexProcess | undefined;
+    match: string;
+    confidence: "high" | "medium" | "low";
+}
+export declare function createTerminalStatusCliFacade(dependencies: TerminalStatusCliDependencies): TerminalStatusCliFacade;
+export {};