@stndrds/schema 1.0.0-alpha.343 → 1.0.0-alpha.344

package/dist/index.d.mts

@@ -1950,7 +1950,7 @@ export type AgentMessagePart = {
 } | {
   type: "compaction";
   state: "failed";
-  /** Human-readable reason from the CompactionImpossibleError. */
+  /** Human-readable reason the summary could not be produced (`summary_timeout`, `summary_failed`, …). */
   reason: string;
   durationMs?: number;
 };
@@ -2710,6 +2710,28 @@ export declare const DEVICE_CHANNEL_PRESENCE_MS = 2000;
  * The JSON frame is what keeps an MV3 service worker awake.
  */
 export declare const DEVICE_CHANNEL_KEEPALIVE_MS = 20000;
+/**
+ * The code a worker closes with when a frame breaks the protocol. A browser
+ * `WebSocket` only accepts 1000 and 3000-4999, so the private-use mirror of
+ * 1008 is the one code every worker can actually send.
+ */
+export declare const DEVICE_CHANNEL_WORKER_CLOSE_PROTOCOL_VIOLATION = 4008;
+/** Where an exponential backoff starts, and where it stops doubling. */
+export interface RetryBounds {
+  initialMs: number;
+  maxMs: number;
+}
+/**
+ * Where the channel is: the path is absolute on the API origin, so a profile's
+ * `apiUrl` keeps only its host and the scheme swaps to the socket one. Written
+ * as an explicit map rather than a rewrite of the origin string, because a
+ * two-letter scheme literal reads to the SDK's egress scan as the `ws` package.
+ */
+export declare function deviceChannelUrl(apiUrl: string): string;
+/** Exponential backoff within the given bounds, plus the shared jitter window. */
+export declare function computeRetryDelay(attempt: number, random: () => number, bounds: RetryBounds): number;
+/** When to reconnect to the channel: 1 s doubling up to 30 s, plus jitter. */
+export declare function computeReconnectDelay(attempt: number, random?: () => number): number;
 export declare const DEVICE_COMMAND_ERROR_CODES: readonly ["worker_disconnected", "cancelled", "timed_out", "execution_failed", "stale_reference", "tab_unavailable", "debugger_unavailable", "blocked_by_user"];
 export type DeviceCommandErrorCode = (typeof DEVICE_COMMAND_ERROR_CODES)[number];
 export declare class DeviceChannelProtocolError extends SchemaError {

package/dist/index.d.ts

@@ -1950,7 +1950,7 @@ export type AgentMessagePart = {
 } | {
   type: "compaction";
   state: "failed";
-  /** Human-readable reason from the CompactionImpossibleError. */
+  /** Human-readable reason the summary could not be produced (`summary_timeout`, `summary_failed`, …). */
   reason: string;
   durationMs?: number;
 };
@@ -2710,6 +2710,28 @@ export declare const DEVICE_CHANNEL_PRESENCE_MS = 2000;
  * The JSON frame is what keeps an MV3 service worker awake.
  */
 export declare const DEVICE_CHANNEL_KEEPALIVE_MS = 20000;
+/**
+ * The code a worker closes with when a frame breaks the protocol. A browser
+ * `WebSocket` only accepts 1000 and 3000-4999, so the private-use mirror of
+ * 1008 is the one code every worker can actually send.
+ */
+export declare const DEVICE_CHANNEL_WORKER_CLOSE_PROTOCOL_VIOLATION = 4008;
+/** Where an exponential backoff starts, and where it stops doubling. */
+export interface RetryBounds {
+  initialMs: number;
+  maxMs: number;
+}
+/**
+ * Where the channel is: the path is absolute on the API origin, so a profile's
+ * `apiUrl` keeps only its host and the scheme swaps to the socket one. Written
+ * as an explicit map rather than a rewrite of the origin string, because a
+ * two-letter scheme literal reads to the SDK's egress scan as the `ws` package.
+ */
+export declare function deviceChannelUrl(apiUrl: string): string;
+/** Exponential backoff within the given bounds, plus the shared jitter window. */
+export declare function computeRetryDelay(attempt: number, random: () => number, bounds: RetryBounds): number;
+/** When to reconnect to the channel: 1 s doubling up to 30 s, plus jitter. */
+export declare function computeReconnectDelay(attempt: number, random?: () => number): number;
 export declare const DEVICE_COMMAND_ERROR_CODES: readonly ["worker_disconnected", "cancelled", "timed_out", "execution_failed", "stale_reference", "tab_unavailable", "debugger_unavailable", "blocked_by_user"];
 export type DeviceCommandErrorCode = (typeof DEVICE_COMMAND_ERROR_CODES)[number];
 export declare class DeviceChannelProtocolError extends SchemaError {