@scotthuang/agent-knock-knock 0.13.12 → 0.13.14

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 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
+
+- Extend the paginated task adapter to Codex 0.159.0 for physical Send, exact task Watch, native questions and answer receipts, and completion callbacks.
+- Preserve existing string-cursor pagination while accepting 0.159.0 as an independently checked client/backend version.
+- Keep the existing 0.158.0 support and the documented 0.157.x limitations. Store writer protocol remains 8 and Terminal Watch schema remains 3.
+
+### Fixed
+
+- Parse Codex 0.159.0 borderless native status output and wrapped fields while retaining exact fresh-card, session, and Composer checks. Separate native activity (including Thinking, Waiting, Compacting, and dynamic headers) and queued-question regions from the status card so active Watch binding and question-answer identity checks can complete. Display text remains outside task identity evidence.
+
 ## 0.13.12 - 2026-09-29
 
 ### Fixed

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 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 compatibility
-review](docs/codex-0.158.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 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;