@geminixiang/mikan 1.0.0-beta.4 → 1.0.0-beta.41

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 (661) hide show
  1. package/CHANGELOG.md +714 -0
  2. package/README.md +99 -36
  3. package/dist/adapter.d.ts +11 -1
  4. package/dist/adapter.d.ts.map +1 -1
  5. package/dist/adapter.js +18 -1
  6. package/dist/adapter.js.map +1 -1
  7. package/dist/adapters/discord/bot.d.ts +6 -7
  8. package/dist/adapters/discord/bot.d.ts.map +1 -1
  9. package/dist/adapters/discord/bot.js +88 -122
  10. package/dist/adapters/discord/bot.js.map +1 -1
  11. package/dist/adapters/discord/components.d.ts +33 -0
  12. package/dist/adapters/discord/components.d.ts.map +1 -0
  13. package/dist/adapters/discord/components.js +32 -0
  14. package/dist/adapters/discord/components.js.map +1 -0
  15. package/dist/adapters/discord/context.d.ts +3 -1
  16. package/dist/adapters/discord/context.d.ts.map +1 -1
  17. package/dist/adapters/discord/context.js +66 -217
  18. package/dist/adapters/discord/context.js.map +1 -1
  19. package/dist/adapters/discord/format.d.ts +3 -0
  20. package/dist/adapters/discord/format.d.ts.map +1 -0
  21. package/dist/adapters/discord/format.js +86 -0
  22. package/dist/adapters/discord/format.js.map +1 -0
  23. package/dist/adapters/github/bot.d.ts +89 -0
  24. package/dist/adapters/github/bot.d.ts.map +1 -0
  25. package/dist/adapters/github/bot.js +653 -0
  26. package/dist/adapters/github/bot.js.map +1 -0
  27. package/dist/adapters/github/client.d.ts +122 -0
  28. package/dist/adapters/github/client.d.ts.map +1 -0
  29. package/dist/adapters/github/client.js +314 -0
  30. package/dist/adapters/github/client.js.map +1 -0
  31. package/dist/adapters/github/cloudbuild.d.ts +19 -0
  32. package/dist/adapters/github/cloudbuild.d.ts.map +1 -0
  33. package/dist/adapters/github/cloudbuild.js +71 -0
  34. package/dist/adapters/github/cloudbuild.js.map +1 -0
  35. package/dist/adapters/github/context.d.ts +12 -0
  36. package/dist/adapters/github/context.d.ts.map +1 -0
  37. package/dist/adapters/github/context.js +101 -0
  38. package/dist/adapters/github/context.js.map +1 -0
  39. package/dist/adapters/github/gcp-auth.d.ts +28 -0
  40. package/dist/adapters/github/gcp-auth.d.ts.map +1 -0
  41. package/dist/adapters/github/gcp-auth.js +196 -0
  42. package/dist/adapters/github/gcp-auth.js.map +1 -0
  43. package/dist/adapters/github/github-ops.d.ts +91 -0
  44. package/dist/adapters/github/github-ops.d.ts.map +1 -0
  45. package/dist/adapters/github/github-ops.js +406 -0
  46. package/dist/adapters/github/github-ops.js.map +1 -0
  47. package/dist/adapters/github/ids.d.ts +34 -0
  48. package/dist/adapters/github/ids.d.ts.map +1 -0
  49. package/dist/adapters/github/ids.js +57 -0
  50. package/dist/adapters/github/ids.js.map +1 -0
  51. package/dist/adapters/github/repo.d.ts +33 -0
  52. package/dist/adapters/github/repo.d.ts.map +1 -0
  53. package/dist/adapters/github/repo.js +141 -0
  54. package/dist/adapters/github/repo.js.map +1 -0
  55. package/dist/adapters/github/tool-pack.d.ts +14 -0
  56. package/dist/adapters/github/tool-pack.d.ts.map +1 -0
  57. package/dist/adapters/github/tool-pack.js +56 -0
  58. package/dist/adapters/github/tool-pack.js.map +1 -0
  59. package/dist/adapters/github/tools/checks.d.ts +19 -0
  60. package/dist/adapters/github/tools/checks.d.ts.map +1 -0
  61. package/dist/adapters/github/tools/checks.js +105 -0
  62. package/dist/adapters/github/tools/checks.js.map +1 -0
  63. package/dist/adapters/github/tools/issue.d.ts +21 -0
  64. package/dist/adapters/github/tools/issue.d.ts.map +1 -0
  65. package/dist/adapters/github/tools/issue.js +48 -0
  66. package/dist/adapters/github/tools/issue.js.map +1 -0
  67. package/dist/adapters/github/tools/pr.d.ts +22 -0
  68. package/dist/adapters/github/tools/pr.d.ts.map +1 -0
  69. package/dist/adapters/github/tools/pr.js +48 -0
  70. package/dist/adapters/github/tools/pr.js.map +1 -0
  71. package/dist/adapters/github/tools/read.d.ts +21 -0
  72. package/dist/adapters/github/tools/read.d.ts.map +1 -0
  73. package/dist/adapters/github/tools/read.js +141 -0
  74. package/dist/adapters/github/tools/read.js.map +1 -0
  75. package/dist/adapters/github/tools/review-reply.d.ts +17 -0
  76. package/dist/adapters/github/tools/review-reply.d.ts.map +1 -0
  77. package/dist/adapters/github/tools/review-reply.js +38 -0
  78. package/dist/adapters/github/tools/review-reply.js.map +1 -0
  79. package/dist/adapters/github/tools/sync.d.ts +17 -0
  80. package/dist/adapters/github/tools/sync.d.ts.map +1 -0
  81. package/dist/adapters/github/tools/sync.js +34 -0
  82. package/dist/adapters/github/tools/sync.js.map +1 -0
  83. package/dist/adapters/github/types.d.ts +373 -0
  84. package/dist/adapters/github/types.d.ts.map +1 -0
  85. package/dist/adapters/github/types.js +2 -0
  86. package/dist/adapters/github/types.js.map +1 -0
  87. package/dist/adapters/intake.d.ts +16 -5
  88. package/dist/adapters/intake.d.ts.map +1 -1
  89. package/dist/adapters/intake.js +86 -23
  90. package/dist/adapters/intake.js.map +1 -1
  91. package/dist/adapters/markdown-tables.d.ts +37 -0
  92. package/dist/adapters/markdown-tables.d.ts.map +1 -0
  93. package/dist/adapters/markdown-tables.js +164 -0
  94. package/dist/adapters/markdown-tables.js.map +1 -0
  95. package/dist/adapters/progressive-renderer.d.ts +7 -0
  96. package/dist/adapters/progressive-renderer.d.ts.map +1 -0
  97. package/dist/adapters/progressive-renderer.js +440 -0
  98. package/dist/adapters/progressive-renderer.js.map +1 -0
  99. package/dist/adapters/shared.d.ts +23 -10
  100. package/dist/adapters/shared.d.ts.map +1 -1
  101. package/dist/adapters/shared.js +60 -22
  102. package/dist/adapters/shared.js.map +1 -1
  103. package/dist/adapters/slack/assistant.d.ts +101 -0
  104. package/dist/adapters/slack/assistant.d.ts.map +1 -0
  105. package/dist/adapters/slack/assistant.js +204 -0
  106. package/dist/adapters/slack/assistant.js.map +1 -0
  107. package/dist/adapters/slack/blocks.d.ts +14 -0
  108. package/dist/adapters/slack/blocks.d.ts.map +1 -1
  109. package/dist/adapters/slack/blocks.js +105 -147
  110. package/dist/adapters/slack/blocks.js.map +1 -1
  111. package/dist/adapters/slack/bot.d.ts +95 -13
  112. package/dist/adapters/slack/bot.d.ts.map +1 -1
  113. package/dist/adapters/slack/bot.js +545 -211
  114. package/dist/adapters/slack/bot.js.map +1 -1
  115. package/dist/adapters/slack/context.d.ts +3 -1
  116. package/dist/adapters/slack/context.d.ts.map +1 -1
  117. package/dist/adapters/slack/context.js +11 -17
  118. package/dist/adapters/slack/context.js.map +1 -1
  119. package/dist/adapters/slack/response-lifecycle.d.ts.map +1 -1
  120. package/dist/adapters/slack/response-lifecycle.js +197 -323
  121. package/dist/adapters/slack/response-lifecycle.js.map +1 -1
  122. package/dist/adapters/slack/session.d.ts.map +1 -1
  123. package/dist/adapters/slack/session.js +7 -11
  124. package/dist/adapters/slack/session.js.map +1 -1
  125. package/dist/adapters/slack/stream-limits.d.ts +35 -0
  126. package/dist/adapters/slack/stream-limits.d.ts.map +1 -0
  127. package/dist/adapters/slack/stream-limits.js +56 -0
  128. package/dist/adapters/slack/stream-limits.js.map +1 -0
  129. package/dist/adapters/slack/tool-pack.d.ts +11 -0
  130. package/dist/adapters/slack/tool-pack.d.ts.map +1 -0
  131. package/dist/adapters/slack/tool-pack.js +45 -0
  132. package/dist/adapters/slack/tool-pack.js.map +1 -0
  133. package/dist/adapters/slack/tools/attach.js +1 -1
  134. package/dist/adapters/slack/tools/attach.js.map +1 -1
  135. package/dist/adapters/slack/tools/blockkit.d.ts +14 -0
  136. package/dist/adapters/slack/tools/blockkit.d.ts.map +1 -0
  137. package/dist/adapters/slack/tools/blockkit.js +106 -0
  138. package/dist/adapters/slack/tools/blockkit.js.map +1 -0
  139. package/dist/adapters/slack/types.d.ts +40 -2
  140. package/dist/adapters/slack/types.d.ts.map +1 -1
  141. package/dist/adapters/slack/types.js.map +1 -1
  142. package/dist/adapters/telegram/bot.d.ts +8 -9
  143. package/dist/adapters/telegram/bot.d.ts.map +1 -1
  144. package/dist/adapters/telegram/bot.js +115 -163
  145. package/dist/adapters/telegram/bot.js.map +1 -1
  146. package/dist/adapters/telegram/context.d.ts +2 -0
  147. package/dist/adapters/telegram/context.d.ts.map +1 -1
  148. package/dist/adapters/telegram/context.js +53 -188
  149. package/dist/adapters/telegram/context.js.map +1 -1
  150. package/dist/adapters/types.d.ts +132 -12
  151. package/dist/adapters/types.d.ts.map +1 -1
  152. package/dist/adapters/types.js.map +1 -1
  153. package/dist/agent-events.d.ts +3 -2
  154. package/dist/agent-events.d.ts.map +1 -1
  155. package/dist/agent-events.js +19 -1
  156. package/dist/agent-events.js.map +1 -1
  157. package/dist/agent.d.ts +14 -19
  158. package/dist/agent.d.ts.map +1 -1
  159. package/dist/agent.js +841 -298
  160. package/dist/agent.js.map +1 -1
  161. package/dist/cli/arg-grammar.d.ts +25 -0
  162. package/dist/cli/arg-grammar.d.ts.map +1 -0
  163. package/dist/cli/arg-grammar.js +61 -0
  164. package/dist/cli/arg-grammar.js.map +1 -0
  165. package/dist/cli/boot.d.ts +5 -0
  166. package/dist/cli/boot.d.ts.map +1 -0
  167. package/dist/cli/boot.js +117 -0
  168. package/dist/cli/boot.js.map +1 -0
  169. package/dist/cli/download.d.ts.map +1 -0
  170. package/dist/{download.js → cli/download.js} +2 -0
  171. package/dist/cli/download.js.map +1 -0
  172. package/dist/cli/ext-dev.d.ts +2 -0
  173. package/dist/cli/ext-dev.d.ts.map +1 -0
  174. package/dist/cli/ext-dev.js +188 -0
  175. package/dist/cli/ext-dev.js.map +1 -0
  176. package/dist/cli/ext.d.ts +2 -0
  177. package/dist/cli/ext.d.ts.map +1 -0
  178. package/dist/cli/ext.js +324 -0
  179. package/dist/cli/ext.js.map +1 -0
  180. package/dist/cli/office.d.ts +2 -0
  181. package/dist/cli/office.d.ts.map +1 -0
  182. package/dist/cli/office.js +91 -0
  183. package/dist/cli/office.js.map +1 -0
  184. package/dist/cli/types.d.ts +16 -0
  185. package/dist/cli/types.d.ts.map +1 -0
  186. package/dist/cli/types.js +2 -0
  187. package/dist/cli/types.js.map +1 -0
  188. package/dist/commands/admin.d.ts.map +1 -1
  189. package/dist/commands/admin.js +3 -2
  190. package/dist/commands/admin.js.map +1 -1
  191. package/dist/commands/auto-reply.d.ts.map +1 -1
  192. package/dist/commands/auto-reply.js +5 -9
  193. package/dist/commands/auto-reply.js.map +1 -1
  194. package/dist/commands/extensions.d.ts +18 -6
  195. package/dist/commands/extensions.d.ts.map +1 -1
  196. package/dist/commands/extensions.js +64 -14
  197. package/dist/commands/extensions.js.map +1 -1
  198. package/dist/commands/login.d.ts +2 -1
  199. package/dist/commands/login.d.ts.map +1 -1
  200. package/dist/commands/login.js +40 -5
  201. package/dist/commands/login.js.map +1 -1
  202. package/dist/commands/manifest.d.ts +37 -0
  203. package/dist/commands/manifest.d.ts.map +1 -0
  204. package/dist/commands/manifest.js +151 -0
  205. package/dist/commands/manifest.js.map +1 -0
  206. package/dist/commands/model.d.ts +2 -3
  207. package/dist/commands/model.d.ts.map +1 -1
  208. package/dist/commands/model.js +63 -24
  209. package/dist/commands/model.js.map +1 -1
  210. package/dist/commands/new.d.ts.map +1 -1
  211. package/dist/commands/new.js +15 -3
  212. package/dist/commands/new.js.map +1 -1
  213. package/dist/commands/registry.d.ts +2 -2
  214. package/dist/commands/registry.d.ts.map +1 -1
  215. package/dist/commands/registry.js +1 -2
  216. package/dist/commands/registry.js.map +1 -1
  217. package/dist/commands/sandbox.d.ts.map +1 -1
  218. package/dist/commands/sandbox.js +83 -33
  219. package/dist/commands/sandbox.js.map +1 -1
  220. package/dist/commands/session-view.d.ts.map +1 -1
  221. package/dist/commands/session-view.js +6 -3
  222. package/dist/commands/session-view.js.map +1 -1
  223. package/dist/commands/types.d.ts +79 -7
  224. package/dist/commands/types.d.ts.map +1 -1
  225. package/dist/commands/types.js.map +1 -1
  226. package/dist/config.d.ts +23 -8
  227. package/dist/config.d.ts.map +1 -1
  228. package/dist/config.js +222 -135
  229. package/dist/config.js.map +1 -1
  230. package/dist/env-manifest.d.ts +30 -0
  231. package/dist/env-manifest.d.ts.map +1 -0
  232. package/dist/env-manifest.js +233 -0
  233. package/dist/env-manifest.js.map +1 -0
  234. package/dist/events.d.ts.map +1 -1
  235. package/dist/events.js +20 -81
  236. package/dist/events.js.map +1 -1
  237. package/dist/execution-resolver.d.ts +7 -8
  238. package/dist/execution-resolver.d.ts.map +1 -1
  239. package/dist/execution-resolver.js +106 -110
  240. package/dist/execution-resolver.js.map +1 -1
  241. package/dist/extension-schedules.d.ts +31 -0
  242. package/dist/extension-schedules.d.ts.map +1 -0
  243. package/dist/extension-schedules.js +229 -0
  244. package/dist/extension-schedules.js.map +1 -0
  245. package/dist/harness/auth.d.ts +2 -1
  246. package/dist/harness/auth.d.ts.map +1 -1
  247. package/dist/harness/auth.js +11 -5
  248. package/dist/harness/auth.js.map +1 -1
  249. package/dist/harness/event-format.d.ts +27 -0
  250. package/dist/harness/event-format.d.ts.map +1 -0
  251. package/dist/harness/event-format.js +160 -0
  252. package/dist/harness/event-format.js.map +1 -0
  253. package/dist/harness/extensions/loader.d.ts +27 -49
  254. package/dist/harness/extensions/loader.d.ts.map +1 -1
  255. package/dist/harness/extensions/loader.js +486 -130
  256. package/dist/harness/extensions/loader.js.map +1 -1
  257. package/dist/harness/extensions/registry.d.ts +107 -2
  258. package/dist/harness/extensions/registry.d.ts.map +1 -1
  259. package/dist/harness/extensions/registry.js +316 -0
  260. package/dist/harness/extensions/registry.js.map +1 -1
  261. package/dist/harness/extensions/types.d.ts +482 -42
  262. package/dist/harness/extensions/types.d.ts.map +1 -1
  263. package/dist/harness/extensions/types.js.map +1 -1
  264. package/dist/harness/index.d.ts +18 -8
  265. package/dist/harness/index.d.ts.map +1 -1
  266. package/dist/harness/index.js +7 -4
  267. package/dist/harness/index.js.map +1 -1
  268. package/dist/harness/models.d.ts +7 -4
  269. package/dist/harness/models.d.ts.map +1 -1
  270. package/dist/harness/models.js +46 -24
  271. package/dist/harness/models.js.map +1 -1
  272. package/dist/harness/runner.d.ts +50 -54
  273. package/dist/harness/runner.d.ts.map +1 -1
  274. package/dist/harness/runner.js +232 -46
  275. package/dist/harness/runner.js.map +1 -1
  276. package/dist/harness/session-store.d.ts +11 -5
  277. package/dist/harness/session-store.d.ts.map +1 -1
  278. package/dist/harness/session-store.js +141 -36
  279. package/dist/harness/session-store.js.map +1 -1
  280. package/dist/harness/settings.d.ts +2 -20
  281. package/dist/harness/settings.d.ts.map +1 -1
  282. package/dist/harness/settings.js +12 -1
  283. package/dist/harness/settings.js.map +1 -1
  284. package/dist/harness/skills.d.ts +10 -29
  285. package/dist/harness/skills.d.ts.map +1 -1
  286. package/dist/harness/skills.js +48 -6
  287. package/dist/harness/skills.js.map +1 -1
  288. package/dist/harness/subagent-profiles.d.ts +8 -0
  289. package/dist/harness/subagent-profiles.d.ts.map +1 -0
  290. package/dist/harness/subagent-profiles.js +299 -0
  291. package/dist/harness/subagent-profiles.js.map +1 -0
  292. package/dist/harness/subagent-runner.d.ts +45 -0
  293. package/dist/harness/subagent-runner.d.ts.map +1 -0
  294. package/dist/harness/subagent-runner.js +680 -0
  295. package/dist/harness/subagent-runner.js.map +1 -0
  296. package/dist/harness/types.d.ts +267 -1
  297. package/dist/harness/types.d.ts.map +1 -1
  298. package/dist/harness/types.js.map +1 -1
  299. package/dist/harness/usage.d.ts +6 -0
  300. package/dist/harness/usage.d.ts.map +1 -0
  301. package/dist/harness/usage.js +32 -0
  302. package/dist/harness/usage.js.map +1 -0
  303. package/dist/index.d.ts +36 -8
  304. package/dist/index.d.ts.map +1 -1
  305. package/dist/index.js +22 -6
  306. package/dist/index.js.map +1 -1
  307. package/dist/main.js +391 -127
  308. package/dist/main.js.map +1 -1
  309. package/dist/observability/instrument.js +7 -5
  310. package/dist/observability/instrument.js.map +1 -1
  311. package/dist/observability/sentry.d.ts +2 -0
  312. package/dist/observability/sentry.d.ts.map +1 -1
  313. package/dist/observability/sentry.js +10 -2
  314. package/dist/observability/sentry.js.map +1 -1
  315. package/dist/office/address.d.ts +31 -0
  316. package/dist/office/address.d.ts.map +1 -0
  317. package/dist/office/address.js +113 -0
  318. package/dist/office/address.js.map +1 -0
  319. package/dist/office/index.d.ts +11 -0
  320. package/dist/office/index.d.ts.map +1 -0
  321. package/dist/office/index.js +11 -0
  322. package/dist/office/index.js.map +1 -0
  323. package/dist/office/layout.d.ts +27 -0
  324. package/dist/office/layout.d.ts.map +1 -0
  325. package/dist/office/layout.js +97 -0
  326. package/dist/office/layout.js.map +1 -0
  327. package/dist/office/migration.d.ts +44 -0
  328. package/dist/office/migration.d.ts.map +1 -0
  329. package/dist/office/migration.js +255 -0
  330. package/dist/office/migration.js.map +1 -0
  331. package/dist/office/registry.d.ts +75 -0
  332. package/dist/office/registry.d.ts.map +1 -0
  333. package/dist/office/registry.js +646 -0
  334. package/dist/office/registry.js.map +1 -0
  335. package/dist/office/types.d.ts +71 -0
  336. package/dist/office/types.d.ts.map +1 -0
  337. package/dist/office/types.js +2 -0
  338. package/dist/office/types.js.map +1 -0
  339. package/dist/packages/admin.d.ts +17 -0
  340. package/dist/packages/admin.d.ts.map +1 -0
  341. package/dist/packages/admin.js +98 -0
  342. package/dist/packages/admin.js.map +1 -0
  343. package/dist/packages/index.d.ts +6 -0
  344. package/dist/packages/index.d.ts.map +1 -0
  345. package/dist/packages/index.js +6 -0
  346. package/dist/packages/index.js.map +1 -0
  347. package/dist/packages/inspect.d.ts +11 -0
  348. package/dist/packages/inspect.d.ts.map +1 -0
  349. package/dist/packages/inspect.js +98 -0
  350. package/dist/packages/inspect.js.map +1 -0
  351. package/dist/packages/materialize.d.ts +40 -0
  352. package/dist/packages/materialize.d.ts.map +1 -0
  353. package/dist/packages/materialize.js +297 -0
  354. package/dist/packages/materialize.js.map +1 -0
  355. package/dist/packages/resolve.d.ts +25 -0
  356. package/dist/packages/resolve.d.ts.map +1 -0
  357. package/dist/packages/resolve.js +208 -0
  358. package/dist/packages/resolve.js.map +1 -0
  359. package/dist/packages/source.d.ts +39 -0
  360. package/dist/packages/source.d.ts.map +1 -0
  361. package/dist/packages/source.js +189 -0
  362. package/dist/packages/source.js.map +1 -0
  363. package/dist/packages/types.d.ts +104 -0
  364. package/dist/packages/types.d.ts.map +1 -0
  365. package/dist/packages/types.js +2 -0
  366. package/dist/packages/types.js.map +1 -0
  367. package/dist/provisioner.d.ts +66 -0
  368. package/dist/provisioner.d.ts.map +1 -1
  369. package/dist/provisioner.js +335 -13
  370. package/dist/provisioner.js.map +1 -1
  371. package/dist/runtime/conversation-runtime.d.ts +1 -1
  372. package/dist/runtime/conversation-runtime.d.ts.map +1 -1
  373. package/dist/runtime/conversation-runtime.js +562 -118
  374. package/dist/runtime/conversation-runtime.js.map +1 -1
  375. package/dist/runtime/session-lifecycle.d.ts +38 -0
  376. package/dist/runtime/session-lifecycle.d.ts.map +1 -0
  377. package/dist/runtime/session-lifecycle.js +193 -0
  378. package/dist/runtime/session-lifecycle.js.map +1 -0
  379. package/dist/runtime/types.d.ts +66 -7
  380. package/dist/runtime/types.d.ts.map +1 -1
  381. package/dist/runtime/types.js.map +1 -1
  382. package/dist/sandbox/cloudflare.d.ts +3 -0
  383. package/dist/sandbox/cloudflare.d.ts.map +1 -1
  384. package/dist/sandbox/cloudflare.js +13 -1
  385. package/dist/sandbox/cloudflare.js.map +1 -1
  386. package/dist/sandbox/container.d.ts +4 -0
  387. package/dist/sandbox/container.d.ts.map +1 -1
  388. package/dist/sandbox/container.js +13 -3
  389. package/dist/sandbox/container.js.map +1 -1
  390. package/dist/sandbox/firecracker.d.ts +3 -0
  391. package/dist/sandbox/firecracker.d.ts.map +1 -1
  392. package/dist/sandbox/firecracker.js +13 -2
  393. package/dist/sandbox/firecracker.js.map +1 -1
  394. package/dist/sandbox/gondolin.d.ts +57 -0
  395. package/dist/sandbox/gondolin.d.ts.map +1 -0
  396. package/dist/sandbox/gondolin.js +764 -0
  397. package/dist/sandbox/gondolin.js.map +1 -0
  398. package/dist/sandbox/host.d.ts +3 -0
  399. package/dist/sandbox/host.d.ts.map +1 -1
  400. package/dist/sandbox/host.js +18 -3
  401. package/dist/sandbox/host.js.map +1 -1
  402. package/dist/sandbox/identity.d.ts +44 -0
  403. package/dist/sandbox/identity.d.ts.map +1 -0
  404. package/dist/sandbox/identity.js +68 -0
  405. package/dist/sandbox/identity.js.map +1 -0
  406. package/dist/sandbox/image.d.ts.map +1 -1
  407. package/dist/sandbox/image.js +2 -0
  408. package/dist/sandbox/image.js.map +1 -1
  409. package/dist/sandbox/index.d.ts +17 -4
  410. package/dist/sandbox/index.d.ts.map +1 -1
  411. package/dist/sandbox/index.js +37 -3
  412. package/dist/sandbox/index.js.map +1 -1
  413. package/dist/sandbox/types.d.ts +65 -1
  414. package/dist/sandbox/types.d.ts.map +1 -1
  415. package/dist/sandbox/types.js.map +1 -1
  416. package/dist/sandbox/utils.d.ts +14 -0
  417. package/dist/sandbox/utils.d.ts.map +1 -1
  418. package/dist/sandbox/utils.js +68 -1
  419. package/dist/sandbox/utils.js.map +1 -1
  420. package/dist/sessions/chat-history-sync.d.ts +25 -0
  421. package/dist/sessions/chat-history-sync.d.ts.map +1 -0
  422. package/dist/sessions/{agent-memory-file-manager.js → chat-history-sync.js} +135 -131
  423. package/dist/sessions/chat-history-sync.js.map +1 -0
  424. package/dist/sessions/conversation-log.d.ts +9 -0
  425. package/dist/sessions/conversation-log.d.ts.map +1 -0
  426. package/dist/sessions/conversation-log.js +50 -0
  427. package/dist/sessions/conversation-log.js.map +1 -0
  428. package/dist/sessions/history-line.d.ts +29 -0
  429. package/dist/sessions/history-line.d.ts.map +1 -0
  430. package/dist/sessions/history-line.js +45 -0
  431. package/dist/sessions/history-line.js.map +1 -0
  432. package/dist/sessions/rotation.d.ts +2 -0
  433. package/dist/sessions/rotation.d.ts.map +1 -0
  434. package/dist/sessions/rotation.js +39 -0
  435. package/dist/sessions/rotation.js.map +1 -0
  436. package/dist/sessions/session-key.d.ts +33 -0
  437. package/dist/sessions/session-key.d.ts.map +1 -0
  438. package/dist/sessions/session-key.js +115 -0
  439. package/dist/sessions/session-key.js.map +1 -0
  440. package/dist/sessions/store.d.ts +15 -7
  441. package/dist/sessions/store.d.ts.map +1 -1
  442. package/dist/sessions/store.js +127 -36
  443. package/dist/sessions/store.js.map +1 -1
  444. package/dist/sessions/types.d.ts +19 -5
  445. package/dist/sessions/types.d.ts.map +1 -1
  446. package/dist/sessions/types.js.map +1 -1
  447. package/dist/settings-mutation.d.ts +40 -0
  448. package/dist/settings-mutation.d.ts.map +1 -0
  449. package/dist/settings-mutation.js +61 -0
  450. package/dist/settings-mutation.js.map +1 -0
  451. package/dist/subagent-progress.d.ts +39 -0
  452. package/dist/subagent-progress.d.ts.map +1 -0
  453. package/dist/subagent-progress.js +225 -0
  454. package/dist/subagent-progress.js.map +1 -0
  455. package/dist/tools/bash.d.ts +3 -1
  456. package/dist/tools/bash.d.ts.map +1 -1
  457. package/dist/tools/bash.js +26 -18
  458. package/dist/tools/bash.js.map +1 -1
  459. package/dist/tools/edit.d.ts.map +1 -1
  460. package/dist/tools/edit.js +14 -13
  461. package/dist/tools/edit.js.map +1 -1
  462. package/dist/tools/event.d.ts +1 -1
  463. package/dist/tools/event.d.ts.map +1 -1
  464. package/dist/tools/event.js +58 -45
  465. package/dist/tools/event.js.map +1 -1
  466. package/dist/tools/generate-image.d.ts +23 -0
  467. package/dist/tools/generate-image.d.ts.map +1 -0
  468. package/dist/tools/generate-image.js +65 -0
  469. package/dist/tools/generate-image.js.map +1 -0
  470. package/dist/tools/host-fn-tool.d.ts +21 -0
  471. package/dist/tools/host-fn-tool.d.ts.map +1 -0
  472. package/dist/tools/host-fn-tool.js +32 -0
  473. package/dist/tools/host-fn-tool.js.map +1 -0
  474. package/dist/tools/index.d.ts +19 -2
  475. package/dist/tools/index.d.ts.map +1 -1
  476. package/dist/tools/index.js +25 -2
  477. package/dist/tools/index.js.map +1 -1
  478. package/dist/tools/react.d.ts +15 -0
  479. package/dist/tools/react.d.ts.map +1 -0
  480. package/dist/tools/react.js +29 -0
  481. package/dist/tools/react.js.map +1 -0
  482. package/dist/tools/read.d.ts +1 -0
  483. package/dist/tools/read.d.ts.map +1 -1
  484. package/dist/tools/read.js +39 -33
  485. package/dist/tools/read.js.map +1 -1
  486. package/dist/tools/sandbox.d.ts +2 -2
  487. package/dist/tools/sandbox.d.ts.map +1 -1
  488. package/dist/tools/sandbox.js +14 -9
  489. package/dist/tools/sandbox.js.map +1 -1
  490. package/dist/tools/subagent-slots.d.ts +28 -0
  491. package/dist/tools/subagent-slots.d.ts.map +1 -0
  492. package/dist/tools/subagent-slots.js +72 -0
  493. package/dist/tools/subagent-slots.js.map +1 -0
  494. package/dist/tools/subagent.d.ts +61 -0
  495. package/dist/tools/subagent.d.ts.map +1 -0
  496. package/dist/tools/subagent.js +434 -0
  497. package/dist/tools/subagent.js.map +1 -0
  498. package/dist/tools/types.d.ts +40 -32
  499. package/dist/tools/types.d.ts.map +1 -1
  500. package/dist/tools/types.js.map +1 -1
  501. package/dist/tools/write.d.ts.map +1 -1
  502. package/dist/tools/write.js +2 -8
  503. package/dist/tools/write.js.map +1 -1
  504. package/dist/trigger.d.ts +2 -1
  505. package/dist/trigger.d.ts.map +1 -1
  506. package/dist/trigger.js +6 -9
  507. package/dist/trigger.js.map +1 -1
  508. package/dist/types.d.ts +411 -59
  509. package/dist/types.d.ts.map +1 -1
  510. package/dist/types.js +2 -2
  511. package/dist/types.js.map +1 -1
  512. package/dist/utils/file-guards.d.ts +9 -0
  513. package/dist/utils/file-guards.d.ts.map +1 -1
  514. package/dist/utils/file-guards.js +44 -1
  515. package/dist/utils/file-guards.js.map +1 -1
  516. package/dist/vault/disabled.d.ts +9 -0
  517. package/dist/vault/disabled.d.ts.map +1 -0
  518. package/dist/vault/disabled.js +25 -0
  519. package/dist/vault/disabled.js.map +1 -0
  520. package/dist/vault/index.d.ts +45 -2
  521. package/dist/vault/index.d.ts.map +1 -1
  522. package/dist/vault/index.js +127 -36
  523. package/dist/vault/index.js.map +1 -1
  524. package/dist/vault/types.d.ts +6 -2
  525. package/dist/vault/types.d.ts.map +1 -1
  526. package/dist/vault/types.js.map +1 -1
  527. package/dist/web/admin/portal.d.ts +31 -3
  528. package/dist/web/admin/portal.d.ts.map +1 -1
  529. package/dist/web/admin/portal.js +850 -345
  530. package/dist/web/admin/portal.js.map +1 -1
  531. package/dist/web/admin/provider-models.js +1 -1
  532. package/dist/web/admin/provider-models.js.map +1 -1
  533. package/dist/web/admin/types.d.ts +23 -3
  534. package/dist/web/admin/types.d.ts.map +1 -1
  535. package/dist/web/admin/types.js.map +1 -1
  536. package/dist/web/login/oauth.d.ts +2 -3
  537. package/dist/web/login/oauth.d.ts.map +1 -1
  538. package/dist/web/login/oauth.js +1 -32
  539. package/dist/web/login/oauth.js.map +1 -1
  540. package/dist/web/login/portal.d.ts +1 -1
  541. package/dist/web/login/portal.d.ts.map +1 -1
  542. package/dist/web/login/portal.js +13 -36
  543. package/dist/web/login/portal.js.map +1 -1
  544. package/dist/web/login/types.d.ts +0 -11
  545. package/dist/web/login/types.d.ts.map +1 -1
  546. package/dist/web/login/types.js.map +1 -1
  547. package/dist/web/portal-shell.d.ts +21 -0
  548. package/dist/web/portal-shell.d.ts.map +1 -0
  549. package/dist/{portal-shell.js → web/portal-shell.js} +67 -2
  550. package/dist/web/portal-shell.js.map +1 -0
  551. package/dist/web/server.d.ts +3 -2
  552. package/dist/web/server.d.ts.map +1 -1
  553. package/dist/web/server.js +11 -4
  554. package/dist/web/server.js.map +1 -1
  555. package/dist/web/session-view/portal.d.ts +1 -1
  556. package/dist/web/session-view/portal.d.ts.map +1 -1
  557. package/dist/web/session-view/portal.js +37 -28
  558. package/dist/web/session-view/portal.js.map +1 -1
  559. package/dist/web/session-view/service.d.ts +1 -1
  560. package/dist/web/session-view/service.d.ts.map +1 -1
  561. package/dist/web/session-view/service.js +61 -18
  562. package/dist/web/session-view/service.js.map +1 -1
  563. package/dist/web/session-view/types.d.ts +0 -3
  564. package/dist/web/session-view/types.d.ts.map +1 -1
  565. package/dist/web/session-view/types.js.map +1 -1
  566. package/dist/web/token-store.js +1 -1
  567. package/dist/web/token-store.js.map +1 -1
  568. package/dist/workspace-projection/index.d.ts +10 -0
  569. package/dist/workspace-projection/index.d.ts.map +1 -0
  570. package/dist/workspace-projection/index.js +120 -0
  571. package/dist/workspace-projection/index.js.map +1 -0
  572. package/dist/workspace-projection/types.d.ts +16 -0
  573. package/dist/workspace-projection/types.d.ts.map +1 -0
  574. package/dist/workspace-projection/types.js +2 -0
  575. package/dist/workspace-projection/types.js.map +1 -0
  576. package/package.json +68 -37
  577. package/dist/adapters/streaming.d.ts +0 -18
  578. package/dist/adapters/streaming.d.ts.map +0 -1
  579. package/dist/adapters/streaming.js +0 -44
  580. package/dist/adapters/streaming.js.map +0 -1
  581. package/dist/adapters/telegram/html.d.ts +0 -3
  582. package/dist/adapters/telegram/html.d.ts.map +0 -1
  583. package/dist/adapters/telegram/html.js +0 -98
  584. package/dist/adapters/telegram/html.js.map +0 -1
  585. package/dist/commands/parse.d.ts +0 -7
  586. package/dist/commands/parse.d.ts.map +0 -1
  587. package/dist/commands/parse.js +0 -14
  588. package/dist/commands/parse.js.map +0 -1
  589. package/dist/download.d.ts.map +0 -1
  590. package/dist/download.js.map +0 -1
  591. package/dist/model-registry.d.ts +0 -4
  592. package/dist/model-registry.d.ts.map +0 -1
  593. package/dist/model-registry.js +0 -7
  594. package/dist/model-registry.js.map +0 -1
  595. package/dist/portal-shell.d.ts +0 -4
  596. package/dist/portal-shell.d.ts.map +0 -1
  597. package/dist/portal-shell.js.map +0 -1
  598. package/dist/runtime/agent-run-controller.d.ts +0 -31
  599. package/dist/runtime/agent-run-controller.d.ts.map +0 -1
  600. package/dist/runtime/agent-run-controller.js +0 -195
  601. package/dist/runtime/agent-run-controller.js.map +0 -1
  602. package/dist/sandbox/path-context.d.ts +0 -3
  603. package/dist/sandbox/path-context.d.ts.map +0 -1
  604. package/dist/sandbox/path-context.js +0 -20
  605. package/dist/sandbox/path-context.js.map +0 -1
  606. package/dist/sessions/agent-memory-file-manager.d.ts +0 -19
  607. package/dist/sessions/agent-memory-file-manager.d.ts.map +0 -1
  608. package/dist/sessions/agent-memory-file-manager.js.map +0 -1
  609. package/dist/sessions/metadata.d.ts +0 -3
  610. package/dist/sessions/metadata.d.ts.map +0 -1
  611. package/dist/sessions/metadata.js +0 -11
  612. package/dist/sessions/metadata.js.map +0 -1
  613. package/dist/sessions/policy.d.ts +0 -6
  614. package/dist/sessions/policy.d.ts.map +0 -1
  615. package/dist/sessions/policy.js +0 -23
  616. package/dist/sessions/policy.js.map +0 -1
  617. package/dist/store.d.ts +0 -46
  618. package/dist/store.d.ts.map +0 -1
  619. package/dist/store.js +0 -177
  620. package/dist/store.js.map +0 -1
  621. package/dist/tools/truncate.d.ts +0 -33
  622. package/dist/tools/truncate.d.ts.map +0 -1
  623. package/dist/tools/truncate.js +0 -184
  624. package/dist/tools/truncate.js.map +0 -1
  625. package/dist/utils/date.d.ts +0 -10
  626. package/dist/utils/date.d.ts.map +0 -1
  627. package/dist/utils/date.js +0 -23
  628. package/dist/utils/date.js.map +0 -1
  629. package/dist/utils/env.d.ts +0 -3
  630. package/dist/utils/env.d.ts.map +0 -1
  631. package/dist/utils/env.js +0 -12
  632. package/dist/utils/env.js.map +0 -1
  633. package/dist/utils/fs-atomic.d.ts +0 -10
  634. package/dist/utils/fs-atomic.d.ts.map +0 -1
  635. package/dist/utils/fs-atomic.js +0 -45
  636. package/dist/utils/fs-atomic.js.map +0 -1
  637. package/dist/utils/html.d.ts +0 -2
  638. package/dist/utils/html.d.ts.map +0 -1
  639. package/dist/utils/html.js +0 -4
  640. package/dist/utils/html.js.map +0 -1
  641. package/dist/utils/http-body.d.ts +0 -10
  642. package/dist/utils/http-body.d.ts.map +0 -1
  643. package/dist/utils/http-body.js +0 -34
  644. package/dist/utils/http-body.js.map +0 -1
  645. package/dist/vault/routing.d.ts +0 -3
  646. package/dist/vault/routing.d.ts.map +0 -1
  647. package/dist/vault/routing.js +0 -13
  648. package/dist/vault/routing.js.map +0 -1
  649. package/dist/web/agent-events/portal.d.ts +0 -3
  650. package/dist/web/agent-events/portal.d.ts.map +0 -1
  651. package/dist/web/agent-events/portal.js +0 -18
  652. package/dist/web/agent-events/portal.js.map +0 -1
  653. package/dist/web/request.d.ts +0 -3
  654. package/dist/web/request.d.ts.map +0 -1
  655. package/dist/web/request.js +0 -13
  656. package/dist/web/request.js.map +0 -1
  657. package/dist/web/session-view/command.d.ts +0 -4
  658. package/dist/web/session-view/command.d.ts.map +0 -1
  659. package/dist/web/session-view/command.js +0 -7
  660. package/dist/web/session-view/command.js.map +0 -1
  661. /package/dist/{download.d.ts → cli/download.d.ts} +0 -0
@@ -0,0 +1,680 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { AsyncLocalStorage } from "node:async_hooks";
3
+ import { Kind, Type } from "@sinclair/typebox";
4
+ import { Value } from "@sinclair/typebox/value";
5
+ import * as log from "../log.js";
6
+ import { MikanAgentSession } from "./runner.js";
7
+ import { SessionStore } from "./session-store.js";
8
+ import { copySubagentUsage, createEmptySubagentUsage } from "./usage.js";
9
+ import { unboundedSlotPool } from "../tools/subagent-slots.js";
10
+ const subagentRunDepth = new AsyncLocalStorage();
11
+ const DEFAULT_SYSTEM_PROMPT = "You are a focused subagent. Complete only the assigned task and return the result directly.";
12
+ export const DEFAULT_SUBAGENT_BUDGET = {
13
+ maxTurns: 100,
14
+ maxCostUsd: 10,
15
+ maxDurationMs: 10 * 60 * 1000,
16
+ };
17
+ /** Time allowed for an aborted subagent to settle before detached cleanup. */
18
+ export const SUBAGENT_ABORT_GRACE_MS = 100;
19
+ const SCHEMA_STRUCTURAL_KEYS = new Set([
20
+ "type",
21
+ "properties",
22
+ "required",
23
+ "items",
24
+ "enum",
25
+ "const",
26
+ "anyOf",
27
+ "oneOf",
28
+ "allOf",
29
+ ]);
30
+ function isRecord(value) {
31
+ return typeof value === "object" && value !== null && !Array.isArray(value);
32
+ }
33
+ function schemaOptions(node) {
34
+ const options = {};
35
+ for (const [key, value] of Object.entries(node)) {
36
+ if (!SCHEMA_STRUCTURAL_KEYS.has(key))
37
+ options[key] = value;
38
+ }
39
+ if (isRecord(options.additionalProperties)) {
40
+ options.additionalProperties = hydrateSchema(options.additionalProperties);
41
+ }
42
+ return options;
43
+ }
44
+ /**
45
+ * outputSchema arrives over the subagent tool as plain JSON (tool-call
46
+ * arguments never carry TypeBox's Kind symbol), but Value.Check dispatches
47
+ * purely on schema[Kind] and throws ValueCheckUnknownTypeError for anything
48
+ * without it. Hydrate plain JSON Schema into real TypeBox schema nodes so
49
+ * validation runs instead of throwing; schemas built with TypeBox already
50
+ * carry Kind and pass through untouched.
51
+ *
52
+ * Unsupported keywords ($ref, not, patternProperties, if/then/else) degrade to
53
+ * a permissive Unknown — fail-open by design: outputSchema is advisory output
54
+ * validation, not a security boundary.
55
+ */
56
+ function hydrateSchema(schema) {
57
+ if (isRecord(schema) && Kind in schema)
58
+ return schema;
59
+ if (!isRecord(schema))
60
+ return Type.Unknown();
61
+ if (Array.isArray(schema.enum)) {
62
+ const literals = schema.enum.filter((value) => typeof value === "string" || typeof value === "number" || typeof value === "boolean");
63
+ return literals.length > 0
64
+ ? Type.Union(literals.map((value) => Type.Literal(value)))
65
+ : Type.Unknown();
66
+ }
67
+ if ("const" in schema) {
68
+ const value = schema.const;
69
+ return typeof value === "string" || typeof value === "number" || typeof value === "boolean"
70
+ ? Type.Literal(value)
71
+ : Type.Unknown();
72
+ }
73
+ if (Array.isArray(schema.anyOf))
74
+ return Type.Union(schema.anyOf.map(hydrateSchema));
75
+ if (Array.isArray(schema.oneOf))
76
+ return Type.Union(schema.oneOf.map(hydrateSchema));
77
+ if (Array.isArray(schema.allOf))
78
+ return Type.Intersect(schema.allOf.map(hydrateSchema));
79
+ const type = Array.isArray(schema.type)
80
+ ? schema.type
81
+ : (schema.type ?? (schema.properties ? "object" : schema.items ? "array" : undefined));
82
+ if (Array.isArray(type)) {
83
+ return Type.Union(type.map((variant) => hydrateSchema({ ...schema, type: variant })));
84
+ }
85
+ const options = schemaOptions(schema);
86
+ switch (type) {
87
+ case "object": {
88
+ const properties = isRecord(schema.properties) ? schema.properties : {};
89
+ const required = new Set(Array.isArray(schema.required) ? schema.required : []);
90
+ const props = {};
91
+ for (const [key, value] of Object.entries(properties)) {
92
+ const hydrated = hydrateSchema(value);
93
+ props[key] = required.has(key) ? hydrated : Type.Optional(hydrated);
94
+ }
95
+ return Type.Object(props, options);
96
+ }
97
+ case "array":
98
+ return Type.Array(schema.items !== undefined ? hydrateSchema(schema.items) : Type.Unknown(), options);
99
+ case "string":
100
+ return Type.String(options);
101
+ case "number":
102
+ return Type.Number(options);
103
+ case "integer":
104
+ return Type.Integer(options);
105
+ case "boolean":
106
+ return Type.Boolean(options);
107
+ case "null":
108
+ return Type.Null(options);
109
+ default:
110
+ return Type.Unknown(options);
111
+ }
112
+ }
113
+ /**
114
+ * Translate a subagent session's event stream into short activity lines.
115
+ *
116
+ * The stream was always there — nothing subscribed to it, so every subagent
117
+ * was silent for its whole run and a slow step looked identical to a hung one.
118
+ *
119
+ * Text is reported as a growing character count rather than its content: it
120
+ * proves liveness during a long single-turn generation, which is the case with
121
+ * nothing else to show, without putting a half-written answer on screen.
122
+ */
123
+ function reportSubagentActivity(session, onActivity) {
124
+ let characters = 0;
125
+ let reportedAt = 0;
126
+ const report = (activity) => {
127
+ try {
128
+ onActivity(activity);
129
+ }
130
+ catch (err) {
131
+ log.logWarning("Subagent onActivity listener failed", String(err));
132
+ }
133
+ };
134
+ session.subscribe(async (event) => {
135
+ if (event.type === "tool_execution_start") {
136
+ const args = (event.args ?? {});
137
+ const name = String(event.toolName ?? "tool");
138
+ report(args.label ? `${name}: ${args.label}` : name);
139
+ return;
140
+ }
141
+ if (event.type === "tool_execution_end") {
142
+ report("thinking");
143
+ return;
144
+ }
145
+ if (event.type === "message_start") {
146
+ characters = 0;
147
+ reportedAt = 0;
148
+ report("thinking");
149
+ return;
150
+ }
151
+ if (event.type === "message_update") {
152
+ const delta = event
153
+ .assistantMessageEvent;
154
+ if (delta?.type !== "text_delta" || !delta.delta)
155
+ return;
156
+ characters += delta.delta.length;
157
+ // Coarse steps: deltas arrive per token, and one report each would churn
158
+ // the dashboard for no added information.
159
+ if (characters - reportedAt < ACTIVITY_CHARS_STEP)
160
+ return;
161
+ reportedAt = characters;
162
+ report(`writing · ${characters} chars`);
163
+ return;
164
+ }
165
+ if (event.type === "auto_retry_start") {
166
+ // The most valuable line here: a retry is the usual reason a run goes
167
+ // quiet for minutes, and it was completely invisible.
168
+ report("retrying after an error");
169
+ }
170
+ });
171
+ }
172
+ /** How much new text earns a fresh activity line during a long generation. */
173
+ const ACTIVITY_CHARS_STEP = 250;
174
+ function resolveBudget(budget) {
175
+ const resolved = { ...DEFAULT_SUBAGENT_BUDGET, ...budget };
176
+ const positiveIntegerFields = [
177
+ ["maxTurns", resolved.maxTurns],
178
+ ["maxTokens", resolved.maxTokens],
179
+ ["maxDurationMs", resolved.maxDurationMs],
180
+ ];
181
+ for (const [name, value] of positiveIntegerFields) {
182
+ if (value !== undefined && (!Number.isInteger(value) || value <= 0)) {
183
+ throw new Error(`api.subagent.run budget.${name} must be a positive integer`);
184
+ }
185
+ }
186
+ if (!Number.isFinite(resolved.maxCostUsd) || resolved.maxCostUsd < 0) {
187
+ throw new Error("api.subagent.run budget.maxCostUsd must be a non-negative number");
188
+ }
189
+ return resolved;
190
+ }
191
+ function selectTools(requested, available) {
192
+ if (!requested || requested.length === 0)
193
+ return [];
194
+ const byName = new Map();
195
+ for (const tool of available) {
196
+ if (!byName.has(tool.name))
197
+ byName.set(tool.name, tool);
198
+ }
199
+ const selected = [];
200
+ for (const name of new Set(requested)) {
201
+ const tool = byName.get(name);
202
+ if (!tool)
203
+ throw new Error(`Unknown or unavailable subagent tool: ${name}`);
204
+ selected.push(tool);
205
+ }
206
+ return selected;
207
+ }
208
+ /**
209
+ * Wrap a tool so the run can prove it was actually reached. Fields are listed
210
+ * explicitly rather than spread: `AgentTool` is a plain interface, and a
211
+ * structural copy would silently drop anything added to it later.
212
+ */
213
+ function witnessToolUse(tool, invoked) {
214
+ return {
215
+ name: tool.name,
216
+ label: tool.label,
217
+ description: tool.description,
218
+ parameters: tool.parameters,
219
+ ...(tool.constrainedSampling !== undefined
220
+ ? { constrainedSampling: tool.constrainedSampling }
221
+ : {}),
222
+ ...(tool.prepareArguments ? { prepareArguments: tool.prepareArguments.bind(tool) } : {}),
223
+ ...(tool.executionMode ? { executionMode: tool.executionMode } : {}),
224
+ execute: (...args) => {
225
+ invoked.add(tool.name);
226
+ return tool.execute(...args);
227
+ },
228
+ };
229
+ }
230
+ function formatTask(task, input, parentContext) {
231
+ const trimmed = task.trim();
232
+ if (!trimmed)
233
+ throw new Error("api.subagent.run requires a non-empty task");
234
+ let formatted = trimmed;
235
+ if (input !== undefined) {
236
+ let serialized;
237
+ try {
238
+ serialized = JSON.stringify(input, null, 2);
239
+ }
240
+ catch (err) {
241
+ throw new Error(`api.subagent.run input must be JSON-serializable: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
242
+ }
243
+ if (serialized === undefined)
244
+ throw new Error("api.subagent.run input must be JSON-serializable");
245
+ formatted = `${trimmed}\n\nInput:\n${serialized}`;
246
+ }
247
+ return parentContext ? `${parentContext}\n\n${formatted}` : formatted;
248
+ }
249
+ function messageText(message) {
250
+ if (message.role === "compactionSummary" || message.role === "branchSummary") {
251
+ return message.summary;
252
+ }
253
+ if (!("content" in message))
254
+ return "";
255
+ if (typeof message.content === "string")
256
+ return message.content;
257
+ if (!Array.isArray(message.content))
258
+ return "";
259
+ return message.content
260
+ .filter((part) => typeof part === "object" && part !== null && part.type === "text")
261
+ .map((part) => part.text)
262
+ .join("");
263
+ }
264
+ function normalizedParentContext(request, messages) {
265
+ if (!request.parentContext || !messages)
266
+ return undefined;
267
+ const recentTurns = request.parentContext.recentTurns ?? 3;
268
+ if (!Number.isInteger(recentTurns) || recentTurns < 1 || recentTurns > 8) {
269
+ throw new Error("api.subagent.run parentContext.recentTurns must be an integer from 1 to 8");
270
+ }
271
+ const conversation = messages.filter((message) => (message.role === "user" || message.role === "assistant") && messageText(message));
272
+ let first = conversation.length;
273
+ let users = 0;
274
+ while (first > 0 && users < recentTurns) {
275
+ first -= 1;
276
+ if (conversation[first]?.role === "user")
277
+ users += 1;
278
+ }
279
+ const recent = conversation.slice(first);
280
+ const recentStart = recent[0] ? messages.indexOf(recent[0]) : messages.length;
281
+ let summary;
282
+ for (let index = recentStart - 1; index >= 0; index--) {
283
+ const message = messages[index];
284
+ if (message?.role === "compactionSummary" || message?.role === "branchSummary") {
285
+ summary = message;
286
+ break;
287
+ }
288
+ }
289
+ return [
290
+ "<parent_reference_context>",
291
+ summary ? `Earlier summary: ${messageText(summary)}` : "[Earlier parent context omitted]",
292
+ ...recent.map((message) => `${message.role === "user" ? "User" : "Assistant"}: ${messageText(message)}`),
293
+ "</parent_reference_context>",
294
+ ].join("\n");
295
+ }
296
+ /**
297
+ * The evidence policy has to name the actual grant. Told to "use granted
298
+ * tools" while holding none, a model will write a tool call as prose and
299
+ * hand that text back as its answer — which then flows to dependent DAG
300
+ * nodes as if it were a finding.
301
+ */
302
+ function groundingPolicy(toolNames) {
303
+ if (toolNames.length === 0) {
304
+ return [
305
+ "Evidence policy:",
306
+ "- You have NO tools in this run. Do not emit tool calls or tool-call syntax; they will not execute.",
307
+ "- Answer only from the task text and any structured input supplied to you.",
308
+ "- Never claim to have read a file, run a command, or reached a repository or URL.",
309
+ "- If the task cannot be done without a tool, say so plainly and stop.",
310
+ ].join("\n");
311
+ }
312
+ return [
313
+ "Evidence policy:",
314
+ `- Your tools this run: ${toolNames.join(", ")}. Nothing else will execute.`,
315
+ "- Use them for any claim about files, commands, repositories, or external state.",
316
+ "- Never simulate tool output or claim a tool was used when it was not.",
317
+ "- If the task requires a tool you were not granted, state that you cannot verify it instead of guessing.",
318
+ ].join("\n");
319
+ }
320
+ function buildSystemPrompt(base, outputSchema, toolNames) {
321
+ const prompt = [base?.trim() || DEFAULT_SYSTEM_PROMPT, groundingPolicy(toolNames)].join("\n\n");
322
+ if (!outputSchema)
323
+ return prompt;
324
+ return [
325
+ prompt,
326
+ "",
327
+ "Return only one JSON value matching this JSON Schema. Do not use Markdown or code fences.",
328
+ JSON.stringify(outputSchema),
329
+ ].join("\n");
330
+ }
331
+ /**
332
+ * Every SubagentRunResult's metric fields are born here — one derivation from
333
+ * the session's run stats, so adding a metric is one edit and no terminal
334
+ * site can drift (the abort branch once shipped without toolCallCounts). The
335
+ * terminal sites state only what differs: status, error, text.
336
+ */
337
+ function baseRunResult(runId, model, startedAt, stats) {
338
+ const usage = stats?.usage ?? createEmptySubagentUsage();
339
+ return {
340
+ runId,
341
+ model,
342
+ turns: stats?.llmCalls ?? 0,
343
+ toolCalls: stats?.toolCalls ?? 0,
344
+ toolCallCounts: stats?.toolCallCounts ?? {},
345
+ usage,
346
+ tokens: usage.totalTokens,
347
+ costUsd: usage.cost.total,
348
+ durationMs: Date.now() - startedAt,
349
+ };
350
+ }
351
+ function finalAssistant(messages) {
352
+ for (let index = messages.length - 1; index >= 0; index--) {
353
+ const message = messages[index];
354
+ if (message?.role === "assistant")
355
+ return message;
356
+ }
357
+ return undefined;
358
+ }
359
+ function assistantText(message) {
360
+ if (!message)
361
+ return "";
362
+ return message.content
363
+ .filter((part) => part.type === "text")
364
+ .map((part) => part.text)
365
+ .join("");
366
+ }
367
+ /**
368
+ * Execute one non-recursive, fresh subagent run. Never rejects: every
369
+ * failure — including request validation — is a result with a terminal
370
+ * status, so batch callers (`tasks` / `dag`) can never orphan in-flight
371
+ * sibling runs on one bad request. Usage is reported once, after the
372
+ * underlying run settles; an aborted run may report it from detached cleanup.
373
+ */
374
+ export async function runSubagent(options) {
375
+ const execution = await executeBoundedSubagentRun(options);
376
+ if (execution.cleanup) {
377
+ void execution.cleanup
378
+ .then(async (result) => {
379
+ await reportSubagentUsage(options.onUsage, result.usage);
380
+ })
381
+ .catch((err) => {
382
+ log.logWarning("Subagent detached cleanup failed", String(err));
383
+ });
384
+ return execution.result;
385
+ }
386
+ await reportSubagentUsage(options.onUsage, execution.result.usage);
387
+ return execution.result;
388
+ }
389
+ async function reportSubagentUsage(onUsage, usage) {
390
+ try {
391
+ await onUsage?.(copySubagentUsage(usage));
392
+ }
393
+ catch (err) {
394
+ log.logWarning("Subagent onUsage listener failed", String(err));
395
+ }
396
+ }
397
+ async function executeBoundedSubagentRun(options) {
398
+ const startedAt = Date.now();
399
+ let release;
400
+ try {
401
+ release = await (options.slots ?? unboundedSlotPool()).acquire(options.request.signal);
402
+ }
403
+ catch (err) {
404
+ if (err instanceof Error && err.name === "AbortError") {
405
+ const model = options.request.model ?? {
406
+ provider: options.defaultModel.provider,
407
+ id: options.defaultModel.id,
408
+ };
409
+ return {
410
+ result: { ...baseRunResult(randomUUID(), model, startedAt), status: "cancelled" },
411
+ };
412
+ }
413
+ throw err;
414
+ }
415
+ if (!release)
416
+ throw new Error("Subagent slot acquisition returned no release handle");
417
+ try {
418
+ const execution = await executeSubagentRun(options);
419
+ if (!execution.cleanup) {
420
+ release();
421
+ release = undefined;
422
+ return execution;
423
+ }
424
+ const cleanup = execution.cleanup;
425
+ const heldRelease = release;
426
+ void cleanup
427
+ .then(() => heldRelease(), (err) => {
428
+ log.logWarning("Subagent detached cleanup failed", String(err));
429
+ heldRelease();
430
+ })
431
+ .catch((err) => {
432
+ log.logWarning("Subagent detached release failed", String(err));
433
+ heldRelease();
434
+ });
435
+ release = undefined;
436
+ return execution;
437
+ }
438
+ catch (err) {
439
+ release?.();
440
+ release = undefined;
441
+ throw err;
442
+ }
443
+ }
444
+ function noop() { }
445
+ /**
446
+ * Expand `request.profile` into the concrete capability set it names. Most
447
+ * profile budgets are caps that callers may only tighten. Token budgets are
448
+ * different: the effective allowance is the larger of the profile default and
449
+ * the caller's request.
450
+ */
451
+ function resolveProfile(request, options) {
452
+ if (!request.profile)
453
+ return request;
454
+ const profile = options.profiles?.get(request.profile);
455
+ if (!profile) {
456
+ const known = [...(options.profiles?.keys() ?? [])].join(", ");
457
+ throw new Error(`Unknown subagent profile: ${request.profile}${known ? ` (available: ${known})` : ""}`);
458
+ }
459
+ if (request.tools || request.model || request.systemPrompt || request.thinkingLevel) {
460
+ throw new Error(`Subagent profile ${request.profile} cannot be combined with tools, model, systemPrompt, or thinkingLevel`);
461
+ }
462
+ const budget = {
463
+ ...request.budget,
464
+ ...(profile.maxTurns !== undefined
465
+ ? { maxTurns: Math.min(profile.maxTurns, request.budget?.maxTurns ?? profile.maxTurns) }
466
+ : {}),
467
+ ...(profile.maxTokens !== undefined || request.budget?.maxTokens !== undefined
468
+ ? { maxTokens: Math.max(profile.maxTokens ?? 0, request.budget?.maxTokens ?? 0) }
469
+ : {}),
470
+ ...(profile.maxCostUsd !== undefined
471
+ ? {
472
+ maxCostUsd: Math.min(profile.maxCostUsd, request.budget?.maxCostUsd ?? profile.maxCostUsd),
473
+ }
474
+ : {}),
475
+ ...(profile.maxDurationMs !== undefined
476
+ ? {
477
+ maxDurationMs: Math.min(profile.maxDurationMs, request.budget?.maxDurationMs ?? profile.maxDurationMs),
478
+ }
479
+ : {}),
480
+ };
481
+ return {
482
+ ...request,
483
+ systemPrompt: profile.systemPrompt,
484
+ tools: profile.tools,
485
+ requiredTools: profile.requiredTools,
486
+ ...(profile.model ? { model: profile.model } : {}),
487
+ ...(profile.thinkingLevel ? { thinkingLevel: profile.thinkingLevel } : {}),
488
+ ...(Object.keys(budget).length > 0 ? { budget } : {}),
489
+ };
490
+ }
491
+ async function executeSubagentRun(options) {
492
+ const request = resolveProfile(options.request, options);
493
+ const runId = randomUUID();
494
+ const startedAt = Date.now();
495
+ let modelSpec = request.model ?? {
496
+ provider: options.defaultModel.provider,
497
+ id: options.defaultModel.id,
498
+ };
499
+ let sessionRef;
500
+ let terminalSignal;
501
+ let timeout;
502
+ let notifyAbort = noop;
503
+ const abortRequested = new Promise((resolve) => {
504
+ notifyAbort = resolve;
505
+ });
506
+ const abort = (reason) => {
507
+ if (terminalSignal)
508
+ return;
509
+ terminalSignal = reason;
510
+ sessionRef?.abort();
511
+ notifyAbort();
512
+ };
513
+ const onAbort = () => abort("cancelled");
514
+ try {
515
+ if ((subagentRunDepth.getStore() ?? 0) >= 1) {
516
+ throw new Error("Nested api.subagent.run calls are not allowed");
517
+ }
518
+ const model = request.model
519
+ ? options.models.resolve(request.model.provider, request.model.id)
520
+ : options.defaultModel;
521
+ modelSpec = { provider: model.provider, id: model.id };
522
+ const invokedTools = new Set();
523
+ const granted = selectTools(request.tools, options.availableTools);
524
+ const missingRequiredTools = (request.requiredTools ?? []).filter((name) => !granted.some((tool) => tool.name === name));
525
+ if (missingRequiredTools.length > 0) {
526
+ throw new Error(`Required subagent tools were not granted: ${missingRequiredTools.join(", ")}`);
527
+ }
528
+ const tools = granted.map((tool) => witnessToolUse(tool, invokedTools));
529
+ const task = formatTask(request.task, request.input, normalizedParentContext(request, options.parentMessages));
530
+ const budget = resolveBudget(request.budget);
531
+ const session = new MikanAgentSession({
532
+ systemPrompt: buildSystemPrompt(request.systemPrompt, request.outputSchema, granted.map((tool) => tool.name)),
533
+ model,
534
+ thinkingLevel: request.thinkingLevel ?? options.thinkingLevel,
535
+ tools,
536
+ models: options.models,
537
+ sessionStore: SessionStore.inMemory(options.workspaceDir),
538
+ settings: { compaction: { enabled: false } },
539
+ });
540
+ sessionRef = session;
541
+ if (options.onActivity)
542
+ reportSubagentActivity(session, options.onActivity);
543
+ request.signal?.addEventListener("abort", onAbort, { once: true });
544
+ if (request.signal?.aborted)
545
+ abort("cancelled");
546
+ timeout = setTimeout(() => abort("timeout"), budget.maxDurationMs);
547
+ timeout.unref();
548
+ const buildResult = (cleanupPending = false) => {
549
+ const stats = session.getLastRunStats();
550
+ const assistant = finalAssistant(session.messages);
551
+ const text = assistantText(assistant);
552
+ const base = {
553
+ ...baseRunResult(runId, modelSpec, startedAt, stats),
554
+ ...(text ? { text } : {}),
555
+ ...(cleanupPending ? { cleanupPending: true } : {}),
556
+ };
557
+ if (terminalSignal) {
558
+ return {
559
+ ...base,
560
+ status: terminalSignal,
561
+ ...(terminalSignal === "timeout"
562
+ ? { error: `Subagent exceeded its ${budget.maxDurationMs}ms duration limit` }
563
+ : {}),
564
+ };
565
+ }
566
+ if (stats.budgetExceededReason) {
567
+ return {
568
+ ...base,
569
+ status: "budget_exceeded",
570
+ error: stats.budgetExceededReason,
571
+ };
572
+ }
573
+ const unusedRequiredTools = (request.requiredTools ?? []).filter((name) => !invokedTools.has(name));
574
+ if (unusedRequiredTools.length > 0) {
575
+ return {
576
+ ...base,
577
+ status: "failed",
578
+ error: `Required tool not used: ${unusedRequiredTools.join(", ")}`,
579
+ };
580
+ }
581
+ if (assistant?.stopReason === "error") {
582
+ return {
583
+ ...base,
584
+ status: "failed",
585
+ error: assistant.errorMessage || "Subagent failed",
586
+ };
587
+ }
588
+ if (!assistant) {
589
+ return { ...base, status: "failed", error: "Subagent produced no assistant response" };
590
+ }
591
+ if (request.outputSchema) {
592
+ let parsed;
593
+ try {
594
+ parsed = JSON.parse(text);
595
+ }
596
+ catch {
597
+ return { ...base, status: "invalid_output", error: "Subagent output is not valid JSON" };
598
+ }
599
+ if (!Value.Check(hydrateSchema(request.outputSchema), parsed)) {
600
+ return {
601
+ ...base,
602
+ status: "invalid_output",
603
+ error: "Subagent output does not match the requested schema",
604
+ };
605
+ }
606
+ return {
607
+ ...base,
608
+ status: "completed",
609
+ output: parsed,
610
+ };
611
+ }
612
+ if (!text) {
613
+ return { ...base, status: "failed", error: "Subagent produced no text output" };
614
+ }
615
+ return {
616
+ ...base,
617
+ status: "completed",
618
+ output: text,
619
+ };
620
+ };
621
+ const buildFailureResult = (err) => ({
622
+ ...baseRunResult(runId, modelSpec, startedAt, session.getLastRunStats()),
623
+ status: terminalSignal ?? "failed",
624
+ error: err instanceof Error ? err.message : String(err),
625
+ });
626
+ if (!terminalSignal) {
627
+ const promptOutcome = subagentRunDepth
628
+ .run(1, () => session.prompt(task, {
629
+ budget: {
630
+ maxLlmCalls: budget.maxTurns,
631
+ maxTokens: budget.maxTokens,
632
+ maxCostUsd: budget.maxCostUsd,
633
+ maxDurationMs: budget.maxDurationMs,
634
+ },
635
+ }))
636
+ .then(() => ({ ok: true }), (error) => ({ ok: false, error }));
637
+ const winner = await Promise.race([
638
+ promptOutcome.then((outcome) => ({ type: "settled", outcome })),
639
+ abortRequested.then(async () => {
640
+ let graceTimer;
641
+ const graceExpired = new Promise((resolve) => {
642
+ graceTimer = setTimeout(() => resolve("expired"), SUBAGENT_ABORT_GRACE_MS);
643
+ });
644
+ const graceOutcome = await Promise.race([
645
+ promptOutcome.then((settledOutcome) => ({
646
+ type: "settled",
647
+ outcome: settledOutcome,
648
+ })),
649
+ graceExpired.then((value) => ({ type: value })),
650
+ ]);
651
+ if (graceTimer)
652
+ clearTimeout(graceTimer);
653
+ return graceOutcome;
654
+ }),
655
+ ]);
656
+ if (winner.type === "expired") {
657
+ const cleanup = promptOutcome.then((settledOutcome) => settledOutcome.ok ? buildResult() : buildFailureResult(settledOutcome.error));
658
+ return { result: buildResult(true), cleanup };
659
+ }
660
+ if (!winner.outcome.ok)
661
+ throw winner.outcome.error;
662
+ }
663
+ return { result: buildResult() };
664
+ }
665
+ catch (err) {
666
+ return {
667
+ result: {
668
+ ...baseRunResult(runId, modelSpec, startedAt, sessionRef?.getLastRunStats()),
669
+ status: terminalSignal ?? "failed",
670
+ error: err instanceof Error ? err.message : String(err),
671
+ },
672
+ };
673
+ }
674
+ finally {
675
+ if (timeout)
676
+ clearTimeout(timeout);
677
+ request.signal?.removeEventListener("abort", onAbort);
678
+ }
679
+ }
680
+ //# sourceMappingURL=subagent-runner.js.map