@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,781 @@
1
+ import type { AgentToolResult } from "@mariozechner/pi-agent-core";
2
+ import type { AnyAgentTool } from "openclaw/plugin-sdk/agent-harness";
3
+ import {
4
+ HEARTBEAT_RESPONSE_TOOL_NAME,
5
+ wrapToolWithBeforeToolCallHook,
6
+ } from "openclaw/plugin-sdk/agent-harness-runtime";
7
+ import {
8
+ initializeGlobalHookRunner,
9
+ resetGlobalHookRunner,
10
+ } from "openclaw/plugin-sdk/hook-runtime";
11
+ import {
12
+ createEmptyPluginRegistry,
13
+ createMockPluginRegistry,
14
+ setActivePluginRegistry,
15
+ } from "openclaw/plugin-sdk/plugin-test-runtime";
16
+ import { afterEach, describe, expect, it, vi } from "vitest";
17
+ import { createCodexDynamicToolBridge } from "./dynamic-tools.js";
18
+ import type { JsonValue } from "./protocol.js";
19
+
20
+ function createTool(overrides: Partial<AnyAgentTool>): AnyAgentTool {
21
+ return {
22
+ name: "tts",
23
+ description: "Convert text to speech.",
24
+ parameters: { type: "object", properties: {} },
25
+ execute: vi.fn(),
26
+ ...overrides,
27
+ } as unknown as AnyAgentTool;
28
+ }
29
+
30
+ function mediaResult(mediaUrl: string, audioAsVoice?: boolean): AgentToolResult<unknown> {
31
+ return {
32
+ content: [{ type: "text", text: "Generated media reply." }],
33
+ details: {
34
+ media: {
35
+ mediaUrl,
36
+ ...(audioAsVoice === true ? { audioAsVoice: true } : {}),
37
+ },
38
+ },
39
+ };
40
+ }
41
+
42
+ function textToolResult(text: string, details: unknown = {}): AgentToolResult<unknown> {
43
+ return {
44
+ content: [{ type: "text", text }],
45
+ details,
46
+ };
47
+ }
48
+
49
+ function createBridgeWithToolResult(toolName: string, toolResult: AgentToolResult<unknown>) {
50
+ return createCodexDynamicToolBridge({
51
+ tools: [
52
+ createTool({
53
+ name: toolName,
54
+ execute: vi.fn(async () => toolResult),
55
+ }),
56
+ ],
57
+ signal: new AbortController().signal,
58
+ });
59
+ }
60
+
61
+ function expectInputText(text: string) {
62
+ return {
63
+ success: true,
64
+ contentItems: [{ type: "inputText", text }],
65
+ };
66
+ }
67
+
68
+ async function handleMessageToolCall(
69
+ bridge: ReturnType<typeof createCodexDynamicToolBridge>,
70
+ arguments_: JsonValue,
71
+ ) {
72
+ return await bridge.handleToolCall({
73
+ threadId: "thread-1",
74
+ turnId: "turn-1",
75
+ callId: "call-1",
76
+ namespace: null,
77
+ tool: "message",
78
+ arguments: arguments_,
79
+ });
80
+ }
81
+
82
+ afterEach(() => {
83
+ resetGlobalHookRunner();
84
+ setActivePluginRegistry(createEmptyPluginRegistry());
85
+ });
86
+
87
+ describe("createCodexDynamicToolBridge", () => {
88
+ it.each([
89
+ { toolName: "tts", mediaUrl: "/tmp/reply.opus", audioAsVoice: true },
90
+ { toolName: "image_generate", mediaUrl: "/tmp/generated.png" },
91
+ { toolName: "video_generate", mediaUrl: "https://media.example/video.mp4" },
92
+ { toolName: "music_generate", mediaUrl: "https://media.example/music.wav" },
93
+ ])(
94
+ "preserves structured media artifacts from $toolName tool results",
95
+ async ({ toolName, mediaUrl, audioAsVoice }) => {
96
+ const bridge = createBridgeWithToolResult(toolName, mediaResult(mediaUrl, audioAsVoice));
97
+
98
+ const result = await bridge.handleToolCall({
99
+ threadId: "thread-1",
100
+ turnId: "turn-1",
101
+ callId: "call-1",
102
+ namespace: null,
103
+ tool: toolName,
104
+ arguments: { prompt: "hello" },
105
+ });
106
+
107
+ expect(result).toEqual(expectInputText("Generated media reply."));
108
+ expect(bridge.telemetry.toolMediaUrls).toEqual([mediaUrl]);
109
+ expect(bridge.telemetry.toolAudioAsVoice).toBe(audioAsVoice === true);
110
+ },
111
+ );
112
+
113
+ it("preserves audio-as-voice metadata from tts results", async () => {
114
+ const toolResult = {
115
+ content: [{ type: "text", text: "(spoken) hello" }],
116
+ details: {
117
+ media: {
118
+ mediaUrl: "/tmp/reply.opus",
119
+ audioAsVoice: true,
120
+ },
121
+ },
122
+ } satisfies AgentToolResult<unknown>;
123
+ const tool = createTool({
124
+ execute: vi.fn(async () => toolResult),
125
+ });
126
+ const bridge = createCodexDynamicToolBridge({
127
+ tools: [tool],
128
+ signal: new AbortController().signal,
129
+ });
130
+
131
+ const result = await bridge.handleToolCall({
132
+ threadId: "thread-1",
133
+ turnId: "turn-1",
134
+ callId: "call-1",
135
+ namespace: null,
136
+ tool: "tts",
137
+ arguments: { text: "hello" },
138
+ });
139
+
140
+ expect(result).toEqual({
141
+ success: true,
142
+ contentItems: [{ type: "inputText", text: "(spoken) hello" }],
143
+ });
144
+ expect(bridge.telemetry.toolMediaUrls).toEqual(["/tmp/reply.opus"]);
145
+ expect(bridge.telemetry.toolAudioAsVoice).toBe(true);
146
+ });
147
+
148
+ it("records messaging tool side effects while returning concise text to app-server", async () => {
149
+ const toolResult = {
150
+ content: [{ type: "text", text: "Sent." }],
151
+ details: { messageId: "message-1" },
152
+ } satisfies AgentToolResult<unknown>;
153
+ const tool = createTool({
154
+ name: "message",
155
+ execute: vi.fn(async () => toolResult),
156
+ });
157
+ const bridge = createCodexDynamicToolBridge({
158
+ tools: [tool],
159
+ signal: new AbortController().signal,
160
+ });
161
+
162
+ const result = await handleMessageToolCall(bridge, {
163
+ action: "send",
164
+ text: "hello from Codex",
165
+ mediaUrl: "/tmp/reply.png",
166
+ provider: "telegram",
167
+ to: "chat-1",
168
+ threadId: "thread-ts-1",
169
+ });
170
+
171
+ expect(result).toEqual(expectInputText("Sent."));
172
+ expect(bridge.telemetry).toMatchObject({
173
+ didSendViaMessagingTool: true,
174
+ messagingToolSentTexts: ["hello from Codex"],
175
+ messagingToolSentMediaUrls: ["/tmp/reply.png"],
176
+ messagingToolSentTargets: [
177
+ {
178
+ tool: "message",
179
+ provider: "telegram",
180
+ to: "chat-1",
181
+ threadId: "thread-ts-1",
182
+ },
183
+ ],
184
+ });
185
+ });
186
+
187
+ it("does not record messaging side effects when the send fails", async () => {
188
+ const tool = createTool({
189
+ name: "message",
190
+ execute: vi.fn(async () => {
191
+ throw new Error("send failed");
192
+ }),
193
+ });
194
+ const bridge = createCodexDynamicToolBridge({
195
+ tools: [tool],
196
+ signal: new AbortController().signal,
197
+ });
198
+
199
+ const result = await handleMessageToolCall(bridge, {
200
+ action: "send",
201
+ text: "not delivered",
202
+ provider: "slack",
203
+ to: "C123",
204
+ });
205
+
206
+ expect(result).toEqual({
207
+ success: false,
208
+ contentItems: [{ type: "inputText", text: "send failed" }],
209
+ });
210
+ expect(bridge.telemetry).toMatchObject({
211
+ didSendViaMessagingTool: false,
212
+ messagingToolSentTexts: [],
213
+ messagingToolSentMediaUrls: [],
214
+ messagingToolSentTargets: [],
215
+ });
216
+ });
217
+
218
+ it("records heartbeat response tool outcomes", async () => {
219
+ const bridge = createBridgeWithToolResult(
220
+ HEARTBEAT_RESPONSE_TOOL_NAME,
221
+ textToolResult("Recorded.", {
222
+ status: "recorded",
223
+ outcome: "needs_attention",
224
+ notify: true,
225
+ summary: "Build is blocked.",
226
+ notificationText: "Build is blocked on missing credentials.",
227
+ priority: "high",
228
+ }),
229
+ );
230
+
231
+ const result = await bridge.handleToolCall({
232
+ threadId: "thread-1",
233
+ turnId: "turn-1",
234
+ callId: "call-1",
235
+ namespace: null,
236
+ tool: HEARTBEAT_RESPONSE_TOOL_NAME,
237
+ arguments: {},
238
+ });
239
+
240
+ expect(result).toEqual(expectInputText("Recorded."));
241
+ expect(bridge.telemetry.heartbeatToolResponse).toEqual({
242
+ outcome: "needs_attention",
243
+ notify: true,
244
+ summary: "Build is blocked.",
245
+ notificationText: "Build is blocked on missing credentials.",
246
+ priority: "high",
247
+ });
248
+ });
249
+
250
+ it("applies agent tool result middleware from the active plugin registry", async () => {
251
+ const registry = createEmptyPluginRegistry();
252
+ const handler = vi.fn(
253
+ async (event: { result: AgentToolResult<unknown>; toolName: string }) => ({
254
+ result: {
255
+ ...event.result,
256
+ content: [{ type: "text" as const, text: `${event.toolName} compacted` }],
257
+ },
258
+ }),
259
+ );
260
+ registry.agentToolResultMiddlewares.push({
261
+ pluginId: "tokenjuice",
262
+ pluginName: "Tokenjuice",
263
+ rawHandler: handler,
264
+ handler,
265
+ runtimes: ["codex"],
266
+ source: "test",
267
+ });
268
+ setActivePluginRegistry(registry);
269
+
270
+ const bridge = createBridgeWithToolResult("exec", {
271
+ content: [{ type: "text", text: "raw output" }],
272
+ details: {},
273
+ });
274
+
275
+ const result = await bridge.handleToolCall({
276
+ threadId: "thread-1",
277
+ turnId: "turn-1",
278
+ callId: "call-1",
279
+ namespace: null,
280
+ tool: "exec",
281
+ arguments: { command: "git status" },
282
+ });
283
+
284
+ expect(result).toEqual(expectInputText("exec compacted"));
285
+ expect(handler).toHaveBeenCalledWith(
286
+ expect.objectContaining({
287
+ threadId: "thread-1",
288
+ turnId: "turn-1",
289
+ toolCallId: "call-1",
290
+ toolName: "exec",
291
+ args: { command: "git status" },
292
+ }),
293
+ expect.objectContaining({ runtime: "codex" }),
294
+ );
295
+ });
296
+
297
+ it("passes raw tool failure state into agent tool result middleware", async () => {
298
+ const registry = createEmptyPluginRegistry();
299
+ const handler = vi.fn(async (_event: { isError?: boolean }) => undefined);
300
+ registry.agentToolResultMiddlewares.push({
301
+ pluginId: "tokenjuice",
302
+ pluginName: "Tokenjuice",
303
+ rawHandler: handler,
304
+ handler,
305
+ runtimes: ["codex"],
306
+ source: "test",
307
+ });
308
+ setActivePluginRegistry(registry);
309
+
310
+ const bridge = createBridgeWithToolResult("exec", {
311
+ content: [{ type: "text", text: "failed output" }],
312
+ details: { status: "failed", exitCode: 1 },
313
+ });
314
+
315
+ await bridge.handleToolCall({
316
+ threadId: "thread-1",
317
+ turnId: "turn-1",
318
+ callId: "call-1",
319
+ namespace: null,
320
+ tool: "exec",
321
+ arguments: { command: "false" },
322
+ });
323
+
324
+ expect(handler).toHaveBeenCalledWith(
325
+ expect.objectContaining({ isError: true }),
326
+ expect.objectContaining({ runtime: "codex" }),
327
+ );
328
+ });
329
+
330
+ it("uses raw tool provenance for media trust after middleware rewrites details", async () => {
331
+ const registry = createEmptyPluginRegistry();
332
+ const handler = vi.fn(async (event: { result: AgentToolResult<unknown> }) => ({
333
+ result: {
334
+ ...event.result,
335
+ content: [{ type: "text" as const, text: "Generated media reply." }],
336
+ details: {
337
+ media: {
338
+ mediaUrl: "/tmp/unsafe.png",
339
+ },
340
+ },
341
+ },
342
+ }));
343
+ registry.agentToolResultMiddlewares.push({
344
+ pluginId: "tokenjuice",
345
+ pluginName: "Tokenjuice",
346
+ rawHandler: handler,
347
+ handler,
348
+ runtimes: ["codex"],
349
+ source: "test",
350
+ });
351
+ setActivePluginRegistry(registry);
352
+
353
+ const bridge = createBridgeWithToolResult("browser", {
354
+ content: [{ type: "text", text: "raw output" }],
355
+ details: {
356
+ mcpServer: "external",
357
+ mcpTool: "browser",
358
+ },
359
+ });
360
+
361
+ const result = await bridge.handleToolCall({
362
+ threadId: "thread-1",
363
+ turnId: "turn-1",
364
+ callId: "call-1",
365
+ namespace: null,
366
+ tool: "browser",
367
+ arguments: {},
368
+ });
369
+
370
+ expect(result).toEqual(expectInputText("Generated media reply."));
371
+ expect(bridge.telemetry.toolMediaUrls).toEqual([]);
372
+ });
373
+
374
+ it("still applies legacy codex app-server extension factories after middleware", async () => {
375
+ const registry = createEmptyPluginRegistry();
376
+ const factory = async (codex: {
377
+ on: (
378
+ event: "tool_result",
379
+ handler: (event: any) => Promise<{ result: AgentToolResult<unknown> }>,
380
+ ) => void;
381
+ }) => {
382
+ codex.on("tool_result", async (event) => ({
383
+ result: {
384
+ ...event.result,
385
+ content: [{ type: "text", text: "legacy compacted" }],
386
+ },
387
+ }));
388
+ };
389
+ registry.codexAppServerExtensionFactories.push({
390
+ pluginId: "tokenjuice",
391
+ pluginName: "Tokenjuice",
392
+ rawFactory: factory,
393
+ factory,
394
+ source: "test",
395
+ });
396
+ setActivePluginRegistry(registry);
397
+
398
+ const bridge = createBridgeWithToolResult("exec", {
399
+ content: [{ type: "text", text: "raw output" }],
400
+ details: {},
401
+ });
402
+
403
+ const result = await bridge.handleToolCall({
404
+ threadId: "thread-1",
405
+ turnId: "turn-1",
406
+ callId: "call-1",
407
+ namespace: null,
408
+ tool: "exec",
409
+ arguments: { command: "git status" },
410
+ });
411
+
412
+ expect(result).toEqual(expectInputText("legacy compacted"));
413
+ });
414
+
415
+ it("fires after_tool_call for successful codex tool executions", async () => {
416
+ const afterToolCall = vi.fn();
417
+ initializeGlobalHookRunner(
418
+ createMockPluginRegistry([{ hookName: "after_tool_call", handler: afterToolCall }]),
419
+ );
420
+
421
+ const bridge = createBridgeWithToolResult("exec", {
422
+ content: [{ type: "text", text: "done" }],
423
+ details: {},
424
+ });
425
+
426
+ await bridge.handleToolCall({
427
+ threadId: "thread-1",
428
+ turnId: "turn-1",
429
+ callId: "call-1",
430
+ namespace: null,
431
+ tool: "exec",
432
+ arguments: { command: "pwd" },
433
+ });
434
+
435
+ await vi.waitFor(() => {
436
+ expect(afterToolCall).toHaveBeenCalledWith(
437
+ expect.objectContaining({
438
+ toolName: "exec",
439
+ toolCallId: "call-1",
440
+ params: { command: "pwd" },
441
+ result: expect.objectContaining({
442
+ content: [{ type: "text", text: "done" }],
443
+ details: {},
444
+ }),
445
+ }),
446
+ expect.objectContaining({
447
+ toolName: "exec",
448
+ toolCallId: "call-1",
449
+ }),
450
+ );
451
+ });
452
+ });
453
+
454
+ it("runs before_tool_call for unwrapped dynamic tools before execution", async () => {
455
+ const beforeToolCall = vi.fn(async () => ({ params: { mode: "safe" } }));
456
+ const afterToolCall = vi.fn();
457
+ initializeGlobalHookRunner(
458
+ createMockPluginRegistry([
459
+ { hookName: "before_tool_call", handler: beforeToolCall },
460
+ { hookName: "after_tool_call", handler: afterToolCall },
461
+ ]),
462
+ );
463
+
464
+ const execute = vi.fn(async () => textToolResult("done", { ok: true }));
465
+ const bridge = createCodexDynamicToolBridge({
466
+ tools: [createTool({ name: "exec", execute })],
467
+ signal: new AbortController().signal,
468
+ hookContext: {
469
+ agentId: "agent-1",
470
+ sessionId: "session-1",
471
+ sessionKey: "agent:agent-1:session-1",
472
+ runId: "run-1",
473
+ },
474
+ });
475
+
476
+ const result = await bridge.handleToolCall({
477
+ threadId: "thread-1",
478
+ turnId: "turn-1",
479
+ callId: "call-1",
480
+ namespace: null,
481
+ tool: "exec",
482
+ arguments: { command: "pwd" },
483
+ });
484
+
485
+ expect(result).toEqual(expectInputText("done"));
486
+ expect(beforeToolCall).toHaveBeenCalledWith(
487
+ expect.objectContaining({
488
+ toolName: "exec",
489
+ toolCallId: "call-1",
490
+ runId: "run-1",
491
+ params: { command: "pwd" },
492
+ }),
493
+ expect.objectContaining({
494
+ agentId: "agent-1",
495
+ sessionId: "session-1",
496
+ sessionKey: "agent:agent-1:session-1",
497
+ runId: "run-1",
498
+ toolCallId: "call-1",
499
+ }),
500
+ );
501
+ expect(execute).toHaveBeenCalledWith(
502
+ "call-1",
503
+ { command: "pwd", mode: "safe" },
504
+ expect.any(AbortSignal),
505
+ undefined,
506
+ );
507
+ await vi.waitFor(() => {
508
+ expect(afterToolCall).toHaveBeenCalledWith(
509
+ expect.objectContaining({
510
+ toolName: "exec",
511
+ toolCallId: "call-1",
512
+ params: { command: "pwd", mode: "safe" },
513
+ result: expect.objectContaining({
514
+ content: [{ type: "text", text: "done" }],
515
+ details: { ok: true },
516
+ }),
517
+ }),
518
+ expect.objectContaining({
519
+ agentId: "agent-1",
520
+ sessionId: "session-1",
521
+ sessionKey: "agent:agent-1:session-1",
522
+ runId: "run-1",
523
+ toolCallId: "call-1",
524
+ }),
525
+ );
526
+ });
527
+ });
528
+
529
+ it("does not execute dynamic tools blocked by before_tool_call", async () => {
530
+ const beforeToolCall = vi.fn(async () => ({
531
+ block: true,
532
+ blockReason: "blocked by policy",
533
+ }));
534
+ const afterToolCall = vi.fn();
535
+ initializeGlobalHookRunner(
536
+ createMockPluginRegistry([
537
+ { hookName: "before_tool_call", handler: beforeToolCall },
538
+ { hookName: "after_tool_call", handler: afterToolCall },
539
+ ]),
540
+ );
541
+ const execute = vi.fn(async () => textToolResult("should not run"));
542
+ const bridge = createCodexDynamicToolBridge({
543
+ tools: [createTool({ name: "message", execute })],
544
+ signal: new AbortController().signal,
545
+ hookContext: { runId: "run-blocked" },
546
+ });
547
+
548
+ const result = await handleMessageToolCall(bridge, {
549
+ action: "send",
550
+ text: "blocked",
551
+ provider: "telegram",
552
+ to: "chat-1",
553
+ });
554
+
555
+ expect(result).toEqual({
556
+ success: true,
557
+ contentItems: [{ type: "inputText", text: "blocked by policy" }],
558
+ });
559
+ expect(execute).not.toHaveBeenCalled();
560
+ expect(bridge.telemetry.didSendViaMessagingTool).toBe(false);
561
+ await vi.waitFor(() => {
562
+ expect(afterToolCall).toHaveBeenCalledWith(
563
+ expect.objectContaining({
564
+ toolName: "message",
565
+ toolCallId: "call-1",
566
+ params: {
567
+ action: "send",
568
+ text: "blocked",
569
+ provider: "telegram",
570
+ to: "chat-1",
571
+ },
572
+ result: expect.objectContaining({
573
+ content: [{ type: "text", text: "blocked by policy" }],
574
+ details: {
575
+ status: "blocked",
576
+ deniedReason: "plugin-before-tool-call",
577
+ reason: "blocked by policy",
578
+ },
579
+ }),
580
+ }),
581
+ expect.objectContaining({
582
+ runId: "run-blocked",
583
+ toolCallId: "call-1",
584
+ }),
585
+ );
586
+ });
587
+ });
588
+
589
+ it("applies dynamic tool result middleware before after_tool_call observes the result", async () => {
590
+ const events: string[] = [];
591
+ const beforeToolCall = vi.fn(async () => {
592
+ events.push("before_tool_call");
593
+ return { params: { mode: "safe" } };
594
+ });
595
+ const afterToolCall = vi.fn(async (event) => {
596
+ events.push("after_tool_call");
597
+ expect(event).toMatchObject({
598
+ params: { command: "status", mode: "safe" },
599
+ result: {
600
+ content: [{ type: "text", text: "compacted output" }],
601
+ details: { stage: "middleware" },
602
+ },
603
+ });
604
+ });
605
+ initializeGlobalHookRunner(
606
+ createMockPluginRegistry([
607
+ { hookName: "before_tool_call", handler: beforeToolCall },
608
+ { hookName: "after_tool_call", handler: afterToolCall },
609
+ ]),
610
+ );
611
+ const registry = createEmptyPluginRegistry();
612
+ const handler = vi.fn(
613
+ async (event: { args: Record<string, unknown>; result: AgentToolResult<unknown> }) => {
614
+ events.push("middleware");
615
+ expect(event.args).toEqual({ command: "status" });
616
+ return {
617
+ result: {
618
+ ...event.result,
619
+ content: [{ type: "text" as const, text: "compacted output" }],
620
+ details: { stage: "middleware" },
621
+ },
622
+ };
623
+ },
624
+ );
625
+ registry.agentToolResultMiddlewares.push({
626
+ pluginId: "tokenjuice",
627
+ pluginName: "Tokenjuice",
628
+ rawHandler: handler,
629
+ handler,
630
+ runtimes: ["codex"],
631
+ source: "test",
632
+ });
633
+ setActivePluginRegistry(registry);
634
+ const execute = vi.fn(async () => {
635
+ events.push("execute");
636
+ return textToolResult("raw output", { stage: "execute" });
637
+ });
638
+ const bridge = createCodexDynamicToolBridge({
639
+ tools: [createTool({ name: "exec", execute })],
640
+ signal: new AbortController().signal,
641
+ hookContext: { runId: "run-middleware" },
642
+ });
643
+
644
+ const result = await bridge.handleToolCall({
645
+ threadId: "thread-1",
646
+ turnId: "turn-1",
647
+ callId: "call-1",
648
+ namespace: null,
649
+ tool: "exec",
650
+ arguments: { command: "status" },
651
+ });
652
+
653
+ expect(result).toEqual(expectInputText("compacted output"));
654
+ await vi.waitFor(() => {
655
+ expect(events).toEqual(["before_tool_call", "execute", "middleware", "after_tool_call"]);
656
+ });
657
+ });
658
+
659
+ it("reports dynamic tool execution errors through after_tool_call without stranding the turn", async () => {
660
+ const beforeToolCall = vi.fn(async () => ({ params: { timeoutSec: 1 } }));
661
+ const afterToolCall = vi.fn();
662
+ initializeGlobalHookRunner(
663
+ createMockPluginRegistry([
664
+ { hookName: "before_tool_call", handler: beforeToolCall },
665
+ { hookName: "after_tool_call", handler: afterToolCall },
666
+ ]),
667
+ );
668
+ const execute = vi.fn(async () => {
669
+ throw new Error("tool failed");
670
+ });
671
+ const bridge = createCodexDynamicToolBridge({
672
+ tools: [createTool({ name: "exec", execute })],
673
+ signal: new AbortController().signal,
674
+ hookContext: { runId: "run-error" },
675
+ });
676
+
677
+ const result = await bridge.handleToolCall({
678
+ threadId: "thread-1",
679
+ turnId: "turn-1",
680
+ callId: "call-err",
681
+ namespace: null,
682
+ tool: "exec",
683
+ arguments: { command: "false" },
684
+ });
685
+
686
+ expect(result).toEqual({
687
+ success: false,
688
+ contentItems: [{ type: "inputText", text: "tool failed" }],
689
+ });
690
+ expect(execute).toHaveBeenCalledWith(
691
+ "call-err",
692
+ { command: "false", timeoutSec: 1 },
693
+ expect.any(AbortSignal),
694
+ undefined,
695
+ );
696
+ await vi.waitFor(() => {
697
+ expect(afterToolCall).toHaveBeenCalledWith(
698
+ expect.objectContaining({
699
+ toolName: "exec",
700
+ toolCallId: "call-err",
701
+ params: { command: "false", timeoutSec: 1 },
702
+ error: "tool failed",
703
+ }),
704
+ expect.objectContaining({
705
+ runId: "run-error",
706
+ toolCallId: "call-err",
707
+ }),
708
+ );
709
+ });
710
+ });
711
+
712
+ it("passes per-call abort signals into dynamic tool execution", async () => {
713
+ let capturedSignal: AbortSignal | undefined;
714
+ let resolveTool: ((result: AgentToolResult<unknown>) => void) | undefined;
715
+ const execute = vi.fn(
716
+ async (_callId: string, _args: Record<string, unknown>, signal: AbortSignal) =>
717
+ await new Promise<AgentToolResult<unknown>>((resolve) => {
718
+ capturedSignal = signal;
719
+ resolveTool = resolve;
720
+ }),
721
+ );
722
+ const runController = new AbortController();
723
+ const callController = new AbortController();
724
+ const bridge = createCodexDynamicToolBridge({
725
+ tools: [createTool({ name: "exec", execute })],
726
+ signal: runController.signal,
727
+ });
728
+
729
+ const result = bridge.handleToolCall(
730
+ {
731
+ threadId: "thread-1",
732
+ turnId: "turn-1",
733
+ callId: "call-signal",
734
+ namespace: null,
735
+ tool: "exec",
736
+ arguments: { command: "sleep" },
737
+ },
738
+ { signal: callController.signal },
739
+ );
740
+ await vi.waitFor(() => expect(capturedSignal).toBeDefined());
741
+
742
+ callController.abort(new Error("deadline"));
743
+ expect(capturedSignal?.aborted).toBe(true);
744
+ resolveTool?.(textToolResult("done"));
745
+
746
+ await expect(result).resolves.toEqual(expectInputText("done"));
747
+ });
748
+
749
+ it("does not double-wrap dynamic tools that already have before_tool_call", async () => {
750
+ const beforeToolCall = vi.fn(async () => ({ params: { mode: "safe" } }));
751
+ initializeGlobalHookRunner(
752
+ createMockPluginRegistry([{ hookName: "before_tool_call", handler: beforeToolCall }]),
753
+ );
754
+ const execute = vi.fn(async () => textToolResult("done"));
755
+ const tool = wrapToolWithBeforeToolCallHook(createTool({ name: "exec", execute }), {
756
+ runId: "run-wrapped",
757
+ });
758
+ const bridge = createCodexDynamicToolBridge({
759
+ tools: [tool],
760
+ signal: new AbortController().signal,
761
+ hookContext: { runId: "run-wrapped" },
762
+ });
763
+
764
+ await bridge.handleToolCall({
765
+ threadId: "thread-1",
766
+ turnId: "turn-1",
767
+ callId: "call-wrapped",
768
+ namespace: null,
769
+ tool: "exec",
770
+ arguments: { command: "pwd" },
771
+ });
772
+
773
+ expect(beforeToolCall).toHaveBeenCalledTimes(1);
774
+ expect(execute).toHaveBeenCalledWith(
775
+ "call-wrapped",
776
+ { command: "pwd", mode: "safe" },
777
+ expect.any(AbortSignal),
778
+ undefined,
779
+ );
780
+ });
781
+ });