@scotthuang/agent-knock-knock 0.13.3 → 0.13.4

package/dist/src/terminal-list-facts.js

@@ -0,0 +1,179 @@
+import { isExactNativeThreadId } from "./managed-session.js";
+import { terminalModelControlProfileFor } from "./terminal-model-control.js";
+/**
+ * Collect the immutable observation facts for one already-discovered terminal.
+ *
+ * This boundary does not create action authority, generate tokens, render
+ * public JSON, write Store state, or send terminal input. Each observation port
+ * is invoked at most once. The status result is the single source for screen,
+ * activity, approval, and interaction facts; later styled-Composer and native
+ * model-control observations remain explicitly separate fail-closed captures.
+ */
+export async function collectTerminalListTerminalFacts(input) {
+    const { session, terminalControl, terminalId, childPids, adapter, ports } = input;
+    const observedState = await ports.observeStatus();
+    const native = await ports.observeNativeIdentity(terminalId);
+    const effectiveState = ports.projectEffectiveState({
+        terminalState: observedState,
+        native
+    });
+    const rawSnapshot = effectiveState._terminal_status_snapshot;
+    const snapshot = rawSnapshot
+        ? ports.projectStatusSnapshot(rawSnapshot, effectiveState)
+        : undefined;
+    const statusCardNativeThreadId = observeStatusCardNativeThreadId(session, adapter, effectiveState);
+    const runtime = observeTerminalListRuntimeFacts(session, adapter, ports);
+    const latentClearResume = session.agent === "codex"
+        ? ports.observeLatentClearResume({
+            screen: effectiveState.screen_excerpt,
+            agentVersion: runtime.agentVersion
+        })
+        : undefined;
+    const terminalHasBlockingTurn = ports.observeTerminalHasBlockingTurn();
+    const composer = await ports.observeComposer(effectiveState);
+    const processIncarnation = ports.observePhysicalProcessIncarnation();
+    const zeroRolloutModelControlVerified = zeroRolloutModelControlFact({
+        session,
+        native,
+        processIncarnation
+    });
+    const terminalHasInteraction = snapshot?.interaction_state !== undefined;
+    const hasOrphanedDispatch = native.orphanedDispatch !== undefined;
+    const modelControlResidual = await ports.observeModelControlResidual({
+        agentVersion: runtime.agentVersion,
+        modelControlCapability: runtime.modelControlCapability,
+        modelControlProfile: runtime.modelControlProfile,
+        native,
+        zeroRolloutVerified: zeroRolloutModelControlVerified,
+        effectiveTerminalState: effectiveState,
+        terminalHasInteraction,
+        terminalHasBlockingTurn,
+        hasOrphanedDispatch
+    });
+    const modelControlSurfaceOpen = modelControlResidual?.state === "recoverable" &&
+        modelControlResidual.kind === "model_surface";
+    const projectedState = modelControlSurfaceOpen
+        ? terminalListStateWithOpenModelControlSurface(effectiveState)
+        : effectiveState;
+    return freezeTerminalListFacts({
+        terminalId,
+        childPids,
+        processIncarnation,
+        observedState,
+        effectiveState,
+        projectedState,
+        snapshot,
+        statusCardNativeThreadId,
+        terminalHasInteraction,
+        native,
+        runtime,
+        composer,
+        terminalHasBlockingTurn,
+        hasOrphanedDispatch,
+        latentClearResume,
+        zeroRolloutModelControlVerified,
+        modelControlResidual
+    });
+}
+function observeStatusCardNativeThreadId(session, adapter, state) {
+    const observation = session.agent === "codex" &&
+        typeof state.screen_excerpt === "string"
+        ? adapter.observeThreadLifecycle?.({
+            operation: { kind: "new_thread" },
+            phase: "before",
+            screen: state.screen_excerpt
+        })
+        : undefined;
+    return observation?.status === "observed" &&
+        state.activity_state === "idle" &&
+        state.approval_state.blocked !== true &&
+        isExactNativeThreadId(observation.nativeThreadId)
+        ? observation.nativeThreadId
+        : undefined;
+}
+function observeTerminalListRuntimeFacts(session, adapter, ports) {
+    const agentVersion = ports.observeAgentVersion();
+    const lifecycleCapability = adapter.probeThreadLifecycle?.(agentVersion) ?? {
+        status: "unsupported",
+        agentVersion,
+        newThread: false,
+        resumeExact: false,
+        reason: "native thread lifecycle is unavailable"
+    };
+    const nativeInspectionCapability = adapter.probeNativeInspection?.(agentVersion) ?? {
+        status: "unsupported",
+        agentVersion,
+        statusInspection: false,
+        reason: "native inspection is unavailable"
+    };
+    const modelControlCapability = adapter.probeModelControl?.(agentVersion) ?? {
+        status: "unsupported",
+        agentVersion,
+        modelSelection: false,
+        reasoningEffortSelection: false,
+        reason: "terminal model control is unavailable"
+    };
+    const compatibilityWarnings = Object.freeze([...new Set([
+            lifecycleCapability.compatibilityWarning,
+            nativeInspectionCapability.compatibilityWarning
+        ].filter((warning) => typeof warning === "string" && warning.trim().length > 0))]);
+    return Object.freeze({
+        agentVersion,
+        lifecycleCapability,
+        nativeInspectionCapability,
+        modelControlCapability,
+        modelControlProfile: terminalModelControlProfileFor(session.agent, agentVersion),
+        compatibilityWarnings
+    });
+}
+function zeroRolloutModelControlFact(input) {
+    const { session, native, processIncarnation } = input;
+    return session.agent === "codex" &&
+        native.nativeIdentityObservation.status === "verified_absent" &&
+        native.authorityNativeIdentityObservation.status === "verified_absent" &&
+        native.codexOpenRootRolloutInventory?.status === "verified_absent" &&
+        native.codexOpenRootRolloutInventory.pid === session.pid &&
+        native.codexOpenRootRolloutInventory.roots.length === 0 &&
+        native.codexOpenRootRolloutInventory.processBirth ===
+            processIncarnation?.processBirth;
+}
+function freezeTerminalListFacts(input) {
+    return Object.freeze({
+        physical: Object.freeze({
+            terminalId: input.terminalId,
+            childPids: Object.freeze([...input.childPids]),
+            processIncarnation: input.processIncarnation
+        }),
+        status: Object.freeze({
+            observed: input.observedState,
+            effective: input.effectiveState,
+            projected: input.projectedState,
+            snapshot: input.snapshot,
+            statusCardNativeThreadId: input.statusCardNativeThreadId,
+            hasInteraction: input.terminalHasInteraction
+        }),
+        native: Object.freeze({ ...input.native }),
+        runtime: input.runtime,
+        composer: Object.freeze({ ...input.composer }),
+        store: Object.freeze({
+            terminalHasBlockingTurn: input.terminalHasBlockingTurn,
+            hasOrphanedDispatch: input.hasOrphanedDispatch
+        }),
+        codex: Object.freeze({
+            latentClearResume: input.latentClearResume,
+            zeroRolloutModelControlVerified: input.zeroRolloutModelControlVerified
+        }),
+        modelControlResidual: input.modelControlResidual
+    });
+}
+function terminalListStateWithOpenModelControlSurface(state) {
+    const reason = "an exact native model-control surface is open";
+    return {
+        ...state,
+        activity_state: "unknown",
+        activity_reason: reason,
+        screen_state: "unknown",
+        screen_reason: reason
+    };
+}
+//# sourceMappingURL=terminal-list-facts.js.map

package/dist/src/terminal-list-facts.js.map

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

package/dist/src/terminal-list-inventory.d.ts

@@ -0,0 +1,59 @@
+import type { ExecutorKind } from "./executors.js";
+import { type ActiveTerminalProcess, type TerminalAgentAdapterRegistry, type TerminalControlRef } from "./terminal-agent-adapter.js";
+import type { TerminalAgentBridge } from "./terminal-agent-bridge.js";
+import type { TerminalControlProvider } from "./terminal-control-provider.js";
+import type { TerminalProcessSource } from "./terminal-process-source.js";
+export interface TerminalListInventoryEntry {
+    agent?: string;
+    activity_state?: string;
+    durable_activity_reason?: string;
+    durable_activity_state?: string;
+    cwd?: string;
+    id?: string;
+    native_identity_state?: string;
+    screen_reason?: string;
+    screen_state?: string;
+    short_ref?: string;
+    terminal_control?: TerminalControlRef | {
+        target?: string;
+        [field: string]: unknown;
+    };
+    workspace?: string;
+    [field: string]: unknown;
+}
+export interface TerminalListInventoryScan {
+    terminalControlled: TerminalListInventoryEntry[];
+    summary: {
+        error?: string;
+        [field: string]: unknown;
+    };
+}
+export interface TerminalListInventoryOptions {
+    managedOnly?: boolean;
+    noApprovalScan?: boolean;
+    terminalDebug?: boolean;
+}
+export interface TerminalListInventoryPorts<Options extends TerminalListInventoryOptions> {
+    createRegistry(options: Options): TerminalAgentAdapterRegistry;
+    createBridge(options: Options, provider: TerminalControlProvider, registry: TerminalAgentAdapterRegistry): TerminalAgentBridge;
+    createProvider(options: Options): TerminalControlProvider;
+    createProcessSource(options: Options): TerminalProcessSource;
+    projectTerminal(input: {
+        session: ActiveTerminalProcess;
+        activeSessions: ActiveTerminalProcess[];
+        options: Options;
+        bridge: TerminalAgentBridge;
+    }): Promise<TerminalListInventoryEntry>;
+    log(level: "info", event: string, fields: Record<string, unknown>): void;
+}
+/**
+ * Collect one physical process/terminal inventory without consulting Store
+ * ownership or public action policy. Every selected process is projected by
+ * exactly one caller-supplied per-terminal observation operation.
+ */
+export declare function collectTerminalListInventory<Options extends TerminalListInventoryOptions>(input: {
+    options: Options;
+    agentFilter?: ExecutorKind;
+    terminalId?: string;
+    ports: TerminalListInventoryPorts<Options>;
+}): Promise<TerminalListInventoryScan>;

package/dist/src/terminal-list-inventory.js

@@ -0,0 +1,194 @@
+import { parseTerminalConversationId } from "./terminal-agent-adapter.js";
+import { selectRootTerminalProcesses } from "./terminal-authority-policy.js";
+/**
+ * Collect one physical process/terminal inventory without consulting Store
+ * ownership or public action policy. Every selected process is projected by
+ * exactly one caller-supplied per-terminal observation operation.
+ */
+export async function collectTerminalListInventory(input) {
+    const { options, agentFilter, terminalId, ports } = input;
+    const empty = {
+        terminalControlled: [],
+        summary: {
+            enabled: false,
+            agents: [],
+            error: undefined
+        }
+    };
+    if (options.managedOnly)
+        return empty;
+    const registry = ports.createRegistry(options);
+    const adapters = agentFilter
+        ? [registry.get(agentFilter)].filter((adapter) => adapter !== undefined)
+        : registry.list();
+    if (agentFilter && adapters.length === 0) {
+        return {
+            ...empty,
+            summary: {
+                enabled: true,
+                agents: [],
+                skipped: `terminal agent adapter is not registered for ${agentFilter}`
+            }
+        };
+    }
+    const terminalProvider = ports.createProvider(options);
+    const bridge = ports.createBridge(options, terminalProvider, registry);
+    const terminalDiagnostics = options.terminalDebug
+        ? await terminalProvider.diagnostics()
+        : undefined;
+    const exactTarget = terminalId
+        ? exactTerminalTargetDiagnostic(terminalId)
+        : undefined;
+    if (terminalId) {
+        ports.log("info", "terminal_exact_scan", {
+            stage: "started",
+            terminal_id: terminalId,
+            target: exactTarget
+        });
+    }
+    const terminalControlled = [];
+    let activeCount = 0;
+    const errors = [];
+    try {
+        const processSource = ports.createProcessSource(options);
+        const snapshots = await processSource.listProcessSnapshots((snapshot) => adapters.some((adapter) => adapter.capabilities.processDiscovery &&
+            adapter.classifyProcess(snapshot) !== undefined), { includeAncestors: true });
+        logExactProcessInventory(ports, terminalId, exactTarget, snapshots);
+        const activeSessions = await bridge.listProcesses(snapshots, adapters.map((adapter) => adapter.agent));
+        const rootSessions = selectRootTerminalProcesses(activeSessions, snapshots);
+        const controlledSessions = rootSessions.filter((session) => session.terminalControl !== undefined);
+        logExactProcessAssociation({
+            ports,
+            terminalId,
+            exactTarget,
+            activeSessions,
+            rootSessions,
+            controlledSessions,
+            bridge
+        });
+        activeCount = controlledSessions.length;
+        const selectedSessions = terminalId
+            ? activeSessions.filter((session) => session.terminalControl !== undefined &&
+                bridge.terminalConversationId(session) === terminalId)
+            : controlledSessions;
+        for (const session of selectedSessions) {
+            try {
+                terminalControlled.push(await ports.projectTerminal({
+                    session,
+                    activeSessions,
+                    options,
+                    bridge
+                }));
+            }
+            catch (error) {
+                errors.push(`terminal process ${session.pid}: ` +
+                    (error instanceof Error ? error.message : String(error)));
+            }
+        }
+    }
+    catch (error) {
+        errors.push(error instanceof Error ? error.message : String(error));
+    }
+    if (terminalId) {
+        ports.log("info", "terminal_exact_scan", {
+            stage: "complete",
+            terminal_id: terminalId,
+            controlled_process_count: activeCount,
+            terminal_row_count: terminalControlled.length,
+            terminal_row_ids: terminalControlled.map((terminal) => terminal.id),
+            errors
+        });
+    }
+    return {
+        terminalControlled,
+        summary: {
+            enabled: true,
+            agents: adapters.map((adapter) => adapter.agent),
+            active_count: activeCount,
+            terminal_count: terminalControlled.length,
+            approval_scan: options.noApprovalScan ? "disabled" : "enabled",
+            diagnostics: terminalDiagnostics,
+            error: errors.length > 0 ? errors.join("; ") : undefined
+        }
+    };
+}
+function logExactProcessInventory(ports, terminalId, exactTarget, snapshots) {
+    if (!terminalId)
+        return;
+    const targetPid = exactTarget?.pid;
+    ports.log("info", "terminal_exact_scan", {
+        stage: "process_inventory",
+        terminal_id: terminalId,
+        target_pid: targetPid,
+        snapshot_count: snapshots.length,
+        target_process_found: targetPid === undefined
+            ? undefined
+            : snapshots.some((snapshot) => snapshot.pid === targetPid),
+        target_process_snapshots: targetPid === undefined
+            ? []
+            : snapshots
+                .filter((snapshot) => snapshot.pid === targetPid)
+                .map((snapshot) => ({ pid: snapshot.pid, ppid: snapshot.ppid }))
+    });
+}
+function logExactProcessAssociation(input) {
+    if (!input.terminalId)
+        return;
+    const targetPid = input.exactTarget?.pid;
+    const targetSessions = targetPid === undefined
+        ? []
+        : input.activeSessions.filter((session) => session.pid === targetPid);
+    input.ports.log("info", "terminal_exact_scan", {
+        stage: "process_classification_and_association",
+        terminal_id: input.terminalId,
+        target_pid: targetPid,
+        classified_process_count: input.activeSessions.length,
+        root_process_count: input.rootSessions.length,
+        controlled_process_count: input.controlledSessions.length,
+        target_classified_count: targetSessions.length,
+        target_controlled_count: targetSessions.filter((session) => session.terminalControl !== undefined).length,
+        target_sessions: targetSessions.map((session) => ({
+            agent: session.agent,
+            pid: session.pid,
+            ppid: session.ppid,
+            kind: session.kind,
+            confidence: session.confidence,
+            selected_as_root: input.rootSessions.includes(session),
+            terminal_conversation_id: session.terminalControl
+                ? input.bridge.terminalConversationId(session)
+                : undefined,
+            terminal_control: terminalControlScanDiagnostic(session.terminalControl)
+        }))
+    });
+}
+function exactTerminalTargetDiagnostic(terminalId) {
+    try {
+        const parsed = parseTerminalConversationId(terminalId);
+        return parsed ? {
+            provider: parsed.kind,
+            agent: parsed.agent,
+            route: parsed.target,
+            pid: parsed.pid
+        } : undefined;
+    }
+    catch (error) {
+        return {
+            parse_error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+function terminalControlScanDiagnostic(terminalControl) {
+    if (!terminalControl)
+        return undefined;
+    const control = terminalControl;
+    return {
+        kind: terminalControl.kind,
+        target: terminalControl.target,
+        pane_pid: control.panePid,
+        process_anchor_pid: control.processAnchorPid,
+        endpoint_key: control.endpointKey,
+        resource_key: control.resourceKey,
+        terminal_id: control.terminalId
+    };
+}
+//# sourceMappingURL=terminal-list-inventory.js.map

package/dist/src/terminal-list-inventory.js.map

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

package/dist/src/terminal-list-ownership-service.d.ts

@@ -0,0 +1,118 @@
+import type { CodexOpenRootRolloutInventory } from "./agent-session-provider.js";
+import { listDeferredForegroundTransfers, type DeferredForegroundTransferSourceRolloutAuthority, type DeferredForegroundTransferSourceTurnAuthority } from "./deferred-foreground-transfer.js";
+import type { ExecutorKind } from "./executors.js";
+import { type HumanObservedHandoffTargetSnapshot, type ManagedSessionState } from "./managed-session.js";
+import { type Conversation } from "./protocol.js";
+import { type CodexSendAuthorityContext, type DeferredCodexForegroundDispatchSnapshot } from "./terminal-authority-policy.js";
+import { type TerminalNativeIdentity } from "./terminal-binding-authority.js";
+import { terminalScopedCodexApprovalPromptSnapshot, type TerminalScopedCodexApprovalBoundary } from "./terminal-scoped-approval-authority.js";
+import { type TerminalDispatchLedgerDocument } from "./terminal-dispatch-ledger-codec.js";
+import { type TerminalControlRef } from "./terminal-control-ref.js";
+export interface DeferredCodexAuthorityObservation {
+    sourceRolloutAuthority: DeferredForegroundTransferSourceRolloutAuthority;
+    sourceTurnHistory?: DeferredForegroundTransferSourceTurnAuthority[];
+    dispatchSnapshot?: DeferredCodexForegroundDispatchSnapshot;
+    sourceAbandonmentFingerprint?: string;
+    exactSource: boolean;
+}
+export interface TerminalListOwnershipContext {
+    storeDir: string;
+    terminals: Record<string, any>[];
+    managedSessions: ManagedSessionState[];
+    allConversations: Conversation[];
+    displayedConversations: Conversation[];
+    mutationsAllowed: boolean;
+    nonterminalDeferredTransfers: ReturnType<typeof listDeferredForegroundTransfers>;
+    conversationHasNonterminalDeferredTransfer: (conversation: Conversation) => boolean;
+}
+export interface TerminalListOwnershipServicePorts {
+    activeTurnHandoffDecisionToken(request: {
+        handoffToken: string;
+        turn: Conversation;
+        ledger?: TerminalDispatchLedgerDocument;
+    }): string;
+    assertManagedTerminalDispatchOwner(request: {
+        storeDir: string;
+        conversation: Conversation;
+        terminalControl: TerminalControlRef;
+        action: "approve" | "cancel";
+    }): void;
+    codexLingeringBeforeIdentityMatchesSession(request: {
+        storeDir: string;
+        session: ManagedSessionState;
+        identity: TerminalNativeIdentity;
+    }): boolean;
+    codexProcessIncarnationForPid(pid: number): {
+        processUuid: string;
+        processBirth: string;
+    };
+    currentWorkingDirectory(): string;
+    isDiscoverableTmuxConversation(conversation: Conversation): boolean;
+    loadTerminalBridgeDispatchLedger(terminalControl: TerminalControlRef): TerminalDispatchLedgerDocument | undefined;
+    loadTerminalDispatchLedgerOwner(ledger: TerminalDispatchLedgerDocument): Conversation | undefined;
+    managedTurnsForSession(storeDir: string, sessionId: string): Conversation[];
+    matchesConfiguredWorkspace(configured: unknown, observed: unknown): boolean;
+    observeDeferredCodexAuthority(request: {
+        mode: "list";
+        storeDir: string;
+        context: CodexSendAuthorityContext;
+        sourceSession?: ManagedSessionState;
+        candidateInventory?: CodexOpenRootRolloutInventory;
+        abandonment: "never" | "missing_rollout";
+        requireUnclaimedCandidate: true;
+    }): DeferredCodexAuthorityObservation | undefined;
+    observedHandoffTargetResolution(request: {
+        storeDir: string;
+        agent: ExecutorKind;
+        workspace: string;
+        nativeThreadId: string;
+        sourceSessionId: string;
+    }): {
+        status: "eligible";
+        session?: ManagedSessionState;
+        snapshot: HumanObservedHandoffTargetSnapshot;
+    } | {
+        status: "blocked";
+        reason: string;
+    };
+    orphanedTerminalDispatchForRecovery(terminalControl: TerminalControlRef): TerminalDispatchLedgerDocument | undefined;
+    runtimeLog(level: "info" | "warn" | "error", event: string, details: Record<string, unknown>): void;
+    terminalControlFromTakeover(value: unknown): TerminalControlRef | undefined;
+    terminalDispatchRecordMatchesControl(ledger: TerminalDispatchLedgerDocument | undefined, terminalControl: TerminalControlRef, options?: {
+        requireProcessAnchor?: boolean;
+    }): boolean;
+}
+interface TerminalScopedBoundaryRequest {
+    storeDir: string;
+    terminal: unknown;
+    session: ManagedSessionState;
+    ledger?: TerminalDispatchLedgerDocument;
+    approval?: ReturnType<typeof terminalScopedCodexApprovalPromptSnapshot>;
+    owner?: Conversation;
+}
+type TerminalDispatchOwnershipResult = {
+    state: "none";
+} | {
+    state: "current";
+    conversation: Conversation;
+} | {
+    state: "conflict";
+    conflict: Record<string, any>;
+};
+export interface TerminalListOwnershipService {
+    assertTerminalIncarnationCanStartTurn(storeDir: string, terminalControl: TerminalControlRef): void;
+    managedSessionHasAnyNativeTransition(storeDir: string, session: ManagedSessionState): boolean;
+    managedSessionHasUnresolvedNativeTransition(storeDir: string, session: ManagedSessionState): boolean;
+    managedSessionMatchesLiveTerminalEntry(session: ManagedSessionState, terminal: Record<string, any>, storeDir: string): boolean;
+    managedTurnMatchesLiveTerminal(conversation: Conversation, terminal: Record<string, any>): boolean;
+    managedTurnNeedsAttention(conversation: Conversation): boolean;
+    observeActionAuthority(terminal: Record<string, any>, context: TerminalListOwnershipContext, binding: Record<string, any>): Record<string, any>;
+    observeBindingAuthority(terminal: Record<string, any>, context: TerminalListOwnershipContext): Record<string, any>;
+    provisionalManagedBindingTurnCount(storeDir: string, session: ManagedSessionState): number | undefined;
+    terminalControlForManagedConversation(conversation: Conversation): TerminalControlRef | undefined;
+    terminalDispatchOwnership(terminalControl: TerminalControlRef): TerminalDispatchOwnershipResult;
+    terminalIncarnationBlockingTurns(storeDir: string, terminalControl: TerminalControlRef, conversations?: Conversation[]): Conversation[];
+    terminalScopedCodexApprovalBoundary(request: TerminalScopedBoundaryRequest): TerminalScopedCodexApprovalBoundary;
+}
+export declare function createTerminalListOwnershipService(ports: TerminalListOwnershipServicePorts): TerminalListOwnershipService;
+export {};