@cursor/july 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +290 -0
- package/LICENSE.md +3 -0
- package/README.md +1233 -0
- package/dist/ab.d.ts +290 -0
- package/dist/ab.d.ts.map +1 -0
- package/dist/ab.js +386 -0
- package/dist/bin/agent-serve.d.ts +15 -0
- package/dist/bin/agent-serve.d.ts.map +1 -0
- package/dist/bin/agent-serve.js +754 -0
- package/dist/channels/github/api.d.ts +101 -0
- package/dist/channels/github/api.d.ts.map +1 -0
- package/dist/channels/github/api.js +229 -0
- package/dist/channels/github/auth.d.ts +67 -0
- package/dist/channels/github/auth.d.ts.map +1 -0
- package/dist/channels/github/auth.js +239 -0
- package/dist/channels/github/binding.d.ts +73 -0
- package/dist/channels/github/binding.d.ts.map +1 -0
- package/dist/channels/github/binding.js +114 -0
- package/dist/channels/github/defaults.d.ts +24 -0
- package/dist/channels/github/defaults.d.ts.map +1 -0
- package/dist/channels/github/defaults.js +100 -0
- package/dist/channels/github/events.d.ts +18 -0
- package/dist/channels/github/events.d.ts.map +1 -0
- package/dist/channels/github/events.js +59 -0
- package/dist/channels/github/forward.d.ts +137 -0
- package/dist/channels/github/forward.d.ts.map +1 -0
- package/dist/channels/github/forward.js +271 -0
- package/dist/channels/github/github-channel.d.ts +127 -0
- package/dist/channels/github/github-channel.d.ts.map +1 -0
- package/dist/channels/github/github-channel.js +1688 -0
- package/dist/channels/github/index.d.ts +52 -0
- package/dist/channels/github/index.d.ts.map +1 -0
- package/dist/channels/github/index.js +51 -0
- package/dist/channels/github/replay.d.ts +115 -0
- package/dist/channels/github/replay.d.ts.map +1 -0
- package/dist/channels/github/replay.js +282 -0
- package/dist/channels/github/state.d.ts +26 -0
- package/dist/channels/github/state.d.ts.map +1 -0
- package/dist/channels/github/state.js +50 -0
- package/dist/channels/github/types.d.ts +385 -0
- package/dist/channels/github/types.d.ts.map +1 -0
- package/dist/channels/github/types.js +1 -0
- package/dist/channels/slack/api.d.ts +117 -0
- package/dist/channels/slack/api.d.ts.map +1 -0
- package/dist/channels/slack/api.js +437 -0
- package/dist/channels/slack/approvals.d.ts +32 -0
- package/dist/channels/slack/approvals.d.ts.map +1 -0
- package/dist/channels/slack/approvals.js +157 -0
- package/dist/channels/slack/assistant.d.ts +23 -0
- package/dist/channels/slack/assistant.d.ts.map +1 -0
- package/dist/channels/slack/assistant.js +67 -0
- package/dist/channels/slack/auth.d.ts +40 -0
- package/dist/channels/slack/auth.d.ts.map +1 -0
- package/dist/channels/slack/auth.js +71 -0
- package/dist/channels/slack/channel-watch.d.ts +46 -0
- package/dist/channels/slack/channel-watch.d.ts.map +1 -0
- package/dist/channels/slack/channel-watch.js +180 -0
- package/dist/channels/slack/constants.d.ts +17 -0
- package/dist/channels/slack/constants.d.ts.map +1 -0
- package/dist/channels/slack/constants.js +27 -0
- package/dist/channels/slack/credentials.d.ts +35 -0
- package/dist/channels/slack/credentials.d.ts.map +1 -0
- package/dist/channels/slack/credentials.js +88 -0
- package/dist/channels/slack/cursor-account.d.ts +76 -0
- package/dist/channels/slack/cursor-account.d.ts.map +1 -0
- package/dist/channels/slack/cursor-account.js +88 -0
- package/dist/channels/slack/defaults.d.ts +32 -0
- package/dist/channels/slack/defaults.d.ts.map +1 -0
- package/dist/channels/slack/defaults.js +380 -0
- package/dist/channels/slack/dispatch.d.ts +43 -0
- package/dist/channels/slack/dispatch.d.ts.map +1 -0
- package/dist/channels/slack/dispatch.js +185 -0
- package/dist/channels/slack/doctor.d.ts +24 -0
- package/dist/channels/slack/doctor.d.ts.map +1 -0
- package/dist/channels/slack/doctor.js +115 -0
- package/dist/channels/slack/event-id-dedupe.d.ts +10 -0
- package/dist/channels/slack/event-id-dedupe.d.ts.map +1 -0
- package/dist/channels/slack/event-id-dedupe.js +23 -0
- package/dist/channels/slack/inbound.d.ts +41 -0
- package/dist/channels/slack/inbound.d.ts.map +1 -0
- package/dist/channels/slack/inbound.js +166 -0
- package/dist/channels/slack/index.d.ts +45 -0
- package/dist/channels/slack/index.d.ts.map +1 -0
- package/dist/channels/slack/index.js +44 -0
- package/dist/channels/slack/init.d.ts +32 -0
- package/dist/channels/slack/init.d.ts.map +1 -0
- package/dist/channels/slack/init.js +82 -0
- package/dist/channels/slack/interactive.d.ts +19 -0
- package/dist/channels/slack/interactive.d.ts.map +1 -0
- package/dist/channels/slack/interactive.js +142 -0
- package/dist/channels/slack/links.d.ts +10 -0
- package/dist/channels/slack/links.d.ts.map +1 -0
- package/dist/channels/slack/links.js +19 -0
- package/dist/channels/slack/live-delivery.d.ts +75 -0
- package/dist/channels/slack/live-delivery.d.ts.map +1 -0
- package/dist/channels/slack/live-delivery.js +143 -0
- package/dist/channels/slack/log.d.ts +25 -0
- package/dist/channels/slack/log.d.ts.map +1 -0
- package/dist/channels/slack/log.js +47 -0
- package/dist/channels/slack/manifest.d.ts +57 -0
- package/dist/channels/slack/manifest.d.ts.map +1 -0
- package/dist/channels/slack/manifest.js +110 -0
- package/dist/channels/slack/pr-ref.d.ts +18 -0
- package/dist/channels/slack/pr-ref.d.ts.map +1 -0
- package/dist/channels/slack/pr-ref.js +36 -0
- package/dist/channels/slack/setup.d.ts +14 -0
- package/dist/channels/slack/setup.d.ts.map +1 -0
- package/dist/channels/slack/setup.js +86 -0
- package/dist/channels/slack/slack-channel.d.ts +15 -0
- package/dist/channels/slack/slack-channel.d.ts.map +1 -0
- package/dist/channels/slack/slack-channel.js +281 -0
- package/dist/channels/slack/socket-mode.d.ts +26 -0
- package/dist/channels/slack/socket-mode.d.ts.map +1 -0
- package/dist/channels/slack/socket-mode.js +116 -0
- package/dist/channels/slack/stream.d.ts +26 -0
- package/dist/channels/slack/stream.d.ts.map +1 -0
- package/dist/channels/slack/stream.js +39 -0
- package/dist/channels/slack/tool-approval-events.d.ts +33 -0
- package/dist/channels/slack/tool-approval-events.d.ts.map +1 -0
- package/dist/channels/slack/tool-approval-events.js +129 -0
- package/dist/channels/slack/types.d.ts +326 -0
- package/dist/channels/slack/types.d.ts.map +1 -0
- package/dist/channels/slack/types.js +4 -0
- package/dist/channels.d.ts +116 -0
- package/dist/channels.d.ts.map +1 -0
- package/dist/channels.js +294 -0
- package/dist/connections.d.ts +75 -0
- package/dist/connections.d.ts.map +1 -0
- package/dist/connections.js +75 -0
- package/dist/docs/404.html +22 -0
- package/dist/docs/ab.html +87 -0
- package/dist/docs/assets/ab.md.COdXkces.js +63 -0
- package/dist/docs/assets/ab.md.COdXkces.lean.js +1 -0
- package/dist/docs/assets/app.DqfFEmJd.js +1 -0
- package/dist/docs/assets/building-with-agents.md.CJCtZCyi.js +13 -0
- package/dist/docs/assets/building-with-agents.md.CJCtZCyi.lean.js +1 -0
- package/dist/docs/assets/chunks/@localSearchIndexroot.CcVk1uKq.js +1 -0
- package/dist/docs/assets/chunks/VPLocalSearchBox.BaLEdS15.js +9 -0
- package/dist/docs/assets/chunks/framework.CAZyNGu9.js +19 -0
- package/dist/docs/assets/chunks/theme.CZRvu_0q.js +2 -0
- package/dist/docs/assets/concepts.md.Cfb9b-k1.js +4 -0
- package/dist/docs/assets/concepts.md.Cfb9b-k1.lean.js +1 -0
- package/dist/docs/assets/deployment.md.Dx1TYNk5.js +14 -0
- package/dist/docs/assets/deployment.md.Dx1TYNk5.lean.js +1 -0
- package/dist/docs/assets/evals.md.DPZ_MAnI.js +85 -0
- package/dist/docs/assets/evals.md.DPZ_MAnI.lean.js +1 -0
- package/dist/docs/assets/guides_agent-to-agent.md.CrtrsySy.js +10 -0
- package/dist/docs/assets/guides_agent-to-agent.md.CrtrsySy.lean.js +1 -0
- package/dist/docs/assets/guides_cloud-runtime.md.CYlNMTNp.js +9 -0
- package/dist/docs/assets/guides_cloud-runtime.md.CYlNMTNp.lean.js +1 -0
- package/dist/docs/assets/guides_github.md.DwbKhCeS.js +20 -0
- package/dist/docs/assets/guides_github.md.DwbKhCeS.lean.js +1 -0
- package/dist/docs/assets/guides_human-in-the-loop.md.Dvuctx7s.js +28 -0
- package/dist/docs/assets/guides_human-in-the-loop.md.Dvuctx7s.lean.js +1 -0
- package/dist/docs/assets/guides_slack.md.bv41fHfW.js +37 -0
- package/dist/docs/assets/guides_slack.md.bv41fHfW.lean.js +1 -0
- package/dist/docs/assets/guides_webhooks.md.hFTik3lf.js +50 -0
- package/dist/docs/assets/guides_webhooks.md.hFTik3lf.lean.js +1 -0
- package/dist/docs/assets/hillclimbing.md.DHNast08.js +4 -0
- package/dist/docs/assets/hillclimbing.md.DHNast08.lean.js +1 -0
- package/dist/docs/assets/index.md.BPKcj5AI.js +20 -0
- package/dist/docs/assets/index.md.BPKcj5AI.lean.js +1 -0
- package/dist/docs/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 +0 -0
- package/dist/docs/assets/inter-italic-cyrillic.By2_1cv3.woff2 +0 -0
- package/dist/docs/assets/inter-italic-greek-ext.1u6EdAuj.woff2 +0 -0
- package/dist/docs/assets/inter-italic-greek.DJ8dCoTZ.woff2 +0 -0
- package/dist/docs/assets/inter-italic-latin-ext.CN1xVJS-.woff2 +0 -0
- package/dist/docs/assets/inter-italic-latin.C2AdPX0b.woff2 +0 -0
- package/dist/docs/assets/inter-italic-vietnamese.BSbpV94h.woff2 +0 -0
- package/dist/docs/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 +0 -0
- package/dist/docs/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 +0 -0
- package/dist/docs/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 +0 -0
- package/dist/docs/assets/inter-roman-greek.BBVDIX6e.woff2 +0 -0
- package/dist/docs/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 +0 -0
- package/dist/docs/assets/inter-roman-latin.Di8DUHzh.woff2 +0 -0
- package/dist/docs/assets/inter-roman-vietnamese.BjW4sHH5.woff2 +0 -0
- package/dist/docs/assets/quickstart.md.tVPiGK_L.js +35 -0
- package/dist/docs/assets/quickstart.md.tVPiGK_L.lean.js +1 -0
- package/dist/docs/assets/reference_agent-config.md.Bpd7HQwf.js +34 -0
- package/dist/docs/assets/reference_agent-config.md.Bpd7HQwf.lean.js +1 -0
- package/dist/docs/assets/reference_channels.md.D7JTR03W.js +53 -0
- package/dist/docs/assets/reference_channels.md.D7JTR03W.lean.js +1 -0
- package/dist/docs/assets/reference_cli.md.DA730zCu.js +33 -0
- package/dist/docs/assets/reference_cli.md.DA730zCu.lean.js +1 -0
- package/dist/docs/assets/reference_connections.md.C3vNH_DE.js +26 -0
- package/dist/docs/assets/reference_connections.md.C3vNH_DE.lean.js +1 -0
- package/dist/docs/assets/reference_hooks.md.BCEc3MyM.js +12 -0
- package/dist/docs/assets/reference_hooks.md.BCEc3MyM.lean.js +1 -0
- package/dist/docs/assets/reference_http-api.md.DBAahtdz.js +11 -0
- package/dist/docs/assets/reference_http-api.md.DBAahtdz.lean.js +1 -0
- package/dist/docs/assets/reference_instructions.md.BC05LEQ8.js +12 -0
- package/dist/docs/assets/reference_instructions.md.BC05LEQ8.lean.js +1 -0
- package/dist/docs/assets/reference_playground.md.CPZhfYaO.js +1 -0
- package/dist/docs/assets/reference_playground.md.CPZhfYaO.lean.js +1 -0
- package/dist/docs/assets/reference_project-layout.md.Bd_CKtNS.js +31 -0
- package/dist/docs/assets/reference_project-layout.md.Bd_CKtNS.lean.js +1 -0
- package/dist/docs/assets/reference_schedules.md.D7qijxLk.js +82 -0
- package/dist/docs/assets/reference_schedules.md.D7qijxLk.lean.js +1 -0
- package/dist/docs/assets/reference_sessions.md.DdjWabnN.js +8 -0
- package/dist/docs/assets/reference_sessions.md.DdjWabnN.lean.js +1 -0
- package/dist/docs/assets/reference_skills.md.VQnlBT3Q.js +15 -0
- package/dist/docs/assets/reference_skills.md.VQnlBT3Q.lean.js +1 -0
- package/dist/docs/assets/reference_subagents.md.CIRAVcPK.js +10 -0
- package/dist/docs/assets/reference_subagents.md.CIRAVcPK.lean.js +1 -0
- package/dist/docs/assets/reference_tools.md.DF5kwlt0.js +46 -0
- package/dist/docs/assets/reference_tools.md.DF5kwlt0.lean.js +1 -0
- package/dist/docs/assets/scaffolding-agents.md.CyYfWGdc.js +1 -0
- package/dist/docs/assets/scaffolding-agents.md.CyYfWGdc.lean.js +1 -0
- package/dist/docs/assets/style.Bj-IXa5W.css +1 -0
- package/dist/docs/assets/troubleshooting.md.DkovjS7h.js +1 -0
- package/dist/docs/assets/troubleshooting.md.DkovjS7h.lean.js +1 -0
- package/dist/docs/building-with-agents.html +37 -0
- package/dist/docs/concepts.html +28 -0
- package/dist/docs/deployment.html +38 -0
- package/dist/docs/evals.html +109 -0
- package/dist/docs/guides/agent-to-agent.html +34 -0
- package/dist/docs/guides/cloud-runtime.html +33 -0
- package/dist/docs/guides/github.html +44 -0
- package/dist/docs/guides/human-in-the-loop.html +52 -0
- package/dist/docs/guides/slack.html +61 -0
- package/dist/docs/guides/webhooks.html +74 -0
- package/dist/docs/hashmap.json +1 -0
- package/dist/docs/hillclimbing.html +28 -0
- package/dist/docs/index.html +44 -0
- package/dist/docs/quickstart.html +59 -0
- package/dist/docs/reference/agent-config.html +58 -0
- package/dist/docs/reference/channels.html +77 -0
- package/dist/docs/reference/cli.html +57 -0
- package/dist/docs/reference/connections.html +50 -0
- package/dist/docs/reference/hooks.html +36 -0
- package/dist/docs/reference/http-api.html +35 -0
- package/dist/docs/reference/instructions.html +36 -0
- package/dist/docs/reference/playground.html +25 -0
- package/dist/docs/reference/project-layout.html +55 -0
- package/dist/docs/reference/schedules.html +106 -0
- package/dist/docs/reference/sessions.html +32 -0
- package/dist/docs/reference/skills.html +39 -0
- package/dist/docs/reference/subagents.html +34 -0
- package/dist/docs/reference/tools.html +70 -0
- package/dist/docs/scaffolding-agents.html +25 -0
- package/dist/docs/troubleshooting.html +25 -0
- package/dist/docs/vp-icons.css +0 -0
- package/dist/evals.d.ts +312 -0
- package/dist/evals.d.ts.map +1 -0
- package/dist/evals.js +254 -0
- package/dist/hooks.d.ts +23 -0
- package/dist/hooks.d.ts.map +1 -0
- package/dist/hooks.js +23 -0
- package/dist/index.d.ts +71 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +101 -0
- package/dist/internal/ab-collector.d.ts +42 -0
- package/dist/internal/ab-collector.d.ts.map +1 -0
- package/dist/internal/ab-collector.js +153 -0
- package/dist/internal/ab-fold.d.ts +36 -0
- package/dist/internal/ab-fold.d.ts.map +1 -0
- package/dist/internal/ab-fold.js +171 -0
- package/dist/internal/ab-snapshot.d.ts +70 -0
- package/dist/internal/ab-snapshot.d.ts.map +1 -0
- package/dist/internal/ab-snapshot.js +208 -0
- package/dist/internal/approval-gate.d.ts +34 -0
- package/dist/internal/approval-gate.d.ts.map +1 -0
- package/dist/internal/approval-gate.js +85 -0
- package/dist/internal/auth.d.ts +8 -0
- package/dist/internal/auth.d.ts.map +1 -0
- package/dist/internal/auth.js +27 -0
- package/dist/internal/authored-alias-hooks.d.ts +31 -0
- package/dist/internal/authored-alias-hooks.d.ts.map +1 -0
- package/dist/internal/authored-alias-hooks.js +43 -0
- package/dist/internal/authored-loaders.d.ts +25 -0
- package/dist/internal/authored-loaders.d.ts.map +1 -0
- package/dist/internal/authored-loaders.js +129 -0
- package/dist/internal/bounded-int.d.ts +11 -0
- package/dist/internal/bounded-int.d.ts.map +1 -0
- package/dist/internal/bounded-int.js +13 -0
- package/dist/internal/brand.d.ts +6 -0
- package/dist/internal/brand.d.ts.map +1 -0
- package/dist/internal/brand.js +17 -0
- package/dist/internal/chat-client.d.ts +19 -0
- package/dist/internal/chat-client.d.ts.map +1 -0
- package/dist/internal/chat-client.js +327 -0
- package/dist/internal/cli-ax.d.ts +58 -0
- package/dist/internal/cli-ax.d.ts.map +1 -0
- package/dist/internal/cli-ax.js +345 -0
- package/dist/internal/cli-cursor.d.ts +20 -0
- package/dist/internal/cli-cursor.d.ts.map +1 -0
- package/dist/internal/cli-cursor.js +227 -0
- package/dist/internal/cli-github.d.ts +47 -0
- package/dist/internal/cli-github.d.ts.map +1 -0
- package/dist/internal/cli-github.js +644 -0
- package/dist/internal/cli-slack.d.ts +18 -0
- package/dist/internal/cli-slack.d.ts.map +1 -0
- package/dist/internal/cli-slack.js +144 -0
- package/dist/internal/cloud-merge.d.ts +23 -0
- package/dist/internal/cloud-merge.d.ts.map +1 -0
- package/dist/internal/cloud-merge.js +28 -0
- package/dist/internal/cron.d.ts +17 -0
- package/dist/internal/cron.d.ts.map +1 -0
- package/dist/internal/cron.js +60 -0
- package/dist/internal/cursor/account-mcp.d.ts +95 -0
- package/dist/internal/cursor/account-mcp.d.ts.map +1 -0
- package/dist/internal/cursor/account-mcp.js +342 -0
- package/dist/internal/cursor/backend-client.d.ts +118 -0
- package/dist/internal/cursor/backend-client.d.ts.map +1 -0
- package/dist/internal/cursor/backend-client.js +477 -0
- package/dist/internal/cursor/credentials.d.ts +112 -0
- package/dist/internal/cursor/credentials.d.ts.map +1 -0
- package/dist/internal/cursor/credentials.js +329 -0
- package/dist/internal/cursor-event-relay.d.ts +111 -0
- package/dist/internal/cursor-event-relay.d.ts.map +1 -0
- package/dist/internal/cursor-event-relay.js +181 -0
- package/dist/internal/cursor-relay-core.d.ts +113 -0
- package/dist/internal/cursor-relay-core.d.ts.map +1 -0
- package/dist/internal/cursor-relay-core.js +364 -0
- package/dist/internal/cursor-slack-relay.d.ts +94 -0
- package/dist/internal/cursor-slack-relay.d.ts.map +1 -0
- package/dist/internal/cursor-slack-relay.js +171 -0
- package/dist/internal/describe-error.d.ts +3 -0
- package/dist/internal/describe-error.d.ts.map +1 -0
- package/dist/internal/describe-error.js +4 -0
- package/dist/internal/dev-mode.d.ts +13 -0
- package/dist/internal/dev-mode.d.ts.map +1 -0
- package/dist/internal/dev-mode.js +17 -0
- package/dist/internal/discovery.d.ts +55 -0
- package/dist/internal/discovery.d.ts.map +1 -0
- package/dist/internal/discovery.js +1427 -0
- package/dist/internal/distribution.d.ts +47 -0
- package/dist/internal/distribution.d.ts.map +1 -0
- package/dist/internal/distribution.js +82 -0
- package/dist/internal/docs-site.d.ts +28 -0
- package/dist/internal/docs-site.d.ts.map +1 -0
- package/dist/internal/docs-site.js +169 -0
- package/dist/internal/duration.d.ts +8 -0
- package/dist/internal/duration.d.ts.map +1 -0
- package/dist/internal/duration.js +35 -0
- package/dist/internal/eval-run-store.d.ts +81 -0
- package/dist/internal/eval-run-store.d.ts.map +1 -0
- package/dist/internal/eval-run-store.js +396 -0
- package/dist/internal/eval-runner.d.ts +76 -0
- package/dist/internal/eval-runner.d.ts.map +1 -0
- package/dist/internal/eval-runner.js +336 -0
- package/dist/internal/event-log.d.ts +51 -0
- package/dist/internal/event-log.d.ts.map +1 -0
- package/dist/internal/event-log.js +167 -0
- package/dist/internal/event-mapper.d.ts +46 -0
- package/dist/internal/event-mapper.d.ts.map +1 -0
- package/dist/internal/event-mapper.js +226 -0
- package/dist/internal/frontmatter.d.ts +12 -0
- package/dist/internal/frontmatter.d.ts.map +1 -0
- package/dist/internal/frontmatter.js +61 -0
- package/dist/internal/github-fanout.d.ts +32 -0
- package/dist/internal/github-fanout.d.ts.map +1 -0
- package/dist/internal/github-fanout.js +122 -0
- package/dist/internal/handleAgentServeTrigger.d.ts +59 -0
- package/dist/internal/handleAgentServeTrigger.d.ts.map +1 -0
- package/dist/internal/handleAgentServeTrigger.js +115 -0
- package/dist/internal/host-platforms.d.ts +40 -0
- package/dist/internal/host-platforms.d.ts.map +1 -0
- package/dist/internal/host-platforms.js +113 -0
- package/dist/internal/http-channel.d.ts +54 -0
- package/dist/internal/http-channel.d.ts.map +1 -0
- package/dist/internal/http-channel.js +382 -0
- package/dist/internal/ids.d.ts +19 -0
- package/dist/internal/ids.d.ts.map +1 -0
- package/dist/internal/ids.js +34 -0
- package/dist/internal/init-project.d.ts +22 -0
- package/dist/internal/init-project.d.ts.map +1 -0
- package/dist/internal/init-project.js +125 -0
- package/dist/internal/json-dir-store.d.ts +32 -0
- package/dist/internal/json-dir-store.d.ts.map +1 -0
- package/dist/internal/json-dir-store.js +100 -0
- package/dist/internal/json-schema.d.ts +18 -0
- package/dist/internal/json-schema.d.ts.map +1 -0
- package/dist/internal/json-schema.js +53 -0
- package/dist/internal/log-ring.d.ts +23 -0
- package/dist/internal/log-ring.d.ts.map +1 -0
- package/dist/internal/log-ring.js +42 -0
- package/dist/internal/map-pool.d.ts +6 -0
- package/dist/internal/map-pool.d.ts.map +1 -0
- package/dist/internal/map-pool.js +41 -0
- package/dist/internal/mcp-endpoint.d.ts +59 -0
- package/dist/internal/mcp-endpoint.d.ts.map +1 -0
- package/dist/internal/mcp-endpoint.js +355 -0
- package/dist/internal/mcp-host.d.ts +28 -0
- package/dist/internal/mcp-host.d.ts.map +1 -0
- package/dist/internal/mcp-host.js +162 -0
- package/dist/internal/net.d.ts +5 -0
- package/dist/internal/net.d.ts.map +1 -0
- package/dist/internal/net.js +30 -0
- package/dist/internal/peer-connections.d.ts +44 -0
- package/dist/internal/peer-connections.d.ts.map +1 -0
- package/dist/internal/peer-connections.js +67 -0
- package/dist/internal/playground/static.d.ts +35 -0
- package/dist/internal/playground/static.d.ts.map +1 -0
- package/dist/internal/playground/static.js +162 -0
- package/dist/internal/playground/toolchain.d.ts +57 -0
- package/dist/internal/playground/toolchain.d.ts.map +1 -0
- package/dist/internal/playground/toolchain.js +226 -0
- package/dist/internal/reminder-runner.d.ts +62 -0
- package/dist/internal/reminder-runner.d.ts.map +1 -0
- package/dist/internal/reminder-runner.js +582 -0
- package/dist/internal/reminder-schedule.d.ts +22 -0
- package/dist/internal/reminder-schedule.d.ts.map +1 -0
- package/dist/internal/reminder-schedule.js +82 -0
- package/dist/internal/reminder-store.d.ts +58 -0
- package/dist/internal/reminder-store.d.ts.map +1 -0
- package/dist/internal/reminder-store.js +106 -0
- package/dist/internal/resolved-connections.d.ts +41 -0
- package/dist/internal/resolved-connections.d.ts.map +1 -0
- package/dist/internal/resolved-connections.js +73 -0
- package/dist/internal/review-comments.d.ts +50 -0
- package/dist/internal/review-comments.d.ts.map +1 -0
- package/dist/internal/review-comments.js +194 -0
- package/dist/internal/router.d.ts +33 -0
- package/dist/internal/router.d.ts.map +1 -0
- package/dist/internal/router.js +93 -0
- package/dist/internal/run-client.d.ts +49 -0
- package/dist/internal/run-client.d.ts.map +1 -0
- package/dist/internal/run-client.js +208 -0
- package/dist/internal/schedule-runner.d.ts +31 -0
- package/dist/internal/schedule-runner.d.ts.map +1 -0
- package/dist/internal/schedule-runner.js +126 -0
- package/dist/internal/sdk-runner.d.ts +41 -0
- package/dist/internal/sdk-runner.d.ts.map +1 -0
- package/dist/internal/sdk-runner.js +221 -0
- package/dist/internal/server.d.ts +25 -0
- package/dist/internal/server.d.ts.map +1 -0
- package/dist/internal/server.js +1374 -0
- package/dist/internal/session-engine.d.ts +287 -0
- package/dist/internal/session-engine.d.ts.map +1 -0
- package/dist/internal/session-engine.js +1377 -0
- package/dist/internal/session-store.d.ts +29 -0
- package/dist/internal/session-store.d.ts.map +1 -0
- package/dist/internal/session-store.js +140 -0
- package/dist/internal/session-urls.d.ts +10 -0
- package/dist/internal/session-urls.d.ts.map +1 -0
- package/dist/internal/session-urls.js +25 -0
- package/dist/internal/stream-progress.d.ts +14 -0
- package/dist/internal/stream-progress.d.ts.map +1 -0
- package/dist/internal/stream-progress.js +195 -0
- package/dist/internal/tool-result.d.ts +20 -0
- package/dist/internal/tool-result.d.ts.map +1 -0
- package/dist/internal/tool-result.js +45 -0
- package/dist/internal/trajectory.d.ts +56 -0
- package/dist/internal/trajectory.d.ts.map +1 -0
- package/dist/internal/trajectory.js +248 -0
- package/dist/internal/workspace.d.ts +42 -0
- package/dist/internal/workspace.d.ts.map +1 -0
- package/dist/internal/workspace.js +199 -0
- package/dist/playground/assets/cursor-icons-outline-oY2V_mvK.woff2 +0 -0
- package/dist/playground/assets/index-1K-hG-7p.css +1 -0
- package/dist/playground/assets/index-FlWjhg3x.js +79 -0
- package/dist/playground/index.html +17 -0
- package/dist/reminders.d.ts +23 -0
- package/dist/reminders.d.ts.map +1 -0
- package/dist/reminders.js +22 -0
- package/dist/schedules.d.ts +23 -0
- package/dist/schedules.d.ts.map +1 -0
- package/dist/schedules.js +26 -0
- package/dist/skills.d.ts +22 -0
- package/dist/skills.d.ts.map +1 -0
- package/dist/skills.js +22 -0
- package/dist/tools.d.ts +92 -0
- package/dist/tools.d.ts.map +1 -0
- package/dist/tools.js +68 -0
- package/dist/types.d.ts +1609 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +80 -0
- package/docs/README.md +174 -0
- package/docs/ab.md +355 -0
- package/docs/building-with-agents.md +129 -0
- package/docs/concepts.md +177 -0
- package/docs/deployment.md +218 -0
- package/docs/evals.md +383 -0
- package/docs/guides/agent-to-agent.md +118 -0
- package/docs/guides/cloud-runtime.md +122 -0
- package/docs/guides/github.md +172 -0
- package/docs/guides/human-in-the-loop.md +131 -0
- package/docs/guides/slack.md +245 -0
- package/docs/guides/webhooks.md +201 -0
- package/docs/hillclimbing.md +93 -0
- package/docs/quickstart.md +183 -0
- package/docs/reference/agent-config.md +154 -0
- package/docs/reference/channels.md +206 -0
- package/docs/reference/cli.md +257 -0
- package/docs/reference/connections.md +137 -0
- package/docs/reference/hooks.md +74 -0
- package/docs/reference/http-api.md +219 -0
- package/docs/reference/instructions.md +77 -0
- package/docs/reference/playground.md +67 -0
- package/docs/reference/project-layout.md +119 -0
- package/docs/reference/schedules.md +220 -0
- package/docs/reference/sessions.md +165 -0
- package/docs/reference/skills.md +79 -0
- package/docs/reference/subagents.md +74 -0
- package/docs/reference/tools.md +203 -0
- package/docs/scaffolding-agents.md +113 -0
- package/docs/troubleshooting.md +95 -0
- package/package.json +185 -0
- package/skills/ab/SKILL.md +139 -0
- package/skills/create-agent/SKILL.md +219 -0
- package/skills/debug/SKILL.md +71 -0
- package/skills/evals/SKILL.md +217 -0
- package/skills/framework-map/SKILL.md +142 -0
- package/skills/github/SKILL.md +144 -0
- package/skills/hillclimb/SKILL.md +162 -0
- package/skills/setup-slack/SKILL.md +180 -0
- package/src/ab.ts +675 -0
- package/src/bin/agent-serve.ts +949 -0
- package/src/channels/github/api.ts +374 -0
- package/src/channels/github/auth.ts +275 -0
- package/src/channels/github/binding.ts +223 -0
- package/src/channels/github/defaults.ts +111 -0
- package/src/channels/github/events.ts +72 -0
- package/src/channels/github/forward.ts +381 -0
- package/src/channels/github/github-channel.ts +2270 -0
- package/src/channels/github/index.ts +52 -0
- package/src/channels/github/replay.ts +387 -0
- package/src/channels/github/state.ts +95 -0
- package/src/channels/github/types.ts +490 -0
- package/src/channels/slack/api.ts +580 -0
- package/src/channels/slack/approvals.ts +198 -0
- package/src/channels/slack/assistant.ts +76 -0
- package/src/channels/slack/auth.ts +112 -0
- package/src/channels/slack/channel-watch.ts +219 -0
- package/src/channels/slack/constants.ts +30 -0
- package/src/channels/slack/credentials.ts +90 -0
- package/src/channels/slack/cursor-account.ts +166 -0
- package/src/channels/slack/defaults.ts +450 -0
- package/src/channels/slack/dispatch.ts +293 -0
- package/src/channels/slack/doctor.ts +135 -0
- package/src/channels/slack/event-id-dedupe.ts +30 -0
- package/src/channels/slack/inbound.ts +219 -0
- package/src/channels/slack/index.ts +45 -0
- package/src/channels/slack/init.ts +133 -0
- package/src/channels/slack/interactive.ts +194 -0
- package/src/channels/slack/links.ts +23 -0
- package/src/channels/slack/live-delivery.ts +201 -0
- package/src/channels/slack/log.ts +83 -0
- package/src/channels/slack/manifest.ts +179 -0
- package/src/channels/slack/pr-ref.ts +50 -0
- package/src/channels/slack/setup.ts +97 -0
- package/src/channels/slack/slack-channel.ts +374 -0
- package/src/channels/slack/socket-mode.ts +154 -0
- package/src/channels/slack/stream.ts +63 -0
- package/src/channels/slack/tool-approval-events.ts +136 -0
- package/src/channels/slack/types.ts +349 -0
- package/src/channels.ts +385 -0
- package/src/connections.ts +89 -0
- package/src/evals.ts +501 -0
- package/src/hooks.ts +33 -0
- package/src/index.ts +184 -0
- package/src/internal/ab-collector.ts +210 -0
- package/src/internal/ab-fold.ts +228 -0
- package/src/internal/ab-snapshot.ts +335 -0
- package/src/internal/approval-gate.ts +115 -0
- package/src/internal/auth.ts +39 -0
- package/src/internal/authored-alias-hooks.ts +69 -0
- package/src/internal/authored-loaders.ts +138 -0
- package/src/internal/bounded-int.ts +27 -0
- package/src/internal/brand.ts +29 -0
- package/src/internal/chat-client.ts +407 -0
- package/src/internal/cli-ax.ts +474 -0
- package/src/internal/cli-cursor.ts +275 -0
- package/src/internal/cli-github.ts +849 -0
- package/src/internal/cli-slack.ts +175 -0
- package/src/internal/cloud-merge.ts +41 -0
- package/src/internal/cron.ts +78 -0
- package/src/internal/cursor/account-mcp.ts +472 -0
- package/src/internal/cursor/backend-client.ts +614 -0
- package/src/internal/cursor/credentials.ts +401 -0
- package/src/internal/cursor-event-relay.ts +281 -0
- package/src/internal/cursor-relay-core.ts +444 -0
- package/src/internal/cursor-slack-relay.ts +242 -0
- package/src/internal/describe-error.ts +4 -0
- package/src/internal/dev-mode.ts +20 -0
- package/src/internal/discovery.ts +1709 -0
- package/src/internal/distribution.ts +97 -0
- package/src/internal/docs-site.ts +191 -0
- package/src/internal/duration.ts +39 -0
- package/src/internal/eval-run-store.ts +519 -0
- package/src/internal/eval-runner.ts +522 -0
- package/src/internal/event-log.ts +175 -0
- package/src/internal/event-mapper.ts +272 -0
- package/src/internal/frontmatter.ts +77 -0
- package/src/internal/github-fanout.ts +159 -0
- package/src/internal/handleAgentServeTrigger.ts +156 -0
- package/src/internal/host-platforms.ts +144 -0
- package/src/internal/http-channel.ts +546 -0
- package/src/internal/ids.ts +44 -0
- package/src/internal/init-project.ts +165 -0
- package/src/internal/json-dir-store.ts +109 -0
- package/src/internal/json-schema.ts +69 -0
- package/src/internal/log-ring.ts +59 -0
- package/src/internal/map-pool.ts +32 -0
- package/src/internal/mcp-endpoint.ts +518 -0
- package/src/internal/mcp-host.ts +211 -0
- package/src/internal/net.ts +31 -0
- package/src/internal/peer-connections.ts +100 -0
- package/src/internal/playground/static.ts +189 -0
- package/src/internal/playground/toolchain.ts +277 -0
- package/src/internal/reminder-runner.ts +756 -0
- package/src/internal/reminder-schedule.ts +106 -0
- package/src/internal/reminder-store.ts +145 -0
- package/src/internal/resolved-connections.ts +145 -0
- package/src/internal/review-comments.ts +268 -0
- package/src/internal/router.ts +145 -0
- package/src/internal/run-client.ts +320 -0
- package/src/internal/schedule-runner.ts +161 -0
- package/src/internal/sdk-runner.ts +315 -0
- package/src/internal/server.ts +1737 -0
- package/src/internal/session-engine.ts +1810 -0
- package/src/internal/session-store.ts +147 -0
- package/src/internal/session-urls.ts +40 -0
- package/src/internal/stream-progress.ts +254 -0
- package/src/internal/tool-result.ts +54 -0
- package/src/internal/trajectory.ts +306 -0
- package/src/internal/workspace.ts +223 -0
- package/src/reminders.ts +35 -0
- package/src/schedules.ts +37 -0
- package/src/skills.ts +27 -0
- package/src/tools.ts +127 -0
- package/src/types.ts +1848 -0
|
@@ -0,0 +1,342 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The Cursor account MCP bridge: `defineConnection({ cursorAccount: true })`
|
|
3
|
+
* resolved for local turns.
|
|
4
|
+
*
|
|
5
|
+
* The serve host mounts one loopback-only streamable-HTTP MCP route per
|
|
6
|
+
* authored account MCP connection (`<base>/v1/cursor-account/<name>/mcp`,
|
|
7
|
+
* guarded by a per-boot bearer secret). The bridge lists and executes the
|
|
8
|
+
* account's connector tools through the Cursor backend
|
|
9
|
+
* (`DashboardService.ListSandMcpTools` / `ExecuteSandMcpTool`), which owns
|
|
10
|
+
* the OAuth credentials — **raw MCP tokens never enter this process**.
|
|
11
|
+
*
|
|
12
|
+
* Cloud-runtime turns reach the same bridge through the serve `publicUrl`
|
|
13
|
+
* (so `servers` filters apply there too); without one they omit the bridge
|
|
14
|
+
* and fall back to the account's natively hydrated connectors.
|
|
15
|
+
*/
|
|
16
|
+
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
17
|
+
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
18
|
+
return new (P || (P = Promise))(function (resolve, reject) {
|
|
19
|
+
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
20
|
+
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
21
|
+
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
22
|
+
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
23
|
+
});
|
|
24
|
+
};
|
|
25
|
+
import { randomBytes } from "node:crypto";
|
|
26
|
+
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
|
|
27
|
+
import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
|
|
28
|
+
import { bearerAuth } from "../../channels.js";
|
|
29
|
+
import { isCursorAccountTransport } from "../../types.js";
|
|
30
|
+
import { handleStatelessMcpRequest } from "../mcp-endpoint.js";
|
|
31
|
+
import { isLoopbackAddress } from "../net.js";
|
|
32
|
+
/** Catalog freshness window; a miss inside it re-uses the cached listing. */
|
|
33
|
+
const CATALOG_TTL_MS = 60000;
|
|
34
|
+
/**
|
|
35
|
+
* Unknown-tool lookups force a refresh, but never more often than this —
|
|
36
|
+
* a model hallucinating tool names cannot turn into a backend hot loop.
|
|
37
|
+
*/
|
|
38
|
+
const FORCE_REFRESH_MIN_INTERVAL_MS = 5000;
|
|
39
|
+
/** MCP clients commonly enforce `^[a-zA-Z0-9_-]{1,128}$` for tool names. */
|
|
40
|
+
const MAX_TOOL_NAME_LENGTH = 128;
|
|
41
|
+
/**
|
|
42
|
+
* Collect `cursorAccount` connections across `mounts`, grouped by mount
|
|
43
|
+
* slug. Purely structural — per-connector validation happens live against
|
|
44
|
+
* the account (see {@link CursorAccountMcpBridge.logPreflight}).
|
|
45
|
+
*/
|
|
46
|
+
export function collectCursorAccountConnections(mounts) {
|
|
47
|
+
const bySlug = new Map();
|
|
48
|
+
for (const { slug, project } of mounts) {
|
|
49
|
+
const refs = [];
|
|
50
|
+
for (const connection of project.agent.connections) {
|
|
51
|
+
if (!isCursorAccountTransport(connection.transport)) {
|
|
52
|
+
continue;
|
|
53
|
+
}
|
|
54
|
+
refs.push(Object.assign({ name: connection.name }, (connection.transport.servers === undefined
|
|
55
|
+
? {}
|
|
56
|
+
: { servers: [...connection.transport.servers] })));
|
|
57
|
+
}
|
|
58
|
+
if (refs.length > 0) {
|
|
59
|
+
bySlug.set(slug, refs);
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
return bySlug;
|
|
63
|
+
}
|
|
64
|
+
/** Bridge mount path for one account MCP connection, relative to the agent base. */
|
|
65
|
+
export function cursorAccountMcpPath(connectionName) {
|
|
66
|
+
return `/v1/cursor-account/${connectionName}/mcp`;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Resolve account refs to engine connections once the server is listening.
|
|
70
|
+
* Local turns and host-side `ctx.host.mcp` reach the loopback bridge with
|
|
71
|
+
* the per-boot secret. When `publicUrl` is configured, cloud turns use the
|
|
72
|
+
* same bridge route so `servers` filters apply there too.
|
|
73
|
+
*/
|
|
74
|
+
export function resolveCursorAccountConnections(args) {
|
|
75
|
+
const serverBase = trimTrailingSlash(args.serverUrl);
|
|
76
|
+
const publicBase = args.publicUrl === undefined
|
|
77
|
+
? undefined
|
|
78
|
+
: trimTrailingSlash(args.publicUrl);
|
|
79
|
+
const headers = { authorization: `Bearer ${args.bridgeSecret}` };
|
|
80
|
+
return args.refs.map((ref) => (Object.assign(Object.assign(Object.assign({ name: ref.name, localUrl: `${serverBase}${args.basePath}${cursorAccountMcpPath(ref.name)}` }, (publicBase === undefined
|
|
81
|
+
? {}
|
|
82
|
+
: {
|
|
83
|
+
cloudUrl: `${publicBase}${args.basePath}${cursorAccountMcpPath(ref.name)}`,
|
|
84
|
+
})), { headers }), (ref.servers === undefined ? {} : { accountServersFilter: ref.servers }))));
|
|
85
|
+
}
|
|
86
|
+
export class CursorAccountMcpBridge {
|
|
87
|
+
constructor(args) {
|
|
88
|
+
var _a;
|
|
89
|
+
/** Per-boot shared secret; resolved connections carry it as a bearer. */
|
|
90
|
+
this.secret = randomBytes(32).toString("hex");
|
|
91
|
+
this.catalogs = new Map();
|
|
92
|
+
this.client = args.client;
|
|
93
|
+
this.logger = (_a = args.logger) !== null && _a !== void 0 ? _a : (() => { });
|
|
94
|
+
this.secretPolicy = bearerAuth(this.secret);
|
|
95
|
+
this.allowRemoteCallers = args.allowRemoteCallers === true;
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Route auth for the bridge: the per-boot bearer secret, from a loopback
|
|
99
|
+
* TCP peer — or from anywhere when the serve host exposed the bridge via
|
|
100
|
+
* `publicUrl` (cloud turns arrive through that ingress with the secret).
|
|
101
|
+
*/
|
|
102
|
+
authPolicy() {
|
|
103
|
+
return (request, info) => __awaiter(this, void 0, void 0, function* () {
|
|
104
|
+
const loopback = info.requestIp !== null && isLoopbackAddress(info.requestIp);
|
|
105
|
+
if (!loopback && !this.allowRemoteCallers) {
|
|
106
|
+
return null;
|
|
107
|
+
}
|
|
108
|
+
if ((yield this.secretPolicy(request, info)) === null) {
|
|
109
|
+
return null;
|
|
110
|
+
}
|
|
111
|
+
return {
|
|
112
|
+
authenticator: "cursor-account-bridge",
|
|
113
|
+
principalId: "cursor-account-bridge",
|
|
114
|
+
principalType: "runtime",
|
|
115
|
+
};
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* Handle one streamable-HTTP MCP request for the connection described by
|
|
120
|
+
* `ref` (stateless: fresh server per POST, like the per-agent endpoint).
|
|
121
|
+
*/
|
|
122
|
+
handle(request, ref) {
|
|
123
|
+
return handleStatelessMcpRequest({
|
|
124
|
+
request,
|
|
125
|
+
buildServer: () => this.buildServer(ref),
|
|
126
|
+
label: "cursor account bridge",
|
|
127
|
+
logger: this.logger,
|
|
128
|
+
});
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Startup DX: log the account's connector statuses for `refs` without
|
|
132
|
+
* blocking serve startup. Surfaces "needsAuth" connectors (authorize in
|
|
133
|
+
* Cursor) and filters that matched nothing (typo'd connector names).
|
|
134
|
+
*/
|
|
135
|
+
logPreflight(refs) {
|
|
136
|
+
for (const ref of refs) {
|
|
137
|
+
void this.getCatalog(ref)
|
|
138
|
+
.then((catalog) => {
|
|
139
|
+
const summary = catalog.servers
|
|
140
|
+
.map((server) => `${server.serverIdentifier} (${server.status === "connected"
|
|
141
|
+
? `${server.tools.length} tools`
|
|
142
|
+
: server.status})`)
|
|
143
|
+
.join(", ");
|
|
144
|
+
this.logger(`[agent-serve] Cursor account MCP connection "${ref.name}": ${catalog.servers.length === 0
|
|
145
|
+
? "no matching connectors on this account — connect servers in Cursor (dashboard → MCP) or fix the `servers` filter"
|
|
146
|
+
: summary}`);
|
|
147
|
+
const needsAuth = catalog.servers.filter((server) => server.status === "needsAuth");
|
|
148
|
+
if (needsAuth.length > 0) {
|
|
149
|
+
this.logger(`[agent-serve] Cursor account MCP connection "${ref.name}": ${needsAuth
|
|
150
|
+
.map((server) => server.serverIdentifier)
|
|
151
|
+
.join(", ")} need re-authorization in Cursor before their tools appear`);
|
|
152
|
+
}
|
|
153
|
+
})
|
|
154
|
+
.catch((error) => {
|
|
155
|
+
this.logger(`[agent-serve] Cursor account MCP connection "${ref.name}" preflight failed: ${describeError(error)}`);
|
|
156
|
+
});
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
buildServer(ref) {
|
|
160
|
+
const server = new Server({ name: `cursor-account:${ref.name}`, version: "0.1.0" }, {
|
|
161
|
+
capabilities: { tools: {} },
|
|
162
|
+
instructions: "Tools from the Cursor account's MCP connectors. Every call executes on the Cursor backend with the account's stored credentials.",
|
|
163
|
+
});
|
|
164
|
+
server.setRequestHandler(ListToolsRequestSchema, () => __awaiter(this, void 0, void 0, function* () {
|
|
165
|
+
const catalog = yield this.getCatalog(ref);
|
|
166
|
+
return {
|
|
167
|
+
tools: catalog.tools.map((tool) => ({
|
|
168
|
+
name: tool.exposedName,
|
|
169
|
+
description: tool.description,
|
|
170
|
+
inputSchema: tool.inputSchema,
|
|
171
|
+
})),
|
|
172
|
+
};
|
|
173
|
+
}));
|
|
174
|
+
server.setRequestHandler(CallToolRequestSchema, (request) => __awaiter(this, void 0, void 0, function* () {
|
|
175
|
+
var _a;
|
|
176
|
+
const tool = yield this.findTool(ref, request.params.name);
|
|
177
|
+
if (tool === undefined) {
|
|
178
|
+
const catalog = yield this.getCatalog(ref);
|
|
179
|
+
return {
|
|
180
|
+
content: [
|
|
181
|
+
{
|
|
182
|
+
type: "text",
|
|
183
|
+
text: `Unknown tool "${request.params.name}". Available: ${catalog.tools.map((t) => t.exposedName).join(", ") || "(none)"}.`,
|
|
184
|
+
},
|
|
185
|
+
],
|
|
186
|
+
isError: true,
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
try {
|
|
190
|
+
const result = yield this.client.executeAccountMcpTool({
|
|
191
|
+
serverIdentifier: tool.serverIdentifier,
|
|
192
|
+
toolName: tool.backendName,
|
|
193
|
+
args: (_a = request.params.arguments) !== null && _a !== void 0 ? _a : {},
|
|
194
|
+
});
|
|
195
|
+
return Object.assign(Object.assign({ content: result.content }, (result.isError ? { isError: true } : {})), (result.structuredContent === undefined
|
|
196
|
+
? {}
|
|
197
|
+
: { structuredContent: result.structuredContent }));
|
|
198
|
+
}
|
|
199
|
+
catch (error) {
|
|
200
|
+
return {
|
|
201
|
+
content: [
|
|
202
|
+
{
|
|
203
|
+
type: "text",
|
|
204
|
+
text: `Account connector tool failed: ${describeError(error)}`,
|
|
205
|
+
},
|
|
206
|
+
],
|
|
207
|
+
isError: true,
|
|
208
|
+
};
|
|
209
|
+
}
|
|
210
|
+
}));
|
|
211
|
+
return server;
|
|
212
|
+
}
|
|
213
|
+
/** Resolve a tool by exposed name, refreshing once when it is unknown. */
|
|
214
|
+
findTool(ref, exposedName) {
|
|
215
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
216
|
+
const catalog = yield this.getCatalog(ref);
|
|
217
|
+
const hit = catalog.byExposedName.get(exposedName);
|
|
218
|
+
if (hit !== undefined) {
|
|
219
|
+
return hit;
|
|
220
|
+
}
|
|
221
|
+
const fresh = yield this.getCatalog(ref, { forceRefresh: true });
|
|
222
|
+
return fresh.byExposedName.get(exposedName);
|
|
223
|
+
});
|
|
224
|
+
}
|
|
225
|
+
/**
|
|
226
|
+
* Fetch (or join) the catalog for `ref`'s server filter. Staleness and
|
|
227
|
+
* joining are decided synchronously: in-flight entries always join their
|
|
228
|
+
* promise; fresh entries use {@link CatalogEntry.freshAtMs} for TTL.
|
|
229
|
+
*/
|
|
230
|
+
getCatalog(ref, options) {
|
|
231
|
+
var _a;
|
|
232
|
+
const key = ref.servers === undefined ? "*" : [...ref.servers].sort().join("\n");
|
|
233
|
+
const entry = this.catalogs.get(key);
|
|
234
|
+
if (entry !== undefined) {
|
|
235
|
+
if (entry.freshAtMs === undefined) {
|
|
236
|
+
return entry.promise;
|
|
237
|
+
}
|
|
238
|
+
const age = Date.now() - entry.freshAtMs;
|
|
239
|
+
const maxAge = (options === null || options === void 0 ? void 0 : options.forceRefresh) === true
|
|
240
|
+
? FORCE_REFRESH_MIN_INTERVAL_MS
|
|
241
|
+
: CATALOG_TTL_MS;
|
|
242
|
+
if (age < maxAge) {
|
|
243
|
+
return entry.promise;
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
const fresh = {
|
|
247
|
+
promise: this.client
|
|
248
|
+
.listAccountMcpTools((_a = ref.servers) !== null && _a !== void 0 ? _a : [])
|
|
249
|
+
.then((servers) => {
|
|
250
|
+
const catalog = buildCatalog(servers);
|
|
251
|
+
fresh.freshAtMs = Date.now();
|
|
252
|
+
return catalog;
|
|
253
|
+
})
|
|
254
|
+
.catch((error) => {
|
|
255
|
+
// Never cache a failure — but only evict our own entry, so a slow
|
|
256
|
+
// failing fetch cannot delete a newer, healthy refresh.
|
|
257
|
+
if (this.catalogs.get(key) === fresh) {
|
|
258
|
+
this.catalogs.delete(key);
|
|
259
|
+
}
|
|
260
|
+
throw error;
|
|
261
|
+
}),
|
|
262
|
+
};
|
|
263
|
+
this.catalogs.set(key, fresh);
|
|
264
|
+
return fresh.promise;
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
/**
|
|
268
|
+
* Build the exposed-tool catalog. Collision suffixes are assigned after
|
|
269
|
+
* sorting the colliding group by backend identity, so the exposed-name →
|
|
270
|
+
* backend-tool mapping is stable across refreshes even when the backend
|
|
271
|
+
* enumerates servers in a different order.
|
|
272
|
+
*/
|
|
273
|
+
function buildCatalog(servers) {
|
|
274
|
+
const byBase = new Map();
|
|
275
|
+
for (const server of servers) {
|
|
276
|
+
for (const tool of server.tools) {
|
|
277
|
+
const base = sanitizeToolName(tool.name);
|
|
278
|
+
const group = byBase.get(base);
|
|
279
|
+
const item = { serverIdentifier: server.serverIdentifier, tool };
|
|
280
|
+
if (group === undefined) {
|
|
281
|
+
byBase.set(base, [item]);
|
|
282
|
+
}
|
|
283
|
+
else {
|
|
284
|
+
group.push(item);
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
const tools = [];
|
|
289
|
+
const byExposedName = new Map();
|
|
290
|
+
// Process sanitize bases in deterministic order so cross-group exposed-name
|
|
291
|
+
// reservation does not depend on backend server listing order.
|
|
292
|
+
const sortedBases = [...byBase.keys()].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
|
|
293
|
+
for (const base of sortedBases) {
|
|
294
|
+
const group = byBase.get(base);
|
|
295
|
+
// Codepoint comparison (not localeCompare): the suffix assignment must
|
|
296
|
+
// be identical on every host and across refreshes.
|
|
297
|
+
group.sort((a, b) => {
|
|
298
|
+
const left = `${a.serverIdentifier}\n${a.tool.name}`;
|
|
299
|
+
const right = `${b.serverIdentifier}\n${b.tool.name}`;
|
|
300
|
+
return left < right ? -1 : left > right ? 1 : 0;
|
|
301
|
+
});
|
|
302
|
+
group.forEach(({ serverIdentifier, tool }, index) => {
|
|
303
|
+
let suffixIndex = index;
|
|
304
|
+
let exposedName = suffixToolName(base, suffixIndex);
|
|
305
|
+
while (byExposedName.has(exposedName)) {
|
|
306
|
+
suffixIndex++;
|
|
307
|
+
exposedName = suffixToolName(base, suffixIndex);
|
|
308
|
+
}
|
|
309
|
+
const entry = {
|
|
310
|
+
exposedName,
|
|
311
|
+
backendName: tool.name,
|
|
312
|
+
serverIdentifier,
|
|
313
|
+
description: tool.description,
|
|
314
|
+
inputSchema: tool.inputSchema,
|
|
315
|
+
};
|
|
316
|
+
tools.push(entry);
|
|
317
|
+
byExposedName.set(entry.exposedName, entry);
|
|
318
|
+
});
|
|
319
|
+
}
|
|
320
|
+
return { servers, tools, byExposedName };
|
|
321
|
+
}
|
|
322
|
+
/** Connector display names can contain anything (spaces, dots, emoji). */
|
|
323
|
+
function sanitizeToolName(name) {
|
|
324
|
+
const cleaned = name
|
|
325
|
+
.replace(/[^a-zA-Z0-9_-]/g, "_")
|
|
326
|
+
.slice(0, MAX_TOOL_NAME_LENGTH);
|
|
327
|
+
return cleaned === "" ? "tool" : cleaned;
|
|
328
|
+
}
|
|
329
|
+
/** `base` for the first claimant, `base_2` / `base_3` … for colliders. */
|
|
330
|
+
function suffixToolName(base, index) {
|
|
331
|
+
if (index === 0) {
|
|
332
|
+
return base;
|
|
333
|
+
}
|
|
334
|
+
const suffix = `_${index + 1}`;
|
|
335
|
+
return `${base.slice(0, MAX_TOOL_NAME_LENGTH - suffix.length)}${suffix}`;
|
|
336
|
+
}
|
|
337
|
+
function trimTrailingSlash(url) {
|
|
338
|
+
return url.endsWith("/") ? url.slice(0, -1) : url;
|
|
339
|
+
}
|
|
340
|
+
function describeError(error) {
|
|
341
|
+
return error instanceof Error ? error.message : String(error);
|
|
342
|
+
}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Minimal Connect-JSON client for the handful of `aiserver.v1.DashboardService`
|
|
3
|
+
* RPCs agent-serve needs — `GetMe`, `ListSandMcpTools`, `ExecuteSandMcpTool`,
|
|
4
|
+
* and the login-time key lifecycle (`CreateUserApiKey`, `ListUserApiKeys`,
|
|
5
|
+
* `RevokeUserApiKey`).
|
|
6
|
+
*
|
|
7
|
+
* Plain `fetch` POSTs with proto-JSON bodies and zod-validated responses:
|
|
8
|
+
* agent-serve is a published package and should not pull the generated
|
|
9
|
+
* proto tree in for a few unary calls.
|
|
10
|
+
*
|
|
11
|
+
* Auth: the client holds the account API key and exchanges it on demand for
|
|
12
|
+
* a short-lived access token (`POST /auth/exchange_user_api_key`, ~1h),
|
|
13
|
+
* cached until shortly before expiry and re-exchanged once on a 401.
|
|
14
|
+
*/
|
|
15
|
+
import { z } from "zod";
|
|
16
|
+
export declare class CursorBackendError extends Error {
|
|
17
|
+
readonly status?: number | undefined;
|
|
18
|
+
constructor(message: string, status?: number | undefined);
|
|
19
|
+
}
|
|
20
|
+
declare const getMeResponseSchema: z.ZodObject<{
|
|
21
|
+
authId: z.ZodOptional<z.ZodString>;
|
|
22
|
+
email: z.ZodOptional<z.ZodString>;
|
|
23
|
+
firstName: z.ZodOptional<z.ZodString>;
|
|
24
|
+
lastName: z.ZodOptional<z.ZodString>;
|
|
25
|
+
teamId: z.ZodOptional<z.ZodNumber>;
|
|
26
|
+
teamName: z.ZodOptional<z.ZodString>;
|
|
27
|
+
}, "strip">;
|
|
28
|
+
export type CursorIdentity = z.infer<typeof getMeResponseSchema>;
|
|
29
|
+
export interface AccountMcpTool {
|
|
30
|
+
/** Fully-qualified tool name (`<server>-<tool>`), the execution key. */
|
|
31
|
+
name: string;
|
|
32
|
+
description: string;
|
|
33
|
+
/** JSON Schema for the tool input (defaulted when the server omits it). */
|
|
34
|
+
inputSchema: Record<string, unknown>;
|
|
35
|
+
}
|
|
36
|
+
export interface AccountMcpServer {
|
|
37
|
+
serverIdentifier: string;
|
|
38
|
+
status: string;
|
|
39
|
+
tools: AccountMcpTool[];
|
|
40
|
+
}
|
|
41
|
+
/** Normalized tool-call outcome, shaped like an MCP `CallToolResult`. */
|
|
42
|
+
export interface AccountMcpCallResult {
|
|
43
|
+
content: Array<{
|
|
44
|
+
type: "text";
|
|
45
|
+
text: string;
|
|
46
|
+
} | {
|
|
47
|
+
type: "image";
|
|
48
|
+
data: string;
|
|
49
|
+
mimeType?: string;
|
|
50
|
+
}>;
|
|
51
|
+
isError: boolean;
|
|
52
|
+
structuredContent?: Record<string, unknown>;
|
|
53
|
+
}
|
|
54
|
+
export interface CursorBackendClientOptions {
|
|
55
|
+
backendUrl: string;
|
|
56
|
+
apiKey: string;
|
|
57
|
+
logger?: (line: string) => void;
|
|
58
|
+
/** Test seam; defaults to global fetch. */
|
|
59
|
+
fetchImpl?: typeof fetch;
|
|
60
|
+
}
|
|
61
|
+
export declare class CursorBackendClient {
|
|
62
|
+
private readonly backendUrl;
|
|
63
|
+
private readonly apiKey;
|
|
64
|
+
private readonly logger;
|
|
65
|
+
private readonly fetchImpl;
|
|
66
|
+
private token;
|
|
67
|
+
private tokenExchange;
|
|
68
|
+
constructor(options: CursorBackendClientOptions);
|
|
69
|
+
/** Who this API key acts as. */
|
|
70
|
+
getMe(): Promise<CursorIdentity>;
|
|
71
|
+
/**
|
|
72
|
+
* The account's MCP connectors with live status and backend-prefixed tool
|
|
73
|
+
* definitions. `serverIdentifiers` restricts discovery (empty = all
|
|
74
|
+
* HTTP/SSE servers on the account).
|
|
75
|
+
*/
|
|
76
|
+
listAccountMcpTools(serverIdentifiers: readonly string[]): Promise<AccountMcpServer[]>;
|
|
77
|
+
/**
|
|
78
|
+
* Execute one connector tool **on the Cursor backend** with the account's
|
|
79
|
+
* stored OAuth credentials. `toolName` is the fully-qualified name from
|
|
80
|
+
* {@link listAccountMcpTools}.
|
|
81
|
+
*/
|
|
82
|
+
executeAccountMcpTool(args: {
|
|
83
|
+
serverIdentifier: string;
|
|
84
|
+
toolName: string;
|
|
85
|
+
args: Record<string, unknown>;
|
|
86
|
+
}): Promise<AccountMcpCallResult>;
|
|
87
|
+
private rpc;
|
|
88
|
+
private getAccessToken;
|
|
89
|
+
private exchangeApiKey;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Mint a named user API key from a short-lived login session token. Used
|
|
93
|
+
* exactly once per `agent-serve login`; the session token is then discarded.
|
|
94
|
+
*/
|
|
95
|
+
export declare function createUserApiKeyWithSessionToken(args: {
|
|
96
|
+
backendUrl: string;
|
|
97
|
+
sessionToken: string;
|
|
98
|
+
keyName: string;
|
|
99
|
+
fetchImpl?: typeof fetch;
|
|
100
|
+
}): Promise<string>;
|
|
101
|
+
/**
|
|
102
|
+
* Best-effort cleanup when `login` mints a key but fails before storing it,
|
|
103
|
+
* authenticated with the browser session token that minted it. The key is
|
|
104
|
+
* identified by its masked suffix in `ListUserApiKeys` — never by name alone,
|
|
105
|
+
* so replica lag after `CreateUserApiKey` can only skip the cleanup, not
|
|
106
|
+
* revoke an older same-named key.
|
|
107
|
+
*/
|
|
108
|
+
export declare function revokeMintedUserApiKey(args: {
|
|
109
|
+
backendUrl: string;
|
|
110
|
+
keyName: string;
|
|
111
|
+
/** The raw minted key; selects the exact list row via `maskedKey`. */
|
|
112
|
+
apiKey: string;
|
|
113
|
+
/** Session token from the PKCE login; the bearer for list + revoke. */
|
|
114
|
+
sessionToken: string;
|
|
115
|
+
fetchImpl?: typeof fetch;
|
|
116
|
+
}): Promise<void>;
|
|
117
|
+
export {};
|
|
118
|
+
//# sourceMappingURL=backend-client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"backend-client.d.ts","sourceRoot":"","sources":["../../../src/internal/cursor/backend-client.ts"],"names":[],"mappings":"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"}
|