@cursor/bdk 0.2.1 → 0.2.3

package/src/types.ts

@@ -342,7 +342,10 @@ export interface AgentHostingOptions {
    * Domains the deployed engine pod may reach (egress allowlist), e.g.
    * `"api.example.com"` or `"*.example.com"` (single leading wildcard).
    * Lowercase hostnames with at least two labels and an alphabetic TLD;
-   * max 20. `agent-sdk deploy` sends these as `egressAllowedDomains`
+   * max 64. A `"host:port"` entry (e.g. `"clickhouse.example.com:9440"`)
+   * opens raw TCP to that host's addresses, for wire protocols the proxy
+   * cannot read a TLS hostname from.
+   * `agent-sdk deploy` sends these as `egressAllowedDomains`
    * (unioned with any `--allow-domain` flags). Only valid on repo-backed
    * deployments. Deployment-scoped like {@link secretNames}: not capped by
    * the team's Cloud Agent egress allowlist. The platform still merges a
@@ -834,7 +837,7 @@ export interface HostOtelApi {
 
 /** Runtime context handed to a tool's `execute`. */
 export interface ToolContext {
-  /** Correlates with `actions.requested` / `action.result` stream events. */
+  /** Correlates with `actions.requested` / `actions.completed` stream events. */
   toolCallId?: string;
   /** The session this tool call runs inside. */
   session: SessionInfo;
@@ -1219,6 +1222,13 @@ export interface DiscoveredExtension {
  *   resolves to a bridge on this host that executes every tool **on the
  *   Cursor backend** with the account's stored OAuth credentials — tokens
  *   never reach this host.
+ *
+ * Credentials belong in `headers` (http/sse) and `env` (stdio) as `${NAME}`
+ * templates, which the transport keeps verbatim and expands from the
+ * environment each time a client opens. Reading `process.env` in the
+ * connection module instead pins whatever the variable held when discovery
+ * imported it, which on Cursor hosting is nothing: the platform binds a
+ * deployment's secrets per request, long after that import.
  */
 export type ConnectionTransport =
   | {
@@ -1547,6 +1557,22 @@ export interface ActionCall {
    * parent `task` tool call id is `parentCallId`.
    */
   parentCallId?: string;
+  /**
+   * Model generation that requested this call. Every tool from one
+   * `runStep` shares the same id (the step's invocation id).
+   */
+  modelCallId?: string;
+}
+
+/** One tool result inside an {@link SessionEventPayload} `actions.completed` batch. */
+export interface ActionResult {
+  callId: string;
+  toolName: string;
+  output?: unknown;
+  isError: boolean;
+  stubbed?: true;
+  parentCallId?: string;
+  modelCallId?: string;
 }
 
 /** Human decision for a parked {@link ToolConfig.needsApproval} tool call. */
@@ -1613,7 +1639,16 @@ export type SessionEventPayload =
     }
   | {
       type: "actions.requested";
-      data: { calls: ActionCall[]; parentCallId?: string };
+      data: {
+        calls: ActionCall[];
+        parentCallId?: string;
+        /**
+         * Same id as {@link ActionCall.modelCallId} on every call.
+         * One envelope per model step (a single tool is a batch of one)
+         * once that step has finished listing tools.
+         */
+        modelCallId?: string;
+      };
     }
   | {
       /**
@@ -1679,6 +1714,21 @@ export type SessionEventPayload =
          */
         stubbed?: true;
         parentCallId?: string;
+        /** Same id as the matching {@link ActionCall.modelCallId}. */
+        modelCallId?: string;
+      };
+    }
+  | {
+      /**
+       * Every result for one {@link SessionEventPayload} `actions.requested`
+       * batch. Pair these two events; `action.result` stays the live
+       * per-call envelope for chips and spans.
+       */
+      type: "actions.completed";
+      data: {
+        results: ActionResult[];
+        parentCallId?: string;
+        modelCallId?: string;
       };
     }
   | {
@@ -2678,8 +2728,9 @@ export interface ArtifactsConfig {
    */
   agentTool?: boolean;
   /**
-   * Retention cap (default 1000). On insert past the cap, the
-   * oldest-updated artifact is evicted.
+   * Retention cap (default 1000). Architecture v1 and self-hosted v2
+   * evict the oldest-updated artifact on insert past the cap. Hosted
+   * architecture v2 does not evict; the installation store keeps every row.
    */
   max?: number;
 }

package/templates/agents-md/bot/lib/collect.ts

@@ -335,10 +335,7 @@ async function readFile(
 ): Promise<string | undefined> {
   try {
     const { data } = await octokit.rest.repos.getContent(args);
-    if (Array.isArray(data) || data.encoding !== "base64") {
-      return undefined;
-    }
-    if (typeof data.content !== "string") {
+    if (Array.isArray(data) || data.type !== "file" || data.encoding !== "base64") {
       return undefined;
     }
     return Buffer.from(data.content, "base64").toString("utf8");

package/templates/code-wiki/bot/channels/github.ts

@@ -90,8 +90,8 @@ async function loadWiki(
       if (
         body === undefined ||
         Array.isArray(body) ||
-        body.encoding !== "base64" ||
-        typeof body.content !== "string"
+        body.type !== "file" ||
+        body.encoding !== "base64"
       ) {
         return;
       }

package/templates/demo/bot/channels/github.ts

@@ -12,7 +12,11 @@ function wake(url: string, github: GitHubHandle) {
   if (start === undefined || ref === undefined) {
     return null;
   }
-  return { task: () => startDemo(start, github, ref) };
+  return {
+    task: async () => {
+      await startDemo(start, github, ref);
+    },
+  };
 }
 
 export default githubChannel({

package/templates/pr-autofixer/bot/lib/start-drive.ts

@@ -7,13 +7,13 @@ import { fetchPrState, isTerminalPrState } from "./pr-state.js";
 
 export type StartDriveErrorCode = "missing_pr" | "unrecognized_pr";
 
-export interface StartDriveError {
+export type StartDriveError = {
   ok: false;
   code: StartDriveErrorCode;
   error: string;
-}
+};
 
-export interface StartDriveSuccess {
+export type StartDriveSuccess = {
   ok: true;
   pr: string;
   sessionId: string | null;
@@ -23,7 +23,7 @@ export interface StartDriveSuccess {
   status: string;
   result: string | null;
   mergeConflictReminderId: string | null;
-}
+};
 
 export type StartDriveResult = StartDriveError | StartDriveSuccess;
 

package/templates/triage/bot/lib/types.ts

@@ -10,7 +10,7 @@ export interface QueueIssue {
   reporter?: string;
 }
 
-export interface TriageVerdict {
+export type TriageVerdict = {
   identifier: string;
   kind: TriageKind;
   severity: TriageSeverity;
@@ -20,12 +20,12 @@ export interface TriageVerdict {
   reporter?: string;
   duplicateOf?: string;
   needsInfo?: boolean;
-}
+};
 
-export interface TrackerIssue {
+export type TrackerIssue = {
   identifier: string;
   url: string;
-}
+};
 
 export type QueueAction =
   | { op: "commented" }
@@ -39,10 +39,10 @@ export type TrackerResult =
   | { status: "acted"; issue: TrackerIssue; actions: QueueAction[] }
   | { status: "failed"; message: string };
 
-export interface RecordTriageResult {
+export type RecordTriageResult = {
   verdict: TriageVerdict;
   evaluatedAt: string;
   tracker: TrackerResult;
-}
+};
 
 export type TrackerConfig = { kind: "none" } | { kind: "linear" | "jira"; connectionName: string };