@agntk/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 (502) hide show
  1. package/README.md +227 -0
  2. package/dist/advanced/index.d.ts +35 -0
  3. package/dist/advanced/index.d.ts.map +1 -0
  4. package/dist/advanced/index.js +52 -0
  5. package/dist/advanced/index.js.map +1 -0
  6. package/dist/agent.d.ts +46 -0
  7. package/dist/agent.d.ts.map +1 -0
  8. package/dist/agent.js +381 -0
  9. package/dist/agent.js.map +1 -0
  10. package/dist/config/defaults.d.ts +10 -0
  11. package/dist/config/defaults.d.ts.map +1 -0
  12. package/dist/config/defaults.js +34 -0
  13. package/dist/config/defaults.js.map +1 -0
  14. package/dist/config/index.d.ts +7 -0
  15. package/dist/config/index.d.ts.map +1 -0
  16. package/dist/config/index.js +11 -0
  17. package/dist/config/index.js.map +1 -0
  18. package/dist/config/loader.d.ts +54 -0
  19. package/dist/config/loader.d.ts.map +1 -0
  20. package/dist/config/loader.js +222 -0
  21. package/dist/config/loader.js.map +1 -0
  22. package/dist/config/schema.d.ts +912 -0
  23. package/dist/config/schema.d.ts.map +1 -0
  24. package/dist/config/schema.js +119 -0
  25. package/dist/config/schema.js.map +1 -0
  26. package/dist/constants.d.ts +17 -0
  27. package/dist/constants.d.ts.map +1 -0
  28. package/dist/constants.js +23 -0
  29. package/dist/constants.js.map +1 -0
  30. package/dist/evals/assertions.d.ts +54 -0
  31. package/dist/evals/assertions.d.ts.map +1 -0
  32. package/dist/evals/assertions.js +200 -0
  33. package/dist/evals/assertions.js.map +1 -0
  34. package/dist/evals/index.d.ts +9 -0
  35. package/dist/evals/index.d.ts.map +1 -0
  36. package/dist/evals/index.js +8 -0
  37. package/dist/evals/index.js.map +1 -0
  38. package/dist/evals/runner.d.ts +34 -0
  39. package/dist/evals/runner.d.ts.map +1 -0
  40. package/dist/evals/runner.js +186 -0
  41. package/dist/evals/runner.js.map +1 -0
  42. package/dist/evals/types.d.ts +68 -0
  43. package/dist/evals/types.d.ts.map +1 -0
  44. package/dist/evals/types.js +5 -0
  45. package/dist/evals/types.js.map +1 -0
  46. package/dist/guardrails/built-ins.d.ts +48 -0
  47. package/dist/guardrails/built-ins.d.ts.map +1 -0
  48. package/dist/guardrails/built-ins.js +149 -0
  49. package/dist/guardrails/built-ins.js.map +1 -0
  50. package/dist/guardrails/index.d.ts +8 -0
  51. package/dist/guardrails/index.d.ts.map +1 -0
  52. package/dist/guardrails/index.js +7 -0
  53. package/dist/guardrails/index.js.map +1 -0
  54. package/dist/guardrails/runner.d.ts +49 -0
  55. package/dist/guardrails/runner.d.ts.map +1 -0
  56. package/dist/guardrails/runner.js +148 -0
  57. package/dist/guardrails/runner.js.map +1 -0
  58. package/dist/guardrails/types.d.ts +63 -0
  59. package/dist/guardrails/types.d.ts.map +1 -0
  60. package/dist/guardrails/types.js +22 -0
  61. package/dist/guardrails/types.js.map +1 -0
  62. package/dist/index.d.ts +31 -0
  63. package/dist/index.d.ts.map +1 -0
  64. package/dist/index.js +35 -0
  65. package/dist/index.js.map +1 -0
  66. package/dist/memory/engine.d.ts +130 -0
  67. package/dist/memory/engine.d.ts.map +1 -0
  68. package/dist/memory/engine.js +227 -0
  69. package/dist/memory/engine.js.map +1 -0
  70. package/dist/memory/extraction.d.ts +24 -0
  71. package/dist/memory/extraction.d.ts.map +1 -0
  72. package/dist/memory/extraction.js +130 -0
  73. package/dist/memory/extraction.js.map +1 -0
  74. package/dist/memory/loader.d.ts +20 -0
  75. package/dist/memory/loader.d.ts.map +1 -0
  76. package/dist/memory/loader.js +73 -0
  77. package/dist/memory/loader.js.map +1 -0
  78. package/dist/memory/store.d.ts +42 -0
  79. package/dist/memory/store.d.ts.map +1 -0
  80. package/dist/memory/store.js +120 -0
  81. package/dist/memory/store.js.map +1 -0
  82. package/dist/memory/tools.d.ts +39 -0
  83. package/dist/memory/tools.d.ts.map +1 -0
  84. package/dist/memory/tools.js +225 -0
  85. package/dist/memory/tools.js.map +1 -0
  86. package/dist/memory/types.d.ts +46 -0
  87. package/dist/memory/types.d.ts.map +1 -0
  88. package/dist/memory/types.js +8 -0
  89. package/dist/memory/types.js.map +1 -0
  90. package/dist/memory/vectra-store.d.ts +31 -0
  91. package/dist/memory/vectra-store.d.ts.map +1 -0
  92. package/dist/memory/vectra-store.js +122 -0
  93. package/dist/memory/vectra-store.js.map +1 -0
  94. package/dist/models.d.ts +37 -0
  95. package/dist/models.d.ts.map +1 -0
  96. package/dist/models.js +131 -0
  97. package/dist/models.js.map +1 -0
  98. package/dist/observability/index.d.ts +6 -0
  99. package/dist/observability/index.d.ts.map +1 -0
  100. package/dist/observability/index.js +5 -0
  101. package/dist/observability/index.js.map +1 -0
  102. package/dist/observability/langfuse.d.ts +47 -0
  103. package/dist/observability/langfuse.d.ts.map +1 -0
  104. package/dist/observability/langfuse.js +112 -0
  105. package/dist/observability/langfuse.js.map +1 -0
  106. package/dist/observability/types.d.ts +37 -0
  107. package/dist/observability/types.d.ts.map +1 -0
  108. package/dist/observability/types.js +5 -0
  109. package/dist/observability/types.js.map +1 -0
  110. package/dist/pool/index.d.ts +7 -0
  111. package/dist/pool/index.d.ts.map +1 -0
  112. package/dist/pool/index.js +6 -0
  113. package/dist/pool/index.js.map +1 -0
  114. package/dist/pool/specialist-pool.d.ts +59 -0
  115. package/dist/pool/specialist-pool.d.ts.map +1 -0
  116. package/dist/pool/specialist-pool.js +224 -0
  117. package/dist/pool/specialist-pool.js.map +1 -0
  118. package/dist/pool/tools.d.ts +63 -0
  119. package/dist/pool/tools.d.ts.map +1 -0
  120. package/dist/pool/tools.js +83 -0
  121. package/dist/pool/tools.js.map +1 -0
  122. package/dist/pool/types.d.ts +79 -0
  123. package/dist/pool/types.d.ts.map +1 -0
  124. package/dist/pool/types.js +5 -0
  125. package/dist/pool/types.js.map +1 -0
  126. package/dist/presets/index.d.ts +5 -0
  127. package/dist/presets/index.d.ts.map +1 -0
  128. package/dist/presets/index.js +5 -0
  129. package/dist/presets/index.js.map +1 -0
  130. package/dist/presets/role-registry.d.ts +41 -0
  131. package/dist/presets/role-registry.d.ts.map +1 -0
  132. package/dist/presets/role-registry.js +213 -0
  133. package/dist/presets/role-registry.js.map +1 -0
  134. package/dist/presets/roles.d.ts +105 -0
  135. package/dist/presets/roles.d.ts.map +1 -0
  136. package/dist/presets/roles.js +207 -0
  137. package/dist/presets/roles.js.map +1 -0
  138. package/dist/presets/sub-agent-configs.d.ts +19 -0
  139. package/dist/presets/sub-agent-configs.d.ts.map +1 -0
  140. package/dist/presets/sub-agent-configs.js +71 -0
  141. package/dist/presets/sub-agent-configs.js.map +1 -0
  142. package/dist/presets/tool-preset-registry.d.ts +34 -0
  143. package/dist/presets/tool-preset-registry.d.ts.map +1 -0
  144. package/dist/presets/tool-preset-registry.js +107 -0
  145. package/dist/presets/tool-preset-registry.js.map +1 -0
  146. package/dist/presets/tools.d.ts +278 -0
  147. package/dist/presets/tools.d.ts.map +1 -0
  148. package/dist/presets/tools.js +108 -0
  149. package/dist/presets/tools.js.map +1 -0
  150. package/dist/prompts/context.d.ts +47 -0
  151. package/dist/prompts/context.d.ts.map +1 -0
  152. package/dist/prompts/context.js +187 -0
  153. package/dist/prompts/context.js.map +1 -0
  154. package/dist/prompts/template.d.ts +17 -0
  155. package/dist/prompts/template.d.ts.map +1 -0
  156. package/dist/prompts/template.js +32 -0
  157. package/dist/prompts/template.js.map +1 -0
  158. package/dist/prompts/templates.d.ts +11 -0
  159. package/dist/prompts/templates.d.ts.map +1 -0
  160. package/dist/prompts/templates.js +115 -0
  161. package/dist/prompts/templates.js.map +1 -0
  162. package/dist/reflection.d.ts +48 -0
  163. package/dist/reflection.d.ts.map +1 -0
  164. package/dist/reflection.js +91 -0
  165. package/dist/reflection.js.map +1 -0
  166. package/dist/skills/index.d.ts +6 -0
  167. package/dist/skills/index.d.ts.map +1 -0
  168. package/dist/skills/index.js +5 -0
  169. package/dist/skills/index.js.map +1 -0
  170. package/dist/skills/loader.d.ts +84 -0
  171. package/dist/skills/loader.d.ts.map +1 -0
  172. package/dist/skills/loader.js +400 -0
  173. package/dist/skills/loader.js.map +1 -0
  174. package/dist/skills/types.d.ts +66 -0
  175. package/dist/skills/types.d.ts.map +1 -0
  176. package/dist/skills/types.js +6 -0
  177. package/dist/skills/types.js.map +1 -0
  178. package/dist/streaming/data-parts.d.ts +163 -0
  179. package/dist/streaming/data-parts.d.ts.map +1 -0
  180. package/dist/streaming/data-parts.js +14 -0
  181. package/dist/streaming/data-parts.js.map +1 -0
  182. package/dist/streaming/index.d.ts +8 -0
  183. package/dist/streaming/index.d.ts.map +1 -0
  184. package/dist/streaming/index.js +10 -0
  185. package/dist/streaming/index.js.map +1 -0
  186. package/dist/streaming/transient.d.ts +136 -0
  187. package/dist/streaming/transient.d.ts.map +1 -0
  188. package/dist/streaming/transient.js +201 -0
  189. package/dist/streaming/transient.js.map +1 -0
  190. package/dist/tools/approval.d.ts +67 -0
  191. package/dist/tools/approval.d.ts.map +1 -0
  192. package/dist/tools/approval.js +113 -0
  193. package/dist/tools/approval.js.map +1 -0
  194. package/dist/tools/ast-grep/cli.d.ts +16 -0
  195. package/dist/tools/ast-grep/cli.d.ts.map +1 -0
  196. package/dist/tools/ast-grep/cli.js +198 -0
  197. package/dist/tools/ast-grep/cli.js.map +1 -0
  198. package/dist/tools/ast-grep/constants.d.ts +24 -0
  199. package/dist/tools/ast-grep/constants.d.ts.map +1 -0
  200. package/dist/tools/ast-grep/constants.js +247 -0
  201. package/dist/tools/ast-grep/constants.js.map +1 -0
  202. package/dist/tools/ast-grep/downloader.d.ts +6 -0
  203. package/dist/tools/ast-grep/downloader.d.ts.map +1 -0
  204. package/dist/tools/ast-grep/downloader.js +137 -0
  205. package/dist/tools/ast-grep/downloader.js.map +1 -0
  206. package/dist/tools/ast-grep/index.d.ts +7 -0
  207. package/dist/tools/ast-grep/index.d.ts.map +1 -0
  208. package/dist/tools/ast-grep/index.js +6 -0
  209. package/dist/tools/ast-grep/index.js.map +1 -0
  210. package/dist/tools/ast-grep/tools.d.ts +33 -0
  211. package/dist/tools/ast-grep/tools.d.ts.map +1 -0
  212. package/dist/tools/ast-grep/tools.js +140 -0
  213. package/dist/tools/ast-grep/tools.js.map +1 -0
  214. package/dist/tools/ast-grep/types.d.ts +68 -0
  215. package/dist/tools/ast-grep/types.d.ts.map +1 -0
  216. package/dist/tools/ast-grep/types.js +2 -0
  217. package/dist/tools/ast-grep/types.js.map +1 -0
  218. package/dist/tools/ast-grep/utils.d.ts +4 -0
  219. package/dist/tools/ast-grep/utils.d.ts.map +1 -0
  220. package/dist/tools/ast-grep/utils.js +55 -0
  221. package/dist/tools/ast-grep/utils.js.map +1 -0
  222. package/dist/tools/browser/index.d.ts +6 -0
  223. package/dist/tools/browser/index.d.ts.map +1 -0
  224. package/dist/tools/browser/index.js +5 -0
  225. package/dist/tools/browser/index.js.map +1 -0
  226. package/dist/tools/browser/stream.d.ts +112 -0
  227. package/dist/tools/browser/stream.d.ts.map +1 -0
  228. package/dist/tools/browser/stream.js +228 -0
  229. package/dist/tools/browser/stream.js.map +1 -0
  230. package/dist/tools/browser/tool.d.ts +144 -0
  231. package/dist/tools/browser/tool.d.ts.map +1 -0
  232. package/dist/tools/browser/tool.js +214 -0
  233. package/dist/tools/browser/tool.js.map +1 -0
  234. package/dist/tools/browser/types.d.ts +216 -0
  235. package/dist/tools/browser/types.d.ts.map +1 -0
  236. package/dist/tools/browser/types.js +146 -0
  237. package/dist/tools/browser/types.js.map +1 -0
  238. package/dist/tools/deep-reasoning/constants.d.ts +11 -0
  239. package/dist/tools/deep-reasoning/constants.d.ts.map +1 -0
  240. package/dist/tools/deep-reasoning/constants.js +35 -0
  241. package/dist/tools/deep-reasoning/constants.js.map +1 -0
  242. package/dist/tools/deep-reasoning/engine.d.ts +20 -0
  243. package/dist/tools/deep-reasoning/engine.d.ts.map +1 -0
  244. package/dist/tools/deep-reasoning/engine.js +77 -0
  245. package/dist/tools/deep-reasoning/engine.js.map +1 -0
  246. package/dist/tools/deep-reasoning/index.d.ts +5 -0
  247. package/dist/tools/deep-reasoning/index.d.ts.map +1 -0
  248. package/dist/tools/deep-reasoning/index.js +7 -0
  249. package/dist/tools/deep-reasoning/index.js.map +1 -0
  250. package/dist/tools/deep-reasoning/tools.d.ts +12 -0
  251. package/dist/tools/deep-reasoning/tools.d.ts.map +1 -0
  252. package/dist/tools/deep-reasoning/tools.js +23 -0
  253. package/dist/tools/deep-reasoning/tools.js.map +1 -0
  254. package/dist/tools/deep-reasoning/types.d.ts +66 -0
  255. package/dist/tools/deep-reasoning/types.d.ts.map +1 -0
  256. package/dist/tools/deep-reasoning/types.js +13 -0
  257. package/dist/tools/deep-reasoning/types.js.map +1 -0
  258. package/dist/tools/factory.d.ts +109 -0
  259. package/dist/tools/factory.d.ts.map +1 -0
  260. package/dist/tools/factory.js +166 -0
  261. package/dist/tools/factory.js.map +1 -0
  262. package/dist/tools/file/index.d.ts +8 -0
  263. package/dist/tools/file/index.d.ts.map +1 -0
  264. package/dist/tools/file/index.js +8 -0
  265. package/dist/tools/file/index.js.map +1 -0
  266. package/dist/tools/file/tools.d.ts +45 -0
  267. package/dist/tools/file/tools.d.ts.map +1 -0
  268. package/dist/tools/file/tools.js +206 -0
  269. package/dist/tools/file/tools.js.map +1 -0
  270. package/dist/tools/glob/cli.d.ts +8 -0
  271. package/dist/tools/glob/cli.d.ts.map +1 -0
  272. package/dist/tools/glob/cli.js +168 -0
  273. package/dist/tools/glob/cli.js.map +1 -0
  274. package/dist/tools/glob/constants.d.ts +7 -0
  275. package/dist/tools/glob/constants.d.ts.map +1 -0
  276. package/dist/tools/glob/constants.js +17 -0
  277. package/dist/tools/glob/constants.js.map +1 -0
  278. package/dist/tools/glob/index.d.ts +6 -0
  279. package/dist/tools/glob/index.d.ts.map +1 -0
  280. package/dist/tools/glob/index.js +5 -0
  281. package/dist/tools/glob/index.js.map +1 -0
  282. package/dist/tools/glob/tools.d.ts +15 -0
  283. package/dist/tools/glob/tools.d.ts.map +1 -0
  284. package/dist/tools/glob/tools.js +74 -0
  285. package/dist/tools/glob/tools.js.map +1 -0
  286. package/dist/tools/glob/types.d.ts +20 -0
  287. package/dist/tools/glob/types.d.ts.map +1 -0
  288. package/dist/tools/glob/types.js +2 -0
  289. package/dist/tools/glob/types.js.map +1 -0
  290. package/dist/tools/glob/utils.d.ts +3 -0
  291. package/dist/tools/glob/utils.d.ts.map +1 -0
  292. package/dist/tools/glob/utils.js +20 -0
  293. package/dist/tools/glob/utils.js.map +1 -0
  294. package/dist/tools/grep/cli.d.ts +4 -0
  295. package/dist/tools/grep/cli.d.ts.map +1 -0
  296. package/dist/tools/grep/cli.js +224 -0
  297. package/dist/tools/grep/cli.js.map +1 -0
  298. package/dist/tools/grep/constants.d.ts +19 -0
  299. package/dist/tools/grep/constants.d.ts.map +1 -0
  300. package/dist/tools/grep/constants.js +115 -0
  301. package/dist/tools/grep/constants.js.map +1 -0
  302. package/dist/tools/grep/downloader.d.ts +3 -0
  303. package/dist/tools/grep/downloader.d.ts.map +1 -0
  304. package/dist/tools/grep/downloader.js +164 -0
  305. package/dist/tools/grep/downloader.js.map +1 -0
  306. package/dist/tools/grep/index.d.ts +7 -0
  307. package/dist/tools/grep/index.d.ts.map +1 -0
  308. package/dist/tools/grep/index.js +6 -0
  309. package/dist/tools/grep/index.js.map +1 -0
  310. package/dist/tools/grep/tools.d.ts +19 -0
  311. package/dist/tools/grep/tools.d.ts.map +1 -0
  312. package/dist/tools/grep/tools.js +82 -0
  313. package/dist/tools/grep/tools.js.map +1 -0
  314. package/dist/tools/grep/types.d.ts +37 -0
  315. package/dist/tools/grep/types.d.ts.map +1 -0
  316. package/dist/tools/grep/types.js +2 -0
  317. package/dist/tools/grep/types.js.map +1 -0
  318. package/dist/tools/grep/utils.d.ts +4 -0
  319. package/dist/tools/grep/utils.d.ts.map +1 -0
  320. package/dist/tools/grep/utils.js +41 -0
  321. package/dist/tools/grep/utils.js.map +1 -0
  322. package/dist/tools/index.d.ts +21 -0
  323. package/dist/tools/index.d.ts.map +1 -0
  324. package/dist/tools/index.js +33 -0
  325. package/dist/tools/index.js.map +1 -0
  326. package/dist/tools/model-retry.d.ts +54 -0
  327. package/dist/tools/model-retry.d.ts.map +1 -0
  328. package/dist/tools/model-retry.js +110 -0
  329. package/dist/tools/model-retry.js.map +1 -0
  330. package/dist/tools/plan/constants.d.ts +18 -0
  331. package/dist/tools/plan/constants.d.ts.map +1 -0
  332. package/dist/tools/plan/constants.js +13 -0
  333. package/dist/tools/plan/constants.js.map +1 -0
  334. package/dist/tools/plan/index.d.ts +5 -0
  335. package/dist/tools/plan/index.d.ts.map +1 -0
  336. package/dist/tools/plan/index.js +7 -0
  337. package/dist/tools/plan/index.js.map +1 -0
  338. package/dist/tools/plan/tools.d.ts +16 -0
  339. package/dist/tools/plan/tools.d.ts.map +1 -0
  340. package/dist/tools/plan/tools.js +217 -0
  341. package/dist/tools/plan/tools.js.map +1 -0
  342. package/dist/tools/plan/types.d.ts +75 -0
  343. package/dist/tools/plan/types.d.ts.map +1 -0
  344. package/dist/tools/plan/types.js +16 -0
  345. package/dist/tools/plan/types.js.map +1 -0
  346. package/dist/tools/plan/utils.d.ts +9 -0
  347. package/dist/tools/plan/utils.d.ts.map +1 -0
  348. package/dist/tools/plan/utils.js +27 -0
  349. package/dist/tools/plan/utils.js.map +1 -0
  350. package/dist/tools/progress/index.d.ts +53 -0
  351. package/dist/tools/progress/index.d.ts.map +1 -0
  352. package/dist/tools/progress/index.js +144 -0
  353. package/dist/tools/progress/index.js.map +1 -0
  354. package/dist/tools/provider.d.ts +97 -0
  355. package/dist/tools/provider.d.ts.map +1 -0
  356. package/dist/tools/provider.js +178 -0
  357. package/dist/tools/provider.js.map +1 -0
  358. package/dist/tools/search-skills.d.ts +44 -0
  359. package/dist/tools/search-skills.d.ts.map +1 -0
  360. package/dist/tools/search-skills.js +134 -0
  361. package/dist/tools/search-skills.js.map +1 -0
  362. package/dist/tools/shell/background.d.ts +38 -0
  363. package/dist/tools/shell/background.d.ts.map +1 -0
  364. package/dist/tools/shell/background.js +229 -0
  365. package/dist/tools/shell/background.js.map +1 -0
  366. package/dist/tools/shell/constants.d.ts +10 -0
  367. package/dist/tools/shell/constants.d.ts.map +1 -0
  368. package/dist/tools/shell/constants.js +55 -0
  369. package/dist/tools/shell/constants.js.map +1 -0
  370. package/dist/tools/shell/index.d.ts +7 -0
  371. package/dist/tools/shell/index.d.ts.map +1 -0
  372. package/dist/tools/shell/index.js +5 -0
  373. package/dist/tools/shell/index.js.map +1 -0
  374. package/dist/tools/shell/tools.d.ts +22 -0
  375. package/dist/tools/shell/tools.d.ts.map +1 -0
  376. package/dist/tools/shell/tools.js +70 -0
  377. package/dist/tools/shell/tools.js.map +1 -0
  378. package/dist/tools/shell/types.d.ts +30 -0
  379. package/dist/tools/shell/types.d.ts.map +1 -0
  380. package/dist/tools/shell/types.js +10 -0
  381. package/dist/tools/shell/types.js.map +1 -0
  382. package/dist/tools/shell/utils.d.ts +7 -0
  383. package/dist/tools/shell/utils.d.ts.map +1 -0
  384. package/dist/tools/shell/utils.js +26 -0
  385. package/dist/tools/shell/utils.js.map +1 -0
  386. package/dist/tools/spawn-agent/index.d.ts +96 -0
  387. package/dist/tools/spawn-agent/index.d.ts.map +1 -0
  388. package/dist/tools/spawn-agent/index.js +168 -0
  389. package/dist/tools/spawn-agent/index.js.map +1 -0
  390. package/dist/tools/utils/errors.d.ts +21 -0
  391. package/dist/tools/utils/errors.d.ts.map +1 -0
  392. package/dist/tools/utils/errors.js +29 -0
  393. package/dist/tools/utils/errors.js.map +1 -0
  394. package/dist/tools/utils/shell.d.ts +23 -0
  395. package/dist/tools/utils/shell.d.ts.map +1 -0
  396. package/dist/tools/utils/shell.js +99 -0
  397. package/dist/tools/utils/shell.js.map +1 -0
  398. package/dist/tools/utils/tool-result.d.ts +6 -0
  399. package/dist/tools/utils/tool-result.d.ts.map +1 -0
  400. package/dist/tools/utils/tool-result.js +22 -0
  401. package/dist/tools/utils/tool-result.js.map +1 -0
  402. package/dist/types/agent.d.ts +218 -0
  403. package/dist/types/agent.d.ts.map +1 -0
  404. package/dist/types/agent.js +6 -0
  405. package/dist/types/agent.js.map +1 -0
  406. package/dist/types/index.d.ts +7 -0
  407. package/dist/types/index.d.ts.map +1 -0
  408. package/dist/types/index.js +6 -0
  409. package/dist/types/index.js.map +1 -0
  410. package/dist/types/lifecycle.d.ts +218 -0
  411. package/dist/types/lifecycle.d.ts.map +1 -0
  412. package/dist/types/lifecycle.js +99 -0
  413. package/dist/types/lifecycle.js.map +1 -0
  414. package/dist/types/streaming.d.ts +120 -0
  415. package/dist/types/streaming.d.ts.map +1 -0
  416. package/dist/types/streaming.js +6 -0
  417. package/dist/types/streaming.js.map +1 -0
  418. package/dist/usage-limits.d.ts +63 -0
  419. package/dist/usage-limits.d.ts.map +1 -0
  420. package/dist/usage-limits.js +88 -0
  421. package/dist/usage-limits.js.map +1 -0
  422. package/dist/utils/logger.d.ts +35 -0
  423. package/dist/utils/logger.d.ts.map +1 -0
  424. package/dist/utils/logger.js +149 -0
  425. package/dist/utils/logger.js.map +1 -0
  426. package/dist/workflow/builders/adapt.d.ts +20 -0
  427. package/dist/workflow/builders/adapt.d.ts.map +1 -0
  428. package/dist/workflow/builders/adapt.js +33 -0
  429. package/dist/workflow/builders/adapt.js.map +1 -0
  430. package/dist/workflow/builders/index.d.ts +8 -0
  431. package/dist/workflow/builders/index.d.ts.map +1 -0
  432. package/dist/workflow/builders/index.js +7 -0
  433. package/dist/workflow/builders/index.js.map +1 -0
  434. package/dist/workflow/builders/parallel.d.ts +25 -0
  435. package/dist/workflow/builders/parallel.d.ts.map +1 -0
  436. package/dist/workflow/builders/parallel.js +60 -0
  437. package/dist/workflow/builders/parallel.js.map +1 -0
  438. package/dist/workflow/builders/pipeline.d.ts +22 -0
  439. package/dist/workflow/builders/pipeline.d.ts.map +1 -0
  440. package/dist/workflow/builders/pipeline.js +48 -0
  441. package/dist/workflow/builders/pipeline.js.map +1 -0
  442. package/dist/workflow/builders/types.d.ts +54 -0
  443. package/dist/workflow/builders/types.d.ts.map +1 -0
  444. package/dist/workflow/builders/types.js +5 -0
  445. package/dist/workflow/builders/types.js.map +1 -0
  446. package/dist/workflow/durable-agent.d.ts +128 -0
  447. package/dist/workflow/durable-agent.d.ts.map +1 -0
  448. package/dist/workflow/durable-agent.js +323 -0
  449. package/dist/workflow/durable-agent.js.map +1 -0
  450. package/dist/workflow/durable-tool.d.ts +103 -0
  451. package/dist/workflow/durable-tool.d.ts.map +1 -0
  452. package/dist/workflow/durable-tool.js +173 -0
  453. package/dist/workflow/durable-tool.js.map +1 -0
  454. package/dist/workflow/hooks.d.ts +318 -0
  455. package/dist/workflow/hooks.d.ts.map +1 -0
  456. package/dist/workflow/hooks.js +629 -0
  457. package/dist/workflow/hooks.js.map +1 -0
  458. package/dist/workflow/index.d.ts +17 -0
  459. package/dist/workflow/index.d.ts.map +1 -0
  460. package/dist/workflow/index.js +24 -0
  461. package/dist/workflow/index.js.map +1 -0
  462. package/dist/workflow/schedulers.d.ts +231 -0
  463. package/dist/workflow/schedulers.d.ts.map +1 -0
  464. package/dist/workflow/schedulers.js +250 -0
  465. package/dist/workflow/schedulers.js.map +1 -0
  466. package/dist/workflow/team/create-team.d.ts +34 -0
  467. package/dist/workflow/team/create-team.d.ts.map +1 -0
  468. package/dist/workflow/team/create-team.js +242 -0
  469. package/dist/workflow/team/create-team.js.map +1 -0
  470. package/dist/workflow/team/index.d.ts +9 -0
  471. package/dist/workflow/team/index.d.ts.map +1 -0
  472. package/dist/workflow/team/index.js +8 -0
  473. package/dist/workflow/team/index.js.map +1 -0
  474. package/dist/workflow/team/machines.d.ts +152 -0
  475. package/dist/workflow/team/machines.d.ts.map +1 -0
  476. package/dist/workflow/team/machines.js +197 -0
  477. package/dist/workflow/team/machines.js.map +1 -0
  478. package/dist/workflow/team/task-board.d.ts +47 -0
  479. package/dist/workflow/team/task-board.d.ts.map +1 -0
  480. package/dist/workflow/team/task-board.js +111 -0
  481. package/dist/workflow/team/task-board.js.map +1 -0
  482. package/dist/workflow/team/tools.d.ts +66 -0
  483. package/dist/workflow/team/tools.d.ts.map +1 -0
  484. package/dist/workflow/team/tools.js +100 -0
  485. package/dist/workflow/team/tools.js.map +1 -0
  486. package/dist/workflow/team/types.d.ts +109 -0
  487. package/dist/workflow/team/types.d.ts.map +1 -0
  488. package/dist/workflow/team/types.js +5 -0
  489. package/dist/workflow/team/types.js.map +1 -0
  490. package/dist/workflow/templates.d.ts +71 -0
  491. package/dist/workflow/templates.d.ts.map +1 -0
  492. package/dist/workflow/templates.js +132 -0
  493. package/dist/workflow/templates.js.map +1 -0
  494. package/dist/workflow/utils.d.ts +29 -0
  495. package/dist/workflow/utils.d.ts.map +1 -0
  496. package/dist/workflow/utils.js +84 -0
  497. package/dist/workflow/utils.js.map +1 -0
  498. package/dist/wrappers/best-of-n.d.ts +69 -0
  499. package/dist/wrappers/best-of-n.d.ts.map +1 -0
  500. package/dist/wrappers/best-of-n.js +242 -0
  501. package/dist/wrappers/best-of-n.js.map +1 -0
  502. package/package.json +101 -0
@@ -0,0 +1,217 @@
1
+ import { tool } from 'ai';
2
+ import { createLogger } from '@agntk/logger';
3
+ import { getToolConfig } from '../../config/index.js';
4
+ import { success, error } from '../utils/tool-result.js';
5
+ import { PLAN_DESCRIPTION, VALIDATION_DESCRIPTION, AVAILABLE_AGENTS, } from './constants.js';
6
+ import { planInputSchema, validationInputSchema, } from './types.js';
7
+ import { runTypeCheck, runTestCommand } from './utils.js';
8
+ const log = createLogger('@agntk/core:plan');
9
+ // Get config values with fallbacks
10
+ function getPlanConfig() {
11
+ const config = getToolConfig('plan');
12
+ return {
13
+ maxSteps: config.maxSteps ?? 100,
14
+ delegationThreshold: config.delegationThreshold ?? 5,
15
+ };
16
+ }
17
+ export function createPlanTool(config = {}) {
18
+ let currentPlan = null;
19
+ let pendingDecision = null;
20
+ function handleCreate(title, steps) {
21
+ const planConfig = getPlanConfig();
22
+ log.debug('plan create', { title, stepCount: steps?.length });
23
+ if (!title || !steps) {
24
+ return error('Title and steps required for create action');
25
+ }
26
+ if (steps.length > planConfig.maxSteps) {
27
+ return error(`Too many steps. Maximum allowed: ${String(planConfig.maxSteps)}, provided: ${String(steps.length)}`);
28
+ }
29
+ currentPlan = {
30
+ title,
31
+ steps: steps.map(name => ({ name, status: 'pending' })),
32
+ createdAt: Date.now(),
33
+ updatedAt: Date.now(),
34
+ };
35
+ if (config.disableDelegation) {
36
+ return success({
37
+ message: `Plan created: "${title}" with ${String(steps.length)} steps`,
38
+ plan: currentPlan,
39
+ scopeAssessment: {
40
+ isLarge: false,
41
+ stepCount: steps.length,
42
+ recommendation: 'Task created. Proceed with implementation (Delegation disabled for this agent).',
43
+ }
44
+ });
45
+ }
46
+ const isLargeTask = steps.length >= planConfig.delegationThreshold;
47
+ let scopeAssessment;
48
+ if (isLargeTask) {
49
+ scopeAssessment = {
50
+ isLarge: true,
51
+ stepCount: steps.length,
52
+ recommendation: `⚠️ This task has ${steps.length} steps. Consider delegating the ENTIRE task to a specialized sub-agent. Pass the original user request along with any context you've gathered. Choose the most appropriate role based on the task type.`,
53
+ availableAgents: [...AVAILABLE_AGENTS],
54
+ handoffExample: 'spawn_agent({ task: "<original user request + your context>", role: "<coder|researcher|analyst>" })',
55
+ };
56
+ }
57
+ else {
58
+ scopeAssessment = {
59
+ isLarge: false,
60
+ stepCount: steps.length,
61
+ recommendation: 'Task size is manageable. Proceed with implementation.',
62
+ };
63
+ }
64
+ if (scopeAssessment.isLarge) {
65
+ pendingDecision = { required: true, stepCount: steps.length };
66
+ return success({
67
+ message: `Plan created: "${title}" with ${String(steps.length)} steps`,
68
+ plan: currentPlan,
69
+ scopeAssessment,
70
+ DECISION_REQUIRED: {
71
+ message: `⚠️ This plan has ${steps.length} steps - substantial work ahead.`,
72
+ recommended: 'delegate',
73
+ reasoning: 'Delegation keeps your context window clean and lets specialized sub-agents focus on implementation while you coordinate.',
74
+ nextStep: 'Call plan({ action: "decide", decision: "delegate" }) to hand off, or decision: "proceed" if you have a specific reason to do it yourself.',
75
+ },
76
+ });
77
+ }
78
+ return success({
79
+ message: `Plan created: "${title}" with ${String(steps.length)} steps`,
80
+ plan: currentPlan,
81
+ scopeAssessment,
82
+ });
83
+ }
84
+ function handleView() {
85
+ if (!currentPlan) {
86
+ return success({ message: 'No active plan' });
87
+ }
88
+ const completed = currentPlan.steps.filter(step => step.status === 'completed').length;
89
+ const total = currentPlan.steps.length;
90
+ const percentage = Math.round((completed / total) * 100);
91
+ return success({
92
+ plan: currentPlan,
93
+ progress: `${String(completed)}/${String(total)} steps completed (${String(percentage)}%)`,
94
+ });
95
+ }
96
+ function handleUpdateStatus(stepName, status) {
97
+ if (!currentPlan || !stepName || !status) {
98
+ return error('Active plan, stepName, and status required');
99
+ }
100
+ const step = currentPlan.steps.find(s => s.name === stepName);
101
+ if (!step) {
102
+ return error(`Step not found: ${stepName}`);
103
+ }
104
+ step.status = status;
105
+ currentPlan.updatedAt = Date.now();
106
+ const completedCount = currentPlan.steps.filter(s => s.status === 'completed').length;
107
+ return success({
108
+ message: `Updated "${stepName}" to ${status}`,
109
+ progress: `${String(completedCount)}/${String(currentPlan.steps.length)} completed`,
110
+ });
111
+ }
112
+ function handleAddNote(stepName, note) {
113
+ if (!currentPlan || !stepName || !note) {
114
+ return error('Active plan, stepName, and note required');
115
+ }
116
+ const noteStep = currentPlan.steps.find(s => s.name === stepName);
117
+ if (!noteStep) {
118
+ return error(`Step not found: ${stepName}`);
119
+ }
120
+ noteStep.notes = note;
121
+ currentPlan.updatedAt = Date.now();
122
+ return success({ message: `Note added to "${stepName}"` });
123
+ }
124
+ function handleAddStep(stepName) {
125
+ const planConfig = getPlanConfig();
126
+ if (!currentPlan || !stepName) {
127
+ return error('Active plan and stepName required');
128
+ }
129
+ if (currentPlan.steps.length >= planConfig.maxSteps) {
130
+ return error(`Cannot add more steps. Maximum allowed: ${String(planConfig.maxSteps)}`);
131
+ }
132
+ currentPlan.steps.push({ name: stepName, status: 'pending' });
133
+ currentPlan.updatedAt = Date.now();
134
+ return success({
135
+ message: `Added step: "${stepName}"`,
136
+ totalSteps: currentPlan.steps.length,
137
+ });
138
+ }
139
+ function handleDecide(decision) {
140
+ if (!pendingDecision?.required) {
141
+ return error('No pending decision. Create a plan first.');
142
+ }
143
+ if (!decision) {
144
+ return error('Decision required: "delegate" or "proceed"');
145
+ }
146
+ const stepCount = pendingDecision.stepCount;
147
+ if (decision === 'delegate') {
148
+ pendingDecision = null;
149
+ return success({
150
+ message: 'You chose to DELEGATE. Now use spawn_agent to hand off the entire task.',
151
+ nextAction: 'spawn_agent({ task: "<original user request + context>", role: "<coder|researcher|analyst>" })',
152
+ availableAgents: [...AVAILABLE_AGENTS],
153
+ });
154
+ }
155
+ else {
156
+ if (config.disableDelegation) {
157
+ pendingDecision = null;
158
+ return success({ message: 'Proceeding with task.' });
159
+ }
160
+ const planConfig = getPlanConfig();
161
+ return error(`Cannot proceed on a ${stepCount}-step plan. Tasks with ${planConfig.delegationThreshold}+ steps MUST be delegated to a sub-agent. Call plan({ action: "decide", decision: "delegate" }) instead.`);
162
+ }
163
+ }
164
+ return tool({
165
+ description: PLAN_DESCRIPTION,
166
+ inputSchema: planInputSchema,
167
+ execute: ({ action, title, steps, decision, stepName, status, note }) => {
168
+ switch (action) {
169
+ case 'create':
170
+ return handleCreate(title, steps);
171
+ case 'decide':
172
+ return handleDecide(decision);
173
+ case 'view':
174
+ return handleView();
175
+ case 'update_status':
176
+ return handleUpdateStatus(stepName, status);
177
+ case 'add_note':
178
+ return handleAddNote(stepName, note);
179
+ case 'add_step':
180
+ return handleAddStep(stepName);
181
+ default:
182
+ return error('Invalid action');
183
+ }
184
+ },
185
+ });
186
+ }
187
+ export function createValidationTool() {
188
+ return tool({
189
+ description: VALIDATION_DESCRIPTION,
190
+ inputSchema: validationInputSchema,
191
+ execute: async ({ checkTypes = true, runTests = false, filesChanged = [] }) => {
192
+ const results = [];
193
+ let allPassed = true;
194
+ if (checkTypes) {
195
+ const typeCheck = await runTypeCheck();
196
+ if (!typeCheck.passed)
197
+ allPassed = false;
198
+ results.push({ check: 'TypeScript type check', ...typeCheck });
199
+ }
200
+ if (runTests) {
201
+ const testRun = await runTestCommand();
202
+ if (!testRun.passed)
203
+ allPassed = false;
204
+ results.push({ check: 'Test suite', ...testRun });
205
+ }
206
+ return success({
207
+ allPassed,
208
+ results,
209
+ filesChanged,
210
+ recommendation: allPassed
211
+ ? 'All checks passed. Safe to proceed.'
212
+ : 'Some checks failed. Fix errors before continuing.',
213
+ });
214
+ },
215
+ });
216
+ }
217
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/tools/plan/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ import { z } from 'zod';
2
+ export interface PlanStep {
3
+ name: string;
4
+ status: 'pending' | 'in_progress' | 'completed' | 'blocked';
5
+ notes?: string;
6
+ }
7
+ export interface Plan {
8
+ title: string;
9
+ steps: PlanStep[];
10
+ createdAt: number;
11
+ updatedAt: number;
12
+ }
13
+ export interface PlanToolConfig {
14
+ disableDelegation?: boolean;
15
+ }
16
+ export interface ScopeAssessment {
17
+ isLarge: boolean;
18
+ stepCount: number;
19
+ recommendation: string;
20
+ availableAgents?: Array<{
21
+ role: string;
22
+ specialization: string;
23
+ }>;
24
+ handoffExample?: string;
25
+ }
26
+ export interface PendingDecision {
27
+ required: boolean;
28
+ stepCount: number;
29
+ }
30
+ export declare const planInputSchema: z.ZodObject<{
31
+ action: z.ZodEnum<["create", "decide", "update_status", "add_note", "add_step", "view"]>;
32
+ title: z.ZodOptional<z.ZodString>;
33
+ steps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
34
+ decision: z.ZodOptional<z.ZodEnum<["delegate", "proceed"]>>;
35
+ stepName: z.ZodOptional<z.ZodString>;
36
+ status: z.ZodOptional<z.ZodEnum<["pending", "in_progress", "completed", "blocked"]>>;
37
+ note: z.ZodOptional<z.ZodString>;
38
+ }, "strip", z.ZodTypeAny, {
39
+ action: "create" | "decide" | "update_status" | "add_note" | "add_step" | "view";
40
+ steps?: string[] | undefined;
41
+ title?: string | undefined;
42
+ status?: "pending" | "blocked" | "completed" | "in_progress" | undefined;
43
+ decision?: "delegate" | "proceed" | undefined;
44
+ stepName?: string | undefined;
45
+ note?: string | undefined;
46
+ }, {
47
+ action: "create" | "decide" | "update_status" | "add_note" | "add_step" | "view";
48
+ steps?: string[] | undefined;
49
+ title?: string | undefined;
50
+ status?: "pending" | "blocked" | "completed" | "in_progress" | undefined;
51
+ decision?: "delegate" | "proceed" | undefined;
52
+ stepName?: string | undefined;
53
+ note?: string | undefined;
54
+ }>;
55
+ export type PlanInput = z.infer<typeof planInputSchema>;
56
+ export declare const validationInputSchema: z.ZodObject<{
57
+ checkTypes: z.ZodOptional<z.ZodBoolean>;
58
+ runTests: z.ZodOptional<z.ZodBoolean>;
59
+ filesChanged: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
60
+ }, "strip", z.ZodTypeAny, {
61
+ checkTypes?: boolean | undefined;
62
+ runTests?: boolean | undefined;
63
+ filesChanged?: string[] | undefined;
64
+ }, {
65
+ checkTypes?: boolean | undefined;
66
+ runTests?: boolean | undefined;
67
+ filesChanged?: string[] | undefined;
68
+ }>;
69
+ export type ValidationInput = z.infer<typeof validationInputSchema>;
70
+ export interface ValidationResult {
71
+ check: string;
72
+ passed: boolean;
73
+ details?: string;
74
+ }
75
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/plan/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;EAQ1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
@@ -0,0 +1,16 @@
1
+ import { z } from 'zod';
2
+ export const planInputSchema = z.object({
3
+ action: z.enum(['create', 'decide', 'update_status', 'add_note', 'add_step', 'view']).describe('What to do'),
4
+ title: z.string().optional().describe('Plan title (when creating)'),
5
+ steps: z.array(z.string()).optional().describe('List of step names (when creating)'),
6
+ decision: z.enum(['delegate', 'proceed']).optional().describe('For large plans: delegate to sub-agent or proceed yourself'),
7
+ stepName: z.string().optional().describe('Which step to update'),
8
+ status: z.enum(['pending', 'in_progress', 'completed', 'blocked']).optional().describe('New status for the step'),
9
+ note: z.string().optional().describe('Note to attach to a step'),
10
+ });
11
+ export const validationInputSchema = z.object({
12
+ checkTypes: z.boolean().optional().describe('Run TypeScript type checking (default: true)'),
13
+ runTests: z.boolean().optional().describe('Run test suite (default: false)'),
14
+ filesChanged: z.array(z.string()).optional().describe('Files that were modified'),
15
+ });
16
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/plan/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgCxB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC5G,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACpF,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IAC3H,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAChE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACjH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CACjE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC3F,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC5E,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAClF,CAAC,CAAC"}
@@ -0,0 +1,9 @@
1
+ export declare function runTypeCheck(): Promise<{
2
+ passed: boolean;
3
+ details: string;
4
+ }>;
5
+ export declare function runTestCommand(): Promise<{
6
+ passed: boolean;
7
+ details: string;
8
+ }>;
9
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/tools/plan/utils.ts"],"names":[],"mappings":"AAEA,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAWlF;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAYpF"}
@@ -0,0 +1,27 @@
1
+ import { executeCommand } from '../utils/shell.js';
2
+ export async function runTypeCheck() {
3
+ const result = await executeCommand('pnpm exec tsc --noEmit', {
4
+ timeout: 30000,
5
+ maxBuffer: 10 * 1024 * 1024,
6
+ });
7
+ if (result.exitCode === 0) {
8
+ const output = result.stdout || result.stderr || '';
9
+ return { passed: true, details: output ? output.substring(0, 500) : 'No type errors found' };
10
+ }
11
+ const errorOutput = result.stderr || result.stdout || result.error || '';
12
+ return { passed: false, details: errorOutput.substring(0, 1000) };
13
+ }
14
+ export async function runTestCommand() {
15
+ const result = await executeCommand('pnpm test', {
16
+ timeout: 60000,
17
+ maxBuffer: 10 * 1024 * 1024,
18
+ });
19
+ if (result.exitCode === 0) {
20
+ const output = result.stdout || result.stderr || '';
21
+ const testSummary = output.split('\n').slice(-10).join('\n');
22
+ return { passed: true, details: testSummary || 'All tests passed' };
23
+ }
24
+ const errorOutput = result.stderr ?? result.stdout ?? result.error ?? '';
25
+ return { passed: false, details: errorOutput.substring(0, 1000) };
26
+ }
27
+ //# sourceMappingURL=utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/tools/plan/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,wBAAwB,EAAE;QAC5D,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;QACpD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC;IAC/F,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACzE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE;QAC/C,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,IAAI,kBAAkB,EAAE,CAAC;IACtE,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACzE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;AACpE,CAAC"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * @agntk/core - Progress Tracking Tools
3
+ *
4
+ * Manages a progress.json file in the workspace for long-running agents
5
+ * to track task completion across sessions. Session log is append-only.
6
+ */
7
+ /** Status of a tracked feature/task. */
8
+ export type FeatureStatus = 'pending' | 'in_progress' | 'completed' | 'blocked';
9
+ /** A tracked feature or task in the progress file. */
10
+ export interface ProgressFeature {
11
+ id: string;
12
+ name: string;
13
+ status: FeatureStatus;
14
+ description?: string;
15
+ updatedAt: string;
16
+ notes?: string;
17
+ }
18
+ /** A session log entry (append-only). */
19
+ export interface SessionLogEntry {
20
+ sessionId: string;
21
+ startedAt: string;
22
+ completedAt?: string;
23
+ actions: string[];
24
+ }
25
+ /** The full progress.json structure. */
26
+ export interface ProgressData {
27
+ version: 1;
28
+ features: ProgressFeature[];
29
+ sessions: SessionLogEntry[];
30
+ }
31
+ /**
32
+ * Create progress tracking tools.
33
+ *
34
+ * @example
35
+ * ```typescript
36
+ * const tools = createProgressTools('/my/project');
37
+ * // Returns { progress_read, progress_update }
38
+ * ```
39
+ */
40
+ export declare function createProgressTools(workspaceRoot: string): {
41
+ progress_read: import("ai").Tool<{}, string>;
42
+ progress_update: import("ai").Tool<{
43
+ action?: string | undefined;
44
+ sessionId?: string | undefined;
45
+ featureId?: string | undefined;
46
+ featureName?: string | undefined;
47
+ featureStatus?: "pending" | "blocked" | "completed" | "in_progress" | undefined;
48
+ featureDescription?: string | undefined;
49
+ featureNotes?: string | undefined;
50
+ }, string>;
51
+ };
52
+ export type { ProgressData as ProgressFileData };
53
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/progress/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAEhF,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AA2CD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM;;;;;;;;;;;EAsFxD;AAGD,YAAY,EAAE,YAAY,IAAI,gBAAgB,EAAE,CAAC"}
@@ -0,0 +1,144 @@
1
+ /**
2
+ * @agntk/core - Progress Tracking Tools
3
+ *
4
+ * Manages a progress.json file in the workspace for long-running agents
5
+ * to track task completion across sessions. Session log is append-only.
6
+ */
7
+ import * as fs from 'node:fs';
8
+ import * as path from 'node:path';
9
+ import { tool } from 'ai';
10
+ import { z } from 'zod';
11
+ import { createLogger } from '@agntk/logger';
12
+ const log = createLogger('@agntk/core:progress');
13
+ // ============================================================================
14
+ // File Operations
15
+ // ============================================================================
16
+ const PROGRESS_FILENAME = 'progress.json';
17
+ function getProgressPath(workspaceRoot) {
18
+ return path.join(workspaceRoot, PROGRESS_FILENAME);
19
+ }
20
+ function readProgressFile(workspaceRoot) {
21
+ const filePath = getProgressPath(workspaceRoot);
22
+ if (!fs.existsSync(filePath)) {
23
+ return { version: 1, features: [], sessions: [] };
24
+ }
25
+ try {
26
+ const raw = fs.readFileSync(filePath, 'utf-8');
27
+ const data = JSON.parse(raw);
28
+ // Validate structure
29
+ if (!data.version || !Array.isArray(data.features) || !Array.isArray(data.sessions)) {
30
+ log.warn('Invalid progress.json structure, returning empty');
31
+ return { version: 1, features: [], sessions: [] };
32
+ }
33
+ return data;
34
+ }
35
+ catch (error) {
36
+ log.warn('Failed to read progress.json', { error: String(error) });
37
+ return { version: 1, features: [], sessions: [] };
38
+ }
39
+ }
40
+ function writeProgressFile(workspaceRoot, data) {
41
+ const filePath = getProgressPath(workspaceRoot);
42
+ fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
43
+ }
44
+ // ============================================================================
45
+ // Tool Factory
46
+ // ============================================================================
47
+ /**
48
+ * Create progress tracking tools.
49
+ *
50
+ * @example
51
+ * ```typescript
52
+ * const tools = createProgressTools('/my/project');
53
+ * // Returns { progress_read, progress_update }
54
+ * ```
55
+ */
56
+ export function createProgressTools(workspaceRoot) {
57
+ const progress_read = tool({
58
+ description: `Read the progress tracking data (features, session logs) from progress.json. Only call this when the user asks about task progress or when resuming a multi-session project. Do NOT call this automatically at the start of every interaction.`,
59
+ inputSchema: z.object({}),
60
+ execute: async () => {
61
+ log.debug('progress_read called');
62
+ try {
63
+ const data = readProgressFile(workspaceRoot);
64
+ const summary = {
65
+ totalFeatures: data.features.length,
66
+ pending: data.features.filter(f => f.status === 'pending').length,
67
+ inProgress: data.features.filter(f => f.status === 'in_progress').length,
68
+ completed: data.features.filter(f => f.status === 'completed').length,
69
+ blocked: data.features.filter(f => f.status === 'blocked').length,
70
+ totalSessions: data.sessions.length,
71
+ };
72
+ return JSON.stringify({ success: true, summary, data });
73
+ }
74
+ catch (error) {
75
+ return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Failed' });
76
+ }
77
+ },
78
+ });
79
+ const progress_update = tool({
80
+ description: `Update progress tracking: add/update features, log session actions. Features are upserted by ID. Session log is append-only.`,
81
+ inputSchema: z.object({
82
+ featureId: z.string().optional().describe('Feature ID to add or update'),
83
+ featureName: z.string().optional().describe('Feature name (required when adding)'),
84
+ featureStatus: z.enum(['pending', 'in_progress', 'completed', 'blocked']).optional().describe('Feature status'),
85
+ featureDescription: z.string().optional().describe('Feature description'),
86
+ featureNotes: z.string().optional().describe('Notes about the feature update'),
87
+ sessionId: z.string().optional().describe('Session ID for logging an action'),
88
+ action: z.string().optional().describe('Action to log in the session'),
89
+ }),
90
+ execute: async ({ featureId, featureName, featureStatus, featureDescription, featureNotes, sessionId, action }) => {
91
+ log.debug('progress_update called', { featureId, featureStatus, sessionId });
92
+ try {
93
+ const data = readProgressFile(workspaceRoot);
94
+ const now = new Date().toISOString();
95
+ // Upsert feature if featureId provided
96
+ if (featureId) {
97
+ const existing = data.features.find(f => f.id === featureId);
98
+ if (existing) {
99
+ if (featureStatus)
100
+ existing.status = featureStatus;
101
+ if (featureName)
102
+ existing.name = featureName;
103
+ if (featureDescription !== undefined)
104
+ existing.description = featureDescription;
105
+ if (featureNotes !== undefined)
106
+ existing.notes = featureNotes;
107
+ existing.updatedAt = now;
108
+ }
109
+ else {
110
+ data.features.push({
111
+ id: featureId,
112
+ name: featureName ?? featureId,
113
+ status: featureStatus ?? 'pending',
114
+ description: featureDescription,
115
+ notes: featureNotes,
116
+ updatedAt: now,
117
+ });
118
+ }
119
+ }
120
+ // Append to session log if sessionId + action provided
121
+ if (sessionId && action) {
122
+ let session = data.sessions.find(s => s.sessionId === sessionId);
123
+ if (!session) {
124
+ session = { sessionId, startedAt: now, actions: [] };
125
+ data.sessions.push(session);
126
+ }
127
+ session.actions.push(`[${now}] ${action}`);
128
+ }
129
+ writeProgressFile(workspaceRoot, data);
130
+ return JSON.stringify({
131
+ success: true,
132
+ message: featureId
133
+ ? `Feature '${featureId}' updated to '${featureStatus ?? 'unchanged'}'`
134
+ : 'Session log updated',
135
+ });
136
+ }
137
+ catch (error) {
138
+ return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Failed' });
139
+ }
140
+ },
141
+ });
142
+ return { progress_read, progress_update };
143
+ }
144
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/progress/index.ts"],"names":[],"mappings":"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"}