@scotthuang/agent-knock-knock 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -4,6 +4,24 @@
 
 No unreleased changes.
 
+## 0.2.0 - 2026-06-22
+
+### Added
+
+- Added experimental native Codex session discovery and takeover flows, including safe resume, OpenClaw-summarized fork, and confirmed terminate-then-resume adoption for active Codex CLI sessions.
+- Added an explicit `allowCwdOnly` terminate-then-resume fallback for Codex TUI processes that do not expose a session id in argv; it still requires a user-confirmed pid and cwd re-scan before termination.
+- Added tests for Codex native session takeover planning, confirmed termination safeguards, fork summary confirmation, and native `codex exec resume` follow-up delivery.
+
+### Changed
+
+- Updated Codex takeover sends to use native `codex exec resume` for adopted Codex sessions, avoiding ACPX session binding issues when resuming existing terminal Codex sessions.
+
+## 0.1.2 - 2026-06-21
+
+### Fixed
+
+- Fixed stalled-task notifications from the background monitor when no explicit Gateway token is stored, allowing local OpenClaw CLI credentials to deliver the stalled callback and including a short executor-output trace in the notification.
+
 ## 0.1.1 - 2026-06-21
 
 ### Fixed

package/README.md

@@ -266,6 +266,37 @@ node dist/src/cli.js restart \
   --conversation <conversation-id>
 ```
 
+Inspect and take over native Codex sessions that were started outside AKK:
+
+Experimental: native Codex takeover depends on best-effort local Codex session metadata, process scanning, and Codex CLI resume behavior. It may be unstable across Codex versions or unusual terminal states, so review the returned plan before confirming any takeover.
+
+```bash
+node dist/src/cli.js agent discover \
+  --agent codex \
+  --scope active
+
+node dist/src/cli.js agent takeover \
+  --agent codex \
+  --session-id <native-codex-session-id> \
+  --strategy terminate_then_resume
+```
+
+`terminate_then_resume` is intentionally two-step. The first command returns the exact pid, cwd, and session that would be stopped. After confirming that plan, execute the takeover:
+
+```bash
+node dist/src/cli.js agent takeover \
+  --agent codex \
+  --session-id <native-codex-session-id> \
+  --strategy terminate_then_resume \
+  --create-conversation \
+  --confirm-terminate \
+  --expected-pid <confirmed-pid>
+```
+
+AKK re-scans before terminating and only proceeds when the confirmed pid is still an exact match for the requested Codex session. After the process exits, AKK creates a managed conversation and future sends use native `codex exec resume`.
+
+Some Codex TUI processes do not expose the native session id in argv. In that case the default takeover remains blocked as ambiguous. For a deliberate local test or an operator-confirmed handoff, add `--allow-cwd-only` with `--expected-pid`; AKK will still re-scan and require that pid to be active in the target session cwd before terminating it.
+
 Close a task locally:
 
 ```bash

package/dist/src/agent-session-provider.d.ts

@@ -0,0 +1,25 @@
+import type { ActiveCodexProcess, CodexSessionModelInfo, CodexSessionSummary, ForkContextPackage, RolloutExcerptOptions } from "./codex-session-provider.js";
+export type CodingAgentSessionProviderAgent = "codex";
+export type HistoricalSessionCapability = "full" | "metadata_only" | "unavailable";
+export type ForkContextCapability = "full" | "partial" | "unavailable";
+export type ActiveSessionCapability = "process_scan" | "unavailable";
+export type TakeoverCapability = "plan_only" | "unavailable";
+export interface AgentSessionCapabilities {
+    historicalSessions: HistoricalSessionCapability;
+    forkContext: ForkContextCapability;
+    activeSessions: ActiveSessionCapability;
+    takeover: TakeoverCapability;
+    reasons: string[];
+}
+export interface ForkContextOptions extends RolloutExcerptOptions {
+    sessionId: string;
+}
+export interface CodingAgentSessionProvider {
+    agent: CodingAgentSessionProviderAgent;
+    getCapabilities(): Promise<AgentSessionCapabilities>;
+    listHistoricalSessions(): Promise<CodexSessionSummary[]>;
+    listActiveSessions(): Promise<ActiveCodexProcess[]>;
+    getSession(sessionId: string): Promise<CodexSessionSummary | undefined>;
+    getSessionModel(sessionId: string): Promise<CodexSessionModelInfo | undefined>;
+    getForkContext(options: ForkContextOptions): Promise<ForkContextPackage | undefined>;
+}

package/dist/src/agent-session-provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-session-provider.js.map

package/dist/src/agent-session-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-provider.js","sourceRoot":"","sources":["../../src/agent-session-provider.ts"],"names":[],"mappings":""}