@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

package/dist/src/terminal-action-projection.js

@@ -0,0 +1,376 @@
+import { managedSessionBindingToken } from "./managed-session.js";
+import { isSessionSendBlockingStatus, sessionIdForConversation } from "./protocol.js";
+/** Canonical send authority used by list projection and fresh mutation prep. */
+export function decideTerminalSendAuthority(facts) {
+    if (facts.ownership === "current")
+        return { mode: "current" };
+    const verifiedEmpty = facts.verifiedEmpty ??
+        facts.verifiedEmptyToken !== undefined;
+    const externalHandoff = facts.externalHandoff ??
+        facts.externalToken !== undefined;
+    const deferred = facts.deferred ?? facts.deferredToken !== undefined;
+    const conflictMode = verifiedEmpty
+        ? { mode: "verified_empty", token: facts.verifiedEmptyToken }
+        : externalHandoff
+            ? { mode: "external_handoff", token: facts.externalToken }
+            : deferred
+                ? { mode: "deferred", token: facts.deferredToken }
+                : undefined;
+    if (facts.ownership === "conflict") {
+        return conflictMode ?? { mode: "conflict" };
+    }
+    if (deferred)
+        return { mode: "deferred", token: facts.deferredToken };
+    return facts.managedSendSessionId
+        ? { mode: "managed", sessionId: facts.managedSendSessionId }
+        : { mode: "raw" };
+}
+export function decideTerminalSessionAuthorityConflict({ unresolvedSessionClaims, conflictingBoundSessionClaims, matchingSessions }) {
+    if (unresolvedSessionClaims.length > 0) {
+        return {
+            reason: "a first-class managed Session has an unresolved lifecycle binding on this terminal",
+            session_ids: unresolvedSessionClaims.map((session) => session.session_id),
+            binding_statuses: unresolvedSessionClaims.map((session) => session.status),
+            transition_ids: unresolvedSessionClaims.map((session) => session.last_transition_id ?? null),
+            recovery: "use only the lifecycle recovery action listed for this terminal"
+        };
+    }
+    if (conflictingBoundSessionClaims.length === 1) {
+        return singleBindingConflict(conflictingBoundSessionClaims[0]);
+    }
+    if (conflictingBoundSessionClaims.length > 1) {
+        return {
+            kind: "ambiguous_bound_claims",
+            reason: "multiple non-exact bound managed Sessions claim the same live terminal",
+            session_ids: conflictingBoundSessionClaims.map(({ session }) => session.session_id),
+            recovery: "inspect Session state; AKK will not reconcile ambiguous claims"
+        };
+    }
+    if (matchingSessions.length > 1) {
+        return {
+            reason: "multiple first-class managed Sessions claim the same live terminal binding",
+            session_ids: matchingSessions.map((session) => session.session_id),
+            recovery: "inspect Session state before performing a side effect"
+        };
+    }
+    return undefined;
+}
+function singleBindingConflict(claim) {
+    const { session, kind } = claim;
+    return {
+        kind,
+        reason: kind === "provisional_orphan"
+            ? "a failed raw attach left a bound Session without an authoritative native-thread identity"
+            : kind === "live_external_thread_change"
+                ? "the live coding-agent thread changed outside AKK while its previous Session binding remained bound"
+                : "the live terminal no longer matches a bound managed Session and the process relationship is unverifiable",
+        session_ids: [session.session_id],
+        binding_ids: [session.binding?.binding_id ?? null],
+        session_revisions: [session.revision ?? null],
+        recovery: kind === "unverifiable"
+            ? "inspect the terminal and Session identity; AKK cannot safely reconcile an unverifiable binding"
+            : "use only the exact reconcile_binding action listed for this terminal"
+    };
+}
+/**
+ * Terminal Watch is only for work started outside AKK. A durable blocking
+ * Turn wins even when its dispatch ledger is temporarily absent, while a
+ * current or conflicted dispatch owner must also fail closed.
+ */
+export function decideTerminalWatchExternalTaskAuthority({ blockingTurn, dispatchOwnership }) {
+    if (blockingTurn) {
+        return { state: "managed_turn", conversation: blockingTurn };
+    }
+    if (dispatchOwnership.state === "current") {
+        return {
+            state: "managed_turn",
+            conversation: dispatchOwnership.conversation
+        };
+    }
+    if (dispatchOwnership.state === "conflict") {
+        return {
+            state: "dispatch_conflict",
+            conflict: dispatchOwnership.conflict
+        };
+    }
+    return { state: "external_task" };
+}
+export function applySessionAuthorityToDispatch({ localOwnership, sessionAuthorityConflict, authoritativeSession, dispatchOwnerMismatch }) {
+    if (sessionAuthorityConflict) {
+        return { state: "conflict", conflict: sessionAuthorityConflict };
+    }
+    if (localOwnership.state === "current" && authoritativeSession &&
+        dispatchOwnerMismatch) {
+        return {
+            state: "conflict",
+            conflict: {
+                reason: "the current dispatch Turn and first-class Session binding disagree",
+                owner_session_id: dispatchOwnerMismatch.ownerSessionId,
+                bound_session_id: authoritativeSession.session_id,
+                recovery: "inspect Session and Turn state before performing a side effect"
+            }
+        };
+    }
+    return localOwnership;
+}
+export function compareManagedConversationRecency(left, right) {
+    const leftTime = Date.parse(String(left.updated_at ?? left.created_at ?? ""));
+    const rightTime = Date.parse(String(right.updated_at ?? right.created_at ?? ""));
+    if (Number.isFinite(leftTime) && Number.isFinite(rightTime) &&
+        leftTime !== rightTime)
+        return rightTime - leftTime;
+    if (Number.isFinite(leftTime) !== Number.isFinite(rightTime)) {
+        return Number.isFinite(leftTime) ? -1 : 1;
+    }
+    return left.conversation_id.localeCompare(right.conversation_id);
+}
+export function decideManagedTerminalAssociation({ allRelated, displayedRelated, authoritativeSession, sessionAuthorityRequired, currentOwner }) {
+    if (currentOwner && !allRelated.some((conversation) => conversation.conversation_id === currentOwner.conversation_id))
+        allRelated.push(currentOwner);
+    const sessionIds = new Set(allRelated.map((conversation) => sessionIdForConversation(conversation)));
+    const legacySessionId = [...displayedRelated]
+        .sort(compareManagedConversationRecency)
+        .map((conversation) => sessionIdForConversation(conversation))[0] ??
+        [...allRelated]
+            .sort(compareManagedConversationRecency)
+            .map((conversation) => sessionIdForConversation(conversation))[0];
+    const managedSessionId = authoritativeSession?.session_id ??
+        (!sessionAuthorityRequired
+            ? currentOwner
+                ? sessionIdForConversation(currentOwner)
+                : legacySessionId
+            : undefined);
+    const historySessionId = managedSessionId ?? legacySessionId;
+    return {
+        managedSessionId,
+        historySessionId,
+        sessionIds,
+        sessionAllRelated: historySessionId
+            ? allRelated.filter((conversation) => sessionIdForConversation(conversation) === historySessionId)
+            : [],
+        sessionDisplayedRelated: historySessionId
+            ? displayedRelated.filter((conversation) => sessionIdForConversation(conversation) === historySessionId)
+            : []
+    };
+}
+export function selectManagedTerminalHistory({ displayedRelated, currentConversationId, hasCurrentTurn, includeAll }) {
+    const sorted = [...displayedRelated]
+        .filter((conversation) => conversation.conversation_id !== currentConversationId)
+        .sort(compareManagedConversationRecency);
+    const recentConversation = hasCurrentTurn ? undefined : sorted[0];
+    return {
+        recentConversation,
+        historyConversations: includeAll
+            ? sorted.filter((conversation) => conversation.conversation_id !== recentConversation?.conversation_id)
+            : []
+    };
+}
+export function managedTurnNeedsAttention(facts) {
+    return isSessionSendBlockingStatus(facts.status) ||
+        ["pending", "failed"].includes(facts.callbackDeliveryStatus ?? "");
+}
+export function projectTerminalDispatchConflict(facts) {
+    return {
+        reason: facts.reason,
+        dispatch_status: facts.dispatchStatus,
+        owner_conversation_id: facts.ownerConversationId,
+        message_id: facts.messageId,
+        recovery: "inspect the shared terminal pane and explicitly resolve the current dispatch before performing a side effect"
+    };
+}
+export function decideLocalTerminalDispatchOwnership(facts) {
+    if (facts.localOwner) {
+        if (!facts.localOwnerMatchesLiveTerminal) {
+            return {
+                state: "conflict",
+                conflict: {
+                    reason: "the terminal dispatch owner no longer matches the live coding-agent process identity or workspace",
+                    owner_conversation_id: facts.ledgerOwnerId,
+                    recovery: "inspect the shared terminal pane and explicitly resolve the stale dispatch before performing a side effect"
+                }
+            };
+        }
+        return { state: "current", conversation: facts.localOwner };
+    }
+    return {
+        state: "conflict",
+        conflict: {
+            reason: "the terminal dispatch owner belongs to another AKK store or is not supported by this list view",
+            owner_conversation_id: facts.ledgerOwnerId,
+            recovery: "inspect the shared terminal pane and use the AKK store that owns the current dispatch"
+        }
+    };
+}
+export function selectTerminalAvailableActions({ ownership, currentActions, sessionAwareRawActions, nonOwnerRawActions, authoritativeSendAction, reconcileBindingAction, terminalScopedApprovalAction, isAction = (value) => Boolean(value) }) {
+    const base = ownership === "current"
+        ? currentActions
+        : ownership === "conflict"
+            ? {
+                ...safeConflictActions(sessionAwareRawActions, isAction),
+                ...(authoritativeSendAction ? { send: authoritativeSendAction } : {}),
+                ...(reconcileBindingAction
+                    ? { reconcile_binding: reconcileBindingAction }
+                    : {})
+            }
+            : {
+                ...nonOwnerRawActions,
+                ...(authoritativeSendAction ? { send: authoritativeSendAction } : {})
+            };
+    return terminalScopedApprovalAction
+        ? { ...base, approve: terminalScopedApprovalAction }
+        : base;
+}
+function safeConflictActions(actions, isAction) {
+    return {
+        ...(isAction(actions.status) ? { status: actions.status } : {}),
+        ...(isAction(actions.close) ? { close: actions.close } : {})
+    };
+}
+export function nonOwnerTerminalActions(actions, facts) {
+    if (!facts.hasAuthoritativeSession)
+        return actions;
+    const next = {};
+    for (const name of Object.keys(actions)) {
+        if (name !== "approve" &&
+            !(facts.rolloutBackedCodexSession && name === "send"))
+            next[name] = actions[name];
+    }
+    return next;
+}
+export function projectTerminalManagement({ managedSessionId, managedSessionShortRef, currentTurn, recentTurn, sessionAllRelatedCount, hiddenTurnCount, sessionCount, authoritativeSession, history }) {
+    return {
+        session_id: managedSessionId ?? null,
+        session_short_ref: managedSessionShortRef,
+        current_turn: currentTurn ?? null,
+        recent_turn: recentTurn ?? null,
+        turn_count: sessionAllRelatedCount,
+        hidden_turn_count: hiddenTurnCount,
+        session_count: sessionCount,
+        ...(authoritativeSession ? managedBindingProjection(authoritativeSession) : {}),
+        ...(history ? { history } : {})
+    };
+}
+function managedBindingProjection(session) {
+    return {
+        binding_status: session.status,
+        binding_id: session.binding?.binding_id ?? null,
+        binding_generation: session.binding?.generation ?? null,
+        native_thread_id: session.binding?.native_thread_id ?? null,
+        binding_token: managedSessionBindingToken(session)
+    };
+}
+export function authoritativeTerminalIdentity(session) {
+    const binding = session?.binding;
+    return binding?.native_thread_id && session
+        ? {
+            native_agent_session_id: binding.native_thread_id,
+            native_agent_process_uuid: binding.native_process.process_uuid,
+            native_agent_process_birth: binding.native_process.process_birth,
+            native_agent_rollout: binding.native_process.rollout,
+            native_agent_identity_evidence: binding.native_process.evidence,
+            lifecycle_binding_token: managedSessionBindingToken(session)
+        }
+        : {};
+}
+export function projectPublicManagementConflict({ conflict, verifiedEmptyToken, deferredToken, explicitlyAbandonedPredecessor }) {
+    if (!conflict)
+        return undefined;
+    if (verifiedEmptyToken) {
+        return {
+            ...conflict,
+            kind: "verified_empty_native_session",
+            reason: "the previously bound Codex rollout is conclusively closed while the same terminal process is at an exact empty prompt",
+            recovery: "use only the exact snapshot-bound send action listed for this terminal"
+        };
+    }
+    if (deferredToken && explicitlyAbandonedPredecessor) {
+        return {
+            ...conflict,
+            kind: "explicitly_abandoned_predecessor_adoptable",
+            reason: "the explicitly abandoned Codex predecessor rollout is no longer open and the current exact rollout inventory is unclaimed",
+            recovery: "use only the exact snapshot-bound follow-current send action listed for this terminal"
+        };
+    }
+    return conflict;
+}
+export function projectHandoffPresentation(facts) {
+    const external = facts.externalHandoffDetected
+        ? {
+            handoff_state: facts.externalHandoffAdoptable
+                ? "external_handoff_adoptable"
+                : "external_handoff_blocked",
+            ...(handoffBlockedReason(facts)
+                ? { handoff_blocked_reason: handoffBlockedReason(facts) }
+                : {})
+        }
+        : {};
+    return facts.verifiedEmptyToken
+        ? { ...external, handoff_state: "verified_empty_native_session_adoptable" }
+        : external;
+}
+function handoffBlockedReason(facts) {
+    if (facts.recoveryBlockingTurnCount > 0) {
+        return "the terminal has unresolved managed Turn state; use only a listed blocking_turns recovery action";
+    }
+    if (facts.hasHandoffDecision) {
+        return "the source Session has one active Turn; use only the snapshot-bound handoff_decision after explicit confirmation";
+    }
+    if (facts.sourceBlockingTurnCount > 0) {
+        return "the conflicting source Session has unresolved Turn state but no snapshot-bound handoff decision is currently safe; inspect the conflict and refresh";
+    }
+    return facts.automatedInputComposerReady
+        ? undefined
+        : "the current terminal composer is not an exact empty idle frame";
+}
+export function projectReconcileBindingAction(facts) {
+    return {
+        tool: "agent_knock_knock_reconcile_binding",
+        arguments: {
+            terminal_id: facts.terminalId,
+            conflicting_session_id: facts.conflictingSession.session_id,
+            expected_session_revision: facts.conflictingSessionRevision,
+            expected_binding_token: managedSessionBindingToken(facts.conflictingSession),
+            expected_terminal_token: facts.expectedTerminalToken
+        },
+        requires_user_intent: true
+    };
+}
+export function projectHandoffDecision(facts) {
+    return {
+        kind: "active_turn_requires_decision",
+        source_session_id: facts.sourceSessionId,
+        source_turn_id: facts.sourceTurnId,
+        live_native_thread_id: facts.liveNativeThreadId,
+        choices: {
+            take_over_current: {
+                action: {
+                    tool: "agent_knock_knock_close",
+                    arguments: {
+                        turn_id: facts.actionTurnId ?? facts.sourceTurnId,
+                        reason: "superseded_by_human_context_switch",
+                        expected_handoff_token: facts.handoffDecisionToken
+                    },
+                    requires_explicit_user_confirmation: true
+                },
+                after: "refresh list and use its follow-current send"
+            },
+            keep_source: {
+                effect: "no Store or terminal mutation",
+                after: "restore source native thread in the Codex/Claude TUI, then refresh list"
+            }
+        }
+    };
+}
+export function projectBlockingTurn(facts) {
+    return {
+        session_id: facts.sessionId,
+        turn_id: facts.turnId,
+        status: facts.status,
+        recovery_action: {
+            tool: "agent_knock_knock_close",
+            arguments: { turn_id: facts.recoveryTurnId ?? facts.turnId },
+            requires_explicit_user_confirmation: true
+        }
+    };
+}
+//# sourceMappingURL=terminal-action-projection.js.map

package/dist/src/terminal-action-projection.js.map

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

package/dist/src/terminal-agent-bridge.d.ts

@@ -376,6 +376,9 @@ export declare function isExactClaudeIdleComposer(screen: string): boolean;
  * name before the same exact-frame proof was reused by lifecycle handoff.
  */
 export declare function isExactClaudeNativeInspectionIdleComposer(screen: string): boolean;
+export declare function exactCodexReadyStyledComposerCapture(screen: string): {
+    digest: string;
+} | undefined;
 export declare function terminalApprovalFingerprint(agent: ExecutorKind, terminalControl: TerminalControlRef, inspection: TerminalScreenInspection, options?: {
     screen?: string;
     runtime?: TerminalRuntimeIdentity;

package/dist/src/terminal-agent-bridge.js

@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
 import { formatTerminalConversationId, parseTerminalConversationId, terminalControlCapabilitiesForAdapter } from "./terminal-agent-adapter.js";
 import { enrichActiveProcessesWithTerminalControl, TerminalControlInputNotSentError } from "./terminal-control-provider.js";
 import { hasCanonicalTerminalEndpoint, sameTerminalControlIncarnation, terminalEndpointFromControlRef, terminalEndpointIdentityKey } from "./terminal-control-ref.js";
-// Verified Codex profiles through 0.147.0 keep Enter in paste/newline mode for
+// Verified Codex profiles through 0.148.0 keep Enter in paste/newline mode for
 // 120ms after burst input. Cross that boundary rather than landing on it, and
 // also require observable composer stability instead of treating this delay
 // alone as acceptance.
@@ -26,6 +26,10 @@ const CODEX_NATIVE_STATUS_POPUP_BY_PROFILE = {
     "codex-tui-0.147.0": [
         "  /status      show current session configuration and token usage",
         "  /statusline  configure which items appear in the status line"
+    ],
+    "codex-tui-0.148.0": [
+        "  /status      show current session configuration and token usage",
+        "  /statusline  configure which items appear in the status line"
     ]
 };
 // Codex's verified `/status` profiles are exercised against its canonical
@@ -36,7 +40,8 @@ const CODEX_NATIVE_STATUS_POPUP_BY_PROFILE = {
 const CODEX_NATIVE_STATUS_MIN_VIEWPORT_BY_PROFILE = {
     "codex-tui-0.146.0": 80,
     "codex-tui-0.146.1": 80,
-    "codex-tui-0.147.0": 80
+    "codex-tui-0.147.0": 80,
+    "codex-tui-0.148.0": 80
 };
 const CLAUDE_NATIVE_STATUS_POPUP_BY_PROFILE = {
     "claude-code-2.1.218-native-status": [
@@ -50,8 +55,28 @@ const CLAUDE_NATIVE_STATUS_POPUP_BY_PROFILE = {
         "/statusline Set up Claude Code's status line UI",
         "/ide Manage IDE integrations and show status",
         "/usage Show session cost, plan usage, and activity stats"
+    ],
+    "claude-code-2.1.237-native-status": [
+        "/status Show Claude Code status including version, model, account, API connectivity, and tool statuses",
+        "/statusline Set up Claude Code's status line UI",
+        "/ide Manage IDE integrations and show status",
+        "/usage Show session cost, plan usage, and activity stats"
     ]
 };
+const CLAUDE_NATIVE_STATUS_SETTLE_BY_PROFILE = {
+    "claude-code-2.1.218-native-status": {
+        minimumStableMs: 80,
+        maximumSettleMs: 2_000
+    },
+    "claude-code-2.1.226-native-status": {
+        minimumStableMs: 80,
+        maximumSettleMs: 5_000
+    },
+    "claude-code-2.1.237-native-status": {
+        minimumStableMs: 80,
+        maximumSettleMs: 5_000
+    }
+};
 const CODEX_LARGE_PASTE_CHAR_THRESHOLD = 1_000;
 /** A terminal send failed at a boundary that proves input never started. */
 export class TerminalInputNotStartedError extends Error {
@@ -1471,11 +1496,7 @@ function assertClosedStatusInspectionPlan(adapter, terminalControl, plan) {
         CLAUDE_NATIVE_STATUS_POPUP_BY_PROFILE[plan.behaviorProfile] !== undefined;
     const expectedSettle = codexProfile
         ? { minimumStableMs: CODEX_PASTE_ENTER_SETTLE_MS, maximumSettleMs: 2_000 }
-        : plan.behaviorProfile === "claude-code-2.1.218-native-status"
-            ? { minimumStableMs: 80, maximumSettleMs: 2_000 }
-            : plan.behaviorProfile === "claude-code-2.1.226-native-status"
-                ? { minimumStableMs: 80, maximumSettleMs: 5_000 }
-                : undefined;
+        : CLAUDE_NATIVE_STATUS_SETTLE_BY_PROFILE[plan.behaviorProfile];
     const exactPresentation = codexProfile
         ? plan.expectedResult.presentation === "inline" &&
             plan.expectedResult.dismissal === undefined &&
@@ -1697,7 +1718,7 @@ function bareDigestFromNativeInspectionScreenFingerprint(fingerprint) {
 function stripTerminalEscapeSequences(value) {
     return value.replace(/\x1B(?:\[[0-?]*[ -/]*[@-~]|\][^\x07]*(?:\x07|\x1B\\))/gu, "");
 }
-function exactCodexReadyStyledComposerCapture(screen) {
+export function exactCodexReadyStyledComposerCapture(screen) {
     const lines = screen.replace(/\r\n?/gu, "\n").split("\n");
     while (lines.length > 0 &&
         stripTerminalEscapeSequences(lines.at(-1) ?? "").trim().length === 0) {