@cursor/july 0.1.108 → 0.1.111

package/dist/internal/workspace.js

@@ -1,10 +1,12 @@
 /**
  * Session workspace materialization. Each session gets its own working
- * directory that the Cursor harness treats as the project: instructions land
- * in `AGENTS.md`, skills land in `.cursor/skills/<name>/SKILL.md`,
- * agent-side tools land in `.agent-serve/tools/<name>.sh`, and
- * `agent/sandbox/workspace/**` seed files are mirrored in. The harness picks
- * all of this up natively through its project setting source.
+ * directory that the Cursor harness treats as the project: skills land in
+ * `.cursor/skills/<name>/SKILL.md`, agent-side tools land in
+ * `.agent-serve/tools/<name>.sh`, and `agent/sandbox/workspace/**` seed files
+ * are mirrored in. The harness picks all of this up natively through its
+ * project setting source. Instructions are not written here: local turns
+ * deliver them as the harness system prompt ({@link buildAgentsMdContent}),
+ * and cloud / grokbot harnesses never read the session workspace.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -59,7 +61,7 @@ export function buildCloudWorkspaceSection(dir) {
  * replace-per-send / task-end wipe lifetime, not a separate mount ACL.
  */
 export function buildCloudSessionWorkspaceSection(dir, relPaths) {
-    const listed = relPaths.map((path) => `\`${path}\``).join(", ");
+    const listed = relPaths.map(path => `\`${path}\``).join(", ");
     return [
         "## Session workspace files",
         "",
@@ -115,7 +117,7 @@ export function withIdentityPreamble(name, instructions) {
  *   Local workspaces omit bodies because the files already exist on disk.
  */
 export function buildAgentToolsCatalog(tools, options = { includeScripts: false }) {
-    const agentTools = tools.filter((tool) => tool.execution === "agent");
+    const agentTools = tools.filter(tool => tool.execution === "agent");
     if (agentTools.length === 0) {
         return "";
     }
@@ -169,7 +171,7 @@ export function buildAgentToolsCatalog(tools, options = { includeScripts: false
  * a host tool and the host-side marker never appears.
  */
 export function buildServerToolsCatalog(tools, options) {
-    const serverTools = tools.filter((tool) => tool.execution === "server");
+    const serverTools = tools.filter(tool => tool.execution === "server");
     if (serverTools.length === 0) {
         return "";
     }
@@ -196,11 +198,12 @@ export function buildServerToolsCatalog(tools, options) {
     return `${parts.join("\n").trimEnd()}\n`;
 }
 /**
- * The full AGENTS.md-equivalent context for an agent: instructions, identity
- * section, and the agent-side tool catalog. Written to the session workspace
- * as `AGENTS.md`, and inlined into the first turn's prompt when the harness
- * cannot discover that file (cloud runtime, or a local workspace the harness
- * will not treat as the project root — see {@link isNestedInGitRepo}).
+ * The full instructions context for an agent: instructions, identity
+ * section, and the agent-side tool catalog. Local turns send it as the
+ * harness system prompt (`AgentOptions.systemPrompt`, replacing Cursor's
+ * built-in prompt), grokbot turns carry it into the hosted session's system
+ * prompt, and cloud turns inline it into the first prompt because a cloud VM
+ * has no materialized workspace to read it from.
  *
  * `serverToolsMcpName` is cloud-only: when the turn's MCP config carries the
  * session-bound server-tool endpoint, the catalog names that server so the
@@ -224,7 +227,7 @@ export function buildAgentsMdContent(agent, options) {
             includeScripts: options.includeScripts,
         }),
     ]
-        .filter((part) => part !== "")
+        .filter(part => part !== "")
         .join("\n\n");
 }
 /**
@@ -288,8 +291,6 @@ export function materializeWorkspace(options) {
         if (seed) {
             yield linkSharedMemoryDir(workspaceDir, stateRoot);
         }
-        const agentsMd = buildAgentsMdContent(agent, { includeScripts: false });
-        yield writeFile(join(workspaceDir, "AGENTS.md"), agentsMd, "utf8");
         for (const tool of agent.tools) {
             if (tool.execution !== "agent" || tool.script === undefined) {
                 continue;

package/dist/kv/memory-kv.d.ts

@@ -1,9 +1,11 @@
 /**
- * In-memory {@link HostKvCasApi} — the test/dev implementation of the
- * interface module (`@cursor/july/kv`), exported at
- * `@cursor/july/kv/memory`.
+ * In-memory {@link HostKvCasApi} — the test/dev implementation of
+ * `@cursor/july/kv`.
  *
- * The memory KV *is* the dev shim: tests and local runs exercise the
+ * Internal only: SDK tests and Cursor factory code. Not a public Agent
+ * SDK export.
+ *
+ * The memory KV *is* the test shim: tests and local runs exercise the
  * CAS contract, not a mock of an RPC. Values are deep-copied on both write and
  * read so callers can never observe (or cause) shared-reference mutation.
  */

package/dist/kv/memory-kv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-kv.d.ts","sourceRoot":"","sources":["../../src/kv/memory-kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,aAAa,CAAC;AAErB,gDAAgD;AAChD,wBAAgB,cAAc,IAAI,YAAY,CA4D7C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,eAAe,CAShD"}
+{"version":3,"file":"memory-kv.d.ts","sourceRoot":"","sources":["../../src/kv/memory-kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,aAAa,CAAC;AAErB,gDAAgD;AAChD,wBAAgB,cAAc,IAAI,YAAY,CA4D7C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,eAAe,CAShD"}

package/dist/kv/memory-kv.js

@@ -1,9 +1,11 @@
 /**
- * In-memory {@link HostKvCasApi} — the test/dev implementation of the
- * interface module (`@cursor/july/kv`), exported at
- * `@cursor/july/kv/memory`.
+ * In-memory {@link HostKvCasApi} — the test/dev implementation of
+ * `@cursor/july/kv`.
  *
- * The memory KV *is* the dev shim: tests and local runs exercise the
+ * Internal only: SDK tests and Cursor factory code. Not a public Agent
+ * SDK export.
+ *
+ * The memory KV *is* the test shim: tests and local runs exercise the
  * CAS contract, not a mock of an RPC. Values are deep-copied on both write and
  * read so callers can never observe (or cause) shared-reference mutation.
  */
@@ -79,7 +81,7 @@ export function createMemoryKv() {
         },
         listKeys(prefix) {
             return __awaiter(this, void 0, void 0, function* () {
-                return [...entries.keys()].filter((key) => key.startsWith(prefix)).sort();
+                return [...entries.keys()].filter(key => key.startsWith(prefix)).sort();
             });
         },
     };
@@ -94,9 +96,9 @@ export function createMemoryKv() {
 export function memoryCasTable() {
     const kv = createMemoryKv();
     return {
-        getWithVersion: (key) => kv.getWithVersion(key),
+        getWithVersion: key => kv.getWithVersion(key),
         putIfAbsent: (key, value) => kv.putIfAbsent(key, value),
         putIfVersion: (key, value, expectedVersion) => kv.putIfVersion(key, value, expectedVersion),
-        listKeys: (prefix) => kv.listKeys(prefix),
+        listKeys: prefix => kv.listKeys(prefix),
     };
 }

package/dist/kv.d.ts

@@ -8,13 +8,10 @@
  * stores of unknown provenance — a `defineStorage` backend declares CAS
  * through its `cas` group instead, so it never needs probing.
  *
- * Implementations live elsewhere:
- *
- * - `@cursor/july/kv/memory` — `createMemoryKv`, the test/dev shim.
- * - The storage backends implement the same operations as the `cas`
- *   group on `defineStorage` (see `StorageCasTable` in
- *   `@cursor/july/storage`): `fileKv` (single-process) and
- *   `cursorHostedStorage` (control-plane proxy). See `docs/storage.md`.
+ * Implementations live on the storage backends: they implement the same
+ * operations as the `cas` group on the internal-only `defineStorage`
+ * (its `StorageCasTable` member): `fileKv` (single-process) and
+ * `cursorHostedStorage` (control-plane proxy). See `docs/storage.md`.
  */
 export type { HostKvApi, HostKvCasApi, KvCasResult, KvVersionedEntry, } from "./types.js";
 export { supportsKvCas } from "./types.js";

package/dist/kv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../src/kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,YAAY,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../src/kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/kv.js

@@ -8,12 +8,9 @@
  * stores of unknown provenance — a `defineStorage` backend declares CAS
  * through its `cas` group instead, so it never needs probing.
  *
- * Implementations live elsewhere:
- *
- * - `@cursor/july/kv/memory` — `createMemoryKv`, the test/dev shim.
- * - The storage backends implement the same operations as the `cas`
- *   group on `defineStorage` (see `StorageCasTable` in
- *   `@cursor/july/storage`): `fileKv` (single-process) and
- *   `cursorHostedStorage` (control-plane proxy). See `docs/storage.md`.
+ * Implementations live on the storage backends: they implement the same
+ * operations as the `cas` group on the internal-only `defineStorage`
+ * (its `StorageCasTable` member): `fileKv` (single-process) and
+ * `cursorHostedStorage` (control-plane proxy). See `docs/storage.md`.
  */
 export { supportsKvCas } from "./types.js";

package/dist/otel-public.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Public `@cursor/july/otel` surface: types and W3C `traceparent`
+ * helpers. `defineOtel` is `@cursor/july/internal/otel`.
+ */
+export type { OtelConfig, OtelConfigFactory, OtelDefinition, OtelExporterConfig, OtelLogOptions, OtelMetricOptions, OtelSignal, OtelTraceOptions, } from "./otel.js";
+export { activeTraceparent, BACKEND_TRACEPARENT_HEADER, formatTraceparent, injectActiveTraceContext, installOutboundFetchInstrumentation, instrumentedFetch, TRACEPARENT_HEADER, } from "./otel.js";
+//# sourceMappingURL=otel-public.d.ts.map

package/dist/otel-public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-public.d.ts","sourceRoot":"","sources":["../src/otel-public.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,wBAAwB,EACxB,mCAAmC,EACnC,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,WAAW,CAAC"}

package/dist/otel-public.js

@@ -0,0 +1,5 @@
+/**
+ * Public `@cursor/july/otel` surface: types and W3C `traceparent`
+ * helpers. `defineOtel` is `@cursor/july/internal/otel`.
+ */
+export { activeTraceparent, BACKEND_TRACEPARENT_HEADER, formatTraceparent, injectActiveTraceContext, installOutboundFetchInstrumentation, instrumentedFetch, TRACEPARENT_HEADER, } from "./otel.js";

package/dist/otel.d.ts

@@ -3,7 +3,7 @@
  * or set `OTEL_EXPORTER_OTLP_ENDPOINT` (standard OTel env).
  *
  * ```ts
- * import { defineOtel } from "@cursor/july/otel";
+ * import { defineOtel } from "@cursor/july/internal/otel";
  *
  * export default defineOtel({
  *   serviceName: "cursor",
@@ -13,6 +13,8 @@
  * // Hosted v2: re-read env on flush after deployment secrets bind.
  * export default defineOtel(() => resolveMyOtelConfig());
  * ```
+ *
+ * Internal only: Cursor factory agents. Not a public Agent SDK export.
  */
 export type OtelSignal = "traces" | "metrics" | "logs";
 /** One OTLP destination. Multiple entries fan out. */
@@ -93,7 +95,10 @@ export type OtelConfigFactory = () => OtelConfig;
  * `pickAuthoredOtel` compares the bake-time snapshot, not the thunk.
  */
 export declare const OTEL_CONFIG_RESOLVE: symbol;
-/** Author OpenTelemetry export under `agent/otel.ts`. */
+/**
+ * Author OpenTelemetry export under `agent/otel.ts`.
+ * Import from `@cursor/july/internal/otel`, not `@cursor/july`.
+ */
 export declare function defineOtel(config?: OtelConfig | OtelConfigFactory): OtelDefinition;
 /** Invoke a `defineOtel(() => …)` factory, or return the static snapshot. */
 export declare function resolveOtelDefinition(def: OtelConfig): OtelConfig;

package/dist/otel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvD,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACpC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;IACtC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,MAAM,UAAU,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,UAAU,CACxB,MAAM,GAAE,UAAU,GAAG,iBAAsB,GAC1C,cAAc,CAWhB;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CAUjE;AA+DD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAEhE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,GAAG,SAAS,CAOrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC,GAAG,IAAI,CAWP;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAItD;AAwBD,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,OAAO,KAAa,GAAG,OAAO,KAAK,CAQ1E;AAMD,wEAAwE;AACxE,wBAAgB,mCAAmC,IAAI,IAAI,CAO1D"}
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvD,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACpC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;IACtC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,MAAM,UAAU,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,GAAE,UAAU,GAAG,iBAAsB,GAC1C,cAAc,CAWhB;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CAUjE;AA+DD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAEhE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,GAAG,SAAS,CAOrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC,GAAG,IAAI,CAWP;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAItD;AAwBD,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,OAAO,KAAa,GAAG,OAAO,KAAK,CAQ1E;AAMD,wEAAwE;AACxE,wBAAgB,mCAAmC,IAAI,IAAI,CAO1D"}

package/dist/otel.js

@@ -3,7 +3,7 @@
  * or set `OTEL_EXPORTER_OTLP_ENDPOINT` (standard OTel env).
  *
  * ```ts
- * import { defineOtel } from "@cursor/july/otel";
+ * import { defineOtel } from "@cursor/july/internal/otel";
  *
  * export default defineOtel({
  *   serviceName: "cursor",
@@ -13,6 +13,8 @@
  * // Hosted v2: re-read env on flush after deployment secrets bind.
  * export default defineOtel(() => resolveMyOtelConfig());
  * ```
+ *
+ * Internal only: Cursor factory agents. Not a public Agent SDK export.
  */
 import { AsyncLocalStorage } from "node:async_hooks";
 import { context, trace } from "@opentelemetry/api";
@@ -22,7 +24,10 @@ import { brandDefinition } from "./internal/brand.js";
  * `pickAuthoredOtel` compares the bake-time snapshot, not the thunk.
  */
 export const OTEL_CONFIG_RESOLVE = Symbol.for("anysphere.july.otel.configResolve");
-/** Author OpenTelemetry export under `agent/otel.ts`. */
+/**
+ * Author OpenTelemetry export under `agent/otel.ts`.
+ * Import from `@cursor/july/internal/otel`, not `@cursor/july`.
+ */
 export function defineOtel(config = {}) {
     const resolve = typeof config === "function" ? config : () => config;
     const snapshot = resolve();