@scotthuang/agent-knock-knock 0.12.10 → 0.12.12

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

@@ -0,0 +1,102 @@
+import type { ManagedSessionState } from "./managed-session.js";
+import { type CanonicalMutationLockPorts, type CanonicalMutationResources, type CanonicalMutationScopes, type CanonicalStateMutationResources, type CanonicalStateMutationScopes } from "./mutation-transaction.js";
+import { type Conversation } from "./protocol.js";
+import { appendEvent } from "./store.js";
+import 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 TerminalDispatchLedgerDocument } from "./terminal-dispatch-ledger-codec.js";
+import type { createTerminalIdentityAuthorityCliAdapter } from "./terminal-identity-authority-cli-adapter.js";
+import type { createTerminalAcceptanceCliFacade } from "./terminal-acceptance-cli-adapter.js";
+import type { createTerminalHandoffCliFacade } from "./terminal-handoff-cli-adapter.js";
+import type { createTerminalListCliFacade } from "./terminal-list-cli-adapter.js";
+import type { TerminalDispatchRecoveryCliFacade } from "./terminal-dispatch-recovery-cli-adapter.js";
+import type { TerminalDispatchRepositoryCliAdapter, TerminalDispatchResolveRequest } from "./terminal-dispatch-repository-cli-adapter.js";
+import type { NativeThreadLifecycleCliFacade } from "./native-thread-lifecycle-cli-adapter.js";
+import type { NativeThreadTransitionApplication } from "./native-thread-transition-application.js";
+export type TerminalMaintenanceCliOptions = Readonly<Record<string, unknown>>;
+interface LoadedConversation {
+    conversation: Conversation;
+    statePath: string;
+    logPath: string;
+}
+type TerminalIdentityFacade = ReturnType<typeof createTerminalIdentityAuthorityCliAdapter>;
+type TerminalAcceptanceFacade = ReturnType<typeof createTerminalAcceptanceCliFacade>;
+type TerminalHandoffFacade = ReturnType<typeof createTerminalHandoffCliFacade>;
+type TerminalListFacade = ReturnType<typeof createTerminalListCliFacade>;
+export interface TerminalMaintenanceRuntimePorts {
+    readonly defaultAgentTimeoutMinutes: number;
+    readonly defaultAgentHardTimeoutMinutes: number;
+    readonly monitorLockVersion: number;
+    loadConversation(options: TerminalMaintenanceCliOptions): LoadedConversation;
+    storeDir(options: TerminalMaintenanceCliOptions): string;
+    createControlProvider(options: TerminalMaintenanceCliOptions): TerminalControlProvider;
+    createBridge(options: TerminalMaintenanceCliOptions): TerminalAgentBridge;
+    startMonitor(input: {
+        conversation: Conversation;
+        statePath: string;
+        logPath: string;
+        options: TerminalMaintenanceCliOptions;
+    }): {
+        pid?: number;
+    } | undefined;
+    positiveMinutes(value: unknown, optionName: string): number;
+    textSummary(value: unknown, maxLength?: number): unknown;
+}
+export type TerminalMaintenanceIdentityPorts = Pick<TerminalIdentityFacade, "resolveTerminalConversationFromOptions" | "migrateLegacyTerminalAgentIdentity" | "terminalRuntimeIdentityForConversation" | "codexAllowedCompanionSetForManagedSession" | "managedBindingConflictKindForResolvedTerminal" | "observeBoundTerminalAgentProcess"> & Pick<TerminalAcceptanceFacade, "resolveNativeIdentity" | "observeNativeIdentity">;
+export type TerminalMaintenanceAuthorityPorts = Pick<TerminalHandoffFacade, "assertConversationHasNoNonterminalDeferredForegroundTransfer" | "assertTerminalHasNoNonterminalDeferredForegroundTransfer" | "observedExternalHandoffIdentity" | "observedHandoffAuthorityToken" | "observedHandoffTargetResolution" | "activeTurnHandoffDecisionToken"> & {
+    hasUnresolvedNativeTransition: TerminalListFacade["managedSessionHasUnresolvedNativeTransition"];
+    assertExclusive: NativeThreadLifecycleCliFacade["assertExclusive"];
+    assertTurnBindingCurrent(conversation: Conversation, operation: string): void;
+    assertManagedTerminalDispatchOwner(input: {
+        storeDir: string;
+        conversation: Conversation;
+        terminalControl: TerminalControlRef;
+        action: "approve" | "cancel";
+    }): void;
+    loadTerminalDispatchLedgerOwner(ledger: TerminalDispatchLedgerDocument): Conversation | undefined;
+};
+type CanonicalStateMutationLockPorts = CanonicalMutationLockPorts & {
+    resources: CanonicalStateMutationResources;
+    acquireState: () => () => void;
+};
+export interface TerminalMaintenanceRepositoryPorts {
+    acquireFileLock(lockPath: string): () => void;
+    acquireTerminalLock: TerminalDispatchRepositoryCliAdapter["acquire"];
+    withStoreWriterLease<Result>(storeDir: string, operation: () => Promise<Result>): Promise<Result>;
+    resolveDispatch: TerminalDispatchRepositoryCliAdapter["resolve"];
+    conversationLoad(scopes: CanonicalStateMutationScopes, resources: CanonicalStateMutationResources): Conversation;
+    conversationSave(scopes: CanonicalStateMutationScopes, resources: CanonicalStateMutationResources, conversation: Conversation): void;
+    conversationAppendEvent(scopes: CanonicalStateMutationScopes, resources: CanonicalStateMutationResources, event: Parameters<typeof appendEvent>[1]): void;
+    sessionLoad(scopes: CanonicalStateMutationScopes, resources: CanonicalStateMutationResources, sessionId: string): ManagedSessionState;
+    ledgerLoad(scopes: CanonicalMutationScopes, resources: CanonicalMutationResources): TerminalDispatchLedgerDocument | undefined;
+    ledgerSave(scopes: CanonicalMutationScopes, resources: CanonicalMutationResources, ledger: TerminalDispatchLedgerDocument): void;
+    ledgerResolve(scopes: CanonicalMutationScopes, resources: CanonicalMutationResources, request: TerminalDispatchResolveRequest): boolean;
+    ledgerReconcileIncarnation(scopes: CanonicalMutationScopes, resources: CanonicalMutationResources): TerminalDispatchLedgerDocument | undefined;
+    ledgerReconcile: NativeThreadTransitionApplication["reconcileLedger"];
+    terminalWriterLocks(storeDir: string, terminalControl: TerminalControlRef): CanonicalMutationLockPorts;
+    terminalWriterStateLocks(storeDir: string, terminalControl: TerminalControlRef, statePath: string, logPath: string): CanonicalStateMutationLockPorts;
+    isVerifiedDead: TerminalDispatchRecoveryCliFacade["isVerifiedDead"];
+    exactVerifiedDeadAuthority: TerminalDispatchRecoveryCliFacade["exactVerifiedDeadAuthority"];
+    ensureVerifiedDeadEvent: TerminalDispatchRecoveryCliFacade["ensureVerifiedDeadEvent"];
+    ensureVerifiedDeadClosedEvent: TerminalDispatchRecoveryCliFacade["ensureVerifiedDeadClosedEvent"];
+    assertVerifiedDeadDispatch: TerminalDispatchRecoveryCliFacade["assertVerifiedDeadDispatch"];
+    resolveVerifiedDeadDispatch: TerminalDispatchRecoveryCliFacade["resolveVerifiedDeadDispatch"];
+}
+export interface TerminalMaintenanceCliDependencies {
+    runtime: TerminalMaintenanceRuntimePorts;
+    identity: TerminalMaintenanceIdentityPorts;
+    authority: TerminalMaintenanceAuthorityPorts;
+    repository: TerminalMaintenanceRepositoryPorts;
+}
+declare function runRenew(options: TerminalMaintenanceCliOptions): Promise<void>;
+declare function runCancel(options: TerminalMaintenanceCliOptions): Promise<void>;
+declare function runClose(options: TerminalMaintenanceCliOptions): Promise<void>;
+declare const terminalMaintenanceOperations: {
+    runRenew: typeof runRenew;
+    runCancel: typeof runCancel;
+    runClose: typeof runClose;
+};
+export type TerminalMaintenanceCliFacade = Readonly<typeof terminalMaintenanceOperations>;
+export declare function createTerminalMaintenanceCliFacade(dependencies: TerminalMaintenanceCliDependencies): TerminalMaintenanceCliFacade;
+export {};