@cursor/bdk 0.2.24 → 0.2.26

package/dist/playground/index.html

@@ -8,8 +8,8 @@
     />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>agent-serve playground</title>
-    <script type="module" crossorigin src="./assets/index-DKKdkF29.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-DpKinTMs.css">
+    <script type="module" crossorigin src="./assets/index-DpbzbqFY.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-CyPkf2y7.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/public-deprecated.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Root-only aliases. The same symbols stay unmarked on
+ * `@cursor/bdk/internal/discovery` and `@cursor/bdk/internal/continuation`.
+ */
+import type { AgentProject, Diagnostic, ProjectInfo } from "./types.js";
+import { type ContinuationClaim } from "./internal/continuation-identity.js";
+/** @deprecated Import from `@cursor/bdk/internal/discovery`. */
+export interface LoadAgentProjectOptions {
+    /** Override the module loader (embedders / tests). */
+    importModule?: (absolutePath: string) => Promise<Record<string, unknown>>;
+}
+/** @deprecated Use loadProject. The loader remains at `@cursor/bdk/internal/discovery`. */
+export declare function loadAgentProject(dir: string, options?: LoadAgentProjectOptions): Promise<AgentProject>;
+/** @deprecated Use loadProject. The loader remains at `@cursor/bdk/internal/discovery`. */
+export declare function loadAgentProjects(rootDir: string, options?: LoadAgentProjectOptions): Promise<Array<{
+    slug: string;
+    project: AgentProject;
+}>>;
+/** @deprecated Import from `@cursor/bdk/internal/discovery`. */
+export declare function resolveAgentMounts(rootDir: string, options?: LoadAgentProjectOptions & {
+    mode?: "single" | "multi";
+}): Promise<Array<{
+    slug: string;
+    project: AgentProject;
+}>>;
+/** @deprecated Import from `@cursor/bdk/internal/discovery`. */
+export declare function isAgentProjectDir(dir: string): Promise<boolean>;
+/** @deprecated Import from `@cursor/bdk/internal/discovery`. */
+export declare function formatDiagnostics(diagnostics: Diagnostic[]): string;
+/** @deprecated Import from `@cursor/bdk/internal/discovery`. */
+export declare function hasErrorDiagnostics(project: AgentProject): boolean;
+/** @deprecated Read `Project.info` from loadProject. */
+export declare function projectInfo(project: AgentProject): ProjectInfo;
+/** @deprecated Import from `@cursor/bdk/internal/continuation`. */
+export declare function mintClaim(claim: ContinuationClaim): string;
+//# sourceMappingURL=public-deprecated.d.ts.map

package/dist/public-deprecated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-deprecated.d.ts","sourceRoot":"","sources":["../src/public-deprecated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,qCAAqC,CAAC;AAW7C,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3E;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAEzD;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,uBAAuB,GAAG;IAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,GAChE,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAEzD;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAEnE;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAElE;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAE9D;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAE1D"}

package/dist/public-deprecated.js

@@ -0,0 +1,39 @@
+/**
+ * Root-only aliases. The same symbols stay unmarked on
+ * `@cursor/bdk/internal/discovery` and `@cursor/bdk/internal/continuation`.
+ */
+import { mintClaim as mintClaimImpl, } from "./internal/continuation-identity.js";
+import { formatDiagnostics as formatDiagnosticsImpl, hasErrorDiagnostics as hasErrorDiagnosticsImpl, isAgentProjectDir as isAgentProjectDirImpl, loadAgentProject as loadAgentProjectImpl, loadAgentProjects as loadAgentProjectsImpl, resolveAgentMounts as resolveAgentMountsImpl, } from "./internal/discovery.js";
+import { projectInfo as projectInfoImpl } from "./internal/discovery/info.js";
+/** @deprecated Use loadProject. The loader remains at `@cursor/bdk/internal/discovery`. */
+export function loadAgentProject(dir, options) {
+    return loadAgentProjectImpl(dir, options);
+}
+/** @deprecated Use loadProject. The loader remains at `@cursor/bdk/internal/discovery`. */
+export function loadAgentProjects(rootDir, options) {
+    return loadAgentProjectsImpl(rootDir, options);
+}
+/** @deprecated Import from `@cursor/bdk/internal/discovery`. */
+export function resolveAgentMounts(rootDir, options) {
+    return resolveAgentMountsImpl(rootDir, options);
+}
+/** @deprecated Import from `@cursor/bdk/internal/discovery`. */
+export function isAgentProjectDir(dir) {
+    return isAgentProjectDirImpl(dir);
+}
+/** @deprecated Import from `@cursor/bdk/internal/discovery`. */
+export function formatDiagnostics(diagnostics) {
+    return formatDiagnosticsImpl(diagnostics);
+}
+/** @deprecated Import from `@cursor/bdk/internal/discovery`. */
+export function hasErrorDiagnostics(project) {
+    return hasErrorDiagnosticsImpl(project);
+}
+/** @deprecated Read `Project.info` from loadProject. */
+export function projectInfo(project) {
+    return projectInfoImpl(project);
+}
+/** @deprecated Import from `@cursor/bdk/internal/continuation`. */
+export function mintClaim(claim) {
+    return mintClaimImpl(claim);
+}

package/dist/tools.d.ts

@@ -6,7 +6,7 @@
  *
  * ```ts
  * import { defineTool } from "@cursor/bdk/tools";
- * import { z } from "zod/v3";
+ * import * as z from "zod/v4";
  *
  * // Runs in-process on the agent-serve host (default). Authored MCP
  * // connections are on ctx.host.mcp (also on the Cursor agent via SDK, and
@@ -51,11 +51,10 @@
  * });
  * ```
  */
-import type { z } from "zod/v3";
 import { forwardTimeArgument, missingTimeWindow, schemaTimeWindowKeys } from "./internal/as-of.js";
 import { classifyAnnotationsEffect } from "./internal/tool-policy.js";
-import type { JsonObject, JsonSchemaObject, ToolContext, ToolDefinition, ToolEffectDeclaration, ToolExecuteResult, ToolNeedsApproval } from "./types.js";
-export type { HostMcpCallResult, HostMcpRegistry, HostMcpToolInfo, ToolConfig, ToolContext, ToolDefinition, ToolEffect, ToolEffectDeclaration, ToolExecuteResult, ToolExecution, ToolNeedsApproval, ToolResultContent, } from "./types.js";
+import type { JsonObject, JsonSchemaObject, ToolContext, ToolDefinition, ToolEffectDeclaration, ToolExecuteResult, ToolNeedsApproval, ZodSchema, ZodSchemaOutput } from "./types.js";
+export type { HostMcpCallResult, HostMcpRegistry, HostMcpToolInfo, ToolConfig, ToolContext, ToolDefinition, ToolEffect, ToolEffectDeclaration, ToolExecuteResult, ToolExecution, ToolNeedsApproval, ToolResultContent, ZodSchema, ZodSchemaInput, ZodSchemaOutput, ZodV4Schema, } from "./types.js";
 /**
  * Time-window and effect classifiers the host applies to every tool call.
  * Re-exported for tools that reach other tools themselves (change-monitor
@@ -63,9 +62,12 @@ export type { HostMcpCallResult, HostMcpRegistry, HostMcpToolInfo, ToolConfig, T
  * forward-time, omitted-window, and read-only filters.
  */
 export { classifyAnnotationsEffect, forwardTimeArgument, missingTimeWindow, schemaTimeWindowKeys };
-/** Input type for `execute`: inferred from a zod schema, JSON otherwise. */
-export type ToolInput<TSchema> = TSchema extends z.ZodTypeAny ? z.infer<TSchema> : JsonObject;
-type ServerToolConfig<TSchema> = {
+/**
+ * Input type for `execute`: the parsed type of a `zod/v3` or `zod/v4`
+ * schema, JSON otherwise.
+ */
+export type ToolInput<TSchema> = TSchema extends ZodSchema ? ZodSchemaOutput<TSchema> : JsonObject;
+export type ServerToolConfig<TSchema> = {
     description: string;
     execution?: "server";
     inputSchema?: TSchema;
@@ -73,7 +75,7 @@ type ServerToolConfig<TSchema> = {
      * JSON Schema for the tool's structured output (zod converted at
      * discovery, never validated against). Advertised when declared.
      */
-    outputSchema?: z.ZodTypeAny | JsonSchemaObject;
+    outputSchema?: ZodSchema | JsonSchemaObject;
     needsApproval?: ToolNeedsApproval<ToolInput<TSchema>>;
     /**
      * Whether this tool changes anything outside the session. Undeclared means
@@ -94,12 +96,12 @@ type ServerToolConfig<TSchema> = {
     execute: (input: ToolInput<TSchema>, ctx: ToolContext) => ToolExecuteResult | Promise<ToolExecuteResult>;
     script?: never;
 };
-type AgentToolConfig<TSchema> = {
+export type AgentToolConfig<TSchema> = {
     description: string;
     execution: "agent";
     inputSchema?: TSchema;
     /** Output JSON Schema; advertised when declared, never validated against. */
-    outputSchema?: z.ZodTypeAny | JsonSchemaObject;
+    outputSchema?: ZodSchema | JsonSchemaObject;
     /**
      * Shell script written into the session workspace. Receives a JSON
      * object on stdin and should print the result on stdout.
@@ -118,8 +120,9 @@ type AgentToolConfig<TSchema> = {
     dryRunResult?: never;
 };
 /**
- * Define a tool. With a zod `inputSchema` the input is validated before
- * `execute` runs and typed via inference; with a plain JSON Schema object
+ * Define a tool. With a zod `inputSchema` (`zod/v3` or `zod/v4`) the input
+ * is validated before `execute` runs and typed via inference; with a plain
+ * JSON Schema object
  * (or no schema) the input is the raw JSON arguments.
  *
  * Set `execution: "agent"` to materialize a workspace script instead of
@@ -128,5 +131,5 @@ type AgentToolConfig<TSchema> = {
  * Set `needsApproval: true` (or a predicate) so the host parks the
  * in-flight call until a human approves or denies it.
  */
-export declare function defineTool<TSchema extends z.ZodTypeAny | JsonSchemaObject | undefined = undefined>(config: ServerToolConfig<TSchema> | AgentToolConfig<TSchema>): ToolDefinition;
+export declare function defineTool<TSchema extends ZodSchema | JsonSchemaObject | undefined = undefined>(config: ServerToolConfig<TSchema> | AgentToolConfig<TSchema>): ToolDefinition;
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEnG,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,UAAU,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB;;;;;GAKG;AACH,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;AAEnG,4EAA4E;AAC5E,MAAM,MAAM,SAAS,CAAC,OAAO,IAAI,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC;AAE9F,KAAK,gBAAgB,CAAC,OAAO,IAAI;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC,UAAU,GAAG,gBAAgB,CAAC;IAC/C,aAAa,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD;;;OAGG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,iBAAiB,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,iBAAiB,CAAC,CAAC;IACtF,OAAO,EAAE,CACP,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,EACzB,GAAG,EAAE,WAAW,KACb,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB,CAAC;AAEF,KAAK,eAAe,CAAC,OAAO,IAAI;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,CAAC,UAAU,GAAG,gBAAgB,CAAC;IAC/C;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,uEAAuE;IACvE,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAChG,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,GAC3D,cAAc,CAEhB"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEnG,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,UAAU,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB;;;;;GAKG;AACH,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;AAEnG;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,OAAO,IAAI,OAAO,SAAS,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC;AAEnG,MAAM,MAAM,gBAAgB,CAAC,OAAO,IAAI;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAAC;IAC5C,aAAa,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD;;;OAGG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,iBAAiB,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,iBAAiB,CAAC,CAAC;IACtF,OAAO,EAAE,CACP,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,EACzB,GAAG,EAAE,WAAW,KACb,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,OAAO,IAAI;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAAC;IAC5C;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,uEAAuE;IACvE,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAC7F,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,GAC3D,cAAc,CAEhB"}

package/dist/tools.js

@@ -6,7 +6,7 @@
  *
  * ```ts
  * import { defineTool } from "@cursor/bdk/tools";
- * import { z } from "zod/v3";
+ * import * as z from "zod/v4";
  *
  * // Runs in-process on the agent-serve host (default). Authored MCP
  * // connections are on ctx.host.mcp (also on the Cursor agent via SDK, and
@@ -62,8 +62,9 @@ import { classifyAnnotationsEffect } from "./internal/tool-policy.js";
  */
 export { classifyAnnotationsEffect, forwardTimeArgument, missingTimeWindow, schemaTimeWindowKeys };
 /**
- * Define a tool. With a zod `inputSchema` the input is validated before
- * `execute` runs and typed via inference; with a plain JSON Schema object
+ * Define a tool. With a zod `inputSchema` (`zod/v3` or `zod/v4`) the input
+ * is validated before `execute` runs and typed via inference; with a plain
+ * JSON Schema object
  * (or no schema) the input is the raw JSON arguments.
  *
  * Set `execution: "agent"` to materialize a workspace script instead of