effect 4.0.0-beta.70 → 4.0.0-beta.71

package/dist/unstable/cluster/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["ClusterCron","ClusterError","ClusterMetrics","ClusterSchema","ClusterWorkflowEngine","DeliverAt","Entity","EntityAddress","EntityId","EntityProxy","EntityProxyServer","EntityResource","EntityType","Envelope","HttpRunner","K8sHttpClient","MachineId","Message","MessageStorage","Reply","Runner","RunnerAddress","RunnerHealth","Runners","RunnerServer","RunnerStorage","ShardId","Sharding","ShardingConfig","ShardingRegistrationEvent","SingleRunner","Singleton","SingletonAddress","Snowflake","SocketRunner","SqlMessageStorage","SqlRunnerStorage","TestRunner"],"sources":["../../../src/unstable/cluster/index.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"index.js","names":["ClusterCron","ClusterError","ClusterMetrics","ClusterSchema","ClusterWorkflowEngine","DeliverAt","Entity","EntityAddress","EntityId","EntityProxy","EntityProxyServer","EntityResource","EntityType","Envelope","HttpRunner","K8sHttpClient","MachineId","Message","MessageStorage","Reply","Runner","RunnerAddress","RunnerHealth","Runners","RunnerServer","RunnerStorage","ShardId","Sharding","ShardingConfig","ShardingRegistrationEvent","SingleRunner","Singleton","SingletonAddress","Snowflake","SocketRunner","SqlMessageStorage","SqlRunnerStorage","TestRunner"],"sources":["../../../src/unstable/cluster/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;AAGA,OAAO,KAAKA,WAAW,MAAM,kBAAkB;AAE/C;;;AAGA,OAAO,KAAKC,YAAY,MAAM,mBAAmB;AAEjD;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;AAGA,OAAO,KAAKC,aAAa,MAAM,oBAAoB;AAEnD;;;AAGA,OAAO,KAAKC,qBAAqB,MAAM,4BAA4B;AAEnE;;;AAGA,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C;;;AAGA,OAAO,KAAKC,MAAM,MAAM,aAAa;AAErC;;;AAGA,OAAO,KAAKC,aAAa,MAAM,oBAAoB;AAEnD;;;AAGA,OAAO,KAAKC,QAAQ,MAAM,eAAe;AAEzC;;;AAGA,OAAO,KAAKC,WAAW,MAAM,kBAAkB;AAE/C;;;AAGA,OAAO,KAAKC,iBAAiB,MAAM,wBAAwB;AAE3D;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;AAGA,OAAO,KAAKC,UAAU,MAAM,iBAAiB;AAE7C;;;AAGA,OAAO,KAAKC,QAAQ,MAAM,eAAe;AAEzC;;;AAGA,OAAO,KAAKC,UAAU,MAAM,iBAAiB;AAE7C;;;AAGA,OAAO,KAAKC,aAAa,MAAM,oBAAoB;AAEnD;;;AAGA,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C;;;AAGA,OAAO,KAAKC,OAAO,MAAM,cAAc;AAEvC;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;AAGA,OAAO,KAAKC,KAAK,MAAM,YAAY;AAEnC;;;AAGA,OAAO,KAAKC,MAAM,MAAM,aAAa;AAErC;;;AAGA,OAAO,KAAKC,aAAa,MAAM,oBAAoB;AAEnD;;;AAGA,OAAO,KAAKC,YAAY,MAAM,mBAAmB;AAEjD;;;AAGA,OAAO,KAAKC,OAAO,MAAM,cAAc;AAEvC;;;AAGA,OAAO,KAAKC,YAAY,MAAM,mBAAmB;AAEjD;;;AAGA,OAAO,KAAKC,aAAa,MAAM,oBAAoB;AAEnD;;;AAGA,OAAO,KAAKC,OAAO,MAAM,cAAc;AAEvC;;;AAGA,OAAO,KAAKC,QAAQ,MAAM,eAAe;AAEzC;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;AAGA,OAAO,KAAKC,yBAAyB,MAAM,gCAAgC;AAE3E;;;AAGA,OAAO,KAAKC,YAAY,MAAM,mBAAmB;AAEjD;;;AAGA,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C;;;AAGA,OAAO,KAAKC,gBAAgB,MAAM,uBAAuB;AAEzD;;;AAGA,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C;;;AAGA,OAAO,KAAKC,YAAY,MAAM,mBAAmB;AAEjD;;;AAGA,OAAO,KAAKC,iBAAiB,MAAM,wBAAwB;AAE3D;;;AAGA,OAAO,KAAKC,gBAAgB,MAAM,uBAAuB;AAEzD;;;AAGA,OAAO,KAAKC,UAAU,MAAM,iBAAiB","ignoreList":[]}

package/dist/unstable/devtools/DevTools.d.ts

@@ -1,18 +1,28 @@
 /**
- * Utilities for wiring an Effect application to the Effect devtools runtime
+ * High-level layers for connecting an Effect runtime to the unstable devtools
  * tracer.
  *
- * This module is the high-level entry point for installing the devtools tracer
- * as a `Layer`. Use it when an application should stream spans, span events,
- * span completions, and metrics snapshots to a devtools process for local
- * inspection. The default `layer` and `layerWebSocket` helpers connect over a
- * WebSocket to `ws://localhost:34437`, while `layerSocket` lets integrations
- * provide their own `Socket` transport.
+ * `DevTools` is the application-facing entry point for installing a tracer that
+ * mirrors the current tracer and streams spans, span events, span completions,
+ * and metric snapshots to an external devtools process. Lower-level socket
+ * protocol details live in `DevToolsClient`.
  *
- * These layers install tracing for the scoped runtime they are provided to;
- * they do not start a devtools server, and a compatible devtools endpoint must
- * be reachable separately. Because this API lives under `unstable`, its
- * protocol and surface may change between releases.
+ * **Common tasks**
+ *
+ * - Use {@link layer} when the runtime provides a global `WebSocket`
+ * - Use {@link layerWebSocket} when the environment should provide the
+ *   `WebSocketConstructor`
+ * - Use {@link layerSocket} when an integration already has a `Socket`
+ *   transport
+ *
+ * **Gotchas**
+ *
+ * - The WebSocket helpers default to `ws://localhost:34437`.
+ * - These layers install only the client-side tracer; start or connect the
+ *   devtools server separately.
+ * - The tracer is scoped to the runtime or layer graph that receives the layer.
+ * - This module is under `unstable`, so the transport protocol and exports may
+ *   change between releases.
  *
  * @since 4.0.0
  */
@@ -37,6 +47,26 @@ export declare const layerWebSocket: (url?: string) => Layer.Layer<never, never,
  * Layer that installs the devtools tracer over a WebSocket connection using the
  * global WebSocket constructor, defaulting to `ws://localhost:34437`.
  *
+ * **When to use**
+ *
+ * Use to stream Effect tracing and metrics telemetry to a devtools process when
+ * the runtime environment already provides a global `WebSocket` constructor.
+ *
+ * **Details**
+ *
+ * This is a convenience wrapper around `layerWebSocket(url)` that provides
+ * `Socket.layerWebSocketConstructorGlobal`, so the resulting layer has no
+ * remaining requirements.
+ *
+ * **Gotchas**
+ *
+ * This layer only installs the client-side tracer; it does not start a devtools
+ * server, so the configured WebSocket endpoint must already be reachable. It
+ * relies on `globalThis.WebSocket` being available in the runtime.
+ *
+ * @see {@link layerWebSocket} for installing the devtools tracer with an explicit `WebSocketConstructor` requirement
+ * @see {@link layerSocket} for installing the devtools tracer over an existing `Socket` transport
+ *
  * @category layers
  * @since 4.0.0
  */

package/dist/unstable/devtools/DevTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DevTools.d.ts","sourceRoot":"","sources":["../../../src/unstable/devtools/DevTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAA;AAG7C;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAA8B,CAAA;AAE/F;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,YAA4B,KAC3B,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,oBAAoB,CAGrD,CAAA;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,YAA4B,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAGnE,CAAA"}
+{"version":3,"file":"DevTools.d.ts","sourceRoot":"","sources":["../../../src/unstable/devtools/DevTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAA;AAG7C;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAA8B,CAAA;AAE/F;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,YAA4B,KAC3B,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,oBAAoB,CAGrD,CAAA;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,KAAK,GAAI,YAA4B,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAGnE,CAAA"}

package/dist/unstable/devtools/DevTools.js

@@ -1,18 +1,28 @@
 /**
- * Utilities for wiring an Effect application to the Effect devtools runtime
+ * High-level layers for connecting an Effect runtime to the unstable devtools
  * tracer.
  *
- * This module is the high-level entry point for installing the devtools tracer
- * as a `Layer`. Use it when an application should stream spans, span events,
- * span completions, and metrics snapshots to a devtools process for local
- * inspection. The default `layer` and `layerWebSocket` helpers connect over a
- * WebSocket to `ws://localhost:34437`, while `layerSocket` lets integrations
- * provide their own `Socket` transport.
+ * `DevTools` is the application-facing entry point for installing a tracer that
+ * mirrors the current tracer and streams spans, span events, span completions,
+ * and metric snapshots to an external devtools process. Lower-level socket
+ * protocol details live in `DevToolsClient`.
  *
- * These layers install tracing for the scoped runtime they are provided to;
- * they do not start a devtools server, and a compatible devtools endpoint must
- * be reachable separately. Because this API lives under `unstable`, its
- * protocol and surface may change between releases.
+ * **Common tasks**
+ *
+ * - Use {@link layer} when the runtime provides a global `WebSocket`
+ * - Use {@link layerWebSocket} when the environment should provide the
+ *   `WebSocketConstructor`
+ * - Use {@link layerSocket} when an integration already has a `Socket`
+ *   transport
+ *
+ * **Gotchas**
+ *
+ * - The WebSocket helpers default to `ws://localhost:34437`.
+ * - These layers install only the client-side tracer; start or connect the
+ *   devtools server separately.
+ * - The tracer is scoped to the runtime or layer graph that receives the layer.
+ * - This module is under `unstable`, so the transport protocol and exports may
+ *   change between releases.
  *
  * @since 4.0.0
  */
@@ -38,6 +48,26 @@ export const layerWebSocket = (url = "ws://localhost:34437") => DevToolsClient.l
  * Layer that installs the devtools tracer over a WebSocket connection using the
  * global WebSocket constructor, defaulting to `ws://localhost:34437`.
  *
+ * **When to use**
+ *
+ * Use to stream Effect tracing and metrics telemetry to a devtools process when
+ * the runtime environment already provides a global `WebSocket` constructor.
+ *
+ * **Details**
+ *
+ * This is a convenience wrapper around `layerWebSocket(url)` that provides
+ * `Socket.layerWebSocketConstructorGlobal`, so the resulting layer has no
+ * remaining requirements.
+ *
+ * **Gotchas**
+ *
+ * This layer only installs the client-side tracer; it does not start a devtools
+ * server, so the configured WebSocket endpoint must already be reachable. It
+ * relies on `globalThis.WebSocket` being available in the runtime.
+ *
+ * @see {@link layerWebSocket} for installing the devtools tracer with an explicit `WebSocketConstructor` requirement
+ * @see {@link layerSocket} for installing the devtools tracer over an existing `Socket` transport
+ *
  * @category layers
  * @since 4.0.0
  */

package/dist/unstable/devtools/DevTools.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevTools.js","names":["Layer","Socket","DevToolsClient","layerSocket","layerTracer","layerWebSocket","url","pipe","provide","layer","layerWebSocketConstructorGlobal"],"sources":["../../../src/unstable/devtools/DevTools.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;AAkBA,OAAO,KAAKA,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,qBAAqB;AAC7C,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;;;;AAMA,OAAO,MAAMC,WAAW,GAA6CD,cAAc,CAACE,WAAW;AAE/F;;;;;;;AAOA,OAAO,MAAMC,cAAc,GAAGA,CAC5BC,GAAG,GAAG,sBAAsB,KAE5BJ,cAAc,CAACE,WAAW,CAACG,IAAI,CAC7BP,KAAK,CAACQ,OAAO,CAACP,MAAM,CAACI,cAAc,CAACC,GAAG,CAAC,CAAC,CAC1C;AAEH;;;;;;;AAOA,OAAO,MAAMG,KAAK,GAAGA,CAACH,GAAG,GAAG,sBAAsB,KAChDD,cAAc,CAACC,GAAG,CAAC,CAACC,IAAI,CACtBP,KAAK,CAACQ,OAAO,CAACP,MAAM,CAACS,+BAA+B,CAAC,CACtD","ignoreList":[]}
+{"version":3,"file":"DevTools.js","names":["Layer","Socket","DevToolsClient","layerSocket","layerTracer","layerWebSocket","url","pipe","provide","layer","layerWebSocketConstructorGlobal"],"sources":["../../../src/unstable/devtools/DevTools.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,OAAO,KAAKA,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,qBAAqB;AAC7C,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;;;;AAMA,OAAO,MAAMC,WAAW,GAA6CD,cAAc,CAACE,WAAW;AAE/F;;;;;;;AAOA,OAAO,MAAMC,cAAc,GAAGA,CAC5BC,GAAG,GAAG,sBAAsB,KAE5BJ,cAAc,CAACE,WAAW,CAACG,IAAI,CAC7BP,KAAK,CAACQ,OAAO,CAACP,MAAM,CAACI,cAAc,CAACC,GAAG,CAAC,CAAC,CAC1C;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,OAAO,MAAMG,KAAK,GAAGA,CAACH,GAAG,GAAG,sBAAsB,KAChDD,cAAc,CAACC,GAAG,CAAC,CAACC,IAAI,CACtBP,KAAK,CAACQ,OAAO,CAACP,MAAM,CAACS,+BAA+B,CAAC,CACtD","ignoreList":[]}

package/dist/unstable/devtools/DevToolsClient.d.ts

@@ -22,6 +22,24 @@ export declare class DevToolsClient extends DevToolsClient_base {
  * NDJSON protocol, sending periodic pings, and responding to metrics snapshot
  * requests.
  *
+ * **When to use**
+ *
+ * Use when you already have a `Socket` and need the low-level `DevToolsClient`
+ * service to exchange devtools telemetry directly.
+ *
+ * **Details**
+ *
+ * The effect requires `Scope` because it starts background fibers for the socket
+ * stream and heartbeat.
+ *
+ * **Gotchas**
+ *
+ * `make` creates only the client service; tracing is installed separately.
+ *
+ * @see {@link layer} for providing the client as a layer
+ * @see {@link makeTracer} for creating a tracer after a `DevToolsClient` is available
+ * @see {@link layerTracer} for creating the client from the current `Socket` and installing the tracer as a layer
+ *
  * @category constructors
  * @since 4.0.0
  */
@@ -29,6 +47,26 @@ export declare const make: Effect.Effect<DevToolsClient["Service"], never, Scope
 /**
  * Layer that provides `DevToolsClient` using the current `Socket`.
  *
+ * **When to use**
+ *
+ * Use to provide the low-level `DevToolsClient` service over an existing
+ * `Socket` for custom devtools integrations that send telemetry through the
+ * client directly.
+ *
+ * **Details**
+ *
+ * It delegates to `make`, so it speaks the devtools NDJSON protocol over the
+ * provided `Socket`, sends periodic pings, responds to metrics snapshot
+ * requests, and finalizes its background fibers when the layer scope closes.
+ *
+ * **Gotchas**
+ *
+ * This layer only provides the client. It does not install the devtools tracer
+ * by itself.
+ *
+ * @see {@link make} for constructing the client as a scoped effect instead of a layer
+ * @see {@link layerTracer} for a higher-level layer that creates the client and installs the devtools tracer
+ *
  * @category layers
  * @since 4.0.0
  */

package/dist/unstable/devtools/DevToolsClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DevToolsClient.d.ts","sourceRoot":"","sources":["../../../src/unstable/devtools/DevToolsClient.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAE3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAIvC,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAE5C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAA;AAC7C,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;;yBAe5B,CACnB,CAAC,EAAE,cAAc,CAAC,IAAI,GAAG,cAAc,CAAC,SAAS,KAC9C,IAAI;;AAZb;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,mBAOC;CAAG;AAuExC;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,CAC9B,cAAc,CAAC,SAAS,CAAC,EACzB,KAAK,EACL,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAM5B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAsC,CAAA;AAmC1G;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,CAK1E,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAEhE,CAAA"}
+{"version":3,"file":"DevToolsClient.d.ts","sourceRoot":"","sources":["../../../src/unstable/devtools/DevToolsClient.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAE3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAIvC,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAE5C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAA;AAC7C,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;;yBAe5B,CACnB,CAAC,EAAE,cAAc,CAAC,IAAI,GAAG,cAAc,CAAC,SAAS,KAC9C,IAAI;;AAZb;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,mBAOC;CAAG;AAuExC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,CAC9B,cAAc,CAAC,SAAS,CAAC,EACzB,KAAK,EACL,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAM5B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAsC,CAAA;AAmC1G;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,CAK1E,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAEhE,CAAA"}

package/dist/unstable/devtools/DevToolsClient.js

@@ -1,15 +1,34 @@
 /**
- * Provides the low-level client used by the unstable devtools integration to
- * exchange telemetry with an Effect devtools server over the current `Socket`.
- *
- * The client speaks the devtools NDJSON protocol, publishes span starts, span
- * events, span completions, and metric snapshots, and exposes layers for
- * installing a tracer that mirrors the current tracer while forwarding data to
- * devtools. Most applications should use the higher-level devtools layers
- * instead of constructing this service directly. When using this module
- * directly, provide a live `Socket`, keep the layer scoped so the background
- * ping and stream fibers are finalized, and prefer `layerTracer` when the goal
- * is to observe an application's Effect traces.
+ * Low-level devtools client and tracer wiring over the current `Socket`.
+ *
+ * `DevToolsClient` speaks the devtools NDJSON protocol used by the unstable
+ * devtools integration. It sends span starts, span events, span completions,
+ * ping messages, and metric snapshots through a socket, then exposes tracer
+ * layers that forward telemetry while preserving the current tracer's behavior.
+ *
+ * **Mental model**
+ *
+ * {@link make} creates the scoped client service over the provided `Socket`;
+ * {@link makeTracer} wraps the current tracer and sends each span update
+ * through that client; {@link layerTracer} combines both steps for integrations
+ * that already have a socket transport. The higher-level `DevTools` module
+ * provides WebSocket defaults for applications.
+ *
+ * **Common tasks**
+ *
+ * - Build the client service directly with {@link make} or {@link layer}
+ * - Install only the forwarding tracer with {@link makeTracer}
+ * - Create the client and tracer together with {@link layerTracer}
+ * - Send custom span or span-event messages through `DevToolsClient.sendUnsafe`
+ *
+ * **Gotchas**
+ *
+ * - The client is scoped because it starts background fibers for the socket
+ *   stream and heartbeat.
+ * - `sendUnsafe` enqueues telemetry without back pressure and should stay on
+ *   the tracer hot path.
+ * - This module does not create a socket transport; provide `Socket` yourself
+ *   or use the higher-level `DevTools` module.
  *
  * @since 4.0.0
  */
@@ -81,6 +100,24 @@ const toMetricsSnapshot = context => ({
  * NDJSON protocol, sending periodic pings, and responding to metrics snapshot
  * requests.
  *
+ * **When to use**
+ *
+ * Use when you already have a `Socket` and need the low-level `DevToolsClient`
+ * service to exchange devtools telemetry directly.
+ *
+ * **Details**
+ *
+ * The effect requires `Scope` because it starts background fibers for the socket
+ * stream and heartbeat.
+ *
+ * **Gotchas**
+ *
+ * `make` creates only the client service; tracing is installed separately.
+ *
+ * @see {@link layer} for providing the client as a layer
+ * @see {@link makeTracer} for creating a tracer after a `DevToolsClient` is available
+ * @see {@link layerTracer} for creating the client from the current `Socket` and installing the tracer as a layer
+ *
  * @category constructors
  * @since 4.0.0
  */
@@ -91,6 +128,26 @@ export const make = /*#__PURE__*/makeEffect.pipe(/*#__PURE__*/Effect.annotateLog
 /**
  * Layer that provides `DevToolsClient` using the current `Socket`.
  *
+ * **When to use**
+ *
+ * Use to provide the low-level `DevToolsClient` service over an existing
+ * `Socket` for custom devtools integrations that send telemetry through the
+ * client directly.
+ *
+ * **Details**
+ *
+ * It delegates to `make`, so it speaks the devtools NDJSON protocol over the
+ * provided `Socket`, sends periodic pings, responds to metrics snapshot
+ * requests, and finalizes its background fibers when the layer scope closes.
+ *
+ * **Gotchas**
+ *
+ * This layer only provides the client. It does not install the devtools tracer
+ * by itself.
+ *
+ * @see {@link make} for constructing the client as a scoped effect instead of a layer
+ * @see {@link layerTracer} for a higher-level layer that creates the client and installs the devtools tracer
+ *
  * @category layers
  * @since 4.0.0
  */

package/dist/unstable/devtools/DevToolsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevToolsClient.js","names":["Cause","Context","Deferred","Effect","Fiber","Layer","Metric","Queue","Schema","Stream","Tracer","Ndjson","Socket","DevToolsSchema","RequestSchema","toCodecJson","Request","ResponseSchema","Response","DevToolsClient","Service","makeEffect","gen","socket","services","context","requests","unbounded","connected","make","offerMetricsSnapshot","sync","offerUnsafe","toMetricsSnapshot","handleResponse","response","_tag","void","fiber","fromQueue","pipe","pipeThroughChannel","duplexSchemaString","toChannelString","inputSchema","outputSchema","onFirst","completeWith","runForEach","forkDetach","addFinalizer","andThen","flatMap","fiberId","id","failCause","interrupt","await","suspend","offer","delay","forever","forkScoped","timeoutOption","asVoid","of","sendUnsafe","request","metrics","snapshotUnsafe","annotateLogs","module","service","layer","effect","makeTracerEffect","client","currentTracer","tracer","span","options","oldEvent","event","name","startTime","attributes","traceId","spanId","call","oldEnd","end","endTime","exit","makeTracer","layerTracer","provide"],"sources":["../../../src/unstable/devtools/DevToolsClient.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"DevToolsClient.js","names":["Cause","Context","Deferred","Effect","Fiber","Layer","Metric","Queue","Schema","Stream","Tracer","Ndjson","Socket","DevToolsSchema","RequestSchema","toCodecJson","Request","ResponseSchema","Response","DevToolsClient","Service","makeEffect","gen","socket","services","context","requests","unbounded","connected","make","offerMetricsSnapshot","sync","offerUnsafe","toMetricsSnapshot","handleResponse","response","_tag","void","fiber","fromQueue","pipe","pipeThroughChannel","duplexSchemaString","toChannelString","inputSchema","outputSchema","onFirst","completeWith","runForEach","forkDetach","addFinalizer","andThen","flatMap","fiberId","id","failCause","interrupt","await","suspend","offer","delay","forever","forkScoped","timeoutOption","asVoid","of","sendUnsafe","request","metrics","snapshotUnsafe","annotateLogs","module","service","layer","effect","makeTracerEffect","client","currentTracer","tracer","span","options","oldEvent","event","name","startTime","attributes","traceId","spanId","call","oldEnd","end","endTime","exit","makeTracer","layerTracer","provide"],"sources":["../../../src/unstable/devtools/DevToolsClient.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/devtools/DevToolsSchema.d.ts.map

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

package/dist/unstable/devtools/DevToolsSchema.js

@@ -1,20 +1,28 @@
 /**
- * Schemas and TypeScript types for the Effect devtools protocol.
- *
- * This module defines the wire format used by devtools clients and servers to
- * exchange telemetry, including spans, span events, metric snapshots, fiber
- * dumps, heartbeat messages, and request/response payloads. Use these schemas
- * when encoding or decoding messages at the devtools boundary, validating
- * custom transports, or building integrations that need to inspect the same
- * protocol data as the built-in devtools implementation.
- *
- * The exported values describe serialized protocol payloads rather than the
- * full in-memory runtime data structures. Some fields intentionally normalize
- * runtime values for transport, for example ended span exits are encoded with
- * successful values erased via `Exit.asVoid`, timestamps are represented as
- * `bigint`s, and arbitrary attributes are accepted as unknown schema values.
- * The module lives under `unstable`, so consumers should treat the protocol
- * shape as experimental.
+ * Defines the experimental wire schema used by the Effect devtools protocol.
+ *
+ * The module contains the serialized message shapes exchanged between devtools
+ * clients and servers: span snapshots, span events, metric snapshots,
+ * heartbeats, and request/response unions. Use these schemas at protocol
+ * boundaries to encode, decode, or validate custom transports that need to
+ * interoperate with the built-in unstable devtools client and server.
+ *
+ * **Mental model**
+ *
+ * `Request` messages flow from the runtime-side devtools client to the server:
+ * `Ping`, `Span`, `SpanEvent`, and `MetricsSnapshot`. `Response` messages flow
+ * back from the server: `Pong` and `MetricsRequest`. The `WithoutPing` and
+ * `WithoutPong` helper types match the server behavior, where heartbeat
+ * messages are handled internally and user handlers see only application-level
+ * protocol messages.
+ *
+ * **Gotchas**
+ *
+ * These schemas describe transport payloads, not the full in-memory tracer or
+ * metric data structures. Ended span exits erase successful values with
+ * `Exit.asVoid`, timestamps are represented as `bigint`s, and attributes remain
+ * intentionally open-ended. Because this module lives under `unstable`, the
+ * protocol shape may change between releases.
  *
  * @since 4.0.0
  */

package/dist/unstable/devtools/DevToolsSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevToolsSchema.js","names":["Exit","identity","Schema","SchemaTransformation","SpanStatusStarted","Struct","_tag","tag","startTime","BigInt","SpanStatusEnded","endTime","exit","Void","DefectWithStack","pipe","decodeTo","Unknown","transform","decode","encode","asVoid","SpanStatus","Union","ExternalSpan","spanId","String","traceId","sampled","Boolean","Span","name","attributes","ReadonlyMap","Any","status","parent","Option","suspend","ParentSpan","SpanEvent","UndefinedOr","Record","Ping","Pong","MetricsRequest","MetricLabel","key","value","metric","type","state","id","description","Counter","count","Number","incremental","Frequency","occurrences","Gauge","Histogram","buckets","Array","Tuple","min","max","sum","Summary","quantiles","Metric","MetricsSnapshot","metrics","Request","Response"],"sources":["../../../src/unstable/devtools/DevToolsSchema.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;AAoBA,OAAO,KAAKA,IAAI,MAAM,eAAe;AACrC,SAASC,QAAQ,QAAQ,mBAAmB;AAE5C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,oBAAoB,MAAM,+BAA+B;AAErE;;;;;;;AAOA,OAAO,MAAMC,iBAAiB,gBAAGF,MAAM,CAACG,MAAM,CAAC;EAC7CC,IAAI,eAAEJ,MAAM,CAACK,GAAG,CAAC,SAAS,CAAC;EAC3BC,SAAS,EAAEN,MAAM,CAACO;CACnB,CAAC;AAUF;;;;;;;;AAQA,OAAO,MAAMC,eAAe,gBAAGR,MAAM,CAACG,MAAM,CAAC;EAC3CC,IAAI,eAAEJ,MAAM,CAACK,GAAG,CAAC,OAAO,CAAC;EACzBC,SAAS,EAAEN,MAAM,CAACO,MAAM;EACxBE,OAAO,EAAET,MAAM,CAACO,MAAM;EACtBG,IAAI,eAAEV,MAAM,CAACF,IAAI,CAACE,MAAM,CAACW,IAAI,EAAEX,MAAM,CAACY,eAAe,EAAEZ,MAAM,CAACY,eAAe,CAAC,CAACC,IAAI,cACjFb,MAAM,CAACc,QAAQ,cACbd,MAAM,CAACF,IAAI,CAACE,MAAM,CAACe,OAAO,EAAEf,MAAM,CAACe,OAAO,EAAEf,MAAM,CAACe,OAAO,CAAC,eAC3Dd,oBAAoB,CAACe,SAAS,CAAC;IAC7BC,MAAM,EAAElB,QAAQ;IAChBmB,MAAM,EAAEpB,IAAI,CAACqB;GACd,CAAC,CACH;CAEJ,CAAC;AAWF;;;;;;AAMA,OAAO,MAAMC,UAAU,gBAAGpB,MAAM,CAACqB,KAAK,CAAC,CAACnB,iBAAiB,EAAEM,eAAe,CAAC,CAAC;AAwB5E;;;;;;;AAOA,OAAO,MAAMc,YAAY,gBAA+BtB,MAAM,CAACG,MAAM,CAAC;EACpEC,IAAI,eAAEJ,MAAM,CAACK,GAAG,CAAC,cAAc,CAAC;EAChCkB,MAAM,EAAEvB,MAAM,CAACwB,MAAM;EACrBC,OAAO,EAAEzB,MAAM,CAACwB,MAAM;EACtBE,OAAO,EAAE1B,MAAM,CAAC2B;CACjB,CAAC;AAoBF;;;;;;AAMA,OAAO,MAAMC,IAAI,gBAAuB5B,MAAM,CAACG,MAAM,CAAC;EACpDC,IAAI,eAAEJ,MAAM,CAACK,GAAG,CAAC,MAAM,CAAC;EACxBkB,MAAM,EAAEvB,MAAM,CAACwB,MAAM;EACrBC,OAAO,EAAEzB,MAAM,CAACwB,MAAM;EACtBK,IAAI,EAAE7B,MAAM,CAACwB,MAAM;EACnBE,OAAO,EAAE1B,MAAM,CAAC2B,OAAO;EACvBG,UAAU,eAAE9B,MAAM,CAAC+B,WAAW,CAAC/B,MAAM,CAACwB,MAAM,EAAExB,MAAM,CAACgC,GAAG,CAAC;EACzDC,MAAM,EAAEb,UAAU;EAClBc,MAAM,eAAElC,MAAM,CAACmC,MAAM,cAACnC,MAAM,CAACoC,OAAO,CAAC,MAAMC,UAAU,CAAC;CACvD,CAAC;AAEF;;;;;;;AAOA,OAAO,MAAMC,SAAS,gBAAGtC,MAAM,CAACG,MAAM,CAAC;EACrCC,IAAI,eAAEJ,MAAM,CAACK,GAAG,CAAC,WAAW,CAAC;EAC7BoB,OAAO,EAAEzB,MAAM,CAACwB,MAAM;EACtBD,MAAM,EAAEvB,MAAM,CAACwB,MAAM;EACrBK,IAAI,EAAE7B,MAAM,CAACwB,MAAM;EACnBlB,SAAS,EAAEN,MAAM,CAACO,MAAM;EACxBuB,UAAU,eAAE9B,MAAM,CAACuC,WAAW,cAACvC,MAAM,CAACwC,MAAM,CAACxC,MAAM,CAACwB,MAAM,EAAExB,MAAM,CAACgC,GAAG,CAAC;CACxE,CAAC;AAmBF;;;;;;;AAOA,OAAO,MAAMK,UAAU,gBAAGrC,MAAM,CAACqB,KAAK,CAAC,CAACO,IAAI,EAAEN,YAAY,CAAC,CAAC;AAE5D;;;;;;AAMA,OAAO,MAAMmB,IAAI,gBAAGzC,MAAM,CAACG,MAAM,CAAC;EAChCC,IAAI,eAAEJ,MAAM,CAACK,GAAG,CAAC,MAAM;CACxB,CAAC;AAUF;;;;;;AAMA,OAAO,MAAMqC,IAAI,gBAAG1C,MAAM,CAACG,MAAM,CAAC;EAChCC,IAAI,eAAEJ,MAAM,CAACK,GAAG,CAAC,MAAM;CACxB,CAAC;AAUF;;;;;;AAMA,OAAO,MAAMsC,cAAc,gBAAG3C,MAAM,CAACG,MAAM,CAAC;EAC1CC,IAAI,eAAEJ,MAAM,CAACK,GAAG,CAAC,gBAAgB;CAClC,CAAC;AAUF;;;;;;AAMA,OAAO,MAAMuC,WAAW,gBAAG5C,MAAM,CAACG,MAAM,CAAC;EACvC0C,GAAG,EAAE7C,MAAM,CAACwB,MAAM;EAClBsB,KAAK,EAAE9C,MAAM,CAACwB;CACf,CAAC;AAUF,MAAMuB,MAAM,GAAGA,CAAgDC,IAAU,EAAEC,KAAY,KACrFjD,MAAM,CAACG,MAAM,CAAC;EACZ+C,EAAE,EAAElD,MAAM,CAACwB,MAAM;EACjBwB,IAAI,EAAEhD,MAAM,CAACK,GAAG,CAAC2C,IAAI,CAAC;EACtBG,WAAW,EAAEnD,MAAM,CAACuC,WAAW,CAACvC,MAAM,CAACwB,MAAM,CAAC;EAC9CM,UAAU,EAAE9B,MAAM,CAACuC,WAAW,CAACvC,MAAM,CAACwC,MAAM,CAACxC,MAAM,CAACwB,MAAM,EAAExB,MAAM,CAACwB,MAAM,CAAC,CAAC;EAC3EyB;CACD,CAAC;AAEJ;;;;;;;AAOA,OAAO,MAAMG,OAAO,gBAAGL,MAAM,CAC3B,SAAS,eACT/C,MAAM,CAACG,MAAM,CAAC;EACZkD,KAAK,eAAErD,MAAM,CAACqB,KAAK,CAAC,CAACrB,MAAM,CAACsD,MAAM,EAAEtD,MAAM,CAACO,MAAM,CAAC,CAAC;EACnDgD,WAAW,EAAEvD,MAAM,CAAC2B;CACrB,CAAC,CACH;AAeD;;;;;;;;;;AAUA,OAAO,MAAM6B,SAAS,gBAAGT,MAAM,CAC7B,WAAW,eACX/C,MAAM,CAACG,MAAM,CAAC;EACZsD,WAAW,eAAEzD,MAAM,CAAC+B,WAAW,CAAC/B,MAAM,CAACwB,MAAM,EAAExB,MAAM,CAACsD,MAAM;CAC7D,CAAC,CACH;AAcD;;;;;;;;;;AAUA,OAAO,MAAMI,KAAK,gBAAGX,MAAM,CACzB,OAAO,eACP/C,MAAM,CAACG,MAAM,CAAC;EACZ2C,KAAK,eAAE9C,MAAM,CAACqB,KAAK,CAAC,CAACrB,MAAM,CAACsD,MAAM,EAAEtD,MAAM,CAACO,MAAM,CAAC;CACnD,CAAC,CACH;AAcD;;;;;;;;;;;AAWA,OAAO,MAAMoD,SAAS,gBAAGZ,MAAM,CAC7B,WAAW,eACX/C,MAAM,CAACG,MAAM,CAAC;EACZyD,OAAO,eAAE5D,MAAM,CAAC6D,KAAK,cAAC7D,MAAM,CAAC8D,KAAK,CAAC,CAAC9D,MAAM,CAACsD,MAAM,EAAEtD,MAAM,CAACsD,MAAM,CAAC,CAAC,CAAC;EACnED,KAAK,EAAErD,MAAM,CAACsD,MAAM;EACpBS,GAAG,EAAE/D,MAAM,CAACsD,MAAM;EAClBU,GAAG,EAAEhE,MAAM,CAACsD,MAAM;EAClBW,GAAG,EAAEjE,MAAM,CAACsD;CACb,CAAC,CACH;AAeD;;;;;;;;;;;AAWA,OAAO,MAAMY,OAAO,gBAAGnB,MAAM,CAC3B,SAAS,eACT/C,MAAM,CAACG,MAAM,CAAC;EACZgE,SAAS,eAAEnE,MAAM,CAAC6D,KAAK,cAAC7D,MAAM,CAAC8D,KAAK,CAAC,CAAC9D,MAAM,CAACsD,MAAM,eAAEtD,MAAM,CAACuC,WAAW,CAACvC,MAAM,CAACsD,MAAM,CAAC,CAAC,CAAC,CAAC;EACzFD,KAAK,EAAErD,MAAM,CAACsD,MAAM;EACpBS,GAAG,EAAE/D,MAAM,CAACsD,MAAM;EAClBU,GAAG,EAAEhE,MAAM,CAACsD,MAAM;EAClBW,GAAG,EAAEjE,MAAM,CAACsD;CACb,CAAC,CACH;AAeD;;;;;;;;;;;AAWA,OAAO,MAAMc,MAAM,gBAAGpE,MAAM,CAACqB,KAAK,CAAC,CAAC+B,OAAO,EAAEI,SAAS,EAAEE,KAAK,EAAEC,SAAS,EAAEO,OAAO,CAAC,CAAC;AAcnF;;;;;;;AAOA,OAAO,MAAMG,eAAe,gBAAGrE,MAAM,CAACG,MAAM,CAAC;EAC3CC,IAAI,eAAEJ,MAAM,CAACK,GAAG,CAAC,iBAAiB,CAAC;EACnCiE,OAAO,eAAEtE,MAAM,CAAC6D,KAAK,CAACO,MAAM;CAC7B,CAAC;AAUF;;;;;;;;;;AAUA,OAAO,MAAMG,OAAO,gBAAGvE,MAAM,CAACqB,KAAK,CAAC,CAACoB,IAAI,EAAEb,IAAI,EAAEU,SAAS,EAAE+B,eAAe,CAAC,CAAC;AAiC7E;;;;;;;;;;AAUA,OAAO,MAAMG,QAAQ,gBAAGxE,MAAM,CAACqB,KAAK,CAAC,CAACqB,IAAI,EAAEC,cAAc,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"DevToolsSchema.js","names":["Exit","identity","Schema","SchemaTransformation","SpanStatusStarted","Struct","_tag","tag","startTime","BigInt","SpanStatusEnded","endTime","exit","Void","DefectWithStack","pipe","decodeTo","Unknown","transform","decode","encode","asVoid","SpanStatus","Union","ExternalSpan","spanId","String","traceId","sampled","Boolean","Span","name","attributes","ReadonlyMap","Any","status","parent","Option","suspend","ParentSpan","SpanEvent","UndefinedOr","Record","Ping","Pong","MetricsRequest","MetricLabel","key","value","metric","type","state","id","description","Counter","count","Number","incremental","Frequency","occurrences","Gauge","Histogram","buckets","Array","Tuple","min","max","sum","Summary","quantiles","Metric","MetricsSnapshot","metrics","Request","Response"],"sources":["../../../src/unstable/devtools/DevToolsSchema.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/devtools/DevToolsServer.d.ts

@@ -1,17 +1,24 @@
 /**
- * Server-side helpers for exposing the Effect devtools protocol over a socket.
- *
- * This module is used by runtime integrations that want to accept devtools
- * clients, decode newline-delimited JSON protocol messages, and hand each
- * connected client to application-specific handling logic. It is most useful
- * for building a devtools endpoint that can inspect running fibers, spans, and
- * other telemetry described by `DevToolsSchema`.
- *
- * The server automatically responds to protocol `Ping` requests with `Pong`
- * responses. All other requests are delivered through the connected `Client`
- * queue, while responses should be written with `Client.send`. The queue is
- * shut down when the socket processing fiber terminates, so handlers should
- * treat it as connection-scoped state rather than a long-lived global channel.
+ * Runs the server side of the unstable Effect devtools socket protocol.
+ *
+ * Use this module when an integration needs to accept devtools clients over a
+ * `SocketServer`, decode newline-delimited JSON messages, and handle each
+ * connection with application-specific logic. It does not interpret spans or
+ * metrics itself; it gives handlers a typed surface for the telemetry described
+ * by `DevToolsSchema`.
+ *
+ * **Mental model**
+ *
+ * Each accepted socket becomes one `Client`. Incoming `Ping` requests are
+ * answered internally with `Pong`, while all other decoded requests are offered
+ * to the client's queue. Handler code reads that queue and sends non-pong
+ * responses such as `MetricsRequest` through `Client.send`.
+ *
+ * **Gotchas**
+ *
+ * The client queue is scoped to the socket-processing fiber and is shut down
+ * when that fiber terminates. Treat it as per-connection state, not as a
+ * process-wide telemetry bus.
  *
  * @since 4.0.0
  */

package/dist/unstable/devtools/DevToolsServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DevToolsServer.d.ts","sourceRoot":"","sources":["../../../src/unstable/devtools/DevToolsServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAKvC,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAA;AACzD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAKrD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IACjE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAC/E;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACxB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC/C,MAAM,CAAC,MAAM,CAChB,KAAK,EACL,YAAY,CAAC,iBAAiB,EAC9B,CAAC,GAAG,YAAY,CAAC,YAAY,CAqC7B,CAAA"}
+{"version":3,"file":"DevToolsServer.d.ts","sourceRoot":"","sources":["../../../src/unstable/devtools/DevToolsServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAKvC,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAA;AACzD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAKrD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IACjE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAC/E;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACxB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC/C,MAAM,CAAC,MAAM,CAChB,KAAK,EACL,YAAY,CAAC,iBAAiB,EAC9B,CAAC,GAAG,YAAY,CAAC,YAAY,CAqC7B,CAAA"}

package/dist/unstable/devtools/DevToolsServer.js

@@ -1,17 +1,24 @@
 /**
- * Server-side helpers for exposing the Effect devtools protocol over a socket.
- *
- * This module is used by runtime integrations that want to accept devtools
- * clients, decode newline-delimited JSON protocol messages, and hand each
- * connected client to application-specific handling logic. It is most useful
- * for building a devtools endpoint that can inspect running fibers, spans, and
- * other telemetry described by `DevToolsSchema`.
- *
- * The server automatically responds to protocol `Ping` requests with `Pong`
- * responses. All other requests are delivered through the connected `Client`
- * queue, while responses should be written with `Client.send`. The queue is
- * shut down when the socket processing fiber terminates, so handlers should
- * treat it as connection-scoped state rather than a long-lived global channel.
+ * Runs the server side of the unstable Effect devtools socket protocol.
+ *
+ * Use this module when an integration needs to accept devtools clients over a
+ * `SocketServer`, decode newline-delimited JSON messages, and handle each
+ * connection with application-specific logic. It does not interpret spans or
+ * metrics itself; it gives handlers a typed surface for the telemetry described
+ * by `DevToolsSchema`.
+ *
+ * **Mental model**
+ *
+ * Each accepted socket becomes one `Client`. Incoming `Ping` requests are
+ * answered internally with `Pong`, while all other decoded requests are offered
+ * to the client's queue. Handler code reads that queue and sends non-pong
+ * responses such as `MetricsRequest` through `Client.send`.
+ *
+ * **Gotchas**
+ *
+ * The client queue is scoped to the socket-processing fiber and is shut down
+ * when that fiber terminates. Treat it as per-connection state, not as a
+ * process-wide telemetry bus.
  *
  * @since 4.0.0
  */

package/dist/unstable/devtools/DevToolsServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevToolsServer.js","names":["Effect","Queue","Schema","Stream","Ndjson","Socket","SocketServer","DevToolsSchema","RequestSchema","toCodecJson","Request","ResponseSchema","Response","run","fnUntraced","handle","server","socket","responses","unbounded","requests","client","queue","send","response","offer","pipe","asVoid","fromQueue","pipeThroughChannel","duplexSchemaString","toChannelString","inputSchema","outputSchema","runForEach","request","_tag","ensuring","shutdown","andThen","forkChild"],"sources":["../../../src/unstable/devtools/DevToolsServer.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;AAiBA,OAAO,KAAKA,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,uBAAuB;AAC/C,OAAO,KAAKC,MAAM,MAAM,qBAAqB;AAC7C,OAAO,KAAKC,YAAY,MAAM,2BAA2B;AACzD,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD,MAAMC,aAAa,gBAAGN,MAAM,CAACO,WAAW,CAACF,cAAc,CAACG,OAAO,CAAC;AAChE,MAAMC,cAAc,gBAAGT,MAAM,CAACO,WAAW,CAACF,cAAc,CAACK,QAAQ,CAAC;AAkBlE;;;;;;;;;;;;AAYA,OAAO,MAAMC,GAAG,gBAMZb,MAAM,CAACc,UAAU,CAAC,WACpBC,MAAkD;EAElD,MAAMC,MAAM,GAAG,OAAOV,YAAY,CAACA,YAAY;EAE/C,OAAO,OAAOU,MAAM,CAACH,GAAG,CAACb,MAAM,CAACc,UAAU,CAAC,WAAUG,MAAM;IACzD,MAAMC,SAAS,GAAG,OAAOjB,KAAK,CAACkB,SAAS,EAA2B;IACnE,MAAMC,QAAQ,GAAG,OAAOnB,KAAK,CAACkB,SAAS,EAAsC;IAE7E,MAAME,MAAM,GAAW;MACrBC,KAAK,EAAEF,QAAQ;MACfG,IAAI,EAAGC,QAAQ,IAAKvB,KAAK,CAACwB,KAAK,CAACP,SAAS,EAAEM,QAAQ,CAAC,CAACE,IAAI,CAAC1B,MAAM,CAAC2B,MAAM;KACxE;IAED,OAAOxB,MAAM,CAACyB,SAAS,CAACV,SAAS,CAAC,CAACQ,IAAI,CACrCvB,MAAM,CAAC0B,kBAAkB,CACvBzB,MAAM,CAAC0B,kBAAkB,CAACzB,MAAM,CAAC0B,eAAe,CAACd,MAAM,CAAC,EAAE;MACxDe,WAAW,EAAErB,cAAc;MAC3BsB,YAAY,EAAEzB;KACf,CAAC,CACH,EACDL,MAAM,CAAC+B,UAAU,CAAEC,OAAO,IACxBA,OAAO,CAACC,IAAI,KAAK,MAAM,GACnBnC,KAAK,CAACwB,KAAK,CAACP,SAAS,EAAE;MAAEkB,IAAI,EAAE;IAAM,CAAE,CAAC,GACxCnC,KAAK,CAACwB,KAAK,CAACL,QAAQ,EAAEe,OAAO,CAAC,CACnC,EACDnC,MAAM,CAACqC,QAAQ,CACbpC,KAAK,CAACqC,QAAQ,CAACpB,SAAS,CAAC,CAACQ,IAAI,CAC5B1B,MAAM,CAACuC,OAAO,CAACtC,KAAK,CAACqC,QAAQ,CAAClB,QAAQ,CAAC,CAAC,CACzC,CACF,EACDpB,MAAM,CAACwC,SAAS,CACjB;IAED,OAAO,OAAOzB,MAAM,CAACM,MAAM,CAAC;EAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"DevToolsServer.js","names":["Effect","Queue","Schema","Stream","Ndjson","Socket","SocketServer","DevToolsSchema","RequestSchema","toCodecJson","Request","ResponseSchema","Response","run","fnUntraced","handle","server","socket","responses","unbounded","requests","client","queue","send","response","offer","pipe","asVoid","fromQueue","pipeThroughChannel","duplexSchemaString","toChannelString","inputSchema","outputSchema","runForEach","request","_tag","ensuring","shutdown","andThen","forkChild"],"sources":["../../../src/unstable/devtools/DevToolsServer.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,OAAO,KAAKA,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,uBAAuB;AAC/C,OAAO,KAAKC,MAAM,MAAM,qBAAqB;AAC7C,OAAO,KAAKC,YAAY,MAAM,2BAA2B;AACzD,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD,MAAMC,aAAa,gBAAGN,MAAM,CAACO,WAAW,CAACF,cAAc,CAACG,OAAO,CAAC;AAChE,MAAMC,cAAc,gBAAGT,MAAM,CAACO,WAAW,CAACF,cAAc,CAACK,QAAQ,CAAC;AAkBlE;;;;;;;;;;;;AAYA,OAAO,MAAMC,GAAG,gBAMZb,MAAM,CAACc,UAAU,CAAC,WACpBC,MAAkD;EAElD,MAAMC,MAAM,GAAG,OAAOV,YAAY,CAACA,YAAY;EAE/C,OAAO,OAAOU,MAAM,CAACH,GAAG,CAACb,MAAM,CAACc,UAAU,CAAC,WAAUG,MAAM;IACzD,MAAMC,SAAS,GAAG,OAAOjB,KAAK,CAACkB,SAAS,EAA2B;IACnE,MAAMC,QAAQ,GAAG,OAAOnB,KAAK,CAACkB,SAAS,EAAsC;IAE7E,MAAME,MAAM,GAAW;MACrBC,KAAK,EAAEF,QAAQ;MACfG,IAAI,EAAGC,QAAQ,IAAKvB,KAAK,CAACwB,KAAK,CAACP,SAAS,EAAEM,QAAQ,CAAC,CAACE,IAAI,CAAC1B,MAAM,CAAC2B,MAAM;KACxE;IAED,OAAOxB,MAAM,CAACyB,SAAS,CAACV,SAAS,CAAC,CAACQ,IAAI,CACrCvB,MAAM,CAAC0B,kBAAkB,CACvBzB,MAAM,CAAC0B,kBAAkB,CAACzB,MAAM,CAAC0B,eAAe,CAACd,MAAM,CAAC,EAAE;MACxDe,WAAW,EAAErB,cAAc;MAC3BsB,YAAY,EAAEzB;KACf,CAAC,CACH,EACDL,MAAM,CAAC+B,UAAU,CAAEC,OAAO,IACxBA,OAAO,CAACC,IAAI,KAAK,MAAM,GACnBnC,KAAK,CAACwB,KAAK,CAACP,SAAS,EAAE;MAAEkB,IAAI,EAAE;IAAM,CAAE,CAAC,GACxCnC,KAAK,CAACwB,KAAK,CAACL,QAAQ,EAAEe,OAAO,CAAC,CACnC,EACDnC,MAAM,CAACqC,QAAQ,CACbpC,KAAK,CAACqC,QAAQ,CAACpB,SAAS,CAAC,CAACQ,IAAI,CAC5B1B,MAAM,CAACuC,OAAO,CAACtC,KAAK,CAACqC,QAAQ,CAAClB,QAAQ,CAAC,CAAC,CACzC,CACF,EACDpB,MAAM,CAACwC,SAAS,CACjB;IAED,OAAO,OAAOzB,MAAM,CAACM,MAAM,CAAC;EAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC","ignoreList":[]}