@cursor/july 0.1.101 → 0.1.103

package/dist/internal/otel/mcp.js

@@ -0,0 +1,55 @@
+/**
+ * Client-side MCP instrumentation: W3C / Cursor HTTP inject on Streamable
+ * HTTP + SSE fetches, SEP-414 `_meta.traceparent` on JSON-RPC params, and
+ * CLIENT spans for `tools/list` / `tools/call`.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { context, SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+import { activeTraceparent, instrumentedFetch } from "../../otel.js";
+import { attrs } from "./attrs.js";
+const TRACER = "agent_sdk";
+export function instrumentedMcpFetch(base = fetch) {
+    return instrumentedFetch(base);
+}
+/** SEP-414 / OTel MCP carrier for `params._meta`. */
+export function mcpTraceMeta() {
+    const traceparent = activeTraceparent();
+    if (traceparent === undefined) {
+        return undefined;
+    }
+    return { traceparent };
+}
+export function runMcpClientSpan(args, fn) {
+    const span = trace.getTracer(TRACER).startSpan(args.method, {
+        kind: SpanKind.CLIENT,
+        attributes: attrs({
+            "rpc.system": "mcp",
+            "mcp.method.name": args.method,
+            "mcp.tool.name": args.toolName,
+            "agent_sdk.mcp.connection": args.connection,
+        }),
+    });
+    return context.with(trace.setSpan(context.active(), span), () => __awaiter(this, void 0, void 0, function* () {
+        try {
+            return yield fn();
+        }
+        catch (error) {
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    }));
+}

package/dist/internal/otel/propagation.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Process-global W3C `traceparent` propagator. Inbound HTTP extracts;
+ * outbound Factory / Cursor API calls inject.
+ */
+export declare function ensureW3cPropagator(): void;
+//# sourceMappingURL=propagation.d.ts.map

package/dist/internal/otel/propagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/propagation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}

package/dist/internal/otel/propagation.js

@@ -0,0 +1,14 @@
+/**
+ * Process-global W3C `traceparent` propagator. Inbound HTTP extracts;
+ * outbound Factory / Cursor API calls inject.
+ */
+import { propagation } from "@opentelemetry/api";
+import { W3CTraceContextPropagator } from "@opentelemetry/core";
+let installed = false;
+export function ensureW3cPropagator() {
+    if (installed) {
+        return;
+    }
+    propagation.setGlobalPropagator(new W3CTraceContextPropagator());
+    installed = true;
+}

package/dist/internal/otel/runtime.d.ts

@@ -8,14 +8,39 @@
 import type { Histogram, Meter, Tracer } from "@opentelemetry/api";
 import type { Logger as OtelLogger } from "@opentelemetry/api-logs";
 import { type ResolvedOtelConfig } from "./config.js";
+/**
+ * Hosted v2 pods may be frozen or destroyed as soon as the HTTP reply
+ * lands. Bound the exporter wait so a slow collector cannot hold the
+ * delivery (OTLP BatchSpanProcessor defaults to 30s).
+ */
+export declare const OTEL_FORCE_FLUSH_TIMEOUT_MS = 1000;
+/**
+ * First hosted OTLP POST may include a cold TLS handshake to Datadog.
+ * Bound separately from {@link OTEL_FORCE_FLUSH_TIMEOUT_MS} so the
+ * queued turn/tool batch is not abandoned after 1s.
+ */
+export declare const OTEL_DEFERRED_EXPORT_TIMEOUT_MS = 5000;
+/** Drop oldest finished spans when no collector has drained the buffer. */
+export declare const OTEL_IN_MEMORY_SPAN_LIMIT = 2048;
 export interface OtelRuntime {
     config: ResolvedOtelConfig;
     tracer: Tracer;
     meter: Meter | undefined;
     logger: OtelLogger | undefined;
     httpDuration: Histogram | undefined;
+    forceFlush: () => Promise<void>;
     shutdown: () => Promise<void>;
 }
-export declare function createOtelRuntime(config: ResolvedOtelConfig, log: (line: string) => void): OtelRuntime | undefined;
+export interface CreateOtelRuntimeOptions {
+    /**
+     * Re-resolve exporters at flush (hosted v2 binds deployment secrets
+     * after bake). When bake had no OTLP exporters, finished spans sit
+     * in memory until this returns destinations.
+     */
+    resolveExport?: () => ResolvedOtelConfig;
+}
+export declare function createOtelRuntime(config: ResolvedOtelConfig, log: (line: string) => void, options?: CreateOtelRuntimeOptions): OtelRuntime | undefined;
+export declare function forceFlushOtelRuntime(runtime: OtelRuntime | undefined): Promise<void>;
 export declare function shutdownOtelRuntime(runtime: OtelRuntime | undefined): Promise<void>;
+export declare function raceOtelForceFlush(work: Promise<unknown>, log: (line: string) => void, timeoutMs?: number): Promise<void>;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/internal/otel/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAgCpE,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAI1E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,WAAW,GAAG,SAAS,CA6BzB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA2CpE,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAK1E;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AAErD,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,kBAAkB,CAAC;CAC1C;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC3B,OAAO,CAAC,EAAE,wBAAwB,GACjC,WAAW,GAAG,SAAS,CAkCzB;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EACtB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC3B,SAAS,GAAE,MAAoC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/internal/otel/runtime.js

@@ -16,6 +16,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { DiagLogLevel, diag, metrics, trace } from "@opentelemetry/api";
 import { logs } from "@opentelemetry/api-logs";
+import { ExportResultCode } from "@opentelemetry/core";
 import { OTLPLogExporter as OTLPLogExporterHttp } from "@opentelemetry/exporter-logs-otlp-http";
 import { OTLPLogExporter as OTLPLogExporterProto } from "@opentelemetry/exporter-logs-otlp-proto";
 import { OTLPMetricExporter as OTLPMetricExporterHttp } from "@opentelemetry/exporter-metrics-otlp-http";
@@ -25,20 +26,41 @@ import { OTLPTraceExporter as OTLPTraceExporterProto } from "@opentelemetry/expo
 import { resourceFromAttributes, } from "@opentelemetry/resources";
 import { BatchLogRecordProcessor, LoggerProvider, } from "@opentelemetry/sdk-logs";
 import { AggregationTemporality, MeterProvider, PeriodicExportingMetricReader, } from "@opentelemetry/sdk-metrics";
+import { SimpleSpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { BatchSpanProcessor, NodeTracerProvider, ParentBasedSampler, TraceIdRatioBasedSampler, } from "@opentelemetry/sdk-trace-node";
 import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION, } from "@opentelemetry/semantic-conventions";
+import { installOutboundFetchInstrumentation, } from "../../otel.js";
 import { exportersForSignal } from "./config.js";
+import { ensureW3cPropagator } from "./propagation.js";
 const INSTRUMENTATION = "agent_sdk";
-export function createOtelRuntime(config, log) {
+/**
+ * Hosted v2 pods may be frozen or destroyed as soon as the HTTP reply
+ * lands. Bound the exporter wait so a slow collector cannot hold the
+ * delivery (OTLP BatchSpanProcessor defaults to 30s).
+ */
+export const OTEL_FORCE_FLUSH_TIMEOUT_MS = 1000;
+/**
+ * First hosted OTLP POST may include a cold TLS handshake to Datadog.
+ * Bound separately from {@link OTEL_FORCE_FLUSH_TIMEOUT_MS} so the
+ * queued turn/tool batch is not abandoned after 1s.
+ */
+export const OTEL_DEFERRED_EXPORT_TIMEOUT_MS = 5000;
+/** Drop oldest finished spans when no collector has drained the buffer. */
+export const OTEL_IN_MEMORY_SPAN_LIMIT = 2048;
+export function createOtelRuntime(config, log, options) {
     var _a;
     if (!config.enabled) {
         return undefined;
     }
+    if (config.traces !== false) {
+        installOutboundFetchInstrumentation();
+    }
     const proto = (_a = process.env.OTEL_EXPORTER_OTLP_PROTOCOL) === null || _a === void 0 ? void 0 : _a.trim().toLowerCase();
     if (proto === "grpc") {
         log("[agent-sdk:otel] OTEL_EXPORTER_OTLP_PROTOCOL=grpc is unsupported; using http/protobuf");
     }
-    const sdk = startOtelSdk(config, log);
+    ensureW3cPropagator();
+    const sdk = startOtelSdk(config, log, options === null || options === void 0 ? void 0 : options.resolveExport);
     const meter = config.metrics === false
         ? undefined
         : metrics.getMeterProvider().getMeter(INSTRUMENTATION);
@@ -53,15 +75,39 @@ export function createOtelRuntime(config, log) {
                 description: "HTTP request duration",
                 unit: "ms",
             }),
+        forceFlush: sdk.forceFlush,
         shutdown: sdk.shutdown,
     };
 }
+export function forceFlushOtelRuntime(runtime) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield runtime === null || runtime === void 0 ? void 0 : runtime.forceFlush();
+    });
+}
 export function shutdownOtelRuntime(runtime) {
     return __awaiter(this, void 0, void 0, function* () {
         yield runtime === null || runtime === void 0 ? void 0 : runtime.shutdown();
     });
 }
-function startOtelSdk(config, logger) {
+export function raceOtelForceFlush(work_1, log_1) {
+    return __awaiter(this, arguments, void 0, function* (work, log, timeoutMs = OTEL_FORCE_FLUSH_TIMEOUT_MS) {
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => resolve("timeout"), timeoutMs);
+        });
+        const result = yield Promise.race([
+            work.then(() => "done").catch(() => "done"),
+            timeout,
+        ]);
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        if (result === "timeout") {
+            log(`[agent-sdk:otel] forceFlush exceeded ${timeoutMs}ms; continuing`);
+        }
+    });
+}
+function startOtelSdk(config, logger, resolveExport) {
     var _a, _b;
     diag.setLogger({
         verbose: (m) => logger(`[agent-sdk:otel] ${m}`),
@@ -74,23 +120,32 @@ function startOtelSdk(config, logger) {
     let tracerProvider;
     let meterProvider;
     let loggerProvider;
+    let memoryExporter;
     const traceOpts = config.traces;
     if (traceOpts !== false) {
         const exporters = exportersForSignal(config.exporters, "traces");
-        if (exporters.length > 0) {
-            if (hasRealTracerProvider()) {
-                logger("[agent-sdk:otel] TracerProvider already registered; reusing global (Agent SDK OTLP exporters not attached)");
+        if (hasRealTracerProvider()) {
+            logger("[agent-sdk:otel] TracerProvider already registered; reusing global (Agent SDK OTLP exporters not attached)");
+        }
+        else {
+            const spanProcessors = [];
+            if (exporters.length > 0) {
+                for (const exporter of exporters) {
+                    spanProcessors.push(new BatchSpanProcessor(createTraceExporter(exporter, signalUrl(exporter.url, "traces"))));
+                }
             }
             else {
-                tracerProvider = new NodeTracerProvider({
-                    resource,
-                    spanProcessors: exporters.map((exporter) => new BatchSpanProcessor(createTraceExporter(exporter, signalUrl(exporter.url, "traces")))),
-                    sampler: new ParentBasedSampler({
-                        root: new TraceIdRatioBasedSampler((_a = traceOpts.sampleRatio) !== null && _a !== void 0 ? _a : 1),
-                    }),
-                });
-                tracerProvider.register();
+                memoryExporter = new BoundedMemorySpanExporter(OTEL_IN_MEMORY_SPAN_LIMIT);
+                spanProcessors.push(new SimpleSpanProcessor(memoryExporter));
             }
+            tracerProvider = new NodeTracerProvider({
+                resource,
+                spanProcessors,
+                sampler: new ParentBasedSampler({
+                    root: new TraceIdRatioBasedSampler((_a = traceOpts.sampleRatio) !== null && _a !== void 0 ? _a : 1),
+                }),
+            });
+            tracerProvider.register();
         }
     }
     const metricOpts = config.metrics;
@@ -131,9 +186,47 @@ function startOtelSdk(config, logger) {
             }
         }
     }
-    logger(`[agent-sdk] otel enabled service=${config.serviceName} exporters=${config.exporters.length} traces=${config.traces !== false} metrics=${config.metrics !== false} logs=${config.logs !== false}`);
+    if (memoryExporter === undefined) {
+        logger(`[agent-sdk] otel enabled service=${config.serviceName} exporters=${config.exporters.length} traces=${config.traces !== false} metrics=${config.metrics !== false} logs=${config.logs !== false}`);
+    }
+    else {
+        logger(`[agent-sdk] otel recording service=${config.serviceName} (export on flush when OTLP exporters resolve)`);
+    }
+    const flushDeferred = () => __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (memoryExporter === undefined) {
+            return;
+        }
+        const spans = memoryExporter.getFinishedSpans();
+        if (spans.length === 0) {
+            return;
+        }
+        const exportConfig = (_a = resolveExport === null || resolveExport === void 0 ? void 0 : resolveExport()) !== null && _a !== void 0 ? _a : config;
+        const destinations = exportersForSignal(exportConfig.exporters, "traces");
+        if (destinations.length === 0) {
+            return;
+        }
+        // Spans already carry the bake-time Resource. Hosted v2 binds
+        // deployment secrets after bake, so env / service extras on
+        // exportConfig must replace that Resource on the wire.
+        const ok = yield exportQueuedSpans(spans, destinations, logger, buildResource(exportConfig));
+        if (ok) {
+            memoryExporter.reset();
+        }
+    });
     return {
+        forceFlush: () => __awaiter(this, void 0, void 0, function* () {
+            yield Promise.allSettled([
+                raceOtelForceFlush(Promise.allSettled([
+                    tracerProvider === null || tracerProvider === void 0 ? void 0 : tracerProvider.forceFlush(),
+                    meterProvider === null || meterProvider === void 0 ? void 0 : meterProvider.forceFlush(),
+                    loggerProvider === null || loggerProvider === void 0 ? void 0 : loggerProvider.forceFlush(),
+                ]), logger),
+                raceOtelForceFlush(flushDeferred(), logger, OTEL_DEFERRED_EXPORT_TIMEOUT_MS),
+            ]);
+        }),
         shutdown: () => __awaiter(this, void 0, void 0, function* () {
+            yield flushDeferred();
             yield Promise.allSettled([
                 tracerProvider === null || tracerProvider === void 0 ? void 0 : tracerProvider.shutdown(),
                 meterProvider === null || meterProvider === void 0 ? void 0 : meterProvider.shutdown(),
@@ -142,6 +235,37 @@ function startOtelSdk(config, logger) {
         }),
     };
 }
+function withExportResource(span, resource) {
+    return new Proxy(span, {
+        get(target, prop, receiver) {
+            if (prop === "resource") {
+                return resource;
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+}
+function exportQueuedSpans(spans, destinations, logger, resource) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const payload = spans.map((span) => withExportResource(span, resource));
+        const exporters = destinations.map((destination) => createTraceExporter(destination, signalUrl(destination.url, "traces")));
+        try {
+            const results = yield Promise.all(exporters.map((exporter) => new Promise((resolve) => {
+                exporter.export(payload, (result) => {
+                    resolve(result.code === ExportResultCode.SUCCESS);
+                });
+            })));
+            return results.every((ok) => ok);
+        }
+        catch (error) {
+            logger(`[agent-sdk:otel] deferred export failed: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+        finally {
+            yield Promise.allSettled(exporters.map((exporter) => exporter.shutdown()));
+        }
+    });
+}
 function buildResource(config) {
     // Align with Cursor enterprise wire resource attrs where they overlap so
     // Agent SDK traces join org metrics/logs in the same collector.
@@ -186,3 +310,30 @@ function createLogExporter(exporter, url) {
         ? new OTLPLogExporterProto(opts)
         : new OTLPLogExporterHttp(opts);
 }
+/** In-memory finished-span queue with a hard cap (oldest dropped). */
+class BoundedMemorySpanExporter {
+    constructor(limit) {
+        this.limit = limit;
+        this.spans = [];
+    }
+    export(spans, resultCallback) {
+        this.spans.push(...spans);
+        if (this.spans.length > this.limit) {
+            this.spans.splice(0, this.spans.length - this.limit);
+        }
+        resultCallback({ code: ExportResultCode.SUCCESS });
+    }
+    getFinishedSpans() {
+        return this.spans.slice();
+    }
+    reset() {
+        this.spans = [];
+    }
+    shutdown() {
+        this.reset();
+        return Promise.resolve();
+    }
+    forceFlush() {
+        return Promise.resolve();
+    }
+}

package/dist/internal/package-inline-stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-inline-stdio.d.ts","sourceRoot":"","sources":["../../src/internal/package-inline-stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAE5B,MAAM,aAAa,CAAC;AAmCrB,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsE/B"}
+{"version":3,"file":"package-inline-stdio.d.ts","sourceRoot":"","sources":["../../src/internal/package-inline-stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAE5B,MAAM,aAAa,CAAC;AA6BrB,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmE/B"}

package/dist/internal/package-inline-stdio.js

@@ -18,11 +18,6 @@ import { fileURLToPath } from "node:url";
 import * as esbuild from "esbuild";
 import { toolInputJsonSchema, toolOutputJsonSchema } from "./json-schema.js";
 const require = createRequire(import.meta.url);
-const CONNECTION_SPECIFIERS = new Set([
-    "@anysphere/agent-serve/connections",
-    "@cursor/july/connections",
-    "@cursor/agentkit/connections",
-]);
 function sibling(basename) {
     const dir = fileURLToPath(new URL(".", import.meta.url));
     const ts = join(dir, `${basename}.ts`);
@@ -82,12 +77,9 @@ serveInlineStdioMcp(
                 {
                     name: "inline-stdio-connection-stub",
                     setup(build) {
-                        build.onResolve({ filter: /.*/ }, (args) => {
-                            if (CONNECTION_SPECIFIERS.has(args.path)) {
-                                return { path: stubPath };
-                            }
-                            return undefined;
-                        });
+                        build.onResolve({ filter: /^@cursor\/july\/connections$/ }, () => ({
+                            path: stubPath,
+                        }));
                     },
                 },
             ],

package/dist/internal/playground/toolchain.d.ts

@@ -6,7 +6,7 @@
  * checkout, `serve` uses this to auto-build a missing bundle and (with `--dev`)
  * spawn the Vite HMR server.
  */
-/** `@anysphere/agent-serve` package root (works from `src/` or `dist/`). */
+/** Package root (works from `src/` or `dist/`). */
 export declare function packageRoot(): string;
 export interface PlaygroundToolchain {
     packageRoot: string;

package/dist/internal/playground/toolchain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolchain.d.ts","sourceRoot":"","sources":["../../../src/internal/playground/toolchain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,4EAA4E;AAC5E,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmCD,0EAA0E;AAC1E,wBAAgB,0BAA0B,IAAI,mBAAmB,GAAG,SAAS,CAW5E;AAED,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACtC,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAUpB;AAED,oEAAoE;AACpE,wBAAsB,kBAAkB,CACtC,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAC3C,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAC3C,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,mBAAmB,GAAG,SAAS,CA8ElC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C"}
+{"version":3,"file":"toolchain.d.ts","sourceRoot":"","sources":["../../../src/internal/playground/toolchain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,mDAAmD;AACnD,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmCD,0EAA0E;AAC1E,wBAAgB,0BAA0B,IAAI,mBAAmB,GAAG,SAAS,CAW5E;AAED,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACtC,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAUpB;AAED,oEAAoE;AACpE,wBAAsB,kBAAkB,CACtC,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAC3C,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAC3C,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,mBAAmB,GAAG,SAAS,CA8ElC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C"}

package/dist/internal/playground/toolchain.js

@@ -22,7 +22,7 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { playgroundBundleExists } from "./static.js";
 const VITE_CONFIG = "playground/vite.config.ts";
-/** `@anysphere/agent-serve` package root (works from `src/` or `dist/`). */
+/** Package root (works from `src/` or `dist/`). */
 export function packageRoot() {
     // src|dist/internal/playground/toolchain.ts → packages/agent-serve/
     return fileURLToPath(new URL("../../..", import.meta.url));

package/dist/internal/request-error-status.d.ts

@@ -0,0 +1,12 @@
+export interface MappedRequestError {
+    status: 400 | 403 | 409 | 503;
+    code: string;
+    message: string;
+}
+/**
+ * Expected throw → HTTP mapping used by `handleRequest` and hosted flush.
+ * Undefined means a real 500 (caller logs and redacts).
+ */
+export declare function mapThrownRequestError(error: unknown): MappedRequestError | undefined;
+export declare function statusForThrownRequestError(error: unknown): number;
+//# sourceMappingURL=request-error-status.d.ts.map

package/dist/internal/request-error-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-error-status.d.ts","sourceRoot":"","sources":["../../src/internal/request-error-status.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,kBAAkB,GAAG,SAAS,CA4ChC;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElE"}

package/dist/internal/request-error-status.js

@@ -0,0 +1,52 @@
+import { InvalidAsOfError, VacuousTimeArgsError } from "./as-of.js";
+import { V2EngineError } from "./continuation-identity.js";
+import { GUEST_CONNECT_STALLED, GUEST_NETWORK_UNAVAILABLE, GuestNetworkUnavailableError, hasGuestNetworkErrno, isQuietGuestConnectStall, } from "./guest-network.js";
+import { SessionAuthError, SessionBusyError } from "./session-engine.js";
+/**
+ * Expected throw → HTTP mapping used by `handleRequest` and hosted flush.
+ * Undefined means a real 500 (caller logs and redacts).
+ */
+export function mapThrownRequestError(error) {
+    if (error instanceof SessionBusyError) {
+        return { status: 409, code: "session_busy", message: error.message };
+    }
+    if (error instanceof V2EngineError) {
+        return {
+            status: 409,
+            code: "v2_identity_conflict",
+            message: "Control-plane session identity conflicts with existing state.",
+        };
+    }
+    if (error instanceof SessionAuthError) {
+        return { status: 403, code: "forbidden", message: error.message };
+    }
+    if (error instanceof InvalidAsOfError ||
+        error instanceof VacuousTimeArgsError) {
+        return { status: 400, code: "invalid_request", message: error.message };
+    }
+    if (error instanceof GuestNetworkUnavailableError ||
+        hasGuestNetworkErrno(error)) {
+        return {
+            status: 503,
+            code: GUEST_NETWORK_UNAVAILABLE,
+            message: error instanceof Error
+                ? error.message
+                : "Guest network is not ready for outbound requests.",
+        };
+    }
+    if (isQuietGuestConnectStall(error)) {
+        return {
+            status: 503,
+            code: GUEST_CONNECT_STALLED,
+            message: error instanceof Error
+                ? error.message
+                : "Guest Connect stalled without a network errno.",
+        };
+    }
+    return undefined;
+}
+export function statusForThrownRequestError(error) {
+    var _a;
+    var _b;
+    return (_b = (_a = mapThrownRequestError(error)) === null || _a === void 0 ? void 0 : _a.status) !== null && _b !== void 0 ? _b : 500;
+}

package/dist/internal/resolve-prod-target.d.ts

@@ -1,5 +1,5 @@
 /**
- * Resolve a hosted (managed) agent-serve deployment into a base URL +
+ * Resolve a hosted (managed) agent-sdk deployment into a base URL +
  * request headers for chat/run/call/eval `--prod`.
  *
  * Uses short-lived `engineAccess` from the deployment status route

package/dist/internal/resolve-prod-target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-prod-target.d.ts","sourceRoot":"","sources":["../../src/internal/resolve-prod-target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGrE,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,gDAAgD;IAChD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAGtC,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;IAFxD,YACE,OAAO,EAAE,MAAM,EACN,OAAO,GAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAiB,EAItE;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA0F7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,wBAAwB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,OAAO,CAAC,2BAA2B,CAAC,CAyDtC;AAiBD,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAgBT"}
+{"version":3,"file":"resolve-prod-target.d.ts","sourceRoot":"","sources":["../../src/internal/resolve-prod-target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGrE,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,gDAAgD;IAChD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAGtC,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;IAFxD,YACE,OAAO,EAAE,MAAM,EACN,OAAO,GAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAiB,EAItE;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA0F7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,wBAAwB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,OAAO,CAAC,2BAA2B,CAAC,CAyDtC;AAWD,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAgBT"}

package/dist/internal/resolve-prod-target.js

@@ -1,5 +1,5 @@
 /**
- * Resolve a hosted (managed) agent-serve deployment into a base URL +
+ * Resolve a hosted (managed) agent-sdk deployment into a base URL +
  * request headers for chat/run/call/eval `--prod`.
  *
  * Uses short-lived `engineAccess` from the deployment status route
@@ -19,6 +19,7 @@ import { basename, resolve } from "node:path";
 import { resolveDeployAuth } from "./cli-deploy.js";
 import { DeployApiError, slugFromDirectoryName, validateDeploymentSlug, } from "./deploy-client.js";
 import { CLI_COMMAND_NAME as CLI } from "./distribution.js";
+import { sleep as defaultSleep } from "./sleep.js";
 import { stderrPalette } from "./terminal-style.js";
 /**
  * Interactive CLI keep-alive for hosted engines. Without these, a hibernated
@@ -70,7 +71,7 @@ export function resolveProdTarget(options) {
         // A hibernated engine can briefly omit engineAccess while getPod fails
         // during wake. Retry a few times before surfacing "not reachable yet".
         const maxReachabilityAttempts = 5;
-        const sleep = (_b = options.sleep) !== null && _b !== void 0 ? _b : sleepMs;
+        const sleep = (_b = options.sleep) !== null && _b !== void 0 ? _b : defaultSleep;
         let detail;
         for (let attempt = 0; attempt < maxReachabilityAttempts; attempt++) {
             try {
@@ -182,11 +183,6 @@ function sanitizeCustomerFacingDetail(message) {
         .replace(/\banyrun\b/gi, "runtime")
         .replace(/\bcursorvm\.com\b/gi, "host");
 }
-function sleepMs(ms) {
-    return new Promise((resolve) => {
-        setTimeout(resolve, ms);
-    });
-}
 /** Resolve the deployment slug the same way `deploy` does for a single dir. */
 export function resolveProdSlug(options) {
     var _a;

package/dist/internal/result-output.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Run the authored `defineResult` commit on the final assistant text.
+ */
+import type { ResultContext, ResultDefinition } from "../types.js";
+export type ResultParse = {
+    ok: true;
+    text: string;
+} | {
+    ok: false;
+    message: string;
+};
+export declare function applyAuthoredResult(args: {
+    definition: ResultDefinition;
+    text: string | undefined;
+    dryRun: boolean;
+    ctx: Omit<ResultContext, "text">;
+}): Promise<ResultParse>;
+//# sourceMappingURL=result-output.d.ts.map

package/dist/internal/result-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-output.d.ts","sourceRoot":"","sources":["../../src/internal/result-output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,UAAU,EAAE,gBAAgB,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,OAAO,CAAC,WAAW,CAAC,CAkBvB"}

package/dist/internal/result-output.js

@@ -0,0 +1,33 @@
+/**
+ * Run the authored `defineResult` commit on the final assistant text.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export function applyAuthoredResult(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (args.text === undefined || args.text.trim() === "") {
+            return { ok: false, message: "turn produced no assistant text" };
+        }
+        const text = args.text;
+        if (args.dryRun) {
+            return { ok: true, text };
+        }
+        try {
+            yield args.definition.commit(Object.assign(Object.assign({}, args.ctx), { text }));
+        }
+        catch (error) {
+            return {
+                ok: false,
+                message: error instanceof Error ? error.message : `on commit: ${String(error)}`,
+            };
+        }
+        return { ok: true, text };
+    });
+}

package/dist/internal/run-client.d.ts

@@ -1,7 +1,7 @@
 /**
- * Programmatic HTTP client for agent-serve sessions.
+ * Programmatic HTTP client for agent-sdk sessions.
  *
- * Used by `agent-serve run` and `chat --json`: create/follow a
+ * Used by `agent-sdk run` and `chat --json`: create/follow a
  * session, collect the NDJSON stream until the turn parks, and return a
  * compact {@link Trajectory} plus the continuation token for follow-ups.
  */

package/dist/internal/run-client.js

@@ -1,7 +1,7 @@
 /**
- * Programmatic HTTP client for agent-serve sessions.
+ * Programmatic HTTP client for agent-sdk sessions.
  *
- * Used by `agent-serve run` and `chat --json`: create/follow a
+ * Used by `agent-sdk run` and `chat --json`: create/follow a
  * session, collect the NDJSON stream until the turn parks, and return a
  * compact {@link Trajectory} plus the continuation token for follow-ups.
  */