@downcity/agent 1.1.73 → 1.1.79

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 (390) hide show
  1. package/README.md +26 -28
  2. package/bin/agent/{Agent.d.ts → local/Agent.d.ts} +8 -36
  3. package/bin/agent/local/Agent.d.ts.map +1 -0
  4. package/bin/agent/{Agent.js → local/Agent.js} +45 -200
  5. package/bin/agent/local/Agent.js.map +1 -0
  6. package/bin/agent/local/AgentInstructions.d.ts +22 -0
  7. package/bin/agent/local/AgentInstructions.d.ts.map +1 -0
  8. package/bin/agent/local/AgentInstructions.js +57 -0
  9. package/bin/agent/local/AgentInstructions.js.map +1 -0
  10. package/bin/agent/local/AgentPluginFactory.d.ts +29 -0
  11. package/bin/agent/local/AgentPluginFactory.d.ts.map +1 -0
  12. package/bin/agent/local/AgentPluginFactory.js +53 -0
  13. package/bin/agent/local/AgentPluginFactory.js.map +1 -0
  14. package/bin/{runtime/host/AgentHostRuntime.d.ts → agent/local/AgentRuntimeAssembly.d.ts} +2 -2
  15. package/bin/agent/local/AgentRuntimeAssembly.d.ts.map +1 -0
  16. package/bin/{runtime/host/AgentHostRuntime.js → agent/local/AgentRuntimeAssembly.js} +2 -2
  17. package/bin/agent/local/AgentRuntimeAssembly.js.map +1 -0
  18. package/bin/agent/local/AgentRuntimeFactory.d.ts +72 -0
  19. package/bin/agent/local/AgentRuntimeFactory.d.ts.map +1 -0
  20. package/bin/agent/local/AgentRuntimeFactory.js +94 -0
  21. package/bin/agent/local/AgentRuntimeFactory.js.map +1 -0
  22. package/bin/{runtime/host → agent/local}/ProjectSetup.d.ts +1 -1
  23. package/bin/agent/local/ProjectSetup.d.ts.map +1 -0
  24. package/bin/{runtime/host → agent/local}/ProjectSetup.js +1 -1
  25. package/bin/agent/local/ProjectSetup.js.map +1 -0
  26. package/bin/agent/{RemoteAgent.d.ts → remote/RemoteAgent.d.ts} +3 -3
  27. package/bin/agent/remote/RemoteAgent.d.ts.map +1 -0
  28. package/bin/agent/remote/RemoteAgent.js +58 -0
  29. package/bin/agent/remote/RemoteAgent.js.map +1 -0
  30. package/bin/agent/remote/RemoteSession.d.ts +62 -0
  31. package/bin/agent/remote/RemoteSession.d.ts.map +1 -0
  32. package/bin/agent/remote/RemoteSession.js +225 -0
  33. package/bin/agent/remote/RemoteSession.js.map +1 -0
  34. package/bin/agent/remote/RemoteTransport.d.ts +52 -0
  35. package/bin/agent/remote/RemoteTransport.d.ts.map +1 -0
  36. package/bin/agent/remote/RemoteTransport.js +9 -0
  37. package/bin/agent/remote/RemoteTransport.js.map +1 -0
  38. package/bin/agent/remote/TransportFactory.d.ts +13 -0
  39. package/bin/agent/remote/TransportFactory.d.ts.map +1 -0
  40. package/bin/agent/remote/TransportFactory.js +22 -0
  41. package/bin/agent/remote/TransportFactory.js.map +1 -0
  42. package/bin/agent/remote/transports/HttpRemoteAgentTransport.d.ts +35 -0
  43. package/bin/agent/remote/transports/HttpRemoteAgentTransport.d.ts.map +1 -0
  44. package/bin/agent/remote/transports/HttpRemoteAgentTransport.js +259 -0
  45. package/bin/agent/remote/transports/HttpRemoteAgentTransport.js.map +1 -0
  46. package/bin/agent/remote/transports/RpcRemoteAgentTransport.d.ts +34 -0
  47. package/bin/agent/remote/transports/RpcRemoteAgentTransport.d.ts.map +1 -0
  48. package/bin/agent/remote/transports/RpcRemoteAgentTransport.js +66 -0
  49. package/bin/agent/remote/transports/RpcRemoteAgentTransport.js.map +1 -0
  50. package/bin/config/AgentInitializer.d.ts +1 -1
  51. package/bin/config/AgentInitializer.js +1 -1
  52. package/bin/executor/Executor.d.ts +4 -0
  53. package/bin/executor/Executor.d.ts.map +1 -1
  54. package/bin/executor/Executor.js +52 -35
  55. package/bin/executor/Executor.js.map +1 -1
  56. package/bin/executor/composer/history/SessionHistoryWriter.js +2 -2
  57. package/bin/executor/composer/history/SessionHistoryWriter.js.map +1 -1
  58. package/bin/executor/composer/system/default/assets/core.prompt.d.ts +1 -1
  59. package/bin/executor/composer/system/default/assets/core.prompt.d.ts.map +1 -1
  60. package/bin/executor/composer/system/default/assets/core.prompt.js +1 -1
  61. package/bin/executor/composer/system/default/assets/core.prompt.js.map +1 -1
  62. package/bin/executor/messages/AssistantResultPersistence.d.ts +3 -3
  63. package/bin/executor/messages/AssistantResultPersistence.d.ts.map +1 -1
  64. package/bin/executor/messages/AssistantResultPersistence.js +2 -6
  65. package/bin/executor/messages/AssistantResultPersistence.js.map +1 -1
  66. package/bin/executor/messages/SessionStepEventMapper.d.ts +7 -8
  67. package/bin/executor/messages/SessionStepEventMapper.d.ts.map +1 -1
  68. package/bin/executor/messages/SessionStepEventMapper.js +55 -86
  69. package/bin/executor/messages/SessionStepEventMapper.js.map +1 -1
  70. package/bin/executor/messages/UserVisibleText.d.ts +2 -10
  71. package/bin/executor/messages/UserVisibleText.d.ts.map +1 -1
  72. package/bin/executor/messages/UserVisibleText.js +3 -16
  73. package/bin/executor/messages/UserVisibleText.js.map +1 -1
  74. package/bin/executor/store/history/SessionHistoryStore.d.ts +12 -0
  75. package/bin/executor/store/history/SessionHistoryStore.d.ts.map +1 -1
  76. package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.d.ts +12 -0
  77. package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.d.ts.map +1 -1
  78. package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.js +145 -8
  79. package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.js.map +1 -1
  80. package/bin/executor/tools/shell/ShellToolFormatting.d.ts +1 -10
  81. package/bin/executor/tools/shell/ShellToolFormatting.d.ts.map +1 -1
  82. package/bin/executor/tools/shell/ShellToolFormatting.js +1 -39
  83. package/bin/executor/tools/shell/ShellToolFormatting.js.map +1 -1
  84. package/bin/executor/types/SessionHistoryPaths.d.ts +4 -0
  85. package/bin/executor/types/SessionHistoryPaths.d.ts.map +1 -1
  86. package/bin/index.d.ts +5 -5
  87. package/bin/index.d.ts.map +1 -1
  88. package/bin/index.js +3 -3
  89. package/bin/index.js.map +1 -1
  90. package/bin/plugin/core/PluginCommandRequest.d.ts +1 -1
  91. package/bin/plugin/core/PluginCommandRequest.js +1 -1
  92. package/bin/plugin/core/PluginLocalExecution.js +1 -1
  93. package/bin/plugin/core/PluginLocalExecution.js.map +1 -1
  94. package/bin/plugin/core/ProjectConfigStore.d.ts +3 -2
  95. package/bin/plugin/core/ProjectConfigStore.d.ts.map +1 -1
  96. package/bin/plugin/core/ProjectConfigStore.js +3 -4
  97. package/bin/plugin/core/ProjectConfigStore.js.map +1 -1
  98. package/bin/plugin/types/Plugin.d.ts +10 -842
  99. package/bin/plugin/types/Plugin.d.ts.map +1 -1
  100. package/bin/plugin/types/Plugin.js +3 -4
  101. package/bin/plugin/types/Plugin.js.map +1 -1
  102. package/bin/plugin/types/PluginApi.d.ts +1 -1
  103. package/bin/plugin/types/PluginApi.js +1 -1
  104. package/bin/plugin/types/PluginState.d.ts +1 -1
  105. package/bin/plugin/types/PluginState.d.ts.map +1 -1
  106. package/bin/rpc/Client.d.ts +2 -99
  107. package/bin/rpc/Client.d.ts.map +1 -1
  108. package/bin/rpc/Client.js +0 -46
  109. package/bin/rpc/Client.js.map +1 -1
  110. package/bin/rpc/Server.d.ts +5 -21
  111. package/bin/rpc/Server.d.ts.map +1 -1
  112. package/bin/rpc/Server.js +30 -315
  113. package/bin/rpc/Server.js.map +1 -1
  114. package/bin/rpc/server/InternalHandlers.d.ts +21 -0
  115. package/bin/rpc/server/InternalHandlers.d.ts.map +1 -0
  116. package/bin/rpc/server/InternalHandlers.js +190 -0
  117. package/bin/rpc/server/InternalHandlers.js.map +1 -0
  118. package/bin/rpc/server/RequestDispatcher.d.ts +27 -0
  119. package/bin/rpc/server/RequestDispatcher.d.ts.map +1 -0
  120. package/bin/rpc/server/RequestDispatcher.js +38 -0
  121. package/bin/rpc/server/RequestDispatcher.js.map +1 -0
  122. package/bin/rpc/server/SdkSessionHandlers.d.ts +25 -0
  123. package/bin/rpc/server/SdkSessionHandlers.d.ts.map +1 -0
  124. package/bin/rpc/server/SdkSessionHandlers.js +86 -0
  125. package/bin/rpc/server/SdkSessionHandlers.js.map +1 -0
  126. package/bin/rpc/server/ServerTypes.d.ts +59 -0
  127. package/bin/rpc/server/ServerTypes.d.ts.map +1 -0
  128. package/bin/rpc/server/ServerTypes.js +9 -0
  129. package/bin/rpc/server/ServerTypes.js.map +1 -0
  130. package/bin/{runtime/sandbox → sandbox}/MacOsSeatbeltSandbox.d.ts +1 -1
  131. package/bin/sandbox/MacOsSeatbeltSandbox.d.ts.map +1 -0
  132. package/bin/sandbox/MacOsSeatbeltSandbox.js.map +1 -0
  133. package/bin/{runtime/sandbox → sandbox}/SandboxConfigResolver.d.ts +2 -2
  134. package/bin/sandbox/SandboxConfigResolver.d.ts.map +1 -0
  135. package/bin/sandbox/SandboxConfigResolver.js.map +1 -0
  136. package/bin/{runtime/sandbox → sandbox}/SandboxRunner.d.ts +2 -2
  137. package/bin/sandbox/SandboxRunner.d.ts.map +1 -0
  138. package/bin/{runtime/sandbox → sandbox}/SandboxRunner.js +2 -2
  139. package/bin/sandbox/SandboxRunner.js.map +1 -0
  140. package/bin/sandbox/types/Sandbox.d.ts.map +1 -0
  141. package/bin/sandbox/types/Sandbox.js.map +1 -0
  142. package/bin/{runtime/sandbox → sandbox}/types/SandboxRuntime.d.ts +2 -2
  143. package/bin/sandbox/types/SandboxRuntime.d.ts.map +1 -0
  144. package/bin/sandbox/types/SandboxRuntime.js.map +1 -0
  145. package/bin/session/Session.d.ts.map +1 -1
  146. package/bin/session/Session.js +2 -1
  147. package/bin/session/Session.js.map +1 -1
  148. package/bin/session/browse/Browse.d.ts +1 -1
  149. package/bin/session/browse/Browse.d.ts.map +1 -1
  150. package/bin/session/browse/Browse.js +28 -13
  151. package/bin/session/browse/Browse.js.map +1 -1
  152. package/bin/session/index.d.ts +1 -1
  153. package/bin/session/index.d.ts.map +1 -1
  154. package/bin/session/index.js +1 -1
  155. package/bin/session/index.js.map +1 -1
  156. package/bin/session/storage/Paths.d.ts +9 -0
  157. package/bin/session/storage/Paths.d.ts.map +1 -1
  158. package/bin/session/storage/Paths.js +11 -0
  159. package/bin/session/storage/Paths.js.map +1 -1
  160. package/bin/types/agent/AgentOptions.d.ts +134 -0
  161. package/bin/types/agent/AgentOptions.d.ts.map +1 -0
  162. package/bin/types/agent/AgentOptions.js +9 -0
  163. package/bin/types/agent/AgentOptions.js.map +1 -0
  164. package/bin/types/{runtime/host/AgentHost.d.ts → agent/AgentRuntimeAssembly.d.ts} +4 -4
  165. package/bin/types/agent/AgentRuntimeAssembly.d.ts.map +1 -0
  166. package/bin/types/{runtime/host/AgentHost.js → agent/AgentRuntimeAssembly.js} +3 -3
  167. package/bin/types/agent/AgentRuntimeAssembly.js.map +1 -0
  168. package/bin/types/agent/AgentTypes.d.ts +8 -613
  169. package/bin/types/agent/AgentTypes.d.ts.map +1 -1
  170. package/bin/types/agent/AgentTypes.js +4 -4
  171. package/bin/types/agent/RemoteAgentOptions.d.ts +28 -0
  172. package/bin/types/agent/RemoteAgentOptions.d.ts.map +1 -0
  173. package/bin/types/agent/RemoteAgentOptions.js +9 -0
  174. package/bin/types/agent/RemoteAgentOptions.js.map +1 -0
  175. package/bin/types/agent/SessionActor.d.ts +60 -0
  176. package/bin/types/agent/SessionActor.d.ts.map +1 -0
  177. package/bin/types/agent/SessionActor.js +9 -0
  178. package/bin/types/agent/SessionActor.js.map +1 -0
  179. package/bin/types/agent/SessionTypes.d.ts +312 -0
  180. package/bin/types/agent/SessionTypes.d.ts.map +1 -0
  181. package/bin/types/agent/SessionTypes.js +9 -0
  182. package/bin/types/agent/SessionTypes.js.map +1 -0
  183. package/bin/types/config/DowncityConfig.d.ts +1 -1
  184. package/bin/types/config/DowncityConfig.d.ts.map +1 -1
  185. package/bin/types/{runtime/host → platform}/Store.d.ts +1 -1
  186. package/bin/types/platform/Store.d.ts.map +1 -0
  187. package/bin/types/{runtime/host → platform}/Store.js +1 -1
  188. package/bin/types/platform/Store.js.map +1 -0
  189. package/bin/types/plugin/PluginAction.d.ts +119 -0
  190. package/bin/types/plugin/PluginAction.d.ts.map +1 -0
  191. package/bin/types/plugin/PluginAction.js +9 -0
  192. package/bin/types/plugin/PluginAction.js.map +1 -0
  193. package/bin/types/plugin/PluginCommand.d.ts +80 -0
  194. package/bin/types/plugin/PluginCommand.d.ts.map +1 -0
  195. package/bin/types/plugin/PluginCommand.js +9 -0
  196. package/bin/types/plugin/PluginCommand.js.map +1 -0
  197. package/bin/types/plugin/PluginDefinition.d.ts +57 -0
  198. package/bin/types/plugin/PluginDefinition.d.ts.map +1 -0
  199. package/bin/types/plugin/PluginDefinition.js +9 -0
  200. package/bin/types/plugin/PluginDefinition.js.map +1 -0
  201. package/bin/types/plugin/PluginHttp.d.ts +34 -0
  202. package/bin/types/plugin/PluginHttp.d.ts.map +1 -0
  203. package/bin/types/plugin/PluginHttp.js +9 -0
  204. package/bin/types/plugin/PluginHttp.js.map +1 -0
  205. package/bin/types/plugin/PluginRuntime.d.ts +148 -0
  206. package/bin/types/plugin/PluginRuntime.d.ts.map +1 -0
  207. package/bin/types/plugin/PluginRuntime.js +9 -0
  208. package/bin/types/plugin/PluginRuntime.js.map +1 -0
  209. package/bin/types/plugin/PluginSetup.d.ts +133 -0
  210. package/bin/types/plugin/PluginSetup.d.ts.map +1 -0
  211. package/bin/types/plugin/PluginSetup.js +9 -0
  212. package/bin/types/plugin/PluginSetup.js.map +1 -0
  213. package/bin/types/plugin/PluginState.d.ts +69 -0
  214. package/bin/types/plugin/PluginState.d.ts.map +1 -0
  215. package/bin/types/plugin/PluginState.js +9 -0
  216. package/bin/types/plugin/PluginState.js.map +1 -0
  217. package/bin/types/rpc/RpcProtocol.d.ts +323 -0
  218. package/bin/types/rpc/RpcProtocol.d.ts.map +1 -0
  219. package/bin/types/rpc/RpcProtocol.js +10 -0
  220. package/bin/types/rpc/RpcProtocol.js.map +1 -0
  221. package/bin/types/runtime/agent/AgentContext.d.ts +1 -1
  222. package/bin/types/runtime/agent/AgentContext.d.ts.map +1 -1
  223. package/bin/types/runtime/agent/AgentRuntime.d.ts +1 -1
  224. package/bin/types/runtime/agent/AgentRuntime.d.ts.map +1 -1
  225. package/bin/types/runtime/platform/Platform.d.ts +7 -7
  226. package/bin/types/runtime/platform/PlatformGateway.d.ts +1 -1
  227. package/bin/types/runtime/platform/PlatformGateway.js +1 -1
  228. package/package.json +2 -2
  229. package/scripts/session-history-inflight.test.mjs +146 -0
  230. package/src/agent/{Agent.ts → local/Agent.ts} +50 -228
  231. package/src/agent/local/AgentInstructions.ts +68 -0
  232. package/src/agent/local/AgentPluginFactory.ts +83 -0
  233. package/src/{runtime/host/AgentHostRuntime.ts → agent/local/AgentRuntimeAssembly.ts} +2 -2
  234. package/src/agent/local/AgentRuntimeFactory.ts +173 -0
  235. package/src/{runtime/host → agent/local}/ProjectSetup.ts +1 -1
  236. package/src/agent/remote/RemoteAgent.ts +76 -0
  237. package/src/agent/remote/RemoteSession.ts +287 -0
  238. package/src/agent/remote/RemoteTransport.ts +71 -0
  239. package/src/agent/remote/TransportFactory.ts +29 -0
  240. package/src/agent/remote/transports/HttpRemoteAgentTransport.ts +347 -0
  241. package/src/agent/remote/transports/RpcRemoteAgentTransport.ts +107 -0
  242. package/src/config/AgentInitializer.ts +1 -1
  243. package/src/executor/Executor.ts +56 -37
  244. package/src/executor/composer/history/SessionHistoryWriter.ts +2 -2
  245. package/src/executor/composer/system/default/assets/core.prompt.ts +1 -1
  246. package/src/executor/composer/system/default/assets/core.prompt.ts.txt +1 -1
  247. package/src/executor/messages/AssistantResultPersistence.ts +4 -12
  248. package/src/executor/messages/SessionStepEventMapper.ts +59 -101
  249. package/src/executor/messages/UserVisibleText.ts +3 -18
  250. package/src/executor/store/history/SessionHistoryStore.ts +15 -0
  251. package/src/executor/store/history/jsonl/JsonlSessionHistoryStore.ts +164 -11
  252. package/src/executor/tools/shell/ShellToolFormatting.ts +1 -50
  253. package/src/executor/types/SessionHistoryPaths.ts +5 -0
  254. package/src/index.ts +5 -5
  255. package/src/plugin/core/PluginCommandRequest.ts +1 -1
  256. package/src/plugin/core/PluginLocalExecution.ts +1 -1
  257. package/src/plugin/core/ProjectConfigStore.ts +4 -4
  258. package/src/plugin/types/Plugin.ts +54 -913
  259. package/src/plugin/types/PluginApi.ts +1 -1
  260. package/src/plugin/types/PluginState.ts +1 -1
  261. package/src/rpc/Client.ts +16 -322
  262. package/src/rpc/Server.ts +39 -565
  263. package/src/rpc/server/InternalHandlers.ts +230 -0
  264. package/src/rpc/server/RequestDispatcher.ts +67 -0
  265. package/src/rpc/server/SdkSessionHandlers.ts +106 -0
  266. package/src/rpc/server/ServerTypes.ts +65 -0
  267. package/src/{runtime/sandbox → sandbox}/MacOsSeatbeltSandbox.ts +1 -1
  268. package/src/{runtime/sandbox → sandbox}/SandboxConfigResolver.ts +1 -1
  269. package/src/{runtime/sandbox → sandbox}/SandboxRunner.ts +3 -3
  270. package/src/{runtime/sandbox → sandbox}/types/SandboxRuntime.ts +2 -2
  271. package/src/session/Session.ts +6 -0
  272. package/src/session/browse/Browse.ts +29 -10
  273. package/src/session/index.ts +1 -0
  274. package/src/session/storage/Paths.ts +19 -0
  275. package/src/types/agent/AgentOptions.ts +147 -0
  276. package/src/types/{runtime/host/AgentHost.ts → agent/AgentRuntimeAssembly.ts} +2 -2
  277. package/src/types/agent/AgentTypes.ts +37 -709
  278. package/src/types/agent/RemoteAgentOptions.ts +29 -0
  279. package/src/types/agent/SessionActor.ts +88 -0
  280. package/src/types/agent/SessionTypes.ts +334 -0
  281. package/src/types/config/DowncityConfig.ts +1 -1
  282. package/src/types/{runtime/host → platform}/Store.ts +1 -1
  283. package/src/types/plugin/PluginAction.ts +133 -0
  284. package/src/types/plugin/PluginCommand.ts +89 -0
  285. package/src/types/plugin/PluginDefinition.ts +74 -0
  286. package/src/types/plugin/PluginHttp.ts +36 -0
  287. package/src/types/plugin/PluginRuntime.ts +169 -0
  288. package/src/types/plugin/PluginSetup.ts +138 -0
  289. package/src/types/plugin/PluginState.ts +82 -0
  290. package/src/types/rpc/RpcProtocol.ts +361 -0
  291. package/src/types/runtime/agent/AgentContext.ts +1 -1
  292. package/src/types/runtime/agent/AgentRuntime.ts +1 -1
  293. package/src/types/runtime/platform/Platform.ts +7 -7
  294. package/src/types/runtime/platform/PlatformGateway.ts +1 -1
  295. package/tsconfig.tsbuildinfo +1 -1
  296. package/bin/agent/Agent.d.ts.map +0 -1
  297. package/bin/agent/Agent.js.map +0 -1
  298. package/bin/agent/RemoteAgent.d.ts.map +0 -1
  299. package/bin/agent/RemoteAgent.js +0 -585
  300. package/bin/agent/RemoteAgent.js.map +0 -1
  301. package/bin/runtime/auth/AuthEnv.d.ts +0 -36
  302. package/bin/runtime/auth/AuthEnv.d.ts.map +0 -1
  303. package/bin/runtime/auth/AuthEnv.js +0 -54
  304. package/bin/runtime/auth/AuthEnv.js.map +0 -1
  305. package/bin/runtime/auth/CliAuthStateStore.d.ts +0 -29
  306. package/bin/runtime/auth/CliAuthStateStore.d.ts.map +0 -1
  307. package/bin/runtime/auth/CliAuthStateStore.js +0 -26
  308. package/bin/runtime/auth/CliAuthStateStore.js.map +0 -1
  309. package/bin/runtime/control/AuthControlService.d.ts +0 -34
  310. package/bin/runtime/control/AuthControlService.d.ts.map +0 -1
  311. package/bin/runtime/control/AuthControlService.js +0 -129
  312. package/bin/runtime/control/AuthControlService.js.map +0 -1
  313. package/bin/runtime/control/CommonHelpers.d.ts +0 -36
  314. package/bin/runtime/control/CommonHelpers.d.ts.map +0 -1
  315. package/bin/runtime/control/CommonHelpers.js +0 -63
  316. package/bin/runtime/control/CommonHelpers.js.map +0 -1
  317. package/bin/runtime/control/ExecuteBySession.d.ts +0 -30
  318. package/bin/runtime/control/ExecuteBySession.d.ts.map +0 -1
  319. package/bin/runtime/control/ExecuteBySession.js +0 -41
  320. package/bin/runtime/control/ExecuteBySession.js.map +0 -1
  321. package/bin/runtime/control/ExecuteInput.d.ts +0 -18
  322. package/bin/runtime/control/ExecuteInput.d.ts.map +0 -1
  323. package/bin/runtime/control/ExecuteInput.js +0 -201
  324. package/bin/runtime/control/ExecuteInput.js.map +0 -1
  325. package/bin/runtime/control/Helpers.d.ts +0 -13
  326. package/bin/runtime/control/Helpers.d.ts.map +0 -1
  327. package/bin/runtime/control/Helpers.js +0 -13
  328. package/bin/runtime/control/Helpers.js.map +0 -1
  329. package/bin/runtime/control/MessageTimeline.d.ts +0 -22
  330. package/bin/runtime/control/MessageTimeline.d.ts.map +0 -1
  331. package/bin/runtime/control/MessageTimeline.js +0 -226
  332. package/bin/runtime/control/MessageTimeline.js.map +0 -1
  333. package/bin/runtime/control/SessionSummaryStore.d.ts +0 -20
  334. package/bin/runtime/control/SessionSummaryStore.d.ts.map +0 -1
  335. package/bin/runtime/control/SessionSummaryStore.js +0 -50
  336. package/bin/runtime/control/SessionSummaryStore.js.map +0 -1
  337. package/bin/runtime/control/TaskStore.d.ts +0 -33
  338. package/bin/runtime/control/TaskStore.d.ts.map +0 -1
  339. package/bin/runtime/control/TaskStore.js +0 -175
  340. package/bin/runtime/control/TaskStore.js.map +0 -1
  341. package/bin/runtime/control/types/AuthControl.d.ts +0 -30
  342. package/bin/runtime/control/types/AuthControl.d.ts.map +0 -1
  343. package/bin/runtime/control/types/AuthControl.js +0 -9
  344. package/bin/runtime/control/types/AuthControl.js.map +0 -1
  345. package/bin/runtime/control/types/ControlSessionExecute.d.ts +0 -85
  346. package/bin/runtime/control/types/ControlSessionExecute.d.ts.map +0 -1
  347. package/bin/runtime/control/types/ControlSessionExecute.js +0 -9
  348. package/bin/runtime/control/types/ControlSessionExecute.js.map +0 -1
  349. package/bin/runtime/control/types/ControlViewData.d.ts +0 -320
  350. package/bin/runtime/control/types/ControlViewData.d.ts.map +0 -1
  351. package/bin/runtime/control/types/ControlViewData.js +0 -9
  352. package/bin/runtime/control/types/ControlViewData.js.map +0 -1
  353. package/bin/runtime/host/AgentHostRuntime.d.ts.map +0 -1
  354. package/bin/runtime/host/AgentHostRuntime.js.map +0 -1
  355. package/bin/runtime/host/ProjectSetup.d.ts.map +0 -1
  356. package/bin/runtime/host/ProjectSetup.js.map +0 -1
  357. package/bin/runtime/sandbox/MacOsSeatbeltSandbox.d.ts.map +0 -1
  358. package/bin/runtime/sandbox/MacOsSeatbeltSandbox.js.map +0 -1
  359. package/bin/runtime/sandbox/SandboxConfigResolver.d.ts.map +0 -1
  360. package/bin/runtime/sandbox/SandboxConfigResolver.js.map +0 -1
  361. package/bin/runtime/sandbox/SandboxRunner.d.ts.map +0 -1
  362. package/bin/runtime/sandbox/SandboxRunner.js.map +0 -1
  363. package/bin/runtime/sandbox/types/Sandbox.d.ts.map +0 -1
  364. package/bin/runtime/sandbox/types/Sandbox.js.map +0 -1
  365. package/bin/runtime/sandbox/types/SandboxRuntime.d.ts.map +0 -1
  366. package/bin/runtime/sandbox/types/SandboxRuntime.js.map +0 -1
  367. package/bin/types/runtime/host/AgentHost.d.ts.map +0 -1
  368. package/bin/types/runtime/host/AgentHost.js.map +0 -1
  369. package/bin/types/runtime/host/Store.d.ts.map +0 -1
  370. package/bin/types/runtime/host/Store.js.map +0 -1
  371. package/src/agent/RemoteAgent.ts +0 -834
  372. package/src/runtime/auth/AuthEnv.ts +0 -62
  373. package/src/runtime/auth/CliAuthStateStore.ts +0 -46
  374. package/src/runtime/control/AuthControlService.ts +0 -169
  375. package/src/runtime/control/CommonHelpers.ts +0 -69
  376. package/src/runtime/control/ExecuteBySession.ts +0 -52
  377. package/src/runtime/control/ExecuteInput.ts +0 -236
  378. package/src/runtime/control/Helpers.ts +0 -22
  379. package/src/runtime/control/MessageTimeline.ts +0 -269
  380. package/src/runtime/control/SessionSummaryStore.ts +0 -72
  381. package/src/runtime/control/TaskStore.ts +0 -242
  382. package/src/runtime/control/types/AuthControl.ts +0 -34
  383. package/src/runtime/control/types/ControlSessionExecute.ts +0 -99
  384. package/src/runtime/control/types/ControlViewData.ts +0 -392
  385. /package/bin/{runtime/sandbox → sandbox}/MacOsSeatbeltSandbox.js +0 -0
  386. /package/bin/{runtime/sandbox → sandbox}/SandboxConfigResolver.js +0 -0
  387. /package/bin/{runtime/sandbox → sandbox}/types/Sandbox.d.ts +0 -0
  388. /package/bin/{runtime/sandbox → sandbox}/types/Sandbox.js +0 -0
  389. /package/bin/{runtime/sandbox → sandbox}/types/SandboxRuntime.js +0 -0
  390. /package/src/{runtime/sandbox → sandbox}/types/Sandbox.ts +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RemoteAgentOptions.js","sourceRoot":"","sources":["../../../src/types/agent/RemoteAgentOptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Agent session actor 接口类型。
3
+ *
4
+ * 关键点(中文)
5
+ * - 这里只描述 session 的可调用能力。
6
+ * - session 的数据结构、history/system payload 放在 `SessionTypes.ts`。
7
+ */
8
+ import type { AgentCreateSessionInput, AgentListSessionsInput, AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionHistoryInput, AgentSessionHistoryPage, AgentSessionInfo, AgentSessionSetInput, AgentSessionSummaryPage, AgentSessionSystemSnapshot } from "../../types/agent/SessionTypes.js";
9
+ import type { AgentSessionSubscriber, AgentSessionUnsubscribe } from "../../types/sdk/AgentSessionEvent.js";
10
+ import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
11
+ import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
12
+ /**
13
+ * SDK Session 集合绑定。
14
+ */
15
+ export interface AgentSessionCollection {
16
+ /** 新建一个 session。 */
17
+ createSession(input?: AgentCreateSessionInput): Promise<AgentSession>;
18
+ /** 获取一个已存在的 session。 */
19
+ getSession(sessionId: string): Promise<AgentSession>;
20
+ /** 列出当前 agent 的 session 摘要页。 */
21
+ listSessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
22
+ }
23
+ /**
24
+ * Session actor 公共能力。
25
+ */
26
+ export interface AgentSessionActor {
27
+ /** 当前 session 稳定标识。 */
28
+ readonly id: string;
29
+ /** 读取当前 session 详情。 */
30
+ getInfo(): Promise<AgentSessionInfo>;
31
+ /** 追加一条新的 prompt。 */
32
+ prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
33
+ /** 订阅当前 session 的未来事件。 */
34
+ subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
35
+ /** 读取当前 session 历史分页。 */
36
+ history(input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage>;
37
+ /** 读取当前 session 生效的 system 快照。 */
38
+ system(): Promise<AgentSessionSystemSnapshot>;
39
+ }
40
+ /**
41
+ * 本地 Agent 返回的公开 session 接口。
42
+ */
43
+ export interface AgentSession extends AgentSessionActor {
44
+ /** 当前 session 所属 agentId。 */
45
+ readonly agentId: string;
46
+ /** 当前 session 配置快照。 */
47
+ readonly config: AgentSessionConfigSnapshot;
48
+ /** 写入当前 session 默认配置。 */
49
+ set(input: AgentSessionSetInput): Promise<void>;
50
+ /** 从当前 session 创建一个分叉会话。 */
51
+ fork(input?: AgentSessionForkInput | string): Promise<AgentSession>;
52
+ }
53
+ /**
54
+ * 远程 Agent 返回的公开 session 接口。
55
+ */
56
+ export interface RemoteAgentSession extends AgentSessionActor {
57
+ /** 从当前远程 session 创建一个分叉会话。 */
58
+ fork(input?: AgentSessionForkInput | string): Promise<RemoteAgentSession>;
59
+ }
60
+ //# sourceMappingURL=SessionActor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SessionActor.d.ts","sourceRoot":"","sources":["../../../src/types/agent/SessionActor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oBAAoB;IACpB,aAAa,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEtE,wBAAwB;IACxB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAErD,gCAAgC;IAChC,YAAY,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAChF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,uBAAuB;IACvB,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErC,qBAAqB;IACrB,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAExE,0BAA0B;IAC1B,SAAS,CAAC,UAAU,EAAE,sBAAsB,GAAG,uBAAuB,CAAC;IAEvE,yBAAyB;IACzB,OAAO,CAAC,KAAK,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAE5E,kCAAkC;IAClC,MAAM,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAE5C,yBAAyB;IACzB,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,4BAA4B;IAC5B,IAAI,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,8BAA8B;IAC9B,IAAI,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC3E"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Agent session actor 接口类型。
3
+ *
4
+ * 关键点(中文)
5
+ * - 这里只描述 session 的可调用能力。
6
+ * - session 的数据结构、history/system payload 放在 `SessionTypes.ts`。
7
+ */
8
+ export {};
9
+ //# sourceMappingURL=SessionActor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SessionActor.js","sourceRoot":"","sources":["../../../src/types/agent/SessionActor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
@@ -0,0 +1,312 @@
1
+ /**
2
+ * Agent session 数据类型。
3
+ *
4
+ * 关键点(中文)
5
+ * - 只描述 session 的输入、摘要、历史、system snapshot 与配置快照。
6
+ * - session actor 方法接口拆到 `SessionActor.ts`。
7
+ */
8
+ import type { LanguageModel } from "ai";
9
+ import type { AgentModel } from "../../model/CityModelAdapter.js";
10
+ import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
11
+ /**
12
+ * 新建 session 的输入参数。
13
+ */
14
+ export interface AgentCreateSessionInput {
15
+ /**
16
+ * 可选显式 sessionId。
17
+ *
18
+ * 关键点(中文)
19
+ * - 传入时表达“创建意图”。
20
+ * - 若该 session 已存在,SDK 应直接报错,而不是静默复用。
21
+ * - 省略时由 SDK 自动生成稳定且不可推导的 sessionId。
22
+ */
23
+ sessionId?: string;
24
+ }
25
+ /**
26
+ * Session 列表查询输入。
27
+ */
28
+ export interface AgentListSessionsInput {
29
+ /**
30
+ * 当前页返回上限。
31
+ *
32
+ * 说明(中文)
33
+ * - 省略时由 SDK 使用默认值。
34
+ * - 建议宿主 UI 明确传入,避免在大量 session 下拉取过多数据。
35
+ */
36
+ limit?: number;
37
+ /**
38
+ * 分页游标。
39
+ *
40
+ * 说明(中文)
41
+ * - 当前使用 SDK 自身生成的透明字符串游标。
42
+ * - 调用方只负责透传,不应自行解析其内部格式。
43
+ */
44
+ cursor?: string;
45
+ /**
46
+ * 关键词过滤。
47
+ *
48
+ * 说明(中文)
49
+ * - 推荐用于匹配 `sessionId`、标题与预览文本。
50
+ * - 属于轻量包含匹配,不承诺复杂搜索语义。
51
+ */
52
+ query?: string;
53
+ }
54
+ /**
55
+ * Session 可变配置。
56
+ */
57
+ export interface AgentSessionSetInput {
58
+ /**
59
+ * 当前 session 默认模型实例。
60
+ *
61
+ * 关键点(中文)
62
+ * - 这里接受运行中的模型实例,而不是模型 ID。
63
+ * - 由于模型实例通常不可序列化,落盘只保留轻量可读标签用于展示。
64
+ */
65
+ model?: AgentModel;
66
+ }
67
+ /**
68
+ * Session 当前配置快照。
69
+ */
70
+ export interface AgentSessionConfigSnapshot {
71
+ /** 当前 session 绑定的默认模型实例。 */
72
+ model?: LanguageModel;
73
+ /** 当前模型的轻量可读标签。 */
74
+ modelLabel?: string;
75
+ }
76
+ /**
77
+ * Session 历史视图类型。
78
+ */
79
+ export type AgentSessionHistoryView = "message" | "timeline";
80
+ /**
81
+ * Session 时间线事件。
82
+ */
83
+ export interface AgentSessionTimelineEvent {
84
+ /** 当前事件唯一标识。 */
85
+ id: string;
86
+ /**
87
+ * 当前事件角色。
88
+ *
89
+ * 说明(中文)
90
+ * - `tool-call` / `tool-result` 用于把 assistant 内部工具过程平铺给 UI。
91
+ */
92
+ role: "user" | "assistant" | "tool-call" | "tool-result";
93
+ /** 事件时间戳(毫秒)。 */
94
+ ts?: number;
95
+ /** 事件所属消息种类。 */
96
+ kind?: string;
97
+ /** 事件来源。 */
98
+ source?: string;
99
+ /** 当前事件展示文本。 */
100
+ text: string;
101
+ /**
102
+ * 当前事件对应工具名称。
103
+ *
104
+ * 说明(中文)
105
+ * - 仅 `tool-call` / `tool-result` 这类事件通常会携带该字段。
106
+ */
107
+ toolName?: string;
108
+ }
109
+ /**
110
+ * Session system block 来源类型。
111
+ */
112
+ export type AgentSessionSystemBlockSource = "core" | "instruction" | "plugin" | "session";
113
+ /**
114
+ * Session system prompt 的单个组成块。
115
+ */
116
+ export interface AgentSessionSystemBlock {
117
+ /** 当前 block 的来源层级。 */
118
+ source: AgentSessionSystemBlockSource;
119
+ /**
120
+ * 当前 block 在来源层级内的名称。
121
+ *
122
+ * 说明(中文)
123
+ * - `instruction` 通常使用 `agent`。
124
+ * - `plugin` 使用对应 plugin 名称。
125
+ * - `core` 使用 `default`。
126
+ * - `session` 使用当前 session 上下文名称。
127
+ */
128
+ name: string;
129
+ /**
130
+ * 已归一化后的 system 文本内容。
131
+ *
132
+ * 关键点(中文)
133
+ * - SDK 不对 instruction 做动态变量替换。
134
+ * - 动态上下文应由调用方放入 user message。
135
+ */
136
+ content: string;
137
+ }
138
+ /**
139
+ * 当前 session 的稳定上下文信息。
140
+ */
141
+ export interface AgentSessionSystemSessionInfo {
142
+ /** 当前 session 所属 agentId。 */
143
+ agentId: string;
144
+ /** 当前 session 唯一标识。 */
145
+ sessionId: string;
146
+ /** 当前 agent 绑定的项目根目录。 */
147
+ projectRoot: string;
148
+ /**
149
+ * 当前 session 首次创建时间。
150
+ *
151
+ * 关键点(中文)
152
+ * - 这是 session 初始化时落盘的稳定参考时间,按 Date/ISO 字符串对外展示。
153
+ * - 它不是每轮运行的当前时间,不会随着后续 turn 执行而改变。
154
+ */
155
+ createdAt: string;
156
+ /**
157
+ * 当前 session 初始化时解析到的系统时区。
158
+ *
159
+ * 关键点(中文)
160
+ * - 这是 session 级参考时区,随创建信息一起固定。
161
+ * - 它不是每轮运行重新解析的动态时区。
162
+ */
163
+ timezone: string;
164
+ }
165
+ /**
166
+ * 当前 session 生效的完整 system prompt 快照。
167
+ */
168
+ export interface AgentSessionSystemSnapshot {
169
+ /** 当前 sessionId。 */
170
+ sessionId: string;
171
+ /**
172
+ * 当前 session 的稳定上下文信息。
173
+ *
174
+ * 关键点(中文)
175
+ * - 这里包含 session 创建时间这类稳定参考信息。
176
+ * - 这里不包含当前时间、轮次、用户输入等每轮变化的数据。
177
+ * - 每轮动态信息应由调用方放入 user message,避免破坏 instruction 缓存命中。
178
+ */
179
+ session: AgentSessionSystemSessionInfo;
180
+ /** 当前生效的 system blocks,按进入模型的顺序排列。 */
181
+ blocks: AgentSessionSystemBlock[];
182
+ }
183
+ /**
184
+ * Session 摘要。
185
+ */
186
+ export interface AgentSessionSummary {
187
+ /** 当前 session 所属 agentId。 */
188
+ agentId: string;
189
+ /** 当前 session 唯一标识。 */
190
+ sessionId: string;
191
+ /**
192
+ * 当前 session 可读标题。
193
+ *
194
+ * 说明(中文)
195
+ * - 标题持久化在 session `meta.json` 顶层。
196
+ * - 首条用户消息出现后,SDK 会优先生成标题,失败时回退到首条用户消息截断。
197
+ * - 空 session 可能暂时没有标题,调用方可回退到 `sessionId`。
198
+ */
199
+ title?: string;
200
+ /**
201
+ * 当前 session 的最近预览文本。
202
+ *
203
+ * 说明(中文)
204
+ * - 通常来自最后一条用户可见消息的裁剪文本。
205
+ * - 适合用于侧边栏、列表卡片或 session picker。
206
+ */
207
+ previewText?: string;
208
+ /** 当前 session 首次创建时间(ms)。 */
209
+ createdAt?: number;
210
+ /** 当前 session 最近一次更新时间(ms)。 */
211
+ updatedAt?: number;
212
+ /** 当前 session 已落盘消息数。 */
213
+ messageCount: number;
214
+ /** 当前 session 绑定模型的可读标签。 */
215
+ modelLabel?: string;
216
+ /** 当前 session 是否处于执行中。 */
217
+ executing?: boolean;
218
+ }
219
+ /**
220
+ * Session 详情。
221
+ */
222
+ export interface AgentSessionInfo extends AgentSessionSummary {
223
+ /** 当前 session 初始化时记录的时区。 */
224
+ timezone?: string;
225
+ }
226
+ /**
227
+ * Session 摘要分页结果。
228
+ */
229
+ export interface AgentSessionSummaryPage {
230
+ /** 当前页 session 摘要列表。 */
231
+ items: AgentSessionSummary[];
232
+ /**
233
+ * 当前页所对应的总条数。
234
+ *
235
+ * 说明(中文)
236
+ * - 这里表示过滤后的总数,不是仅当前页数量。
237
+ * - 对分页 UI、结果统计和空态判断更友好。
238
+ */
239
+ total: number;
240
+ /** 下一页游标。 */
241
+ nextCursor?: string;
242
+ /** 是否仍有更多结果。 */
243
+ hasMore: boolean;
244
+ }
245
+ /**
246
+ * Session 历史读取输入。
247
+ */
248
+ export interface AgentSessionHistoryInput {
249
+ /** 当前页返回上限。 */
250
+ limit?: number;
251
+ /** 分页游标。 */
252
+ cursor?: string;
253
+ /**
254
+ * 返回顺序。
255
+ *
256
+ * 说明(中文)
257
+ * - `asc`:从旧到新
258
+ * - `desc`:从新到旧
259
+ */
260
+ order?: "asc" | "desc";
261
+ /**
262
+ * 返回视图类型。
263
+ *
264
+ * 说明(中文)
265
+ * - `message`:原始 session 消息
266
+ * - `timeline`:适合直接渲染 UI 的平铺事件
267
+ */
268
+ view?: AgentSessionHistoryView;
269
+ }
270
+ /**
271
+ * Session 历史分页结果。
272
+ */
273
+ export interface AgentSessionHistoryPage {
274
+ /** 当前读取所对应的 session 信息。 */
275
+ session: AgentSessionInfo;
276
+ /** 当前页实际返回视图。 */
277
+ view: AgentSessionHistoryView;
278
+ /**
279
+ * 当前页数据列表。
280
+ *
281
+ * 说明(中文)
282
+ * - `view=message` 时返回 `SessionMessageV1[]`
283
+ * - `view=timeline` 时返回 `AgentSessionTimelineEvent[]`
284
+ */
285
+ items: SessionMessageV1[] | AgentSessionTimelineEvent[];
286
+ /**
287
+ * 过滤前后的总条数。
288
+ *
289
+ * 说明(中文)
290
+ * - 对 `view=message` 表示消息条数。
291
+ * - 对 `view=timeline` 表示时间线事件条数。
292
+ */
293
+ total: number;
294
+ /** 下一页游标。 */
295
+ nextCursor?: string;
296
+ /** 是否仍有更多数据。 */
297
+ hasMore: boolean;
298
+ }
299
+ /**
300
+ * Session fork 输入。
301
+ */
302
+ export interface AgentSessionForkInput {
303
+ /**
304
+ * 可选分叉锚点消息 ID。
305
+ *
306
+ * 关键点(中文)
307
+ * - 省略时复制当前 session 的完整消息历史。
308
+ * - 传入时复制到该消息为止(包含该消息)。
309
+ */
310
+ messageId?: string;
311
+ }
312
+ //# sourceMappingURL=SessionTypes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SessionTypes.d.ts","sourceRoot":"","sources":["../../../src/types/agent/SessionTypes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Agent session 数据类型。
3
+ *
4
+ * 关键点(中文)
5
+ * - 只描述 session 的输入、摘要、历史、system snapshot 与配置快照。
6
+ * - session actor 方法接口拆到 `SessionActor.ts`。
7
+ */
8
+ export {};
9
+ //# sourceMappingURL=SessionTypes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SessionTypes.js","sourceRoot":"","sources":["../../../src/types/agent/SessionTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
@@ -8,7 +8,7 @@
8
8
  import type { LlmConfig } from "../../types/config/LlmConfig.js";
9
9
  import type { ExecutionBindingConfig } from "../../types/config/ExecutionBinding.js";
10
10
  import type { JsonObject } from "../../types/common/Json.js";
11
- import type { SandboxProjectConfig } from "../../runtime/sandbox/types/Sandbox.js";
11
+ import type { SandboxProjectConfig } from "../../sandbox/types/Sandbox.js";
12
12
  /**
13
13
  * 单个聊天渠道配置。
14
14
  */
@@ -1 +1 @@
1
- {"version":3,"file":"DowncityConfig.d.ts","sourceRoot":"","sources":["../../../src/types/config/DowncityConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC;;OAEG;IACH,EAAE,CAAC,EAAE,yBAAyB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,CAAC,EAAE,6BAA6B,CAAC;IACtC;;OAEG;IACH,MAAM,CAAC,EAAE,8BAA8B,CAAC;IACxC;;OAEG;IACH,QAAQ,CAAC,EAAE,gCAAgC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC;;OAEG;IACH,KAAK,CAAC,EAAE,yBAAyB,CAAC;IAClC;;OAEG;IACH,CAAC,UAAU,EAAE,MAAM,GACf,UAAU,GACV,wBAAwB,GACxB,yBAAyB,GACzB,SAAS,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB"}
1
+ {"version":3,"file":"DowncityConfig.d.ts","sourceRoot":"","sources":["../../../src/types/config/DowncityConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC;;OAEG;IACH,EAAE,CAAC,EAAE,yBAAyB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,CAAC,EAAE,6BAA6B,CAAC;IACtC;;OAEG;IACH,MAAM,CAAC,EAAE,8BAA8B,CAAC;IACxC;;OAEG;IACH,QAAQ,CAAC,EAAE,gCAAgC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC;;OAEG;IACH,KAAK,CAAC,EAAE,yBAAyB,CAAC;IAClC;;OAEG;IACH,CAAC,UAAU,EAAE,MAAM,GACf,UAAU,GACV,wBAAwB,GACxB,yBAAyB,GACzB,SAAS,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * 平台宿主存储类型定义。
2
+ * 平台存储类型定义。
3
3
  *
4
4
  * 关键点(中文)
5
5
  * - Town 只保存平台级 env、channel account 与安全配置。
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../../src/types/platform/Store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,KAAK,EAAE,QAAQ,CAAC;IAChB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,KAAK,EAAE,QAAQ,CAAC;IAChB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,OAAO,EAAE,2BAA2B,CAAC;IACrC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,OAAO,EAAE,2BAA2B,CAAC;IACrC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * 平台宿主存储类型定义。
2
+ * 平台存储类型定义。
3
3
  *
4
4
  * 关键点(中文)
5
5
  * - Town 只保存平台级 env、channel account 与安全配置。
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Store.js","sourceRoot":"","sources":["../../../src/types/platform/Store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
@@ -0,0 +1,119 @@
1
+ /**
2
+ * Plugin action 类型。
3
+ *
4
+ * 关键点(中文)
5
+ * - action 是 plugin 对外暴露的显式能力。
6
+ * - CLI / HTTP 只是 action 的输入适配层,真正执行器统一走 `execute`。
7
+ */
8
+ import type { Command } from "commander";
9
+ import type { Context as HonoContext } from "hono";
10
+ import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
11
+ import type { JsonValue } from "../../types/common/Json.js";
12
+ /**
13
+ * Plugin action 调用参数。
14
+ */
15
+ export interface PluginActionInvokeParams {
16
+ /** 目标 plugin 名称。 */
17
+ plugin: string;
18
+ /** 目标 action 名称。 */
19
+ action: string;
20
+ /** 调用 payload(可选)。 */
21
+ payload?: JsonValue;
22
+ }
23
+ /**
24
+ * Plugin action 调用结果。
25
+ */
26
+ export interface PluginActionInvokeResult {
27
+ /** 调用是否成功。 */
28
+ success: boolean;
29
+ /** 结构化返回数据(可选)。 */
30
+ data?: JsonValue;
31
+ /** 错误信息(可选)。 */
32
+ error?: string;
33
+ }
34
+ /**
35
+ * Plugin action 调用端口。
36
+ */
37
+ export interface PluginActionInvokePort {
38
+ /** 调用指定 plugin action。 */
39
+ invoke(params: PluginActionInvokeParams): Promise<PluginActionInvokeResult>;
40
+ }
41
+ /**
42
+ * Plugin Action 执行结果。
43
+ */
44
+ export interface PluginActionResult<R extends JsonValue = JsonValue> {
45
+ /** Action 是否成功。 */
46
+ success: boolean;
47
+ /** 返回数据(可选)。 */
48
+ data?: R;
49
+ /** 错误信息(可选)。 */
50
+ error?: string;
51
+ /** 人类可读消息(可选)。 */
52
+ message?: string;
53
+ }
54
+ /**
55
+ * Plugin Action 命令输入。
56
+ */
57
+ export interface PluginActionCommandInput {
58
+ /** 位置参数列表。 */
59
+ args: string[];
60
+ /** 选项参数对象。 */
61
+ opts: Record<string, JsonValue>;
62
+ }
63
+ /**
64
+ * Plugin Action CLI 定义。
65
+ */
66
+ export interface PluginActionCommand<P extends JsonValue = JsonValue> {
67
+ /** 命令说明。 */
68
+ description: string;
69
+ /** 额外 commander 配置(可选)。 */
70
+ configure?: (command: Command) => void;
71
+ /** 将 CLI 输入映射为 payload。 */
72
+ mapInput: (input: PluginActionCommandInput) => P | Promise<P>;
73
+ }
74
+ /**
75
+ * Plugin Action HTTP 定义。
76
+ */
77
+ export interface PluginActionApi<P extends JsonValue = JsonValue> {
78
+ /** HTTP 方法。 */
79
+ method?: "GET" | "POST" | "PUT" | "DELETE";
80
+ /** HTTP 路径。 */
81
+ path?: string;
82
+ /** 将 HTTP 输入映射为 payload(可选)。 */
83
+ mapInput?: (ctx: HonoContext) => P | Promise<P>;
84
+ }
85
+ /**
86
+ * Plugin Action 定义。
87
+ */
88
+ export interface PluginAction<P extends JsonValue = JsonValue, R extends JsonValue = JsonValue> {
89
+ /**
90
+ * disabled 状态下是否仍允许执行。
91
+ *
92
+ * 说明(中文)
93
+ * - 用于 `on` / `status` / `models` / `configure` / `install` 这类 setup 相关 action。
94
+ * - 默认 false,避免 disabled plugin 绕过 registry 保护执行普通业务 action。
95
+ */
96
+ allowWhenDisabled?: boolean;
97
+ /** CLI 定义(可选)。 */
98
+ command?: PluginActionCommand<P>;
99
+ /** HTTP 定义(可选)。 */
100
+ api?: PluginActionApi<P>;
101
+ /** Action 执行器。 */
102
+ execute: (params: {
103
+ /** 当前执行上下文。 */
104
+ context: AgentContext;
105
+ /** 输入 payload。 */
106
+ payload: P;
107
+ /** 当前插件名称。 */
108
+ pluginName: string;
109
+ /** 当前 Action 名称。 */
110
+ actionName: string;
111
+ }) => Promise<PluginActionResult<R>> | PluginActionResult<R>;
112
+ }
113
+ /**
114
+ * Plugin Action 集合。
115
+ */
116
+ export type PluginActions = {
117
+ [actionName: string]: PluginAction<JsonValue, JsonValue>;
118
+ };
119
+ //# sourceMappingURL=PluginAction.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PluginAction.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginAction.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Plugin action 类型。
3
+ *
4
+ * 关键点(中文)
5
+ * - action 是 plugin 对外暴露的显式能力。
6
+ * - CLI / HTTP 只是 action 的输入适配层,真正执行器统一走 `execute`。
7
+ */
8
+ export {};
9
+ //# sourceMappingURL=PluginAction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PluginAction.js","sourceRoot":"","sources":["../../../src/types/plugin/PluginAction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}