@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
|
@@ -10,10 +10,10 @@ import { classifyExpectedDeliveryFailure } from "./expected-delivery-failure.js"
|
|
|
10
10
|
import { formatGuestNetworkServerTiming, GUEST_CONNECT_STALLED, GUEST_NETWORK_UNAVAILABLE, GuestNetworkUnavailableError, waitForGuestNetworkReady, } from "./guest-network.js";
|
|
11
11
|
import { getHostedAdmissionAdapter, } from "./hosted-admission-adapter.js";
|
|
12
12
|
import { HostedAdmissionLocalSendError, runDuringHostedAdmission, } from "./hosted-admission-context.js";
|
|
13
|
-
import { HOSTED_ADMISSION_PATH, HOSTED_DELIVERY_HEADER, HOSTED_DELIVERY_PROTOCOL_VERSION, HOSTED_EXECUTION_PATH, HOSTED_GUEST_RETRY_TERMINAL, HOSTED_GUEST_RETRY_TRANSIENT, HOSTED_MAX_CONSUMED_DELIVERY_IDS, hostedFailureClassification, hostedGuestErrorResponse, isHostedReminderAdmission, isHostedScheduleAdmission, parseHostedAdmissionHandlerRejection, parseHostedAdmission, parseHostedExecution, parseHostedReminderFireDescriptorPayload, parseHostedReminderFirePayload, parseHostedScheduleFirePayload, } from "./hosted-delivery-protocol.js";
|
|
13
|
+
import { HOSTED_ADMISSION_PATH, HOSTED_DELIVERY_HEADER, HOSTED_DELIVERY_PROTOCOL_VERSION, HOSTED_EXECUTION_PATH, HOSTED_GUEST_RETRY_TERMINAL, HOSTED_GUEST_RETRY_TRANSIENT, HOSTED_MAX_CONSUMED_DELIVERY_IDS, HOSTED_SERVER_TIMING_STEP, hostedFailureClassification, hostedGuestErrorResponse, isHostedReminderAdmission, isHostedScheduleAdmission, parseHostedAdmissionHandlerRejection, parseHostedAdmission, parseHostedExecution, parseHostedReminderFireDescriptorPayload, parseHostedReminderFirePayload, parseHostedScheduleFirePayload, } from "./hosted-delivery-protocol.js";
|
|
14
14
|
import { abortReasonFromTurnStatus, HOSTED_EXECUTION_DIAG_RUNNING_STATUS, hostedExecutionDiagId, } from "./hosted-execution-diag.js";
|
|
15
15
|
import { flushDurableHostedExecutionRecord, refreshStartLogWhile, writeLocalHostedExecutionRecord, } from "./hosted-execution-flush.js";
|
|
16
|
-
import { finalizeHostedExecutionLatency, formatHostedExecutionLatencyServerTiming, hostedExecutionNow, runWithHostedExecutionLatency, } from "./hosted-execution-latency.js";
|
|
16
|
+
import { finalizeHostedExecutionLatency, formatHostedExecutionLatencyServerTiming, hostedExecutionNow, hostedTurnStartedAt, runWithHostedExecutionLatency, } from "./hosted-execution-latency.js";
|
|
17
17
|
import { recordHostedManagedAutomation } from "./hosted-managed-automation.js";
|
|
18
18
|
import { readJsonObject } from "./http-channel.js";
|
|
19
19
|
import { resolveDeliveryId } from "./ids.js";
|
|
@@ -360,7 +360,7 @@ async function handlerRejection(response) {
|
|
|
360
360
|
return undefined;
|
|
361
361
|
}
|
|
362
362
|
}
|
|
363
|
-
function withServerTiming(response, durationMs, guestNetwork, latency) {
|
|
363
|
+
function withServerTiming(response, durationMs, guestNetwork, latency, steps = {}) {
|
|
364
364
|
const parts = [`agent_sdk;desc="hosted";dur=${Math.max(0, durationMs).toFixed(1)}`];
|
|
365
365
|
if (guestNetwork !== undefined) {
|
|
366
366
|
parts.push(formatGuestNetworkServerTiming(guestNetwork));
|
|
@@ -368,6 +368,9 @@ function withServerTiming(response, durationMs, guestNetwork, latency) {
|
|
|
368
368
|
if (latency !== undefined) {
|
|
369
369
|
parts.push(...formatHostedExecutionLatencyServerTiming(latency));
|
|
370
370
|
}
|
|
371
|
+
for (const [step, stepMs] of Object.entries(steps)) {
|
|
372
|
+
parts.push(`${HOSTED_SERVER_TIMING_STEP};desc="${step}";dur=${stepMs.toFixed(1)}`);
|
|
373
|
+
}
|
|
371
374
|
const headers = new Headers(response.headers);
|
|
372
375
|
headers.set("Server-Timing", parts.join(", "));
|
|
373
376
|
return new Response(response.body, {
|
|
@@ -473,7 +476,8 @@ export function registerHostedDeliveryRoute(input) {
|
|
|
473
476
|
const runAdmissionOperation = async (delivery, definition) => afterHostedWork(input.flushOtel?.bind(input), async () => {
|
|
474
477
|
const startedAt = performance.now();
|
|
475
478
|
let guestNetwork;
|
|
476
|
-
const
|
|
479
|
+
const steps = {};
|
|
480
|
+
const finish = (response) => withServerTiming(response, performance.now() - startedAt, guestNetwork, undefined, steps);
|
|
477
481
|
try {
|
|
478
482
|
const network = await finishNetworkWait("admission");
|
|
479
483
|
guestNetwork = network.timing;
|
|
@@ -498,14 +502,23 @@ export function registerHostedDeliveryRoute(input) {
|
|
|
498
502
|
definition,
|
|
499
503
|
args: input.buildHandlerArgs(delivery.channelId),
|
|
500
504
|
});
|
|
501
|
-
endHandler();
|
|
505
|
+
steps.handler = endHandler();
|
|
502
506
|
if (admitted.pendingSend === undefined) {
|
|
503
507
|
return await responseToReply(finish(admitted.response));
|
|
504
508
|
}
|
|
505
509
|
pruneExpired();
|
|
506
510
|
const admissionToken = randomBytes(24).toString("hex");
|
|
507
511
|
pending.set(admissionToken, {
|
|
508
|
-
send:
|
|
512
|
+
send: {
|
|
513
|
+
...admitted.pendingSend,
|
|
514
|
+
options: {
|
|
515
|
+
...admitted.pendingSend.options,
|
|
516
|
+
turnContext: delivery.turnContext,
|
|
517
|
+
// The key this admission was signed under, not the session
|
|
518
|
+
// record's: a resumed session keeps its original record key.
|
|
519
|
+
turnSessionKey: delivery.mailboxContinuationKey,
|
|
520
|
+
},
|
|
521
|
+
},
|
|
509
522
|
channelKind: delivery.channelKind,
|
|
510
523
|
expiresAt: Date.now() + pendingTtlMs,
|
|
511
524
|
deliveryId: delivery.deliveryId,
|
|
@@ -625,7 +638,8 @@ export function registerHostedDeliveryRoute(input) {
|
|
|
625
638
|
const startedAt = performance.now();
|
|
626
639
|
let guestNetwork;
|
|
627
640
|
let latencySnapshot;
|
|
628
|
-
const
|
|
641
|
+
const steps = {};
|
|
642
|
+
const finish = (response) => withServerTiming(response, performance.now() - startedAt, guestNetwork, latencySnapshot, steps);
|
|
629
643
|
const unconsumed = finishBoundSecrets();
|
|
630
644
|
if (unconsumed !== undefined) {
|
|
631
645
|
return finish(unconsumed);
|
|
@@ -751,7 +765,7 @@ export function registerHostedDeliveryRoute(input) {
|
|
|
751
765
|
sessionId: "",
|
|
752
766
|
turnStatus: HOSTED_EXECUTION_DIAG_RUNNING_STATUS,
|
|
753
767
|
}, { awaitDurable: false });
|
|
754
|
-
endClaim();
|
|
768
|
+
steps.claim = endClaim();
|
|
755
769
|
let sessionId = "";
|
|
756
770
|
const owner = {
|
|
757
771
|
primaryDeliveryId: admitted.deliveryId,
|
|
@@ -765,7 +779,7 @@ export function registerHostedDeliveryRoute(input) {
|
|
|
765
779
|
let completionAt;
|
|
766
780
|
let drainAt;
|
|
767
781
|
try {
|
|
768
|
-
const args = input.buildHandlerArgs(admitted.send.channelId, execution.sessionPublicId);
|
|
782
|
+
const args = input.buildHandlerArgs(admitted.send.channelId, execution.sessionPublicId, { platformDeliveryId: admitted.deliveryId });
|
|
769
783
|
const options = {
|
|
770
784
|
...admitted.send.options,
|
|
771
785
|
mailboxContinuation: {
|
|
@@ -781,7 +795,8 @@ export function registerHostedDeliveryRoute(input) {
|
|
|
781
795
|
options,
|
|
782
796
|
sessionPublicId: execution.sessionPublicId,
|
|
783
797
|
});
|
|
784
|
-
endSend();
|
|
798
|
+
steps.send = endSend();
|
|
799
|
+
const admittedAt = hostedExecutionNow();
|
|
785
800
|
sessionId = session.id;
|
|
786
801
|
// The pre-turn claim used an empty sessionId. Stamp the
|
|
787
802
|
// engine id now so a dashboard / session-view poll that
|
|
@@ -855,6 +870,10 @@ export function registerHostedDeliveryRoute(input) {
|
|
|
855
870
|
: undefined,
|
|
856
871
|
},
|
|
857
872
|
};
|
|
873
|
+
const turnStartedAt = hostedTurnStartedAt();
|
|
874
|
+
if (turnStartedAt !== undefined) {
|
|
875
|
+
steps.queue = Math.max(0, turnStartedAt - admittedAt);
|
|
876
|
+
}
|
|
858
877
|
// Finalize as late as possible so `post_drain` and `total`
|
|
859
878
|
// include eviction + diag write after durability drain.
|
|
860
879
|
latencySnapshot = finalizeHostedExecutionLatency({
|
|
@@ -1060,12 +1079,17 @@ function hostedFailureForUnfinishedTurn(outcome) {
|
|
|
1060
1079
|
return { error: "turn_failed", retry: HOSTED_GUEST_RETRY_TERMINAL };
|
|
1061
1080
|
}
|
|
1062
1081
|
/**
|
|
1063
|
-
* `agent_sdk.hosted.<step>` span;
|
|
1082
|
+
* `agent_sdk.hosted.<step>` span; the result ends it and returns its elapsed
|
|
1083
|
+
* milliseconds. The delivery
|
|
1064
1084
|
* replies before this work finishes, so the inbound HTTP span never covers it.
|
|
1065
1085
|
*/
|
|
1066
1086
|
function startHostedSpan(step, attributes) {
|
|
1087
|
+
const startedAt = performance.now();
|
|
1067
1088
|
const span = trace.getTracer("agent_sdk").startSpan(`agent_sdk.hosted.${step}`, { attributes });
|
|
1068
|
-
return () =>
|
|
1089
|
+
return () => {
|
|
1090
|
+
span.end();
|
|
1091
|
+
return performance.now() - startedAt;
|
|
1092
|
+
};
|
|
1069
1093
|
}
|
|
1070
1094
|
async function afterHostedWork(flushOtel, work) {
|
|
1071
1095
|
try {
|
|
@@ -47,6 +47,9 @@ export declare function sanitizeHostedChannelKind(value: string): string;
|
|
|
47
47
|
export declare function runWithHostedExecutionLatency<T>(args: {
|
|
48
48
|
channelKind: string;
|
|
49
49
|
}, work: () => T): T;
|
|
50
|
+
/** The first `turn.started` wins; follow-up turns drained into the same execution do not move it. */
|
|
51
|
+
export declare function markHostedTurnStarted(): void;
|
|
52
|
+
export declare function hostedTurnStartedAt(): number | undefined;
|
|
50
53
|
export declare function isDuringHostedExecutionLatency(): boolean;
|
|
51
54
|
/**
|
|
52
55
|
* Mark the first user-visible Slack outbound success. Exact-once: later
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hosted-execution-latency.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-latency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAIL,KAAK,KAAK,EAEX,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,gCAAgC,2CAA2C,CAAC;AACzF,eAAO,MAAM,qCAAqC,6CAA6C,CAAC;AAEhG,8DAA8D;AAC9D,eAAO,MAAM,8BAA8B,WAAW,CAAC;AAEvD,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,iBAAiB,GAAG,YAAY,GAAG,OAAO,CAAC;AAE5F,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,6BAA6B,GAC7B,kBAAkB,GAClB,YAAY,GACZ,OAAO,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,CAAC;AAErD,MAAM,MAAM,8BAA8B,GAAG;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,yBAAyB,CAAC;IACnC,eAAe,EAAE,qBAAqB,CAAC;IACvC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD,CAAC;
|
|
1
|
+
{"version":3,"file":"hosted-execution-latency.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-latency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAIL,KAAK,KAAK,EAEX,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,gCAAgC,2CAA2C,CAAC;AACzF,eAAO,MAAM,qCAAqC,6CAA6C,CAAC;AAEhG,8DAA8D;AAC9D,eAAO,MAAM,8BAA8B,WAAW,CAAC;AAEvD,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,iBAAiB,GAAG,YAAY,GAAG,OAAO,CAAC;AAE5F,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,6BAA6B,GAC7B,kBAAkB,GAClB,YAAY,GACZ,OAAO,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,CAAC;AAErD,MAAM,MAAM,8BAA8B,GAAG;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,yBAAyB,CAAC;IACnC,eAAe,EAAE,qBAAqB,CAAC;IACvC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD,CAAC;AAuBF,oEAAoE;AACpE,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,gBAAgB;AAChB,wBAAgB,oCAAoC,CAAC,GAAG,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,GAAG,IAAI,CAE1F;AAED,gBAAgB;AAChB,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,IAAI,CAIrF;AAED,gBAAgB;AAChB,wBAAgB,mCAAmC,IAAI,IAAI,CAK1D;AA2BD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ/D;AASD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAahG;AAED,qGAAqG;AACrG,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C;AAED,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAExD;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAAC;IAC1C,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC,GAAG,OAAO,CAgBV;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,CAAC,EAAE;IACjD,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC,GAAG,IAAI,CAkBP;AAYD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,8BAA8B,GAAG,SAAS,CAqD7C;AAED,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,8BAA8B,GACvC,MAAM,EAAE,CAmBV"}
|
|
@@ -94,6 +94,7 @@ export function runWithHostedExecutionLatency(args, work) {
|
|
|
94
94
|
startedAt: hostedExecutionNow(),
|
|
95
95
|
channelKind: sanitizeHostedChannelKind(args.channelKind),
|
|
96
96
|
firstVisibleAt: undefined,
|
|
97
|
+
turnStartedAt: undefined,
|
|
97
98
|
firstVisibleOutcome: undefined,
|
|
98
99
|
deliverySurface: "none",
|
|
99
100
|
visibleCounterEmitted: false,
|
|
@@ -102,6 +103,16 @@ export function runWithHostedExecutionLatency(args, work) {
|
|
|
102
103
|
};
|
|
103
104
|
return latencyAls.run(store, work);
|
|
104
105
|
}
|
|
106
|
+
/** The first `turn.started` wins; follow-up turns drained into the same execution do not move it. */
|
|
107
|
+
export function markHostedTurnStarted() {
|
|
108
|
+
const store = latencyAls.getStore();
|
|
109
|
+
if (store !== undefined) {
|
|
110
|
+
store.turnStartedAt ??= hostedExecutionNow();
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
export function hostedTurnStartedAt() {
|
|
114
|
+
return latencyAls.getStore()?.turnStartedAt;
|
|
115
|
+
}
|
|
105
116
|
export function isDuringHostedExecutionLatency() {
|
|
106
117
|
return latencyAls.getStore() !== undefined;
|
|
107
118
|
}
|
|
@@ -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
|
|
@@ -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
|
+
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcp-endpoint.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC;AAOzH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAA8B,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"mcp-endpoint.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC;AAOzH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAA8B,MAAM,aAAa,CAAC;AAIzF,OAAO,EAEL,KAAK,aAAa,EAKnB,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AAUtD,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvE;AAED,yEAAyE;AACzE,UAAU,oBAAoB;IAC5B,OAAO,CAAC,SAAS,EAAE,wCAAwC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,oBAAoB,CAAC;IACxC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyCpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAMpE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,gBAAgB,CAanB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,gBAAgB,CAoCnB"}
|