codex-toys 0.140.13 → 0.140.15

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 (468) hide show
  1. package/README.md +39 -50
  2. package/dist/cli/actions.d.ts +1 -1
  3. package/dist/cli/actions.d.ts.map +1 -1
  4. package/dist/cli/actions.js +0 -8
  5. package/dist/cli/actions.js.map +1 -1
  6. package/dist/cli/args.d.ts +11 -28
  7. package/dist/cli/args.d.ts.map +1 -1
  8. package/dist/cli/args.js +59 -97
  9. package/dist/cli/args.js.map +1 -1
  10. package/dist/cli/help.d.ts.map +1 -1
  11. package/dist/cli/help.js +52 -61
  12. package/dist/cli/help.js.map +1 -1
  13. package/dist/cli/index.js +61 -67
  14. package/dist/cli/index.js.map +1 -1
  15. package/dist/cli/mcp.d.ts.map +1 -1
  16. package/dist/cli/mcp.js +27 -85
  17. package/dist/cli/mcp.js.map +1 -1
  18. package/dist/cli/toybox.d.ts +1 -1
  19. package/dist/cli/toybox.d.ts.map +1 -1
  20. package/dist/cli/toybox.js +18 -23
  21. package/dist/cli/toybox.js.map +1 -1
  22. package/dist/index.d.ts +1 -3
  23. package/dist/index.d.ts.map +1 -1
  24. package/dist/index.js +1 -3
  25. package/dist/index.js.map +1 -1
  26. package/dist/internal/bridge/app-server/generated/AgentMessageInputContent.d.ts +8 -0
  27. package/dist/internal/bridge/app-server/generated/AgentMessageInputContent.d.ts.map +1 -0
  28. package/dist/internal/bridge/app-server/generated/AgentMessageInputContent.js +3 -0
  29. package/dist/internal/bridge/app-server/generated/AgentMessageInputContent.js.map +1 -0
  30. package/dist/internal/bridge/app-server/generated/AmazonBedrockCredentialSource.d.ts +2 -0
  31. package/dist/internal/bridge/app-server/generated/AmazonBedrockCredentialSource.d.ts.map +1 -0
  32. package/dist/internal/bridge/app-server/generated/AmazonBedrockCredentialSource.js +3 -0
  33. package/dist/internal/bridge/app-server/generated/AmazonBedrockCredentialSource.js.map +1 -0
  34. package/dist/internal/bridge/app-server/generated/AuthMode.d.ts +1 -1
  35. package/dist/internal/bridge/app-server/generated/AuthMode.d.ts.map +1 -1
  36. package/dist/internal/bridge/app-server/generated/ClientRequest.d.ts +61 -2
  37. package/dist/internal/bridge/app-server/generated/ClientRequest.d.ts.map +1 -1
  38. package/dist/internal/bridge/app-server/generated/ConversationTextRole.d.ts +2 -0
  39. package/dist/internal/bridge/app-server/generated/ConversationTextRole.d.ts.map +1 -0
  40. package/dist/internal/bridge/app-server/generated/ConversationTextRole.js +3 -0
  41. package/dist/internal/bridge/app-server/generated/ConversationTextRole.js.map +1 -0
  42. package/dist/internal/bridge/app-server/generated/InitializeCapabilities.d.ts +4 -0
  43. package/dist/internal/bridge/app-server/generated/InitializeCapabilities.d.ts.map +1 -1
  44. package/dist/internal/bridge/app-server/generated/InternalChatMessageMetadataPassthrough.d.ts +10 -0
  45. package/dist/internal/bridge/app-server/generated/InternalChatMessageMetadataPassthrough.d.ts.map +1 -0
  46. package/dist/internal/bridge/app-server/generated/InternalChatMessageMetadataPassthrough.js +3 -0
  47. package/dist/internal/bridge/app-server/generated/InternalChatMessageMetadataPassthrough.js.map +1 -0
  48. package/dist/internal/bridge/app-server/generated/LegacyAppPathString.d.ts +23 -0
  49. package/dist/internal/bridge/app-server/generated/LegacyAppPathString.d.ts.map +1 -0
  50. package/dist/internal/bridge/app-server/generated/LegacyAppPathString.js +3 -0
  51. package/dist/internal/bridge/app-server/generated/LegacyAppPathString.js.map +1 -0
  52. package/dist/internal/bridge/app-server/generated/MultiAgentMode.d.ts +8 -0
  53. package/dist/internal/bridge/app-server/generated/MultiAgentMode.d.ts.map +1 -0
  54. package/dist/internal/bridge/app-server/generated/MultiAgentMode.js +3 -0
  55. package/dist/internal/bridge/app-server/generated/MultiAgentMode.js.map +1 -0
  56. package/dist/internal/bridge/app-server/generated/ReasoningEffort.d.ts +1 -1
  57. package/dist/internal/bridge/app-server/generated/ReasoningEffort.d.ts.map +1 -1
  58. package/dist/internal/bridge/app-server/generated/ResponseItem.d.ts +38 -1
  59. package/dist/internal/bridge/app-server/generated/ResponseItem.d.ts.map +1 -1
  60. package/dist/internal/bridge/app-server/generated/ServerNotification.d.ts +16 -0
  61. package/dist/internal/bridge/app-server/generated/ServerNotification.d.ts.map +1 -1
  62. package/dist/internal/bridge/app-server/generated/ServerRequest.d.ts +5 -0
  63. package/dist/internal/bridge/app-server/generated/ServerRequest.d.ts.map +1 -1
  64. package/dist/internal/bridge/app-server/generated/WebSearchMode.d.ts +1 -1
  65. package/dist/internal/bridge/app-server/generated/WebSearchMode.d.ts.map +1 -1
  66. package/dist/internal/bridge/app-server/generated/index.d.ts +6 -0
  67. package/dist/internal/bridge/app-server/generated/index.d.ts.map +1 -1
  68. package/dist/internal/bridge/app-server/generated/index.js.map +1 -1
  69. package/dist/internal/bridge/app-server/generated/v2/Account.d.ts +3 -1
  70. package/dist/internal/bridge/app-server/generated/v2/Account.d.ts.map +1 -1
  71. package/dist/internal/bridge/app-server/generated/v2/AccountRateLimitsUpdatedNotification.d.ts +7 -0
  72. package/dist/internal/bridge/app-server/generated/v2/AccountRateLimitsUpdatedNotification.d.ts.map +1 -1
  73. package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageDailyBucket.d.ts +5 -0
  74. package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageDailyBucket.d.ts.map +1 -0
  75. package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageDailyBucket.js +3 -0
  76. package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageDailyBucket.js.map +1 -0
  77. package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageSummary.d.ts +8 -0
  78. package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageSummary.d.ts.map +1 -0
  79. package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageSummary.js +3 -0
  80. package/dist/internal/bridge/app-server/generated/v2/AccountTokenUsageSummary.js.map +1 -0
  81. package/dist/internal/bridge/app-server/generated/v2/AdditionalFileSystemPermissions.d.ts +3 -3
  82. package/dist/internal/bridge/app-server/generated/v2/AdditionalFileSystemPermissions.d.ts.map +1 -1
  83. package/dist/internal/bridge/app-server/generated/v2/AppSummary.d.ts +1 -1
  84. package/dist/internal/bridge/app-server/generated/v2/AppSummary.d.ts.map +1 -1
  85. package/dist/internal/bridge/app-server/generated/v2/AppTemplateSummary.d.ts +13 -0
  86. package/dist/internal/bridge/app-server/generated/v2/AppTemplateSummary.d.ts.map +1 -0
  87. package/dist/internal/bridge/app-server/generated/v2/AppTemplateSummary.js +3 -0
  88. package/dist/internal/bridge/app-server/generated/v2/AppTemplateSummary.js.map +1 -0
  89. package/dist/internal/bridge/app-server/generated/v2/AppTemplateUnavailableReason.d.ts +2 -0
  90. package/dist/internal/bridge/app-server/generated/v2/AppTemplateUnavailableReason.d.ts.map +1 -0
  91. package/dist/internal/bridge/app-server/generated/v2/AppTemplateUnavailableReason.js +3 -0
  92. package/dist/internal/bridge/app-server/generated/v2/AppTemplateUnavailableReason.js.map +1 -0
  93. package/dist/internal/bridge/app-server/generated/v2/AppsConfig.d.ts +2 -0
  94. package/dist/internal/bridge/app-server/generated/v2/AppsConfig.d.ts.map +1 -1
  95. package/dist/internal/bridge/app-server/generated/v2/AppsDefaultConfig.d.ts +4 -0
  96. package/dist/internal/bridge/app-server/generated/v2/AppsDefaultConfig.d.ts.map +1 -1
  97. package/dist/internal/bridge/app-server/generated/v2/CapabilityRootLocation.d.ts +9 -0
  98. package/dist/internal/bridge/app-server/generated/v2/CapabilityRootLocation.d.ts.map +1 -0
  99. package/dist/internal/bridge/app-server/generated/v2/CapabilityRootLocation.js +3 -0
  100. package/dist/internal/bridge/app-server/generated/v2/CapabilityRootLocation.js.map +1 -0
  101. package/dist/internal/bridge/app-server/generated/v2/CommandExecutionRequestApprovalParams.d.ts +6 -2
  102. package/dist/internal/bridge/app-server/generated/v2/CommandExecutionRequestApprovalParams.d.ts.map +1 -1
  103. package/dist/internal/bridge/app-server/generated/v2/ConfigLayerSource.d.ts +12 -0
  104. package/dist/internal/bridge/app-server/generated/v2/ConfigLayerSource.d.ts.map +1 -1
  105. package/dist/internal/bridge/app-server/generated/v2/ConfigRequirements.d.ts +5 -1
  106. package/dist/internal/bridge/app-server/generated/v2/ConfigRequirements.d.ts.map +1 -1
  107. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditOutcome.d.ts +2 -0
  108. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditOutcome.d.ts.map +1 -0
  109. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditOutcome.js +3 -0
  110. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditOutcome.js.map +1 -0
  111. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditParams.d.ts +8 -0
  112. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditParams.d.ts.map +1 -0
  113. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditParams.js +3 -0
  114. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditParams.js.map +1 -0
  115. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditResponse.d.ts +5 -0
  116. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditResponse.d.ts.map +1 -0
  117. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditResponse.js +3 -0
  118. package/dist/internal/bridge/app-server/generated/v2/ConsumeAccountRateLimitResetCreditResponse.js.map +1 -0
  119. package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadParams.d.ts +4 -0
  120. package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadParams.d.ts.map +1 -0
  121. package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadParams.js +3 -0
  122. package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadParams.js.map +1 -0
  123. package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadResponse.d.ts +7 -0
  124. package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadResponse.d.ts.map +1 -0
  125. package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadResponse.js +3 -0
  126. package/dist/internal/bridge/app-server/generated/v2/CurrentTimeReadResponse.js.map +1 -0
  127. package/dist/internal/bridge/app-server/generated/v2/DynamicToolFunctionSpec.d.ts +8 -0
  128. package/dist/internal/bridge/app-server/generated/v2/DynamicToolFunctionSpec.d.ts.map +1 -0
  129. package/dist/internal/bridge/app-server/generated/v2/DynamicToolFunctionSpec.js +3 -0
  130. package/dist/internal/bridge/app-server/generated/v2/DynamicToolFunctionSpec.js.map +1 -0
  131. package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceSpec.d.ts +7 -0
  132. package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceSpec.d.ts.map +1 -0
  133. package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceSpec.js +3 -0
  134. package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceSpec.js.map +1 -0
  135. package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceTool.d.ts +5 -0
  136. package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceTool.d.ts.map +1 -0
  137. package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceTool.js +3 -0
  138. package/dist/internal/bridge/app-server/generated/v2/DynamicToolNamespaceTool.js.map +1 -0
  139. package/dist/internal/bridge/app-server/generated/v2/DynamicToolSpec.d.ts +6 -7
  140. package/dist/internal/bridge/app-server/generated/v2/DynamicToolSpec.d.ts.map +1 -1
  141. package/dist/internal/bridge/app-server/generated/v2/EnvironmentAddParams.d.ts +4 -0
  142. package/dist/internal/bridge/app-server/generated/v2/EnvironmentAddParams.d.ts.map +1 -1
  143. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigDetectParams.d.ts +1 -1
  144. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportCompletedNotification.d.ts +5 -1
  145. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportCompletedNotification.d.ts.map +1 -1
  146. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistoriesReadResponse.d.ts +5 -0
  147. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistoriesReadResponse.d.ts.map +1 -0
  148. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistoriesReadResponse.js +3 -0
  149. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistoriesReadResponse.js.map +1 -0
  150. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistory.d.ts +9 -0
  151. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistory.d.ts.map +1 -0
  152. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistory.js +3 -0
  153. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportHistory.js.map +1 -0
  154. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeFailure.d.ts +10 -0
  155. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeFailure.d.ts.map +1 -0
  156. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeFailure.js +3 -0
  157. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeFailure.js.map +1 -0
  158. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeSuccess.d.ts +8 -0
  159. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeSuccess.d.ts.map +1 -0
  160. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeSuccess.js +3 -0
  161. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportItemTypeSuccess.js.map +1 -0
  162. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportParams.d.ts +4 -0
  163. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportParams.d.ts.map +1 -1
  164. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportProgressNotification.d.ts +6 -0
  165. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportProgressNotification.d.ts.map +1 -0
  166. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportProgressNotification.js +3 -0
  167. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportProgressNotification.js.map +1 -0
  168. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportResponse.d.ts +3 -1
  169. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportResponse.d.ts.map +1 -1
  170. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportTypeResult.d.ts +9 -0
  171. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportTypeResult.d.ts.map +1 -0
  172. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportTypeResult.js +3 -0
  173. package/dist/internal/bridge/app-server/generated/v2/ExternalAgentConfigImportTypeResult.js.map +1 -0
  174. package/dist/internal/bridge/app-server/generated/v2/FileSystemPath.d.ts +2 -2
  175. package/dist/internal/bridge/app-server/generated/v2/FileSystemPath.d.ts.map +1 -1
  176. package/dist/internal/bridge/app-server/generated/v2/GetAccountRateLimitsResponse.d.ts +2 -0
  177. package/dist/internal/bridge/app-server/generated/v2/GetAccountRateLimitsResponse.d.ts.map +1 -1
  178. package/dist/internal/bridge/app-server/generated/v2/GetAccountTokenUsageResponse.d.ts +7 -0
  179. package/dist/internal/bridge/app-server/generated/v2/GetAccountTokenUsageResponse.d.ts.map +1 -0
  180. package/dist/internal/bridge/app-server/generated/v2/GetAccountTokenUsageResponse.js +3 -0
  181. package/dist/internal/bridge/app-server/generated/v2/GetAccountTokenUsageResponse.js.map +1 -0
  182. package/dist/internal/bridge/app-server/generated/v2/GetWorkspaceMessagesResponse.d.ts +12 -0
  183. package/dist/internal/bridge/app-server/generated/v2/GetWorkspaceMessagesResponse.d.ts.map +1 -0
  184. package/dist/internal/bridge/app-server/generated/v2/GetWorkspaceMessagesResponse.js +3 -0
  185. package/dist/internal/bridge/app-server/generated/v2/GetWorkspaceMessagesResponse.js.map +1 -0
  186. package/dist/internal/bridge/app-server/generated/v2/HookSource.d.ts +1 -1
  187. package/dist/internal/bridge/app-server/generated/v2/HookSource.d.ts.map +1 -1
  188. package/dist/internal/bridge/app-server/generated/v2/McpServerElicitationRequestParams.d.ts +5 -0
  189. package/dist/internal/bridge/app-server/generated/v2/McpServerElicitationRequestParams.d.ts.map +1 -1
  190. package/dist/internal/bridge/app-server/generated/v2/McpServerStatusUpdatedNotification.d.ts +1 -0
  191. package/dist/internal/bridge/app-server/generated/v2/McpServerStatusUpdatedNotification.d.ts.map +1 -1
  192. package/dist/internal/bridge/app-server/generated/v2/McpToolCallAppContext.d.ts +6 -0
  193. package/dist/internal/bridge/app-server/generated/v2/McpToolCallAppContext.d.ts.map +1 -0
  194. package/dist/internal/bridge/app-server/generated/v2/McpToolCallAppContext.js +3 -0
  195. package/dist/internal/bridge/app-server/generated/v2/McpToolCallAppContext.js.map +1 -0
  196. package/dist/internal/bridge/app-server/generated/v2/ModelSafetyBufferingUpdatedNotification.d.ts +10 -0
  197. package/dist/internal/bridge/app-server/generated/v2/ModelSafetyBufferingUpdatedNotification.d.ts.map +1 -0
  198. package/dist/internal/bridge/app-server/generated/v2/ModelSafetyBufferingUpdatedNotification.js +3 -0
  199. package/dist/internal/bridge/app-server/generated/v2/ModelSafetyBufferingUpdatedNotification.js.map +1 -0
  200. package/dist/internal/bridge/app-server/generated/v2/PermissionProfileSummary.d.ts +4 -0
  201. package/dist/internal/bridge/app-server/generated/v2/PermissionProfileSummary.d.ts.map +1 -1
  202. package/dist/internal/bridge/app-server/generated/v2/PermissionsRequestApprovalParams.d.ts +1 -0
  203. package/dist/internal/bridge/app-server/generated/v2/PermissionsRequestApprovalParams.d.ts.map +1 -1
  204. package/dist/internal/bridge/app-server/generated/v2/PluginDetail.d.ts +3 -0
  205. package/dist/internal/bridge/app-server/generated/v2/PluginDetail.d.ts.map +1 -1
  206. package/dist/internal/bridge/app-server/generated/v2/PluginInterface.d.ts +8 -0
  207. package/dist/internal/bridge/app-server/generated/v2/PluginInterface.d.ts.map +1 -1
  208. package/dist/internal/bridge/app-server/generated/v2/PluginListMarketplaceKind.d.ts +1 -1
  209. package/dist/internal/bridge/app-server/generated/v2/PluginListMarketplaceKind.d.ts.map +1 -1
  210. package/dist/internal/bridge/app-server/generated/v2/RateLimitResetCreditsSummary.d.ts +4 -0
  211. package/dist/internal/bridge/app-server/generated/v2/RateLimitResetCreditsSummary.d.ts.map +1 -0
  212. package/dist/internal/bridge/app-server/generated/v2/RateLimitResetCreditsSummary.js +3 -0
  213. package/dist/internal/bridge/app-server/generated/v2/RateLimitResetCreditsSummary.js.map +1 -0
  214. package/dist/internal/bridge/app-server/generated/v2/RateLimitSnapshot.d.ts +2 -0
  215. package/dist/internal/bridge/app-server/generated/v2/RateLimitSnapshot.d.ts.map +1 -1
  216. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClient.d.ts +11 -0
  217. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClient.d.ts.map +1 -0
  218. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClient.js +3 -0
  219. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClient.js.map +1 -0
  220. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListOrder.d.ts +2 -0
  221. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListOrder.d.ts.map +1 -0
  222. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListOrder.js +3 -0
  223. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListOrder.js.map +1 -0
  224. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListParams.d.ts +8 -0
  225. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListParams.d.ts.map +1 -0
  226. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListParams.js +3 -0
  227. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListParams.js.map +1 -0
  228. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListResponse.d.ts +6 -0
  229. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListResponse.d.ts.map +1 -0
  230. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListResponse.js +3 -0
  231. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsListResponse.js.map +1 -0
  232. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeParams.d.ts +5 -0
  233. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeParams.d.ts.map +1 -0
  234. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeParams.js +3 -0
  235. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeParams.js.map +1 -0
  236. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeResponse.d.ts +2 -0
  237. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeResponse.d.ts.map +1 -0
  238. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeResponse.js +3 -0
  239. package/dist/internal/bridge/app-server/generated/v2/RemoteControlClientsRevokeResponse.js.map +1 -0
  240. package/dist/internal/bridge/app-server/generated/v2/RemoteControlDisableParams.d.ts +4 -0
  241. package/dist/internal/bridge/app-server/generated/v2/RemoteControlDisableParams.d.ts.map +1 -0
  242. package/dist/internal/bridge/app-server/generated/v2/RemoteControlDisableParams.js +3 -0
  243. package/dist/internal/bridge/app-server/generated/v2/RemoteControlDisableParams.js.map +1 -0
  244. package/dist/internal/bridge/app-server/generated/v2/RemoteControlEnableParams.d.ts +4 -0
  245. package/dist/internal/bridge/app-server/generated/v2/RemoteControlEnableParams.d.ts.map +1 -0
  246. package/dist/internal/bridge/app-server/generated/v2/RemoteControlEnableParams.js +3 -0
  247. package/dist/internal/bridge/app-server/generated/v2/RemoteControlEnableParams.js.map +1 -0
  248. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartParams.d.ts +4 -0
  249. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartParams.d.ts.map +1 -0
  250. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartParams.js +3 -0
  251. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartParams.js.map +1 -0
  252. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartResponse.d.ts +7 -0
  253. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartResponse.d.ts.map +1 -0
  254. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartResponse.js +3 -0
  255. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStartResponse.js.map +1 -0
  256. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusParams.d.ts +5 -0
  257. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusParams.d.ts.map +1 -0
  258. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusParams.js +3 -0
  259. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusParams.js.map +1 -0
  260. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusResponse.d.ts +4 -0
  261. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusResponse.d.ts.map +1 -0
  262. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusResponse.js +3 -0
  263. package/dist/internal/bridge/app-server/generated/v2/RemoteControlPairingStatusResponse.js.map +1 -0
  264. package/dist/internal/bridge/app-server/generated/v2/SelectedCapabilityRoot.d.ts +15 -0
  265. package/dist/internal/bridge/app-server/generated/v2/SelectedCapabilityRoot.d.ts.map +1 -0
  266. package/dist/internal/bridge/app-server/generated/v2/SelectedCapabilityRoot.js +3 -0
  267. package/dist/internal/bridge/app-server/generated/v2/SelectedCapabilityRoot.js.map +1 -0
  268. package/dist/internal/bridge/app-server/generated/v2/SpendControlLimitSnapshot.d.ts +7 -0
  269. package/dist/internal/bridge/app-server/generated/v2/SpendControlLimitSnapshot.d.ts.map +1 -0
  270. package/dist/internal/bridge/app-server/generated/v2/SpendControlLimitSnapshot.js +3 -0
  271. package/dist/internal/bridge/app-server/generated/v2/SpendControlLimitSnapshot.js.map +1 -0
  272. package/dist/internal/bridge/app-server/generated/v2/SubAgentActivityKind.d.ts +2 -0
  273. package/dist/internal/bridge/app-server/generated/v2/SubAgentActivityKind.d.ts.map +1 -0
  274. package/dist/internal/bridge/app-server/generated/v2/SubAgentActivityKind.js +3 -0
  275. package/dist/internal/bridge/app-server/generated/v2/SubAgentActivityKind.js.map +1 -0
  276. package/dist/internal/bridge/app-server/generated/v2/Thread.d.ts +8 -0
  277. package/dist/internal/bridge/app-server/generated/v2/Thread.d.ts.map +1 -1
  278. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminal.d.ts +11 -0
  279. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminal.d.ts.map +1 -0
  280. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminal.js +3 -0
  281. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminal.js.map +1 -0
  282. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListParams.d.ts +12 -0
  283. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListParams.d.ts.map +1 -0
  284. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListParams.js +3 -0
  285. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListParams.js.map +1 -0
  286. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListResponse.d.ts +10 -0
  287. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListResponse.d.ts.map +1 -0
  288. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListResponse.js +3 -0
  289. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsListResponse.js.map +1 -0
  290. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateParams.d.ts +5 -0
  291. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateParams.d.ts.map +1 -0
  292. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateParams.js +3 -0
  293. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateParams.js.map +1 -0
  294. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateResponse.d.ts +4 -0
  295. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateResponse.d.ts.map +1 -0
  296. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateResponse.js +3 -0
  297. package/dist/internal/bridge/app-server/generated/v2/ThreadBackgroundTerminalsTerminateResponse.js.map +1 -0
  298. package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteParams.d.ts +4 -0
  299. package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteParams.d.ts.map +1 -0
  300. package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteParams.js +3 -0
  301. package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteParams.js.map +1 -0
  302. package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteResponse.d.ts +2 -0
  303. package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteResponse.d.ts.map +1 -0
  304. package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteResponse.js +3 -0
  305. package/dist/internal/bridge/app-server/generated/v2/ThreadDeleteResponse.js.map +1 -0
  306. package/dist/internal/bridge/app-server/generated/v2/ThreadDeletedNotification.d.ts +4 -0
  307. package/dist/internal/bridge/app-server/generated/v2/ThreadDeletedNotification.d.ts.map +1 -0
  308. package/dist/internal/bridge/app-server/generated/v2/ThreadDeletedNotification.js +3 -0
  309. package/dist/internal/bridge/app-server/generated/v2/ThreadDeletedNotification.js.map +1 -0
  310. package/dist/internal/bridge/app-server/generated/v2/ThreadForkParams.d.ts +3 -9
  311. package/dist/internal/bridge/app-server/generated/v2/ThreadForkParams.d.ts.map +1 -1
  312. package/dist/internal/bridge/app-server/generated/v2/ThreadForkResponse.d.ts +8 -2
  313. package/dist/internal/bridge/app-server/generated/v2/ThreadForkResponse.d.ts.map +1 -1
  314. package/dist/internal/bridge/app-server/generated/v2/ThreadItem.d.ts +18 -1
  315. package/dist/internal/bridge/app-server/generated/v2/ThreadItem.d.ts.map +1 -1
  316. package/dist/internal/bridge/app-server/generated/v2/ThreadListParams.d.ts +4 -0
  317. package/dist/internal/bridge/app-server/generated/v2/ThreadListParams.d.ts.map +1 -1
  318. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechParams.d.ts +8 -0
  319. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechParams.d.ts.map +1 -0
  320. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechParams.js +3 -0
  321. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechParams.js.map +1 -0
  322. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechResponse.d.ts +5 -0
  323. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechResponse.d.ts.map +1 -0
  324. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechResponse.js +3 -0
  325. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendSpeechResponse.js.map +1 -0
  326. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendTextParams.d.ts +2 -0
  327. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeAppendTextParams.d.ts.map +1 -1
  328. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeStartParams.d.ts +32 -0
  329. package/dist/internal/bridge/app-server/generated/v2/ThreadRealtimeStartParams.d.ts.map +1 -1
  330. package/dist/internal/bridge/app-server/generated/v2/ThreadResumeParams.d.ts +3 -9
  331. package/dist/internal/bridge/app-server/generated/v2/ThreadResumeParams.d.ts.map +1 -1
  332. package/dist/internal/bridge/app-server/generated/v2/ThreadResumeResponse.d.ts +8 -2
  333. package/dist/internal/bridge/app-server/generated/v2/ThreadResumeResponse.d.ts.map +1 -1
  334. package/dist/internal/bridge/app-server/generated/v2/ThreadSettings.d.ts +5 -0
  335. package/dist/internal/bridge/app-server/generated/v2/ThreadSettings.d.ts.map +1 -1
  336. package/dist/internal/bridge/app-server/generated/v2/ThreadSettingsUpdateParams.d.ts +5 -0
  337. package/dist/internal/bridge/app-server/generated/v2/ThreadSettingsUpdateParams.d.ts.map +1 -1
  338. package/dist/internal/bridge/app-server/generated/v2/ThreadSortKey.d.ts +1 -1
  339. package/dist/internal/bridge/app-server/generated/v2/ThreadSortKey.d.ts.map +1 -1
  340. package/dist/internal/bridge/app-server/generated/v2/ThreadSource.d.ts +1 -1
  341. package/dist/internal/bridge/app-server/generated/v2/ThreadSource.d.ts.map +1 -1
  342. package/dist/internal/bridge/app-server/generated/v2/ThreadStartParams.d.ts +13 -9
  343. package/dist/internal/bridge/app-server/generated/v2/ThreadStartParams.d.ts.map +1 -1
  344. package/dist/internal/bridge/app-server/generated/v2/ThreadStartResponse.d.ts +8 -2
  345. package/dist/internal/bridge/app-server/generated/v2/ThreadStartResponse.d.ts.map +1 -1
  346. package/dist/internal/bridge/app-server/generated/v2/ToolRequestUserInputParams.d.ts +1 -0
  347. package/dist/internal/bridge/app-server/generated/v2/ToolRequestUserInputParams.d.ts.map +1 -1
  348. package/dist/internal/bridge/app-server/generated/v2/TurnEnvironmentParams.d.ts +2 -2
  349. package/dist/internal/bridge/app-server/generated/v2/TurnEnvironmentParams.d.ts.map +1 -1
  350. package/dist/internal/bridge/app-server/generated/v2/TurnModerationMetadataNotification.d.ts +7 -0
  351. package/dist/internal/bridge/app-server/generated/v2/TurnModerationMetadataNotification.d.ts.map +1 -0
  352. package/dist/internal/bridge/app-server/generated/v2/TurnModerationMetadataNotification.js +3 -0
  353. package/dist/internal/bridge/app-server/generated/v2/TurnModerationMetadataNotification.js.map +1 -0
  354. package/dist/internal/bridge/app-server/generated/v2/TurnStartParams.d.ts +16 -5
  355. package/dist/internal/bridge/app-server/generated/v2/TurnStartParams.d.ts.map +1 -1
  356. package/dist/internal/bridge/app-server/generated/v2/TurnSteerParams.d.ts +7 -1
  357. package/dist/internal/bridge/app-server/generated/v2/TurnSteerParams.d.ts.map +1 -1
  358. package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessage.d.ts +15 -0
  359. package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessage.d.ts.map +1 -0
  360. package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessage.js +3 -0
  361. package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessage.js.map +1 -0
  362. package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessageType.d.ts +2 -0
  363. package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessageType.d.ts.map +1 -0
  364. package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessageType.js +3 -0
  365. package/dist/internal/bridge/app-server/generated/v2/WorkspaceMessageType.js.map +1 -0
  366. package/dist/internal/bridge/app-server/generated/v2/index.d.ts +52 -0
  367. package/dist/internal/bridge/app-server/generated/v2/index.d.ts.map +1 -1
  368. package/dist/internal/bridge/index.d.ts +1 -1
  369. package/dist/internal/bridge/index.d.ts.map +1 -1
  370. package/dist/internal/bridge/index.js +1 -1
  371. package/dist/internal/bridge/index.js.map +1 -1
  372. package/dist/internal/bridge/threads.d.ts +2 -0
  373. package/dist/internal/bridge/threads.d.ts.map +1 -1
  374. package/dist/internal/bridge/threads.js +6 -0
  375. package/dist/internal/bridge/threads.js.map +1 -1
  376. package/dist/internal/package.json +1 -1
  377. package/dist/internal/proxy/proxy.js +6 -6
  378. package/dist/internal/proxy/proxy.js.map +1 -1
  379. package/dist/internal/remote/remote-control.d.ts +2 -1
  380. package/dist/internal/remote/remote-control.d.ts.map +1 -1
  381. package/dist/internal/remote/remote-control.js +19 -17
  382. package/dist/internal/remote/remote-control.js.map +1 -1
  383. package/dist/internal/remote/remote-preflight.js +4 -4
  384. package/dist/internal/remote/remote-preflight.js.map +1 -1
  385. package/dist/internal/remote/remote-provider.d.ts.map +1 -1
  386. package/dist/internal/remote/remote-provider.js +9 -8
  387. package/dist/internal/remote/remote-provider.js.map +1 -1
  388. package/dist/internal/toybox/protocol.d.ts +1 -1
  389. package/dist/internal/toybox/protocol.d.ts.map +1 -1
  390. package/dist/internal/toybox/protocol.js +0 -1
  391. package/dist/internal/toybox/protocol.js.map +1 -1
  392. package/dist/internal/workbench/fetch.d.ts +5 -6
  393. package/dist/internal/workbench/fetch.d.ts.map +1 -1
  394. package/dist/internal/workbench/fetch.js +22 -23
  395. package/dist/internal/workbench/fetch.js.map +1 -1
  396. package/dist/internal/workbench/host-overview.d.ts +2 -2
  397. package/dist/internal/workbench/host-overview.d.ts.map +1 -1
  398. package/dist/internal/workbench/host-overview.js +1 -1
  399. package/dist/internal/workbench/host-overview.js.map +1 -1
  400. package/dist/internal/workbench/index.d.ts +0 -3
  401. package/dist/internal/workbench/index.d.ts.map +1 -1
  402. package/dist/internal/workbench/index.js +0 -3
  403. package/dist/internal/workbench/index.js.map +1 -1
  404. package/dist/internal/workbench/workbench-overview.d.ts +7 -7
  405. package/dist/internal/workbench/workbench-overview.d.ts.map +1 -1
  406. package/dist/internal/workbench/workbench-overview.js +16 -16
  407. package/dist/internal/workbench/workbench-overview.js.map +1 -1
  408. package/dist/internal/workbench/workflow-module-runner.js +0 -7
  409. package/dist/internal/workbench/workflow-module-runner.js.map +1 -1
  410. package/dist/internal/workbench/workflow.d.ts +1 -45
  411. package/dist/internal/workbench/workflow.d.ts.map +1 -1
  412. package/dist/internal/workbench/workflow.js +5 -117
  413. package/dist/internal/workbench/workflow.js.map +1 -1
  414. package/dist/runtime.d.ts +11 -0
  415. package/dist/runtime.d.ts.map +1 -0
  416. package/dist/runtime.js +6 -0
  417. package/dist/runtime.js.map +1 -0
  418. package/docs/pages/components/cli.md +23 -29
  419. package/docs/pages/components/runtime.md +112 -0
  420. package/docs/pages/guides/dashboard-over-runtime.md +87 -0
  421. package/docs/pages/guides/remote-runtime.md +109 -0
  422. package/docs/pages/index.md +33 -35
  423. package/docs/pages/operations/plugins.md +7 -7
  424. package/docs/pages/primitives/dispatch-queues.md +4 -4
  425. package/docs/pages/primitives/feed.md +3 -3
  426. package/docs/pages/primitives/workbench.md +3 -2
  427. package/docs/pages/primitives/workflow.md +19 -18
  428. package/docs/pages/reference/packages.md +18 -25
  429. package/package.json +6 -23
  430. package/dist/internal/proxy/bin/codex-toys-proxy.js +0 -837
  431. package/dist/internal/workbench/delegation-methods.d.ts +0 -40
  432. package/dist/internal/workbench/delegation-methods.d.ts.map +0 -1
  433. package/dist/internal/workbench/delegation-methods.js +0 -473
  434. package/dist/internal/workbench/delegation-methods.js.map +0 -1
  435. package/dist/internal/workbench/delegation.d.ts +0 -128
  436. package/dist/internal/workbench/delegation.d.ts.map +0 -1
  437. package/dist/internal/workbench/delegation.js +0 -345
  438. package/dist/internal/workbench/delegation.js.map +0 -1
  439. package/dist/internal/workbench/workbench-delegation.d.ts +0 -45
  440. package/dist/internal/workbench/workbench-delegation.d.ts.map +0 -1
  441. package/dist/internal/workbench/workbench-delegation.js +0 -100
  442. package/dist/internal/workbench/workbench-delegation.js.map +0 -1
  443. package/dist/proxy/browser.d.ts +0 -2
  444. package/dist/proxy/browser.d.ts.map +0 -1
  445. package/dist/proxy/browser.js +0 -2
  446. package/dist/proxy/browser.js.map +0 -1
  447. package/dist/proxy/index.d.ts +0 -2
  448. package/dist/proxy/index.d.ts.map +0 -1
  449. package/dist/proxy/index.js +0 -2
  450. package/dist/proxy/index.js.map +0 -1
  451. package/dist/proxy/vite.d.ts +0 -2
  452. package/dist/proxy/vite.d.ts.map +0 -1
  453. package/dist/proxy/vite.js +0 -2
  454. package/dist/proxy/vite.js.map +0 -1
  455. package/dist/remote.d.ts +0 -2
  456. package/dist/remote.d.ts.map +0 -1
  457. package/dist/remote.js +0 -2
  458. package/dist/remote.js.map +0 -1
  459. package/dist/toybox.d.ts +0 -2
  460. package/dist/toybox.d.ts.map +0 -1
  461. package/dist/toybox.js +0 -2
  462. package/dist/toybox.js.map +0 -1
  463. package/docs/pages/components/proxy.md +0 -62
  464. package/docs/pages/components/toybox.md +0 -108
  465. package/docs/pages/guides/dashboard-over-toybox.md +0 -145
  466. package/docs/pages/guides/delegated-repo-work.md +0 -119
  467. package/docs/pages/guides/remote-codex-workbench.md +0 -147
  468. package/docs/pages/primitives/delegation.md +0 -74
@@ -0,0 +1,87 @@
1
+ ---
2
+ title: Dashboard Over Runtime
3
+ description: Build a browser dashboard backed by the codex-toys runtime HTTP edge and workspace functions.
4
+ ---
5
+
6
+ # Dashboard Over Runtime
7
+
8
+ A dashboard over runtime is a browser UI that talks to `codex-toys runtime http`.
9
+ The HTTP edge forwards generic app, workbench, and function calls to the same
10
+ runtime used by CLI and SSH operation. It does not create a separate durable
11
+ dashboard surface or custom thread registry.
12
+
13
+ ## Serve Static Files
14
+
15
+ ```bash
16
+ codex-toys runtime http --cwd . --static ./dashboard
17
+ ```
18
+
19
+ The dashboard can call same-origin `/api/*` routes:
20
+
21
+ ```text
22
+ GET /api/status
23
+ GET /api/schema
24
+ POST /api/rpc
25
+ POST /api/app/:method
26
+ POST /api/workbench/:method
27
+ POST /api/workbench/overview
28
+ ```
29
+
30
+ ## Browser Client
31
+
32
+ ```ts
33
+ import { createCodexToysBrowserClient } from "codex-toys/runtime";
34
+
35
+ const codexToys = createCodexToysBrowserClient();
36
+ const overview = await codexToys.workbench.call("workbench.overview", {});
37
+ const threads = await codexToys.app.call("thread/list", {
38
+ limit: 20,
39
+ sourceKinds: [],
40
+ });
41
+ const functions = await codexToys.functions.list();
42
+ ```
43
+
44
+ Prefer workspace functions for product-specific data. They keep dashboard
45
+ semantics in the workspace instead of baking product routes into codex-toys.
46
+
47
+ ## Vite Middleware
48
+
49
+ ```ts
50
+ import { codexToysRuntime } from "codex-toys/runtime";
51
+
52
+ export default {
53
+ plugins: [
54
+ codexToysRuntime({
55
+ cwd: ".",
56
+ }),
57
+ ],
58
+ };
59
+ ```
60
+
61
+ The Vite plugin serves the runtime API under `/__codex_toys/api`. Point the
62
+ browser client at that base path:
63
+
64
+ ```ts
65
+ const codexToys = createCodexToysBrowserClient({
66
+ basePath: "/__codex_toys/api",
67
+ });
68
+ ```
69
+
70
+ ## Remote Runtime Without Remote HTTP
71
+
72
+ Run the HTTP edge locally and connect it to a remote runtime over SSH:
73
+
74
+ ```bash
75
+ codex-toys runtime http \
76
+ --ssh workbox \
77
+ --cwd /srv/codex/workspaces/ops \
78
+ --static ./dashboard
79
+ ```
80
+
81
+ The browser talks to localhost. The remote host exposes no HTTP port.
82
+
83
+ ## Boundary
84
+
85
+ The runtime HTTP edge owns transport, schema discovery, browser helpers, and
86
+ forwarding. The workspace owns dashboard data through functions. Native Codex
87
+ owns thread creation, thread opening, archive/delete, and app UI updates.
@@ -0,0 +1,109 @@
1
+ ---
2
+ title: Remote Runtime
3
+ description: Operate a Codex workspace on an SSH host through codex-toys runtime stdio.
4
+ ---
5
+
6
+ # Remote Runtime
7
+
8
+ A remote runtime is a Codex environment on a VPS or SSH host that is controlled
9
+ from local commands. The remote machine owns Codex auth, config, sessions,
10
+ memories, and workspace state. The local machine starts a short-lived
11
+ `codex-toys runtime serve` process over SSH stdio for each command.
12
+
13
+ ## Prepare The Host
14
+
15
+ Install these on the remote host:
16
+
17
+ - Node 24
18
+ - Codex CLI
19
+ - `codex-toys`
20
+ - a working shell for non-interactive SSH
21
+
22
+ Authenticate Codex on the remote host. Commands sent through `--ssh` use the
23
+ remote Codex home and remote config; they do not use local Codex auth.
24
+
25
+ ## Check Connectivity
26
+
27
+ ```bash
28
+ codex-toys --ssh <host-or-alias> --cwd /srv/codex/workspaces/ops runtime preflight --json
29
+ ```
30
+
31
+ Preflight checks SSH, cwd, Node, Codex, codex-toys, runtime startup, and native
32
+ app-server initialization.
33
+
34
+ ## Configure PATH
35
+
36
+ Non-interactive SSH shells often have a smaller PATH than login shells. Use
37
+ explicit command paths or prepend entries:
38
+
39
+ ```bash
40
+ codex-toys --ssh workbox \
41
+ --cwd /srv/codex/workspaces/ops \
42
+ --remote-path-prepend /opt/node/bin:/usr/local/bin \
43
+ --runtime-command /usr/local/bin/codex-toys \
44
+ --codex-command /usr/local/bin/codex \
45
+ runtime preflight --json
46
+ ```
47
+
48
+ Environment equivalents:
49
+
50
+ ```text
51
+ CODEX_TOYS_REMOTE_SSH_TARGET=workbox
52
+ CODEX_TOYS_REMOTE_CWD=/srv/codex/workspaces/ops
53
+ CODEX_TOYS_REMOTE_PATH_PREPEND=/opt/node/bin:/usr/local/bin
54
+ CODEX_TOYS_RUNTIME_COMMAND=/usr/local/bin/codex-toys
55
+ CODEX_TOYS_REMOTE_CODEX_COMMAND=/usr/local/bin/codex
56
+ CODEX_TOYS_REMOTE_CODEX_ARGS=["-s","danger-full-access"]
57
+ ```
58
+
59
+ ## Run Remote Work
60
+
61
+ Use direct remote calls for quick checks:
62
+
63
+ ```bash
64
+ codex-toys --ssh workbox --cwd /srv/codex/workspaces/ops fetch
65
+ codex-toys --ssh workbox --cwd /srv/codex/workspaces/ops functions list --json
66
+ codex-toys --ssh workbox --cwd /srv/codex/workspaces/ops workflow run release-check --event event.json
67
+ codex-toys --ssh workbox --cwd /srv/codex/workspaces/ops turn run "Scan current folder" --wait
68
+ ```
69
+
70
+ SSH-backed `turn run` must wait because the remote runtime exits when the
71
+ command exits. Use prompt queues, dispatch queues, workflows, or native Codex
72
+ threads for work that should continue independently.
73
+
74
+ ## Inspect Remote State
75
+
76
+ Remote state stays remote:
77
+
78
+ ```text
79
+ <remote-workspace>/.codex/workbench/local/
80
+ <remote-workspace>/.codex/feed/local/
81
+ <remote-codex-home>/sessions/
82
+ <remote-codex-home>/memories/
83
+ ```
84
+
85
+ `codex-toys` does not copy remote Codex sessions, memories, or workbench state.
86
+ Use the Codex App and native thread links for app-native thread discovery.
87
+
88
+ ## Browser Access
89
+
90
+ For a browser UI, run the HTTP edge locally and let it speak SSH to the remote
91
+ runtime:
92
+
93
+ ```bash
94
+ codex-toys runtime http \
95
+ --ssh workbox \
96
+ --cwd /srv/codex/workspaces/ops \
97
+ --static ./dashboard
98
+ ```
99
+
100
+ The browser talks to localhost. The remote host still exposes no HTTP port.
101
+
102
+ ## Troubleshooting
103
+
104
+ - `runtime preflight` fails before runtime startup: SSH target, remote cwd,
105
+ remote PATH, Node, Codex, or codex-toys is missing.
106
+ - Runtime starts but app calls fail: inspect remote Codex auth and remote Codex
107
+ config.
108
+ - SSH prompt turns need `--wait`: use native Codex threads, queues, or workflows
109
+ for supervised background work.
@@ -1,26 +1,26 @@
1
1
  ---
2
2
  title: codex-toys
3
- description: Primitive-first documentation for codex-toys workflow, workbench, feed, components, guides, and Codex state helpers.
3
+ description: Primitive-first documentation for codex-toys workflow, runtime, feed, templates, and Codex state helpers.
4
4
  ---
5
5
 
6
6
  # codex-toys
7
7
 
8
- `codex-toys` is a workbench layer for Codex. It gives a repository or operator
9
- process a small set of primitives for running code before Codex turns, operating
10
- local or SSH-backed workbenches, ingesting external or manual feed signals,
11
- dispatching durable work, and moving durable Codex state between homes.
8
+ `codex-toys` is a small workspace layer around native Codex. Native Codex owns
9
+ threads, turns, app UI, plugins, skills, hooks, auth, model settings, and app
10
+ automations. `codex-toys` owns workspace templates, workspace functions,
11
+ workflow execution, feed intake, explicit queues, Actions/runtime scaffolding,
12
+ runtime transports, and Codex state utilities.
12
13
 
13
14
  The public npm package is `codex-toys`. Internal `@codex-toys/*` packages are
14
- feature boundaries that are embedded into the public tarball and exposed through
15
- `codex-toys/*` subpaths.
15
+ implementation boundaries that are embedded into the public tarball and exposed
16
+ through focused `codex-toys/*` subpaths.
16
17
 
17
18
  ## Primitive Map
18
19
 
19
20
  | Primitive | Owns | Start here |
20
21
  |-----------|------|------------|
21
- | Workflow | A script that inspects state and can start, read, wait on, or delegate Codex turns. | [Workflow](primitives/workflow) |
22
+ | Workflow | A script that inspects state and can start, read, or wait on native Codex turns. | [Workflow](primitives/workflow) |
22
23
  | Workbench | Repo-local config, modes, explicit tasks, functions, health, and overview. | [Workbench](primitives/workbench) |
23
- | Delegation | Starting and tracking Codex work in another workbench-relative cwd. | [Delegation](primitives/delegation) |
24
24
  | Dispatch And Queues | Durable future intents, prompt queues, handoff queues, attempts, and collection. | [Dispatch and queues](primitives/dispatch-queues) |
25
25
  | Feed | RSS/Atom and manual intake, item storage, cursors, and ack-aware dispatch. | [Feed](primitives/feed) |
26
26
 
@@ -28,9 +28,8 @@ feature boundaries that are embedded into the public tarball and exposed through
28
28
 
29
29
  | Component | Owns | Start here |
30
30
  |-----------|------|------------|
31
- | Toybox | The stdio JSON-RPC workbench control surface used locally and over SSH. | [Toybox](components/toybox) |
32
- | Proxy | Optional HTTP edge for browser dashboards. | [Proxy](components/proxy) |
33
- | Kits | Repo-local copies of skills, plugins, and workflow templates. | [Kits](components/kits) |
31
+ | Runtime | Local stdio, SSH stdio, and optional HTTP/browser transport over the same app/workbench/function methods. | [Runtime](components/runtime) |
32
+ | Kits | Workspace templates installed from local or Git sources. | [Kits](components/kits) |
34
33
  | CLI | Command porcelain over primitives and components. | [CLI](components/cli) |
35
34
 
36
35
  ## Guides
@@ -38,12 +37,11 @@ feature boundaries that are embedded into the public tarball and exposed through
38
37
  | Guide | Use it when |
39
38
  |-------|-------------|
40
39
  | [Repository autonomy](guides/repository-autonomy) | A repo should run its workbench on a GitHub Actions schedule and commit durable Codex state back to itself. |
41
- | [Remote Codex workbench](guides/remote-codex-workbench) | A VPS or SSH host should run a separate Codex workbench controlled from local commands. |
40
+ | [Remote runtime](guides/remote-runtime) | A VPS or SSH host should run Codex work while local commands control it over SSH stdio. |
42
41
  | [Local scheduled workbench](guides/local-scheduled-workbench) | A trusted local machine should run explicit workbench or feed commands on systemd user timers. |
43
- | [Dashboard over toybox](guides/dashboard-over-toybox) | A browser UI should inspect or operate a local or SSH-backed workbench through the proxy. |
42
+ | [Dashboard over runtime](guides/dashboard-over-runtime) | A browser UI should inspect or operate a local or SSH-backed workspace through the runtime HTTP edge. |
44
43
  | [Feed to workflow](guides/feed-to-workflow) | RSS or Atom items should dispatch into workflow-backed workbench tasks. |
45
- | [Capability kit setup](guides/capability-kit-setup) | A workbench should install checked-in local skills, plugins, or workflows from a kit. |
46
- | [Delegated repo work](guides/delegated-repo-work) | A controlling workbench should start and track Codex work in another checkout. |
44
+ | [Capability kit setup](guides/capability-kit-setup) | A workspace should install checked-in local templates from a kit. |
47
45
 
48
46
  ## Operations
49
47
 
@@ -56,45 +54,46 @@ feature boundaries that are embedded into the public tarball and exposed through
56
54
 
57
55
  ```bash
58
56
  codex-toys fetch
59
- codex-toys toybox serve --cwd <workbench>
57
+ codex-toys runtime serve --cwd <workspace>
58
+ codex-toys runtime http --cwd <workspace> --static ./dashboard
60
59
  codex-toys workflow list
61
60
  codex-toys workflow run <name> --event event.json
62
61
  codex-toys workbench doctor
62
+ codex-toys functions list --json
63
63
  codex-toys feed poll --json
64
64
  codex-toys workbench prompt enqueue "Review this later."
65
65
  codex-toys workbench dispatch list --json
66
66
  ```
67
67
 
68
- Run the same workbench over SSH without opening a remote port:
68
+ Run the same workspace over SSH without opening a remote port:
69
69
 
70
70
  ```bash
71
- codex-toys --ssh <target> --cwd <remote-workbench> fetch
72
- codex-toys --ssh <target> --cwd <remote-workbench> workflow run <name> --event event.json
73
- codex-toys --ssh <target> --cwd <remote-workbench> workbench dispatch collect --cursor operator --json
71
+ codex-toys --ssh <target> --cwd <remote-workspace> fetch
72
+ codex-toys --ssh <target> --cwd <remote-workspace> runtime preflight --json
73
+ codex-toys --ssh <target> --cwd <remote-workspace> workflow run <name> --event event.json
74
+ codex-toys --ssh <target> --cwd <remote-workspace> functions list --json
75
+ codex-toys --ssh <target> --cwd <remote-workspace> turn run "Scan current folder" --wait
74
76
  ```
75
77
 
76
78
  ## Runtime Shape
77
79
 
78
- Local CLI commands spawn `codex-toys toybox serve` over stdio when they need
79
- workbench methods. SSH commands start that same toybox on the remote host and
80
- speak JSON-RPC over SSH stdio. Core commands do not expose HTTP or WebSocket
81
- servers.
82
-
83
- Browser dashboards opt into HTTP explicitly with `codex-toys-proxy`. The proxy
84
- forwards generic app and workbench calls to the toybox instead of creating a
85
- second product model.
80
+ Local CLI commands spawn `codex-toys runtime serve` over stdio when they need
81
+ workspace methods. SSH commands start that same stdio runtime on the remote
82
+ host and speak JSON-RPC over SSH stdio. Browser dashboards opt into HTTP with
83
+ `codex-toys runtime http`, which forwards generic app, workbench, and function
84
+ calls to the runtime instead of creating a second product API.
86
85
 
87
86
  ## Boundary
88
87
 
89
88
  `codex-toys` owns reusable mechanics:
90
89
 
91
90
  - Codex app-server bridge helpers
92
- - toybox transport and method metadata
91
+ - runtime transport and method metadata
93
92
  - workflow script execution and host helpers
94
93
  - feed intake and cursor state
95
- - workbench tasks, functions, queues, delegation, and overview
94
+ - workbench tasks, functions, queues, and overview
96
95
  - memory and thread rollout file moves
97
- - kit inspection and repo-local installation
96
+ - kit inspection and workspace-template installation
98
97
 
99
98
  Installing products own domain completion: credentials, source catalogs, scoring,
100
99
  prompt policy, deployment decisions, branch or release policy, external writes,
@@ -113,9 +112,8 @@ Install Codex-facing guidance from the shared plugin marketplace:
113
112
  ```bash
114
113
  codex plugin marketplace add peezy-tech/skills --ref main
115
114
  codex plugin add codex-toys-author@peezy-tech
116
- codex plugin add codex-toys-local-workbench@peezy-tech
115
+ codex plugin add codex-toys-local-workspace@peezy-tech
117
116
  codex plugin add codex-toys-remote-control@peezy-tech
118
117
  ```
119
118
 
120
- Use kits only when a workbench intentionally wants repo-local copies of skills,
121
- plugins, or workflow templates.
119
+ Use kits only when a workspace intentionally wants repo-local templates.
@@ -6,15 +6,15 @@ description: Install codex-toys Codex-facing guidance from a Git-backed marketpl
6
6
  # Plugins
7
7
 
8
8
  The npm package installs the CLI and runtime APIs. Codex plugins install
9
- Codex-facing guidance such as workflow authoring, local toybox operation, and
10
- remote workbench operation.
9
+ Codex-facing guidance such as workflow authoring, local runtime operation, and
10
+ remote workspace operation.
11
11
 
12
12
  ## Shared Marketplace
13
13
 
14
14
  ```bash
15
15
  codex plugin marketplace add peezy-tech/skills --ref main
16
16
  codex plugin add codex-toys-author@peezy-tech
17
- codex plugin add codex-toys-local-workbench@peezy-tech
17
+ codex plugin add codex-toys-local-workspace@peezy-tech
18
18
  codex plugin add codex-toys-remote-control@peezy-tech
19
19
  ```
20
20
 
@@ -26,8 +26,8 @@ is reloaded.
26
26
  | Plugin | Use it for |
27
27
  |--------|------------|
28
28
  | `codex-toys-author` | Writing or reviewing workflow scripts. |
29
- | `codex-toys-local-workbench` | Operating local toyboxes and proxy dashboards. |
30
- | `codex-toys-remote-control` | Operating SSH-backed workbenches from a local Codex App. |
29
+ | `codex-toys-local-workspace` | Operating local runtimes and HTTP dashboards. |
30
+ | `codex-toys-remote-control` | Operating SSH-backed workspaces from a local Codex App. |
31
31
 
32
32
  The root `codex-toys` plugin is for product-local development against this repo.
33
33
  Prefer the granular plugins for normal use.
@@ -39,7 +39,7 @@ When iterating on this checkout, add the checkout root as a local marketplace:
39
39
  ```bash
40
40
  codex plugin marketplace add <codex-toys-checkout>
41
41
  codex plugin add codex-toys-author@codex-toys
42
- codex plugin add codex-toys-local-workbench@codex-toys
42
+ codex plugin add codex-toys-local-workspace@codex-toys
43
43
  codex plugin add codex-toys-remote-control@codex-toys
44
44
  ```
45
45
 
@@ -49,4 +49,4 @@ upgrade the affected plugin and start a new thread.
49
49
  ## Runtime Boundary
50
50
 
51
51
  Plugin install does not start a service. The CLI, MCP server, workflow runs,
52
- functions, delegation, and proxy all use the normal toybox/proxy runtime paths.
52
+ functions, and optional HTTP edge all use the normal runtime paths.
@@ -110,10 +110,10 @@ codex-toys workbench handoff drain \
110
110
  ## SSH
111
111
 
112
112
  SSH is transport, not a third queue. With `--ssh`, queue commands operate on the
113
- remote workbench's local queue through the remote toybox.
113
+ remote workspace's local queue through the remote runtime.
114
114
 
115
115
  ```bash
116
- codex-toys --ssh <target> --cwd <remote-workbench> workbench dispatch list --json
117
- codex-toys --ssh <target> --cwd <remote-workbench> workbench prompt run-due --limit 1
118
- codex-toys --ssh <target> --cwd <remote-workbench> workbench handoff collect --cursor operator --json
116
+ codex-toys --ssh <target> --cwd <remote-workspace> workbench dispatch list --json
117
+ codex-toys --ssh <target> --cwd <remote-workspace> workbench prompt run-due --limit 1
118
+ codex-toys --ssh <target> --cwd <remote-workspace> workbench handoff collect --cursor operator --json
119
119
  ```
@@ -51,12 +51,12 @@ codex-toys feed dispatch --source project-releases --cursor radar --target workb
51
51
  codex-toys feed prune --older-than-days 90 --dry-run
52
52
  ```
53
53
 
54
- With `--ssh`, the local CLI starts the remote toybox and calls the same feed
54
+ With `--ssh`, the local CLI starts the remote runtime and calls the same feed
55
55
  methods in the remote root selected by `--cwd`.
56
56
 
57
57
  ```bash
58
- codex-toys --ssh <target> --cwd <remote-workbench> feed poll --json
59
- codex-toys --ssh <target> --cwd <remote-workbench> feed collect --cursor radar --json
58
+ codex-toys --ssh <target> --cwd <remote-workspace> feed poll --json
59
+ codex-toys --ssh <target> --cwd <remote-workspace> feed collect --cursor radar --json
60
60
  ```
61
61
 
62
62
  ## State
@@ -131,6 +131,7 @@ where that history belongs in git.
131
131
  - functions
132
132
  - recent cwd threads
133
133
  - git state
134
- - health checks for Node, codex-toys, Codex, toybox, app-server, and config
134
+ - health checks for Node, codex-toys, Codex, runtime transport, app-server, and config
135
135
 
136
- The proxy exposes the same data through `POST /api/workbench/overview`.
136
+ The runtime HTTP edge exposes the same data through
137
+ `POST /api/workbench/overview`.
@@ -8,14 +8,13 @@ description: The codex-toys primitive for running script code before composing n
8
8
  Workflow is the pre-turn orchestration primitive. A workflow runs a JavaScript or
9
9
  TypeScript module, gives it a JSON context, and records the JSON object returned
10
10
  by the module. The script can decide to skip, return data, start a Codex turn,
11
- wait on several turns, or delegate work through the toybox.
11
+ or wait on several native Codex turns.
12
12
 
13
13
  ```text
14
14
  event, schedule, or operator command
15
15
  -> workflow script
16
16
  -> return JSON
17
17
  -> optionally call context.turn.*
18
- -> optionally call context.delegate.*
19
18
  ```
20
19
 
21
20
  The CLI does not interpret returned `action` fields. The script owns its own
@@ -63,7 +62,7 @@ codex-toys workflow run --script ./check.ts --event event.json
63
62
  printf '%s\n' 'export default () => ({ status: "ok" })' | codex-toys workflow run --script-stdin
64
63
  ```
65
64
 
66
- By default, workflow turns use the workbench toybox surface. Use `--via app`
65
+ By default, workflow turns use the workbench runtime surface. Use `--via app`
67
66
  only when deliberately targeting direct app-server calls without workbench
68
67
  helpers.
69
68
 
@@ -75,8 +74,8 @@ codex-toys workflow run release-check --event event.json --via app
75
74
  Run the workflow on a remote host through SSH stdio:
76
75
 
77
76
  ```bash
78
- codex-toys --ssh <target> --cwd <remote-workbench> workflow list --json
79
- codex-toys --ssh <target> --cwd <remote-workbench> workflow run release-check --event event.json
77
+ codex-toys --ssh <target> --cwd <remote-workspace> workflow list --json
78
+ codex-toys --ssh <target> --cwd <remote-workspace> workflow run release-check --event event.json
80
79
  ```
81
80
 
82
81
  With `--ssh`, discovery, named resolution, event loading, and script execution
@@ -114,14 +113,11 @@ The context includes:
114
113
  Host helpers include:
115
114
 
116
115
  - `context.app.call(method, params)`
117
- - `context.workbench.call(method, params)`, only through the toybox surface
116
+ - `context.workbench.call(method, params)`, only through the runtime surface
118
117
  - `context.turn.start(params)`
119
118
  - `context.turn.read(turn)`
120
119
  - `context.turn.wait(turn, options)`
121
120
  - `context.turn.waitAll(turns, options)`
122
- - `context.delegate.start(params)`, only through the toybox surface
123
- - `context.delegate.read(delegation)`
124
- - `context.delegate.wait(delegation, options)`
125
121
 
126
122
  ## Turn Fields
127
123
 
@@ -143,25 +139,30 @@ Host helpers include:
143
139
  Do not combine a sandbox mode with a permissions profile unless the target Codex
144
140
  host explicitly supports that combination.
145
141
 
146
- ## Delegated Work
142
+ ## Background Work
147
143
 
148
- Use delegation when the work belongs in another checkout under the same
149
- workbench root.
144
+ Workflow does not create a second thread registry. When background work belongs
145
+ in another checkout, start or resume native Codex turns directly through
146
+ `context.turn.*`, dispatch queues, or explicit app-server calls, then return the
147
+ thread id and `codex://thread/<id>` link from the script result.
150
148
 
151
149
  ```ts
152
150
  export default async function run(context) {
153
- const delegation = await context.delegate.start({
151
+ const turn = await context.turn.start({
154
152
  cwd: "@/repos/example",
155
- prompt: "Inspect this repository and summarize risks.",
156
- returnMode: "wake_on_done"
153
+ prompt: "Inspect this repository and summarize risks."
157
154
  });
158
155
 
159
- return { status: "delegated", delegation };
156
+ return {
157
+ status: "started",
158
+ threadId: turn.threadId,
159
+ threadUrl: turn.threadId ? `codex://thread/${turn.threadId}` : undefined
160
+ };
160
161
  }
161
162
  ```
162
163
 
163
- `context.delegate.*` requires `--via workbench`, because delegation is a toybox
164
- method, not a direct app-server method.
164
+ Native Codex owns thread discovery, open links, archive/delete, fork, resume,
165
+ and app UI control.
165
166
 
166
167
  ## Workbench Tasks
167
168
 
@@ -26,11 +26,6 @@ import { v2 } from "codex-toys/bridge/generated";
26
26
  import { parseJsonText } from "codex-toys/bridge/json";
27
27
  ```
28
28
 
29
- ## `codex-toys/toybox`
30
-
31
- Stdio JSON-RPC protocol, client, and server primitives for local and SSH-backed
32
- toyboxes. Use it when another process needs to host or call a toybox directly.
33
-
34
29
  ## `codex-toys/feed`
35
30
 
36
31
  Feed intake helpers:
@@ -42,7 +37,7 @@ Feed intake helpers:
42
37
  - durable feed item storage
43
38
  - collection cursors
44
39
  - dispatch and pruning
45
- - toybox method factories and metadata
40
+ - runtime method factories and metadata
46
41
 
47
42
  ```ts
48
43
  import {
@@ -59,10 +54,9 @@ import {
59
54
  Workbench runtime and policy helpers:
60
55
 
61
56
  - workflow script execution and workflow host helpers
62
- - remote workflow toybox methods
57
+ - remote workflow runtime methods
63
58
  - workbench doctor, task execution, dispatch drains, and Actions scaffolding
64
59
  - dispatch runs, prompt queue, and local handoff queue
65
- - delegation methods and state
66
60
  - workbench functions
67
61
  - workbench and host overview
68
62
  - thread presentation helpers and request descriptors
@@ -100,22 +94,21 @@ system packages. The generated Actions-mode workflow uses
100
94
  release feed publishes `codex-<codex-version>` tags that bake native Codex into
101
95
  the image before the bindings workflow runs.
102
96
 
103
- ## `codex-toys/remote`
104
-
105
- SSH-backed transport and preflight helpers. This package creates toybox
106
- transports over SSH stdio, resolves remote options, performs remote preflight,
107
- and supports remote-control status helpers without exposing remote HTTP ports.
108
-
109
- ## `codex-toys/proxy`
97
+ ## `codex-toys/runtime`
110
98
 
111
- Optional HTTP edge for dashboards. Public entry points include:
99
+ Runtime/connect helpers for local stdio, SSH stdio, browser clients, and the
100
+ optional HTTP edge. This is the public surface for all codex-toys transport
101
+ paths.
112
102
 
113
- - `codex-toys/proxy`
114
- - `codex-toys/proxy/browser`
115
- - `codex-toys/proxy/vite`
116
- - `codex-toys-proxy`
117
-
118
- The proxy forwards generic app and workbench methods to a toybox.
103
+ ```ts
104
+ import {
105
+ CodexRuntimeClient,
106
+ createSshRuntimeTransport,
107
+ createCodexToysRuntimeHttpHandler,
108
+ createCodexToysBrowserClient,
109
+ codexToysRuntime
110
+ } from "codex-toys/runtime";
111
+ ```
119
112
 
120
113
  ## `codex-toys/kits`
121
114
 
@@ -126,6 +119,6 @@ workflow templates. Kits read optional `codex-kit.toml` manifests, write
126
119
 
127
120
  ## `codex-toys`
128
121
 
129
- The CLI package and umbrella runtime export. It publishes the `codex-toys` and
130
- `codex-toys-proxy` binaries, re-exports the focused runtime surfaces, and
131
- ships a version-matched Markdown docs snapshot under `docs/pages`.
122
+ The CLI package and umbrella runtime export. It publishes the `codex-toys`
123
+ binary, re-exports the focused runtime surfaces, and ships a version-matched
124
+ Markdown docs snapshot under `docs/pages`.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "codex-toys",
3
- "version": "0.140.13",
4
- "description": "Codex CLI and umbrella runtime export for bridge, toybox, feed, remote, workbench, actions, proxy, and kits.",
3
+ "version": "0.140.15",
4
+ "description": "Codex CLI and umbrella runtime export for bridge, runtime, feed, workbench, actions, and kits.",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
7
7
  "repository": {
@@ -18,8 +18,7 @@
18
18
  "sideEffects": false,
19
19
  "types": "./dist/index.d.ts",
20
20
  "bin": {
21
- "codex-toys": "dist/cli/index.js",
22
- "codex-toys-proxy": "dist/internal/proxy/bin/codex-toys-proxy.js"
21
+ "codex-toys": "dist/cli/index.js"
23
22
  },
24
23
  "files": [
25
24
  "dist",
@@ -74,25 +73,9 @@
74
73
  "types": "./dist/kits.d.ts",
75
74
  "import": "./dist/kits.js"
76
75
  },
77
- "./proxy": {
78
- "types": "./dist/proxy/index.d.ts",
79
- "import": "./dist/proxy/index.js"
80
- },
81
- "./proxy/browser": {
82
- "types": "./dist/proxy/browser.d.ts",
83
- "import": "./dist/proxy/browser.js"
84
- },
85
- "./proxy/vite": {
86
- "types": "./dist/proxy/vite.d.ts",
87
- "import": "./dist/proxy/vite.js"
88
- },
89
- "./remote": {
90
- "types": "./dist/remote.d.ts",
91
- "import": "./dist/remote.js"
92
- },
93
- "./toybox": {
94
- "types": "./dist/toybox.d.ts",
95
- "import": "./dist/toybox.js"
76
+ "./runtime": {
77
+ "types": "./dist/runtime.d.ts",
78
+ "import": "./dist/runtime.js"
96
79
  },
97
80
  "./workbench": {
98
81
  "types": "./dist/workbench.d.ts",