@q9labsai/chalk-client 5.2.2 → 5.2.4

package/dist/client.d.ts

@@ -1761,6 +1761,66 @@ export declare const createChalkEffectClient: (options: ChalkEffectClientOptions
                 readonly message: import("effect/Schema").String;
             }>;
         }>, never, never>>, never, never>, never, never>;
+        readonly reportConnectionFailure: HttpApiClient.Client.Method<import("effect/unstable/httpapi/HttpApiEndpoint").HttpApiEndpoint<"reportConnectionFailure", "POST", "/v1/tenants/:tenant_id/connection-reports", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+            readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
+        }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+            readonly events: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+                readonly attempt: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Number>>;
+                readonly close_code: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Number>>;
+                readonly code: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["invalid_state", "invalid_access", "access_unavailable", "permission_denied", "device_not_found", "device_busy", "device_constraint_invalid", "media_capture_failed", "sync_start_failed", "state_digest_recovery_failed", "sync_hello_timeout", "media_start_failed", "join_cleanup_unconfirmed", "sync_recovery_exhausted", "media_recovery_exhausted", "command_rejected", "leave_unconfirmed", "episode_ended", "unsupported_environment", "internal_error", "collaboration_unavailable", "chat_cursor_reset_required", "rate_limited", "invalid_payload"]>>;
+                readonly duration_ms: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Number>>;
+                readonly elapsed_ms: import("effect/Schema").Number;
+                readonly event: import("effect/Schema").Literals<readonly ["space_join_span", "state_changed", "connection_failed", "sync_connect_failed", "sync_dial_timeout", "access_refreshed", "access_refresh_failed", "recovery_attempt", "recovery_succeeded", "recovery_exhausted", "cleanup_completed", "cleanup_unconfirmed", "sync_socket_open", "sync_socket_close", "sync_heartbeat_gap", "media_state", "media_http_error"]>;
+                readonly heartbeat_gap_ms: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Number>>;
+                readonly http_status: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Number>>;
+                readonly outcome: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["started", "succeeded", "failed", "cancelled"]>>;
+                readonly phase: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["idle", "connecting", "live", "recovering", "failed", "stopped", "new", "connected", "disconnected", "closed"]>>;
+                readonly state: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["idle", "joining", "live", "reconnecting", "leaving", "left", "failed"]>>;
+                readonly step: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["join", "acquire_initial_media", "access_initialize", "create_media_client", "create_sync_client", "start_media", "start_sync", "wait_for_sync_live", "confirm_entered"]>>;
+            }>>;
+            readonly trigger: import("effect/Schema").Literals<readonly ["join_failed", "connection_lost", "recovery_exhausted"]>;
+            readonly version: import("effect/Schema").Literal<1>;
+        }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Void>, import("effect/Schema").toCodecJson<import("effect/Schema").decodeTo<typeof import("./effect").AccessForbiddenError, import("effect/Schema").Struct<{
+            readonly error: import("effect/Schema").Struct<{
+                readonly code: import("effect/Schema").Literal<"access.forbidden">;
+                readonly message: import("effect/Schema").String;
+            }>;
+        }>, never, never> | import("effect/Schema").decodeTo<typeof import("./effect").AccessUnauthenticatedError, import("effect/Schema").Struct<{
+            readonly error: import("effect/Schema").Struct<{
+                readonly code: import("effect/Schema").Literal<"access.unauthenticated">;
+                readonly message: import("effect/Schema").String;
+            }>;
+        }>, never, never> | import("effect/Schema").decodeTo<typeof import("./effect").RequestInvalidError, import("effect/Schema").Struct<{
+            readonly error: import("effect/Schema").Struct<{
+                readonly code: import("effect/Schema").Literal<"request.invalid">;
+                readonly message: import("effect/Schema").String;
+            }>;
+        }>, never, never> | import("effect/Schema").decodeTo<typeof import("./effect").RequestPayloadTooLargeError, import("effect/Schema").Struct<{
+            readonly error: import("effect/Schema").Struct<{
+                readonly code: import("effect/Schema").Literal<"request.payload_too_large">;
+                readonly message: import("effect/Schema").String;
+            }>;
+        }>, never, never> | import("effect/Schema").decodeTo<typeof import("./effect").RequestRateLimitedError, import("effect/Schema").Struct<{
+            readonly error: import("effect/Schema").Struct<{
+                readonly code: import("effect/Schema").Literal<"request.rate_limited">;
+                readonly message: import("effect/Schema").String;
+            }>;
+        }>, never, never> | import("effect/Schema").decodeTo<typeof import("./effect").ServiceInternalError, import("effect/Schema").Struct<{
+            readonly error: import("effect/Schema").Struct<{
+                readonly code: import("effect/Schema").Literal<"service.internal_error">;
+                readonly message: import("effect/Schema").String;
+            }>;
+        }>, never, never> | import("effect/Schema").decodeTo<typeof import("./effect").ServiceUnavailableError, import("effect/Schema").Struct<{
+            readonly error: import("effect/Schema").Struct<{
+                readonly code: import("effect/Schema").Literal<"service.unavailable">;
+                readonly message: import("effect/Schema").String;
+            }>;
+        }>, never, never> | import("effect/Schema").decodeTo<typeof import("./effect").TenantInvalidIdError, import("effect/Schema").Struct<{
+            readonly error: import("effect/Schema").Struct<{
+                readonly code: import("effect/Schema").Literal<"tenant.invalid_id">;
+                readonly message: import("effect/Schema").String;
+            }>;
+        }>, never, never>>, never, never>, never, never>;
         readonly revokeAPIKey: HttpApiClient.Client.Method<import("effect/unstable/httpapi/HttpApiEndpoint").HttpApiEndpoint<"revokeAPIKey", "DELETE", "/v1/tenants/:tenant_id/api-keys/:api_key_id", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
             readonly api_key_id: import("effect/Schema").brand<import("effect/Schema").String, "UUID">;
             readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;

package/dist/connection/dependencies.d.ts

@@ -1,3 +1,4 @@
+import type { ConnectionReporter, ConnectionReportTransportEvent } from "./report";
 import type { ClientMediaPlane, CloudflareSFUBootstrap, ConnectionMediaSnapshot } from "../media";
 import type { ChalkChatFileTransport } from "../chat-files";
 import type { V1AdmissionTarget, V1AssignableRole, V1CommandResult, V1EpisodeSnapshot, V1SelfMediaTargetResult } from "../sync";
@@ -79,6 +80,8 @@ export type ConnectionMediaFactoryInput = {
     readonly access: ParsedAccessGrant;
     readonly credential: () => Promise<string>;
     readonly replaceMediaConnection?: () => Promise<ParticipantMediaAccess>;
+    readonly traceparent?: string;
+    readonly onTransportDiagnostic?: (event: ConnectionReportTransportEvent) => void;
     readonly onFailure: (error: unknown) => void;
     readonly onScreenEnded: () => void;
 };
@@ -86,6 +89,8 @@ export type ConnectionSyncFactoryInput = {
     readonly access: ParsedAccessGrant;
     readonly token: () => Promise<string>;
     readonly media: ConnectionMediaClient;
+    readonly traceparent?: string;
+    readonly onTransportDiagnostic?: (event: ConnectionReportTransportEvent) => void;
 };
 export type ConnectionWhiteboardFactoryInput = {
     readonly onWatchdogReplacement?: ChalkWhiteboardV1ClientOptions["onWatchdogReplacement"];
@@ -97,6 +102,7 @@ export type ConnectionChatFileFactoryInput = {
 };
 export type ConnectionDependencies = {
     readonly clock: ConnectionClock;
+    readonly createConnectionReporter?: (access: () => ParsedAccessGrant | null) => ConnectionReporter | undefined;
     readonly cancelPendingAdmission?: (access: ParsedAccessGrant, signal: AbortSignal) => Promise<boolean>;
     readonly mediaDevices: ConnectionMediaDevices;
     readonly createMediaClient: (input: ConnectionMediaFactoryInput) => ConnectionMediaClient;

package/dist/connection/diagnostics.d.ts

@@ -32,6 +32,13 @@ export type ConnectionDiagnostic = {
     readonly outcome?: ConnectionJoinTraceOutcome;
     readonly durationMs?: number;
     readonly sync?: import("../sync/connect-diagnostics").SyncConnectDiagnostic;
+    readonly recovery?: {
+        readonly reference: "connection.sync_recovery_exhausted" | "connection.media_recovery_exhausted";
+        readonly attempts: number;
+        readonly transport: import("../sync/connect-diagnostics").SyncRecoveryDiagnostic | null;
+        readonly lastHeartbeatReplyAgoMs: number | null;
+        readonly visibilityState: DocumentVisibilityState | null;
+    };
 };
 export declare class ConnectionDiagnostics {
     #private;
@@ -41,6 +48,13 @@ export declare class ConnectionDiagnostics {
         readonly onEvent?: (event: ConnectionDiagnostic) => void;
     });
     record(input: Omit<ConnectionDiagnostic, "timestamp">): void;
+    recordRecoveryExhausted(input: {
+        readonly state: ConnectionState;
+        readonly epoch: number;
+        readonly code: "sync_recovery_exhausted" | "media_recovery_exhausted";
+        readonly attempts: number;
+        readonly transport: import("../sync/connect-diagnostics").SyncRecoveryDiagnostic | null;
+    }): void;
     snapshot(): readonly ConnectionDiagnostic[];
     startSpan(input: {
         readonly step: ConnectionJoinTraceStep;

package/dist/connection/report.d.ts

@@ -0,0 +1,21 @@
+import type { ParsedAccessGrant } from "../access/grant";
+import type { ConnectionDiagnostic } from "./diagnostics";
+import type { ConnectionReport, ConnectionReportTransportEvent } from "../transport-diagnostics";
+export type { ConnectionReport, ConnectionReportTransportEvent } from "../transport-diagnostics";
+type ReporterOptions = {
+    readonly traceparent: string;
+    readonly now: () => number;
+    readonly access: () => ParsedAccessGrant | null;
+    readonly send: (access: ParsedAccessGrant, report: ConnectionReport, signal: AbortSignal, traceparent: string) => Promise<void>;
+    readonly online: () => boolean;
+    readonly subscribeOnline: (listener: () => void) => () => void;
+};
+/** Only SDK-owned enums and numeric facts enter this buffer. No generic logging. */
+export declare class ConnectionReporter {
+    #private;
+    constructor(options: ReporterOptions);
+    recordDiagnostic(diagnostic: ConnectionDiagnostic): void;
+    recordTransport(event: ConnectionReportTransportEvent): void;
+    dispose(): void;
+    get traceparent(): string;
+}

package/dist/effect.js

@@ -17,8 +17,8 @@ import {
   makeSpaceClientCoreLayer,
   makeSpaceClientCoreLayerFromServices,
   makeSpaceStoreLayer
-} from "./chunk-XPW3OCPO.js";
-import "./chunk-DWKTGBHR.js";
+} from "./chunk-LDPC2JZB.js";
+import "./chunk-3ASKGMD3.js";
 import {
   APIKeyListSchema,
   APIKeyWithSecretSchema,
@@ -139,6 +139,7 @@ import {
   CloudflareSFURenegotiateResponseSchema,
   CloudflareSFUTracksAPIResponseSchema,
   CloudflareSFUTracksRequestSchema,
+  ConnectionReportRequestSchema,
   CreateAPIKey429ResponseHeadersSchema,
   CreateAPIKeyErrorSchema,
   CreateAPIKeyPathParamsSchema,
@@ -548,6 +549,10 @@ import {
   RenegotiateCloudflareSFUPathParamsSchema,
   RenegotiateCloudflareSFURequestBodySchema,
   RenegotiateCloudflareSFUResponseSchema,
+  ReportConnectionFailure429ResponseHeadersSchema,
+  ReportConnectionFailureErrorSchema,
+  ReportConnectionFailurePathParamsSchema,
+  ReportConnectionFailureRequestBodySchema,
   ReportsDeliveryFailedError,
   ReportsDeliveryFailedErrorSchema,
   ReportsDeliveryFailedErrorWireSchema,
@@ -828,8 +833,8 @@ import {
   WhiteboardStorageUnavailableErrorSchema,
   WhiteboardStorageUnavailableErrorWireSchema,
   createChalkEffectClient
-} from "./chunk-GA3JDPFI.js";
-import "./chunk-AIJ5Z6HA.js";
+} from "./chunk-AZONR3Q3.js";
+import "./chunk-5YPQNMJE.js";
 
 // src/space-client/effect.ts
 import { Context, Effect, Exit, Layer, Scope } from "effect";
@@ -990,6 +995,7 @@ export {
   ConnectionAccessService,
   ConnectionLifecycleService,
   ConnectionPlatformService,
+  ConnectionReportRequestSchema,
   CreateAPIKey429ResponseHeadersSchema,
   CreateAPIKeyErrorSchema,
   CreateAPIKeyPathParamsSchema,
@@ -1399,6 +1405,10 @@ export {
   RenegotiateCloudflareSFUPathParamsSchema,
   RenegotiateCloudflareSFURequestBodySchema,
   RenegotiateCloudflareSFUResponseSchema,
+  ReportConnectionFailure429ResponseHeadersSchema,
+  ReportConnectionFailureErrorSchema,
+  ReportConnectionFailurePathParamsSchema,
+  ReportConnectionFailureRequestBodySchema,
   ReportsDeliveryFailedError,
   ReportsDeliveryFailedErrorSchema,
   ReportsDeliveryFailedErrorWireSchema,

package/dist/generated/http-api.d.ts

@@ -1726,6 +1726,65 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
         readonly code: import("effect/Schema").Literal<"tenant.invalid_id">;
         readonly message: import("effect/Schema").String;
     }>;
+}>, never, never>>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"reportConnectionFailure", "POST", "/v1/tenants/:tenant_id/connection-reports", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
+}>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+    readonly events: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly attempt: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Number>>;
+        readonly close_code: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Number>>;
+        readonly code: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["invalid_state", "invalid_access", "access_unavailable", "permission_denied", "device_not_found", "device_busy", "device_constraint_invalid", "media_capture_failed", "sync_start_failed", "state_digest_recovery_failed", "sync_hello_timeout", "media_start_failed", "join_cleanup_unconfirmed", "sync_recovery_exhausted", "media_recovery_exhausted", "command_rejected", "leave_unconfirmed", "episode_ended", "unsupported_environment", "internal_error", "collaboration_unavailable", "chat_cursor_reset_required", "rate_limited", "invalid_payload"]>>;
+        readonly duration_ms: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Number>>;
+        readonly elapsed_ms: import("effect/Schema").Number;
+        readonly event: import("effect/Schema").Literals<readonly ["space_join_span", "state_changed", "connection_failed", "sync_connect_failed", "sync_dial_timeout", "access_refreshed", "access_refresh_failed", "recovery_attempt", "recovery_succeeded", "recovery_exhausted", "cleanup_completed", "cleanup_unconfirmed", "sync_socket_open", "sync_socket_close", "sync_heartbeat_gap", "media_state", "media_http_error"]>;
+        readonly heartbeat_gap_ms: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Number>>;
+        readonly http_status: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Number>>;
+        readonly outcome: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["started", "succeeded", "failed", "cancelled"]>>;
+        readonly phase: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["idle", "connecting", "live", "recovering", "failed", "stopped", "new", "connected", "disconnected", "closed"]>>;
+        readonly state: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["idle", "joining", "live", "reconnecting", "leaving", "left", "failed"]>>;
+        readonly step: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["join", "acquire_initial_media", "access_initialize", "create_media_client", "create_sync_client", "start_media", "start_sync", "wait_for_sync_live", "confirm_entered"]>>;
+    }>>;
+    readonly trigger: import("effect/Schema").Literals<readonly ["join_failed", "connection_lost", "recovery_exhausted"]>;
+    readonly version: import("effect/Schema").Literal<1>;
+}>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Void>, import("effect/Schema").toCodecJson<import("effect/Schema").decodeTo<typeof S.AccessForbiddenError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"access.forbidden">;
+        readonly message: import("effect/Schema").String;
+    }>;
+}>, never, never> | import("effect/Schema").decodeTo<typeof S.AccessUnauthenticatedError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"access.unauthenticated">;
+        readonly message: import("effect/Schema").String;
+    }>;
+}>, never, never> | import("effect/Schema").decodeTo<typeof S.RequestInvalidError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"request.invalid">;
+        readonly message: import("effect/Schema").String;
+    }>;
+}>, never, never> | import("effect/Schema").decodeTo<typeof S.RequestPayloadTooLargeError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"request.payload_too_large">;
+        readonly message: import("effect/Schema").String;
+    }>;
+}>, never, never> | import("effect/Schema").decodeTo<typeof S.RequestRateLimitedError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"request.rate_limited">;
+        readonly message: import("effect/Schema").String;
+    }>;
+}>, never, never> | import("effect/Schema").decodeTo<typeof S.ServiceInternalError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"service.internal_error">;
+        readonly message: import("effect/Schema").String;
+    }>;
+}>, never, never> | import("effect/Schema").decodeTo<typeof S.ServiceUnavailableError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"service.unavailable">;
+        readonly message: import("effect/Schema").String;
+    }>;
+}>, never, never> | import("effect/Schema").decodeTo<typeof S.TenantInvalidIdError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"tenant.invalid_id">;
+        readonly message: import("effect/Schema").String;
+    }>;
 }>, never, never>>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"revokeAPIKey", "DELETE", "/v1/tenants/:tenant_id/api-keys/:api_key_id", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
     readonly api_key_id: import("effect/Schema").brand<import("effect/Schema").String, "UUID">;
     readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;

package/dist/generated/schemas.d.ts

@@ -219,6 +219,25 @@ export declare const CloudflareSFUTracksRequestSchema: Schema.Struct<{
     }>>;
 }>;
 export type CloudflareSFUTracksRequest = typeof CloudflareSFUTracksRequestSchema.Type;
+export declare const ConnectionReportRequestSchema: Schema.Struct<{
+    readonly events: Schema.$Array<Schema.Struct<{
+        readonly attempt: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly close_code: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly code: Schema.optional<Schema.Literals<readonly ["invalid_state", "invalid_access", "access_unavailable", "permission_denied", "device_not_found", "device_busy", "device_constraint_invalid", "media_capture_failed", "sync_start_failed", "state_digest_recovery_failed", "sync_hello_timeout", "media_start_failed", "join_cleanup_unconfirmed", "sync_recovery_exhausted", "media_recovery_exhausted", "command_rejected", "leave_unconfirmed", "episode_ended", "unsupported_environment", "internal_error", "collaboration_unavailable", "chat_cursor_reset_required", "rate_limited", "invalid_payload"]>>;
+        readonly duration_ms: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly elapsed_ms: Schema.Number;
+        readonly event: Schema.Literals<readonly ["space_join_span", "state_changed", "connection_failed", "sync_connect_failed", "sync_dial_timeout", "access_refreshed", "access_refresh_failed", "recovery_attempt", "recovery_succeeded", "recovery_exhausted", "cleanup_completed", "cleanup_unconfirmed", "sync_socket_open", "sync_socket_close", "sync_heartbeat_gap", "media_state", "media_http_error"]>;
+        readonly heartbeat_gap_ms: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly http_status: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly outcome: Schema.optional<Schema.Literals<readonly ["started", "succeeded", "failed", "cancelled"]>>;
+        readonly phase: Schema.optional<Schema.Literals<readonly ["idle", "connecting", "live", "recovering", "failed", "stopped", "new", "connected", "disconnected", "closed"]>>;
+        readonly state: Schema.optional<Schema.Literals<readonly ["idle", "joining", "live", "reconnecting", "leaving", "left", "failed"]>>;
+        readonly step: Schema.optional<Schema.Literals<readonly ["join", "acquire_initial_media", "access_initialize", "create_media_client", "create_sync_client", "start_media", "start_sync", "wait_for_sync_live", "confirm_entered"]>>;
+    }>>;
+    readonly trigger: Schema.Literals<readonly ["join_failed", "connection_lost", "recovery_exhausted"]>;
+    readonly version: Schema.Literal<1>;
+}>;
+export type ConnectionReportRequest = typeof ConnectionReportRequestSchema.Type;
 export declare const CreateAPIKeyRequestSchema: Schema.Struct<{
     readonly expires_at: Schema.brand<Schema.String, "DateTimeString">;
     readonly name: Schema.String;
@@ -3284,6 +3303,35 @@ export declare const RenegotiateCloudflareSFU429ResponseHeadersSchema: Schema.St
     readonly "X-RateLimit-Remaining": Schema.NumberFromString;
 }>;
 export type RenegotiateCloudflareSFU429ResponseHeaders = typeof RenegotiateCloudflareSFU429ResponseHeadersSchema.Type;
+export declare const ReportConnectionFailurePathParamsSchema: Schema.Struct<{
+    readonly tenant_id: Schema.brand<Schema.String, "TenantId">;
+}>;
+export type ReportConnectionFailurePathParams = typeof ReportConnectionFailurePathParamsSchema.Type;
+export declare const ReportConnectionFailureRequestBodySchema: Schema.Struct<{
+    readonly events: Schema.$Array<Schema.Struct<{
+        readonly attempt: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly close_code: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly code: Schema.optional<Schema.Literals<readonly ["invalid_state", "invalid_access", "access_unavailable", "permission_denied", "device_not_found", "device_busy", "device_constraint_invalid", "media_capture_failed", "sync_start_failed", "state_digest_recovery_failed", "sync_hello_timeout", "media_start_failed", "join_cleanup_unconfirmed", "sync_recovery_exhausted", "media_recovery_exhausted", "command_rejected", "leave_unconfirmed", "episode_ended", "unsupported_environment", "internal_error", "collaboration_unavailable", "chat_cursor_reset_required", "rate_limited", "invalid_payload"]>>;
+        readonly duration_ms: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly elapsed_ms: Schema.Number;
+        readonly event: Schema.Literals<readonly ["space_join_span", "state_changed", "connection_failed", "sync_connect_failed", "sync_dial_timeout", "access_refreshed", "access_refresh_failed", "recovery_attempt", "recovery_succeeded", "recovery_exhausted", "cleanup_completed", "cleanup_unconfirmed", "sync_socket_open", "sync_socket_close", "sync_heartbeat_gap", "media_state", "media_http_error"]>;
+        readonly heartbeat_gap_ms: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly http_status: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly outcome: Schema.optional<Schema.Literals<readonly ["started", "succeeded", "failed", "cancelled"]>>;
+        readonly phase: Schema.optional<Schema.Literals<readonly ["idle", "connecting", "live", "recovering", "failed", "stopped", "new", "connected", "disconnected", "closed"]>>;
+        readonly state: Schema.optional<Schema.Literals<readonly ["idle", "joining", "live", "reconnecting", "leaving", "left", "failed"]>>;
+        readonly step: Schema.optional<Schema.Literals<readonly ["join", "acquire_initial_media", "access_initialize", "create_media_client", "create_sync_client", "start_media", "start_sync", "wait_for_sync_live", "confirm_entered"]>>;
+    }>>;
+    readonly trigger: Schema.Literals<readonly ["join_failed", "connection_lost", "recovery_exhausted"]>;
+    readonly version: Schema.Literal<1>;
+}>;
+export type ReportConnectionFailureRequestBody = typeof ReportConnectionFailureRequestBodySchema.Type;
+export declare const ReportConnectionFailure429ResponseHeadersSchema: Schema.Struct<{
+    readonly "Retry-After": Schema.NumberFromString;
+    readonly "X-RateLimit-Limit": Schema.NumberFromString;
+    readonly "X-RateLimit-Remaining": Schema.NumberFromString;
+}>;
+export type ReportConnectionFailure429ResponseHeaders = typeof ReportConnectionFailure429ResponseHeadersSchema.Type;
 export declare const RequestRecordingExportPathParamsSchema: Schema.Struct<{
     readonly recording_id: Schema.brand<Schema.String, "RecordingId">;
     readonly tenant_id: Schema.brand<Schema.String, "TenantId">;
@@ -9843,6 +9891,48 @@ export declare const RenegotiateCloudflareSFUErrorSchema: Schema.Union<readonly
     }>;
 }>, never, never>]>;
 export type RenegotiateCloudflareSFUError = typeof RenegotiateCloudflareSFUErrorSchema.Type;
+export declare const ReportConnectionFailureErrorSchema: Schema.Union<readonly [Schema.decodeTo<typeof AccessForbiddenError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"access.forbidden">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>, Schema.decodeTo<typeof AccessUnauthenticatedError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"access.unauthenticated">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>, Schema.decodeTo<typeof RequestInvalidError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"request.invalid">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>, Schema.decodeTo<typeof RequestPayloadTooLargeError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"request.payload_too_large">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>, Schema.decodeTo<typeof RequestRateLimitedError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"request.rate_limited">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>, Schema.decodeTo<typeof ServiceInternalError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"service.internal_error">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>, Schema.decodeTo<typeof ServiceUnavailableError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"service.unavailable">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>, Schema.decodeTo<typeof TenantInvalidIdError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"tenant.invalid_id">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>]>;
+export type ReportConnectionFailureError = typeof ReportConnectionFailureErrorSchema.Type;
 export declare const RequestRecordingExportErrorSchema: Schema.Union<readonly [Schema.decodeTo<typeof AccessForbiddenError, Schema.Struct<{
     readonly error: Schema.Struct<{
         readonly code: Schema.Literal<"access.forbidden">;
@@ -11346,6 +11436,14 @@ export declare const ChalkOperationPolicies: {
             readonly windowSeconds: 60;
         };
     };
+    readonly reportConnectionFailure: {
+        readonly maxBodyBytes: 32768;
+        readonly rateLimit: {
+            readonly limit: 6;
+            readonly policy: "connection_reports.participant";
+            readonly windowSeconds: 600;
+        };
+    };
     readonly requestRecordingExport: {
         readonly maxBodyBytes: 1048576;
         readonly rateLimit: {

package/dist/generated/sync.d.ts

@@ -37,7 +37,7 @@ export declare const SyncProtocolMetadata: {
         readonly accepts: readonly ["entered", "command", "live_target", "directed_request", "delivery_ack", "request_ack", "reaction_send", "chat_send", "chat_page_request", "chat_read_set", "chat_reaction_set", "ping"];
         readonly heartbeat: {
             readonly intervalMs: 20000;
-            readonly missedDeadlinesBeforeClose: 2;
+            readonly missedDeadlinesBeforeClose: 5;
         };
     }, {
         readonly id: "terminal";

package/dist/generated/whiteboard-v1.d.ts

@@ -11,6 +11,7 @@ export declare const WhiteboardV1ProtocolMetadata: {
         readonly presentation: {
             readonly name: "presentation_v1";
             readonly exactFields: readonly ["name"];
+            readonly presenterExactFields: readonly ["name", "presenter"];
         };
         readonly view: {
             readonly name: "view_v1";
@@ -258,6 +259,7 @@ export type WhiteboardV1SharedAppState = {
 } | null;
 export type WhiteboardV1PresentationExtension = {
     readonly name: "presentation_v1";
+    readonly presenter?: true;
 };
 export type WhiteboardV1ViewExtension = {
     readonly name: "view_v1";
@@ -388,6 +390,7 @@ export type WhiteboardV1ServerFrame = {
     readonly revision: string;
     readonly can_draw: boolean;
     readonly presenting: boolean;
+    readonly presenter_id?: string | null;
     readonly view_owner_id?: string;
 } | {
     readonly type: "snapshot_page";
@@ -451,6 +454,7 @@ export type WhiteboardV1ServerFrame = {
     readonly scene_id: string;
     readonly revision: string;
     readonly presenting: boolean;
+    readonly presenter_id?: string | null;
 } | {
     readonly type: "reset_required";
     readonly scene_id: string;

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   createSpaceClient,
   decodeWhiteboardV1ServerFrame,
   encodeWhiteboardV1ClientFrame
-} from "./chunk-XPW3OCPO.js";
+} from "./chunk-LDPC2JZB.js";
 import {
   CloudflareSFUClient,
   CloudflareSFUError,
@@ -28,19 +28,19 @@ import {
   requireSFUDescription,
   validatePublicationSnapshot,
   waitFor
-} from "./chunk-DWKTGBHR.js";
+} from "./chunk-3ASKGMD3.js";
 import {
   createChalkPublicClient,
   createChalkPublicInviteClient,
   parseInviteCode
-} from "./chunk-6LNRDKJF.js";
+} from "./chunk-SYUGRHZ5.js";
 import {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
   SpacePublicInviteUnavailableError,
   parseParsedAccessGrant,
   requireAccessGrant
-} from "./chunk-GA3JDPFI.js";
+} from "./chunk-AZONR3Q3.js";
 import {
   AsyncStorageV1PendingTargetStore,
   InMemoryV1PendingTargetStore,
@@ -69,7 +69,7 @@ import {
   optimisticV1Control,
   reactionFromFrame,
   restoreV1Snapshot
-} from "./chunk-AIJ5Z6HA.js";
+} from "./chunk-5YPQNMJE.js";
 
 // src/space-client/reload-rejoin.ts
 import { Schema } from "effect";
@@ -123,7 +123,7 @@ var FAILURE_DETAILS = {
   "access.unavailable": "Couldn\u2019t get access to the call. Try again.",
   "connection.sync_start_failed": "Couldn\u2019t reach the call service. Try again.",
   "connection.sync_hello_timeout": "The call service did not respond in time. Try again.",
-  "connection.sync_recovery_exhausted": "The call connection could not recover. Try again.",
+  "connection.sync_recovery_exhausted": "You\u2019re disconnected from the call. Rejoin to continue.",
   "connection.media_start_failed": "Audio and video could not connect. Try again.",
   "connection.media_recovery_exhausted": "Audio and video could not reconnect. Try again.",
   "environment.unsupported": "This device cannot start the call. Use an up-to-date browser over HTTPS, or update the app."

package/dist/media/index.js

@@ -10,7 +10,7 @@ import {
   requireSFUDescription,
   validatePublicationSnapshot,
   waitFor
-} from "../chunk-DWKTGBHR.js";
+} from "../chunk-3ASKGMD3.js";
 export {
   CloudflareSFUClient,
   CloudflareSFUError,

package/dist/media/types.d.ts

@@ -1,3 +1,4 @@
+import type { ConnectionReportTransportEvent } from "../transport-diagnostics";
 import type { MediaPublication, MediaPublicationSource } from "./plane";
 export type CloudflareSFUBootstrap = {
     readonly connectionId: string;
@@ -108,6 +109,8 @@ export type CloudflareSFURestartOptions = {
 };
 export type CloudflareSFUCredentialProvider = (signal?: AbortSignal) => string | Promise<string>;
 export type CloudflareSFUHTTPTransportOptions = {
+    readonly traceparent?: string;
+    readonly onDiagnostic?: (event: ConnectionReportTransportEvent) => void;
     readonly apiBaseURL: string;
     readonly credential?: CloudflareSFUCredentialProvider;
     /** @deprecated Use credential so refreshed media access is read before every request. */

package/dist/public-invites/index.js

@@ -2,12 +2,12 @@ import {
   createChalkPublicClient,
   createChalkPublicInviteClient,
   parseInviteCode
-} from "../chunk-6LNRDKJF.js";
+} from "../chunk-SYUGRHZ5.js";
 import {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
   SpacePublicInviteUnavailableError
-} from "../chunk-GA3JDPFI.js";
+} from "../chunk-AZONR3Q3.js";
 export {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,

package/dist/space-client/types.d.ts

@@ -203,6 +203,7 @@ export type WhiteboardSlice = {
         readonly sceneId: string | null;
         readonly revision: string | null;
         readonly presenting: boolean;
+        readonly presenterId?: string | null;
         readonly error: ChalkWhiteboardV1Failure | null;
     };
     /** Who can draw, as Sync last told this person. `canDraw` is false until the board subscription is live. */

package/dist/sync/connect-diagnostics.d.ts

@@ -1,3 +1,13 @@
+/** Transport facts only. No URLs, close reasons, payloads, or identities. */
+export type SyncRecoveryDiagnostic = {
+    readonly socketAttempts: number;
+    readonly socketCloses: readonly {
+        readonly code: number;
+        readonly wasClean: boolean | null;
+    }[];
+    readonly omittedSocketCloses: number;
+    readonly lastHeartbeatReplyAt: number | null;
+};
 /** Browsers expose only upgrade/open and hello, never DNS/TCP/TLS progress. */
 export type SyncConnectDiagnostic = {
     readonly stage: "upgrade" | "hello";

package/dist/sync/index.js

@@ -22,7 +22,7 @@ import {
   encodeV1ClientFrame,
   optimisticV1Control,
   restoreV1Snapshot
-} from "../chunk-AIJ5Z6HA.js";
+} from "../chunk-5YPQNMJE.js";
 export {
   AsyncStorageV1PendingTargetStore,
   InMemoryV1PendingTargetStore,

package/dist/sync/react-native.d.ts

@@ -7,6 +7,7 @@ export type ReactNativeAsyncStorage = {
 export type ReactNativeWebSocketCloseEvent = {
     readonly code?: unknown;
     readonly reason?: unknown;
+    readonly wasClean?: unknown;
 };
 export type ReactNativeWebSocket = {
     onopen: ((event: unknown) => void) | null;

package/dist/sync/types.d.ts

@@ -10,6 +10,7 @@ export type SyncSocket = {
     onclose: ((event: {
         readonly code: number;
         readonly reason?: string;
+        readonly wasClean?: boolean;
     }) => void) | null;
     onerror: (() => void) | null;
     send(data: string): void;

package/dist/sync/v1-types.d.ts

@@ -1,3 +1,4 @@
+import type { ConnectionReportTransportEvent } from "../transport-diagnostics";
 import type { SetAdmissionPolicyCommandFrame, SyncV1ServerFrame } from "../generated/sync";
 import type { ClientMediaPlane, MediaPlaneOutcome, MediaPlaneResult, MediaPlaneTarget, MediaPublication, MediaSource } from "../media/plane";
 import type { ChalkChatReactionInput, ChalkChatReactions, ChalkChatMessage, ChalkChatPageResult, ChalkChatReadReceipt, ChalkReaction, ChalkReactionEvent, ChalkSendChatMessageInput, ChalkSyncV1CollaborationCapability } from "../collaboration/types";
@@ -81,6 +82,7 @@ export type V1EpisodeSnapshot = {
         readonly dialTimeoutCount?: number;
         readonly connectAttempt?: import("./connect-diagnostics").SyncConnectDiagnostic;
         readonly connectFailure?: import("./connect-diagnostics").SyncConnectDiagnostic;
+        readonly recoveryDiagnostic?: import("./connect-diagnostics").SyncRecoveryDiagnostic;
     };
     readonly participantId: string | null;
     readonly participantGeneration: number | null;
@@ -188,6 +190,8 @@ export type V1CollaborationClient = {
     }) => Promise<ChalkChatPageResult>;
 };
 export type V1SyncClientOptions = {
+    readonly traceparent?: string;
+    readonly onDiagnostic?: (event: ConnectionReportTransportEvent) => void;
     readonly url: string;
     readonly token: () => Promise<string>;
     readonly webSocket: SyncWebSocketFactory;

package/dist/transport-diagnostics.d.ts

@@ -0,0 +1,3 @@
+import type { components } from "./generated/openapi-types";
+export type ConnectionReport = components["schemas"]["ConnectionReportRequest"];
+export type ConnectionReportTransportEvent = Pick<ConnectionReport["events"][number], "event" | "phase" | "attempt" | "duration_ms" | "heartbeat_gap_ms" | "close_code" | "http_status">;