@scotthuang/agent-knock-knock 0.12.18 → 0.12.19

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

@@ -1,9 +1,11 @@
 import { type CallbackRouteV1 } from "./callback-transport.js";
 import type { ClaudeAgentRow } from "./claude-terminal-agent-adapter.js";
+import type { ExecutorKind } from "./executors.js";
 import { type Conversation } from "./protocol.js";
 import { type TerminalDispatchOwnership } from "./terminal-action-projection.js";
-import type { TerminalControlRef } from "./terminal-control-ref.js";
+import type { TerminalControlEvidence, TerminalControlRef } from "./terminal-control-ref.js";
 import { type TerminalWatchCallbackCliAdapter } from "./terminal-watch-callback-cli-adapter.js";
+import { type TerminalWatchTerminalIdentity, type UserExplicitFallbackWatchAnchor } from "./terminal-watch-store.js";
 export interface TerminalWatchCliOptions {
     callbackRoute?: CallbackRouteV1;
     /** Private Host-adapter authority describing how a route template is bound. */
@@ -17,6 +19,32 @@ export interface TerminalWatchCliOptions {
     watch?: string;
     [option: string]: unknown;
 }
+export interface UserExplicitFallbackWatchTarget {
+    conversationId: string;
+    agent: ExecutorKind;
+    pid: number;
+    terminalControl: TerminalControlRef;
+}
+export interface PreparedUserExplicitFallbackWatch {
+    watchId: string;
+    terminalId: string;
+    agent: ExecutorKind;
+    pid: number;
+    terminalEndpoint: TerminalControlEvidence;
+    terminalIdentity: TerminalWatchTerminalIdentity;
+    physicalToken: string;
+    requestHash: string;
+    callbackRoute: CallbackRouteV1;
+    openclawSession: string;
+    openclawBin: string;
+    timeoutMs: number;
+    anchor: UserExplicitFallbackWatchAnchor;
+}
+export interface UserExplicitFallbackWatchReceipt {
+    callback_expected: true;
+    callback_mode: "terminal_watch";
+    watch_id: string;
+}
 type ExactTerminalWatchObservation = {
     state: "available";
     rawTerminal: Record<string, unknown>;
@@ -50,6 +78,21 @@ export interface TerminalWatchCliDependencies {
     callback?: TerminalWatchCallbackCliAdapter;
 }
 export interface TerminalWatchCliFacade {
+    prepareUserExplicitFallbackWatch(input: {
+        options: TerminalWatchCliOptions;
+        terminal: UserExplicitFallbackWatchTarget;
+        requestHash: string;
+        messageId: string;
+        physicalToken: string;
+    }): Promise<PreparedUserExplicitFallbackWatch | undefined>;
+    attachUserExplicitFallbackWatch(input: {
+        options: TerminalWatchCliOptions;
+        prepared: PreparedUserExplicitFallbackWatch;
+    }): Promise<UserExplicitFallbackWatchReceipt>;
+    userExplicitFallbackWatchReceipt(input: {
+        options: TerminalWatchCliOptions;
+        watchId: string;
+    }): UserExplicitFallbackWatchReceipt | undefined;
     runWatch(options: TerminalWatchCliOptions): Promise<void>;
     runUnwatch(options: TerminalWatchCliOptions): Promise<void>;
     runWatchStatus(options: TerminalWatchCliOptions): void;