@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
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
* compatibility window. See `docs/agent-serve/hosted-delivery-protocol.md`.
|
|
6
6
|
*/
|
|
7
7
|
import { packageVersion } from "./distribution.js";
|
|
8
|
+
import { isHostedSessionId } from "./ids.js";
|
|
8
9
|
import { isRecord } from "./is-record.js";
|
|
9
10
|
function isMember(value, allowed) {
|
|
10
11
|
return allowed.some((item) => item === value);
|
|
@@ -242,8 +243,10 @@ const DELIVERY_KEYS = new Set([
|
|
|
242
243
|
"sessionMode",
|
|
243
244
|
"mailboxContinuationKey",
|
|
244
245
|
"payload",
|
|
246
|
+
"sessionPublicId",
|
|
245
247
|
"managedAutomation",
|
|
246
248
|
"platformHandoff",
|
|
249
|
+
"turnContext",
|
|
247
250
|
]);
|
|
248
251
|
const MANAGED_AUTOMATION_KEYS = new Set(["automationUuid", "mcpServerNames", "slackChannels"]);
|
|
249
252
|
export const HOSTED_PLATFORM_HANDOFF_KEYS = new Set(["v", "slackPlaceholder"]);
|
|
@@ -361,13 +364,81 @@ export function parseHostedAdmission(value) {
|
|
|
361
364
|
!boundedString(body.deliveryId, 256) ||
|
|
362
365
|
(body.sessionMode !== "event" && body.sessionMode !== "continuation") ||
|
|
363
366
|
!boundedString(body.mailboxContinuationKey, 512) ||
|
|
367
|
+
(body.sessionPublicId !== undefined && !isHostedSessionId(body.sessionPublicId)) ||
|
|
364
368
|
parseManagedAutomation(body.managedAutomation) === undefined ||
|
|
365
369
|
parsePlatformHandoff(body.platformHandoff) === undefined) {
|
|
366
370
|
return undefined;
|
|
367
371
|
}
|
|
372
|
+
const turnContext = parseTurnContext(body.turnContext);
|
|
373
|
+
if (turnContext === "invalid") {
|
|
374
|
+
return undefined;
|
|
375
|
+
}
|
|
368
376
|
const prefix = body.sessionMode === "event" ? "evt:" : "cont:";
|
|
377
|
+
if (!body.mailboxContinuationKey.startsWith(prefix)) {
|
|
378
|
+
return undefined;
|
|
379
|
+
}
|
|
369
380
|
// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- every HostedAdmission field was checked above; a record does not narrow to that interface
|
|
370
|
-
|
|
381
|
+
const admission = { ...body, turnContext };
|
|
382
|
+
if (turnContext === undefined) {
|
|
383
|
+
delete admission.turnContext;
|
|
384
|
+
}
|
|
385
|
+
return admission;
|
|
386
|
+
}
|
|
387
|
+
/**
|
|
388
|
+
* Fields this bundle does not know are ignored at every level, so a later
|
|
389
|
+
* control plane can add one. A source kind it does not know drops the
|
|
390
|
+
* context, so the turn runs with no user instead of the delivery failing.
|
|
391
|
+
*/
|
|
392
|
+
function parseTurnContext(value) {
|
|
393
|
+
if (value === undefined) {
|
|
394
|
+
return undefined;
|
|
395
|
+
}
|
|
396
|
+
if (!isRecord(value) || !boundedString(value.deploymentId, 256) || !isRecord(value.source)) {
|
|
397
|
+
return "invalid";
|
|
398
|
+
}
|
|
399
|
+
const source = parseTurnSource(value.source);
|
|
400
|
+
if (source === "invalid") {
|
|
401
|
+
return "invalid";
|
|
402
|
+
}
|
|
403
|
+
if (source === undefined) {
|
|
404
|
+
return undefined;
|
|
405
|
+
}
|
|
406
|
+
if (value.user === undefined) {
|
|
407
|
+
return { deploymentId: value.deploymentId, source };
|
|
408
|
+
}
|
|
409
|
+
const user = value.user;
|
|
410
|
+
if (!isRecord(user) ||
|
|
411
|
+
typeof user.id !== "number" ||
|
|
412
|
+
!Number.isSafeInteger(user.id) ||
|
|
413
|
+
user.id <= 0 ||
|
|
414
|
+
!boundedString(user.signature, 4096)) {
|
|
415
|
+
return "invalid";
|
|
416
|
+
}
|
|
417
|
+
return {
|
|
418
|
+
deploymentId: value.deploymentId,
|
|
419
|
+
source,
|
|
420
|
+
user: { id: user.id, signature: user.signature },
|
|
421
|
+
};
|
|
422
|
+
}
|
|
423
|
+
function parseTurnSource(source) {
|
|
424
|
+
switch (source.kind) {
|
|
425
|
+
case "slack":
|
|
426
|
+
case "teams":
|
|
427
|
+
return boundedString(source.tenantId, 128) && boundedString(source.userId, 128)
|
|
428
|
+
? { kind: source.kind, tenantId: source.tenantId, userId: source.userId }
|
|
429
|
+
: "invalid";
|
|
430
|
+
case "playground":
|
|
431
|
+
return boundedString(source.userId, 128)
|
|
432
|
+
? { kind: "playground", userId: source.userId }
|
|
433
|
+
: "invalid";
|
|
434
|
+
case "schedule":
|
|
435
|
+
case "webhook":
|
|
436
|
+
case "http":
|
|
437
|
+
case "eval":
|
|
438
|
+
return { kind: source.kind };
|
|
439
|
+
default:
|
|
440
|
+
return typeof source.kind === "string" ? undefined : "invalid";
|
|
441
|
+
}
|
|
371
442
|
}
|
|
372
443
|
export function parseHostedExecution(value) {
|
|
373
444
|
if (!isRecord(value)) {
|
|
@@ -377,8 +448,7 @@ export function parseHostedExecution(value) {
|
|
|
377
448
|
if (Object.keys(body).some((key) => !EXECUTION_KEYS.has(key)) ||
|
|
378
449
|
body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION ||
|
|
379
450
|
!boundedString(body.admissionToken, 128) ||
|
|
380
|
-
|
|
381
|
-
!/^ses_[a-f0-9]{24}$/.test(body.sessionPublicId)) {
|
|
451
|
+
!isHostedSessionId(body.sessionPublicId)) {
|
|
382
452
|
return undefined;
|
|
383
453
|
}
|
|
384
454
|
const mode = body.mode;
|
|
@@ -3,6 +3,7 @@ import { type HostedBoundSecretsResult } from "./cursor/hosted-bound-secrets.js"
|
|
|
3
3
|
import { type HostedAdmissionInput, type HostedReminderFireDescriptorPayload } from "./hosted-delivery-protocol.js";
|
|
4
4
|
import type { LogRingEntry } from "./log-ring.js";
|
|
5
5
|
import type { Router } from "./router.js";
|
|
6
|
+
import { type EngineSendOptions } from "./session-engine.js";
|
|
6
7
|
import type { SessionRunExecutionWrite } from "./session-run-log.js";
|
|
7
8
|
type DispatchInput = {
|
|
8
9
|
delivery: HostedAdmissionInput;
|
|
@@ -19,7 +20,7 @@ export type HostedSendStart = (input: {
|
|
|
19
20
|
type PendingSend = {
|
|
20
21
|
channelId: string;
|
|
21
22
|
message: string;
|
|
22
|
-
options: SendMessageOptions
|
|
23
|
+
options: SendMessageOptions & Pick<EngineSendOptions, "turnContext" | "turnSessionKey">;
|
|
23
24
|
mailboxContinuationKey: string;
|
|
24
25
|
};
|
|
25
26
|
type AdmissionDispatch = {
|
|
@@ -37,6 +38,9 @@ type AdmissionDispatch = {
|
|
|
37
38
|
* does not switch on `channelKind`.
|
|
38
39
|
*/
|
|
39
40
|
export declare function dispatchHostedAdmission(input: DispatchInput): Promise<AdmissionDispatch>;
|
|
41
|
+
type FireScheduleOptions = {
|
|
42
|
+
hostedSessionId?: string;
|
|
43
|
+
};
|
|
40
44
|
export declare function registerHostedDeliveryRoute(input: {
|
|
41
45
|
router: Router;
|
|
42
46
|
base: string;
|
|
@@ -44,7 +48,9 @@ export declare function registerHostedDeliveryRoute(input: {
|
|
|
44
48
|
id: string;
|
|
45
49
|
definition: object;
|
|
46
50
|
}>;
|
|
47
|
-
buildHandlerArgs(channelId: string, sessionPublicId?: string
|
|
51
|
+
buildHandlerArgs(channelId: string, sessionPublicId?: string, execution?: {
|
|
52
|
+
platformDeliveryId: string;
|
|
53
|
+
}): ChannelHandlerArgs;
|
|
48
54
|
/**
|
|
49
55
|
* Reserved reminder admission: dispatch a hydrated ReminderRunner fire
|
|
50
56
|
* without authored channel admission. Returns the runner's outcome so the
|
|
@@ -69,7 +75,7 @@ export declare function registerHostedDeliveryRoute(input: {
|
|
|
69
75
|
* only after every turn and `waitUntil` it started has settled. Throws
|
|
70
76
|
* {@link UnknownScheduleError} for a name this release does not declare.
|
|
71
77
|
*/
|
|
72
|
-
fireSchedule?(scheduleId: string): Promise<unknown>;
|
|
78
|
+
fireSchedule?(scheduleId: string, options: FireScheduleOptions): Promise<unknown>;
|
|
73
79
|
/**
|
|
74
80
|
* Await the session's durable mirror (dispatch chain + storage queue)
|
|
75
81
|
* before the execution reply: the control plane may park the pod the
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hosted-delivery.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AAyB1C,OAAO,EASL,KAAK,oBAAoB,EAIzB,KAAK,mCAAmC,EAYzC,MAAM,+BAA+B,CAAC;AAwBvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"hosted-delivery.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery.ts"],"names":[],"mappings":"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"}
|
|
@@ -231,7 +231,9 @@ async function dispatchHostedScheduleAdmission(input, delivery) {
|
|
|
231
231
|
return terminalHostedError(400, "invalid_schedule_payload", "Expected { protocolVersion: 1, scheduleId, scheduledAtMs }.");
|
|
232
232
|
}
|
|
233
233
|
try {
|
|
234
|
-
await input.fireSchedule(payload.scheduleId
|
|
234
|
+
await input.fireSchedule(payload.scheduleId, {
|
|
235
|
+
hostedSessionId: delivery.sessionPublicId,
|
|
236
|
+
});
|
|
235
237
|
}
|
|
236
238
|
catch (error) {
|
|
237
239
|
if (error instanceof UnknownScheduleError) {
|
|
@@ -509,7 +511,16 @@ export function registerHostedDeliveryRoute(input) {
|
|
|
509
511
|
pruneExpired();
|
|
510
512
|
const admissionToken = randomBytes(24).toString("hex");
|
|
511
513
|
pending.set(admissionToken, {
|
|
512
|
-
send:
|
|
514
|
+
send: {
|
|
515
|
+
...admitted.pendingSend,
|
|
516
|
+
options: {
|
|
517
|
+
...admitted.pendingSend.options,
|
|
518
|
+
turnContext: delivery.turnContext,
|
|
519
|
+
// The key this admission was signed under, not the session
|
|
520
|
+
// record's: a resumed session keeps its original record key.
|
|
521
|
+
turnSessionKey: delivery.mailboxContinuationKey,
|
|
522
|
+
},
|
|
523
|
+
},
|
|
513
524
|
channelKind: delivery.channelKind,
|
|
514
525
|
expiresAt: Date.now() + pendingTtlMs,
|
|
515
526
|
deliveryId: delivery.deliveryId,
|
|
@@ -770,7 +781,7 @@ export function registerHostedDeliveryRoute(input) {
|
|
|
770
781
|
let completionAt;
|
|
771
782
|
let drainAt;
|
|
772
783
|
try {
|
|
773
|
-
const args = input.buildHandlerArgs(admitted.send.channelId, execution.sessionPublicId);
|
|
784
|
+
const args = input.buildHandlerArgs(admitted.send.channelId, execution.sessionPublicId, { platformDeliveryId: admitted.deliveryId });
|
|
774
785
|
const options = {
|
|
775
786
|
...admitted.send.options,
|
|
776
787
|
mailboxContinuation: {
|
|
@@ -11,6 +11,7 @@ export function hostedSessionFixture(teamId, slug = "danny") {
|
|
|
11
11
|
statusMessage: null,
|
|
12
12
|
},
|
|
13
13
|
logClient(args) {
|
|
14
|
+
// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- the fixture implements only the log methods these tests call
|
|
14
15
|
return {
|
|
15
16
|
async getAgentkitDeploymentLogs() {
|
|
16
17
|
return [{ sessionId: "ses_new", lines: args.lines ?? ["turn started"] }];
|
|
@@ -27,7 +28,6 @@ export function hostedSessionFixture(teamId, slug = "danny") {
|
|
|
27
28
|
getAgentkitSessionEvents(eventArgs) {
|
|
28
29
|
return args.events(eventArgs.afterEventIndex);
|
|
29
30
|
},
|
|
30
|
-
// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- the fixture implements only the log methods these tests call
|
|
31
31
|
};
|
|
32
32
|
},
|
|
33
33
|
};
|
|
@@ -24,6 +24,11 @@ export declare function validateContainerImageName(name: string): string | undef
|
|
|
24
24
|
* `hosting.secretNames` or pass them to secret commands.
|
|
25
25
|
*/
|
|
26
26
|
export declare const PLATFORM_HOSTED_STORAGE_SECRET_NAMES: readonly ["AGENT_SERVE_DEPLOYMENT_ID"];
|
|
27
|
+
/**
|
|
28
|
+
* Per-installation key that signs the webhooks Cursor services send to the
|
|
29
|
+
* deployment's own channels. Cursor hosting mints it and binds it into the env.
|
|
30
|
+
*/
|
|
31
|
+
export declare const PLATFORM_WEBHOOK_SECRET_NAME = "AGENT_SERVE_WEBHOOK_SECRET";
|
|
27
32
|
/** Returns a human error message, or undefined when the domain is valid. */
|
|
28
33
|
export declare function validateEgressDomain(domain: string): string | undefined;
|
|
29
34
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hosting.d.ts","sourceRoot":"","sources":["../../src/internal/hosting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,kCAAkC;AAClC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,YAAY,CAAC;AACrD,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,sDAAsD;AACtD,eAAO,MAAM,yBAAyB,EAAE,MAA+B,CAAC;AAIxE,gFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK3E;AAED;;;GAGG;AACH,eAAO,MAAM,oCAAoC,YAAI,2BAA2B,CAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"hosting.d.ts","sourceRoot":"","sources":["../../src/internal/hosting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,kCAAkC;AAClC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,YAAY,CAAC;AACrD,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,sDAAsD;AACtD,eAAO,MAAM,yBAAyB,EAAE,MAA+B,CAAC;AAIxE,gFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK3E;AAED;;;GAGG;AACH,eAAO,MAAM,oCAAoC,YAAI,2BAA2B,CAAU,CAAC;AAE3F;;;GAGG;AACH,eAAO,MAAM,4BAA4B,+BAA+B,CAAC;AAWzE,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASvE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKtF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQnE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAS1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE;IAC3C,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,GAAG,MAAM,EAAE,CAmBX;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS3E;AAQD,8IAA8I;AAC9I,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D"}
|
package/dist/internal/hosting.js
CHANGED
|
@@ -30,6 +30,11 @@ export function validateContainerImageName(name) {
|
|
|
30
30
|
* `hosting.secretNames` or pass them to secret commands.
|
|
31
31
|
*/
|
|
32
32
|
export const PLATFORM_HOSTED_STORAGE_SECRET_NAMES = ["AGENT_SERVE_DEPLOYMENT_ID"];
|
|
33
|
+
/**
|
|
34
|
+
* Per-installation key that signs the webhooks Cursor services send to the
|
|
35
|
+
* deployment's own channels. Cursor hosting mints it and binds it into the env.
|
|
36
|
+
*/
|
|
37
|
+
export const PLATFORM_WEBHOOK_SECRET_NAME = "AGENT_SERVE_WEBHOOK_SECRET";
|
|
33
38
|
const SECRET_NAME_PATTERN = /^[A-Z][A-Z0-9_]*$/;
|
|
34
39
|
// Lowercase hostname with >=2 labels, an alphabetic TLD, and at most one
|
|
35
40
|
// leading `*.` wildcard. Labels: alphanumeric with interior hyphens.
|
|
@@ -80,7 +85,8 @@ export function isReservedSecretName(name) {
|
|
|
80
85
|
return true;
|
|
81
86
|
}
|
|
82
87
|
const upper = name.toUpperCase();
|
|
83
|
-
return
|
|
88
|
+
return (upper === PLATFORM_WEBHOOK_SECRET_NAME ||
|
|
89
|
+
PLATFORM_HOSTED_STORAGE_SECRET_NAMES.some((managed) => managed === upper));
|
|
84
90
|
}
|
|
85
91
|
/**
|
|
86
92
|
* Grammar and platform-managed-name errors in declared egress domains and
|
package/dist/internal/ids.d.ts
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
/** Fresh session id (`ses_<24 hex>` — a single safe path segment). */
|
|
2
2
|
export declare function newSessionId(): string;
|
|
3
|
+
/** A platform session id: `ses_` plus 24 lowercase hex characters. */
|
|
4
|
+
export declare function isHostedSessionId(value: unknown): value is string;
|
|
3
5
|
/** Fresh delivery id for one `send()` (`dlv_<24 hex>`). */
|
|
4
6
|
export declare function newDeliveryId(): string;
|
|
5
7
|
export declare const MAX_DELIVERY_ID_LENGTH = 256;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/internal/ids.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/internal/ids.ts"],"names":[],"mappings":"AAIA,sEAAsE;AACtE,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEjE;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAc5D;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS/F"}
|
package/dist/internal/ids.js
CHANGED
|
@@ -1,8 +1,13 @@
|
|
|
1
1
|
import { randomBytes } from "node:crypto";
|
|
2
|
+
const HOSTED_SESSION_ID_RE = /^ses_[a-f0-9]{24}$/;
|
|
2
3
|
/** Fresh session id (`ses_<24 hex>` — a single safe path segment). */
|
|
3
4
|
export function newSessionId() {
|
|
4
5
|
return `ses_${randomBytes(12).toString("hex")}`;
|
|
5
6
|
}
|
|
7
|
+
/** A platform session id: `ses_` plus 24 lowercase hex characters. */
|
|
8
|
+
export function isHostedSessionId(value) {
|
|
9
|
+
return typeof value === "string" && HOSTED_SESSION_ID_RE.test(value);
|
|
10
|
+
}
|
|
6
11
|
/** Fresh delivery id for one `send()` (`dlv_<24 hex>`). */
|
|
7
12
|
export function newDeliveryId() {
|
|
8
13
|
return `dlv_${randomBytes(12).toString("hex")}`;
|
|
@@ -25,10 +25,8 @@ export declare const CURSOR_JULY_SKILLS_HOME_ENV = "CURSOR_JULY_SKILLS_HOME";
|
|
|
25
25
|
/** Set to `1` to skip the postinstall skill copy. */
|
|
26
26
|
export declare const CURSOR_JULY_SKIP_SKILL_INSTALL_ENV = "CURSOR_JULY_SKIP_SKILL_INSTALL";
|
|
27
27
|
export interface PackageSkill {
|
|
28
|
-
/** Frontmatter `name` (e.g. agent-sdk-
|
|
28
|
+
/** Frontmatter `name` (e.g. agent-sdk-debug), also the install folder under agent-sdk/. */
|
|
29
29
|
name: string;
|
|
30
|
-
/** Leaf install directory under agent-sdk/ (e.g. create-agent). */
|
|
31
|
-
leafDir: string;
|
|
32
30
|
/** Absolute path to the source skill directory in the package. */
|
|
33
31
|
sourceDir: string;
|
|
34
32
|
/** Exact package version that supplied this skill. */
|
|
@@ -44,10 +42,11 @@ export declare function cursorSkillsHome(home?: string): string;
|
|
|
44
42
|
export declare function isConsumerPackageInstall(packageRoot: string): boolean;
|
|
45
43
|
/** `~/.cursor/skills/agent-sdk` — where package skills are installed. */
|
|
46
44
|
export declare function bdkCursorSkillsDir(skillsHome?: string): string;
|
|
47
|
-
/** Absolute install path for one skill: `…/agent-sdk/<
|
|
48
|
-
export declare function skillInstallPath(skill: Pick<PackageSkill, "
|
|
45
|
+
/** Absolute install path for one skill: `…/agent-sdk/<name>`. */
|
|
46
|
+
export declare function skillInstallPath(skill: Pick<PackageSkill, "name">, skillsHome?: string): string;
|
|
49
47
|
/**
|
|
50
|
-
* Skills shipped next to the running package
|
|
48
|
+
* Skills shipped next to the running package that this installer copies:
|
|
49
|
+
* every one except those Cursor already serves. Uses the frontmatter `name`
|
|
51
50
|
* when present, otherwise `agent-sdk-<dir>`.
|
|
52
51
|
*/
|
|
53
52
|
export declare function listShippedPackageSkills(packageRoot?: string): Promise<PackageSkill[]>;
|
|
@@ -71,7 +70,7 @@ export interface SkillInstallResult {
|
|
|
71
70
|
removedLegacyDirs: string[];
|
|
72
71
|
}
|
|
73
72
|
/**
|
|
74
|
-
* Copy each skill directory into `skillsHome/agent-sdk/<
|
|
73
|
+
* Copy each skill directory into `skillsHome/agent-sdk/<name>/`.
|
|
75
74
|
* Always overwrites so a package upgrade refreshes local Cursor skills.
|
|
76
75
|
* Strips monorepo-only frontmatter, sets `alwaysApply: true` so Cursor
|
|
77
76
|
* loads the body into context, and removes leaf dirs no longer shipped.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"install-cursor-skills.d.ts","sourceRoot":"","sources":["../../src/internal/install-cursor-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAwBnD,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AAErE,qDAAqD;AACrD,eAAO,MAAM,kCAAkC,mCAAmC,CAAC;AAEnF,MAAM,WAAW,YAAY;IAC3B,
|
|
1
|
+
{"version":3,"file":"install-cursor-skills.d.ts","sourceRoot":"","sources":["../../src/internal/install-cursor-skills.ts"],"names":[],"mappings":"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"}
|
|
@@ -78,12 +78,15 @@ export function bdkCursorSkillsDir(skillsHome = cursorSkillsHome()) {
|
|
|
78
78
|
function legacyCursorSkillsDirs(skillsHome) {
|
|
79
79
|
return LEGACY_CURSOR_SKILLS_NAMESPACES.map((name) => join(skillsHome, name));
|
|
80
80
|
}
|
|
81
|
-
/** Absolute install path for one skill: `…/agent-sdk/<
|
|
81
|
+
/** Absolute install path for one skill: `…/agent-sdk/<name>`. */
|
|
82
82
|
export function skillInstallPath(skill, skillsHome = cursorSkillsHome()) {
|
|
83
|
-
return join(bdkCursorSkillsDir(skillsHome), skill.
|
|
83
|
+
return join(bdkCursorSkillsDir(skillsHome), skill.name);
|
|
84
84
|
}
|
|
85
|
+
/** Cursor already provides these skills, so an installed copy would list them twice. */
|
|
86
|
+
const CURSOR_BUILTIN_SKILL_NAMES = new Set(["agent-sdk-create-agent"]);
|
|
85
87
|
/**
|
|
86
|
-
* Skills shipped next to the running package
|
|
88
|
+
* Skills shipped next to the running package that this installer copies:
|
|
89
|
+
* every one except those Cursor already serves. Uses the frontmatter `name`
|
|
87
90
|
* when present, otherwise `agent-sdk-<dir>`.
|
|
88
91
|
*/
|
|
89
92
|
export async function listShippedPackageSkills(packageRoot = packageRootDir()) {
|
|
@@ -111,9 +114,12 @@ export async function listShippedPackageSkills(packageRoot = packageRootDir()) {
|
|
|
111
114
|
}
|
|
112
115
|
const raw = await readFile(skillMd, "utf8");
|
|
113
116
|
const name = parseFrontmatter(raw).data.name || `${CURSOR_SKILLS_NAMESPACE}-${entry.name}`;
|
|
114
|
-
|
|
117
|
+
if (CURSOR_BUILTIN_SKILL_NAMES.has(name)) {
|
|
118
|
+
continue;
|
|
119
|
+
}
|
|
120
|
+
skills.push({ name, sourceDir, packageVersion, packageName });
|
|
115
121
|
}
|
|
116
|
-
skills.sort((a, b) => a.
|
|
122
|
+
skills.sort((a, b) => a.name.localeCompare(b.name));
|
|
117
123
|
return skills;
|
|
118
124
|
}
|
|
119
125
|
const PACKAGE_VERSION_PLACEHOLDER = "__BDK_VERSION__";
|
|
@@ -155,7 +161,7 @@ export async function findMissingCursorSkills(options) {
|
|
|
155
161
|
return missing;
|
|
156
162
|
}
|
|
157
163
|
/**
|
|
158
|
-
* Copy each skill directory into `skillsHome/agent-sdk/<
|
|
164
|
+
* Copy each skill directory into `skillsHome/agent-sdk/<name>/`.
|
|
159
165
|
* Always overwrites so a package upgrade refreshes local Cursor skills.
|
|
160
166
|
* Strips monorepo-only frontmatter, sets `alwaysApply: true` so Cursor
|
|
161
167
|
* loads the body into context, and removes leaf dirs no longer shipped.
|
|
@@ -183,7 +189,7 @@ export async function installCursorSkills(skills, skillsHome = cursorSkillsHome(
|
|
|
183
189
|
if (adjusted !== raw) {
|
|
184
190
|
await writeFile(skillMdPath, adjusted, "utf8");
|
|
185
191
|
}
|
|
186
|
-
installed.push(skill.
|
|
192
|
+
installed.push(skill.name);
|
|
187
193
|
}
|
|
188
194
|
const removedLegacyDirs = await removeLegacyCursorSkillsNamespaces(skillsHome);
|
|
189
195
|
return { installed, removed, removedLegacyDirs };
|
|
@@ -210,7 +216,7 @@ async function addOwnerWrite(path) {
|
|
|
210
216
|
}
|
|
211
217
|
/** Installed leaf dirs the package no longer ships. Installing deletes these. */
|
|
212
218
|
async function orphanLeaves(namespaceDir, skills) {
|
|
213
|
-
const shipped = new Set(skills.map((skill) => skill.
|
|
219
|
+
const shipped = new Set(skills.map((skill) => skill.name));
|
|
214
220
|
let entries;
|
|
215
221
|
try {
|
|
216
222
|
entries = await readdir(namespaceDir, { withFileTypes: true });
|
|
@@ -341,7 +347,7 @@ export async function planSkillInstall(options) {
|
|
|
341
347
|
shipped,
|
|
342
348
|
skillsHome,
|
|
343
349
|
directory,
|
|
344
|
-
leaves: shipped.map((skill) => skill.
|
|
350
|
+
leaves: shipped.map((skill) => skill.name),
|
|
345
351
|
firstInstall: present.every((isPresent) => !isPresent),
|
|
346
352
|
orphans: await orphanLeaves(directory, shipped),
|
|
347
353
|
legacyDirs: await existingLegacyCursorSkillsDirs(skillsHome),
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
import * as z from "zod/v4";
|
|
7
7
|
import { type InterviewField } from "./question.js";
|
|
8
8
|
export declare const PURPOSES: readonly ["chat", "repo-automation", "domain-assistant", "scheduled-reporter", "other"];
|
|
9
|
-
export declare const CHANNELS: readonly ["slack", "github", "webhook", "schedule"];
|
|
9
|
+
export declare const CHANNELS: readonly ["slack", "teams", "github", "webhook", "schedule"];
|
|
10
10
|
export declare const MCP_KINDS: readonly ["cursor-account", "remote", "stdio"];
|
|
11
11
|
export declare const CAPABILITIES: readonly ["server-tools", "agent-tools", "skills", "subagents", "hooks", "sandbox-seeds", "evals"];
|
|
12
12
|
export type Purpose = (typeof PURPOSES)[number];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-questions.d.ts","sourceRoot":"","sources":["../../../src/internal/interview/agent-questions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,EAAS,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3D,eAAO,MAAM,QAAQ,YACnB,MAAM,EACN,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,OAAO,CACC,CAAC;AACX,eAAO,MAAM,QAAQ,YAAI,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"agent-questions.d.ts","sourceRoot":"","sources":["../../../src/internal/interview/agent-questions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,EAAS,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3D,eAAO,MAAM,QAAQ,YACnB,MAAM,EACN,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,OAAO,CACC,CAAC;AACX,eAAO,MAAM,QAAQ,YAAI,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AACrF,eAAO,MAAM,SAAS,YAAI,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AACxE,eAAO,MAAM,YAAY,YACvB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,WAAW,EACX,OAAO,EACP,eAAe,EACf,OAAO,CACC,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAKhD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAehD,eAAO,MAAM,gBAAgB,EAAE,MAAiB,CAAC;AAEjD,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAKpC,CAAC;AAEL,eAAO,MAAM,YAAY,EAAE,SAAS,cAAc,EA4FjD,CAAC;AAOF,iDAAiD;AACjD,wBAAgB,qBAAqB,IAAI,MAAM,CAY9C"}
|
|
@@ -14,7 +14,7 @@ export const PURPOSES = [
|
|
|
14
14
|
"scheduled-reporter",
|
|
15
15
|
"other",
|
|
16
16
|
];
|
|
17
|
-
export const CHANNELS = ["slack", "github", "webhook", "schedule"];
|
|
17
|
+
export const CHANNELS = ["slack", "teams", "github", "webhook", "schedule"];
|
|
18
18
|
export const MCP_KINDS = ["cursor-account", "remote", "stdio"];
|
|
19
19
|
export const CAPABILITIES = [
|
|
20
20
|
"server-tools",
|
|
@@ -72,16 +72,17 @@ export const AGENT_FIELDS = [
|
|
|
72
72
|
id: "channels",
|
|
73
73
|
label: "Channels",
|
|
74
74
|
prompt: "Channels beyond the playground and HTTP?",
|
|
75
|
-
hint: "Slack: `skills/setup-slack/SKILL.md`. GitHub: `skills/github/SKILL.md`. No Discord
|
|
75
|
+
hint: "Slack: `skills/setup-slack/SKILL.md`. Teams: `skills/setup-teams/SKILL.md`. GitHub: `skills/github/SKILL.md`. No Discord pack; offer custom webhook.",
|
|
76
76
|
multi: true,
|
|
77
77
|
choices: [
|
|
78
78
|
{ value: "slack", label: "Slack" },
|
|
79
|
+
{ value: "teams", label: "Microsoft Teams" },
|
|
79
80
|
{ value: "github", label: "GitHub" },
|
|
80
81
|
{ value: "webhook", label: "custom webhook" },
|
|
81
82
|
{ value: "schedule", label: "schedule" },
|
|
82
83
|
],
|
|
83
84
|
default: (answers) => isPurpose(answers.purpose) ? PURPOSE_CHANNELS[answers.purpose] : "none",
|
|
84
|
-
}, z.array(z.enum(CHANNELS)), "playground + HTTP (always on) · Slack · GitHub · custom webhook · schedule"),
|
|
85
|
+
}, z.array(z.enum(CHANNELS)), "playground + HTTP (always on) · Slack · Microsoft Teams · GitHub · custom webhook · schedule"),
|
|
85
86
|
field("surface", {
|
|
86
87
|
id: "mcp",
|
|
87
88
|
label: "MCP",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"local-control-plane.d.ts","sourceRoot":"","sources":["../../src/internal/local-control-plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,kCAAkC,EAExC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAKL,KAAK,oBAAoB,EAIzB,KAAK,qBAAqB,EAI3B,MAAM,sCAAsC,CAAC;AAI9C,MAAM,WAAW,iBAAkB,SAAQ,cAAc,EAAE,oBAAoB;IAC7E;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,kCAAkC,GAAG,wBAAwB,CAAC;IACvF;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE;QAAE,KAAK,IAAI,IAAI,CAAC;QAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,yEAAyE;IACzE,WAAW,IAAI,IAAI,CAAC;IACpB,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE;;;OAGG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,iBAAiB,CAAC,
|
|
1
|
+
{"version":3,"file":"local-control-plane.d.ts","sourceRoot":"","sources":["../../src/internal/local-control-plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,kCAAkC,EAExC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAKL,KAAK,oBAAoB,EAIzB,KAAK,qBAAqB,EAI3B,MAAM,sCAAsC,CAAC;AAI9C,MAAM,WAAW,iBAAkB,SAAQ,cAAc,EAAE,oBAAoB;IAC7E;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,kCAAkC,GAAG,wBAAwB,CAAC;IACvF;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE;QAAE,KAAK,IAAI,IAAI,CAAC;QAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,yEAAyE;IACzE,WAAW,IAAI,IAAI,CAAC;IACpB,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE;;;OAGG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4Y7B"}
|
|
@@ -266,6 +266,30 @@ export async function createLocalControlPlane(opts) {
|
|
|
266
266
|
await persist(updated);
|
|
267
267
|
return updated;
|
|
268
268
|
},
|
|
269
|
+
async fireReminderNow(id) {
|
|
270
|
+
const current = reminders.get(id);
|
|
271
|
+
const nowMs = Date.now();
|
|
272
|
+
// With clocks off (`--dev`) no timer claims the reminder, so fire it here.
|
|
273
|
+
if (!armReminderClocks && current?.status === "armed") {
|
|
274
|
+
await persist({ ...current, nextFireAtMs: Math.min(current.nextFireAtMs, nowMs) });
|
|
275
|
+
await onReminderDue(id);
|
|
276
|
+
return reminders.get(id);
|
|
277
|
+
}
|
|
278
|
+
if (current === undefined || current.status !== "armed" || current.nextFireAtMs <= nowMs) {
|
|
279
|
+
return current;
|
|
280
|
+
}
|
|
281
|
+
const updated = {
|
|
282
|
+
...current,
|
|
283
|
+
nextFireAtMs: nowMs,
|
|
284
|
+
generation: recordGeneration(current) + 1,
|
|
285
|
+
updatedAt: new Date(nowMs).toISOString(),
|
|
286
|
+
};
|
|
287
|
+
await persist(updated);
|
|
288
|
+
if (armReminderClocks) {
|
|
289
|
+
armReminder(updated);
|
|
290
|
+
}
|
|
291
|
+
return updated;
|
|
292
|
+
},
|
|
269
293
|
async rekeyReminders(channelId, oldToken, newToken) {
|
|
270
294
|
let n = 0;
|
|
271
295
|
for (const record of [...reminders.values()]) {
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Reads the allowlist the Cursor MCP gateway reports on `tools/list`, under
|
|
3
|
+
* `_meta.mcpAllowlist`. The report is display only. A listing without the key
|
|
4
|
+
* or with a malformed one reads as no report, and never fails the listing.
|
|
5
|
+
*/
|
|
6
|
+
export interface McpAllowlistInUse {
|
|
7
|
+
/** `other` is a list this client does not know by name. */
|
|
8
|
+
list: "local" | "cloud" | "other";
|
|
9
|
+
name: string;
|
|
10
|
+
reason: string;
|
|
11
|
+
/** The servers the listing was allowed to return, by display name when the gateway sent names. Absent when it did not say. */
|
|
12
|
+
allowedServers?: string[];
|
|
13
|
+
/** The caller's servers the list kept out of the listing. Absent when the gateway did not say. */
|
|
14
|
+
blockedServers?: string[];
|
|
15
|
+
}
|
|
16
|
+
/** The allowlist report in a `tools/list` result's `_meta`, or undefined when absent or malformed. */
|
|
17
|
+
export declare function parseMcpAllowlistInUse(meta: unknown): McpAllowlistInUse | undefined;
|
|
18
|
+
/**
|
|
19
|
+
* The list, why it applies, the servers it allowed and the ones it blocked, as
|
|
20
|
+
* sentences that follow a caller's own lead-in.
|
|
21
|
+
*/
|
|
22
|
+
export declare function describeMcpAllowlistInUse(inUse: McpAllowlistInUse): string;
|
|
23
|
+
//# sourceMappingURL=mcp-allowlist-in-use.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp-allowlist-in-use.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-allowlist-in-use.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,8HAA8H;IAC9H,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kGAAkG;IAClG,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAmBD,sGAAsG;AACtG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CA8BnF;AAwCD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAE1E"}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Reads the allowlist the Cursor MCP gateway reports on `tools/list`, under
|
|
3
|
+
* `_meta.mcpAllowlist`. The report is display only. A listing without the key
|
|
4
|
+
* or with a malformed one reads as no report, and never fails the listing.
|
|
5
|
+
*/
|
|
6
|
+
import { isRecord } from "./is-record.js";
|
|
7
|
+
const MAX_TEXT_LENGTH = 200;
|
|
8
|
+
const MAX_SERVER_NAME_LENGTH = 200;
|
|
9
|
+
const MAX_SERVERS = 200;
|
|
10
|
+
const MAX_SERVERS_SHOWN = 20;
|
|
11
|
+
/** One line of printable text within `maxLength`, or undefined. */
|
|
12
|
+
function displayText(value, maxLength) {
|
|
13
|
+
if (typeof value !== "string") {
|
|
14
|
+
return undefined;
|
|
15
|
+
}
|
|
16
|
+
const text = value.trim();
|
|
17
|
+
if (text === "" || text.length > maxLength || /\p{Cc}/u.test(text)) {
|
|
18
|
+
return undefined;
|
|
19
|
+
}
|
|
20
|
+
return text;
|
|
21
|
+
}
|
|
22
|
+
/** The allowlist report in a `tools/list` result's `_meta`, or undefined when absent or malformed. */
|
|
23
|
+
export function parseMcpAllowlistInUse(meta) {
|
|
24
|
+
if (!isRecord(meta)) {
|
|
25
|
+
return undefined;
|
|
26
|
+
}
|
|
27
|
+
const reported = meta.mcpAllowlist;
|
|
28
|
+
if (!isRecord(reported) || typeof reported.list !== "string") {
|
|
29
|
+
return undefined;
|
|
30
|
+
}
|
|
31
|
+
const name = displayText(reported.name, MAX_TEXT_LENGTH);
|
|
32
|
+
const reason = displayText(reported.reason, MAX_TEXT_LENGTH);
|
|
33
|
+
if (name === undefined || reason === undefined) {
|
|
34
|
+
return undefined;
|
|
35
|
+
}
|
|
36
|
+
const inUse = {
|
|
37
|
+
list: reported.list === "local" || reported.list === "cloud" ? reported.list : "other",
|
|
38
|
+
name,
|
|
39
|
+
reason,
|
|
40
|
+
};
|
|
41
|
+
// `allowedServerNames` holds display names. `allowedServers` can hold
|
|
42
|
+
// connection identifiers, so it is read only when the names are absent.
|
|
43
|
+
const allowedServers = serverNames(reported.allowedServerNames) ?? serverNames(reported.allowedServers);
|
|
44
|
+
if (allowedServers !== undefined) {
|
|
45
|
+
inUse.allowedServers = allowedServers;
|
|
46
|
+
}
|
|
47
|
+
const blockedServers = serverNames(reported.blockedServers);
|
|
48
|
+
if (blockedServers !== undefined) {
|
|
49
|
+
inUse.blockedServers = blockedServers;
|
|
50
|
+
}
|
|
51
|
+
return inUse;
|
|
52
|
+
}
|
|
53
|
+
/** The printable names in a reported server list, or undefined when it is not a list. */
|
|
54
|
+
function serverNames(reported) {
|
|
55
|
+
if (!Array.isArray(reported)) {
|
|
56
|
+
return undefined;
|
|
57
|
+
}
|
|
58
|
+
const names = [];
|
|
59
|
+
for (const server of reported.slice(0, MAX_SERVERS)) {
|
|
60
|
+
const serverName = displayText(server, MAX_SERVER_NAME_LENGTH);
|
|
61
|
+
if (serverName !== undefined) {
|
|
62
|
+
names.push(serverName);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
return names;
|
|
66
|
+
}
|
|
67
|
+
/** `names` after `label`, the first few by name and the rest as a count. */
|
|
68
|
+
function serversSentence(label, names) {
|
|
69
|
+
const shown = names.slice(0, MAX_SERVERS_SHOWN).join(", ");
|
|
70
|
+
const more = names.length - MAX_SERVERS_SHOWN;
|
|
71
|
+
return more > 0 ? ` ${label}: ${shown}, and ${more} more.` : ` ${label}: ${shown}.`;
|
|
72
|
+
}
|
|
73
|
+
function allowedServersSentence(allowedServers) {
|
|
74
|
+
if (allowedServers === undefined) {
|
|
75
|
+
return "";
|
|
76
|
+
}
|
|
77
|
+
return allowedServers.length === 0
|
|
78
|
+
? " Allowed servers: none."
|
|
79
|
+
: serversSentence("Allowed servers", allowedServers);
|
|
80
|
+
}
|
|
81
|
+
/** Nothing when the gateway named no blocked server. */
|
|
82
|
+
function blockedServersSentence(blockedServers) {
|
|
83
|
+
return blockedServers === undefined || blockedServers.length === 0
|
|
84
|
+
? ""
|
|
85
|
+
: serversSentence("Blocked", blockedServers);
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* The list, why it applies, the servers it allowed and the ones it blocked, as
|
|
89
|
+
* sentences that follow a caller's own lead-in.
|
|
90
|
+
*/
|
|
91
|
+
export function describeMcpAllowlistInUse(inUse) {
|
|
92
|
+
return `${inUse.name}, which applies because ${inUse.reason}.${allowedServersSentence(inUse.allowedServers)}${blockedServersSentence(inUse.blockedServers)}`;
|
|
93
|
+
}
|