@cursor/bdk 0.2.25 → 0.2.26

package/dist/internal/describe-error.js

@@ -1,3 +1,5 @@
+/** Sentence returned when an SDK agent-store failure must not reach the caller. */
+export const USER_FACING_TURN_FAILURE = "I hit an error while handling your request. Please try again or rephrase.";
 /** Stable string for logging / HTTP error bodies. */
 export function describeError(error) {
     return error instanceof Error ? error.message : String(error);

package/dist/internal/discovery/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,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,KAAK,YAAY,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/E,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IACjD,IAAI,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAUA;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUrE;AAgCD,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,GACb,IAAI,CASN;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE;IACV,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,GACA,IAAI,CAEN;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/C"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,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,KAAK,YAAY,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/E,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IACjD,IAAI,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAUA;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUrE;AAgCD,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,GACb,IAAI,CASN;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE;IACV,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,GACA,IAAI,CAEN;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/C"}

package/dist/internal/discovery/context.js

@@ -74,8 +74,7 @@ export function pushConfigDiagnostic(ctx, diagnostic) {
     ctx.diagnostics.push({ ...diagnostic, code: "config_error" });
 }
 export function displayPath(ctx, absolutePath) {
-    const rel = relative(ctx.rootDir, absolutePath);
-    return rel.startsWith("..") ? absolutePath : toPosix(rel);
+    return toPosix(relative(ctx.rootDir, absolutePath));
 }
 export function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);

package/dist/internal/discovery/cursor-plugin.js

@@ -3,7 +3,7 @@
  */
 import { readFile } from "node:fs/promises";
 import { basename, dirname, extname, isAbsolute, join } from "node:path";
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { parseYamlFrontmatter } from "../frontmatter.js";
 import { isRecord } from "../is-record.js";
 import { displayPath, errorMessage, isBlank } from "./context.js";
@@ -37,8 +37,8 @@ const manifestSchema = z.object({
     mcpServers: z
         .union([
         z.string(),
-        z.record(z.unknown()),
-        z.array(z.union([z.string(), z.record(z.unknown())])),
+        z.record(z.string(), z.unknown()),
+        z.array(z.union([z.string(), z.record(z.string(), z.unknown())])),
     ])
         .optional()
         .transform((value) => {
@@ -58,16 +58,16 @@ const frontmatterSchema = z.object({
 const mcpServerSchema = z.object({
     type: z.string().optional(),
     url: z.string().optional(),
-    headers: z.record(z.string()).optional(),
+    headers: z.record(z.string(), z.string()).optional(),
     command: z.string().optional(),
     args: z.array(z.string()).optional(),
-    env: z.record(z.string()).optional(),
+    env: z.record(z.string(), z.string()).optional(),
     cwd: z.string().optional(),
     envFile: z.string().optional(),
     /** Cursor's static OAuth client hint. */
-    auth: z.record(z.unknown()).optional(),
+    auth: z.record(z.string(), z.unknown()).optional(),
     /** Claude's spelling of the same hint. */
-    oauth: z.record(z.unknown()).optional(),
+    oauth: z.record(z.string(), z.unknown()).optional(),
     /** Cursor disables unlisted tools; an empty list would disable them all. */
     enabledTools: z.array(z.string()).nonempty().optional(),
 });
@@ -499,7 +499,7 @@ function componentName(plugin, raw, path) {
     });
     return undefined;
 }
-/** `headers: Expected object, received array`; the path names the field. */
+/** `headers: Invalid input: expected record, received array`; the path names the field. */
 function firstIssue(error) {
     const issue = error.issues[0];
     if (issue === undefined) {

package/dist/internal/discovery/extensions.js

@@ -329,23 +329,30 @@ function byId(items) {
     return new Map(items.map((item) => [item.id, item]));
 }
 /**
- * Agent-singleton slots: one runtime (`agent.ts`), one storage backend,
- * one OTLP exporter. Playground chips are a Vite glob of the agent tree,
- * not a discovery walk. Nested `extensions/` are not mounted.
+ * Agent-singleton slots: one runtime (`agent.ts`), one storage backend.
+ * Playground chips are a Vite glob of the agent tree, not a discovery walk.
+ * Nested `extensions/` are not mounted.
  */
 async function warnAgentRootOnlySlots(ctx, root) {
     const files = [
-        ["agent.ts", "agent.ts"],
-        ["storage.ts", "storage"],
-        ["otel.ts", "otel"],
+        ["agent.ts", "The agent that mounts this extension owns agent.ts; ignoring."],
+        ["storage.ts", "The agent that mounts this extension owns storage; ignoring."],
+        [
+            "otel.ts",
+            'otel.ts is removed. Delete this file. See "Migrating from serve({ otel })" in docs/guides/opentelemetry.md.',
+        ],
+        [
+            "instrumentation.ts",
+            'instrumentation.ts is not loaded. Delete this file. See "Migrating from serve({ otel })" in docs/guides/opentelemetry.md.',
+        ],
     ];
-    for (const [file, label] of files) {
+    for (const [file, message] of files) {
         const path = join(root, file);
         if (await isFile(path)) {
             ctx.diagnostics.push({
                 severity: "warning",
                 path: displayPath(ctx, path),
-                message: `The agent that mounts this extension owns ${label}; ignoring.`,
+                message,
             });
         }
     }

package/dist/internal/discovery/info.d.ts

@@ -1,6 +1,6 @@
 /**
  * The `info` / `GET /v1/info` projection of an {@link AgentProject}.
  */
-import { type AgentProject, type AgentProjectInfo } from "../../types.js";
-export declare function projectInfo(project: AgentProject): AgentProjectInfo;
+import { type AgentProject, type ProjectInfo } from "../../types.js";
+export declare function projectInfo(project: AgentProject): ProjectInfo;
 //# sourceMappingURL=info.d.ts.map

package/dist/internal/discovery/info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/info.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAqB,MAAM,gBAAgB,CAAC;AAK7F,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAsKnE"}
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/info.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AAMxF,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAkK9D"}

package/dist/internal/discovery/info.js

@@ -5,6 +5,7 @@ import { resolveArtifactsMax } from "../../artifacts.js";
 import { toPublicCloudInfo } from "../../types.js";
 import { toolInputJsonSchema } from "../json-schema.js";
 import { MCP_ENDPOINT_PATH, mcpEndpointToolNames } from "../mcp-endpoint.js";
+import { DEFAULT_AGENT_ARCHITECTURE } from "./agent-config.js";
 import { connectionTransportLabel } from "./connections.js";
 export function projectInfo(project) {
     const agent = project.agent;
@@ -37,12 +38,14 @@ export function projectInfo(project) {
         },
     ];
     return {
+        schemaVersion: 1,
         name: project.name,
         description: agent.description,
         model: agent.model,
+        architecture: agent.architecture ?? DEFAULT_AGENT_ARCHITECTURE,
         runtime: agent.runtime,
         cloud: agent.cloud === undefined ? undefined : toPublicCloudInfo(agent.cloud),
-        local: agent.local,
+        local: agent.local?.cwd === undefined ? undefined : { cwd: agent.local.cwd },
         hosting: agent.hosting,
         concurrency: agent.concurrency,
         mcp: { path: MCP_ENDPOINT_PATH, tools: mcpEndpointToolNames(project) },
@@ -58,7 +61,7 @@ export function projectInfo(project) {
             name: tool.name,
             description: tool.description,
             execution: tool.execution,
-            needsApproval: tool.needsApproval,
+            needsApproval: typeof tool.definition.needsApproval === "function" ? "dynamic" : tool.needsApproval,
             effect: tool.effect,
             inputSchema: tool.inputSchema,
         })),
@@ -158,12 +161,6 @@ export function projectInfo(project) {
                 agentTool: project.artifacts.agentTool === true,
                 max: resolveArtifactsMax(project.artifacts),
             },
-        otel: project.otel === undefined
-            ? undefined
-            : {
-                enabled: true,
-                serviceName: project.otel.serviceName,
-            },
-        diagnostics: project.diagnostics,
+        diagnostics: project.diagnostics.map((diagnostic) => ({ ...diagnostic })),
     };
 }

package/dist/internal/discovery/instrumentation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bake-time OpenTelemetry providers. Installed before `agent.ts` so a
+ * module-scope meter, tracer, or logger binds to a real provider.
+ * `instrumentation.ts` is not loaded.
+ */
+import { type DiscoveryContext } from "./context.js";
+export declare function agentDirHasInstrumentation(agentDir: string): boolean;
+export declare function resetInstrumentationRegistryForTests(): void;
+export declare function loadInstrumentation(ctx: DiscoveryContext, agentDir: string): Promise<boolean>;
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/internal/discovery/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAKlE,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAKD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/internal/discovery/instrumentation.js

@@ -0,0 +1,29 @@
+/**
+ * Bake-time OpenTelemetry providers. Installed before `agent.ts` so a
+ * module-scope meter, tracer, or logger binds to a real provider.
+ * `instrumentation.ts` is not loaded.
+ */
+import { installCustomerOtel } from "../otel/customer.js";
+import { displayPath } from "./context.js";
+import { findModuleFile } from "./fs.js";
+const instrumentedAgentDirs = new Set();
+export function agentDirHasInstrumentation(agentDir) {
+    return instrumentedAgentDirs.has(agentDir);
+}
+export function resetInstrumentationRegistryForTests() {
+    instrumentedAgentDirs.clear();
+}
+const INSTRUMENTATION_FILE = 'instrumentation.ts is not loaded. Delete this file. See "Migrating from serve({ otel })" in docs/guides/opentelemetry.md.';
+export async function loadInstrumentation(ctx, agentDir) {
+    installCustomerOtel();
+    instrumentedAgentDirs.add(agentDir);
+    const path = await findModuleFile(agentDir, "instrumentation");
+    if (path !== undefined) {
+        ctx.diagnostics.push({
+            severity: "error",
+            path: displayPath(ctx, path),
+            message: INSTRUMENTATION_FILE,
+        });
+    }
+    return true;
+}

package/dist/internal/discovery/modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/modules.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,KAAK,gBAAgB,EAAyC,MAAM,cAAc,CAAC;AAI5F,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAC;AAEvE,4EAA4E;AAC5E,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,YAAY,GAC1B,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAwBhD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,GACnD,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAGvD"}
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/modules.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,KAAK,gBAAgB,EAAyC,MAAM,cAAc,CAAC;AAI5F,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAC;AAEvE,4EAA4E;AAC5E,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,YAAY,GAC1B,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAwBhD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,GACnD,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAGvD"}

package/dist/internal/discovery/modules.js

@@ -53,13 +53,14 @@ export async function importDefault(ctx, modulePath, expected) {
     const helpers = kinds.map(helperCall).join(" or ");
     const expectedKinds = kinds.join(" or ");
     const article = /^[aeiou]/.test(expectedKinds) ? "an" : "a";
+    const message = kind === undefined
+        ? `Module must default-export ${helpers}.`
+        : `Expected ${article} ${expectedKinds} definition but found "${kind}" (wrong authored slot?).`;
     ctx.diagnostics.push({
         severity: "error",
         code: "invalid_definition",
         path: displayPath(ctx, modulePath),
-        message: kind === undefined
-            ? `Module must default-export ${helpers}.`
-            : `Expected ${article} ${expectedKinds} definition but found "${kind}" (wrong authored slot?).`,
+        message,
     });
     return undefined;
 }
@@ -84,5 +85,4 @@ const DEFINE_HELPER_NAME = {
     hook: "defineHook",
     storage: "defineStorage",
     artifacts: "defineArtifacts",
-    otel: "defineOtel",
 };

package/dist/internal/discovery/project-public.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Public project load. `serve` reads the compiled project back from the map.
+ */
+import type { AgentProject, Diagnostic, Project } from "../../types.js";
+export interface LoadProjectOptions {
+    /** When true, warnings throw {@link ProjectLoadError} as well as errors. */
+    strict?: boolean;
+}
+export declare class ProjectLoadError extends Error {
+    readonly diagnostics: readonly Diagnostic[];
+    constructor(diagnostics: readonly Diagnostic[]);
+}
+export declare function loadProject(dir: string, options?: LoadProjectOptions): Promise<Project>;
+export declare function createProject(agentProject: AgentProject): Project;
+export declare function unwrapProject(project: Project): AgentProject;
+//# sourceMappingURL=project-public.d.ts.map

package/dist/internal/discovery/project-public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-public.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/project-public.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAe,MAAM,gBAAgB,CAAC;AAMrF,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAE5C,YAAY,WAAW,EAAE,SAAS,UAAU,EAAE,EAK7C;CACF;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQjG;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAIjE;AAkBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAM5D"}

package/dist/internal/discovery/project-public.js

@@ -0,0 +1,54 @@
+/**
+ * Public project load. `serve` reads the compiled project back from the map.
+ */
+import { projectInfo } from "./info.js";
+import { formatDiagnostics, hasErrorDiagnostics, loadAgentProject } from "./project.js";
+const agentProjects = new WeakMap();
+class ProjectImpl {
+    constructor(info) {
+        this.info = info;
+    }
+}
+export class ProjectLoadError extends Error {
+    constructor(diagnostics) {
+        const copy = diagnostics.map((diagnostic) => ({ ...diagnostic }));
+        super(formatDiagnostics(copy));
+        this.name = "ProjectLoadError";
+        this.diagnostics = copy;
+    }
+}
+export async function loadProject(dir, options = {}) {
+    const loaded = await loadAgentProject(dir);
+    const hasError = hasErrorDiagnostics(loaded);
+    const hasWarning = loaded.diagnostics.some((diagnostic) => diagnostic.severity === "warning");
+    if (hasError || (options.strict === true && hasWarning)) {
+        throw new ProjectLoadError(loaded.diagnostics);
+    }
+    return createProject(loaded);
+}
+export function createProject(agentProject) {
+    const project = new ProjectImpl(deepFreeze(projectInfo(agentProject)));
+    agentProjects.set(project, agentProject);
+    return project;
+}
+function deepFreeze(value) {
+    const copy = structuredClone(value);
+    freezeValue(copy);
+    return copy;
+}
+function freezeValue(value) {
+    if (value === null || typeof value !== "object" || Object.isFrozen(value)) {
+        return;
+    }
+    for (const nested of Object.values(value)) {
+        freezeValue(nested);
+    }
+    Object.freeze(value);
+}
+export function unwrapProject(project) {
+    const agentProject = project instanceof ProjectImpl ? agentProjects.get(project) : undefined;
+    if (agentProject === undefined) {
+        throw new Error("serve() accepts a Project from loadProject");
+    }
+    return agentProject;
+}

package/dist/internal/discovery/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAuB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAapF,OAAO,EAIL,KAAK,uBAAuB,EAE7B,MAAM,cAAc,CAAC;AAetB;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAYD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA2BlF;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CA6BzD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAAuB,GAAG;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAgBzD;AAWD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CAqHvB;AA0BD,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAElE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAOnE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC,GACvF,MAAM,CAeR"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAuB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAcpF,OAAO,EAIL,KAAK,uBAAuB,EAE7B,MAAM,cAAc,CAAC;AAgBtB;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAYD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA2BlF;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CA6BzD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAAuB,GAAG;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAgBzD;AAWD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CA+HvB;AA0BD,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAElE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAOnE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC,GACvF,MAAM,CAeR"}

package/dist/internal/discovery/project.js

@@ -6,15 +6,17 @@ import { registerAuthoredModuleLoaders } from "../authored-loaders.js";
 import { channelArchitectureError, channelArchitectureMigrationWarning, } from "../channel-architecture.js";
 import { applyAgentContinuationDefaults, warnOmittedContinuationDowngrades, } from "../continuation-channel.js";
 import { httpChannel } from "../http-channel-define.js";
+import { otelProvidersReplaced } from "../otel/customer.js";
 import { loadAgent, warnUnknownSlots } from "./agent.js";
 import { loadChannels } from "./channels.js";
 import { defaultImportModule, displayPath, pushConfigDiagnostic, } from "./context.js";
 import { hasFlatLayoutMarkers, isDirectory, readPackageName, sortedEntries } from "./fs.js";
 import { loadHooks } from "./hooks.js";
+import { loadInstrumentation } from "./instrumentation.js";
 import { NAME_PATTERN, RESERVED_SLUGS } from "./names.js";
 import { loadReminders } from "./reminders.js";
 import { loadSchedules } from "./schedules.js";
-import { appendArtifactTool, loadArtifacts, loadOtel, loadStorage, mergeArtifacts, rejectLegacyResult, } from "./services.js";
+import { appendArtifactTool, loadArtifacts, loadStorage, mergeArtifacts, rejectLegacyOtelModule, rejectLegacyResult, } from "./services.js";
 /**
  * True when `dir` looks like an agent project root: it has a nested `bot/`
  * directory, a compatible `agent/` directory, or flat-layout markers
@@ -158,11 +160,20 @@ export async function loadAgentProject(dir, options = {}) {
         diagnostics,
         importModule: options.importModule ?? defaultImportModule,
     };
+    // Before agent.ts, tools, and channels. A meter created first stays a no-op.
+    await loadInstrumentation(ctx, agentDir);
     const name = (await readPackageName(rootDir)) ?? basename(rootDir);
     const { agent, projectSlots } = await loadAgent(ctx, agentDir, {
         name,
         isRoot: true,
     });
+    if (otelProvidersReplaced()) {
+        ctx.diagnostics.push({
+            severity: "warning",
+            path: displayPath(ctx, join(agentDir, "agent.ts")),
+            message: "A module replaced an OpenTelemetry provider BDK installed. The global API now uses that module's provider. See docs/guides/opentelemetry.md.",
+        });
+    }
     const { channels, httpChannelDefinition } = await loadChannels(ctx, join(agentDir, "channels"));
     for (const channel of projectSlots.channels) {
         if (channel.id === "http" || channels.some((c) => c.id === channel.id)) {
@@ -183,7 +194,7 @@ export async function loadAgentProject(dir, options = {}) {
     hooks.push(...projectSlots.hooks);
     const storage = await loadStorage(ctx, agentDir, agent.architecture);
     const artifacts = await mergeProjectArtifacts(ctx, agentDir, projectSlots.artifacts);
-    const otel = await loadOtel(ctx, agentDir);
+    await rejectLegacyOtelModule(ctx, agentDir);
     await rejectLegacyResult(ctx, agentDir);
     await appendArtifactTool(ctx, agentDir, agent, artifacts);
     if (agentDir !== rootDir) {
@@ -237,7 +248,6 @@ export async function loadAgentProject(dir, options = {}) {
         hooks,
         storage,
         artifacts,
-        otel,
         diagnostics,
     };
 }

package/dist/internal/discovery/services.d.ts

@@ -1,13 +1,14 @@
 /**
- * `agent/storage.ts`, `agent/otel.ts`, `agent/artifacts.ts`:
- * host services the agent configures.
+ * `agent/storage.ts` and `agent/artifacts.ts`: host services the agent
+ * configures. `agent/otel.ts` is rejected. OpenTelemetry is `OTEL_*`
+ * variables.
  */
-import type { OtelDefinition } from "../../otel.js";
 import type { StorageDefinition } from "../../storage.js";
 import type { AgentArchitecture, ArtifactsDefinition, ResolvedAgent } from "../../types.js";
 import { type DiscoveryContext } from "./context.js";
 export declare function loadStorage(ctx: DiscoveryContext, agentDir: string, architecture: AgentArchitecture | undefined): Promise<StorageDefinition | undefined>;
-export declare function loadOtel(ctx: DiscoveryContext, agentDir: string): Promise<OtelDefinition | undefined>;
+/** Fail discovery when the retired `otel.ts` module is still present. */
+export declare function rejectLegacyOtelModule(ctx: DiscoveryContext, agentDir: string): Promise<void>;
 export declare function loadArtifacts(ctx: DiscoveryContext, agentDir: string): Promise<ArtifactsDefinition | undefined>;
 /**
  * `defineResult` / `agent/result.ts` is gone. A leftover file is an

package/dist/internal/discovery/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/services.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE5F,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAIlE,wBAAsB,WAAW,CAC/B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CA6BxC;AAED,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAOrC;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAmB1C;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/F;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,GAAG,SAAS,EACtC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,mBAAmB,GAAG,SAAS,CAYjC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,mBAAmB,GAAG,SAAS,GACzC,OAAO,CAAC,IAAI,CAAC,CAkBf"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/services.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE5F,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAIlE,wBAAsB,WAAW,CAC/B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CA6BxC;AAKD,yEAAyE;AACzE,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAmB1C;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/F;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,GAAG,SAAS,EACtC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,mBAAmB,GAAG,SAAS,CAYjC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,mBAAmB,GAAG,SAAS,GACzC,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/internal/discovery/services.js

@@ -1,6 +1,7 @@
 /**
- * `agent/storage.ts`, `agent/otel.ts`, `agent/artifacts.ts`:
- * host services the agent configures.
+ * `agent/storage.ts` and `agent/artifacts.ts`: host services the agent
+ * configures. `agent/otel.ts` is rejected. OpenTelemetry is `OTEL_*`
+ * variables.
  */
 import { join } from "node:path";
 import { defineArtifacts } from "../../artifacts.js";
@@ -36,13 +37,18 @@ export async function loadStorage(ctx, agentDir, architecture) {
     const definition = await importDefault(ctx, path, "storage");
     return definition;
 }
-export async function loadOtel(ctx, agentDir) {
+const LEGACY_OTEL_MESSAGE = 'bot/otel.ts and agent/otel.ts are removed. Delete this file. See "Migrating from serve({ otel })" in docs/guides/opentelemetry.md.';
+/** Fail discovery when the retired `otel.ts` module is still present. */
+export async function rejectLegacyOtelModule(ctx, agentDir) {
     const path = await findModuleFile(agentDir, "otel");
     if (path === undefined) {
-        return undefined;
+        return;
     }
-    const definition = await importDefault(ctx, path, "otel");
-    return definition;
+    ctx.diagnostics.push({
+        severity: "error",
+        path: displayPath(ctx, path),
+        message: LEGACY_OTEL_MESSAGE,
+    });
 }
 export async function loadArtifacts(ctx, agentDir) {
     const path = await findModuleFile(agentDir, "artifacts");

package/dist/internal/event-mapper.d.ts.map

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

package/dist/internal/event-mapper.js

@@ -306,6 +306,7 @@ export class TurnEventMapper {
             stubbed: this.isStubbed(callId) ? true : undefined,
             parentCallId,
             modelCallId,
+            completedAt: new Date().toISOString(),
         };
         const wave = this.waveForComplete({ parentCallId, modelCallId, callId });
         if (wave === undefined) {

package/dist/internal/factory-resource-channel.d.ts

@@ -1,4 +1,4 @@
-import type { z } from "zod/v3";
+import type * as z from "zod/v4";
 import type { ChannelDefinition, ChannelHandlerArgs } from "../types.js";
 import type { ContinuationIdentity } from "./continuation-identity.js";
 type FactoryResourceChannelOptions<TEvent> = {

package/dist/internal/factory-resource-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory-resource-channel.d.ts","sourceRoot":"","sources":["../../src/internal/factory-resource-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIvE,KAAK,6BAA6B,CAAC,MAAM,IAAI;IAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACjF,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;CACtC,CAAC;AAEF,KAAK,0BAA0B,CAAC,MAAM,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,IAAI;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,0BAA0B,CAAC,MAAM,IAAI;IACxC,OAAO,EAAE,CAAC,OAAO,EAAE,6BAA6B,CAAC,MAAM,CAAC,KAAK,iBAAiB,CAAC;IAC/E,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,6BAA6B,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CACvF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC/E,IAAI,EAAE,0BAA0B,CAAC,MAAM,CAAC,GACvC,0BAA0B,CAAC,MAAM,CAAC,CAkEpC"}
+{"version":3,"file":"factory-resource-channel.d.ts","sourceRoot":"","sources":["../../src/internal/factory-resource-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIvE,KAAK,6BAA6B,CAAC,MAAM,IAAI;IAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACjF,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;CACtC,CAAC;AAEF,KAAK,0BAA0B,CAAC,MAAM,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,IAAI;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,0BAA0B,CAAC,MAAM,IAAI;IACxC,OAAO,EAAE,CAAC,OAAO,EAAE,6BAA6B,CAAC,MAAM,CAAC,KAAK,iBAAiB,CAAC;IAC/E,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,6BAA6B,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CACvF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC/E,IAAI,EAAE,0BAA0B,CAAC,MAAM,CAAC,GACvC,0BAA0B,CAAC,MAAM,CAAC,CAkEpC"}

package/dist/internal/filesystem/nearest.d.ts

@@ -9,6 +9,7 @@ export declare function formatMissNeighborHint(path: string, neighbors: readonly
 /**
  * One-line miss hint when the parent directory listed siblings.
  * `undefined` leaves the caller to throw the ordinary miss.
+ * @deprecated Deprecated on the package root.
  */
 export declare function nearestNeighborMissHint(root: Pick<FileSystem, "list">, path: string): Promise<string | undefined>;
 //# sourceMappingURL=nearest.d.ts.map

package/dist/internal/filesystem/nearest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nearest.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/nearest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,UAAU,EAA2C,MAAM,qBAAqB,CAAC;AAK/F,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,GAAE,MAAuB,GAC7B,MAAM,EAAE,CAeV;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,EAC9B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc7B"}
+{"version":3,"file":"nearest.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/nearest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,UAAU,EAA2C,MAAM,qBAAqB,CAAC;AAK/F,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,GAAE,MAAuB,GAC7B,MAAM,EAAE,CAeV;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,MAAM,GAAG,SAAS,CAKpB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,EAC9B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc7B"}

package/dist/internal/filesystem/nearest.js

@@ -32,6 +32,7 @@ export function formatMissNeighborHint(path, neighbors) {
 /**
  * One-line miss hint when the parent directory listed siblings.
  * `undefined` leaves the caller to throw the ordinary miss.
+ * @deprecated Deprecated on the package root.
  */
 export async function nearestNeighborMissHint(root, path) {
     const missed = normalizeFsPath(path);

package/dist/internal/filesystem/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,kBAAkB,EAYxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AAgCrE,eAAO,MAAM,kCAAkC,YAC7C,MAAM,EACN,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,gBAAgB,CACR,CAAC;AAEX,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,kCAAkC,CAAC,CAAC,MAAM,CAAC,CAAC;AAIhG,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrE;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACnC,kBAAkB,EAAE,GAAG,SAAS,CAmBlC;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACnC,kBAAkB,EAAE,GAAG,SAAS,CAKlC;AAKD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,GAAG,SAAS,6BAA6B,EAAE,CAW3C;AA2lBD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,cAAc,GAAG,SAAS,CAS5B;AAED,iEAAiE;AACjE,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC,CAclB;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvF;AA8BD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,SAAS,kBAAkB,EAAE,GACrC,cAAc,EAAE,CAQlB"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,kBAAkB,EAYxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAA6B,MAAM,gBAAgB,CAAC;AAgChF,eAAO,MAAM,kCAAkC,YAC7C,MAAM,EACN,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,gBAAgB,CACR,CAAC;AAEX,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,kCAAkC,CAAC,CAAC,MAAM,CAAC,CAAC;AAIhG,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrE;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACnC,kBAAkB,EAAE,GAAG,SAAS,CAmBlC;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACnC,kBAAkB,EAAE,GAAG,SAAS,CAKlC;AAKD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,GAAG,SAAS,6BAA6B,EAAE,CAW3C;AA2lBD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,cAAc,GAAG,SAAS,CAS5B;AAED,iEAAiE;AACjE,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC,CAclB;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvF;AA8BD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,SAAS,kBAAkB,EAAE,GACrC,cAAc,EAAE,CAQlB"}

package/dist/internal/filesystem/tools.js

@@ -8,7 +8,7 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 import { Buffer } from "node:buffer";
 import { minimatch } from "minimatch";
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { canonicalizeFileSystemToolName, collectGrepMatches, FILE_SYSTEM_SCAN_LIMIT, fileSystemImage, fileSystemText, InvalidGrepPatternError, isFileNotFoundError, shapeGrepUnion, sliceReadContent, strReplaceOnFileSystem, } from "../../filesystem.js";
 import { defineTool } from "../../tools.js";
 import { toolInputJsonSchema, toolOutputJsonSchema, validateToolInput } from "../json-schema.js";

package/dist/internal/handleAgentServeTrigger.d.ts

@@ -11,6 +11,7 @@ import type { GitHubChannelOptions } from "../channels/github/types.js";
 import type { OriginChannelOptions } from "../channels/origin/types.js";
 import type { ChannelHandlerArgs } from "../types.js";
 import { type RouteLocalIngressContinuation } from "./local-ingress.js";
+/** @deprecated Deprecated on the package root. */
 export interface AgentServeGitHubTriggerTarget {
     /** Agent mount slug (empty string in single-agent mode). */
     slug: string;
@@ -19,6 +20,7 @@ export interface AgentServeGitHubTriggerTarget {
     /** Per-agent channel handler args (`send`, `waitUntil`, `host`, …). */
     args: ChannelHandlerArgs;
 }
+/** @deprecated Deprecated on the package root. */
 export interface AgentServeGitHubTriggerEvent {
     type: "github";
     /** Raw webhook body (signature already verified by the caller). */
@@ -29,11 +31,13 @@ export interface AgentServeGitHubTriggerEvent {
     /** Local CP ingest. Defaults to {@link routeLocalIngressContinuation}. */
     routeContinuation?: RouteLocalIngressContinuation;
 }
+/** @deprecated Deprecated on the package root. */
 export interface AgentServeOriginTriggerTarget {
     slug: string;
     options: OriginChannelOptions;
     args: ChannelHandlerArgs;
 }
+/** @deprecated Deprecated on the package root. */
 export interface AgentServeOriginTriggerEvent {
     type: "origin";
     /** Origin envelope JSON (signature already verified by the caller). */
@@ -42,12 +46,15 @@ export interface AgentServeOriginTriggerEvent {
     /** Local CP ingest. Defaults to {@link routeLocalIngressContinuation}. */
     routeContinuation?: RouteLocalIngressContinuation;
 }
+/** @deprecated Deprecated on the package root. */
 export type AgentServeTriggerEvent = AgentServeGitHubTriggerEvent | AgentServeOriginTriggerEvent;
+/** @deprecated Deprecated on the package root. */
 export interface AgentServeTriggerTargetResult {
     slug: string;
     status: number;
     body: unknown;
 }
+/** @deprecated Deprecated on the package root. */
 export interface AgentServeTriggerResult {
     ok: boolean;
     event: string | null;
@@ -56,6 +63,7 @@ export interface AgentServeTriggerResult {
 /**
  * Build fan-out targets from mounted agent projects that export a github
  * channel created via {@link githubChannel}.
+ * @deprecated Deprecated on the package root.
  */
 export declare function collectGitHubTriggerTargets(input: {
     mounts: Array<{
@@ -70,6 +78,7 @@ export declare function collectGitHubTriggerTargets(input: {
 /**
  * Build fan-out targets from mounted agent projects that export an origin
  * channel created via {@link originChannel}.
+ * @deprecated Deprecated on the package root.
  */
 export declare function collectOriginTriggerTargets(input: {
     mounts: Array<{
@@ -83,6 +92,7 @@ export declare function collectOriginTriggerTargets(input: {
 }): AgentServeOriginTriggerTarget[];
 /**
  * Dispatch an agent-serve trigger. GitHub and Origin webhook fan-out.
+ * @deprecated Deprecated on the package root.
  */
 export declare function handleAgentServeTrigger(event: AgentServeTriggerEvent): Promise<AgentServeTriggerResult>;
 //# sourceMappingURL=handleAgentServeTrigger.d.ts.map