@vinhnt-sdk/core 0.1.0

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 (575) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +57 -0
  3. package/dist/agent/agent-def.d.ts +11 -0
  4. package/dist/agent/agent-def.d.ts.map +1 -0
  5. package/dist/agent/agent-def.js +2 -0
  6. package/dist/agent/agent-def.js.map +1 -0
  7. package/dist/agent/agent-factory.d.ts +21 -0
  8. package/dist/agent/agent-factory.d.ts.map +1 -0
  9. package/dist/agent/agent-factory.js +119 -0
  10. package/dist/agent/agent-factory.js.map +1 -0
  11. package/dist/agent/agent-file-loader.d.ts +46 -0
  12. package/dist/agent/agent-file-loader.d.ts.map +1 -0
  13. package/dist/agent/agent-file-loader.js +111 -0
  14. package/dist/agent/agent-file-loader.js.map +1 -0
  15. package/dist/agent/agent-parser.d.ts +9 -0
  16. package/dist/agent/agent-parser.d.ts.map +1 -0
  17. package/dist/agent/agent-parser.js +70 -0
  18. package/dist/agent/agent-parser.js.map +1 -0
  19. package/dist/agent/agent-registry.d.ts +49 -0
  20. package/dist/agent/agent-registry.d.ts.map +1 -0
  21. package/dist/agent/agent-registry.js +127 -0
  22. package/dist/agent/agent-registry.js.map +1 -0
  23. package/dist/agent/behaviour-profiles.d.ts +11 -0
  24. package/dist/agent/behaviour-profiles.d.ts.map +1 -0
  25. package/dist/agent/behaviour-profiles.js +46 -0
  26. package/dist/agent/behaviour-profiles.js.map +1 -0
  27. package/dist/agent/create-agent-tool.d.ts +20 -0
  28. package/dist/agent/create-agent-tool.d.ts.map +1 -0
  29. package/dist/agent/create-agent-tool.js +108 -0
  30. package/dist/agent/create-agent-tool.js.map +1 -0
  31. package/dist/agent/default-agents.d.ts +5 -0
  32. package/dist/agent/default-agents.d.ts.map +1 -0
  33. package/dist/agent/default-agents.js +38 -0
  34. package/dist/agent/default-agents.js.map +1 -0
  35. package/dist/agent/delegate-batch-tool.d.ts +10 -0
  36. package/dist/agent/delegate-batch-tool.d.ts.map +1 -0
  37. package/dist/agent/delegate-batch-tool.js +48 -0
  38. package/dist/agent/delegate-batch-tool.js.map +1 -0
  39. package/dist/agent/delegate-tool.d.ts +13 -0
  40. package/dist/agent/delegate-tool.d.ts.map +1 -0
  41. package/dist/agent/delegate-tool.js +49 -0
  42. package/dist/agent/delegate-tool.js.map +1 -0
  43. package/dist/agent/dynamic-registry.d.ts +30 -0
  44. package/dist/agent/dynamic-registry.d.ts.map +1 -0
  45. package/dist/agent/dynamic-registry.js +87 -0
  46. package/dist/agent/dynamic-registry.js.map +1 -0
  47. package/dist/agent/execution-engine.d.ts +25 -0
  48. package/dist/agent/execution-engine.d.ts.map +1 -0
  49. package/dist/agent/execution-engine.js +80 -0
  50. package/dist/agent/execution-engine.js.map +1 -0
  51. package/dist/agent/list-agents-tool.d.ts +4 -0
  52. package/dist/agent/list-agents-tool.d.ts.map +1 -0
  53. package/dist/agent/list-agents-tool.js +43 -0
  54. package/dist/agent/list-agents-tool.js.map +1 -0
  55. package/dist/agent/spawn-agent-tool.d.ts +15 -0
  56. package/dist/agent/spawn-agent-tool.d.ts.map +1 -0
  57. package/dist/agent/spawn-agent-tool.js +77 -0
  58. package/dist/agent/spawn-agent-tool.js.map +1 -0
  59. package/dist/crypto/password.d.ts +11 -0
  60. package/dist/crypto/password.d.ts.map +1 -0
  61. package/dist/crypto/password.js +44 -0
  62. package/dist/crypto/password.js.map +1 -0
  63. package/dist/event-bus/bridge.d.ts +19 -0
  64. package/dist/event-bus/bridge.d.ts.map +1 -0
  65. package/dist/event-bus/bridge.js +48 -0
  66. package/dist/event-bus/bridge.js.map +1 -0
  67. package/dist/event-bus/global-bus.d.ts +30 -0
  68. package/dist/event-bus/global-bus.d.ts.map +1 -0
  69. package/dist/event-bus/global-bus.js +92 -0
  70. package/dist/event-bus/global-bus.js.map +1 -0
  71. package/dist/event-bus/in-memory-bus.d.ts +19 -0
  72. package/dist/event-bus/in-memory-bus.d.ts.map +1 -0
  73. package/dist/event-bus/in-memory-bus.js +97 -0
  74. package/dist/event-bus/in-memory-bus.js.map +1 -0
  75. package/dist/event-bus/index.d.ts +5 -0
  76. package/dist/event-bus/index.d.ts.map +1 -0
  77. package/dist/event-bus/index.js +4 -0
  78. package/dist/event-bus/index.js.map +1 -0
  79. package/dist/event-bus/types.d.ts +20 -0
  80. package/dist/event-bus/types.d.ts.map +1 -0
  81. package/dist/event-bus/types.js +2 -0
  82. package/dist/event-bus/types.js.map +1 -0
  83. package/dist/fakes/fake-agent-registry.d.ts +17 -0
  84. package/dist/fakes/fake-agent-registry.d.ts.map +1 -0
  85. package/dist/fakes/fake-agent-registry.js +70 -0
  86. package/dist/fakes/fake-agent-registry.js.map +1 -0
  87. package/dist/fakes/fake-approval-store.d.ts +27 -0
  88. package/dist/fakes/fake-approval-store.d.ts.map +1 -0
  89. package/dist/fakes/fake-approval-store.js +66 -0
  90. package/dist/fakes/fake-approval-store.js.map +1 -0
  91. package/dist/fakes/fake-model.d.ts +37 -0
  92. package/dist/fakes/fake-model.d.ts.map +1 -0
  93. package/dist/fakes/fake-model.js +63 -0
  94. package/dist/fakes/fake-model.js.map +1 -0
  95. package/dist/fakes/fake-store.d.ts +16 -0
  96. package/dist/fakes/fake-store.d.ts.map +1 -0
  97. package/dist/fakes/fake-store.js +61 -0
  98. package/dist/fakes/fake-store.js.map +1 -0
  99. package/dist/fakes/fake-tool-context.d.ts +28 -0
  100. package/dist/fakes/fake-tool-context.d.ts.map +1 -0
  101. package/dist/fakes/fake-tool-context.js +34 -0
  102. package/dist/fakes/fake-tool-context.js.map +1 -0
  103. package/dist/fakes/fake-tool.d.ts +22 -0
  104. package/dist/fakes/fake-tool.d.ts.map +1 -0
  105. package/dist/fakes/fake-tool.js +27 -0
  106. package/dist/fakes/fake-tool.js.map +1 -0
  107. package/dist/fakes/index.d.ts +7 -0
  108. package/dist/fakes/index.d.ts.map +1 -0
  109. package/dist/fakes/index.js +7 -0
  110. package/dist/fakes/index.js.map +1 -0
  111. package/dist/index.d.ts +111 -0
  112. package/dist/index.d.ts.map +1 -0
  113. package/dist/index.js +72 -0
  114. package/dist/index.js.map +1 -0
  115. package/dist/internal/index.d.ts +5 -0
  116. package/dist/internal/index.d.ts.map +1 -0
  117. package/dist/internal/index.js +8 -0
  118. package/dist/internal/index.js.map +1 -0
  119. package/dist/kernel/approval-handler.d.ts +17 -0
  120. package/dist/kernel/approval-handler.d.ts.map +1 -0
  121. package/dist/kernel/approval-handler.js +28 -0
  122. package/dist/kernel/approval-handler.js.map +1 -0
  123. package/dist/kernel/circuit-breaker.d.ts +25 -0
  124. package/dist/kernel/circuit-breaker.d.ts.map +1 -0
  125. package/dist/kernel/circuit-breaker.js +88 -0
  126. package/dist/kernel/circuit-breaker.js.map +1 -0
  127. package/dist/kernel/context-manager.d.ts +29 -0
  128. package/dist/kernel/context-manager.d.ts.map +1 -0
  129. package/dist/kernel/context-manager.js +64 -0
  130. package/dist/kernel/context-manager.js.map +1 -0
  131. package/dist/kernel/kernel-error.d.ts +7 -0
  132. package/dist/kernel/kernel-error.d.ts.map +1 -0
  133. package/dist/kernel/kernel-error.js +12 -0
  134. package/dist/kernel/kernel-error.js.map +1 -0
  135. package/dist/kernel/kernel-session.d.ts +30 -0
  136. package/dist/kernel/kernel-session.d.ts.map +1 -0
  137. package/dist/kernel/kernel-session.js +92 -0
  138. package/dist/kernel/kernel-session.js.map +1 -0
  139. package/dist/kernel/kernel-types.d.ts +72 -0
  140. package/dist/kernel/kernel-types.d.ts.map +1 -0
  141. package/dist/kernel/kernel-types.js +2 -0
  142. package/dist/kernel/kernel-types.js.map +1 -0
  143. package/dist/kernel/kernel-utils.d.ts +29 -0
  144. package/dist/kernel/kernel-utils.d.ts.map +1 -0
  145. package/dist/kernel/kernel-utils.js +74 -0
  146. package/dist/kernel/kernel-utils.js.map +1 -0
  147. package/dist/kernel/kernel.d.ts +150 -0
  148. package/dist/kernel/kernel.d.ts.map +1 -0
  149. package/dist/kernel/kernel.js +536 -0
  150. package/dist/kernel/kernel.js.map +1 -0
  151. package/dist/kernel/max-steps-prompt.d.ts +3 -0
  152. package/dist/kernel/max-steps-prompt.d.ts.map +1 -0
  153. package/dist/kernel/max-steps-prompt.js +13 -0
  154. package/dist/kernel/max-steps-prompt.js.map +1 -0
  155. package/dist/kernel/model-caller.d.ts +35 -0
  156. package/dist/kernel/model-caller.d.ts.map +1 -0
  157. package/dist/kernel/model-caller.js +196 -0
  158. package/dist/kernel/model-caller.js.map +1 -0
  159. package/dist/kernel/permission-gate.d.ts +74 -0
  160. package/dist/kernel/permission-gate.d.ts.map +1 -0
  161. package/dist/kernel/permission-gate.js +258 -0
  162. package/dist/kernel/permission-gate.js.map +1 -0
  163. package/dist/kernel/run-loop.d.ts +69 -0
  164. package/dist/kernel/run-loop.d.ts.map +1 -0
  165. package/dist/kernel/run-loop.js +437 -0
  166. package/dist/kernel/run-loop.js.map +1 -0
  167. package/dist/kernel/run-orchestrator.d.ts +66 -0
  168. package/dist/kernel/run-orchestrator.d.ts.map +1 -0
  169. package/dist/kernel/run-orchestrator.js +182 -0
  170. package/dist/kernel/run-orchestrator.js.map +1 -0
  171. package/dist/kernel/run-state.d.ts +25 -0
  172. package/dist/kernel/run-state.d.ts.map +1 -0
  173. package/dist/kernel/run-state.js +86 -0
  174. package/dist/kernel/run-state.js.map +1 -0
  175. package/dist/kernel/self-correction.d.ts +27 -0
  176. package/dist/kernel/self-correction.d.ts.map +1 -0
  177. package/dist/kernel/self-correction.js +80 -0
  178. package/dist/kernel/self-correction.js.map +1 -0
  179. package/dist/kernel/state-machine.d.ts +4 -0
  180. package/dist/kernel/state-machine.d.ts.map +1 -0
  181. package/dist/kernel/state-machine.js +18 -0
  182. package/dist/kernel/state-machine.js.map +1 -0
  183. package/dist/kernel/step-executor.d.ts +72 -0
  184. package/dist/kernel/step-executor.d.ts.map +1 -0
  185. package/dist/kernel/step-executor.js +301 -0
  186. package/dist/kernel/step-executor.js.map +1 -0
  187. package/dist/kernel/step-runner.d.ts +57 -0
  188. package/dist/kernel/step-runner.d.ts.map +1 -0
  189. package/dist/kernel/step-runner.js +124 -0
  190. package/dist/kernel/step-runner.js.map +1 -0
  191. package/dist/kernel/sub-agent-runner.d.ts +45 -0
  192. package/dist/kernel/sub-agent-runner.d.ts.map +1 -0
  193. package/dist/kernel/sub-agent-runner.js +128 -0
  194. package/dist/kernel/sub-agent-runner.js.map +1 -0
  195. package/dist/kernel/termination.d.ts +85 -0
  196. package/dist/kernel/termination.d.ts.map +1 -0
  197. package/dist/kernel/termination.js +89 -0
  198. package/dist/kernel/termination.js.map +1 -0
  199. package/dist/kernel/tool-context-builder.d.ts +15 -0
  200. package/dist/kernel/tool-context-builder.d.ts.map +1 -0
  201. package/dist/kernel/tool-context-builder.js +23 -0
  202. package/dist/kernel/tool-context-builder.js.map +1 -0
  203. package/dist/kernel/tool-error-router.d.ts +25 -0
  204. package/dist/kernel/tool-error-router.d.ts.map +1 -0
  205. package/dist/kernel/tool-error-router.js +102 -0
  206. package/dist/kernel/tool-error-router.js.map +1 -0
  207. package/dist/kernel/tool-result-processor.d.ts +22 -0
  208. package/dist/kernel/tool-result-processor.d.ts.map +1 -0
  209. package/dist/kernel/tool-result-processor.js +47 -0
  210. package/dist/kernel/tool-result-processor.js.map +1 -0
  211. package/dist/kernel/tool-saga.d.ts +24 -0
  212. package/dist/kernel/tool-saga.d.ts.map +1 -0
  213. package/dist/kernel/tool-saga.js +59 -0
  214. package/dist/kernel/tool-saga.js.map +1 -0
  215. package/dist/knowledge/approval.d.ts +19 -0
  216. package/dist/knowledge/approval.d.ts.map +1 -0
  217. package/dist/knowledge/approval.js +60 -0
  218. package/dist/knowledge/approval.js.map +1 -0
  219. package/dist/knowledge/compressor.d.ts +46 -0
  220. package/dist/knowledge/compressor.d.ts.map +1 -0
  221. package/dist/knowledge/compressor.js +86 -0
  222. package/dist/knowledge/compressor.js.map +1 -0
  223. package/dist/knowledge/index.d.ts +16 -0
  224. package/dist/knowledge/index.d.ts.map +1 -0
  225. package/dist/knowledge/index.js +10 -0
  226. package/dist/knowledge/index.js.map +1 -0
  227. package/dist/knowledge/learning-engine.d.ts +47 -0
  228. package/dist/knowledge/learning-engine.d.ts.map +1 -0
  229. package/dist/knowledge/learning-engine.js +83 -0
  230. package/dist/knowledge/learning-engine.js.map +1 -0
  231. package/dist/knowledge/llm-compactor.d.ts +25 -0
  232. package/dist/knowledge/llm-compactor.d.ts.map +1 -0
  233. package/dist/knowledge/llm-compactor.js +79 -0
  234. package/dist/knowledge/llm-compactor.js.map +1 -0
  235. package/dist/knowledge/memory-bounded.d.ts +21 -0
  236. package/dist/knowledge/memory-bounded.d.ts.map +1 -0
  237. package/dist/knowledge/memory-bounded.js +63 -0
  238. package/dist/knowledge/memory-bounded.js.map +1 -0
  239. package/dist/knowledge/memory.d.ts +21 -0
  240. package/dist/knowledge/memory.d.ts.map +1 -0
  241. package/dist/knowledge/memory.js +85 -0
  242. package/dist/knowledge/memory.js.map +1 -0
  243. package/dist/knowledge/prompt-builder.d.ts +11 -0
  244. package/dist/knowledge/prompt-builder.d.ts.map +1 -0
  245. package/dist/knowledge/prompt-builder.js +23 -0
  246. package/dist/knowledge/prompt-builder.js.map +1 -0
  247. package/dist/knowledge/review.d.ts +26 -0
  248. package/dist/knowledge/review.d.ts.map +1 -0
  249. package/dist/knowledge/review.js +69 -0
  250. package/dist/knowledge/review.js.map +1 -0
  251. package/dist/knowledge/tool.d.ts +4 -0
  252. package/dist/knowledge/tool.d.ts.map +1 -0
  253. package/dist/knowledge/tool.js +27 -0
  254. package/dist/knowledge/tool.js.map +1 -0
  255. package/dist/knowledge/types.d.ts +27 -0
  256. package/dist/knowledge/types.d.ts.map +1 -0
  257. package/dist/knowledge/types.js +2 -0
  258. package/dist/knowledge/types.js.map +1 -0
  259. package/dist/logger.d.ts +11 -0
  260. package/dist/logger.d.ts.map +1 -0
  261. package/dist/logger.js +44 -0
  262. package/dist/logger.js.map +1 -0
  263. package/dist/model.d.ts +90 -0
  264. package/dist/model.d.ts.map +1 -0
  265. package/dist/model.js +13 -0
  266. package/dist/model.js.map +1 -0
  267. package/dist/permission/checker.d.ts +29 -0
  268. package/dist/permission/checker.d.ts.map +1 -0
  269. package/dist/permission/checker.js +102 -0
  270. package/dist/permission/checker.js.map +1 -0
  271. package/dist/permission/evaluator.d.ts +24 -0
  272. package/dist/permission/evaluator.d.ts.map +1 -0
  273. package/dist/permission/evaluator.js +89 -0
  274. package/dist/permission/evaluator.js.map +1 -0
  275. package/dist/permission/permission.d.ts +29 -0
  276. package/dist/permission/permission.d.ts.map +1 -0
  277. package/dist/permission/permission.js +18 -0
  278. package/dist/permission/permission.js.map +1 -0
  279. package/dist/permission/saved.d.ts +34 -0
  280. package/dist/permission/saved.d.ts.map +1 -0
  281. package/dist/permission/saved.js +43 -0
  282. package/dist/permission/saved.js.map +1 -0
  283. package/dist/plugin/manager.d.ts +33 -0
  284. package/dist/plugin/manager.d.ts.map +1 -0
  285. package/dist/plugin/manager.js +114 -0
  286. package/dist/plugin/manager.js.map +1 -0
  287. package/dist/plugin/plugin-file-loader.d.ts +43 -0
  288. package/dist/plugin/plugin-file-loader.d.ts.map +1 -0
  289. package/dist/plugin/plugin-file-loader.js +115 -0
  290. package/dist/plugin/plugin-file-loader.js.map +1 -0
  291. package/dist/plugin/plugin-tool-provider.d.ts +22 -0
  292. package/dist/plugin/plugin-tool-provider.d.ts.map +1 -0
  293. package/dist/plugin/plugin-tool-provider.js +27 -0
  294. package/dist/plugin/plugin-tool-provider.js.map +1 -0
  295. package/dist/plugin.d.ts +130 -0
  296. package/dist/plugin.d.ts.map +1 -0
  297. package/dist/plugin.js +2 -0
  298. package/dist/plugin.js.map +1 -0
  299. package/dist/session/compaction.d.ts +9 -0
  300. package/dist/session/compaction.d.ts.map +1 -0
  301. package/dist/session/compaction.js +2 -0
  302. package/dist/session/compaction.js.map +1 -0
  303. package/dist/session/durable-reload.d.ts +41 -0
  304. package/dist/session/durable-reload.d.ts.map +1 -0
  305. package/dist/session/durable-reload.js +72 -0
  306. package/dist/session/durable-reload.js.map +1 -0
  307. package/dist/session/in-memory-session-state.d.ts +19 -0
  308. package/dist/session/in-memory-session-state.d.ts.map +1 -0
  309. package/dist/session/in-memory-session-state.js +51 -0
  310. package/dist/session/in-memory-session-state.js.map +1 -0
  311. package/dist/session/null-store.d.ts +30 -0
  312. package/dist/session/null-store.d.ts.map +1 -0
  313. package/dist/session/null-store.js +78 -0
  314. package/dist/session/null-store.js.map +1 -0
  315. package/dist/session/run-coordinator.d.ts +52 -0
  316. package/dist/session/run-coordinator.d.ts.map +1 -0
  317. package/dist/session/run-coordinator.js +127 -0
  318. package/dist/session/run-coordinator.js.map +1 -0
  319. package/dist/session/session-state.d.ts +37 -0
  320. package/dist/session/session-state.d.ts.map +1 -0
  321. package/dist/session/session-state.js +2 -0
  322. package/dist/session/session-state.js.map +1 -0
  323. package/dist/session/session-tree.d.ts +34 -0
  324. package/dist/session/session-tree.d.ts.map +1 -0
  325. package/dist/session/session-tree.js +171 -0
  326. package/dist/session/session-tree.js.map +1 -0
  327. package/dist/session/store.d.ts +45 -0
  328. package/dist/session/store.d.ts.map +1 -0
  329. package/dist/session/store.js +2 -0
  330. package/dist/session/store.js.map +1 -0
  331. package/dist/session/title.d.ts +7 -0
  332. package/dist/session/title.d.ts.map +1 -0
  333. package/dist/session/title.js +22 -0
  334. package/dist/session/title.js.map +1 -0
  335. package/dist/skill/create-skill-tool.d.ts +13 -0
  336. package/dist/skill/create-skill-tool.d.ts.map +1 -0
  337. package/dist/skill/create-skill-tool.js +77 -0
  338. package/dist/skill/create-skill-tool.js.map +1 -0
  339. package/dist/skill/skill-def-registry.d.ts +27 -0
  340. package/dist/skill/skill-def-registry.d.ts.map +1 -0
  341. package/dist/skill/skill-def-registry.js +74 -0
  342. package/dist/skill/skill-def-registry.js.map +1 -0
  343. package/dist/skill/skill-file-loader.d.ts +50 -0
  344. package/dist/skill/skill-file-loader.d.ts.map +1 -0
  345. package/dist/skill/skill-file-loader.js +115 -0
  346. package/dist/skill/skill-file-loader.js.map +1 -0
  347. package/dist/skill/skill-parser.d.ts +7 -0
  348. package/dist/skill/skill-parser.d.ts.map +1 -0
  349. package/dist/skill/skill-parser.js +42 -0
  350. package/dist/skill/skill-parser.js.map +1 -0
  351. package/dist/skill/skill-tool.d.ts +10 -0
  352. package/dist/skill/skill-tool.d.ts.map +1 -0
  353. package/dist/skill/skill-tool.js +100 -0
  354. package/dist/skill/skill-tool.js.map +1 -0
  355. package/dist/system-context/index.d.ts +10 -0
  356. package/dist/system-context/index.d.ts.map +1 -0
  357. package/dist/system-context/index.js +7 -0
  358. package/dist/system-context/index.js.map +1 -0
  359. package/dist/system-context/prompts/anthropic.d.ts +2 -0
  360. package/dist/system-context/prompts/anthropic.d.ts.map +1 -0
  361. package/dist/system-context/prompts/anthropic.js +35 -0
  362. package/dist/system-context/prompts/anthropic.js.map +1 -0
  363. package/dist/system-context/prompts/deepseek.d.ts +2 -0
  364. package/dist/system-context/prompts/deepseek.d.ts.map +1 -0
  365. package/dist/system-context/prompts/deepseek.js +38 -0
  366. package/dist/system-context/prompts/deepseek.js.map +1 -0
  367. package/dist/system-context/prompts/default.d.ts +2 -0
  368. package/dist/system-context/prompts/default.d.ts.map +1 -0
  369. package/dist/system-context/prompts/default.js +43 -0
  370. package/dist/system-context/prompts/default.js.map +1 -0
  371. package/dist/system-context/prompts/gemini.d.ts +2 -0
  372. package/dist/system-context/prompts/gemini.d.ts.map +1 -0
  373. package/dist/system-context/prompts/gemini.js +38 -0
  374. package/dist/system-context/prompts/gemini.js.map +1 -0
  375. package/dist/system-context/prompts/index.d.ts +3 -0
  376. package/dist/system-context/prompts/index.d.ts.map +1 -0
  377. package/dist/system-context/prompts/index.js +24 -0
  378. package/dist/system-context/prompts/index.js.map +1 -0
  379. package/dist/system-context/prompts/openai.d.ts +2 -0
  380. package/dist/system-context/prompts/openai.d.ts.map +1 -0
  381. package/dist/system-context/prompts/openai.js +31 -0
  382. package/dist/system-context/prompts/openai.js.map +1 -0
  383. package/dist/system-context/prompts/system-prompt-source.d.ts +3 -0
  384. package/dist/system-context/prompts/system-prompt-source.d.ts.map +1 -0
  385. package/dist/system-context/prompts/system-prompt-source.js +21 -0
  386. package/dist/system-context/prompts/system-prompt-source.js.map +1 -0
  387. package/dist/system-context/registry.d.ts +3 -0
  388. package/dist/system-context/registry.d.ts.map +1 -0
  389. package/dist/system-context/registry.js +73 -0
  390. package/dist/system-context/registry.js.map +1 -0
  391. package/dist/system-context/sources/agent-source.d.ts +14 -0
  392. package/dist/system-context/sources/agent-source.d.ts.map +1 -0
  393. package/dist/system-context/sources/agent-source.js +50 -0
  394. package/dist/system-context/sources/agent-source.js.map +1 -0
  395. package/dist/system-context/sources/date-source.d.ts +7 -0
  396. package/dist/system-context/sources/date-source.d.ts.map +1 -0
  397. package/dist/system-context/sources/date-source.js +26 -0
  398. package/dist/system-context/sources/date-source.js.map +1 -0
  399. package/dist/system-context/sources/instructions-source.d.ts +8 -0
  400. package/dist/system-context/sources/instructions-source.d.ts.map +1 -0
  401. package/dist/system-context/sources/instructions-source.js +50 -0
  402. package/dist/system-context/sources/instructions-source.js.map +1 -0
  403. package/dist/system-context/sources/skill-guidance-source.d.ts +7 -0
  404. package/dist/system-context/sources/skill-guidance-source.d.ts.map +1 -0
  405. package/dist/system-context/sources/skill-guidance-source.js +41 -0
  406. package/dist/system-context/sources/skill-guidance-source.js.map +1 -0
  407. package/dist/system-context/sources/workspace-source.d.ts +10 -0
  408. package/dist/system-context/sources/workspace-source.d.ts.map +1 -0
  409. package/dist/system-context/sources/workspace-source.js +29 -0
  410. package/dist/system-context/sources/workspace-source.js.map +1 -0
  411. package/dist/system-context/types.d.ts +37 -0
  412. package/dist/system-context/types.d.ts.map +1 -0
  413. package/dist/system-context/types.js +2 -0
  414. package/dist/system-context/types.js.map +1 -0
  415. package/dist/tool/arity.d.ts +22 -0
  416. package/dist/tool/arity.d.ts.map +1 -0
  417. package/dist/tool/arity.js +96 -0
  418. package/dist/tool/arity.js.map +1 -0
  419. package/dist/tool/bridge.d.ts +7 -0
  420. package/dist/tool/bridge.d.ts.map +1 -0
  421. package/dist/tool/bridge.js +48 -0
  422. package/dist/tool/bridge.js.map +1 -0
  423. package/dist/tool/context.d.ts +43 -0
  424. package/dist/tool/context.d.ts.map +1 -0
  425. package/dist/tool/context.js +2 -0
  426. package/dist/tool/context.js.map +1 -0
  427. package/dist/tool/define-tool.d.ts +45 -0
  428. package/dist/tool/define-tool.d.ts.map +1 -0
  429. package/dist/tool/define-tool.js +120 -0
  430. package/dist/tool/define-tool.js.map +1 -0
  431. package/dist/tool/definitions.d.ts +22 -0
  432. package/dist/tool/definitions.d.ts.map +1 -0
  433. package/dist/tool/definitions.js +2 -0
  434. package/dist/tool/definitions.js.map +1 -0
  435. package/dist/tool/description-lint.d.ts +25 -0
  436. package/dist/tool/description-lint.d.ts.map +1 -0
  437. package/dist/tool/description-lint.js +90 -0
  438. package/dist/tool/description-lint.js.map +1 -0
  439. package/dist/tool/diff.d.ts +7 -0
  440. package/dist/tool/diff.d.ts.map +1 -0
  441. package/dist/tool/diff.js +26 -0
  442. package/dist/tool/diff.js.map +1 -0
  443. package/dist/tool/domain.d.ts +39 -0
  444. package/dist/tool/domain.d.ts.map +1 -0
  445. package/dist/tool/domain.js +20 -0
  446. package/dist/tool/domain.js.map +1 -0
  447. package/dist/tool/file-history.d.ts +43 -0
  448. package/dist/tool/file-history.d.ts.map +1 -0
  449. package/dist/tool/file-history.js +55 -0
  450. package/dist/tool/file-history.js.map +1 -0
  451. package/dist/tool/file-tools.d.ts +51 -0
  452. package/dist/tool/file-tools.d.ts.map +1 -0
  453. package/dist/tool/file-tools.js +534 -0
  454. package/dist/tool/file-tools.js.map +1 -0
  455. package/dist/tool/git-tools.d.ts +8 -0
  456. package/dist/tool/git-tools.d.ts.map +1 -0
  457. package/dist/tool/git-tools.js +114 -0
  458. package/dist/tool/git-tools.js.map +1 -0
  459. package/dist/tool/history-hook.d.ts +4 -0
  460. package/dist/tool/history-hook.d.ts.map +1 -0
  461. package/dist/tool/history-hook.js +62 -0
  462. package/dist/tool/history-hook.js.map +1 -0
  463. package/dist/tool/image-tools.d.ts +11 -0
  464. package/dist/tool/image-tools.d.ts.map +1 -0
  465. package/dist/tool/image-tools.js +55 -0
  466. package/dist/tool/image-tools.js.map +1 -0
  467. package/dist/tool/in-memory-tool-registry.d.ts +13 -0
  468. package/dist/tool/in-memory-tool-registry.d.ts.map +1 -0
  469. package/dist/tool/in-memory-tool-registry.js +39 -0
  470. package/dist/tool/in-memory-tool-registry.js.map +1 -0
  471. package/dist/tool/index.d.ts +45 -0
  472. package/dist/tool/index.d.ts.map +1 -0
  473. package/dist/tool/index.js +33 -0
  474. package/dist/tool/index.js.map +1 -0
  475. package/dist/tool/json-schema.d.ts +22 -0
  476. package/dist/tool/json-schema.d.ts.map +1 -0
  477. package/dist/tool/json-schema.js +2 -0
  478. package/dist/tool/json-schema.js.map +1 -0
  479. package/dist/tool/lazy-registry.d.ts +23 -0
  480. package/dist/tool/lazy-registry.d.ts.map +1 -0
  481. package/dist/tool/lazy-registry.js +64 -0
  482. package/dist/tool/lazy-registry.js.map +1 -0
  483. package/dist/tool/policy.d.ts +5 -0
  484. package/dist/tool/policy.d.ts.map +1 -0
  485. package/dist/tool/policy.js +2 -0
  486. package/dist/tool/policy.js.map +1 -0
  487. package/dist/tool/provider-helpers.d.ts +31 -0
  488. package/dist/tool/provider-helpers.d.ts.map +1 -0
  489. package/dist/tool/provider-helpers.js +54 -0
  490. package/dist/tool/provider-helpers.js.map +1 -0
  491. package/dist/tool/provider.d.ts +80 -0
  492. package/dist/tool/provider.d.ts.map +1 -0
  493. package/dist/tool/provider.js +96 -0
  494. package/dist/tool/provider.js.map +1 -0
  495. package/dist/tool/providers/agent-provider.d.ts +26 -0
  496. package/dist/tool/providers/agent-provider.d.ts.map +1 -0
  497. package/dist/tool/providers/agent-provider.js +42 -0
  498. package/dist/tool/providers/agent-provider.js.map +1 -0
  499. package/dist/tool/providers/builtin-provider.d.ts +28 -0
  500. package/dist/tool/providers/builtin-provider.d.ts.map +1 -0
  501. package/dist/tool/providers/builtin-provider.js +67 -0
  502. package/dist/tool/providers/builtin-provider.js.map +1 -0
  503. package/dist/tool/providers/file-loader.d.ts +47 -0
  504. package/dist/tool/providers/file-loader.d.ts.map +1 -0
  505. package/dist/tool/providers/file-loader.js +120 -0
  506. package/dist/tool/providers/file-loader.js.map +1 -0
  507. package/dist/tool/providers/index.d.ts +8 -0
  508. package/dist/tool/providers/index.d.ts.map +1 -0
  509. package/dist/tool/providers/index.js +8 -0
  510. package/dist/tool/providers/index.js.map +1 -0
  511. package/dist/tool/providers/skill-provider.d.ts +23 -0
  512. package/dist/tool/providers/skill-provider.d.ts.map +1 -0
  513. package/dist/tool/providers/skill-provider.js +28 -0
  514. package/dist/tool/providers/skill-provider.js.map +1 -0
  515. package/dist/tool/question-tool.d.ts +15 -0
  516. package/dist/tool/question-tool.d.ts.map +1 -0
  517. package/dist/tool/question-tool.js +51 -0
  518. package/dist/tool/question-tool.js.map +1 -0
  519. package/dist/tool/read-tracker.d.ts +8 -0
  520. package/dist/tool/read-tracker.d.ts.map +1 -0
  521. package/dist/tool/read-tracker.js +33 -0
  522. package/dist/tool/read-tracker.js.map +1 -0
  523. package/dist/tool/registry.d.ts +58 -0
  524. package/dist/tool/registry.d.ts.map +1 -0
  525. package/dist/tool/registry.js +128 -0
  526. package/dist/tool/registry.js.map +1 -0
  527. package/dist/tool/runtime.d.ts +59 -0
  528. package/dist/tool/runtime.d.ts.map +1 -0
  529. package/dist/tool/runtime.js +108 -0
  530. package/dist/tool/runtime.js.map +1 -0
  531. package/dist/tool/sandbox.d.ts +12 -0
  532. package/dist/tool/sandbox.d.ts.map +1 -0
  533. package/dist/tool/sandbox.js +72 -0
  534. package/dist/tool/sandbox.js.map +1 -0
  535. package/dist/tool/search-tools.d.ts +6 -0
  536. package/dist/tool/search-tools.d.ts.map +1 -0
  537. package/dist/tool/search-tools.js +118 -0
  538. package/dist/tool/search-tools.js.map +1 -0
  539. package/dist/tool/shell-tool.d.ts +19 -0
  540. package/dist/tool/shell-tool.d.ts.map +1 -0
  541. package/dist/tool/shell-tool.js +139 -0
  542. package/dist/tool/shell-tool.js.map +1 -0
  543. package/dist/tool/todo-tool.d.ts +2 -0
  544. package/dist/tool/todo-tool.d.ts.map +1 -0
  545. package/dist/tool/todo-tool.js +121 -0
  546. package/dist/tool/todo-tool.js.map +1 -0
  547. package/dist/tool/tool-registry-types.d.ts +14 -0
  548. package/dist/tool/tool-registry-types.d.ts.map +1 -0
  549. package/dist/tool/tool-registry-types.js +2 -0
  550. package/dist/tool/tool-registry-types.js.map +1 -0
  551. package/dist/tool/validate.d.ts +9 -0
  552. package/dist/tool/validate.d.ts.map +1 -0
  553. package/dist/tool/validate.js +26 -0
  554. package/dist/tool/validate.js.map +1 -0
  555. package/dist/tool/web-search-tool.d.ts +24 -0
  556. package/dist/tool/web-search-tool.d.ts.map +1 -0
  557. package/dist/tool/web-search-tool.js +66 -0
  558. package/dist/tool/web-search-tool.js.map +1 -0
  559. package/dist/tool/web-tools.d.ts +10 -0
  560. package/dist/tool/web-tools.d.ts.map +1 -0
  561. package/dist/tool/web-tools.js +61 -0
  562. package/dist/tool/web-tools.js.map +1 -0
  563. package/dist/tracer.d.ts +21 -0
  564. package/dist/tracer.d.ts.map +1 -0
  565. package/dist/tracer.js +62 -0
  566. package/dist/tracer.js.map +1 -0
  567. package/dist/workspace.d.ts +33 -0
  568. package/dist/workspace.d.ts.map +1 -0
  569. package/dist/workspace.js +135 -0
  570. package/dist/workspace.js.map +1 -0
  571. package/dist/yaml-frontmatter.d.ts +5 -0
  572. package/dist/yaml-frontmatter.d.ts.map +1 -0
  573. package/dist/yaml-frontmatter.js +58 -0
  574. package/dist/yaml-frontmatter.js.map +1 -0
  575. package/package.json +108 -0
@@ -0,0 +1,115 @@
1
+ import { readFile, readdir, stat } from "node:fs/promises";
2
+ import { join } from "node:path";
3
+ /**
4
+ * PluginFileLoader — Discovers and loads plugins from file system.
5
+ *
6
+ * Convention:
7
+ * .vnt/plugins/<plugin-id>/plugin.ts (project)
8
+ * .vnt/plugins/<plugin-id>/plugin.js
9
+ * ~/.vnt/plugins/<plugin-id>/plugin.ts (global)
10
+ * ~/.vnt/plugins/<plugin-id>/plugin.js
11
+ * .claude/plugins/<plugin-id>/plugin.ts (Claude-compatible)
12
+ * .agents/plugins/<plugin-id>/plugin.ts (Agents-compatible)
13
+ */
14
+ export class PluginFileLoader {
15
+ parser;
16
+ constructor(config) {
17
+ this.parser = config?.parser ?? defaultPluginParser;
18
+ }
19
+ /**
20
+ * Load plugins from a directory.
21
+ * Each subdirectory with a `plugin.ts` or `plugin.js` file is a plugin.
22
+ */
23
+ async loadFromDirectory(dir, _source) {
24
+ const plugins = [];
25
+ try {
26
+ const entries = await readdir(dir, { withFileTypes: true });
27
+ for (const entry of entries) {
28
+ if (!entry.isDirectory())
29
+ continue;
30
+ const pluginDir = join(dir, entry.name);
31
+ const pluginFile = await findPluginFile(pluginDir);
32
+ if (!pluginFile)
33
+ continue;
34
+ try {
35
+ const content = await readFile(pluginFile, "utf-8");
36
+ const plugin = this.parser(content, pluginFile);
37
+ if (plugin) {
38
+ plugins.push(plugin);
39
+ }
40
+ }
41
+ catch {
42
+ // Skip unreadable files
43
+ }
44
+ }
45
+ }
46
+ catch {
47
+ // Directory doesn't exist — not an error
48
+ }
49
+ return plugins;
50
+ }
51
+ /**
52
+ * Load plugins from multiple directories (global first, then project).
53
+ */
54
+ async loadFromDirectories(dirs) {
55
+ const allPlugins = [];
56
+ // Sort by priority (lower = higher priority)
57
+ const sorted = [...dirs].sort((a, b) => a.priority - b.priority);
58
+ for (const source of sorted) {
59
+ const plugins = await this.loadFromDirectory(source.dir, source);
60
+ for (const plugin of plugins) {
61
+ // Later plugins override earlier ones with same ID
62
+ const existingIdx = allPlugins.findIndex((p) => p.manifest.id === plugin.manifest.id);
63
+ if (existingIdx >= 0) {
64
+ allPlugins[existingIdx] = plugin;
65
+ }
66
+ else {
67
+ allPlugins.push(plugin);
68
+ }
69
+ }
70
+ }
71
+ return allPlugins;
72
+ }
73
+ }
74
+ async function findPluginFile(pluginDir) {
75
+ const candidates = ["plugin.ts", "plugin.js", "index.ts", "index.js"];
76
+ for (const name of candidates) {
77
+ const filePath = join(pluginDir, name);
78
+ try {
79
+ const s = await stat(filePath);
80
+ if (s.isFile())
81
+ return filePath;
82
+ }
83
+ catch {
84
+ // not found
85
+ }
86
+ }
87
+ return null;
88
+ }
89
+ function defaultPluginParser(content, _filePath) {
90
+ // Simple parser: try to extract manifest from file content
91
+ // In production, this would use dynamic import or a safer sandbox
92
+ const idMatch = content.match(/id:\s*["']([^"']+)["']/);
93
+ const nameMatch = content.match(/name:\s*["']([^"']+)["']/);
94
+ const versionMatch = content.match(/version:\s*["']([^"']+)["']/);
95
+ const descMatch = content.match(/description:\s*["']([^"']+)["']/);
96
+ const authorMatch = content.match(/author:\s*["']([^"']+)["']/);
97
+ if (!idMatch)
98
+ return null;
99
+ const manifest = {
100
+ id: idMatch[1],
101
+ name: nameMatch?.[1] ?? idMatch[1],
102
+ version: versionMatch?.[1] ?? "0.0.0",
103
+ description: descMatch?.[1],
104
+ author: authorMatch?.[1],
105
+ };
106
+ // Note: actual hook implementation requires dynamic import at runtime
107
+ // This parser only extracts the manifest metadata
108
+ return {
109
+ manifest,
110
+ async activate() {
111
+ // Plugin activation happens at runtime via dynamic import
112
+ },
113
+ };
114
+ }
115
+ //# sourceMappingURL=plugin-file-loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-file-loader.js","sourceRoot":"","sources":["../../src/plugin/plugin-file-loader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import type { ToolDefinition } from "../tool/definitions.js";
2
+ import type { ToolRegistry } from "../tool/registry.js";
3
+ import type { ToolProvider } from "../tool/provider.js";
4
+ import type { DefaultPluginManager } from "./manager.js";
5
+ /**
6
+ * PluginToolProvider — Wraps tools registered by plugins as a ToolProvider.
7
+ *
8
+ * Each plugin that calls `ctx.registerTool()` during `activate()` gets its
9
+ * tools collected here. The PluginToolProvider then presents them as a
10
+ * single ToolProvider to the ToolProviderRegistry.
11
+ */
12
+ export declare class PluginToolProvider implements ToolProvider {
13
+ readonly id = "plugins";
14
+ readonly name = "Plugin Tools";
15
+ readonly description = "Tools contributed by active plugins";
16
+ private readonly pluginManager;
17
+ constructor(pluginManager: DefaultPluginManager);
18
+ get tools(): ToolDefinition[];
19
+ register(_registry: ToolRegistry): void;
20
+ unregister(_registry: ToolRegistry): void;
21
+ }
22
+ //# sourceMappingURL=plugin-tool-provider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-tool-provider.d.ts","sourceRoot":"","sources":["../../src/plugin/plugin-tool-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,EAAE,aAAa;IACxB,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,yCAAyC;IAE7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;gBAEzC,aAAa,EAAE,oBAAoB;IAI/C,IAAI,KAAK,IAAI,cAAc,EAAE,CAG5B;IAED,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAIvC,UAAU,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;CAG1C"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * PluginToolProvider — Wraps tools registered by plugins as a ToolProvider.
3
+ *
4
+ * Each plugin that calls `ctx.registerTool()` during `activate()` gets its
5
+ * tools collected here. The PluginToolProvider then presents them as a
6
+ * single ToolProvider to the ToolProviderRegistry.
7
+ */
8
+ export class PluginToolProvider {
9
+ id = "plugins";
10
+ name = "Plugin Tools";
11
+ description = "Tools contributed by active plugins";
12
+ pluginManager;
13
+ constructor(pluginManager) {
14
+ this.pluginManager = pluginManager;
15
+ }
16
+ get tools() {
17
+ // Live view — tools are added as plugins activate
18
+ return [...this.pluginManager.tools];
19
+ }
20
+ register(_registry) {
21
+ // Registration is handled by ToolProviderRegistry
22
+ }
23
+ unregister(_registry) {
24
+ // Plugin tools are removed when plugins are deactivated
25
+ }
26
+ }
27
+ //# sourceMappingURL=plugin-tool-provider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-tool-provider.js","sourceRoot":"","sources":["../../src/plugin/plugin-tool-provider.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACpB,EAAE,GAAG,SAAS,CAAC;IACf,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG,qCAAqC,CAAC;IAE5C,aAAa,CAAuB;IAErD,YAAY,aAAmC;QAC7C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,IAAI,KAAK;QACP,kDAAkD;QAClD,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ,CAAC,SAAuB;QAC9B,kDAAkD;IACpD,CAAC;IAED,UAAU,CAAC,SAAuB;QAChC,wDAAwD;IAC1D,CAAC;CACF"}
@@ -0,0 +1,130 @@
1
+ import type { ToolDefinition } from "./tool/definitions.js";
2
+ import type { ContextSourceValue } from "./system-context/types.js";
3
+ import type { AgentRegistry } from "./agent/agent-registry.js";
4
+ import type { ToolProviderRegistry } from "./tool/provider.js";
5
+ import type { EventBus } from "./event-bus/types.js";
6
+ import type { AgentConfig } from "@vinhnt-sdk/schema";
7
+ export interface PluginManifest {
8
+ readonly id: string;
9
+ readonly name: string;
10
+ readonly version: string;
11
+ readonly description?: string;
12
+ readonly author?: string;
13
+ }
14
+ export interface PluginContext {
15
+ registerTool(tool: ToolDefinition): void;
16
+ registerContextSource(source: ContextSourceValue): void;
17
+ registerAgent(config: AgentConfig): Promise<void>;
18
+ getAgentRegistry(): AgentRegistry;
19
+ getToolProviderRegistry(): ToolProviderRegistry;
20
+ getEventBus(): EventBus;
21
+ }
22
+ export type HookResult<T> = {
23
+ modified: T;
24
+ } | null;
25
+ export interface PluginHooks {
26
+ onRunStarted?(data: {
27
+ runId: string;
28
+ prompt: string;
29
+ }): Promise<void>;
30
+ onStepStarted?(data: {
31
+ step: number;
32
+ }): Promise<void>;
33
+ onTokenStreamed?(data: {
34
+ content: string;
35
+ step: number;
36
+ }): Promise<void>;
37
+ onToolCompleted?(data: {
38
+ toolId: string;
39
+ toolName: string;
40
+ output: unknown;
41
+ }): Promise<HookResult<{
42
+ output: unknown;
43
+ }>>;
44
+ onToolFailed?(data: {
45
+ toolId: string;
46
+ toolName: string;
47
+ error: string;
48
+ }): Promise<void>;
49
+ onContextCompressed?(data: {
50
+ originalCount: number;
51
+ compressedCount: number;
52
+ }): Promise<void>;
53
+ onStepCompleted?(data: {
54
+ step: number;
55
+ toolCallCount: number;
56
+ }): Promise<void>;
57
+ onRunCompleted?(data: {
58
+ status: string;
59
+ output?: string;
60
+ error?: string;
61
+ stopCondition?: string;
62
+ }): Promise<void>;
63
+ onToolInvoked?(data: {
64
+ toolId: string;
65
+ toolName: string;
66
+ input: unknown;
67
+ }): Promise<HookResult<{
68
+ input: unknown;
69
+ }>>;
70
+ onPermissionAsk?(data: {
71
+ permission: string;
72
+ resource: string;
73
+ reason: string;
74
+ }): Promise<HookResult<{
75
+ reply: "once" | "always" | "reject";
76
+ } | null>>;
77
+ onChatParams?(data: {
78
+ request: Record<string, unknown>;
79
+ }): Promise<HookResult<{
80
+ request: Record<string, unknown>;
81
+ }>>;
82
+ onShellEnv?(data: {
83
+ env: Record<string, string>;
84
+ }): Promise<HookResult<{
85
+ env: Record<string, string>;
86
+ }>>;
87
+ onBeforeModelCall?(data: {
88
+ request: Record<string, unknown>;
89
+ }): Promise<HookResult<{
90
+ request: Record<string, unknown>;
91
+ }>>;
92
+ onAfterModelCall?(data: {
93
+ response: Record<string, unknown>;
94
+ }): Promise<HookResult<{
95
+ response: Record<string, unknown>;
96
+ }>>;
97
+ onBeforeToolExecution?(data: {
98
+ toolId: string;
99
+ toolName: string;
100
+ input: unknown;
101
+ }): Promise<HookResult<{
102
+ input: unknown;
103
+ }>>;
104
+ onAfterToolExecution?(data: {
105
+ toolId: string;
106
+ toolName: string;
107
+ output: unknown;
108
+ }): Promise<HookResult<{
109
+ output: unknown;
110
+ }>>;
111
+ }
112
+ export interface Plugin {
113
+ readonly manifest: PluginManifest;
114
+ readonly hooks?: PluginHooks;
115
+ activate(ctx: PluginContext): Promise<void>;
116
+ deactivate?(): Promise<void>;
117
+ }
118
+ export type HookName = keyof PluginHooks;
119
+ export type HookPayload<N extends HookName> = Parameters<NonNullable<PluginHooks[N]>>[0];
120
+ export type HookReturn<N extends HookName> = ReturnType<NonNullable<PluginHooks[N]>> extends Promise<HookResult<infer T>> ? HookResult<T> : void;
121
+ export interface PluginManager {
122
+ register(plugin: Plugin): Promise<void>;
123
+ activate(id: string): Promise<void>;
124
+ deactivate(id: string): Promise<void>;
125
+ list(): readonly Plugin[];
126
+ get(id: string): Plugin | undefined;
127
+ getActivePlugins(): readonly Plugin[];
128
+ fireHook<N extends HookName>(name: N, data: HookPayload<N>): Promise<HookReturn<N>>;
129
+ }
130
+ //# sourceMappingURL=plugin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
package/dist/plugin.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=plugin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":""}
@@ -0,0 +1,9 @@
1
+ import type { CompressionSummary } from "@vinhnt-sdk/schema";
2
+ import type { ChatMessage } from "../model.js";
3
+ export interface ConversationCompactor {
4
+ compact(messages: readonly ChatMessage[], signal?: AbortSignal): Promise<{
5
+ messages: readonly ChatMessage[];
6
+ summary: CompressionSummary;
7
+ }>;
8
+ }
9
+ //# sourceMappingURL=compaction.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/session/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,OAAO,CACL,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;QAAC,OAAO,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;CAC/E"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=compaction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../src/session/compaction.ts"],"names":[],"mappings":""}
@@ -0,0 +1,41 @@
1
+ import type { RunId } from "@vinhnt-sdk/schema";
2
+ import type { RunEventStore, SessionStore } from "./store.js";
3
+ import type { SessionRuntimeState } from "./session-state.js";
4
+ /** Result of restoring a run from durable storage. */
5
+ export interface RestoredRun {
6
+ /** The restored session runtime state with messages and step count. */
7
+ sessionState: SessionRuntimeState;
8
+ /** The run ID being restored. */
9
+ runId: RunId;
10
+ /** The session ID associated with the run. */
11
+ sessionId: string | undefined;
12
+ /** The step count restored from snapshot. */
13
+ step: number;
14
+ /** Token counts restored from snapshot. */
15
+ totalInputTokens: number;
16
+ totalOutputTokens: number;
17
+ /** The model name from the snapshot. */
18
+ model: string | undefined;
19
+ /** The final output if the run completed. */
20
+ finalOutput: string | undefined;
21
+ }
22
+ /**
23
+ * Restore a run's state from durable storage (snapshot + messages).
24
+ *
25
+ * This enables "durable history reload" — after a process restart, the kernel
26
+ * can reconstruct the conversation context and continue from where it left off.
27
+ *
28
+ * Usage:
29
+ * const restored = await restoreRunFromStore(store, sessionStore, runId);
30
+ * if (restored) {
31
+ * // Use restored.sessionState to resume the run
32
+ * kernel.run(prompt, ctx, sessionId, restored.sessionState);
33
+ * }
34
+ */
35
+ export declare function restoreRunFromStore(eventStore: RunEventStore, sessionStore: SessionStore | undefined, runId: RunId): Promise<RestoredRun | null>;
36
+ /**
37
+ * Reconstruct session busy state from event store on startup.
38
+ * Returns session IDs that have non-terminal (pending/running) events.
39
+ */
40
+ export declare function findActiveSessionIds(_eventStore: RunEventStore): Promise<string[]>;
41
+ //# sourceMappingURL=durable-reload.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"durable-reload.d.ts","sourceRoot":"","sources":["../../src/session/durable-reload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAW,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,YAAY,EAAE,mBAAmB,CAAC;IAClC,iCAAiC;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,8CAA8C;IAC9C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,6CAA6C;IAC7C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,aAAa,EACzB,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqC7B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,aAAa,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB"}
@@ -0,0 +1,72 @@
1
+ import { InMemorySessionState } from "./in-memory-session-state.js";
2
+ /**
3
+ * Convert a DB Message to a ChatMessage for the run loop.
4
+ */
5
+ function messageToChatMessage(msg) {
6
+ const base = {
7
+ role: msg.role,
8
+ content: msg.content,
9
+ };
10
+ if (msg.toolCallId) {
11
+ base.toolCallId = msg.toolCallId;
12
+ }
13
+ return base;
14
+ }
15
+ /**
16
+ * Restore a run's state from durable storage (snapshot + messages).
17
+ *
18
+ * This enables "durable history reload" — after a process restart, the kernel
19
+ * can reconstruct the conversation context and continue from where it left off.
20
+ *
21
+ * Usage:
22
+ * const restored = await restoreRunFromStore(store, sessionStore, runId);
23
+ * if (restored) {
24
+ * // Use restored.sessionState to resume the run
25
+ * kernel.run(prompt, ctx, sessionId, restored.sessionState);
26
+ * }
27
+ */
28
+ export async function restoreRunFromStore(eventStore, sessionStore, runId) {
29
+ // 1. Try to load snapshot first (O(1))
30
+ const snapshot = await eventStore.getSnapshot(runId);
31
+ // 2. Load events to find run metadata
32
+ const events = await eventStore.list(runId);
33
+ if (events.length === 0)
34
+ return null;
35
+ // Find session ID from snapshot or events
36
+ const sessionId = snapshot?.state?.sessionId;
37
+ // 3. Load persisted messages from SessionStore
38
+ let messages = [];
39
+ if (sessionStore && sessionId) {
40
+ const dbMessages = await sessionStore.listMessages(sessionId);
41
+ messages = dbMessages.map(messageToChatMessage);
42
+ }
43
+ // 4. Reconstruct SessionRuntimeState
44
+ const sessionState = new InMemorySessionState();
45
+ sessionState.resetMessages(messages);
46
+ if (snapshot) {
47
+ sessionState.step = snapshot.state?.step ?? 0;
48
+ sessionState.toolCallCount = snapshot.state?.toolCallCount ?? 0;
49
+ }
50
+ return {
51
+ sessionState,
52
+ runId,
53
+ sessionId,
54
+ step: sessionState.step,
55
+ totalInputTokens: snapshot?.state?.totalInputTokens ?? 0,
56
+ totalOutputTokens: snapshot?.state?.totalOutputTokens ?? 0,
57
+ model: snapshot?.state?.model ?? undefined,
58
+ finalOutput: snapshot?.state?.finalOutput ?? undefined,
59
+ };
60
+ }
61
+ /**
62
+ * Reconstruct session busy state from event store on startup.
63
+ * Returns session IDs that have non-terminal (pending/running) events.
64
+ */
65
+ export async function findActiveSessionIds(_eventStore) {
66
+ // Look for run.started events without corresponding run.completed events
67
+ const activeSessionIds = new Set();
68
+ // This is a simplified implementation — in production, you'd scan
69
+ // all recent events and track which runs are still active
70
+ return [...activeSessionIds];
71
+ }
72
+ //# sourceMappingURL=durable-reload.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"durable-reload.js","sourceRoot":"","sources":["../../src/session/durable-reload.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAqBpE;;GAEG;AACH,SAAS,oBAAoB,CAAC,GAAY;IACxC,MAAM,IAAI,GAAgB;QACxB,IAAI,EAAE,GAAG,CAAC,IAA2B;QACrC,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;IACF,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QAClB,IAA8C,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAyB,EACzB,YAAsC,EACtC,KAAY;IAEZ,uCAAuC;IACvC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAErD,sCAAsC;IACtC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,0CAA0C;IAC1C,MAAM,SAAS,GAAG,QAAQ,EAAE,KAAK,EAAE,SAA+B,CAAC;IAEnE,+CAA+C;IAC/C,IAAI,QAAQ,GAAkB,EAAE,CAAC;IACjC,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC9D,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClD,CAAC;IAED,qCAAqC;IACrC,MAAM,YAAY,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAChD,YAAY,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAErC,IAAI,QAAQ,EAAE,CAAC;QACb,YAAY,CAAC,IAAI,GAAI,QAAQ,CAAC,KAAK,EAAE,IAAe,IAAI,CAAC,CAAC;QAC1D,YAAY,CAAC,aAAa,GAAI,QAAQ,CAAC,KAAK,EAAE,aAAwB,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO;QACL,YAAY;QACZ,KAAK;QACL,SAAS;QACT,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,gBAAgB,EAAG,QAAQ,EAAE,KAAK,EAAE,gBAA2B,IAAI,CAAC;QACpE,iBAAiB,EAAG,QAAQ,EAAE,KAAK,EAAE,iBAA4B,IAAI,CAAC;QACtE,KAAK,EAAG,QAAQ,EAAE,KAAK,EAAE,KAAgB,IAAI,SAAS;QACtD,WAAW,EAAG,QAAQ,EAAE,KAAK,EAAE,WAAsB,IAAI,SAAS;KACnE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAA0B;IAE1B,yEAAyE;IACzE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE3C,kEAAkE;IAClE,0DAA0D;IAC1D,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAC;AAC/B,CAAC"}
@@ -0,0 +1,19 @@
1
+ import type { ChatMessage } from "../model.js";
2
+ import type { SessionRuntimeState, SessionRuntimeSnapshot } from "../session/session-state.js";
3
+ export declare class InMemorySessionState implements SessionRuntimeState {
4
+ private _messages;
5
+ private _context;
6
+ step: number;
7
+ toolCallCount: number;
8
+ isRunning: boolean;
9
+ get messages(): readonly ChatMessage[];
10
+ get context(): ReadonlyMap<string, unknown>;
11
+ pushMessage(msg: ChatMessage): void;
12
+ resetMessages(msgs: readonly ChatMessage[]): void;
13
+ setContext(key: string, value: unknown): void;
14
+ clearContext(): void;
15
+ snapshot(): SessionRuntimeSnapshot;
16
+ restore(snapshot: SessionRuntimeSnapshot): void;
17
+ fork(): SessionRuntimeState;
18
+ }
19
+ //# sourceMappingURL=in-memory-session-state.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"in-memory-session-state.d.ts","sourceRoot":"","sources":["../../src/session/in-memory-session-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE/F,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,IAAI,SAAK;IACT,aAAa,SAAK;IAClB,SAAS,UAAS;IAElB,IAAI,QAAQ,IAAI,SAAS,WAAW,EAAE,CAErC;IAED,IAAI,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAE1C;IAED,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAInC,aAAa,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI;IAIjD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI7C,YAAY,IAAI,IAAI;IAIpB,QAAQ,IAAI,sBAAsB;IAUlC,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAQ/C,IAAI,IAAI,mBAAmB;CAS5B"}
@@ -0,0 +1,51 @@
1
+ export class InMemorySessionState {
2
+ _messages = [];
3
+ _context = new Map();
4
+ step = 0;
5
+ toolCallCount = 0;
6
+ isRunning = false;
7
+ get messages() {
8
+ return this._messages;
9
+ }
10
+ get context() {
11
+ return this._context;
12
+ }
13
+ pushMessage(msg) {
14
+ this._messages.push(msg);
15
+ }
16
+ resetMessages(msgs) {
17
+ this._messages = [...msgs];
18
+ }
19
+ setContext(key, value) {
20
+ this._context.set(key, value);
21
+ }
22
+ clearContext() {
23
+ this._context.clear();
24
+ }
25
+ snapshot() {
26
+ return {
27
+ messages: [...this._messages],
28
+ context: Object.fromEntries(this._context),
29
+ step: this.step,
30
+ toolCallCount: this.toolCallCount,
31
+ isRunning: this.isRunning,
32
+ };
33
+ }
34
+ restore(snapshot) {
35
+ this._messages = [...snapshot.messages];
36
+ this._context = new Map(Object.entries(snapshot.context));
37
+ this.step = snapshot.step;
38
+ this.toolCallCount = snapshot.toolCallCount;
39
+ this.isRunning = snapshot.isRunning;
40
+ }
41
+ fork() {
42
+ const fork = new InMemorySessionState();
43
+ fork._messages = [...this._messages];
44
+ fork._context = new Map(this._context);
45
+ fork.step = this.step;
46
+ fork.toolCallCount = this.toolCallCount;
47
+ fork.isRunning = this.isRunning;
48
+ return fork;
49
+ }
50
+ }
51
+ //# sourceMappingURL=in-memory-session-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"in-memory-session-state.js","sourceRoot":"","sources":["../../src/session/in-memory-session-state.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,oBAAoB;IACvB,SAAS,GAAkB,EAAE,CAAC;IAC9B,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC9C,IAAI,GAAG,CAAC,CAAC;IACT,aAAa,GAAG,CAAC,CAAC;IAClB,SAAS,GAAG,KAAK,CAAC;IAElB,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,WAAW,CAAC,GAAgB;QAC1B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,aAAa,CAAC,IAA4B;QACxC,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,GAAW,EAAE,KAAc;QACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,YAAY;QACV,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,QAAQ;QACN,OAAO;YACL,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;YAC1C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,QAAgC;QACtC,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IACtC,CAAC;IAED,IAAI;QACF,MAAM,IAAI,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
@@ -0,0 +1,30 @@
1
+ import type { RunEvent, Session, Message, SessionStats } from "@vinhnt-sdk/schema";
2
+ import type { RunEventStore, RunEventSnapshot, SessionStore, SessionUpdates } from "./store.js";
3
+ export declare class NullRunEventStore implements RunEventStore {
4
+ private listeners;
5
+ private events;
6
+ append(event: RunEvent): Promise<void>;
7
+ list(_runId: string, _afterSequence?: number): Promise<readonly RunEvent[]>;
8
+ saveSnapshot(_runId: string, _state: Record<string, unknown>): Promise<void>;
9
+ getSnapshot(_runId: string): Promise<RunEventSnapshot | null>;
10
+ getSnapshotAfterSequence(_runId: string, _sequence: number): Promise<RunEventSnapshot | null>;
11
+ getNextSequence(_aggregateId: string): Promise<number>;
12
+ subscribe(listener: (event: RunEvent) => void): () => void;
13
+ }
14
+ export declare class NullSessionStore implements SessionStore {
15
+ createSession(_title?: string, _parentSessionId?: string): Promise<Session>;
16
+ forkSession(_sourceSessionId: string, _title?: string): Promise<Session>;
17
+ getSession(_id: string): Promise<Session | null>;
18
+ listSessions(_limit?: number, _offset?: number): Promise<readonly Session[]>;
19
+ updateSession(_id: string, _updates: SessionUpdates): Promise<void>;
20
+ deleteSession(_id: string): Promise<void>;
21
+ addMessage(_sessionId: string, _role: string, _content: string, _toolCallId?: string, _tokens?: {
22
+ input: number;
23
+ output: number;
24
+ reasoning?: number;
25
+ }, _model?: string, _cost?: number): Promise<Message>;
26
+ listMessages(_sessionId: string): Promise<readonly Message[]>;
27
+ searchMessages(_query: string, _limit?: number): Promise<readonly Message[]>;
28
+ getSessionStats(): Promise<SessionStats>;
29
+ }
30
+ //# sourceMappingURL=null-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"null-store.d.ts","sourceRoot":"","sources":["../../src/session/null-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AACzG,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMhG,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,MAAM,CAAkB;IAE1B,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC;IAI3E,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAE5E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAI7D,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAI7F,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5D,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;CAI3D;AAED,qBAAa,gBAAiB,YAAW,YAAY;IAC7C,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU3E,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUxE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAIhD,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IAI5E,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnE,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEzC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzM,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IAI7D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IAI5E,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;CAG/C"}