@sentry/cloudflare 10.68.0 → 10.70.0

package/build/types/utils/invocationScope.d.ts

@@ -0,0 +1,24 @@
+import { type Scope } from '@sentry/core';
+/**
+ * Runs `callback` on the isolation scope for the current invocation.
+ *
+ * An instrumented handler is either the entry point of an invocation or reentrant — reached from
+ * another instrumented handler already serving the same invocation (a Durable Object method calling
+ * its own `fetch`, an RPC method reaching a sibling method). Only the entry point may fork:
+ *
+ * - Forking at the entry point is mandatory. `setUser`/`setTag` write to the isolation scope, and a
+ *   Durable Object's isolation scope outlives the invocation that touched it, so without a fork one
+ *   invocation's user and tags reappear on the next invocation's events in the same isolate.
+ *   Forking clones, so request data set by an enclosing wrapper is still inherited.
+ * - Forking again when reentrant would be wrong. Everything below the entry point is one logical
+ *   unit of work: a nested call must see what the caller set and be able to add to it, the way it
+ *   would if the SDK were not wrapping it at all.
+ *
+ * The AsyncLocalStorage strategy hands the default isolation scope back whenever no invocation is in
+ * flight, and a forked one while inside `withIsolationScope`. Reference-comparing against the default
+ * is therefore enough to tell the two cases apart. The stack fallback does not fork, so it reports the
+ * default scope even inside an invocation; there the fork degrades to a no-op, which the stack strategy
+ * tolerates. This matches the approach used by `patchEventHandler` in Nuxt.
+ */
+export declare function withInvocationIsolationScope<T>(callback: (scope: Scope) => T): T;
+//# sourceMappingURL=invocationScope.d.ts.map

package/build/types/utils/invocationScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocationScope.d.ts","sourceRoot":"","sources":["../../../src/utils/invocationScope.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,KAAK,EAAsB,MAAM,cAAc,CAAC;AAE3G;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,GAAG,CAAC,CAMhF"}

package/build/types/utils/rpcMeta.d.ts

@@ -4,6 +4,14 @@ import { type SerializedTraceData } from '@sentry/core';
  * If no active trace exists, returns the original args unchanged.
  */
 export declare function appendRpcMeta(args: unknown[]): unknown[];
+/**
+ * Whether the trailing argument carries Sentry RPC metadata.
+ *
+ * Separate from {@link extractRpcMeta} because the RPC method wrappers run this check on every
+ * call — including the instance's own internal method calls, which never carry metadata — and
+ * must not allocate on that path.
+ */
+export declare function hasRpcMeta(args: unknown[]): boolean;
 /**
  * Extracts Sentry RPC metadata from the trailing argument of an args array.
  * Returns cleaned args (without meta) and the extracted trace data if found.

package/build/types/utils/rpcMeta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpcMeta.d.ts","sourceRoot":"","sources":["../../../src/utils/rpcMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAoBpF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAQxD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,EAChD,IAAI,EAAE,CAAC,GACN;IACD,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAcA"}
+{"version":3,"file":"rpcMeta.d.ts","sourceRoot":"","sources":["../../../src/utils/rpcMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAoBpF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAQxD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAEnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,EAChD,IAAI,EAAE,CAAC,GACN;IACD,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAcA"}

package/build/types/vite/agentClass.d.ts

@@ -0,0 +1,41 @@
+import type { ProgramBody } from './transform';
+/**
+ * The subset of the Vite/Rollup plugin context needed to walk the module graph.
+ *
+ * `resolve` is optional: without it detection still works, but only for base-class chains declared
+ * inside the entry module itself. `readFile` is injectable for tests and defaults to reading disk.
+ *
+ * Deliberately **no `load`**: awaiting the plugin context's `load()` from inside a `transform` hook
+ * deadlocks the build — the module cannot finish loading while its own transform is still pending
+ * (Rollup documents this hazard, and Vite's Rolldown pipeline is stricter still). Sibling modules
+ * are therefore read straight off disk; see {@link getModuleShape}.
+ */
+export interface ModuleResolver {
+    parse(code: string): ProgramBody;
+    resolve?(source: string, importer: string): Promise<{
+        id: string;
+    } | null | undefined>;
+    readFile?(id: string): string | undefined;
+}
+/**
+ * Find which of `candidates` (top-level class names in the entry module) are Cloudflare
+ * [`agents`](https://www.npmjs.com/package/agents) Agents.
+ *
+ * An Agent is a Durable Object under the hood, so wrangler configures it as one and the transform
+ * would otherwise reach for `instrumentDurableObjectWithSentry`. Detecting the Agent base chain lets
+ * it pick `instrumentAgentWithSentry` instead, which adds the Agent-specific telemetry on top.
+ *
+ * Unlike `WorkerEntrypoint` detection, the chain is followed *across* modules: base classes commonly
+ * live in their own file (`import { MyBase } from './base'`), and there is no runtime fallback that
+ * would catch a missed one. Resolution stops at package boundaries — a base class imported from
+ * `node_modules` is only recognized when it is one of {@link AGENT_BASE_CLASSES}.
+ */
+export declare function detectAgentClasses(ast: ProgramBody, entryId: string, candidates: Iterable<string>, resolver: ModuleResolver): Promise<Set<string>>;
+/**
+ * The local class names in the entry that a configured class name could refer to — either declared
+ * under that name directly, or aliased to it by an `export { Local as Configured }` specifier.
+ *
+ * Keeps detection (which reads and scans other modules) off classes that no binding points at.
+ */
+export declare function collectAgentCandidates(ast: ProgramBody, configuredNames: Iterable<string>): Set<string>;
+//# sourceMappingURL=agentClass.d.ts.map

package/build/types/vite/agentClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentClass.d.ts","sourceRoot":"","sources":["../../../src/vite/agentClass.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAuB/C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACjC,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACvF,QAAQ,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC3C;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC5B,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CActB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAevG"}

package/build/types/vite/autoInstrument.d.ts

@@ -1,5 +1,7 @@
-import { type ProgramBody } from './transform';
-export declare function sentryCloudflareAutoInstrumentPlugin(): {
+import { type ModuleResolver } from './agentClass';
+export declare function sentryCloudflareAutoInstrumentPlugin(options?: {
+    wranglerConfigPath?: string;
+}): {
     name: string;
     configResolved(config: {
         root: string;
@@ -7,15 +9,14 @@ export declare function sentryCloudflareAutoInstrumentPlugin(): {
             warn(msg: string): void;
         };
     }): void;
-    transform(this: {
-        parse(code: string): ProgramBody;
+    transform(this: ModuleResolver & {
         warn?(msg: string): void;
         environment?: {
             name?: string;
         };
-    }, code: string, id: string): {
+    }, code: string, id: string): Promise<{
         code: string;
         map: unknown;
-    } | undefined;
+    } | undefined>;
 };
 //# sourceMappingURL=autoInstrument.d.ts.map

package/build/types/vite/autoInstrument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoInstrument.d.ts","sourceRoot":"","sources":["../../../src/vite/autoInstrument.ts"],"names":[],"mappings":"AACA,OAAO,EAAwD,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAcrG,wBAAgB,oCAAoC;;2BAUzB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI;oBAyB5E;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,QAC/F,MAAM,MACR,MAAM,GACT;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS;EA6DhD"}
+{"version":3,"file":"autoInstrument.d.ts","sourceRoot":"","sources":["../../../src/vite/autoInstrument.ts"],"names":[],"mappings":"AACA,OAAO,EAA8C,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAgB/F,wBAAgB,oCAAoC,CAAC,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAO;;2BAUvE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI;oBAkC5E,cAAc,GAAG;QAAE,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,QAC9E,MAAM,MACR,MAAM,GACT,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;EAiFzD"}

package/build/types/vite/index.d.ts

@@ -2,6 +2,17 @@
  * Options for {@link sentryCloudflareVitePlugin}.
  */
 export interface SentryCloudflareVitePluginOptions {
+    /**
+     * Path to the wrangler config, relative to the Vite root (or absolute).
+     * Set this when your config doesn't use a default name — e.g. when you
+     * pass `configPath: './wrangler.agent.jsonc'` to `@cloudflare/vite-plugin`,
+     * which the Sentry plugin cannot see. When set, only this file is read
+     * (no default-name probing), and a warning is emitted if it is missing or
+     * unparseable.
+     *
+     * @default undefined (probes `wrangler.json`, `wrangler.jsonc`, `wrangler.toml` at the Vite root)
+     */
+    wranglerConfigPath?: string;
     /**
      * Experimental options that may change or be removed without notice.
      */
@@ -74,15 +85,14 @@ export declare function sentryCloudflareVitePlugin(options?: SentryCloudflareVit
             warn(msg: string): void;
         };
     }): void;
-    transform(this: {
-        parse(code: string): import("./transform").ProgramBody;
+    transform(this: import("./agentClass").ModuleResolver & {
         warn?(msg: string): void;
         environment?: {
             name?: string;
         };
-    }, code: string, id: string): {
+    }, code: string, id: string): Promise<{
         code: string;
         map: unknown;
-    } | undefined;
+    } | undefined>;
 } | import("vite").Plugin<any>)[];
 //# sourceMappingURL=index.d.ts.map

package/build/types/vite/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vite/index.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,aAAa,CAAC,EAAE;QACd;;;;;;;;;;;;;WAaG;QACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;QACzC;;;;;;;;;;WAUG;QACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,iCAAsC;;;;cAvDpC,CAAC;;;;;;YAoB7B,CAAA;mBAKf,CAAC;gBAAQ,CAAC;;;;;;kCAqCpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vite/index.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,aAAa,CAAC,EAAE;QACd;;;;;;;;;;;;;WAaG;QACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;QACzC;;;;;;;;;;WAUG;QACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,iCAAsC;;;;cA5DlF,CAAC;;;;;YAiCgE,CAAC;mBAChD,CAAC;gBAAS,CAAA;;;;;;kCAmCnC"}

package/build/types/vite/moduleShape.d.ts

@@ -0,0 +1,52 @@
+import type { ProgramBody } from './transform';
+/** Binding name used for a module's default export. */
+export declare const DEFAULT_EXPORT = "default";
+/** A resolved superclass reference: a bare identifier or a `ns.Member` expression. */
+export type SuperRef = {
+    kind: 'identifier';
+    name: string;
+} | {
+    kind: 'member';
+    object: string;
+    property: string;
+};
+/** The declarations of a single module that binding resolution needs. */
+export interface ModuleShape {
+    /** Top-level class names → their superclass reference (absent when the class has no `extends`). */
+    classes: Map<string, SuperRef | undefined>;
+    /** Local binding name → the import it came from (`imported` is `default` for a default import). */
+    imports: Map<string, {
+        source: string;
+        imported: string;
+    }>;
+    /** Local binding name → module specifier, for `import * as ns from '...'`. */
+    namespaces: Map<string, string>;
+    /** Exported name → the re-export it came from, for `export { x as y } from '...'`. */
+    reexports: Map<string, {
+        source: string;
+        imported: string;
+    }>;
+    /** Exported name → local binding name, for `export { x as y }` without a source. */
+    localExports: Map<string, string>;
+    /** Module specifiers of bare `export * from '...'` declarations. */
+    starExports: string[];
+    /** `export default <Identifier>` — the local name it refers to. */
+    defaultExportName?: string;
+    /** True when the module's default export is a class declaration/expression. */
+    defaultExportIsClass?: boolean;
+    /** Superclass of an anonymous `export default class extends X`. */
+    defaultExportSuper?: SuperRef;
+}
+/** Collect the shape of a module from its parsed AST — used for the already-parsed entry module. */
+export declare function shapeFromAst(ast: ProgramBody): ModuleShape;
+/**
+ * Extract the module shape from **unprocessed source**.
+ *
+ * Sibling modules are read straight from disk (the plugin context's `load()` would deadlock inside a
+ * transform hook), so they may still be TypeScript — which no JS parser will accept. Only
+ * import/export statements and `class X extends Y` headers matter here, and those are
+ * declaration-level syntax a scan can pick out reliably; class bodies, type annotations and generics
+ * are irrelevant and simply skipped.
+ */
+export declare function shapeFromSource(rawCode: string): ModuleShape;
+//# sourceMappingURL=moduleShape.d.ts.map

package/build/types/vite/moduleShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleShape.d.ts","sourceRoot":"","sources":["../../../src/vite/moduleShape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,aAAa,CAAC;AAoDzD,uDAAuD;AACvD,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,sFAAsF;AACtF,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnH,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,mGAAmG;IACnG,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC3C,mGAAmG;IACnG,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,8EAA8E;IAC9E,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,sFAAsF;IACtF,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,oFAAoF;IACpF,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,oEAAoE;IACpE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,QAAQ,CAAC;CAC/B;AAiBD,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAqC1D;AAiED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAgD5D"}

package/build/types/vite/transform.d.ts

@@ -18,7 +18,7 @@ export interface ProgramBody {
  * config providing only a fallback for self-bound entrypoints whose base class
  * lives in another module.
  */
-export type ClassWrapperKind = 'durableObject' | 'workflow' | 'workerEntrypoint';
+export type ClassWrapperKind = 'durableObject' | 'agent' | 'workflow' | 'workerEntrypoint';
 export interface TransformContext {
     /**
      * Exported class name → the kind of Sentry wrapper to apply. Populated from
@@ -26,6 +26,11 @@ export interface TransformContext {
      * each class's base type.
      */
     classWrappers: Map<string, ClassWrapperKind>;
+    /**
+     * Local class names detected as `agents` Agents. An Agent is configured as a Durable Object in
+     * wrangler, so this upgrades those entries from `durableObject` to `agent`.
+     */
+    agentClasses?: ReadonlySet<string>;
     optionsFn: string;
     /** Import statement prepended when `optionsFn` references a separate module. */
     optionsImport?: string;

package/build/types/vite/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/vite/transform.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,cAAc,CAAC;AAOvC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAuDD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAajF,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5C;;;;OAIG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,gBAAgB,GACpB,eAAe,GAAG,SAAS,CA6C7B"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/vite/transform.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,cAAc,CAAC;AAOvC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAuDD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAc3F,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5C;;;;OAIG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,gBAAgB,GACpB,eAAe,GAAG,SAAS,CA8C7B"}

package/build/types/wrapMethodWithSentry.d.ts

@@ -1,7 +1,7 @@
 import type { DurableObjectStorage } from '@cloudflare/workers-types';
 import type { CloudflareOptions } from './client';
 /** Extended DurableObjectState with originalStorage exposed by instrumentContext */
-interface InstrumentedDurableObjectState extends DurableObjectState {
+export interface InstrumentedDurableObjectState extends DurableObjectState {
     originalStorage?: DurableObjectStorage;
 }
 type MethodWrapperOptions = {

package/build/types/wrapMethodWithSentry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapMethodWithSentry.d.ts","sourceRoot":"","sources":["../../src/wrapMethodWithSentry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAgBtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAQlD,oFAAoF;AACpF,UAAU,8BAA+B,SAAQ,kBAAkB;IACjE,eAAe,CAAC,EAAE,oBAAoB,CAAC;CACxC;AAyBD,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,gBAAgB,GAAG,8BAA8B,CAAC;IAC3D;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AACtD,KAAK,cAAc,GAAG,eAAe,CAAC;AAEtC;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,cAAc,EAC3D,cAAc,EAAE,oBAAoB,EACpC,OAAO,EAAE,CAAC,EACV,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,EAC3C,MAAM,CAAC,EAAE,IAAI,GACZ,CAAC,CA0JH"}
+{"version":3,"file":"wrapMethodWithSentry.d.ts","sourceRoot":"","sources":["../../src/wrapMethodWithSentry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAatE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AASlD,oFAAoF;AACpF,MAAM,WAAW,8BAA+B,SAAQ,kBAAkB;IACxE,eAAe,CAAC,EAAE,oBAAoB,CAAC;CACxC;AAyBD,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,gBAAgB,GAAG,8BAA8B,CAAC;IAC3D;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AACtD,KAAK,cAAc,GAAG,eAAe,CAAC;AAEtC;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,cAAc,EAC3D,cAAc,EAAE,oBAAoB,EACpC,OAAO,EAAE,CAAC,EACV,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,EAC3C,MAAM,CAAC,EAAE,IAAI,GACZ,CAAC,CAqJH"}

package/build/types-ts3.8/client.d.ts

@@ -41,6 +41,8 @@ export declare class CloudflareClient extends ServerRuntimeClient {
      * After calling dispose(), the client should not be used anymore.
      */
     dispose(): void;
+    /** @inheritDoc */
+    protected _setupIntegrations(): void;
     /**
      * Resets the span completion promise and resolve function.
      */
@@ -132,6 +134,30 @@ interface BaseCloudflareOptions {
      * ```
      */
     durableObjectSqlSpanAllowlist?: Array<string | RegExp>;
+    /**
+     * KV keys that should stay instrumented even though they match a reserved prefix used by Durable
+     * Object frameworks (`agents`, `partyserver`, ...) for their internal storage entries.
+     *
+     * By default, KV reads/writes (`get`, `put`, `delete`, `list`) of `cf_`- or `__ps_`-prefixed keys
+     * are treated as framework noise and no `durable_object_storage_*` span is created for them,
+     * mirroring how `cf_`-prefixed SQL tables are handled (see {@link durableObjectSqlSpanAllowlist}).
+     * If one of your own keys happens to use such a prefix, add it here to opt it back into
+     * instrumentation. Strings must match exactly, while regular expressions give you prefix/pattern
+     * matching.
+     *
+     * @default []
+     * @example
+     * ```ts
+     * export default Sentry.withSentry(
+     *   (env) => ({
+     *     dsn: env.SENTRY_DSN,
+     *     durableObjectStorageSpanAllowlist: ['cf_my_key', /^cf_reports_/],
+     *   }),
+     *   handler,
+     * );
+     * ```
+     */
+    durableObjectStorageSpanAllowlist?: Array<string | RegExp>;
     /**
      * @deprecated Use `enableRpcTracePropagation` instead. This option will be removed in a future major version.
      *
@@ -145,6 +171,17 @@ interface BaseCloudflareOptions {
      * @default false
      */
     instrumentPrototypeMethods?: boolean | string[];
+    /**
+     * If you use Spotlight by Sentry during development, use
+     * this option to forward captured Sentry events to Spotlight.
+     *
+     * Either set it to true, or provide a specific Spotlight Sidecar URL.
+     *
+     * More details: https://spotlightjs.com/
+     *
+     * IMPORTANT: Only set this option to `true` while developing, not in production!
+     */
+    spotlight?: boolean | string;
 }
 /**
  * Configuration options for the Sentry Cloudflare SDK

package/build/types-ts3.8/durableobject.d.ts

@@ -1,5 +1,53 @@
 import { DurableObject } from 'cloudflare:workers';
 import { CloudflareOptions } from './client';
+/**
+ * The instrumented context passed between the shared construction helpers.
+ *
+ * This is intentionally `any` rather than `ReturnType<typeof instrumentContext<DurableObjectState>>`.
+ * A concrete `DurableObjectState` here forces `tsc` to structurally relate its `storage: SqlStorage`
+ * graph against the `ExecutionContext | InstrumentedDurableObjectState` parameter of
+ * `wrapMethodWithSentry`, while the RPC-branded `DurableObject` from `cloudflare:workers` is also in
+ * scope. That union comparison explodes (1296×1296) and hangs the type build. The original inline
+ * implementation avoided this only incidentally, because `ctx` reached it as `any` through the Proxy
+ * `construct` trap. Keeping the shared context `any` preserves that behavior.
+ */
+type InstrumentedDurableObjectContext = any;
+/**
+ * Constructs a Durable Object instance and instruments its built-in handler methods
+ * (`fetch`, `alarm`, `webSocketMessage`, `webSocketClose`, `webSocketError`).
+ *
+ * This is the shared construction path used by both {@link instrumentDurableObjectWithSentry}
+ * and {@link instrumentAgentWithSentry}. It intentionally does NOT apply the RPC prototype-method
+ * instrumentation — callers apply that last via {@link finalizeWithRpcInstrumentation}, after any
+ * additional per-instance instrumentation has been layered onto the returned object.
+ *
+ * @internal
+ */
+export declare function constructInstrumentedDurableObject<E, T extends DurableObject<E>>(target: new (state: DurableObjectState, env: E) => T, ctx: DurableObjectState, env: E, newTarget: NewableFunction, optionsCallback: (env: E) => CloudflareOptions): {
+    obj: T;
+    options: CloudflareOptions;
+    context: InstrumentedDurableObjectContext;
+    frameworkManagedMethods: ReadonlySet<string>;
+};
+/**
+ * Adds trace propagation to a constructed Durable Object's RPC methods.
+ *
+ * RPC methods are wrapped on the prototype because Cloudflare dispatches them with the Durable
+ * Object instance as the receiver. This preserves native private-field access and keeps the methods
+ * visible to Cloudflare's RPC dispatcher. Built-in handlers, Agent handlers, and methods managed by
+ * another framework are left untouched.
+ *
+ * Call this after all per-instance instrumentation has been applied. If RPC trace propagation is
+ * disabled, the object is returned unchanged.
+ *
+ * @param obj The constructed Durable Object instance.
+ * @param options The resolved SDK options for this instance.
+ * @param context The instrumented execution context for this instance.
+ * @param excludedMethods Method names owned by another framework and therefore not safe to wrap.
+ * @returns The same Durable Object instance, with eligible prototype methods instrumented.
+ * @internal
+ */
+export declare function finalizeWithRpcInstrumentation<T extends object>(obj: T, options: CloudflareOptions, context: InstrumentedDurableObjectContext, excludedMethods?: ReadonlySet<string>): T;
 /**
  * Instruments a Durable Object class to capture errors and performance data.
  *
@@ -34,4 +82,46 @@ import { CloudflareOptions } from './client';
  * ```
  */
 export declare function instrumentDurableObjectWithSentry<E, T extends DurableObject<E>, C extends new (state: DurableObjectState, env: E) => T>(optionsCallback: (env: E) => CloudflareOptions, DurableObjectClass: C): C;
+/**
+ * Instruments a Cloudflare [`agents`](https://www.npmjs.com/package/agents) Agent class with Sentry.
+ *
+ * An `Agent` is a Durable Object under the hood, so this applies the same instrumentation as
+ * {@link instrumentDurableObjectWithSentry} (request transactions, `alarm`, WebSocket handlers, RPC
+ * trace propagation, SQL spans) and additionally captures Agent-specific telemetry via
+ * `instrumentCloudflareAgent`:
+ *
+ * - **Callable RPC spans** — a span (op `rpc`) for each `@callable()` method invoked over WebSocket.
+ * - **Breadcrumbs** — for every Agent observability event (`rpc`, `state:update`, `connect`,
+ *   `disconnect`, `schedule:*`, `queue:*`, `workflow:*`, `email:*`, `mcp:*`, ...).
+ *
+ * Cloudflare Workers cannot auto-instrument, so the Agent class must be wrapped manually.
+ *
+ * @param optionsCallback Function that returns the options for the SDK initialization.
+ * @param AgentClass The Agent class to instrument.
+ * @returns The instrumented Agent class.
+ *
+ * @example
+ * ```ts
+ * import { Agent, callable, routeAgentRequest } from 'agents';
+ * import * as Sentry from '@sentry/cloudflare';
+ *
+ * class MyAgentBase extends Agent<Env> {
+ *   @callable()
+ *   async greet(name: string): Promise<string> {
+ *     return `Hello, ${name}!`;
+ *   }
+ * }
+ *
+ * export const MyAgent = Sentry.instrumentAgentWithSentry(
+ *   env => ({
+ *     dsn: env.SENTRY_DSN,
+ *     tracesSampleRate: 1.0,
+ *     enableRpcTracePropagation: true,
+ *   }),
+ *   MyAgentBase,
+ * );
+ * ```
+ */
+export declare function instrumentAgentWithSentry<E, T extends DurableObject<E>, C extends new (state: DurableObjectState, env: E) => T>(optionsCallback: (env: E) => CloudflareOptions, AgentClass: C): C;
+export {};
 //# sourceMappingURL=durableobject.d.ts.map

package/build/types-ts3.8/flush.d.ts

@@ -19,7 +19,7 @@ type FlushLock = {
  *
  * By using the original waitUntil for flush operations, we bypass this issue.
  */
-export declare function getOriginalWaitUntil(context: ExecutionContextCompat): ExecutionContext['waitUntil'] | undefined;
+export declare function getOriginalWaitUntil(context: ExecutionContextCompat): ExecutionContext['waitUntil'];
 /**
  * Enhances the given execution context by wrapping its `waitUntil` method with a proxy
  * to monitor pending tasks, and provides a flusher function to ensure all tasks

package/build/types-ts3.8/index.d.ts

@@ -3,13 +3,14 @@ export { CloudflareOptions } from './client';
 export { addEventProcessor, addBreadcrumb, addIntegration, captureException, captureEvent, captureMessage, captureFeedback, close, createTransport, lastEventId, flush, getClient, isInitialized, isEnabled, getCurrentScope, getGlobalScope, getIsolationScope, setCurrentClient, Scope, SDK_VERSION, setContext, setExtra, setExtras, setTag, setTags, setAttribute, setAttributes, setUser, setConversationId, getSpanStatusFromHttpCode, setHttpStatus, withScope, withIsolationScope, captureCheckIn, withMonitor, setMeasurement, getActiveSpan, getRootSpan, getTraceData, getTraceMetaTags, startSpan, startInactiveSpan, startSpanManual, startNewTrace, bindScopeToEmitter, suppressTracing, withActiveSpan, getSpanDescendants, continueTrace, functionToStringIntegration, inboundFiltersIntegration, instrumentOpenAiClient, instrumentGoogleGenAIClient, instrumentAnthropicAiClient, eventFiltersIntegration, linkedErrorsIntegration, requestDataIntegration, extraErrorDataIntegration, dedupeIntegration, rewriteFramesIntegration, captureConsoleIntegration, moduleMetadataIntegration, supabaseIntegration, instrumentSupabaseClient, instrumentPostgresJsSql, zodErrorsIntegration, consoleIntegration, SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, SEMANTIC_ATTRIBUTE_SENTRY_SAMPLE_RATE, trpcMiddleware, spanToJSON, spanToTraceHeader, spanToBaggageHeader, updateSpanName, wrapMcpServerWithSentry, consoleLoggingIntegration, createConsolaReporter, createLangChainCallbackHandler, instrumentLangChainEmbeddings, featureFlagsIntegration, growthbookIntegration, logger, metrics, withStreamedSpan, spanStreamingIntegration, instrumentStateGraph, instrumentLangGraph, instrumentCreateReactAgent, } from '@sentry/core';
 export { withSentry } from './withSentry';
 export { defineCloudflareOptions } from './defineCloudflareOptions';
-export { instrumentDurableObjectWithSentry } from './durableobject';
+export { instrumentAgentWithSentry, instrumentDurableObjectWithSentry } from './durableobject';
 export { sentryPagesPlugin } from './pages-plugin';
 export { wrapRequestHandler } from './request';
 export { CloudflareClient } from './client';
 export { getDefaultIntegrations } from './sdk';
 export { httpServerIntegration } from './integrations/httpServer';
 export { fetchIntegration } from './integrations/fetch';
+export { spotlightIntegration } from './integrations/spotlight';
 export { vercelAIIntegration } from './integrations/tracing/vercelai';
 export { honoIntegration } from './integrations/hono';
 export { instrumentD1WithSentry } from './instrumentations/worker/instrumentD1';

package/build/types-ts3.8/instrumentations/agents/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Instruments an instance of a Cloudflare [`agents`](https://www.npmjs.com/package/agents) `Agent`
+ * with Sentry, adding telemetry that is specific to the Agent's runtime behavior:
+ *
+ * - **Callable RPC spans** — a span (op `rpc`) for each `@callable()` method invoked over WebSocket.
+ * - **Conversation correlation** — sets the conversation id on the scope for each unit of agent
+ *   work — chat turn, callable RPC call, or HTTP request — so `gen_ai` spans created within it are
+ *   correlated, for chat and plain agents alike. The id is minted once per agent instance and
+ *   rotated when the chat is cleared (the `message:clear` observability event); it is persisted to
+ *   Durable Object storage so it survives hibernation.
+ *
+ * It only hooks the `agents` package internals and uses Sentry's tracing primitives. On Cloudflare
+ * Workers, prefer `instrumentAgentWithSentry`, which additionally instruments the Durable Object
+ * handlers and initializes the SDK; that function calls this one internally.
+ *
+ * The hooks replace own-properties on the instance and defer to the original implementation, so
+ * they compose with any other instrumentation applied to the same instance.
+ *
+ * @param agent The `agents` `Agent` instance to instrument.
+ * @returns The same instance, instrumented.
+ *
+ * @internal Use `instrumentAgentWithSentry` instead — this is called internally by it.
+ */
+export declare function instrumentCloudflareAgent<T extends object>(agent: T): T;
+//# sourceMappingURL=index.d.ts.map

package/build/types-ts3.8/instrumentations/agents/instrumentAgentCallableRpc.d.ts

@@ -0,0 +1,14 @@
+import { AgentInternals } from './types';
+/**
+ * Wraps the Agent's `onMessage` handler to create a span for each `@callable()` RPC invocation.
+ * RPC requests arrive as WebSocket messages, so this span nests under the active transaction for
+ * the WebSocket message (on Cloudflare, the instrumented Durable Object `webSocketMessage` hook).
+ *
+ * Also sets the conversation id on the scope for the duration of the call: callable methods are the
+ * unit of work for plain (non-chat) agents, which run LLM calls just like chat turns do. It is
+ * awaited so the id is on the scope before the method body creates any span; the `agents`
+ * `onMessage` own property this wraps is already `async`, so the promise return is nothing new to
+ * the WebSocket dispatch upstream.
+ */
+export declare function instrumentAgentCallableRpc(obj: AgentInternals): void;
+//# sourceMappingURL=instrumentAgentCallableRpc.d.ts.map

package/build/types-ts3.8/instrumentations/agents/instrumentAgentRequestConversation.d.ts

@@ -0,0 +1,16 @@
+import { AgentInternals } from './types';
+/**
+ * Correlates the AI spans of an HTTP-driven agent turn with a conversation id on the active scope.
+ *
+ * `onRequest` is the third unit of agent work, alongside chat turns and `@callable()` RPC: the
+ * `agents` router sends every non-WebSocket request to it, which is how REST endpoints and webhooks
+ * reach an agent.
+ *
+ * `agents` installs `onRequest` as an own property in the `Agent` constructor (as it does
+ * `onMessage`), and we instrument after construction, so wrapping the own property is what the
+ * router ends up calling. That own property is already `async`, and partyserver's `fetch` awaits it,
+ * so returning a promise from this wrapper — to get the conversation id onto the scope before the
+ * request handler creates any span — keeps the existing contract.
+ */
+export declare function instrumentAgentRequestConversation(obj: AgentInternals): void;
+//# sourceMappingURL=instrumentAgentRequestConversation.d.ts.map

package/build/types-ts3.8/instrumentations/agents/instrumentChatAgentConversation.d.ts

@@ -0,0 +1,23 @@
+import { AgentInternals } from './types';
+/**
+ * For chat agents (`AIChatAgent` from `@cloudflare/ai-chat`), correlates each chat turn's AI spans
+ * with a conversation id on the active scope.
+ *
+ * In the Agents model one agent instance is one long-lived conversation, so the conversation id is
+ * minted once per instance and persisted to Durable Object storage, which is what carries it across
+ * hibernation (that destroys the in-memory instance). When the user clears the chat, they expect a
+ * fresh conversation — but recreating the Durable Object for that would also drop the MCP/OAuth
+ * state stored per instance (GitHub/Sentry sign-in). To get a fresh conversation id *without*
+ * losing that state, we rotate the persisted id when the SDK reports a cleared chat.
+ *
+ * The id itself is not attached to spans here — `setAgentConversationId` resolves it, and the SDK's
+ * `conversationIdIntegration` picks it off the scope at `spanStart` to stamp
+ * `gen_ai.conversation.id` onto the AI spans created inside the turn (e.g. by the Workers AI
+ * instrumentation), which correlates a turn's model and tool calls.
+ *
+ * Plain (non-chat) `Agent`s do not define `onChatMessage`, so they are skipped here — their unit
+ * of work is the callable RPC method, where `instrumentAgentCallableRpc` sets the conversation id
+ * instead.
+ */
+export declare function instrumentChatAgentConversation(obj: AgentInternals): void;
+//# sourceMappingURL=instrumentChatAgentConversation.d.ts.map