reactor-effect-client 0.7.1 → 0.8.0

package/dist/internal/h3/operations.js

@@ -0,0 +1,284 @@
+/**
+ * Clip operations by submission: what the provider's evidence established
+ * about each committed clip, from acceptance to its end. Every transition is
+ * pure and returns the waiters it completes, run once the new table is in place.
+ */
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Result from "effect/Result";
+import { ClipEnded, CommandFailure, ReactorError } from "../../ReactorError.js";
+export const empty = (capacity) => ({
+    capacity,
+    operations: new Map(),
+    byClip: new Map(),
+});
+export const makeWaiters = Effect.all({
+    accepted: Deferred.make(),
+    generated: Deferred.make(),
+    started: Deferred.make(),
+    finished: Deferred.make(),
+});
+/** Nothing more can change it: its clip ended once accepted, or it was decided without one. */
+const settled = (operation) => (operation.ended !== undefined && operation.acceptance !== undefined) ||
+    operation.indeterminate ||
+    operation.rejected;
+const put = (table, operation) => {
+    const operations = new Map(table.operations).set(operation.identity.id, operation);
+    const byClip = operation.clipId === undefined || operation.rejected
+        ? table.byClip
+        : new Map(table.byClip).set(operation.clipId, operation.identity.id);
+    return { ...table, operations, byClip };
+};
+const remove = (table, id) => {
+    const operation = table.operations.get(id);
+    if (operation === undefined)
+        return table;
+    const operations = new Map(table.operations);
+    operations.delete(id);
+    const byClip = new Map(table.byClip);
+    if (operation.clipId !== undefined && byClip.get(operation.clipId) === id)
+        byClip.delete(operation.clipId);
+    return { ...table, operations, byClip };
+};
+const succeed = (deferred, value) => Effect.asVoid(Deferred.succeed(deferred, value));
+const fail = (deferred, error) => Effect.asVoid(Deferred.fail(deferred, error));
+/**
+ * Takes a slot for a submission about to dispatch. Operations that ended are
+ * evicted first, oldest first; a table of unresolved operations refuses.
+ */
+export const reserve = ({ table, identity, waiters, }) => {
+    if (table.operations.has(identity.id))
+        return Result.succeed(table);
+    let next = table;
+    if (next.operations.size >= next.capacity) {
+        const evictable = [...next.operations.values()].find(settled);
+        if (evictable !== undefined)
+            next = remove(next, evictable.identity.id);
+    }
+    if (next.operations.size >= next.capacity)
+        return Result.fail(ReactorError.fromCode("Overflow", "H3 clip operation bound reached", {
+            operation: "enqueue",
+            outcome: "not-submitted",
+        }));
+    return Result.succeed(put(next, {
+        identity,
+        waiters,
+        acceptance: undefined,
+        clipId: undefined,
+        generated: undefined,
+        started: undefined,
+        ended: undefined,
+        indeterminate: false,
+        rejected: false,
+        holders: 0,
+    }));
+};
+/** A commit that failed after reserving sent nothing. */
+export const abandon = ({ table, id }) => remove(table, id);
+/** What an operation established resolves its waiters, once its acceptance is decided. */
+const publish = (operation) => {
+    if (operation.acceptance === undefined)
+        return [];
+    const { generated, started, ended, waiters } = operation;
+    const effects = [];
+    if (generated !== undefined)
+        effects.push(succeed(waiters.generated, generated));
+    if (started !== undefined)
+        effects.push(succeed(waiters.started, started));
+    if (ended === undefined)
+        return effects;
+    if (ended.message === "clip_failed" || ended.message === "clip_popped") {
+        const error = ReactorError.make({
+            reason: ClipEnded.make({
+                message: `clip ended by ${ended.message}`,
+                clipId: ended.clipId,
+                lifecycle: ended.message,
+                transportGeneration: ended.transportGeneration,
+            }),
+            context: { operation: "clip operation" },
+        });
+        // A phase that was not reached never will be.
+        if (generated === undefined)
+            effects.push(fail(waiters.generated, error));
+        if (started === undefined)
+            effects.push(fail(waiters.started, error));
+    }
+    effects.push(succeed(waiters.finished, ended));
+    return effects;
+};
+/** The enqueue's own result: a definite failure decides the operation without a clip. */
+export const settle = ({ table, id, exit, }) => {
+    const operation = table.operations.get(id);
+    if (operation === undefined || operation.acceptance !== undefined || Exit.isSuccess(exit))
+        return [table, []];
+    const error = Exit.findError(exit);
+    if (error._tag !== "Success" || !CommandFailure.is(error.success))
+        return [table, []];
+    const failure = error.success;
+    if (failure.context.outcome === "unknown")
+        return [table, []];
+    // No clip will ever carry this submission, and what a clip showed before the
+    // refusal is not its fact.
+    const rejected = {
+        ...operation,
+        rejected: true,
+        generated: undefined,
+        started: undefined,
+        ended: undefined,
+    };
+    const next = put(remove(table, id), { ...rejected, clipId: undefined });
+    const { waiters } = operation;
+    return [
+        next,
+        [
+            fail(waiters.accepted, failure),
+            fail(waiters.generated, failure),
+            fail(waiters.started, failure),
+            fail(waiters.finished, failure),
+        ],
+    ];
+};
+/**
+ * Evidence the provider holds until the enqueue's reply decides the
+ * acceptance: the clip's facts accrue meanwhile.
+ */
+export const identify = ({ table, acceptance, }) => {
+    const operation = table.operations.get(acceptance.submissionId);
+    if (operation === undefined || operation.clipId !== undefined || operation.rejected)
+        return table;
+    return put(table, { ...operation, clipId: acceptance.clip.clip_id });
+};
+/** The acceptance the provider recorded, on the same path that records it. */
+export const accept = ({ table, acceptance, }) => {
+    const operation = table.operations.get(acceptance.submissionId);
+    if (operation === undefined || operation.acceptance !== undefined)
+        return [table, []];
+    const accepted = {
+        ...operation,
+        acceptance,
+        clipId: operation.clipId ?? acceptance.clip.clip_id,
+    };
+    return [
+        put(table, accepted),
+        [succeed(operation.waiters.accepted, acceptance), ...publish(accepted)],
+    ];
+};
+/**
+ * A clip carrying a submission's exact prompt and metadata after its pending
+ * acceptance expired, or in a later generation. It resolves the operation only.
+ */
+export const lateEvidence = ({ table, id, clip, source, }) => {
+    const operation = table.operations.get(id);
+    if (operation === undefined ||
+        operation.acceptance !== undefined ||
+        operation.rejected ||
+        operation.identity.metadata !== clip.metadata ||
+        operation.identity.prompt !== clip.prompt)
+        return [table, []];
+    return accept({
+        table,
+        acceptance: { submissionId: id, clip, evidence: { kind: "metadata", source } },
+    });
+};
+const fact = (clipId, message, source) => ({
+    clipId,
+    message,
+    transportGeneration: source.generation,
+    source,
+});
+const advance = (table, clipId, message, source, phase) => {
+    const id = table.byClip.get(clipId);
+    const operation = id === undefined ? undefined : table.operations.get(id);
+    if (operation === undefined || operation.ended !== undefined || operation.indeterminate)
+        return [table, []];
+    const evidence = fact(clipId, message, source);
+    // Started implies generated, and an end that finished or stopped implies both.
+    const reachedStart = phase === "started" ||
+        (phase === "ended" && (message === "clip_finished" || message === "clip_stopped"));
+    const next = {
+        ...operation,
+        generated: operation.generated ?? (phase === "generated" || reachedStart ? evidence : undefined),
+        started: operation.started ?? (reachedStart ? evidence : undefined),
+        ended: phase === "ended" ? evidence : undefined,
+    };
+    return [put(table, next), publish(next)];
+};
+/** Advances operations from a message the reducer applied. */
+export const observe = ({ table, message, source, }) => {
+    if (table.byClip.size === 0)
+        return [table, []];
+    switch (message.type) {
+        case "queue_update": {
+            let next = table;
+            const effects = [];
+            for (const clip of message.data.playout)
+                if (clip.ready) {
+                    const [after, done] = advance(next, clip.clip_id, "queue_update", source, "generated");
+                    next = after;
+                    effects.push(...done);
+                }
+            return [next, effects];
+        }
+        case "state_update":
+            return message.data.playing_clip_id === null
+                ? [table, []]
+                : advance(table, message.data.playing_clip_id, "state_update", source, "started");
+        case "clip_generated":
+            return advance(table, message.data.clip.clip_id, message.type, source, "generated");
+        case "clip_started":
+            return advance(table, message.data.clip.clip_id, message.type, source, "started");
+        case "clip_finished":
+        case "clip_stopped":
+        case "clip_failed":
+        case "clip_popped":
+            return advance(table, message.data.clip.clip_id, message.type, source, "ended");
+        default:
+            return [table, []];
+    }
+};
+/** The provider retired: what evidence did not decide is `Indeterminate`. */
+export const retire = (table) => {
+    const indeterminate = ReactorError.fromCode("Indeterminate", "H3 provider retired before the clip's evidence", { operation: "clip operation" });
+    let next = table;
+    const effects = [];
+    for (const operation of table.operations.values()) {
+        const { waiters } = operation;
+        effects.push(fail(waiters.accepted, indeterminate), fail(waiters.generated, indeterminate), fail(waiters.started, indeterminate), fail(waiters.finished, indeterminate));
+        next =
+            operation.holders === 0
+                ? remove(next, operation.identity.id)
+                : put(next, {
+                    ...operation,
+                    indeterminate: operation.indeterminate || !settled(operation),
+                });
+    }
+    return [next, effects];
+};
+/** A holder of an operation; releasing the last holder acknowledges it and frees its slot. */
+export const hold = ({ table, id, }) => {
+    const operation = table.operations.get(id);
+    return operation === undefined
+        ? Result.fail(ReactorError.fromCode("InvalidState", "H3 has no clip operation for this submission; it has not committed or was released", { operation: "clip operation" }))
+        : Result.succeed(put(table, { ...operation, holders: operation.holders + 1 }));
+};
+export const release = ({ table, id }) => {
+    const operation = table.operations.get(id);
+    if (operation === undefined)
+        return table;
+    return operation.holders <= 1
+        ? remove(table, id)
+        : put(table, { ...operation, holders: operation.holders - 1 });
+};
+/** A clip's facts are the operation's once its acceptance is decided. */
+export const factsOf = ({ id, operation, }) => operation?.acceptance === undefined
+    ? { submissionId: id, indeterminate: operation?.indeterminate ?? false }
+    : {
+        submissionId: id,
+        acceptance: operation.acceptance,
+        ...(operation.generated === undefined ? {} : { generated: operation.generated }),
+        ...(operation.started === undefined ? {} : { started: operation.started }),
+        ...(operation.ended === undefined ? {} : { ended: operation.ended }),
+        indeterminate: operation.indeterminate,
+    };
+//# sourceMappingURL=operations.js.map

package/dist/internal/h3/operations.js.map

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

package/dist/{h3 → internal/h3}/profile.d.ts

@@ -2,52 +2,52 @@
 export declare const modelName: "reactor/h3-reference-to-video-turbo-realtime";
 export declare const documentedVersion: "0.5.5";
 export declare const source = "https://docs.reactor.inc/model-api-reference/h3-reference-to-video-turbo-realtime/schema";
-export declare const requestSeconds: Readonly<{
-    min: 5;
-    max: 15.084;
-}>;
-export declare const canvases: Readonly<{
-    "16:9": Readonly<{
-        width: 1344;
-        height: 768;
-    }>;
-    "1:1": Readonly<{
-        width: 768;
-        height: 768;
-    }>;
-    "9:16": Readonly<{
-        width: 768;
-        height: 1344;
-    }>;
-    "4:3": Readonly<{
-        width: 1024;
-        height: 768;
-    }>;
-}>;
+export declare const requestSeconds: {
+    readonly min: 5;
+    readonly max: 15.084;
+};
+export declare const canvases: {
+    readonly "16:9": {
+        readonly width: 1344;
+        readonly height: 768;
+    };
+    readonly "1:1": {
+        readonly width: 768;
+        readonly height: 768;
+    };
+    readonly "9:16": {
+        readonly width: 768;
+        readonly height: 1344;
+    };
+    readonly "4:3": {
+        readonly width: 1024;
+        readonly height: 768;
+    };
+};
+export type CanvasAspect = keyof typeof canvases;
 /** SDK image safety bounds; byte validation does not replace the model's image decoder. */
-export declare const referenceLimits: Readonly<{
-    maxImages: 9;
-    maxBytes: number;
-    maxPixels: 25000000;
-    minAspect: 0.25;
-    maxAspect: 4;
-}>;
+export declare const referenceLimits: {
+    readonly maxImages: 9;
+    readonly maxBytes: number;
+    readonly maxPixels: 25000000;
+    readonly minAspect: 0.25;
+    readonly maxAspect: 4;
+};
 /**
  * H3's audio reference bounds: at most three clips, or two when the clip
  * continues another, whose soundtrack takes the third; at most twelve
  * references in total, counting images, audio and a continuation; each 2–15 s
  * long, mono or stereo, and at most 25 MiB.
  */
-export declare const audioReferenceLimits: Readonly<{
-    maxAudio: 3;
-    maxAudioWithContinuation: 2;
-    maxTotal: 12;
-    maxBytes: number;
-    minSeconds: 2;
-    maxSeconds: 15;
-    maxChannels: 2;
-}>;
-/** Adapter limits shared by request capture, reference validation and profile declarations. */
+export declare const audioReferenceLimits: {
+    readonly maxAudio: 3;
+    readonly maxAudioWithContinuation: 2;
+    readonly maxTotal: 12;
+    readonly maxBytes: number;
+    readonly minSeconds: 2;
+    readonly maxSeconds: 15;
+    readonly maxChannels: 2;
+};
 export declare const metadataMaxChars = 2000;
 export declare const imageMimeTypes: readonly ["image/jpeg", "image/png", "image/webp"];
 /**
@@ -57,10 +57,7 @@ export declare const imageMimeTypes: readonly ["image/jpeg", "image/png", "image
  * may carry any of them.
  */
 export declare const audioMimeTypes: readonly ["audio/wav", "audio/mpeg", "audio/aac", "audio/mp4", "audio/ogg", "audio/flac", "audio/webm", "audio/x-wav", "audio/wave", "audio/x-m4a", "audio/opus", "audio/x-flac"];
-/** Shared H3 timing data and explicit defaults used by offline orchestration. */
-export type CanvasAspect = keyof typeof canvases;
 export interface ModelProfile {
-    /** Wire model name passed to the SDK. */
     readonly modelName: string;
     readonly fps: number;
     /** Legal output lengths are `minFrames + k * frameStep`, `k >= 0`, up to `maxFrames`. */
@@ -74,9 +71,9 @@ export interface ModelProfile {
     };
     readonly prompt: {
         readonly maxChars: number;
-        /** Provider-side text budget. It is not a local hard limit because the provider tokenizer is authoritative. */
+        /** The provider's text budget; its tokenizer, not this estimate, is authoritative. */
         readonly maxTokens: number;
-        /** Conservative characters-per-token used to estimate the token bound locally. */
+        /** Conservative characters per token for a local estimate. */
         readonly charsPerTokenEstimate: number;
     };
     readonly references: {
@@ -89,10 +86,7 @@ export interface ModelProfile {
         readonly maxAspect: number;
         readonly mimeTypes: ReadonlyArray<string>;
     };
-    /**
-     * Audio references the model takes beside its images; absent for a model
-     * that takes none, whose requests must carry no audio.
-     */
+    /** Audio references the model takes beside its images; absent for a model that takes none. */
     readonly audioReferences?: {
         readonly max: number;
         /** A continued clip spends one audio slot on the previous clip's soundtrack. */
@@ -110,12 +104,12 @@ export interface ModelProfile {
         readonly width: number;
         readonly height: number;
     }>;
-    /** Defaults for offline simulation; live provider snapshots remain authoritative. */
+    /** The queue capacities H3 documents; live state snapshots are authoritative. */
     readonly expectedCapacities: {
         readonly generation: number;
         readonly playout: number;
     };
-    /** Bounded continuation hints for orchestration; not a claim that the deployment retains a clip. */
+    /** How many recent clips orchestration offers as continuations. */
     readonly continuationWindow: number;
     readonly audio: {
         readonly sampleRate: number;
@@ -127,20 +121,24 @@ export interface ModelProfile {
     };
 }
 export declare const h3ReferenceTurboRealtime: ModelProfile;
-export declare const minSeconds: (p: ModelProfile) => number;
-export declare const maxSeconds: (p: ModelProfile) => number;
-/** Snap upward on this profile's frame grid. Actual admitted lengths come from Clip.frames and Clip.seconds. */
-export declare const alignFrames: (p: ModelProfile, seconds: number) => number;
-export declare const alignSecondsTo: (p: ModelProfile, seconds: number) => number;
-/** Clamp into the accepted request range, then align. Always yields a length the provider accepts. */
-export declare const clampSecondsTo: (p: ModelProfile, seconds: number) => number;
+export declare const minSeconds: (profile: ModelProfile) => number;
+export declare const maxSeconds: (profile: ModelProfile) => number;
+/**
+ * The frame count a request of `seconds` produces: rounded up onto the
+ * profile's frame grid. A clip's own `frames` and `seconds` are authoritative.
+ */
+export declare const alignFrames: {
+    (seconds: number): (profile: ModelProfile) => number;
+    (profile: ModelProfile, seconds: number): number;
+};
 /** True when `seconds` is a length the provider accepts as a request. */
-export declare const isRequestableSeconds: (p: ModelProfile, seconds: number) => boolean;
-/** Advisory token-count estimate for caller budgeting. The adapter does not reject from this estimate; the provider tokenizer is authoritative. */
-export declare const estimateTokens: (p: ModelProfile, prompt: string) => number;
-export declare const canvasSize: (p: ModelProfile, aspect: CanvasAspect) => {
-    readonly aspect: CanvasAspect;
-    readonly width: number;
-    readonly height: number;
-} | undefined;
+export declare const isRequestableSeconds: {
+    (seconds: number): (profile: ModelProfile) => boolean;
+    (profile: ModelProfile, seconds: number): boolean;
+};
+/** An advisory token estimate for budgeting; the provider's tokenizer decides. */
+export declare const estimateTokens: {
+    (prompt: string): (profile: ModelProfile) => number;
+    (profile: ModelProfile, prompt: string): number;
+};
 //# sourceMappingURL=profile.d.ts.map

package/dist/internal/h3/profile.d.ts.map

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

package/dist/{h3 → internal/h3}/profile.js

@@ -1,29 +1,31 @@
+/** The H3 Reference Turbo Realtime model: its documented limits and frame grid. */
+import { dual } from "effect/Function";
 /** Documentation revision selected by this adapter, not an assertion about a server version. */
 export const modelName = "reactor/h3-reference-to-video-turbo-realtime";
 export const documentedVersion = "0.5.5";
 export const source = "https://docs.reactor.inc/model-api-reference/h3-reference-to-video-turbo-realtime/schema";
-export const requestSeconds = Object.freeze({ min: 5, max: 15.084 });
-export const canvases = Object.freeze({
-    "16:9": Object.freeze({ width: 1344, height: 768 }),
-    "1:1": Object.freeze({ width: 768, height: 768 }),
-    "9:16": Object.freeze({ width: 768, height: 1344 }),
-    "4:3": Object.freeze({ width: 1024, height: 768 }),
-});
+export const requestSeconds = { min: 5, max: 15.084 };
+export const canvases = {
+    "16:9": { width: 1344, height: 768 },
+    "1:1": { width: 768, height: 768 },
+    "9:16": { width: 768, height: 1344 },
+    "4:3": { width: 1024, height: 768 },
+};
 /** SDK image safety bounds; byte validation does not replace the model's image decoder. */
-export const referenceLimits = Object.freeze({
+export const referenceLimits = {
     maxImages: 9,
     maxBytes: 25 * 1024 * 1024,
     maxPixels: 25_000_000,
     minAspect: 0.25,
     maxAspect: 4,
-});
+};
 /**
  * H3's audio reference bounds: at most three clips, or two when the clip
  * continues another, whose soundtrack takes the third; at most twelve
  * references in total, counting images, audio and a continuation; each 2–15 s
  * long, mono or stereo, and at most 25 MiB.
  */
-export const audioReferenceLimits = Object.freeze({
+export const audioReferenceLimits = {
     maxAudio: 3,
     maxAudioWithContinuation: 2,
     maxTotal: 12,
@@ -31,17 +33,16 @@ export const audioReferenceLimits = Object.freeze({
     minSeconds: 2,
     maxSeconds: 15,
     maxChannels: 2,
-});
-/** Adapter limits shared by request capture, reference validation and profile declarations. */
+};
 export const metadataMaxChars = 2_000;
-export const imageMimeTypes = Object.freeze(["image/jpeg", "image/png", "image/webp"]);
+export const imageMimeTypes = ["image/jpeg", "image/png", "image/webp"];
 /**
  * The audio formats H3 documents (WAV, MP3, AAC/M4A, OGG/Opus, FLAC and WebM),
  * by the MIME type an upload of each carries. Bytes are identified by their
  * container, which names the first type of each format; an existing upload
  * may carry any of them.
  */
-export const audioMimeTypes = Object.freeze([
+export const audioMimeTypes = [
     "audio/wav",
     "audio/mpeg",
     "audio/aac",
@@ -54,7 +55,7 @@ export const audioMimeTypes = Object.freeze([
     "audio/x-m4a",
     "audio/opus",
     "audio/x-flac",
-]);
+];
 export const h3ReferenceTurboRealtime = {
     modelName,
     fps: 24,
@@ -62,8 +63,8 @@ export const h3ReferenceTurboRealtime = {
     maxFrames: 362,
     frameStep: 17,
     requestSeconds,
-    // No provider character limit; the text budget is ~2,000 tokens ("roughly 8,000 characters of English
-    // prose") and exceeding it fails the clip at build. maxChars is our own sanity bound.
+    // The provider sets no character limit; its budget is about 2,000 tokens, and
+    // a longer prompt fails the clip at build. maxChars is this SDK's own bound.
     prompt: { maxChars: 12_000, maxTokens: 2_000, charsPerTokenEstimate: 3.5 },
     references: {
         min: 0,
@@ -72,7 +73,7 @@ export const h3ReferenceTurboRealtime = {
         maxPixels: referenceLimits.maxPixels,
         minAspect: referenceLimits.minAspect,
         maxAspect: referenceLimits.maxAspect,
-        mimeTypes: [...imageMimeTypes],
+        mimeTypes: imageMimeTypes,
     },
     audioReferences: {
         max: audioReferenceLimits.maxAudio,
@@ -81,34 +82,33 @@ export const h3ReferenceTurboRealtime = {
         maxBytes: audioReferenceLimits.maxBytes,
         minSeconds: audioReferenceLimits.minSeconds,
         maxSeconds: audioReferenceLimits.maxSeconds,
-        mimeTypes: [...audioMimeTypes],
+        mimeTypes: audioMimeTypes,
     },
     metadataMaxChars,
-    canvases: Object.entries(canvases).map(([aspect, size]) => ({
-        aspect: aspect,
-        ...size,
+    canvases: ["16:9", "1:1", "9:16", "4:3"].map((aspect) => ({
+        aspect,
+        ...canvases[aspect],
     })),
     expectedCapacities: { generation: 20, playout: 10 },
     continuationWindow: 8,
     audio: { sampleRate: 48_000, channels: 1 },
     tracks: { video: "main_video", audio: "main_audio" },
 };
-export const minSeconds = (p) => p.minFrames / p.fps;
-export const maxSeconds = (p) => p.maxFrames / p.fps;
-/** Snap upward on this profile's frame grid. Actual admitted lengths come from Clip.frames and Clip.seconds. */
-export const alignFrames = (p, seconds) => {
-    if (!Number.isFinite(seconds))
-        throw new RangeError("clip length must be finite");
-    const frames = Math.ceil(seconds * p.fps - 1e-6);
-    const steps = Math.ceil(Math.max(0, frames - p.minFrames) / p.frameStep);
-    return Math.min(p.maxFrames, p.minFrames + steps * p.frameStep);
-};
-export const alignSecondsTo = (p, seconds) => alignFrames(p, seconds) / p.fps;
-/** Clamp into the accepted request range, then align. Always yields a length the provider accepts. */
-export const clampSecondsTo = (p, seconds) => alignSecondsTo(p, Math.min(p.requestSeconds.max, Math.max(p.requestSeconds.min, Number.isFinite(seconds) ? seconds : p.requestSeconds.min)));
+export const minSeconds = (profile) => profile.minFrames / profile.fps;
+export const maxSeconds = (profile) => profile.maxFrames / profile.fps;
+/**
+ * The frame count a request of `seconds` produces: rounded up onto the
+ * profile's frame grid. A clip's own `frames` and `seconds` are authoritative.
+ */
+export const alignFrames = dual(2, (profile, seconds) => {
+    const frames = Number.isFinite(seconds) ? Math.ceil(seconds * profile.fps - 1e-6) : 0;
+    const steps = Math.ceil(Math.max(0, frames - profile.minFrames) / profile.frameStep);
+    return Math.min(profile.maxFrames, profile.minFrames + steps * profile.frameStep);
+});
 /** True when `seconds` is a length the provider accepts as a request. */
-export const isRequestableSeconds = (p, seconds) => Number.isFinite(seconds) && seconds >= p.requestSeconds.min && seconds <= p.requestSeconds.max;
-/** Advisory token-count estimate for caller budgeting. The adapter does not reject from this estimate; the provider tokenizer is authoritative. */
-export const estimateTokens = (p, prompt) => Math.ceil(prompt.length / p.prompt.charsPerTokenEstimate);
-export const canvasSize = (p, aspect) => p.canvases.find((c) => c.aspect === aspect);
+export const isRequestableSeconds = dual(2, (profile, seconds) => Number.isFinite(seconds) &&
+    seconds >= profile.requestSeconds.min &&
+    seconds <= profile.requestSeconds.max);
+/** An advisory token estimate for budgeting; the provider's tokenizer decides. */
+export const estimateTokens = dual(2, (profile, prompt) => Math.ceil(prompt.length / profile.prompt.charsPerTokenEstimate));
 //# sourceMappingURL=profile.js.map