@scotthuang/agent-knock-knock 0.14.16 → 0.15.0

package/dist/src/claude-native-public-projection.d.ts

@@ -1,6 +1,21 @@
 import { type ClaudeNativeCatalogEntry } from "./claude-native-identity.js";
 import type { ClaudeNativeSnapshot, ClaudeNativePublicProgress } from "./claude-native-observation.js";
 import type { ClaudeNativeTaskRecord } from "./claude-native-state-store.js";
+/** Consume the verified terminal's current offers; adapter support alone is not input authority. */
+export declare function claudeNativeControlCapabilities(actions?: Record<string, unknown>, terminal?: Record<string, unknown>): {
+    interaction_respond: boolean;
+    approve: boolean;
+    model_options: boolean;
+    set_model: boolean;
+    permission_options: boolean;
+    set_permissions: boolean;
+    cancel: boolean;
+    new_thread: boolean;
+    clear_thread: boolean;
+    resume_thread: boolean;
+    list_resumable_threads: boolean;
+    native_inspect: boolean;
+};
 /** The no-snapshot form is List-safe: no transcript read or progress/answer body. */
 export declare function claudeNativeSessionProjection(entry: ClaudeNativeCatalogEntry, snapshot?: ClaudeNativeSnapshot): {
     waiting_for: string | null;
@@ -27,21 +42,22 @@ export declare function claudeNativeSessionProjection(entry: ClaudeNativeCatalog
     activity_state: "idle" | "unknown" | "waiting" | "working";
     observed_at: string;
     capabilities: {
-        interaction_notify: false;
-        interaction_respond: false;
-        approve: false;
-        model_options: false;
-        set_model: false;
-        permission_options: false;
-        set_permissions: false;
-        cancel: false;
-        new_thread: false;
-        clear_thread: false;
-        resume_thread: false;
-        list_resumable_threads: false;
+        interaction_respond: boolean;
+        approve: boolean;
+        model_options: boolean;
+        set_model: boolean;
+        permission_options: boolean;
+        set_permissions: boolean;
+        cancel: boolean;
+        new_thread: boolean;
+        clear_thread: boolean;
+        resume_thread: boolean;
+        list_resumable_threads: boolean;
         status: boolean;
         send: boolean;
         watch: boolean;
+        interaction_notify: boolean;
+        native_inspect: boolean;
     };
     available_actions: {
         status: {
@@ -50,6 +66,13 @@ export declare function claudeNativeSessionProjection(entry: ClaudeNativeCatalog
                 conversation_id: string;
             };
         };
+        native_inspect: {
+            tool: string;
+            input: {
+                conversation_id: string;
+                inspection: string;
+            };
+        };
         send?: {
             tool: string;
             input: {
@@ -137,18 +160,18 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
     callback_configured: boolean;
     callback_expected: boolean;
     capabilities: {
-        interaction_notify: false;
-        interaction_respond: false;
-        approve: false;
-        model_options: false;
-        set_model: false;
-        permission_options: false;
-        set_permissions: false;
-        cancel: false;
-        new_thread: false;
-        clear_thread: false;
-        resume_thread: false;
-        list_resumable_threads: false;
+        interaction_respond: boolean;
+        approve: boolean;
+        model_options: boolean;
+        set_model: boolean;
+        permission_options: boolean;
+        set_permissions: boolean;
+        cancel: boolean;
+        new_thread: boolean;
+        clear_thread: boolean;
+        resume_thread: boolean;
+        list_resumable_threads: boolean;
+        native_inspect: boolean;
         status: boolean;
         close: boolean;
         unwatch: boolean;
@@ -156,6 +179,7 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
         recover: boolean;
         retry_callback: boolean;
         callback: boolean;
+        interaction_notify: boolean;
     };
     available_actions: {
         recover?: {
@@ -200,6 +224,8 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
     delivered?: undefined;
     send_state?: undefined;
     delivery_receipt?: undefined;
+    sender_permission_class?: undefined;
+    sender_permission_class_source?: undefined;
     agent_acceptance?: undefined;
     send_error?: undefined;
     resend_allowed?: undefined;
@@ -269,18 +295,18 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
     callback_configured: boolean;
     callback_expected: boolean;
     capabilities: {
-        interaction_notify: false;
-        interaction_respond: false;
-        approve: false;
-        model_options: false;
-        set_model: false;
-        permission_options: false;
-        set_permissions: false;
-        cancel: false;
-        new_thread: false;
-        clear_thread: false;
-        resume_thread: false;
-        list_resumable_threads: false;
+        interaction_respond: boolean;
+        approve: boolean;
+        model_options: boolean;
+        set_model: boolean;
+        permission_options: boolean;
+        set_permissions: boolean;
+        cancel: boolean;
+        new_thread: boolean;
+        clear_thread: boolean;
+        resume_thread: boolean;
+        list_resumable_threads: boolean;
+        native_inspect: boolean;
         status: boolean;
         close: boolean;
         unwatch: boolean;
@@ -288,6 +314,7 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
         recover: boolean;
         retry_callback: boolean;
         callback: boolean;
+        interaction_notify: boolean;
     };
     available_actions: {
         recover?: {
@@ -332,6 +359,8 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
     delivered?: undefined;
     send_state?: undefined;
     delivery_receipt?: undefined;
+    sender_permission_class?: undefined;
+    sender_permission_class_source?: undefined;
     agent_acceptance?: undefined;
     send_error?: undefined;
     resend_allowed?: undefined;
@@ -401,18 +430,18 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
     callback_configured: boolean;
     callback_expected: boolean;
     capabilities: {
-        interaction_notify: false;
-        interaction_respond: false;
-        approve: false;
-        model_options: false;
-        set_model: false;
-        permission_options: false;
-        set_permissions: false;
-        cancel: false;
-        new_thread: false;
-        clear_thread: false;
-        resume_thread: false;
-        list_resumable_threads: false;
+        interaction_respond: boolean;
+        approve: boolean;
+        model_options: boolean;
+        set_model: boolean;
+        permission_options: boolean;
+        set_permissions: boolean;
+        cancel: boolean;
+        new_thread: boolean;
+        clear_thread: boolean;
+        resume_thread: boolean;
+        list_resumable_threads: boolean;
+        native_inspect: boolean;
         status: boolean;
         close: boolean;
         unwatch: boolean;
@@ -420,6 +449,7 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
         recover: boolean;
         retry_callback: boolean;
         callback: boolean;
+        interaction_notify: boolean;
     };
     available_actions: {
         recover?: {
@@ -464,6 +494,8 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
     delivered: boolean;
     send_state: "accepted" | "attached" | "held" | "not_sent" | "refused" | "reserved" | "uncertain";
     delivery_receipt: string;
+    sender_permission_class: import("./claude-native-sender-policy.js").ClaudeNativeSenderPermissionClass | null;
+    sender_permission_class_source: string;
     agent_acceptance: string;
     send_error: string | undefined;
     resend_allowed: boolean;
@@ -533,18 +565,550 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
     callback_configured: boolean;
     callback_expected: boolean;
     capabilities: {
-        interaction_notify: false;
-        interaction_respond: false;
-        approve: false;
-        model_options: false;
-        set_model: false;
-        permission_options: false;
-        set_permissions: false;
-        cancel: false;
-        new_thread: false;
-        clear_thread: false;
-        resume_thread: false;
-        list_resumable_threads: false;
+        interaction_respond: boolean;
+        approve: boolean;
+        model_options: boolean;
+        set_model: boolean;
+        permission_options: boolean;
+        set_permissions: boolean;
+        cancel: boolean;
+        new_thread: boolean;
+        clear_thread: boolean;
+        resume_thread: boolean;
+        list_resumable_threads: boolean;
+        native_inspect: boolean;
+        status: boolean;
+        close: boolean;
+        unwatch: boolean;
+        renew: boolean;
+        recover: boolean;
+        retry_callback: boolean;
+        callback: boolean;
+        interaction_notify: boolean;
+    };
+    available_actions: {
+        recover?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        unwatch?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        close?: {
+            tool: string;
+            input: {
+                turn_id: string;
+            };
+        } | undefined;
+        retry_callback?: {
+            tool: string;
+            input: {
+                watch_id: string;
+                notification_id: string;
+            };
+        } | undefined;
+        renew?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        status: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        };
+    };
+    message_id: string;
+    delivered: boolean;
+    send_state: "accepted" | "attached" | "held" | "not_sent" | "refused" | "reserved" | "uncertain";
+    delivery_receipt: string;
+    sender_permission_class: import("./claude-native-sender-policy.js").ClaudeNativeSenderPermissionClass | null;
+    sender_permission_class_source: string;
+    agent_acceptance: string;
+    send_error: string | undefined;
+    resend_allowed: boolean;
+    response_text?: undefined;
+    response_truncated?: undefined;
+    progress?: undefined;
+} | {
+    task_kind: "send" | "watch";
+    turn_id?: string | undefined;
+    management_state: string;
+    deadline_at: string;
+    renewal_count: number;
+    closed_at: string | undefined;
+    close_reason: string | undefined;
+    unwatched_at: string | undefined;
+    renewed_at: string | undefined;
+    recovered_at: string | undefined;
+    callback_in_flight: boolean;
+    retryable_callback_ids: string[];
+    callback_state: string;
+    callback_delivery_scope: "controller_acceptance_only";
+    channel_delivery_state: "unknown";
+    callback_notifications: {
+        id: string;
+        notification_id: string;
+        status: string;
+        attempts: number;
+        controller_acceptance: string;
+        error_code?: string | undefined;
+        request_dispatched?: boolean | undefined;
+        request_phase?: string | undefined;
+        retry_budget_exhausted?: boolean | undefined;
+        max_delivery_attempts?: number | undefined;
+        next_attempt_at?: string | undefined;
+        automatic_retry_stopped?: boolean | undefined;
+    }[];
+    waiting_for: string | null;
+    interaction_requests_scanned: boolean;
+    pending_interaction_count: null;
+    watch_id: string;
+    conversation_id: string;
+    source: string;
+    agent: string;
+    status: string;
+    observation_state: string;
+    task_origin: "send" | "watch";
+    observation_status: import("./claude-native-state-store.js").ClaudeNativeTaskStatus;
+    observation_active: boolean;
+    native_thread_id: string;
+    native_input_id: string | null;
+    task_anchor_kind: string;
+    observation_mode: string;
+    anchor_state: string;
+    needs_watch: boolean;
+    created_at: string;
+    updated_at: string;
+    observed_at: string | undefined;
+    observation_error: string | undefined;
+    callback_configured: boolean;
+    callback_expected: boolean;
+    capabilities: {
+        interaction_respond: boolean;
+        approve: boolean;
+        model_options: boolean;
+        set_model: boolean;
+        permission_options: boolean;
+        set_permissions: boolean;
+        cancel: boolean;
+        new_thread: boolean;
+        clear_thread: boolean;
+        resume_thread: boolean;
+        list_resumable_threads: boolean;
+        native_inspect: boolean;
+        status: boolean;
+        close: boolean;
+        unwatch: boolean;
+        renew: boolean;
+        recover: boolean;
+        retry_callback: boolean;
+        callback: boolean;
+        interaction_notify: boolean;
+    };
+    available_actions: {
+        recover?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        unwatch?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        close?: {
+            tool: string;
+            input: {
+                turn_id: string;
+            };
+        } | undefined;
+        retry_callback?: {
+            tool: string;
+            input: {
+                watch_id: string;
+                notification_id: string;
+            };
+        } | undefined;
+        renew?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        status: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        };
+    };
+    attention_required: boolean;
+    manual_required: boolean;
+    next_action: string;
+    interaction_hint: {
+        kind: string;
+        actionable: boolean;
+        source: string;
+    };
+    message_id?: undefined;
+    delivered?: undefined;
+    send_state?: undefined;
+    delivery_receipt?: undefined;
+    sender_permission_class?: undefined;
+    sender_permission_class_source?: undefined;
+    agent_acceptance?: undefined;
+    send_error?: undefined;
+    resend_allowed?: undefined;
+    response_text: string;
+    response_truncated: boolean;
+    progress: ClaudeNativePublicProgress | undefined;
+} | {
+    task_kind: "send" | "watch";
+    turn_id?: string | undefined;
+    management_state: string;
+    deadline_at: string;
+    renewal_count: number;
+    closed_at: string | undefined;
+    close_reason: string | undefined;
+    unwatched_at: string | undefined;
+    renewed_at: string | undefined;
+    recovered_at: string | undefined;
+    callback_in_flight: boolean;
+    retryable_callback_ids: string[];
+    callback_state: string;
+    callback_delivery_scope: "controller_acceptance_only";
+    channel_delivery_state: "unknown";
+    callback_notifications: {
+        id: string;
+        notification_id: string;
+        status: string;
+        attempts: number;
+        controller_acceptance: string;
+        error_code?: string | undefined;
+        request_dispatched?: boolean | undefined;
+        request_phase?: string | undefined;
+        retry_budget_exhausted?: boolean | undefined;
+        max_delivery_attempts?: number | undefined;
+        next_attempt_at?: string | undefined;
+        automatic_retry_stopped?: boolean | undefined;
+    }[];
+    waiting_for: string | null;
+    interaction_requests_scanned: boolean;
+    pending_interaction_count: null;
+    watch_id: string;
+    conversation_id: string;
+    source: string;
+    agent: string;
+    status: string;
+    observation_state: string;
+    task_origin: "send" | "watch";
+    observation_status: import("./claude-native-state-store.js").ClaudeNativeTaskStatus;
+    observation_active: boolean;
+    native_thread_id: string;
+    native_input_id: string | null;
+    task_anchor_kind: string;
+    observation_mode: string;
+    anchor_state: string;
+    needs_watch: boolean;
+    created_at: string;
+    updated_at: string;
+    observed_at: string | undefined;
+    observation_error: string | undefined;
+    callback_configured: boolean;
+    callback_expected: boolean;
+    capabilities: {
+        interaction_respond: boolean;
+        approve: boolean;
+        model_options: boolean;
+        set_model: boolean;
+        permission_options: boolean;
+        set_permissions: boolean;
+        cancel: boolean;
+        new_thread: boolean;
+        clear_thread: boolean;
+        resume_thread: boolean;
+        list_resumable_threads: boolean;
+        native_inspect: boolean;
+        status: boolean;
+        close: boolean;
+        unwatch: boolean;
+        renew: boolean;
+        recover: boolean;
+        retry_callback: boolean;
+        callback: boolean;
+        interaction_notify: boolean;
+    };
+    available_actions: {
+        recover?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        unwatch?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        close?: {
+            tool: string;
+            input: {
+                turn_id: string;
+            };
+        } | undefined;
+        retry_callback?: {
+            tool: string;
+            input: {
+                watch_id: string;
+                notification_id: string;
+            };
+        } | undefined;
+        renew?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        status: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        };
+    };
+    attention_required: boolean;
+    manual_required: boolean;
+    next_action: string;
+    interaction_hint: {
+        kind: string;
+        actionable: boolean;
+        source: string;
+    };
+    message_id?: undefined;
+    delivered?: undefined;
+    send_state?: undefined;
+    delivery_receipt?: undefined;
+    sender_permission_class?: undefined;
+    sender_permission_class_source?: undefined;
+    agent_acceptance?: undefined;
+    send_error?: undefined;
+    resend_allowed?: undefined;
+    response_text?: undefined;
+    response_truncated?: undefined;
+    progress?: undefined;
+} | {
+    task_kind: "send" | "watch";
+    turn_id?: string | undefined;
+    management_state: string;
+    deadline_at: string;
+    renewal_count: number;
+    closed_at: string | undefined;
+    close_reason: string | undefined;
+    unwatched_at: string | undefined;
+    renewed_at: string | undefined;
+    recovered_at: string | undefined;
+    callback_in_flight: boolean;
+    retryable_callback_ids: string[];
+    callback_state: string;
+    callback_delivery_scope: "controller_acceptance_only";
+    channel_delivery_state: "unknown";
+    callback_notifications: {
+        id: string;
+        notification_id: string;
+        status: string;
+        attempts: number;
+        controller_acceptance: string;
+        error_code?: string | undefined;
+        request_dispatched?: boolean | undefined;
+        request_phase?: string | undefined;
+        retry_budget_exhausted?: boolean | undefined;
+        max_delivery_attempts?: number | undefined;
+        next_attempt_at?: string | undefined;
+        automatic_retry_stopped?: boolean | undefined;
+    }[];
+    waiting_for: string | null;
+    interaction_requests_scanned: boolean;
+    pending_interaction_count: null;
+    watch_id: string;
+    conversation_id: string;
+    source: string;
+    agent: string;
+    status: string;
+    observation_state: string;
+    task_origin: "send" | "watch";
+    observation_status: import("./claude-native-state-store.js").ClaudeNativeTaskStatus;
+    observation_active: boolean;
+    native_thread_id: string;
+    native_input_id: string | null;
+    task_anchor_kind: string;
+    observation_mode: string;
+    anchor_state: string;
+    needs_watch: boolean;
+    created_at: string;
+    updated_at: string;
+    observed_at: string | undefined;
+    observation_error: string | undefined;
+    callback_configured: boolean;
+    callback_expected: boolean;
+    capabilities: {
+        interaction_respond: boolean;
+        approve: boolean;
+        model_options: boolean;
+        set_model: boolean;
+        permission_options: boolean;
+        set_permissions: boolean;
+        cancel: boolean;
+        new_thread: boolean;
+        clear_thread: boolean;
+        resume_thread: boolean;
+        list_resumable_threads: boolean;
+        native_inspect: boolean;
+        status: boolean;
+        close: boolean;
+        unwatch: boolean;
+        renew: boolean;
+        recover: boolean;
+        retry_callback: boolean;
+        callback: boolean;
+        interaction_notify: boolean;
+    };
+    available_actions: {
+        recover?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        unwatch?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        close?: {
+            tool: string;
+            input: {
+                turn_id: string;
+            };
+        } | undefined;
+        retry_callback?: {
+            tool: string;
+            input: {
+                watch_id: string;
+                notification_id: string;
+            };
+        } | undefined;
+        renew?: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        } | undefined;
+        status: {
+            tool: string;
+            input: {
+                watch_id: string;
+            };
+        };
+    };
+    attention_required: boolean;
+    manual_required: boolean;
+    next_action: string;
+    interaction_hint: {
+        kind: string;
+        actionable: boolean;
+        source: string;
+    };
+    message_id: string;
+    delivered: boolean;
+    send_state: "accepted" | "attached" | "held" | "not_sent" | "refused" | "reserved" | "uncertain";
+    delivery_receipt: string;
+    sender_permission_class: import("./claude-native-sender-policy.js").ClaudeNativeSenderPermissionClass | null;
+    sender_permission_class_source: string;
+    agent_acceptance: string;
+    send_error: string | undefined;
+    resend_allowed: boolean;
+    response_text: string;
+    response_truncated: boolean;
+    progress: ClaudeNativePublicProgress | undefined;
+} | {
+    task_kind: "send" | "watch";
+    turn_id?: string | undefined;
+    management_state: string;
+    deadline_at: string;
+    renewal_count: number;
+    closed_at: string | undefined;
+    close_reason: string | undefined;
+    unwatched_at: string | undefined;
+    renewed_at: string | undefined;
+    recovered_at: string | undefined;
+    callback_in_flight: boolean;
+    retryable_callback_ids: string[];
+    callback_state: string;
+    callback_delivery_scope: "controller_acceptance_only";
+    channel_delivery_state: "unknown";
+    callback_notifications: {
+        id: string;
+        notification_id: string;
+        status: string;
+        attempts: number;
+        controller_acceptance: string;
+        error_code?: string | undefined;
+        request_dispatched?: boolean | undefined;
+        request_phase?: string | undefined;
+        retry_budget_exhausted?: boolean | undefined;
+        max_delivery_attempts?: number | undefined;
+        next_attempt_at?: string | undefined;
+        automatic_retry_stopped?: boolean | undefined;
+    }[];
+    waiting_for: string | null;
+    interaction_requests_scanned: boolean;
+    pending_interaction_count: null;
+    watch_id: string;
+    conversation_id: string;
+    source: string;
+    agent: string;
+    status: string;
+    observation_state: string;
+    task_origin: "send" | "watch";
+    observation_status: import("./claude-native-state-store.js").ClaudeNativeTaskStatus;
+    observation_active: boolean;
+    native_thread_id: string;
+    native_input_id: string | null;
+    task_anchor_kind: string;
+    observation_mode: string;
+    anchor_state: string;
+    needs_watch: boolean;
+    created_at: string;
+    updated_at: string;
+    observed_at: string | undefined;
+    observation_error: string | undefined;
+    callback_configured: boolean;
+    callback_expected: boolean;
+    capabilities: {
+        interaction_respond: boolean;
+        approve: boolean;
+        model_options: boolean;
+        set_model: boolean;
+        permission_options: boolean;
+        set_permissions: boolean;
+        cancel: boolean;
+        new_thread: boolean;
+        clear_thread: boolean;
+        resume_thread: boolean;
+        list_resumable_threads: boolean;
+        native_inspect: boolean;
         status: boolean;
         close: boolean;
         unwatch: boolean;
@@ -552,6 +1116,7 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
         recover: boolean;
         retry_callback: boolean;
         callback: boolean;
+        interaction_notify: boolean;
     };
     available_actions: {
         recover?: {
@@ -592,10 +1157,20 @@ export declare function claudeNativeTaskProjection(task: ClaudeNativeTaskRecord,
             };
         };
     };
+    attention_required: boolean;
+    manual_required: boolean;
+    next_action: string;
+    interaction_hint: {
+        kind: string;
+        actionable: boolean;
+        source: string;
+    };
     message_id: string;
     delivered: boolean;
     send_state: "accepted" | "attached" | "held" | "not_sent" | "refused" | "reserved" | "uncertain";
     delivery_receipt: string;
+    sender_permission_class: import("./claude-native-sender-policy.js").ClaudeNativeSenderPermissionClass | null;
+    sender_permission_class_source: string;
     agent_acceptance: string;
     send_error: string | undefined;
     resend_allowed: boolean;