@cursor/bdk 0.2.25 → 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-CHk6O92d.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-BdMwybMt.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
@@ -67,7 +67,7 @@ export { classifyAnnotationsEffect, forwardTimeArgument, missingTimeWindow, sche
  * schema, JSON otherwise.
  */
 export type ToolInput<TSchema> = TSchema extends ZodSchema ? ZodSchemaOutput<TSchema> : JsonObject;
-type ServerToolConfig<TSchema> = {
+export type ServerToolConfig<TSchema> = {
     description: string;
     execution?: "server";
     inputSchema?: TSchema;
@@ -96,7 +96,7 @@ 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;

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,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,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,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,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,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"}
+{"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

package/dist/types.d.ts

@@ -14,11 +14,12 @@ import type * as z4core from "zod/v4/core";
 import type * as z4mini from "zod/v4/mini";
 import type { FileSystem } from "./filesystem.js";
 import type { ContinuationClaim, ContinuationIdentity, MailboxContinuation } from "./internal/continuation-identity.js";
-import type { OtelConfig, OtelDefinition } from "./otel.js";
 import type { StorageDefinition } from "./storage.js";
 import type { Octokit } from "@octokit/rest";
 import type { WebClient } from "@slack/web-api";
 import type { HostEvalsApi } from "./evals.js";
+export type { HostEvalsApi };
+export type { StorageDefinition };
 export type JsonPrimitive = string | number | boolean | null;
 export type JsonValue = JsonPrimitive | JsonValue[] | JsonObject;
 export type JsonObject = {
@@ -44,7 +45,7 @@ export type ZodSchemaInput<TSchema> = TSchema extends z3.ZodTypeAny ? z3.input<T
  * Discriminates the `define*` helper that produced a module's default export
  * so discovery can validate that a file landed in the right authored slot.
  */
-export type DefinitionKind = "agent" | "instructions" | "tool" | "skill" | "extension" | "disabled-tool" | "disabled-connection" | "disabled" | "connection" | "channel" | "http-channel" | "schedule" | "reminder" | "hook" | "eval" | "storage" | "artifacts" | "otel";
+export type DefinitionKind = "agent" | "instructions" | "tool" | "skill" | "extension" | "disabled-tool" | "disabled-connection" | "disabled" | "connection" | "channel" | "http-channel" | "schedule" | "reminder" | "hook" | "eval" | "storage" | "artifacts";
 export interface BrandedDefinition<K extends DefinitionKind> {
     readonly __agentServe: K;
 }
@@ -572,6 +573,9 @@ export interface HostContext {
      * Author-facing OpenTelemetry metrics and session tags. Always present.
      * Counters and histograms no-op when no meter is running. `setAttributes`
      * still tags the open session when a collector is attached.
+     *
+     * @deprecated Set `OTEL_*` variables and use `metrics.getMeter` or
+     * `trace.getTracer` from `@opentelemetry/api`.
      */
     otel: HostOtelApi;
 }
@@ -697,6 +701,12 @@ export interface HostFilesCapabilities {
  * never filesystem paths — {@link materializedPath} is the one place a real
  * path appears, and it is `undefined` whenever the sink keeps no local copy.
  */
+/**
+ * Text encodings {@link HostFilesApi.read} accepts. The same set Node calls
+ * `BufferEncoding`, written out so the public signature does not name a
+ * Node global.
+ */
+export type HostFileTextEncoding = "ascii" | "utf8" | "utf-8" | "utf16le" | "utf-16le" | "ucs2" | "ucs-2" | "base64" | "base64url" | "latin1" | "binary" | "hex";
 export interface HostFilesApi {
     /** What the configured sink supports. */
     readonly capabilities: HostFilesCapabilities;
@@ -704,7 +714,7 @@ export interface HostFilesApi {
     forSession(sessionId: string): HostFilesApi;
     /** Read as text. Miss → `undefined`. */
     read(path: string, options?: HostFilesCallOptions & {
-        encoding?: BufferEncoding;
+        encoding?: HostFileTextEncoding;
     }): Promise<string | undefined>;
     /** Read as bytes. Miss → `undefined`. */
     readBytes(path: string, options?: HostFilesCallOptions): Promise<Uint8Array | undefined>;
@@ -734,6 +744,10 @@ export type HostOtelAttributes = Record<string, string | number | boolean | unde
 /**
  * Author-facing OpenTelemetry surface on {@link HostContext.otel}.
  *
+ * @deprecated Set `OTEL_*` variables and use `metrics.getMeter` or
+ * `trace.getTracer` from `@opentelemetry/api`. This helper still runs
+ * for this release and emits one deprecation warning per process.
+ *
  * Metrics and tags only — no custom spans, and no raw OTel `Meter` /
  * `Tracer`. First-party names (`cursor.token.usage`, …) and join keys
  * (`cursor.conversation.id`, `agent_sdk.session_id`, `agent_sdk.agent`,
@@ -1276,6 +1290,9 @@ export type ConnectionConfig = (((Exclude<ConnectionTransport, {
      * With {@link advertiseTools}, a `listTools` or `auth` failure skips this
      * connection (zero tools from it) instead of failing the turn. Other
      * advertised connections still fail closed. Requires `advertiseTools`.
+     *
+     * A turn never waits to authorize an optional connection, also in the
+     * playground. Authorize it ahead of time with `bdk mcp oauth <name>`.
      */
     optional?: boolean;
     /**
@@ -1390,6 +1407,7 @@ export interface ActionResult {
     stubbed?: true;
     parentCallId?: string;
     modelCallId?: string;
+    completedAt?: string;
 }
 /** Human decision for a parked {@link ToolConfig.needsApproval} tool call. */
 export type ApprovalDecision = "approve" | "deny";
@@ -1427,6 +1445,13 @@ export type SessionEventPayload = {
     type: "message.received";
     data: {
         text: string;
+        /**
+         * {@link ChannelSession.deliveryId} of each `send()` this prompt
+         * carries, in arrival order. One for a direct send or a steer;
+         * several when coalesced follow-ups drain into one turn. Omitted on
+         * prompts no `send()` produced and on legacy stored events.
+         */
+        deliveryIds?: string[];
     };
 } | {
     /**
@@ -1516,8 +1541,13 @@ export type SessionEventPayload = {
     };
 } | {
     /**
-     * A host MCP call/list needs OAuth. The turn stays running until
-     * the human completes the `authUrl` and the runtime retries.
+     * A host MCP call/list needs OAuth, and a person can authorize it: a
+     * playground or HTTP chat turn, or a Slack message on a channel that
+     * handles this event (`slackChannel({ toolApprovals: true })` or
+     * `buildToolApprovalEvents` in `events`). The turn waits until
+     * the person completes the `authUrl`, the turn is interrupted, or 10
+     * minutes pass. Other turns (schedules, reminders, webhooks, evals) do
+     * not emit this event. They fail the call with a "Reconnect" message.
      */
     type: "action.auth_requested";
     data: {
@@ -1554,6 +1584,7 @@ export type SessionEventPayload = {
         parentCallId?: string;
         /** Same id as the matching {@link ActionCall.modelCallId}. */
         modelCallId?: string;
+        completedAt?: string;
     };
 } | {
     /**
@@ -1648,13 +1679,20 @@ export type SessionEventPayload = {
     };
 } | {
     /**
-     * A Slack follow-up queued mid-turn reached the running agent: the
-     * workspace carrier moved it from `pending/` to `delivered/` at a tool
-     * boundary. Channels use this to reposition a live progress message
-     * below the follow-up, which Slack cannot do any other way.
+     * A follow-up sent mid-turn reached the running agent. Channels use
+     * this to reposition a live progress message below the follow-up,
+     * which Slack cannot do any other way.
+     *
+     * `deliveryId` is set when a coalesced `send()` was steered into the
+     * turn and names that send's {@link ChannelSession.deliveryId}. It is
+     * absent when the Slack nudge carrier delivered the follow-up from its
+     * file store at a tool boundary, which does not know which send it
+     * carried.
      */
     type: "nudge.delivered";
-    data: Record<string, never>;
+    data: {
+        deliveryId?: string;
+    };
 } | {
     type: "session.waiting";
     data: Record<string, never>;
@@ -1904,6 +1942,22 @@ export interface ChannelSession {
      * in-flight turn instead of starting immediately (Slack busy path).
      */
     readonly coalesced?: boolean;
+    /**
+     * Identifies this `send()` on the session's events: {@link SendMessageOptions.deliveryId}
+     * when the caller passed one, otherwise a fresh `dlv_…` id. The message
+     * reaches the agent exactly one of two ways, and the id is on that event:
+     *
+     * - `nudge.delivered` `{ deliveryId }` — a coalesced send steered into
+     *   the running turn.
+     * - `message.received` `{ deliveryIds }` — the prompt of a turn: a send
+     *   that started one, or coalesced sends that fell back to the next turn
+     *   instead of steering.
+     *
+     * Set on every handle `send()` returns, including the one a hosted-admission
+     * `send()` returns before the session exists. Absent on handles looked up
+     * by session id, which no send produced.
+     */
+    readonly deliveryId?: string;
     readonly info: SessionInfo;
     /**
      * Replay recorded events from `startIndex`, then follow live (NDJSON).
@@ -2049,6 +2103,15 @@ export interface SendMessageOptions {
      * mid-turn nudge already delivered this `sourceTs`, boundary resume skips it.
      */
     coalesceSourceTs?: string;
+    /**
+     * Caller-chosen id for this send, returned as {@link ChannelSession.deliveryId}
+     * and stamped on the event where the message reaches the agent. Use one
+     * you already hold (a webhook delivery or message id) to correlate without
+     * keeping the returned handle. Opaque, compared verbatim; at most 256
+     * characters. Omit for a fresh `dlv_…` id. Keep it unique per session:
+     * two sends with the same id cannot be told apart.
+     */
+    deliveryId?: string;
 }
 export type SendMessageFn = (message: string, options?: SendMessageOptions) => Promise<ChannelSession>;
 /**
@@ -2952,7 +3015,7 @@ export interface Diagnostic {
      * before codes existed still has a code.
      */
     code?: DiagnosticCode;
-    /** Repo-relative or absolute path of the offending file. */
+    /** Path of the offending file, relative to the project root directory. */
     path?: string;
     /**
      * Bare npm package name when `code` is `module_not_found` and the missing
@@ -3161,8 +3224,6 @@ export interface AgentProject {
     storage?: StorageDefinition;
     /** Optional `agent/artifacts.ts` (`defineArtifacts`). */
     artifacts?: ArtifactsDefinition;
-    /** Optional `agent/otel.ts` (`defineOtel`). */
-    otel?: OtelDefinition;
     diagnostics: Diagnostic[];
 }
 /** JSON-safe projection of one channel HTTP route on `GET /v1/info`. */
@@ -3176,123 +3237,191 @@ export interface AgentChannelRouteInfo {
     bodySchema?: JsonSchemaObject;
     querySchema?: JsonSchemaObject;
 }
+export interface ProjectToolInfo {
+    name: string;
+    description: string;
+    /** @experimental */
+    execution: ToolExecution;
+    /**
+     * `true` or `false` when the author set a boolean. `"dynamic"` when
+     * the author set a function.
+     */
+    needsApproval: boolean | "dynamic";
+    /**
+     * The tool's declared {@link ToolEffect} when static, `"dynamic"` when
+     * declared as a predicate. Absent when the author declared nothing —
+     * "unknown", not "mutates".
+     */
+    effect?: ToolEffect | "dynamic";
+    inputSchema: JsonSchemaObject;
+}
+export interface ProjectConnectionInfo {
+    name: string;
+    transport: string;
+    /** @experimental */
+    advertiseTools?: boolean;
+    /** @experimental */
+    optional?: boolean;
+    /** @experimental */
+    effects?: readonly ToolEffect[];
+    /** @experimental */
+    tools?: readonly string[];
+    /** @experimental */
+    disallowedTools?: readonly string[];
+    /**
+     * Present only for `cursorAccount` connections. A connector-name
+     * allowlist, or `"*"` for every connected server.
+     * @experimental
+     */
+    cursorAccountServers?: string[] | "*";
+}
+export interface ProjectChannelInfo {
+    id: string;
+    routes: AgentChannelRouteInfo[];
+    /** Pack kind when the channel declares one (e.g. `"github"`). */
+    kind?: string;
+    /**
+     * GitHub webhook events the channel dispatches on, when declared.
+     * @experimental
+     */
+    githubWebhookEvents?: readonly string[];
+    /**
+     * Origin webhook event types the channel dispatches on, when declared.
+     * @experimental
+     */
+    originWebhookEvents?: readonly string[];
+    /**
+     * GitLab `object_kind`s the channel dispatches on, when declared.
+     * @experimental
+     */
+    gitlabWebhookEvents?: readonly string[];
+    /**
+     * Bitbucket event keys (Cloud vocabulary) the channel dispatches on.
+     * @experimental
+     */
+    bitbucketWebhookEvents?: readonly string[];
+    /**
+     * PagerDuty v3 event types the channel dispatches on, when declared.
+     * @experimental
+     */
+    pagerdutyWebhookEvents?: readonly string[];
+    /**
+     * Factory deployment event types the channel dispatches on, when declared.
+     * @experimental
+     */
+    deploymentEventTypes?: readonly string[];
+    /**
+     * Change Monitor checkpoint or Factory issue event types the channel dispatches on, when declared.
+     * @experimental
+     */
+    factoryEventTypes?: readonly string[];
+    /**
+     * Slack Events API event types the channel dispatches on, when declared.
+     * @experimental
+     */
+    slackEventTypes?: readonly string[];
+    /**
+     * Slack channels watched for posts (opt-in channel watch), when declared.
+     * @experimental
+     */
+    slackChannelPosts?: readonly string[];
+}
 /** JSON-safe projection of the manifest returned by `GET /v1/info`. */
-export interface AgentProjectInfo {
+export interface ProjectInfo {
+    /** Projection shape. Bump only when a stable field changes meaning. */
+    schemaVersion: 1;
     name: string;
     /** Short agent description when authored on `defineAgent`. */
     description?: string;
     model?: ModelSetting;
+    /**
+     * Resolved runtime architecture. Omitted authors are `"v2"`.
+     */
+    architecture: AgentArchitecture;
+    /** @experimental */
     runtime: AgentRuntime;
+    /** @experimental */
     cloud?: AgentCloudPublicInfo;
-    /** Local harness options when authored (`cwd` absolute). */
+    /**
+     * Local harness options when authored (`cwd` absolute).
+     * @experimental
+     */
     local?: {
         cwd?: string;
     };
-    /** Managed-hosting declarations when authored or declared by a mounted extension (egress allowlist, expected secrets, container image). */
+    /**
+     * Managed-hosting declarations when authored or declared by a mounted extension (egress allowlist, expected secrets, container image).
+     * @experimental
+     */
     hosting?: {
         egressDomains?: string[];
         secretNames?: string[];
         image?: string;
     };
-    /** Turn admission limits when authored (`concurrency` on `agent.ts`). */
+    /**
+     * Turn admission limits when authored (`concurrency` on `agent.ts`).
+     * @experimental
+     */
     concurrency?: {
         maxRunningTurns?: number;
     };
     /**
-     * The agent's own MCP surface (mounted at `<base>/v1/mcp`): other agents
+     * The agent's own MCP surface (mounted at `<base>/v1/mcp`). Other agents
      * and MCP clients delegate to this agent through these tools.
+     * @experimental
      */
     mcp: {
         path: string;
         tools: string[];
     };
+    /**
+     * @experimental
+     */
     instructions?: {
         chars: number;
         preview: string;
     };
-    tools: Array<{
-        name: string;
-        description: string;
-        execution: ToolExecution;
-        needsApproval: boolean;
-        /**
-         * The tool's declared {@link ToolEffect} when static, `"dynamic"` when
-         * declared as a predicate. Absent when the author declared nothing —
-         * "unknown", not "mutates".
-         */
-        effect?: ToolEffect | "dynamic";
-        inputSchema: JsonSchemaObject;
-    }>;
+    tools: ProjectToolInfo[];
     skills: Array<{
         name: string;
         description: string;
     }>;
-    /** Mounted extensions and the tool / skill names each contributed. */
+    /**
+     * Mounted extensions and the tool / skill names each contributed.
+     * @experimental
+     */
     extensions: DiscoveredExtension[];
-    connections: Array<{
-        name: string;
-        transport: string;
-        advertiseTools?: boolean;
-        optional?: boolean;
-        effects?: readonly ToolEffect[];
-        tools?: readonly string[];
-        disallowedTools?: readonly string[];
-        /**
-         * Present only for `cursorAccount` connections: the connector-name
-         * allowlist, or `"*"` for every connected server. Structured twin of the
-         * `cursor-account[:a,b]` transport label so consumers (e.g. the
-         * dashboard's connector scoping) never parse the display string.
-         */
-        cursorAccountServers?: string[] | "*";
-    }>;
+    connections: ProjectConnectionInfo[];
     subagents: Array<{
         name: string;
         description?: string;
         model?: ModelSetting;
     }>;
-    channels: Array<{
-        id: string;
-        routes: AgentChannelRouteInfo[];
-        /** Pack kind when the channel declares one (e.g. `"github"`). */
-        kind?: string;
-        /** GitHub webhook events the channel dispatches on, when declared. */
-        githubWebhookEvents?: readonly string[];
-        /** Origin webhook event types the channel dispatches on, when declared. */
-        originWebhookEvents?: readonly string[];
-        /** GitLab `object_kind`s the channel dispatches on, when declared. */
-        gitlabWebhookEvents?: readonly string[];
-        /** Bitbucket event keys (Cloud vocabulary) the channel dispatches on. */
-        bitbucketWebhookEvents?: readonly string[];
-        /** PagerDuty v3 event types the channel dispatches on, when declared. */
-        pagerdutyWebhookEvents?: readonly string[];
-        /** Factory deployment event types the channel dispatches on, when declared. */
-        deploymentEventTypes?: readonly string[];
-        /** Change Monitor checkpoint or Factory issue event types the channel dispatches on, when declared. */
-        factoryEventTypes?: readonly string[];
-        /** Slack Events API event types the channel dispatches on, when declared. */
-        slackEventTypes?: readonly string[];
-        /** Slack channels watched for posts (opt-in channel watch), when declared. */
-        slackChannelPosts?: readonly string[];
-    }>;
+    channels: ProjectChannelInfo[];
     schedules: Array<{
         name: string;
         cron: string;
         kind: "markdown" | "run";
     }>;
-    /** Named reminder handlers (`agent/reminders/<name>.ts`) when present. */
+    /**
+     * Named reminder handlers (`agent/reminders/<name>.ts`) when present.
+     * @experimental
+     */
     reminders?: Array<{
         name: string;
     }>;
     hooks: string[];
-    /** Project storage sink from `agent/storage.ts`, when authored. */
+    /**
+     * Project storage sink from `agent/storage.ts`, when authored.
+     * @experimental
+     */
     storage?: {
         name?: string;
     };
-    otel?: {
-        serviceName?: string;
-        enabled: true;
-    };
-    /** Declared artifact kinds from `agent/artifacts.ts`, when authored. */
+    /**
+     * Declared artifact kinds from `agent/artifacts.ts`, when authored.
+     * @experimental
+     */
     artifacts?: {
         kinds: string[];
         agentTool: boolean;
@@ -3301,10 +3430,16 @@ export interface AgentProjectInfo {
     /**
      * Eval cases a hosted architecture v2 release runs as its own sessions.
      * Set only in that release's deploy manifest.
+     * @experimental
      */
     evals?: AgentProjectEvalsInfo;
     diagnostics: Diagnostic[];
 }
+/** @deprecated Use {@link ProjectInfo}. */
+export type AgentProjectInfo = ProjectInfo;
+export interface Project {
+    readonly info: ProjectInfo;
+}
 export interface AgentProjectEvalsInfo {
     /** Hosted eval-case protocol this release speaks. */
     protocol: 1;
@@ -3557,14 +3692,8 @@ export interface ServeOptions {
         apiKey?: string;
     };
     logger?: (line: string) => void;
-    /**
-     * OpenTelemetry export. Pass a config object, or `false` to force-disable
-     * even when `OTEL_EXPORTER_OTLP_*` env vars / `agent/otel.ts` are set.
-     * When omitted, env + authored `defineOtel` still enable export.
-     */
-    otel?: OtelConfig | false;
 }
-/** One agent mounted on a server (its URL slug + compiled project). */
+/** One agent mounted on a server (its URL slug and public project info). */
 export interface MountedAgentInfo {
     /**
      * URL slug the agent is mounted under. Empty string in single-agent mode
@@ -3572,18 +3701,20 @@ export interface MountedAgentInfo {
      * `/<slug>/v1/...`).
      */
     slug: string;
-    project: AgentProject;
     /** Absolute base URL for this agent (server URL + `/<slug>` when slugged). */
     url: string;
+    /** Same projection as `GET /v1/info` for this agent. */
+    info: ProjectInfo;
 }
 export interface AgentServeHandle {
     url: string;
     port: number;
     /**
-     * The single served agent's project. In multi-agent mode this is the first
-     * mounted agent; use {@link agents} for the full set.
+     * The first mounted agent's {@link Project}. In multi-agent mode use
+     * {@link agents} for the full set.
+     * @deprecated Use `agents[0].info`.
      */
-    project: AgentProject;
+    project: Project;
     /** Every agent mounted on this server. One entry in single-agent mode. */
     agents: MountedAgentInfo[];
     /**