@prestyj/editor 0.7.1

package/dist/core/audio-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-cleanup.d.ts","sourceRoot":"","sources":["../../src/core/audio-cleanup.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvF,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;IAClB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,cAAmB,GAAG,MAAM,CAmCvF;AAED,gFAAgF;AAChF,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/core/audio-cleanup.js

@@ -0,0 +1,79 @@
+/**
+ * Audio cleanup helpers — voice-noise reduction, de-essing, hum removal.
+ *
+ * All routes through ffmpeg filters. We expose a small set of "modes" so the
+ * agent doesn't have to learn ffmpeg syntax:
+ *   - denoise / denoise-strong: spectral noise gate (afftdn)
+ *   - rnnoise: RNN-based noise removal (arnndn). Needs a model file; if none
+ *     supplied we fall back to afftdn with a stronger setting.
+ *   - dehum: notch out 50/60Hz mains hum
+ *   - deess: tame harsh sibilance
+ */
+import { runFfmpeg } from "./media/ffmpeg.js";
+/**
+ * Build the ffmpeg `-af` filter string for a cleanup mode. Pure function so
+ * tests can verify the chain without spawning ffmpeg.
+ */
+export function buildCleanupFilter(mode, opts = {}) {
+    switch (mode) {
+        case "denoise":
+            // Mild spectral gate. Good default for podcast room tone.
+            return "afftdn=nr=12:nf=-25";
+        case "denoise-strong":
+            // Aggressive — will start to chew transients on bad source. Only use when
+            // the noise floor is genuinely loud.
+            return "afftdn=nr=24:nf=-20";
+        case "rnnoise":
+            if (!opts.rnnoiseModel) {
+                // Fallback: stronger afftdn so the tool still produces output even
+                // without a model file.
+                return "afftdn=nr=20:nf=-22";
+            }
+            return `arnndn=m=${escapeFfPath(opts.rnnoiseModel)}`;
+        case "dehum": {
+            const f = opts.mainsHz === 60 ? 60 : 50;
+            // Notch the fundamental + first three harmonics. Anchored Q for surgical
+            // cuts that don't muddy the rest of the band.
+            return [
+                `anequalizer=f=${f}:width_type=h:width=10:g=-30`,
+                `anequalizer=f=${f * 2}:width_type=h:width=10:g=-25`,
+                `anequalizer=f=${f * 3}:width_type=h:width=10:g=-20`,
+                `anequalizer=f=${f * 4}:width_type=h:width=10:g=-15`,
+            ].join(",");
+        }
+        case "deess":
+            // Sibilance lives 5-9kHz. Light shelf cut + dynamic compression on that band.
+            return "deesser=i=0.6:m=0.5:f=0.5:s=o";
+        default: {
+            const _exhaustive = mode;
+            throw new Error(`unknown cleanup mode: ${String(_exhaustive)}`);
+        }
+    }
+}
+/** Run a single cleanup pass on an audio/video file. Video stream is copied. */
+export async function applyCleanup(inputPath, outputPath, mode, opts = {}) {
+    const filter = buildCleanupFilter(mode, opts);
+    const isWav = /\.wav$/i.test(outputPath);
+    const args = [
+        "-i",
+        inputPath,
+        "-af",
+        filter,
+        "-c:v",
+        "copy",
+        ...(isWav ? ["-c:a", "pcm_s16le"] : ["-c:a", "aac", "-b:a", "192k"]),
+        outputPath,
+    ];
+    const r = await runFfmpeg(args, { signal: opts.signal });
+    if (r.code !== 0) {
+        throw new Error(`ffmpeg ${mode} exited ${r.code}: ${tail(r.stderr)}`);
+    }
+}
+function escapeFfPath(p) {
+    // ffmpeg filter args use ':' and '\' as separators; escape them.
+    return p.replace(/\\/g, "\\\\").replace(/:/g, "\\:");
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+//# sourceMappingURL=audio-cleanup.js.map

package/dist/core/audio-cleanup.js.map

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

package/dist/core/audio-cleanup.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audio-cleanup.test.d.ts.map

package/dist/core/audio-cleanup.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-cleanup.test.d.ts","sourceRoot":"","sources":["../../src/core/audio-cleanup.test.ts"],"names":[],"mappings":""}

package/dist/core/audio-cleanup.test.js

@@ -0,0 +1,41 @@
+import { describe, expect, it } from "vitest";
+import { buildCleanupFilter } from "./audio-cleanup.js";
+describe("buildCleanupFilter", () => {
+    it("builds afftdn for denoise modes", () => {
+        expect(buildCleanupFilter("denoise")).toMatch(/^afftdn=/);
+        expect(buildCleanupFilter("denoise-strong")).toMatch(/^afftdn=/);
+    });
+    it("falls back to afftdn when rnnoise mode is requested without a model", () => {
+        const f = buildCleanupFilter("rnnoise");
+        expect(f).toMatch(/^afftdn=/);
+    });
+    it("uses arnndn when a model is supplied", () => {
+        const f = buildCleanupFilter("rnnoise", { rnnoiseModel: "/path/to/model.rnnn" });
+        expect(f).toMatch(/^arnndn=m=/);
+        expect(f).toContain("/path/to/model.rnnn");
+    });
+    it("escapes colons in rnnoise model path", () => {
+        const f = buildCleanupFilter("rnnoise", {
+            rnnoiseModel: "C:/models/voice.rnnn",
+        });
+        expect(f).toContain("C\\:/models/voice.rnnn");
+    });
+    it("dehum at 50Hz hits 50/100/150/200", () => {
+        const f = buildCleanupFilter("dehum");
+        expect(f).toContain("f=50");
+        expect(f).toContain("f=100");
+        expect(f).toContain("f=150");
+        expect(f).toContain("f=200");
+    });
+    it("dehum at 60Hz hits 60/120/180/240", () => {
+        const f = buildCleanupFilter("dehum", { mainsHz: 60 });
+        expect(f).toContain("f=60");
+        expect(f).toContain("f=120");
+        expect(f).toContain("f=180");
+        expect(f).toContain("f=240");
+    });
+    it("deess uses the deesser filter", () => {
+        expect(buildCleanupFilter("deess")).toMatch(/^deesser=/);
+    });
+});
+//# sourceMappingURL=audio-cleanup.test.js.map

package/dist/core/audio-cleanup.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-cleanup.test.js","sourceRoot":"","sources":["../../src/core/audio-cleanup.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,CAAC,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,kBAAkB,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,kBAAkB,CAAC,SAAS,EAAE;YACtC,YAAY,EAAE,sBAAsB;SACrC,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/audio-mix.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Audio mixing chain — EQ, compressor, gate, reverb, de-esser, limiter.
+ *
+ * File-only path: pure ffmpeg filter strings, mirroring `audio-cleanup.ts`
+ * but with parameter knobs the agent can tune per-clip. We expose this as
+ * a single "chain" so the agent can express a full mixing decision in one
+ * call (e.g. "vocal preset = highpass 80Hz + 3dB peak at 5kHz + 4:1 comp +
+ * -1dB ceiling limiter").
+ *
+ * All filters confirmed present in stock Homebrew ffmpeg:
+ *   - equalizer / highpass / lowpass — eq bands
+ *   - acompressor — compressor
+ *   - agate — gate
+ *   - aecho / aphaser — pseudo-reverb
+ *   - alimiter — brick-wall limiter
+ *   - adynamicequalizer — de-esser (5-9 kHz dynamic shelf)
+ *
+ * Real-world reference for filter syntax: ffmpeg-filters man page +
+ * jiaaro/pydub's effect chains + scottcjn/bottube's mixing helpers.
+ */
+export interface EqBand {
+    /** Filter type. */
+    type: "low" | "high" | "peak" | "shelf-low" | "shelf-high";
+    /** Center / cutoff frequency in Hz. */
+    freqHz: number;
+    /** Gain in dB (peak / shelf only; ignored for low/high pass). */
+    gainDb?: number;
+    /** Bandwidth Q-factor. Default 1. Higher = narrower band. */
+    q?: number;
+}
+export interface Compressor {
+    /** Threshold in dB below which the comp doesn't act. -18 to -10 typical for voice. */
+    thresholdDb: number;
+    /** Ratio. 4 = 4:1 = strong voice control. */
+    ratio: number;
+    /** Attack in ms. Default 20. */
+    attackMs?: number;
+    /** Release in ms. Default 250. */
+    releaseMs?: number;
+    /** Makeup gain in dB. Default 0. */
+    makeupDb?: number;
+}
+export interface Gate {
+    /** Below threshold the signal is attenuated. -50 dB cuts most room tone. */
+    thresholdDb: number;
+    /** Ratio. Higher = more aggressive cut. Default 5. */
+    ratio?: number;
+    attackMs?: number;
+    releaseMs?: number;
+}
+export interface Reverb {
+    /** 0..1; how big the room sounds. */
+    roomSize: number;
+    /** 0..1; balance. 0 = dry, 1 = all wet. */
+    wetDryMix: number;
+}
+export interface Limiter {
+    /** Output ceiling in dB. -1 dBTP is the YouTube/Spotify-friendly default. */
+    ceilingDb: number;
+    releaseMs?: number;
+}
+export interface DeEsser {
+    /** Frequency in Hz where sibilance lives. Default 6500. */
+    freqHz?: number;
+    /** Threshold in dB above which the dynamic shelf engages. Default -25. */
+    thresholdDb?: number;
+}
+export interface AudioChain {
+    eq?: EqBand[];
+    compressor?: Compressor;
+    gate?: Gate;
+    reverb?: Reverb;
+    deess?: DeEsser;
+    limiter?: Limiter;
+}
+/**
+ * Build the ffmpeg `-af` filter string for a chain. Pure function — tests
+ * verify the full string assembly without spawning ffmpeg.
+ *
+ * Order: gate → eq → de-esser → compressor → reverb → limiter. This matches
+ * the conventional mixing console order: clean noise out first, shape tone,
+ * tame dynamics, add ambience, then catch peaks.
+ */
+export declare function buildMixFilter(chain: AudioChain): string;
+/** Apply a mixing chain to one input file. Video stream is copied. */
+export declare function applyMix(inputPath: string, outputPath: string, chain: AudioChain, opts?: {
+    signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=audio-mix.d.ts.map

package/dist/core/audio-mix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mix.d.ts","sourceRoot":"","sources":["../../src/core/audio-mix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,WAAW,MAAM;IACrB,mBAAmB;IACnB,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;IAC3D,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAqFxD;AA+CD,sEAAsE;AACtE,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/core/audio-mix.js

@@ -0,0 +1,163 @@
+/**
+ * Audio mixing chain — EQ, compressor, gate, reverb, de-esser, limiter.
+ *
+ * File-only path: pure ffmpeg filter strings, mirroring `audio-cleanup.ts`
+ * but with parameter knobs the agent can tune per-clip. We expose this as
+ * a single "chain" so the agent can express a full mixing decision in one
+ * call (e.g. "vocal preset = highpass 80Hz + 3dB peak at 5kHz + 4:1 comp +
+ * -1dB ceiling limiter").
+ *
+ * All filters confirmed present in stock Homebrew ffmpeg:
+ *   - equalizer / highpass / lowpass — eq bands
+ *   - acompressor — compressor
+ *   - agate — gate
+ *   - aecho / aphaser — pseudo-reverb
+ *   - alimiter — brick-wall limiter
+ *   - adynamicequalizer — de-esser (5-9 kHz dynamic shelf)
+ *
+ * Real-world reference for filter syntax: ffmpeg-filters man page +
+ * jiaaro/pydub's effect chains + scottcjn/bottube's mixing helpers.
+ */
+import { runFfmpeg } from "./media/ffmpeg.js";
+/**
+ * Build the ffmpeg `-af` filter string for a chain. Pure function — tests
+ * verify the full string assembly without spawning ffmpeg.
+ *
+ * Order: gate → eq → de-esser → compressor → reverb → limiter. This matches
+ * the conventional mixing console order: clean noise out first, shape tone,
+ * tame dynamics, add ambience, then catch peaks.
+ */
+export function buildMixFilter(chain) {
+    const parts = [];
+    if (chain.gate) {
+        const g = chain.gate;
+        parts.push([
+            `agate`,
+            `threshold=${dbToLinear(g.thresholdDb)}`,
+            `ratio=${g.ratio ?? 5}`,
+            `attack=${g.attackMs ?? 20}`,
+            `release=${g.releaseMs ?? 250}`,
+        ].join(":"));
+    }
+    if (chain.eq && chain.eq.length > 0) {
+        for (const band of chain.eq) {
+            parts.push(buildEqBand(band));
+        }
+    }
+    if (chain.deess) {
+        // adynamicequalizer is the modern, present-everywhere de-esser. Ranged
+        // shelf around the sibilance frequency.
+        const f = chain.deess.freqHz ?? 6500;
+        const t = chain.deess.thresholdDb ?? -25;
+        parts.push(
+        // mode=cutabove → attenuate the target band when detection exceeds
+        // threshold. This is the canonical de-esser shape (sibilance pokes
+        // above threshold → shelf cuts it). Valid modes on ffmpeg ≥ 5 are:
+        // listen | cutbelow | cutabove | boostbelow | boostabove. The older
+        // `mode=cut` alias was never accepted — it errors with "Undefined
+        // constant or missing '('".
+        `adynamicequalizer=dfrequency=${f}:dqfactor=2:tfrequency=${f}:tqfactor=2:threshold=${dbToLinear(t)}:ratio=4:mode=cutabove:tftype=highshelf`);
+    }
+    if (chain.compressor) {
+        const c = chain.compressor;
+        parts.push([
+            `acompressor`,
+            `threshold=${dbToLinear(c.thresholdDb)}`,
+            `ratio=${c.ratio}`,
+            `attack=${c.attackMs ?? 20}`,
+            `release=${c.releaseMs ?? 250}`,
+            `makeup=${c.makeupDb ?? 0}`,
+        ].join(":"));
+    }
+    if (chain.reverb) {
+        const r = chain.reverb;
+        // aecho-based pseudo-reverb. Real reverb requires SoX or impulse response
+        // filtering, which Homebrew ffmpeg doesn't ship. The aecho approximation
+        // is good enough for "this should sound like a room" at the agent level.
+        const delays = roomSizeToDelays(r.roomSize);
+        const decays = roomSizeToDecays(r.roomSize);
+        const inGain = 1 - r.wetDryMix * 0.5;
+        const outGain = 0.5 + r.wetDryMix * 0.5;
+        parts.push(`aecho=in_gain=${fmt(inGain)}:out_gain=${fmt(outGain)}:delays=${delays}:decays=${decays}`);
+    }
+    if (chain.limiter) {
+        const l = chain.limiter;
+        parts.push([
+            `alimiter`,
+            `level_in=1`,
+            `level_out=1`,
+            `limit=${dbToLinear(l.ceilingDb)}`,
+            `attack=5`,
+            `release=${l.releaseMs ?? 50}`,
+            `level=disabled`,
+        ].join(":"));
+    }
+    if (parts.length === 0) {
+        throw new Error("buildMixFilter: empty chain — supply at least one effect");
+    }
+    return parts.join(",");
+}
+function buildEqBand(band) {
+    const q = band.q ?? 1;
+    const w = q;
+    switch (band.type) {
+        case "low":
+            // Low-pass: cut content above freqHz.
+            return `lowpass=f=${band.freqHz}`;
+        case "high":
+            return `highpass=f=${band.freqHz}`;
+        case "peak":
+            return `equalizer=f=${band.freqHz}:t=q:w=${w}:g=${band.gainDb ?? 0}`;
+        case "shelf-low":
+            return `bass=g=${band.gainDb ?? 0}:f=${band.freqHz}:w=${w}`;
+        case "shelf-high":
+            return `treble=g=${band.gainDb ?? 0}:f=${band.freqHz}:w=${w}`;
+        default: {
+            const _exhaustive = band.type;
+            throw new Error(`unknown eq band type: ${String(_exhaustive)}`);
+        }
+    }
+}
+/** dB → linear scalar for ffmpeg threshold/ceiling args. */
+function dbToLinear(db) {
+    return fmt(Math.pow(10, db / 20));
+}
+function fmt(n) {
+    if (Number.isInteger(n))
+        return String(n);
+    return n.toFixed(6).replace(/\.?0+$/, "");
+}
+function roomSizeToDelays(roomSize) {
+    // Map 0..1 → a delay pair from a small bedroom to a large hall.
+    const small = Math.max(40, Math.round(20 + roomSize * 80));
+    const large = Math.max(120, Math.round(100 + roomSize * 800));
+    return `${small}|${large}`;
+}
+function roomSizeToDecays(roomSize) {
+    const a = (0.2 + roomSize * 0.4).toFixed(2);
+    const b = (0.1 + roomSize * 0.3).toFixed(2);
+    return `${a}|${b}`;
+}
+/** Apply a mixing chain to one input file. Video stream is copied. */
+export async function applyMix(inputPath, outputPath, chain, opts = {}) {
+    const filter = buildMixFilter(chain);
+    const isWav = /\.wav$/i.test(outputPath);
+    const args = [
+        "-i",
+        inputPath,
+        "-af",
+        filter,
+        "-c:v",
+        "copy",
+        ...(isWav ? ["-c:a", "pcm_s16le"] : ["-c:a", "aac", "-b:a", "192k"]),
+        outputPath,
+    ];
+    const r = await runFfmpeg(args, { signal: opts.signal });
+    if (r.code !== 0) {
+        throw new Error(`ffmpeg mix exited ${r.code}: ${tail(r.stderr)}`);
+    }
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+//# sourceMappingURL=audio-mix.js.map

package/dist/core/audio-mix.js.map

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

package/dist/core/audio-mix.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audio-mix.test.d.ts.map

package/dist/core/audio-mix.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mix.test.d.ts","sourceRoot":"","sources":["../../src/core/audio-mix.test.ts"],"names":[],"mappings":""}

package/dist/core/audio-mix.test.js

@@ -0,0 +1,91 @@
+import { describe, expect, it } from "vitest";
+import { buildMixFilter } from "./audio-mix.js";
+describe("buildMixFilter", () => {
+    it("rejects an empty chain", () => {
+        expect(() => buildMixFilter({})).toThrow(/empty chain/);
+    });
+    it("emits a high-pass band", () => {
+        const f = buildMixFilter({
+            eq: [{ type: "high", freqHz: 80 }],
+        });
+        expect(f).toBe("highpass=f=80");
+    });
+    it("emits a low-pass band", () => {
+        const f = buildMixFilter({ eq: [{ type: "low", freqHz: 12000 }] });
+        expect(f).toBe("lowpass=f=12000");
+    });
+    it("emits a peak band with frequency, q, gain", () => {
+        const f = buildMixFilter({
+            eq: [{ type: "peak", freqHz: 5000, gainDb: 3, q: 1.5 }],
+        });
+        expect(f).toContain("equalizer=f=5000");
+        expect(f).toContain("t=q");
+        expect(f).toContain("w=1.5");
+        expect(f).toContain("g=3");
+    });
+    it("emits low-shelf and high-shelf as bass / treble", () => {
+        const f = buildMixFilter({
+            eq: [
+                { type: "shelf-low", freqHz: 200, gainDb: -2 },
+                { type: "shelf-high", freqHz: 8000, gainDb: 4 },
+            ],
+        });
+        expect(f).toContain("bass=g=-2:f=200");
+        expect(f).toContain("treble=g=4:f=8000");
+    });
+    it("emits acompressor with linearized threshold", () => {
+        const f = buildMixFilter({
+            compressor: { thresholdDb: -18, ratio: 4 },
+        });
+        expect(f).toMatch(/^acompressor:/);
+        expect(f).toContain("ratio=4");
+        // -18 dB ≈ 0.125892541 linear; the formatter trims trailing zeros.
+        expect(f).toMatch(/threshold=0\.125/);
+    });
+    it("emits agate before everything else when supplied", () => {
+        const f = buildMixFilter({
+            gate: { thresholdDb: -50 },
+            compressor: { thresholdDb: -18, ratio: 4 },
+        });
+        // Gate index < compressor index.
+        expect(f.indexOf("agate")).toBeLessThan(f.indexOf("acompressor"));
+    });
+    it("emits limiter with -1 dB ceiling", () => {
+        const f = buildMixFilter({ limiter: { ceilingDb: -1 } });
+        expect(f).toMatch(/^alimiter:/);
+        // -1 dB ≈ 0.891 linear.
+        expect(f).toMatch(/limit=0\.89/);
+        expect(f).toContain("level=disabled");
+    });
+    it("emits adynamicequalizer for de-esser", () => {
+        const f = buildMixFilter({ deess: { freqHz: 6500, thresholdDb: -25 } });
+        expect(f).toMatch(/^adynamicequalizer/);
+        expect(f).toContain("dfrequency=6500");
+        expect(f).toContain("mode=cutabove");
+    });
+    it("chains multiple effects in canonical order: gate, eq, deess, comp, reverb, limiter", () => {
+        const f = buildMixFilter({
+            gate: { thresholdDb: -50 },
+            eq: [{ type: "high", freqHz: 80 }],
+            deess: {},
+            compressor: { thresholdDb: -18, ratio: 4 },
+            reverb: { roomSize: 0.4, wetDryMix: 0.2 },
+            limiter: { ceilingDb: -1 },
+        });
+        const order = ["agate", "highpass", "adynamicequalizer", "acompressor", "aecho", "alimiter"];
+        let cursor = 0;
+        for (const tag of order) {
+            const idx = f.indexOf(tag, cursor);
+            expect(idx).toBeGreaterThan(-1);
+            cursor = idx;
+        }
+    });
+    it("emits aecho for reverb with appropriate delays/decays", () => {
+        const f = buildMixFilter({ reverb: { roomSize: 0.5, wetDryMix: 0.3 } });
+        expect(f).toContain("aecho=");
+        // Two delay/decay channels separated by |
+        expect(f).toMatch(/delays=\d+\|\d+/);
+        expect(f).toMatch(/decays=[\d.]+\|[\d.]+/);
+    });
+});
+//# sourceMappingURL=audio-mix.test.js.map

package/dist/core/audio-mix.test.js.map

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

package/dist/core/auth/api-keys.d.ts

@@ -0,0 +1,18 @@
+export type ApiKeyName = "openai" | "huggingface" | "pexels";
+/**
+ * Read a stored API key. Returns undefined when none is saved.
+ * The key store is cached after first load.
+ */
+export declare function getStoredApiKey(name: ApiKeyName): string | undefined;
+/**
+ * Persist an API key. Trims whitespace; throws if empty.
+ */
+export declare function setStoredApiKey(name: ApiKeyName, key: string): void;
+/**
+ * Convenience: env var first, then the stored value. The order matches
+ * how the vision modules already work — they default to the env var,
+ * and now they get a sensible fallback when it's not set.
+ */
+export declare function resolveApiKey(envVar: string, name: ApiKeyName): string | undefined;
+export declare const API_KEYS_FILE: string;
+//# sourceMappingURL=api-keys.d.ts.map

package/dist/core/auth/api-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.d.ts","sourceRoot":"","sources":["../../../src/core/auth/api-keys.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,CAAC;AAkC7D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAKnE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAElF;AAED,eAAO,MAAM,aAAa,QAAgB,CAAC"}

package/dist/core/auth/api-keys.js

@@ -0,0 +1,73 @@
+/**
+ * API-key store. Separate from auth.json (which holds OAuth tokens
+ * with refresh metadata) so we don't pollute that schema with bare
+ * static keys. Lives at ~/.ezcoder/api-keys.json:
+ *
+ *   {
+ *     "openai": "sk-...",
+ *     "huggingface": "hf_...",
+ *     "pexels": "..."
+ *   }
+ *
+ * Used by vision tools (analyze_hook / score_shot / color_match /
+ * skin_grade / match_clip_color) when the matching env var isn't set
+ * — onboarding can capture the key once and persist it here.
+ */
+import { readFileSync, writeFileSync, mkdirSync, chmodSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const API_KEYS_PATH = join(homedir(), ".ezcoder", "api-keys.json");
+let _cache;
+function loadStore() {
+    if (_cache)
+        return _cache;
+    try {
+        const raw = readFileSync(API_KEYS_PATH, "utf8");
+        _cache = JSON.parse(raw);
+    }
+    catch {
+        _cache = {};
+    }
+    return _cache;
+}
+function saveStore(store) {
+    mkdirSync(dirname(API_KEYS_PATH), { recursive: true });
+    writeFileSync(API_KEYS_PATH, JSON.stringify(store, null, 2) + "\n", "utf8");
+    // 0600 so other users on the system can't read the key.
+    try {
+        chmodSync(API_KEYS_PATH, 0o600);
+    }
+    catch {
+        // Best-effort — some filesystems (network mounts, CI sandboxes)
+        // ignore chmod. Not a hard error.
+    }
+    _cache = store;
+}
+/**
+ * Read a stored API key. Returns undefined when none is saved.
+ * The key store is cached after first load.
+ */
+export function getStoredApiKey(name) {
+    const v = loadStore()[name];
+    return v && v.length > 0 ? v : undefined;
+}
+/**
+ * Persist an API key. Trims whitespace; throws if empty.
+ */
+export function setStoredApiKey(name, key) {
+    const trimmed = key.trim();
+    if (trimmed.length === 0)
+        throw new Error(`API key for ${name} is empty`);
+    const store = { ...loadStore(), [name]: trimmed };
+    saveStore(store);
+}
+/**
+ * Convenience: env var first, then the stored value. The order matches
+ * how the vision modules already work — they default to the env var,
+ * and now they get a sensible fallback when it's not set.
+ */
+export function resolveApiKey(envVar, name) {
+    return process.env[envVar] || getStoredApiKey(name);
+}
+export const API_KEYS_FILE = API_KEYS_PATH;
+//# sourceMappingURL=api-keys.js.map

package/dist/core/auth/api-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.js","sourceRoot":"","sources":["../../../src/core/auth/api-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;AAUnE,IAAI,MAA4B,CAAC;AAEjC,SAAS,SAAS;IAChB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,EAAE,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5E,wDAAwD;IACxD,IAAI,CAAC;QACH,SAAS,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;QAChE,kCAAkC;IACpC,CAAC;IACD,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB,EAAE,GAAW;IAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,WAAW,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IAClD,SAAS,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,IAAgB;IAC5D,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC"}

package/dist/core/auth/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ezeditor's auth surface. Single source of truth lives in
+ * `@prestyj/cli/auth` \u2014 we re-export it here so editor code keeps a
+ * stable import path while the underlying OAuth flows, refresh logic, and
+ * AuthStorage are exactly the ones ezcoder ships and exercises daily.
+ *
+ * Why re-export instead of fork: every previous fork (ezeditor 0.6.0\u20130.6.6)
+ * accumulated regressions when small details drifted \u2014 wrong OpenAI
+ * `originator`, missing 401 retry callback, broken Windows browser-open.
+ * Importing keeps editor + coder bug-fix-symmetric forever.
+ *
+ * `types.ts` and `api-keys.ts` stay editor-local: provider lists and the
+ * vision-tools API-key store are editor-specific concerns.
+ */
+export { AuthStorage, NotLoggedInError, loginAnthropic, loginOpenAI, refreshAnthropicToken, refreshOpenAIToken, } from "@prestyj/cli/auth";
+export type { OAuthCredentials, OAuthLoginCallbacks } from "@prestyj/cli/auth";
+export { runLogin, runLogout, runStatus } from "./login.js";
+export { STATIC_KEY_PROVIDERS, OAUTH_PROVIDERS } from "./types.js";
+export type { SupportedAuthProvider } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/auth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}