@cursor/bdk 0.2.3 → 0.2.4

package/src/connections.ts

@@ -1,153 +0,0 @@
-/**
- * `defineConnection` — authored at `agent/mcp-connections/<name>.ts`
- * (model + host) or `agent/host-connections/<name>.ts` (host + `mcp oauth`
- * only).
- *
- * A connection gives tools from an external MCP server. The filename
- * becomes the connection (server) name. Files under `mcp-connections/`
- * are available to the agent (SDK `mcpServers`), host (`ctx.host.mcp`),
- * and channel/schedule handlers. Pass `advertiseTools: true` for named
- * tools on local turns. Pass `effects: "read"` with `advertiseTools` to
- * advertise only tools the server classifies as reads. Pass `tools` as
- * a name list to keep a subset, same shape as `defineAgent({ tools })`.
- * Pass `disallowedTools` to drop names. Files under
- * `host-connections/` stay off the model.
- *
- * ```ts
- * import { defineConnection } from "@cursor/bdk/connections";
- *
- * export default defineConnection({
- *   url: "https://mcp.linear.app/mcp",
- *   headers: { authorization: "Bearer ${LINEAR_TOKEN}" },
- * });
- *
- * // TypeScript tools, packaged as stdio MCP for the agent environment:
- * export default defineConnection({
- *   tools: {
- *     probe_cloud_tool: {
- *       description: "Prove the tool ran in the agent environment.",
- *       async execute({ label }) {
- *         return { ok: true, label };
- *       },
- *     },
- *   },
- * });
- *
- * export default defineConnection({
- *   cursorAccount: true,
- *   servers: ["anytool"],
- * });
- *
- * // query-only: advertise only tools classified as reads
- * export default defineConnection({
- *   url: "https://api.cursor.com/v1/agent/mcp",
- *   advertiseTools: true,
- *   effects: "read",
- * });
- *
- * // named subset: advertise and call only these tools
- * export default defineConnection({
- *   url: "https://mcp.example.com/inventory",
- *   advertiseTools: true,
- *   tools: ["search_skus", "get_stock"],
- * });
- *
- * // drop a few tools from a large server
- * export default defineConnection({
- *   url: "https://mcp.example.com/inventory",
- *   advertiseTools: true,
- *   disallowedTools: ["place_order", "delete_sku"],
- * });
- * ```
- *
- * A **Cursor account MCP connection** exposes the MCP connectors the operator
- * already authorized in their Cursor account (dashboard → MCP). Every tool
- * executes **on the Cursor backend** with the account's stored OAuth
- * credentials, so the agent gets Linear / Notion / Slack / … tools with
- * zero token plumbing and no OAuth secrets on this host. Requires the host
- * to be signed in (`agent-sdk login`, `CURSOR_API_KEY`, or
- * `CURSOR_SERVICE_ACCOUNT_KEY`):
- *
- * ```ts
- * // agent/mcp-connections/account.ts — every connected server (no allowlist)
- * export default defineConnection({
- *   cursorAccount: true,
- *   advertiseTools: true,
- * });
- * // equivalent explicit form:
- * export default defineConnection({
- *   cursorAccount: true,
- *   servers: "*",
- *   advertiseTools: true,
- * });
- *
- * // or restrict to specific connectors by name
- * export default defineConnection({
- *   cursorAccount: true,
- *   servers: ["Linear"],
- *   advertiseTools: true,
- * });
- * ```
- *
- * A **peer MCP connection** addresses another agent mounted on the same serve
- * host by slug — every mounted agent is itself an MCP server at
- * `/<slug>/v1/mcp` (tools: `ask`, `check`, and `call_tool` when it has
- * server tools), so the model can delegate work to the peer, which runs
- * in its own sessions with its own tools and context:
- *
- * ```ts
- * export default defineConnection({
- *   agent: "weather-agent",
- *   description: "Delegate weather questions to the weather agent.",
- * });
- * ```
- *
- * Peer URLs resolve over loopback when the server starts.
- *
- * Server tools can call the same connection:
- *
- * ```ts
- * async execute(input, ctx) {
- *   return ctx.host.mcp.callTool("linear", "list_issues", { query: input.q });
- * }
- * ```
- *
- * So can webhook / channel route handlers (deterministic, no agent loop):
- *
- * ```ts
- * POST("/sync", {
- *   bodySchema: z.object({}),
- *   handler: async (_req, { host }) => {
- *     const result = await host.mcp.callTool("linear", "list_issues", {});
- *     return Response.json(result);
- *   },
- * });
- * ```
- */
-
-import { brandDefinition } from "./internal/brand.js";
-import type { ConnectionConfig, ConnectionDefinition } from "./types.js";
-
-export type {
-  ConnectionConfig,
-  ConnectionDefinition,
-  ConnectionEffects,
-  ConnectionTransport,
-  HostMcpCallResult,
-  HostMcpRegistry,
-  HostMcpToolInfo,
-  InlineStdioConnectionConfig,
-  InlineStdioToolConfig,
-  ToolEffect,
-} from "./types.js";
-export {
-  isInlineStdioConnection,
-  isToolEffect,
-  normalizeConnectionEffects,
-  normalizeConnectionTools,
-  normalizeCursorAccountServers,
-} from "./types.js";
-
-export function defineConnection(config: ConnectionConfig): ConnectionDefinition {
-  return brandDefinition("connection", config);
-}

package/src/dashboard-session-url.ts

@@ -1,30 +0,0 @@
-/**
- * Hosted dashboard deep-link for a serve session.
- *
- * Prefers the playground URL operators already use:
- * `https://cursor.com/dashboard/deployed-agents/<slug>/playground?sessionId=`
- * Falls back to `https://cursor.com/agents/<publicId>/<sessionId>` when the
- * slug is unknown. Returns undefined without a hosted public id so local
- * serve never emits a broken link.
- */
-
-const PUBLIC_ID = /^asd_[0-9a-f]{32}$/;
-const SLUG = /^[a-z0-9][a-z0-9_-]{0,63}$/;
-
-export const AGENT_SERVE_PUBLIC_ID_ENV = "AGENT_SERVE_PUBLIC_ID";
-
-export function dashboardSessionUrl(
-  sessionId: string,
-  opts?: { slug?: string; publicId?: string },
-): string | undefined {
-  const publicId = opts?.publicId ?? process.env[AGENT_SERVE_PUBLIC_ID_ENV];
-  if (publicId === undefined || !PUBLIC_ID.test(publicId)) {
-    return undefined;
-  }
-  const origin = (process.env.CURSOR_WEBSITE_URL ?? "https://cursor.com").replace(/\/$/, "");
-  const slug = opts?.slug;
-  if (slug !== undefined && SLUG.test(slug)) {
-    return `${origin}/dashboard/deployed-agents/${slug}/playground?sessionId=${encodeURIComponent(sessionId)}`;
-  }
-  return `${origin}/agents/${publicId}/${encodeURIComponent(sessionId)}`;
-}