bonecode 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (575) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +64 -50
  3. package/bone/output/agent/.dockerignore +7 -7
  4. package/bone/output/agent/.env.example +36 -36
  5. package/bone/output/agent/.github/workflows/ci.yaml +58 -58
  6. package/bone/output/agent/AgentDomain.bone.map +349 -349
  7. package/bone/output/agent/AgentDomain.postman_collection.json +957 -957
  8. package/bone/output/agent/Dockerfile +22 -22
  9. package/bone/output/agent/README.md +47 -47
  10. package/bone/output/agent/admin/index.html +739 -739
  11. package/bone/output/agent/docker-compose.yaml +22 -22
  12. package/bone/output/agent/k8s/deployment.yaml +75 -75
  13. package/bone/output/agent/migrations/agent.sql +36 -36
  14. package/bone/output/agent/migrations/agent_instance.sql +36 -36
  15. package/bone/output/agent/migrations/audit_log.sql +18 -18
  16. package/bone/output/agent/migrations/build_step.sql +34 -34
  17. package/bone/output/agent/migrations/event_outbox.sql +31 -31
  18. package/bone/output/agent/migrations/plan.sql +30 -30
  19. package/bone/output/agent/migrations/task.sql +30 -30
  20. package/bone/output/agent/migrations/tool_call.sql +33 -33
  21. package/bone/output/agent/openapi.yaml +1116 -1116
  22. package/bone/output/agent/package.json +35 -35
  23. package/bone/output/agent/schema.graphql +233 -233
  24. package/bone/output/agent/sdk/client.ts +231 -231
  25. package/bone/output/agent/src/algorithms.ts +2 -2
  26. package/bone/output/agent/src/audit.ts +44 -44
  27. package/bone/output/agent/src/auth.ts +57 -57
  28. package/bone/output/agent/src/cron.ts +12 -12
  29. package/bone/output/agent/src/db.ts +31 -31
  30. package/bone/output/agent/src/debug.ts +66 -66
  31. package/bone/output/agent/src/events.ts +243 -243
  32. package/bone/output/agent/src/extensions.ts +54 -54
  33. package/bone/output/agent/src/failure_rules.ts +322 -322
  34. package/bone/output/agent/src/flows.ts +168 -168
  35. package/bone/output/agent/src/health.ts +43 -43
  36. package/bone/output/agent/src/index.ts +99 -99
  37. package/bone/output/agent/src/logger.ts +69 -66
  38. package/bone/output/agent/src/metrics.ts +75 -75
  39. package/bone/output/agent/src/migrate.ts +351 -351
  40. package/bone/output/agent/src/migration_diff.ts +108 -108
  41. package/bone/output/agent/src/notify.ts +125 -125
  42. package/bone/output/agent/src/routes/plan.ts +91 -91
  43. package/bone/output/agent/src/routes/task.ts +105 -105
  44. package/bone/output/agent/src/routes/tool_call.ts +166 -166
  45. package/bone/output/agent/src/schemas.ts +384 -384
  46. package/bone/output/agent/src/state_machines/agent_instance.ts +24 -24
  47. package/bone/output/agent/src/state_machines/build_step.ts +22 -22
  48. package/bone/output/agent/src/state_machines/plan.ts +22 -22
  49. package/bone/output/agent/src/state_machines/task.ts +22 -22
  50. package/bone/output/agent/src/state_machines/tool_call.ts +22 -22
  51. package/bone/output/agent/src/tests.ts +361 -361
  52. package/bone/output/agent/src/websocket.ts +200 -200
  53. package/bone/output/agent/tsconfig.json +24 -24
  54. package/bone/output/rag/.dockerignore +7 -7
  55. package/bone/output/rag/.env.example +36 -36
  56. package/bone/output/rag/.github/workflows/ci.yaml +58 -58
  57. package/bone/output/rag/Dockerfile +22 -22
  58. package/bone/output/rag/RAGDomain.bone.map +286 -286
  59. package/bone/output/rag/RAGDomain.postman_collection.json +922 -922
  60. package/bone/output/rag/README.md +47 -47
  61. package/bone/output/rag/admin/index.html +817 -817
  62. package/bone/output/rag/docker-compose.yaml +22 -22
  63. package/bone/output/rag/k8s/deployment.yaml +75 -75
  64. package/bone/output/rag/migrations/audit_log.sql +18 -18
  65. package/bone/output/rag/migrations/code_chunk.sql +34 -34
  66. package/bone/output/rag/migrations/code_file.sql +33 -33
  67. package/bone/output/rag/migrations/event_outbox.sql +31 -31
  68. package/bone/output/rag/migrations/indexing_job.sql +33 -33
  69. package/bone/output/rag/migrations/knowledge_base.sql +35 -35
  70. package/bone/output/rag/migrations/memory_entry.sql +34 -34
  71. package/bone/output/rag/openapi.yaml +1097 -1097
  72. package/bone/output/rag/package.json +35 -35
  73. package/bone/output/rag/schema.graphql +245 -245
  74. package/bone/output/rag/sdk/client.ts +234 -234
  75. package/bone/output/rag/src/algorithms.ts +2 -2
  76. package/bone/output/rag/src/audit.ts +37 -37
  77. package/bone/output/rag/src/auth.ts +57 -57
  78. package/bone/output/rag/src/cron.ts +12 -12
  79. package/bone/output/rag/src/db.ts +31 -31
  80. package/bone/output/rag/src/debug.ts +66 -66
  81. package/bone/output/rag/src/events.ts +243 -243
  82. package/bone/output/rag/src/extensions.ts +350 -350
  83. package/bone/output/rag/src/failure_rules.ts +314 -314
  84. package/bone/output/rag/src/flows.ts +239 -239
  85. package/bone/output/rag/src/health.ts +43 -43
  86. package/bone/output/rag/src/index.ts +94 -94
  87. package/bone/output/rag/src/logger.ts +69 -66
  88. package/bone/output/rag/src/metrics.ts +75 -75
  89. package/bone/output/rag/src/migrate.ts +363 -363
  90. package/bone/output/rag/src/migration_diff.ts +108 -108
  91. package/bone/output/rag/src/notify.ts +99 -99
  92. package/bone/output/rag/src/routes/code_chunk.ts +75 -75
  93. package/bone/output/rag/src/routes/code_file.ts +101 -101
  94. package/bone/output/rag/src/routes/indexing_job.ts +87 -87
  95. package/bone/output/rag/src/routes/knowledge_base.ts +230 -230
  96. package/bone/output/rag/src/routes/memory_entry.ts +87 -87
  97. package/bone/output/rag/src/schemas.ts +394 -394
  98. package/bone/output/rag/src/state_machines/code_file.ts +23 -23
  99. package/bone/output/rag/src/state_machines/indexing_job.ts +22 -22
  100. package/bone/output/rag/src/state_machines/knowledge_base.ts +23 -23
  101. package/bone/output/rag/src/state_machines/memory_entry.ts +20 -20
  102. package/bone/output/rag/src/tests.ts +339 -339
  103. package/bone/output/rag/tsconfig.json +24 -24
  104. package/bone/output/session/.dockerignore +7 -7
  105. package/bone/output/session/.env.example +36 -36
  106. package/bone/output/session/.github/workflows/ci.yaml +58 -58
  107. package/bone/output/session/Dockerfile +22 -22
  108. package/bone/output/session/README.md +47 -47
  109. package/bone/output/session/SessionDomain.bone.map +349 -349
  110. package/bone/output/session/SessionDomain.postman_collection.json +957 -957
  111. package/bone/output/session/admin/index.html +666 -666
  112. package/bone/output/session/docker-compose.yaml +22 -22
  113. package/bone/output/session/k8s/deployment.yaml +75 -75
  114. package/bone/output/session/migrations/audit_log.sql +18 -18
  115. package/bone/output/session/migrations/event_outbox.sql +31 -31
  116. package/bone/output/session/migrations/message.sql +31 -31
  117. package/bone/output/session/migrations/part.sql +28 -28
  118. package/bone/output/session/migrations/permission.sql +28 -28
  119. package/bone/output/session/migrations/project.sql +28 -28
  120. package/bone/output/session/migrations/session.sql +38 -38
  121. package/bone/output/session/openapi.yaml +1101 -1101
  122. package/bone/output/session/package.json +35 -35
  123. package/bone/output/session/schema.graphql +222 -222
  124. package/bone/output/session/sdk/client.ts +225 -225
  125. package/bone/output/session/src/algorithms.ts +2 -2
  126. package/bone/output/session/src/audit.ts +44 -44
  127. package/bone/output/session/src/auth.ts +57 -57
  128. package/bone/output/session/src/cron.ts +12 -12
  129. package/bone/output/session/src/db.ts +31 -31
  130. package/bone/output/session/src/debug.ts +66 -66
  131. package/bone/output/session/src/events.ts +270 -270
  132. package/bone/output/session/src/extensions.ts +215 -215
  133. package/bone/output/session/src/failure_rules.ts +283 -283
  134. package/bone/output/session/src/flows.ts +168 -168
  135. package/bone/output/session/src/health.ts +43 -43
  136. package/bone/output/session/src/index.ts +99 -99
  137. package/bone/output/session/src/logger.ts +67 -66
  138. package/bone/output/session/src/metrics.ts +75 -75
  139. package/bone/output/session/src/migrate.ts +331 -331
  140. package/bone/output/session/src/migration_diff.ts +108 -108
  141. package/bone/output/session/src/notify.ts +112 -112
  142. package/bone/output/session/src/routes/message.ts +93 -93
  143. package/bone/output/session/src/routes/part.ts +79 -79
  144. package/bone/output/session/src/routes/permission.ts +79 -79
  145. package/bone/output/session/src/routes/project.ts +79 -79
  146. package/bone/output/session/src/routes/session.ts +294 -294
  147. package/bone/output/session/src/schemas.ts +357 -357
  148. package/bone/output/session/src/state_machines/session.ts +23 -23
  149. package/bone/output/session/src/tests.ts +325 -325
  150. package/bone/output/session/src/websocket.ts +223 -200
  151. package/bone/output/session/tsconfig.json +24 -24
  152. package/bone/output/workspace/.dockerignore +7 -7
  153. package/bone/output/workspace/.env.example +36 -36
  154. package/bone/output/workspace/.github/workflows/ci.yaml +58 -58
  155. package/bone/output/workspace/Dockerfile +22 -22
  156. package/bone/output/workspace/README.md +45 -45
  157. package/bone/output/workspace/WorkspaceDomain.bone.map +188 -188
  158. package/bone/output/workspace/WorkspaceDomain.postman_collection.json +620 -620
  159. package/bone/output/workspace/admin/index.html +484 -484
  160. package/bone/output/workspace/docker-compose.yaml +22 -22
  161. package/bone/output/workspace/k8s/deployment.yaml +75 -75
  162. package/bone/output/workspace/migrations/audit_log.sql +18 -18
  163. package/bone/output/workspace/migrations/codebase.sql +34 -34
  164. package/bone/output/workspace/migrations/event_outbox.sql +31 -31
  165. package/bone/output/workspace/migrations/snapshot.sql +32 -32
  166. package/bone/output/workspace/migrations/workspace.sql +33 -33
  167. package/bone/output/workspace/openapi.yaml +721 -721
  168. package/bone/output/workspace/package.json +35 -35
  169. package/bone/output/workspace/schema.graphql +153 -153
  170. package/bone/output/workspace/sdk/client.ts +155 -155
  171. package/bone/output/workspace/src/algorithms.ts +2 -2
  172. package/bone/output/workspace/src/audit.ts +37 -37
  173. package/bone/output/workspace/src/auth.ts +57 -57
  174. package/bone/output/workspace/src/cron.ts +12 -12
  175. package/bone/output/workspace/src/db.ts +31 -31
  176. package/bone/output/workspace/src/debug.ts +66 -66
  177. package/bone/output/workspace/src/events.ts +243 -243
  178. package/bone/output/workspace/src/extensions.ts +44 -44
  179. package/bone/output/workspace/src/failure_rules.ts +152 -152
  180. package/bone/output/workspace/src/health.ts +43 -43
  181. package/bone/output/workspace/src/index.ts +88 -88
  182. package/bone/output/workspace/src/logger.ts +69 -66
  183. package/bone/output/workspace/src/metrics.ts +75 -75
  184. package/bone/output/workspace/src/migrate.ts +219 -219
  185. package/bone/output/workspace/src/migration_diff.ts +108 -108
  186. package/bone/output/workspace/src/notify.ts +73 -73
  187. package/bone/output/workspace/src/routes/codebase.ts +87 -87
  188. package/bone/output/workspace/src/routes/snapshot.ts +127 -127
  189. package/bone/output/workspace/src/routes/workspace.ts +190 -190
  190. package/bone/output/workspace/src/schemas.ts +231 -231
  191. package/bone/output/workspace/src/state_machines/codebase.ts +21 -21
  192. package/bone/output/workspace/src/state_machines/snapshot.ts +20 -20
  193. package/bone/output/workspace/src/state_machines/workspace.ts +21 -21
  194. package/bone/output/workspace/src/tests.ts +248 -248
  195. package/bone/output/workspace/tsconfig.json +24 -24
  196. package/compat/opencode_adapter.ts +94 -17
  197. package/package.json +15 -2
  198. package/src/cli.ts +66 -107
  199. package/src/db_adapter.ts +354 -0
  200. package/src/engine/account/account.sql.ts +39 -39
  201. package/src/engine/account/account.ts +456 -456
  202. package/src/engine/account/repo.ts +166 -166
  203. package/src/engine/account/schema.ts +99 -99
  204. package/src/engine/account/url.ts +8 -8
  205. package/src/engine/acp/README.md +174 -174
  206. package/src/engine/acp/agent.ts +1968 -1968
  207. package/src/engine/acp/runtime.ts +22 -22
  208. package/src/engine/acp/session.ts +122 -122
  209. package/src/engine/acp/types.ts +24 -24
  210. package/src/engine/agent/agent.ts +463 -463
  211. package/src/engine/agent/generate.txt +75 -75
  212. package/src/engine/agent/prompt/compaction.txt +9 -9
  213. package/src/engine/agent/prompt/explore.txt +18 -18
  214. package/src/engine/agent/prompt/scout.txt +36 -36
  215. package/src/engine/agent/prompt/summary.txt +11 -11
  216. package/src/engine/agent/prompt/title.txt +44 -44
  217. package/src/engine/agent/subagent-permissions.ts +34 -34
  218. package/src/engine/auth/index.ts +96 -96
  219. package/src/engine/background/background/job.ts +200 -200
  220. package/src/engine/background/job.ts +200 -200
  221. package/src/engine/bus/bus-event.ts +45 -45
  222. package/src/engine/bus/global.ts +22 -22
  223. package/src/engine/bus/index.ts +203 -203
  224. package/src/engine/command/command/index.ts +181 -181
  225. package/src/engine/command/command/template/initialize.txt +66 -66
  226. package/src/engine/command/command/template/review.txt +101 -101
  227. package/src/engine/command/index.ts +181 -181
  228. package/src/engine/command/template/initialize.txt +66 -66
  229. package/src/engine/command/template/review.txt +101 -101
  230. package/src/engine/config/agent.ts +172 -172
  231. package/src/engine/config/attachment.ts +25 -25
  232. package/src/engine/config/command.ts +62 -62
  233. package/src/engine/config/config.ts +833 -833
  234. package/src/engine/config/console-state.ts +14 -14
  235. package/src/engine/config/entry-name.ts +16 -16
  236. package/src/engine/config/error.ts +23 -23
  237. package/src/engine/config/formatter.ts +13 -13
  238. package/src/engine/config/layout.ts +6 -6
  239. package/src/engine/config/lsp.ts +43 -43
  240. package/src/engine/config/managed.ts +71 -71
  241. package/src/engine/config/markdown.ts +96 -96
  242. package/src/engine/config/mcp.ts +56 -56
  243. package/src/engine/config/model-id.ts +5 -5
  244. package/src/engine/config/parse.ts +79 -79
  245. package/src/engine/config/paths.ts +45 -45
  246. package/src/engine/config/permission.ts +58 -58
  247. package/src/engine/config/plugin.ts +84 -84
  248. package/src/engine/config/provider.ts +111 -111
  249. package/src/engine/config/reference.ts +23 -23
  250. package/src/engine/config/server.ts +19 -19
  251. package/src/engine/config/skills.ts +14 -14
  252. package/src/engine/config/variable.ts +90 -90
  253. package/src/engine/control-plane/adapters/index.ts +41 -41
  254. package/src/engine/control-plane/adapters/worktree.ts +96 -96
  255. package/src/engine/control-plane/dev/README.md +19 -19
  256. package/src/engine/control-plane/dev/debug-workspace-plugin.ts +73 -73
  257. package/src/engine/control-plane/schema.ts +14 -14
  258. package/src/engine/control-plane/types.ts +59 -59
  259. package/src/engine/control-plane/util.ts +39 -39
  260. package/src/engine/control-plane/workspace-adapter-runtime.ts +51 -51
  261. package/src/engine/control-plane/workspace-context.ts +26 -26
  262. package/src/engine/control-plane/workspace.sql.ts +20 -20
  263. package/src/engine/control-plane/workspace.ts +1072 -1072
  264. package/src/engine/data-migration.ts +161 -161
  265. package/src/engine/effect/app-runtime.ts +143 -143
  266. package/src/engine/effect/bootstrap-runtime.ts +29 -29
  267. package/src/engine/effect/bridge.ts +84 -84
  268. package/src/engine/effect/config-service.ts +67 -67
  269. package/src/engine/effect/instance-ref.ts +11 -11
  270. package/src/engine/effect/instance-registry.ts +12 -12
  271. package/src/engine/effect/instance-state.ts +72 -72
  272. package/src/engine/effect/promise.ts +17 -17
  273. package/src/engine/effect/run-service.ts +47 -47
  274. package/src/engine/effect/runner.ts +217 -217
  275. package/src/engine/effect/runtime-flags.ts +74 -74
  276. package/src/engine/effect/service-use.ts +38 -38
  277. package/src/engine/env/index.ts +37 -37
  278. package/src/engine/event-v2-bridge.ts +89 -89
  279. package/src/engine/file/file/ignore.ts +81 -81
  280. package/src/engine/file/file/index.ts +651 -651
  281. package/src/engine/file/file/protected.ts +59 -59
  282. package/src/engine/file/file/ripgrep.ts +481 -481
  283. package/src/engine/file/file/watcher.ts +167 -167
  284. package/src/engine/file/ignore.ts +81 -81
  285. package/src/engine/file/index.ts +651 -651
  286. package/src/engine/file/protected.ts +59 -59
  287. package/src/engine/file/ripgrep.ts +481 -481
  288. package/src/engine/file/watcher.ts +167 -167
  289. package/src/engine/format/format/formatter.ts +404 -404
  290. package/src/engine/format/format/index.ts +209 -209
  291. package/src/engine/format/formatter.ts +404 -404
  292. package/src/engine/format/index.ts +209 -209
  293. package/src/engine/git/git/index.ts +347 -347
  294. package/src/engine/git/index.ts +347 -347
  295. package/src/engine/id/id.ts +80 -80
  296. package/src/engine/ide/index.ts +70 -70
  297. package/src/engine/image/image/image.ts +176 -176
  298. package/src/engine/image/image.ts +176 -176
  299. package/src/engine/index.ts +251 -251
  300. package/src/engine/installation/index.ts +327 -327
  301. package/src/engine/lsp/client.ts +707 -707
  302. package/src/engine/lsp/diagnostic.ts +29 -29
  303. package/src/engine/lsp/language.ts +121 -121
  304. package/src/engine/lsp/launch.ts +21 -21
  305. package/src/engine/lsp/lsp/client.ts +707 -707
  306. package/src/engine/lsp/lsp/diagnostic.ts +29 -29
  307. package/src/engine/lsp/lsp/language.ts +121 -121
  308. package/src/engine/lsp/lsp/launch.ts +21 -21
  309. package/src/engine/lsp/lsp/lsp.ts +507 -507
  310. package/src/engine/lsp/lsp/server.ts +2064 -2064
  311. package/src/engine/lsp/lsp.ts +507 -507
  312. package/src/engine/lsp/server.ts +2064 -2064
  313. package/src/engine/mcp/auth.ts +146 -146
  314. package/src/engine/mcp/index.ts +958 -958
  315. package/src/engine/mcp/mcp/auth.ts +146 -146
  316. package/src/engine/mcp/mcp/index.ts +958 -958
  317. package/src/engine/mcp/mcp/oauth-callback.ts +232 -232
  318. package/src/engine/mcp/mcp/oauth-provider.ts +214 -214
  319. package/src/engine/mcp/oauth-callback.ts +232 -232
  320. package/src/engine/mcp/oauth-provider.ts +214 -214
  321. package/src/engine/node.ts +6 -6
  322. package/src/engine/patch/index.ts +689 -689
  323. package/src/engine/patch/patch/index.ts +689 -689
  324. package/src/engine/permission/arity.ts +163 -163
  325. package/src/engine/permission/evaluate.ts +15 -15
  326. package/src/engine/permission/index.ts +306 -306
  327. package/src/engine/permission/permission/arity.ts +163 -163
  328. package/src/engine/permission/permission/evaluate.ts +15 -15
  329. package/src/engine/permission/permission/index.ts +306 -306
  330. package/src/engine/permission/permission/schema.ts +13 -13
  331. package/src/engine/permission/schema.ts +13 -13
  332. package/src/engine/plugin/azure.ts +26 -26
  333. package/src/engine/plugin/cloudflare.ts +76 -76
  334. package/src/engine/plugin/codex.ts +622 -622
  335. package/src/engine/plugin/digitalocean.ts +411 -411
  336. package/src/engine/plugin/github-copilot/copilot.ts +394 -394
  337. package/src/engine/plugin/github-copilot/models.ts +196 -196
  338. package/src/engine/plugin/index.ts +295 -295
  339. package/src/engine/plugin/install.ts +439 -439
  340. package/src/engine/plugin/loader.ts +216 -216
  341. package/src/engine/plugin/meta.ts +188 -188
  342. package/src/engine/plugin/shared.ts +323 -323
  343. package/src/engine/project/bootstrap-service.ts +9 -9
  344. package/src/engine/project/bootstrap.ts +75 -75
  345. package/src/engine/project/instance-context.ts +24 -24
  346. package/src/engine/project/instance-layer.ts +11 -11
  347. package/src/engine/project/instance-runtime.ts +16 -16
  348. package/src/engine/project/instance-store.ts +193 -193
  349. package/src/engine/project/project.sql.ts +17 -17
  350. package/src/engine/project/project.ts +537 -537
  351. package/src/engine/project/schema.ts +13 -13
  352. package/src/engine/project/vcs.ts +405 -405
  353. package/src/engine/provider/auth.ts +225 -225
  354. package/src/engine/provider/error.ts +204 -204
  355. package/src/engine/provider/model-status.ts +8 -8
  356. package/src/engine/provider/provider.ts +1843 -1843
  357. package/src/engine/provider/schema.ts +30 -30
  358. package/src/engine/provider/transform.ts +1376 -1376
  359. package/src/engine/pty/index.ts +365 -365
  360. package/src/engine/pty/input.ts +24 -24
  361. package/src/engine/pty/pty/index.ts +365 -365
  362. package/src/engine/pty/pty/input.ts +24 -24
  363. package/src/engine/pty/pty/pty.bun.ts +26 -26
  364. package/src/engine/pty/pty/pty.node.ts +27 -27
  365. package/src/engine/pty/pty/pty.ts +25 -25
  366. package/src/engine/pty/pty/schema.ts +14 -14
  367. package/src/engine/pty/pty/ticket.ts +68 -68
  368. package/src/engine/pty/pty.bun.ts +26 -26
  369. package/src/engine/pty/pty.node.ts +27 -27
  370. package/src/engine/pty/pty.ts +25 -25
  371. package/src/engine/pty/schema.ts +14 -14
  372. package/src/engine/pty/ticket.ts +68 -68
  373. package/src/engine/question/index.ts +213 -213
  374. package/src/engine/question/question/index.ts +213 -213
  375. package/src/engine/question/question/schema.ts +10 -10
  376. package/src/engine/question/schema.ts +10 -10
  377. package/src/engine/reference/reference/reference.ts +241 -241
  378. package/src/engine/reference/reference/repository-cache.ts +147 -147
  379. package/src/engine/reference/reference.ts +241 -241
  380. package/src/engine/reference/repository-cache.ts +147 -147
  381. package/src/engine/session/compaction.ts +651 -651
  382. package/src/engine/session/instruction.ts +238 -238
  383. package/src/engine/session/llm.ts +459 -459
  384. package/src/engine/session/message-error.ts +14 -14
  385. package/src/engine/session/message-v2.ts +1202 -1202
  386. package/src/engine/session/message.ts +146 -146
  387. package/src/engine/session/overflow.ts +32 -32
  388. package/src/engine/session/processor.ts +823 -823
  389. package/src/engine/session/prompt/anthropic.txt +105 -105
  390. package/src/engine/session/prompt/beast.txt +147 -147
  391. package/src/engine/session/prompt/build-switch.txt +5 -5
  392. package/src/engine/session/prompt/codex.txt +79 -79
  393. package/src/engine/session/prompt/copilot-gpt-5.txt +143 -143
  394. package/src/engine/session/prompt/default.txt +105 -105
  395. package/src/engine/session/prompt/gemini.txt +155 -155
  396. package/src/engine/session/prompt/gpt.txt +107 -107
  397. package/src/engine/session/prompt/kimi.txt +95 -95
  398. package/src/engine/session/prompt/max-steps.txt +15 -15
  399. package/src/engine/session/prompt/plan-reminder-anthropic.txt +67 -67
  400. package/src/engine/session/prompt/plan.txt +26 -26
  401. package/src/engine/session/prompt/trinity.txt +97 -97
  402. package/src/engine/session/prompt.ts +66 -9
  403. package/src/engine/session/retry.ts +200 -200
  404. package/src/engine/session/revert.ts +162 -162
  405. package/src/engine/session/run-state.ts +153 -153
  406. package/src/engine/session/schema.ts +26 -26
  407. package/src/engine/session/session.sql.ts +137 -137
  408. package/src/engine/session/session.ts +1011 -1011
  409. package/src/engine/session/status.ts +94 -94
  410. package/src/engine/session/summary.ts +164 -164
  411. package/src/engine/session/system.ts +84 -84
  412. package/src/engine/session/todo.ts +81 -81
  413. package/src/engine/share/session.ts +61 -61
  414. package/src/engine/share/share-next.ts +376 -376
  415. package/src/engine/share/share.sql.ts +13 -13
  416. package/src/engine/shell/shell/shell.ts +215 -215
  417. package/src/engine/shell/shell.ts +215 -215
  418. package/src/engine/skill/discovery.ts +116 -116
  419. package/src/engine/skill/index.ts +336 -336
  420. package/src/engine/skill/prompt/customize-opencode.md +377 -377
  421. package/src/engine/skill/skill/discovery.ts +116 -116
  422. package/src/engine/skill/skill/index.ts +336 -336
  423. package/src/engine/skill/skill/prompt/customize-opencode.md +377 -377
  424. package/src/engine/snapshot/index.ts +762 -762
  425. package/src/engine/snapshot/snapshot/index.ts +762 -762
  426. package/src/engine/sync/README.md +179 -179
  427. package/src/engine/sync/event.sql.ts +17 -17
  428. package/src/engine/sync/index.ts +410 -410
  429. package/src/engine/sync/schema.ts +11 -11
  430. package/src/engine/temporary.ts +33 -33
  431. package/src/engine/tool/apply_patch.ts +313 -313
  432. package/src/engine/tool/apply_patch.txt +33 -33
  433. package/src/engine/tool/edit.ts +711 -711
  434. package/src/engine/tool/edit.txt +10 -10
  435. package/src/engine/tool/external-directory.ts +49 -49
  436. package/src/engine/tool/glob.ts +103 -103
  437. package/src/engine/tool/glob.txt +6 -6
  438. package/src/engine/tool/grep.ts +156 -156
  439. package/src/engine/tool/grep.txt +8 -8
  440. package/src/engine/tool/invalid.ts +21 -21
  441. package/src/engine/tool/json-schema.ts +164 -164
  442. package/src/engine/tool/lsp.ts +113 -113
  443. package/src/engine/tool/lsp.txt +24 -24
  444. package/src/engine/tool/mcp-websearch.ts +96 -96
  445. package/src/engine/tool/plan-enter.txt +14 -14
  446. package/src/engine/tool/plan-exit.txt +13 -13
  447. package/src/engine/tool/plan.ts +78 -78
  448. package/src/engine/tool/question.ts +44 -44
  449. package/src/engine/tool/question.txt +10 -10
  450. package/src/engine/tool/read.ts +337 -337
  451. package/src/engine/tool/read.txt +14 -14
  452. package/src/engine/tool/registry.ts +472 -472
  453. package/src/engine/tool/repo_clone.ts +80 -80
  454. package/src/engine/tool/repo_clone.txt +5 -5
  455. package/src/engine/tool/repo_overview.ts +279 -279
  456. package/src/engine/tool/repo_overview.txt +4 -4
  457. package/src/engine/tool/schema.ts +14 -14
  458. package/src/engine/tool/shell/id.ts +19 -19
  459. package/src/engine/tool/shell/prompt.ts +295 -295
  460. package/src/engine/tool/shell/shell.txt +77 -77
  461. package/src/engine/tool/shell.ts +647 -647
  462. package/src/engine/tool/skill.ts +75 -75
  463. package/src/engine/tool/skill.txt +5 -5
  464. package/src/engine/tool/task.ts +337 -337
  465. package/src/engine/tool/task.txt +58 -58
  466. package/src/engine/tool/task_status.ts +179 -179
  467. package/src/engine/tool/task_status.txt +13 -13
  468. package/src/engine/tool/todo.ts +57 -57
  469. package/src/engine/tool/todowrite.txt +167 -167
  470. package/src/engine/tool/tool/apply_patch.ts +313 -313
  471. package/src/engine/tool/tool/apply_patch.txt +33 -33
  472. package/src/engine/tool/tool/edit.ts +711 -711
  473. package/src/engine/tool/tool/edit.txt +10 -10
  474. package/src/engine/tool/tool/external-directory.ts +49 -49
  475. package/src/engine/tool/tool/glob.ts +103 -103
  476. package/src/engine/tool/tool/glob.txt +6 -6
  477. package/src/engine/tool/tool/grep.ts +156 -156
  478. package/src/engine/tool/tool/grep.txt +8 -8
  479. package/src/engine/tool/tool/invalid.ts +21 -21
  480. package/src/engine/tool/tool/json-schema.ts +164 -164
  481. package/src/engine/tool/tool/lsp.ts +113 -113
  482. package/src/engine/tool/tool/lsp.txt +24 -24
  483. package/src/engine/tool/tool/mcp-websearch.ts +96 -96
  484. package/src/engine/tool/tool/plan-enter.txt +14 -14
  485. package/src/engine/tool/tool/plan-exit.txt +13 -13
  486. package/src/engine/tool/tool/plan.ts +78 -78
  487. package/src/engine/tool/tool/question.ts +44 -44
  488. package/src/engine/tool/tool/question.txt +10 -10
  489. package/src/engine/tool/tool/read.ts +337 -337
  490. package/src/engine/tool/tool/read.txt +14 -14
  491. package/src/engine/tool/tool/registry.ts +472 -472
  492. package/src/engine/tool/tool/repo_clone.ts +80 -80
  493. package/src/engine/tool/tool/repo_clone.txt +5 -5
  494. package/src/engine/tool/tool/repo_overview.ts +279 -279
  495. package/src/engine/tool/tool/repo_overview.txt +4 -4
  496. package/src/engine/tool/tool/schema.ts +14 -14
  497. package/src/engine/tool/tool/shell/id.ts +19 -19
  498. package/src/engine/tool/tool/shell/prompt.ts +295 -295
  499. package/src/engine/tool/tool/shell/shell.txt +77 -77
  500. package/src/engine/tool/tool/shell.ts +647 -647
  501. package/src/engine/tool/tool/skill.ts +75 -75
  502. package/src/engine/tool/tool/skill.txt +5 -5
  503. package/src/engine/tool/tool/task.ts +337 -337
  504. package/src/engine/tool/tool/task.txt +58 -58
  505. package/src/engine/tool/tool/task_status.ts +179 -179
  506. package/src/engine/tool/tool/task_status.txt +13 -13
  507. package/src/engine/tool/tool/todo.ts +57 -57
  508. package/src/engine/tool/tool/todowrite.txt +167 -167
  509. package/src/engine/tool/tool/tool.ts +164 -164
  510. package/src/engine/tool/tool/truncate.ts +160 -160
  511. package/src/engine/tool/tool/truncation-dir.ts +4 -4
  512. package/src/engine/tool/tool/webfetch.ts +192 -192
  513. package/src/engine/tool/tool/webfetch.txt +13 -13
  514. package/src/engine/tool/tool/websearch.ts +143 -143
  515. package/src/engine/tool/tool/websearch.txt +14 -14
  516. package/src/engine/tool/tool/write.ts +104 -104
  517. package/src/engine/tool/tool/write.txt +8 -8
  518. package/src/engine/tool/tool.ts +164 -164
  519. package/src/engine/tool/truncate.ts +160 -160
  520. package/src/engine/tool/truncation-dir.ts +4 -4
  521. package/src/engine/tool/webfetch.ts +192 -192
  522. package/src/engine/tool/webfetch.txt +13 -13
  523. package/src/engine/tool/websearch.ts +143 -143
  524. package/src/engine/tool/websearch.txt +14 -14
  525. package/src/engine/tool/write.ts +104 -104
  526. package/src/engine/tool/write.txt +8 -8
  527. package/src/engine/util/archive.ts +17 -17
  528. package/src/engine/util/bom.ts +31 -31
  529. package/src/engine/util/data-url.ts +9 -9
  530. package/src/engine/util/defer.ts +10 -10
  531. package/src/engine/util/effect-http-client.ts +11 -11
  532. package/src/engine/util/error.ts +88 -88
  533. package/src/engine/util/filesystem.ts +252 -252
  534. package/src/engine/util/format.ts +20 -20
  535. package/src/engine/util/iife.ts +3 -3
  536. package/src/engine/util/lazy.ts +20 -20
  537. package/src/engine/util/local-context.ts +25 -25
  538. package/src/engine/util/locale.ts +86 -86
  539. package/src/engine/util/media.ts +26 -26
  540. package/src/engine/util/process.ts +176 -176
  541. package/src/engine/util/queue.ts +32 -32
  542. package/src/engine/util/record.ts +3 -3
  543. package/src/engine/util/repository.ts +158 -158
  544. package/src/engine/util/rpc.ts +66 -66
  545. package/src/engine/util/signal.ts +12 -12
  546. package/src/engine/util/timeout.ts +13 -13
  547. package/src/engine/util/token.ts +7 -7
  548. package/src/engine/util/util/archive.ts +17 -17
  549. package/src/engine/util/util/bom.ts +31 -31
  550. package/src/engine/util/util/data-url.ts +9 -9
  551. package/src/engine/util/util/defer.ts +10 -10
  552. package/src/engine/util/util/effect-http-client.ts +11 -11
  553. package/src/engine/util/util/error.ts +88 -88
  554. package/src/engine/util/util/filesystem.ts +252 -252
  555. package/src/engine/util/util/format.ts +20 -20
  556. package/src/engine/util/util/iife.ts +3 -3
  557. package/src/engine/util/util/lazy.ts +20 -20
  558. package/src/engine/util/util/local-context.ts +25 -25
  559. package/src/engine/util/util/locale.ts +86 -86
  560. package/src/engine/util/util/media.ts +26 -26
  561. package/src/engine/util/util/process.ts +176 -176
  562. package/src/engine/util/util/queue.ts +32 -32
  563. package/src/engine/util/util/record.ts +3 -3
  564. package/src/engine/util/util/repository.ts +158 -158
  565. package/src/engine/util/util/rpc.ts +66 -66
  566. package/src/engine/util/util/signal.ts +12 -12
  567. package/src/engine/util/util/timeout.ts +13 -13
  568. package/src/engine/util/util/token.ts +7 -7
  569. package/src/engine/util/util/which.ts +14 -14
  570. package/src/engine/util/util/wildcard.ts +59 -59
  571. package/src/engine/util/which.ts +14 -14
  572. package/src/engine/util/wildcard.ts +59 -59
  573. package/src/engine/worktree/index.ts +621 -621
  574. package/src/server.ts +121 -158
  575. package/src/tui.ts +485 -502
@@ -1,58 +1,58 @@
1
- Launch a new agent to handle complex, multistep tasks autonomously.
2
-
3
- When using the Task tool, you must specify a subagent_type parameter to select which agent type to use.
4
-
5
- When to use the Task tool:
6
- - When you are instructed to execute custom slash commands. Use the Task tool with the slash command invocation as the entire prompt. The slash command can take arguments. For example: Task(description="Check the file", prompt="/check-file path/to/file.py")
7
-
8
- When NOT to use the Task tool:
9
- - If you want to read a specific file path, use the Read or Glob tool instead of the Task tool, to find the match more quickly
10
- - If you are searching for a specific class definition like "class Foo", use the Glob tool instead, to find the match more quickly
11
- - If you are searching for code within a specific file or set of 2-3 files, use the Read tool instead of the Task tool, to find the match more quickly
12
- - Other tasks that are not related to the agent descriptions above
13
-
14
-
15
- Usage notes:
16
- 1. Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses
17
- 2. When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result. The output includes a task_id you can reuse later to continue the same subagent session.
18
- 3. If OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS is enabled, background=true launches the subagent asynchronously. Use task_status(task_id=..., wait=false) to poll, or wait=true to block until done.
19
- 4. Each agent invocation starts with a fresh context unless you provide task_id to resume the same subagent session (which continues with its previous messages and tool outputs). When starting fresh, your prompt should contain a highly detailed task description for the agent to perform autonomously and you should specify exactly what information the agent should return back to you in its final and only message to you.
20
- 5. The agent's outputs should generally be trusted
21
- 6. Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.), since it is not aware of the user's intent. Tell it how to verify its work if possible (e.g., relevant test commands).
22
- 7. If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.
23
-
24
- Example usage (NOTE: The agents below are fictional examples for illustration only - use the actual agents listed above):
25
-
26
- <example_agent_descriptions>
27
- "code-reviewer": use this agent after you are done writing a significant piece of code
28
- "greeting-responder": use this agent when to respond to user greetings with a friendly joke
29
- </example_agent_description>
30
-
31
- <example>
32
- user: "Please write a function that checks if a number is prime"
33
- assistant: Sure let me write a function that checks if a number is prime
34
- assistant: First let me use the Write tool to write a function that checks if a number is prime
35
- assistant: I'm going to use the Write tool to write the following code:
36
- <code>
37
- function isPrime(n) {
38
- if (n <= 1) return false
39
- for (let i = 2; i * i <= n; i++) {
40
- if (n % i === 0) return false
41
- }
42
- return true
43
- }
44
- </code>
45
- <commentary>
46
- Since a significant piece of code was written and the task was completed, now use the code-reviewer agent to review the code
47
- </commentary>
48
- assistant: Now let me use the code-reviewer agent to review the code
49
- assistant: Uses the Task tool to launch the code-reviewer agent
50
- </example>
51
-
52
- <example>
53
- user: "Hello"
54
- <commentary>
55
- Since the user is greeting, use the greeting-responder agent to respond with a friendly joke
56
- </commentary>
57
- assistant: "I'm going to use the Task tool to launch the with the greeting-responder agent"
58
- </example>
1
+ Launch a new agent to handle complex, multistep tasks autonomously.
2
+
3
+ When using the Task tool, you must specify a subagent_type parameter to select which agent type to use.
4
+
5
+ When to use the Task tool:
6
+ - When you are instructed to execute custom slash commands. Use the Task tool with the slash command invocation as the entire prompt. The slash command can take arguments. For example: Task(description="Check the file", prompt="/check-file path/to/file.py")
7
+
8
+ When NOT to use the Task tool:
9
+ - If you want to read a specific file path, use the Read or Glob tool instead of the Task tool, to find the match more quickly
10
+ - If you are searching for a specific class definition like "class Foo", use the Glob tool instead, to find the match more quickly
11
+ - If you are searching for code within a specific file or set of 2-3 files, use the Read tool instead of the Task tool, to find the match more quickly
12
+ - Other tasks that are not related to the agent descriptions above
13
+
14
+
15
+ Usage notes:
16
+ 1. Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses
17
+ 2. When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result. The output includes a task_id you can reuse later to continue the same subagent session.
18
+ 3. If OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS is enabled, background=true launches the subagent asynchronously. Use task_status(task_id=..., wait=false) to poll, or wait=true to block until done.
19
+ 4. Each agent invocation starts with a fresh context unless you provide task_id to resume the same subagent session (which continues with its previous messages and tool outputs). When starting fresh, your prompt should contain a highly detailed task description for the agent to perform autonomously and you should specify exactly what information the agent should return back to you in its final and only message to you.
20
+ 5. The agent's outputs should generally be trusted
21
+ 6. Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.), since it is not aware of the user's intent. Tell it how to verify its work if possible (e.g., relevant test commands).
22
+ 7. If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.
23
+
24
+ Example usage (NOTE: The agents below are fictional examples for illustration only - use the actual agents listed above):
25
+
26
+ <example_agent_descriptions>
27
+ "code-reviewer": use this agent after you are done writing a significant piece of code
28
+ "greeting-responder": use this agent when to respond to user greetings with a friendly joke
29
+ </example_agent_description>
30
+
31
+ <example>
32
+ user: "Please write a function that checks if a number is prime"
33
+ assistant: Sure let me write a function that checks if a number is prime
34
+ assistant: First let me use the Write tool to write a function that checks if a number is prime
35
+ assistant: I'm going to use the Write tool to write the following code:
36
+ <code>
37
+ function isPrime(n) {
38
+ if (n <= 1) return false
39
+ for (let i = 2; i * i <= n; i++) {
40
+ if (n % i === 0) return false
41
+ }
42
+ return true
43
+ }
44
+ </code>
45
+ <commentary>
46
+ Since a significant piece of code was written and the task was completed, now use the code-reviewer agent to review the code
47
+ </commentary>
48
+ assistant: Now let me use the code-reviewer agent to review the code
49
+ assistant: Uses the Task tool to launch the code-reviewer agent
50
+ </example>
51
+
52
+ <example>
53
+ user: "Hello"
54
+ <commentary>
55
+ Since the user is greeting, use the greeting-responder agent to respond with a friendly joke
56
+ </commentary>
57
+ assistant: "I'm going to use the Task tool to launch the with the greeting-responder agent"
58
+ </example>
@@ -1,179 +1,179 @@
1
- import * as Tool from "./tool"
2
- import DESCRIPTION from "./task_status.txt"
3
- import { BackgroundJob } from "@/background/job"
4
- import { Session } from "@/session/session"
5
- import { MessageV2 } from "@/session/message-v2"
6
- import { SessionID } from "@/session/schema"
7
- import { SessionStatus } from "@/session/status"
8
- import { PositiveInt } from "@opencode-ai/core/schema"
9
- import { RuntimeFlags } from "@/effect/runtime-flags"
10
- import { Effect, Option, Schema } from "effect"
11
-
12
- const DEFAULT_TIMEOUT = 60_000
13
- const POLL_MS = 300
14
-
15
- const Parameters = Schema.Struct({
16
- task_id: SessionID.annotate({ description: "The task_id returned by the task tool" }),
17
- wait: Schema.optional(Schema.Boolean).annotate({
18
- description: "When true, wait until the task reaches a terminal state or timeout",
19
- }),
20
- timeout_ms: Schema.optional(PositiveInt).annotate({
21
- description: "Maximum milliseconds to wait when wait=true (default: 60000)",
22
- }),
23
- })
24
-
25
- type State = BackgroundJob.Status
26
- type InspectResult = { state: State; text: string }
27
-
28
- function format(input: { taskID: SessionID; state: State; text: string }) {
29
- const tag = input.state === "completed" || input.state === "running" ? "task_result" : "task_error"
30
- return [`task_id: ${input.taskID}`, `state: ${input.state}`, "", `<${tag}>`, input.text, `</${tag}>`].join("\n")
31
- }
32
-
33
- function errorText(error: NonNullable<MessageV2.Assistant["error"]>) {
34
- const data = Reflect.get(error, "data")
35
- const message = data && typeof data === "object" ? Reflect.get(data, "message") : undefined
36
- if (typeof message === "string" && message) return message
37
- return error.name
38
- }
39
-
40
- function inspectMessage(message: MessageV2.WithParts): InspectResult | undefined {
41
- if (message.info.role !== "assistant") return
42
- const text = message.parts.findLast((part) => part.type === "text")?.text ?? ""
43
- if (message.info.error) return { state: "error", text: text || errorText(message.info.error) }
44
- if (message.info.finish && !["tool-calls", "unknown"].includes(message.info.finish))
45
- return { state: "completed", text }
46
- return { state: "running", text: text || "Task is still running." }
47
- }
48
-
49
- export const TaskStatusTool = Tool.define(
50
- "task_status",
51
- Effect.gen(function* () {
52
- const jobs = yield* BackgroundJob.Service
53
- const sessions = yield* Session.Service
54
- const status = yield* SessionStatus.Service
55
- const flags = yield* RuntimeFlags.Service
56
-
57
- const inspect: (taskID: SessionID) => Effect.Effect<InspectResult> = Effect.fn("TaskStatusTool.inspect")(function* (
58
- taskID: SessionID,
59
- ) {
60
- const job = yield* jobs.get(taskID)
61
- if (job) {
62
- return {
63
- state: job.status,
64
- text:
65
- job.output ??
66
- job.error ??
67
- (job.status === "running"
68
- ? "Task is still running."
69
- : job.status === "cancelled"
70
- ? "Task was cancelled."
71
- : ""),
72
- }
73
- }
74
-
75
- const current = yield* status.get(taskID)
76
- if (current.type === "busy" || current.type === "retry") {
77
- return {
78
- state: "running",
79
- text: current.type === "retry" ? `Task is retrying: ${current.message}` : "Task is still running.",
80
- }
81
- }
82
-
83
- const latestAssistant = yield* sessions
84
- .findMessage(taskID, (item) => item.info.role === "assistant")
85
- .pipe(Effect.orDie)
86
- if (Option.isSome(latestAssistant)) {
87
- const latest = inspectMessage(latestAssistant.value)
88
- if (!latest) return { state: "error", text: "Task is not running in this process." }
89
- if (latest.state === "running")
90
- return { state: "error", text: "Task is not running in this process and has no final output." }
91
- return latest
92
- }
93
- return { state: "error", text: "Task is not running in this process and has not produced output." }
94
- })
95
-
96
- const waitForTerminal: (
97
- taskID: SessionID,
98
- timeout: number,
99
- ) => Effect.Effect<{ result: InspectResult; timedOut: boolean }> = Effect.fn("TaskStatusTool.waitForTerminal")(
100
- function* (taskID: SessionID, timeout: number) {
101
- const result = yield* inspect(taskID)
102
- if (result.state !== "running") return { result, timedOut: false }
103
- if (timeout <= 0) return { result, timedOut: true }
104
- const sleep = Math.min(POLL_MS, timeout)
105
- yield* Effect.sleep(`${sleep} millis`)
106
- return yield* waitForTerminal(taskID, timeout - sleep)
107
- },
108
- )
109
-
110
- const run = Effect.fn("TaskStatusTool.execute")(function* (
111
- params: Schema.Schema.Type<typeof Parameters>,
112
- _ctx: Tool.Context,
113
- ) {
114
- if (!flags.experimentalBackgroundSubagents) {
115
- return yield* Effect.fail(new Error("task_status requires OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true"))
116
- }
117
-
118
- const session = yield* sessions.get(params.task_id).pipe(Effect.catchCause(() => Effect.succeed(undefined)))
119
- if (!session) {
120
- return {
121
- title: "Task status",
122
- metadata: {
123
- task_id: params.task_id,
124
- state: "error" as const,
125
- timed_out: false,
126
- },
127
- output: format({
128
- taskID: params.task_id,
129
- state: "error",
130
- text: `Task not found: ${params.task_id}`,
131
- }),
132
- }
133
- }
134
-
135
- const waited =
136
- params.wait === true
137
- ? yield* jobs.wait({ id: params.task_id, timeout: params.timeout_ms ?? DEFAULT_TIMEOUT })
138
- : { info: yield* jobs.get(params.task_id), timedOut: false }
139
- const inspected = waited.info
140
- ? {
141
- result: {
142
- state: waited.info.status,
143
- text:
144
- waited.info.output ??
145
- waited.info.error ??
146
- (waited.info.status === "running" ? "Task is still running." : ""),
147
- },
148
- timedOut: waited.timedOut,
149
- }
150
- : params.wait === true
151
- ? yield* waitForTerminal(params.task_id, params.timeout_ms ?? DEFAULT_TIMEOUT)
152
- : { result: yield* inspect(params.task_id), timedOut: false }
153
- const text = inspected.timedOut
154
- ? `Timed out after ${params.timeout_ms ?? DEFAULT_TIMEOUT}ms while waiting for task completion.`
155
- : inspected.result.text
156
-
157
- return {
158
- title: "Task status",
159
- metadata: {
160
- task_id: params.task_id,
161
- state: inspected.result.state,
162
- timed_out: inspected.timedOut,
163
- },
164
- output: format({
165
- taskID: params.task_id,
166
- state: inspected.result.state,
167
- text,
168
- }),
169
- }
170
- })
171
-
172
- return {
173
- description: DESCRIPTION,
174
- parameters: Parameters,
175
- execute: (params: Schema.Schema.Type<typeof Parameters>, ctx: Tool.Context) =>
176
- run(params, ctx).pipe(Effect.orDie),
177
- }
178
- }),
179
- )
1
+ import * as Tool from "./tool"
2
+ import DESCRIPTION from "./task_status.txt"
3
+ import { BackgroundJob } from "@/background/job"
4
+ import { Session } from "@/session/session"
5
+ import { MessageV2 } from "@/session/message-v2"
6
+ import { SessionID } from "@/session/schema"
7
+ import { SessionStatus } from "@/session/status"
8
+ import { PositiveInt } from "@opencode-ai/core/schema"
9
+ import { RuntimeFlags } from "@/effect/runtime-flags"
10
+ import { Effect, Option, Schema } from "effect"
11
+
12
+ const DEFAULT_TIMEOUT = 60_000
13
+ const POLL_MS = 300
14
+
15
+ const Parameters = Schema.Struct({
16
+ task_id: SessionID.annotate({ description: "The task_id returned by the task tool" }),
17
+ wait: Schema.optional(Schema.Boolean).annotate({
18
+ description: "When true, wait until the task reaches a terminal state or timeout",
19
+ }),
20
+ timeout_ms: Schema.optional(PositiveInt).annotate({
21
+ description: "Maximum milliseconds to wait when wait=true (default: 60000)",
22
+ }),
23
+ })
24
+
25
+ type State = BackgroundJob.Status
26
+ type InspectResult = { state: State; text: string }
27
+
28
+ function format(input: { taskID: SessionID; state: State; text: string }) {
29
+ const tag = input.state === "completed" || input.state === "running" ? "task_result" : "task_error"
30
+ return [`task_id: ${input.taskID}`, `state: ${input.state}`, "", `<${tag}>`, input.text, `</${tag}>`].join("\n")
31
+ }
32
+
33
+ function errorText(error: NonNullable<MessageV2.Assistant["error"]>) {
34
+ const data = Reflect.get(error, "data")
35
+ const message = data && typeof data === "object" ? Reflect.get(data, "message") : undefined
36
+ if (typeof message === "string" && message) return message
37
+ return error.name
38
+ }
39
+
40
+ function inspectMessage(message: MessageV2.WithParts): InspectResult | undefined {
41
+ if (message.info.role !== "assistant") return
42
+ const text = message.parts.findLast((part) => part.type === "text")?.text ?? ""
43
+ if (message.info.error) return { state: "error", text: text || errorText(message.info.error) }
44
+ if (message.info.finish && !["tool-calls", "unknown"].includes(message.info.finish))
45
+ return { state: "completed", text }
46
+ return { state: "running", text: text || "Task is still running." }
47
+ }
48
+
49
+ export const TaskStatusTool = Tool.define(
50
+ "task_status",
51
+ Effect.gen(function* () {
52
+ const jobs = yield* BackgroundJob.Service
53
+ const sessions = yield* Session.Service
54
+ const status = yield* SessionStatus.Service
55
+ const flags = yield* RuntimeFlags.Service
56
+
57
+ const inspect: (taskID: SessionID) => Effect.Effect<InspectResult> = Effect.fn("TaskStatusTool.inspect")(function* (
58
+ taskID: SessionID,
59
+ ) {
60
+ const job = yield* jobs.get(taskID)
61
+ if (job) {
62
+ return {
63
+ state: job.status,
64
+ text:
65
+ job.output ??
66
+ job.error ??
67
+ (job.status === "running"
68
+ ? "Task is still running."
69
+ : job.status === "cancelled"
70
+ ? "Task was cancelled."
71
+ : ""),
72
+ }
73
+ }
74
+
75
+ const current = yield* status.get(taskID)
76
+ if (current.type === "busy" || current.type === "retry") {
77
+ return {
78
+ state: "running",
79
+ text: current.type === "retry" ? `Task is retrying: ${current.message}` : "Task is still running.",
80
+ }
81
+ }
82
+
83
+ const latestAssistant = yield* sessions
84
+ .findMessage(taskID, (item) => item.info.role === "assistant")
85
+ .pipe(Effect.orDie)
86
+ if (Option.isSome(latestAssistant)) {
87
+ const latest = inspectMessage(latestAssistant.value)
88
+ if (!latest) return { state: "error", text: "Task is not running in this process." }
89
+ if (latest.state === "running")
90
+ return { state: "error", text: "Task is not running in this process and has no final output." }
91
+ return latest
92
+ }
93
+ return { state: "error", text: "Task is not running in this process and has not produced output." }
94
+ })
95
+
96
+ const waitForTerminal: (
97
+ taskID: SessionID,
98
+ timeout: number,
99
+ ) => Effect.Effect<{ result: InspectResult; timedOut: boolean }> = Effect.fn("TaskStatusTool.waitForTerminal")(
100
+ function* (taskID: SessionID, timeout: number) {
101
+ const result = yield* inspect(taskID)
102
+ if (result.state !== "running") return { result, timedOut: false }
103
+ if (timeout <= 0) return { result, timedOut: true }
104
+ const sleep = Math.min(POLL_MS, timeout)
105
+ yield* Effect.sleep(`${sleep} millis`)
106
+ return yield* waitForTerminal(taskID, timeout - sleep)
107
+ },
108
+ )
109
+
110
+ const run = Effect.fn("TaskStatusTool.execute")(function* (
111
+ params: Schema.Schema.Type<typeof Parameters>,
112
+ _ctx: Tool.Context,
113
+ ) {
114
+ if (!flags.experimentalBackgroundSubagents) {
115
+ return yield* Effect.fail(new Error("task_status requires OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true"))
116
+ }
117
+
118
+ const session = yield* sessions.get(params.task_id).pipe(Effect.catchCause(() => Effect.succeed(undefined)))
119
+ if (!session) {
120
+ return {
121
+ title: "Task status",
122
+ metadata: {
123
+ task_id: params.task_id,
124
+ state: "error" as const,
125
+ timed_out: false,
126
+ },
127
+ output: format({
128
+ taskID: params.task_id,
129
+ state: "error",
130
+ text: `Task not found: ${params.task_id}`,
131
+ }),
132
+ }
133
+ }
134
+
135
+ const waited =
136
+ params.wait === true
137
+ ? yield* jobs.wait({ id: params.task_id, timeout: params.timeout_ms ?? DEFAULT_TIMEOUT })
138
+ : { info: yield* jobs.get(params.task_id), timedOut: false }
139
+ const inspected = waited.info
140
+ ? {
141
+ result: {
142
+ state: waited.info.status,
143
+ text:
144
+ waited.info.output ??
145
+ waited.info.error ??
146
+ (waited.info.status === "running" ? "Task is still running." : ""),
147
+ },
148
+ timedOut: waited.timedOut,
149
+ }
150
+ : params.wait === true
151
+ ? yield* waitForTerminal(params.task_id, params.timeout_ms ?? DEFAULT_TIMEOUT)
152
+ : { result: yield* inspect(params.task_id), timedOut: false }
153
+ const text = inspected.timedOut
154
+ ? `Timed out after ${params.timeout_ms ?? DEFAULT_TIMEOUT}ms while waiting for task completion.`
155
+ : inspected.result.text
156
+
157
+ return {
158
+ title: "Task status",
159
+ metadata: {
160
+ task_id: params.task_id,
161
+ state: inspected.result.state,
162
+ timed_out: inspected.timedOut,
163
+ },
164
+ output: format({
165
+ taskID: params.task_id,
166
+ state: inspected.result.state,
167
+ text,
168
+ }),
169
+ }
170
+ })
171
+
172
+ return {
173
+ description: DESCRIPTION,
174
+ parameters: Parameters,
175
+ execute: (params: Schema.Schema.Type<typeof Parameters>, ctx: Tool.Context) =>
176
+ run(params, ctx).pipe(Effect.orDie),
177
+ }
178
+ }),
179
+ )
@@ -1,13 +1,13 @@
1
- Poll the status of a background subagent task launched with the task tool.
2
-
3
- Use this for tasks started with `task(background=true)`.
4
-
5
- Parameters:
6
- - `task_id` (required): the task session id returned by the task tool
7
- - `wait` (optional): when true, wait for completion
8
- - `timeout_ms` (optional): max wait duration in milliseconds when `wait=true`
9
-
10
- Returns compact, parseable output:
11
- - `task_id`
12
- - `state` (`running`, `completed`, `error`, or `cancelled`)
13
- - `<task_result>...</task_result>` or `<task_error>...</task_error>` containing final output, error summary, or current progress text
1
+ Poll the status of a background subagent task launched with the task tool.
2
+
3
+ Use this for tasks started with `task(background=true)`.
4
+
5
+ Parameters:
6
+ - `task_id` (required): the task session id returned by the task tool
7
+ - `wait` (optional): when true, wait for completion
8
+ - `timeout_ms` (optional): max wait duration in milliseconds when `wait=true`
9
+
10
+ Returns compact, parseable output:
11
+ - `task_id`
12
+ - `state` (`running`, `completed`, `error`, or `cancelled`)
13
+ - `<task_result>...</task_result>` or `<task_error>...</task_error>` containing final output, error summary, or current progress text
@@ -1,57 +1,57 @@
1
- import { Effect, Schema } from "effect"
2
- import * as Tool from "./tool"
3
- import DESCRIPTION_WRITE from "./todowrite.txt"
4
- import { Todo } from "../session/todo"
5
-
6
- // Todo.Info is still a zod schema (session/todo.ts). Inline the field shape
7
- // here rather than referencing its `.shape` — the LLM-visible JSON Schema is
8
- // identical, and it removes the last zod dependency from this tool.
9
- const TodoItem = Schema.Struct({
10
- content: Schema.String.annotate({ description: "Brief description of the task" }),
11
- status: Schema.String.annotate({
12
- description: "Current status of the task: pending, in_progress, completed, cancelled",
13
- }),
14
- priority: Schema.String.annotate({ description: "Priority level of the task: high, medium, low" }),
15
- })
16
-
17
- export const Parameters = Schema.Struct({
18
- todos: Schema.mutable(Schema.Array(TodoItem)).annotate({ description: "The updated todo list" }),
19
- })
20
-
21
- type Metadata = {
22
- todos: Todo.Info[]
23
- }
24
-
25
- export const TodoWriteTool = Tool.define<typeof Parameters, Metadata, Todo.Service>(
26
- "todowrite",
27
- Effect.gen(function* () {
28
- const todo = yield* Todo.Service
29
-
30
- return {
31
- description: DESCRIPTION_WRITE,
32
- parameters: Parameters,
33
- execute: (params: Schema.Schema.Type<typeof Parameters>, ctx: Tool.Context<Metadata>) =>
34
- Effect.gen(function* () {
35
- yield* ctx.ask({
36
- permission: "todowrite",
37
- patterns: ["*"],
38
- always: ["*"],
39
- metadata: {},
40
- })
41
-
42
- yield* todo.update({
43
- sessionID: ctx.sessionID,
44
- todos: params.todos,
45
- })
46
-
47
- return {
48
- title: `${params.todos.filter((x) => x.status !== "completed").length} todos`,
49
- output: JSON.stringify(params.todos, null, 2),
50
- metadata: {
51
- todos: params.todos,
52
- },
53
- }
54
- }),
55
- } satisfies Tool.DefWithoutID<typeof Parameters, Metadata>
56
- }),
57
- )
1
+ import { Effect, Schema } from "effect"
2
+ import * as Tool from "./tool"
3
+ import DESCRIPTION_WRITE from "./todowrite.txt"
4
+ import { Todo } from "../session/todo"
5
+
6
+ // Todo.Info is still a zod schema (session/todo.ts). Inline the field shape
7
+ // here rather than referencing its `.shape` — the LLM-visible JSON Schema is
8
+ // identical, and it removes the last zod dependency from this tool.
9
+ const TodoItem = Schema.Struct({
10
+ content: Schema.String.annotate({ description: "Brief description of the task" }),
11
+ status: Schema.String.annotate({
12
+ description: "Current status of the task: pending, in_progress, completed, cancelled",
13
+ }),
14
+ priority: Schema.String.annotate({ description: "Priority level of the task: high, medium, low" }),
15
+ })
16
+
17
+ export const Parameters = Schema.Struct({
18
+ todos: Schema.mutable(Schema.Array(TodoItem)).annotate({ description: "The updated todo list" }),
19
+ })
20
+
21
+ type Metadata = {
22
+ todos: Todo.Info[]
23
+ }
24
+
25
+ export const TodoWriteTool = Tool.define<typeof Parameters, Metadata, Todo.Service>(
26
+ "todowrite",
27
+ Effect.gen(function* () {
28
+ const todo = yield* Todo.Service
29
+
30
+ return {
31
+ description: DESCRIPTION_WRITE,
32
+ parameters: Parameters,
33
+ execute: (params: Schema.Schema.Type<typeof Parameters>, ctx: Tool.Context<Metadata>) =>
34
+ Effect.gen(function* () {
35
+ yield* ctx.ask({
36
+ permission: "todowrite",
37
+ patterns: ["*"],
38
+ always: ["*"],
39
+ metadata: {},
40
+ })
41
+
42
+ yield* todo.update({
43
+ sessionID: ctx.sessionID,
44
+ todos: params.todos,
45
+ })
46
+
47
+ return {
48
+ title: `${params.todos.filter((x) => x.status !== "completed").length} todos`,
49
+ output: JSON.stringify(params.todos, null, 2),
50
+ metadata: {
51
+ todos: params.todos,
52
+ },
53
+ }
54
+ }),
55
+ } satisfies Tool.DefWithoutID<typeof Parameters, Metadata>
56
+ }),
57
+ )