@reactor-models/lingbot 0.2.18 → 0.2.21

package/dist/core.d.mts

@@ -0,0 +1,326 @@
+import { Reactor, FileRef } from '@reactor-team/js-sdk';
+export { FileRef } from '@reactor-team/js-sdk';
+
+declare const MODEL_NAME: "lingbot";
+declare const MODEL_VERSION: "v0.2.21";
+/**
+ * Preset media tracks for the Lingbot model.
+ *
+ * Declared in the model's OpenAPI schema and passed to the SDK as
+ * `modelTracks` so the transport can prepare the SDP offer in
+ * parallel with session polling (faster first-frame latency).
+ */
+declare const LingbotTracks: readonly [{
+    readonly name: "main_video";
+    readonly kind: "video";
+    readonly direction: "recvonly";
+}];
+/** Track names the client can subscribe to (recvonly, from the client's perspective). */
+type LingbotRecvTrackName = "main_video";
+/** Set seed */
+interface LingbotSetSeedParams {
+    /**
+     * Seed for the random generator used to sample the initial noise. Must be a non-negative integer; the model never draws its own random seed — pick one explicitly (or keep the default) for reproducible runs. Read once when `start` fires; later changes take effect only after `reset` followed by a new `start`.
+     * @minimum 0
+     * @default 42
+     */
+    seed?: number;
+}
+/** Provide a reference image that anchors generation (image-to-video). Call before `start`; the image is required for generation to begin. Changes during generation have no effect until `reset` is issued and `start` is called again. Emits `image_accepted`, `conditions_ready`, and `state` on success, or `command_error` if the file is missing, not an image, or cannot be decoded. */
+interface LingbotSetImageParams {
+    /**
+     * Reference to a file uploaded via the Reactor presigned-URL protocol.
+     * @default null
+     */
+    image?: FileRef;
+}
+/** Set the scene prompt. Valid at any time — call before `start` to arm generation, or hot-swap during generation to steer the next chunk. Emits `prompt_accepted`, `conditions_ready`, and `state` on success. */
+interface LingbotSetPromptParams {
+    /**
+     * Natural-language description of the scene to generate. Replaces the previously active prompt. Applied on the next chunk when generating; otherwise takes effect when `start` fires.
+     * @default ""
+     */
+    prompt?: string;
+}
+/** Set movement */
+interface LingbotSetMovementParams {
+    /**
+     * Character movement in the generated scene. `idle` holds the character stationary; `forward` / `back` translate along the look axis; `strafe_left` / `strafe_right` translate sideways. Can be changed at any time; the new value applies to the next chunk.
+     * @default "idle"
+     */
+    movement?: "idle" | "forward" | "back" | "strafe_left" | "strafe_right";
+}
+/** Set look_vertical */
+interface LingbotSetLookVerticalParams {
+    /**
+     * Vertical (pitch) camera rotation. `idle` holds pitch steady; `up` / `down` rotate the camera at the rate given by `rotation_speed_deg`. Can be changed at any time; the new value applies to the next chunk.
+     * @default "idle"
+     */
+    look_vertical?: "idle" | "up" | "down";
+}
+/** Set look_horizontal */
+interface LingbotSetLookHorizontalParams {
+    /**
+     * Horizontal (yaw) camera rotation. `idle` holds yaw steady; `left` / `right` rotate the camera at the rate given by `rotation_speed_deg`. Can be changed at any time; the new value applies to the next chunk.
+     * @default "idle"
+     */
+    look_horizontal?: "idle" | "left" | "right";
+}
+/** Set rotation_speed_deg */
+interface LingbotSetRotationSpeedDegParams {
+    /**
+     * Camera rotation speed in degrees per latent frame, applied when `look_horizontal` or `look_vertical` is not `idle`. Range 0.0 – 30.0. Ignored when both look axes are `idle`. Can be changed at any time; the new value applies to the next chunk.
+     * @minimum 0
+     * @maximum 30
+     * @default 5
+     */
+    rotation_speed_deg?: number;
+}
+/**
+ * Snapshot of the session's observable state.
+ *
+ * Emitted on connect, after every command that mutates session state (`set_prompt`, `set_image`, `start`, `pause`, `resume`, `reset`, and the auto-generated `set_<field>` setters), and after each `chunk_complete`. Clients can treat this as the single source of truth for driving UI, without having to track every individual command and message themselves.
+ */
+interface LingbotStateMessage {
+    type: "state";
+    /** Current value of the `seed` input field. The seed that was actually used by the running generation was captured when `start` fired — later changes to `seed` only take effect after `reset` and a new `start`. */
+    seed: number;
+    /** True while generation is paused via `pause`. */
+    paused: boolean;
+    /** True while the chunk loop is actively producing frames — equivalent to `started and not paused`. `False` both before `start` and while paused; read `started` to disambiguate. */
+    running: boolean;
+    /** True once `start` has been accepted. Remains true while paused; reset to false by `reset` or after `generation_complete` when the session is not auto-restarting. */
+    started: boolean;
+    /** Current value of the `movement` input field. */
+    movement: string;
+    /** True once a reference image has been set for the session. */
+    has_image: boolean;
+    /** True once a prompt has been set for the session. */
+    has_prompt: boolean;
+    /** Zero-based index of the last completed chunk. `0` before the first chunk has completed, and resets to `0` on `reset`. */
+    current_chunk: number;
+    /** Current value of the `look_vertical` input field. */
+    look_vertical: string;
+    /** Composite action string derived from `movement`, `look_horizontal`, and `look_vertical` — a `+`-joined combination of `w`/`s`/`a`/`d` and `left`/`right`/`up`/`down`, or `still` when idle. */
+    current_action: string;
+    /** The prompt currently driving generation, or `null` if no prompt has been set for the session. */
+    current_prompt: unknown;
+    /** Current value of the `look_horizontal` input field. */
+    look_horizontal: string;
+    /** Current value of the `rotation_speed_deg` input field (0.0 – 30.0). */
+    rotation_speed_deg: number;
+}
+/** Emitted when a command is rejected because preconditions are not met or its arguments could not be processed. */
+interface LingbotCommandErrorMessage {
+    type: "command_error";
+    /** Human-readable explanation of why the command was rejected. */
+    reason: string;
+    /** Name of the command that was rejected. */
+    command: string;
+}
+/** Emitted once per completed chunk of `main_video`. */
+interface LingbotChunkCompleteMessage {
+    type: "chunk_complete";
+    /** Zero-based index of the chunk that just completed. */
+    chunk_index: number;
+    /** The composite action string used to drive this chunk — a `+`-joined combination of movement (`w`/`s`/`a`/`d`) and look directions (`left`/`right`/`up`/`down`), or `still` when the character is idle with no camera rotation. */
+    active_action: string;
+    /** The prompt that was active while this chunk was generated. */
+    active_prompt: string;
+    /** Number of pixel frames emitted by this chunk. */
+    frames_emitted: number;
+}
+/** Emitted after `set_image` successfully decodes the uploaded file. */
+interface LingbotImageAcceptedMessage {
+    type: "image_accepted";
+    /** Width in pixels of the decoded reference image. */
+    width: number;
+    /** Height in pixels of the decoded reference image. */
+    height: number;
+}
+/** Emitted after `set_prompt` is accepted. */
+interface LingbotPromptAcceptedMessage {
+    type: "prompt_accepted";
+    /** The prompt text that was accepted. */
+    prompt: string;
+}
+/** Emitted after `set_prompt` or `set_image` so the client can tell at a glance whether `start` will succeed. */
+interface LingbotConditionsReadyMessage {
+    type: "conditions_ready";
+    /** True once a reference image has been set for the session. */
+    has_image: boolean;
+    /** True once a prompt has been set for the session. */
+    has_prompt: boolean;
+}
+/** Emitted after `reset` clears session state and returns to the waiting state. */
+interface LingbotGenerationResetMessage {
+    type: "generation_reset";
+    /** Short human-readable reason the reset was issued. */
+    reason: string;
+}
+/** Emitted in response to `pause`, once the current chunk finishes. */
+interface LingbotGenerationPausedMessage {
+    type: "generation_paused";
+    /** Index of the last completed chunk before pausing. */
+    chunk_index: number;
+}
+/** Emitted in response to `resume` when leaving the paused state. */
+interface LingbotGenerationResumedMessage {
+    type: "generation_resumed";
+    /** Index of the last completed chunk before resuming. */
+    chunk_index: number;
+}
+/** Emitted once when `start` succeeds and frames begin streaming. */
+interface LingbotGenerationStartedMessage {
+    type: "generation_started";
+    /** The prompt active at the start of generation. */
+    prompt: string;
+    /** Total number of chunks the run will produce before `generation_complete` fires. */
+    chunk_num: number;
+    /** Total number of pixel frames the run will emit on `main_video` before `generation_complete`. */
+    frame_num: number;
+}
+/** Emitted when all `chunk_num` chunks of a run have streamed. If the session is still `started`, a new run kicks off immediately with the same prompt and image; call `reset` to stop. */
+interface LingbotGenerationCompleteMessage {
+    type: "generation_complete";
+    /** Total number of chunks produced by the run. */
+    total_chunks: number;
+}
+type LingbotMessage = LingbotStateMessage | LingbotCommandErrorMessage | LingbotChunkCompleteMessage | LingbotImageAcceptedMessage | LingbotPromptAcceptedMessage | LingbotConditionsReadyMessage | LingbotGenerationResetMessage | LingbotGenerationPausedMessage | LingbotGenerationResumedMessage | LingbotGenerationStartedMessage | LingbotGenerationCompleteMessage;
+/**
+ * Options for creating a LingbotModel (model name is set automatically).
+ *
+ * Derived from `Reactor`'s own constructor options with `modelName`
+ * and `modelTracks` removed — those are supplied by this class.
+ * Any new option the SDK adds appears here automatically on the
+ * next `defaultSdkVersion` bump.
+ */
+type LingbotOptions = Omit<ConstructorParameters<typeof Reactor>[0], "modelName" | "modelTracks">;
+/**
+ * Strongly-typed client for the Lingbot model.
+ *
+ * Extends {@link Reactor} with the model name (and modelTracks) baked into the
+ * constructor, so every public method on Reactor — `connect`, `disconnect`,
+ * `sendCommand`, `on`/`off`, `getStats`, `publishTrack`/`unpublishTrack`,
+ * etc. — is reachable directly on the instance. The schema-derived sugar
+ * below adds typed wrappers for every declared event, message, and track.
+ */
+declare class LingbotModel extends Reactor {
+    constructor(options?: LingbotOptions);
+    /** @deprecated The model client now extends `Reactor` directly — call methods on `this` instead. This accessor returns `this` for backwards compatibility and will be removed in a future major release. */
+    get reactor(): this;
+    /** Pause generation after the current chunk finishes. Frames stop streaming on `main_video` until `resume` is called. Requires generation to be active. Emits `generation_paused` and `state` on success, or `command_error` if not generating or already paused. */
+    pause(): Promise<void>;
+    /** Abort the current run, clear the active prompt and reference image, and return to the waiting state. Valid at any time. After `reset`, call `set_prompt` and `set_image` again before `start` to begin a new session. Emits `generation_reset` and `state`. */
+    reset(): Promise<void>;
+    /** Begin generating video on `main_video`. Requires both a prompt (via `set_prompt`) and a reference image (via `set_image`). Emits `generation_started` and `state` on success, or `command_error` if a precondition is missing. Has no effect while already generating. */
+    start(): Promise<void>;
+    /** Resume generation from a previous `pause`. Requires the session to be paused. Emits `generation_resumed` and `state` on success, or `command_error` if not paused. */
+    resume(): Promise<void>;
+    /**
+     * Set seed
+     * @param params - Set seed
+     */
+    setSeed(params: LingbotSetSeedParams): Promise<void>;
+    /**
+     * Provide a reference image that anchors generation (image-to-video). Call before `start`; the image is required for generation to begin. Changes during generation have no effect until `reset` is issued and `start` is called again. Emits `image_accepted`, `conditions_ready`, and `state` on success, or `command_error` if the file is missing, not an image, or cannot be decoded.
+     * @param params - Provide a reference image that anchors generation (image-to-video). Call before `start`; the image is required for generation to begin. Changes during generation have no effect until `reset` is issued and `start` is called again. Emits `image_accepted`, `conditions_ready`, and `state` on success, or `command_error` if the file is missing, not an image, or cannot be decoded.
+     */
+    setImage(params: LingbotSetImageParams): Promise<void>;
+    /**
+     * Set the scene prompt. Valid at any time — call before `start` to arm generation, or hot-swap during generation to steer the next chunk. Emits `prompt_accepted`, `conditions_ready`, and `state` on success.
+     * @param params - Set the scene prompt. Valid at any time — call before `start` to arm generation, or hot-swap during generation to steer the next chunk. Emits `prompt_accepted`, `conditions_ready`, and `state` on success.
+     */
+    setPrompt(params: LingbotSetPromptParams): Promise<void>;
+    /**
+     * Set movement
+     * @param params - Set movement
+     */
+    setMovement(params: LingbotSetMovementParams): Promise<void>;
+    /**
+     * Set look_vertical
+     * @param params - Set look_vertical
+     */
+    setLookVertical(params: LingbotSetLookVerticalParams): Promise<void>;
+    /**
+     * Set look_horizontal
+     * @param params - Set look_horizontal
+     */
+    setLookHorizontal(params: LingbotSetLookHorizontalParams): Promise<void>;
+    /**
+     * Set rotation_speed_deg
+     * @param params - Set rotation_speed_deg
+     */
+    setRotationSpeedDeg(params: LingbotSetRotationSpeedDegParams): Promise<void>;
+    /**
+     * Subscribe to typed model messages.
+     * @param handler - Called with a discriminated LingbotMessage
+     * @returns Unsubscribe function
+     */
+    onMessage(handler: (message: LingbotMessage) => void): () => void;
+    /**
+     * Subscribe to "state" messages only.
+     * @returns Unsubscribe function
+     */
+    onState(handler: (message: LingbotStateMessage) => void): () => void;
+    /**
+     * Subscribe to "command_error" messages only.
+     * @returns Unsubscribe function
+     */
+    onCommandError(handler: (message: LingbotCommandErrorMessage) => void): () => void;
+    /**
+     * Subscribe to "chunk_complete" messages only.
+     * @returns Unsubscribe function
+     */
+    onChunkComplete(handler: (message: LingbotChunkCompleteMessage) => void): () => void;
+    /**
+     * Subscribe to "image_accepted" messages only.
+     * @returns Unsubscribe function
+     */
+    onImageAccepted(handler: (message: LingbotImageAcceptedMessage) => void): () => void;
+    /**
+     * Subscribe to "prompt_accepted" messages only.
+     * @returns Unsubscribe function
+     */
+    onPromptAccepted(handler: (message: LingbotPromptAcceptedMessage) => void): () => void;
+    /**
+     * Subscribe to "conditions_ready" messages only.
+     * @returns Unsubscribe function
+     */
+    onConditionsReady(handler: (message: LingbotConditionsReadyMessage) => void): () => void;
+    /**
+     * Subscribe to "generation_reset" messages only.
+     * @returns Unsubscribe function
+     */
+    onGenerationReset(handler: (message: LingbotGenerationResetMessage) => void): () => void;
+    /**
+     * Subscribe to "generation_paused" messages only.
+     * @returns Unsubscribe function
+     */
+    onGenerationPaused(handler: (message: LingbotGenerationPausedMessage) => void): () => void;
+    /**
+     * Subscribe to "generation_resumed" messages only.
+     * @returns Unsubscribe function
+     */
+    onGenerationResumed(handler: (message: LingbotGenerationResumedMessage) => void): () => void;
+    /**
+     * Subscribe to "generation_started" messages only.
+     * @returns Unsubscribe function
+     */
+    onGenerationStarted(handler: (message: LingbotGenerationStartedMessage) => void): () => void;
+    /**
+     * Subscribe to "generation_complete" messages only.
+     * @returns Unsubscribe function
+     */
+    onGenerationComplete(handler: (message: LingbotGenerationCompleteMessage) => void): () => void;
+    /**
+     * Subscribe to the "main_video" recvonly video track the model publishes.
+     *
+     * The handler fires once the model starts publishing this track; it receives the live MediaStreamTrack and the parent MediaStream (useful for attaching to a `<video>` / `<audio>` element via `srcObject`).
+     * @param handler - Called with the received track and its stream
+     * @returns Unsubscribe function
+     */
+    onMainVideo(handler: (track: MediaStreamTrack, stream: MediaStream) => void): () => void;
+}
+
+export { type LingbotChunkCompleteMessage, type LingbotCommandErrorMessage, type LingbotConditionsReadyMessage, type LingbotGenerationCompleteMessage, type LingbotGenerationPausedMessage, type LingbotGenerationResetMessage, type LingbotGenerationResumedMessage, type LingbotGenerationStartedMessage, type LingbotImageAcceptedMessage, type LingbotMessage, LingbotModel, type LingbotOptions, type LingbotPromptAcceptedMessage, type LingbotRecvTrackName, type LingbotSetImageParams, type LingbotSetLookHorizontalParams, type LingbotSetLookVerticalParams, type LingbotSetMovementParams, type LingbotSetPromptParams, type LingbotSetRotationSpeedDegParams, type LingbotSetSeedParams, type LingbotStateMessage, LingbotTracks, MODEL_NAME, MODEL_VERSION };

package/dist/core.d.ts

@@ -0,0 +1,326 @@
+import { Reactor, FileRef } from '@reactor-team/js-sdk';
+export { FileRef } from '@reactor-team/js-sdk';
+
+declare const MODEL_NAME: "lingbot";
+declare const MODEL_VERSION: "v0.2.21";
+/**
+ * Preset media tracks for the Lingbot model.
+ *
+ * Declared in the model's OpenAPI schema and passed to the SDK as
+ * `modelTracks` so the transport can prepare the SDP offer in
+ * parallel with session polling (faster first-frame latency).
+ */
+declare const LingbotTracks: readonly [{
+    readonly name: "main_video";
+    readonly kind: "video";
+    readonly direction: "recvonly";
+}];
+/** Track names the client can subscribe to (recvonly, from the client's perspective). */
+type LingbotRecvTrackName = "main_video";
+/** Set seed */
+interface LingbotSetSeedParams {
+    /**
+     * Seed for the random generator used to sample the initial noise. Must be a non-negative integer; the model never draws its own random seed — pick one explicitly (or keep the default) for reproducible runs. Read once when `start` fires; later changes take effect only after `reset` followed by a new `start`.
+     * @minimum 0
+     * @default 42
+     */
+    seed?: number;
+}
+/** Provide a reference image that anchors generation (image-to-video). Call before `start`; the image is required for generation to begin. Changes during generation have no effect until `reset` is issued and `start` is called again. Emits `image_accepted`, `conditions_ready`, and `state` on success, or `command_error` if the file is missing, not an image, or cannot be decoded. */
+interface LingbotSetImageParams {
+    /**
+     * Reference to a file uploaded via the Reactor presigned-URL protocol.
+     * @default null
+     */
+    image?: FileRef;
+}
+/** Set the scene prompt. Valid at any time — call before `start` to arm generation, or hot-swap during generation to steer the next chunk. Emits `prompt_accepted`, `conditions_ready`, and `state` on success. */
+interface LingbotSetPromptParams {
+    /**
+     * Natural-language description of the scene to generate. Replaces the previously active prompt. Applied on the next chunk when generating; otherwise takes effect when `start` fires.
+     * @default ""
+     */
+    prompt?: string;
+}
+/** Set movement */
+interface LingbotSetMovementParams {
+    /**
+     * Character movement in the generated scene. `idle` holds the character stationary; `forward` / `back` translate along the look axis; `strafe_left` / `strafe_right` translate sideways. Can be changed at any time; the new value applies to the next chunk.
+     * @default "idle"
+     */
+    movement?: "idle" | "forward" | "back" | "strafe_left" | "strafe_right";
+}
+/** Set look_vertical */
+interface LingbotSetLookVerticalParams {
+    /**
+     * Vertical (pitch) camera rotation. `idle` holds pitch steady; `up` / `down` rotate the camera at the rate given by `rotation_speed_deg`. Can be changed at any time; the new value applies to the next chunk.
+     * @default "idle"
+     */
+    look_vertical?: "idle" | "up" | "down";
+}
+/** Set look_horizontal */
+interface LingbotSetLookHorizontalParams {
+    /**
+     * Horizontal (yaw) camera rotation. `idle` holds yaw steady; `left` / `right` rotate the camera at the rate given by `rotation_speed_deg`. Can be changed at any time; the new value applies to the next chunk.
+     * @default "idle"
+     */
+    look_horizontal?: "idle" | "left" | "right";
+}
+/** Set rotation_speed_deg */
+interface LingbotSetRotationSpeedDegParams {
+    /**
+     * Camera rotation speed in degrees per latent frame, applied when `look_horizontal` or `look_vertical` is not `idle`. Range 0.0 – 30.0. Ignored when both look axes are `idle`. Can be changed at any time; the new value applies to the next chunk.
+     * @minimum 0
+     * @maximum 30
+     * @default 5
+     */
+    rotation_speed_deg?: number;
+}
+/**
+ * Snapshot of the session's observable state.
+ *
+ * Emitted on connect, after every command that mutates session state (`set_prompt`, `set_image`, `start`, `pause`, `resume`, `reset`, and the auto-generated `set_<field>` setters), and after each `chunk_complete`. Clients can treat this as the single source of truth for driving UI, without having to track every individual command and message themselves.
+ */
+interface LingbotStateMessage {
+    type: "state";
+    /** Current value of the `seed` input field. The seed that was actually used by the running generation was captured when `start` fired — later changes to `seed` only take effect after `reset` and a new `start`. */
+    seed: number;
+    /** True while generation is paused via `pause`. */
+    paused: boolean;
+    /** True while the chunk loop is actively producing frames — equivalent to `started and not paused`. `False` both before `start` and while paused; read `started` to disambiguate. */
+    running: boolean;
+    /** True once `start` has been accepted. Remains true while paused; reset to false by `reset` or after `generation_complete` when the session is not auto-restarting. */
+    started: boolean;
+    /** Current value of the `movement` input field. */
+    movement: string;
+    /** True once a reference image has been set for the session. */
+    has_image: boolean;
+    /** True once a prompt has been set for the session. */
+    has_prompt: boolean;
+    /** Zero-based index of the last completed chunk. `0` before the first chunk has completed, and resets to `0` on `reset`. */
+    current_chunk: number;
+    /** Current value of the `look_vertical` input field. */
+    look_vertical: string;
+    /** Composite action string derived from `movement`, `look_horizontal`, and `look_vertical` — a `+`-joined combination of `w`/`s`/`a`/`d` and `left`/`right`/`up`/`down`, or `still` when idle. */
+    current_action: string;
+    /** The prompt currently driving generation, or `null` if no prompt has been set for the session. */
+    current_prompt: unknown;
+    /** Current value of the `look_horizontal` input field. */
+    look_horizontal: string;
+    /** Current value of the `rotation_speed_deg` input field (0.0 – 30.0). */
+    rotation_speed_deg: number;
+}
+/** Emitted when a command is rejected because preconditions are not met or its arguments could not be processed. */
+interface LingbotCommandErrorMessage {
+    type: "command_error";
+    /** Human-readable explanation of why the command was rejected. */
+    reason: string;
+    /** Name of the command that was rejected. */
+    command: string;
+}
+/** Emitted once per completed chunk of `main_video`. */
+interface LingbotChunkCompleteMessage {
+    type: "chunk_complete";
+    /** Zero-based index of the chunk that just completed. */
+    chunk_index: number;
+    /** The composite action string used to drive this chunk — a `+`-joined combination of movement (`w`/`s`/`a`/`d`) and look directions (`left`/`right`/`up`/`down`), or `still` when the character is idle with no camera rotation. */
+    active_action: string;
+    /** The prompt that was active while this chunk was generated. */
+    active_prompt: string;
+    /** Number of pixel frames emitted by this chunk. */
+    frames_emitted: number;
+}
+/** Emitted after `set_image` successfully decodes the uploaded file. */
+interface LingbotImageAcceptedMessage {
+    type: "image_accepted";
+    /** Width in pixels of the decoded reference image. */
+    width: number;
+    /** Height in pixels of the decoded reference image. */
+    height: number;
+}
+/** Emitted after `set_prompt` is accepted. */
+interface LingbotPromptAcceptedMessage {
+    type: "prompt_accepted";
+    /** The prompt text that was accepted. */
+    prompt: string;
+}
+/** Emitted after `set_prompt` or `set_image` so the client can tell at a glance whether `start` will succeed. */
+interface LingbotConditionsReadyMessage {
+    type: "conditions_ready";
+    /** True once a reference image has been set for the session. */
+    has_image: boolean;
+    /** True once a prompt has been set for the session. */
+    has_prompt: boolean;
+}
+/** Emitted after `reset` clears session state and returns to the waiting state. */
+interface LingbotGenerationResetMessage {
+    type: "generation_reset";
+    /** Short human-readable reason the reset was issued. */
+    reason: string;
+}
+/** Emitted in response to `pause`, once the current chunk finishes. */
+interface LingbotGenerationPausedMessage {
+    type: "generation_paused";
+    /** Index of the last completed chunk before pausing. */
+    chunk_index: number;
+}
+/** Emitted in response to `resume` when leaving the paused state. */
+interface LingbotGenerationResumedMessage {
+    type: "generation_resumed";
+    /** Index of the last completed chunk before resuming. */
+    chunk_index: number;
+}
+/** Emitted once when `start` succeeds and frames begin streaming. */
+interface LingbotGenerationStartedMessage {
+    type: "generation_started";
+    /** The prompt active at the start of generation. */
+    prompt: string;
+    /** Total number of chunks the run will produce before `generation_complete` fires. */
+    chunk_num: number;
+    /** Total number of pixel frames the run will emit on `main_video` before `generation_complete`. */
+    frame_num: number;
+}
+/** Emitted when all `chunk_num` chunks of a run have streamed. If the session is still `started`, a new run kicks off immediately with the same prompt and image; call `reset` to stop. */
+interface LingbotGenerationCompleteMessage {
+    type: "generation_complete";
+    /** Total number of chunks produced by the run. */
+    total_chunks: number;
+}
+type LingbotMessage = LingbotStateMessage | LingbotCommandErrorMessage | LingbotChunkCompleteMessage | LingbotImageAcceptedMessage | LingbotPromptAcceptedMessage | LingbotConditionsReadyMessage | LingbotGenerationResetMessage | LingbotGenerationPausedMessage | LingbotGenerationResumedMessage | LingbotGenerationStartedMessage | LingbotGenerationCompleteMessage;
+/**
+ * Options for creating a LingbotModel (model name is set automatically).
+ *
+ * Derived from `Reactor`'s own constructor options with `modelName`
+ * and `modelTracks` removed — those are supplied by this class.
+ * Any new option the SDK adds appears here automatically on the
+ * next `defaultSdkVersion` bump.
+ */
+type LingbotOptions = Omit<ConstructorParameters<typeof Reactor>[0], "modelName" | "modelTracks">;
+/**
+ * Strongly-typed client for the Lingbot model.
+ *
+ * Extends {@link Reactor} with the model name (and modelTracks) baked into the
+ * constructor, so every public method on Reactor — `connect`, `disconnect`,
+ * `sendCommand`, `on`/`off`, `getStats`, `publishTrack`/`unpublishTrack`,
+ * etc. — is reachable directly on the instance. The schema-derived sugar
+ * below adds typed wrappers for every declared event, message, and track.
+ */
+declare class LingbotModel extends Reactor {
+    constructor(options?: LingbotOptions);
+    /** @deprecated The model client now extends `Reactor` directly — call methods on `this` instead. This accessor returns `this` for backwards compatibility and will be removed in a future major release. */
+    get reactor(): this;
+    /** Pause generation after the current chunk finishes. Frames stop streaming on `main_video` until `resume` is called. Requires generation to be active. Emits `generation_paused` and `state` on success, or `command_error` if not generating or already paused. */
+    pause(): Promise<void>;
+    /** Abort the current run, clear the active prompt and reference image, and return to the waiting state. Valid at any time. After `reset`, call `set_prompt` and `set_image` again before `start` to begin a new session. Emits `generation_reset` and `state`. */
+    reset(): Promise<void>;
+    /** Begin generating video on `main_video`. Requires both a prompt (via `set_prompt`) and a reference image (via `set_image`). Emits `generation_started` and `state` on success, or `command_error` if a precondition is missing. Has no effect while already generating. */
+    start(): Promise<void>;
+    /** Resume generation from a previous `pause`. Requires the session to be paused. Emits `generation_resumed` and `state` on success, or `command_error` if not paused. */
+    resume(): Promise<void>;
+    /**
+     * Set seed
+     * @param params - Set seed
+     */
+    setSeed(params: LingbotSetSeedParams): Promise<void>;
+    /**
+     * Provide a reference image that anchors generation (image-to-video). Call before `start`; the image is required for generation to begin. Changes during generation have no effect until `reset` is issued and `start` is called again. Emits `image_accepted`, `conditions_ready`, and `state` on success, or `command_error` if the file is missing, not an image, or cannot be decoded.
+     * @param params - Provide a reference image that anchors generation (image-to-video). Call before `start`; the image is required for generation to begin. Changes during generation have no effect until `reset` is issued and `start` is called again. Emits `image_accepted`, `conditions_ready`, and `state` on success, or `command_error` if the file is missing, not an image, or cannot be decoded.
+     */
+    setImage(params: LingbotSetImageParams): Promise<void>;
+    /**
+     * Set the scene prompt. Valid at any time — call before `start` to arm generation, or hot-swap during generation to steer the next chunk. Emits `prompt_accepted`, `conditions_ready`, and `state` on success.
+     * @param params - Set the scene prompt. Valid at any time — call before `start` to arm generation, or hot-swap during generation to steer the next chunk. Emits `prompt_accepted`, `conditions_ready`, and `state` on success.
+     */
+    setPrompt(params: LingbotSetPromptParams): Promise<void>;
+    /**
+     * Set movement
+     * @param params - Set movement
+     */
+    setMovement(params: LingbotSetMovementParams): Promise<void>;
+    /**
+     * Set look_vertical
+     * @param params - Set look_vertical
+     */
+    setLookVertical(params: LingbotSetLookVerticalParams): Promise<void>;
+    /**
+     * Set look_horizontal
+     * @param params - Set look_horizontal
+     */
+    setLookHorizontal(params: LingbotSetLookHorizontalParams): Promise<void>;
+    /**
+     * Set rotation_speed_deg
+     * @param params - Set rotation_speed_deg
+     */
+    setRotationSpeedDeg(params: LingbotSetRotationSpeedDegParams): Promise<void>;
+    /**
+     * Subscribe to typed model messages.
+     * @param handler - Called with a discriminated LingbotMessage
+     * @returns Unsubscribe function
+     */
+    onMessage(handler: (message: LingbotMessage) => void): () => void;
+    /**
+     * Subscribe to "state" messages only.
+     * @returns Unsubscribe function
+     */
+    onState(handler: (message: LingbotStateMessage) => void): () => void;
+    /**
+     * Subscribe to "command_error" messages only.
+     * @returns Unsubscribe function
+     */
+    onCommandError(handler: (message: LingbotCommandErrorMessage) => void): () => void;
+    /**
+     * Subscribe to "chunk_complete" messages only.
+     * @returns Unsubscribe function
+     */
+    onChunkComplete(handler: (message: LingbotChunkCompleteMessage) => void): () => void;
+    /**
+     * Subscribe to "image_accepted" messages only.
+     * @returns Unsubscribe function
+     */
+    onImageAccepted(handler: (message: LingbotImageAcceptedMessage) => void): () => void;
+    /**
+     * Subscribe to "prompt_accepted" messages only.
+     * @returns Unsubscribe function
+     */
+    onPromptAccepted(handler: (message: LingbotPromptAcceptedMessage) => void): () => void;
+    /**
+     * Subscribe to "conditions_ready" messages only.
+     * @returns Unsubscribe function
+     */
+    onConditionsReady(handler: (message: LingbotConditionsReadyMessage) => void): () => void;
+    /**
+     * Subscribe to "generation_reset" messages only.
+     * @returns Unsubscribe function
+     */
+    onGenerationReset(handler: (message: LingbotGenerationResetMessage) => void): () => void;
+    /**
+     * Subscribe to "generation_paused" messages only.
+     * @returns Unsubscribe function
+     */
+    onGenerationPaused(handler: (message: LingbotGenerationPausedMessage) => void): () => void;
+    /**
+     * Subscribe to "generation_resumed" messages only.
+     * @returns Unsubscribe function
+     */
+    onGenerationResumed(handler: (message: LingbotGenerationResumedMessage) => void): () => void;
+    /**
+     * Subscribe to "generation_started" messages only.
+     * @returns Unsubscribe function
+     */
+    onGenerationStarted(handler: (message: LingbotGenerationStartedMessage) => void): () => void;
+    /**
+     * Subscribe to "generation_complete" messages only.
+     * @returns Unsubscribe function
+     */
+    onGenerationComplete(handler: (message: LingbotGenerationCompleteMessage) => void): () => void;
+    /**
+     * Subscribe to the "main_video" recvonly video track the model publishes.
+     *
+     * The handler fires once the model starts publishing this track; it receives the live MediaStreamTrack and the parent MediaStream (useful for attaching to a `<video>` / `<audio>` element via `srcObject`).
+     * @param handler - Called with the received track and its stream
+     * @returns Unsubscribe function
+     */
+    onMainVideo(handler: (track: MediaStreamTrack, stream: MediaStream) => void): () => void;
+}
+
+export { type LingbotChunkCompleteMessage, type LingbotCommandErrorMessage, type LingbotConditionsReadyMessage, type LingbotGenerationCompleteMessage, type LingbotGenerationPausedMessage, type LingbotGenerationResetMessage, type LingbotGenerationResumedMessage, type LingbotGenerationStartedMessage, type LingbotImageAcceptedMessage, type LingbotMessage, LingbotModel, type LingbotOptions, type LingbotPromptAcceptedMessage, type LingbotRecvTrackName, type LingbotSetImageParams, type LingbotSetLookHorizontalParams, type LingbotSetLookVerticalParams, type LingbotSetMovementParams, type LingbotSetPromptParams, type LingbotSetRotationSpeedDegParams, type LingbotSetSeedParams, type LingbotStateMessage, LingbotTracks, MODEL_NAME, MODEL_VERSION };