reactor-effect-client 0.0.0-reserved.0 → 0.2.0

package/dist/h3/types.d.ts

@@ -0,0 +1,173 @@
+import type * as Effect from "effect/Effect";
+import type * as Result from "effect/Result";
+import type * as Scope from "effect/Scope";
+import type * as Stream from "effect/Stream";
+import type { ReactorError } from "../errors.js";
+import type { CommandFailure, CommandReply, SessionEvent } from "../session/index.js";
+import type { Submission } from "../Submission.js";
+import type { UploadReference } from "../wire.generated.js";
+import type { Clip, DecodedMessage, Message, MessageType, Payload, Queue, State } from "./messages.js";
+import type { CanvasAspect, documentedVersion, imageMimeTypes, modelName } from "./profile.js";
+export type Aspect = CanvasAspect;
+export type Reference = {
+    readonly _tag: "Bytes";
+    readonly bytes: Uint8Array;
+} | {
+    readonly _tag: "Uploaded";
+    readonly file: UploadReference;
+};
+declare const validatedReference: unique symbol;
+/** Opaque validated input. Byte storage is private and detached from the caller. */
+export interface ValidatedReference {
+    readonly [validatedReference]: true;
+    readonly _tag: "ValidatedReference";
+    readonly mimeType: (typeof imageMimeTypes)[number];
+    readonly size: number;
+    readonly width: number | null;
+    readonly height: number | null;
+}
+export interface Request {
+    readonly prompt: string;
+    readonly references?: readonly (Reference | ValidatedReference)[];
+    readonly seconds?: number;
+    readonly seed?: number;
+    readonly position?: number;
+    readonly continueFrom?: string;
+    /** User metadata is a provider string. Local acceptance wraps and preserves it. */
+    readonly metadata?: string;
+}
+export interface Contract {
+    readonly modelName: typeof modelName;
+    readonly documentedVersion: typeof documentedVersion;
+    readonly source: string;
+    readonly subset: "prompt-and-images";
+    readonly deployment: {
+        readonly title: string | null;
+        readonly version: string | null;
+    };
+}
+export interface Facts {
+    readonly state: State;
+    readonly queue: Queue;
+}
+export interface ClipObservation {
+    readonly clip: Clip;
+    /** Last explicit clip lifecycle event; null means only a queue snapshot listed it. */
+    readonly lifecycle: Exclude<MessageType, "queue_update" | "state_update"> | null;
+    readonly source: CommandReply;
+}
+interface SnapshotBase {
+    readonly sessionId: string;
+    readonly transportGeneration: bigint;
+    readonly revision: bigint;
+    readonly clips: readonly ClipObservation[];
+}
+export type ProviderSnapshot = SnapshotBase & ({
+    readonly _tag: "Synchronizing";
+    readonly lastFacts: Facts | null;
+} | {
+    readonly _tag: "Ready";
+    readonly state: State;
+    readonly queue: Queue;
+} | {
+    readonly _tag: "Unavailable";
+    readonly cause: ReactorError;
+    readonly lastFacts: Facts | null;
+});
+export interface Acceptance {
+    readonly submissionId: string;
+    readonly clip: Clip;
+    readonly evidence: {
+        readonly kind: "correlated" | "metadata";
+        readonly source: CommandReply;
+    };
+}
+export interface Reply<K extends MessageType> {
+    readonly value: Payload<K>;
+    readonly source: CommandReply;
+}
+/** An ACK establishes command receipt, never an invented model payload. */
+export type ControlResult = {
+    readonly _tag: "Acknowledged";
+    readonly source: CommandReply;
+} | {
+    readonly _tag: "Reply";
+    readonly message: Message;
+    readonly source: CommandReply;
+};
+export type ProviderEvent = {
+    readonly _tag: "Message";
+    readonly message: DecodedMessage;
+    readonly source: CommandReply;
+    readonly disposition: "applied" | "duplicate" | "stale";
+} | {
+    readonly _tag: "Acknowledged";
+    readonly source: CommandReply;
+} | {
+    readonly _tag: "Acceptance";
+    readonly acceptance: Acceptance;
+} | {
+    readonly _tag: "Session";
+    readonly source: Exclude<SessionEvent, CommandReply>;
+} | {
+    readonly _tag: "Diagnostic";
+    readonly error: ReactorError;
+    readonly source?: SessionEvent;
+};
+export interface ObservationOptions {
+    readonly capacity?: number;
+    readonly maxBytes?: number;
+}
+export interface ProviderObservation {
+    readonly initial: ProviderSnapshot;
+    readonly revision: bigint;
+    readonly events: Stream.Stream<ProviderEvent, ReactorError>;
+}
+export interface PrepareHooks {
+    readonly commit?: (submissionId: string) => Effect.Effect<void, CommandFailure>;
+    /** A post-commit observer. Failure is diagnostic and cannot rewrite remote evidence. */
+    readonly result?: (submissionId: string, result: Result.Result<Acceptance, CommandFailure>) => Effect.Effect<void>;
+}
+export interface Options {
+    readonly commandTimeoutMs?: number;
+    readonly setupTimeoutMs?: number;
+    readonly reconcileWindowMs?: number;
+    readonly resultHookTimeoutMs?: number;
+    readonly maxPending?: number;
+    readonly maxTrackedClips?: number;
+    readonly maxAcceptances?: number;
+    readonly maxCachedUploads?: number;
+    readonly maxRetainedBytes?: number;
+    readonly maxPromptBytes?: number;
+    readonly observation?: ObservationOptions;
+}
+export interface Provider {
+    readonly sessionId: string;
+    readonly contract: Contract;
+    readonly current: Effect.Effect<ProviderSnapshot>;
+    readonly observe: (options?: ObservationOptions) => Effect.Effect<ProviderObservation, ReactorError, Scope.Scope>;
+    readonly events: (options?: ObservationOptions) => Stream.Stream<ProviderEvent, ReactorError>;
+    readonly failure: Effect.Effect<ReactorError>;
+    /** Local annotations are separate from the provider's authoritative state. */
+    readonly acceptances: Effect.Effect<readonly Acceptance[]>;
+    readonly acceptance: (submissionId: string) => Effect.Effect<Acceptance | undefined>;
+    readonly prepare: (request: Request, hooks?: PrepareHooks) => Effect.Effect<Submission<Acceptance, CommandFailure>, ReactorError>;
+    /** Host IO belongs to the same provisional scope and commit owner as static preparation. */
+    readonly prepareFrom: (preparation: Effect.Effect<Request, ReactorError, Scope.Scope>, hooks?: PrepareHooks) => Effect.Effect<Submission<Acceptance, CommandFailure>, ReactorError>;
+    readonly enqueue: (request: Request) => Effect.Effect<Acceptance, CommandFailure>;
+    readonly getState: Effect.Effect<Reply<"state_update">, CommandFailure>;
+    readonly getQueue: Effect.Effect<Reply<"queue_update">, CommandFailure>;
+    readonly refresh: Effect.Effect<void, CommandFailure>;
+    readonly pop: (clipId: string) => Effect.Effect<Reply<"clip_popped">, CommandFailure>;
+    readonly move: (clipId: string, position: number) => Effect.Effect<Reply<"clip_moved">, CommandFailure>;
+    readonly play: (clipId?: string) => Effect.Effect<ControlResult, CommandFailure>;
+    readonly stop: Effect.Effect<ControlResult, CommandFailure>;
+    readonly setSeed: (seed: number) => Effect.Effect<Reply<"seed_accepted">, CommandFailure>;
+    readonly setClipSeconds: (seconds: number) => Effect.Effect<Reply<"clip_length_accepted">, CommandFailure>;
+    readonly setCanvas: (aspect: Aspect) => Effect.Effect<Reply<"canvas_accepted">, CommandFailure>;
+    readonly setAutoplay: (enabled: boolean) => Effect.Effect<Reply<"autoplay_accepted">, CommandFailure>;
+    readonly setFlushOnClipEnd: (enabled: boolean) => Effect.Effect<Reply<"flush_accepted">, CommandFailure>;
+    readonly reset: Effect.Effect<Reply<"session_reset">, CommandFailure>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/h3/types.d.ts.map

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

package/dist/h3/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/h3/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/h3/types.ts"],"names":[],"mappings":""}

package/dist/host.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Host transport extension surface.
+ *
+ * reactor-effect-browser and reactor-effect-native implement the peer contract
+ * and project a connected session's media generations through this module. It
+ * is published for those first-party host packages, which pin this exact
+ * version, and is not part of the application-facing contract: applications
+ * compose hosts through their packages and read media through their `media`
+ * functions. Nothing here allocates or owns a session.
+ */
+export { errorOf, positiveLimit } from "./errors.js";
+export { finite, isRecord, record } from "./json.js";
+export { fromOwnedReadableStream } from "./media-stream.js";
+export { terminal } from "./contract.js";
+export type { IceCandidate, IceServer } from "./contract.js";
+export { Observations } from "./observation.js";
+export type { ObservationOptions } from "./observation.js";
+export { CoordinatorClient } from "./coordinator/_internal/client.js";
+export { retryAfterMs } from "./coordinator/_internal/response.js";
+export { mediaGeneration, trackGeneration } from "./session/_internal/acquire.js";
+export type { Channel, MediaTrack, Peer, PeerEvent, PeerState, Prepared } from "./PeerTypes.js";
+export type { AudioFrame, MediaGeneration, MediaPressure, RawMedia, TrackGeneration, VideoFrame, } from "./session/media.js";
+export { readFileBytes, uploadFile } from "./session/files.js";
+export type { FileUploadOptions } from "./session/files.js";
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAClF,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAChG,YAAY,EACV,UAAU,EACV,eAAe,EACf,aAAa,EACb,QAAQ,EACR,eAAe,EACf,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/host.js

@@ -0,0 +1,20 @@
+/**
+ * Host transport extension surface.
+ *
+ * reactor-effect-browser and reactor-effect-native implement the peer contract
+ * and project a connected session's media generations through this module. It
+ * is published for those first-party host packages, which pin this exact
+ * version, and is not part of the application-facing contract: applications
+ * compose hosts through their packages and read media through their `media`
+ * functions. Nothing here allocates or owns a session.
+ */
+export { errorOf, positiveLimit } from "./errors.js";
+export { finite, isRecord, record } from "./json.js";
+export { fromOwnedReadableStream } from "./media-stream.js";
+export { terminal } from "./contract.js";
+export { Observations } from "./observation.js";
+export { CoordinatorClient } from "./coordinator/_internal/client.js";
+export { retryAfterMs } from "./coordinator/_internal/response.js";
+export { mediaGeneration, trackGeneration } from "./session/_internal/acquire.js";
+export { readFileBytes, uploadFile } from "./session/files.js";
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAUlF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/** Portable entry point: importing it does not select or load a native/browser peer. */
+export { Client, make, layer, AcquisitionFailure, CommandFailure } from "./session/index.js";
+export type { Factory, Configuration, CreateOptions, AttachOptions, Session, } from "./session/index.js";
+export * as Coordinator from "./coordinator/index.js";
+export * as Peers from "./PeerFactory.js";
+export * as FetchHttp from "./FetchHttp.js";
+export { ReactorError, ErrorCode, ErrorContext, ProviderFailure } from "./errors.js";
+export type { RemoteOutcome } from "./errors.js";
+export { PeerFactory } from "./PeerFactory.js";
+export type { PeerFactoryShape } from "./PeerFactory.js";
+export type { SessionEvent, Snapshot, ReadyState, Status, CommandReply, CloseReport, Uploaded, UploadProgress, } from "./SessionTypes.js";
+export type { HttpOptions, Termination } from "./coordinator/_internal/client.js";
+export type { CommandContext } from "./session/commands.js";
+export type { Statistics } from "./stats.js";
+export type { Json, JsonObject } from "./json.js";
+export type { Capabilities, Descriptor, Track, Mapping } from "./contract.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC7F,YAAY,EACV,OAAO,EACP,aAAa,EACb,aAAa,EACb,aAAa,EACb,OAAO,GACR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACrF,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,MAAM,EACN,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/** Portable entry point: importing it does not select or load a native/browser peer. */
+export { Client, make, layer, AcquisitionFailure, CommandFailure } from "./session/index.js";
+export * as Coordinator from "./coordinator/index.js";
+export * as Peers from "./PeerFactory.js";
+export * as FetchHttp from "./FetchHttp.js";
+export { ReactorError, ErrorCode, ErrorContext, ProviderFailure } from "./errors.js";
+export { PeerFactory } from "./PeerFactory.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQ7F,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,18 @@
+import type { Google_Struct } from "./wire.generated.js";
+export type Json = null | boolean | number | string | JsonObject | readonly Json[];
+export interface JsonObject {
+    readonly [key: string]: Json;
+}
+export declare const isRecord: (u: unknown) => u is Record<string, unknown>;
+export declare const record: (u: unknown, context?: string) => Record<string, unknown>;
+export declare const string: (u: unknown, context: string, max?: number) => string;
+export declare const nonempty: (u: unknown, context: string) => string;
+export declare const finite: (u: unknown, context: string) => number;
+export declare const uint32: (u: unknown, context: string) => number;
+export declare const array: (u: unknown, context: string) => readonly unknown[];
+/** Validates, copies, and freezes finite JSON; never coerces undefined, cycles, Dates or accessors. */
+export declare const json: (input: unknown, maximumNodes?: number) => Json;
+export declare const jsonObject: (input: unknown) => JsonObject;
+export declare const structFromObject: (input: unknown) => Google_Struct;
+export declare const objectFromStruct: (s: Google_Struct, depth?: number) => JsonObject;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,qBAAqB,CAAC;AACvE,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,IAAI,EAAE,CAAC;AACnF,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AACD,eAAO,MAAM,QAAQ,MAAO,OAAO,KAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACP,CAAC;AAI3D,eAAO,MAAM,MAAM,MAAO,OAAO,uBAAuB,MAAM,CAAC,MAAM,EAAE,OAAO,CAChC,CAAC;AAC/C,eAAO,MAAM,MAAM,MAAO,OAAO,WAAW,MAAM,mBAAoB,MACc,CAAC;AACrF,eAAO,MAAM,QAAQ,MAAO,OAAO,WAAW,MAAM,KAAG,MAGtD,CAAC;AACF,eAAO,MAAM,MAAM,MAAO,OAAO,WAAW,MAAM,KAAG,MACwC,CAAC;AAC9F,eAAO,MAAM,MAAM,MAAO,OAAO,WAAW,MAAM,KAAG,MAGpD,CAAC;AACF,eAAO,MAAM,KAAK,MAAO,OAAO,WAAW,MAAM,KAAG,SAAS,OAAO,EACV,CAAC;AAE3D,uGAAuG;AACvG,eAAO,MAAM,IAAI,UAAW,OAAO,4BAA0B,IAqC5D,CAAC;AAGF,eAAO,MAAM,UAAU,UAAW,OAAO,KAAG,UAG3C,CAAC;AAUF,eAAO,MAAM,gBAAgB,UAAW,OAAO,KAAG,aAKjD,CAAC;AAsBF,eAAO,MAAM,gBAAgB,MAAO,aAAa,qBAAc,UAM9D,CAAC"}

package/dist/json.js

@@ -0,0 +1,123 @@
+import { ReactorError } from "./errors.js";
+import { checkedString } from "./protobuf.js";
+export const isRecord = (u) => typeof u === "object" && u !== null && !Array.isArray(u);
+const bad = (message) => {
+    throw new ReactorError("Protocol", message);
+};
+export const record = (u, context = "object") => isRecord(u) ? u : bad(`expected ${context}`);
+export const string = (u, context, max = 1_048_576) => typeof u === "string" ? checkedString(u, max) : bad(`expected string: ${context}`);
+export const nonempty = (u, context) => {
+    const s = string(u, context);
+    return s.length ? s : bad(`empty ${context}`);
+};
+export const finite = (u, context) => typeof u === "number" && Number.isFinite(u) ? u : bad(`expected finite number: ${context}`);
+export const uint32 = (u, context) => {
+    const n = finite(u, context);
+    return Number.isInteger(n) && n >= 0 && n <= 0xffffffff ? n : bad(`expected uint32: ${context}`);
+};
+export const array = (u, context) => Array.isArray(u) ? u : bad(`expected array: ${context}`);
+/** Validates, copies, and freezes finite JSON; never coerces undefined, cycles, Dates or accessors. */
+export const json = (input, maximumNodes = 65_536) => {
+    const ancestors = new Set();
+    let nodes = 0, chars = 0;
+    const visit = (u, depth) => {
+        if (++nodes > maximumNodes || depth > 64)
+            return bad("JSON node/depth limit");
+        if (u === null || typeof u === "boolean")
+            return u;
+        if (typeof u === "number")
+            return finite(u, "JSON number");
+        if (typeof u === "string") {
+            chars += u.length;
+            if (chars > 4_194_304)
+                return bad("JSON text limit");
+            return checkedString(u, 4_194_304);
+        }
+        if (typeof u !== "object")
+            return bad("not a JSON value");
+        if (ancestors.has(u))
+            return bad("cyclic JSON");
+        ancestors.add(u);
+        try {
+            if (Array.isArray(u))
+                return Object.freeze(u.map((v) => visit(v, depth + 1)));
+            const proto = Object.getPrototypeOf(u);
+            if (proto !== Object.prototype && proto !== null)
+                return bad("JSON object must have a plain prototype");
+            if (Object.getOwnPropertySymbols(u).length)
+                return bad("symbol keys are not JSON");
+            const result = {};
+            for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(u))) {
+                if (!descriptor.enumerable)
+                    continue;
+                if (!("value" in descriptor))
+                    return bad("JSON accessors are not supported");
+                chars += key.length;
+                checkedString(key, 4_194_304);
+                const value = descriptor.value;
+                Object.defineProperty(result, key, { value: visit(value, depth + 1), enumerable: true });
+            }
+            return Object.freeze(result);
+        }
+        finally {
+            ancestors.delete(u);
+        }
+    };
+    return visit(input, 0);
+};
+const isJsonObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+export const jsonObject = (input) => {
+    const value = json(input);
+    return isJsonObject(value) ? value : bad("command data must be a top-level JSON object");
+};
+const valueFromJson = (value) => {
+    if (value === null)
+        return { kind: { case: "null_value", value: 0 } };
+    if (typeof value === "boolean")
+        return { kind: { case: "bool_value", value } };
+    if (typeof value === "number")
+        return { kind: { case: "number_value", value } };
+    if (typeof value === "string")
+        return { kind: { case: "string_value", value } };
+    if (Array.isArray(value))
+        return { kind: { case: "list_value", value: { values: value.map(valueFromJson) } } };
+    return { kind: { case: "struct_value", value: structFromObject(value) } };
+};
+export const structFromObject = (input) => {
+    const data = jsonObject(input), fields = new Map();
+    for (const [key, value] of Object.entries(data))
+        fields.set(key, valueFromJson(value));
+    return { fields };
+};
+/** Upstream Struct conversion maps unset/unknown Value kinds and nonfinite doubles to null.
+ * The raw generated codecs preserve those distinctions; use them when JSON is insufficient.
+ */
+const valueToJson = (value, depth) => {
+    if (depth > 64)
+        return bad("Struct depth limit");
+    const kind = value.kind;
+    if (kind === undefined)
+        return null;
+    switch (kind.case) {
+        case "null_value":
+            return null;
+        case "number_value":
+            return Number.isFinite(kind.value) ? kind.value : null;
+        case "string_value":
+        case "bool_value":
+            return kind.value;
+        case "struct_value":
+            return objectFromStruct(kind.value, depth + 1);
+        case "list_value":
+            return Object.freeze(kind.value.values.map((v) => valueToJson(v, depth + 1)));
+    }
+};
+export const objectFromStruct = (s, depth = 0) => {
+    if (depth > 64)
+        return bad("Struct depth limit");
+    const result = {};
+    for (const [key, value] of s.fields)
+        Object.defineProperty(result, key, { value: valueToJson(value, depth + 1), enumerable: true });
+    return Object.freeze(result);
+};
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

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

package/dist/media-stream.d.ts

@@ -0,0 +1,10 @@
+import * as Stream from "effect/Stream";
+import type { ReactorError } from "./errors.js";
+/** Catch acquisition failures in the typed channel and own both cancel AND releaseLock.
+ * In pinned Effect, fromReadableStream's default finalizer cancels without releasing;
+ * releaseLockOnEnd instead releases without cancellation. Media needs both operations. */
+export declare const fromOwnedReadableStream: <A>(options: {
+    readonly evaluate: () => ReadableStream<A>;
+    readonly onError: (error: unknown) => ReactorError;
+}) => Stream.Stream<A, ReactorError>;
+//# sourceMappingURL=media-stream.d.ts.map

package/dist/media-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-stream.d.ts","sourceRoot":"","sources":["../src/media-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD;;0FAE0F;AAC1F,eAAO,MAAM,uBAAuB,GAAI,CAAC,WAAW;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,YAAY,CAAC;CACpD,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAsB9B,CAAC"}

package/dist/media-stream.js

@@ -0,0 +1,20 @@
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+/** Catch acquisition failures in the typed channel and own both cancel AND releaseLock.
+ * In pinned Effect, fromReadableStream's default finalizer cancels without releasing;
+ * releaseLockOnEnd instead releases without cancellation. Media needs both operations. */
+export const fromOwnedReadableStream = (options) => Stream.unwrap(Effect.gen(function* () {
+    const reader = yield* Effect.acquireRelease(Effect.try({ try: () => options.evaluate().getReader(), catch: options.onError }), (reader) => Effect.promise(async () => {
+        try {
+            await reader.cancel();
+        }
+        catch {
+            /* Underlying media finalizer still runs on stream error. */
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }));
+    return Stream.unfold(undefined, () => Effect.tryPromise({ try: () => reader.read(), catch: options.onError }).pipe(Effect.map((next) => (next.done ? undefined : [next.value, undefined]))));
+}));
+//# sourceMappingURL=media-stream.js.map

package/dist/media-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-stream.js","sourceRoot":"","sources":["../src/media-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;0FAE0F;AAC1F,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAI,OAG1C,EAAkC,EAAE,CACnC,MAAM,CAAC,MAAM,CACX,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CACzC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,EACjF,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CACL,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,CACnC,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAC1E,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAW,CAAC,CAAC,CACnF,CACF,CAAC;AACJ,CAAC,CAAC,CACH,CAAC"}

package/dist/observation.d.ts

@@ -0,0 +1,26 @@
+import * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+import { ReactorError } from "./errors.js";
+export interface ObservationOptions {
+    readonly capacity?: number;
+    readonly maxBytes?: number;
+}
+/** Slow observation never blocks protocol correlation or silently drops lifecycle events. */
+export declare class Observations<A> {
+    private readonly maxSubscribers;
+    private readonly subscribers;
+    private closed;
+    private failure;
+    overflowCount: bigint;
+    constructor(maxSubscribers?: number);
+    get size(): number;
+    /** Acquire before reading a snapshot, then ignore queued revisions covered by that snapshot. */
+    subscribe(options?: ObservationOptions): Effect.Effect<Stream.Stream<A, ReactorError>, ReactorError, Scope.Scope>;
+    stream(options?: ObservationOptions): Stream.Stream<A, ReactorError>;
+    emit(value: A, bytes?: number): void;
+    end(): void;
+    /** Source failure belongs to each reader, including a later subscription. */
+    fail(error: ReactorError): void;
+}
+//# sourceMappingURL=observation.d.ts.map

package/dist/observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAA0B,YAAY,EAAE,MAAM,aAAa,CAAC;AAYnE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,6FAA6F;AAC7F,qBAAa,YAAY,CAAC,CAAC;IAMb,OAAO,CAAC,QAAQ,CAAC,cAAc;IAL3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA2B;IAC1C,aAAa,SAAM;IAEnB,YAA6B,cAAc,SAAK,EAE/C;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,gGAAgG;IAChG,SAAS,CACP,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,CAwE1E;IAED,MAAM,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAEnE;IAED,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,SAAM,GAAG,IAAI,CAoBhC;IAED,GAAG,IAAI,IAAI,CAKV;IAED,6EAA6E;IAC7E,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAO9B;CACF"}

package/dist/observation.js

@@ -0,0 +1,106 @@
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Queue from "effect/Queue";
+import * as Stream from "effect/Stream";
+import { errorOf, positiveLimit, ReactorError } from "./errors.js";
+/** Slow observation never blocks protocol correlation or silently drops lifecycle events. */
+export class Observations {
+    maxSubscribers;
+    subscribers = new Set();
+    closed = false;
+    failure;
+    overflowCount = 0n;
+    constructor(maxSubscribers = 64) {
+        this.maxSubscribers = maxSubscribers;
+        positiveLimit(maxSubscribers, "observer count", 4096);
+    }
+    get size() {
+        return this.subscribers.size;
+    }
+    /** Acquire before reading a snapshot, then ignore queued revisions covered by that snapshot. */
+    subscribe(options = {}) {
+        const observations = this;
+        return Effect.gen(function* () {
+            const bounds = yield* Effect.try({
+                try: () => ({
+                    capacity: positiveLimit(options.capacity ?? 64, "observation capacity", 4096),
+                    maxBytes: positiveLimit(options.maxBytes ?? 1_048_576, "observation bytes", 64 * 1024 * 1024),
+                }),
+                catch: errorOf,
+            });
+            const subscriber = yield* Effect.acquireRelease(Effect.gen(function* () {
+                if (observations.subscribers.size >= observations.maxSubscribers) {
+                    return yield* Effect.fail(new ReactorError("Overflow", "observer count bound reached", {
+                        outcome: "not-submitted",
+                    }));
+                }
+                const queue = yield* Queue.dropping(bounds.capacity);
+                const subscriber = { queue, maxBytes: bounds.maxBytes, bufferedBytes: 0 };
+                if (observations.failure !== undefined)
+                    Queue.failCauseUnsafe(queue, Cause.fail(observations.failure));
+                else if (observations.closed)
+                    Queue.endUnsafe(queue);
+                else
+                    observations.subscribers.add(subscriber);
+                return subscriber;
+            }), (subscriber) => Effect.gen(function* () {
+                observations.subscribers.delete(subscriber);
+                subscriber.bufferedBytes = 0;
+                yield* Queue.shutdown(subscriber.queue);
+            }));
+            let reading = false;
+            return Stream.unwrap(Effect.gen(function* () {
+                yield* Effect.acquireRelease(Effect.try({
+                    try: () => {
+                        if (reading)
+                            throw new ReactorError("AlreadyReading", "this observation already has an active reader");
+                        reading = true;
+                    },
+                    catch: errorOf,
+                }), () => Effect.sync(() => {
+                    reading = false;
+                }));
+                return Stream.fromEffectRepeat(Effect.uninterruptibleMask((restore) => restore(Queue.take(subscriber.queue)).pipe(Effect.map((entry) => {
+                    subscriber.bufferedBytes -= entry.bytes;
+                    return entry.value;
+                }))));
+            }));
+        });
+    }
+    stream(options) {
+        return Stream.unwrap(this.subscribe(options));
+    }
+    emit(value, bytes = 256) {
+        if (this.closed)
+            return;
+        for (const subscriber of this.subscribers) {
+            if (bytes > subscriber.maxBytes - subscriber.bufferedBytes ||
+                !Queue.offerUnsafe(subscriber.queue, { value, bytes })) {
+                this.overflowCount++;
+                Queue.failCauseUnsafe(subscriber.queue, Cause.fail(new ReactorError("Overflow", "observation bound exceeded; acquire a new observation and snapshot")));
+                this.subscribers.delete(subscriber);
+            }
+            else
+                subscriber.bufferedBytes += bytes;
+        }
+    }
+    end() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const subscriber of this.subscribers)
+            Queue.endUnsafe(subscriber.queue);
+        this.subscribers.clear();
+    }
+    /** Source failure belongs to each reader, including a later subscription. */
+    fail(error) {
+        if (this.closed)
+            return;
+        this.failure = error;
+        this.closed = true;
+        for (const subscriber of this.subscribers)
+            Queue.failCauseUnsafe(subscriber.queue, Cause.fail(error));
+        this.subscribers.clear();
+    }
+}
+//# sourceMappingURL=observation.js.map