@downcity/agent 1.1.438 → 1.1.445

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 (702) hide show
  1. package/README.md +25 -18
  2. package/bin/agent/Agent.d.ts +44 -20
  3. package/bin/agent/Agent.d.ts.map +1 -1
  4. package/bin/agent/Agent.js +114 -69
  5. package/bin/agent/Agent.js.map +1 -1
  6. package/bin/agent/AgentInstructions.d.ts +18 -4
  7. package/bin/agent/AgentInstructions.d.ts.map +1 -1
  8. package/bin/agent/AgentInstructions.js +33 -14
  9. package/bin/agent/AgentInstructions.js.map +1 -1
  10. package/bin/agent/AgentMemoryStorage.d.ts +1 -1
  11. package/bin/agent/AgentMemoryStorage.d.ts.map +1 -1
  12. package/bin/agent/AgentMemoryStorage.js.map +1 -1
  13. package/bin/agent/AgentSessions.d.ts +29 -16
  14. package/bin/agent/AgentSessions.d.ts.map +1 -1
  15. package/bin/agent/AgentSessions.js +42 -22
  16. package/bin/agent/AgentSessions.js.map +1 -1
  17. package/bin/group/Group.d.ts +13 -12
  18. package/bin/group/Group.d.ts.map +1 -1
  19. package/bin/group/Group.js +24 -23
  20. package/bin/group/Group.js.map +1 -1
  21. package/bin/group/GroupSession.d.ts.map +1 -1
  22. package/bin/group/GroupSession.js +13 -9
  23. package/bin/group/GroupSession.js.map +1 -1
  24. package/bin/group/GroupSessions.d.ts +27 -2
  25. package/bin/group/GroupSessions.d.ts.map +1 -1
  26. package/bin/group/GroupSessions.js +68 -21
  27. package/bin/group/GroupSessions.js.map +1 -1
  28. package/bin/group/storage/LocalGroupSessionDataStore.d.ts +8 -0
  29. package/bin/group/storage/LocalGroupSessionDataStore.d.ts.map +1 -1
  30. package/bin/group/storage/LocalGroupSessionDataStore.js +1 -1
  31. package/bin/group/storage/LocalGroupSessionDataStore.js.map +1 -1
  32. package/bin/group/storage/LocalGroupSessionStore.d.ts +64 -5
  33. package/bin/group/storage/LocalGroupSessionStore.d.ts.map +1 -1
  34. package/bin/group/storage/LocalGroupSessionStore.js +114 -23
  35. package/bin/group/storage/LocalGroupSessionStore.js.map +1 -1
  36. package/bin/index.d.ts +25 -30
  37. package/bin/index.d.ts.map +1 -1
  38. package/bin/index.js +14 -14
  39. package/bin/index.js.map +1 -1
  40. package/bin/{executor/model → model}/ModelGenerate.d.ts +1 -1
  41. package/bin/model/ModelGenerate.d.ts.map +1 -0
  42. package/bin/model/ModelGenerate.js.map +1 -0
  43. package/bin/{executor/model → model}/ModelRequestRunner.d.ts +1 -1
  44. package/bin/model/ModelRequestRunner.d.ts.map +1 -0
  45. package/bin/model/ModelRequestRunner.js.map +1 -0
  46. package/bin/{executor/model → model}/ModelStepRunner.d.ts +6 -7
  47. package/bin/model/ModelStepRunner.d.ts.map +1 -0
  48. package/bin/{executor/model → model}/ModelStepRunner.js +16 -10
  49. package/bin/model/ModelStepRunner.js.map +1 -0
  50. package/bin/model/ModelStreamConsumer.d.ts.map +1 -0
  51. package/bin/model/ModelStreamConsumer.js.map +1 -0
  52. package/bin/model/ModelStreamFailure.d.ts.map +1 -0
  53. package/bin/model/ModelStreamFailure.js.map +1 -0
  54. package/bin/model/ToolInputValidation.d.ts +28 -0
  55. package/bin/model/ToolInputValidation.d.ts.map +1 -0
  56. package/bin/model/ToolInputValidation.js +37 -0
  57. package/bin/model/ToolInputValidation.js.map +1 -0
  58. package/bin/model/messages/ChatMessageMarkup.d.ts.map +1 -0
  59. package/bin/model/messages/ChatMessageMarkup.js.map +1 -0
  60. package/bin/{executor → model}/messages/ChatMessageMarkupTypes.d.ts +1 -1
  61. package/bin/model/messages/ChatMessageMarkupTypes.d.ts.map +1 -0
  62. package/bin/{executor → model}/messages/ChatMessageMarkupTypes.js +1 -1
  63. package/bin/model/messages/ChatMessageMarkupTypes.js.map +1 -0
  64. package/bin/model/messages/SessionAttachmentMapper.d.ts.map +1 -0
  65. package/bin/model/messages/SessionAttachmentMapper.js.map +1 -0
  66. package/bin/model/messages/SessionMessageLog.d.ts.map +1 -0
  67. package/bin/model/messages/SessionMessageLog.js.map +1 -0
  68. package/bin/model/messages/SessionModelMessages.d.ts.map +1 -0
  69. package/bin/{executor → model}/messages/SessionModelMessages.js +0 -1
  70. package/bin/model/messages/SessionModelMessages.js.map +1 -0
  71. package/bin/model/prompts/SystemPromptAssets.d.ts.map +1 -0
  72. package/bin/{executor/composer/system/default → model/prompts}/SystemPromptAssets.js +1 -1
  73. package/bin/model/prompts/SystemPromptAssets.js.map +1 -0
  74. package/bin/model/prompts/assets/core.prompt.d.ts +7 -0
  75. package/bin/model/prompts/assets/core.prompt.d.ts.map +1 -0
  76. package/bin/model/prompts/assets/core.prompt.js +8 -0
  77. package/bin/model/prompts/assets/core.prompt.js.map +1 -0
  78. package/bin/session/Session.d.ts +29 -17
  79. package/bin/session/Session.d.ts.map +1 -1
  80. package/bin/session/Session.js +161 -134
  81. package/bin/session/Session.js.map +1 -1
  82. package/bin/session/input/SessionHookRunner.d.ts +52 -0
  83. package/bin/session/input/SessionHookRunner.d.ts.map +1 -0
  84. package/bin/session/input/SessionHookRunner.js +51 -0
  85. package/bin/session/input/SessionHookRunner.js.map +1 -0
  86. package/bin/session/input/SessionSystem.d.ts +26 -0
  87. package/bin/session/input/SessionSystem.d.ts.map +1 -0
  88. package/bin/session/{SessionSystem.js → input/SessionSystem.js} +27 -23
  89. package/bin/session/input/SessionSystem.js.map +1 -0
  90. package/bin/session/input/StepInput.d.ts +77 -0
  91. package/bin/session/input/StepInput.d.ts.map +1 -0
  92. package/bin/session/input/StepInput.js +429 -0
  93. package/bin/session/input/StepInput.js.map +1 -0
  94. package/bin/session/input/composer/AdaptiveContextCheckpoint.d.ts +33 -0
  95. package/bin/session/input/composer/AdaptiveContextCheckpoint.d.ts.map +1 -0
  96. package/bin/session/input/composer/AdaptiveContextCheckpoint.js +83 -0
  97. package/bin/session/input/composer/AdaptiveContextCheckpoint.js.map +1 -0
  98. package/bin/session/input/composer/AdaptiveContextParts.d.ts +26 -0
  99. package/bin/session/input/composer/AdaptiveContextParts.d.ts.map +1 -0
  100. package/bin/session/input/composer/AdaptiveContextParts.js +124 -0
  101. package/bin/session/input/composer/AdaptiveContextParts.js.map +1 -0
  102. package/bin/session/input/composer/ComposerAssembly.d.ts +21 -0
  103. package/bin/session/input/composer/ComposerAssembly.d.ts.map +1 -0
  104. package/bin/session/input/composer/ComposerAssembly.js +64 -0
  105. package/bin/session/input/composer/ComposerAssembly.js.map +1 -0
  106. package/bin/session/{composer/policies/SessionSummaryPrompts.d.ts → input/composer/ContextSummaryPrompts.d.ts} +5 -3
  107. package/bin/session/input/composer/ContextSummaryPrompts.d.ts.map +1 -0
  108. package/bin/session/{composer/policies/SessionSummaryPrompts.js → input/composer/ContextSummaryPrompts.js} +5 -3
  109. package/bin/session/input/composer/ContextSummaryPrompts.js.map +1 -0
  110. package/bin/session/input/composer/DefaultSessionComposer.d.ts +24 -0
  111. package/bin/session/input/composer/DefaultSessionComposer.d.ts.map +1 -0
  112. package/bin/session/input/composer/DefaultSessionComposer.js +108 -0
  113. package/bin/session/input/composer/DefaultSessionComposer.js.map +1 -0
  114. package/bin/session/input/composer/FullHistorySessionComposer.d.ts +19 -0
  115. package/bin/session/input/composer/FullHistorySessionComposer.d.ts.map +1 -0
  116. package/bin/session/input/composer/FullHistorySessionComposer.js +36 -0
  117. package/bin/session/input/composer/FullHistorySessionComposer.js.map +1 -0
  118. package/bin/session/{SessionLoop.d.ts → loop/SessionLoop.d.ts} +34 -7
  119. package/bin/session/loop/SessionLoop.d.ts.map +1 -0
  120. package/bin/session/{SessionLoop.js → loop/SessionLoop.js} +79 -16
  121. package/bin/session/loop/SessionLoop.js.map +1 -0
  122. package/bin/session/{SessionQueue.d.ts → loop/SessionQueue.d.ts} +9 -1
  123. package/bin/session/loop/SessionQueue.d.ts.map +1 -0
  124. package/bin/session/{SessionQueue.js → loop/SessionQueue.js} +19 -0
  125. package/bin/session/loop/SessionQueue.js.map +1 -0
  126. package/bin/session/{SessionState.d.ts → loop/SessionState.d.ts} +4 -5
  127. package/bin/session/loop/SessionState.d.ts.map +1 -0
  128. package/bin/session/{SessionState.js → loop/SessionState.js} +6 -25
  129. package/bin/session/loop/SessionState.js.map +1 -0
  130. package/bin/session/{SessionTitle.d.ts → loop/SessionTitle.d.ts} +4 -4
  131. package/bin/session/loop/SessionTitle.d.ts.map +1 -0
  132. package/bin/session/{SessionTitle.js → loop/SessionTitle.js} +3 -3
  133. package/bin/session/loop/SessionTitle.js.map +1 -0
  134. package/bin/session/loop/SessionTitleTask.d.ts.map +1 -0
  135. package/bin/session/loop/SessionTitleTask.js.map +1 -0
  136. package/bin/session/{runtime → loop}/SessionTurnCompletion.d.ts +7 -0
  137. package/bin/session/loop/SessionTurnCompletion.d.ts.map +1 -0
  138. package/bin/session/{runtime → loop}/SessionTurnCompletion.js +25 -6
  139. package/bin/session/loop/SessionTurnCompletion.js.map +1 -0
  140. package/bin/session/loop/SessionTurnContext.d.ts +12 -0
  141. package/bin/session/loop/SessionTurnContext.d.ts.map +1 -0
  142. package/bin/session/{runtime → loop}/SessionTurnContext.js +14 -67
  143. package/bin/session/loop/SessionTurnContext.js.map +1 -0
  144. package/bin/session/loop/SessionTurnFileDiff.d.ts.map +1 -0
  145. package/bin/session/{runtime → loop}/SessionTurnFileDiff.js +1 -1
  146. package/bin/session/loop/SessionTurnFileDiff.js.map +1 -0
  147. package/bin/session/{messages → loop}/SessionTurnFileDiffBuilder.d.ts +3 -3
  148. package/bin/session/loop/SessionTurnFileDiffBuilder.d.ts.map +1 -0
  149. package/bin/session/loop/SessionTurnFileDiffBuilder.js.map +1 -0
  150. package/bin/session/messages/ApprovalInteraction.d.ts +30 -0
  151. package/bin/session/messages/ApprovalInteraction.d.ts.map +1 -0
  152. package/bin/session/messages/ApprovalInteraction.js +61 -0
  153. package/bin/session/messages/ApprovalInteraction.js.map +1 -0
  154. package/bin/session/messages/SessionAgentMessageState.d.ts +47 -18
  155. package/bin/session/messages/SessionAgentMessageState.d.ts.map +1 -1
  156. package/bin/session/messages/SessionAgentMessageState.js +224 -86
  157. package/bin/session/messages/SessionAgentMessageState.js.map +1 -1
  158. package/bin/session/messages/SessionAgentMessageWriter.d.ts +15 -4
  159. package/bin/session/messages/SessionAgentMessageWriter.d.ts.map +1 -1
  160. package/bin/session/messages/SessionAgentMessageWriter.js +57 -37
  161. package/bin/session/messages/SessionAgentMessageWriter.js.map +1 -1
  162. package/bin/session/messages/SessionAgentParts.d.ts +14 -0
  163. package/bin/session/messages/SessionAgentParts.d.ts.map +1 -0
  164. package/bin/session/messages/SessionAgentParts.js +20 -0
  165. package/bin/session/messages/SessionAgentParts.js.map +1 -0
  166. package/bin/session/{execution → messages}/SessionAssistantOutputAdapter.d.ts +2 -2
  167. package/bin/session/messages/SessionAssistantOutputAdapter.d.ts.map +1 -0
  168. package/bin/session/messages/SessionAssistantOutputAdapter.js.map +1 -0
  169. package/bin/session/messages/SessionEventHub.d.ts.map +1 -0
  170. package/bin/session/messages/SessionEventHub.js.map +1 -0
  171. package/bin/session/messages/SessionInteractions.d.ts +57 -0
  172. package/bin/session/messages/SessionInteractions.d.ts.map +1 -0
  173. package/bin/session/messages/SessionInteractions.js +178 -0
  174. package/bin/session/messages/SessionInteractions.js.map +1 -0
  175. package/bin/session/messages/SessionJsonValue.d.ts +1 -3
  176. package/bin/session/messages/SessionJsonValue.d.ts.map +1 -1
  177. package/bin/session/messages/SessionJsonValue.js +0 -19
  178. package/bin/session/messages/SessionJsonValue.js.map +1 -1
  179. package/bin/session/messages/SessionMessageCache.d.ts +55 -0
  180. package/bin/session/messages/SessionMessageCache.d.ts.map +1 -0
  181. package/bin/session/messages/SessionMessageCache.js +133 -0
  182. package/bin/session/messages/SessionMessageCache.js.map +1 -0
  183. package/bin/session/messages/SessionMessageState.d.ts +17 -0
  184. package/bin/session/messages/SessionMessageState.d.ts.map +1 -0
  185. package/bin/session/messages/SessionMessageState.js +34 -0
  186. package/bin/session/messages/SessionMessageState.js.map +1 -0
  187. package/bin/session/messages/SessionMessageTimeline.d.ts.map +1 -0
  188. package/bin/session/{browse → messages}/SessionMessageTimeline.js +0 -1
  189. package/bin/session/messages/SessionMessageTimeline.js.map +1 -0
  190. package/bin/session/{SessionMessages.d.ts → messages/SessionMessages.d.ts} +35 -43
  191. package/bin/session/messages/SessionMessages.d.ts.map +1 -0
  192. package/bin/session/{SessionMessages.js → messages/SessionMessages.js} +178 -196
  193. package/bin/session/messages/SessionMessages.js.map +1 -0
  194. package/bin/session/messages/SessionModelRequestWarning.d.ts.map +1 -0
  195. package/bin/session/messages/SessionModelRequestWarning.js.map +1 -0
  196. package/bin/session/messages/SessionMutationFactory.d.ts +26 -0
  197. package/bin/session/messages/SessionMutationFactory.d.ts.map +1 -0
  198. package/bin/session/messages/SessionMutationFactory.js +38 -0
  199. package/bin/session/messages/SessionMutationFactory.js.map +1 -0
  200. package/bin/session/messages/SessionUserMessage.d.ts +5 -7
  201. package/bin/session/messages/SessionUserMessage.d.ts.map +1 -1
  202. package/bin/session/messages/SessionUserMessage.js +5 -28
  203. package/bin/session/messages/SessionUserMessage.js.map +1 -1
  204. package/bin/{executor/core-engine/CoreEngineSignals.d.ts → session/runner/AssistantParts.d.ts} +4 -9
  205. package/bin/session/runner/AssistantParts.d.ts.map +1 -0
  206. package/bin/{executor/core-engine/CoreEngineSignals.js → session/runner/AssistantParts.js} +4 -17
  207. package/bin/session/runner/AssistantParts.js.map +1 -0
  208. package/bin/session/runner/ContextPressure.d.ts +15 -0
  209. package/bin/session/runner/ContextPressure.d.ts.map +1 -0
  210. package/bin/{executor/core-engine/CoreEngineContextCompaction.js → session/runner/ContextPressure.js} +11 -11
  211. package/bin/session/runner/ContextPressure.js.map +1 -0
  212. package/bin/session/runner/ContextRetry.d.ts +39 -0
  213. package/bin/session/runner/ContextRetry.d.ts.map +1 -0
  214. package/bin/{executor/services/ExecutorRecoveryPolicy.js → session/runner/ContextRetry.js} +19 -19
  215. package/bin/session/runner/ContextRetry.js.map +1 -0
  216. package/bin/{executor/core-engine/CoreEngineError.d.ts → session/runner/ModelFailure.d.ts} +4 -4
  217. package/bin/session/runner/ModelFailure.d.ts.map +1 -0
  218. package/bin/{executor/core-engine/CoreEngineError.js → session/runner/ModelFailure.js} +4 -4
  219. package/bin/session/runner/ModelFailure.js.map +1 -0
  220. package/bin/session/runner/SessionExecutor.d.ts +108 -0
  221. package/bin/session/runner/SessionExecutor.d.ts.map +1 -0
  222. package/bin/session/runner/SessionExecutor.js +430 -0
  223. package/bin/session/runner/SessionExecutor.js.map +1 -0
  224. package/bin/session/runner/ToolLoopDecision.d.ts +60 -0
  225. package/bin/session/runner/ToolLoopDecision.d.ts.map +1 -0
  226. package/bin/{executor/core-engine/CoreEngineLoopDecision.js → session/runner/ToolLoopDecision.js} +5 -5
  227. package/bin/session/runner/ToolLoopDecision.js.map +1 -0
  228. package/bin/session/runner/ToolLoopLimits.d.ts +30 -0
  229. package/bin/session/runner/ToolLoopLimits.d.ts.map +1 -0
  230. package/bin/session/runner/ToolLoopLimits.js +46 -0
  231. package/bin/session/runner/ToolLoopLimits.js.map +1 -0
  232. package/bin/session/{browse → storage}/Browse.d.ts +1 -1
  233. package/bin/session/storage/Browse.d.ts.map +1 -0
  234. package/bin/session/{browse → storage}/Browse.js +1 -1
  235. package/bin/session/storage/Browse.js.map +1 -0
  236. package/bin/session/storage/LocalSessionStore.js +1 -1
  237. package/bin/session/storage/LocalSessionStore.js.map +1 -1
  238. package/bin/session/storage/LocalStorePaths.d.ts +0 -2
  239. package/bin/session/storage/LocalStorePaths.d.ts.map +1 -1
  240. package/bin/session/storage/LocalStorePaths.js +1 -1
  241. package/bin/session/storage/LocalStorePaths.js.map +1 -1
  242. package/bin/session/storage/Metadata.d.ts +1 -23
  243. package/bin/session/storage/Metadata.d.ts.map +1 -1
  244. package/bin/session/storage/Metadata.js +0 -18
  245. package/bin/session/storage/Metadata.js.map +1 -1
  246. package/bin/session/storage/RuntimeSessionPort.d.ts +0 -4
  247. package/bin/session/storage/RuntimeSessionPort.d.ts.map +1 -1
  248. package/bin/session/storage/RuntimeSessionPort.js +0 -1
  249. package/bin/session/storage/RuntimeSessionPort.js.map +1 -1
  250. package/bin/session/{preview → storage}/SessionMessagePreview.d.ts.map +1 -1
  251. package/bin/session/{preview → storage}/SessionMessagePreview.js +0 -1
  252. package/bin/session/{preview → storage}/SessionMessagePreview.js.map +1 -1
  253. package/bin/session/storage/SessionStorageCodec.d.ts.map +1 -1
  254. package/bin/session/storage/SessionStorageCodec.js +36 -18
  255. package/bin/session/storage/SessionStorageCodec.js.map +1 -1
  256. package/bin/session/storage/SessionStorageSchema.d.ts +1 -1
  257. package/bin/session/storage/SessionStorageSchema.js +1 -1
  258. package/bin/session/storage/SqliteSessionStorage.d.ts +6 -4
  259. package/bin/session/storage/SqliteSessionStorage.d.ts.map +1 -1
  260. package/bin/session/storage/SqliteSessionStorage.js +21 -18
  261. package/bin/session/storage/SqliteSessionStorage.js.map +1 -1
  262. package/bin/tools/ask/AskQuestionAnswers.d.ts +20 -0
  263. package/bin/tools/ask/AskQuestionAnswers.d.ts.map +1 -0
  264. package/bin/tools/ask/AskQuestionAnswers.js +99 -0
  265. package/bin/tools/ask/AskQuestionAnswers.js.map +1 -0
  266. package/bin/tools/ask/AskQuestionsTool.d.ts +5 -2
  267. package/bin/tools/ask/AskQuestionsTool.d.ts.map +1 -1
  268. package/bin/tools/ask/AskQuestionsTool.js +23 -31
  269. package/bin/tools/ask/AskQuestionsTool.js.map +1 -1
  270. package/bin/tools/ask/AskQuestionsToolSchemas.d.ts +1 -1
  271. package/bin/types/agent/AgentOptions.d.ts +16 -8
  272. package/bin/types/agent/AgentOptions.d.ts.map +1 -1
  273. package/bin/types/agent/AgentSessionCollection.d.ts +8 -0
  274. package/bin/types/agent/AgentSessionCollection.d.ts.map +1 -1
  275. package/bin/types/agent/SessionActor.d.ts +3 -3
  276. package/bin/types/agent/SessionActor.d.ts.map +1 -1
  277. package/bin/types/group/DispatchStrategy.js +1 -1
  278. package/bin/types/group/DispatchStrategy.js.map +1 -1
  279. package/bin/types/group/GroupSession.d.ts +41 -1
  280. package/bin/types/group/GroupSession.d.ts.map +1 -1
  281. package/bin/types/group/GroupSessionStore.d.ts +30 -3
  282. package/bin/types/group/GroupSessionStore.d.ts.map +1 -1
  283. package/bin/types/model/ModelRequest.d.ts.map +1 -0
  284. package/bin/types/model/ModelRequest.js.map +1 -0
  285. package/bin/types/sdk/AgentSessionAction.d.ts +1 -9
  286. package/bin/types/sdk/AgentSessionAction.d.ts.map +1 -1
  287. package/bin/types/session/{AdaptivePartContextPolicy.d.ts → ContextCheckpoint.d.ts} +10 -9
  288. package/bin/types/session/ContextCheckpoint.d.ts.map +1 -0
  289. package/bin/types/session/ContextCheckpoint.js +8 -0
  290. package/bin/types/session/ContextCheckpoint.js.map +1 -0
  291. package/bin/types/session/SessionAgentMessageState.d.ts +6 -10
  292. package/bin/types/session/SessionAgentMessageState.d.ts.map +1 -1
  293. package/bin/types/session/SessionAgentMessageState.js +3 -2
  294. package/bin/types/session/SessionAgentMessageState.js.map +1 -1
  295. package/bin/types/session/SessionComposer.d.ts +65 -36
  296. package/bin/types/session/SessionComposer.d.ts.map +1 -1
  297. package/bin/types/session/SessionComposer.js +7 -2
  298. package/bin/types/session/SessionComposer.js.map +1 -1
  299. package/bin/types/session/SessionExecution.d.ts +15 -11
  300. package/bin/types/session/SessionExecution.d.ts.map +1 -1
  301. package/bin/types/session/SessionExecution.js +1 -1
  302. package/bin/types/session/SessionInteractions.d.ts +0 -2
  303. package/bin/types/session/SessionInteractions.d.ts.map +1 -1
  304. package/bin/types/session/SessionLocalState.d.ts +0 -4
  305. package/bin/types/session/SessionLocalState.d.ts.map +1 -1
  306. package/bin/types/session/SessionLoop.d.ts +33 -12
  307. package/bin/types/session/SessionLoop.d.ts.map +1 -1
  308. package/bin/types/session/SessionMessages.d.ts +3 -29
  309. package/bin/types/session/SessionMessages.d.ts.map +1 -1
  310. package/bin/types/session/SessionOptions.d.ts +16 -13
  311. package/bin/types/session/SessionOptions.d.ts.map +1 -1
  312. package/bin/types/session/SessionPort.d.ts +0 -3
  313. package/bin/types/session/SessionPort.d.ts.map +1 -1
  314. package/bin/types/session/SessionState.d.ts +0 -1
  315. package/bin/types/session/SessionState.d.ts.map +1 -1
  316. package/bin/types/session/SessionSystem.d.ts +10 -12
  317. package/bin/types/session/SessionSystem.d.ts.map +1 -1
  318. package/bin/types/session/SessionTool.d.ts +2 -2
  319. package/bin/types/session/SessionTool.d.ts.map +1 -1
  320. package/bin/types/session/SessionTurnCompletion.d.ts +12 -2
  321. package/bin/types/session/SessionTurnCompletion.d.ts.map +1 -1
  322. package/bin/types/session/SessionTurnFileDiff.d.ts +4 -4
  323. package/bin/types/session/SessionTurnFileDiff.d.ts.map +1 -1
  324. package/bin/types/session/{SessionComposition.d.ts → StepInput.d.ts} +17 -15
  325. package/bin/types/session/StepInput.d.ts.map +1 -0
  326. package/bin/types/session/StepInput.js +8 -0
  327. package/bin/types/session/StepInput.js.map +1 -0
  328. package/bin/types/store/SessionHistoryMeta.d.ts.map +1 -0
  329. package/bin/types/store/SessionHistoryMeta.js.map +1 -0
  330. package/bin/types/store/SessionStorage.d.ts +17 -12
  331. package/bin/types/store/SessionStorage.d.ts.map +1 -1
  332. package/bin/types/tool/BoundAgentTool.d.ts +36 -0
  333. package/bin/types/tool/BoundAgentTool.d.ts.map +1 -0
  334. package/bin/types/tool/BoundAgentTool.js +13 -0
  335. package/bin/types/tool/BoundAgentTool.js.map +1 -0
  336. package/bin/types/tools/ask/AskQuestionsTool.d.ts +9 -13
  337. package/bin/types/tools/ask/AskQuestionsTool.d.ts.map +1 -1
  338. package/bin/types/tools/ask/AskQuestionsTool.js +3 -2
  339. package/bin/types/tools/ask/AskQuestionsTool.js.map +1 -1
  340. package/bin/types/turn/SessionAssistantOutput.d.ts.map +1 -0
  341. package/bin/types/turn/SessionAssistantOutput.js.map +1 -0
  342. package/bin/types/{executor → turn}/SessionTurnContext.d.ts +10 -28
  343. package/bin/types/turn/SessionTurnContext.d.ts.map +1 -0
  344. package/bin/types/turn/SessionTurnContext.js.map +1 -0
  345. package/bin/{executor/ids/resolveSessionId.d.ts → utils/ResolveSessionId.d.ts} +1 -1
  346. package/bin/utils/ResolveSessionId.d.ts.map +1 -0
  347. package/bin/{executor/ids/resolveSessionId.js → utils/ResolveSessionId.js} +1 -1
  348. package/bin/utils/ResolveSessionId.js.map +1 -0
  349. package/bin/utils/Time.d.ts +5 -8
  350. package/bin/utils/Time.d.ts.map +1 -1
  351. package/bin/utils/Time.js +5 -54
  352. package/bin/utils/Time.js.map +1 -1
  353. package/package.json +2 -2
  354. package/scripts/ask-question-answers.test.mjs +132 -0
  355. package/scripts/group-session-archive.test.mjs +193 -0
  356. package/scripts/{core-engine-model-stream.test.mjs → model-step-runner.test.mjs} +97 -4
  357. package/scripts/rewrite-build-aliases.mjs +3 -4
  358. package/scripts/session-action-part.test.mjs +172 -0
  359. package/scripts/session-agent-message-part-order.test.mjs +13 -7
  360. package/scripts/{core-engine-context-compaction.test.mjs → session-executor-context-pressure.test.mjs} +40 -32
  361. package/scripts/{executor-failure-result.test.mjs → session-executor-failure-result.test.mjs} +17 -14
  362. package/scripts/session-executor-max-steps.test.mjs +143 -0
  363. package/scripts/session-initialization.test.mjs +3 -4
  364. package/scripts/session-interaction-migration.test.mjs +145 -0
  365. package/scripts/session-interaction-mutation.test.mjs +202 -0
  366. package/scripts/session-messages-error-part.test.mjs +1 -1
  367. package/scripts/session-messages-error.test.mjs +1 -1
  368. package/scripts/session-prompt-idempotency.test.mjs +4 -2
  369. package/scripts/session-queue.test.mjs +21 -1
  370. package/scripts/session-storage-sqlite.test.mjs +3 -3
  371. package/scripts/session-system-blocks.test.mjs +61 -39
  372. package/scripts/session-turn-context.test.mjs +37 -40
  373. package/scripts/verify-build-aliases.mjs +1 -1
  374. package/src/agent/Agent.ts +137 -80
  375. package/src/agent/AgentInstructions.ts +48 -15
  376. package/src/agent/AgentMemoryStorage.ts +1 -1
  377. package/src/agent/AgentSessions.ts +60 -38
  378. package/src/group/Group.ts +27 -24
  379. package/src/group/GroupSession.ts +12 -8
  380. package/src/group/GroupSessions.ts +79 -20
  381. package/src/group/storage/LocalGroupSessionDataStore.ts +9 -1
  382. package/src/group/storage/LocalGroupSessionStore.ts +138 -28
  383. package/src/index.ts +35 -52
  384. package/src/{executor/model → model}/ModelGenerate.ts +3 -3
  385. package/src/{executor/model → model}/ModelRequestRunner.ts +2 -2
  386. package/src/{executor/model → model}/ModelStepRunner.ts +22 -19
  387. package/src/{executor/model → model}/ModelStreamConsumer.ts +1 -1
  388. package/src/model/README.md +117 -0
  389. package/src/model/ToolInputValidation.ts +58 -0
  390. package/src/{executor → model}/messages/ChatMessageMarkupTypes.ts +1 -1
  391. package/src/{executor → model}/messages/SessionModelMessages.ts +0 -1
  392. package/src/{executor/composer/system/default → model/prompts}/SystemPromptAssets.ts +1 -1
  393. package/src/model/prompts/assets/core.prompt.ts +9 -0
  394. package/src/{executor/composer/system/default → model/prompts}/assets/core.prompt.ts.txt +26 -25
  395. package/src/session/Session.ts +185 -151
  396. package/src/session/input/SessionHookRunner.ts +100 -0
  397. package/src/session/{SessionSystem.ts → input/SessionSystem.ts} +31 -29
  398. package/src/session/input/StepInput.ts +507 -0
  399. package/src/session/input/composer/AdaptiveContextCheckpoint.ts +115 -0
  400. package/src/session/input/composer/AdaptiveContextParts.ts +166 -0
  401. package/src/session/input/composer/ComposerAssembly.ts +81 -0
  402. package/src/session/{composer/policies/SessionSummaryPrompts.ts → input/composer/ContextSummaryPrompts.ts} +5 -2
  403. package/src/session/input/composer/DefaultSessionComposer.ts +147 -0
  404. package/src/session/input/composer/FullHistorySessionComposer.ts +55 -0
  405. package/src/session/loop/README.md +28 -0
  406. package/src/session/{SessionLoop.ts → loop/SessionLoop.ts} +100 -24
  407. package/src/session/{SessionQueue.ts → loop/SessionQueue.ts} +18 -0
  408. package/src/session/{SessionState.ts → loop/SessionState.ts} +4 -21
  409. package/src/session/{SessionTitle.ts → loop/SessionTitle.ts} +3 -3
  410. package/src/session/{runtime → loop}/SessionTurnCompletion.ts +27 -8
  411. package/src/session/{runtime → loop}/SessionTurnContext.ts +19 -93
  412. package/src/session/{runtime → loop}/SessionTurnFileDiff.ts +1 -1
  413. package/src/session/{messages → loop}/SessionTurnFileDiffBuilder.ts +4 -4
  414. package/src/session/messages/ApprovalInteraction.ts +77 -0
  415. package/src/session/messages/README.md +27 -0
  416. package/src/session/messages/SessionAgentMessageState.ts +324 -113
  417. package/src/session/messages/SessionAgentMessageWriter.ts +82 -45
  418. package/src/session/messages/SessionAgentParts.ts +39 -0
  419. package/src/session/{execution → messages}/SessionAssistantOutputAdapter.ts +2 -2
  420. package/src/session/messages/SessionInteractions.ts +227 -0
  421. package/src/session/messages/SessionJsonValue.ts +1 -18
  422. package/src/session/messages/SessionMessageCache.ts +171 -0
  423. package/src/session/messages/SessionMessageState.ts +42 -0
  424. package/src/session/{browse → messages}/SessionMessageTimeline.ts +0 -1
  425. package/src/session/{SessionMessages.ts → messages/SessionMessages.ts} +225 -284
  426. package/src/session/messages/SessionMutationFactory.ts +58 -0
  427. package/src/session/messages/SessionUserMessage.ts +7 -32
  428. package/src/{executor/core-engine/CoreEngineSignals.ts → session/runner/AssistantParts.ts} +3 -21
  429. package/src/{executor/core-engine/CoreEngineContextCompaction.ts → session/runner/ContextPressure.ts} +10 -10
  430. package/src/{executor/services/ExecutorRecoveryPolicy.ts → session/runner/ContextRetry.ts} +25 -25
  431. package/src/{executor/core-engine/CoreEngineError.ts → session/runner/ModelFailure.ts} +3 -3
  432. package/src/session/runner/SessionExecutor.ts +633 -0
  433. package/src/session/runner/ToolLoopDecision.ts +98 -0
  434. package/src/session/runner/ToolLoopLimits.ts +53 -0
  435. package/src/session/{browse → storage}/Browse.ts +2 -2
  436. package/src/session/storage/LocalSessionStore.ts +1 -1
  437. package/src/session/storage/LocalStorePaths.ts +1 -1
  438. package/src/session/storage/Metadata.ts +1 -44
  439. package/src/session/storage/RuntimeSessionPort.ts +0 -5
  440. package/src/session/{preview → storage}/SessionMessagePreview.ts +0 -1
  441. package/src/session/storage/SessionStorageCodec.ts +54 -28
  442. package/src/session/storage/SessionStorageSchema.ts +1 -1
  443. package/src/session/storage/SqliteSessionStorage.ts +29 -22
  444. package/src/tools/ask/AskQuestionAnswers.ts +125 -0
  445. package/src/tools/ask/AskQuestionsTool.ts +32 -37
  446. package/src/types/agent/AgentOptions.ts +17 -8
  447. package/src/types/agent/AgentSessionCollection.ts +9 -0
  448. package/src/types/agent/SessionActor.ts +3 -4
  449. package/src/types/group/DispatchStrategy.ts +1 -1
  450. package/src/types/group/GroupSession.ts +44 -1
  451. package/src/types/group/GroupSessionStore.ts +30 -3
  452. package/src/types/sdk/AgentSessionAction.ts +1 -14
  453. package/src/types/session/{AdaptivePartContextPolicy.ts → ContextCheckpoint.ts} +9 -8
  454. package/src/types/session/SessionAgentMessageState.ts +6 -16
  455. package/src/types/session/SessionComposer.ts +67 -39
  456. package/src/types/session/SessionExecution.ts +15 -13
  457. package/src/types/session/SessionInteractions.ts +0 -2
  458. package/src/types/session/SessionLocalState.ts +0 -5
  459. package/src/types/session/SessionLoop.ts +37 -12
  460. package/src/types/session/SessionMessages.ts +3 -34
  461. package/src/types/session/SessionOptions.ts +18 -13
  462. package/src/types/session/SessionPort.ts +0 -4
  463. package/src/types/session/SessionState.ts +0 -1
  464. package/src/types/session/SessionSystem.ts +10 -16
  465. package/src/types/session/SessionTool.ts +2 -2
  466. package/src/types/session/SessionTurnCompletion.ts +12 -2
  467. package/src/types/session/SessionTurnFileDiff.ts +4 -4
  468. package/src/types/session/{SessionComposition.ts → StepInput.ts} +22 -14
  469. package/src/types/store/SessionStorage.ts +17 -12
  470. package/src/types/tool/BoundAgentTool.ts +38 -0
  471. package/src/types/tools/ask/AskQuestionsTool.ts +11 -13
  472. package/src/types/{executor → turn}/SessionTurnContext.ts +8 -34
  473. package/src/utils/Time.ts +12 -64
  474. package/tsconfig.json +1 -2
  475. package/tsconfig.tsbuildinfo +1 -1
  476. package/bin/executor/Executor.d.ts +0 -92
  477. package/bin/executor/Executor.d.ts.map +0 -1
  478. package/bin/executor/Executor.js +0 -232
  479. package/bin/executor/Executor.js.map +0 -1
  480. package/bin/executor/composer/system/default/SystemPromptAssets.d.ts.map +0 -1
  481. package/bin/executor/composer/system/default/SystemPromptAssets.js.map +0 -1
  482. package/bin/executor/composer/system/default/assets/core.prompt.d.ts +0 -7
  483. package/bin/executor/composer/system/default/assets/core.prompt.d.ts.map +0 -1
  484. package/bin/executor/composer/system/default/assets/core.prompt.js +0 -8
  485. package/bin/executor/composer/system/default/assets/core.prompt.js.map +0 -1
  486. package/bin/executor/core-engine/CoreEngineContextCompaction.d.ts +0 -15
  487. package/bin/executor/core-engine/CoreEngineContextCompaction.d.ts.map +0 -1
  488. package/bin/executor/core-engine/CoreEngineContextCompaction.js.map +0 -1
  489. package/bin/executor/core-engine/CoreEngineError.d.ts.map +0 -1
  490. package/bin/executor/core-engine/CoreEngineError.js.map +0 -1
  491. package/bin/executor/core-engine/CoreEngineLoopDecision.d.ts +0 -26
  492. package/bin/executor/core-engine/CoreEngineLoopDecision.d.ts.map +0 -1
  493. package/bin/executor/core-engine/CoreEngineLoopDecision.js.map +0 -1
  494. package/bin/executor/core-engine/CoreEngineRunner.d.ts +0 -48
  495. package/bin/executor/core-engine/CoreEngineRunner.d.ts.map +0 -1
  496. package/bin/executor/core-engine/CoreEngineRunner.js +0 -343
  497. package/bin/executor/core-engine/CoreEngineRunner.js.map +0 -1
  498. package/bin/executor/core-engine/CoreEngineSignals.d.ts.map +0 -1
  499. package/bin/executor/core-engine/CoreEngineSignals.js.map +0 -1
  500. package/bin/executor/ids/resolveSessionId.d.ts.map +0 -1
  501. package/bin/executor/ids/resolveSessionId.js.map +0 -1
  502. package/bin/executor/messages/ChatMessageMarkup.d.ts.map +0 -1
  503. package/bin/executor/messages/ChatMessageMarkup.js.map +0 -1
  504. package/bin/executor/messages/ChatMessageMarkupTypes.d.ts.map +0 -1
  505. package/bin/executor/messages/ChatMessageMarkupTypes.js.map +0 -1
  506. package/bin/executor/messages/SessionAttachmentMapper.d.ts.map +0 -1
  507. package/bin/executor/messages/SessionAttachmentMapper.js.map +0 -1
  508. package/bin/executor/messages/SessionMessageLog.d.ts.map +0 -1
  509. package/bin/executor/messages/SessionMessageLog.js.map +0 -1
  510. package/bin/executor/messages/SessionModelMessages.d.ts.map +0 -1
  511. package/bin/executor/messages/SessionModelMessages.js.map +0 -1
  512. package/bin/executor/model/ModelGenerate.d.ts.map +0 -1
  513. package/bin/executor/model/ModelGenerate.js.map +0 -1
  514. package/bin/executor/model/ModelRequestRunner.d.ts.map +0 -1
  515. package/bin/executor/model/ModelRequestRunner.js.map +0 -1
  516. package/bin/executor/model/ModelStepRunner.d.ts.map +0 -1
  517. package/bin/executor/model/ModelStepRunner.js.map +0 -1
  518. package/bin/executor/model/ModelStreamConsumer.d.ts.map +0 -1
  519. package/bin/executor/model/ModelStreamConsumer.js.map +0 -1
  520. package/bin/executor/model/ModelStreamFailure.d.ts.map +0 -1
  521. package/bin/executor/model/ModelStreamFailure.js.map +0 -1
  522. package/bin/executor/services/ExecutorRecoveryPolicy.d.ts +0 -39
  523. package/bin/executor/services/ExecutorRecoveryPolicy.d.ts.map +0 -1
  524. package/bin/executor/services/ExecutorRecoveryPolicy.js.map +0 -1
  525. package/bin/executor/types/SessionHistoryMeta.d.ts.map +0 -1
  526. package/bin/executor/types/SessionHistoryMeta.js.map +0 -1
  527. package/bin/executor/types/SessionLoop.d.ts +0 -59
  528. package/bin/executor/types/SessionLoop.d.ts.map +0 -1
  529. package/bin/executor/types/SessionLoop.js +0 -9
  530. package/bin/executor/types/SessionLoop.js.map +0 -1
  531. package/bin/executor/types/SessionPrompts.d.ts +0 -14
  532. package/bin/executor/types/SessionPrompts.d.ts.map +0 -1
  533. package/bin/executor/types/SessionPrompts.js +0 -8
  534. package/bin/executor/types/SessionPrompts.js.map +0 -1
  535. package/bin/session/DefaultSessionComposer.d.ts +0 -24
  536. package/bin/session/DefaultSessionComposer.d.ts.map +0 -1
  537. package/bin/session/DefaultSessionComposer.js +0 -99
  538. package/bin/session/DefaultSessionComposer.js.map +0 -1
  539. package/bin/session/SessionComposition.d.ts +0 -49
  540. package/bin/session/SessionComposition.d.ts.map +0 -1
  541. package/bin/session/SessionComposition.js +0 -309
  542. package/bin/session/SessionComposition.js.map +0 -1
  543. package/bin/session/SessionHookPoints.d.ts +0 -15
  544. package/bin/session/SessionHookPoints.d.ts.map +0 -1
  545. package/bin/session/SessionHookPoints.js +0 -15
  546. package/bin/session/SessionHookPoints.js.map +0 -1
  547. package/bin/session/SessionHooks.d.ts +0 -38
  548. package/bin/session/SessionHooks.d.ts.map +0 -1
  549. package/bin/session/SessionHooks.js +0 -71
  550. package/bin/session/SessionHooks.js.map +0 -1
  551. package/bin/session/SessionLoop.d.ts.map +0 -1
  552. package/bin/session/SessionLoop.js.map +0 -1
  553. package/bin/session/SessionMessages.d.ts.map +0 -1
  554. package/bin/session/SessionMessages.js.map +0 -1
  555. package/bin/session/SessionQueue.d.ts.map +0 -1
  556. package/bin/session/SessionQueue.js.map +0 -1
  557. package/bin/session/SessionState.d.ts.map +0 -1
  558. package/bin/session/SessionState.js.map +0 -1
  559. package/bin/session/SessionSystem.d.ts +0 -19
  560. package/bin/session/SessionSystem.d.ts.map +0 -1
  561. package/bin/session/SessionSystem.js.map +0 -1
  562. package/bin/session/SessionTitle.d.ts.map +0 -1
  563. package/bin/session/SessionTitle.js.map +0 -1
  564. package/bin/session/browse/Browse.d.ts.map +0 -1
  565. package/bin/session/browse/Browse.js.map +0 -1
  566. package/bin/session/browse/SessionMessageTimeline.d.ts.map +0 -1
  567. package/bin/session/browse/SessionMessageTimeline.js.map +0 -1
  568. package/bin/session/composer/policies/AdaptivePartContextPolicy.d.ts +0 -35
  569. package/bin/session/composer/policies/AdaptivePartContextPolicy.d.ts.map +0 -1
  570. package/bin/session/composer/policies/AdaptivePartContextPolicy.js +0 -256
  571. package/bin/session/composer/policies/AdaptivePartContextPolicy.js.map +0 -1
  572. package/bin/session/composer/policies/FullHistoryContextPolicy.d.ts +0 -24
  573. package/bin/session/composer/policies/FullHistoryContextPolicy.d.ts.map +0 -1
  574. package/bin/session/composer/policies/FullHistoryContextPolicy.js +0 -31
  575. package/bin/session/composer/policies/FullHistoryContextPolicy.js.map +0 -1
  576. package/bin/session/composer/policies/SessionSummaryPrompts.d.ts.map +0 -1
  577. package/bin/session/composer/policies/SessionSummaryPrompts.js.map +0 -1
  578. package/bin/session/control/SessionInteractions.d.ts +0 -39
  579. package/bin/session/control/SessionInteractions.d.ts.map +0 -1
  580. package/bin/session/control/SessionInteractions.js +0 -255
  581. package/bin/session/control/SessionInteractions.js.map +0 -1
  582. package/bin/session/execution/SessionAssistantOutputAdapter.d.ts.map +0 -1
  583. package/bin/session/execution/SessionAssistantOutputAdapter.js.map +0 -1
  584. package/bin/session/execution/tools/SessionShellApprovalAdapter.d.ts +0 -28
  585. package/bin/session/execution/tools/SessionShellApprovalAdapter.d.ts.map +0 -1
  586. package/bin/session/execution/tools/SessionShellApprovalAdapter.js +0 -87
  587. package/bin/session/execution/tools/SessionShellApprovalAdapter.js.map +0 -1
  588. package/bin/session/messages/SessionAgentActionPartWriter.d.ts +0 -22
  589. package/bin/session/messages/SessionAgentActionPartWriter.d.ts.map +0 -1
  590. package/bin/session/messages/SessionAgentActionPartWriter.js +0 -36
  591. package/bin/session/messages/SessionAgentActionPartWriter.js.map +0 -1
  592. package/bin/session/messages/SessionMessageInteractionWriter.d.ts +0 -46
  593. package/bin/session/messages/SessionMessageInteractionWriter.d.ts.map +0 -1
  594. package/bin/session/messages/SessionMessageInteractionWriter.js +0 -183
  595. package/bin/session/messages/SessionMessageInteractionWriter.js.map +0 -1
  596. package/bin/session/messages/SessionTurnFileDiffBuilder.d.ts.map +0 -1
  597. package/bin/session/messages/SessionTurnFileDiffBuilder.js.map +0 -1
  598. package/bin/session/runtime/SessionEventHub.d.ts.map +0 -1
  599. package/bin/session/runtime/SessionEventHub.js.map +0 -1
  600. package/bin/session/runtime/SessionModelRequestWarning.d.ts.map +0 -1
  601. package/bin/session/runtime/SessionModelRequestWarning.js.map +0 -1
  602. package/bin/session/runtime/SessionTitleTask.d.ts.map +0 -1
  603. package/bin/session/runtime/SessionTitleTask.js.map +0 -1
  604. package/bin/session/runtime/SessionTurnCompletion.d.ts.map +0 -1
  605. package/bin/session/runtime/SessionTurnCompletion.js.map +0 -1
  606. package/bin/session/runtime/SessionTurnContext.d.ts +0 -29
  607. package/bin/session/runtime/SessionTurnContext.d.ts.map +0 -1
  608. package/bin/session/runtime/SessionTurnContext.js.map +0 -1
  609. package/bin/session/runtime/SessionTurnFileDiff.d.ts.map +0 -1
  610. package/bin/session/runtime/SessionTurnFileDiff.js.map +0 -1
  611. package/bin/types/action/ActionResult.d.ts +0 -35
  612. package/bin/types/action/ActionResult.d.ts.map +0 -1
  613. package/bin/types/action/ActionResult.js +0 -18
  614. package/bin/types/action/ActionResult.js.map +0 -1
  615. package/bin/types/executor/ModelRequest.d.ts.map +0 -1
  616. package/bin/types/executor/ModelRequest.js.map +0 -1
  617. package/bin/types/executor/SessionAssistantOutput.d.ts.map +0 -1
  618. package/bin/types/executor/SessionAssistantOutput.js.map +0 -1
  619. package/bin/types/executor/SessionToolExecutionContext.d.ts +0 -23
  620. package/bin/types/executor/SessionToolExecutionContext.d.ts.map +0 -1
  621. package/bin/types/executor/SessionToolExecutionContext.js +0 -10
  622. package/bin/types/executor/SessionToolExecutionContext.js.map +0 -1
  623. package/bin/types/executor/SessionTurnContext.d.ts.map +0 -1
  624. package/bin/types/executor/SessionTurnContext.js.map +0 -1
  625. package/bin/types/session/AdaptivePartContextPolicy.d.ts.map +0 -1
  626. package/bin/types/session/AdaptivePartContextPolicy.js +0 -7
  627. package/bin/types/session/AdaptivePartContextPolicy.js.map +0 -1
  628. package/bin/types/session/SessionComposition.d.ts.map +0 -1
  629. package/bin/types/session/SessionComposition.js +0 -8
  630. package/bin/types/session/SessionComposition.js.map +0 -1
  631. package/bin/types/session/SessionContextPolicy.d.ts +0 -70
  632. package/bin/types/session/SessionContextPolicy.d.ts.map +0 -1
  633. package/bin/types/session/SessionContextPolicy.js +0 -8
  634. package/bin/types/session/SessionContextPolicy.js.map +0 -1
  635. package/bin/types/tools/ToolActionExecutionContext.d.ts +0 -30
  636. package/bin/types/tools/ToolActionExecutionContext.d.ts.map +0 -1
  637. package/bin/types/tools/ToolActionExecutionContext.js +0 -8
  638. package/bin/types/tools/ToolActionExecutionContext.js.map +0 -1
  639. package/src/executor/Executor.ts +0 -319
  640. package/src/executor/README.md +0 -92
  641. package/src/executor/composer/system/default/assets/core.prompt.ts +0 -9
  642. package/src/executor/core-engine/CoreEngineLoopDecision.ts +0 -63
  643. package/src/executor/core-engine/CoreEngineRunner.ts +0 -458
  644. package/src/executor/types/SessionLoop.ts +0 -69
  645. package/src/executor/types/SessionPrompts.ts +0 -14
  646. package/src/session/DefaultSessionComposer.ts +0 -123
  647. package/src/session/SessionComposition.ts +0 -370
  648. package/src/session/SessionHookPoints.ts +0 -17
  649. package/src/session/SessionHooks.ts +0 -85
  650. package/src/session/composer/policies/AdaptivePartContextPolicy.ts +0 -307
  651. package/src/session/composer/policies/FullHistoryContextPolicy.ts +0 -36
  652. package/src/session/control/SessionInteractions.ts +0 -311
  653. package/src/session/execution/tools/SessionShellApprovalAdapter.ts +0 -105
  654. package/src/session/messages/SessionAgentActionPartWriter.ts +0 -54
  655. package/src/session/messages/SessionMessageInteractionWriter.ts +0 -279
  656. package/src/types/action/ActionResult.ts +0 -50
  657. package/src/types/executor/SessionToolExecutionContext.ts +0 -26
  658. package/src/types/session/SessionContextPolicy.ts +0 -77
  659. package/src/types/tools/ToolActionExecutionContext.ts +0 -32
  660. /package/bin/{executor/model → model}/ModelGenerate.js +0 -0
  661. /package/bin/{executor/model → model}/ModelRequestRunner.js +0 -0
  662. /package/bin/{executor/model → model}/ModelStreamConsumer.d.ts +0 -0
  663. /package/bin/{executor/model → model}/ModelStreamConsumer.js +0 -0
  664. /package/bin/{executor/model → model}/ModelStreamFailure.d.ts +0 -0
  665. /package/bin/{executor/model → model}/ModelStreamFailure.js +0 -0
  666. /package/bin/{executor → model}/messages/ChatMessageMarkup.d.ts +0 -0
  667. /package/bin/{executor → model}/messages/ChatMessageMarkup.js +0 -0
  668. /package/bin/{executor → model}/messages/SessionAttachmentMapper.d.ts +0 -0
  669. /package/bin/{executor → model}/messages/SessionAttachmentMapper.js +0 -0
  670. /package/bin/{executor → model}/messages/SessionMessageLog.d.ts +0 -0
  671. /package/bin/{executor → model}/messages/SessionMessageLog.js +0 -0
  672. /package/bin/{executor → model}/messages/SessionModelMessages.d.ts +0 -0
  673. /package/bin/{executor/composer/system/default → model/prompts}/SystemPromptAssets.d.ts +0 -0
  674. /package/bin/session/{runtime → loop}/SessionTitleTask.d.ts +0 -0
  675. /package/bin/session/{runtime → loop}/SessionTitleTask.js +0 -0
  676. /package/bin/session/{runtime → loop}/SessionTurnFileDiff.d.ts +0 -0
  677. /package/bin/session/{messages → loop}/SessionTurnFileDiffBuilder.js +0 -0
  678. /package/bin/session/{execution → messages}/SessionAssistantOutputAdapter.js +0 -0
  679. /package/bin/session/{runtime → messages}/SessionEventHub.d.ts +0 -0
  680. /package/bin/session/{runtime → messages}/SessionEventHub.js +0 -0
  681. /package/bin/session/{browse → messages}/SessionMessageTimeline.d.ts +0 -0
  682. /package/bin/session/{runtime → messages}/SessionModelRequestWarning.d.ts +0 -0
  683. /package/bin/session/{runtime → messages}/SessionModelRequestWarning.js +0 -0
  684. /package/bin/session/{preview → storage}/SessionMessagePreview.d.ts +0 -0
  685. /package/bin/types/{executor → model}/ModelRequest.d.ts +0 -0
  686. /package/bin/types/{executor → model}/ModelRequest.js +0 -0
  687. /package/bin/{executor/types → types/store}/SessionHistoryMeta.d.ts +0 -0
  688. /package/bin/{executor/types → types/store}/SessionHistoryMeta.js +0 -0
  689. /package/bin/types/{executor → turn}/SessionAssistantOutput.d.ts +0 -0
  690. /package/bin/types/{executor → turn}/SessionAssistantOutput.js +0 -0
  691. /package/bin/types/{executor → turn}/SessionTurnContext.js +0 -0
  692. /package/src/{executor/model → model}/ModelStreamFailure.ts +0 -0
  693. /package/src/{executor → model}/messages/ChatMessageMarkup.ts +0 -0
  694. /package/src/{executor → model}/messages/SessionAttachmentMapper.ts +0 -0
  695. /package/src/{executor → model}/messages/SessionMessageLog.ts +0 -0
  696. /package/src/session/{runtime → loop}/SessionTitleTask.ts +0 -0
  697. /package/src/session/{runtime → messages}/SessionEventHub.ts +0 -0
  698. /package/src/session/{runtime → messages}/SessionModelRequestWarning.ts +0 -0
  699. /package/src/types/{executor → model}/ModelRequest.ts +0 -0
  700. /package/src/{executor/types → types/store}/SessionHistoryMeta.ts +0 -0
  701. /package/src/types/{executor → turn}/SessionAssistantOutput.ts +0 -0
  702. /package/src/{executor/ids/resolveSessionId.ts → utils/ResolveSessionId.ts} +0 -0
@@ -1,256 +0,0 @@
1
- /**
2
- * 基于稳定 Part 游标的自适应上下文策略。
3
- *
4
- * Message 仍是 canonical 持久化聚合,Part 是上下文取舍与摘要边界。策略只写自己的
5
- * checkpoint 派生表,不修改 Message;单个 Agent Message 很大时也可以在
6
- * Message 内部形成摘要边界。
7
- */
8
- import { generate_id } from "../../../utils/Id.js";
9
- import { build_text_model_messages, generate_model } from "../../../executor/model/ModelGenerate.js";
10
- import { session_messages_to_model_messages } from "../../../executor/messages/SessionModelMessages.js";
11
- import { build_initial_session_summary_prompt, build_updated_session_summary_prompt, SESSION_SUMMARY_SYSTEM_PROMPT, } from "../../../session/composer/policies/SessionSummaryPrompts.js";
12
- const POLICY_VERSION = 1;
13
- const SUMMARY_MAX_OUTPUT_TOKENS = 4_000;
14
- const CHECKPOINT_TABLE = "composer_adaptive_part_checkpoints";
15
- /** 默认 Part 级上下文策略。 */
16
- export class AdaptivePartContextPolicy {
17
- name = "adaptive_part";
18
- /** 创建当前策略独享的 checkpoint 表。 */
19
- async initialize(input) {
20
- await input.storage.transaction((transaction) => {
21
- transaction.execute(`
22
- CREATE TABLE IF NOT EXISTS ${CHECKPOINT_TABLE} (
23
- checkpoint_id TEXT PRIMARY KEY,
24
- through_message_id TEXT NOT NULL REFERENCES messages(message_id) ON DELETE CASCADE,
25
- through_message_sequence INTEGER NOT NULL,
26
- through_part_sequence INTEGER NOT NULL,
27
- summary TEXT NOT NULL,
28
- policy_version INTEGER NOT NULL,
29
- created_at INTEGER NOT NULL,
30
- UNIQUE(through_message_sequence, through_part_sequence, policy_version)
31
- )
32
- `);
33
- });
34
- }
35
- /** 返回显式摘要 system block 与 Part 边界后的 canonical 历史。 */
36
- async resolve(input) {
37
- const checkpoint = await this.read_latest_checkpoint(input.storage);
38
- const canonical = await input.storage.list_messages();
39
- const tail = checkpoint
40
- ? slice_messages_after_checkpoint(canonical, checkpoint)
41
- : canonical;
42
- return {
43
- messages: await session_messages_to_model_messages(tail, input.project_root),
44
- ...(checkpoint?.summary.trim()
45
- ? {
46
- system_blocks: [{
47
- source: "session",
48
- name: "context-summary",
49
- content: `<session-context-summary>\n${checkpoint.summary}\n</session-context-summary>`,
50
- }],
51
- }
52
- : {}),
53
- diagnostics: {
54
- policy_name: this.name,
55
- ...(canonical.at(-1)?.sequence !== undefined
56
- ? { through_sequence: canonical.at(-1)?.sequence }
57
- : {}),
58
- ...(checkpoint
59
- ? { through_part_sequence: checkpoint.through_part_sequence }
60
- : {}),
61
- derived: Boolean(checkpoint),
62
- ...(checkpoint ? { derivation_id: checkpoint.checkpoint_id } : {}),
63
- },
64
- };
65
- }
66
- /** 上下文压力出现时,按体积选择较旧稳定 Part 并合并进累计摘要。 */
67
- async recover(input) {
68
- if (!input.model)
69
- return false;
70
- const previous = await this.read_latest_checkpoint(input.storage);
71
- const canonical = await input.storage.list_messages();
72
- const candidates = collect_stable_parts(canonical, previous);
73
- const compact_parts = select_compact_parts(candidates);
74
- const boundary = compact_parts.at(-1);
75
- if (!boundary)
76
- return false;
77
- const conversation_text = compact_parts
78
- .map(candidate_to_summary_text)
79
- .filter(Boolean)
80
- .join("\n");
81
- if (!conversation_text)
82
- return false;
83
- const prompt = previous?.summary.trim()
84
- ? build_updated_session_summary_prompt({
85
- previous_summary: previous.summary,
86
- conversation_text,
87
- })
88
- : build_initial_session_summary_prompt({ conversation_text });
89
- const result = await generate_model(input.model, {
90
- messages: build_text_model_messages(SESSION_SUMMARY_SYSTEM_PROMPT, prompt),
91
- max_output_tokens: SUMMARY_MAX_OUTPUT_TOKENS,
92
- }, {
93
- request_kind: "history_compaction",
94
- on_failure: input.on_model_request_failure,
95
- });
96
- const summary = String(result.text || "").trim();
97
- if (!summary)
98
- throw new Error("Context summary model returned an empty result");
99
- const checkpoint_id = `checkpoint:${generate_id()}`;
100
- try {
101
- await input.storage.transaction((transaction) => {
102
- transaction.execute(`
103
- INSERT INTO ${CHECKPOINT_TABLE} (
104
- checkpoint_id, through_message_id, through_message_sequence,
105
- through_part_sequence, summary, policy_version, created_at
106
- ) VALUES (?, ?, ?, ?, ?, ?, ?)
107
- `, [
108
- checkpoint_id,
109
- boundary.message.message_id,
110
- boundary.message.sequence,
111
- boundary.part.sequence,
112
- summary,
113
- POLICY_VERSION,
114
- Date.now(),
115
- ]);
116
- });
117
- return true;
118
- }
119
- catch (error) {
120
- const latest = await this.read_latest_checkpoint(input.storage);
121
- if (latest && compare_position(latest, boundary) >= 0)
122
- return true;
123
- throw error;
124
- }
125
- }
126
- /** 读取当前版本位置最靠后的累计 checkpoint。 */
127
- async read_latest_checkpoint(storage) {
128
- return await storage.transaction((transaction) => transaction.get(`
129
- SELECT checkpoint_id, through_message_id, through_message_sequence,
130
- through_part_sequence, summary, policy_version, created_at
131
- FROM ${CHECKPOINT_TABLE}
132
- WHERE policy_version = ?
133
- ORDER BY through_message_sequence DESC, through_part_sequence DESC
134
- LIMIT 1
135
- `, [POLICY_VERSION]));
136
- }
137
- }
138
- /** 收集 checkpoint 后适合进入摘要的稳定 Part。 */
139
- function collect_stable_parts(messages, checkpoint) {
140
- return messages.flatMap((message) => message.parts.flatMap((part) => {
141
- if (checkpoint && compare_part_position(message.sequence, part.sequence, checkpoint) <= 0) {
142
- return [];
143
- }
144
- if (!is_stable_summary_part(message, part))
145
- return [];
146
- return [{ message, part }];
147
- }));
148
- }
149
- /** 判断 Part 是否稳定且值得占据累计摘要。 */
150
- function is_stable_summary_part(message, part) {
151
- switch (part.type) {
152
- case "reasoning":
153
- case "action":
154
- case "interaction":
155
- return false;
156
- case "tool":
157
- return part.state === "completed" || part.state === "failed";
158
- case "text":
159
- if (message.role === "user")
160
- return true;
161
- return "state" in part && part.state === "done" && message.state === "done";
162
- case "context":
163
- case "file":
164
- case "data":
165
- case "error":
166
- return true;
167
- default:
168
- return assert_never(part);
169
- }
170
- }
171
- /** 把单个 Part 收窄为摘要模型需要的稳定事实。 */
172
- function candidate_to_summary_text(candidate) {
173
- return JSON.stringify({
174
- role: candidate.message.role,
175
- message_id: candidate.message.message_id,
176
- part: summary_part(candidate.part),
177
- });
178
- }
179
- /** 删除瞬时字段并保留 Tool 调用/结果原子。 */
180
- function summary_part(part) {
181
- switch (part.type) {
182
- case "text":
183
- return { type: "text", text: part.text };
184
- case "context":
185
- return { type: "context", tag: part.tag, context: part.context };
186
- case "file":
187
- return { type: "file", media_type: part.media_type, url: part.url, filename: part.filename };
188
- case "data":
189
- return { type: "data", data_type: part.data_type, data: part.data };
190
- case "tool":
191
- return {
192
- type: "tool",
193
- tool_name: part.tool_name,
194
- input: part.input,
195
- output: part.output,
196
- error: part.error,
197
- };
198
- case "error":
199
- return { type: "error", code: part.code, message: part.message };
200
- case "reasoning":
201
- case "action":
202
- case "interaction":
203
- return { type: part.type };
204
- default:
205
- return assert_never(part);
206
- }
207
- }
208
- /**
209
- * 选择足以释放约一半原始上下文体积的最旧 Part。
210
- *
211
- * 关键点(中文):Part 数量不能代表上下文压力。一个巨大 Tool/Text Part
212
- * 可以独自占满窗口,因此使用送入摘要模型的序列化字符体积作为轻量估算,
213
- * 并保证只有一个可用 Part 时仍能推进 checkpoint。
214
- */
215
- function select_compact_parts(candidates) {
216
- if (candidates.length === 0)
217
- return [];
218
- const sizes = candidates.map((candidate) => Math.max(candidate_to_summary_text(candidate).length, 1));
219
- const target_size = Math.ceil(sizes.reduce((total, size) => total + size, 0) / 2);
220
- let selected_size = 0;
221
- let selected_count = 0;
222
- while (selected_count < candidates.length && selected_size < target_size) {
223
- selected_size += sizes[selected_count] ?? 0;
224
- selected_count += 1;
225
- }
226
- return candidates.slice(0, Math.max(selected_count, 1));
227
- }
228
- /** 删除 checkpoint 以前的 Part;边界可以位于单个 Message 内部。 */
229
- function slice_messages_after_checkpoint(messages, checkpoint) {
230
- return messages.flatMap((message) => {
231
- if (message.sequence < checkpoint.through_message_sequence)
232
- return [];
233
- if (message.sequence > checkpoint.through_message_sequence)
234
- return [message];
235
- const parts = message.parts.filter((part) => part.sequence > checkpoint.through_part_sequence);
236
- if (parts.length === 0)
237
- return [];
238
- return [{ ...message, parts }];
239
- });
240
- }
241
- /** 比较 canonical Part 与 checkpoint 的全局线性位置。 */
242
- function compare_part_position(message_sequence, part_sequence, checkpoint) {
243
- if (message_sequence !== checkpoint.through_message_sequence) {
244
- return message_sequence - checkpoint.through_message_sequence;
245
- }
246
- return part_sequence - checkpoint.through_part_sequence;
247
- }
248
- /** 比较 checkpoint 与候选边界。 */
249
- function compare_position(checkpoint, candidate) {
250
- return -compare_part_position(candidate.message.sequence, candidate.part.sequence, checkpoint);
251
- }
252
- /** canonical Part 联合类型新增成员时强制摘要策略显式选择语义。 */
253
- function assert_never(value) {
254
- throw new Error(`Unsupported summary Session Part: ${String(value.type)}`);
255
- }
256
- //# sourceMappingURL=AdaptivePartContextPolicy.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"AdaptivePartContextPolicy.js","sourceRoot":"","sources":["../../../../src/session/composer/policies/AdaptivePartContextPolicy.ts"],"names":[],"mappings":"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"}
@@ -1,24 +0,0 @@
1
- /**
2
- * 全量历史上下文策略。
3
- *
4
- * 该策略没有派生状态,适用于短会话、测试或拥有足够上下文窗口的模型。
5
- */
6
- import type { SessionContextPolicy } from "../../../types/session/SessionContextPolicy.js";
7
- /** 直接把全部 canonical Message 转换为模型历史。 */
8
- export declare class FullHistoryContextPolicy implements SessionContextPolicy {
9
- readonly name = "full_history";
10
- /** 全量历史策略不需要创建派生表。 */
11
- initialize(): Promise<void>;
12
- /** 按 canonical 顺序返回完整模型历史。 */
13
- resolve(input: Parameters<SessionContextPolicy["resolve"]>[0]): Promise<{
14
- messages: import("@downcity/type").ModelMessage[];
15
- diagnostics: {
16
- derived: boolean;
17
- through_sequence?: number | undefined;
18
- policy_name: string;
19
- };
20
- }>;
21
- /** 没有派生状态,因此无法通过恢复改变上下文。 */
22
- recover(): Promise<boolean>;
23
- }
24
- //# sourceMappingURL=FullHistoryContextPolicy.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"FullHistoryContextPolicy.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/policies/FullHistoryContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAEpF,uCAAuC;AACvC,qBAAa,wBAAyB,YAAW,oBAAoB;IACnE,QAAQ,CAAC,IAAI,kBAAkB;IAE/B,sBAAsB;IAChB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjC,8BAA8B;IACxB,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;;;;;;;;IAcnE,4BAA4B;IACtB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAGlC"}
@@ -1,31 +0,0 @@
1
- /**
2
- * 全量历史上下文策略。
3
- *
4
- * 该策略没有派生状态,适用于短会话、测试或拥有足够上下文窗口的模型。
5
- */
6
- import { session_messages_to_model_messages } from "../../../executor/messages/SessionModelMessages.js";
7
- /** 直接把全部 canonical Message 转换为模型历史。 */
8
- export class FullHistoryContextPolicy {
9
- name = "full_history";
10
- /** 全量历史策略不需要创建派生表。 */
11
- async initialize() { }
12
- /** 按 canonical 顺序返回完整模型历史。 */
13
- async resolve(input) {
14
- const messages = await input.storage.list_messages();
15
- return {
16
- messages: await session_messages_to_model_messages(messages, input.project_root),
17
- diagnostics: {
18
- policy_name: this.name,
19
- ...(messages.at(-1)?.sequence !== undefined
20
- ? { through_sequence: messages.at(-1)?.sequence }
21
- : {}),
22
- derived: false,
23
- },
24
- };
25
- }
26
- /** 没有派生状态,因此无法通过恢复改变上下文。 */
27
- async recover() {
28
- return false;
29
- }
30
- }
31
- //# sourceMappingURL=FullHistoryContextPolicy.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"FullHistoryContextPolicy.js","sourceRoot":"","sources":["../../../../src/session/composer/policies/FullHistoryContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AAGjG,uCAAuC;AACvC,MAAM,OAAO,wBAAwB;IAC1B,IAAI,GAAG,cAAc,CAAC;IAE/B,sBAAsB;IACtB,KAAK,CAAC,UAAU,KAAmB,CAAC;IAEpC,8BAA8B;IAC9B,KAAK,CAAC,OAAO,CAAC,KAAqD;QACjE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACrD,OAAO;YACL,QAAQ,EAAE,MAAM,kCAAkC,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC;YAChF,WAAW,EAAE;gBACX,WAAW,EAAE,IAAI,CAAC,IAAI;gBACtB,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,SAAS;oBACzC,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE;oBACjD,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO,EAAE,KAAK;aACf;SACF,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,OAAO;QACX,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"SessionSummaryPrompts.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/policies/SessionSummaryPrompts.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,2BAA2B;AAC3B,eAAO,MAAM,6BAA6B,QAI9B,CAAC;AAEb,yBAAyB;AACzB,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,8BAA8B;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAQT;AAED,6BAA6B;AAC7B,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,qBAAqB;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAYT"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"SessionSummaryPrompts.js","sourceRoot":"","sources":["../../../../src/session/composer/policies/SessionSummaryPrompts.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,2BAA2B;AAC3B,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,4CAA4C;IAC5C,yEAAyE;IACzE,2DAA2D;CAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,yBAAyB;AACzB,MAAM,UAAU,oCAAoC,CAAC,KAGpD;IACC,OAAO;QACL,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC9B,EAAE;QACF,yEAAyE;QACzE,wHAAwH;QACxH,+FAA+F;KAChG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,oCAAoC,CAAC,KAKpD;IACC,OAAO;QACL,oBAAoB;QACpB,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC7B,qBAAqB;QACrB,EAAE;QACF,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC9B,EAAE;QACF,kDAAkD;QAClD,mHAAmH;QACnH,+FAA+F;KAChG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
@@ -1,39 +0,0 @@
1
- /**
2
- * Session 用户异步交互运行时。
3
- *
4
- * 本模块只拥有 pending waiter、超时与恢复执行;Interaction 的权威状态由
5
- * SessionMessages 持久化。任何终态都必须先提交 canonical Message,再兑现等待 Promise。
6
- */
7
- import type { SessionMessages } from "../../session/SessionMessages.js";
8
- import type { RespondSessionInteractionInput, SessionInteractionHandle, SessionInteractionLifecycle, SessionInteractionPort, SessionInteractionRequest, SessionInteractionResult, SessionPendingInteraction } from "@downcity/type";
9
- /** 单个 Session 的异步用户交互入口。 */
10
- export declare class SessionInteractions implements SessionInteractionPort, SessionInteractionLifecycle {
11
- private readonly session_id;
12
- private readonly messages;
13
- private readonly pending_by_id;
14
- constructor(options: {
15
- /** 当前 Interaction 运行时所属 Session 标识。 */
16
- session_id: string;
17
- /** 当前 Session 的 canonical Message 入口。 */
18
- messages: SessionMessages;
19
- });
20
- /** 创建并持久化一次 Interaction,返回等待终态结果的句柄。 */
21
- request(request: SessionInteractionRequest): Promise<SessionInteractionHandle>;
22
- /** 返回当前 Session 全部 pending Interaction 请求快照。 */
23
- list(): SessionPendingInteraction[];
24
- /** 保存用户响应,并在提交成功后恢复原执行。 */
25
- respond(input: RespondSessionInteractionInput): Promise<SessionInteractionResult>;
26
- /** 取消当前 Session 的全部 pending Interaction。 */
27
- cancel_all(reason: "turn_stopped" | "session_disposed" | "runtime_interrupted"): Promise<void>;
28
- /** 处理单个 Interaction 自动过期。 */
29
- private expire;
30
- /** 校验执行面提交的 Interaction 请求。 */
31
- private validate_request;
32
- /** 校验响应 type、问题集合与回答值。 */
33
- private validate_response;
34
- /** 读取当前 pending Interaction 运行态。 */
35
- private require_pending;
36
- /** 清理运行态并兑现执行方等待 Promise。 */
37
- private finish_pending;
38
- }
39
- //# sourceMappingURL=SessionInteractions.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"SessionInteractions.d.ts","sourceRoot":"","sources":["../../../src/session/control/SessionInteractions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,EAEzB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AAGxB,4BAA4B;AAC5B,qBAAa,mBAAoB,YAAW,sBAAsB,EAAE,2BAA2B;IAC7F,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG1B;gBAEQ,OAAO,EAAE;QACnB,uCAAuC;QACvC,UAAU,EAAE,MAAM,CAAC;QACnB,yCAAyC;QACzC,QAAQ,EAAE,eAAe,CAAC;KAC3B;IAQD,wCAAwC;IAClC,OAAO,CACX,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAsCpC,gDAAgD;IAChD,IAAI,IAAI,yBAAyB,EAAE;IAMnC,2BAA2B;IACrB,OAAO,CACX,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,wBAAwB,CAAC;IAsBpC,4CAA4C;IACtC,UAAU,CACd,MAAM,EAAE,cAAc,GAAG,kBAAkB,GAAG,qBAAqB,GAClE,OAAO,CAAC,IAAI,CAAC;IAqBhB,6BAA6B;YACf,MAAM;IAgBpB,+BAA+B;IAC/B,OAAO,CAAC,gBAAgB;IAkExB,0BAA0B;IAC1B,OAAO,CAAC,iBAAiB;IAyDzB,oCAAoC;IACpC,OAAO,CAAC,eAAe;IAQvB,6BAA6B;IAC7B,OAAO,CAAC,cAAc;CAUvB"}
@@ -1,255 +0,0 @@
1
- /**
2
- * Session 用户异步交互运行时。
3
- *
4
- * 本模块只拥有 pending waiter、超时与恢复执行;Interaction 的权威状态由
5
- * SessionMessages 持久化。任何终态都必须先提交 canonical Message,再兑现等待 Promise。
6
- */
7
- /** 单个 Session 的异步用户交互入口。 */
8
- export class SessionInteractions {
9
- session_id;
10
- messages;
11
- pending_by_id = new Map();
12
- constructor(options) {
13
- this.session_id = String(options.session_id || "").trim();
14
- this.messages = options.messages;
15
- if (!this.session_id) {
16
- throw new Error("SessionInteractions requires a non-empty session_id");
17
- }
18
- }
19
- /** 创建并持久化一次 Interaction,返回等待终态结果的句柄。 */
20
- async request(request) {
21
- this.validate_request(request);
22
- if (this.pending_by_id.has(request.interaction_id)) {
23
- throw new Error(`Session Interaction is already pending: ${request.interaction_id}`);
24
- }
25
- let resolve_result;
26
- const result = new Promise((resolve) => {
27
- resolve_result = resolve;
28
- });
29
- const pending = {
30
- request: structuredClone(request),
31
- resolve: resolve_result,
32
- };
33
- this.pending_by_id.set(request.interaction_id, pending);
34
- try {
35
- await this.messages.request_interaction(request);
36
- }
37
- catch (error) {
38
- this.pending_by_id.delete(request.interaction_id);
39
- throw error;
40
- }
41
- if (request.expires_at !== undefined) {
42
- const delay_ms = Math.max(0, request.expires_at - Date.now());
43
- const timer = setTimeout(() => {
44
- void this.expire(request.interaction_id);
45
- }, delay_ms);
46
- if (typeof timer.unref === "function")
47
- timer.unref();
48
- pending.timer = timer;
49
- }
50
- return {
51
- interaction_id: request.interaction_id,
52
- result,
53
- };
54
- }
55
- /** 返回当前 Session 全部 pending Interaction 请求快照。 */
56
- list() {
57
- return this.messages.list_pending_interactions().map((interaction) => ({
58
- request: structuredClone(interaction.request),
59
- }));
60
- }
61
- /** 保存用户响应,并在提交成功后恢复原执行。 */
62
- async respond(input) {
63
- const pending = this.require_pending(input.interaction_id);
64
- this.validate_response(pending.request, input.response);
65
- await this.messages.resolve_interaction(input.interaction_id, input.response);
66
- const result = input.response.outcome === "denied"
67
- ? {
68
- status: "denied",
69
- interaction_id: input.interaction_id,
70
- reason: extract_interaction_reason(input.response.payload),
71
- }
72
- : {
73
- status: "resolved",
74
- interaction_id: input.interaction_id,
75
- response: structuredClone(input.response),
76
- };
77
- this.finish_pending(input.interaction_id, result);
78
- return result;
79
- }
80
- /** 取消当前 Session 的全部 pending Interaction。 */
81
- async cancel_all(reason) {
82
- let first_error;
83
- for (const interaction_id of [...this.pending_by_id.keys()]) {
84
- const result = {
85
- status: "cancelled",
86
- interaction_id,
87
- reason,
88
- };
89
- try {
90
- await this.messages.close_interaction(interaction_id, {
91
- status: "cancelled",
92
- reason,
93
- });
94
- this.finish_pending(interaction_id, result);
95
- }
96
- catch (error) {
97
- first_error ??= error;
98
- }
99
- }
100
- if (first_error)
101
- throw first_error;
102
- }
103
- /** 处理单个 Interaction 自动过期。 */
104
- async expire(interaction_id) {
105
- if (!this.pending_by_id.has(interaction_id))
106
- return;
107
- const result = {
108
- status: "expired",
109
- interaction_id,
110
- };
111
- try {
112
- await this.messages.close_interaction(interaction_id, {
113
- status: "expired",
114
- });
115
- }
116
- catch {
117
- return;
118
- }
119
- this.finish_pending(interaction_id, result);
120
- }
121
- /** 校验执行面提交的 Interaction 请求。 */
122
- validate_request(request) {
123
- if (!String(request.interaction_id || "").trim()) {
124
- throw new Error("Session Interaction requires interaction_id");
125
- }
126
- if (!String(request.turn_id || "").trim()) {
127
- throw new Error("Session Interaction requires turn_id");
128
- }
129
- if (request.expires_at !== undefined &&
130
- (!Number.isFinite(request.expires_at) || request.expires_at < request.created_at)) {
131
- throw new Error("Session Interaction expires_at must not precede created_at");
132
- }
133
- if (!String(request.type || "").trim()) {
134
- throw new Error("Session Interaction requires a non-empty type");
135
- }
136
- if (!request.source || typeof request.source !== "object") {
137
- throw new Error("Session Interaction requires a source");
138
- }
139
- if (request.type === "question") {
140
- const payload = request.payload;
141
- const questions = payload?.questions;
142
- if (!Array.isArray(questions) || questions.length === 0) {
143
- throw new Error("Question Interaction requires at least one question");
144
- }
145
- const question_ids = new Set();
146
- for (const question of questions) {
147
- if (!String(question.question_id || "").trim()) {
148
- throw new Error("Interaction question requires question_id");
149
- }
150
- if (question_ids.has(String(question.question_id))) {
151
- throw new Error("Duplicate Interaction question_id");
152
- }
153
- question_ids.add(String(question.question_id));
154
- if (!String(question.prompt || "").trim()) {
155
- throw new Error(`Interaction question requires prompt: ${question.question_id}`);
156
- }
157
- if (question.response_type !== "text" &&
158
- (!Array.isArray(question.options) || question.options.length === 0)) {
159
- throw new Error(`Select Interaction question requires options: ${question.question_id}`);
160
- }
161
- if (question.options) {
162
- const option_values = new Set();
163
- for (const option of question.options) {
164
- if (!String(option.value || "").trim()) {
165
- throw new Error(`Interaction option requires value: ${question.question_id}`);
166
- }
167
- const option_value = String(option.value);
168
- if (option_values.has(option_value)) {
169
- throw new Error("Duplicate Interaction option value");
170
- }
171
- option_values.add(option_value);
172
- }
173
- }
174
- }
175
- }
176
- }
177
- /** 校验响应 type、问题集合与回答值。 */
178
- validate_response(request, response) {
179
- if (request.type !== response.type) {
180
- throw new Error("Session Interaction response type mismatch");
181
- }
182
- if (response.outcome !== "resolved" && response.outcome !== "denied") {
183
- throw new Error("Session Interaction response requires a valid outcome");
184
- }
185
- if (request.type !== "question")
186
- return;
187
- const request_payload = request.payload;
188
- const response_payload = response.payload;
189
- const questions = Array.isArray(request_payload.questions)
190
- ? request_payload.questions
191
- : [];
192
- const response_answers = Array.isArray(response_payload?.answers)
193
- ? response_payload.answers
194
- : [];
195
- const answers = new Map();
196
- for (const answer of response_answers) {
197
- const question_id = String(answer.question_id || "");
198
- if (answers.has(question_id)) {
199
- throw new Error("Duplicate Session Interaction answer");
200
- }
201
- answers.set(question_id, answer.value);
202
- }
203
- if (answers.size !== questions.length) {
204
- throw new Error("Session Interaction answer count mismatch");
205
- }
206
- for (const question of questions) {
207
- const question_id = String(question.question_id || "");
208
- const value = answers.get(question_id);
209
- if (value === undefined) {
210
- throw new Error("Session Interaction answer is missing");
211
- }
212
- if (question.response_type === "multi_select") {
213
- if (!Array.isArray(value)) {
214
- throw new Error("Session Interaction answer must be an array");
215
- }
216
- }
217
- else if (typeof value !== "string") {
218
- throw new Error("Session Interaction answer must be a string");
219
- }
220
- if (question.response_type !== "text") {
221
- const allowed = new Set((Array.isArray(question.options) ? question.options : []).map((option) => option.value));
222
- const selected = Array.isArray(value) ? value : [value];
223
- if (selected.some((item) => !allowed.has(item))) {
224
- throw new Error("Session Interaction answer contains an invalid option");
225
- }
226
- }
227
- }
228
- }
229
- /** 读取当前 pending Interaction 运行态。 */
230
- require_pending(interaction_id) {
231
- const pending = this.pending_by_id.get(interaction_id);
232
- if (pending)
233
- return pending;
234
- throw new Error(`Pending Session Interaction not found: ${interaction_id}`);
235
- }
236
- /** 清理运行态并兑现执行方等待 Promise。 */
237
- finish_pending(interaction_id, result) {
238
- const pending = this.pending_by_id.get(interaction_id);
239
- if (!pending)
240
- return;
241
- if (pending.timer)
242
- clearTimeout(pending.timer);
243
- this.pending_by_id.delete(interaction_id);
244
- pending.resolve(result);
245
- }
246
- }
247
- /** 从通用响应 payload 中读取可选的人类可读拒绝原因。 */
248
- function extract_interaction_reason(payload) {
249
- if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
250
- return undefined;
251
- }
252
- const reason = payload.reason;
253
- return typeof reason === "string" ? reason : undefined;
254
- }
255
- //# sourceMappingURL=SessionInteractions.js.map