@higgsfield/video-editor-mcp 1.1.1-dev.0 → 2.0.0

package/node_modules/@higgsfield/higgsedit/dist/api.d.ts

@@ -0,0 +1,481 @@
+/**
+ * The HTTP API of `higgsedit dev`, as a client sees it. Published as `@higgsfield/higgsedit/api` (types only), so
+ * a program driving a project through its dev server (the Video Editor MCP server) shares these shapes with the
+ * handlers instead of restating them. Nothing here imports the engine: the file stands on its own once packed.
+ *
+ * Every route lives under the project the server was started for; relative media paths resolve inside it.
+ * An error answers with a non-2xx status and `{ error }`.
+ *
+ *   GET  /api/outline                      Outline
+ *   POST /api/edit        EditRequest   →  EditReply
+ *   POST /api/undo | /api/redo           →  UndoReply
+ *   POST /api/render      RenderRequest →  RenderStarted; GET /api/render?id=<id> → RenderJob
+ *   POST /api/sheet       SheetRequest  →  image/png
+ *   POST /api/media/probe      MediaRequest                     → MediaProbe
+ *   POST /api/media/grab       MediaRequest & GrabOptions       → GrabResult
+ *   POST /api/media/filmstrip  MediaRequest & PreviewOptions    → FilmstripResult
+ *   POST /api/media/waveform   MediaRequest & WaveformOptions   → WaveformResult
+ *   POST /api/media/transcribe MediaRequest & TranscribeOptions → JobStarted (a Job<TranscribeResult>)
+ *   POST /api/media/segment    MediaRequest & SegmentRequest    → JobStarted (a Job<SegmentResult>)
+ *   GET  /api/jobs/<id>                    Job<…>
+ *   GET  /api/fonts?family=&category=&cached=&limit=&offset=   FontList
+ *   GET  /api/doctor                       Diagnosis
+ */
+/** Seconds, frames ("45f") or "MM:SS"; where a route says so, a negative counts back from the end. */
+export type TimeArg = number | string;
+export interface ApiError {
+    error: string;
+}
+export interface Composition {
+    width: number;
+    height: number;
+    fps: number;
+    duration: number;
+    frames: number;
+}
+export type InspectType = "number" | "color" | "text" | "font" | "boolean" | "select";
+export type InspectValue = string | number | boolean;
+/** An `@inspect` const: edited by name with `set-const`, not by element id. */
+export interface InspectVariable {
+    type?: InspectType;
+    min?: number;
+    max?: number;
+    step?: number;
+    /** Choices for `select`, listed as written. */
+    options?: string[];
+    /** `path="A/B/Label"` split into segments. */
+    path?: string[];
+    file: string;
+    line: number;
+    name: string;
+    label: string;
+    group: string[];
+    /** The initializer's literal, when it is one the control can show. */
+    value?: InspectValue;
+    /** Whether `set-const` can write it; `reason` says why not. */
+    editable: boolean;
+    reason?: string;
+}
+export interface OutlineElement {
+    key: string;
+    tag: string;
+    parent: string | null;
+    depth: number;
+    /** On the parent's clock, as `start`/`end` are written. An open end resolves to the parent's end (null if that is open too). */
+    start: number;
+    end: number | null;
+    /** True when the source gives no end and nothing (media, children) implies one. */
+    openEnd?: boolean;
+    /** On the scene's root clock. */
+    absStart: number;
+    absEnd: number | null;
+    props: Record<string, unknown>;
+    text?: string;
+    /** Props the source computes, by their source text; edits refuse these. */
+    code?: Record<string, string>;
+    component?: string;
+    file?: string;
+    line?: number;
+    /** `syncTo`: the measured offset (seconds after the target's recording) and the sourceIn it plays from, or why it keeps its default placement. */
+    sync?: {
+        to: string;
+        offset?: number;
+        sourceIn?: number;
+        error?: string;
+    };
+}
+/** What `check` learned about a media file the project references. */
+export interface MediaSummary {
+    codec: string;
+    duration: number;
+    hasAudio: boolean;
+    pixFmt?: string;
+    width?: number;
+    height?: number;
+    fps?: number;
+}
+export interface Outline {
+    ok: boolean;
+    name: string;
+    errors: string[];
+    warnings: string[];
+    composition?: Composition;
+    media: {
+        src: string;
+        probe?: MediaSummary;
+    }[];
+    elements: OutlineElement[];
+    variables: InspectVariable[];
+    /** The same, as a compact tree a model can read. */
+    text: string;
+}
+/** What a source can spell as a literal. */
+export type PropValue = number | string | boolean | null | PropValue[] | {
+    [key: string]: PropValue;
+};
+export type Edit = 
+/** `name` may be a path into a literal (`animate.opacity.1.1`). */
+{
+    op: "set-prop";
+    name: string;
+    value: PropValue;
+} | {
+    op: "set-text";
+    text: string;
+}
+/** Inserts a new element under the target. */
+ | {
+    op: "insert";
+    tag: string;
+    props?: Record<string, PropValue>;
+    text?: string;
+    before?: string;
+    /** For a component: where `tag` is imported from, written as in an import declaration (relative to the file the element lands in). */
+    import?: {
+        from: string;
+    };
+} | {
+    op: "remove";
+} | {
+    op: "move";
+    parent: string;
+    before?: string;
+} | {
+    op: "retime";
+    start?: number | string;
+    end?: number | string;
+}
+/** Rewrites an `@inspect` const's literal; addressed by name (and file when the name is not unique), not by element key. */
+ | {
+    op: "set-const";
+    name: string;
+    file?: string;
+    value: InspectValue;
+};
+export type RefusalCode = "not-found" | "ambiguous-id" | "expression" | "loop-bound" | "loop-body" | "spread" | "shared-component" | "invalid" | "syntax";
+export interface Refusal {
+    code: RefusalCode;
+    reason: string;
+    /** Where the refusal was decided, `file:line`. */
+    at?: string;
+    /** The attribute or child text that blocked it. */
+    source?: string;
+}
+export interface EditResult {
+    ok: boolean;
+    written: string[];
+    refused?: Refusal;
+    /** The JSX the edit landed on (the call site when it followed a prop there). */
+    target?: {
+        file: string;
+        line: number;
+        id: string | undefined;
+    };
+    /** Id of an inserted element. */
+    id?: string;
+}
+/** `key` is the element id (empty for `set-const`); all or nothing, one undo step. */
+export interface EditRequest {
+    name?: string;
+    edits: {
+        key: string;
+        edit: Edit;
+    }[];
+    dryRun?: boolean;
+}
+export interface UndoState {
+    canUndo: boolean;
+    canRedo: boolean;
+    undoName: string | null;
+    redoName: string | null;
+}
+export interface EditReply {
+    ok: boolean;
+    results: EditResult[];
+    undo: UndoState;
+}
+export type HistoryResult = {
+    ok: true;
+    written: string[];
+} | {
+    ok: false;
+    reason: string;
+};
+export type UndoReply = HistoryResult & {
+    undo: UndoState;
+};
+/** The editor's export settings (`spec`) are the panel's own; a program leaves them out and gets the defaults. */
+export interface RenderRequest {
+    /** Under `renders/`; default `render.mp4`, never overwriting (a suffix is added). */
+    fileName?: string;
+    from?: string;
+    to?: string;
+    depth?: 8 | 10;
+    sceneId?: string;
+    allowFontFallback?: boolean;
+}
+export interface RenderStarted {
+    id: string;
+}
+export interface RenderJob {
+    state: "running" | "done" | "failed" | "cancelled";
+    done: number;
+    total: number;
+    /** Project-relative, once done. */
+    out?: string;
+    error?: string;
+    msPerFrame?: number;
+}
+/** Frames of the project at `times`, side by side on one PNG. */
+export interface SheetRequest {
+    times: TimeArg[];
+    /** Default min(4, times). */
+    columns?: number;
+    /** Thumbnail width in px, default 480. */
+    width?: number;
+    allowFontFallback?: boolean;
+}
+/** A file: absolute, `~/…`, or relative to the project (`media/clip.mp4`). */
+export interface MediaRequest {
+    path: string;
+}
+export interface MediaTrack {
+    id: number;
+    type: string;
+    codec: string | null;
+    codecLongName?: string;
+    profile?: string;
+    language: string;
+    firstTimestamp: number;
+    duration: number;
+    bitRate?: number;
+    frames?: number;
+    width?: number;
+    height?: number;
+    fps?: number;
+    pixFmt?: string;
+    colorSpace?: string;
+    colorRange?: string;
+    colorTransfer?: string;
+    colorPrimaries?: string;
+    rotation?: number;
+    sampleRate?: number;
+    channels?: number;
+    channelLayout?: string;
+}
+export interface MediaProbe {
+    path: string;
+    name: string;
+    /** video, audio, image, or other (not readable as media). */
+    type: "video" | "audio" | "image" | "other";
+    size: number;
+    /** ffmpeg's container name; null when the file could not be read as media. */
+    format: string | null;
+    formatLongName?: string;
+    /** Seconds. */
+    duration?: number;
+    bitRate?: number;
+    width?: number;
+    height?: number;
+    tags?: Record<string, string>;
+    tracks: MediaTrack[];
+}
+export type Quality = "small" | "medium" | "large" | "fullres";
+export interface GrabOptions {
+    /** Source times; negatives count back from the end. Default [0]. */
+    times?: TimeArg[];
+    /** Instead of times: this many frames evenly spaced across the clip or the start/end window. */
+    count?: number;
+    start?: TimeArg;
+    end?: TimeArg;
+    quality?: Quality;
+    /** One PNG per frame instead of contact sheets. */
+    separate?: boolean;
+    /** Frames per contact sheet, 1–12. */
+    perSheet?: number;
+    /** Lift the 100-frame cap. */
+    uncapped?: boolean;
+    /** Directory for the PNGs; default a fresh one under the system temp dir. */
+    output?: string;
+}
+export interface GrabbedImage {
+    /** The frame's stamp, or `first-last` for a sheet. */
+    timecode: string;
+    path: string;
+}
+export interface GrabResult {
+    images: GrabbedImage[];
+}
+export interface PreviewOptions {
+    start?: TimeArg;
+    end?: TimeArg;
+    /** PNG path, or a directory to put a fresh file in; default a fresh file under the system temp dir. */
+    output?: string;
+    /** Thumbnail scale, clamped to 0.25–4: smaller fits more rows and columns. Default 1. */
+    scale?: number;
+}
+export interface FilmstripResult {
+    path: string;
+    width: number;
+    height: number;
+    columns: number;
+    rows: number;
+    cell: {
+        width: number;
+        height: number;
+    };
+    /** Height of the ruler band above each row. */
+    ruler: number;
+    /** Source seconds of each cell, row by row. */
+    times: number[];
+}
+export interface WaveformOptions extends PreviewOptions {
+    /** Peak level, in dBFS, at or below which audio counts as silent. Default -40. */
+    silenceDb?: number;
+    /** Shortest silence reported, in seconds. Default 0.4. */
+    minSilence?: number;
+}
+export interface Silence {
+    start: number;
+    end: number;
+}
+export interface WaveformResult {
+    path: string;
+    /** Silent spans in absolute source seconds. */
+    silences: Silence[];
+    width: number;
+    height: number;
+    rows: number;
+}
+export interface TranscribeOptions {
+    /** JSON path to write, or a folder for a fresh file; default a fresh file under the system temp dir. */
+    output?: string;
+    model?: string;
+    language?: string;
+}
+export interface TranscribeResult {
+    path: string;
+    segments: number;
+    words: number;
+    language?: string;
+}
+export interface Point {
+    x: number;
+    y: number;
+}
+export type SegmentModel = "tiny" | "small" | "base-plus" | "large";
+/** Prompts in 0..1 of the frame (x right, y down); times in source time. */
+export interface SegmentRequest {
+    points?: Point[];
+    exclude?: Point[];
+    box?: [number, number, number, number];
+    /** The frame the prompts are on; default `start`. */
+    at?: TimeArg;
+    /** Span to track; default the whole file. */
+    start?: TimeArg;
+    end?: TimeArg;
+    /** Default tiny. */
+    model?: SegmentModel;
+    /** Where the `.mask` goes; default `masks/<file name>.mask` in the project. */
+    output?: string;
+}
+export interface SegmentResult {
+    path: string;
+    model: SegmentModel;
+    backend: "webgpu" | "wasm";
+    frameRate: number;
+    /** Source seconds of the first masked frame, and just past the last. */
+    start: number;
+    end: number;
+    frames: number;
+    /** On the prompted frame: the object's bounds in 0..1 (null if nothing was found) and its share of the frame. */
+    bbox: [number, number, number, number] | null;
+    area: number;
+    score: number;
+    iou: number;
+    /** [start, end) source seconds where no object was found. */
+    lost: [number, number][];
+    /** [start, end) source seconds where the model rated its mask below 0.5. */
+    weak: [number, number][];
+    msPerFrame: number;
+}
+export interface JobStarted {
+    id: string;
+}
+export type Job<T> = {
+    status: "running";
+} | {
+    status: "done";
+    result: T;
+} | {
+    status: "failed";
+    error: string;
+};
+export type FontCategory = "sans-serif" | "serif" | "display" | "handwriting" | "monospace";
+export interface FontQuery {
+    /** Substring of the family name, any case. */
+    family?: string;
+    category?: FontCategory;
+    /** Only families with a variant in the local cache. */
+    cached?: boolean;
+    limit?: number;
+    /** Families to skip, for paging. */
+    offset?: number;
+}
+export interface GoogleFamily {
+    family: string;
+    /** sans-serif, serif, display, handwriting or monospace. */
+    category: string;
+    /** Google's popularity rank (1 = most used). */
+    popularity: number;
+    /** Weights with a normal-style file, lightest first. */
+    weights: number[];
+    /** Weights with an italic file, lightest first. */
+    italics: number[];
+}
+export interface ListedFamily extends GoogleFamily {
+    /** Variants in HIGGSEDIT_HOME/fonts ("400", "700i"): these render offline. */
+    cached: string[];
+    /** css2 stylesheet with every variant, for an <html> element. */
+    stylesheet: string;
+}
+export interface FontList {
+    families: ListedFamily[];
+    /** How many families pass the filters (can exceed `families.length` when `limit` cuts it). */
+    total: number;
+    catalogue: {
+        fetchedAt: string;
+        stale: boolean;
+    };
+}
+export type SelectStatus = {
+    url: null;
+} | {
+    url: string;
+    answers: boolean;
+    detail: string;
+};
+export interface Diagnosis {
+    node: string;
+    platform: string;
+    ffmpeg: {
+        path: string;
+    } | {
+        missing: string;
+    };
+    ffprobe: {
+        path: string;
+    } | {
+        missing: string;
+    };
+    chrome: {
+        version: string;
+        path?: string;
+        note?: string;
+    };
+    /** HIGGSEDIT_SELECT_URL and whether its server answers `GET v1`. */
+    select: SelectStatus;
+    log: string;
+    /** Error entries from the end of the log, newest last. */
+    errors: string[];
+}

package/node_modules/@higgsfield/higgsedit/dist/{chunk-PFQYUJQL.mjs → chunk-3XVMJSV2.mjs}

@@ -6,7 +6,7 @@ const __filename = __higgseditPath(import.meta.url);
 const __dirname = __filename.slice(0, __filename.lastIndexOf("/"));
 import {
   CLI_MANIFEST
-} from "./chunk-2WKNH7OL.mjs";
+} from "./chunk-O3AVYZ6U.mjs";
 import "./chunk-75WO2NOF.mjs";
 
 // src/init.ts

package/node_modules/@higgsfield/higgsedit/dist/{chunk-F4CMIG5G.mjs → chunk-4VE54E4U.mjs}

@@ -11,9 +11,10 @@ import {
   rateFilter,
   render,
   sheet,
+  sheetPng,
   shuffle,
   verify
-} from "./chunk-NARTAWRN.mjs";
+} from "./chunk-HYCUOCUQ.mjs";
 import "./chunk-7PYXSJS7.mjs";
 import "./chunk-UDL5AHKO.mjs";
 import "./chunk-LTKMGZ6T.mjs";
@@ -31,6 +32,7 @@ export {
   rateFilter,
   render,
   sheet,
+  sheetPng,
   shuffle,
   verify
 };