@opencode/ai 2.0.15 → 2.0.17

package/dist/protocols/openai-transcription.d.ts

@@ -0,0 +1,211 @@
+import { Schema } from "effect";
+import { MediaProtocol } from "../route/media-protocol.js";
+import { MediaRoute } from "../route/media.js";
+import { TranscriptionModel, type TranscriptionRequestFor, type TranscriptionSegment } from "../transcription.js";
+export declare const DEFAULT_BASE_URL = "https://api.openai.com/v1";
+export declare const PATH = "/audio/transcriptions";
+export type OpenAITranscriptionOptions = {
+    readonly chunking_strategy?: "auto" | {
+        readonly type: "server_vad";
+        readonly prefix_padding_ms?: number;
+        readonly silence_duration_ms?: number;
+        readonly threshold?: number;
+    };
+    readonly include?: ReadonlyArray<"logprobs">;
+    readonly keywords?: ReadonlyArray<string>;
+    readonly known_speaker_names?: ReadonlyArray<string>;
+    readonly known_speaker_references?: ReadonlyArray<string>;
+    readonly temperature?: number;
+} & Record<string, unknown>;
+export type Request = TranscriptionRequestFor<OpenAITranscriptionOptions>;
+declare const Transcript: Schema.Struct<{
+    text: Schema.String;
+    language: Schema.optional<Schema.String>;
+    languages: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly code: Schema.String;
+    }>>>;
+    duration: Schema.optional<Schema.Number>;
+    segments: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly text: Schema.String;
+        readonly start: Schema.Number;
+        readonly end: Schema.Number;
+        readonly speaker: Schema.optional<Schema.String>;
+    }>>>;
+    words: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly word: Schema.String;
+        readonly start: Schema.Number;
+        readonly end: Schema.Number;
+    }>>>;
+    usage: Schema.optional<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"tokens">;
+        readonly input_tokens: Schema.optional<Schema.Number>;
+        readonly output_tokens: Schema.optional<Schema.Number>;
+        readonly total_tokens: Schema.optional<Schema.Number>;
+        readonly input_token_details: Schema.optional<Schema.Struct<{
+            readonly audio_tokens: Schema.optional<Schema.Number>;
+            readonly text_tokens: Schema.optional<Schema.Number>;
+        }>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"duration">;
+        readonly seconds: Schema.Number;
+    }>]>>;
+}>;
+type Transcript = Schema.Schema.Type<typeof Transcript>;
+type Frame = string | {
+    readonly document: string;
+};
+interface State {
+    readonly segments: Array<TranscriptionSegment>;
+    readonly transcript?: Transcript;
+}
+export declare const protocol: MediaProtocol.Streamed<Request, {
+    readonly id: string;
+    readonly type: "generation-queued";
+    readonly position?: number | undefined;
+} | {
+    readonly id: string;
+    readonly type: "generation-progress";
+    readonly progress?: number | undefined;
+} | {
+    readonly type: "text-delta";
+    readonly delta: string;
+} | {
+    readonly type: "segment";
+    readonly segment: {
+        readonly text: string;
+        readonly startSeconds: number;
+        readonly endSeconds: number;
+        readonly speaker?: string | undefined;
+    };
+} | {
+    readonly type: "finish";
+    readonly text: string;
+    readonly durationSeconds?: number | undefined;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+    readonly usage?: {
+        readonly type: "tokens";
+        readonly input?: number | undefined;
+        readonly output?: number | undefined;
+        readonly total?: number | undefined;
+        readonly details?: {
+            readonly [x: string]: unknown;
+        } | undefined;
+    } | {
+        readonly type: "seconds";
+        readonly seconds: number;
+    } | {
+        readonly type: "characters";
+        readonly characters: number;
+    } | {
+        readonly type: "credits";
+        readonly credits: number;
+    } | {
+        readonly type: "compute";
+        readonly seconds: number;
+    } | undefined;
+    readonly notices?: readonly {
+        readonly type: "other" | "moderated" | "filtered";
+        readonly message: string;
+        readonly providerMetadata?: {
+            readonly [x: string]: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined;
+    }[] | undefined;
+    readonly language?: string | undefined;
+    readonly segments?: readonly {
+        readonly text: string;
+        readonly startSeconds: number;
+        readonly endSeconds: number;
+        readonly speaker?: string | undefined;
+    }[] | undefined;
+    readonly words?: readonly {
+        readonly text: string;
+        readonly startSeconds: number;
+        readonly endSeconds: number;
+        readonly speaker?: string | undefined;
+        readonly confidence?: number | undefined;
+    }[] | undefined;
+}, Frame, State>;
+export declare const model: (input: MediaRoute.ModelInput) => TranscriptionModel<OpenAITranscriptionOptions>;
+export declare const OpenAITranscription: {
+    readonly protocol: MediaProtocol.Streamed<Request, {
+        readonly id: string;
+        readonly type: "generation-queued";
+        readonly position?: number | undefined;
+    } | {
+        readonly id: string;
+        readonly type: "generation-progress";
+        readonly progress?: number | undefined;
+    } | {
+        readonly type: "text-delta";
+        readonly delta: string;
+    } | {
+        readonly type: "segment";
+        readonly segment: {
+            readonly text: string;
+            readonly startSeconds: number;
+            readonly endSeconds: number;
+            readonly speaker?: string | undefined;
+        };
+    } | {
+        readonly type: "finish";
+        readonly text: string;
+        readonly durationSeconds?: number | undefined;
+        readonly providerMetadata?: {
+            readonly [x: string]: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined;
+        readonly usage?: {
+            readonly type: "tokens";
+            readonly input?: number | undefined;
+            readonly output?: number | undefined;
+            readonly total?: number | undefined;
+            readonly details?: {
+                readonly [x: string]: unknown;
+            } | undefined;
+        } | {
+            readonly type: "seconds";
+            readonly seconds: number;
+        } | {
+            readonly type: "characters";
+            readonly characters: number;
+        } | {
+            readonly type: "credits";
+            readonly credits: number;
+        } | {
+            readonly type: "compute";
+            readonly seconds: number;
+        } | undefined;
+        readonly notices?: readonly {
+            readonly type: "other" | "moderated" | "filtered";
+            readonly message: string;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+        }[] | undefined;
+        readonly language?: string | undefined;
+        readonly segments?: readonly {
+            readonly text: string;
+            readonly startSeconds: number;
+            readonly endSeconds: number;
+            readonly speaker?: string | undefined;
+        }[] | undefined;
+        readonly words?: readonly {
+            readonly text: string;
+            readonly startSeconds: number;
+            readonly endSeconds: number;
+            readonly speaker?: string | undefined;
+            readonly confidence?: number | undefined;
+        }[] | undefined;
+    }, Frame, State>;
+    readonly model: (input: MediaRoute.ModelInput) => TranscriptionModel<OpenAITranscriptionOptions>;
+};
+export {};

package/dist/protocols/openai-transcription.js

@@ -0,0 +1,202 @@
+import { Effect, Schema, Stream } from "effect";
+import { classifyProviderFailure } from "../provider-error.js";
+import { Framing } from "../route/framing.js";
+import { MediaProtocol } from "../route/media-protocol.js";
+import { MediaRoute } from "../route/media.js";
+import { AIError, mergeJsonRecords } from "../schema/index.js";
+import { TranscriptionFinishEvent, TranscriptionModel, TranscriptionSegmentEvent, TranscriptionTextDeltaEvent, } from "../transcription.js";
+import { mediaTypeExtension } from "../utils/media-type.js";
+import { ProviderShared } from "./shared.js";
+import { MediaInput } from "./utils/media-input.js";
+const route = MediaProtocol.identity({ id: "openai-transcription", name: "OpenAI Transcription", provider: "openai" });
+export const DEFAULT_BASE_URL = "https://api.openai.com/v1";
+export const PATH = "/audio/transcriptions";
+// ---------------------------------------------------------------------------
+// 3. Streaming event schema
+// ---------------------------------------------------------------------------
+const Segment = Schema.Struct({
+    text: Schema.String,
+    start: Schema.Number,
+    end: Schema.Number,
+    speaker: Schema.optional(Schema.String),
+});
+const Usage = Schema.Union([
+    Schema.Struct({
+        type: Schema.Literal("tokens"),
+        input_tokens: Schema.optional(Schema.Number),
+        output_tokens: Schema.optional(Schema.Number),
+        total_tokens: Schema.optional(Schema.Number),
+        input_token_details: Schema.optional(Schema.Struct({ audio_tokens: Schema.optional(Schema.Number), text_tokens: Schema.optional(Schema.Number) })),
+    }),
+    Schema.Struct({ type: Schema.Literal("duration"), seconds: Schema.Number }),
+]);
+const transcriptFields = {
+    text: Schema.String,
+    language: Schema.optional(Schema.String),
+    languages: Schema.optional(Schema.Array(Schema.Struct({ code: Schema.String }))),
+    duration: Schema.optional(Schema.Number),
+    segments: Schema.optional(Schema.Array(Segment)),
+    words: Schema.optional(Schema.Array(Schema.Struct({ word: Schema.String, start: Schema.Number, end: Schema.Number }))),
+    usage: Schema.optional(Usage),
+};
+/** OpenAI may add stream event types; frames outside `EVENT_TYPES` are ignored. */
+const EventType = Schema.Struct({ type: Schema.String });
+const Event = Schema.Union([
+    Schema.Struct({ type: Schema.Literal("transcript.text.delta"), delta: Schema.String }),
+    Schema.Struct({ type: Schema.Literal("transcript.text.segment"), ...Segment.fields }),
+    Schema.Struct({ type: Schema.Literal("transcript.text.done"), ...transcriptFields }),
+    Schema.Struct({
+        type: Schema.Literal("error"),
+        message: Schema.optional(Schema.String),
+        error: Schema.optional(Schema.Struct({ message: Schema.optional(Schema.String) })),
+    }),
+]);
+const EVENT_TYPES = new Set(["transcript.text.delta", "transcript.text.segment", "transcript.text.done", "error"]);
+const Transcript = Schema.Struct(transcriptFields);
+const decodeEventType = route.decodeFrame(EventType);
+const decodeEvent = route.decodeFrame(Event);
+const decodeTranscript = route.decodeFrame(Transcript);
+const TRANSCRIBE = { stream: true, timestamps: [], diarize: false, languageField: "language" };
+const capabilities = (model) => {
+    if (model.startsWith("whisper"))
+        return { ...TRANSCRIBE, stream: false, timestamps: ["segment", "word"] };
+    if (model.includes("diarize"))
+        return { ...TRANSCRIBE, timestamps: ["segment"], diarize: true };
+    // `gpt-transcribe` replaces `language` with `languages[]` and rejects both together.
+    if (model.startsWith("gpt-transcribe"))
+        return { ...TRANSCRIBE, languageField: "languages" };
+    return TRANSCRIBE;
+};
+/** whisper-1 ignores `stream`, so its `stream` mode sends a plain request and emits only `finish`. */
+const streamsEvents = (request) => request.mode === "stream" && capabilities(request.model.id).stream;
+const validate = (request, model) => {
+    const id = request.model.id;
+    if (request.diarize === true && !model.diarize)
+        return Effect.fail(route.unsupported("media.diarize", `${id} does not diarize; use gpt-4o-transcribe-diarize`));
+    if (request.prompt !== undefined && model.diarize)
+        return Effect.fail(route.unsupported("media.prompt", `${id} does not accept a prompt`));
+    if (request.timestamps === undefined ||
+        request.timestamps === "none" ||
+        model.timestamps.includes(request.timestamps))
+        return Effect.void;
+    return Effect.fail(route.unsupported("media.timestamps", `${id} does not return ${request.timestamps} timestamps`));
+};
+const RESERVED_FORM_FIELDS = new Set([
+    "file",
+    "model",
+    "prompt",
+    "language",
+    "response_format",
+    "timestamp_granularities",
+    "stream",
+]);
+const fromRequest = Effect.fn("OpenAITranscription.fromRequest")(function* (request) {
+    const model = capabilities(request.model.id);
+    yield* validate(request, model);
+    // The API detects the audio format from the upload's filename extension.
+    const extension = mediaTypeExtension(request.audio.mediaType);
+    if (extension === undefined)
+        return yield* ProviderShared.invalidRequest(`${route.name} cannot name a ${request.audio.mediaType} upload; send mp3, mp4, m4a, wav, webm, ogg, or flac audio`);
+    const audio = yield* MediaInput.inlineBytes(route.id, request.audio);
+    const responseFormat = model.diarize
+        ? "diarized_json"
+        : request.timestamps === undefined || request.timestamps === "none"
+            ? undefined
+            : "verbose_json";
+    const form = new FormData();
+    form.append("file", MediaInput.blob(audio, request.audio.mediaType), `audio.${extension}`);
+    MediaInput.appendFields(form, {
+        model: request.model.id,
+        language: model.languageField === "language" ? request.language : undefined,
+        languages: model.languageField === "languages" && request.language !== undefined ? [request.language] : undefined,
+        prompt: request.prompt,
+        response_format: responseFormat,
+        timestamp_granularities: responseFormat === "verbose_json" ? [request.timestamps] : undefined,
+        // Diarizing audio longer than 30 seconds requires a chunking strategy.
+        chunking_strategy: model.diarize ? "auto" : undefined,
+        stream: streamsEvents(request) ? true : undefined,
+    }, {
+        overlay: mergeJsonRecords(request.providerOptions, request.http?.body),
+        reserved: RESERVED_FORM_FIELDS,
+        repeatArrays: true,
+    });
+    return MediaProtocol.multipart(form);
+});
+// ---------------------------------------------------------------------------
+// 6. Stream parsing
+// ---------------------------------------------------------------------------
+const segment = (value) => ({
+    text: value.text.trim(),
+    startSeconds: value.start,
+    endSeconds: value.end,
+    speaker: value.speaker,
+});
+const onEvent = Effect.fn("OpenAITranscription.onEvent")(function* (state, frame) {
+    if (!EVENT_TYPES.has((yield* decodeEventType(frame)).type))
+        return [state, []];
+    const event = yield* decodeEvent(frame);
+    if (event.type === "error")
+        return yield* new AIError({
+            reason: classifyProviderFailure({
+                message: `${route.name} stream failed: ${event.message ?? event.error?.message ?? "unknown error"}`,
+                rawBody: frame,
+            }),
+        });
+    if (event.type === "transcript.text.done")
+        return [{ ...state, transcript: event }, []];
+    if (event.type === "transcript.text.delta")
+        return [state, event.delta.length === 0 ? [] : [TranscriptionTextDeltaEvent.make({ delta: event.delta })]];
+    const next = segment(event);
+    state.segments.push(next);
+    return [state, [TranscriptionSegmentEvent.make({ segment: next })]];
+});
+const step = (state, frame) => typeof frame === "string"
+    ? onEvent(state, frame)
+    : decodeTranscript(frame.document).pipe(Effect.map((transcript) => [{ ...state, transcript }, []]));
+const usage = (value) => {
+    if (value === undefined)
+        return undefined;
+    if (value.type === "duration")
+        return { type: "seconds", seconds: value.seconds };
+    return {
+        type: "tokens",
+        input: value.input_tokens,
+        output: value.output_tokens,
+        total: value.total_tokens,
+        details: { openai: value },
+    };
+};
+const finish = (state) => {
+    const transcript = state.transcript;
+    if (transcript === undefined)
+        return Effect.fail(route.incomplete());
+    const segments = transcript.segments?.map(segment) ?? state.segments;
+    return Effect.succeed([
+        TranscriptionFinishEvent.make({
+            text: transcript.text,
+            segments: segments.length === 0 ? undefined : segments,
+            words: transcript.words?.map((word) => ({ text: word.word, startSeconds: word.start, endSeconds: word.end })),
+            language: (transcript.language ?? transcript.languages?.[0]?.code)?.toLowerCase(),
+            durationSeconds: transcript.duration,
+            usage: usage(transcript.usage),
+        }),
+    ]);
+};
+// ---------------------------------------------------------------------------
+// 7. Protocol and route
+// ---------------------------------------------------------------------------
+export const protocol = MediaProtocol.stream(route, {
+    unsupported: ["speakers"],
+    body: { from: fromRequest },
+    frames: (bytes, context) => streamsEvents(context.request)
+        ? Framing.sse.frame(bytes)
+        : Framing.document.frame(bytes).pipe(Stream.map((document) => ({ document }))),
+    initial: () => ({ segments: [] }),
+    step,
+    finish,
+});
+export const model = (input) => TranscriptionModel.fromRoute({ protocol, baseURL: DEFAULT_BASE_URL, path: PATH }, input);
+export const OpenAITranscription = {
+    protocol,
+    model,
+};

package/dist/protocols/replicate-images.d.ts

@@ -0,0 +1,28 @@
+import { Schema } from "effect";
+import { ImageModel, ImageResponse, type ImageRequestFor } from "../image.js";
+import { MediaProtocol } from "../route/media-protocol.js";
+import { MediaRoute } from "../route/media.js";
+export declare const DEFAULT_BASE_URL = "https://api.replicate.com";
+/** Model-defined `input` fields under the model's own names; `Media.Asset` values lower to URLs or data URLs. */
+export type ReplicateImageOptions = Record<string, unknown>;
+export type Request = ImageRequestFor<ReplicateImageOptions>;
+export declare const Token: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly getURL: Schema.String;
+    readonly cancelURL: Schema.String;
+}>;
+export type Token = Schema.Schema.Type<typeof Token>;
+export declare const protocol: MediaProtocol.Queued<Request, ImageResponse, {
+    readonly id: string;
+    readonly getURL: string;
+    readonly cancelURL: string;
+}>;
+export declare const model: (input: MediaRoute.ModelInput) => ImageModel<ReplicateImageOptions>;
+export declare const ReplicateImages: {
+    readonly protocol: MediaProtocol.Queued<Request, ImageResponse, {
+        readonly id: string;
+        readonly getURL: string;
+        readonly cancelURL: string;
+    }>;
+    readonly model: (input: MediaRoute.ModelInput) => ImageModel<ReplicateImageOptions>;
+};

package/dist/protocols/replicate-images.js

@@ -0,0 +1,127 @@
+import { Duration, Effect, Schema } from "effect";
+import { ImageModel, ImageResponse } from "../image.js";
+import { Media } from "../media.js";
+import { MediaProtocol } from "../route/media-protocol.js";
+import { MediaRoute } from "../route/media.js";
+import { mergeJsonRecords } from "../schema/index.js";
+import { ProviderShared, optionalNull } from "./shared.js";
+const route = MediaProtocol.identity({ id: "replicate-images", name: "Replicate", provider: "replicate" });
+export const DEFAULT_BASE_URL = "https://api.replicate.com";
+const OUTPUT_RETENTION = Duration.hours(1);
+const MAX_DATA_URL_BYTES = 256 * 1024;
+// ---------------------------------------------------------------------------
+// 2. Token and response schemas
+// ---------------------------------------------------------------------------
+export const Token = Schema.Struct({ id: Schema.String, getURL: Schema.String, cancelURL: Schema.String });
+const Prediction = Schema.Struct({
+    id: Schema.String,
+    status: Schema.String,
+    output: optionalNull(Schema.Unknown),
+    error: optionalNull(Schema.Unknown),
+    data_removed: optionalNull(Schema.Boolean),
+    completed_at: optionalNull(Schema.String),
+    metrics: optionalNull(Schema.Struct({ predict_time: optionalNull(Schema.Number) })),
+    urls: Schema.Struct({ get: Schema.String, cancel: Schema.String }),
+});
+const Output = Schema.Union([Schema.String, Schema.Array(Schema.String)]);
+const isOutput = Schema.is(Output);
+const STATUS = {
+    starting: "queued",
+    processing: "running",
+    succeeded: "completed",
+    failed: "failed",
+    canceled: "cancelled",
+    // The prediction hit its `Cancel-After` deadline before it started running.
+    aborted: "expired",
+};
+// ---------------------------------------------------------------------------
+// 5. Request body construction
+// ---------------------------------------------------------------------------
+// Official models run by `owner/name`; anything else (`owner/name:version` or a bare version id) is a pinned version.
+const isOfficial = (model) => /^[^/:]+\/[^/:]+$/.test(model);
+const inlineSize = (source) => {
+    if (source.type === "bytes")
+        return source.data.byteLength;
+    if (source.type === "base64")
+        return source.data.length * 0.75;
+    return 0;
+};
+const fileInput = (asset) => {
+    if (inlineSize(asset.source) > MAX_DATA_URL_BYTES)
+        return Effect.fail(ProviderShared.invalidRequest(`${route.name} data URL inputs are limited to 256 KB; pass a larger file by https URL`));
+    return ProviderShared.mediaReference(asset, undefined, route.name).pipe(Effect.map((reference) => reference.value));
+};
+const inputValue = (value) => {
+    if (value instanceof Media.Asset)
+        return fileInput(value);
+    if (Array.isArray(value) && value.some((item) => item instanceof Media.Asset))
+        return Effect.forEach(value, (item) => (item instanceof Media.Asset ? fileInput(item) : Effect.succeed(item)));
+    return Effect.succeed(value);
+};
+const fromRequest = Effect.fn("ReplicateImages.fromRequest")(function* (request) {
+    const native = yield* Effect.forEach(Object.entries(request.providerOptions ?? {}), ([key, value]) => inputValue(value).pipe(Effect.map((lowered) => [key, lowered])));
+    const input = mergeJsonRecords({ prompt: request.prompt }, Object.fromEntries(native));
+    const model = request.model.id;
+    return MediaProtocol.json(mergeJsonRecords(isOfficial(model) ? { input } : { version: model, input }, request.http?.body) ?? {});
+});
+// ---------------------------------------------------------------------------
+// 6. Response decoding
+// ---------------------------------------------------------------------------
+const decodePrediction = route.decodeJson(Prediction);
+const decodeStart = Effect.fn("ReplicateImages.decodeStart")(function* (response) {
+    const output = yield* decodePrediction(response);
+    const prediction = output.value;
+    return {
+        token: { id: prediction.id, getURL: prediction.urls.get, cancelURL: prediction.urls.cancel },
+        // `Prefer: wait` can return an already-finished prediction, so `await` skips straight to the result.
+        snapshot: { id: prediction.id, status: yield* MediaProtocol.status(STATUS, prediction.status, output) },
+    };
+});
+const decodeStatus = Effect.fn("ReplicateImages.decodeStatus")(function* (response, context) {
+    const output = yield* decodePrediction(response);
+    return { id: context.token.id, status: yield* MediaProtocol.status(STATUS, output.value.status, output) };
+});
+const decodeResult = Effect.fn("ReplicateImages.decodeResult")(function* (response, context) {
+    const output = yield* decodePrediction(response);
+    const prediction = output.value;
+    const status = yield* MediaProtocol.status(STATUS, prediction.status, output);
+    if (status === "failed" || status === "cancelled" || status === "expired")
+        return yield* output.ended(status, `${route.name} prediction ${context.token.id} ${prediction.status}${typeof prediction.error === "string" ? `: ${prediction.error}` : ""}`);
+    if (status !== "completed")
+        return yield* output.pending(context.token.id);
+    if (prediction.data_removed === true)
+        return yield* output.ended("expired", `${route.name} removed the output of prediction ${context.token.id}`);
+    if (!isOutput(prediction.output))
+        return yield* output.invalid(`${route.name} prediction ${context.token.id} returned output that is not image URLs`);
+    const urls = typeof prediction.output === "string" ? [prediction.output] : prediction.output;
+    if (urls.length === 0)
+        return yield* output.invalid(`${route.name} prediction ${context.token.id} returned no images`);
+    const predictTime = prediction.metrics?.predict_time ?? undefined;
+    const completedAt = prediction.completed_at ?? undefined;
+    const expiresAt = completedAt === undefined ? undefined : Date.parse(completedAt) + Duration.toMillis(OUTPUT_RETENTION);
+    return new ImageResponse({
+        images: urls.map((url) => Media.url(url, { expiresAt })),
+        usage: predictTime === undefined ? undefined : { type: "compute", seconds: predictTime },
+        providerMetadata: { replicate: { predictionId: prediction.id } },
+    });
+});
+// ---------------------------------------------------------------------------
+// 7. Protocol and route
+// ---------------------------------------------------------------------------
+export const protocol = MediaProtocol.queued(route, {
+    token: Token,
+    unsupported: ["images", "mask", "n", "size", "aspectRatio", "seed", "format"],
+    start: { body: { from: fromRequest }, decode: decodeStart },
+    status: { path: (token) => token.getURL, decode: decodeStatus },
+    result: { path: (token) => token.getURL, decode: decodeResult },
+    cancel: { method: "POST", path: (token) => token.cancelURL },
+});
+export const model = (input) => ImageModel.fromRoute({
+    protocol,
+    baseURL: DEFAULT_BASE_URL,
+    path: ({ request }) => isOfficial(request.model.id) ? `/v1/models/${request.model.id}/predictions` : "/v1/predictions",
+}, input);
+export const ReplicateImages = {
+    protocol,
+    model,
+};

package/dist/protocols/runway-video.d.ts

@@ -0,0 +1,38 @@
+import { Schema } from "effect";
+import { MediaProtocol } from "../route/media-protocol.js";
+import { MediaRoute } from "../route/media.js";
+import { type OpenString } from "../schema/index.js";
+import { VideoModel, VideoResponse, type VideoRequestFor } from "../video.js";
+export declare const DEFAULT_BASE_URL = "https://api.dev.runwayml.com/v1";
+/** Every Runway request must pin the API version. */
+export declare const API_VERSION = "2024-11-06";
+export declare const TEXT_TO_VIDEO_PATH = "/text_to_video";
+export declare const IMAGE_TO_VIDEO_PATH = "/image_to_video";
+export declare const VIDEO_TO_VIDEO_PATH = "/video_to_video";
+export declare const TASKS_PATH = "/tasks";
+/**
+ * Provider-native options. Common fields lower to Runway's names: `aspectRatio` → `ratio` (Runway expects pixel
+ * ratios such as `1280:720` for most models), `durationSeconds` → `duration`, `audio`, `negativePrompt`,
+ * `resolution`, `references`, and `frames` → `promptImage`.
+ */
+export type RunwayVideoOptions = {
+    readonly contentModeration?: {
+        readonly publicFigureThreshold?: OpenString<"auto" | "low">;
+    };
+    readonly outputFormat?: OpenString<"mp4" | "prores" | "png_sequence">;
+} & Record<string, unknown>;
+export type Request = VideoRequestFor<RunwayVideoOptions>;
+export declare const Token: Schema.Struct<{
+    readonly taskID: Schema.String;
+}>;
+export type Token = Schema.Schema.Type<typeof Token>;
+export declare const protocol: MediaProtocol.Queued<Request, VideoResponse, {
+    readonly taskID: string;
+}>;
+export declare const model: (input: MediaRoute.ModelInput) => VideoModel<RunwayVideoOptions>;
+export declare const RunwayVideo: {
+    readonly protocol: MediaProtocol.Queued<Request, VideoResponse, {
+        readonly taskID: string;
+    }>;
+    readonly model: (input: MediaRoute.ModelInput) => VideoModel<RunwayVideoOptions>;
+};