@grok/agent-sdk 0.6.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/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.Ch-048af.js} +4 -4
- package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
- package/dist/docs/assets/{changelog.md.DVNB-ApU.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.v_dV4U2Q.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
- package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BIzu7OVF.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.B4y6Y5eG.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
- package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.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.BKB971D5.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
- package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.CdOyJvsX.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
- package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DDwvoQlY.js} +1 -1
- package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.BRXPDWj3.js} +1 -1
- package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.3YwC0t3o.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.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.BaVlHHL-.js → theme.bNyH5NPA.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DQqE3WF8.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.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 +35 -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 +636 -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 +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 +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 +3 -0
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +69 -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 +11 -2
- 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 +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 +45 -4
- 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 +136 -5
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +580 -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/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 +271 -2
- package/dist/types.d.ts.map +1 -1
- package/docs/changelog.md +35 -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.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
|
@@ -860,12 +860,38 @@ export function parseAgentServeMcpGatewayUrl(url) {
|
|
|
860
860
|
// ============================================================================
|
|
861
861
|
// Error mapping (HTTP → actionable human messages)
|
|
862
862
|
// ============================================================================
|
|
863
|
+
/** A thrown Connect error keeps its text out of `message`, which reads `Error`. */
|
|
864
|
+
const OPAQUE_SERVER_MESSAGE = /^(\[[a-z_]+\] )?Error$/;
|
|
865
|
+
/** `details[0].debug.details.detail` of a thrown Connect error's body. */
|
|
866
|
+
function connectErrorDetailText(details) {
|
|
867
|
+
if (!Array.isArray(details)) {
|
|
868
|
+
return undefined;
|
|
869
|
+
}
|
|
870
|
+
const first = details[0];
|
|
871
|
+
if (!isRecord(first) || !isRecord(first.debug) || !isRecord(first.debug.details)) {
|
|
872
|
+
return undefined;
|
|
873
|
+
}
|
|
874
|
+
const detail = first.debug.details.detail;
|
|
875
|
+
return typeof detail === "string" && detail !== "" ? detail : undefined;
|
|
876
|
+
}
|
|
877
|
+
/**
|
|
878
|
+
* The server's reason. Route refusals send `{ error }`; errors thrown out of
|
|
879
|
+
* a route send `{ code, message }`, and Connect errors add `details`.
|
|
880
|
+
*/
|
|
863
881
|
function serverErrorText(bodyText) {
|
|
864
882
|
try {
|
|
865
883
|
const parsed = JSON.parse(bodyText);
|
|
866
|
-
if (isRecord(parsed)
|
|
884
|
+
if (!isRecord(parsed)) {
|
|
885
|
+
return undefined;
|
|
886
|
+
}
|
|
887
|
+
if (typeof parsed.error === "string" && parsed.error !== "") {
|
|
867
888
|
return parsed.error;
|
|
868
889
|
}
|
|
890
|
+
const message = typeof parsed.message === "string" && parsed.message !== "" ? parsed.message : undefined;
|
|
891
|
+
if (message !== undefined && !OPAQUE_SERVER_MESSAGE.test(message)) {
|
|
892
|
+
return message;
|
|
893
|
+
}
|
|
894
|
+
return connectErrorDetailText(parsed.details) ?? message;
|
|
869
895
|
}
|
|
870
896
|
catch {
|
|
871
897
|
// Non-JSON body — fall through.
|
|
@@ -929,6 +955,12 @@ function legacyPrivacyModeDenialText(bodyText) {
|
|
|
929
955
|
return undefined;
|
|
930
956
|
}
|
|
931
957
|
}
|
|
958
|
+
/** A 403 says only what the server said; a guessed cause misleads when it is wrong. */
|
|
959
|
+
function forbiddenText(serverError) {
|
|
960
|
+
return serverError === undefined
|
|
961
|
+
? "Not authorized (HTTP 403). The server gave no reason."
|
|
962
|
+
: `Not authorized (HTTP 403): ${serverError}`;
|
|
963
|
+
}
|
|
932
964
|
function mapErrorResponse(response, bodyText, context) {
|
|
933
965
|
const serverError = serverErrorText(bodyText);
|
|
934
966
|
const slugPart = context.slug === undefined ? "" : ` "${context.slug}"`;
|
|
@@ -941,7 +973,7 @@ function mapErrorResponse(response, bodyText, context) {
|
|
|
941
973
|
return new DeployApiError(severalAgentsRefusalText(bodyText) ??
|
|
942
974
|
persistentDeploymentsDisabledText(bodyText) ??
|
|
943
975
|
legacyPrivacyModeDenialText(bodyText) ??
|
|
944
|
-
|
|
976
|
+
forbiddenText(serverError), 403);
|
|
945
977
|
case 404: {
|
|
946
978
|
// Fastify's route-not-found envelope means we hit the wrong host
|
|
947
979
|
// (api2 vs api.cursor.com), not a missing deployment / closed gate.
|
|
@@ -29,6 +29,7 @@
|
|
|
29
29
|
* union for control-plane consumers.
|
|
30
30
|
*/
|
|
31
31
|
import { type CatchAuthDeclaration } from "../channels.js";
|
|
32
|
+
import { type ChannelCredentialEnv, type NamedChannelCredentialEnv } from "./credential-env-names.js";
|
|
32
33
|
import type { SecretAlternatives } from "./secret-alternatives.js";
|
|
33
34
|
import type { AgentProject, AgentProjectInfo } from "../types.js";
|
|
34
35
|
import { type ContinuationIdentity } from "./continuation-identity.js";
|
|
@@ -74,6 +75,18 @@ export interface AgentDeployManifestDeclarations {
|
|
|
74
75
|
* ingress.
|
|
75
76
|
*/
|
|
76
77
|
slackChannelPosts?: string[];
|
|
78
|
+
/**
|
|
79
|
+
* What wakes a Teams channel: personal chats, mentions, and the watched
|
|
80
|
+
* channel ids when the author set channel posts, with `includeBotPosts`
|
|
81
|
+
* for whether other bots' posts there wake it. Present only for
|
|
82
|
+
* `teams` channels that declare it.
|
|
83
|
+
*/
|
|
84
|
+
teamsEngagement?: {
|
|
85
|
+
mentions: boolean;
|
|
86
|
+
directMessages: boolean;
|
|
87
|
+
channelPosts?: string[];
|
|
88
|
+
includeBotPosts?: boolean;
|
|
89
|
+
};
|
|
77
90
|
/**
|
|
78
91
|
* Control-plane catch routes: present only for an authored channel
|
|
79
92
|
* whose auth chain carries a `sharedSecretAuth` / `hmacSignatureAuth`
|
|
@@ -81,6 +94,12 @@ export interface AgentDeployManifestDeclarations {
|
|
|
81
94
|
* pairs and verifies the named deployment secret before any compute.
|
|
82
95
|
*/
|
|
83
96
|
catch?: AgentDeployManifestCatchDeclaration;
|
|
97
|
+
/**
|
|
98
|
+
* Env names this channel reads, and the normalized prefix (`""` when
|
|
99
|
+
* the names are unprefixed). Absent when the channel passes
|
|
100
|
+
* `credentials` or names none. Older manifests omit it.
|
|
101
|
+
*/
|
|
102
|
+
credentialEnv?: ChannelCredentialEnv;
|
|
84
103
|
}>;
|
|
85
104
|
/**
|
|
86
105
|
* Authored `agent/schedules/*`. The v2 control plane compiles these into
|
|
@@ -95,6 +114,11 @@ export interface AgentDeployManifestDeclarations {
|
|
|
95
114
|
* this list. Absent means the CLI predates peer declarations.
|
|
96
115
|
*/
|
|
97
116
|
peers?: string[];
|
|
117
|
+
/**
|
|
118
|
+
* Customer OIDC audiences (`hosting.oidc.audiences`). Absent means none.
|
|
119
|
+
* The Cursor exchange audience is refused and is not stored here.
|
|
120
|
+
*/
|
|
121
|
+
oidcAudiences?: string[];
|
|
98
122
|
}
|
|
99
123
|
export interface AgentDeployManifestScheduleDeclaration {
|
|
100
124
|
/** Path under `agent/schedules/` without extension. */
|
|
@@ -125,6 +149,8 @@ export interface AgentDeployManifestV1 {
|
|
|
125
149
|
cliVersion: string;
|
|
126
150
|
/** Git commit for a checkout-built `@grok/agent-sdk`; absent for npm builds. */
|
|
127
151
|
cliGitSha?: string;
|
|
152
|
+
/** Hosted protocol features this build understands. Absent means none. */
|
|
153
|
+
capabilities?: string[];
|
|
128
154
|
declarations: AgentDeployManifestDeclarations;
|
|
129
155
|
/**
|
|
130
156
|
* Full `projectInfo` payload (see `GET /v1/info`). Opaque to the wire
|
|
@@ -132,6 +158,8 @@ export interface AgentDeployManifestV1 {
|
|
|
132
158
|
*/
|
|
133
159
|
info: AgentProjectInfo;
|
|
134
160
|
}
|
|
161
|
+
/** Hosted protocol features this build understands, written into every deploy manifest. */
|
|
162
|
+
export declare const HOSTED_CAPABILITIES: readonly string[];
|
|
135
163
|
/**
|
|
136
164
|
* Extract the offline deploy manifest from a loaded project. Pure: no
|
|
137
165
|
* network, no filesystem beyond what `loadAgentProject` already read.
|
|
@@ -161,11 +189,31 @@ export declare function channelCatchSecretNames(definition: AgentProject["channe
|
|
|
161
189
|
/**
|
|
162
190
|
* Deployment secrets a channel reads in the guest: `githubChannel`
|
|
163
191
|
* `{ secretName }` credentials and a named `pagerdutyChannel` user id.
|
|
164
|
-
*
|
|
165
|
-
*
|
|
166
|
-
*
|
|
192
|
+
* Slack and Teams env names are not here. `slack create` and the dashboard
|
|
193
|
+
* store those tokens on their own, and a hosted Slack pod does not read
|
|
194
|
+
* the Socket Mode app token, so a missing-secret warning for them is false.
|
|
167
195
|
*/
|
|
168
196
|
export declare function channelCredentialSecretNames(definition: AgentProject["channels"][number]["definition"]): string[];
|
|
197
|
+
/**
|
|
198
|
+
* Copy `meta.credentialEnv` and reject a name that cannot be a deployment
|
|
199
|
+
* secret. This is the only length check. Every channel kind uses it.
|
|
200
|
+
*/
|
|
201
|
+
export declare function credentialEnvFromChannel(channel: {
|
|
202
|
+
id: string;
|
|
203
|
+
definition: {
|
|
204
|
+
meta?: {
|
|
205
|
+
credentialEnv?: ChannelCredentialEnv;
|
|
206
|
+
};
|
|
207
|
+
};
|
|
208
|
+
}): ChannelCredentialEnv | undefined;
|
|
209
|
+
export declare function credentialEnvsFromChannels(channels: readonly {
|
|
210
|
+
id: string;
|
|
211
|
+
definition: {
|
|
212
|
+
meta?: {
|
|
213
|
+
credentialEnv?: ChannelCredentialEnv;
|
|
214
|
+
};
|
|
215
|
+
};
|
|
216
|
+
}[]): NamedChannelCredentialEnv[];
|
|
169
217
|
/**
|
|
170
218
|
* Sets of guest-read secrets a channel needs one of, such as
|
|
171
219
|
* `pagerdutyChannel`'s user id or a token to infer it from. `deploy`
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;
|
|
1
|
+
{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-manifest.ts"],"names":[],"mappings":"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"}
|
|
@@ -29,9 +29,11 @@
|
|
|
29
29
|
* union for control-plane consumers.
|
|
30
30
|
*/
|
|
31
31
|
import * as z from "zod/v4";
|
|
32
|
+
import { CLI_RESERVED_OIDC_AUDIENCES, validateOidcAudiences } from "./oidcAudiences.js";
|
|
32
33
|
import { catchAuthDeclaration, isPublicEndpointPolicy, } from "../channels.js";
|
|
33
34
|
import { githubChannelCredentialSecretNames, isCursorAccountGitHubChannel, } from "../channels/github/github-channel.js";
|
|
34
35
|
import { pagerDutyChannelCredentialSecretNames, pagerDutyChannelSecretAlternatives, } from "../channels/pagerduty/pagerduty-channel.js";
|
|
36
|
+
import { credentialEnvNameError, } from "./credential-env-names.js";
|
|
35
37
|
import { isCursorHostedStorage } from "../storage-backends/cursor-hosted.js";
|
|
36
38
|
import { channelArchitectureError } from "./channel-architecture.js";
|
|
37
39
|
import { applyAgentContinuationDefaults, channelContinuationIdentity, channelDeclaredEventTypes, handshakeChannelContinuation, } from "./continuation-channel.js";
|
|
@@ -71,6 +73,12 @@ const catchDeclarationSchema = z.object({
|
|
|
71
73
|
separator: z.string().min(1).max(8).optional(),
|
|
72
74
|
}),
|
|
73
75
|
z.object({ kind: z.literal("public") }),
|
|
76
|
+
z.object({
|
|
77
|
+
kind: z.literal("microsoft-teams-bot-framework"),
|
|
78
|
+
secret: z.string().min(1).max(64),
|
|
79
|
+
tenantSecret: z.string().min(1).max(64).optional(),
|
|
80
|
+
tenantId: z.string().min(1).max(64).optional(),
|
|
81
|
+
}),
|
|
74
82
|
]))
|
|
75
83
|
.min(1)
|
|
76
84
|
.max(CATCH_MAX_AUTH_POLICIES),
|
|
@@ -105,6 +113,7 @@ const agentDeployManifestV1Schema = z.object({
|
|
|
105
113
|
.string()
|
|
106
114
|
.regex(/^[0-9a-f]{40,64}$/)
|
|
107
115
|
.optional(),
|
|
116
|
+
capabilities: z.array(z.string().min(1).max(64)).max(32).optional(),
|
|
108
117
|
declarations: z.object({
|
|
109
118
|
egressDomains: z.array(z.string().min(1)).max(64),
|
|
110
119
|
publicRoutePaths: z.array(z.string().min(1)).max(64),
|
|
@@ -121,14 +130,39 @@ const agentDeployManifestV1Schema = z.object({
|
|
|
121
130
|
catch: catchDeclarationSchema.optional(),
|
|
122
131
|
slackReply: slackReplyDeclarationSchema.optional(),
|
|
123
132
|
slackChannelPosts: z.array(z.string().min(1).max(80)).max(64).optional(),
|
|
133
|
+
credentialEnv: z
|
|
134
|
+
.object({
|
|
135
|
+
envPrefix: z.string().max(64),
|
|
136
|
+
keys: z.record(z.string().min(1).max(32), z.string().min(1).max(64)),
|
|
137
|
+
})
|
|
138
|
+
.optional(),
|
|
139
|
+
teamsEngagement: z
|
|
140
|
+
.object({
|
|
141
|
+
mentions: z.boolean(),
|
|
142
|
+
directMessages: z.boolean(),
|
|
143
|
+
channelPosts: z.array(z.string().min(1).max(512)).max(64).optional(),
|
|
144
|
+
includeBotPosts: z.boolean().optional(),
|
|
145
|
+
})
|
|
146
|
+
.optional(),
|
|
124
147
|
}))
|
|
125
148
|
.max(64),
|
|
126
149
|
schedules: z.array(scheduleDeclarationSchema).max(MAX_SCHEDULES).optional(),
|
|
127
150
|
peers: z.array(z.string().min(1).max(128)).max(64).optional(),
|
|
151
|
+
oidcAudiences: z
|
|
152
|
+
.array(z
|
|
153
|
+
.string()
|
|
154
|
+
.min(1)
|
|
155
|
+
.max(512)
|
|
156
|
+
.regex(/^[!-~]+$/)
|
|
157
|
+
.refine((value) => !value.includes("*")))
|
|
158
|
+
.max(8)
|
|
159
|
+
.optional(),
|
|
128
160
|
}),
|
|
129
161
|
// Full `projectInfo` payload — opaque to the wire contract.
|
|
130
162
|
info: z.record(z.string(), z.unknown()),
|
|
131
163
|
});
|
|
164
|
+
/** Hosted protocol features this build understands, written into every deploy manifest. */
|
|
165
|
+
export const HOSTED_CAPABILITIES = ["turnContext"];
|
|
132
166
|
/**
|
|
133
167
|
* Extract the offline deploy manifest from a loaded project. Pure: no
|
|
134
168
|
* network, no filesystem beyond what `loadAgentProject` already read.
|
|
@@ -148,6 +182,8 @@ export function buildAgentDeployManifest(project, options) {
|
|
|
148
182
|
const meta = channel.definition.meta;
|
|
149
183
|
const declaredEvents = channelDeclaredEventTypes(channel.definition.meta);
|
|
150
184
|
const eventTypes = declaredEvents === undefined ? undefined : [...declaredEvents].sort();
|
|
185
|
+
const credentialEnv = credentialEnvFromChannel(channel);
|
|
186
|
+
const teamsEngagement = kind === "teams" ? meta?.teamsEngagement : undefined;
|
|
151
187
|
return {
|
|
152
188
|
id: channel.id,
|
|
153
189
|
kind,
|
|
@@ -160,18 +196,30 @@ export function buildAgentDeployManifest(project, options) {
|
|
|
160
196
|
...(kind === "slack" && meta?.slackChannelPosts !== undefined
|
|
161
197
|
? { slackChannelPosts: [...meta.slackChannelPosts] }
|
|
162
198
|
: {}),
|
|
199
|
+
credentialEnv,
|
|
200
|
+
teamsEngagement: teamsEngagement === undefined
|
|
201
|
+
? undefined
|
|
202
|
+
: {
|
|
203
|
+
mentions: teamsEngagement.mentions,
|
|
204
|
+
directMessages: teamsEngagement.directMessages,
|
|
205
|
+
channelPosts: teamsEngagement.channelPosts?.slice(),
|
|
206
|
+
includeBotPosts: teamsEngagement.includeBotPosts,
|
|
207
|
+
},
|
|
163
208
|
};
|
|
164
209
|
});
|
|
165
|
-
//
|
|
166
|
-
//
|
|
210
|
+
// Alias-token-free route prefixes: `publicEndpoint()`, and a Bot Framework
|
|
211
|
+
// catch. Azure Bot cannot send an alias token, and the activity JWT is the
|
|
212
|
+
// gate.
|
|
167
213
|
const publicRoutePaths = project.channels
|
|
168
|
-
.filter((channel) => (channel.definition.auth ?? []).some(isPublicEndpointPolicy)
|
|
214
|
+
.filter((channel) => (channel.definition.auth ?? []).some((policy) => isPublicEndpointPolicy(policy) ||
|
|
215
|
+
catchAuthDeclaration(policy)?.kind === "microsoft-teams-bot-framework"))
|
|
169
216
|
.map((channel) => `/v1/channels/${channel.id}`);
|
|
170
217
|
const manifest = {
|
|
171
218
|
manifestVersion: DEPLOY_MANIFEST_VERSION,
|
|
172
219
|
generatedAtMs: options?.nowMs ?? Date.now(),
|
|
173
220
|
cliVersion: options?.cliVersion ?? packageVersion(),
|
|
174
221
|
cliGitSha: options?.cliGitSha ?? packageGitSha(),
|
|
222
|
+
capabilities: [...HOSTED_CAPABILITIES],
|
|
175
223
|
declarations: {
|
|
176
224
|
egressDomains: [...(project.agent.hosting?.egressDomains ?? [])],
|
|
177
225
|
publicRoutePaths,
|
|
@@ -187,6 +235,9 @@ export function buildAgentDeployManifest(project, options) {
|
|
|
187
235
|
? {}
|
|
188
236
|
: { architecture: project.agent.architecture }),
|
|
189
237
|
...(project.agent.hosting?.image === undefined ? {} : { image: project.agent.hosting.image }),
|
|
238
|
+
oidcAudiences: project.agent.hosting?.oidc?.audiences
|
|
239
|
+
? [...project.agent.hosting.oidc.audiences]
|
|
240
|
+
: undefined,
|
|
190
241
|
channels,
|
|
191
242
|
// v1 calendars stay engine-synced at boot; only v2 compiles declarations.
|
|
192
243
|
schedules: project.agent.architecture === "v2"
|
|
@@ -200,6 +251,13 @@ export function buildAgentDeployManifest(project, options) {
|
|
|
200
251
|
},
|
|
201
252
|
info: projectInfo(project),
|
|
202
253
|
};
|
|
254
|
+
const declaredAudiences = manifest.declarations.oidcAudiences;
|
|
255
|
+
if (declaredAudiences !== undefined) {
|
|
256
|
+
const audiences = validateOidcAudiences(declaredAudiences, CLI_RESERVED_OIDC_AUDIENCES);
|
|
257
|
+
if (!audiences.ok) {
|
|
258
|
+
throw new Error(`Invalid Agent SDK deploy manifest: declarations.oidcAudiences: ${audiences.reason}`);
|
|
259
|
+
}
|
|
260
|
+
}
|
|
203
261
|
const validation = agentDeployManifestV1Schema.safeParse(manifest);
|
|
204
262
|
if (!validation.success) {
|
|
205
263
|
const issues = validation.error.issues
|
|
@@ -279,15 +337,25 @@ export function channelCatchSecretNames(definition) {
|
|
|
279
337
|
return [];
|
|
280
338
|
}
|
|
281
339
|
return [
|
|
282
|
-
...new Set(declaration.auth.flatMap((policy) =>
|
|
340
|
+
...new Set(declaration.auth.flatMap((policy) => {
|
|
341
|
+
if (policy.kind === "public") {
|
|
342
|
+
return [];
|
|
343
|
+
}
|
|
344
|
+
if (policy.kind === "microsoft-teams-bot-framework") {
|
|
345
|
+
return policy.tenantSecret === undefined
|
|
346
|
+
? [policy.secret]
|
|
347
|
+
: [policy.secret, policy.tenantSecret];
|
|
348
|
+
}
|
|
349
|
+
return [policy.secret];
|
|
350
|
+
})),
|
|
283
351
|
];
|
|
284
352
|
}
|
|
285
353
|
/**
|
|
286
354
|
* Deployment secrets a channel reads in the guest: `githubChannel`
|
|
287
355
|
* `{ secretName }` credentials and a named `pagerdutyChannel` user id.
|
|
288
|
-
*
|
|
289
|
-
*
|
|
290
|
-
*
|
|
356
|
+
* Slack and Teams env names are not here. `slack create` and the dashboard
|
|
357
|
+
* store those tokens on their own, and a hosted Slack pod does not read
|
|
358
|
+
* the Socket Mode app token, so a missing-secret warning for them is false.
|
|
291
359
|
*/
|
|
292
360
|
export function channelCredentialSecretNames(definition) {
|
|
293
361
|
return [
|
|
@@ -295,6 +363,27 @@ export function channelCredentialSecretNames(definition) {
|
|
|
295
363
|
...pagerDutyChannelCredentialSecretNames(definition),
|
|
296
364
|
];
|
|
297
365
|
}
|
|
366
|
+
/**
|
|
367
|
+
* Copy `meta.credentialEnv` and reject a name that cannot be a deployment
|
|
368
|
+
* secret. This is the only length check. Every channel kind uses it.
|
|
369
|
+
*/
|
|
370
|
+
export function credentialEnvFromChannel(channel) {
|
|
371
|
+
const env = channel.definition.meta?.credentialEnv;
|
|
372
|
+
if (env === undefined) {
|
|
373
|
+
return undefined;
|
|
374
|
+
}
|
|
375
|
+
const nameError = credentialEnvNameError(channel.id, env);
|
|
376
|
+
if (nameError !== undefined) {
|
|
377
|
+
throw new Error(nameError);
|
|
378
|
+
}
|
|
379
|
+
return env;
|
|
380
|
+
}
|
|
381
|
+
export function credentialEnvsFromChannels(channels) {
|
|
382
|
+
return channels.flatMap((channel) => {
|
|
383
|
+
const env = credentialEnvFromChannel(channel);
|
|
384
|
+
return env === undefined ? [] : [{ id: channel.id, envPrefix: env.envPrefix, keys: env.keys }];
|
|
385
|
+
});
|
|
386
|
+
}
|
|
298
387
|
/**
|
|
299
388
|
* Sets of guest-read secrets a channel needs one of, such as
|
|
300
389
|
* `pagerdutyChannel`'s user id or a token to infer it from. `deploy`
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAExB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,KAAK,gBAAgB,EAA8C,MAAM,cAAc,CAAC;AAIjG,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,EAAE,iBAAwB,CAAC;AAElE,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,iBAAiB,GAAG,SAAS,CAa/B;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,IAAI,CASN;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CASpB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAAG,SAAS,EACxC,UAAU,EAAE,SAAS,mBAAmB,EAAE,GACzC,mBAAmB,GAAG,SAAS,
|
|
1
|
+
{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAExB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,KAAK,gBAAgB,EAA8C,MAAM,cAAc,CAAC;AAIjG,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,EAAE,iBAAwB,CAAC;AAElE,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,iBAAiB,GAAG,SAAS,CAa/B;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,IAAI,CASN;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CASpB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAAG,SAAS,EACxC,UAAU,EAAE,SAAS,mBAAmB,EAAE,GACzC,mBAAmB,GAAG,SAAS,CA6CjC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,uBAAuB,GAAG,SAAS,GAC/C,uBAAuB,GAAG,SAAS,CAmBrC;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CA6B5C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAKzE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO,GACjB,SAAS,YAAY,EAAE,GAAG,SAAS,CAcrC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,OAAO,GAC3B,OAAO,GAAG,SAAS,CAarB"}
|
|
@@ -98,13 +98,18 @@ export function resolveHosting(ctx, agentDir, hosting, extensions) {
|
|
|
98
98
|
...extensions.flatMap((extension) => extension.hosting?.secretNames ?? []),
|
|
99
99
|
]),
|
|
100
100
|
];
|
|
101
|
-
|
|
101
|
+
const oidc = hosting?.oidc;
|
|
102
|
+
if (egressDomains.length === 0 &&
|
|
103
|
+
secretNames.length === 0 &&
|
|
104
|
+
hosting?.image === undefined &&
|
|
105
|
+
oidc?.audiences === undefined) {
|
|
102
106
|
return undefined;
|
|
103
107
|
}
|
|
104
108
|
return {
|
|
105
109
|
egressDomains: egressDomains.length === 0 ? undefined : egressDomains,
|
|
106
110
|
secretNames: secretNames.length === 0 ? undefined : secretNames,
|
|
107
111
|
image: hosting?.image,
|
|
112
|
+
oidc,
|
|
108
113
|
};
|
|
109
114
|
}
|
|
110
115
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/connections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,
|
|
1
|
+
{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/connections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EAQ1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,KAAK,gBAAgB,EAAsC,MAAM,cAAc,CAAC;AAIzF,4DAA4D;AAC5D,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM,CAa/E;AA+GD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,GAChD,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoBjC;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAM3C;AA2BD,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE,OAAO,GAAG,MAAgB,GAC/B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoBjC;AAED,iEAAiE;AACjE,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,EAChC,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAmQ3C"}
|
|
@@ -46,6 +46,22 @@ function parseConnectionEffects(effects) {
|
|
|
46
46
|
}
|
|
47
47
|
return { ok: true, value: normalizeConnectionEffects(parsed) };
|
|
48
48
|
}
|
|
49
|
+
function parseConnectionCredentials(connection) {
|
|
50
|
+
const raw = connection.credentials;
|
|
51
|
+
if (raw === undefined) {
|
|
52
|
+
return { ok: true, value: undefined };
|
|
53
|
+
}
|
|
54
|
+
if (!("cursorAccount" in connection && connection.cursorAccount)) {
|
|
55
|
+
return {
|
|
56
|
+
ok: false,
|
|
57
|
+
message: "MCP connection `credentials` requires defineConnection({ cursorAccount: true }).",
|
|
58
|
+
};
|
|
59
|
+
}
|
|
60
|
+
if (raw !== "individual" && raw !== "shared") {
|
|
61
|
+
return { ok: false, message: 'MCP connection `credentials` must be "individual" or "shared".' };
|
|
62
|
+
}
|
|
63
|
+
return { ok: true, value: raw };
|
|
64
|
+
}
|
|
49
65
|
function parseConnectionTools(tools) {
|
|
50
66
|
if (tools === undefined) {
|
|
51
67
|
return { ok: true, value: undefined };
|
|
@@ -169,6 +185,20 @@ export async function loadConnections(ctx, connectionsDir, role = "model") {
|
|
|
169
185
|
}
|
|
170
186
|
/** Validate one `defineConnection` and resolve its transport. */
|
|
171
187
|
export async function compileConnection(ctx, entryPath, name, connection, role) {
|
|
188
|
+
const credentials = role === "host" && connection.credentials !== undefined
|
|
189
|
+
? {
|
|
190
|
+
ok: false,
|
|
191
|
+
message: "MCP connection `credentials` is only supported in mcp-connections/.",
|
|
192
|
+
}
|
|
193
|
+
: parseConnectionCredentials(connection);
|
|
194
|
+
if (!credentials.ok) {
|
|
195
|
+
ctx.diagnostics.push({
|
|
196
|
+
severity: "error",
|
|
197
|
+
path: displayPath(ctx, entryPath),
|
|
198
|
+
message: credentials.message,
|
|
199
|
+
});
|
|
200
|
+
return undefined;
|
|
201
|
+
}
|
|
172
202
|
if (Object.hasOwn(connection, "hostOnly")) {
|
|
173
203
|
ctx.diagnostics.push({
|
|
174
204
|
severity: "error",
|
|
@@ -209,6 +239,14 @@ export async function compileConnection(ctx, entryPath, name, connection, role)
|
|
|
209
239
|
});
|
|
210
240
|
return undefined;
|
|
211
241
|
}
|
|
242
|
+
if (connection.advertiseTools === true && credentials.value === "individual") {
|
|
243
|
+
ctx.diagnostics.push({
|
|
244
|
+
severity: "error",
|
|
245
|
+
path: displayPath(ctx, entryPath),
|
|
246
|
+
message: `MCP connection "${name}" uses \`credentials: "individual"\` and cannot set \`advertiseTools: true\`. Advertised tools are called from the serve host, which cannot prove which person's turn a call belongs to, so every call would be refused. Drop \`advertiseTools\` so the model calls the connection directly as the turn's user.`,
|
|
247
|
+
});
|
|
248
|
+
return undefined;
|
|
249
|
+
}
|
|
212
250
|
if (connection.optional !== undefined && typeof connection.optional !== "boolean") {
|
|
213
251
|
ctx.diagnostics.push({
|
|
214
252
|
severity: "error",
|
|
@@ -321,6 +359,17 @@ export async function compileConnection(ctx, entryPath, name, connection, role)
|
|
|
321
359
|
});
|
|
322
360
|
return undefined;
|
|
323
361
|
}
|
|
362
|
+
if (credentials.value === "individual" &&
|
|
363
|
+
"cursorAccount" in connection &&
|
|
364
|
+
connection.cursorAccount &&
|
|
365
|
+
cursorAccountServersReachEvery(connection.servers)) {
|
|
366
|
+
ctx.diagnostics.push({
|
|
367
|
+
severity: "error",
|
|
368
|
+
path: displayPath(ctx, entryPath),
|
|
369
|
+
message: `MCP connection "${name}" uses \`credentials: "individual"\` and must list its \`servers\` by name. An individual connection on every server would leave no server for the deployment's shared sign-in.`,
|
|
370
|
+
});
|
|
371
|
+
return undefined;
|
|
372
|
+
}
|
|
324
373
|
const transport = connectionTransport(connection);
|
|
325
374
|
if (transport === undefined) {
|
|
326
375
|
ctx.diagnostics.push({
|
|
@@ -361,6 +410,7 @@ export async function compileConnection(ctx, entryPath, name, connection, role)
|
|
|
361
410
|
return {
|
|
362
411
|
name,
|
|
363
412
|
transport,
|
|
413
|
+
credentials: credentials.value,
|
|
364
414
|
description: connection.description,
|
|
365
415
|
auth: connection.auth,
|
|
366
416
|
advertiseTools: connection.advertiseTools,
|
|
@@ -430,3 +480,6 @@ async function loadInlineStdioConnection(ctx, name, entryPath, connection) {
|
|
|
430
480
|
return undefined;
|
|
431
481
|
}
|
|
432
482
|
}
|
|
483
|
+
function cursorAccountServersReachEvery(servers) {
|
|
484
|
+
return (servers === undefined || servers === "*" || servers.every((server) => server.trim() === "*"));
|
|
485
|
+
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/extensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,cAAc,EAGd,aAAa,EACb,QAAQ,EAET,MAAM,gBAAgB,CAAC;AAUxB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/extensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,cAAc,EAGd,aAAa,EACb,QAAQ,EAET,MAAM,gBAAgB,CAAC;AAUxB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAiClE,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA2BhC"}
|
|
@@ -22,6 +22,7 @@ import { loadArtifacts, mergeArtifacts } from "./services.js";
|
|
|
22
22
|
import { loadSkills } from "./skills.js";
|
|
23
23
|
import { loadSubagents, subagent } from "./subagent.js";
|
|
24
24
|
import { compileTool, loadTools } from "./tools.js";
|
|
25
|
+
import { recordMountNamespace } from "../extension-namespace.js";
|
|
25
26
|
/**
|
|
26
27
|
* Mount every extension under `agent/extensions/` and append what it
|
|
27
28
|
* contributes to the authored lists as `<ns>__<name>`, stamped with
|
|
@@ -101,6 +102,7 @@ function emptyDiscovered(ns, description) {
|
|
|
101
102
|
* what is left.
|
|
102
103
|
*/
|
|
103
104
|
async function mountExtension(ctx, site, mount, into) {
|
|
105
|
+
recordMountNamespace(mount, site.ns);
|
|
104
106
|
const mounted = emptyDiscovered(site.ns, mount.extension.description);
|
|
105
107
|
const root = resolve(ctx.rootDir, mount.extension.root);
|
|
106
108
|
if (!(await isDirectory(root))) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/info.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AAMxF,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,
|
|
1
|
+
{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/info.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AAMxF,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAmK9D"}
|
|
@@ -79,6 +79,7 @@ export function projectInfo(project) {
|
|
|
79
79
|
tools: connection.tools,
|
|
80
80
|
disallowedTools: connection.disallowedTools,
|
|
81
81
|
cursorAccountServers: "cursorAccount" in connection.transport ? (connection.transport.servers ?? "*") : undefined,
|
|
82
|
+
credentials: connection.credentials,
|
|
82
83
|
})),
|
|
83
84
|
subagents: agent.subagents.map((subagent) => ({
|
|
84
85
|
name: subagent.name,
|
|
@@ -136,6 +137,9 @@ export function projectInfo(project) {
|
|
|
136
137
|
if (meta?.slackChannelPosts !== undefined) {
|
|
137
138
|
info.slackChannelPosts = meta.slackChannelPosts;
|
|
138
139
|
}
|
|
140
|
+
if (meta?.teamsEngagement !== undefined) {
|
|
141
|
+
info.teamsEngagement = meta.teamsEngagement;
|
|
142
|
+
}
|
|
139
143
|
return info;
|
|
140
144
|
}),
|
|
141
145
|
],
|
|
@@ -10,6 +10,7 @@ export declare function upsertEnvFile(path: string, entries: Array<{
|
|
|
10
10
|
key: string;
|
|
11
11
|
value: string;
|
|
12
12
|
}>): Promise<void>;
|
|
13
|
+
export declare function ensureGitignoreEntry(dir: string, entry: string, covers?: (line: string) => boolean): Promise<boolean>;
|
|
13
14
|
/**
|
|
14
15
|
* Ensure the agent directory's .gitignore covers .env.local (create or
|
|
15
16
|
* append). A bare `.env` line does not count — that pattern matches only
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"env-file.d.ts","sourceRoot":"","sources":["../../src/internal/env-file.ts"],"names":[],"mappings":"AAAA;;GAEG;
|
|
1
|
+
{"version":3,"file":"env-file.d.ts","sourceRoot":"","sources":["../../src/internal/env-file.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAkC,GAC3D,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAItE"}
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Shared `.env` / `.env.local` writers for CLI commands that mint tokens.
|
|
3
3
|
*/
|
|
4
|
-
import {
|
|
4
|
+
import { readFile, writeFile } from "node:fs/promises";
|
|
5
5
|
import { join } from "node:path";
|
|
6
|
+
import { resolveLinkedFile, restrictExistingPrivateFile, writePrivateFile, } from "./private-file.js";
|
|
6
7
|
function isErrnoException(error) {
|
|
7
8
|
return error instanceof Error && "code" in error;
|
|
8
9
|
}
|
|
@@ -23,7 +24,9 @@ async function readOptionalFile(path) {
|
|
|
23
24
|
* missing.
|
|
24
25
|
*/
|
|
25
26
|
export async function upsertEnvFile(path, entries) {
|
|
26
|
-
const
|
|
27
|
+
const target = await resolveLinkedFile(path);
|
|
28
|
+
await restrictExistingPrivateFile(target, { privateDirectory: false });
|
|
29
|
+
const existing = await readOptionalFile(target);
|
|
27
30
|
const lines = existing === "" ? [] : existing.replace(/\r?\n$/, "").split(/\r?\n/);
|
|
28
31
|
// A stale `export KEY=…` line would shadow or duplicate the bare line
|
|
29
32
|
// under some loaders; treat both spellings as the same entry.
|
|
@@ -48,27 +51,25 @@ export async function upsertEnvFile(path, entries) {
|
|
|
48
51
|
lines.push(next);
|
|
49
52
|
}
|
|
50
53
|
}
|
|
51
|
-
|
|
52
|
-
await writeFile(path, `${lines.join("\n")}\n`, { mode: 0o600 });
|
|
53
|
-
await chmod(path, 0o600);
|
|
54
|
+
await writePrivateFile(target, `${lines.join("\n")}\n`, { privateDirectory: false });
|
|
54
55
|
}
|
|
55
|
-
|
|
56
|
-
* Ensure the agent directory's .gitignore covers .env.local (create or
|
|
57
|
-
* append). A bare `.env` line does not count — that pattern matches only
|
|
58
|
-
* the file literally named .env.
|
|
59
|
-
*/
|
|
60
|
-
export async function ensureEnvLocalGitignored(dir) {
|
|
56
|
+
export async function ensureGitignoreEntry(dir, entry, covers = (line) => line === entry) {
|
|
61
57
|
const path = join(dir, ".gitignore");
|
|
62
58
|
const existing = await readOptionalFile(path);
|
|
63
|
-
|
|
64
|
-
.split(/\r?\n/)
|
|
65
|
-
.some((line) => /^\.env(\.local\*?|\.\*|\*)$/.test(line.trim()));
|
|
66
|
-
if (covered) {
|
|
59
|
+
if (existing.split(/\r?\n/).some((line) => covers(line.trim()))) {
|
|
67
60
|
return false;
|
|
68
61
|
}
|
|
69
62
|
const next = existing === "" || existing.endsWith("\n")
|
|
70
|
-
? `${existing}
|
|
71
|
-
: `${existing}\n
|
|
63
|
+
? `${existing}${entry}\n`
|
|
64
|
+
: `${existing}\n${entry}\n`;
|
|
72
65
|
await writeFile(path, next);
|
|
73
66
|
return true;
|
|
74
67
|
}
|
|
68
|
+
/**
|
|
69
|
+
* Ensure the agent directory's .gitignore covers .env.local (create or
|
|
70
|
+
* append). A bare `.env` line does not count — that pattern matches only
|
|
71
|
+
* the file literally named .env.
|
|
72
|
+
*/
|
|
73
|
+
export function ensureEnvLocalGitignored(dir) {
|
|
74
|
+
return ensureGitignoreEntry(dir, ".env.local", (line) => /^\.env(\.local\*?|\.\*|\*)$/.test(line));
|
|
75
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/** Normalize an agent directory or display name into an env var prefix. */
|
|
2
|
+
export declare function envPrefixFromName(name: string): string;
|
|
3
|
+
/**
|
|
4
|
+
* The prefix stored on a channel. A blank prefix is `""`. Any other prefix
|
|
5
|
+
* is the normalized name. Callers build env names with {@link envName} from
|
|
6
|
+
* this result, so the stored prefix and the names stay the same.
|
|
7
|
+
*/
|
|
8
|
+
export declare function storedEnvPrefix(prefix: string | undefined): string;
|
|
9
|
+
/** Full env name for a stored prefix. An empty prefix keeps the suffix. */
|
|
10
|
+
export declare function envName(envPrefix: string, suffix: string): string;
|
|
11
|
+
//# sourceMappingURL=env-prefix.d.ts.map
|