@grok/agent-sdk 0.6.0 → 0.7.1
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.
- package/AGENTS.md +40 -0
- package/dist/channels/github/cursor-account.d.ts +1 -0
- package/dist/channels/github/cursor-account.d.ts.map +1 -1
- package/dist/channels/github/cursor-account.js +8 -2
- package/dist/channels/github/forward.d.ts +5 -0
- package/dist/channels/github/forward.d.ts.map +1 -1
- package/dist/channels/github/forward.js +6 -3
- package/dist/channels/origin/cursor-account.d.ts +6 -0
- package/dist/channels/origin/cursor-account.d.ts.map +1 -1
- package/dist/channels/origin/cursor-account.js +17 -0
- package/dist/channels/slack/api.d.ts +18 -0
- package/dist/channels/slack/api.d.ts.map +1 -1
- package/dist/channels/slack/api.js +31 -0
- package/dist/channels/slack/approvals.d.ts +19 -2
- package/dist/channels/slack/approvals.d.ts.map +1 -1
- package/dist/channels/slack/approvals.js +90 -19
- package/dist/channels/slack/attachments.d.ts +7 -2
- package/dist/channels/slack/attachments.d.ts.map +1 -1
- package/dist/channels/slack/attachments.js +318 -156
- package/dist/channels/slack/connect-card.d.ts +16 -0
- package/dist/channels/slack/connect-card.d.ts.map +1 -0
- package/dist/channels/slack/connect-card.js +31 -0
- package/dist/channels/slack/credentials.d.ts +10 -2
- package/dist/channels/slack/credentials.d.ts.map +1 -1
- package/dist/channels/slack/credentials.js +17 -15
- package/dist/channels/slack/defaults.d.ts.map +1 -1
- package/dist/channels/slack/defaults.js +18 -9
- package/dist/channels/slack/dispatch.d.ts +1 -1
- package/dist/channels/slack/dispatch.d.ts.map +1 -1
- package/dist/channels/slack/dispatch.js +19 -3
- package/dist/channels/slack/inbound.d.ts +8 -2
- package/dist/channels/slack/inbound.d.ts.map +1 -1
- package/dist/channels/slack/inbound.js +25 -4
- package/dist/channels/slack/index.d.ts +3 -2
- package/dist/channels/slack/index.d.ts.map +1 -1
- package/dist/channels/slack/index.js +3 -2
- package/dist/channels/slack/init.d.ts.map +1 -1
- package/dist/channels/slack/init.js +2 -1
- package/dist/channels/slack/mentions.d.ts +28 -0
- package/dist/channels/slack/mentions.d.ts.map +1 -0
- package/dist/channels/slack/mentions.js +178 -0
- package/dist/channels/slack/setup.js +1 -1
- package/dist/channels/slack/slack-channel.d.ts.map +1 -1
- package/dist/channels/slack/slack-channel.js +46 -3
- package/dist/channels/slack/stop.d.ts.map +1 -1
- package/dist/channels/slack/stop.js +7 -1
- package/dist/channels/slack/thread-context.d.ts +3 -0
- package/dist/channels/slack/thread-context.d.ts.map +1 -1
- package/dist/channels/slack/thread-context.js +17 -7
- package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
- package/dist/channels/slack/tool-approval-events.js +55 -2
- package/dist/channels/slack/types.d.ts +2 -0
- package/dist/channels/slack/types.d.ts.map +1 -1
- package/dist/channels/teams/activity.d.ts +33 -0
- package/dist/channels/teams/activity.d.ts.map +1 -0
- package/dist/channels/teams/activity.js +213 -0
- package/dist/channels/teams/auth.d.ts +25 -0
- package/dist/channels/teams/auth.d.ts.map +1 -0
- package/dist/channels/teams/auth.js +55 -0
- package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
- package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
- package/dist/channels/teams/bot-framework-auth.js +154 -0
- package/dist/channels/teams/cards.d.ts +23 -0
- package/dist/channels/teams/cards.d.ts.map +1 -0
- package/dist/channels/teams/cards.js +107 -0
- package/dist/channels/teams/connector.d.ts +48 -0
- package/dist/channels/teams/connector.d.ts.map +1 -0
- package/dist/channels/teams/connector.js +159 -0
- package/dist/channels/teams/credentials.d.ts +65 -0
- package/dist/channels/teams/credentials.d.ts.map +1 -0
- package/dist/channels/teams/credentials.js +84 -0
- package/dist/channels/teams/delivery.d.ts +14 -0
- package/dist/channels/teams/delivery.d.ts.map +1 -0
- package/dist/channels/teams/delivery.js +169 -0
- package/dist/channels/teams/dispatch.d.ts +45 -0
- package/dist/channels/teams/dispatch.d.ts.map +1 -0
- package/dist/channels/teams/dispatch.js +402 -0
- package/dist/channels/teams/engagement.d.ts +32 -0
- package/dist/channels/teams/engagement.d.ts.map +1 -0
- package/dist/channels/teams/engagement.js +120 -0
- package/dist/channels/teams/index.d.ts +21 -0
- package/dist/channels/teams/index.d.ts.map +1 -0
- package/dist/channels/teams/index.js +19 -0
- package/dist/channels/teams/marks.d.ts +19 -0
- package/dist/channels/teams/marks.d.ts.map +1 -0
- package/dist/channels/teams/marks.js +96 -0
- package/dist/channels/teams/senders.d.ts +27 -0
- package/dist/channels/teams/senders.d.ts.map +1 -0
- package/dist/channels/teams/senders.js +72 -0
- package/dist/channels/teams/teams-channel.d.ts +43 -0
- package/dist/channels/teams/teams-channel.d.ts.map +1 -0
- package/dist/channels/teams/teams-channel.js +278 -0
- package/dist/channels/teams/text.d.ts +7 -0
- package/dist/channels/teams/text.d.ts.map +1 -0
- package/dist/channels/teams/text.js +63 -0
- package/dist/channels/teams/types.d.ts +306 -0
- package/dist/channels/teams/types.d.ts.map +1 -0
- package/dist/channels/teams/types.js +1 -0
- package/dist/channels.d.ts +31 -0
- package/dist/channels.d.ts.map +1 -1
- package/dist/channels.js +37 -0
- package/dist/connections.d.ts +1 -1
- package/dist/connections.d.ts.map +1 -1
- package/dist/docs/404.html +3 -3
- package/dist/docs/assets/{app.lt-BYgI2.js → app.CpLKJnOA.js} +4 -4
- package/dist/docs/assets/changelog.md.DoOgjnPC.js +1 -0
- package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.DoOgjnPC.lean.js} +1 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BJ_1eI6D.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.Cr1HJ_9k.js} +2 -2
- package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BjpgGAMM.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.CKdhNPPk.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.iovoEQbg.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BYQIeDre.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY.gbWi2q8N.js} +1 -1
- package/dist/docs/assets/chunks/channel.BP0n324b.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.1Mem4UG9.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.Dn3H-X_H.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.BkpSDZwX.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.BScqy1zP.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.Cp394LWf.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.BDv9LhoL.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.CsgCcrKO.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.BKBpIC5O.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BhTtyWMA.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BhTtyWMA.js +1 -0
- package/dist/docs/assets/chunks/clone.BVK2rFqj.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.Bs3ZS9PC.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.CgWi0tY2.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.rn6qIo9N.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.ChhW8oww.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.C0wH5KSk.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.CNEcrwA0.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DCsnKO-7.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.WCMkfvP0.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.BUb1Sxfr.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF._kORbCzm.js} +1 -1
- package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.PrGRm4KW.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.BxhCjiQM.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.5ddTis2y.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BUStU27-.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.CJd1psl3.js} +1 -1
- package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DqvbZSML.js} +1 -1
- package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.DOmz-1UB.js} +1 -1
- package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.33k2v8dM.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.iISCqCXC.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.BHvVgzmD.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.CY3w_-Cn.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.CHXKQS1v.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.DTtRoGss.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.NnPcQ3eY.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.D8DFciH7.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ESAwmMws.js +1 -0
- package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.CwkiT-Fo.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ._wIWkMU6.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.NLVv7R6r.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DbsCXUZp.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.Dp5uAVDl.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.eOEBq4rX.js} +1 -1
- package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.CIRydNl3.js} +3 -3
- package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.CIRydNl3.lean.js} +1 -1
- package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
- package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
- package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
- package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
- package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.js +82 -0
- package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.lean.js +1 -0
- package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.js → reference_agent-config.md.CfM1S6Ac.js} +2 -2
- package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.lean.js → reference_agent-config.md.CfM1S6Ac.lean.js} +1 -1
- package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
- package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
- package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
- package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
- package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
- package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
- package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
- package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
- package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
- package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
- package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
- package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
- package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
- package/dist/docs/building-with-agents.html +37 -37
- package/dist/docs/changelog.html +37 -37
- package/dist/docs/changelog.md +43 -0
- package/dist/docs/deployment.html +40 -40
- package/dist/docs/deployment.md +14 -0
- package/dist/docs/evals.html +37 -37
- package/dist/docs/guides/agent-to-agent.html +37 -37
- package/dist/docs/guides/bitbucket.html +37 -37
- package/dist/docs/guides/cloud-agents.html +43 -38
- package/dist/docs/guides/cloud-agents.md +47 -0
- package/dist/docs/guides/convert-automation.html +37 -37
- package/dist/docs/guides/github.html +37 -37
- package/dist/docs/guides/gitlab.html +37 -37
- package/dist/docs/guides/improve.html +37 -37
- package/dist/docs/guides/jev.html +37 -37
- package/dist/docs/guides/mcp-oauth.html +37 -37
- package/dist/docs/guides/migrate.html +37 -37
- package/dist/docs/guides/opentelemetry.html +37 -37
- package/dist/docs/guides/pagerduty.html +37 -37
- package/dist/docs/guides/slack.html +37 -37
- package/dist/docs/guides/teams.html +109 -0
- package/dist/docs/guides/teams.md +384 -0
- package/dist/docs/guides/webhooks.html +37 -37
- package/dist/docs/guides/workload-identity.html +141 -0
- package/dist/docs/guides/workload-identity.md +227 -0
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +37 -37
- package/dist/docs/index.html +37 -37
- package/dist/docs/llms-full.txt +881 -5
- package/dist/docs/llms.txt +2 -0
- package/dist/docs/quickstart.html +37 -37
- package/dist/docs/reference/access.html +36 -36
- package/dist/docs/reference/agent-config.html +39 -39
- package/dist/docs/reference/agent-config.md +1 -1
- package/dist/docs/reference/artifacts.html +37 -37
- package/dist/docs/reference/channels.html +38 -38
- package/dist/docs/reference/channels.md +1 -0
- package/dist/docs/reference/cli.html +50 -40
- package/dist/docs/reference/cli.md +116 -0
- package/dist/docs/reference/connections.html +37 -37
- package/dist/docs/reference/evals.html +37 -37
- package/dist/docs/reference/extensions.html +37 -37
- package/dist/docs/reference/hooks.html +37 -37
- package/dist/docs/reference/http-api.html +37 -37
- package/dist/docs/reference/instructions.html +37 -37
- package/dist/docs/reference/limits.html +39 -39
- package/dist/docs/reference/limits.md +4 -4
- package/dist/docs/reference/memory.html +37 -37
- package/dist/docs/reference/playground.html +36 -36
- package/dist/docs/reference/project-layout.html +37 -37
- package/dist/docs/reference/schedules.html +40 -40
- package/dist/docs/reference/sessions.html +38 -38
- package/dist/docs/reference/sessions.md +13 -0
- package/dist/docs/reference/skills.html +40 -40
- package/dist/docs/reference/subagents.html +37 -37
- package/dist/docs/reference/tools.html +37 -37
- package/dist/docs/templates/agentic-owners.html +37 -37
- package/dist/docs/templates/reviews.html +37 -37
- package/dist/docs/troubleshooting.html +38 -38
- package/dist/docs/troubleshooting.md +21 -0
- package/dist/evals/run-facts.d.ts.map +1 -1
- package/dist/evals/run-facts.js +4 -0
- package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
- package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
- package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
- package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
- package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
- package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
- package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
- package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
- package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
- package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
- package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
- package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
- package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
- package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
- package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
- package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
- package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
- package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
- package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
- package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
- package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
- package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
- package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
- package/dist/extensions.d.ts.map +1 -1
- package/dist/extensions.js +18 -3
- package/dist/files-backends/agent-store-presigned-url.js +5 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/internal/approval-gate.d.ts +6 -1
- package/dist/internal/approval-gate.d.ts.map +1 -1
- package/dist/internal/approval-gate.js +13 -2
- package/dist/internal/authored-loaders.js +1 -1
- package/dist/internal/channel-architecture.d.ts.map +1 -1
- package/dist/internal/channel-architecture.js +3 -1
- package/dist/internal/cli/commands/channels.d.ts +9 -3
- package/dist/internal/cli/commands/channels.d.ts.map +1 -1
- package/dist/internal/cli/commands/channels.js +193 -4
- package/dist/internal/cli/commands/index.d.ts.map +1 -1
- package/dist/internal/cli/commands/index.js +6 -1
- package/dist/internal/cli/commands/serve.d.ts.map +1 -1
- package/dist/internal/cli/commands/serve.js +25 -5
- package/dist/internal/cli/dispatch.d.ts.map +1 -1
- package/dist/internal/cli/dispatch.js +22 -8
- package/dist/internal/cli/flags.d.ts +14 -0
- package/dist/internal/cli/flags.d.ts.map +1 -1
- package/dist/internal/cli/flags.js +14 -0
- package/dist/internal/cli/help.d.ts.map +1 -1
- package/dist/internal/cli/help.js +3 -1
- package/dist/internal/cli-ax.d.ts.map +1 -1
- package/dist/internal/cli-ax.js +6 -3
- package/dist/internal/cli-cursor.js +2 -2
- package/dist/internal/cli-deploy.d.ts +1 -0
- package/dist/internal/cli-deploy.d.ts.map +1 -1
- package/dist/internal/cli-deploy.js +19 -1
- package/dist/internal/cli-mcp.d.ts.map +1 -1
- package/dist/internal/cli-mcp.js +5 -3
- package/dist/internal/cli-teams-doctor.d.ts +39 -0
- package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
- package/dist/internal/cli-teams-doctor.js +508 -0
- package/dist/internal/cli-teams-forward.d.ts +84 -0
- package/dist/internal/cli-teams-forward.d.ts.map +1 -0
- package/dist/internal/cli-teams-forward.js +386 -0
- package/dist/internal/cli-teams-package.d.ts +26 -0
- package/dist/internal/cli-teams-package.d.ts.map +1 -0
- package/dist/internal/cli-teams-package.js +123 -0
- package/dist/internal/cli-teams.d.ts +15 -0
- package/dist/internal/cli-teams.d.ts.map +1 -0
- package/dist/internal/cli-teams.js +253 -0
- package/dist/internal/connect-click.d.ts +12 -0
- package/dist/internal/connect-click.d.ts.map +1 -0
- package/dist/internal/connect-click.js +22 -0
- package/dist/internal/continuation-channel.d.ts +5 -1
- package/dist/internal/continuation-channel.d.ts.map +1 -1
- package/dist/internal/continuation-channel.js +34 -0
- package/dist/internal/continuation-identity.d.ts +7 -4
- package/dist/internal/continuation-identity.d.ts.map +1 -1
- package/dist/internal/continuation-identity.js +66 -1
- package/dist/internal/convert-automation/convert-workflow.js +2 -2
- package/dist/internal/credential-env-names.d.ts +36 -0
- package/dist/internal/credential-env-names.d.ts.map +1 -0
- package/dist/internal/credential-env-names.js +68 -0
- package/dist/internal/cursor/account-mcp.d.ts +67 -9
- package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
- package/dist/internal/cursor/account-mcp.js +206 -25
- package/dist/internal/cursor/backend-client.d.ts +10 -1
- package/dist/internal/cursor/backend-client.d.ts.map +1 -1
- package/dist/internal/cursor/backend-client.js +19 -7
- package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
- package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
- package/dist/internal/cursor/cloud-agent-identity.js +224 -0
- package/dist/internal/cursor/credentials.d.ts.map +1 -1
- package/dist/internal/cursor/credentials.js +3 -1
- package/dist/internal/cursor-account-mcp-auth.d.ts +8 -1
- package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
- package/dist/internal/cursor-account-mcp-auth.js +22 -6
- package/dist/internal/deploy-client.d.ts.map +1 -1
- package/dist/internal/deploy-client.js +34 -2
- package/dist/internal/deploy-manifest.d.ts +51 -3
- package/dist/internal/deploy-manifest.d.ts.map +1 -1
- package/dist/internal/deploy-manifest.js +96 -7
- package/dist/internal/discovery/agent-config.d.ts.map +1 -1
- package/dist/internal/discovery/agent-config.js +6 -1
- package/dist/internal/discovery/agent.d.ts.map +1 -1
- package/dist/internal/discovery/agent.js +2 -1
- package/dist/internal/discovery/connections.d.ts +5 -0
- package/dist/internal/discovery/connections.d.ts.map +1 -1
- package/dist/internal/discovery/connections.js +71 -1
- package/dist/internal/discovery/extensions.d.ts.map +1 -1
- package/dist/internal/discovery/extensions.js +2 -0
- package/dist/internal/discovery/info.d.ts.map +1 -1
- package/dist/internal/discovery/info.js +4 -0
- package/dist/internal/env-file.d.ts +1 -0
- package/dist/internal/env-file.d.ts.map +1 -1
- package/dist/internal/env-file.js +18 -17
- package/dist/internal/env-prefix.d.ts +11 -0
- package/dist/internal/env-prefix.d.ts.map +1 -0
- package/dist/internal/env-prefix.js +23 -0
- package/dist/internal/event-id-dedupe.d.ts +12 -0
- package/dist/internal/event-id-dedupe.d.ts.map +1 -0
- package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
- package/dist/internal/event-mapper.d.ts +7 -2
- package/dist/internal/event-mapper.d.ts.map +1 -1
- package/dist/internal/event-mapper.js +7 -0
- package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
- package/dist/internal/expected-delivery-failure.js +3 -0
- package/dist/internal/extension-namespace.d.ts +9 -0
- package/dist/internal/extension-namespace.d.ts.map +1 -0
- package/dist/internal/extension-namespace.js +14 -0
- package/dist/internal/guid.d.ts +2 -0
- package/dist/internal/guid.d.ts.map +1 -0
- package/dist/internal/guid.js +4 -0
- package/dist/internal/host-kv-cas.d.ts +13 -0
- package/dist/internal/host-kv-cas.d.ts.map +1 -0
- package/dist/internal/host-kv-cas.js +26 -0
- package/dist/internal/host-kv.d.ts +4 -1
- package/dist/internal/host-kv.d.ts.map +1 -1
- package/dist/internal/host-kv.js +15 -2
- package/dist/internal/hosted-catch-protocol.d.ts +5 -0
- package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-catch-protocol.js +5 -0
- package/dist/internal/hosted-catch.d.ts +2 -0
- package/dist/internal/hosted-catch.d.ts.map +1 -1
- package/dist/internal/hosted-catch.js +6 -1
- package/dist/internal/hosted-delivery-protocol.d.ts +4 -0
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +73 -3
- package/dist/internal/hosted-delivery.d.ts +9 -3
- package/dist/internal/hosted-delivery.d.ts.map +1 -1
- package/dist/internal/hosted-delivery.js +14 -3
- package/dist/internal/hosted-session-fixture.js +1 -1
- package/dist/internal/hosting.d.ts +5 -0
- package/dist/internal/hosting.d.ts.map +1 -1
- package/dist/internal/hosting.js +7 -1
- package/dist/internal/ids.d.ts +2 -0
- package/dist/internal/ids.d.ts.map +1 -1
- package/dist/internal/ids.js +5 -0
- package/dist/internal/install-cursor-skills.d.ts +6 -7
- package/dist/internal/install-cursor-skills.d.ts.map +1 -1
- package/dist/internal/install-cursor-skills.js +15 -9
- package/dist/internal/interview/agent-questions.d.ts +1 -1
- package/dist/internal/interview/agent-questions.d.ts.map +1 -1
- package/dist/internal/interview/agent-questions.js +4 -3
- package/dist/internal/local-control-plane.d.ts.map +1 -1
- package/dist/internal/local-control-plane.js +24 -0
- package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
- package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
- package/dist/internal/mcp-allowlist-in-use.js +93 -0
- package/dist/internal/mcp-endpoint.d.ts.map +1 -1
- package/dist/internal/mcp-endpoint.js +8 -10
- package/dist/internal/mcp-host.d.ts +19 -1
- package/dist/internal/mcp-host.d.ts.map +1 -1
- package/dist/internal/mcp-host.js +67 -3
- package/dist/internal/mcp-oauth.d.ts.map +1 -1
- package/dist/internal/mcp-oauth.js +5 -7
- package/dist/internal/oidcAudiences.d.ts +22 -0
- package/dist/internal/oidcAudiences.d.ts.map +1 -0
- package/dist/internal/oidcAudiences.js +35 -0
- package/dist/internal/otel/collector.d.ts.map +1 -1
- package/dist/internal/otel/collector.js +2 -0
- package/dist/internal/platform-timers.d.ts +2 -0
- package/dist/internal/platform-timers.d.ts.map +1 -1
- package/dist/internal/platform-timers.js +14 -0
- package/dist/internal/private-file.d.ts +32 -1
- package/dist/internal/private-file.d.ts.map +1 -1
- package/dist/internal/private-file.js +209 -7
- package/dist/internal/redact-values.d.ts +3 -0
- package/dist/internal/redact-values.d.ts.map +1 -0
- package/dist/internal/redact-values.js +19 -0
- package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
- package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
- package/dist/internal/reminder-followup-error.d.ts +23 -0
- package/dist/internal/reminder-followup-error.d.ts.map +1 -0
- package/dist/internal/reminder-followup-error.js +12 -0
- package/dist/internal/reminder-runner.d.ts +15 -1
- package/dist/internal/reminder-runner.d.ts.map +1 -1
- package/dist/internal/reminder-runner.js +95 -21
- package/dist/internal/resolved-connections.d.ts.map +1 -1
- package/dist/internal/resolved-connections.js +23 -3
- package/dist/internal/run-client.js +2 -1
- package/dist/internal/run-program.d.ts +31 -0
- package/dist/internal/run-program.d.ts.map +1 -0
- package/dist/internal/run-program.js +150 -0
- package/dist/internal/schedule-runner.d.ts +1 -0
- package/dist/internal/schedule-runner.d.ts.map +1 -1
- package/dist/internal/schedule-runner.js +10 -1
- package/dist/internal/sdk-runner.d.ts +28 -2
- package/dist/internal/sdk-runner.d.ts.map +1 -1
- package/dist/internal/sdk-runner.js +298 -38
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +53 -8
- package/dist/internal/session-credential.d.ts +14 -0
- package/dist/internal/session-credential.d.ts.map +1 -0
- package/dist/internal/session-credential.js +25 -0
- package/dist/internal/session-engine.d.ts +140 -6
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +583 -93
- package/dist/internal/storage-coordinator.d.ts +3 -1
- package/dist/internal/storage-coordinator.d.ts.map +1 -1
- package/dist/internal/storage-coordinator.js +13 -0
- package/dist/internal/storage-roles.d.ts +9 -1
- package/dist/internal/storage-roles.d.ts.map +1 -1
- package/dist/internal/teams-channel-profile.d.ts +41 -0
- package/dist/internal/teams-channel-profile.d.ts.map +1 -0
- package/dist/internal/teams-channel-profile.js +91 -0
- package/dist/internal/teams-devtunnel.d.ts +55 -0
- package/dist/internal/teams-devtunnel.d.ts.map +1 -0
- package/dist/internal/teams-devtunnel.js +205 -0
- package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
- package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
- package/dist/internal/teams-tunnel-proxy.js +100 -0
- package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
- package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
- package/dist/internal/testing/conversation-identity-vectors.js +67 -0
- package/dist/internal/testing/hosted-http.d.ts +15 -0
- package/dist/internal/testing/hosted-http.d.ts.map +1 -0
- package/dist/internal/testing/hosted-http.js +86 -0
- package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
- package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
- package/dist/internal/testing/teams-activity-fixtures.js +236 -0
- package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
- package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
- package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
- package/dist/internal/tunnel-process.d.ts +29 -0
- package/dist/internal/tunnel-process.d.ts.map +1 -0
- package/dist/internal/tunnel-process.js +105 -0
- package/dist/internal/turn-context.d.ts +28 -0
- package/dist/internal/turn-context.d.ts.map +1 -0
- package/dist/internal/turn-context.js +1 -0
- package/dist/oidc-token.d.ts +131 -0
- package/dist/oidc-token.d.ts.map +1 -0
- package/dist/oidc-token.js +221 -0
- package/dist/playground/assets/chunk-YOKDWASO-BPO_8GRX.js +115 -0
- package/dist/playground/assets/highlighted-body-KPVGNVTW-CxEV-T_f.js +1 -0
- package/dist/playground/assets/index-CjFJhCtb.js +62 -0
- package/dist/playground/assets/index-vwUVwmk8.css +1 -0
- package/dist/playground/assets/mermaid-HWGCJPDP-eK-fpbFn.js +1 -0
- package/dist/playground/index.html +2 -2
- package/dist/teams-app-package.d.ts +78 -0
- package/dist/teams-app-package.d.ts.map +1 -0
- package/dist/teams-app-package.js +204 -0
- package/dist/tools.d.ts +1 -1
- package/dist/tools.d.ts.map +1 -1
- package/dist/types.d.ts +271 -2
- package/dist/types.d.ts.map +1 -1
- package/docs/changelog.md +43 -0
- package/docs/deployment.md +14 -0
- package/docs/guides/cloud-agents.md +47 -0
- package/docs/guides/teams.md +389 -0
- package/docs/guides/workload-identity.md +232 -0
- package/docs/reference/agent-config.md +1 -1
- package/docs/reference/channels.md +1 -0
- package/docs/reference/cli.md +116 -0
- package/docs/reference/limits.md +4 -4
- package/docs/reference/sessions.md +13 -0
- package/docs/troubleshooting.md +21 -0
- package/package.json +23 -46
- package/skills/create-agent/SKILL.md +17 -4
- package/skills/debug/SKILL.md +1 -0
- package/skills/deploy/SKILL.md +1 -1
- package/skills/framework-map/SKILL.md +1 -0
- package/skills/setup-teams/SKILL.md +141 -0
- package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
- package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
- package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
- package/dist/docs/assets/changelog.md.DVNB-ApU.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +0 -1
- package/dist/docs/assets/chunks/channel.CdyTxaXV.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +0 -1
- package/dist/docs/assets/chunks/clone.DpIwUbur.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +0 -1
- package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
- package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
- package/dist/playground/assets/index-CnFd5R1_.js +0 -62
- package/dist/playground/assets/index-DNzRv6G8.css +0 -1
- /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
- /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
|
@@ -24,8 +24,9 @@
|
|
|
24
24
|
* The tools run on the serve host, so they need the local runtime.
|
|
25
25
|
*
|
|
26
26
|
* The `cloud__cloud-agent-stop-watch` reminder wakes the conversation that
|
|
27
|
-
* launched an agent once that agent stops (`watchStops`).
|
|
28
|
-
* agent
|
|
27
|
+
* launched an agent once that agent stops (`watchStops`). On Cursor hosting
|
|
28
|
+
* the agent's status webhook fires it; nothing polls the agent, and no model
|
|
29
|
+
* turn runs until the one wake.
|
|
29
30
|
*/
|
|
30
31
|
import * as z from "zod/v4";
|
|
31
32
|
import { defineExtension } from "../../extensions.js";
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
/** A fresh Cloud Agents API agent id, chosen before the launch. */
|
|
2
|
+
export declare function newCloudAgentId(): string;
|
|
3
|
+
/** The `bc-<uuid>` form the Cloud Agents API takes as a client-chosen agent id. */
|
|
4
|
+
export declare function isCloudAgentId(value: string): boolean;
|
|
5
|
+
//# sourceMappingURL=agent-id.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agent-id.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/agent-id.ts"],"names":[],"mappings":"AAIA,mEAAmE;AACnE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
const AGENT_ID_PATTERN = /^bc-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
|
|
3
|
+
/** A fresh Cloud Agents API agent id, chosen before the launch. */
|
|
4
|
+
export function newCloudAgentId() {
|
|
5
|
+
return `bc-${randomUUID()}`;
|
|
6
|
+
}
|
|
7
|
+
/** The `bc-<uuid>` form the Cloud Agents API takes as a client-chosen agent id. */
|
|
8
|
+
export function isCloudAgentId(value) {
|
|
9
|
+
return AGENT_ID_PATTERN.test(value);
|
|
10
|
+
}
|
|
@@ -1,18 +1,25 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* The Cursor backend as the tools use it: launches go through the public
|
|
3
|
-
* v1 Cloud Agents API (the only surface that takes per-launch `envVars`),
|
|
4
|
-
*
|
|
3
|
+
* v1 Cloud Agents API (the only surface that takes per-launch `envVars`), and
|
|
4
|
+
* so does a run's final answer, which the platform records when the run
|
|
5
|
+
* finishes. Everything else about an existing agent goes through the same
|
|
5
6
|
* `aiserver.v1.BackgroundComposerService` RPCs Sand's CloudAgent tool
|
|
6
7
|
* calls, so follow-ups queue, runs pause, and the full conversation is
|
|
7
8
|
* readable. Both authenticate with the host's Cursor API key; the RPCs
|
|
8
9
|
* exchange it for a session token the way the dashboard client does.
|
|
9
10
|
*/
|
|
10
|
-
import type { AgentCloudOptions, ModelSetting } from "../../../types.js";
|
|
11
|
+
import type { AgentCloudOptions, JsonObject, ModelSetting } from "../../../types.js";
|
|
12
|
+
/** The platform route that arms a stop watch and launches with its status webhook in one call. */
|
|
13
|
+
export declare const FACTORY_LAUNCH_PATH = "/internal/agentsdk/cloud-agents/launch";
|
|
11
14
|
export declare class CloudAgentsApiError extends Error {
|
|
12
15
|
readonly status?: number | undefined;
|
|
13
16
|
constructor(message: string, status?: number | undefined);
|
|
14
17
|
}
|
|
15
18
|
export type CloudAgentStatus = "creating" | "running" | "finished" | "error" | "expired" | "unknown";
|
|
19
|
+
/** The run ended. An unknown status is not a stop. */
|
|
20
|
+
export declare function isStoppedRun(status: string | undefined): boolean;
|
|
21
|
+
/** The agent stopped working: it finished, failed, or expired. */
|
|
22
|
+
export declare function isStopped(status: CloudAgentStatus): boolean;
|
|
16
23
|
export type CloudAgentInfo = {
|
|
17
24
|
agentId: string;
|
|
18
25
|
name: string;
|
|
@@ -28,6 +35,8 @@ export type CloudAgentInfo = {
|
|
|
28
35
|
linesAdded: number;
|
|
29
36
|
linesRemoved: number;
|
|
30
37
|
};
|
|
38
|
+
/** The final answer of the agent's latest run, once the agent stopped and that run finished. */
|
|
39
|
+
result?: string;
|
|
31
40
|
};
|
|
32
41
|
export type CloudAgentToolCall = {
|
|
33
42
|
name: string;
|
|
@@ -81,11 +90,21 @@ export type CloudAgentLaunchTarget = AgentCloudOptions & {
|
|
|
81
90
|
teamMcpServers?: string[];
|
|
82
91
|
};
|
|
83
92
|
export type LaunchRequest = {
|
|
93
|
+
/**
|
|
94
|
+
* A client-chosen `bc-<uuid>`. The API keeps it as the agent id and answers
|
|
95
|
+
* 409 when it already exists; it refuses it together with `envVars`.
|
|
96
|
+
*/
|
|
97
|
+
agentId?: string;
|
|
84
98
|
prompt: string;
|
|
85
99
|
name?: string;
|
|
86
100
|
cloud: CloudAgentLaunchTarget;
|
|
87
101
|
model?: ModelSetting;
|
|
88
102
|
};
|
|
103
|
+
/** The stop watch the platform arms before it launches, and the channel its webhook targets. */
|
|
104
|
+
export type LaunchWatch = {
|
|
105
|
+
watch: JsonObject;
|
|
106
|
+
channel: string;
|
|
107
|
+
};
|
|
89
108
|
export declare class CloudAgentsBackend {
|
|
90
109
|
private readonly apiKey;
|
|
91
110
|
private readonly fetchImpl;
|
|
@@ -93,6 +112,17 @@ export declare class CloudAgentsBackend {
|
|
|
93
112
|
constructor(apiKey: () => string, fetchImpl?: typeof fetch);
|
|
94
113
|
/** `POST /v1/agents`: create the agent and start its first run in one call. */
|
|
95
114
|
launch(request: LaunchRequest): Promise<CloudAgentLaunch>;
|
|
115
|
+
/**
|
|
116
|
+
* The platform's launch route: it arms `watch`, then calls `POST /v1/agents`
|
|
117
|
+
* with the status webhook of this deployment's `channel`. Throws when the
|
|
118
|
+
* route is missing, turned off, or fails.
|
|
119
|
+
*/
|
|
120
|
+
launchWithWatch(request: LaunchRequest & {
|
|
121
|
+
agentId: string;
|
|
122
|
+
}, watch: LaunchWatch): Promise<{
|
|
123
|
+
launch: CloudAgentLaunch;
|
|
124
|
+
reminderId: string | undefined;
|
|
125
|
+
}>;
|
|
96
126
|
/** `GetEnvironment`: one saved environment by public id, or undefined when not visible. */
|
|
97
127
|
environment(publicId: string): Promise<CloudEnvironment | undefined>;
|
|
98
128
|
/**
|
|
@@ -102,6 +132,28 @@ export declare class CloudAgentsBackend {
|
|
|
102
132
|
*/
|
|
103
133
|
environmentsNamed(name: string): Promise<CloudEnvironment[]>;
|
|
104
134
|
info(agentId: string): Promise<CloudAgentInfo>;
|
|
135
|
+
/** `info`, plus the agent's `result` once it stopped. */
|
|
136
|
+
infoWithResult(agentId: string): Promise<CloudAgentInfo>;
|
|
137
|
+
/**
|
|
138
|
+
* An agent that already exists, as its launch would have returned it, and
|
|
139
|
+
* when the API created it.
|
|
140
|
+
*/
|
|
141
|
+
existingLaunch(agentId: string): Promise<{
|
|
142
|
+
launch: CloudAgentLaunch;
|
|
143
|
+
createdAt: string | undefined;
|
|
144
|
+
}>;
|
|
145
|
+
/**
|
|
146
|
+
* The agent's latest run from the v1 API: its status, such as `FINISHED`
|
|
147
|
+
* or `CANCELLED`, and its final answer. The platform records the answer
|
|
148
|
+
* only when a run finishes, so an errored or expired run has none.
|
|
149
|
+
*/
|
|
150
|
+
latestRun(agentId: string): Promise<{
|
|
151
|
+
id: string;
|
|
152
|
+
status?: string;
|
|
153
|
+
result?: string;
|
|
154
|
+
} | undefined>;
|
|
155
|
+
private agentRecord;
|
|
156
|
+
private run;
|
|
105
157
|
conversation(agentId: string): Promise<CloudAgentMessage[]>;
|
|
106
158
|
/**
|
|
107
159
|
* Queue a follow-up behind the current run, or with `interrupt` cancel the
|
|
@@ -111,6 +163,8 @@ export declare class CloudAgentsBackend {
|
|
|
111
163
|
runId: string | undefined;
|
|
112
164
|
}>;
|
|
113
165
|
pause(agentId: string): Promise<void>;
|
|
166
|
+
/** One public v1 Cloud Agents API call: a POST when it has a body, else a GET. */
|
|
167
|
+
private v1Request;
|
|
114
168
|
}
|
|
115
169
|
/** The process-wide backend for this mount, built on first use. */
|
|
116
170
|
export declare function cloudAgentsBackend(): CloudAgentsBackend;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/backend.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/backend.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* The Cursor backend as the tools use it: launches go through the public
|
|
3
|
-
* v1 Cloud Agents API (the only surface that takes per-launch `envVars`),
|
|
4
|
-
*
|
|
3
|
+
* v1 Cloud Agents API (the only surface that takes per-launch `envVars`), and
|
|
4
|
+
* so does a run's final answer, which the platform records when the run
|
|
5
|
+
* finishes. Everything else about an existing agent goes through the same
|
|
5
6
|
* `aiserver.v1.BackgroundComposerService` RPCs Sand's CloudAgent tool
|
|
6
7
|
* calls, so follow-ups queue, runs pause, and the full conversation is
|
|
7
8
|
* readable. Both authenticate with the host's Cursor API key; the RPCs
|
|
@@ -10,6 +11,7 @@
|
|
|
10
11
|
import { randomUUID } from "node:crypto";
|
|
11
12
|
import * as z from "zod/v4";
|
|
12
13
|
import { CursorBackendClient } from "../../../internal/cursor/backend-client.js";
|
|
14
|
+
import { hostedControlPlaneFetch } from "../../../internal/hosted-fetch.js";
|
|
13
15
|
import { isRecord } from "../../../internal/is-record.js";
|
|
14
16
|
import { cloudAgentUrl, cursorBackendUrl, cursorExternalApiUrl, resolveApiKeySync, SIGN_IN_HINT, } from "../../../internal/cursor/credentials.js";
|
|
15
17
|
import { toModelSelection } from "../../../internal/sdk-runner.js";
|
|
@@ -20,6 +22,8 @@ const SOURCE = "BACKGROUND_COMPOSER_SOURCE_SDK";
|
|
|
20
22
|
const RPC_TIMEOUT_MS = 60_000;
|
|
21
23
|
// The create call returns once the initial run exists, which can wait on a VM.
|
|
22
24
|
const LAUNCH_TIMEOUT_MS = 300_000;
|
|
25
|
+
/** The platform route that arms a stop watch and launches with its status webhook in one call. */
|
|
26
|
+
export const FACTORY_LAUNCH_PATH = "/internal/agentsdk/cloud-agents/launch";
|
|
23
27
|
export class CloudAgentsApiError extends Error {
|
|
24
28
|
constructor(message, status) {
|
|
25
29
|
super(message);
|
|
@@ -27,6 +31,22 @@ export class CloudAgentsApiError extends Error {
|
|
|
27
31
|
this.name = "CloudAgentsApiError";
|
|
28
32
|
}
|
|
29
33
|
}
|
|
34
|
+
const STOPPED_STATUSES = new Set(["finished", "error", "expired"]);
|
|
35
|
+
/** Cloud Agents API run statuses of a run that ended. */
|
|
36
|
+
const STOPPED_RUN_STATUSES = new Set([
|
|
37
|
+
"FINISHED",
|
|
38
|
+
"ERROR",
|
|
39
|
+
"CANCELLED",
|
|
40
|
+
"EXPIRED",
|
|
41
|
+
]);
|
|
42
|
+
/** The run ended. An unknown status is not a stop. */
|
|
43
|
+
export function isStoppedRun(status) {
|
|
44
|
+
return status !== undefined && STOPPED_RUN_STATUSES.has(status);
|
|
45
|
+
}
|
|
46
|
+
/** The agent stopped working: it finished, failed, or expired. */
|
|
47
|
+
export function isStopped(status) {
|
|
48
|
+
return STOPPED_STATUSES.has(status);
|
|
49
|
+
}
|
|
30
50
|
// ---------------------------------------------------------------------------
|
|
31
51
|
// Proto-JSON response schemas (camelCase; default-valued fields are omitted)
|
|
32
52
|
// ---------------------------------------------------------------------------
|
|
@@ -95,6 +115,19 @@ const launchResponseSchema = z.object({
|
|
|
95
115
|
agent: z.object({ id: z.string(), url: z.string().optional() }),
|
|
96
116
|
run: z.object({ id: z.string(), status: z.string() }),
|
|
97
117
|
});
|
|
118
|
+
/** A null `reminderId` means the platform cancelled the watch, for a run that already stopped. */
|
|
119
|
+
const factoryLaunchResponseSchema = z.object({
|
|
120
|
+
launch: launchResponseSchema,
|
|
121
|
+
reminderId: z.string().nullable(),
|
|
122
|
+
});
|
|
123
|
+
const agentResponseSchema = z.object({
|
|
124
|
+
latestRunId: z.string().optional(),
|
|
125
|
+
createdAt: z.string().optional(),
|
|
126
|
+
});
|
|
127
|
+
const runResponseSchema = z.object({
|
|
128
|
+
status: z.string().optional(),
|
|
129
|
+
result: z.string().optional(),
|
|
130
|
+
});
|
|
98
131
|
// ---------------------------------------------------------------------------
|
|
99
132
|
export class CloudAgentsBackend {
|
|
100
133
|
constructor(apiKey, fetchImpl = fetch) {
|
|
@@ -110,34 +143,23 @@ export class CloudAgentsBackend {
|
|
|
110
143
|
}
|
|
111
144
|
/** `POST /v1/agents`: create the agent and start its first run in one call. */
|
|
112
145
|
async launch(request) {
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
autoCreatePR: cloud.autoCreatePR,
|
|
125
|
-
skipReviewerRequest: cloud.skipReviewerRequest,
|
|
126
|
-
};
|
|
146
|
+
return toLaunch(launchResponseSchema.parse(await this.v1Request("/v1/agents", "launch", {
|
|
147
|
+
body: launchBody(request),
|
|
148
|
+
timeoutMs: LAUNCH_TIMEOUT_MS,
|
|
149
|
+
})));
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* The platform's launch route: it arms `watch`, then calls `POST /v1/agents`
|
|
153
|
+
* with the status webhook of this deployment's `channel`. Throws when the
|
|
154
|
+
* route is missing, turned off, or fails.
|
|
155
|
+
*/
|
|
156
|
+
async launchWithWatch(request, watch) {
|
|
127
157
|
let response;
|
|
128
158
|
try {
|
|
129
|
-
response = await
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
authorization: `Bearer ${this.apiKey()}`,
|
|
134
|
-
"x-ghost-mode": "true",
|
|
135
|
-
"x-cursor-client-type": "agent-serve",
|
|
136
|
-
"x-request-id": randomUUID(),
|
|
137
|
-
},
|
|
138
|
-
body: JSON.stringify(body),
|
|
139
|
-
signal: AbortSignal.timeout(LAUNCH_TIMEOUT_MS),
|
|
140
|
-
});
|
|
159
|
+
response = await hostedControlPlaneFetch({
|
|
160
|
+
apiKey: this.apiKey(),
|
|
161
|
+
fetch: (input, init) => this.fetchImpl(input, { ...init, signal: AbortSignal.timeout(LAUNCH_TIMEOUT_MS) }),
|
|
162
|
+
}, "POST", FACTORY_LAUNCH_PATH, { launch: launchBody(request), watch: watch.watch, channel: watch.channel });
|
|
141
163
|
}
|
|
142
164
|
catch (error) {
|
|
143
165
|
throw new CloudAgentsApiError(`Cloud agent launch failed: ${error instanceof Error ? error.message : String(error)}`);
|
|
@@ -146,13 +168,8 @@ export class CloudAgentsBackend {
|
|
|
146
168
|
if (!response.ok) {
|
|
147
169
|
throw new CloudAgentsApiError(`Cloud agent launch failed (${response.status}): ${apiErrorMessage(text)}`, response.status);
|
|
148
170
|
}
|
|
149
|
-
const parsed =
|
|
150
|
-
return {
|
|
151
|
-
agentId: parsed.agent.id,
|
|
152
|
-
runId: parsed.run.id,
|
|
153
|
-
status: parsed.run.status.toLowerCase(),
|
|
154
|
-
url: parsed.agent.url ?? cloudAgentUrl(parsed.agent.id),
|
|
155
|
-
};
|
|
171
|
+
const parsed = factoryLaunchResponseSchema.parse(JSON.parse(text));
|
|
172
|
+
return { launch: toLaunch(parsed.launch), reminderId: parsed.reminderId ?? undefined };
|
|
156
173
|
}
|
|
157
174
|
/** `GetEnvironment`: one saved environment by public id, or undefined when not visible. */
|
|
158
175
|
async environment(publicId) {
|
|
@@ -193,6 +210,53 @@ export class CloudAgentsBackend {
|
|
|
193
210
|
},
|
|
194
211
|
};
|
|
195
212
|
}
|
|
213
|
+
/** `info`, plus the agent's `result` once it stopped. */
|
|
214
|
+
async infoWithResult(agentId) {
|
|
215
|
+
const info = await this.info(agentId);
|
|
216
|
+
if (!isStopped(info.status)) {
|
|
217
|
+
return info;
|
|
218
|
+
}
|
|
219
|
+
const result = (await this.latestRun(agentId))?.result;
|
|
220
|
+
return result === undefined ? info : { ...info, result };
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
223
|
+
* An agent that already exists, as its launch would have returned it, and
|
|
224
|
+
* when the API created it.
|
|
225
|
+
*/
|
|
226
|
+
async existingLaunch(agentId) {
|
|
227
|
+
const { latestRunId, createdAt } = await this.agentRecord(agentId);
|
|
228
|
+
const run = latestRunId === undefined ? undefined : await this.run(agentId, latestRunId);
|
|
229
|
+
return {
|
|
230
|
+
launch: {
|
|
231
|
+
agentId,
|
|
232
|
+
runId: run?.id ?? "",
|
|
233
|
+
status: run?.status?.toLowerCase() ?? "unknown",
|
|
234
|
+
url: cloudAgentUrl(agentId),
|
|
235
|
+
},
|
|
236
|
+
createdAt,
|
|
237
|
+
};
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* The agent's latest run from the v1 API: its status, such as `FINISHED`
|
|
241
|
+
* or `CANCELLED`, and its final answer. The platform records the answer
|
|
242
|
+
* only when a run finishes, so an errored or expired run has none.
|
|
243
|
+
*/
|
|
244
|
+
async latestRun(agentId) {
|
|
245
|
+
const { latestRunId } = await this.agentRecord(agentId);
|
|
246
|
+
return latestRunId === undefined ? undefined : this.run(agentId, latestRunId);
|
|
247
|
+
}
|
|
248
|
+
async agentRecord(agentId) {
|
|
249
|
+
return agentResponseSchema.parse(await this.v1Request(`/v1/agents/${encodeURIComponent(agentId)}`, "read", {
|
|
250
|
+
timeoutMs: RPC_TIMEOUT_MS,
|
|
251
|
+
}));
|
|
252
|
+
}
|
|
253
|
+
async run(agentId, latestRunId) {
|
|
254
|
+
const agentPath = `/v1/agents/${encodeURIComponent(agentId)}`;
|
|
255
|
+
const run = runResponseSchema.parse(await this.v1Request(`${agentPath}/runs/${encodeURIComponent(latestRunId)}`, "run read", {
|
|
256
|
+
timeoutMs: RPC_TIMEOUT_MS,
|
|
257
|
+
}));
|
|
258
|
+
return { id: latestRunId, ...run };
|
|
259
|
+
}
|
|
196
260
|
async conversation(agentId) {
|
|
197
261
|
const { conversation } = conversationResponseSchema.parse(await this.rpcClient.serviceRpc(SERVICE, "GetBackgroundComposerConversation", { bcId: agentId }, RPC_TIMEOUT_MS));
|
|
198
262
|
return (conversation ?? []).map((message) => {
|
|
@@ -230,6 +294,57 @@ export class CloudAgentsBackend {
|
|
|
230
294
|
async pause(agentId) {
|
|
231
295
|
await this.rpcClient.serviceRpc(SERVICE, "PauseBackgroundComposer", { bcId: agentId, source: SOURCE }, RPC_TIMEOUT_MS);
|
|
232
296
|
}
|
|
297
|
+
/** One public v1 Cloud Agents API call: a POST when it has a body, else a GET. */
|
|
298
|
+
async v1Request(path, action, init) {
|
|
299
|
+
let response;
|
|
300
|
+
try {
|
|
301
|
+
response = await this.fetchImpl(`${cursorExternalApiUrl()}${path}`, {
|
|
302
|
+
method: init.body === undefined ? "GET" : "POST",
|
|
303
|
+
headers: {
|
|
304
|
+
"content-type": "application/json",
|
|
305
|
+
authorization: `Bearer ${this.apiKey()}`,
|
|
306
|
+
"x-ghost-mode": "true",
|
|
307
|
+
"x-cursor-client-type": "agent-serve",
|
|
308
|
+
"x-request-id": randomUUID(),
|
|
309
|
+
},
|
|
310
|
+
body: init.body === undefined ? undefined : JSON.stringify(init.body),
|
|
311
|
+
signal: AbortSignal.timeout(init.timeoutMs),
|
|
312
|
+
});
|
|
313
|
+
}
|
|
314
|
+
catch (error) {
|
|
315
|
+
throw new CloudAgentsApiError(`Cloud agent ${action} failed: ${error instanceof Error ? error.message : String(error)}`);
|
|
316
|
+
}
|
|
317
|
+
const text = await response.text();
|
|
318
|
+
if (!response.ok) {
|
|
319
|
+
throw new CloudAgentsApiError(`Cloud agent ${action} failed (${response.status}): ${apiErrorMessage(text)}`, response.status);
|
|
320
|
+
}
|
|
321
|
+
return JSON.parse(text);
|
|
322
|
+
}
|
|
323
|
+
}
|
|
324
|
+
function launchBody(request) {
|
|
325
|
+
const { cloud } = request;
|
|
326
|
+
return {
|
|
327
|
+
agentId: request.agentId,
|
|
328
|
+
prompt: { text: request.prompt },
|
|
329
|
+
name: request.name,
|
|
330
|
+
model: request.model === undefined ? undefined : toModelSelection(request.model),
|
|
331
|
+
env: cloud.env,
|
|
332
|
+
envVars: cloud.envVars,
|
|
333
|
+
mcpServers: cloud.mcpServers,
|
|
334
|
+
teamMcpServers: cloud.teamMcpServers,
|
|
335
|
+
repos: cloud.repos,
|
|
336
|
+
workOnCurrentBranch: cloud.workOnCurrentBranch,
|
|
337
|
+
autoCreatePR: cloud.autoCreatePR,
|
|
338
|
+
skipReviewerRequest: cloud.skipReviewerRequest,
|
|
339
|
+
};
|
|
340
|
+
}
|
|
341
|
+
function toLaunch(parsed) {
|
|
342
|
+
return {
|
|
343
|
+
agentId: parsed.agent.id,
|
|
344
|
+
runId: parsed.run.id,
|
|
345
|
+
status: parsed.run.status.toLowerCase(),
|
|
346
|
+
url: parsed.agent.url ?? cloudAgentUrl(parsed.agent.id),
|
|
347
|
+
};
|
|
233
348
|
}
|
|
234
349
|
let backend;
|
|
235
350
|
/** The process-wide backend for this mount, built on first use. */
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
* the fleet listing is that principal's records, by default narrowed to the
|
|
7
7
|
* session that launched them.
|
|
8
8
|
*/
|
|
9
|
-
import type { ToolContext } from "../../../types.js";
|
|
9
|
+
import type { HostKvApi, ToolContext } from "../../../types.js";
|
|
10
10
|
export type FleetEntry = {
|
|
11
11
|
agentId: string;
|
|
12
12
|
name?: string;
|
|
@@ -17,9 +17,37 @@ export type FleetEntry = {
|
|
|
17
17
|
export type FleetScope = "session" | "all";
|
|
18
18
|
/** Unauthenticated sessions (local dev, direct calls) share one principal. */
|
|
19
19
|
export declare function principalOf(ctx: ToolContext): string;
|
|
20
|
-
export declare function recordLaunch(ctx: ToolContext, agentId: string, name: string | undefined
|
|
21
|
-
|
|
22
|
-
|
|
20
|
+
export declare function recordLaunch(ctx: ToolContext, agentId: string, name: string | undefined, launch: {
|
|
21
|
+
webhook: boolean;
|
|
22
|
+
}): Promise<void>;
|
|
23
|
+
/**
|
|
24
|
+
* Bind an agent id to this principal before its launch, so that a retry of
|
|
25
|
+
* the same launch can take the agent the first attempt created. Refuses an
|
|
26
|
+
* id that another principal holds. `earlier` is true when this principal
|
|
27
|
+
* held the id before this call. `claimedAt` is set while no launch of the id
|
|
28
|
+
* has returned, so an agent the API created before it is not this claim's.
|
|
29
|
+
*/
|
|
30
|
+
export declare function claimAgentId(ctx: ToolContext, agentId: string): Promise<{
|
|
31
|
+
earlier: boolean;
|
|
32
|
+
webhook: boolean;
|
|
33
|
+
claimedAt: number | undefined;
|
|
34
|
+
release: () => Promise<void>;
|
|
35
|
+
}>;
|
|
36
|
+
/**
|
|
37
|
+
* Refuse agents launched by another principal, or not through the extension.
|
|
38
|
+
* A claim whose launch never returned does not count.
|
|
39
|
+
* Resolves with whether the launch registered the status webhook.
|
|
40
|
+
*/
|
|
41
|
+
export declare function assertOwned(ctx: ToolContext, agentId: string): Promise<{
|
|
42
|
+
webhook: boolean;
|
|
43
|
+
}>;
|
|
44
|
+
/**
|
|
45
|
+
* Turn a pending claim on `agentId` into a launch with the status webhook.
|
|
46
|
+
* Only a signed status webhook may call this: it names only agents the
|
|
47
|
+
* platform launched with this deployment's webhook, so the launch whose reply
|
|
48
|
+
* was lost created the agent. Any other record is left as it is.
|
|
49
|
+
*/
|
|
50
|
+
export declare function adoptPendingLaunch(kv: HostKvApi, agentId: string): Promise<void>;
|
|
23
51
|
/** The caller's launches, newest first: this session's, or every session's. */
|
|
24
52
|
export declare function listFleet(ctx: ToolContext, scope?: FleetScope): Promise<FleetEntry[]>;
|
|
25
53
|
//# sourceMappingURL=fleet.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fleet.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/fleet.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;
|
|
1
|
+
{"version":3,"file":"fleet.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/fleet.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAa,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAK3E,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;AAmC3C,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAGpD;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC,CAkCD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAM/B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtF;AAwBD,+EAA+E;AAC/E,wBAAsB,SAAS,CAC7B,GAAG,EAAE,WAAW,EAChB,KAAK,GAAE,UAAkB,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CAIvB"}
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
* the fleet listing is that principal's records, by default narrowed to the
|
|
7
7
|
* session that launched them.
|
|
8
8
|
*/
|
|
9
|
+
import { randomUUID } from "node:crypto";
|
|
9
10
|
import * as z from "zod/v4";
|
|
10
11
|
const PREFIX = "cloud-agents";
|
|
11
12
|
const fleetSchema = z.array(z.object({
|
|
@@ -14,7 +15,15 @@ const fleetSchema = z.array(z.object({
|
|
|
14
15
|
launchedAt: z.string(),
|
|
15
16
|
sessionId: z.string().optional(),
|
|
16
17
|
}));
|
|
17
|
-
const ownerSchema = z.object({
|
|
18
|
+
const ownerSchema = z.object({
|
|
19
|
+
principal: z.string(),
|
|
20
|
+
/** The launch registered the status webhook; absent on launches before it existed. */
|
|
21
|
+
webhook: z.literal(true).optional(),
|
|
22
|
+
/** Set while no launch of the claimed id has returned; one value per claim. */
|
|
23
|
+
pending: z.string().optional(),
|
|
24
|
+
/** When the pending claim was written, in ms since the epoch. */
|
|
25
|
+
claimedAt: z.number().optional(),
|
|
26
|
+
});
|
|
18
27
|
// `host.kv` has no compare-and-swap, and a model that launches two agents in
|
|
19
28
|
// one turn calls this tool in parallel. Chain the index read-modify-write per
|
|
20
29
|
// principal so neither launch overwrites the other's entry.
|
|
@@ -33,7 +42,7 @@ export function principalOf(ctx) {
|
|
|
33
42
|
const auth = ctx.session.auth;
|
|
34
43
|
return auth === null ? "anonymous" : `${auth.principalType}:${auth.principalId}`;
|
|
35
44
|
}
|
|
36
|
-
export async function recordLaunch(ctx, agentId, name) {
|
|
45
|
+
export async function recordLaunch(ctx, agentId, name, launch) {
|
|
37
46
|
const principal = principalOf(ctx);
|
|
38
47
|
const entry = {
|
|
39
48
|
agentId,
|
|
@@ -41,18 +50,95 @@ export async function recordLaunch(ctx, agentId, name) {
|
|
|
41
50
|
launchedAt: new Date().toISOString(),
|
|
42
51
|
sessionId: ctx.session.id,
|
|
43
52
|
};
|
|
44
|
-
await ctx.host.kv.put(
|
|
53
|
+
await ctx.host.kv.put(ownerKey(agentId), launch.webhook ? { principal, webhook: true } : { principal });
|
|
45
54
|
await withIndexLock(fleetKey(principal), async () => {
|
|
46
55
|
const fleet = await listFleet(ctx);
|
|
47
|
-
await ctx.host.kv.put(fleetKey(principal), [
|
|
56
|
+
await ctx.host.kv.put(fleetKey(principal), [
|
|
57
|
+
entry,
|
|
58
|
+
...fleet.filter((earlier) => earlier.agentId !== agentId),
|
|
59
|
+
]);
|
|
48
60
|
});
|
|
49
61
|
}
|
|
50
|
-
/**
|
|
62
|
+
/**
|
|
63
|
+
* Bind an agent id to this principal before its launch, so that a retry of
|
|
64
|
+
* the same launch can take the agent the first attempt created. Refuses an
|
|
65
|
+
* id that another principal holds. `earlier` is true when this principal
|
|
66
|
+
* held the id before this call. `claimedAt` is set while no launch of the id
|
|
67
|
+
* has returned, so an agent the API created before it is not this claim's.
|
|
68
|
+
*/
|
|
69
|
+
export async function claimAgentId(ctx, agentId) {
|
|
70
|
+
const key = ownerKey(agentId);
|
|
71
|
+
const stored = await ctx.host.kv.get(key);
|
|
72
|
+
let pending;
|
|
73
|
+
let claimedAt;
|
|
74
|
+
if (stored === undefined) {
|
|
75
|
+
pending = randomUUID();
|
|
76
|
+
claimedAt = Date.now();
|
|
77
|
+
await ctx.host.kv.put(key, { principal: principalOf(ctx), pending, claimedAt });
|
|
78
|
+
}
|
|
79
|
+
else {
|
|
80
|
+
const owner = ownerOf(ctx, agentId, stored);
|
|
81
|
+
if (owner.pending === undefined || owner.claimedAt === undefined) {
|
|
82
|
+
return {
|
|
83
|
+
earlier: true,
|
|
84
|
+
webhook: owner.webhook === true,
|
|
85
|
+
claimedAt: undefined,
|
|
86
|
+
release: async () => { },
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
pending = owner.pending;
|
|
90
|
+
claimedAt = owner.claimedAt;
|
|
91
|
+
}
|
|
92
|
+
return {
|
|
93
|
+
earlier: stored !== undefined,
|
|
94
|
+
webhook: false,
|
|
95
|
+
claimedAt,
|
|
96
|
+
// Leave the record when a parallel launch of the same id replaced the claim.
|
|
97
|
+
release: async () => {
|
|
98
|
+
const current = ownerSchema.safeParse(await ctx.host.kv.get(key));
|
|
99
|
+
if (current.success && current.data.pending === pending) {
|
|
100
|
+
await ctx.host.kv.delete(key);
|
|
101
|
+
}
|
|
102
|
+
},
|
|
103
|
+
};
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Refuse agents launched by another principal, or not through the extension.
|
|
107
|
+
* A claim whose launch never returned does not count.
|
|
108
|
+
* Resolves with whether the launch registered the status webhook.
|
|
109
|
+
*/
|
|
51
110
|
export async function assertOwned(ctx, agentId) {
|
|
52
|
-
const owner =
|
|
111
|
+
const owner = ownerOf(ctx, agentId, await ctx.host.kv.get(ownerKey(agentId)));
|
|
112
|
+
if (owner.pending !== undefined) {
|
|
113
|
+
throw notLaunchedHere(agentId);
|
|
114
|
+
}
|
|
115
|
+
return { webhook: owner.webhook === true };
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* Turn a pending claim on `agentId` into a launch with the status webhook.
|
|
119
|
+
* Only a signed status webhook may call this: it names only agents the
|
|
120
|
+
* platform launched with this deployment's webhook, so the launch whose reply
|
|
121
|
+
* was lost created the agent. Any other record is left as it is.
|
|
122
|
+
*/
|
|
123
|
+
export async function adoptPendingLaunch(kv, agentId) {
|
|
124
|
+
const key = ownerKey(agentId);
|
|
125
|
+
const owner = ownerSchema.safeParse(await kv.get(key));
|
|
126
|
+
if (owner.success && owner.data.pending !== undefined) {
|
|
127
|
+
await kv.put(key, { principal: owner.data.principal, webhook: true });
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
function ownerOf(ctx, agentId, stored) {
|
|
131
|
+
const owner = ownerSchema.safeParse(stored);
|
|
53
132
|
if (!owner.success || owner.data.principal !== principalOf(ctx)) {
|
|
54
|
-
throw
|
|
133
|
+
throw notLaunchedHere(agentId);
|
|
55
134
|
}
|
|
135
|
+
return owner.data;
|
|
136
|
+
}
|
|
137
|
+
function notLaunchedHere(agentId) {
|
|
138
|
+
return new Error(`Agent ${agentId} was not launched through this extension by this principal; only your own launches can be read or steered.`);
|
|
139
|
+
}
|
|
140
|
+
function ownerKey(agentId) {
|
|
141
|
+
return `${PREFIX}/agents/${agentId}`;
|
|
56
142
|
}
|
|
57
143
|
/** The caller's launches, newest first: this session's, or every session's. */
|
|
58
144
|
export async function listFleet(ctx, scope = "all") {
|