@scotthuang/agent-knock-knock 0.13.18 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (270) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/CONTRIBUTING.md +212 -0
  3. package/README.md +105 -166
  4. package/connectors/deepseek-harness/LICENSE +21 -0
  5. package/connectors/deepseek-harness/README.md +406 -0
  6. package/connectors/pi/LICENSE +21 -0
  7. package/connectors/pi/README.md +446 -0
  8. package/dist/src/backend-recovery-semantic.d.ts +16 -0
  9. package/dist/src/backend-recovery-semantic.js +113 -0
  10. package/dist/src/backend-recovery-semantic.js.map +1 -0
  11. package/dist/src/backend-task-recovery.d.ts +103 -0
  12. package/dist/src/backend-task-recovery.js +142 -0
  13. package/dist/src/backend-task-recovery.js.map +1 -0
  14. package/dist/src/callback-transport.d.ts +8 -0
  15. package/dist/src/callback-transport.js +14 -0
  16. package/dist/src/callback-transport.js.map +1 -1
  17. package/dist/src/cli-core.js +18 -8
  18. package/dist/src/cli-core.js.map +1 -1
  19. package/dist/src/cli-runtime-context.d.ts +5 -0
  20. package/dist/src/cli-runtime-context.js.map +1 -1
  21. package/dist/src/codex-native-cli-adapter.d.ts +6 -0
  22. package/dist/src/codex-native-cli-adapter.js +273 -0
  23. package/dist/src/codex-native-cli-adapter.js.map +1 -0
  24. package/dist/src/codex-native-client-interactions.d.ts +6 -0
  25. package/dist/src/codex-native-client-interactions.js +124 -0
  26. package/dist/src/codex-native-client-interactions.js.map +1 -0
  27. package/dist/src/codex-native-client-rpc.d.ts +21 -0
  28. package/dist/src/codex-native-client-rpc.js +137 -0
  29. package/dist/src/codex-native-client-rpc.js.map +1 -0
  30. package/dist/src/codex-native-client.d.ts +42 -0
  31. package/dist/src/codex-native-client.js +326 -0
  32. package/dist/src/codex-native-client.js.map +1 -0
  33. package/dist/src/codex-native-identity.d.ts +6 -0
  34. package/dist/src/codex-native-identity.js +42 -0
  35. package/dist/src/codex-native-identity.js.map +1 -0
  36. package/dist/src/codex-native-monitor.d.ts +4 -0
  37. package/dist/src/codex-native-monitor.js +92 -0
  38. package/dist/src/codex-native-monitor.js.map +1 -0
  39. package/dist/src/codex-native-outbox.d.ts +16 -0
  40. package/dist/src/codex-native-outbox.js +120 -0
  41. package/dist/src/codex-native-outbox.js.map +1 -0
  42. package/dist/src/codex-native-public-projection.d.ts +545 -0
  43. package/dist/src/codex-native-public-projection.js +182 -0
  44. package/dist/src/codex-native-public-projection.js.map +1 -0
  45. package/dist/src/codex-native-record-store.d.ts +27 -0
  46. package/dist/src/codex-native-record-store.js +111 -0
  47. package/dist/src/codex-native-record-store.js.map +1 -0
  48. package/dist/src/codex-native-response-service.d.ts +69 -0
  49. package/dist/src/codex-native-response-service.js +244 -0
  50. package/dist/src/codex-native-response-service.js.map +1 -0
  51. package/dist/src/codex-native-runtime.d.ts +46 -0
  52. package/dist/src/codex-native-runtime.js +112 -0
  53. package/dist/src/codex-native-runtime.js.map +1 -0
  54. package/dist/src/codex-native-semantic.d.ts +17 -0
  55. package/dist/src/codex-native-semantic.js +175 -0
  56. package/dist/src/codex-native-semantic.js.map +1 -0
  57. package/dist/src/codex-native-snapshot.d.ts +19 -0
  58. package/dist/src/codex-native-snapshot.js +160 -0
  59. package/dist/src/codex-native-snapshot.js.map +1 -0
  60. package/dist/src/codex-native-state-store.d.ts +61 -0
  61. package/dist/src/codex-native-state-store.js +132 -0
  62. package/dist/src/codex-native-state-store.js.map +1 -0
  63. package/dist/src/codex-native-task-service.d.ts +71 -0
  64. package/dist/src/codex-native-task-service.js +502 -0
  65. package/dist/src/codex-native-task-service.js.map +1 -0
  66. package/dist/src/codex-native-types.d.ts +92 -0
  67. package/dist/src/codex-native-types.js +15 -0
  68. package/dist/src/codex-native-types.js.map +1 -0
  69. package/dist/src/conversation-list.d.ts +12 -0
  70. package/dist/src/conversation-list.js +30 -0
  71. package/dist/src/conversation-list.js.map +1 -0
  72. package/dist/src/conversation-route-dispatch.d.ts +13 -0
  73. package/dist/src/conversation-route-dispatch.js +66 -0
  74. package/dist/src/conversation-route-dispatch.js.map +1 -0
  75. package/dist/src/conversation-route-legacy.d.ts +18 -0
  76. package/dist/src/conversation-route-legacy.js +54 -0
  77. package/dist/src/conversation-route-legacy.js.map +1 -0
  78. package/dist/src/conversation-route-store.d.ts +51 -0
  79. package/dist/src/conversation-route-store.js +126 -0
  80. package/dist/src/conversation-route-store.js.map +1 -0
  81. package/dist/src/conversation-routing-cli-adapter.d.ts +12 -0
  82. package/dist/src/conversation-routing-cli-adapter.js +211 -0
  83. package/dist/src/conversation-routing-cli-adapter.js.map +1 -0
  84. package/dist/src/conversation-routing-commands.d.ts +11 -0
  85. package/dist/src/conversation-routing-commands.js +85 -0
  86. package/dist/src/conversation-routing-commands.js.map +1 -0
  87. package/dist/src/conversation-routing-home.d.ts +26 -0
  88. package/dist/src/conversation-routing-home.js +105 -0
  89. package/dist/src/conversation-routing-home.js.map +1 -0
  90. package/dist/src/conversation-routing-identity.d.ts +40 -0
  91. package/dist/src/conversation-routing-identity.js +174 -0
  92. package/dist/src/conversation-routing-identity.js.map +1 -0
  93. package/dist/src/conversation-runtime-route-store.d.ts +11 -0
  94. package/dist/src/conversation-runtime-route-store.js +118 -0
  95. package/dist/src/conversation-runtime-route-store.js.map +1 -0
  96. package/dist/src/desktop-async-interactions.d.ts +15 -0
  97. package/dist/src/desktop-async-interactions.js +88 -0
  98. package/dist/src/desktop-async-interactions.js.map +1 -0
  99. package/dist/src/desktop-async-state.d.ts +5 -0
  100. package/dist/src/desktop-async-state.js +53 -0
  101. package/dist/src/desktop-async-state.js.map +1 -0
  102. package/dist/src/desktop-cli-adapter.d.ts +7 -0
  103. package/dist/src/desktop-cli-adapter.js +322 -0
  104. package/dist/src/desktop-cli-adapter.js.map +1 -0
  105. package/dist/src/desktop-cli-controls.d.ts +9 -0
  106. package/dist/src/desktop-cli-controls.js +45 -0
  107. package/dist/src/desktop-cli-controls.js.map +1 -0
  108. package/dist/src/desktop-command-presentation.d.ts +2 -0
  109. package/dist/src/desktop-command-presentation.js +31 -0
  110. package/dist/src/desktop-command-presentation.js.map +1 -0
  111. package/dist/src/desktop-control-semantic.d.ts +8 -0
  112. package/dist/src/desktop-control-semantic.js +68 -0
  113. package/dist/src/desktop-control-semantic.js.map +1 -0
  114. package/dist/src/desktop-identity.d.ts +5 -0
  115. package/dist/src/desktop-identity.js +40 -0
  116. package/dist/src/desktop-identity.js.map +1 -0
  117. package/dist/src/desktop-interaction-projection.d.ts +57 -0
  118. package/dist/src/desktop-interaction-projection.js +196 -0
  119. package/dist/src/desktop-interaction-projection.js.map +1 -0
  120. package/dist/src/desktop-interaction-state.d.ts +3 -0
  121. package/dist/src/desktop-interaction-state.js +48 -0
  122. package/dist/src/desktop-interaction-state.js.map +1 -0
  123. package/dist/src/desktop-ipc-async-answer.d.ts +9 -0
  124. package/dist/src/desktop-ipc-async-answer.js +71 -0
  125. package/dist/src/desktop-ipc-async-answer.js.map +1 -0
  126. package/dist/src/desktop-ipc-client.d.ts +47 -0
  127. package/dist/src/desktop-ipc-client.js +400 -0
  128. package/dist/src/desktop-ipc-client.js.map +1 -0
  129. package/dist/src/desktop-ipc-native-operations.d.ts +11 -0
  130. package/dist/src/desktop-ipc-native-operations.js +126 -0
  131. package/dist/src/desktop-ipc-native-operations.js.map +1 -0
  132. package/dist/src/desktop-ipc-transport.d.ts +13 -0
  133. package/dist/src/desktop-ipc-transport.js +123 -0
  134. package/dist/src/desktop-ipc-transport.js.map +1 -0
  135. package/dist/src/desktop-list.d.ts +25 -0
  136. package/dist/src/desktop-list.js +55 -0
  137. package/dist/src/desktop-list.js.map +1 -0
  138. package/dist/src/desktop-metadata-reader.d.ts +30 -0
  139. package/dist/src/desktop-metadata-reader.js +182 -0
  140. package/dist/src/desktop-metadata-reader.js.map +1 -0
  141. package/dist/src/desktop-monitor.d.ts +4 -0
  142. package/dist/src/desktop-monitor.js +101 -0
  143. package/dist/src/desktop-monitor.js.map +1 -0
  144. package/dist/src/desktop-public-projection.d.ts +6 -0
  145. package/dist/src/desktop-public-projection.js +134 -0
  146. package/dist/src/desktop-public-projection.js.map +1 -0
  147. package/dist/src/desktop-request-interactions.d.ts +14 -0
  148. package/dist/src/desktop-request-interactions.js +144 -0
  149. package/dist/src/desktop-request-interactions.js.map +1 -0
  150. package/dist/src/desktop-response-dispatch.d.ts +14 -0
  151. package/dist/src/desktop-response-dispatch.js +19 -0
  152. package/dist/src/desktop-response-dispatch.js.map +1 -0
  153. package/dist/src/desktop-response-evidence.d.ts +4 -0
  154. package/dist/src/desktop-response-evidence.js +19 -0
  155. package/dist/src/desktop-response-evidence.js.map +1 -0
  156. package/dist/src/desktop-response-service.d.ts +11 -0
  157. package/dist/src/desktop-response-service.js +188 -0
  158. package/dist/src/desktop-response-service.js.map +1 -0
  159. package/dist/src/desktop-response-store.d.ts +35 -0
  160. package/dist/src/desktop-response-store.js +58 -0
  161. package/dist/src/desktop-response-store.js.map +1 -0
  162. package/dist/src/desktop-response-types.d.ts +20 -0
  163. package/dist/src/desktop-response-types.js +2 -0
  164. package/dist/src/desktop-response-types.js.map +1 -0
  165. package/dist/src/desktop-response-value.d.ts +6 -0
  166. package/dist/src/desktop-response-value.js +31 -0
  167. package/dist/src/desktop-response-value.js.map +1 -0
  168. package/dist/src/desktop-runtime.d.ts +153 -0
  169. package/dist/src/desktop-runtime.js +88 -0
  170. package/dist/src/desktop-runtime.js.map +1 -0
  171. package/dist/src/desktop-semantic.d.ts +21 -0
  172. package/dist/src/desktop-semantic.js +140 -0
  173. package/dist/src/desktop-semantic.js.map +1 -0
  174. package/dist/src/desktop-session-catalog.d.ts +68 -0
  175. package/dist/src/desktop-session-catalog.js +225 -0
  176. package/dist/src/desktop-session-catalog.js.map +1 -0
  177. package/dist/src/desktop-session-controls.d.ts +145 -0
  178. package/dist/src/desktop-session-controls.js +176 -0
  179. package/dist/src/desktop-session-controls.js.map +1 -0
  180. package/dist/src/desktop-sidebar-metadata.d.ts +27 -0
  181. package/dist/src/desktop-sidebar-metadata.js +83 -0
  182. package/dist/src/desktop-sidebar-metadata.js.map +1 -0
  183. package/dist/src/desktop-sidebar-projects.d.ts +10 -0
  184. package/dist/src/desktop-sidebar-projects.js +31 -0
  185. package/dist/src/desktop-sidebar-projects.js.map +1 -0
  186. package/dist/src/desktop-sidebar-selection.d.ts +28 -0
  187. package/dist/src/desktop-sidebar-selection.js +85 -0
  188. package/dist/src/desktop-sidebar-selection.js.map +1 -0
  189. package/dist/src/desktop-snapshot-details.d.ts +4 -0
  190. package/dist/src/desktop-snapshot-details.js +116 -0
  191. package/dist/src/desktop-snapshot-details.js.map +1 -0
  192. package/dist/src/desktop-snapshot.d.ts +11 -0
  193. package/dist/src/desktop-snapshot.js +276 -0
  194. package/dist/src/desktop-snapshot.js.map +1 -0
  195. package/dist/src/desktop-state-store.d.ts +72 -0
  196. package/dist/src/desktop-state-store.js +269 -0
  197. package/dist/src/desktop-state-store.js.map +1 -0
  198. package/dist/src/desktop-task-interactions.d.ts +10 -0
  199. package/dist/src/desktop-task-interactions.js +93 -0
  200. package/dist/src/desktop-task-interactions.js.map +1 -0
  201. package/dist/src/desktop-task-recovery.d.ts +38 -0
  202. package/dist/src/desktop-task-recovery.js +171 -0
  203. package/dist/src/desktop-task-recovery.js.map +1 -0
  204. package/dist/src/desktop-task-service.d.ts +54 -0
  205. package/dist/src/desktop-task-service.js +441 -0
  206. package/dist/src/desktop-task-service.js.map +1 -0
  207. package/dist/src/desktop-types.d.ts +281 -0
  208. package/dist/src/desktop-types.js +13 -0
  209. package/dist/src/desktop-types.js.map +1 -0
  210. package/dist/src/host-monitor-reconciliation.js +36 -4
  211. package/dist/src/host-monitor-reconciliation.js.map +1 -1
  212. package/dist/src/host-profile-runtime.js +7 -3
  213. package/dist/src/host-profile-runtime.js.map +1 -1
  214. package/dist/src/local-codex-cli-adapter.d.ts +7 -0
  215. package/dist/src/local-codex-cli-adapter.js +13 -0
  216. package/dist/src/local-codex-cli-adapter.js.map +1 -0
  217. package/dist/src/openclaw-callback-transport.js +2 -1
  218. package/dist/src/openclaw-callback-transport.js.map +1 -1
  219. package/dist/src/semantic-conversation-target.d.ts +4 -0
  220. package/dist/src/semantic-conversation-target.js +20 -0
  221. package/dist/src/semantic-conversation-target.js.map +1 -0
  222. package/dist/src/semantic-permission-control.js +47 -9
  223. package/dist/src/semantic-permission-control.js.map +1 -1
  224. package/dist/src/semantic-private-authority-offers.d.ts +1 -1
  225. package/dist/src/semantic-private-authority-offers.js +3 -1
  226. package/dist/src/semantic-private-authority-offers.js.map +1 -1
  227. package/dist/src/semantic-tool-command-helpers.d.ts +6 -0
  228. package/dist/src/semantic-tool-command-helpers.js +199 -78
  229. package/dist/src/semantic-tool-command-helpers.js.map +1 -1
  230. package/dist/src/semantic-tool-descriptions.d.ts +2 -1
  231. package/dist/src/semantic-tool-descriptions.js +81 -35
  232. package/dist/src/semantic-tool-descriptions.js.map +1 -1
  233. package/dist/src/semantic-tool-list-projection.js +66 -2
  234. package/dist/src/semantic-tool-list-projection.js.map +1 -1
  235. package/dist/src/semantic-tool-presentation.js +76 -7
  236. package/dist/src/semantic-tool-presentation.js.map +1 -1
  237. package/dist/src/semantic-tool-runtime.js +129 -29
  238. package/dist/src/semantic-tool-runtime.js.map +1 -1
  239. package/dist/src/semantic-tool-schemas.d.ts +410 -27
  240. package/dist/src/semantic-tool-schemas.js +176 -88
  241. package/dist/src/semantic-tool-schemas.js.map +1 -1
  242. package/dist/src/terminal-action-contracts.js +10 -6
  243. package/dist/src/terminal-action-contracts.js.map +1 -1
  244. package/dist/src/terminal-list-cli-adapter.d.ts +1 -0
  245. package/dist/src/terminal-list-cli-adapter.js +6 -3
  246. package/dist/src/terminal-list-cli-adapter.js.map +1 -1
  247. package/dist/src/terminal-monitor-decision-policy.d.ts +1 -1
  248. package/dist/src/terminal-permission-control-list-projection.d.ts +1 -1
  249. package/dist/src/terminal-user-send-intent.d.ts +2 -0
  250. package/dist/src/terminal-user-send-intent.js +11 -3
  251. package/dist/src/terminal-user-send-intent.js.map +1 -1
  252. package/docs/architecture/current-architecture.md +313 -0
  253. package/docs/architecture/interactive-terminal-response.md +276 -0
  254. package/docs/architecture/issue-126-final-report.md +248 -0
  255. package/docs/architecture/orchestration-refactor-history.md +2987 -0
  256. package/docs/architecture/orchestration-refactor.md +21 -0
  257. package/docs/backend-task-recovery.md +89 -0
  258. package/docs/bidirectional-agent-protocol.md +260 -0
  259. package/docs/codex-cli-native-compatibility.md +246 -0
  260. package/docs/codex-desktop-compatibility.md +414 -0
  261. package/docs/openclaw-operations.md +281 -0
  262. package/docs/openclaw-session-turn-delivery-requirement.md +45 -0
  263. package/docs/operator-guide.md +543 -0
  264. package/docs/storage-and-logging.md +91 -0
  265. package/docs/test-performance-issue-108.md +80 -0
  266. package/docs/test-performance-issue-120.md +226 -0
  267. package/docs/testing.md +628 -0
  268. package/openclaw.plugin.json +7 -3
  269. package/package.json +6 -13
  270. package/templates/openclaw-skills/agent-knock-knock/SKILL.md +66 -15
@@ -14,6 +14,11 @@ type CliDependencyOptions = Readonly<Record<string, unknown>>;
14
14
  * parallel without sharing providers, output, environment, or clocks.
15
15
  */
16
16
  export interface CliCommandDependencies<Options extends CliDependencyOptions = CliDependencyOptions> {
17
+ conversationRoutingTerminals?: (options: Record<string, unknown>, terminalId?: string) => Promise<Record<string, unknown>[]>;
18
+ createCodexNativeRuntime?: typeof import("./codex-native-runtime.js").createCodexNativeRuntime;
19
+ launchCodexNativeMonitor?: typeof import("./codex-native-monitor.js").launchCodexNativeMonitor;
20
+ createDesktopRuntime?: typeof import("./desktop-runtime.js").createDesktopRuntime;
21
+ launchDesktopMonitor?: typeof import("./desktop-monitor.js").launchDesktopMonitor;
17
22
  terminalControlProviderRegistry?: TerminalControlProviderRegistry;
18
23
  terminalProcessSource?: TerminalProcessSource;
19
24
  createAgentSessionProvider?: (agent: "codex", options: Options) => CodingAgentSessionProvider;
@@ -1 +1 @@
1
- {"version":3,"file":"cli-runtime-context.js","sourceRoot":"","sources":["../../src/cli-runtime-context.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cli-runtime-context.js","sourceRoot":"","sources":["../../src/cli-runtime-context.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import { type CodexNativeRuntimeOptions } from "./codex-native-runtime.js";
2
+ type Options = Record<string, unknown>;
3
+ export declare function codexNativeRuntimeOptions(options: Options): CodexNativeRuntimeOptions;
4
+ export declare function codexNativeListForCli(options: Options): Promise<Record<string, unknown>>;
5
+ export declare function dispatchCodexNativeCli(command: string | undefined, options: Options): Promise<boolean>;
6
+ export {};
@@ -0,0 +1,273 @@
1
+ import { assertBackendRecoveryCliTarget } from "./backend-recovery-semantic.js";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import { randomUUID } from "node:crypto";
5
+ import { cliCwd, cliDependencies, cliEnv, writeCliStdout } from "./cli-runtime-context.js";
6
+ import { createTerminalWatchOpenClawCallbackRoute, parseCallbackRoute } from "./callback-transport.js";
7
+ import { isCodexNativeConversationId, parseCodexNativeConversationId } from "./codex-native-identity.js";
8
+ import { isCodexNativeWatchId } from "./codex-native-state-store.js";
9
+ import { codexNativeTaskNeedsReconciliation, nativeDigest, nativeErrorCode } from "./codex-native-task-service.js";
10
+ import { createCodexNativeRuntime } from "./codex-native-runtime.js";
11
+ import { launchCodexNativeMonitor, runCodexNativeMonitor } from "./codex-native-monitor.js";
12
+ import { codexNativeSessionProjection, codexNativeTaskProjection, nativeQuestionResponse } from "./codex-native-public-projection.js";
13
+ const nativeCommands = new Set(["codex-cli-list", "monitor-codex-native", "reconcile-codex-native-watches"]);
14
+ const supported = new Set([...nativeCommands, "send", "status", "watch-terminal", "watch-status", "unwatch-terminal",
15
+ "native-inspect", "permission-options", "set-permissions", "approve", "respond-interaction", "close", "renew", "recover", "retry-callback"]);
16
+ const text = (value) => typeof value === "string" && value.trim() ? value : undefined;
17
+ const required = (value, label) => {
18
+ const result = text(value);
19
+ if (!result)
20
+ throw new Error(`Codex CLI ${label} is required`);
21
+ return result;
22
+ };
23
+ const output = (value) => writeCliStdout(JSON.stringify(value, null, 2) + "\n");
24
+ export function codexNativeRuntimeOptions(options) {
25
+ const env = cliEnv();
26
+ const home = env.HOME ?? os.homedir();
27
+ const resolve = (value) => path.resolve(cliCwd(), value.startsWith("~/") ? path.join(home, value.slice(2)) : value);
28
+ let homes = [path.join(home, ".codex"), ...(text(options.codexHome) ? [text(options.codexHome)] : env.CODEX_HOME ? [env.CODEX_HOME] : [])];
29
+ if (env.AKK_NATIVE_CODEX_HOMES) {
30
+ const saved = JSON.parse(env.AKK_NATIVE_CODEX_HOMES);
31
+ if (!Array.isArray(saved) || !saved.length || saved.some(item => typeof item !== "string" || !path.isAbsolute(item))) {
32
+ throw new Error("Invalid configured Codex CLI homes");
33
+ }
34
+ homes = saved;
35
+ }
36
+ return { storeDir: resolve(text(options.storeDir ?? options.logDir) ?? path.join(home, ".agent-knock-knock", "store")),
37
+ codexHomes: [...new Set(homes.map(resolve))], openclawBin: text(options.openclawBin) };
38
+ }
39
+ const runtimeFor = (options) => (cliDependencies().createCodexNativeRuntime ?? createCodexNativeRuntime)(codexNativeRuntimeOptions(options));
40
+ export async function codexNativeListForCli(options) {
41
+ if (options.agent && options.agent !== "codex")
42
+ return { codex_cli_sessions: [], codex_cli_watches: [], codex_cli_scan: { status: "filtered" } };
43
+ const runtime = runtimeFor(options);
44
+ try {
45
+ const discovery = await runtime.catalog.discover();
46
+ const rows = [];
47
+ const errors = [...discovery.errors];
48
+ for (const entry of discovery.sessions) {
49
+ try {
50
+ const client = await runtime.clientFor(entry);
51
+ const snapshot = await client.readSnapshot(entry.threadId);
52
+ if (options.status && options.status !== snapshot.thread.status.type &&
53
+ !(options.status === "working" && snapshot.thread.status.type === "active"))
54
+ continue;
55
+ rows.push(codexNativeSessionProjection(entry, snapshot, entry.backendVersion));
56
+ }
57
+ catch (error) {
58
+ errors.push({ codexHome: entry.codexHome, error_code: nativeErrorCode(error) });
59
+ }
60
+ }
61
+ let watches = [];
62
+ let watchError;
63
+ try {
64
+ watches = runtime.tasks.list().map(codexNativeTaskProjection);
65
+ }
66
+ catch {
67
+ watchError = "codex_native_watch_store_unavailable";
68
+ }
69
+ return { codex_cli_sessions: rows, codex_cli_watches: watches,
70
+ codex_cli_scan: { status: errors.length ? "partial" : "ok", returned: rows.length,
71
+ loaded_count: discovery.sessions.length, complete: errors.length === 0, diagnostics: errors, watch_error: watchError } };
72
+ }
73
+ finally {
74
+ await runtime.close();
75
+ }
76
+ }
77
+ function conversation(options) {
78
+ if (["conversation", "conversationId", "terminal", "session", "watch", "turn"].filter(key => options[key] !== undefined).length !== 1) {
79
+ throw new Error("Codex CLI accepts exactly one native conversation or Watch target");
80
+ }
81
+ const id = required(options.conversation ?? options.conversationId, "conversation ID");
82
+ return { id, target: parseCodexNativeConversationId(id) };
83
+ }
84
+ async function launchIfNeeded(task, options) {
85
+ const result = codexNativeTaskProjection(task);
86
+ if (codexNativeTaskNeedsReconciliation(task)) {
87
+ try {
88
+ result.monitor_pid = await (cliDependencies().launchCodexNativeMonitor ?? launchCodexNativeMonitor)(task.id, codexNativeRuntimeOptions(options));
89
+ }
90
+ catch {
91
+ result.monitor_error = "codex_native_monitor_launch_failed";
92
+ result.callback_expected = false;
93
+ }
94
+ }
95
+ return result;
96
+ }
97
+ async function sendOrWatch(runtime, command, options) {
98
+ const { id, target } = conversation(options);
99
+ const controllerSession = required(options.openclawSession, "controller session");
100
+ const route = options.callbackRoute ? parseCallbackRoute(options.callbackRoute)
101
+ : createTerminalWatchOpenClawCallbackRoute({ controllerSessionId: controllerSession, openclawBin: text(options.openclawBin) });
102
+ const input = { target, nativeId: id, controllerSession, callbackRoute: route,
103
+ timeoutMs: Number(options.hardTimeoutMinutes ?? options.agentHardTimeoutMinutes ?? 60) * 60_000 };
104
+ const task = command === "send" ? await runtime.tasks.send({ ...input,
105
+ messageId: text(options.messageId) ?? randomUUID(), text: required(options.message ?? options.request, "message") })
106
+ : await runtime.tasks.watch(input);
107
+ output(await launchIfNeeded(task, options));
108
+ }
109
+ async function inspectConversation(runtime, options) {
110
+ const { target } = conversation(options);
111
+ const client = await runtime.clientFor(target);
112
+ // Subscription replays current requests on an already loaded thread; it cannot load a historical conversation.
113
+ await client.subscribe(target.threadId);
114
+ output(codexNativeSessionProjection(target, await client.readSnapshot(target.threadId), client.metadata.serverVersion, true));
115
+ }
116
+ async function permissionCommand(runtime, command, options) {
117
+ const { id, target } = conversation(options);
118
+ const client = await runtime.clientFor(target);
119
+ if (command === "set-permissions") {
120
+ if (!["read-only", "default", "full-access"].includes(String(options.mode)))
121
+ throw new Error("Mode must be read-only, default, or full-access");
122
+ const before = await client.readPermissions(target.threadId);
123
+ const settings = await client.updatePermissions(target.threadId, options.mode);
124
+ output({ source: "codex_cli", conversation_id: id, native_thread_id: target.threadId, applied: true, settings,
125
+ scope: "current_session", defaults_changed: false, do_not_retry: false,
126
+ outcome: before.preset === settings.preset ? "already_effective" : "changed",
127
+ requested: { mode: options.mode }, effective: { mode: settings.preset } });
128
+ }
129
+ else {
130
+ const settings = await client.readPermissions(target.threadId);
131
+ const labels = { "read-only": "Read Only", default: "Default", "full-access": "Full Access" };
132
+ output({ source: "codex_cli", conversation_id: id, native_thread_id: target.threadId, settings,
133
+ scope: "current_session", current: settings.preset,
134
+ choices: ["read-only", "default", "full-access"].map(mode => ({ id: mode, mode,
135
+ label: labels[mode], description: mode === "full-access" ? "Unrestricted execution without approval prompts for this thread."
136
+ : mode === "read-only" ? "Read-only sandbox; request approval for additional access." : "Write inside the workspace; request approval for additional access.",
137
+ action: { tool: "agent_knock_knock_set_permissions", input: { conversation_id: id, mode } } })) });
138
+ }
139
+ }
140
+ function responseValue(command, options, interaction) {
141
+ if (command === "approve") {
142
+ if (!["command_approval", "file_approval"].includes(interaction.kind))
143
+ throw new Error("Interaction is not an approval");
144
+ const decision = options.decision ?? "approve_once";
145
+ if (decision !== "approve_once" && decision !== "reject")
146
+ throw new Error("Decision must be approve_once or reject");
147
+ return { decision: decision === "approve_once" ? "accept"
148
+ : !interaction.availableDecisions || interaction.availableDecisions.includes("decline") ? "decline" : "cancel" };
149
+ }
150
+ else {
151
+ return nativeQuestionResponse(interaction, JSON.parse(required(options.responseJson, "typed response JSON")));
152
+ }
153
+ }
154
+ async function respond(runtime, command, options) {
155
+ const controllerSession = required(options.openclawSession, "controller session");
156
+ const watch = text(options.watch);
157
+ let subject;
158
+ if (watch) {
159
+ if (["conversation", "conversationId", "terminal", "session", "turn"].some(key => options[key] !== undefined))
160
+ throw new Error("Use only one response target");
161
+ const task = runtime.tasks.status(watch);
162
+ if (task.controller_session !== controllerSession)
163
+ throw new Error("Codex CLI Watch belongs to a different controller");
164
+ await runtime.reconcile(watch);
165
+ subject = { id: task.native_id, target: task.target };
166
+ }
167
+ else
168
+ subject = conversation(options);
169
+ const interactionId = required(options.interaction, "interaction ID");
170
+ const previous = runtime.responses.list().find(record => record.id === `codex-cli-response:${nativeDigest([subject.target, interactionId])}`);
171
+ if (previous && previous.controller_session !== controllerSession)
172
+ throw new Error("Codex CLI response belongs to a different controller");
173
+ const snapshot = previous ? undefined : await runtime.transport.observe(subject.target, watch ? runtime.tasks.status(watch).native_turn_id : undefined);
174
+ const interaction = previous?.interaction ?? snapshot?.pendingInteractions.find(item => item.id === interactionId);
175
+ if (!interaction)
176
+ throw new Error("Codex CLI interaction is no longer pending; refresh Status");
177
+ const response = responseValue(command, options, interaction);
178
+ const input = { controllerSession, interactionId,
179
+ responseId: text(options.responseId) ?? nativeDigest([controllerSession, subject.id, interactionId, response]), response };
180
+ const record = watch ? await runtime.responses.respondWatch(watch, input)
181
+ : await runtime.responses.respond({ ...input, nativeId: subject.id, target: subject.target });
182
+ output({ source: "codex_cli", conversation_id: subject.id, ...(watch ? { watch_id: watch } : {}),
183
+ interaction_id: interactionId, response_id: record.id, state: record.state, evidence: record.evidence,
184
+ attempts: record.attempts ?? 1, not_sent_history: record.not_sent_history, error_code: record.error_code,
185
+ resend_allowed: record.state === "not_sent" });
186
+ }
187
+ async function watchCommand(runtime, command, options) {
188
+ const id = required(options.watch ?? options.turn, "Watch ID");
189
+ if (["conversation", "conversationId", "terminal", "session", "watch", "turn"].filter(key => options[key] !== undefined).length !== 1)
190
+ throw new Error("Use only one exact Watch target");
191
+ const task = runtime.tasks.status(id);
192
+ if (options.openclawSession && options.openclawSession !== task.controller_session)
193
+ throw new Error("Codex CLI Watch belongs to a different controller");
194
+ if (command === "unwatch-terminal") {
195
+ output(codexNativeTaskProjection(runtime.tasks.unwatch(id, { controllerSession: required(options.openclawSession, "controller session") })));
196
+ }
197
+ else if (command === "watch-status" || command === "status") {
198
+ output(codexNativeTaskProjection(await runtime.reconcile(id)));
199
+ }
200
+ else if (["close", "renew", "recover", "retry-callback"].includes(command)) {
201
+ const controllerSession = required(options.openclawSession, "controller session");
202
+ const result = command === "close" ? runtime.tasks.close(id, { controllerSession, reason: text(options.reason) })
203
+ : command === "renew" ? await runtime.tasks.renew(id, { controllerSession,
204
+ ...((options.minutes ?? options.hardTimeoutMinutes ?? options.agentHardTimeoutMinutes) !== undefined
205
+ ? { timeoutMs: Number(options.minutes ?? options.hardTimeoutMinutes ?? options.agentHardTimeoutMinutes) * 60_000 } : {}) })
206
+ : command === "recover" ? await runtime.tasks.recover(id, { controllerSession })
207
+ : await runtime.tasks.retryCallback(id, { controllerSession, notificationId: text(options.notificationId) });
208
+ output(command === "close" ? codexNativeTaskProjection(result) : await launchIfNeeded(result, options));
209
+ }
210
+ else
211
+ throw new Error("Codex CLI Watch is only valid for status, response, or task management");
212
+ }
213
+ async function reconcileWatches(runtime) {
214
+ const before = new Map(runtime.tasks.list().map(task => [task.id, task]));
215
+ const result = await runtime.tasks.reconcileAll();
216
+ output({ checked: result.tasks.length + result.errors.length, errors: result.errors.length, diagnostics: result.errors,
217
+ changed: result.tasks.filter(task => task.status !== before.get(task.id)?.status).length,
218
+ callbacks_delivered: result.tasks.reduce((total, task) => total + task.notifications.filter(note => note.status === "accepted" &&
219
+ !before.get(task.id)?.notifications.some(old => old.id === note.id && old.status === "accepted")).length, 0) });
220
+ }
221
+ async function dispatchTarget(runtime, command, options) {
222
+ if (command === "approve" || command === "respond-interaction")
223
+ await respond(runtime, command, options);
224
+ else if (options.watch || options.turn)
225
+ await watchCommand(runtime, command, options);
226
+ else if (command === "set-permissions" || command === "permission-options" || command === "native-inspect" && options.action === "permissions") {
227
+ await permissionCommand(runtime, command, options);
228
+ }
229
+ else if (command === "status" || command === "native-inspect" && (options.action === "status" || options.action === undefined))
230
+ await inspectConversation(runtime, options);
231
+ else if (command === "send" || command === "watch-terminal")
232
+ await sendOrWatch(runtime, command, options);
233
+ else
234
+ throw new Error("Unsupported Codex CLI native inspection");
235
+ }
236
+ function isNativeDispatch(command, options) {
237
+ const target = options.conversation ?? options.conversationId ?? options.terminal ?? options.session;
238
+ return isCodexNativeConversationId(target) || String(options.watch ?? options.turn ?? "").startsWith("codex-cli-watch:") || nativeCommands.has(command ?? "");
239
+ }
240
+ export async function dispatchCodexNativeCli(command, options) {
241
+ if (!isNativeDispatch(command, options))
242
+ return false;
243
+ assertBackendRecoveryCliTarget(command, options);
244
+ if (!supported.has(command ?? ""))
245
+ throw new Error("Unsupported Codex CLI native action; target was not sent to a terminal");
246
+ if (options.watch !== undefined && !isCodexNativeWatchId(options.watch) ||
247
+ options.turn !== undefined && !isCodexNativeWatchId(options.turn))
248
+ throw new Error("Invalid Codex CLI Watch ID");
249
+ if (["close", "renew", "recover", "retry-callback"].includes(command ?? "") && !options.watch && !options.turn) {
250
+ throw new Error("Codex CLI task management requires an exact Watch ID via --watch or --turn");
251
+ }
252
+ if (command === "codex-cli-list") {
253
+ output(await codexNativeListForCli(options));
254
+ return true;
255
+ }
256
+ if (command === "monitor-codex-native") {
257
+ await runCodexNativeMonitor(required(options.watch, "Watch ID"), codexNativeRuntimeOptions(options));
258
+ return true;
259
+ }
260
+ const runtime = runtimeFor(options);
261
+ try {
262
+ if (command === "reconcile-codex-native-watches") {
263
+ await reconcileWatches(runtime);
264
+ }
265
+ else
266
+ await dispatchTarget(runtime, command, options);
267
+ return true;
268
+ }
269
+ finally {
270
+ await runtime.close();
271
+ }
272
+ }
273
+ //# sourceMappingURL=codex-native-cli-adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codex-native-cli-adapter.js","sourceRoot":"","sources":["../../src/codex-native-cli-adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import { type NativeInteraction, type NativeInteractionResponse, type CodexNativeTurn } from "./codex-native-types.js";
2
+ export declare function parseNativeRequest(raw: Record<string, unknown>): NativeInteraction | null;
3
+ export declare function nativeResponse(interaction: NativeInteraction, response: NativeInteractionResponse): Record<string, unknown>;
4
+ export declare function buildNativeAsyncReply(interaction: NativeInteraction, answer: string): string;
5
+ /** Preview comes from the same native item as the pending approval, never a nearby diff. */
6
+ export declare function hydrateNativeFileApproval(interaction: NativeInteraction, turns: CodexNativeTurn[], liveItem?: CodexNativeTurn["items"][number]): NativeInteraction;
@@ -0,0 +1,124 @@
1
+ import { CodexNativeError } from "./codex-native-types.js";
2
+ import { nativeId, nativeRecord, nativeInvalid, nativeInteractionId } from "./codex-native-snapshot.js";
3
+ const methods = new Map([
4
+ ["item/commandExecution/requestApproval", "command_approval"],
5
+ ["item/fileChange/requestApproval", "file_approval"], ["item/tool/requestUserInput", "blocking_question"]
6
+ ]);
7
+ export function parseNativeRequest(raw) {
8
+ const kind = methods.get(String(raw.method));
9
+ if (!kind)
10
+ return null;
11
+ if ((typeof raw.id !== "string" && !Number.isSafeInteger(raw.id)) || raw.id === undefined)
12
+ nativeInvalid("Invalid native request id");
13
+ const p = nativeRecord(raw.params);
14
+ const threadId = nativeId(p.threadId), turnId = nativeId(p.turnId), itemId = nativeId(p.itemId);
15
+ const questions = kind === "blocking_question" ? parseQuestions(p.questions) : [];
16
+ const details = approvalDetails(p, kind);
17
+ return { id: nativeInteractionId([threadId, turnId, itemId, raw.method, questions, details]), kind, threadId, turnId, itemId,
18
+ method: String(raw.method), requestId: raw.id, questions, ...details };
19
+ }
20
+ function approvalDetails(p, kind) {
21
+ const details = {};
22
+ for (const field of ["command", "reason", "cwd"]) {
23
+ if (p[field] != null && typeof p[field] !== "string")
24
+ nativeInvalid("Invalid native approval detail");
25
+ if (typeof p[field] === "string")
26
+ details[field] = p[field];
27
+ }
28
+ if (p.availableDecisions != null) {
29
+ if (!Array.isArray(p.availableDecisions))
30
+ nativeInvalid("Invalid native approval decisions");
31
+ details.availableDecisions = p.availableDecisions.filter((d) => typeof d === "string");
32
+ }
33
+ if (kind === "command_approval") {
34
+ details.nativeApprovalKind = p.kind == null ? "command" : nativeId(p.kind);
35
+ if (p.approvalId != null)
36
+ details.approvalId = nativeId(p.approvalId);
37
+ if (p.networkApprovalContext != null) {
38
+ const network = nativeRecord(p.networkApprovalContext);
39
+ details.networkApprovalContext = { host: nativeId(network.host, 4096), protocol: nativeId(network.protocol) };
40
+ }
41
+ }
42
+ return details;
43
+ }
44
+ function parseQuestions(value) {
45
+ if (!Array.isArray(value) || value.length < 1 || value.length > 64)
46
+ nativeInvalid("Invalid native blocking questions");
47
+ const ids = new Set();
48
+ return value.map(raw => {
49
+ const q = nativeRecord(raw);
50
+ const id = nativeId(q.id);
51
+ if (ids.has(id) || typeof q.question !== "string")
52
+ nativeInvalid("Invalid native question identity");
53
+ ids.add(id);
54
+ if (q.options != null && !Array.isArray(q.options))
55
+ nativeInvalid("Invalid native question options");
56
+ const options = (q.options ?? []).map(raw => {
57
+ const option = nativeRecord(raw);
58
+ if (typeof option.label !== "string")
59
+ nativeInvalid("Invalid native question option");
60
+ return option.label;
61
+ });
62
+ return { id, title: q.question, options, isOther: q.isOther === true, isSecret: q.isSecret === true };
63
+ });
64
+ }
65
+ export function nativeResponse(interaction, response) {
66
+ if (interaction.kind === "blocking_question" && "answers" in response) {
67
+ const keys = Object.keys(response.answers);
68
+ if (keys.length !== interaction.questions.length || interaction.questions.some(q => !Object.hasOwn(response.answers, q.id))) {
69
+ throw new CodexNativeError("invalid_argument", "Answer must identify every native question exactly once");
70
+ }
71
+ const answers = Object.create(null);
72
+ for (const q of interaction.questions) {
73
+ const values = response.answers[q.id];
74
+ if (!Array.isArray(values) || values.length < 1 || values.length > 100 || values.some(value => typeof value !== "string"
75
+ || !value.trim() || value.length > 16_384 || (!q.isOther && q.options.length > 0 && !q.options.includes(value)))) {
76
+ throw new CodexNativeError("invalid_argument", "Invalid answer for native question");
77
+ }
78
+ answers[q.id] = { answers: values };
79
+ }
80
+ return { answers };
81
+ }
82
+ if ((interaction.kind === "command_approval" || interaction.kind === "file_approval") && "decision" in response
83
+ && ["accept", "decline", "cancel"].includes(response.decision)) {
84
+ if (interaction.availableDecisions && !interaction.availableDecisions.includes(response.decision)) {
85
+ throw new CodexNativeError("invalid_argument", "Decision is not offered by this native approval");
86
+ }
87
+ return { decision: response.decision };
88
+ }
89
+ throw new CodexNativeError("invalid_argument", "Response does not match native interaction kind");
90
+ }
91
+ export function buildNativeAsyncReply(interaction, answer) {
92
+ if (interaction.kind !== "async_question" || interaction.questions.length !== 1 || typeof answer !== "string"
93
+ || !answer.trim() || answer.length > 16_384)
94
+ throw new CodexNativeError("invalid_argument", "Invalid native asynchronous answer");
95
+ const question = interaction.questions[0];
96
+ return `<send_user_message_question_reply>\n${JSON.stringify([{ questionItemId: question.id,
97
+ question: question.title, answer }])}\n</send_user_message_question_reply>`;
98
+ }
99
+ /** Preview comes from the same native item as the pending approval, never a nearby diff. */
100
+ export function hydrateNativeFileApproval(interaction, turns, liveItem) {
101
+ if (interaction.kind !== "file_approval")
102
+ return interaction;
103
+ const turn = turns.find(t => t.id === interaction.turnId);
104
+ const item = turn?.items.find(i => i.id === interaction.itemId && i.type === "fileChange")
105
+ ?? (liveItem?.id === interaction.itemId && liveItem.type === "fileChange" ? liveItem : undefined);
106
+ if (!item)
107
+ return interaction; // The canonical item can appear one polling tick after the request.
108
+ if (!Array.isArray(item.changes) || item.changes.length === 0)
109
+ nativeInvalid("Native file approval omitted exact changes");
110
+ const changes = item.changes.map(raw => {
111
+ const change = nativeRecord(raw);
112
+ const path = nativeId(change.path, 16_384);
113
+ const kind = change.kind == null ? undefined : typeof change.kind === "string" ? change.kind : nativeRecord(change.kind).type;
114
+ if (kind !== undefined && typeof kind !== "string")
115
+ nativeInvalid("Invalid native file change kind");
116
+ if (change.diff !== undefined && typeof change.diff !== "string")
117
+ nativeInvalid("Invalid native file diff");
118
+ const diffBytes = typeof change.diff === "string" ? Buffer.from(change.diff) : undefined;
119
+ return { path, ...(typeof kind === "string" ? { kind } : {}),
120
+ ...(diffBytes ? { diff: diffBytes.subarray(0, 16_384).toString("utf8"), ...(diffBytes.length > 16_384 ? { diffTruncated: true } : {}) } : {}) };
121
+ });
122
+ return { ...interaction, changes };
123
+ }
124
+ //# sourceMappingURL=codex-native-client-interactions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codex-native-client-interactions.js","sourceRoot":"","sources":["../../src/codex-native-client-interactions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import { type CodexNativeClientOptions, type CodexNativeMetadata } from "./codex-native-types.js";
2
+ /** Internal RPC transport, deliberately not exported through the public adapter. */
3
+ export declare class CodexNativeRpc {
4
+ private transport;
5
+ readonly timeoutMs: number;
6
+ readonly metadata: CodexNativeMetadata;
7
+ private sequence;
8
+ private closed;
9
+ private pending;
10
+ private listeners;
11
+ private unlisten;
12
+ private constructor();
13
+ static connect(options: CodexNativeClientOptions): Promise<CodexNativeRpc>;
14
+ onEvent(listener: (message: Record<string, unknown>) => void): () => void;
15
+ call(method: string, params: unknown, mutation?: boolean): Promise<unknown>;
16
+ respond(id: string | number, result: unknown): void;
17
+ close(): void;
18
+ private receive;
19
+ private receiveResponse;
20
+ private finish;
21
+ }