@scotthuang/agent-knock-knock 0.12.12 → 0.12.14

package/dist/src/claude-local-transcript-provider.d.ts

@@ -22,6 +22,80 @@ export interface CaptureClaudeTranscriptAnchorOptions {
     agentRows: readonly ClaudeAgentRow[];
     now?: Date;
 }
+/**
+ * Durable identity for one already-running root Claude task started by the
+ * human in the TUI. The prompt is represented only by its exact SHA-256 digest
+ * and native UUID; raw prompt content is never retained in this anchor.
+ */
+export interface ClaudeHumanStartedActiveTaskAnchor {
+    schema: "agent-knock-knock/claude-human-started-active-task-anchor";
+    version: 1;
+    session_id: string;
+    cwd: string;
+    pid: number;
+    agent_started_at_ms: number;
+    captured_at: string;
+    relative_path: string;
+    device: string;
+    inode: string;
+    prompt_uuid: string;
+    request_hash: string;
+    claude_version: string;
+    transcript_file_id: string;
+    turn_start_offset_bytes: number;
+    observed_end_offset_bytes: number;
+    anchor_fingerprint: string;
+}
+export interface CaptureClaudeHumanStartedActiveTaskOptions extends CaptureClaudeTranscriptAnchorOptions {
+    maxTurnBytes?: number;
+}
+export interface ObserveClaudeHumanStartedActiveTaskOptions extends DetectClaudeTranscriptCompletionOptions {
+    anchor: ClaudeHumanStartedActiveTaskAnchor;
+    /** Last complete, stable JSONL boundary returned by a prior observation. */
+    resumeOffsetBytes?: number;
+    checkpoint?: ClaudeHumanStartedActiveTaskCheckpoint;
+}
+export interface ClaudeHumanStartedActiveTaskCheckpointToolUse {
+    tool_use_id: string;
+    owner_uuid: string;
+}
+/**
+ * Privacy-safe continuation state for streaming one anchored Claude turn.
+ * It contains only opaque native IDs, hashes, and bounded redacted output.
+ */
+export interface ClaudeHumanStartedActiveTaskCheckpoint {
+    schema: "agent-knock-knock/claude-human-started-active-task-checkpoint";
+    version: 1;
+    anchor_fingerprint: string;
+    safe_resume_offset_bytes: number;
+    last_record_uuid: string;
+    record_count: number;
+    chain_fingerprint: string;
+    unresolved_tool_uses: ClaudeHumanStartedActiveTaskCheckpointToolUse[];
+    assistant_message_id?: string;
+    assistant_text?: string;
+    end_turn_message_id?: string;
+    end_turn_assistant_uuid?: string;
+    checkpoint_fingerprint: string;
+}
+export type ClaudeHumanStartedActiveTaskObservation = {
+    status: "pending";
+    observedEndOffsetBytes: number;
+    safeResumeOffsetBytes: number;
+    checkpoint: ClaudeHumanStartedActiveTaskCheckpoint;
+} | {
+    status: "completed";
+    completion: TerminalCompletionEvidence & {
+        outcome: "success" | "failure";
+    };
+} | {
+    status: "invalidated";
+    reason: string;
+} | {
+    status: "unavailable";
+    reason: string;
+    retryable: true;
+};
 export interface DetectClaudeTranscriptCompletionOptions {
     claudeHome?: string;
     agentRows: readonly ClaudeAgentRow[];
@@ -101,6 +175,13 @@ export declare function revalidateClaudeThreadLifecycleCandidate(candidate: Term
  * No transcript contents are retained in conversation state.
  */
 export declare function captureClaudeTranscriptAnchor(options: CaptureClaudeTranscriptAnchorOptions): ClaudeTranscriptAnchor | undefined;
+/** Capture the latest exact, unfinished root prompt in a live Claude process. */
+export declare function captureClaudeHumanStartedActiveTaskAnchor(options: CaptureClaudeHumanStartedActiveTaskOptions): ClaudeHumanStartedActiveTaskAnchor | undefined;
+/** Observe only the exact root prompt named by a human-started task anchor. */
+export declare function observeClaudeHumanStartedActiveTask(options: ObserveClaudeHumanStartedActiveTaskOptions): ClaudeHumanStartedActiveTaskObservation;
+export declare function validateClaudeHumanStartedActiveTaskAnchor(value: unknown): ClaudeHumanStartedActiveTaskAnchor;
+export declare function initialClaudeHumanStartedActiveTaskCheckpoint(value: ClaudeHumanStartedActiveTaskAnchor): ClaudeHumanStartedActiveTaskCheckpoint;
+export declare function validateClaudeHumanStartedActiveTaskCheckpoint(value: unknown, anchorValue: ClaudeHumanStartedActiveTaskAnchor): ClaudeHumanStartedActiveTaskCheckpoint;
 /**
  * Detects one completed Claude Code turn from the append-only local transcript.
  * The detector intentionally fails closed on identity, schema, rotation, prompt,