@cursor/bdk 0.2.24 → 0.2.26

package/dist/extensions/cursor-cloud-agents/tools/reply.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineTool } from "../../../tools.js";
 import extension from "../extension.js";
 import { cloudAgentsBackend } from "../lib/backend.js";

package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/cursor-grokbot-agents/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,sBAAsB,CAAC,CAAC;IAChD;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AA0CzC,QAAA,MAAM,mBAAmB,EAAE,SAAS,CAClC,yBAAyB,EACzB,0BAA0B,GAAG,SAAS,CAKtC,CAAC;eAEY,mBAAmB"}
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/cursor-grokbot-agents/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,sBAAsB,CAAC,CAAC;IAChD;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAmCzC,QAAA,MAAM,mBAAmB,EAAE,SAAS,CAClC,yBAAyB,EACzB,0BAA0B,GAAG,SAAS,CAKtC,CAAC;eAEY,mBAAmB"}

package/dist/extensions/cursor-grokbot-agents/extension.js

@@ -29,7 +29,7 @@
  * extension keeps the agent where it is and lets it talk to *other* Grok
  * Bot agents.
  */
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineExtension } from "../../extensions.js";
 /** The backend's session name limit. */
 export const AGENT_NAME_MAX_LENGTH = 255;
@@ -45,7 +45,11 @@ const configuredAgent = z
 const agents = z
     .array(configuredAgent)
     .min(1, "agents must name at least one Grok Bot agent; omit it to allow any.")
-    .refine((list) => new Set(list.map((agent) => agent.name.toLowerCase())).size === list.length, "agents must not repeat a name (names match case-insensitively).");
+    .refine((list) => new Set(list.map((agent) => agent.name.toLowerCase())).size === list.length, {
+    message: "agents must not repeat a name (names match case-insensitively).",
+    // An element that failed `agentName` never reached the transform, so it has no `name`.
+    when: (payload) => payload.issues.length === 0,
+});
 const config = z
     .object({
     agents: agents.optional(),
@@ -53,7 +57,7 @@ const config = z
     apiKey: z.string().optional(),
     pollIntervalMs: z.number().int().min(1).default(DEFAULT_POLL_INTERVAL_MS),
 })
-    .default({})
+    .prefault({})
     .transform((options) => ({
     ...options,
     needsApproval: options.needsApproval ?? options.agents === undefined,

package/dist/extensions/cursor-grokbot-agents/lib/backend.js

@@ -7,7 +7,7 @@
  * after a cursor, with the turn's status alongside.
  */
 import { randomUUID } from "node:crypto";
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { cursorExternalApiUrl, resolveApiKeySync, SIGN_IN_HINT, } from "../../../internal/cursor/credentials.js";
 import extension from "../extension.js";
 const REQUEST_TIMEOUT_MS = 60_000;

package/dist/extensions/cursor-grokbot-agents/lib/contacts.js

@@ -6,7 +6,7 @@
  * since that caller last read, and a lookup by name for `check` and
  * `interrupt`, which never create an agent the caller has not spoken to.
  */
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { KeyedLock } from "./lock.js";
 const PREFIX = "grokbot-agents";
 const contactsSchema = z.array(z.object({

package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 export declare const agentName: z.ZodOptional<z.ZodString>;
 export declare const waitSeconds: z.ZodDefault<z.ZodNumber>;
 //# sourceMappingURL=inputs.d.ts.map

package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAM9C,CAAC;AAEJ,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAQ/C,CAAC"}
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAM9C,CAAC;AAEJ,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAQ/C,CAAC"}

package/dist/extensions/cursor-grokbot-agents/lib/inputs.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { AGENT_NAME_MAX_LENGTH } from "../extension.js";
 import { DEFAULT_WAIT_SECONDS, MAX_WAIT_SECONDS } from "./conversation.js";
 export const agentName = z

package/dist/extensions/cursor-grokbot-agents/tools/ask.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineTool } from "../../../tools.js";
 import extension from "../extension.js";
 import { ask as askAgent } from "../lib/conversation.js";

package/dist/extensions/cursor-grokbot-agents/tools/check.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineTool } from "../../../tools.js";
 import { check as checkAgent } from "../lib/conversation.js";
 import { agentName, waitSeconds } from "../lib/inputs.js";

package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineTool } from "../../../tools.js";
 import { interrupt as interruptAgent } from "../lib/conversation.js";
 import { agentName } from "../lib/inputs.js";

package/dist/extensions/cursor-grokbot-agents/tools/list.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineTool } from "../../../tools.js";
 import extension from "../extension.js";
 import { listContacts } from "../lib/contacts.js";

package/dist/extensions/improve/extension.js

@@ -24,7 +24,7 @@
  * repository checked out needs no second mount: the skill has it work in
  * that checkout.
  */
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineExtension } from "../../extensions.js";
 const line = z.string().trim().min(1);
 const improve = defineExtension({

package/dist/extensions/jev/extension.js

@@ -20,7 +20,7 @@
  * Hosted deploys allowlist `api.typesafe.ai` for the mounting agent and
  * expect a `TYPESAFE_API_KEY` secret.
  */
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineExtension } from "../../extensions.js";
 import { DEFAULT_EVALUATION_MODEL, DEFAULT_TYPESAFE_HOST, TYPESAFE_API_KEY_ENV, } from "./lib/evaluate.js";
 const config = z
@@ -30,7 +30,7 @@ const config = z
     harnessTools: z.boolean().default(true),
     skills: z.boolean().default(true),
 })
-    .default({})
+    .prefault({})
     .transform((options) => ({
     apiKey: options.apiKey,
     model: options.model ?? DEFAULT_EVALUATION_MODEL,

package/dist/extensions/jev/tools/evaluate.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineTool } from "../../../tools.js";
 import extension from "../extension.js";
 import { evaluate } from "../lib/evaluate.js";
@@ -11,7 +11,7 @@ const choiceQuestion = z.object({
     id: z.string().min(1),
     type: z.literal("choice"),
     instructions: z.string().min(1),
-    criteria: z.record(z.string()),
+    criteria: z.record(z.string(), z.string()),
 });
 const scoreQuestion = z.object({
     id: z.string().min(1),
@@ -52,7 +52,7 @@ const evaluateTool = defineTool({
     inputSchema: z
         .object({
         state: z
-            .union([z.string(), z.array(z.unknown()), z.record(z.unknown())])
+            .union([z.string(), z.array(z.unknown()), z.record(z.string(), z.unknown())])
             .describe("Ticket, pull request, or other state Jev should judge. Not repo source."),
         questions: z
             .array(question)

package/dist/extensions/slack-communication/extension.js

@@ -18,7 +18,7 @@
  * through the channel Slack client. The tools do not call Slack.
  * `post-update` returns a ts for edit and delete.
  */
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineExtension } from "../../extensions.js";
 const slackCommunication = defineExtension({
     root: import.meta.dirname,

package/dist/extensions/slack-communication/tools/delete-message.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { has } from "../../../channels/slack/agentic-posted.js";
 import { MAX_REASON_CHARS } from "../../../channels/slack/agentic-signals.js";
 import { defineTool } from "../../../tools.js";

package/dist/extensions/slack-communication/tools/edit-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edit-message.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/edit-message.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,QAAA,MAAM,WAAW,EAAE,cA6BjB,CAAC;eAEY,WAAW"}
+{"version":3,"file":"edit-message.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/edit-message.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,QAAA,MAAM,WAAW,EAAE,cA0BjB,CAAC;eAEY,WAAW"}

package/dist/extensions/slack-communication/tools/edit-message.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { has } from "../../../channels/slack/agentic-posted.js";
 import { MAX_UPDATE_CHARS } from "../../../channels/slack/agentic-signals.js";
 import { defineTool } from "../../../tools.js";
@@ -13,15 +13,12 @@ const editMessage = defineTool({
     inputSchema: z.object({
         ts: z.string().trim().min(1, INVALID_ARGUMENTS_MESSAGE),
         message: z
-            .string({
-            required_error: INVALID_ARGUMENTS_MESSAGE,
-            invalid_type_error: INVALID_ARGUMENTS_MESSAGE,
-        })
+            .string({ error: INVALID_ARGUMENTS_MESSAGE })
             .min(1, INVALID_ARGUMENTS_MESSAGE)
             .superRefine((message, ctx) => {
             if (message.length > MAX_UPDATE_CHARS) {
                 ctx.addIssue({
-                    code: z.ZodIssueCode.custom,
+                    code: "custom",
                     message: `size (${message.length}) is more than ${MAX_UPDATE_CHARS}-character limit. drop what the reader would not act on and try again`,
                 });
             }

package/dist/extensions/slack-communication/tools/post-card.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineTool } from "../../../tools.js";
 const postCard = defineTool({
     description: [

package/dist/extensions/slack-communication/tools/post-file.js

@@ -1,6 +1,6 @@
 import { realpathSync, statSync } from "node:fs";
 import { basename, extname, isAbsolute, sep } from "node:path";
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { defineTool } from "../../../tools.js";
 const ALLOWED = new Set([
     ".png",

package/dist/extensions/slack-communication/tools/post-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-update.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/post-update.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,QAAA,MAAM,UAAU,EAAE,cA6BhB,CAAC;eAEY,UAAU"}
+{"version":3,"file":"post-update.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/post-update.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,QAAA,MAAM,UAAU,EAAE,cA0BhB,CAAC;eAEY,UAAU"}

package/dist/extensions/slack-communication/tools/post-update.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { reserve } from "../../../channels/slack/agentic-posted.js";
 import { MAX_UPDATE_CHARS } from "../../../channels/slack/agentic-signals.js";
 import { defineTool } from "../../../tools.js";
@@ -14,15 +14,12 @@ const postUpdate = defineTool({
     ].join(" "),
     inputSchema: z.object({
         message: z
-            .string({
-            required_error: INVALID_ARGUMENTS_MESSAGE,
-            invalid_type_error: INVALID_ARGUMENTS_MESSAGE,
-        })
+            .string({ error: INVALID_ARGUMENTS_MESSAGE })
             .min(1, INVALID_ARGUMENTS_MESSAGE)
             .superRefine((message, ctx) => {
             if (message.length > MAX_UPDATE_CHARS) {
                 ctx.addIssue({
-                    code: z.ZodIssueCode.custom,
+                    code: "custom",
                     message: `size (${message.length}) is more than ${MAX_UPDATE_CHARS}-character limit. drop what the reader would not act on and move receipts into a post-file attachment, rather than compressing the sentences you keep, and try again`,
                 });
             }

package/dist/extensions/slack-communication/tools/react.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { emojiName } from "../../../channels/slack/agentic-signals.js";
 import { defineTool } from "../../../tools.js";
 const react = defineTool({

package/dist/extensions/slack-communication/tools/set-status.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { SLACK_STATUS_MAX_LEN } from "../../../channels/slack/constants.js";
 import { defineTool } from "../../../tools.js";
 const setStatus = defineTool({

package/dist/extensions.d.ts

@@ -11,7 +11,7 @@
  * ```ts
  * // extension.ts
  * import { defineExtension } from "@cursor/bdk/extensions";
- * import { z } from "zod/v3";
+ * import * as z from "zod/v4";
  *
  * export default defineExtension({
  *   root: import.meta.dirname,

package/dist/extensions.js

@@ -11,7 +11,7 @@
  * ```ts
  * // extension.ts
  * import { defineExtension } from "@cursor/bdk/extensions";
- * import { z } from "zod/v3";
+ * import * as z from "zod/v4";
  *
  * export default defineExtension({
  *   root: import.meta.dirname,

package/dist/index.d.ts

@@ -12,8 +12,7 @@
  * console.log(`agent listening on ${handle.url}`);
  * ```
  */
-import { type LoadAgentProjectOptions } from "./internal/discovery.js";
-import type { AgentConfig, AgentConfigDefinition, AgentProject, AgentServeHandle, InstructionsConfig, InstructionsDefinition, ServeOptions } from "./types.js";
+import type { AgentConfig, AgentConfigDefinition, AgentServeHandle, InstructionsConfig, InstructionsDefinition, Project, ServeOptions } from "./types.js";
 export { defineArtifacts } from "./artifacts.js";
 export { allowAll, bearerAuth, DELETE, defineChannel, GET, localDev, localDevStrict, loopbackGitHubDev, loopbackOnly, PATCH, POST, PUT, publicEndpoint, } from "./channels.js";
 export { defineConnection } from "./connections.js";
@@ -23,9 +22,8 @@ export { DeleteNotSupportedError, EditError, emptyFs, FILE_SYSTEM_SCAN_LIMIT, Fi
 export { defineHook } from "./hooks.js";
 export { InvalidAsOfError, VacuousTimeArgsError } from "./internal/as-of.js";
 export type { ContinuationBuiltin, ContinuationClaim, ContinuationIdentity, ContinuationSelector, ConversationType, MailboxContinuation, ParsedContinuation, } from "./internal/continuation-identity.js";
-export { mintClaim } from "./internal/continuation-identity.js";
-export type { LoadAgentProjectOptions } from "./internal/discovery.js";
-export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, projectInfo, resolveAgentMounts, } from "./internal/discovery.js";
+export type { LoadAgentProjectOptions } from "./public-deprecated.js";
+export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, mintClaim, projectInfo, resolveAgentMounts, } from "./public-deprecated.js";
 export { nearestNeighborMissHint } from "./internal/filesystem/nearest.js";
 export type { AgentServeGitHubTriggerEvent, AgentServeGitHubTriggerTarget, AgentServeOriginTriggerEvent, AgentServeOriginTriggerTarget, AgentServeTriggerEvent, AgentServeTriggerResult, AgentServeTriggerTargetResult, } from "./internal/handleAgentServeTrigger.js";
 export { collectGitHubTriggerTargets, collectOriginTriggerTargets, handleAgentServeTrigger, } from "./internal/handleAgentServeTrigger.js";
@@ -33,9 +31,10 @@ export { MCP_CHANNEL_ID, MCP_ENDPOINT_PATH, mcpEndpointToolNames, TOOL_MCP_ENDPO
 export { REMINDER_ARGS_MAX_BYTES, ReminderValidationError, rejectAnonymousReminderHandlers, UnknownReminderError, } from "./internal/reminder-runner.js";
 export type { AgentMount } from "./internal/server.js";
 export { SessionBusyError, ToolInputError, ToolNotDirectlyCallableError, UnknownChannelError, UnknownSessionError, UnknownToolError, } from "./internal/session-engine.js";
-export type { MemoryBackend, TurnMemoryRecord } from "./memory.js";
+export { loadProject, ProjectLoadError } from "./internal/discovery/project-public.js";
+export type { LoadProjectOptions } from "./internal/discovery/project-public.js";
+export type { AgentStoreMemoryBackendOptions, FileMemoryBackendOptions, MemoryBackend, MemoryHookOptions, TurnMemoryRecord, } from "./memory.js";
 export { agentStoreMemoryBackend, fileMemoryBackend, memoryHook } from "./memory.js";
-export type { OtelConfig, OtelDefinition, OtelExporterConfig } from "./otel.js";
 export type { PromptTag } from "./prompt.js";
 export { prompt } from "./prompt.js";
 export type { ReminderBusyPolicy, ReminderCreateInput, ReminderDefinition, ReminderFireContext, ReminderFireResult, ReminderFollowupOptions, ReminderHandlerConfig, ReminderHostApi, ReminderInfo, ReminderReschedule, ReminderScheduleKind, ReminderStatus, ReminderTarget, ReminderUntilContext, } from "./reminders.js";
@@ -43,6 +42,7 @@ export { defineReminder } from "./reminders.js";
 export { defineSchedule } from "./schedules.js";
 export { defineSkill } from "./skills.js";
 export { defineTool } from "./tools.js";
+export type { AgentToolConfig, ServerToolConfig } from "./tools.js";
 export type * from "./types.js";
 export { cursorAccountServersHasMixedWildcard, DEFAULT_MODEL, DIRECT_TOOL_CALL_CHANNEL_ID, HttpSessionAdmitError, isCursorAccountTransport, isPeerConnectionTransport, isSymbolicConnectionTransport, isToolEffect, MAX_RUNNING_TURNS_LIMIT, normalizeConnectionEffects, normalizeConnectionTools, normalizeCursorAccountServers, supportsKvCas, } from "./types.js";
 /**
@@ -65,19 +65,22 @@ export declare function defineInstructions(config: InstructionsConfig): Instruct
  *   directory name as the slug.
  * - Given a directory whose immediate children are agent projects, mounts
  *   each under its directory name.
- * - Pass `mode: "single"` (or an {@link AgentProject}) for the unslugged
+ * - Pass `mode: "single"` (or a {@link Project}) for the unslugged
  *   `/v1/*` surface.
  *
  * The built-in session channel lives under `/v1/session*`, custom channels
  * under `/v1/channels/<id>`, plus `/v1/health` and `/v1/info`. Schedules run
  * on their cron cadence unless dev mode or `schedules: false` disables them.
  */
-export declare function serve(projectOrDir: string | AgentProject, options?: ServeOptions & {
-    discovery?: LoadAgentProjectOptions;
+export declare function serve(projectOrDir: string | Project, options?: ServeOptions & {
+    discovery?: {
+        /** Override the module loader (embedders / tests). */
+        importModule?: (absolutePath: string) => Promise<Record<string, unknown>>;
+    };
     /**
      * Mount layout. Defaults to `"multi"` (slugged routes + index).
      * `"single"` serves one agent at `/v1/*` with an empty slug. Ignored when
-     * an {@link AgentProject} is passed (always single-mount).
+     * a {@link Project} is passed (always single-mount).
      */
     mode?: "single" | "multi";
 }): Promise<AgentServeHandle>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -16,6 +16,7 @@ import { registerAuthoredModuleLoaders } from "./internal/authored-loaders.js";
 import { brandDefinition } from "./internal/brand.js";
 import { setDevMode } from "./internal/dev-mode.js";
 import { resolveAgentMounts } from "./internal/discovery.js";
+import { unwrapProject } from "./internal/discovery/project-public.js";
 import { startServer } from "./internal/server.js";
 export { defineArtifacts } from "./artifacts.js";
 // Authoring helpers (also available on their focused subpath exports).
@@ -25,13 +26,13 @@ export { cursorPlugin, defineExtension, disable, disableArtifacts, disableChanne
 export { DeleteNotSupportedError, EditError, emptyFs, FILE_SYSTEM_SCAN_LIMIT, FileNotFoundError, hostFs, InvalidGrepPatternError, isFileNotFoundError, NoMountError, childOverlayFs, overlayFs, PathError, ReadOnlyMountError, strReplaceOnFileSystem, tempFs, unionFs, WriteFailedError, } from "./filesystem.js";
 export { defineHook } from "./hooks.js";
 export { InvalidAsOfError, VacuousTimeArgsError } from "./internal/as-of.js";
-export { mintClaim } from "./internal/continuation-identity.js";
-export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, projectInfo, resolveAgentMounts, } from "./internal/discovery.js";
+export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, mintClaim, projectInfo, resolveAgentMounts, } from "./public-deprecated.js";
 export { nearestNeighborMissHint } from "./internal/filesystem/nearest.js";
 export { collectGitHubTriggerTargets, collectOriginTriggerTargets, handleAgentServeTrigger, } from "./internal/handleAgentServeTrigger.js";
 export { MCP_CHANNEL_ID, MCP_ENDPOINT_PATH, mcpEndpointToolNames, TOOL_MCP_ENDPOINT_PATH, } from "./internal/mcp-endpoint.js";
 export { REMINDER_ARGS_MAX_BYTES, ReminderValidationError, rejectAnonymousReminderHandlers, UnknownReminderError, } from "./internal/reminder-runner.js";
 export { SessionBusyError, ToolInputError, ToolNotDirectlyCallableError, UnknownChannelError, UnknownSessionError, UnknownToolError, } from "./internal/session-engine.js";
+export { loadProject, ProjectLoadError } from "./internal/discovery/project-public.js";
 export { agentStoreMemoryBackend, fileMemoryBackend, memoryHook } from "./memory.js";
 export { prompt } from "./prompt.js";
 export { defineReminder } from "./reminders.js";
@@ -63,7 +64,7 @@ export function defineInstructions(config) {
  *   directory name as the slug.
  * - Given a directory whose immediate children are agent projects, mounts
  *   each under its directory name.
- * - Pass `mode: "single"` (or an {@link AgentProject}) for the unslugged
+ * - Pass `mode: "single"` (or a {@link Project}) for the unslugged
  *   `/v1/*` surface.
  *
  * The built-in session channel lives under `/v1/session*`, custom channels
@@ -71,6 +72,9 @@ export function defineInstructions(config) {
  * on their cron cadence unless dev mode or `schedules: false` disables them.
  */
 export async function serve(projectOrDir, options = {}) {
+    if ("otel" in options) {
+        throw new Error('serve({ otel }) is removed. See "Migrating from serve({ otel })" in docs/guides/opentelemetry.md.');
+    }
     const { discovery, mode, ...serveOptions } = options;
     // Programmatic embedders get the same authored-TypeScript loading as the
     // CLI (idempotent; the bin registers earlier, source runs are a no-op).
@@ -80,7 +84,7 @@ export async function serve(projectOrDir, options = {}) {
     // loopback-forwarded deliveries. No-op outside dev.
     setDevMode(serveOptions.dev === true);
     if (typeof projectOrDir !== "string") {
-        return startServer([{ slug: "", project: projectOrDir }], serveOptions);
+        return startServer([{ slug: "", project: unwrapProject(projectOrDir) }], serveOptions);
     }
     const mounts = await resolveAgentMounts(projectOrDir, {
         ...discovery,

package/dist/internal/approval-gate.d.ts

@@ -8,10 +8,12 @@
  * reloads. After a process restart the in-flight SDK tool callback is gone,
  * so resolve returns false and the host treats the park as interrupted.
  */
-import type { ApprovalDecision, PendingApproval } from "../types.js";
+import type { ApprovalDecision, AuthContext, PendingApproval } from "../types.js";
 export interface ApprovalResolution {
     decision: ApprovalDecision;
     by?: string;
+    /** The resolver's auth context, when the host knows it. */
+    approver?: AuthContext;
 }
 export declare class ApprovalGate<T extends {
     callId: string;
@@ -22,7 +24,7 @@ export declare class ApprovalGate<T extends {
      * Unblock a waiter. Returns false when there is no live waiter (e.g. the
      * host restarted while the tool call was parked).
      */
-    resolve(sessionId: string, callId: string, decision: ApprovalDecision, resolvedBy?: string): boolean;
+    resolve(sessionId: string, callId: string, decision: ApprovalDecision, resolvedBy?: string, approver?: AuthContext): boolean;
     has(sessionId: string, callId: string): boolean;
     list(sessionId: string): T[];
     /** Drop waiters for a session (e.g. turn already failed). */

package/dist/internal/approval-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval-gate.d.ts","sourceRoot":"","sources":["../../src/internal/approval-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMrE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAOD,qBAAa,YAAY,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAExD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAY5D;IAED;;;OAGG;IACH,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAaT;IAED,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9C;IAED,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,CAS3B;IAED,6DAA6D;IAC7D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAyB,GAAG,IAAI,CAS1E;IAED,wDAAwD;IACxD,SAAS,CAAC,QAAQ,GAAE,gBAAyB,GAAG,IAAI,CAKnD;CACF"}
+{"version":3,"file":"approval-gate.d.ts","sourceRoot":"","sources":["../../src/internal/approval-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMlF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAOD,qBAAa,YAAY,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAExD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAY5D;IAED;;;OAGG;IACH,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAcT;IAED,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9C;IAED,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,CAS3B;IAED,6DAA6D;IAC7D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAyB,GAAG,IAAI,CAS1E;IAED,wDAAwD;IACxD,SAAS,CAAC,QAAQ,GAAE,gBAAyB,GAAG,IAAI,CAKnD;CACF"}

package/dist/internal/approval-gate.js

@@ -32,7 +32,7 @@ export class ApprovalGate {
      * Unblock a waiter. Returns false when there is no live waiter (e.g. the
      * host restarted while the tool call was parked).
      */
-    resolve(sessionId, callId, decision, resolvedBy) {
+    resolve(sessionId, callId, decision, resolvedBy, approver) {
         const key = approvalKey(sessionId, callId);
         const waiter = this.waiters.get(key);
         if (waiter === undefined) {
@@ -43,6 +43,7 @@ export class ApprovalGate {
         waiter.resolve({
             decision,
             by,
+            approver,
         });
         return true;
     }

package/dist/internal/as-of.d.ts

@@ -1,8 +1,10 @@
+/** @deprecated Deprecated on the package root. */
 export declare class InvalidAsOfError extends Error {
     constructor(value: string);
 }
 export declare function normalizeAsOf(value: string | undefined): string | undefined;
 export declare function sessionClock(asOf: string | undefined): () => Date;
+/** @deprecated Deprecated on the package root. */
 export declare class VacuousTimeArgsError extends Error {
     constructor(toolName: string, missing: readonly string[]);
 }

package/dist/internal/as-of.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"as-of.d.ts","sourceRoot":"","sources":["../../src/internal/as-of.ts"],"names":[],"mappings":"AAEA,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,KAAK,EAAE,MAAM,EAMxB;CACF;AAWD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAS3E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,IAAI,CAMjE;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAQvD;CACF;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QAAE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC7C,WAAW,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CACxD,EAAE,EACH,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,IAAI,CAeN;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAwBpB;AAyCD,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmCpF;AAqBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,SAAS,GAChE,MAAM,EAAE,CAkBV;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAgBpB"}
+{"version":3,"file":"as-of.d.ts","sourceRoot":"","sources":["../../src/internal/as-of.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,KAAK,EAAE,MAAM,EAMxB;CACF;AAWD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAS3E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,IAAI,CAMjE;AAED,kDAAkD;AAClD,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAQvD;CACF;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QAAE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC7C,WAAW,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CACxD,EAAE,EACH,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,IAAI,CAeN;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAwBpB;AAyCD,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmCpF;AAqBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,SAAS,GAChE,MAAM,EAAE,CAkBV;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAgBpB"}

package/dist/internal/as-of.js

@@ -1,4 +1,5 @@
 const TIMEZONE_SUFFIX = /(?:Z|[+-]\d{2}:?\d{2})$/i;
+/** @deprecated Deprecated on the package root. */
 export class InvalidAsOfError extends Error {
     constructor(value) {
         super(`asOf must be an ISO-8601 instant with a timezone (e.g. ` +
@@ -31,6 +32,7 @@ export function sessionClock(asOf) {
     const frozen = new Date(asOf).getTime();
     return () => new Date(frozen);
 }
+/** @deprecated Deprecated on the package root. */
 export class VacuousTimeArgsError extends Error {
     constructor(toolName, missing) {
         super(`Tool "${toolName}" declares timeArgs ` +

package/dist/internal/builtin-tools/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/internal/builtin-tools/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAmBrD,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CA+BvE"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/internal/builtin-tools/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,eAAe,EAEf,cAAc,EAGf,MAAM,gBAAgB,CAAC;AAGxB,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AA0DrD,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CAgCvE"}

package/dist/internal/builtin-tools/artifacts.js

@@ -5,25 +5,56 @@
  * generated from the declared kinds registry.
  */
 import { z } from "zod/v3";
+import * as z4 from "zod/v4";
 import { defineTool } from "../../tools.js";
+import { isZodV4Schema } from "../zod-schema.js";
 export const TAG_ARTIFACT_TOOL_NAME = "tag_artifact";
+const FREEFORM_DATA_DESCRIPTION = "Freeform JSON object payload for this kind.";
+const TITLE_DESCRIPTION = "Short human-readable label shown in artifact lists.";
+const KEY_DESCRIPTION = "Stable key, unique across kinds. Reusing it replaces that record instead of adding a new one.";
 function kindVariant(name, schema) {
     return z.object({
         kind: z.literal(name),
-        data: schema ?? z.object({}).passthrough().describe("Freeform JSON object payload for this kind."),
-        title: z.string().optional().describe("Short human-readable label shown in artifact lists."),
-        key: z
-            .string()
-            .trim()
-            .min(1)
-            .optional()
-            .describe("Stable key, unique across kinds. Reusing it replaces that record instead of adding a new one."),
+        data: schema ?? z.object({}).passthrough().describe(FREEFORM_DATA_DESCRIPTION),
+        title: z.string().optional().describe(TITLE_DESCRIPTION),
+        key: z.string().trim().min(1).optional().describe(KEY_DESCRIPTION),
     });
 }
+function kindVariantV4(name, schema) {
+    return z4.object({
+        kind: z4.literal(name),
+        data: schema ?? z4.looseObject({}).describe(FREEFORM_DATA_DESCRIPTION),
+        title: z4.string().optional().describe(TITLE_DESCRIPTION),
+        key: z4.string().trim().min(1).optional().describe(KEY_DESCRIPTION),
+    });
+}
+/**
+ * Kind schemas nest inside the tool's input schema, and a `zod/v4` schema
+ * cannot nest inside a `zod/v3` one (or the reverse), so the wrapper uses
+ * the kinds' own version.
+ */
+function tagArtifactInputSchema(kinds) {
+    const declared = kinds.flatMap(([, schema]) => (schema === undefined ? [] : [schema]));
+    const v4Count = declared.filter(isZodV4Schema).length;
+    if (v4Count > 0 && v4Count < declared.length) {
+        throw new Error("tag_artifact: artifact kind schemas mix zod/v3 and zod/v4; declare every kind schema with the same zod version");
+    }
+    if (v4Count === 0) {
+        const [first, ...rest] = kinds.map(([name, schema]) => kindVariant(name, schema));
+        if (first === undefined) {
+            throw new Error("tag_artifact requires at least one declared artifact kind");
+        }
+        return z.discriminatedUnion("kind", [first, ...rest]);
+    }
+    const [first, ...rest] = kinds.map(([name, schema]) => kindVariantV4(name, schema));
+    if (first === undefined) {
+        throw new Error("tag_artifact requires at least one declared artifact kind");
+    }
+    return z4.discriminatedUnion("kind", [first, ...rest]);
+}
 export function tagArtifactTool(config) {
     const kinds = Object.entries(config.kinds ?? {});
-    const [first, ...rest] = kinds.map(([name, kind]) => kindVariant(name, kind.schema));
-    if (first === undefined) {
+    if (kinds.length === 0) {
         // Discovery already errors on agentTool without kinds.
         throw new Error("tag_artifact requires at least one declared artifact kind");
     }
@@ -32,10 +63,12 @@ export function tagArtifactTool(config) {
         "Kinds:",
         ...kinds.map(([name, kind]) => `- ${name}: ${kind.description}`),
     ].join("\n");
+    const inputSchema = tagArtifactInputSchema(kinds.map(([name, kind]) => [name, kind.schema]));
     return defineTool({
         description,
-        inputSchema: z.discriminatedUnion("kind", [first, ...rest]),
-        async execute(input, ctx) {
+        inputSchema,
+        async execute(rawInput, ctx) {
+            const input = rawInput;
             const record = await ctx.artifacts.tag({
                 kind: input.kind,
                 data: input.data,