@q9labsai/chalk-client 5.2.3 → 5.2.5

package/dist/connection/lifecycle.d.ts

@@ -39,6 +39,7 @@ export type ConnectionLifecycleCapability = {
     }>) => Effect.Effect<void, ConnectionLifecycleFailure>;
     readonly getSyncToken: () => Effect.Effect<string, ConnectionLifecycleFailure>;
     readonly confirmEpisodeEnded: Effect.Effect<void>;
+    readonly runEpisodeEnd: <A, E>(operation: Effect.Effect<A, E>) => Effect.Effect<A, E>;
     readonly join: () => Effect.Effect<void, ConnectionLifecycleFailure>;
     readonly leave: () => Effect.Effect<void, ConnectionLifecycleFailure>;
     readonly runCommand: <A, E>(operation: (ports: ConnectionPorts) => Effect.Effect<A, E>) => Effect.Effect<A, ConnectionLifecycleFailure | E>;
@@ -47,6 +48,7 @@ export type ConnectionLifecycleCapability = {
     readonly scheduleUnsafe: (callback: () => void, milliseconds: number) => unknown;
     readonly cancelScheduleUnsafe: (handle: unknown) => void;
     readonly createId: () => string;
+    readonly recordTransportDiagnostic: (event: import("./report").ConnectionReportTransportEvent) => void;
 };
 declare const ConnectionLifecycleService_base: Context.ServiceClass<ConnectionLifecycleService, "@chalk/client/ConnectionLifecycle", ConnectionLifecycleCapability>;
 export declare class ConnectionLifecycleService extends ConnectionLifecycleService_base {

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-4ZUN55Z2.js";
-import "./chunk-DWKTGBHR.js";
+} from "./chunk-BUNSEDXL.js";
+import "./chunk-FD25AMLG.js";
 import {
   APIKeyListSchema,
   APIKeyWithSecretSchema,
@@ -139,6 +139,7 @@ import {
   CloudflareSFURenegotiateResponseSchema,
   CloudflareSFUTracksAPIResponseSchema,
   CloudflareSFUTracksRequestSchema,
+  ConnectionReportRequestSchema,
   CreateAPIKey429ResponseHeadersSchema,
   CreateAPIKeyErrorSchema,
   CreateAPIKeyPathParamsSchema,
@@ -260,6 +261,10 @@ import {
   GetEpisodeErrorSchema,
   GetEpisodePathParamsSchema,
   GetEpisodeResponseSchema,
+  GetParticipantEpisodeStatus429ResponseHeadersSchema,
+  GetParticipantEpisodeStatusErrorSchema,
+  GetParticipantEpisodeStatusPathParamsSchema,
+  GetParticipantEpisodeStatusResponseSchema,
   GetProblemReportAvailabilityErrorSchema,
   GetProblemReportAvailabilityPathParamsSchema,
   GetProblemReportAvailabilityResponseSchema,
@@ -450,6 +455,7 @@ import {
   ParticipantConnectionSupersededError,
   ParticipantConnectionSupersededErrorSchema,
   ParticipantConnectionSupersededErrorWireSchema,
+  ParticipantEpisodeStatusSchema,
   ParticipantGenerationMismatchError,
   ParticipantGenerationMismatchErrorSchema,
   ParticipantGenerationMismatchErrorWireSchema,
@@ -459,6 +465,9 @@ import {
   ParticipantInvalidIdErrorWireSchema,
   ParticipantJoinCancellationSchema,
   ParticipantLifecycleSchema,
+  ParticipantMediaReplacementPendingError,
+  ParticipantMediaReplacementPendingErrorSchema,
+  ParticipantMediaReplacementPendingErrorWireSchema,
   ParticipantNotActiveError,
   ParticipantNotActiveErrorSchema,
   ParticipantNotActiveErrorWireSchema,
@@ -548,6 +557,10 @@ import {
   RenegotiateCloudflareSFUPathParamsSchema,
   RenegotiateCloudflareSFURequestBodySchema,
   RenegotiateCloudflareSFUResponseSchema,
+  ReportConnectionFailure429ResponseHeadersSchema,
+  ReportConnectionFailureErrorSchema,
+  ReportConnectionFailurePathParamsSchema,
+  ReportConnectionFailureRequestBodySchema,
   ReportsDeliveryFailedError,
   ReportsDeliveryFailedErrorSchema,
   ReportsDeliveryFailedErrorWireSchema,
@@ -828,8 +841,8 @@ import {
   WhiteboardStorageUnavailableErrorSchema,
   WhiteboardStorageUnavailableErrorWireSchema,
   createChalkEffectClient
-} from "./chunk-GA3JDPFI.js";
-import "./chunk-IMMT22US.js";
+} from "./chunk-UMAE5GCV.js";
+import "./chunk-5YPQNMJE.js";
 
 // src/space-client/effect.ts
 import { Context, Effect, Exit, Layer, Scope } from "effect";
@@ -990,6 +1003,7 @@ export {
   ConnectionAccessService,
   ConnectionLifecycleService,
   ConnectionPlatformService,
+  ConnectionReportRequestSchema,
   CreateAPIKey429ResponseHeadersSchema,
   CreateAPIKeyErrorSchema,
   CreateAPIKeyPathParamsSchema,
@@ -1111,6 +1125,10 @@ export {
   GetEpisodeErrorSchema,
   GetEpisodePathParamsSchema,
   GetEpisodeResponseSchema,
+  GetParticipantEpisodeStatus429ResponseHeadersSchema,
+  GetParticipantEpisodeStatusErrorSchema,
+  GetParticipantEpisodeStatusPathParamsSchema,
+  GetParticipantEpisodeStatusResponseSchema,
   GetProblemReportAvailabilityErrorSchema,
   GetProblemReportAvailabilityPathParamsSchema,
   GetProblemReportAvailabilityResponseSchema,
@@ -1301,6 +1319,7 @@ export {
   ParticipantConnectionSupersededError,
   ParticipantConnectionSupersededErrorSchema,
   ParticipantConnectionSupersededErrorWireSchema,
+  ParticipantEpisodeStatusSchema,
   ParticipantGenerationMismatchError,
   ParticipantGenerationMismatchErrorSchema,
   ParticipantGenerationMismatchErrorWireSchema,
@@ -1310,6 +1329,9 @@ export {
   ParticipantInvalidIdErrorWireSchema,
   ParticipantJoinCancellationSchema,
   ParticipantLifecycleSchema,
+  ParticipantMediaReplacementPendingError,
+  ParticipantMediaReplacementPendingErrorSchema,
+  ParticipantMediaReplacementPendingErrorWireSchema,
   ParticipantNotActiveError,
   ParticipantNotActiveErrorSchema,
   ParticipantNotActiveErrorWireSchema,
@@ -1399,6 +1421,10 @@ export {
   RenegotiateCloudflareSFUPathParamsSchema,
   RenegotiateCloudflareSFURequestBodySchema,
   RenegotiateCloudflareSFUResponseSchema,
+  ReportConnectionFailure429ResponseHeadersSchema,
+  ReportConnectionFailureErrorSchema,
+  ReportConnectionFailurePathParamsSchema,
+  ReportConnectionFailureRequestBodySchema,
   ReportsDeliveryFailedError,
   ReportsDeliveryFailedErrorSchema,
   ReportsDeliveryFailedErrorWireSchema,

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

@@ -1037,6 +1037,7 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
     readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
 }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
     readonly current_media_token: import("effect/Schema").optional<import("effect/Schema").String>;
+    readonly expected_media_connection_id: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").String>>;
     readonly participant_generation: import("effect/Schema").Number;
     readonly replace_media_connection: import("effect/Schema").Boolean;
 }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
@@ -1158,6 +1159,11 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
         readonly code: import("effect/Schema").Literal<"participant.invalid_id">;
         readonly message: import("effect/Schema").String;
     }>;
+}>, never, never> | import("effect/Schema").decodeTo<typeof S.ParticipantMediaReplacementPendingError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"participant.media_replacement_pending">;
+        readonly message: import("effect/Schema").String;
+    }>;
 }>, never, never> | import("effect/Schema").decodeTo<typeof S.ParticipantNotFoundError, import("effect/Schema").Struct<{
     readonly error: import("effect/Schema").Struct<{
         readonly code: import("effect/Schema").Literal<"participant.not_found">;
@@ -1726,6 +1732,72 @@ 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", "media_projection_mismatch"]>;
+        readonly granted_audio: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["granted", "not_granted", "unknown"]>>;
+        readonly granted_video: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["granted", "not_granted", "unknown"]>>;
+        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 media_error_kind: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["NotAllowedError", "NotReadableError", "NotFoundError", "OverconstrainedError", "AbortError", "SecurityError", "InvalidStateError", "OperationError", "NotSupportedError", "CloudflareSFUError", "network", "timeout", "unknown"]>>;
+        readonly media_error_step: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["local_capture", "peer_connection", "access_refresh", "sfu_tracks", "sfu_close_tracks", "sfu_renegotiate", "sfu_publications"]>>;
+        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 projection_state: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["on", "off"]>>;
+        readonly publication_state: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["on", "off"]>>;
+        readonly source: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["microphone", "camera"]>>;
+        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", "media_projection_mismatch"]>;
+    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">;
@@ -2871,6 +2943,63 @@ 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<"getParticipantEpisodeStatus", "GET", "/v1/tenants/:tenant_id/spaces/:space_id/episodes/:episode_id/participants/:participant_id/episode-status", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly episode_id: import("effect/Schema").brand<import("effect/Schema").String, "EpisodeId">;
+    readonly participant_id: import("effect/Schema").brand<import("effect/Schema").String, "ParticipantId">;
+    readonly space_id: import("effect/Schema").brand<import("effect/Schema").String, "SpaceId">;
+    readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
+}>>, never, never, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+    readonly status: import("effect/Schema").Literals<readonly ["active", "ending", "ended"]>;
+}>>, 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.EpisodeInvalidIdError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"episode.invalid_id">;
+        readonly message: import("effect/Schema").String;
+    }>;
+}>, never, never> | import("effect/Schema").decodeTo<typeof S.EpisodeNotFoundError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"episode.not_found">;
+        readonly message: import("effect/Schema").String;
+    }>;
+}>, never, never> | import("effect/Schema").decodeTo<typeof S.ParticipantInvalidIdError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"participant.invalid_id">;
+        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.SpaceInvalidIdError, import("effect/Schema").Struct<{
+    readonly error: import("effect/Schema").Struct<{
+        readonly code: import("effect/Schema").Literal<"space.invalid_id">;
+        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<"issueEpisodeParticipantSyncToken", "POST", "/v1/tenants/:tenant_id/spaces/:space_id/episodes/:episode_id/participants/:participant_id/sync-token", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
     readonly episode_id: import("effect/Schema").brand<import("effect/Schema").String, "EpisodeId">;
     readonly participant_id: import("effect/Schema").brand<import("effect/Schema").String, "ParticipantId">;

package/dist/generated/schemas.d.ts

@@ -219,6 +219,32 @@ 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", "media_projection_mismatch"]>;
+        readonly granted_audio: Schema.optional<Schema.Literals<readonly ["granted", "not_granted", "unknown"]>>;
+        readonly granted_video: Schema.optional<Schema.Literals<readonly ["granted", "not_granted", "unknown"]>>;
+        readonly heartbeat_gap_ms: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly http_status: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly media_error_kind: Schema.optional<Schema.Literals<readonly ["NotAllowedError", "NotReadableError", "NotFoundError", "OverconstrainedError", "AbortError", "SecurityError", "InvalidStateError", "OperationError", "NotSupportedError", "CloudflareSFUError", "network", "timeout", "unknown"]>>;
+        readonly media_error_step: Schema.optional<Schema.Literals<readonly ["local_capture", "peer_connection", "access_refresh", "sfu_tracks", "sfu_close_tracks", "sfu_renegotiate", "sfu_publications"]>>;
+        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 projection_state: Schema.optional<Schema.Literals<readonly ["on", "off"]>>;
+        readonly publication_state: Schema.optional<Schema.Literals<readonly ["on", "off"]>>;
+        readonly source: Schema.optional<Schema.Literals<readonly ["microphone", "camera"]>>;
+        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", "media_projection_mismatch"]>;
+    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;
@@ -424,6 +450,7 @@ export declare const IntegrationServiceIdSchema: Schema.brand<Schema.String, "In
 export type IntegrationServiceId = typeof IntegrationServiceIdSchema.Type;
 export declare const IssueAccessGrantRequestSchema: Schema.Struct<{
     readonly current_media_token: Schema.optional<Schema.String>;
+    readonly expected_media_connection_id: Schema.optional<Schema.NullOr<Schema.String>>;
     readonly participant_generation: Schema.Number;
     readonly replace_media_connection: Schema.Boolean;
 }>;
@@ -459,6 +486,10 @@ export declare const MembershipListSchema: Schema.Struct<{
     }>;
 }>;
 export type MembershipList = typeof MembershipListSchema.Type;
+export declare const ParticipantEpisodeStatusSchema: Schema.Struct<{
+    readonly status: Schema.Literals<readonly ["active", "ending", "ended"]>;
+}>;
+export type ParticipantEpisodeStatus = typeof ParticipantEpisodeStatusSchema.Type;
 export declare const ParticipantJoinCancellationSchema: Schema.Struct<{
     readonly cancelled: Schema.Boolean;
 }>;
@@ -2216,6 +2247,23 @@ export declare const GetEpisodeAttendance429ResponseHeadersSchema: Schema.Struct
     readonly "X-RateLimit-Remaining": Schema.NumberFromString;
 }>;
 export type GetEpisodeAttendance429ResponseHeaders = typeof GetEpisodeAttendance429ResponseHeadersSchema.Type;
+export declare const GetParticipantEpisodeStatusPathParamsSchema: Schema.Struct<{
+    readonly episode_id: Schema.brand<Schema.String, "EpisodeId">;
+    readonly participant_id: Schema.brand<Schema.String, "ParticipantId">;
+    readonly space_id: Schema.brand<Schema.String, "SpaceId">;
+    readonly tenant_id: Schema.brand<Schema.String, "TenantId">;
+}>;
+export type GetParticipantEpisodeStatusPathParams = typeof GetParticipantEpisodeStatusPathParamsSchema.Type;
+export declare const GetParticipantEpisodeStatusResponseSchema: Schema.Struct<{
+    readonly status: Schema.Literals<readonly ["active", "ending", "ended"]>;
+}>;
+export type GetParticipantEpisodeStatusResponse = typeof GetParticipantEpisodeStatusResponseSchema.Type;
+export declare const GetParticipantEpisodeStatus429ResponseHeadersSchema: Schema.Struct<{
+    readonly "Retry-After": Schema.NumberFromString;
+    readonly "X-RateLimit-Limit": Schema.NumberFromString;
+    readonly "X-RateLimit-Remaining": Schema.NumberFromString;
+}>;
+export type GetParticipantEpisodeStatus429ResponseHeaders = typeof GetParticipantEpisodeStatus429ResponseHeadersSchema.Type;
 export declare const GetProblemReportAvailabilityPathParamsSchema: Schema.Struct<{
     readonly tenant_id: Schema.brand<Schema.String, "TenantId">;
 }>;
@@ -2580,6 +2628,7 @@ export declare const IssueAccessGrantPathParamsSchema: Schema.Struct<{
 export type IssueAccessGrantPathParams = typeof IssueAccessGrantPathParamsSchema.Type;
 export declare const IssueAccessGrantRequestBodySchema: Schema.Struct<{
     readonly current_media_token: Schema.optional<Schema.String>;
+    readonly expected_media_connection_id: Schema.optional<Schema.NullOr<Schema.String>>;
     readonly participant_generation: Schema.Number;
     readonly replace_media_connection: Schema.Boolean;
 }>;
@@ -3284,6 +3333,42 @@ 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", "media_projection_mismatch"]>;
+        readonly granted_audio: Schema.optional<Schema.Literals<readonly ["granted", "not_granted", "unknown"]>>;
+        readonly granted_video: Schema.optional<Schema.Literals<readonly ["granted", "not_granted", "unknown"]>>;
+        readonly heartbeat_gap_ms: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly http_status: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly media_error_kind: Schema.optional<Schema.Literals<readonly ["NotAllowedError", "NotReadableError", "NotFoundError", "OverconstrainedError", "AbortError", "SecurityError", "InvalidStateError", "OperationError", "NotSupportedError", "CloudflareSFUError", "network", "timeout", "unknown"]>>;
+        readonly media_error_step: Schema.optional<Schema.Literals<readonly ["local_capture", "peer_connection", "access_refresh", "sfu_tracks", "sfu_close_tracks", "sfu_renegotiate", "sfu_publications"]>>;
+        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 projection_state: Schema.optional<Schema.Literals<readonly ["on", "off"]>>;
+        readonly publication_state: Schema.optional<Schema.Literals<readonly ["on", "off"]>>;
+        readonly source: Schema.optional<Schema.Literals<readonly ["microphone", "camera"]>>;
+        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", "media_projection_mismatch"]>;
+    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">;
@@ -4814,6 +4899,26 @@ export declare const ParticipantInvalidIdErrorSchema: Schema.decodeTo<typeof Par
         readonly message: Schema.String;
     }>;
 }>, never, never>;
+declare const ParticipantMediaReplacementPendingError_base: Schema.Class<ParticipantMediaReplacementPendingError, Schema.TaggedStruct<"ParticipantMediaReplacementPendingError", {
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"participant.media_replacement_pending">;
+        readonly message: Schema.String;
+    }>;
+}>, import("effect/Cause").YieldableError>;
+export declare class ParticipantMediaReplacementPendingError extends ParticipantMediaReplacementPendingError_base {
+}
+export declare const ParticipantMediaReplacementPendingErrorWireSchema: Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"participant.media_replacement_pending">;
+        readonly message: Schema.String;
+    }>;
+}>;
+export declare const ParticipantMediaReplacementPendingErrorSchema: Schema.decodeTo<typeof ParticipantMediaReplacementPendingError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"participant.media_replacement_pending">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>;
 declare const ParticipantNotActiveError_base: Schema.Class<ParticipantNotActiveError, Schema.TaggedStruct<"ParticipantNotActiveError", {
     readonly error: Schema.Struct<{
         readonly code: Schema.Literal<"participant.not_active">;
@@ -7821,6 +7926,58 @@ export declare const GetEpisodeErrorSchema: Schema.Union<readonly [Schema.decode
     }>;
 }>, never, never>]>;
 export type GetEpisodeError = typeof GetEpisodeErrorSchema.Type;
+export declare const GetParticipantEpisodeStatusErrorSchema: 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 EpisodeInvalidIdError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"episode.invalid_id">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>, Schema.decodeTo<typeof EpisodeNotFoundError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"episode.not_found">;
+        readonly message: Schema.String;
+    }>;
+}>, never, never>, Schema.decodeTo<typeof ParticipantInvalidIdError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"participant.invalid_id">;
+        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 SpaceInvalidIdError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"space.invalid_id">;
+        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 GetParticipantEpisodeStatusError = typeof GetParticipantEpisodeStatusErrorSchema.Type;
 export declare const GetProblemReportAvailabilityErrorSchema: Schema.decodeTo<typeof TenantInvalidIdError, Schema.Struct<{
     readonly error: Schema.Struct<{
         readonly code: Schema.Literal<"tenant.invalid_id">;
@@ -8537,6 +8694,11 @@ export declare const IssueAccessGrantErrorSchema: Schema.Union<readonly [Schema.
         readonly code: Schema.Literal<"participant.invalid_id">;
         readonly message: Schema.String;
     }>;
+}>, never, never>, Schema.decodeTo<typeof ParticipantMediaReplacementPendingError, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.Literal<"participant.media_replacement_pending">;
+        readonly message: Schema.String;
+    }>;
 }>, never, never>, Schema.decodeTo<typeof ParticipantNotFoundError, Schema.Struct<{
     readonly error: Schema.Struct<{
         readonly code: Schema.Literal<"participant.not_found">;
@@ -9843,6 +10005,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">;
@@ -11178,6 +11382,13 @@ export declare const ChalkOperationPolicies: {
             readonly windowSeconds: 60;
         };
     };
+    readonly getParticipantEpisodeStatus: {
+        readonly rateLimit: {
+            readonly limit: 300;
+            readonly policy: "v1.authenticated.read";
+            readonly windowSeconds: 60;
+        };
+    };
     readonly getSpacePublicInvite: {
         readonly rateLimit: {
             readonly limit: 300;
@@ -11346,6 +11557,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: {