effect 4.0.0-beta.66 → 4.0.0-beta.68

package/dist/unstable/devtools/DevToolsSchema.js

@@ -1,4 +1,21 @@
 /**
+ * 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.
+ *
  * @since 4.0.0
  */
 import * as Exit from "../../Exit.js";
@@ -6,16 +23,23 @@ import { identity } from "../../Function.js";
 import * as Schema from "../../Schema.js";
 import * as SchemaTransformation from "../../SchemaTransformation.js";
 /**
- * @since 4.0.0
+ * Schema for a span status representing a span that has started but not yet
+ * ended.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const SpanStatusStarted = /*#__PURE__*/Schema.Struct({
   _tag: /*#__PURE__*/Schema.tag("Started"),
   startTime: Schema.BigInt
 });
 /**
- * @since 4.0.0
+ * Schema for a span status representing an ended span, including start time,
+ * end time, and encoded exit status. Encoding drops success values with
+ * `Exit.asVoid`.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const SpanStatusEnded = /*#__PURE__*/Schema.Struct({
   _tag: /*#__PURE__*/Schema.tag("Ended"),
@@ -27,13 +51,18 @@ export const SpanStatusEnded = /*#__PURE__*/Schema.Struct({
   })))
 });
 /**
- * @since 4.0.0
+ * Schema for devtools span status, either started or ended.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const SpanStatus = /*#__PURE__*/Schema.Union([SpanStatusStarted, SpanStatusEnded]);
 /**
- * @since 4.0.0
+ * Schema for an external parent span context containing span id, trace id, and
+ * sampling flag.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const ExternalSpan = /*#__PURE__*/Schema.Struct({
   _tag: /*#__PURE__*/Schema.tag("ExternalSpan"),
@@ -42,8 +71,10 @@ export const ExternalSpan = /*#__PURE__*/Schema.Struct({
   sampled: Schema.Boolean
 });
 /**
- * @since 4.0.0
+ * Schema for an Effect span telemetry payload sent to devtools.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Span = /*#__PURE__*/Schema.Struct({
   _tag: /*#__PURE__*/Schema.tag("Span"),
@@ -56,8 +87,11 @@ export const Span = /*#__PURE__*/Schema.Struct({
   parent: /*#__PURE__*/Schema.Option(/*#__PURE__*/Schema.suspend(() => ParentSpan))
 });
 /**
- * @since 4.0.0
+ * Schema for a named event emitted by a span, including trace id, span id,
+ * start time, and optional attributes.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const SpanEvent = /*#__PURE__*/Schema.Struct({
   _tag: /*#__PURE__*/Schema.tag("SpanEvent"),
@@ -68,34 +102,45 @@ export const SpanEvent = /*#__PURE__*/Schema.Struct({
   attributes: /*#__PURE__*/Schema.UndefinedOr(/*#__PURE__*/Schema.Record(Schema.String, Schema.Any))
 });
 /**
- * @since 4.0.0
+ * Schema for a span parent, either a full devtools `Span` payload or an
+ * `ExternalSpan` context.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const ParentSpan = /*#__PURE__*/Schema.Union([Span, ExternalSpan]);
 /**
- * @since 4.0.0
+ * Schema for the devtools heartbeat request sent by the client.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Ping = /*#__PURE__*/Schema.Struct({
   _tag: /*#__PURE__*/Schema.tag("Ping")
 });
 /**
- * @since 4.0.0
+ * Schema for the devtools heartbeat response.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Pong = /*#__PURE__*/Schema.Struct({
   _tag: /*#__PURE__*/Schema.tag("Pong")
 });
 /**
- * @since 4.0.0
+ * Schema for a devtools request asking the client to send a metrics snapshot.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const MetricsRequest = /*#__PURE__*/Schema.Struct({
   _tag: /*#__PURE__*/Schema.tag("MetricsRequest")
 });
 /**
- * @since 4.0.0
+ * Schema for a metric label key/value pair in a devtools metrics snapshot.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const MetricLabel = /*#__PURE__*/Schema.Struct({
   key: Schema.String,
@@ -109,30 +154,46 @@ const metric = (type, state) => Schema.Struct({
   state
 });
 /**
- * @since 4.0.0
+ * Schema for a counter metric snapshot, including the count and whether updates
+ * are incremental.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Counter = /*#__PURE__*/metric("Counter", /*#__PURE__*/Schema.Struct({
   count: /*#__PURE__*/Schema.Union([Schema.Number, Schema.BigInt]),
   incremental: Schema.Boolean
 }));
 /**
- * @since 4.0.0
+ * Schema for a devtools frequency metric snapshot.
+ *
+ * The metric state records occurrence counts by string key.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Frequency = /*#__PURE__*/metric("Frequency", /*#__PURE__*/Schema.Struct({
   occurrences: /*#__PURE__*/Schema.ReadonlyMap(Schema.String, Schema.Number)
 }));
 /**
- * @since 4.0.0
+ * Schema for a devtools gauge metric snapshot.
+ *
+ * The metric state contains the current numeric or bigint value.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Gauge = /*#__PURE__*/metric("Gauge", /*#__PURE__*/Schema.Struct({
   value: /*#__PURE__*/Schema.Union([Schema.Number, Schema.BigInt])
 }));
 /**
- * @since 4.0.0
+ * Schema for a devtools histogram metric snapshot.
+ *
+ * The metric state includes bucket counts plus the total count, minimum,
+ * maximum, and sum.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Histogram = /*#__PURE__*/metric("Histogram", /*#__PURE__*/Schema.Struct({
   buckets: /*#__PURE__*/Schema.Array(/*#__PURE__*/Schema.Tuple([Schema.Number, Schema.Number])),
@@ -142,8 +203,13 @@ export const Histogram = /*#__PURE__*/metric("Histogram", /*#__PURE__*/Schema.St
   sum: Schema.Number
 }));
 /**
- * @since 4.0.0
+ * Schema for a devtools summary metric snapshot.
+ *
+ * The metric state contains quantile values plus the total count, minimum,
+ * maximum, and sum.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Summary = /*#__PURE__*/metric("Summary", /*#__PURE__*/Schema.Struct({
   quantiles: /*#__PURE__*/Schema.Array(/*#__PURE__*/Schema.Tuple([Schema.Number, /*#__PURE__*/Schema.UndefinedOr(Schema.Number)])),
@@ -153,26 +219,42 @@ export const Summary = /*#__PURE__*/metric("Summary", /*#__PURE__*/Schema.Struct
   sum: Schema.Number
 }));
 /**
- * @since 4.0.0
+ * Schema for any devtools metric snapshot.
+ *
+ * Accepted metric kinds are counters, frequencies, gauges, histograms, and
+ * summaries.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Metric = /*#__PURE__*/Schema.Union([Counter, Frequency, Gauge, Histogram, Summary]);
 /**
- * @since 4.0.0
+ * Schema for a devtools protocol message containing the current metric
+ * snapshots.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const MetricsSnapshot = /*#__PURE__*/Schema.Struct({
   _tag: /*#__PURE__*/Schema.tag("MetricsSnapshot"),
   metrics: /*#__PURE__*/Schema.Array(Metric)
 });
 /**
- * @since 4.0.0
+ * Schema for devtools protocol requests accepted by the server.
+ *
+ * Requests include heartbeat pings, spans, span events, and metric snapshots.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Request = /*#__PURE__*/Schema.Union([Ping, Span, SpanEvent, MetricsSnapshot]);
 /**
- * @since 4.0.0
+ * Schema for devtools protocol responses sent by the server.
+ *
+ * Responses include heartbeat pongs and requests for metric snapshots.
+ *
  * @category schemas
+ * @since 4.0.0
  */
 export const Response = /*#__PURE__*/Schema.Union([Pong, MetricsRequest]);
 //# sourceMappingURL=DevToolsSchema.js.map

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":"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","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":"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;AAaD;;;;;;;;AAQA,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;AAYD;;;;;;;;AAQA,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;AAYD;;;;;;;;;AASA,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;AAaD;;;;;;;;;AASA,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;AAaD;;;;;;;;;AASA,OAAO,MAAMc,MAAM,gBAAGpE,MAAM,CAACqB,KAAK,CAAC,CAAC+B,OAAO,EAAEI,SAAS,EAAEE,KAAK,EAAEC,SAAS,EAAEO,OAAO,CAAC,CAAC;AAYnF;;;;;;;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;;;;;;;;AAQA,OAAO,MAAMG,OAAO,gBAAGvE,MAAM,CAACqB,KAAK,CAAC,CAACoB,IAAI,EAAEb,IAAI,EAAEU,SAAS,EAAE+B,eAAe,CAAC,CAAC;AA8B7E;;;;;;;;AAQA,OAAO,MAAMG,QAAQ,gBAAGxE,MAAM,CAACqB,KAAK,CAAC,CAACqB,IAAI,EAAEC,cAAc,CAAC,CAAC","ignoreList":[]}

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

@@ -1,4 +1,18 @@
 /**
+ * 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.
+ *
  * @since 4.0.0
  */
 import * as Effect from "../../Effect.ts";
@@ -6,16 +20,27 @@ import * as Queue from "../../Queue.ts";
 import * as SocketServer from "../socket/SocketServer.ts";
 import * as DevToolsSchema from "./DevToolsSchema.ts";
 /**
- * @since 4.0.0
+ * Handle for a connected devtools client.
+ *
+ * It exposes a queue of non-ping requests received from the socket and a
+ * `send` function for non-pong responses.
+ *
  * @category models
+ * @since 4.0.0
  */
 export interface Client {
     readonly queue: Queue.Dequeue<DevToolsSchema.Request.WithoutPing>;
     readonly send: (_: DevToolsSchema.Response.WithoutPong) => Effect.Effect<void>;
 }
 /**
- * @since 4.0.0
+ * Runs the devtools socket server.
+ *
+ * Each connection is decoded as NDJSON devtools protocol messages, `Ping`
+ * requests are answered with `Pong`, and all other requests are delivered
+ * through the `Client` passed to the handler.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export declare const run: <_, E, R>(handle: (client: Client) => Effect.Effect<_, E, R>) => Effect.Effect<never, SocketServer.SocketServerError, R | SocketServer.SocketServer>;
 //# sourceMappingURL=DevToolsServer.d.ts.map

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;;GAEG;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;;;GAGG;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;;;GAGG;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;;;;;;;;;;;;;;;;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;;;;;;;;GAQG;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;;;;;;;;;GASG;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,4 +1,18 @@
 /**
+ * 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.
+ *
  * @since 4.0.0
  */
 import * as Effect from "../../Effect.js";
@@ -12,8 +26,14 @@ import * as DevToolsSchema from "./DevToolsSchema.js";
 const RequestSchema = /*#__PURE__*/Schema.toCodecJson(DevToolsSchema.Request);
 const ResponseSchema = /*#__PURE__*/Schema.toCodecJson(DevToolsSchema.Response);
 /**
- * @since 4.0.0
+ * Runs the devtools socket server.
+ *
+ * Each connection is decoded as NDJSON devtools protocol messages, `Ping`
+ * requests are answered with `Pong`, and all other requests are delivered
+ * through the `Client` passed to the handler.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const run = /*#__PURE__*/Effect.fnUntraced(function* (handle) {
   const server = yield* SocketServer.SocketServer;

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;;;AAGA,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;AAWlE;;;;AAIA,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;;;;;;;;;;;;;;;;;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;AAgBlE;;;;;;;;;;AAUA,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":[]}

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

@@ -2,18 +2,76 @@
  * @since 4.0.0
  */
 /**
+ * Utilities for wiring an Effect application to the Effect devtools runtime
+ * 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.
+ *
+ * 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.
+ *
  * @since 4.0.0
  */
 export * as DevTools from "./DevTools.ts";
 /**
+ * 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.
+ *
  * @since 4.0.0
  */
 export * as DevToolsClient from "./DevToolsClient.ts";
 /**
+ * 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.
+ *
  * @since 4.0.0
  */
 export * as DevToolsSchema from "./DevToolsSchema.ts";
 /**
+ * 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.
+ *
  * @since 4.0.0
  */
 export * as DevToolsServer from "./DevToolsServer.ts";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/devtools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/devtools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA"}

package/dist/unstable/devtools/index.js

@@ -3,18 +3,76 @@
  */
 // @barrel: Auto-generated exports. Do not edit manually.
 /**
+ * Utilities for wiring an Effect application to the Effect devtools runtime
+ * 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.
+ *
+ * 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.
+ *
  * @since 4.0.0
  */
 export * as DevTools from "./DevTools.js";
 /**
+ * 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.
+ *
  * @since 4.0.0
  */
 export * as DevToolsClient from "./DevToolsClient.js";
 /**
+ * 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.
+ *
  * @since 4.0.0
  */
 export * as DevToolsSchema from "./DevToolsSchema.js";
 /**
+ * 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.
+ *
  * @since 4.0.0
  */
 export * as DevToolsServer from "./DevToolsServer.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["DevTools","DevToolsClient","DevToolsSchema","DevToolsServer"],"sources":["../../../src/unstable/devtools/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;AAGA,OAAO,KAAKA,QAAQ,MAAM,eAAe;AAEzC;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;AAGA,OAAO,KAAKC,cAAc,MAAM,qBAAqB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["DevTools","DevToolsClient","DevToolsSchema","DevToolsServer"],"sources":["../../../src/unstable/devtools/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;;;;;;;;;;;;;;;;AAkBA,OAAO,KAAKA,QAAQ,MAAM,eAAe;AAEzC;;;;;;;;;;;;;;;AAeA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;;;;;;;;;;;;;;;;;;AAoBA,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AAErD;;;;;;;;;;;;;;;;;AAiBA,OAAO,KAAKC,cAAc,MAAM,qBAAqB","ignoreList":[]}