@scotthuang/agent-knock-knock 0.13.13 → 0.13.15

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.13.15 - 2026-10-02
+
+- Attempt Codex exact callback observation through validated runtime UI and paginated read contracts on newer versions; preserve exact task identity across compatible backend upgrades.
+- Automatically attach a notification-only terminal-activity Watch when exact Codex or Claude Send preparation is unavailable and physical identity remains safe.
+- Preserve strict native answer permissions and refuse uncertain probe input; include sanitized backend-version and operation diagnostics in read errors.
+- Use store writer protocol 9 with backward-readable anchors, leaving existing private Watch records intact.
+
+## 0.13.14 - 2026-10-01
+
+### Changed
+
+- Support Codex CLI 0.159.2 and the reviewed 0.159.0 foreground/0.159.2 shared-backend pair. Bind the physical and backend versions separately for paginated Send, Watch, native questions, and answer receipts; reject unreviewed pairs and backend drift.
+- Add exact Claude Code 2.1.285 lifecycle, native status, question, and model-control profiles while retaining earlier version checks.
+
+### Fixed
+
+- Recover clipped Codex `/status` cards through bounded native history navigation, requiring a complete card, unique captured overlap, and restoration before using its thread identity. Correct locale-free tmux viewport parsing, Herdr visible-screen reads, and native style checks.
+- Continue read-only confirmation of a single Codex async answer for up to 15 seconds after dispatch, including a timed-out RPC, without repeating the answer.
+- Recognize Claude's named-session Composer and Bash ask-rule prompt, and read transcript attachments written before their parent records without changing conversation order or weakening identity checks.
+
 ## 0.13.13 - 2026-09-30
 
 ### Changed

package/README.md

@@ -76,11 +76,11 @@ Open a Web conversation and enter `/akk list`. The connector gives every convers
 
 Suppose several Codex or Claude Code jobs are already running in tmux or Herdr:
 
-Codex CLI 0.158.0/0.159.0 supports exact paginated task Watches for ordinary terminal
+Codex CLI 0.158.0/0.159.0/0.159.2 supports exact paginated task Watches for ordinary terminal
 Send, native question responses, and durable completion callbacks. The adapter
 checks the foreground thread and server version before attaching; uncertain
-answers are never automatically replayed. See the [0.158.0/0.159.0 compatibility
-review](docs/codex-0.159.0-compatibility.md) for managed-session and already-open
+answers are never automatically replayed. See the [0.158.0/0.159.0/0.159.2 compatibility
+review](docs/codex-0.159.2-compatibility.md) for managed-session and already-open
 question boundaries. Codex 0.157.x retains its [partial compatibility](docs/codex-0.157.1-compatibility.md).
 
 - **Watch without babysitting.** `/akk watch <terminal>` observes work already in progress and sends a callback when it finishes, needs approval, or becomes blocked. You can leave the terminal and continue from your phone or another chat client.
@@ -137,7 +137,7 @@ Skill SHA-256 digests; an older, missing, or drifted handshake fails closed
 instead of mounting a partial tool surface. Connector package versions remain
 independent of one another.
 
-In the current OpenClaw plugin and core Host Adapter, an idle Codex pane with ambiguous foreground rollout identity may advertise `identify_foreground`. That action issues one closed `/status` command to the exact pane. It does not mutate the AKK Store, but it does type into the visible terminal. Its 30-second result is diagnostic only and grants no later authority. The separate `identify_and_send` action keeps one terminal lock across the probe and one requested task, then relies on exact request acceptance—not the status card—for durable Session and Turn identity. List and Status never run this probe. Codex 0.158.0/0.159.0 exact Send and active-task Watch use a separate closed `/status` transaction to bind the foreground paginated thread; subsequent observation is read-only.
+In the current OpenClaw plugin and core Host Adapter, an idle Codex pane with ambiguous foreground rollout identity may advertise `identify_foreground`. That action issues one closed `/status` command to the exact pane. It does not mutate the AKK Store, but it does type into the visible terminal. Its 30-second result is diagnostic only and grants no later authority. The separate `identify_and_send` action keeps one terminal lock across the probe and one requested task, then relies on exact request acceptance—not the status card—for durable Session and Turn identity. List and Status never run this probe. Codex 0.158.0/0.159.0/0.159.2 exact Send and active-task Watch use a separate closed `/status` transaction to bind the foreground paginated thread; subsequent observation is read-only.
 
 AKK is local-first: there is no hosted control plane or telemetry. It stores only the local state needed for routing, lifecycle recovery, callback delivery, and idempotency.
 

package/dist/src/claude-lifecycle-compatibility.js

@@ -45,8 +45,8 @@ const CLAUDE_STATUS_PANEL_FIELDS_2_1_261 = Object.freeze([
     ...CLAUDE_STATUS_PANEL_FIELDS_2_1_251,
     "Organization policy"
 ]);
-// Observed in Claude Code 2.1.282 /status. Keep this outside the verified
-// profile registry: only this bounded status-field difference has been checked.
+// Observed in Claude Code 2.1.282 and 2.1.285 /status. The 2.1.282 runtime
+// remains unverified: only its bounded status-field difference was checked.
 const CLAUDE_STATUS_PANEL_FIELDS_2_1_282 = Object.freeze([
     ...CLAUDE_STATUS_PANEL_FIELDS_2_1_261,
     "Auto mode server"
@@ -179,12 +179,33 @@ const CLAUDE_LIFECYCLE_PROFILES = Object.freeze({
             "2.1.266",
             "2.1.267"
         ])
+    }),
+    "2.1.285": Object.freeze({
+        lifecycleBehaviorProfile: "claude-code-2.1.285",
+        nativeInspectionBehaviorProfile: "claude-code-2.1.285-native-status",
+        nativeInspectionComposerStableMs: 80,
+        nativeInspectionComposerSettleTimeoutMs: 5_000,
+        nativeStatusPanelFields: CLAUDE_STATUS_PANEL_FIELDS_2_1_282,
+        nativeStatusPanelRequiredValues: Object.freeze({
+            "Session kind": "interactive"
+        }),
+        resumableSourceVersions: Object.freeze([
+            "2.1.218",
+            "2.1.226",
+            "2.1.237",
+            "2.1.251",
+            "2.1.259",
+            "2.1.263",
+            "2.1.266",
+            "2.1.267",
+            "2.1.285"
+        ])
     })
 });
 /**
  * Best-effort runtime protocol for complete x.y.z Claude Code versions
- * that AKK has not regression-tested yet. This deliberately reuses the newest
- * verified, bounded Status modal shape; a real TUI change therefore fails at
+ * that AKK has not regression-tested yet. This deliberately reuses the existing
+ * bounded Status modal shape; a real TUI change therefore fails at
  * observation instead of being blocked solely by its version number.
  */
 const CLAUDE_UNVERIFIED_LIFECYCLE_PROFILE = Object.freeze({

package/dist/src/claude-lifecycle-compatibility.js.map

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

package/dist/src/claude-local-transcript-provider.js

@@ -4,6 +4,7 @@ import os from "node:os";
 import path from "node:path";
 import { isClaudeAgentIdleState } from "./claude-terminal-agent-adapter.js";
 import { claudeLifecycleSourceVersionSupported, claudeRuntimeLifecycleCompatibilityProfile, DEFAULT_CLAUDE_LIFECYCLE_VERSION, } from "./claude-lifecycle-compatibility.js";
+import { assertParentsPrecedeChildren, earliestClaudeTranscriptRecordOffset, initialClaudeTranscriptCheckpointRecords, orderClaudePrewrittenAttachments } from "./claude-transcript-record-order.js";
 import { redactString } from "./runtime-log.js";
 import { isRecord } from "./value-guards.js";
 import { validateTerminalSubmissionAcceptanceEvidence } from "./terminal-submission-facts.js";
@@ -465,7 +466,7 @@ export function captureClaudeHumanStartedActiveTaskAnchor(options) {
             throw new Error("Claude active-task transcript has an incomplete JSONL tail; retry");
         }
         const recordEntries = readBoundedCompleteJsonlTail(opened.fd, before.size, maxBytes);
-        const records = recordEntries.map((entry) => entry.record);
+        const records = orderClaudePrewrittenAttachments(recordEntries.map((entry) => entry.record));
         const after = fs.fstatSync(opened.fd);
         if (!sameStableTranscriptFile(before, after)) {
             throw new Error("Claude active-task transcript changed while it was captured; retry");
@@ -517,7 +518,8 @@ export function captureClaudeHumanStartedActiveTaskAnchor(options) {
         })) {
             return undefined;
         }
-        if (!pendingApprovalTurn(snapshot)) {
+        const activeTurn = pendingApprovalTurn(snapshot);
+        if (!activeTurn) {
             throw new Error("Claude active root prompt has no unique unfinished foreground chain");
         }
         const base = {
@@ -535,7 +537,7 @@ export function captureClaudeHumanStartedActiveTaskAnchor(options) {
             request_hash: requestHash,
             claude_version: claudeVersion,
             transcript_file_id: fileId,
-            turn_start_offset_bytes: promptEntry.offsetBytes,
+            turn_start_offset_bytes: earliestClaudeTranscriptRecordOffset(recordEntries, activeTurn.descendants, promptEntry.offsetBytes),
             observed_end_offset_bytes: before.size
         };
         return {
@@ -604,7 +606,7 @@ export function observeClaudeHumanStartedActiveTask(options) {
                 throw new Error("Claude active-task JSONL record exceeded the bounded local read limit");
             }
             const safeResumeOffsetBytes = resumeOffsetBytes + completeLength;
-            const suffixRecords = readCompleteJsonlRecordEntries(opened.fd, resumeOffsetBytes, completeLength, { preReadBuffer: suffixBuffer.subarray(0, completeLength) }).map((entry) => entry.record);
+            const suffixRecords = orderClaudePrewrittenAttachments(readCompleteJsonlRecordEntries(opened.fd, resumeOffsetBytes, completeLength, { preReadBuffer: suffixBuffer.subarray(0, completeLength) }).map((entry) => entry.record));
             const after = fs.fstatSync(opened.fd);
             if (!sameStableTranscriptFile(before, after)) {
                 assertObservableClaudeActiveTaskAgent(options.agentRows, anchor);
@@ -615,7 +617,9 @@ export function observeClaudeHumanStartedActiveTask(options) {
                     checkpoint
                 };
             }
-            const advanced = advanceClaudeHumanStartedActiveTaskCheckpoint(anchor, checkpoint, suffixRecords, safeResumeOffsetBytes);
+            const advanced = advanceClaudeHumanStartedActiveTaskCheckpoint(anchor, checkpoint, checkpoint.record_count === 0
+                ? initialClaudeTranscriptCheckpointRecords(suffixRecords, anchor.prompt_uuid, hasTurnCompletionSignal)
+                : suffixRecords, safeResumeOffsetBytes);
             if (advanced.completion) {
                 return { status: "completed", completion: advanced.completion };
             }
@@ -744,7 +748,7 @@ function isActiveClaudeAgentState(agent) {
     return agent.status === "working" ||
         agent.status === "busy" ||
         (agent.status === "waiting" &&
-            ["dialog open", "permission prompt"].includes(agent.waitingFor ?? ""));
+            ["dialog open", "permission prompt", "input needed"].includes(agent.waitingFor ?? ""));
 }
 function isObservableClaudeAgentState(agent) {
     return isClaudeAgentIdleState(agent) || isActiveClaudeAgentState(agent);
@@ -2090,8 +2094,8 @@ function openRelativeTranscript(projectsRoot, relativePath) {
     }
 }
 function readCompleteJsonlRecords(fd, offset, length) {
-    return readCompleteJsonlRecordEntries(fd, offset, length)
-        .map((entry) => entry.record);
+    return orderClaudePrewrittenAttachments(readCompleteJsonlRecordEntries(fd, offset, length)
+        .map((entry) => entry.record));
 }
 function readBoundedCompleteJsonlTail(fd, endOffset, maxBytes) {
     const offset = Math.max(0, endOffset - maxBytes);
@@ -2170,17 +2174,6 @@ function descendantRecords(records, recordsByUuid, ancestorUuid, predicate) {
     return records.filter((record) => predicate(record) &&
         descendantChain(recordsByUuid, ancestorUuid, record) !== undefined);
 }
-function assertParentsPrecedeChildren(records, recordsByUuid) {
-    const indexes = new Map(records.map((record, index) => [record, index]));
-    for (const record of records) {
-        const parentUuid = uuidValue(record.parentUuid);
-        const parent = parentUuid ? recordsByUuid.get(parentUuid) : undefined;
-        if (parent && (indexes.get(parent) ?? Number.POSITIVE_INFINITY) >=
-            (indexes.get(record) ?? Number.NEGATIVE_INFINITY)) {
-            throw new Error("Claude transcript parent UUID does not precede its child record");
-        }
-    }
-}
 function descendantChain(recordsByUuid, ancestorUuid, descendant) {
     const reversed = [];
     let current = descendant;