@grok/agent-sdk 0.5.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +40 -0
- 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/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/manifest.d.ts.map +1 -1
- package/dist/channels/slack/manifest.js +2 -15
- 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.CYdjweqP.js → app.Ch-048af.js} +4 -4
- package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
- package/dist/docs/assets/{changelog.md.BMrJ5WxW.lean.js → changelog.md.SoN0MK7o.lean.js} +1 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.CRATKS9J.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
- package/dist/docs/assets/chunks/{arc.BxM78ISR.js → arc.BIzu7OVF.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.Bi6MuKaU.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.L47qqpDG.js → baseUniq.B4y6Y5eG.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.kHFF2FK5.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BTW85ll3.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
- package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.Bbh3_48g.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.WeAmK3fK.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.DTdUiVHf.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.n5XzANDz.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.D51eewCb.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.BrY0U7ZV.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B0OA4aFV.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Djt3Mjft.js → chunk-YZCP3GAM.CwrYtDVo.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +1 -0
- package/dist/docs/assets/chunks/clone.F824-PNx.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DiMcA6Q8.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.BGqI4vrS.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.bDqFuMoH.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Y0sxaXRU.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Bg43b0yi.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.DCfVasEC.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.C72GaD16.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.DxRQj7pP.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DiLZy5Q4.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.DL8XkRvh.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
- package/dist/docs/assets/chunks/{graph.3Xub80xJ.js → graph.CdOyJvsX.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.O3lGaspu.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.w-pCiQzn.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cg_oBs9j.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.BpfMGPwn.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
- package/dist/docs/assets/chunks/{layout.CtwXs__p.js → layout.DDwvoQlY.js} +1 -1
- package/dist/docs/assets/chunks/{linear.NmCskOrP.js → linear.BRXPDWj3.js} +1 -1
- package/dist/docs/assets/chunks/{min.DpQtsLKs.js → min.3YwC0t3o.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.B-P-aKVp.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.BfjjqK7j.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BTzHo53F.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DIT2FIKr.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.NK1wCsgt.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.D9oElkvo.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.IPksnixH.js → stateDiagram-FHFEXIEX.B_SGgvgs.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +1 -0
- package/dist/docs/assets/chunks/{theme.CgKu7tr3.js → theme.bNyH5NPA.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CuAtJapY.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.B87nNW9E.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
- package/dist/docs/assets/chunks/wardley-RL74JXVD.DQqE3WF8.js +162 -0
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BELjSq8w.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.5zN5ZGsz.js → xychartDiagram-5P7HB3ND.DnJA2aXp.js} +1 -1
- package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.N9S5KC5R.js} +2 -2
- package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.N9S5KC5R.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/{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 +51 -0
- package/dist/docs/deployment.html +39 -39
- package/dist/docs/deployment.md +10 -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/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +37 -37
- package/dist/docs/index.html +37 -37
- package/dist/docs/llms-full.txt +652 -4
- package/dist/docs/llms.txt +1 -0
- package/dist/docs/quickstart.html +37 -37
- package/dist/docs/reference/access.html +36 -36
- package/dist/docs/reference/agent-config.html +37 -37
- 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-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 +31 -8
- 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 +1 -0
- package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
- package/dist/internal/cursor-account-mcp-auth.js +2 -1
- 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/connections.d.ts.map +1 -1
- package/dist/internal/discovery/connections.js +53 -0
- 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 +8 -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 +6 -0
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +71 -1
- package/dist/internal/hosted-delivery.d.ts +5 -2
- package/dist/internal/hosted-delivery.d.ts.map +1 -1
- package/dist/internal/hosted-delivery.js +36 -12
- package/dist/internal/hosted-execution-latency.d.ts +3 -0
- package/dist/internal/hosted-execution-latency.d.ts.map +1 -1
- package/dist/internal/hosted-execution-latency.js +11 -0
- 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/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/sdk-runner.d.ts +29 -3
- package/dist/internal/sdk-runner.d.ts.map +1 -1
- package/dist/internal/sdk-runner.js +304 -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 +137 -5
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +606 -92
- 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/tcp-address.d.ts +3 -1
- package/dist/internal/tcp-address.d.ts.map +1 -1
- package/dist/internal/tcp-address.js +6 -0
- 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 +127 -0
- package/dist/oidc-token.d.ts.map +1 -0
- package/dist/oidc-token.js +221 -0
- package/dist/playground/assets/index-BaBSZXki.css +1 -0
- package/dist/playground/assets/index-BkAF8YlO.js +62 -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 +278 -2
- package/dist/types.d.ts.map +1 -1
- package/docs/changelog.md +51 -0
- package/docs/deployment.md +10 -0
- package/docs/guides/cloud-agents.md +47 -0
- package/docs/guides/teams.md +389 -0
- 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 +21 -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.BMrJ5WxW.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.dUaE1f8e.js +0 -1
- package/dist/docs/assets/chunks/channel.ljJtQtBi.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BZ3Uc-XU.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BZ3Uc-XU.js +0 -1
- package/dist/docs/assets/chunks/clone.BDtbEo69.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CbhzVsQE.js +0 -1
- package/dist/docs/assets/chunks/wardley-RL74JXVD.BFIVMaoi.js +0 -162
- 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-D0-FHg1x.css +0 -1
- package/dist/playground/assets/index-D5SLKUy6.js +0 -62
- /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
package/dist/types.d.ts
CHANGED
|
@@ -221,7 +221,9 @@ export interface AgentConfig {
|
|
|
221
221
|
* the discovered `agent/skills/` read-only and index them in the
|
|
222
222
|
* instructions. Pass a callback to mount the tree it returns instead,
|
|
223
223
|
* for example the discovered skills plus tenant skills. The index
|
|
224
|
-
*
|
|
224
|
+
* lists only the discovered skills that tree serves at
|
|
225
|
+
* `/<name>/SKILL.md`, asked each turn, so a tree can withhold a skill
|
|
226
|
+
* for one session by not serving it. `false` mounts nothing and
|
|
225
227
|
* drops the index. Host-disk agents get `.cursor/skills/` and ignore
|
|
226
228
|
* this field.
|
|
227
229
|
*/
|
|
@@ -373,6 +375,15 @@ export interface AgentHostingOptions {
|
|
|
373
375
|
* the next deploy.
|
|
374
376
|
*/
|
|
375
377
|
image?: string;
|
|
378
|
+
/**
|
|
379
|
+
* Customer OIDC audiences this deployment may mint for workload identity
|
|
380
|
+
* federation. Exact strings, at most 8, each 1–512 printable ASCII
|
|
381
|
+
* characters with no spaces or `*`. The Cursor exchange audience is
|
|
382
|
+
* refused even if it is listed.
|
|
383
|
+
*/
|
|
384
|
+
oidc?: {
|
|
385
|
+
audiences?: string[];
|
|
386
|
+
};
|
|
376
387
|
}
|
|
377
388
|
/**
|
|
378
389
|
* Local runtime options on {@link AgentConfig.local}.
|
|
@@ -858,6 +869,11 @@ export interface ToolContext {
|
|
|
858
869
|
* `subagent.completed`). Omitted for scratch `callTool` with no session.
|
|
859
870
|
*/
|
|
860
871
|
emit?: (payload: SessionEventPayload) => void;
|
|
872
|
+
/**
|
|
873
|
+
* Add a user message to the turn this call runs in, through `Run.steer`.
|
|
874
|
+
* See {@link SteerTurn}. Omitted for scratch `callTool` with no session.
|
|
875
|
+
*/
|
|
876
|
+
steer?: SteerTurn;
|
|
861
877
|
/**
|
|
862
878
|
* Tags for this turn. The values stay in the process and are copied
|
|
863
879
|
* onto spans, log records, and `cursor.token.usage` when those are
|
|
@@ -916,6 +932,19 @@ export type ToolNeedsApproval<TInput> = boolean | ((input: TInput) => boolean |
|
|
|
916
932
|
* run.
|
|
917
933
|
*/
|
|
918
934
|
export type ToolEffect = "read" | "write" | "idempotent";
|
|
935
|
+
/**
|
|
936
|
+
* Whose account a `cursorAccount` connection uses for a call.
|
|
937
|
+
*
|
|
938
|
+
* - `"shared"`: every call uses the account signed in on the Deployed Agents
|
|
939
|
+
* page, including a run with no person. This is the mode when
|
|
940
|
+
* {@link ConnectionConfig.credentials} is omitted.
|
|
941
|
+
* - `"individual"`: the account of the person whose message started the
|
|
942
|
+
* turn. A turn with no person, such as a schedule or a webhook, fails. It
|
|
943
|
+
* never uses another account.
|
|
944
|
+
*
|
|
945
|
+
* @experimental
|
|
946
|
+
*/
|
|
947
|
+
export type ConnectionCredentialMode = "individual" | "shared";
|
|
919
948
|
/** Authored `defineConnection({ effects })` — one effect or a set. */
|
|
920
949
|
export type ConnectionEffects = ToolEffect | readonly ToolEffect[];
|
|
921
950
|
export declare function isToolEffect(value: unknown): value is ToolEffect;
|
|
@@ -1074,6 +1103,12 @@ export interface Extension<TConfig = undefined, TInput = TConfig> extends Extens
|
|
|
1074
1103
|
(...args: undefined extends TInput ? [config?: TInput] : [config: TInput]): ExtensionMount;
|
|
1075
1104
|
/** The mounted configuration (schema defaults applied); throws before the mount. */
|
|
1076
1105
|
readonly config: TConfig;
|
|
1106
|
+
/**
|
|
1107
|
+
* The namespace the agent mounted it under (`agent/extensions/<ns>.ts`), so
|
|
1108
|
+
* the tree can name its own contributions (`<ns>__<name>`); throws until
|
|
1109
|
+
* discovery has loaded the mount.
|
|
1110
|
+
*/
|
|
1111
|
+
readonly namespace: string;
|
|
1077
1112
|
}
|
|
1078
1113
|
/** The mount-independent part of an {@link Extension}: an agent-shaped tree. */
|
|
1079
1114
|
export interface ExtensionDeclaration {
|
|
@@ -1293,6 +1328,13 @@ export type ConnectionConfig = (((Exclude<ConnectionTransport, {
|
|
|
1293
1328
|
*/
|
|
1294
1329
|
tools?: readonly string[];
|
|
1295
1330
|
}) | InlineStdioConnectionConfig) & {
|
|
1331
|
+
/**
|
|
1332
|
+
* Whose account a `cursorAccount` connection uses. See
|
|
1333
|
+
* {@link ConnectionCredentialMode}. Omit it to keep the account signed in
|
|
1334
|
+
* on the Deployed Agents page. Only valid with `cursorAccount: true`.
|
|
1335
|
+
* @experimental
|
|
1336
|
+
*/
|
|
1337
|
+
credentials?: ConnectionCredentialMode;
|
|
1296
1338
|
/** Documentation only; shown in `info` output. */
|
|
1297
1339
|
description?: string;
|
|
1298
1340
|
/**
|
|
@@ -1408,6 +1450,8 @@ export interface AuthContext {
|
|
|
1408
1450
|
principalId: string;
|
|
1409
1451
|
principalType: "user" | "service" | "runtime";
|
|
1410
1452
|
attributes?: Record<string, string>;
|
|
1453
|
+
/** The caller's display name, shown where a person reads who acted, such as an approval card. */
|
|
1454
|
+
label?: string;
|
|
1411
1455
|
}
|
|
1412
1456
|
export interface AuthRequestInfo {
|
|
1413
1457
|
/** Client IP, or null when the host cannot provide it. */
|
|
@@ -1470,6 +1514,8 @@ export interface ActionResult {
|
|
|
1470
1514
|
}
|
|
1471
1515
|
/** Human decision for a parked {@link ToolConfig.needsApproval} tool call. */
|
|
1472
1516
|
export type ApprovalDecision = "approve" | "deny";
|
|
1517
|
+
/** Why a tool approval or MCP auth wait ended with nobody's decision. */
|
|
1518
|
+
export type ApprovalEndReason = "timeout" | "interrupt";
|
|
1473
1519
|
/** Durable record of a tool call waiting on human approval. */
|
|
1474
1520
|
export interface PendingApproval {
|
|
1475
1521
|
callId: string;
|
|
@@ -1478,6 +1524,20 @@ export interface PendingApproval {
|
|
|
1478
1524
|
args: unknown;
|
|
1479
1525
|
requestedAt: string;
|
|
1480
1526
|
}
|
|
1527
|
+
/**
|
|
1528
|
+
* The host's answer to the agent's `mcp_auth` request, the same shape as
|
|
1529
|
+
* `@cursor/sdk`'s `onMcpAuthRequest`. `undefined` keeps the SDK's default.
|
|
1530
|
+
* @experimental
|
|
1531
|
+
*/
|
|
1532
|
+
export type McpAuthRequestHandler = (request: {
|
|
1533
|
+
serverName: string;
|
|
1534
|
+
toolCallId: string;
|
|
1535
|
+
}) => Promise<{
|
|
1536
|
+
kind: "approved";
|
|
1537
|
+
} | {
|
|
1538
|
+
kind: "rejected";
|
|
1539
|
+
reason: string;
|
|
1540
|
+
} | undefined>;
|
|
1481
1541
|
/** Durable record of a tool call waiting on MCP authorization. */
|
|
1482
1542
|
export interface PendingAuth {
|
|
1483
1543
|
callId: string;
|
|
@@ -1486,6 +1546,18 @@ export interface PendingAuth {
|
|
|
1486
1546
|
connection: string;
|
|
1487
1547
|
authUrl: string;
|
|
1488
1548
|
requestedAt: string;
|
|
1549
|
+
/**
|
|
1550
|
+
* Set when no turn waits on this connect. It stays until the person's next
|
|
1551
|
+
* turn finds the connection connected, or they cancel.
|
|
1552
|
+
* @experimental
|
|
1553
|
+
*/
|
|
1554
|
+
awaitsNextTurn?: true;
|
|
1555
|
+
/**
|
|
1556
|
+
* The signed user a connect that awaits the next turn was made for. Only
|
|
1557
|
+
* that user's turns reuse, cancel or resolve it.
|
|
1558
|
+
* @experimental
|
|
1559
|
+
*/
|
|
1560
|
+
userId?: number;
|
|
1489
1561
|
}
|
|
1490
1562
|
export type SessionEventPayload = {
|
|
1491
1563
|
type: "session.started";
|
|
@@ -1537,6 +1609,20 @@ export type SessionEventPayload = {
|
|
|
1537
1609
|
stepId: number;
|
|
1538
1610
|
durationMs: number;
|
|
1539
1611
|
};
|
|
1612
|
+
} | {
|
|
1613
|
+
/**
|
|
1614
|
+
* One model call finished. `usage` is that call's tokens, counted
|
|
1615
|
+
* like {@link TurnUsage}: `inputTokens` is the whole prompt, cache
|
|
1616
|
+
* reads and writes included. `modelCallId` matches
|
|
1617
|
+
* {@link ActionCall.modelCallId} on the tools that call requested.
|
|
1618
|
+
* Emitted only when the Cursor SDK reports per-call usage;
|
|
1619
|
+
* `turn.completed` still carries the turn's total.
|
|
1620
|
+
*/
|
|
1621
|
+
type: "model_call.completed";
|
|
1622
|
+
data: {
|
|
1623
|
+
modelCallId: string;
|
|
1624
|
+
usage: TurnUsage;
|
|
1625
|
+
};
|
|
1540
1626
|
} | {
|
|
1541
1627
|
type: "reasoning.appended";
|
|
1542
1628
|
data: {
|
|
@@ -1595,7 +1681,10 @@ export type SessionEventPayload = {
|
|
|
1595
1681
|
callId: string;
|
|
1596
1682
|
toolName: string;
|
|
1597
1683
|
decision: ApprovalDecision;
|
|
1684
|
+
/** The person who decided. Absent when nobody did. */
|
|
1598
1685
|
by?: string;
|
|
1686
|
+
/** Set when nobody decided: the wait timed out or the turn was interrupted. */
|
|
1687
|
+
reason?: ApprovalEndReason;
|
|
1599
1688
|
parentCallId?: string;
|
|
1600
1689
|
};
|
|
1601
1690
|
} | {
|
|
@@ -1607,6 +1696,8 @@ export type SessionEventPayload = {
|
|
|
1607
1696
|
* the person completes the `authUrl`, the turn is interrupted, or 10
|
|
1608
1697
|
* minutes pass. Other turns (schedules, reminders, webhooks, evals) do
|
|
1609
1698
|
* not emit this event. They fail the call with a "Reconnect" message.
|
|
1699
|
+
* An `"individual"` connection sets `privateTo` and does not wait: the
|
|
1700
|
+
* person connects, then clicks Connected, which starts their next turn.
|
|
1610
1701
|
*/
|
|
1611
1702
|
type: "action.auth_requested";
|
|
1612
1703
|
data: {
|
|
@@ -1615,6 +1706,27 @@ export type SessionEventPayload = {
|
|
|
1615
1706
|
connection: string;
|
|
1616
1707
|
authUrl: string;
|
|
1617
1708
|
parentCallId?: string;
|
|
1709
|
+
/**
|
|
1710
|
+
* Show `authUrl` only to this person. The turn does not wait for
|
|
1711
|
+
* them to connect. `slackUserId` is set when the turn came from
|
|
1712
|
+
* Slack. A channel that cannot reach this person shows nothing.
|
|
1713
|
+
* @experimental
|
|
1714
|
+
*/
|
|
1715
|
+
privateTo?: {
|
|
1716
|
+
slackUserId?: string;
|
|
1717
|
+
};
|
|
1718
|
+
};
|
|
1719
|
+
} | {
|
|
1720
|
+
/**
|
|
1721
|
+
* The Slack member who started this turn has no linked Cursor account,
|
|
1722
|
+
* and the agent has an `"individual"` connection. Show them, and only
|
|
1723
|
+
* them, how to link their account. The turn runs without that
|
|
1724
|
+
* connection.
|
|
1725
|
+
* @experimental
|
|
1726
|
+
*/
|
|
1727
|
+
type: "action.account_link_requested";
|
|
1728
|
+
data: {
|
|
1729
|
+
slackUserId: string;
|
|
1618
1730
|
};
|
|
1619
1731
|
} | {
|
|
1620
1732
|
type: "action.auth_resolved";
|
|
@@ -1623,7 +1735,10 @@ export type SessionEventPayload = {
|
|
|
1623
1735
|
toolName: string;
|
|
1624
1736
|
connection: string;
|
|
1625
1737
|
decision: ApprovalDecision;
|
|
1738
|
+
/** The person who decided. Absent when nobody did. */
|
|
1626
1739
|
by?: string;
|
|
1740
|
+
/** Set when nobody decided: the wait timed out or the turn was interrupted. */
|
|
1741
|
+
reason?: ApprovalEndReason;
|
|
1627
1742
|
parentCallId?: string;
|
|
1628
1743
|
};
|
|
1629
1744
|
} | {
|
|
@@ -1897,6 +2012,18 @@ export interface SessionRecord {
|
|
|
1897
2012
|
channelState?: JsonValue;
|
|
1898
2013
|
/** Cursor SDK agent id for this session. */
|
|
1899
2014
|
sdkAgentId?: string;
|
|
2015
|
+
/**
|
|
2016
|
+
* The cloud run that the newest hosted delivery started. A retry of that
|
|
2017
|
+
* delivery on another host waits on this run instead of sending the
|
|
2018
|
+
* message again.
|
|
2019
|
+
*
|
|
2020
|
+
* @internal
|
|
2021
|
+
*/
|
|
2022
|
+
hostedCloudRun?: {
|
|
2023
|
+
platformDeliveryId: string;
|
|
2024
|
+
sdkAgentId: string;
|
|
2025
|
+
runId: string;
|
|
2026
|
+
};
|
|
1900
2027
|
/**
|
|
1901
2028
|
* When set, local harness turns use this directory as `cwd` (e.g. a PR
|
|
1902
2029
|
* worktree). Session scaffold files still land under the session workspace.
|
|
@@ -2291,7 +2418,7 @@ export interface ChannelHandlerArgs {
|
|
|
2291
2418
|
* pass `sessionId` in `tag` input to attribute one).
|
|
2292
2419
|
*/
|
|
2293
2420
|
artifacts: ArtifactsApi;
|
|
2294
|
-
/** Hosted
|
|
2421
|
+
/** Hosted admission uses this to paint a warm follow-up. */
|
|
2295
2422
|
hasContinuationSession?(continuationToken: string): Promise<boolean>;
|
|
2296
2423
|
isContinuationBusy?(continuationToken: string): Promise<boolean>;
|
|
2297
2424
|
getContinuationLastBotMessageTs?(continuationToken: string): Promise<string | undefined>;
|
|
@@ -2387,7 +2514,51 @@ export interface SessionContext {
|
|
|
2387
2514
|
* auto-fills both ids and rejects a conflicting explicit `sessionId`.
|
|
2388
2515
|
*/
|
|
2389
2516
|
artifacts: ArtifactsApi;
|
|
2517
|
+
/**
|
|
2518
|
+
* Add a user message to this session's running turn through the Cursor
|
|
2519
|
+
* SDK's `Run.steer`. For a turn-scoped event it targets that event's turn
|
|
2520
|
+
* only. See {@link SteerTurn}. The host sets it on every context it builds;
|
|
2521
|
+
* it is optional so contexts built by hand, as in tests, stay valid.
|
|
2522
|
+
*/
|
|
2523
|
+
steer?: SteerTurn;
|
|
2524
|
+
}
|
|
2525
|
+
/** Options for {@link SteerTurn}. */
|
|
2526
|
+
export interface SteerTurnOptions {
|
|
2527
|
+
/**
|
|
2528
|
+
* Stamped on the `message.received` and `nudge.delivered` events a
|
|
2529
|
+
* landed steer records. Same rules as {@link SendMessageOptions.deliveryId};
|
|
2530
|
+
* omit for a fresh `dlv_…` id.
|
|
2531
|
+
*/
|
|
2532
|
+
deliveryId?: string;
|
|
2390
2533
|
}
|
|
2534
|
+
/**
|
|
2535
|
+
* What {@link SteerTurn} did.
|
|
2536
|
+
*
|
|
2537
|
+
* - `steered`: the running turn took the message. The session records
|
|
2538
|
+
* `message.received` and `nudge.delivered` with `deliveryId`.
|
|
2539
|
+
* - `no_turn`: no turn is running in this process for the session, or the
|
|
2540
|
+
* running turn is not the one this context belongs to.
|
|
2541
|
+
* - `not_delivered`: a turn is running but did not take the message:
|
|
2542
|
+
* `unsupported` when its runner cannot steer, `refused` when the SDK
|
|
2543
|
+
* reverted the steer (the turn was ending, or the run cannot be steered).
|
|
2544
|
+
*/
|
|
2545
|
+
export type SteerTurnResult = {
|
|
2546
|
+
status: "steered";
|
|
2547
|
+
turnId: string;
|
|
2548
|
+
deliveryId: string;
|
|
2549
|
+
} | {
|
|
2550
|
+
status: "no_turn";
|
|
2551
|
+
} | {
|
|
2552
|
+
status: "not_delivered";
|
|
2553
|
+
reason: "unsupported" | "refused";
|
|
2554
|
+
};
|
|
2555
|
+
/**
|
|
2556
|
+
* Add a user message to the session's running turn, as a person steering
|
|
2557
|
+
* the turn would. It never starts a turn, opens a session, or queues the
|
|
2558
|
+
* message for later: when the message cannot land now, the result says so
|
|
2559
|
+
* and nothing else happens.
|
|
2560
|
+
*/
|
|
2561
|
+
export type SteerTurn = (message: string, options?: SteerTurnOptions) => Promise<SteerTurnResult>;
|
|
2391
2562
|
/**
|
|
2392
2563
|
* Discovery stores every channel as {@link ChannelDefinition}. That definition
|
|
2393
2564
|
* types state as {@link JsonValue}. The method form lets a handler for one
|
|
@@ -2485,6 +2656,11 @@ export interface ChannelStartArgs {
|
|
|
2485
2656
|
export interface ChannelMeta {
|
|
2486
2657
|
/** Well-known pack kind, e.g. `"github"` or `"slack"`. */
|
|
2487
2658
|
kind?: string;
|
|
2659
|
+
/**
|
|
2660
|
+
* How long a parked tool call on this channel waits for Approve or Deny
|
|
2661
|
+
* before it is denied. Absent waits until a decision or a cancel.
|
|
2662
|
+
*/
|
|
2663
|
+
toolApprovalTimeoutMs?: number;
|
|
2488
2664
|
/**
|
|
2489
2665
|
* For GitHub webhook packs: the webhook event names this channel is wired
|
|
2490
2666
|
* to dispatch on. Used to derive `gh webhook forward --events`.
|
|
@@ -2539,6 +2715,28 @@ export interface ChannelMeta {
|
|
|
2539
2715
|
* by `info` so watched channels are auditable.
|
|
2540
2716
|
*/
|
|
2541
2717
|
slackChannelPosts?: readonly string[];
|
|
2718
|
+
/**
|
|
2719
|
+
* Env names this channel reads, keyed by role (`appId`, `bot`).
|
|
2720
|
+
* `envPrefix` is already normalized, or `""` when the names have no prefix.
|
|
2721
|
+
* The deploy manifest copies this. Absent when the channel takes
|
|
2722
|
+
* `credentials` directly. Older manifests omit it.
|
|
2723
|
+
*/
|
|
2724
|
+
credentialEnv?: {
|
|
2725
|
+
envPrefix: string;
|
|
2726
|
+
keys: Readonly<Record<string, string>>;
|
|
2727
|
+
};
|
|
2728
|
+
/**
|
|
2729
|
+
* For Teams packs: what wakes the agent. `channelPosts` lists the watched
|
|
2730
|
+
* channel ids and is present only when the channel watches posts.
|
|
2731
|
+
* `includeBotPosts` is present with it, and says whether posts by other
|
|
2732
|
+
* bots in those channels wake the agent.
|
|
2733
|
+
*/
|
|
2734
|
+
teamsEngagement?: {
|
|
2735
|
+
mentions: boolean;
|
|
2736
|
+
directMessages: boolean;
|
|
2737
|
+
channelPosts?: readonly string[];
|
|
2738
|
+
includeBotPosts?: boolean;
|
|
2739
|
+
};
|
|
2542
2740
|
/**
|
|
2543
2741
|
* Author-facing notices about deprecated options the pack still honored.
|
|
2544
2742
|
* Discovery surfaces each one as a `validate` warning on the channel file.
|
|
@@ -3058,6 +3256,18 @@ export interface ReminderHostApi {
|
|
|
3058
3256
|
* calls this from `setContinuationToken`; channels rarely need to.
|
|
3059
3257
|
*/
|
|
3060
3258
|
rekeyContinuation(channelId: string, oldToken: string, newToken: string): Promise<number>;
|
|
3259
|
+
/**
|
|
3260
|
+
* Fire an armed reminder as soon as the platform can, through its normal
|
|
3261
|
+
* claim, so a duplicate request never fires it twice. Returns the reminder
|
|
3262
|
+
* unchanged when it is not armed, and undefined for an unknown id.
|
|
3263
|
+
*/
|
|
3264
|
+
fireNow?(id: string): Promise<ReminderInfo | undefined>;
|
|
3265
|
+
/**
|
|
3266
|
+
* The request that `create` would send for `input`, validated the same
|
|
3267
|
+
* way, without creating the reminder. Undefined on hosts without a
|
|
3268
|
+
* reminder control plane.
|
|
3269
|
+
*/
|
|
3270
|
+
createRequest?(input: ReminderCreateInput): Promise<JsonObject>;
|
|
3061
3271
|
/**
|
|
3062
3272
|
* Fire immediately (dev / hillclimb).
|
|
3063
3273
|
* `outcome` is `"noop"` when already firing or not armed.
|
|
@@ -3156,6 +3366,12 @@ export interface DiscoveredConnection {
|
|
|
3156
3366
|
name: string;
|
|
3157
3367
|
transport: ConnectionTransport;
|
|
3158
3368
|
description?: string;
|
|
3369
|
+
/**
|
|
3370
|
+
* {@link ConnectionConfig.credentials}. Absent means the account signed in
|
|
3371
|
+
* on the Deployed Agents page.
|
|
3372
|
+
* @experimental
|
|
3373
|
+
*/
|
|
3374
|
+
credentials?: ConnectionCredentialMode;
|
|
3159
3375
|
/** Per-session auth from {@link ConnectionConfig.auth} (http/sse only). */
|
|
3160
3376
|
auth?: ConnectionAuthProvider;
|
|
3161
3377
|
/** Advertise-by-name from {@link ConnectionConfig.advertiseTools}. */
|
|
@@ -3345,6 +3561,11 @@ export interface ProjectConnectionInfo {
|
|
|
3345
3561
|
* @experimental
|
|
3346
3562
|
*/
|
|
3347
3563
|
cursorAccountServers?: string[] | "*";
|
|
3564
|
+
/**
|
|
3565
|
+
* Present when the connection sets {@link ConnectionConfig.credentials}.
|
|
3566
|
+
* @experimental
|
|
3567
|
+
*/
|
|
3568
|
+
credentials?: ConnectionCredentialMode;
|
|
3348
3569
|
}
|
|
3349
3570
|
export interface ProjectChannelInfo {
|
|
3350
3571
|
id: string;
|
|
@@ -3391,6 +3612,19 @@ export interface ProjectChannelInfo {
|
|
|
3391
3612
|
* @experimental
|
|
3392
3613
|
*/
|
|
3393
3614
|
slackChannelPosts?: readonly string[];
|
|
3615
|
+
/**
|
|
3616
|
+
* For Teams packs: what wakes the agent. `channelPosts` lists the watched
|
|
3617
|
+
* channel ids and is present only when the channel watches posts.
|
|
3618
|
+
* `includeBotPosts` is present with it, and says whether posts by other
|
|
3619
|
+
* bots in those channels wake the agent.
|
|
3620
|
+
* @experimental
|
|
3621
|
+
*/
|
|
3622
|
+
teamsEngagement?: {
|
|
3623
|
+
mentions: boolean;
|
|
3624
|
+
directMessages: boolean;
|
|
3625
|
+
channelPosts?: readonly string[];
|
|
3626
|
+
includeBotPosts?: boolean;
|
|
3627
|
+
};
|
|
3394
3628
|
}
|
|
3395
3629
|
/** JSON-safe projection of the manifest returned by `GET /v1/info`. */
|
|
3396
3630
|
export interface ProjectInfo {
|
|
@@ -3423,6 +3657,9 @@ export interface ProjectInfo {
|
|
|
3423
3657
|
egressDomains?: string[];
|
|
3424
3658
|
secretNames?: string[];
|
|
3425
3659
|
image?: string;
|
|
3660
|
+
oidc?: {
|
|
3661
|
+
audiences?: string[];
|
|
3662
|
+
};
|
|
3426
3663
|
};
|
|
3427
3664
|
/**
|
|
3428
3665
|
* Turn admission limits when authored (`concurrency` on `agent.ts`).
|
|
@@ -3617,10 +3854,49 @@ export interface RunnerTurnRequest {
|
|
|
3617
3854
|
* the local executor cache key stays stable while credentials rotate.
|
|
3618
3855
|
*/
|
|
3619
3856
|
perSendMcpServers?: boolean;
|
|
3857
|
+
/**
|
|
3858
|
+
* Decides the agent's `mcp_auth` requests on a local turn. Passed to the
|
|
3859
|
+
* SDK as `local.onMcpAuthRequest`; an SDK without that option rejects the
|
|
3860
|
+
* request as before.
|
|
3861
|
+
* @experimental
|
|
3862
|
+
*/
|
|
3863
|
+
onMcpAuthRequest?: McpAuthRequestHandler;
|
|
3864
|
+
/**
|
|
3865
|
+
* Loopback URLs of the host's own Cursor-account bridges. The backend checks
|
|
3866
|
+
* every server they relay against the team's MCP policy.
|
|
3867
|
+
*
|
|
3868
|
+
* @internal
|
|
3869
|
+
*/
|
|
3870
|
+
hostMcpBridgeUrls?: readonly string[];
|
|
3620
3871
|
subagents: RunnerSubagent[];
|
|
3621
3872
|
onUpdate: (update: RunnerUpdate) => void | Promise<void>;
|
|
3622
3873
|
/** Called once the SDK agent is open so the engine can persist its id. */
|
|
3623
3874
|
onSdkAgentId?: (sdkAgentId: string) => void | Promise<void>;
|
|
3875
|
+
/**
|
|
3876
|
+
* A cloud run to wait on instead of sending {@link prompt}: the run that an
|
|
3877
|
+
* earlier host started for this same delivery on {@link sdkAgentId}. When
|
|
3878
|
+
* that run ends without finishing, the turn sends {@link prompt} after all.
|
|
3879
|
+
*
|
|
3880
|
+
* @internal
|
|
3881
|
+
*/
|
|
3882
|
+
reattachCloudRunId?: string;
|
|
3883
|
+
/**
|
|
3884
|
+
* The hosted platform's id for the delivery this turn answers. A cloud turn
|
|
3885
|
+
* derives the id of a cloud agent it creates from it and the turn's model,
|
|
3886
|
+
* so every attempt at the delivery on one model names the same agent.
|
|
3887
|
+
*
|
|
3888
|
+
* @internal
|
|
3889
|
+
*/
|
|
3890
|
+
platformDeliveryId?: string;
|
|
3891
|
+
/**
|
|
3892
|
+
* Called once a cloud send has started its run, before the run finishes.
|
|
3893
|
+
*
|
|
3894
|
+
* @internal
|
|
3895
|
+
*/
|
|
3896
|
+
onCloudRunStarted?: (run: {
|
|
3897
|
+
sdkAgentId: string;
|
|
3898
|
+
runId: string;
|
|
3899
|
+
}) => void | Promise<void>;
|
|
3624
3900
|
/**
|
|
3625
3901
|
* Called once the harness names the run, before it produces anything.
|
|
3626
3902
|
* Surfaces the request id while the turn is still running rather than at
|