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

package/dist/h3/_internal/references.js

@@ -0,0 +1,186 @@
+import * as Effect from "effect/Effect";
+import { ReactorError } from "../../errors.js";
+import { imageMimeTypes, referenceLimits } from "../profile.js";
+const materials = new WeakMap();
+const invalid = (message) => {
+    throw new ReactorError("InvalidInput", message, {
+        operation: "H3 reference",
+        outcome: "not-submitted",
+    });
+};
+const uint16 = (b, o) => b[o] * 256 + b[o + 1];
+const uint32 = (b, o) => b[o] * 0x1000000 + b[o + 1] * 65536 + b[o + 2] * 256 + b[o + 3];
+const le16 = (b, o) => b[o] + b[o + 1] * 256;
+const le24 = (b, o) => le16(b, o) + b[o + 2] * 65536;
+const le32 = (b, o) => le24(b, o) + b[o + 3] * 0x1000000;
+const ascii = (b, o, count) => String.fromCharCode(...b.subarray(o, o + count));
+/** The only image-header validator used by the provider and host reference loaders. */
+const inspectImage = (bytes) => {
+    if (bytes.length >= 33 &&
+        ascii(bytes, 1, 3) === "PNG" &&
+        bytes[0] === 137 &&
+        bytes[4] === 13 &&
+        bytes[5] === 10 &&
+        bytes[6] === 26 &&
+        bytes[7] === 10) {
+        if (uint32(bytes, 8) !== 13 || ascii(bytes, 12, 4) !== "IHDR")
+            return invalid("PNG has no complete image header");
+        let offset = 8, hasData = false, ended = false;
+        while (offset + 12 <= bytes.length) {
+            const size = uint32(bytes, offset), type = ascii(bytes, offset + 4, 4);
+            if (size > bytes.length - offset - 12)
+                return invalid("PNG chunk is truncated");
+            if (type === "IDAT" && size > 0)
+                hasData = true;
+            offset += size + 12;
+            if (type === "IEND") {
+                ended = size === 0 && offset === bytes.length;
+                break;
+            }
+        }
+        if (!hasData || !ended)
+            return invalid("PNG is incomplete");
+        return { mimeType: "image/png", width: uint32(bytes, 16), height: uint32(bytes, 20) };
+    }
+    if (bytes.length >= 4 &&
+        bytes[0] === 255 &&
+        bytes[1] === 216 &&
+        bytes.at(-2) === 255 &&
+        bytes.at(-1) === 217) {
+        let offset = 2;
+        while (offset + 4 <= bytes.length) {
+            if (bytes[offset] !== 255)
+                break;
+            const marker = bytes[offset + 1];
+            if (marker === 255) {
+                offset++;
+                continue;
+            }
+            if (marker === 216 || marker === 1 || (marker >= 208 && marker <= 215)) {
+                offset += 2;
+                continue;
+            }
+            const size = uint16(bytes, offset + 2);
+            if (size < 2 || offset + 2 + size > bytes.length)
+                break;
+            if (marker >= 192 &&
+                marker <= 207 &&
+                marker !== 196 &&
+                marker !== 200 &&
+                marker !== 204 &&
+                size >= 8) {
+                return {
+                    mimeType: "image/jpeg",
+                    height: uint16(bytes, offset + 5),
+                    width: uint16(bytes, offset + 7),
+                };
+            }
+            if (marker === 218 || marker === 217)
+                break;
+            offset += 2 + size;
+        }
+        return invalid("JPEG has no complete dimension header");
+    }
+    if (bytes.length >= 30 && ascii(bytes, 0, 4) === "RIFF" && ascii(bytes, 8, 4) === "WEBP") {
+        if (le32(bytes, 4) + 8 !== bytes.length || le32(bytes, 16) > bytes.length - 20)
+            return invalid("WebP is truncated");
+        const type = ascii(bytes, 12, 4);
+        if (type === "VP8 " && bytes[23] === 157 && bytes[24] === 1 && bytes[25] === 42)
+            return {
+                mimeType: "image/webp",
+                width: le16(bytes, 26) & 16383,
+                height: le16(bytes, 28) & 16383,
+            };
+        if (type === "VP8L" && bytes[20] === 47) {
+            const bits = le32(bytes, 21);
+            return {
+                mimeType: "image/webp",
+                width: (bits & 16383) + 1,
+                height: ((bits >>> 14) & 16383) + 1,
+            };
+        }
+        if (type === "VP8X" && le32(bytes, 16) >= 10)
+            return { mimeType: "image/webp", width: le24(bytes, 24) + 1, height: le24(bytes, 27) + 1 };
+    }
+    return invalid("Reference must contain a supported PNG, JPEG, or WebP image");
+};
+export const plain = (input, allowed) => {
+    if (input === null ||
+        typeof input !== "object" ||
+        Array.isArray(input) ||
+        (Object.getPrototypeOf(input) !== Object.prototype && Object.getPrototypeOf(input) !== null) ||
+        Object.getOwnPropertySymbols(input).length !== 0)
+        return invalid("Expected a plain input object");
+    const output = {};
+    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(input))) {
+        if (!allowed.includes(key) || !("value" in descriptor))
+            return invalid("Input contains unsupported fields or accessors");
+        Object.defineProperty(output, key, { value: descriptor.value, enumerable: true });
+    }
+    return output;
+};
+/** Validates wire identity and a safe JSON size projection without inventing upload provenance. */
+export const checkedUpload = (input) => {
+    const file = plain(input, ["upload_id", "name", "mime_type", "size", "_unknown"]);
+    if (typeof file.upload_id !== "string" ||
+        !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(file.upload_id) ||
+        typeof file.name !== "string" ||
+        file.name.length === 0 ||
+        file.name.length > 1024 ||
+        !imageMimeTypes.includes(String(file.mime_type)) ||
+        typeof file.size !== "bigint" ||
+        file.size <= 0n ||
+        file.size > BigInt(referenceLimits.maxBytes)) {
+        return invalid("Uploaded reference has invalid identity, type, or size");
+    }
+    return Object.freeze({
+        upload_id: file.upload_id,
+        name: file.name,
+        mime_type: file.mime_type,
+        size: file.size,
+    });
+};
+export const captureReference = (input) => {
+    if (input !== null && typeof input === "object" && materials.has(input))
+        return input;
+    const object = plain(input, ["_tag", "bytes", "file"]);
+    let material, facts;
+    if (object._tag === "Bytes" && object.bytes instanceof Uint8Array && object.file === undefined) {
+        if (object.bytes.byteLength === 0 || object.bytes.byteLength > referenceLimits.maxBytes)
+            return invalid("Image exceeds the SDK byte bound");
+        const bytes = new Uint8Array(object.bytes), dimensions = inspectImage(bytes);
+        const { width, height } = dimensions, aspect = width / height;
+        if (width <= 0 ||
+            height <= 0 ||
+            width * height > referenceLimits.maxPixels ||
+            aspect < referenceLimits.minAspect ||
+            aspect > referenceLimits.maxAspect)
+            return invalid("Image dimensions exceed the SDK bounds");
+        material = { _tag: "Bytes", bytes };
+        facts = { _tag: "ValidatedReference", ...dimensions, size: bytes.length };
+    }
+    else if (object._tag === "Uploaded" && object.bytes === undefined) {
+        const file = checkedUpload(object.file);
+        material = { _tag: "Uploaded", file };
+        facts = {
+            _tag: "ValidatedReference",
+            mimeType: file.mime_type,
+            size: Number(file.size),
+            width: null,
+            height: null,
+        };
+    }
+    else
+        return invalid("Reference must be Bytes or Uploaded; reference audio is unsupported");
+    const validated = Object.freeze(facts);
+    materials.set(validated, material);
+    return validated;
+};
+export const referenceMaterial = (reference) => materials.get(reference) ?? invalid("Unknown validated reference");
+export const validateReference = (input) => Effect.try({
+    try: () => captureReference(input),
+    catch: (error) => error instanceof ReactorError
+        ? error
+        : new ReactorError("InvalidInput", "Invalid H3 reference", { outcome: "not-submitted" }),
+});
+//# sourceMappingURL=references.js.map

package/dist/h3/_internal/references.js.map

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

package/dist/h3/_internal/request.d.ts

@@ -0,0 +1,16 @@
+import type { UploadReference } from "../../wire.generated.js";
+import type { Request, ValidatedReference } from "../types.js";
+import type { CommandArgs } from "./contracts.js";
+export interface CapturedRequest extends Omit<Request, "references"> {
+    readonly references: readonly ValidatedReference[];
+}
+export declare const nonnegative: (value: unknown, field: string) => number;
+export declare const seconds: (value: unknown, bounds?: {
+    readonly min: number;
+    readonly max: number;
+}) => number;
+export declare const clipId: (input: unknown) => string;
+export declare const captureRequest: (input: Request, maxPromptBytes: number) => CapturedRequest;
+/** Project validated, captured input once; no reference validation or host IO happens here. */
+export declare const enqueueArguments: (request: CapturedRequest, files: readonly UploadReference[], metadata: string) => CommandArgs<"enqueue">;
+//# sourceMappingURL=request.d.ts.map

package/dist/h3/_internal/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/h3/_internal/request.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC;IAClE,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACpD;AAOD,eAAO,MAAM,WAAW,UAAW,OAAO,SAAS,MAAM,KAAG,MAI3D,CAAC;AACF,eAAO,MAAM,OAAO,UACX,OAAO,WACN;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KACrD,MASF,CAAC;AACF,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,MAOvC,CAAC;AACF,eAAO,MAAM,cAAc,UAAW,OAAO,kBAAkB,MAAM,KAAG,eAmCvE,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,YAClB,eAAe,SACjB,SAAS,eAAe,EAAE,YACvB,MAAM,KACf,WAAW,CAAC,SAAS,CAcpB,CAAC"}

package/dist/h3/_internal/request.js

@@ -0,0 +1,79 @@
+import { ReactorError } from "../../errors.js";
+import { checkedString } from "../../protobuf.js";
+import { metadataMaxChars, referenceLimits, requestSeconds } from "../profile.js";
+import { captureReference, plain } from "./references.js";
+const bad = (message) => {
+    throw new ReactorError("InvalidInput", message, {
+        operation: "enqueue",
+        outcome: "not-submitted",
+    });
+};
+export const nonnegative = (value, field) => {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+        return bad(`${field} must be a nonnegative safe integer`);
+    return value;
+};
+export const seconds = (value, bounds = requestSeconds) => {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value < bounds.min ||
+        value > bounds.max)
+        return bad("Clip duration is outside the accepted request bounds");
+    return value;
+};
+export const clipId = (input) => {
+    if (typeof input !== "string" ||
+        !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(input))
+        return bad("clipId must be a UUID");
+    return input;
+};
+export const captureRequest = (input, maxPromptBytes) => {
+    const request = plain(input, [
+        "prompt",
+        "references",
+        "seconds",
+        "seed",
+        "position",
+        "continueFrom",
+        "metadata",
+    ]);
+    if (typeof request.prompt !== "string" || request.prompt.trim().length === 0)
+        return bad("Prompt must contain text");
+    checkedString(request.prompt, maxPromptBytes);
+    if (new TextEncoder().encode(request.prompt).length > maxPromptBytes)
+        return bad("Prompt exceeds the configured SDK byte bound");
+    if (request.metadata !== undefined && typeof request.metadata !== "string")
+        return bad("Metadata must be a string");
+    const references = request.references ?? [];
+    if (!Array.isArray(references) || references.length > referenceLimits.maxImages)
+        return bad("H3 accepts at most nine image references");
+    return Object.freeze({
+        prompt: request.prompt,
+        references: Object.freeze(references.map((reference) => captureReference(reference))),
+        ...(request.seconds === undefined ? {} : { seconds: seconds(request.seconds) }),
+        ...(request.seed === undefined ? {} : { seed: nonnegative(request.seed, "seed") }),
+        ...(request.position === undefined
+            ? {}
+            : { position: nonnegative(request.position, "position") }),
+        ...(request.continueFrom === undefined ? {} : { continueFrom: clipId(request.continueFrom) }),
+        ...(request.metadata === undefined
+            ? {}
+            : { metadata: checkedString(request.metadata, metadataMaxChars) }),
+    });
+};
+/** Project validated, captured input once; no reference validation or host IO happens here. */
+export const enqueueArguments = (request, files, metadata) => Object.freeze({
+    prompt: request.prompt,
+    reference_images: files.map((file) => ({
+        upload_id: file.upload_id,
+        name: file.name,
+        mime_type: file.mime_type,
+        size: Number(file.size),
+    })),
+    metadata,
+    ...(request.seconds === undefined ? {} : { seconds: request.seconds }),
+    ...(request.seed === undefined ? {} : { seed: request.seed }),
+    ...(request.position === undefined ? {} : { position: request.position }),
+    ...(request.continueFrom === undefined ? {} : { continue_from_clip_id: request.continueFrom }),
+});
+//# sourceMappingURL=request.js.map

package/dist/h3/_internal/request.js.map

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

package/dist/h3/_internal/state.d.ts

@@ -0,0 +1,30 @@
+import { ReactorError } from "../../errors.js";
+import type { CommandReply, SessionEvent } from "../../session/index.js";
+import type { DecodedMessage } from "../messages.js";
+import type { ProviderSnapshot } from "../types.js";
+/** Only the Session observation reader may supply protocol facts to this reducer. */
+export declare class ProviderState {
+    readonly sessionId: string;
+    private readonly maxClips;
+    private state;
+    private queue;
+    private lastFacts;
+    private cause;
+    private readonly clips;
+    private revision;
+    private generation;
+    private stateDirty;
+    private queueDirty;
+    private readonly bodies;
+    private availability;
+    constructor(sessionId: string, generation: bigint, revision: bigint, maxClips: number);
+    snapshot(): ProviderSnapshot;
+    unavailable(cause: ReactorError): void;
+    private rememberFacts;
+    admit(source: SessionEvent): "applied" | "duplicate" | "stale";
+    private put;
+    private invalidate;
+    private coherent;
+    apply(message: DecodedMessage, source: CommandReply): "applied" | "duplicate";
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/h3/_internal/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/h3/_internal/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAQ,cAAc,EAA6B,MAAM,gBAAgB,CAAC;AACtF,OAAO,KAAK,EAA0B,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAe5E,qFAAqF;AACrF,qBAAa,aAAa;IActB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAG1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAhB3B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,YAAY,CAA8D;IAElF,YACW,SAAS,EAAE,MAAM,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAIlC;IAED,QAAQ,IAAI,gBAAgB,CAiB3B;IAED,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAIrC;IAED,OAAO,CAAC,aAAa;IAKrB,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAqD7D;IAED,OAAO,CAAC,GAAG;IAQX,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,QAAQ;IAchB,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,WAAW,CAqG5E;CACF"}

package/dist/h3/_internal/state.js

@@ -0,0 +1,243 @@
+import { ReactorError } from "../../errors.js";
+const rank = (type) => type === "clip_generated"
+    ? 1
+    : type === "clip_started"
+        ? 2
+        : type === "clip_finished" ||
+            type === "clip_stopped" ||
+            type === "clip_failed" ||
+            type === "clip_popped"
+            ? 3
+            : 0;
+const ended = (type) => rank(type) === 3;
+/** Only the Session observation reader may supply protocol facts to this reducer. */
+export class ProviderState {
+    sessionId;
+    maxClips;
+    state;
+    queue;
+    lastFacts = null;
+    cause;
+    clips = new Map();
+    revision;
+    generation;
+    stateDirty = true;
+    queueDirty = true;
+    bodies = new Map();
+    availability = "Synchronizing";
+    constructor(sessionId, generation, revision, maxClips) {
+        this.sessionId = sessionId;
+        this.maxClips = maxClips;
+        this.generation = generation;
+        this.revision = revision;
+    }
+    snapshot() {
+        const base = {
+            sessionId: this.sessionId,
+            transportGeneration: this.generation,
+            revision: this.revision,
+            clips: Object.freeze([...this.clips.values()]),
+        };
+        if (this.availability === "Ready" && this.state !== undefined && this.queue !== undefined)
+            return Object.freeze({ ...base, _tag: "Ready", state: this.state, queue: this.queue });
+        if (this.availability === "Unavailable")
+            return Object.freeze({
+                ...base,
+                _tag: "Unavailable",
+                cause: this.cause,
+                lastFacts: this.lastFacts,
+            });
+        return Object.freeze({ ...base, _tag: "Synchronizing", lastFacts: this.lastFacts });
+    }
+    unavailable(cause) {
+        this.rememberFacts();
+        this.availability = "Unavailable";
+        this.cause = cause;
+    }
+    rememberFacts() {
+        if (this.state !== undefined && this.queue !== undefined && this.coherent())
+            this.lastFacts = Object.freeze({ state: this.state, queue: this.queue });
+    }
+    admit(source) {
+        if (source.generation < this.generation)
+            return "stale";
+        if (source.sequence <= this.revision)
+            return "duplicate";
+        this.revision = source.sequence;
+        if (source.generation > this.generation) {
+            this.rememberFacts();
+            this.generation = source.generation;
+            this.state = undefined;
+            this.queue = undefined;
+            this.stateDirty = true;
+            this.queueDirty = true;
+            this.bodies.clear();
+            this.availability = "Synchronizing";
+            this.cause = undefined;
+        }
+        if (source._tag === "Model" && source.correlation === "stale-generation")
+            return "stale";
+        // The wire correlator may label a body following an ACK as duplicate.
+        // Each source sequence is distinct; an ACK is never a model payload.
+        if (source._tag === "Model" && source.kind === "message" && source.requestId !== "") {
+            if (source.correlation === "duplicate" &&
+                this.bodies.get(source.requestId) === source.generation)
+                return "duplicate";
+            this.bodies.set(source.requestId, source.generation);
+            if (this.bodies.size > 256) {
+                const first = this.bodies.keys().next();
+                if (!first.done)
+                    this.bodies.delete(first.value);
+            }
+        }
+        if (source._tag === "Status") {
+            if (source.status === "disconnected" ||
+                source.status === "closing" ||
+                source.status === "closed") {
+                this.unavailable(new ReactorError(source.status === "disconnected" ? "Disconnected" : "Closed", `H3 session is ${source.status}`, { operation: "H3 observation" }));
+            }
+            else if (source.status === "ready" && this.availability === "Unavailable") {
+                this.state = undefined;
+                this.queue = undefined;
+                this.stateDirty = true;
+                this.queueDirty = true;
+                this.availability = "Synchronizing";
+                this.cause = undefined;
+            }
+        }
+        return "applied";
+    }
+    put(clip, source, lifecycle) {
+        if (!this.clips.has(clip.clip_id) && this.clips.size >= this.maxClips)
+            throw new ReactorError("Overflow", "H3 clip observation bound exceeded", {
+                operation: "H3 observation",
+            });
+        this.clips.set(clip.clip_id, Object.freeze({ clip, source, lifecycle }));
+    }
+    invalidate(state, queue) {
+        this.rememberFacts();
+        this.stateDirty ||= state;
+        this.queueDirty ||= queue;
+        if (this.availability !== "Unavailable")
+            this.availability = "Synchronizing";
+    }
+    coherent() {
+        return (this.state !== undefined &&
+            this.queue !== undefined &&
+            !this.stateDirty &&
+            !this.queueDirty &&
+            this.state.generation_queued === this.queue.generation.length &&
+            this.state.playout_queued === this.queue.playout.length &&
+            ![...this.queue.generation, ...this.queue.playout].some((clip) => clip.clip_id === this.state.playing_clip_id));
+    }
+    apply(message, source) {
+        if (message.type === "unknown")
+            return "applied";
+        if (message.type === "state_update") {
+            this.state = message.data;
+            this.stateDirty = false;
+        }
+        else if (message.type === "queue_update") {
+            const clips = [...message.data.generation, ...message.data.playout, ...message.data.history];
+            const ids = new Set([...this.clips.keys(), ...clips.map((clip) => clip.clip_id)]);
+            if (ids.size > this.maxClips)
+                throw new ReactorError("Overflow", "H3 clip observation bound exceeded", {
+                    operation: "H3 observation",
+                });
+            this.queue = message.data;
+            this.queueDirty = false;
+            for (const clip of clips) {
+                const previous = this.clips.get(clip.clip_id);
+                this.put(clip, source, previous?.lifecycle ?? null);
+            }
+        }
+        else if ("clip" in message.data) {
+            const clip = message.data.clip, previous = this.clips.get(clip.clip_id);
+            if (message.type === "clip_moved") {
+                this.put(clip, source, previous?.lifecycle ?? null);
+                if (this.queue?.[message.data.queue][message.data.position]?.clip_id !== clip.clip_id)
+                    this.invalidate(false, true);
+            }
+            else {
+                const lifecycle = message.type;
+                if (previous !== undefined && previous.lifecycle !== null) {
+                    if (previous.lifecycle === lifecycle ||
+                        ended(previous.lifecycle) ||
+                        rank(previous.lifecycle) > rank(lifecycle))
+                        return "duplicate";
+                }
+                this.put(clip, source, lifecycle);
+                const queued = this.queue?.generation.some((entry) => entry.clip_id === clip.clip_id) === true;
+                const ready = this.queue?.playout.some((entry) => entry.clip_id === clip.clip_id) === true;
+                switch (message.type) {
+                    case "clip_queued":
+                        if (!queued && !ready && this.state?.playing_clip_id !== clip.clip_id)
+                            this.invalidate(true, true);
+                        break;
+                    case "clip_generated":
+                        if (!ready && this.state?.playing_clip_id !== clip.clip_id)
+                            this.invalidate(true, true);
+                        break;
+                    case "clip_started":
+                        if (this.state?.playing_clip_id !== clip.clip_id)
+                            this.invalidate(true, false);
+                        if (queued || ready)
+                            this.invalidate(false, true);
+                        break;
+                    case "clip_failed":
+                    case "clip_popped":
+                        if (queued || ready)
+                            this.invalidate(true, true);
+                        break;
+                    case "clip_finished":
+                    case "clip_stopped":
+                        if (this.state?.playing_clip_id === clip.clip_id || this.state === undefined)
+                            this.invalidate(true, false);
+                        break;
+                }
+            }
+        }
+        else {
+            switch (message.type) {
+                case "seed_accepted":
+                    if (this.state?.seed !== message.data.seed)
+                        this.invalidate(true, false);
+                    break;
+                case "clip_length_accepted":
+                    if (this.state?.clip_seconds !== message.data.clip_seconds)
+                        this.invalidate(true, false);
+                    break;
+                case "canvas_accepted":
+                    if (this.state?.aspect !== message.data.aspect ||
+                        this.state?.width !== message.data.width ||
+                        this.state?.height !== message.data.height)
+                        this.invalidate(true, false);
+                    break;
+                case "autoplay_accepted":
+                    if (this.state?.autoplay !== message.data.enabled)
+                        this.invalidate(true, false);
+                    break;
+                case "flush_accepted":
+                    if (this.state?.flush_on_clip_end !== message.data.enabled)
+                        this.invalidate(true, false);
+                    break;
+                case "session_reset":
+                    if (this.state?.playing !== false ||
+                        this.queue?.generation.length !== 0 ||
+                        this.queue.playout.length !== 0)
+                        this.invalidate(true, true);
+                    break;
+            }
+        }
+        // Settings/stop ACKs never fabricate state. Only the model's complete
+        // state and queue snapshots establish synchronized provider facts.
+        if (this.coherent() && this.availability !== "Unavailable") {
+            this.availability = "Ready";
+            this.rememberFacts();
+        }
+        else if (this.availability !== "Unavailable")
+            this.availability = "Synchronizing";
+        return "applied";
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/h3/_internal/state.js.map

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

package/dist/h3/index.d.ts

@@ -0,0 +1,10 @@
+/** Portable H3 Reference Turbo Realtime provider over a canonical, already connected Session. */
+export { make } from "./_internal/client.js";
+export { validateReference } from "./_internal/references.js";
+export { modelName, documentedVersion, source, requestSeconds, canvases, referenceLimits, } from "./profile.js";
+export { h3ReferenceTurboRealtime, minSeconds, maxSeconds, alignFrames, alignSecondsTo, clampSecondsTo, isRequestableSeconds, estimateTokens, canvasSize, } from "./profile.js";
+export type { ModelProfile, CanvasAspect } from "./profile.js";
+export { Clip, Queue, State } from "./messages.js";
+export type { Message, MessageType, Payload, DecodedMessage } from "./messages.js";
+export type { Reference, ValidatedReference, Request, Options, Aspect, Provider, ProviderSnapshot, ProviderEvent, ProviderObservation, ObservationOptions, Acceptance, PrepareHooks, Reply, ControlResult, Contract, Facts, ClipObservation, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/h3/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,QAAQ,EACR,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,EACxB,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnF,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,OAAO,EACP,OAAO,EACP,MAAM,EACN,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,KAAK,EACL,aAAa,EACb,QAAQ,EACR,KAAK,EACL,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/h3/index.js

@@ -0,0 +1,7 @@
+/** Portable H3 Reference Turbo Realtime provider over a canonical, already connected Session. */
+export { make } from "./_internal/client.js";
+export { validateReference } from "./_internal/references.js";
+export { modelName, documentedVersion, source, requestSeconds, canvases, referenceLimits, } from "./profile.js";
+export { h3ReferenceTurboRealtime, minSeconds, maxSeconds, alignFrames, alignSecondsTo, clampSecondsTo, isRequestableSeconds, estimateTokens, canvasSize, } from "./profile.js";
+export { Clip, Queue, State } from "./messages.js";
+//# sourceMappingURL=index.js.map

package/dist/h3/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/h3/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,QAAQ,EACR,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,EACxB,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC"}