@cursor/bdk 0.2.25 → 0.2.27

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;
 }
@@ -115,11 +116,11 @@ export type AgentCloudPublicInfo = Omit<AgentCloudOptions, "envVars"> & {
 };
 export declare function toPublicCloudInfo(cloud: AgentCloudOptions): AgentCloudPublicInfo;
 /**
- * Session-scoped facts a `root` factory needs and does not otherwise
+ * Session-scoped facts an `fs` factory needs and does not otherwise
  * have at `defineAgent` time. The factory returns a handle: each
  * method must observe the current binding. Do not snapshot the tree.
  */
-export interface RootContext {
+export interface FsContext {
     sessionId: string;
     agentName?: string;
     continuationKey?: string;
@@ -129,6 +130,15 @@ export interface RootContext {
         kv?: HostKvApi;
     };
 }
+/** @deprecated Use FsContext. */
+export type RootContext = FsContext;
+/** Input to an {@link AgentConfig.skills} callback. */
+export interface SkillsMountContext {
+    /** Read-only. Layout is `/<name>/SKILL.md` plus sibling files. Mounted at `/agent/skills`. */
+    readonly skills: FileSystem;
+    readonly sessionId: string;
+    readonly continuationKey?: string;
+}
 /** Input to `defineAgent` (authored at `agent/agent.ts`). */
 export interface AgentConfig {
     /**
@@ -175,14 +185,30 @@ export interface AgentConfig {
     runtime?: AgentRuntime;
     /**
      * The FileSystem the model can see. Omit it and the root is the host
-     * disk. A static handle (`tempFs`, `unionFs`, ...) is that object on
+     * disk. `fs` is mounted at `/`. BDK mounts `/tmp` and `/agent/skills`
+     * over it, so the authored tree must not have anything at
+     * `/agent/skills` unless {@link skills} is `false`.
+     *
+     * A static handle (`tempFs`, `unionFs`, ...) is that object on
      * every session — writes are shared. Pass `(ctx) => …` and return a
      * new handle per session when you want isolation. A factory that
      * returns the same object still shares. Incompatible with
      * {@link local} `cwd` / `workspaceDir` / `sandbox` and with
      * {@link runtime} `"cloud"`.
      */
-    root?: FileSystem | ((ctx: RootContext) => FileSystem | Promise<FileSystem>);
+    fs?: FileSystem | ((ctx: FsContext) => FileSystem | Promise<FileSystem>);
+    /** @deprecated Alias of fs. Setting both is a discovery error. */
+    root?: FileSystem | ((ctx: FsContext) => FileSystem | Promise<FileSystem>);
+    /**
+     * What an {@link fs} agent sees at `/agent/skills`. Omit it to mount
+     * the discovered `agent/skills/` read-only and index them in the
+     * instructions. Pass a callback to mount the tree it returns instead,
+     * for example the discovered skills plus tenant skills. The index
+     * still lists only discovered skills. `false` mounts nothing and
+     * drops the index. Host-disk agents get `.cursor/skills/` and ignore
+     * this field.
+     */
+    skills?: false | ((ctx: SkillsMountContext) => FileSystem | Promise<FileSystem>);
     /**
      * Cloud attach defaults merged under per-session
      * {@link SendMessageOptions.cloud}. Used by existing agents that still
@@ -572,6 +598,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 +726,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 +739,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 +769,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 +1315,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 +1432,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 +1470,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 +1566,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 +1609,7 @@ export type SessionEventPayload = {
         parentCallId?: string;
         /** Same id as the matching {@link ActionCall.modelCallId}. */
         modelCallId?: string;
+        completedAt?: string;
     };
 } | {
     /**
@@ -1648,13 +1704,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 +1967,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 +2128,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 +3040,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
@@ -3095,10 +3183,19 @@ export interface ResolvedAgent {
     /** Execution runtime. Root agents default to `"local"`. */
     runtime: AgentRuntime;
     /**
-     * Authored {@link AgentConfig.root}. The factory is persisted, not a
-     * serialized tree. A resumed session calls it again (or reuses the handle).
+     * Authored {@link AgentConfig.fs}, or a lone {@link AgentConfig.root}.
+     * The factory is persisted, not a serialized tree. A resumed session
+     * calls it again (or reuses the handle).
      */
-    root?: FileSystem | ((ctx: RootContext) => FileSystem | Promise<FileSystem>);
+    fs?: FileSystem | ((ctx: FsContext) => FileSystem | Promise<FileSystem>);
+    /** @deprecated Set to the same handle as {@link fs} when the author used `root`. */
+    root?: FileSystem | ((ctx: FsContext) => FileSystem | Promise<FileSystem>);
+    /**
+     * Authored {@link AgentConfig.skills}, copied here for the session engine.
+     *
+     * @internal
+     */
+    skillsMount?: false | ((ctx: SkillsMountContext) => FileSystem | Promise<FileSystem>);
     /** Resolved {@link AgentConfig.cloud} for this agent. */
     cloud?: AgentCloudOptions;
     /**
@@ -3161,8 +3258,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 +3271,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 +3464,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 +3726,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 +3735,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[];
     /**