@grok/agent-sdk 0.2.28 → 0.2.29

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 (339) hide show
  1. package/AGENTS.md +29 -29
  2. package/dist/bin/agent-serve.d.ts +2 -2
  3. package/dist/bin/agent-serve.js +3 -3
  4. package/dist/channels/pagerduty/api.js +1 -1
  5. package/dist/channels/pagerduty/pagerduty-channel.d.ts +1 -1
  6. package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -1
  7. package/dist/channels/pagerduty/pagerduty-channel.js +1 -1
  8. package/dist/channels/pagerduty/replay.d.ts +1 -1
  9. package/dist/channels/pagerduty/replay.js +4 -4
  10. package/dist/docs/404.html +2 -2
  11. package/dist/docs/assets/{app.DF9vlcdn.js → app.DMrZKFjI.js} +4 -4
  12. package/dist/docs/assets/changelog.md.DrLFQUlu.js +1 -0
  13. package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +1 -0
  14. package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +1 -0
  15. package/dist/docs/assets/chunks/{VPLocalSearchBox.D8OuwKO0.js → VPLocalSearchBox.DQvuw1KA.js} +1 -1
  16. package/dist/docs/assets/chunks/{arc.DCq_TCYV.js → arc.ahOG-Qza.js} +1 -1
  17. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.PWRNTPbk.js → architectureDiagram-Q4EWVU46.BcgfYNO_.js} +1 -1
  18. package/dist/docs/assets/chunks/{baseUniq.BeRPvRUL.js → baseUniq.DeIYZrWh.js} +1 -1
  19. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BuRmZVSo.js → blockDiagram-DXYQGD6D.HjJ2goMX.js} +1 -1
  20. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.7DKSMwuv.js → c4Diagram-AHTNJAMY.C1QTb9GM.js} +1 -1
  21. package/dist/docs/assets/chunks/channel._fZX_hvU.js +1 -0
  22. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.7VrO9-9i.js → chunk-4BX2VUAB.UuZiDiVp.js} +1 -1
  23. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.CHystNE2.js → chunk-4TB4RGXK.5A3YmkhI.js} +1 -1
  24. package/dist/docs/assets/chunks/{chunk-55IACEB6.Nuh9TbTq.js → chunk-55IACEB6.B4uf1yYV.js} +1 -1
  25. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CA0EKugm.js → chunk-EDXVE4YY.CoXBce8t.js} +1 -1
  26. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.F9_mp7U8.js → chunk-FMBD7UC4.DnC5NO4e.js} +1 -1
  27. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CEU4QfE1.js → chunk-OYMX7WX6.CzfHCeIi.js} +1 -1
  28. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B8h_x9_i.js → chunk-QZHKN3VN.C6tcwkVd.js} +1 -1
  29. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Btfb-rKg.js → chunk-YZCP3GAM._oboyZ1A.js} +1 -1
  30. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +1 -0
  31. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +1 -0
  32. package/dist/docs/assets/chunks/clone.W1Phdw9P.js +1 -0
  33. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DKvc96Wa.js → cose-bilkent-S5V4N54A.BfPVKeId.js} +1 -1
  34. package/dist/docs/assets/chunks/{dagre-KV5264BT.CMo0cy1b.js → dagre-KV5264BT.CLMLc0lD.js} +1 -1
  35. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DDgMOQhB.js → diagram-5BDNPKRD.C7OF7UfH.js} +1 -1
  36. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BdJnoIsU.js → diagram-G4DWMVQ6.Dpao0Bl1.js} +1 -1
  37. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.oSvhAZaL.js → diagram-MMDJMWI5.DLnM9eLp.js} +1 -1
  38. package/dist/docs/assets/chunks/{diagram-TYMM5635.C9zZLIE-.js → diagram-TYMM5635.BcpVgA_M.js} +1 -1
  39. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.BNhVyccy.js → erDiagram-SMLLAGMA.CsL5JuCV.js} +1 -1
  40. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BEFLLBiU.js → flowDiagram-DWJPFMVM.MFihq9AF.js} +1 -1
  41. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BdUzXBgY.js → ganttDiagram-T4ZO3ILL.CJeLodyG.js} +1 -1
  42. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.Rd3LlOIJ.js → gitGraphDiagram-UUTBAWPF.1HhlE45Z.js} +1 -1
  43. package/dist/docs/assets/chunks/{graph.DnJC1GpG.js → graph.BS02KkWA.js} +1 -1
  44. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.xv0xntDJ.js → infoDiagram-42DDH7IO.fp5gvytQ.js} +1 -1
  45. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.BaGIlviU.js → ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js} +1 -1
  46. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cof_h0fp.js → journeyDiagram-VCZTEJTY.qJt4uJ_H.js} +1 -1
  47. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.C5GozFuU.js → kanban-definition-6JOO6SKY.z2tG9kly.js} +1 -1
  48. package/dist/docs/assets/chunks/{layout.zc9UShLc.js → layout.BPCkdejr.js} +1 -1
  49. package/dist/docs/assets/chunks/{linear.BoqrFVcJ.js → linear.CL3TC3u7.js} +1 -1
  50. package/dist/docs/assets/chunks/{min.DwIfr8hG.js → min.SPrSp704.js} +1 -1
  51. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.Dkq2yTtp.js → mindmap-definition-QFDTVHPH.DgrQRFZW.js} +1 -1
  52. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.B4CpTmHK.js → pieDiagram-DEJITSTG.Ba7yxiW2.js} +1 -1
  53. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BqXnFC9C.js → quadrantDiagram-34T5L4WZ.Bvskad4p.js} +1 -1
  54. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DhIN2z-E.js → requirementDiagram-MS252O5E.Ce70ugV9.js} +1 -1
  55. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BhxUAmg2.js → sankeyDiagram-XADWPNL6.BJ5OEULO.js} +1 -1
  56. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BqgU7HU-.js → sequenceDiagram-FGHM5R23.C8a1hDs6.js} +1 -1
  57. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B1BCO18N.js → stateDiagram-FHFEXIEX.D2D8A5CK.js} +1 -1
  58. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +1 -0
  59. package/dist/docs/assets/chunks/{theme.oV7rddEz.js → theme.DRciHmS1.js} +2 -2
  60. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.oRI8UwMC.js → timeline-definition-GMOUNBTQ.C4ePrY8-.js} +1 -1
  61. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.DmuWrIxN.js → vennDiagram-DHZGUBPP.Dzso6dEA.js} +1 -1
  62. package/dist/docs/assets/chunks/{wardley-RL74JXVD.CEBjM5ov.js → wardley-RL74JXVD.djgXR0ar.js} +1 -1
  63. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.m5zsCOF9.js → wardleyDiagram-NUSXRM2D.Bf2ICxjh.js} +1 -1
  64. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.cPN-587n.js → xychartDiagram-5P7HB3ND.DEH4BcVJ.js} +1 -1
  65. package/dist/docs/assets/{deployment.md.DDmjAVbg.js → deployment.md.KW0Ni_rY.js} +5 -5
  66. package/dist/docs/assets/{evals.md.OjKb7tNA.js → evals.md.DiljU__Z.js} +1 -1
  67. package/dist/docs/assets/{guides_jev.md.Ccw4pedT.js → guides_jev.md.CEqLgjj9.js} +2 -2
  68. package/dist/docs/assets/{guides_jev.md.Ccw4pedT.lean.js → guides_jev.md.CEqLgjj9.lean.js} +1 -1
  69. package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.js → guides_mcp-oauth.md.DrGY92u4.js} +1 -1
  70. package/dist/docs/assets/{guides_slack.md.BqiGSYGX.js → guides_slack.md.BwXHURvY.js} +1 -1
  71. package/dist/docs/assets/index.md.CAruw_rp.js +26 -0
  72. package/dist/docs/assets/{index.md.CVRjO09Y.lean.js → index.md.CAruw_rp.lean.js} +1 -1
  73. package/dist/docs/assets/{quickstart.md.DaLk4ZIF.js → quickstart.md.CljDaJBi.js} +3 -3
  74. package/dist/docs/assets/{quickstart.md.DaLk4ZIF.lean.js → quickstart.md.CljDaJBi.lean.js} +1 -1
  75. package/dist/docs/assets/reference_access.md.CEtibb4i.js +1 -0
  76. package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +1 -0
  77. package/dist/docs/assets/{reference_agent-config.md.11E_xe--.js → reference_agent-config.md.Ck29qYNj.js} +1 -1
  78. package/dist/docs/assets/{reference_cli.md.DQ3dCgmk.js → reference_cli.md.BkdLRbXg.js} +5 -5
  79. package/dist/docs/assets/{reference_evals.md.DYKjGFi-.js → reference_evals.md.2BXeMiO2.js} +23 -3
  80. package/dist/docs/assets/{reference_evals.md.DYKjGFi-.lean.js → reference_evals.md.2BXeMiO2.lean.js} +1 -1
  81. package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.js → reference_extensions.md.DI5X5x8p.js} +1 -1
  82. package/dist/docs/assets/{reference_limits.md.Da1HegjB.js → reference_limits.md.BCCnvt3o.js} +2 -2
  83. package/dist/docs/assets/{reference_limits.md.Da1HegjB.lean.js → reference_limits.md.BCCnvt3o.lean.js} +1 -1
  84. package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +1 -0
  85. package/dist/docs/building-with-agents.html +35 -35
  86. package/dist/docs/building-with-agents.md +5 -5
  87. package/dist/docs/changelog.html +36 -36
  88. package/dist/docs/changelog.md +10 -0
  89. package/dist/docs/deployment.html +41 -41
  90. package/dist/docs/deployment.md +8 -8
  91. package/dist/docs/evals.html +37 -37
  92. package/dist/docs/evals.md +4 -2
  93. package/dist/docs/guides/agent-to-agent.html +35 -35
  94. package/dist/docs/guides/bitbucket.html +35 -35
  95. package/dist/docs/guides/cloud-agents.html +36 -36
  96. package/dist/docs/guides/convert-automation.html +35 -35
  97. package/dist/docs/guides/github.html +35 -35
  98. package/dist/docs/guides/github.md +1 -1
  99. package/dist/docs/guides/gitlab.html +35 -35
  100. package/dist/docs/guides/hooks.html +35 -35
  101. package/dist/docs/guides/improve.html +36 -36
  102. package/dist/docs/guides/jev.html +36 -36
  103. package/dist/docs/guides/jev.md +5 -0
  104. package/dist/docs/guides/mcp-oauth.html +37 -37
  105. package/dist/docs/guides/mcp-oauth.md +2 -3
  106. package/dist/docs/guides/migrate.html +35 -35
  107. package/dist/docs/guides/migrate.md +2 -2
  108. package/dist/docs/guides/opentelemetry.html +35 -35
  109. package/dist/docs/guides/pagerduty.html +35 -35
  110. package/dist/docs/guides/slack.html +37 -37
  111. package/dist/docs/guides/slack.md +5 -6
  112. package/dist/docs/guides/webhooks.html +35 -35
  113. package/dist/docs/hashmap.json +1 -1
  114. package/dist/docs/hillclimbing.html +35 -35
  115. package/dist/docs/hillclimbing.md +2 -2
  116. package/dist/docs/index.html +51 -52
  117. package/dist/docs/index.md +17 -16
  118. package/dist/docs/llms-full.txt +120 -199
  119. package/dist/docs/llms.txt +0 -1
  120. package/dist/docs/package/skills/create-agent/SKILL.md +178 -0
  121. package/dist/docs/package/skills/evals/SKILL.md +145 -0
  122. package/dist/docs/package/skills/github/SKILL.md +133 -0
  123. package/dist/docs/package/skills/hillclimb/SKILL.md +63 -0
  124. package/dist/docs/package/skills/mcp-auth/SKILL.md +60 -0
  125. package/dist/docs/package/skills/migrate-v2/SKILL.md +394 -0
  126. package/dist/docs/package/skills/setup-slack/SKILL.md +136 -0
  127. package/dist/docs/quickstart.html +38 -38
  128. package/dist/docs/quickstart.md +5 -1
  129. package/dist/docs/reference/access.html +36 -36
  130. package/dist/docs/reference/access.md +3 -3
  131. package/dist/docs/reference/agent-config.html +37 -37
  132. package/dist/docs/reference/agent-config.md +1 -1
  133. package/dist/docs/reference/artifacts.html +35 -35
  134. package/dist/docs/reference/channels.html +35 -35
  135. package/dist/docs/reference/cli.html +41 -41
  136. package/dist/docs/reference/cli.md +6 -6
  137. package/dist/docs/reference/connections.html +35 -35
  138. package/dist/docs/reference/connections.md +1 -1
  139. package/dist/docs/reference/evals.html +57 -37
  140. package/dist/docs/reference/evals.md +35 -0
  141. package/dist/docs/reference/extensions.html +37 -37
  142. package/dist/docs/reference/extensions.md +2 -2
  143. package/dist/docs/reference/hooks.html +35 -35
  144. package/dist/docs/reference/http-api.html +35 -35
  145. package/dist/docs/reference/instructions.html +35 -35
  146. package/dist/docs/reference/limits.html +37 -37
  147. package/dist/docs/reference/limits.md +2 -2
  148. package/dist/docs/reference/memory.html +35 -35
  149. package/dist/docs/reference/playground.html +35 -35
  150. package/dist/docs/reference/project-layout.html +35 -35
  151. package/dist/docs/reference/prompt.html +35 -35
  152. package/dist/docs/reference/schedules.html +35 -35
  153. package/dist/docs/reference/sessions.html +35 -35
  154. package/dist/docs/reference/skills.html +35 -35
  155. package/dist/docs/reference/subagents.html +35 -35
  156. package/dist/docs/reference/tools.html +35 -35
  157. package/dist/docs/templates/agentic-owners.html +35 -35
  158. package/dist/docs/templates/security-reviewer.html +35 -35
  159. package/dist/docs/templates/thermo-quality-review.html +35 -35
  160. package/dist/docs/templates/thermo-review.html +35 -35
  161. package/dist/docs/templates/triage.html +35 -35
  162. package/dist/docs/troubleshooting.html +36 -36
  163. package/dist/docs/troubleshooting.md +4 -4
  164. package/dist/evals.d.ts +2 -2
  165. package/dist/extensions/jev/extension.d.ts +12 -2
  166. package/dist/extensions/jev/extension.d.ts.map +1 -1
  167. package/dist/extensions/jev/extension.js +4 -0
  168. package/dist/extensions/jev/lib/evaluate.d.ts +31 -4
  169. package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
  170. package/dist/extensions/jev/lib/evaluate.js +18 -4
  171. package/dist/internal/cli/command.d.ts +1 -1
  172. package/dist/internal/cli/command.js +1 -1
  173. package/dist/internal/cli/commands/channels.js +6 -6
  174. package/dist/internal/cli/commands/develop.d.ts.map +1 -1
  175. package/dist/internal/cli/commands/develop.js +23 -14
  176. package/dist/internal/cli/commands/hosted.js +4 -4
  177. package/dist/internal/cli/commands/index.d.ts +1 -1
  178. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  179. package/dist/internal/cli/commands/index.js +1 -1
  180. package/dist/internal/cli/commands/mcp.js +1 -1
  181. package/dist/internal/cli/commands/project.js +4 -4
  182. package/dist/internal/cli/commands/scaffold.d.ts.map +1 -1
  183. package/dist/internal/cli/commands/scaffold.js +9 -6
  184. package/dist/internal/cli/commands/serve.d.ts +1 -1
  185. package/dist/internal/cli/commands/serve.js +5 -5
  186. package/dist/internal/cli/commands/session.d.ts.map +1 -1
  187. package/dist/internal/cli/commands/session.js +12 -7
  188. package/dist/internal/cli/dispatch.d.ts +3 -3
  189. package/dist/internal/cli/dispatch.js +3 -3
  190. package/dist/internal/cli/errors.d.ts +1 -1
  191. package/dist/internal/cli/errors.d.ts.map +1 -1
  192. package/dist/internal/cli/errors.js +1 -1
  193. package/dist/internal/cli/flags.d.ts +2 -2
  194. package/dist/internal/cli/flags.d.ts.map +1 -1
  195. package/dist/internal/cli/flags.js +2 -2
  196. package/dist/internal/cli/help-command.d.ts +1 -1
  197. package/dist/internal/cli/help-command.js +2 -2
  198. package/dist/internal/cli/help.d.ts +7 -7
  199. package/dist/internal/cli/help.d.ts.map +1 -1
  200. package/dist/internal/cli/help.js +8 -8
  201. package/dist/internal/cli-ax.d.ts.map +1 -1
  202. package/dist/internal/cli-ax.js +3 -0
  203. package/dist/internal/cli-convert-automation.d.ts +1 -1
  204. package/dist/internal/cli-convert-automation.js +1 -1
  205. package/dist/internal/cli-migrate.d.ts +1 -1
  206. package/dist/internal/cli-migrate.js +1 -1
  207. package/dist/internal/cli-pagerduty.d.ts +1 -1
  208. package/dist/internal/cli-pagerduty.js +1 -1
  209. package/dist/internal/convert-automation/types.d.ts +1 -1
  210. package/dist/internal/convert-automation/types.js +1 -1
  211. package/dist/internal/deploy-client.d.ts +2 -2
  212. package/dist/internal/deploy-client.d.ts.map +1 -1
  213. package/dist/internal/init-project.d.ts +7 -3
  214. package/dist/internal/init-project.d.ts.map +1 -1
  215. package/dist/internal/init-project.js +53 -7
  216. package/dist/internal/init-scaffold.d.ts +2 -1
  217. package/dist/internal/init-scaffold.d.ts.map +1 -1
  218. package/dist/internal/init-scaffold.js +20 -7
  219. package/dist/internal/peer-connections.js +1 -1
  220. package/dist/internal/server.d.ts +1 -1
  221. package/dist/internal/session-cost.d.ts +4 -4
  222. package/dist/internal/session-cost.d.ts.map +1 -1
  223. package/dist/internal/session-cost.js +4 -4
  224. package/dist/internal/session-engine.d.ts +1 -1
  225. package/dist/internal/session-engine.js +1 -1
  226. package/dist/playground/assets/{index-_3zz3yh8.js → index-Cl9zvmmf.js} +40 -40
  227. package/dist/playground/assets/index-F8b5WvWi.css +1 -0
  228. package/dist/playground/index.html +2 -2
  229. package/dist/types.d.ts +5 -5
  230. package/docs/README.md +17 -16
  231. package/docs/changelog.md +10 -0
  232. package/docs/deployment.md +8 -8
  233. package/docs/evals.md +3 -1
  234. package/docs/guides/jev.md +5 -0
  235. package/docs/guides/mcp-oauth.md +1 -2
  236. package/docs/guides/slack.md +3 -4
  237. package/docs/quickstart.md +5 -1
  238. package/docs/reference/access.md +3 -3
  239. package/docs/reference/agent-config.md +1 -1
  240. package/docs/reference/cli.md +6 -6
  241. package/docs/reference/evals.md +35 -0
  242. package/docs/reference/extensions.md +2 -2
  243. package/docs/reference/limits.md +2 -2
  244. package/docs/troubleshooting.md +4 -4
  245. package/package.json +2 -8
  246. package/skills/cli/SKILL.md +15 -15
  247. package/skills/create-agent/SKILL.md +20 -19
  248. package/skills/debug/SKILL.md +4 -4
  249. package/skills/deploy/SKILL.md +2 -2
  250. package/skills/evals/SKILL.md +8 -8
  251. package/skills/framework-map/SKILL.md +3 -3
  252. package/skills/github/SKILL.md +7 -7
  253. package/skills/hillclimb/SKILL.md +4 -4
  254. package/skills/mcp-auth/SKILL.md +3 -3
  255. package/skills/migrate-v2/SKILL.md +40 -40
  256. package/skills/otel/SKILL.md +2 -2
  257. package/skills/setup-slack/SKILL.md +8 -8
  258. package/templates/agentic-owners/README.md +5 -5
  259. package/templates/agentic-owners/bot/tools/record_review.ts +1 -1
  260. package/templates/agentic-owners/package.json +1 -1
  261. package/templates/agents-md/README.md +4 -4
  262. package/templates/agents-md/package.json +1 -1
  263. package/templates/code-wiki/README.md +3 -3
  264. package/templates/code-wiki/package.json +1 -1
  265. package/templates/demo/README.md +3 -3
  266. package/templates/demo/package.json +1 -1
  267. package/templates/pr-autofixer/package.json +1 -1
  268. package/templates/security-help/README.md +5 -5
  269. package/templates/security-help/package.json +1 -1
  270. package/templates/security-reviewer/README.md +3 -3
  271. package/templates/security-reviewer/package.json +1 -1
  272. package/templates/thermo-quality-review/README.md +4 -4
  273. package/templates/thermo-quality-review/package.json +1 -1
  274. package/templates/thermo-review/README.md +4 -4
  275. package/templates/thermo-review/package.json +1 -1
  276. package/templates/triage/README.md +3 -3
  277. package/templates/triage/overlays/jira/README.md +3 -3
  278. package/templates/triage/overlays/linear/README.md +3 -3
  279. package/templates/triage/package.json +1 -1
  280. package/dist/docs/assets/changelog.md.fZ-NNFeJ.js +0 -1
  281. package/dist/docs/assets/changelog.md.fZ-NNFeJ.lean.js +0 -1
  282. package/dist/docs/assets/chunks/@localSearchIndexroot.mfzjiOsL.js +0 -1
  283. package/dist/docs/assets/chunks/channel.goFR5lbe.js +0 -1
  284. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.B2yLtFja.js +0 -1
  285. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.B2yLtFja.js +0 -1
  286. package/dist/docs/assets/chunks/clone.CztV97Wu.js +0 -1
  287. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CZlVHdDZ.js +0 -1
  288. package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.js +0 -15
  289. package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.lean.js +0 -1
  290. package/dist/docs/assets/index.md.CVRjO09Y.js +0 -27
  291. package/dist/docs/assets/reference_access.md.CExlH_mR.js +0 -1
  292. package/dist/docs/assets/reference_access.md.CExlH_mR.lean.js +0 -1
  293. package/dist/docs/assets/troubleshooting.md.AGJ3jDzj.js +0 -1
  294. package/dist/docs/guides/grokbot-agents.html +0 -74
  295. package/dist/docs/guides/grokbot-agents.md +0 -129
  296. package/dist/extensions/cursor-grokbot-agents/extension.d.ts +0 -71
  297. package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +0 -1
  298. package/dist/extensions/cursor-grokbot-agents/extension.js +0 -64
  299. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +0 -11
  300. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +0 -1
  301. package/dist/extensions/cursor-grokbot-agents/lib/agents.js +0 -31
  302. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +0 -56
  303. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +0 -1
  304. package/dist/extensions/cursor-grokbot-agents/lib/backend.js +0 -139
  305. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +0 -28
  306. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +0 -1
  307. package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +0 -46
  308. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +0 -53
  309. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +0 -1
  310. package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +0 -186
  311. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +0 -4
  312. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +0 -1
  313. package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +0 -15
  314. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +0 -12
  315. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +0 -1
  316. package/dist/extensions/cursor-grokbot-agents/lib/lock.js +0 -24
  317. package/dist/extensions/cursor-grokbot-agents/skills/consult.md +0 -40
  318. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +0 -4
  319. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +0 -1
  320. package/dist/extensions/cursor-grokbot-agents/tools/ask.js +0 -26
  321. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +0 -4
  322. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +0 -1
  323. package/dist/extensions/cursor-grokbot-agents/tools/check.js +0 -21
  324. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +0 -4
  325. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +0 -1
  326. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +0 -13
  327. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +0 -4
  328. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +0 -1
  329. package/dist/extensions/cursor-grokbot-agents/tools/list.js +0 -22
  330. package/dist/playground/assets/index-BMpVzZzC.css +0 -1
  331. package/docs/guides/grokbot-agents.md +0 -134
  332. /package/dist/docs/assets/{deployment.md.DDmjAVbg.lean.js → deployment.md.KW0Ni_rY.lean.js} +0 -0
  333. /package/dist/docs/assets/{evals.md.OjKb7tNA.lean.js → evals.md.DiljU__Z.lean.js} +0 -0
  334. /package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.lean.js → guides_mcp-oauth.md.DrGY92u4.lean.js} +0 -0
  335. /package/dist/docs/assets/{guides_slack.md.BqiGSYGX.lean.js → guides_slack.md.BwXHURvY.lean.js} +0 -0
  336. /package/dist/docs/assets/{reference_agent-config.md.11E_xe--.lean.js → reference_agent-config.md.Ck29qYNj.lean.js} +0 -0
  337. /package/dist/docs/assets/{reference_cli.md.DQ3dCgmk.lean.js → reference_cli.md.BkdLRbXg.lean.js} +0 -0
  338. /package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.lean.js → reference_extensions.md.DI5X5x8p.lean.js} +0 -0
  339. /package/dist/docs/assets/{troubleshooting.md.AGJ3jDzj.lean.js → troubleshooting.md.CGOdNVAL.lean.js} +0 -0
@@ -36,15 +36,23 @@
36
36
  * Auth is `TYPESAFE_API_KEY`. `model` is a TypeSafe id (`jev-latest` by
37
37
  * default).
38
38
  */
39
- /** TypeSafe model used when {@link EvaluateArgs.model} is omitted. */
39
+ /**
40
+ * TypeSafe model used when {@link EvaluateArgs.model} is omitted.
41
+ * @experimental
42
+ */
40
43
  export declare const DEFAULT_EVALUATION_MODEL = "jev-latest";
41
- /** Default bar for {@link needsHuman} when the caller does not pass one. */
44
+ /**
45
+ * Default bar for {@link needsHuman} when the caller does not pass one.
46
+ * @experimental
47
+ */
42
48
  export declare const DEFAULT_HUMAN_THRESHOLD = 0.7;
43
49
  /** Host behind the default base URL. */
44
50
  export declare const DEFAULT_TYPESAFE_HOST: string;
45
51
  /** Environment variable holding the TypeSafe key when a call passes no `apiKey`. */
46
52
  export declare const TYPESAFE_API_KEY_ENV = "TYPESAFE_API_KEY";
53
+ /** @experimental */
47
54
  export type EvaluationState = string | Record<string, unknown> | readonly unknown[];
55
+ /** @experimental */
48
56
  export type BooleanQuestion = {
49
57
  type: "boolean";
50
58
  instructions: string;
@@ -52,22 +60,28 @@ export type BooleanQuestion = {
52
60
  export type ChoiceCriterion = string | readonly string[] | {
53
61
  includes: readonly string[];
54
62
  } | null;
63
+ /** @experimental */
55
64
  export type ChoiceQuestion<C extends Record<string, ChoiceCriterion> = Record<string, ChoiceCriterion>> = {
56
65
  type: "choice";
57
66
  instructions: string;
58
67
  criteria: C;
59
68
  };
69
+ /** @experimental */
60
70
  export type ScoreQuestion = {
61
71
  type: "score";
62
72
  instructions: string;
63
73
  criteria: readonly string[];
64
74
  };
75
+ /** @experimental */
65
76
  export type EvaluationQuestion = BooleanQuestion | ChoiceQuestion | ScoreQuestion;
77
+ /** @experimental */
66
78
  export type QuestionMap = Record<string, EvaluationQuestion>;
79
+ /** @experimental */
67
80
  export type BooleanAnswer = {
68
81
  type: "boolean";
69
82
  probability: number;
70
83
  };
84
+ /** @experimental */
71
85
  export type ChoiceAnswer<C extends Record<string, unknown> = Record<string, unknown>> = {
72
86
  type: "choice";
73
87
  choice: keyof C & string;
@@ -75,19 +89,24 @@ export type ChoiceAnswer<C extends Record<string, unknown> = Record<string, unkn
75
89
  [K in keyof C]: number;
76
90
  };
77
91
  };
92
+ /** @experimental */
78
93
  export type ScoreAnswer = {
79
94
  type: "score";
80
95
  score: number;
81
96
  probabilities: Record<string, number>;
82
97
  };
98
+ /** @experimental */
83
99
  export type EvaluationAnswer = BooleanAnswer | ChoiceAnswer | ScoreAnswer;
84
100
  export type AnswerFor<Q> = Q extends BooleanQuestion ? BooleanAnswer : Q extends ChoiceQuestion<infer C> ? ChoiceAnswer<C> : Q extends ScoreQuestion ? ScoreAnswer : never;
101
+ /** @experimental */
85
102
  export type AnswersFor<Q extends QuestionMap> = {
86
103
  [K in keyof Q]: AnswerFor<Q[K]>;
87
104
  };
105
+ /** @experimental */
88
106
  export type EvaluateResult<Q extends QuestionMap = QuestionMap> = {
89
107
  answers: AnswersFor<Q>;
90
108
  };
109
+ /** @experimental */
91
110
  export type EvaluateArgs<Q extends QuestionMap = QuestionMap> = {
92
111
  model?: string;
93
112
  state: EvaluationState;
@@ -96,10 +115,18 @@ export type EvaluateArgs<Q extends QuestionMap = QuestionMap> = {
96
115
  baseUrl?: string;
97
116
  fetch?: typeof globalThis.fetch;
98
117
  };
99
- /** Ask Jev for typed answers over one state. */
118
+ /**
119
+ * Ask Jev for typed answers over one state.
120
+ * @experimental
121
+ */
100
122
  export declare function evaluate<const Q extends QuestionMap>(args: EvaluateArgs<Q>): Promise<EvaluateResult<Q>>;
101
- /** Same as {@link evaluate}, returning only `answers`. */
123
+ /**
124
+ * Same as {@link evaluate}, returning only `answers`.
125
+ * @experimental
126
+ */
102
127
  export declare function decide<const Q extends QuestionMap>(args: EvaluateArgs<Q>): Promise<AnswersFor<Q>>;
128
+ /** @experimental */
103
129
  export declare function above(answer: BooleanAnswer | ScoreAnswer, threshold: number): boolean;
130
+ /** @experimental */
104
131
  export declare function needsHuman(answer: BooleanAnswer | ChoiceAnswer, threshold?: number): boolean;
105
132
  //# sourceMappingURL=evaluate.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../../src/extensions/jev/lib/evaluate.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../../src/extensions/jev/lib/evaluate.ts"],"names":[],"mappings":"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"}
@@ -37,9 +37,15 @@
37
37
  * default).
38
38
  */
39
39
  import { isRecord } from "../../../internal/is-record.js";
40
- /** TypeSafe model used when {@link EvaluateArgs.model} is omitted. */
40
+ /**
41
+ * TypeSafe model used when {@link EvaluateArgs.model} is omitted.
42
+ * @experimental
43
+ */
41
44
  export const DEFAULT_EVALUATION_MODEL = "jev-latest";
42
- /** Default bar for {@link needsHuman} when the caller does not pass one. */
45
+ /**
46
+ * Default bar for {@link needsHuman} when the caller does not pass one.
47
+ * @experimental
48
+ */
43
49
  export const DEFAULT_HUMAN_THRESHOLD = 0.7;
44
50
  const DEFAULT_BASE_URL = "https://api.typesafe.ai/v1";
45
51
  /** Host behind the default base URL. */
@@ -125,7 +131,10 @@ async function postSystemOne(args) {
125
131
  }
126
132
  return asRecord(asRecord(parsed, "response is not an object").answers, "response is missing answers");
127
133
  }
128
- /** Ask Jev for typed answers over one state. */
134
+ /**
135
+ * Ask Jev for typed answers over one state.
136
+ * @experimental
137
+ */
129
138
  export async function evaluate(args) {
130
139
  const questions = {};
131
140
  for (const [id, question] of Object.entries(args.questions)) {
@@ -154,17 +163,22 @@ export async function evaluate(args) {
154
163
  answers: answers,
155
164
  };
156
165
  }
157
- /** Same as {@link evaluate}, returning only `answers`. */
166
+ /**
167
+ * Same as {@link evaluate}, returning only `answers`.
168
+ * @experimental
169
+ */
158
170
  export async function decide(args) {
159
171
  const result = await evaluate(args);
160
172
  return result.answers;
161
173
  }
174
+ /** @experimental */
162
175
  export function above(answer, threshold) {
163
176
  if (answer.type === "boolean") {
164
177
  return answer.probability >= threshold;
165
178
  }
166
179
  return answer.score >= threshold;
167
180
  }
181
+ /** @experimental */
168
182
  export function needsHuman(answer, threshold = DEFAULT_HUMAN_THRESHOLD) {
169
183
  if (answer.type === "boolean") {
170
184
  return answer.probability < threshold;
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * One declarative table of CLI commands. Each command owns its flags, so
3
3
  * parsing rejects a flag that belongs to another command, `--help` works on
4
- * every command, and `bdk help --json` prints the same table for agents.
4
+ * every command, and `agent-sdk help --json` prints the same table for agents.
5
5
  */
6
6
  import type { ParseArgsOptionDescriptor, parseArgs } from "node:util";
7
7
  import type { ValueKind } from "./value-kinds.js";
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * One declarative table of CLI commands. Each command owns its flags, so
3
3
  * parsing rejects a flag that belongs to another command, `--help` works on
4
- * every command, and `bdk help --json` prints the same table for agents.
4
+ * every command, and `agent-sdk help --json` prints the same table for agents.
5
5
  */
6
6
  /**
7
7
  * The index of the first positional argument in `rest`, or -1. Skips the
@@ -79,7 +79,7 @@ function forgeReplay(values) {
79
79
  out: values["fixtures-dir"] ?? values.out,
80
80
  };
81
81
  }
82
- const servingNote = "Needs the agent already serving (`bdk dev` or `bdk serve --dev`).";
82
+ const servingNote = "Needs the agent already serving (`agent-sdk dev` or `agent-sdk serve --dev`).";
83
83
  // ---------------------------------------------------------------- GitHub --
84
84
  export const githubForwardCommand = defineCommand({
85
85
  name: "github forward",
@@ -140,7 +140,7 @@ posts them to the matching channels. ${servingNote}`,
140
140
  context: { type: "string", value: "<context>", description: "Commit-status context." },
141
141
  },
142
142
  effect: "write",
143
- examples: ["bdk github replay https://github.com/o/r/pull/12 --events '*' --dry-run"],
143
+ examples: ["agent-sdk github replay https://github.com/o/r/pull/12 --events '*' --dry-run"],
144
144
  async run({ values, positionals }) {
145
145
  const { cmdGithub } = await import("../../cli-github.js");
146
146
  return cmdGithub("replay", {
@@ -369,9 +369,9 @@ export const slackCreateCommand = defineCommand({
369
369
  summary: "Create a dedicated Socket Mode Slack app through the Cursor dashboard wizard.",
370
370
  description: `
371
371
  Finish the name, workspace, and Slack consent in the wizard. The CLI then writes
372
- the token pair into <dir>/.env.local and runs doctor. Needs \`bdk login\` (or
372
+ the token pair into <dir>/.env.local and runs doctor. Needs \`agent-sdk login\` (or
373
373
  CURSOR_API_KEY). A team service-account key cannot create Slack apps. Uses the
374
- v2 control plane: an agent that sets architecture: "v1" must run \`bdk migrate\`
374
+ v2 control plane: an agent that sets architecture: "v1" must run \`agent-sdk migrate\`
375
375
  first.`,
376
376
  flags: {
377
377
  ...slackProvisionFlags,
@@ -388,7 +388,7 @@ first.`,
388
388
  ...dryRunFlag,
389
389
  },
390
390
  effect: "write",
391
- examples: ["bdk slack create --dir ./my-agent --channel-posts"],
391
+ examples: ["agent-sdk slack create --dir ./my-agent --channel-posts"],
392
392
  async run({ values }) {
393
393
  const { cmdSlack } = await import("../../cli-slack.js");
394
394
  return cmdSlack("create", {
@@ -434,7 +434,7 @@ export const slackInitCommand = defineCommand({
434
434
  description: `
435
435
  Writes the channel file, manifests, a Slack CLI .slack/ project, env.example,
436
436
  and setup-status.json. When ~/.slack/bin/slack is logged in, installs the app.
437
- Without --manual this is not the first-run path: use \`bdk slack create\`.`,
437
+ Without --manual this is not the first-run path: use \`agent-sdk slack create\`.`,
438
438
  flags: {
439
439
  ...slackAppFlags,
440
440
  manual: { type: "boolean", description: "Set up a manually created app." },
@@ -1 +1 @@
1
- {"version":3,"file":"develop.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/commands/develop.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAe3E,OAAO,EAAE,KAAK,WAAW,EAAoD,MAAM,eAAe,CAAC;AAyCnG,8DAA8D;AAC9D,wBAAsB,YAAY,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACvC,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;AA8BD,eAAO,MAAM,UAAU,EAAE,WAwFvB,CAAC;AAgHH,eAAO,MAAM,WAAW,EAAE,WAyCxB,CAAC;AAaH,eAAO,MAAM,eAAe,EAAE,WA8C5B,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAqB3B,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,WAkB9B,CAAC;AAuBH,eAAO,MAAM,WAAW,EAAE,WAyCxB,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,WAqD5B,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,YAAY,EAAE,WA6BzB,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,WAwBxB,CAAC"}
1
+ {"version":3,"file":"develop.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/commands/develop.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAe3E,OAAO,EAAE,KAAK,WAAW,EAAoD,MAAM,eAAe,CAAC;AA8CnG,8DAA8D;AAC9D,wBAAsB,YAAY,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACvC,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;AA8BD,eAAO,MAAM,UAAU,EAAE,WA4FvB,CAAC;AAgHH,eAAO,MAAM,WAAW,EAAE,WAyCxB,CAAC;AAaH,eAAO,MAAM,eAAe,EAAE,WA8C5B,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAqB3B,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,WAkB9B,CAAC;AAuBH,eAAO,MAAM,WAAW,EAAE,WAyCxB,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,WAqD5B,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,YAAY,EAAE,WA6BzB,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,WAwBxB,CAAC"}
@@ -19,11 +19,16 @@ const messageFlag = {
19
19
  };
20
20
  /** `run --prod` flags, accepted for old scripts. `session create` documents them. */
21
21
  const hiddenHostedTurnFlags = {
22
- "read-only": { type: "boolean", hidden: true, description: "See `bdk session create`." },
23
- "as-of": { type: "string", hidden: true, description: "See `bdk session create`." },
24
- component: { type: "string", hidden: true, description: "See `bdk session create`." },
25
- team: { type: "string", hidden: true, kind: "teamId", description: "See `bdk session create`." },
26
- "api-key": { type: "string", hidden: true, description: "See `bdk session create`." },
22
+ "read-only": { type: "boolean", hidden: true, description: "See `agent-sdk session create`." },
23
+ "as-of": { type: "string", hidden: true, description: "See `agent-sdk session create`." },
24
+ component: { type: "string", hidden: true, description: "See `agent-sdk session create`." },
25
+ team: {
26
+ type: "string",
27
+ hidden: true,
28
+ kind: "teamId",
29
+ description: "See `agent-sdk session create`.",
30
+ },
31
+ "api-key": { type: "string", hidden: true, description: "See `agent-sdk session create`." },
27
32
  };
28
33
  /** `--message` values after the `--messages-file` entries. */
29
34
  export async function loadMessages(messages, messagesFile) {
@@ -74,9 +79,9 @@ export const runCommand = defineCommand({
74
79
  group: "develop",
75
80
  summary: "Run one turn on an ephemeral local server and print the trajectory.",
76
81
  description: `
77
- Writes one events.ndjson trace (read it with \`bdk session get --file\`).
82
+ Writes one events.ndjson trace (read it with \`agent-sdk session get --file\`).
78
83
  Streams tool calls and reply text to stderr when stderr is a TTY. --url uses a
79
- running server. For the hosted deployment, use \`bdk session create\`.`,
84
+ running server. For the hosted deployment, use \`agent-sdk session create\`.`,
80
85
  flags: {
81
86
  ...dirFlag,
82
87
  ...messageFlag,
@@ -119,13 +124,17 @@ running server. For the hosted deployment, use \`bdk session create\`.`,
119
124
  ...noStreamFlag,
120
125
  ...dryRunFlag,
121
126
  // The hosted turn moved to `session create`; these keep old scripts working.
122
- prod: { type: "boolean", hidden: true, description: "Older form of `bdk session create`." },
127
+ prod: {
128
+ type: "boolean",
129
+ hidden: true,
130
+ description: "Older form of `agent-sdk session create`.",
131
+ },
123
132
  ...hiddenHostedTurnFlags,
124
133
  },
125
134
  effect: "write",
126
135
  examples: [
127
- 'bdk run --message "What is the temperature in NYC?"',
128
- 'bdk run --message "What is the temperature in NYC?" --json',
136
+ 'agent-sdk run --message "What is the temperature in NYC?"',
137
+ 'agent-sdk run --message "What is the temperature in NYC?" --json',
129
138
  ],
130
139
  async run({ values, io }) {
131
140
  const messages = await loadMessages(values.message, values["messages-file"]);
@@ -284,9 +293,9 @@ supported.`,
284
293
  flags: evalFlags,
285
294
  effect: "write",
286
295
  examples: [
287
- "bdk eval --list",
288
- "bdk eval weather/nyc --json",
289
- "bdk eval --url http://127.0.0.1:3000 --no-wait",
296
+ "agent-sdk eval --list",
297
+ "agent-sdk eval weather/nyc --json",
298
+ "agent-sdk eval --url http://127.0.0.1:3000 --no-wait",
290
299
  ],
291
300
  async run({ values, positionals }) {
292
301
  if (values.limit !== undefined ||
@@ -482,7 +491,7 @@ export const toolCallCommand = defineCommand({
482
491
  ...dryRunFlag,
483
492
  },
484
493
  effect: "write",
485
- examples: [`bdk tool call get_weather --input '{"city":"NYC"}' --json`],
494
+ examples: [`agent-sdk tool call get_weather --input '{"city":"NYC"}' --json`],
486
495
  async run({ values, positionals }) {
487
496
  if (values["dry-run"] === true && values.url === undefined && values.prod !== true) {
488
497
  let input;
@@ -87,7 +87,7 @@ deploy of a slug prints the alias token once. Save it.`,
87
87
  ...writeFlags,
88
88
  },
89
89
  effect: "write",
90
- examples: ["bdk deploy", "bdk deploy --dir ./agents --slug triage --no-wait --json"],
90
+ examples: ["agent-sdk deploy", "agent-sdk deploy --dir ./agents --slug triage --no-wait --json"],
91
91
  async run({ values }) {
92
92
  return cmdDeploy({
93
93
  ...deployOptions(values),
@@ -110,7 +110,7 @@ export const deploymentListCommand = defineCommand({
110
110
  summary: "List the team's deployments.",
111
111
  description: "--json prints { items, nextPageToken }. Pass the token as --page-token for the next page.",
112
112
  flags: { ...limitFlags, ...fieldsFlag, ...hostedFlags },
113
- examples: ["bdk deployment list --json --fields slug,status --limit 50"],
113
+ examples: ["agent-sdk deployment list --json --fields slug,status --limit 50"],
114
114
  effect: "read",
115
115
  async run({ values }) {
116
116
  return cmdDeployments(deployOptions(values));
@@ -250,7 +250,7 @@ these. To move the install onto another release, use \`deployment upgrade\` or
250
250
  ...writeFlags,
251
251
  },
252
252
  effect: "write",
253
- examples: ["bdk deployment update my-agent --event-repo acme/api --event-repo acme/web"],
253
+ examples: ["agent-sdk deployment update my-agent --event-repo acme/api --event-repo acme/web"],
254
254
  async run({ values, positionals }) {
255
255
  const repositories = values["event-repo"] ?? [];
256
256
  const clear = values["no-event-repos"] === true;
@@ -336,7 +336,7 @@ export const secretSetCommand = defineCommand({
336
336
  ...writeFlags,
337
337
  },
338
338
  effect: "write",
339
- examples: ['printf %s "$TOKEN" | bdk secret set my-agent GITHUB_TOKEN'],
339
+ examples: ['printf %s "$TOKEN" | agent-sdk secret set my-agent GITHUB_TOKEN'],
340
340
  async run({ values, positionals }) {
341
341
  return cmdSecretsSet(positionals[0], positionals.slice(1), deployOptions(values));
342
342
  },
@@ -1,4 +1,4 @@
1
- /** Every `bdk` command, in help order within each group. */
1
+ /** Every `agent-sdk` command, in help order within each group. */
2
2
  import type { CommandSpec } from "../command.js";
3
3
  export declare const COMMANDS: readonly CommandSpec[];
4
4
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/commands/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA4EjD,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EAyE1C,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/commands/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA4EjD,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EAyE1C,CAAC"}
@@ -1,4 +1,4 @@
1
- /** Every `bdk` command, in help order within each group. */
1
+ /** Every `agent-sdk` command, in help order within each group. */
2
2
  import { helpCommand } from "../help-command.js";
3
3
  import { bitbucketEventsCommand, bitbucketForwardCommand, bitbucketReplayCommand, githubDoctorCommand, githubEventsCommand, githubForwardCommand, githubReplayCommand, gitlabEventsCommand, gitlabForwardCommand, gitlabReplayCommand, pagerdutyEventsCommand, pagerdutyReplayCommand, slackCreateCommand, slackDestroyCommand, slackDoctorCommand, slackIconCommand, slackInitCommand, slackManifestCommand, slackSetupCommand, } from "./channels.js";
4
4
  import { chatCommand, docsCommand, evalCancelCommand, evalCommand, evalGetCommand, evalListCommand, runCommand, skillCommand, toolCallCommand, } from "./develop.js";
@@ -12,7 +12,7 @@ export const mcpServeCommand = defineCommand({
12
12
  description: "Proxies newline-delimited JSON-RPC to <url>/v1/mcp for clients that spawn local servers, such as Cursor. stdout is the MCP wire.",
13
13
  flags: { ...urlFlag, ...bearerTokenFlag, ...prodRejectedFlag },
14
14
  effect: "interactive",
15
- examples: ["bdk mcp serve --url http://127.0.0.1:3000/my-agent"],
15
+ examples: ["agent-sdk mcp serve --url http://127.0.0.1:3000/my-agent"],
16
16
  async run({ values }) {
17
17
  const { cmdMcp } = await import("../../cli-mcp.js");
18
18
  return cmdMcp(undefined, {
@@ -13,7 +13,7 @@ export const validateCommand = defineCommand({
13
13
  summary: "Check the project and exit 1 on any error diagnostic.",
14
14
  flags: { ...dirFlag, ...jsonFlag },
15
15
  effect: "read",
16
- examples: ["bdk validate", "bdk validate --dir ./agents --json"],
16
+ examples: ["agent-sdk validate", "agent-sdk validate --dir ./agents --json"],
17
17
  async run({ values }) {
18
18
  const mounts = await resolveAgentMounts(values.dir);
19
19
  if (values.json === true) {
@@ -62,9 +62,9 @@ network.`,
62
62
  },
63
63
  effect: "read",
64
64
  examples: [
65
- "bdk info --json",
66
- "bdk info --json --fields name,tools.name",
67
- "bdk info --view manifest --json",
65
+ "agent-sdk info --json",
66
+ "agent-sdk info --json --fields name,tools.name",
67
+ "agent-sdk info --view manifest --json",
68
68
  ],
69
69
  async run({ values }) {
70
70
  if (values.view === "manifest") {
@@ -1 +1 @@
1
- {"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/commands/scaffold.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAK3E,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,eAAe,CAAC;AAmChE,eAAO,MAAM,WAAW,EAAE,WA4FxB,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAyC3B,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,WAwBjC,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,WAmB9B,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,WA4BzB,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,WAc1B,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,WAU1B,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,WAU1B,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAW3B,CAAC"}
1
+ {"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/commands/scaffold.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAK3E,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,eAAe,CAAC;AAmChE,eAAO,MAAM,WAAW,EAAE,WA4FxB,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAyC3B,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,WAwBjC,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,WAsB9B,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,WA4BzB,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,WAc1B,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,WAU1B,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,WAU1B,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAW3B,CAAC"}
@@ -91,9 +91,9 @@ become Cursor-account connections. Warnings never fail the command.
91
91
  },
92
92
  effect: "write",
93
93
  examples: [
94
- "bdk init my-agent --template demo",
95
- "bdk init my-agent --json --var name=triage",
96
- "bdk init --from automation:https://cursor.com/automations/<uuid>",
94
+ "agent-sdk init my-agent --template demo",
95
+ "agent-sdk init my-agent --json --var name=triage",
96
+ "agent-sdk init --from automation:https://cursor.com/automations/<uuid>",
97
97
  ],
98
98
  async run({ values, positionals }) {
99
99
  const automation = parseInitSource(values.from, values["from-grokbot"]);
@@ -124,7 +124,7 @@ export const migrateCommand = defineCommand({
124
124
  description: `
125
125
  Uses the bdk-migrate-v2 skill on the pushed ref. --repo, --ref, and --path are
126
126
  inferred like deploy. Waits for the pull request unless --no-wait. Never
127
- deploys. After the merge, \`bdk deploy\` to the same slug replaces the v1
127
+ deploys. After the merge, \`agent-sdk deploy\` to the same slug replaces the v1
128
128
  deployment.`,
129
129
  flags: {
130
130
  ...dirFlag,
@@ -187,10 +187,13 @@ export const skillsListCommand = defineCommand({
187
187
  name: "skills list",
188
188
  group: "develop",
189
189
  summary: "List the BDK skills for coding agents and the version of each installed copy.",
190
- description: "--json prints { items, nextPageToken }. Each item has name, description, version (the package release), installedVersion (null when not installed, `unknown` when the installed copy has no metadata.version), and path. An installedVersion that differs from version means the copy is stale: run `bdk skills install`.",
190
+ description: "--json prints { items, nextPageToken }. Each item has name, description, version (the package release), installedVersion (null when not installed, `unknown` when the installed copy has no metadata.version), and path. An installedVersion that differs from version means the copy is stale: run `agent-sdk skills install`.",
191
191
  flags: { ...limitFlags, ...fieldsFlag, ...jsonFlag },
192
192
  effect: "read",
193
- examples: ["bdk skills list", "bdk skills list --json --fields name,installedVersion"],
193
+ examples: [
194
+ "agent-sdk skills list",
195
+ "agent-sdk skills list --json --fields name,installedVersion",
196
+ ],
194
197
  async run({ values }) {
195
198
  const { cmdListSkills } = await import("../../cli-skills.js");
196
199
  const list = listValues(values);
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * `serve` and `dev`: run agents over HTTP. Cursor hosting starts engines
3
- * with `bdk serve` and reads `bdk --help` for the hosting flags, so keep
3
+ * with `agent-sdk serve` and reads `agent-sdk --help` for the hosting flags, so keep
4
4
  * `--cloud-tools-url`, `--peers-url`, and `--no-control-plane` listed.
5
5
  */
6
6
  import { type CommandSpec } from "../command.js";
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * `serve` and `dev`: run agents over HTTP. Cursor hosting starts engines
3
- * with `bdk serve` and reads `bdk --help` for the hosting flags, so keep
3
+ * with `agent-sdk serve` and reads `agent-sdk --help` for the hosting flags, so keep
4
4
  * `--cloud-tools-url`, `--peers-url`, and `--no-control-plane` listed.
5
5
  */
6
6
  import { spawn } from "node:child_process";
@@ -75,12 +75,12 @@ const serveFlags = {
75
75
  "cloud-tools-url": {
76
76
  type: "string",
77
77
  value: "<url>",
78
- description: "Cursor hosting passes the deployment's server-tools MCP URL here. Hosting reads `bdk --help` for this flag.",
78
+ description: "Cursor hosting passes the deployment's server-tools MCP URL here. Hosting reads `agent-sdk --help` for this flag.",
79
79
  },
80
80
  "peers-url": {
81
81
  type: "string",
82
82
  value: "<url>",
83
- description: "Cursor hosting passes the base URL where a single-agent serve reaches its peers at <url>/<slug>/v1/mcp. Hosting reads `bdk --help` for this flag.",
83
+ description: "Cursor hosting passes the base URL where a single-agent serve reaches its peers at <url>/<slug>/v1/mcp. Hosting reads `agent-sdk --help` for this flag.",
84
84
  },
85
85
  "cursor-events": {
86
86
  type: "boolean",
@@ -102,7 +102,7 @@ On a TTY, press Enter to restart: the CLI starts again, so agent code, evals,
102
102
  and the playground reload. Cursor hosting starts engines with this command.`,
103
103
  flags: serveFlags,
104
104
  effect: "interactive",
105
- examples: ["bdk serve --dir ./agents", "bdk serve --mode single --port 0"],
105
+ examples: ["agent-sdk serve --dir ./agents", "agent-sdk serve --mode single --port 0"],
106
106
  async run({ values }) {
107
107
  return runServe(values.dir, values, false);
108
108
  },
@@ -124,7 +124,7 @@ current folder.`,
124
124
  },
125
125
  },
126
126
  effect: "interactive",
127
- examples: ["bdk dev", "bdk dev ./my-agent --web"],
127
+ examples: ["agent-sdk dev", "agent-sdk dev ./my-agent --web"],
128
128
  async run({ values, positionals, argv }) {
129
129
  const dirFlagPassed = argv.some((arg) => arg === "--dir" || arg.startsWith("--dir="));
130
130
  const positionalDir = positionals[0];
@@ -1 +1 @@
1
- {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/commands/session.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAWhF,OAAO,EACL,KAAK,WAAW,EAKjB,MAAM,eAAe,CAAC;AAmEvB,eAAO,MAAM,WAAW,EAAE,WAkCxB,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,WA+D/B,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,WAgI9B,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,WAgFjC,CAAC"}
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/commands/session.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAWhF,OAAO,EACL,KAAK,WAAW,EAKjB,MAAM,eAAe,CAAC;AAmEvB,eAAO,MAAM,WAAW,EAAE,WAqCxB,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,WA+D/B,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,WAgI9B,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,WAkFjC,CAAC"}
@@ -65,7 +65,10 @@ header. Pass a session id to tail only that session.`,
65
65
  },
66
66
  },
67
67
  effect: "read",
68
- examples: ["bdk logs --prod --slug my-agent --once", "bdk logs ses_abc --prod --slug my-agent"],
68
+ examples: [
69
+ "agent-sdk logs --prod --slug my-agent --once",
70
+ "agent-sdk logs ses_abc --prod --slug my-agent",
71
+ ],
69
72
  async run({ values, positionals }) {
70
73
  return cmdLogs({
71
74
  dir: values.dir,
@@ -118,7 +121,7 @@ stops at a cutoff. --view cost prints token usage per session plus a total
118
121
  },
119
122
  },
120
123
  effect: "read",
121
- examples: ["bdk session list --prod --slug my-agent --json --limit 5"],
124
+ examples: ["agent-sdk session list --prod --slug my-agent --json --limit 5"],
122
125
  async run({ values }) {
123
126
  if (values.view === "cost") {
124
127
  return cmdCost(undefined, {
@@ -174,7 +177,7 @@ export const sessionGetCommand = defineCommand({
174
177
  description: `
175
178
  Reads a running server, --url, or with --prod the hosted deployment. --file
176
179
  reads a saved events.ndjson trace instead (no server). --trace also writes the
177
- raw NDJSON trace (the format \`bdk run --trace\` writes). --web opens the
180
+ raw NDJSON trace (the format \`agent-sdk run --trace\` writes). --web opens the
178
181
  session in the playground.`,
179
182
  args: [sessionArg],
180
183
  flags: {
@@ -215,8 +218,8 @@ session in the playground.`,
215
218
  },
216
219
  effect: "read",
217
220
  examples: [
218
- "bdk session get ses_abc --prod --slug my-agent --json",
219
- "bdk session get --file .agent-serve/traces/ses_abc.ndjson",
221
+ "agent-sdk session get ses_abc --prod --slug my-agent --json",
222
+ "agent-sdk session get --file .agent-serve/traces/ses_abc.ndjson",
220
223
  ],
221
224
  async run({ values, positionals }) {
222
225
  const sessionId = positionals[0];
@@ -289,7 +292,7 @@ export const sessionCreateCommand = defineCommand({
289
292
  The control plane accepts a delivery and allocates the session later. --wait
290
293
  polls the delivery until it names the session (exit 3, pending, if
291
294
  --timeout-ms passes first; default 120000). Then read it with
292
- \`bdk session get <ses_> --prod\`. --session ses_… resumes that session.`,
295
+ \`agent-sdk session get <ses_> --prod\`. --session ses_… resumes that session.`,
293
296
  flags: {
294
297
  ...dirFlag,
295
298
  ...slugFlag,
@@ -329,7 +332,9 @@ polls the delivery until it names the session (exit 3, pending, if
329
332
  ...dryRunFlag,
330
333
  },
331
334
  effect: "write",
332
- examples: ['bdk session create --slug my-agent --message "Summarize open PRs" --wait --json'],
335
+ examples: [
336
+ 'agent-sdk session create --slug my-agent --message "Summarize open PRs" --wait --json',
337
+ ],
333
338
  async run({ values }) {
334
339
  const timeoutMs = values["timeout-ms"] === undefined ? undefined : Number.parseInt(values["timeout-ms"], 10);
335
340
  if (timeoutMs !== undefined && (Number.isNaN(timeoutMs) || timeoutMs <= 0)) {
@@ -19,13 +19,13 @@ export declare function aliasesOf(spec: CommandSpec): CommandAlias[];
19
19
  */
20
20
  export declare function resolveCommand(commands: readonly CommandSpec[], argv: readonly string[]): ResolvedCommand | undefined;
21
21
  /**
22
- * True when the run only prints help: bare `bdk`, `bdk help`, `--help`, or
23
- * `<command> --help`. Hosting probes `bdk --help`, so these runs skip the
22
+ * True when the run only prints help: bare `agent-sdk`, `agent-sdk help`, `--help`, or
23
+ * `<command> --help`. Hosting probes `agent-sdk --help`, so these runs skip the
24
24
  * update check and exit fast.
25
25
  */
26
26
  export declare function isHelpRequest(argv: readonly string[]): boolean;
27
27
  /**
28
- * Run the CLI: the command index for bare `bdk`, the full reference for
28
+ * Run the CLI: the command index for bare `agent-sdk`, the full reference for
29
29
  * `--help`, and one command otherwise. Unknown commands exit 2 with a
30
30
  * suggestion instead of the whole reference.
31
31
  */
@@ -83,8 +83,8 @@ function wantsHelp(rest) {
83
83
  return flagArgs(rest).some((arg) => HELP_FLAGS.has(arg));
84
84
  }
85
85
  /**
86
- * True when the run only prints help: bare `bdk`, `bdk help`, `--help`, or
87
- * `<command> --help`. Hosting probes `bdk --help`, so these runs skip the
86
+ * True when the run only prints help: bare `agent-sdk`, `agent-sdk help`, `--help`, or
87
+ * `<command> --help`. Hosting probes `agent-sdk --help`, so these runs skip the
88
88
  * update check and exit fast.
89
89
  */
90
90
  export function isHelpRequest(argv) {
@@ -95,7 +95,7 @@ export function isHelpRequest(argv) {
95
95
  return wantsHelp(argv.slice(1));
96
96
  }
97
97
  /**
98
- * Run the CLI: the command index for bare `bdk`, the full reference for
98
+ * Run the CLI: the command index for bare `agent-sdk`, the full reference for
99
99
  * `--help`, and one command otherwise. Unknown commands exit 2 with a
100
100
  * suggestion instead of the whole reference.
101
101
  */
@@ -6,7 +6,7 @@
6
6
  export type CliErrorCode = "failed" | "aborted" | "usage" | "pending" | "invalid_argument" | "not_found" | "unauthenticated" | "permission_denied" | "conflict" | "failed_precondition" | "rate_limited" | "unavailable";
7
7
  /** The exit code for each error code. 0 is success. */
8
8
  export declare const EXIT_CODE_BY_ERROR: Readonly<Record<CliErrorCode, number>>;
9
- /** The exit code table that `bdk help` and `bdk help --json` print. */
9
+ /** The exit code table that `agent-sdk help` and `agent-sdk help --json` print. */
10
10
  export declare const EXIT_CODES: readonly {
11
11
  exitCode: number;
12
12
  meaning: string;
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/internal/cli/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,GACT,kBAAkB,GAClB,WAAW,GACX,iBAAiB,GACjB,mBAAmB,GACnB,UAAU,GACV,qBAAqB,GACrB,cAAc,GACd,aAAa,CAAC;AAElB,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAarE,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,UAAU,EAAE,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAWtE,CAAC;AAEF,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B,YACE,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,YAAY,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,EAOzF;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF;AAED,mFAAmF;AACnF,qBAAa,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,EAG3D;CACF;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CA6B3E;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAenE;AAiBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAYnD;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG;IAC9C,KAAK,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAClF,CASA"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/internal/cli/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,GACT,kBAAkB,GAClB,WAAW,GACX,iBAAiB,GACjB,mBAAmB,GACnB,UAAU,GACV,qBAAqB,GACrB,cAAc,GACd,aAAa,CAAC;AAElB,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAarE,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,UAAU,EAAE,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAWtE,CAAC;AAEF,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B,YACE,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,YAAY,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,EAOzF;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF;AAED,mFAAmF;AACnF,qBAAa,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,EAG3D;CACF;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CA6B3E;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAenE;AAiBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAYnD;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG;IAC9C,KAAK,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAClF,CASA"}