@openclaw/codex 2026.5.1-beta.1

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 (599) hide show
  1. package/dist/.boundary-tsc.stamp +1 -0
  2. package/dist/.boundary-tsc.tsbuildinfo +1 -0
  3. package/harness.ts +59 -0
  4. package/index.test.ts +106 -0
  5. package/index.ts +41 -0
  6. package/media-understanding-provider.test.ts +300 -0
  7. package/media-understanding-provider.ts +369 -0
  8. package/openclaw.plugin.json +299 -0
  9. package/package.json +43 -0
  10. package/prompt-overlay-runtime-contract.test.ts +45 -0
  11. package/prompt-overlay.ts +19 -0
  12. package/provider-catalog.ts +83 -0
  13. package/provider-discovery.ts +45 -0
  14. package/provider.test.ts +350 -0
  15. package/provider.ts +223 -0
  16. package/src/app-server/approval-bridge.test.ts +838 -0
  17. package/src/app-server/approval-bridge.ts +731 -0
  18. package/src/app-server/auth-bridge.test.ts +922 -0
  19. package/src/app-server/auth-bridge.ts +345 -0
  20. package/src/app-server/auth-profile-runtime-contract.test.ts +217 -0
  21. package/src/app-server/capabilities.ts +27 -0
  22. package/src/app-server/client-factory.ts +30 -0
  23. package/src/app-server/client.test.ts +414 -0
  24. package/src/app-server/client.ts +575 -0
  25. package/src/app-server/compact.test.ts +452 -0
  26. package/src/app-server/compact.ts +374 -0
  27. package/src/app-server/computer-use.test.ts +790 -0
  28. package/src/app-server/computer-use.ts +682 -0
  29. package/src/app-server/config.test.ts +431 -0
  30. package/src/app-server/config.ts +486 -0
  31. package/src/app-server/context-engine-projection.test.ts +104 -0
  32. package/src/app-server/context-engine-projection.ts +147 -0
  33. package/src/app-server/delivery-no-reply-runtime-contract.test.ts +80 -0
  34. package/src/app-server/dynamic-tools.test.ts +781 -0
  35. package/src/app-server/dynamic-tools.ts +345 -0
  36. package/src/app-server/elicitation-bridge.test.ts +625 -0
  37. package/src/app-server/elicitation-bridge.ts +555 -0
  38. package/src/app-server/event-projector.test.ts +921 -0
  39. package/src/app-server/event-projector.ts +1160 -0
  40. package/src/app-server/managed-binary.test.ts +95 -0
  41. package/src/app-server/managed-binary.ts +121 -0
  42. package/src/app-server/models.test.ts +242 -0
  43. package/src/app-server/models.ts +168 -0
  44. package/src/app-server/native-hook-relay.test.ts +143 -0
  45. package/src/app-server/native-hook-relay.ts +64 -0
  46. package/src/app-server/openclaw-owned-tool-runtime-contract.test.ts +415 -0
  47. package/src/app-server/outcome-fallback-runtime-contract.test.ts +352 -0
  48. package/src/app-server/plugin-approval-roundtrip.ts +122 -0
  49. package/src/app-server/protocol-generated/json/DynamicToolCallParams.json +24 -0
  50. package/src/app-server/protocol-generated/json/v2/ErrorNotification.json +162 -0
  51. package/src/app-server/protocol-generated/json/v2/GetAccountResponse.json +86 -0
  52. package/src/app-server/protocol-generated/json/v2/ModelListResponse.json +162 -0
  53. package/src/app-server/protocol-generated/json/v2/ThreadResumeResponse.json +1994 -0
  54. package/src/app-server/protocol-generated/json/v2/ThreadStartResponse.json +1994 -0
  55. package/src/app-server/protocol-generated/json/v2/TurnCompletedNotification.json +1243 -0
  56. package/src/app-server/protocol-generated/json/v2/TurnStartResponse.json +1240 -0
  57. package/src/app-server/protocol-generated/typescript/AbsolutePathBuf.ts +14 -0
  58. package/src/app-server/protocol-generated/typescript/AgentPath.ts +5 -0
  59. package/src/app-server/protocol-generated/typescript/ApplyPatchApprovalParams.ts +24 -0
  60. package/src/app-server/protocol-generated/typescript/ApplyPatchApprovalResponse.ts +6 -0
  61. package/src/app-server/protocol-generated/typescript/AuthMode.ts +8 -0
  62. package/src/app-server/protocol-generated/typescript/ClientInfo.ts +5 -0
  63. package/src/app-server/protocol-generated/typescript/ClientNotification.ts +5 -0
  64. package/src/app-server/protocol-generated/typescript/ClientRequest.ts +165 -0
  65. package/src/app-server/protocol-generated/typescript/CollaborationMode.ts +10 -0
  66. package/src/app-server/protocol-generated/typescript/ContentItem.ts +9 -0
  67. package/src/app-server/protocol-generated/typescript/ConversationGitInfo.ts +9 -0
  68. package/src/app-server/protocol-generated/typescript/ConversationSummary.ts +19 -0
  69. package/src/app-server/protocol-generated/typescript/ExecCommandApprovalParams.ts +22 -0
  70. package/src/app-server/protocol-generated/typescript/ExecCommandApprovalResponse.ts +6 -0
  71. package/src/app-server/protocol-generated/typescript/ExecPolicyAmendment.ts +12 -0
  72. package/src/app-server/protocol-generated/typescript/FileChange.ts +8 -0
  73. package/src/app-server/protocol-generated/typescript/ForcedLoginMethod.ts +5 -0
  74. package/src/app-server/protocol-generated/typescript/FunctionCallOutputBody.ts +6 -0
  75. package/src/app-server/protocol-generated/typescript/FunctionCallOutputContentItem.ts +12 -0
  76. package/src/app-server/protocol-generated/typescript/FuzzyFileSearchMatchType.ts +5 -0
  77. package/src/app-server/protocol-generated/typescript/FuzzyFileSearchParams.ts +9 -0
  78. package/src/app-server/protocol-generated/typescript/FuzzyFileSearchResponse.ts +6 -0
  79. package/src/app-server/protocol-generated/typescript/FuzzyFileSearchResult.ts +16 -0
  80. package/src/app-server/protocol-generated/typescript/FuzzyFileSearchSessionCompletedNotification.ts +5 -0
  81. package/src/app-server/protocol-generated/typescript/FuzzyFileSearchSessionUpdatedNotification.ts +10 -0
  82. package/src/app-server/protocol-generated/typescript/GetAuthStatusParams.ts +5 -0
  83. package/src/app-server/protocol-generated/typescript/GetAuthStatusResponse.ts +10 -0
  84. package/src/app-server/protocol-generated/typescript/GetConversationSummaryParams.ts +6 -0
  85. package/src/app-server/protocol-generated/typescript/GetConversationSummaryResponse.ts +6 -0
  86. package/src/app-server/protocol-generated/typescript/GhostCommit.ts +13 -0
  87. package/src/app-server/protocol-generated/typescript/GitDiffToRemoteParams.ts +5 -0
  88. package/src/app-server/protocol-generated/typescript/GitDiffToRemoteResponse.ts +6 -0
  89. package/src/app-server/protocol-generated/typescript/GitSha.ts +5 -0
  90. package/src/app-server/protocol-generated/typescript/ImageDetail.ts +5 -0
  91. package/src/app-server/protocol-generated/typescript/InitializeCapabilities.ts +18 -0
  92. package/src/app-server/protocol-generated/typescript/InitializeParams.ts +10 -0
  93. package/src/app-server/protocol-generated/typescript/InitializeResponse.ts +22 -0
  94. package/src/app-server/protocol-generated/typescript/InputModality.ts +8 -0
  95. package/src/app-server/protocol-generated/typescript/LocalShellAction.ts +6 -0
  96. package/src/app-server/protocol-generated/typescript/LocalShellExecAction.ts +11 -0
  97. package/src/app-server/protocol-generated/typescript/LocalShellStatus.ts +5 -0
  98. package/src/app-server/protocol-generated/typescript/MessagePhase.ts +11 -0
  99. package/src/app-server/protocol-generated/typescript/ModeKind.ts +8 -0
  100. package/src/app-server/protocol-generated/typescript/NetworkPolicyAmendment.ts +6 -0
  101. package/src/app-server/protocol-generated/typescript/NetworkPolicyRuleAction.ts +5 -0
  102. package/src/app-server/protocol-generated/typescript/ParsedCommand.ts +20 -0
  103. package/src/app-server/protocol-generated/typescript/Personality.ts +5 -0
  104. package/src/app-server/protocol-generated/typescript/PlanType.ts +17 -0
  105. package/src/app-server/protocol-generated/typescript/RealtimeConversationVersion.ts +5 -0
  106. package/src/app-server/protocol-generated/typescript/RealtimeOutputModality.ts +5 -0
  107. package/src/app-server/protocol-generated/typescript/RealtimeVoice.ts +24 -0
  108. package/src/app-server/protocol-generated/typescript/RealtimeVoicesList.ts +11 -0
  109. package/src/app-server/protocol-generated/typescript/ReasoningEffort.ts +8 -0
  110. package/src/app-server/protocol-generated/typescript/ReasoningItemContent.ts +7 -0
  111. package/src/app-server/protocol-generated/typescript/ReasoningItemReasoningSummary.ts +5 -0
  112. package/src/app-server/protocol-generated/typescript/ReasoningSummary.ts +10 -0
  113. package/src/app-server/protocol-generated/typescript/RequestId.ts +5 -0
  114. package/src/app-server/protocol-generated/typescript/Resource.ts +19 -0
  115. package/src/app-server/protocol-generated/typescript/ResourceContent.ts +27 -0
  116. package/src/app-server/protocol-generated/typescript/ResourceTemplate.ts +16 -0
  117. package/src/app-server/protocol-generated/typescript/ResponseItem.ts +70 -0
  118. package/src/app-server/protocol-generated/typescript/ReviewDecision.ts +17 -0
  119. package/src/app-server/protocol-generated/typescript/ServerNotification.ts +144 -0
  120. package/src/app-server/protocol-generated/typescript/ServerRequest.ts +47 -0
  121. package/src/app-server/protocol-generated/typescript/ServiceTier.ts +5 -0
  122. package/src/app-server/protocol-generated/typescript/SessionSource.ts +13 -0
  123. package/src/app-server/protocol-generated/typescript/Settings.ts +13 -0
  124. package/src/app-server/protocol-generated/typescript/SubAgentSource.ts +20 -0
  125. package/src/app-server/protocol-generated/typescript/ThreadId.ts +5 -0
  126. package/src/app-server/protocol-generated/typescript/ThreadMemoryMode.ts +5 -0
  127. package/src/app-server/protocol-generated/typescript/Tool.ts +18 -0
  128. package/src/app-server/protocol-generated/typescript/Verbosity.ts +9 -0
  129. package/src/app-server/protocol-generated/typescript/WebSearchAction.ts +9 -0
  130. package/src/app-server/protocol-generated/typescript/WebSearchContextSize.ts +5 -0
  131. package/src/app-server/protocol-generated/typescript/WebSearchLocation.ts +10 -0
  132. package/src/app-server/protocol-generated/typescript/WebSearchMode.ts +5 -0
  133. package/src/app-server/protocol-generated/typescript/WebSearchToolConfig.ts +11 -0
  134. package/src/app-server/protocol-generated/typescript/index.ts +80 -0
  135. package/src/app-server/protocol-generated/typescript/serde_json/JsonValue.ts +11 -0
  136. package/src/app-server/protocol-generated/typescript/v2/Account.ts +9 -0
  137. package/src/app-server/protocol-generated/typescript/v2/AccountLoginCompletedNotification.ts +9 -0
  138. package/src/app-server/protocol-generated/typescript/v2/AccountRateLimitsUpdatedNotification.ts +6 -0
  139. package/src/app-server/protocol-generated/typescript/v2/AccountUpdatedNotification.ts +7 -0
  140. package/src/app-server/protocol-generated/typescript/v2/AddCreditsNudgeCreditType.ts +5 -0
  141. package/src/app-server/protocol-generated/typescript/v2/AddCreditsNudgeEmailStatus.ts +5 -0
  142. package/src/app-server/protocol-generated/typescript/v2/AdditionalFileSystemPermissions.ts +18 -0
  143. package/src/app-server/protocol-generated/typescript/v2/AdditionalNetworkPermissions.ts +5 -0
  144. package/src/app-server/protocol-generated/typescript/v2/AdditionalPermissionProfile.ts +10 -0
  145. package/src/app-server/protocol-generated/typescript/v2/AgentMessageDeltaNotification.ts +10 -0
  146. package/src/app-server/protocol-generated/typescript/v2/AnalyticsConfig.ts +14 -0
  147. package/src/app-server/protocol-generated/typescript/v2/AppBranding.ts +15 -0
  148. package/src/app-server/protocol-generated/typescript/v2/AppInfo.ts +32 -0
  149. package/src/app-server/protocol-generated/typescript/v2/AppListUpdatedNotification.ts +9 -0
  150. package/src/app-server/protocol-generated/typescript/v2/AppMetadata.ts +20 -0
  151. package/src/app-server/protocol-generated/typescript/v2/AppReview.ts +5 -0
  152. package/src/app-server/protocol-generated/typescript/v2/AppScreenshot.ts +5 -0
  153. package/src/app-server/protocol-generated/typescript/v2/AppSummary.ts +14 -0
  154. package/src/app-server/protocol-generated/typescript/v2/AppToolApproval.ts +5 -0
  155. package/src/app-server/protocol-generated/typescript/v2/AppToolsConfig.ts +8 -0
  156. package/src/app-server/protocol-generated/typescript/v2/ApprovalsReviewer.ts +12 -0
  157. package/src/app-server/protocol-generated/typescript/v2/AppsConfig.ts +17 -0
  158. package/src/app-server/protocol-generated/typescript/v2/AppsDefaultConfig.ts +9 -0
  159. package/src/app-server/protocol-generated/typescript/v2/AppsListParams.ts +25 -0
  160. package/src/app-server/protocol-generated/typescript/v2/AppsListResponse.ts +16 -0
  161. package/src/app-server/protocol-generated/typescript/v2/AskForApproval.ts +18 -0
  162. package/src/app-server/protocol-generated/typescript/v2/AutoReviewDecisionSource.ts +8 -0
  163. package/src/app-server/protocol-generated/typescript/v2/ByteRange.ts +5 -0
  164. package/src/app-server/protocol-generated/typescript/v2/CancelLoginAccountParams.ts +5 -0
  165. package/src/app-server/protocol-generated/typescript/v2/CancelLoginAccountResponse.ts +6 -0
  166. package/src/app-server/protocol-generated/typescript/v2/CancelLoginAccountStatus.ts +5 -0
  167. package/src/app-server/protocol-generated/typescript/v2/ChatgptAuthTokensRefreshParams.ts +18 -0
  168. package/src/app-server/protocol-generated/typescript/v2/ChatgptAuthTokensRefreshReason.ts +5 -0
  169. package/src/app-server/protocol-generated/typescript/v2/ChatgptAuthTokensRefreshResponse.ts +9 -0
  170. package/src/app-server/protocol-generated/typescript/v2/CodexErrorInfo.ts +27 -0
  171. package/src/app-server/protocol-generated/typescript/v2/CollabAgentState.ts +6 -0
  172. package/src/app-server/protocol-generated/typescript/v2/CollabAgentStatus.ts +12 -0
  173. package/src/app-server/protocol-generated/typescript/v2/CollabAgentTool.ts +5 -0
  174. package/src/app-server/protocol-generated/typescript/v2/CollabAgentToolCallStatus.ts +5 -0
  175. package/src/app-server/protocol-generated/typescript/v2/CollaborationModeMask.ts +15 -0
  176. package/src/app-server/protocol-generated/typescript/v2/CommandAction.ts +10 -0
  177. package/src/app-server/protocol-generated/typescript/v2/CommandExecOutputDeltaNotification.ts +31 -0
  178. package/src/app-server/protocol-generated/typescript/v2/CommandExecOutputStream.ts +8 -0
  179. package/src/app-server/protocol-generated/typescript/v2/CommandExecParams.ts +107 -0
  180. package/src/app-server/protocol-generated/typescript/v2/CommandExecResizeParams.ts +19 -0
  181. package/src/app-server/protocol-generated/typescript/v2/CommandExecResizeResponse.ts +8 -0
  182. package/src/app-server/protocol-generated/typescript/v2/CommandExecResponse.ts +25 -0
  183. package/src/app-server/protocol-generated/typescript/v2/CommandExecTerminalSize.ts +17 -0
  184. package/src/app-server/protocol-generated/typescript/v2/CommandExecTerminateParams.ts +14 -0
  185. package/src/app-server/protocol-generated/typescript/v2/CommandExecTerminateResponse.ts +8 -0
  186. package/src/app-server/protocol-generated/typescript/v2/CommandExecWriteParams.ts +23 -0
  187. package/src/app-server/protocol-generated/typescript/v2/CommandExecWriteResponse.ts +8 -0
  188. package/src/app-server/protocol-generated/typescript/v2/CommandExecutionApprovalDecision.ts +13 -0
  189. package/src/app-server/protocol-generated/typescript/v2/CommandExecutionOutputDeltaNotification.ts +10 -0
  190. package/src/app-server/protocol-generated/typescript/v2/CommandExecutionRequestApprovalParams.ts +62 -0
  191. package/src/app-server/protocol-generated/typescript/v2/CommandExecutionRequestApprovalResponse.ts +8 -0
  192. package/src/app-server/protocol-generated/typescript/v2/CommandExecutionSource.ts +9 -0
  193. package/src/app-server/protocol-generated/typescript/v2/CommandExecutionStatus.ts +5 -0
  194. package/src/app-server/protocol-generated/typescript/v2/Config.ts +54 -0
  195. package/src/app-server/protocol-generated/typescript/v2/ConfigBatchWriteParams.ts +17 -0
  196. package/src/app-server/protocol-generated/typescript/v2/ConfigEdit.ts +7 -0
  197. package/src/app-server/protocol-generated/typescript/v2/ConfigLayer.ts +12 -0
  198. package/src/app-server/protocol-generated/typescript/v2/ConfigLayerMetadata.ts +6 -0
  199. package/src/app-server/protocol-generated/typescript/v2/ConfigLayerSource.ts +27 -0
  200. package/src/app-server/protocol-generated/typescript/v2/ConfigReadParams.ts +13 -0
  201. package/src/app-server/protocol-generated/typescript/v2/ConfigReadResponse.ts +12 -0
  202. package/src/app-server/protocol-generated/typescript/v2/ConfigRequirements.ts +15 -0
  203. package/src/app-server/protocol-generated/typescript/v2/ConfigRequirementsReadResponse.ts +11 -0
  204. package/src/app-server/protocol-generated/typescript/v2/ConfigValueWriteParams.ts +16 -0
  205. package/src/app-server/protocol-generated/typescript/v2/ConfigWarningNotification.ts +23 -0
  206. package/src/app-server/protocol-generated/typescript/v2/ConfigWriteResponse.ts +16 -0
  207. package/src/app-server/protocol-generated/typescript/v2/ConfiguredHookHandler.ts +14 -0
  208. package/src/app-server/protocol-generated/typescript/v2/ConfiguredHookMatcherGroup.ts +9 -0
  209. package/src/app-server/protocol-generated/typescript/v2/ContextCompactedNotification.ts +8 -0
  210. package/src/app-server/protocol-generated/typescript/v2/CreditsSnapshot.ts +5 -0
  211. package/src/app-server/protocol-generated/typescript/v2/DeprecationNoticeNotification.ts +14 -0
  212. package/src/app-server/protocol-generated/typescript/v2/DeviceKeyAlgorithm.ts +8 -0
  213. package/src/app-server/protocol-generated/typescript/v2/DeviceKeyCreateParams.ts +16 -0
  214. package/src/app-server/protocol-generated/typescript/v2/DeviceKeyCreateResponse.ts +18 -0
  215. package/src/app-server/protocol-generated/typescript/v2/DeviceKeyProtectionClass.ts +11 -0
  216. package/src/app-server/protocol-generated/typescript/v2/DeviceKeyProtectionPolicy.ts +8 -0
  217. package/src/app-server/protocol-generated/typescript/v2/DeviceKeyPublicParams.ts +8 -0
  218. package/src/app-server/protocol-generated/typescript/v2/DeviceKeyPublicResponse.ts +18 -0
  219. package/src/app-server/protocol-generated/typescript/v2/DeviceKeySignParams.ts +9 -0
  220. package/src/app-server/protocol-generated/typescript/v2/DeviceKeySignPayload.ts +68 -0
  221. package/src/app-server/protocol-generated/typescript/v2/DeviceKeySignResponse.ts +20 -0
  222. package/src/app-server/protocol-generated/typescript/v2/DynamicToolCallOutputContentItem.ts +7 -0
  223. package/src/app-server/protocol-generated/typescript/v2/DynamicToolCallParams.ts +13 -0
  224. package/src/app-server/protocol-generated/typescript/v2/DynamicToolCallResponse.ts +9 -0
  225. package/src/app-server/protocol-generated/typescript/v2/DynamicToolCallStatus.ts +5 -0
  226. package/src/app-server/protocol-generated/typescript/v2/DynamicToolSpec.ts +12 -0
  227. package/src/app-server/protocol-generated/typescript/v2/ErrorNotification.ts +11 -0
  228. package/src/app-server/protocol-generated/typescript/v2/ExecPolicyAmendment.ts +5 -0
  229. package/src/app-server/protocol-generated/typescript/v2/ExperimentalFeature.ts +38 -0
  230. package/src/app-server/protocol-generated/typescript/v2/ExperimentalFeatureEnablementSetParams.ts +13 -0
  231. package/src/app-server/protocol-generated/typescript/v2/ExperimentalFeatureEnablementSetResponse.ts +10 -0
  232. package/src/app-server/protocol-generated/typescript/v2/ExperimentalFeatureListParams.ts +14 -0
  233. package/src/app-server/protocol-generated/typescript/v2/ExperimentalFeatureListResponse.ts +13 -0
  234. package/src/app-server/protocol-generated/typescript/v2/ExperimentalFeatureStage.ts +10 -0
  235. package/src/app-server/protocol-generated/typescript/v2/ExternalAgentConfigDetectParams.ts +14 -0
  236. package/src/app-server/protocol-generated/typescript/v2/ExternalAgentConfigDetectResponse.ts +6 -0
  237. package/src/app-server/protocol-generated/typescript/v2/ExternalAgentConfigImportCompletedNotification.ts +5 -0
  238. package/src/app-server/protocol-generated/typescript/v2/ExternalAgentConfigImportParams.ts +8 -0
  239. package/src/app-server/protocol-generated/typescript/v2/ExternalAgentConfigImportResponse.ts +5 -0
  240. package/src/app-server/protocol-generated/typescript/v2/ExternalAgentConfigMigrationItem.ts +15 -0
  241. package/src/app-server/protocol-generated/typescript/v2/ExternalAgentConfigMigrationItemType.ts +10 -0
  242. package/src/app-server/protocol-generated/typescript/v2/FeedbackUploadParams.ts +12 -0
  243. package/src/app-server/protocol-generated/typescript/v2/FeedbackUploadResponse.ts +5 -0
  244. package/src/app-server/protocol-generated/typescript/v2/FileChangeApprovalDecision.ts +5 -0
  245. package/src/app-server/protocol-generated/typescript/v2/FileChangeOutputDeltaNotification.ts +10 -0
  246. package/src/app-server/protocol-generated/typescript/v2/FileChangePatchUpdatedNotification.ts +11 -0
  247. package/src/app-server/protocol-generated/typescript/v2/FileChangeRequestApprovalParams.ts +18 -0
  248. package/src/app-server/protocol-generated/typescript/v2/FileChangeRequestApprovalResponse.ts +6 -0
  249. package/src/app-server/protocol-generated/typescript/v2/FileSystemAccessMode.ts +5 -0
  250. package/src/app-server/protocol-generated/typescript/v2/FileSystemPath.ts +10 -0
  251. package/src/app-server/protocol-generated/typescript/v2/FileSystemSandboxEntry.ts +7 -0
  252. package/src/app-server/protocol-generated/typescript/v2/FileSystemSpecialPath.ts +12 -0
  253. package/src/app-server/protocol-generated/typescript/v2/FileUpdateChange.ts +6 -0
  254. package/src/app-server/protocol-generated/typescript/v2/FsChangedNotification.ts +18 -0
  255. package/src/app-server/protocol-generated/typescript/v2/FsCopyParams.ts +22 -0
  256. package/src/app-server/protocol-generated/typescript/v2/FsCopyResponse.ts +8 -0
  257. package/src/app-server/protocol-generated/typescript/v2/FsCreateDirectoryParams.ts +18 -0
  258. package/src/app-server/protocol-generated/typescript/v2/FsCreateDirectoryResponse.ts +8 -0
  259. package/src/app-server/protocol-generated/typescript/v2/FsGetMetadataParams.ts +14 -0
  260. package/src/app-server/protocol-generated/typescript/v2/FsGetMetadataResponse.ts +29 -0
  261. package/src/app-server/protocol-generated/typescript/v2/FsReadDirectoryEntry.ts +21 -0
  262. package/src/app-server/protocol-generated/typescript/v2/FsReadDirectoryParams.ts +14 -0
  263. package/src/app-server/protocol-generated/typescript/v2/FsReadDirectoryResponse.ts +14 -0
  264. package/src/app-server/protocol-generated/typescript/v2/FsReadFileParams.ts +14 -0
  265. package/src/app-server/protocol-generated/typescript/v2/FsReadFileResponse.ts +13 -0
  266. package/src/app-server/protocol-generated/typescript/v2/FsRemoveParams.ts +22 -0
  267. package/src/app-server/protocol-generated/typescript/v2/FsRemoveResponse.ts +8 -0
  268. package/src/app-server/protocol-generated/typescript/v2/FsUnwatchParams.ts +13 -0
  269. package/src/app-server/protocol-generated/typescript/v2/FsUnwatchResponse.ts +8 -0
  270. package/src/app-server/protocol-generated/typescript/v2/FsWatchParams.ts +18 -0
  271. package/src/app-server/protocol-generated/typescript/v2/FsWatchResponse.ts +14 -0
  272. package/src/app-server/protocol-generated/typescript/v2/FsWriteFileParams.ts +18 -0
  273. package/src/app-server/protocol-generated/typescript/v2/FsWriteFileResponse.ts +8 -0
  274. package/src/app-server/protocol-generated/typescript/v2/GetAccountParams.ts +14 -0
  275. package/src/app-server/protocol-generated/typescript/v2/GetAccountRateLimitsResponse.ts +15 -0
  276. package/src/app-server/protocol-generated/typescript/v2/GetAccountResponse.ts +6 -0
  277. package/src/app-server/protocol-generated/typescript/v2/GitInfo.ts +5 -0
  278. package/src/app-server/protocol-generated/typescript/v2/GrantedPermissionProfile.ts +10 -0
  279. package/src/app-server/protocol-generated/typescript/v2/GuardianApprovalReview.ts +18 -0
  280. package/src/app-server/protocol-generated/typescript/v2/GuardianApprovalReviewAction.ts +34 -0
  281. package/src/app-server/protocol-generated/typescript/v2/GuardianApprovalReviewStatus.ts +13 -0
  282. package/src/app-server/protocol-generated/typescript/v2/GuardianCommandSource.ts +5 -0
  283. package/src/app-server/protocol-generated/typescript/v2/GuardianRiskLevel.ts +8 -0
  284. package/src/app-server/protocol-generated/typescript/v2/GuardianUserAuthorization.ts +8 -0
  285. package/src/app-server/protocol-generated/typescript/v2/GuardianWarningNotification.ts +14 -0
  286. package/src/app-server/protocol-generated/typescript/v2/HookCompletedNotification.ts +10 -0
  287. package/src/app-server/protocol-generated/typescript/v2/HookEventName.ts +11 -0
  288. package/src/app-server/protocol-generated/typescript/v2/HookExecutionMode.ts +5 -0
  289. package/src/app-server/protocol-generated/typescript/v2/HookHandlerType.ts +5 -0
  290. package/src/app-server/protocol-generated/typescript/v2/HookOutputEntry.ts +6 -0
  291. package/src/app-server/protocol-generated/typescript/v2/HookOutputEntryKind.ts +5 -0
  292. package/src/app-server/protocol-generated/typescript/v2/HookPromptFragment.ts +5 -0
  293. package/src/app-server/protocol-generated/typescript/v2/HookRunStatus.ts +5 -0
  294. package/src/app-server/protocol-generated/typescript/v2/HookRunSummary.ts +28 -0
  295. package/src/app-server/protocol-generated/typescript/v2/HookScope.ts +5 -0
  296. package/src/app-server/protocol-generated/typescript/v2/HookSource.ts +13 -0
  297. package/src/app-server/protocol-generated/typescript/v2/HookStartedNotification.ts +10 -0
  298. package/src/app-server/protocol-generated/typescript/v2/ItemCompletedNotification.ts +6 -0
  299. package/src/app-server/protocol-generated/typescript/v2/ItemGuardianApprovalReviewCompletedNotification.ts +36 -0
  300. package/src/app-server/protocol-generated/typescript/v2/ItemGuardianApprovalReviewStartedNotification.ts +34 -0
  301. package/src/app-server/protocol-generated/typescript/v2/ItemStartedNotification.ts +6 -0
  302. package/src/app-server/protocol-generated/typescript/v2/ListMcpServerStatusParams.ts +20 -0
  303. package/src/app-server/protocol-generated/typescript/v2/ListMcpServerStatusResponse.ts +13 -0
  304. package/src/app-server/protocol-generated/typescript/v2/LoginAccountParams.ts +27 -0
  305. package/src/app-server/protocol-generated/typescript/v2/LoginAccountResponse.ts +27 -0
  306. package/src/app-server/protocol-generated/typescript/v2/LogoutAccountResponse.ts +5 -0
  307. package/src/app-server/protocol-generated/typescript/v2/ManagedHooksRequirements.ts +15 -0
  308. package/src/app-server/protocol-generated/typescript/v2/MarketplaceAddParams.ts +9 -0
  309. package/src/app-server/protocol-generated/typescript/v2/MarketplaceAddResponse.ts +10 -0
  310. package/src/app-server/protocol-generated/typescript/v2/MarketplaceInterface.ts +5 -0
  311. package/src/app-server/protocol-generated/typescript/v2/MarketplaceLoadErrorInfo.ts +6 -0
  312. package/src/app-server/protocol-generated/typescript/v2/MarketplaceRemoveParams.ts +5 -0
  313. package/src/app-server/protocol-generated/typescript/v2/MarketplaceRemoveResponse.ts +9 -0
  314. package/src/app-server/protocol-generated/typescript/v2/MarketplaceUpgradeErrorInfo.ts +5 -0
  315. package/src/app-server/protocol-generated/typescript/v2/MarketplaceUpgradeParams.ts +5 -0
  316. package/src/app-server/protocol-generated/typescript/v2/MarketplaceUpgradeResponse.ts +11 -0
  317. package/src/app-server/protocol-generated/typescript/v2/McpAuthStatus.ts +5 -0
  318. package/src/app-server/protocol-generated/typescript/v2/McpElicitationArrayType.ts +5 -0
  319. package/src/app-server/protocol-generated/typescript/v2/McpElicitationBooleanSchema.ts +11 -0
  320. package/src/app-server/protocol-generated/typescript/v2/McpElicitationBooleanType.ts +5 -0
  321. package/src/app-server/protocol-generated/typescript/v2/McpElicitationConstOption.ts +5 -0
  322. package/src/app-server/protocol-generated/typescript/v2/McpElicitationEnumSchema.ts +11 -0
  323. package/src/app-server/protocol-generated/typescript/v2/McpElicitationLegacyTitledEnumSchema.ts +13 -0
  324. package/src/app-server/protocol-generated/typescript/v2/McpElicitationMultiSelectEnumSchema.ts +9 -0
  325. package/src/app-server/protocol-generated/typescript/v2/McpElicitationNumberSchema.ts +13 -0
  326. package/src/app-server/protocol-generated/typescript/v2/McpElicitationNumberType.ts +5 -0
  327. package/src/app-server/protocol-generated/typescript/v2/McpElicitationObjectType.ts +5 -0
  328. package/src/app-server/protocol-generated/typescript/v2/McpElicitationPrimitiveSchema.ts +13 -0
  329. package/src/app-server/protocol-generated/typescript/v2/McpElicitationSchema.ts +18 -0
  330. package/src/app-server/protocol-generated/typescript/v2/McpElicitationSingleSelectEnumSchema.ts +9 -0
  331. package/src/app-server/protocol-generated/typescript/v2/McpElicitationStringFormat.ts +5 -0
  332. package/src/app-server/protocol-generated/typescript/v2/McpElicitationStringSchema.ts +15 -0
  333. package/src/app-server/protocol-generated/typescript/v2/McpElicitationStringType.ts +5 -0
  334. package/src/app-server/protocol-generated/typescript/v2/McpElicitationTitledEnumItems.ts +6 -0
  335. package/src/app-server/protocol-generated/typescript/v2/McpElicitationTitledMultiSelectEnumSchema.ts +15 -0
  336. package/src/app-server/protocol-generated/typescript/v2/McpElicitationTitledSingleSelectEnumSchema.ts +13 -0
  337. package/src/app-server/protocol-generated/typescript/v2/McpElicitationUntitledEnumItems.ts +9 -0
  338. package/src/app-server/protocol-generated/typescript/v2/McpElicitationUntitledMultiSelectEnumSchema.ts +15 -0
  339. package/src/app-server/protocol-generated/typescript/v2/McpElicitationUntitledSingleSelectEnumSchema.ts +12 -0
  340. package/src/app-server/protocol-generated/typescript/v2/McpResourceReadParams.ts +5 -0
  341. package/src/app-server/protocol-generated/typescript/v2/McpResourceReadResponse.ts +6 -0
  342. package/src/app-server/protocol-generated/typescript/v2/McpServerElicitationAction.ts +5 -0
  343. package/src/app-server/protocol-generated/typescript/v2/McpServerElicitationRequestParams.ts +27 -0
  344. package/src/app-server/protocol-generated/typescript/v2/McpServerElicitationRequestResponse.ts +19 -0
  345. package/src/app-server/protocol-generated/typescript/v2/McpServerOauthLoginCompletedNotification.ts +9 -0
  346. package/src/app-server/protocol-generated/typescript/v2/McpServerOauthLoginParams.ts +9 -0
  347. package/src/app-server/protocol-generated/typescript/v2/McpServerOauthLoginResponse.ts +5 -0
  348. package/src/app-server/protocol-generated/typescript/v2/McpServerRefreshResponse.ts +5 -0
  349. package/src/app-server/protocol-generated/typescript/v2/McpServerStartupState.ts +5 -0
  350. package/src/app-server/protocol-generated/typescript/v2/McpServerStatus.ts +15 -0
  351. package/src/app-server/protocol-generated/typescript/v2/McpServerStatusDetail.ts +5 -0
  352. package/src/app-server/protocol-generated/typescript/v2/McpServerStatusUpdatedNotification.ts +10 -0
  353. package/src/app-server/protocol-generated/typescript/v2/McpServerToolCallParams.ts +12 -0
  354. package/src/app-server/protocol-generated/typescript/v2/McpServerToolCallResponse.ts +11 -0
  355. package/src/app-server/protocol-generated/typescript/v2/McpToolCallError.ts +5 -0
  356. package/src/app-server/protocol-generated/typescript/v2/McpToolCallProgressNotification.ts +10 -0
  357. package/src/app-server/protocol-generated/typescript/v2/McpToolCallResult.ts +10 -0
  358. package/src/app-server/protocol-generated/typescript/v2/McpToolCallStatus.ts +5 -0
  359. package/src/app-server/protocol-generated/typescript/v2/MemoryCitation.ts +6 -0
  360. package/src/app-server/protocol-generated/typescript/v2/MemoryCitationEntry.ts +10 -0
  361. package/src/app-server/protocol-generated/typescript/v2/MergeStrategy.ts +5 -0
  362. package/src/app-server/protocol-generated/typescript/v2/MigrationDetails.ts +6 -0
  363. package/src/app-server/protocol-generated/typescript/v2/Model.ts +25 -0
  364. package/src/app-server/protocol-generated/typescript/v2/ModelAvailabilityNux.ts +5 -0
  365. package/src/app-server/protocol-generated/typescript/v2/ModelListParams.ts +18 -0
  366. package/src/app-server/protocol-generated/typescript/v2/ModelListResponse.ts +13 -0
  367. package/src/app-server/protocol-generated/typescript/v2/ModelRerouteReason.ts +5 -0
  368. package/src/app-server/protocol-generated/typescript/v2/ModelReroutedNotification.ts +12 -0
  369. package/src/app-server/protocol-generated/typescript/v2/ModelUpgradeInfo.ts +10 -0
  370. package/src/app-server/protocol-generated/typescript/v2/ModelVerification.ts +5 -0
  371. package/src/app-server/protocol-generated/typescript/v2/ModelVerificationNotification.ts +10 -0
  372. package/src/app-server/protocol-generated/typescript/v2/NetworkAccess.ts +5 -0
  373. package/src/app-server/protocol-generated/typescript/v2/NetworkApprovalContext.ts +6 -0
  374. package/src/app-server/protocol-generated/typescript/v2/NetworkApprovalProtocol.ts +5 -0
  375. package/src/app-server/protocol-generated/typescript/v2/NetworkDomainPermission.ts +5 -0
  376. package/src/app-server/protocol-generated/typescript/v2/NetworkPolicyAmendment.ts +6 -0
  377. package/src/app-server/protocol-generated/typescript/v2/NetworkPolicyRuleAction.ts +5 -0
  378. package/src/app-server/protocol-generated/typescript/v2/NetworkRequirements.ts +40 -0
  379. package/src/app-server/protocol-generated/typescript/v2/NetworkUnixSocketPermission.ts +5 -0
  380. package/src/app-server/protocol-generated/typescript/v2/NonSteerableTurnKind.ts +5 -0
  381. package/src/app-server/protocol-generated/typescript/v2/OverriddenMetadata.ts +11 -0
  382. package/src/app-server/protocol-generated/typescript/v2/PatchApplyStatus.ts +5 -0
  383. package/src/app-server/protocol-generated/typescript/v2/PatchChangeKind.ts +8 -0
  384. package/src/app-server/protocol-generated/typescript/v2/PermissionGrantScope.ts +5 -0
  385. package/src/app-server/protocol-generated/typescript/v2/PermissionProfile.ts +10 -0
  386. package/src/app-server/protocol-generated/typescript/v2/PermissionProfileFileSystemPermissions.ts +9 -0
  387. package/src/app-server/protocol-generated/typescript/v2/PermissionProfileNetworkPermissions.ts +5 -0
  388. package/src/app-server/protocol-generated/typescript/v2/PermissionsRequestApprovalParams.ts +14 -0
  389. package/src/app-server/protocol-generated/typescript/v2/PermissionsRequestApprovalResponse.ts +14 -0
  390. package/src/app-server/protocol-generated/typescript/v2/PlanDeltaNotification.ts +14 -0
  391. package/src/app-server/protocol-generated/typescript/v2/PluginAuthPolicy.ts +5 -0
  392. package/src/app-server/protocol-generated/typescript/v2/PluginDetail.ts +17 -0
  393. package/src/app-server/protocol-generated/typescript/v2/PluginInstallParams.ts +10 -0
  394. package/src/app-server/protocol-generated/typescript/v2/PluginInstallPolicy.ts +5 -0
  395. package/src/app-server/protocol-generated/typescript/v2/PluginInstallResponse.ts +10 -0
  396. package/src/app-server/protocol-generated/typescript/v2/PluginInterface.ts +46 -0
  397. package/src/app-server/protocol-generated/typescript/v2/PluginListParams.ts +12 -0
  398. package/src/app-server/protocol-generated/typescript/v2/PluginListResponse.ts +11 -0
  399. package/src/app-server/protocol-generated/typescript/v2/PluginMarketplaceEntry.ts +17 -0
  400. package/src/app-server/protocol-generated/typescript/v2/PluginReadParams.ts +10 -0
  401. package/src/app-server/protocol-generated/typescript/v2/PluginReadResponse.ts +6 -0
  402. package/src/app-server/protocol-generated/typescript/v2/PluginSource.ts +9 -0
  403. package/src/app-server/protocol-generated/typescript/v2/PluginSummary.ts +18 -0
  404. package/src/app-server/protocol-generated/typescript/v2/PluginUninstallParams.ts +5 -0
  405. package/src/app-server/protocol-generated/typescript/v2/PluginUninstallResponse.ts +5 -0
  406. package/src/app-server/protocol-generated/typescript/v2/PluginsMigration.ts +5 -0
  407. package/src/app-server/protocol-generated/typescript/v2/ProfileV2.ts +38 -0
  408. package/src/app-server/protocol-generated/typescript/v2/RateLimitReachedType.ts +10 -0
  409. package/src/app-server/protocol-generated/typescript/v2/RateLimitSnapshot.ts +17 -0
  410. package/src/app-server/protocol-generated/typescript/v2/RateLimitWindow.ts +9 -0
  411. package/src/app-server/protocol-generated/typescript/v2/RawResponseItemCompletedNotification.ts +10 -0
  412. package/src/app-server/protocol-generated/typescript/v2/ReadOnlyAccess.ts +8 -0
  413. package/src/app-server/protocol-generated/typescript/v2/ReasoningEffortOption.ts +6 -0
  414. package/src/app-server/protocol-generated/typescript/v2/ReasoningSummaryPartAddedNotification.ts +10 -0
  415. package/src/app-server/protocol-generated/typescript/v2/ReasoningSummaryTextDeltaNotification.ts +11 -0
  416. package/src/app-server/protocol-generated/typescript/v2/ReasoningTextDeltaNotification.ts +11 -0
  417. package/src/app-server/protocol-generated/typescript/v2/RemoteControlClientConnectionAudience.ts +8 -0
  418. package/src/app-server/protocol-generated/typescript/v2/RemoteControlClientEnrollmentAudience.ts +8 -0
  419. package/src/app-server/protocol-generated/typescript/v2/RequestPermissionProfile.ts +10 -0
  420. package/src/app-server/protocol-generated/typescript/v2/ResidencyRequirement.ts +5 -0
  421. package/src/app-server/protocol-generated/typescript/v2/ReviewDelivery.ts +5 -0
  422. package/src/app-server/protocol-generated/typescript/v2/ReviewStartParams.ts +15 -0
  423. package/src/app-server/protocol-generated/typescript/v2/ReviewStartResponse.ts +15 -0
  424. package/src/app-server/protocol-generated/typescript/v2/ReviewTarget.ts +16 -0
  425. package/src/app-server/protocol-generated/typescript/v2/SandboxMode.ts +5 -0
  426. package/src/app-server/protocol-generated/typescript/v2/SandboxPolicy.ts +19 -0
  427. package/src/app-server/protocol-generated/typescript/v2/SandboxWorkspaceWrite.ts +10 -0
  428. package/src/app-server/protocol-generated/typescript/v2/SendAddCreditsNudgeEmailParams.ts +6 -0
  429. package/src/app-server/protocol-generated/typescript/v2/SendAddCreditsNudgeEmailResponse.ts +6 -0
  430. package/src/app-server/protocol-generated/typescript/v2/ServerRequestResolvedNotification.ts +6 -0
  431. package/src/app-server/protocol-generated/typescript/v2/SessionSource.ts +13 -0
  432. package/src/app-server/protocol-generated/typescript/v2/SkillDependencies.ts +6 -0
  433. package/src/app-server/protocol-generated/typescript/v2/SkillErrorInfo.ts +5 -0
  434. package/src/app-server/protocol-generated/typescript/v2/SkillInterface.ts +13 -0
  435. package/src/app-server/protocol-generated/typescript/v2/SkillMetadata.ts +21 -0
  436. package/src/app-server/protocol-generated/typescript/v2/SkillScope.ts +5 -0
  437. package/src/app-server/protocol-generated/typescript/v2/SkillSummary.ts +14 -0
  438. package/src/app-server/protocol-generated/typescript/v2/SkillToolDependency.ts +12 -0
  439. package/src/app-server/protocol-generated/typescript/v2/SkillsChangedNotification.ts +11 -0
  440. package/src/app-server/protocol-generated/typescript/v2/SkillsConfigWriteParams.ts +16 -0
  441. package/src/app-server/protocol-generated/typescript/v2/SkillsConfigWriteResponse.ts +5 -0
  442. package/src/app-server/protocol-generated/typescript/v2/SkillsListEntry.ts +11 -0
  443. package/src/app-server/protocol-generated/typescript/v2/SkillsListExtraRootsForCwd.ts +5 -0
  444. package/src/app-server/protocol-generated/typescript/v2/SkillsListParams.ts +19 -0
  445. package/src/app-server/protocol-generated/typescript/v2/SkillsListResponse.ts +6 -0
  446. package/src/app-server/protocol-generated/typescript/v2/SortDirection.ts +5 -0
  447. package/src/app-server/protocol-generated/typescript/v2/TerminalInteractionNotification.ts +11 -0
  448. package/src/app-server/protocol-generated/typescript/v2/TextElement.ts +15 -0
  449. package/src/app-server/protocol-generated/typescript/v2/TextPosition.ts +14 -0
  450. package/src/app-server/protocol-generated/typescript/v2/TextRange.ts +6 -0
  451. package/src/app-server/protocol-generated/typescript/v2/Thread.ts +79 -0
  452. package/src/app-server/protocol-generated/typescript/v2/ThreadActiveFlag.ts +5 -0
  453. package/src/app-server/protocol-generated/typescript/v2/ThreadApproveGuardianDeniedActionParams.ts +12 -0
  454. package/src/app-server/protocol-generated/typescript/v2/ThreadApproveGuardianDeniedActionResponse.ts +5 -0
  455. package/src/app-server/protocol-generated/typescript/v2/ThreadArchiveParams.ts +5 -0
  456. package/src/app-server/protocol-generated/typescript/v2/ThreadArchiveResponse.ts +5 -0
  457. package/src/app-server/protocol-generated/typescript/v2/ThreadArchivedNotification.ts +5 -0
  458. package/src/app-server/protocol-generated/typescript/v2/ThreadClosedNotification.ts +5 -0
  459. package/src/app-server/protocol-generated/typescript/v2/ThreadCompactStartParams.ts +5 -0
  460. package/src/app-server/protocol-generated/typescript/v2/ThreadCompactStartResponse.ts +5 -0
  461. package/src/app-server/protocol-generated/typescript/v2/ThreadForkParams.ts +55 -0
  462. package/src/app-server/protocol-generated/typescript/v2/ThreadForkResponse.ts +41 -0
  463. package/src/app-server/protocol-generated/typescript/v2/ThreadInjectItemsParams.ts +12 -0
  464. package/src/app-server/protocol-generated/typescript/v2/ThreadInjectItemsResponse.ts +5 -0
  465. package/src/app-server/protocol-generated/typescript/v2/ThreadItem.ts +156 -0
  466. package/src/app-server/protocol-generated/typescript/v2/ThreadListParams.ts +55 -0
  467. package/src/app-server/protocol-generated/typescript/v2/ThreadListResponse.ts +20 -0
  468. package/src/app-server/protocol-generated/typescript/v2/ThreadLoadedListParams.ts +14 -0
  469. package/src/app-server/protocol-generated/typescript/v2/ThreadLoadedListResponse.ts +15 -0
  470. package/src/app-server/protocol-generated/typescript/v2/ThreadMetadataGitInfoUpdateParams.ts +21 -0
  471. package/src/app-server/protocol-generated/typescript/v2/ThreadMetadataUpdateParams.ts +14 -0
  472. package/src/app-server/protocol-generated/typescript/v2/ThreadMetadataUpdateResponse.ts +6 -0
  473. package/src/app-server/protocol-generated/typescript/v2/ThreadNameUpdatedNotification.ts +5 -0
  474. package/src/app-server/protocol-generated/typescript/v2/ThreadReadParams.ts +11 -0
  475. package/src/app-server/protocol-generated/typescript/v2/ThreadReadResponse.ts +6 -0
  476. package/src/app-server/protocol-generated/typescript/v2/ThreadRealtimeAudioChunk.ts +14 -0
  477. package/src/app-server/protocol-generated/typescript/v2/ThreadRealtimeClosedNotification.ts +8 -0
  478. package/src/app-server/protocol-generated/typescript/v2/ThreadRealtimeErrorNotification.ts +8 -0
  479. package/src/app-server/protocol-generated/typescript/v2/ThreadRealtimeItemAddedNotification.ts +9 -0
  480. package/src/app-server/protocol-generated/typescript/v2/ThreadRealtimeOutputAudioDeltaNotification.ts +12 -0
  481. package/src/app-server/protocol-generated/typescript/v2/ThreadRealtimeSdpNotification.ts +8 -0
  482. package/src/app-server/protocol-generated/typescript/v2/ThreadRealtimeStartTransport.ts +17 -0
  483. package/src/app-server/protocol-generated/typescript/v2/ThreadRealtimeStartedNotification.ts +13 -0
  484. package/src/app-server/protocol-generated/typescript/v2/ThreadRealtimeTranscriptDeltaNotification.ts +16 -0
  485. package/src/app-server/protocol-generated/typescript/v2/ThreadRealtimeTranscriptDoneNotification.ts +16 -0
  486. package/src/app-server/protocol-generated/typescript/v2/ThreadResumeParams.ts +64 -0
  487. package/src/app-server/protocol-generated/typescript/v2/ThreadResumeResponse.ts +41 -0
  488. package/src/app-server/protocol-generated/typescript/v2/ThreadRollbackParams.ts +14 -0
  489. package/src/app-server/protocol-generated/typescript/v2/ThreadRollbackResponse.ts +15 -0
  490. package/src/app-server/protocol-generated/typescript/v2/ThreadSetNameParams.ts +5 -0
  491. package/src/app-server/protocol-generated/typescript/v2/ThreadSetNameResponse.ts +5 -0
  492. package/src/app-server/protocol-generated/typescript/v2/ThreadShellCommandParams.ts +14 -0
  493. package/src/app-server/protocol-generated/typescript/v2/ThreadShellCommandResponse.ts +5 -0
  494. package/src/app-server/protocol-generated/typescript/v2/ThreadSortKey.ts +5 -0
  495. package/src/app-server/protocol-generated/typescript/v2/ThreadSourceKind.ts +15 -0
  496. package/src/app-server/protocol-generated/typescript/v2/ThreadStartParams.ts +43 -0
  497. package/src/app-server/protocol-generated/typescript/v2/ThreadStartResponse.ts +41 -0
  498. package/src/app-server/protocol-generated/typescript/v2/ThreadStartSource.ts +5 -0
  499. package/src/app-server/protocol-generated/typescript/v2/ThreadStartedNotification.ts +6 -0
  500. package/src/app-server/protocol-generated/typescript/v2/ThreadStatus.ts +10 -0
  501. package/src/app-server/protocol-generated/typescript/v2/ThreadStatusChangedNotification.ts +6 -0
  502. package/src/app-server/protocol-generated/typescript/v2/ThreadTokenUsage.ts +10 -0
  503. package/src/app-server/protocol-generated/typescript/v2/ThreadTokenUsageUpdatedNotification.ts +10 -0
  504. package/src/app-server/protocol-generated/typescript/v2/ThreadTurnsListParams.ts +20 -0
  505. package/src/app-server/protocol-generated/typescript/v2/ThreadTurnsListResponse.ts +20 -0
  506. package/src/app-server/protocol-generated/typescript/v2/ThreadUnarchiveParams.ts +5 -0
  507. package/src/app-server/protocol-generated/typescript/v2/ThreadUnarchiveResponse.ts +6 -0
  508. package/src/app-server/protocol-generated/typescript/v2/ThreadUnarchivedNotification.ts +5 -0
  509. package/src/app-server/protocol-generated/typescript/v2/ThreadUnsubscribeParams.ts +5 -0
  510. package/src/app-server/protocol-generated/typescript/v2/ThreadUnsubscribeResponse.ts +6 -0
  511. package/src/app-server/protocol-generated/typescript/v2/ThreadUnsubscribeStatus.ts +5 -0
  512. package/src/app-server/protocol-generated/typescript/v2/TokenUsageBreakdown.ts +11 -0
  513. package/src/app-server/protocol-generated/typescript/v2/ToolRequestUserInputAnswer.ts +8 -0
  514. package/src/app-server/protocol-generated/typescript/v2/ToolRequestUserInputOption.ts +8 -0
  515. package/src/app-server/protocol-generated/typescript/v2/ToolRequestUserInputParams.ts +14 -0
  516. package/src/app-server/protocol-generated/typescript/v2/ToolRequestUserInputQuestion.ts +16 -0
  517. package/src/app-server/protocol-generated/typescript/v2/ToolRequestUserInputResponse.ts +11 -0
  518. package/src/app-server/protocol-generated/typescript/v2/ToolsV2.ts +6 -0
  519. package/src/app-server/protocol-generated/typescript/v2/Turn.ts +33 -0
  520. package/src/app-server/protocol-generated/typescript/v2/TurnCompletedNotification.ts +6 -0
  521. package/src/app-server/protocol-generated/typescript/v2/TurnDiffUpdatedNotification.ts +9 -0
  522. package/src/app-server/protocol-generated/typescript/v2/TurnEnvironmentParams.ts +6 -0
  523. package/src/app-server/protocol-generated/typescript/v2/TurnError.ts +10 -0
  524. package/src/app-server/protocol-generated/typescript/v2/TurnInterruptParams.ts +5 -0
  525. package/src/app-server/protocol-generated/typescript/v2/TurnInterruptResponse.ts +5 -0
  526. package/src/app-server/protocol-generated/typescript/v2/TurnPlanStep.ts +6 -0
  527. package/src/app-server/protocol-generated/typescript/v2/TurnPlanStepStatus.ts +5 -0
  528. package/src/app-server/protocol-generated/typescript/v2/TurnPlanUpdatedNotification.ts +11 -0
  529. package/src/app-server/protocol-generated/typescript/v2/TurnStartParams.ts +62 -0
  530. package/src/app-server/protocol-generated/typescript/v2/TurnStartResponse.ts +6 -0
  531. package/src/app-server/protocol-generated/typescript/v2/TurnStartedNotification.ts +6 -0
  532. package/src/app-server/protocol-generated/typescript/v2/TurnStatus.ts +5 -0
  533. package/src/app-server/protocol-generated/typescript/v2/TurnSteerParams.ts +13 -0
  534. package/src/app-server/protocol-generated/typescript/v2/TurnSteerResponse.ts +5 -0
  535. package/src/app-server/protocol-generated/typescript/v2/UserInput.ts +18 -0
  536. package/src/app-server/protocol-generated/typescript/v2/WarningNotification.ts +14 -0
  537. package/src/app-server/protocol-generated/typescript/v2/WebSearchAction.ts +9 -0
  538. package/src/app-server/protocol-generated/typescript/v2/WindowsSandboxSetupCompletedNotification.ts +10 -0
  539. package/src/app-server/protocol-generated/typescript/v2/WindowsSandboxSetupMode.ts +5 -0
  540. package/src/app-server/protocol-generated/typescript/v2/WindowsSandboxSetupStartParams.ts +10 -0
  541. package/src/app-server/protocol-generated/typescript/v2/WindowsSandboxSetupStartResponse.ts +5 -0
  542. package/src/app-server/protocol-generated/typescript/v2/WindowsWorldWritableWarningNotification.ts +9 -0
  543. package/src/app-server/protocol-generated/typescript/v2/WriteStatus.ts +5 -0
  544. package/src/app-server/protocol-generated/typescript/v2/index.ts +410 -0
  545. package/src/app-server/protocol-validators.ts +167 -0
  546. package/src/app-server/protocol.ts +110 -0
  547. package/src/app-server/request.ts +45 -0
  548. package/src/app-server/run-attempt.context-engine.test.ts +420 -0
  549. package/src/app-server/run-attempt.test.ts +2225 -0
  550. package/src/app-server/run-attempt.ts +1641 -0
  551. package/src/app-server/run-attempt.vision-tools.test.ts +35 -0
  552. package/src/app-server/schema-normalization-runtime-contract.test.ts +168 -0
  553. package/src/app-server/session-binding.test.ts +52 -0
  554. package/src/app-server/session-binding.ts +131 -0
  555. package/src/app-server/session-history.ts +44 -0
  556. package/src/app-server/shared-client.test.ts +368 -0
  557. package/src/app-server/shared-client.ts +157 -0
  558. package/src/app-server/test-support.ts +48 -0
  559. package/src/app-server/thread-lifecycle.test.ts +59 -0
  560. package/src/app-server/thread-lifecycle.ts +311 -0
  561. package/src/app-server/timeout.ts +22 -0
  562. package/src/app-server/trajectory.test.ts +155 -0
  563. package/src/app-server/trajectory.ts +433 -0
  564. package/src/app-server/transcript-mirror.test.ts +265 -0
  565. package/src/app-server/transcript-mirror.ts +308 -0
  566. package/src/app-server/transcript-repair-runtime-contract.test.ts +44 -0
  567. package/src/app-server/transport-stdio.test.ts +171 -0
  568. package/src/app-server/transport-stdio.ts +107 -0
  569. package/src/app-server/transport-websocket.test.ts +71 -0
  570. package/src/app-server/transport-websocket.ts +90 -0
  571. package/src/app-server/transport.ts +117 -0
  572. package/src/app-server/user-input-bridge.test.ts +137 -0
  573. package/src/app-server/user-input-bridge.ts +294 -0
  574. package/src/app-server/version.ts +3 -0
  575. package/src/app-server/vision-tools.ts +12 -0
  576. package/src/command-formatters.ts +204 -0
  577. package/src/command-handlers.ts +1559 -0
  578. package/src/command-rpc.test.ts +16 -0
  579. package/src/command-rpc.ts +97 -0
  580. package/src/commands.test.ts +1716 -0
  581. package/src/commands.ts +32 -0
  582. package/src/conversation-binding-data.ts +72 -0
  583. package/src/conversation-binding.test.ts +76 -0
  584. package/src/conversation-binding.ts +351 -0
  585. package/src/conversation-control.test.ts +50 -0
  586. package/src/conversation-control.ts +255 -0
  587. package/src/conversation-turn-collector.test.ts +154 -0
  588. package/src/conversation-turn-collector.ts +158 -0
  589. package/src/conversation-turn-input.test.ts +44 -0
  590. package/src/conversation-turn-input.ts +80 -0
  591. package/src/manifest.test.ts +20 -0
  592. package/src/migration/apply.ts +43 -0
  593. package/src/migration/helpers.ts +60 -0
  594. package/src/migration/plan.ts +148 -0
  595. package/src/migration/provider.test.ts +219 -0
  596. package/src/migration/provider.ts +28 -0
  597. package/src/migration/source.ts +176 -0
  598. package/src/migration/targets.ts +25 -0
  599. package/tsconfig.json +16 -0
@@ -0,0 +1,433 @@
1
+ import nodeFs from "node:fs";
2
+ import fs from "node:fs/promises";
3
+ import path from "node:path";
4
+ import type {
5
+ EmbeddedRunAttemptParams,
6
+ EmbeddedRunAttemptResult,
7
+ } from "openclaw/plugin-sdk/agent-harness";
8
+ import { resolveUserPath } from "openclaw/plugin-sdk/agent-harness";
9
+
10
+ type CodexTrajectoryRecorder = {
11
+ filePath: string;
12
+ recordEvent: (type: string, data?: Record<string, unknown>) => void;
13
+ flush: () => Promise<void>;
14
+ };
15
+
16
+ type CodexTrajectoryInit = {
17
+ attempt: EmbeddedRunAttemptParams;
18
+ cwd: string;
19
+ developerInstructions?: string;
20
+ prompt?: string;
21
+ tools?: Array<{ name?: string; description?: string; inputSchema?: unknown }>;
22
+ env?: NodeJS.ProcessEnv;
23
+ };
24
+
25
+ const SENSITIVE_FIELD_RE = /(?:authorization|cookie|credential|key|password|passwd|secret|token)/iu;
26
+ const PRIVATE_PAYLOAD_FIELD_RE = /(?:image|screenshot|attachment|fileData|dataUri)/iu;
27
+ const AUTHORIZATION_VALUE_RE = /\b(Bearer|Basic)\s+[A-Za-z0-9+/._~=-]{8,}/giu;
28
+ const JWT_VALUE_RE = /\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\b/gu;
29
+ const COOKIE_PAIR_RE = /\b([A-Za-z][A-Za-z0-9_.-]{1,64})=([A-Za-z0-9+/._~%=-]{16,})(?=;|\s|$)/gu;
30
+ const TRAJECTORY_RUNTIME_FILE_MAX_BYTES = 50 * 1024 * 1024;
31
+ const TRAJECTORY_RUNTIME_EVENT_MAX_BYTES = 256 * 1024;
32
+
33
+ type CodexTrajectoryOpenFlagConstants = Pick<
34
+ typeof nodeFs.constants,
35
+ "O_APPEND" | "O_CREAT" | "O_TRUNC" | "O_WRONLY"
36
+ > &
37
+ Partial<Pick<typeof nodeFs.constants, "O_NOFOLLOW">>;
38
+
39
+ export function resolveCodexTrajectoryAppendFlags(
40
+ constants: CodexTrajectoryOpenFlagConstants = nodeFs.constants,
41
+ ): number {
42
+ const noFollow = constants.O_NOFOLLOW;
43
+ return (
44
+ constants.O_CREAT |
45
+ constants.O_APPEND |
46
+ constants.O_WRONLY |
47
+ (typeof noFollow === "number" ? noFollow : 0)
48
+ );
49
+ }
50
+
51
+ export function resolveCodexTrajectoryPointerFlags(
52
+ constants: CodexTrajectoryOpenFlagConstants = nodeFs.constants,
53
+ ): number {
54
+ const noFollow = constants.O_NOFOLLOW;
55
+ return (
56
+ constants.O_CREAT |
57
+ constants.O_TRUNC |
58
+ constants.O_WRONLY |
59
+ (typeof noFollow === "number" ? noFollow : 0)
60
+ );
61
+ }
62
+
63
+ async function assertNoSymlinkParents(filePath: string): Promise<void> {
64
+ const resolvedDir = path.resolve(path.dirname(filePath));
65
+ const parsed = path.parse(resolvedDir);
66
+ const relativeParts = path.relative(parsed.root, resolvedDir).split(path.sep).filter(Boolean);
67
+ let current = parsed.root;
68
+ for (const part of relativeParts) {
69
+ current = path.join(current, part);
70
+ const stat = await fs.lstat(current);
71
+ if (stat.isSymbolicLink()) {
72
+ if (path.dirname(current) === parsed.root) {
73
+ continue;
74
+ }
75
+ throw new Error(`Refusing to write trajectory under symlinked directory: ${current}`);
76
+ }
77
+ if (!stat.isDirectory()) {
78
+ throw new Error(`Refusing to write trajectory under non-directory: ${current}`);
79
+ }
80
+ }
81
+ }
82
+
83
+ function verifyStableOpenedTrajectoryFile(params: {
84
+ preOpenStat?: nodeFs.Stats;
85
+ postOpenStat: nodeFs.Stats;
86
+ filePath: string;
87
+ }): void {
88
+ if (!params.postOpenStat.isFile()) {
89
+ throw new Error(`Refusing to write trajectory to non-file: ${params.filePath}`);
90
+ }
91
+ if (params.postOpenStat.nlink > 1) {
92
+ throw new Error(`Refusing to write trajectory to hardlinked file: ${params.filePath}`);
93
+ }
94
+ const pre = params.preOpenStat;
95
+ if (pre && (pre.dev !== params.postOpenStat.dev || pre.ino !== params.postOpenStat.ino)) {
96
+ throw new Error(`Refusing to write trajectory after file changed: ${params.filePath}`);
97
+ }
98
+ }
99
+
100
+ async function safeAppendTrajectoryFile(filePath: string, line: string): Promise<void> {
101
+ await assertNoSymlinkParents(filePath);
102
+
103
+ let preOpenStat: nodeFs.Stats | undefined;
104
+ try {
105
+ const stat = await fs.lstat(filePath);
106
+ if (stat.isSymbolicLink()) {
107
+ throw new Error(`Refusing to write trajectory through symlink: ${filePath}`);
108
+ }
109
+ if (!stat.isFile()) {
110
+ throw new Error(`Refusing to write trajectory to non-file: ${filePath}`);
111
+ }
112
+ preOpenStat = stat;
113
+ } catch (err) {
114
+ if ((err as NodeJS.ErrnoException).code !== "ENOENT") {
115
+ throw err;
116
+ }
117
+ }
118
+ const lineBytes = Buffer.byteLength(line, "utf8");
119
+ if ((preOpenStat?.size ?? 0) + lineBytes > TRAJECTORY_RUNTIME_FILE_MAX_BYTES) {
120
+ return;
121
+ }
122
+
123
+ const handle = await fs.open(filePath, resolveCodexTrajectoryAppendFlags(), 0o600);
124
+ try {
125
+ const stat = await handle.stat();
126
+ verifyStableOpenedTrajectoryFile({ preOpenStat, postOpenStat: stat, filePath });
127
+ if (stat.size + lineBytes > TRAJECTORY_RUNTIME_FILE_MAX_BYTES) {
128
+ return;
129
+ }
130
+ await handle.chmod(0o600);
131
+ await handle.appendFile(line, "utf8");
132
+ } finally {
133
+ await handle.close();
134
+ }
135
+ }
136
+
137
+ function boundedTrajectoryLine(event: Record<string, unknown>): string | undefined {
138
+ const line = JSON.stringify(event);
139
+ const bytes = Buffer.byteLength(line, "utf8");
140
+ if (bytes <= TRAJECTORY_RUNTIME_EVENT_MAX_BYTES) {
141
+ return `${line}\n`;
142
+ }
143
+ const truncated = JSON.stringify({
144
+ ...event,
145
+ data: {
146
+ truncated: true,
147
+ originalBytes: bytes,
148
+ limitBytes: TRAJECTORY_RUNTIME_EVENT_MAX_BYTES,
149
+ reason: "trajectory-event-size-limit",
150
+ },
151
+ });
152
+ if (Buffer.byteLength(truncated, "utf8") <= TRAJECTORY_RUNTIME_EVENT_MAX_BYTES) {
153
+ return `${truncated}\n`;
154
+ }
155
+ return undefined;
156
+ }
157
+
158
+ function resolveTrajectoryPointerFilePath(sessionFile: string): string {
159
+ return sessionFile.endsWith(".jsonl")
160
+ ? `${sessionFile.slice(0, -".jsonl".length)}.trajectory-path.json`
161
+ : `${sessionFile}.trajectory-path.json`;
162
+ }
163
+
164
+ function writeTrajectoryPointerBestEffort(params: {
165
+ filePath: string;
166
+ sessionFile: string;
167
+ sessionId: string;
168
+ }): void {
169
+ const pointerPath = resolveTrajectoryPointerFilePath(params.sessionFile);
170
+ try {
171
+ const pointerDir = path.resolve(path.dirname(pointerPath));
172
+ if (nodeFs.lstatSync(pointerDir).isSymbolicLink()) {
173
+ return;
174
+ }
175
+ try {
176
+ if (nodeFs.lstatSync(pointerPath).isSymbolicLink()) {
177
+ return;
178
+ }
179
+ } catch (error) {
180
+ if ((error as NodeJS.ErrnoException).code !== "ENOENT") {
181
+ return;
182
+ }
183
+ }
184
+ const fd = nodeFs.openSync(pointerPath, resolveCodexTrajectoryPointerFlags(), 0o600);
185
+ try {
186
+ nodeFs.writeFileSync(
187
+ fd,
188
+ `${JSON.stringify(
189
+ {
190
+ traceSchema: "openclaw-trajectory-pointer",
191
+ schemaVersion: 1,
192
+ sessionId: params.sessionId,
193
+ runtimeFile: params.filePath,
194
+ },
195
+ null,
196
+ 2,
197
+ )}\n`,
198
+ "utf8",
199
+ );
200
+ nodeFs.fchmodSync(fd, 0o600);
201
+ } finally {
202
+ nodeFs.closeSync(fd);
203
+ }
204
+ } catch {
205
+ // Pointer files are best-effort; the runtime sidecar itself is authoritative.
206
+ }
207
+ }
208
+
209
+ export function createCodexTrajectoryRecorder(
210
+ params: CodexTrajectoryInit,
211
+ ): CodexTrajectoryRecorder | null {
212
+ const env = params.env ?? process.env;
213
+ const enabled = parseTrajectoryEnabled(env);
214
+ if (!enabled) {
215
+ return null;
216
+ }
217
+
218
+ const filePath = resolveTrajectoryFilePath({
219
+ env,
220
+ sessionFile: params.attempt.sessionFile,
221
+ sessionId: params.attempt.sessionId,
222
+ });
223
+ const ready = fs
224
+ .mkdir(path.dirname(filePath), { recursive: true, mode: 0o700 })
225
+ .catch(() => undefined);
226
+ writeTrajectoryPointerBestEffort({
227
+ filePath,
228
+ sessionFile: params.attempt.sessionFile,
229
+ sessionId: params.attempt.sessionId,
230
+ });
231
+ let queue = Promise.resolve();
232
+ let seq = 0;
233
+
234
+ return {
235
+ filePath,
236
+ recordEvent: (type, data) => {
237
+ const event = {
238
+ traceSchema: "openclaw-trajectory",
239
+ schemaVersion: 1,
240
+ traceId: params.attempt.sessionId,
241
+ source: "runtime",
242
+ type,
243
+ ts: new Date().toISOString(),
244
+ seq: (seq += 1),
245
+ sourceSeq: seq,
246
+ sessionId: params.attempt.sessionId,
247
+ sessionKey: params.attempt.sessionKey,
248
+ runId: params.attempt.runId,
249
+ workspaceDir: params.cwd,
250
+ provider: params.attempt.provider,
251
+ modelId: params.attempt.modelId,
252
+ modelApi: params.attempt.model.api,
253
+ data: data ? sanitizeValue(data) : undefined,
254
+ };
255
+ const line = boundedTrajectoryLine(event);
256
+ if (!line) {
257
+ return;
258
+ }
259
+ queue = queue
260
+ .then(() => ready)
261
+ .then(() => safeAppendTrajectoryFile(filePath, line))
262
+ .catch(() => undefined);
263
+ },
264
+ flush: async () => {
265
+ await queue;
266
+ },
267
+ };
268
+ }
269
+
270
+ export function recordCodexTrajectoryContext(
271
+ recorder: CodexTrajectoryRecorder | null,
272
+ params: CodexTrajectoryInit,
273
+ ): void {
274
+ if (!recorder) {
275
+ return;
276
+ }
277
+ recorder.recordEvent("context.compiled", {
278
+ systemPrompt: params.developerInstructions,
279
+ prompt: params.prompt ?? params.attempt.prompt,
280
+ imagesCount: params.attempt.images?.length ?? 0,
281
+ tools: toTrajectoryToolDefinitions(params.tools),
282
+ });
283
+ }
284
+
285
+ export function recordCodexTrajectoryCompletion(
286
+ recorder: CodexTrajectoryRecorder | null,
287
+ params: {
288
+ attempt: EmbeddedRunAttemptParams;
289
+ result: EmbeddedRunAttemptResult;
290
+ threadId: string;
291
+ turnId: string;
292
+ timedOut: boolean;
293
+ yieldDetected?: boolean;
294
+ },
295
+ ): void {
296
+ if (!recorder) {
297
+ return;
298
+ }
299
+ recorder.recordEvent("model.completed", {
300
+ threadId: params.threadId,
301
+ turnId: params.turnId,
302
+ timedOut: params.timedOut,
303
+ yieldDetected: params.yieldDetected ?? false,
304
+ aborted: params.result.aborted,
305
+ promptError: normalizeCodexTrajectoryError(params.result.promptError),
306
+ usage: params.result.attemptUsage,
307
+ assistantTexts: params.result.assistantTexts,
308
+ messagesSnapshot: params.result.messagesSnapshot,
309
+ });
310
+ }
311
+
312
+ function parseTrajectoryEnabled(env: NodeJS.ProcessEnv): boolean {
313
+ const value = env.OPENCLAW_TRAJECTORY?.trim().toLowerCase();
314
+ if (value === "1" || value === "true" || value === "yes" || value === "on") {
315
+ return true;
316
+ }
317
+ if (value === "0" || value === "false" || value === "no" || value === "off") {
318
+ return false;
319
+ }
320
+ return true;
321
+ }
322
+
323
+ function resolveTrajectoryFilePath(params: {
324
+ env: NodeJS.ProcessEnv;
325
+ sessionFile: string;
326
+ sessionId: string;
327
+ }): string {
328
+ const dirOverride = params.env.OPENCLAW_TRAJECTORY_DIR?.trim();
329
+ if (dirOverride) {
330
+ return resolveContainedPath(
331
+ resolveUserPath(dirOverride),
332
+ `${safeTrajectorySessionFileName(params.sessionId)}.jsonl`,
333
+ );
334
+ }
335
+ return params.sessionFile.endsWith(".jsonl")
336
+ ? `${params.sessionFile.slice(0, -".jsonl".length)}.trajectory.jsonl`
337
+ : `${params.sessionFile}.trajectory.jsonl`;
338
+ }
339
+
340
+ function safeTrajectorySessionFileName(sessionId: string): string {
341
+ const safe = sessionId.replaceAll(/[^A-Za-z0-9_-]/g, "_").slice(0, 120);
342
+ return /[A-Za-z0-9]/u.test(safe) ? safe : "session";
343
+ }
344
+
345
+ function resolveContainedPath(baseDir: string, fileName: string): string {
346
+ const resolvedBase = path.resolve(baseDir);
347
+ const resolvedFile = path.resolve(resolvedBase, fileName);
348
+ const relative = path.relative(resolvedBase, resolvedFile);
349
+ if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) {
350
+ throw new Error("Trajectory file path escaped its configured directory");
351
+ }
352
+ return resolvedFile;
353
+ }
354
+
355
+ function toTrajectoryToolDefinitions(
356
+ tools: Array<{ name?: string; description?: string; inputSchema?: unknown }> | undefined,
357
+ ): Array<{ name: string; description?: string; parameters?: unknown }> | undefined {
358
+ if (!tools || tools.length === 0) {
359
+ return undefined;
360
+ }
361
+ return tools
362
+ .flatMap((tool) => {
363
+ const name = tool.name?.trim();
364
+ if (!name) {
365
+ return [];
366
+ }
367
+ return [
368
+ {
369
+ name,
370
+ description: tool.description,
371
+ parameters: sanitizeValue(tool.inputSchema),
372
+ },
373
+ ];
374
+ })
375
+ .toSorted((left, right) => left.name.localeCompare(right.name));
376
+ }
377
+
378
+ function sanitizeValue(value: unknown, depth = 0, key = ""): unknown {
379
+ if (value == null || typeof value === "boolean" || typeof value === "number") {
380
+ return value;
381
+ }
382
+ if (typeof value === "string") {
383
+ if (SENSITIVE_FIELD_RE.test(key)) {
384
+ return "<redacted>";
385
+ }
386
+ if (value.startsWith("data:") && value.length > 256) {
387
+ return `<redacted data-uri ${value.slice(0, value.indexOf(",")).length} chars>`;
388
+ }
389
+ if (PRIVATE_PAYLOAD_FIELD_RE.test(key) && value.length > 256) {
390
+ return "<redacted payload>";
391
+ }
392
+ const redacted = redactSensitiveString(value);
393
+ return redacted.length > 20_000 ? `${redacted.slice(0, 20_000)}…` : redacted;
394
+ }
395
+ if (depth >= 6) {
396
+ return "<truncated>";
397
+ }
398
+ if (Array.isArray(value)) {
399
+ return value.slice(0, 100).map((entry) => sanitizeValue(entry, depth + 1, key));
400
+ }
401
+ if (typeof value === "object") {
402
+ const next: Record<string, unknown> = {};
403
+ for (const [key, child] of Object.entries(value).slice(0, 100)) {
404
+ next[key] = sanitizeValue(child, depth + 1, key);
405
+ }
406
+ return next;
407
+ }
408
+ return JSON.stringify(value);
409
+ }
410
+
411
+ function redactSensitiveString(value: string): string {
412
+ return value
413
+ .replace(AUTHORIZATION_VALUE_RE, "$1 <redacted>")
414
+ .replace(JWT_VALUE_RE, "<redacted-jwt>")
415
+ .replace(COOKIE_PAIR_RE, "$1=<redacted>");
416
+ }
417
+
418
+ export function normalizeCodexTrajectoryError(value: unknown): string | null {
419
+ if (!value) {
420
+ return null;
421
+ }
422
+ if (value instanceof Error) {
423
+ return value.message;
424
+ }
425
+ if (typeof value === "string") {
426
+ return value;
427
+ }
428
+ try {
429
+ return JSON.stringify(value);
430
+ } catch {
431
+ return "Unknown error";
432
+ }
433
+ }
@@ -0,0 +1,265 @@
1
+ import fs from "node:fs/promises";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import {
5
+ initializeGlobalHookRunner,
6
+ resetGlobalHookRunner,
7
+ } from "openclaw/plugin-sdk/hook-runtime";
8
+ import { createMockPluginRegistry } from "openclaw/plugin-sdk/plugin-test-runtime";
9
+ import {
10
+ castAgentMessage,
11
+ makeAgentAssistantMessage,
12
+ makeAgentUserMessage,
13
+ } from "openclaw/plugin-sdk/test-fixtures";
14
+ import { afterEach, describe, expect, it } from "vitest";
15
+ import { mirrorCodexAppServerTranscript } from "./transcript-mirror.js";
16
+
17
+ const tempDirs: string[] = [];
18
+
19
+ afterEach(async () => {
20
+ resetGlobalHookRunner();
21
+ for (const dir of tempDirs.splice(0)) {
22
+ await fs.rm(dir, { recursive: true, force: true });
23
+ }
24
+ });
25
+
26
+ async function createTempSessionFile() {
27
+ const dir = await fs.mkdtemp(path.join(os.tmpdir(), "openclaw-codex-transcript-"));
28
+ tempDirs.push(dir);
29
+ return path.join(dir, "session.jsonl");
30
+ }
31
+
32
+ async function makeRoot(prefix: string): Promise<string> {
33
+ const root = await fs.mkdtemp(path.join(os.tmpdir(), prefix));
34
+ tempDirs.push(root);
35
+ return root;
36
+ }
37
+
38
+ describe("mirrorCodexAppServerTranscript", () => {
39
+ it("mirrors user and assistant messages into the Pi transcript", async () => {
40
+ const sessionFile = await createTempSessionFile();
41
+
42
+ await mirrorCodexAppServerTranscript({
43
+ sessionFile,
44
+ sessionKey: "session-1",
45
+ messages: [
46
+ makeAgentUserMessage({
47
+ content: [{ type: "text", text: "hello" }],
48
+ timestamp: Date.now(),
49
+ }),
50
+ makeAgentAssistantMessage({
51
+ content: [{ type: "text", text: "hi there" }],
52
+ timestamp: Date.now() + 1,
53
+ }),
54
+ ],
55
+ idempotencyScope: "scope-1",
56
+ });
57
+
58
+ const raw = await fs.readFile(sessionFile, "utf8");
59
+ expect(raw).toContain('"role":"user"');
60
+ expect(raw).toContain('"content":[{"type":"text","text":"hello"}]');
61
+ expect(raw).toContain('"role":"assistant"');
62
+ expect(raw).toContain('"content":[{"type":"text","text":"hi there"}]');
63
+ expect(raw).toContain('"idempotencyKey":"scope-1:user:0"');
64
+ expect(raw).toContain('"idempotencyKey":"scope-1:assistant:1"');
65
+ });
66
+
67
+ it("creates the transcript directory on first mirror", async () => {
68
+ const root = await makeRoot("openclaw-codex-transcript-missing-dir-");
69
+ const sessionFile = path.join(root, "nested", "sessions", "session.jsonl");
70
+
71
+ await mirrorCodexAppServerTranscript({
72
+ sessionFile,
73
+ sessionKey: "session-1",
74
+ messages: [
75
+ makeAgentAssistantMessage({
76
+ content: [{ type: "text", text: "first mirror" }],
77
+ timestamp: Date.now(),
78
+ }),
79
+ ],
80
+ idempotencyScope: "scope-1",
81
+ });
82
+
83
+ const raw = await fs.readFile(sessionFile, "utf8");
84
+ expect(raw).toContain('"role":"assistant"');
85
+ expect(raw).toContain('"content":[{"type":"text","text":"first mirror"}]');
86
+ });
87
+
88
+ it("deduplicates app-server turn mirrors by idempotency scope", async () => {
89
+ const sessionFile = await createTempSessionFile();
90
+ const messages = [
91
+ makeAgentUserMessage({
92
+ content: [{ type: "text", text: "hello" }],
93
+ timestamp: Date.now(),
94
+ }),
95
+ makeAgentAssistantMessage({
96
+ content: [{ type: "text", text: "hi there" }],
97
+ timestamp: Date.now() + 1,
98
+ }),
99
+ ] as const;
100
+
101
+ await mirrorCodexAppServerTranscript({
102
+ sessionFile,
103
+ sessionKey: "session-1",
104
+ messages: [...messages],
105
+ idempotencyScope: "scope-1",
106
+ });
107
+ await mirrorCodexAppServerTranscript({
108
+ sessionFile,
109
+ sessionKey: "session-1",
110
+ messages: [...messages],
111
+ idempotencyScope: "scope-1",
112
+ });
113
+
114
+ const records = (await fs.readFile(sessionFile, "utf8"))
115
+ .trim()
116
+ .split("\n")
117
+ .filter(Boolean)
118
+ .map((line) => JSON.parse(line) as { type?: string; message?: { role?: string } });
119
+ expect(records.slice(1)).toHaveLength(2);
120
+ });
121
+
122
+ it("runs before_message_write before appending mirrored transcript messages", async () => {
123
+ initializeGlobalHookRunner(
124
+ createMockPluginRegistry([
125
+ {
126
+ hookName: "before_message_write",
127
+ handler: (event) => ({
128
+ message: castAgentMessage({
129
+ ...((event as { message: unknown }).message as Record<string, unknown>),
130
+ content: [{ type: "text", text: "hello [hooked]" }],
131
+ }),
132
+ }),
133
+ },
134
+ ]),
135
+ );
136
+ const sessionFile = await createTempSessionFile();
137
+
138
+ await mirrorCodexAppServerTranscript({
139
+ sessionFile,
140
+ sessionKey: "session-1",
141
+ messages: [
142
+ makeAgentAssistantMessage({
143
+ content: [{ type: "text", text: "hello" }],
144
+ timestamp: Date.now(),
145
+ }),
146
+ ],
147
+ idempotencyScope: "scope-1",
148
+ });
149
+
150
+ const raw = await fs.readFile(sessionFile, "utf8");
151
+ expect(raw).toContain('"content":[{"type":"text","text":"hello [hooked]"}]');
152
+ expect(raw).toContain('"idempotencyKey":"scope-1:assistant:0"');
153
+ });
154
+
155
+ it("preserves the computed idempotency key when hooks rewrite message keys", async () => {
156
+ initializeGlobalHookRunner(
157
+ createMockPluginRegistry([
158
+ {
159
+ hookName: "before_message_write",
160
+ handler: (event) => ({
161
+ message: castAgentMessage({
162
+ ...((event as { message: unknown }).message as Record<string, unknown>),
163
+ idempotencyKey: "hook-rewritten-key",
164
+ }),
165
+ }),
166
+ },
167
+ ]),
168
+ );
169
+ const sessionFile = await createTempSessionFile();
170
+
171
+ await mirrorCodexAppServerTranscript({
172
+ sessionFile,
173
+ sessionKey: "session-1",
174
+ messages: [
175
+ makeAgentAssistantMessage({
176
+ content: [{ type: "text", text: "hello" }],
177
+ timestamp: Date.now(),
178
+ }),
179
+ ],
180
+ idempotencyScope: "scope-1",
181
+ });
182
+
183
+ const raw = await fs.readFile(sessionFile, "utf8");
184
+ expect(raw).toContain('"idempotencyKey":"scope-1:assistant:0"');
185
+ expect(raw).not.toContain("hook-rewritten-key");
186
+ });
187
+
188
+ it("respects before_message_write blocking decisions", async () => {
189
+ initializeGlobalHookRunner(
190
+ createMockPluginRegistry([
191
+ {
192
+ hookName: "before_message_write",
193
+ handler: () => ({ block: true }),
194
+ },
195
+ ]),
196
+ );
197
+ const sessionFile = await createTempSessionFile();
198
+
199
+ await mirrorCodexAppServerTranscript({
200
+ sessionFile,
201
+ sessionKey: "session-1",
202
+ messages: [
203
+ makeAgentAssistantMessage({
204
+ content: [{ type: "text", text: "should not persist" }],
205
+ timestamp: Date.now(),
206
+ }),
207
+ ],
208
+ idempotencyScope: "scope-1",
209
+ });
210
+
211
+ await expect(fs.readFile(sessionFile, "utf8")).rejects.toMatchObject({ code: "ENOENT" });
212
+ });
213
+
214
+ it("migrates small linear transcripts before mirroring", async () => {
215
+ const sessionFile = await createTempSessionFile();
216
+ await fs.writeFile(
217
+ sessionFile,
218
+ [
219
+ JSON.stringify({
220
+ type: "session",
221
+ version: 3,
222
+ id: "linear-codex-session",
223
+ timestamp: new Date().toISOString(),
224
+ cwd: process.cwd(),
225
+ }),
226
+ JSON.stringify({
227
+ type: "message",
228
+ id: "legacy-user",
229
+ timestamp: new Date().toISOString(),
230
+ message: { role: "user", content: "legacy user" },
231
+ }),
232
+ ].join("\n") + "\n",
233
+ "utf8",
234
+ );
235
+
236
+ await mirrorCodexAppServerTranscript({
237
+ sessionFile,
238
+ sessionKey: "session-1",
239
+ messages: [
240
+ makeAgentAssistantMessage({
241
+ content: [{ type: "text", text: "mirrored assistant" }],
242
+ timestamp: Date.now(),
243
+ }),
244
+ ],
245
+ idempotencyScope: "scope-1",
246
+ });
247
+
248
+ const records = (await fs.readFile(sessionFile, "utf8"))
249
+ .trim()
250
+ .split("\n")
251
+ .map(
252
+ (line) =>
253
+ JSON.parse(line) as {
254
+ type?: string;
255
+ id?: string;
256
+ parentId?: string | null;
257
+ message?: { role?: string };
258
+ },
259
+ )
260
+ .filter((record) => record.type === "message");
261
+
262
+ expect(records[0]).toMatchObject({ id: "legacy-user", parentId: null });
263
+ expect(records[1]).toMatchObject({ parentId: "legacy-user" });
264
+ });
265
+ });