@prestyj/editor 0.7.1

package/dist/core/hook-analysis.test.js

@@ -0,0 +1,130 @@
+import { describe, expect, it } from "vitest";
+import { buildHookResult, parseHookVisionResponse, speechAt0_5sScore } from "./hook-analysis.js";
+describe("speechAt0_5sScore", () => {
+    it("returns 1.0 when there are no silences in the window", () => {
+        expect(speechAt0_5sScore([])).toBe(1);
+    });
+    it("returns 0.0 when the entire window is silent", () => {
+        expect(speechAt0_5sScore([{ startSec: 0, endSec: 1 }])).toBe(0);
+    });
+    it("returns 0.5 when half the window is silent", () => {
+        expect(speechAt0_5sScore([{ startSec: 0, endSec: 0.25 }])).toBeCloseTo(0.5, 3);
+    });
+    it("clips silences that start before / extend past the window", () => {
+        expect(speechAt0_5sScore([{ startSec: -1, endSec: 0.1 }])).toBeCloseTo(0.8, 3);
+        expect(speechAt0_5sScore([{ startSec: 0.4, endSec: 5 }])).toBeCloseTo(0.8, 3);
+    });
+    it("respects a custom windowSec", () => {
+        expect(speechAt0_5sScore([{ startSec: 0, endSec: 1 }], 2)).toBeCloseTo(0.5, 3);
+    });
+});
+describe("parseHookVisionResponse", () => {
+    it("parses a well-formed response", () => {
+        const j = JSON.stringify({
+            onScreenText: 0.8,
+            motion: 0.6,
+            subjectClarity: 0.9,
+            emotionalIntensity: 0.7,
+            why: "bold hook text + reaction shot",
+        });
+        const r = parseHookVisionResponse(j);
+        expect(r.onScreenText).toBe(0.8);
+        expect(r.motion).toBe(0.6);
+        expect(r.subjectClarity).toBe(0.9);
+        expect(r.emotionalIntensity).toBe(0.7);
+        expect(r.why).toContain("hook");
+    });
+    it("falls back to 0 on missing fields", () => {
+        const r = parseHookVisionResponse("{}");
+        expect(r.onScreenText).toBe(0);
+        expect(r.motion).toBe(0);
+        expect(r.subjectClarity).toBe(0);
+        expect(r.emotionalIntensity).toBe(0);
+    });
+    it("clamps out-of-range values to [0,1]", () => {
+        const r = parseHookVisionResponse(JSON.stringify({ onScreenText: 99, motion: -5, subjectClarity: 0.5, emotionalIntensity: 1 }));
+        expect(r.onScreenText).toBe(1);
+        expect(r.motion).toBe(0);
+    });
+    it("survives prose wrapping around the JSON", () => {
+        const r = parseHookVisionResponse('Here:\n{"onScreenText":0.5,"motion":0.5,"subjectClarity":0.5,"emotionalIntensity":0.5}\nDone.');
+        expect(r.onScreenText).toBe(0.5);
+    });
+    it("throws on totally absent JSON", () => {
+        expect(() => parseHookVisionResponse("no json")).toThrow(/no JSON/);
+    });
+});
+describe("buildHookResult", () => {
+    const strong = {
+        onScreenText: 0.9,
+        motion: 0.8,
+        subjectClarity: 0.9,
+        emotionalIntensity: 0.8,
+        why: "strong",
+    };
+    const weak = {
+        onScreenText: 0.1,
+        motion: 0.1,
+        subjectClarity: 0.1,
+        emotionalIntensity: 0.1,
+        why: "weak",
+    };
+    it("produces a high score for a strong hook", () => {
+        const r = buildHookResult(1, strong);
+        expect(r.score).toBeGreaterThanOrEqual(85);
+        expect(r.passes).toBe(true);
+        expect(r.findings).toEqual([]);
+    });
+    it("produces a low score for a weak hook", () => {
+        const r = buildHookResult(0, weak);
+        expect(r.score).toBeLessThanOrEqual(15);
+        expect(r.passes).toBe(false);
+        // All five findings should fire.
+        const ids = r.findings.map((f) => f.id);
+        expect(ids).toContain("silent_open");
+        expect(ids).toContain("no_on_screen_text");
+        expect(ids).toContain("static_first_frame");
+        expect(ids).toContain("no_clear_subject");
+        expect(ids).toContain("weak_emotional_hook");
+    });
+    it("flags silent_open with severity=block when speech < 0.2", () => {
+        const r = buildHookResult(0.05, strong);
+        const f = r.findings.find((x) => x.id === "silent_open");
+        expect(f?.severity).toBe("block");
+    });
+    it("flags silent_open with severity=warn when 0.2 <= speech < 0.5", () => {
+        const r = buildHookResult(0.3, strong);
+        const f = r.findings.find((x) => x.id === "silent_open");
+        expect(f?.severity).toBe("warn");
+    });
+    it("does not flag silent_open when speech >= 0.5", () => {
+        const r = buildHookResult(0.6, strong);
+        expect(r.findings.find((x) => x.id === "silent_open")).toBeUndefined();
+    });
+    it("respects a custom passThreshold", () => {
+        const r = buildHookResult(0.5, {
+            onScreenText: 0.5,
+            motion: 0.5,
+            subjectClarity: 0.5,
+            emotionalIntensity: 0.5,
+            why: "mid",
+        });
+        // Score ≈ 50 with default weights; passes at threshold 50.
+        expect(buildHookResult(0.5, r).score).toBeGreaterThanOrEqual(0);
+        expect(buildHookResult(0.5, {
+            onScreenText: 0.5,
+            motion: 0.5,
+            subjectClarity: 0.5,
+            emotionalIntensity: 0.5,
+            why: "mid",
+        }, { passThreshold: 40 }).passes).toBe(true);
+        expect(buildHookResult(0.5, {
+            onScreenText: 0.5,
+            motion: 0.5,
+            subjectClarity: 0.5,
+            emotionalIntensity: 0.5,
+            why: "mid",
+        }, { passThreshold: 90 }).passes).toBe(false);
+    });
+});
+//# sourceMappingURL=hook-analysis.test.js.map

package/dist/core/hook-analysis.test.js.map

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

package/dist/core/hook-rewrite.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Hook rewriter.
+ *
+ * Given a current hook + topic + (optional) transcript context + a target
+ * pattern from the `viral-hook-patterns` skill, produce 3 candidate
+ * rewrites. ONE LLM call. The agent surfaces candidates to the user;
+ * we never auto-apply (we don't generate footage).
+ *
+ * The 12 patterns below are the compact form of the skill — name +
+ * one-line structure each. Plenty for the LLM; not enough to bloat the
+ * prompt.
+ */
+export declare const HOOK_PATTERNS: readonly ["click-to-unpause", "shock-intrigue-satisfy", "foreshadow-ending", "but-so-escalation", "power-word", "crazy-progression", "match-thumbnail", "i-asked-google", "credibility-plus-n", "cliffhanger", "first-frame-thumbnail", "auto"];
+export type HookPattern = (typeof HOOK_PATTERNS)[number];
+export interface HookCandidate {
+    line: string;
+    pattern: string;
+    why: string;
+}
+export interface HookRewriteResult {
+    candidates: HookCandidate[];
+    chosenPattern: string;
+    why: string;
+}
+export interface RewriteOptions {
+    apiKey?: string;
+    model?: string;
+    signal?: AbortSignal;
+}
+export interface RewriteInput {
+    currentHook: string;
+    videoTopic: string;
+    transcriptExcerpt?: string;
+    pattern: HookPattern;
+}
+/**
+ * Run ONE LLM call. Throws on parse / network error so the wrapper
+ * converts to err().
+ */
+export declare function runHookRewrite(input: RewriteInput, opts?: RewriteOptions): Promise<HookRewriteResult>;
+/**
+ * Parse the model's JSON. Robust to missing keys; pads to exactly 3
+ * candidates so the caller always has a stable shape.
+ *
+ * Pure — exported for testing.
+ */
+export declare function parseRewriteResponse(content: string, requestedPattern: HookPattern): HookRewriteResult;
+//# sourceMappingURL=hook-rewrite.d.ts.map

package/dist/core/hook-rewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-rewrite.d.ts","sourceRoot":"","sources":["../../src/core/hook-rewrite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,eAAO,MAAM,aAAa,iPAahB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AA6CzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EACnB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAwC5B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,WAAW,GAC5B,iBAAiB,CA6BnB"}

package/dist/core/hook-rewrite.js

@@ -0,0 +1,151 @@
+/**
+ * Hook rewriter.
+ *
+ * Given a current hook + topic + (optional) transcript context + a target
+ * pattern from the `viral-hook-patterns` skill, produce 3 candidate
+ * rewrites. ONE LLM call. The agent surfaces candidates to the user;
+ * we never auto-apply (we don't generate footage).
+ *
+ * The 12 patterns below are the compact form of the skill — name +
+ * one-line structure each. Plenty for the LLM; not enough to bloat the
+ * prompt.
+ */
+import { resolveApiKey } from "./auth/api-keys.js";
+export const HOOK_PATTERNS = [
+    "click-to-unpause",
+    "shock-intrigue-satisfy",
+    "foreshadow-ending",
+    "but-so-escalation",
+    "power-word",
+    "crazy-progression",
+    "match-thumbnail",
+    "i-asked-google",
+    "credibility-plus-n",
+    "cliffhanger",
+    "first-frame-thumbnail",
+    "auto",
+];
+const PATTERN_LIBRARY = `Pattern library (12 viral hook patterns):
+
+1. click-to-unpause       — open with the most arresting visual moment, then "rewind" verbally. ("This is the moment X — but to understand it, we need to start an hour earlier.")
+2. shock-intrigue-satisfy — line 1 shocks; line 2 reframes; line 3 promises payoff. ("I found a $1 phone. It actually works. Here's what's wrong with it.")
+3. foreshadow-ending      — open by referencing the climax. ("In 8 minutes I'll be holding $10,000 cash — but first…")
+4. but-so-escalation      — string two reversals: "I tried X. But Y went wrong. So I doubled down."
+5. power-word             — lead with one ALL-CAPS power word. ("ILLEGAL. This is illegal in 14 states.")
+6. crazy-progression      — escalate scale across the line. ("First 1, then 10, then 100, then 1,000.")
+7. match-thumbnail        — the hook restates the thumbnail's promise verbally in the first 3s.
+8. i-asked-google         — frame as a research question. ("I asked Google, what's the rarest…")
+9. credibility-plus-n     — credential + specific number. ("As a 12-year sommelier, I tried 47 wines.")
+10. cliffhanger            — open mid-action with a missing answer. ("I can't believe what just happened.")
+11. first-frame-thumbnail  — describe the literal first visual frame as if reading the thumbnail aloud.
+12. auto                   — no constraint; pick the closest-fit pattern based on topic.
+
+Each pattern is a STRUCTURE, not a script. Adapt to the topic — never reuse a verbatim example from this list.`;
+const SYSTEM = `You rewrite YouTube / Shorts / Reels / TikTok hooks. You receive:
+  - A CURRENT HOOK (may be empty when none exists yet).
+  - The VIDEO TOPIC (one line).
+  - Optionally a 200-500 char EXCERPT from the transcript for tone.
+  - A target PATTERN from the library below.
+
+${PATTERN_LIBRARY}
+
+Output JSON with these EXACT keys:
+{
+  "candidates":     [
+    { "line": "<≤140 char rewritten hook>", "pattern": "<pattern name>", "why": "<≤120 char rationale>" },
+    ...exactly 3 entries...
+  ],
+  "chosenPattern": "<the pattern actually used (matches the requested one unless 'auto' was passed)>",
+  "why":           "<≤200 char overall rationale>"
+}
+
+Rules:
+- Exactly 3 candidates.
+- Each candidate ≤140 chars.
+- All 3 candidates use the SAME pattern (consistency for A/B testing).
+- Vary the candidates: different specifics, different power words, different opens. Don't paraphrase the same line three times.
+- When the requested pattern is "auto", pick the closest-fit pattern from the library and stamp it into "chosenPattern".
+- Honest tone — no clickbait that the video can't deliver.`;
+/**
+ * Run ONE LLM call. Throws on parse / network error so the wrapper
+ * converts to err().
+ */
+export async function runHookRewrite(input, opts = {}) {
+    const apiKey = opts.apiKey ?? resolveApiKey("OPENAI_API_KEY", "openai");
+    if (!apiKey)
+        throw new Error("OPENAI_API_KEY required for rewrite_hook.");
+    const model = opts.model ?? "gpt-4o-mini";
+    const userParts = [];
+    userParts.push(`PATTERN: ${input.pattern}`);
+    userParts.push(`VIDEO TOPIC: ${input.videoTopic}`);
+    userParts.push(`CURRENT HOOK: ${input.currentHook || "[none — write a fresh one]"}`);
+    if (input.transcriptExcerpt) {
+        userParts.push(`TRANSCRIPT EXCERPT (for tone):\n${input.transcriptExcerpt.slice(0, 600)}`);
+    }
+    const body = {
+        model,
+        messages: [
+            { role: "system", content: SYSTEM },
+            { role: "user", content: userParts.join("\n\n") },
+        ],
+        response_format: { type: "json_object" },
+        temperature: 0,
+    };
+    const res = await fetch("https://api.openai.com/v1/chat/completions", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+        signal: opts.signal,
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`OpenAI HTTP ${res.status}: ${text.slice(0, 200)}`);
+    }
+    const data = (await res.json());
+    const content = data.choices[0]?.message?.content;
+    if (!content)
+        throw new Error("rewrite_hook: empty model response");
+    return parseRewriteResponse(content, input.pattern);
+}
+/**
+ * Parse the model's JSON. Robust to missing keys; pads to exactly 3
+ * candidates so the caller always has a stable shape.
+ *
+ * Pure — exported for testing.
+ */
+export function parseRewriteResponse(content, requestedPattern) {
+    const start = content.indexOf("{");
+    const end = content.lastIndexOf("}");
+    if (start < 0 || end < start) {
+        throw new Error("rewrite_hook: no JSON object in response");
+    }
+    const parsed = JSON.parse(content.slice(start, end + 1));
+    const candRaw = Array.isArray(parsed.candidates) ? parsed.candidates : [];
+    const candidates = [];
+    for (const c of candRaw) {
+        if (typeof c !== "object" || c === null)
+            continue;
+        const r = c;
+        const line = String(r.line ?? "").trim();
+        if (!line)
+            continue;
+        candidates.push({
+            line: line.slice(0, 200),
+            pattern: String(r.pattern ?? requestedPattern).slice(0, 60),
+            why: String(r.why ?? "").slice(0, 200),
+        });
+        if (candidates.length === 3)
+            break;
+    }
+    // Pad to 3 by duplicating the first usable candidate.
+    while (candidates.length > 0 && candidates.length < 3) {
+        candidates.push({ ...candidates[0] });
+    }
+    const chosenPattern = String(parsed.chosenPattern ?? requestedPattern).slice(0, 60);
+    const why = String(parsed.why ?? "").slice(0, 240);
+    return { candidates, chosenPattern, why };
+}
+//# sourceMappingURL=hook-rewrite.js.map

package/dist/core/hook-rewrite.js.map

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

package/dist/core/hook-rewrite.test.d.ts

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

package/dist/core/hook-rewrite.test.d.ts.map

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

package/dist/core/hook-rewrite.test.js

@@ -0,0 +1,58 @@
+import { describe, expect, it } from "vitest";
+import { HOOK_PATTERNS, parseRewriteResponse } from "./hook-rewrite.js";
+describe("HOOK_PATTERNS", () => {
+    it("includes all 12 patterns + auto", () => {
+        expect(HOOK_PATTERNS).toContain("auto");
+        expect(HOOK_PATTERNS).toContain("click-to-unpause");
+        expect(HOOK_PATTERNS).toContain("shock-intrigue-satisfy");
+        expect(HOOK_PATTERNS).toContain("foreshadow-ending");
+        expect(HOOK_PATTERNS).toContain("but-so-escalation");
+        expect(HOOK_PATTERNS).toContain("power-word");
+        expect(HOOK_PATTERNS).toContain("crazy-progression");
+        expect(HOOK_PATTERNS).toContain("match-thumbnail");
+        expect(HOOK_PATTERNS).toContain("i-asked-google");
+        expect(HOOK_PATTERNS).toContain("credibility-plus-n");
+        expect(HOOK_PATTERNS).toContain("cliffhanger");
+        expect(HOOK_PATTERNS).toContain("first-frame-thumbnail");
+    });
+});
+describe("parseRewriteResponse", () => {
+    it("returns 3 candidates when the model gives 3", () => {
+        const content = JSON.stringify({
+            candidates: [
+                { line: "A", pattern: "power-word", why: "punchy" },
+                { line: "B", pattern: "power-word", why: "punchy" },
+                { line: "C", pattern: "power-word", why: "punchy" },
+            ],
+            chosenPattern: "power-word",
+            why: "loud opener",
+        });
+        const r = parseRewriteResponse(content, "auto");
+        expect(r.candidates).toHaveLength(3);
+        expect(r.chosenPattern).toBe("power-word");
+    });
+    it("pads to 3 when the model gives fewer", () => {
+        const content = JSON.stringify({
+            candidates: [{ line: "only one", pattern: "cliffhanger", why: "x" }],
+            chosenPattern: "cliffhanger",
+        });
+        const r = parseRewriteResponse(content, "auto");
+        expect(r.candidates).toHaveLength(3);
+        expect(r.candidates.every((c) => c.line === "only one")).toBe(true);
+    });
+    it("returns no candidates when model gives nothing", () => {
+        const r = parseRewriteResponse(JSON.stringify({ candidates: [] }), "auto");
+        expect(r.candidates).toHaveLength(0);
+    });
+    it("falls back chosenPattern to the requested pattern", () => {
+        const content = JSON.stringify({
+            candidates: [{ line: "x", pattern: "power-word", why: "y" }],
+        });
+        const r = parseRewriteResponse(content, "power-word");
+        expect(r.chosenPattern).toBe("power-word");
+    });
+    it("throws on non-JSON", () => {
+        expect(() => parseRewriteResponse("not json", "auto")).toThrow();
+    });
+});
+//# sourceMappingURL=hook-rewrite.test.js.map

package/dist/core/hook-rewrite.test.js.map

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

package/dist/core/hosts/detect.d.ts

@@ -0,0 +1,17 @@
+import type { HostName } from "../../types.js";
+export interface DetectedHost {
+    name: HostName;
+    displayName: string;
+    /** Process name(s) we matched against. */
+    matched: string[];
+}
+/**
+ * Auto-detect what NLE is currently running. Returns the first match.
+ * If nothing is running, returns "none".
+ *
+ * Note: Resolve's process name is "resolve" lowercase on Linux which collides
+ * with all sorts of unrelated stuff; we restrict that match to look for the
+ * full app bundle path on macOS first, then fall back.
+ */
+export declare function detectHost(): DetectedHost;
+//# sourceMappingURL=detect.d.ts.map

package/dist/core/hosts/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/core/hosts/detect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAoCD;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAsBzC"}

package/dist/core/hosts/detect.js

@@ -0,0 +1,64 @@
+import { spawnSync } from "node:child_process";
+import { platform } from "node:os";
+/**
+ * Cross-platform process scan. Returns true if any process whose name (or
+ * full command line) contains one of the patterns is running.
+ */
+function isProcessRunning(patterns) {
+    const os = platform();
+    let stdout;
+    if (os === "darwin" || os === "linux") {
+        const r = spawnSync("ps", ["-axo", "comm,args"], { encoding: "utf8" });
+        stdout = r.stdout ?? "";
+    }
+    else if (os === "win32") {
+        const r = spawnSync("tasklist", ["/FO", "CSV", "/NH"], { encoding: "utf8" });
+        stdout = r.stdout ?? "";
+    }
+    else {
+        return [];
+    }
+    const lower = stdout.toLowerCase();
+    return patterns.filter((p) => lower.includes(p.toLowerCase()));
+}
+const HOST_PATTERNS = {
+    resolve: {
+        display: "DaVinci Resolve",
+        // Match the macOS app bundle name and the Linux/Windows binary.
+        patterns: ["DaVinci Resolve", "Resolve.exe", "resolve"],
+    },
+    premiere: {
+        display: "Adobe Premiere Pro",
+        patterns: ["Adobe Premiere Pro", "Premiere Pro", "Adobe Premiere"],
+    },
+};
+/**
+ * Auto-detect what NLE is currently running. Returns the first match.
+ * If nothing is running, returns "none".
+ *
+ * Note: Resolve's process name is "resolve" lowercase on Linux which collides
+ * with all sorts of unrelated stuff; we restrict that match to look for the
+ * full app bundle path on macOS first, then fall back.
+ */
+export function detectHost() {
+    // Resolve check — be strict to avoid false positives from "dns.resolve" etc.
+    const resolveBundleHits = isProcessRunning(["DaVinci Resolve.app", "DaVinci Resolve"]);
+    if (resolveBundleHits.length > 0) {
+        return {
+            name: "resolve",
+            displayName: HOST_PATTERNS.resolve.display,
+            matched: resolveBundleHits,
+        };
+    }
+    // Premiere check
+    const premiereHits = isProcessRunning(HOST_PATTERNS.premiere.patterns);
+    if (premiereHits.length > 0) {
+        return {
+            name: "premiere",
+            displayName: HOST_PATTERNS.premiere.display,
+            matched: premiereHits,
+        };
+    }
+    return { name: "none", displayName: "No NLE detected", matched: [] };
+}
+//# sourceMappingURL=detect.js.map

package/dist/core/hosts/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../src/core/hosts/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAUnC;;;GAGG;AACH,SAAS,gBAAgB,CAAC,QAAkB;IAC1C,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtB,IAAI,MAAc,CAAC;IAEnB,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACvE,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;IAC1B,CAAC;SAAM,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7E,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,aAAa,GAA+E;IAChG,OAAO,EAAE;QACP,OAAO,EAAE,iBAAiB;QAC1B,gEAAgE;QAChE,QAAQ,EAAE,CAAC,iBAAiB,EAAE,aAAa,EAAE,SAAS,CAAC;KACxD;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,oBAAoB;QAC7B,QAAQ,EAAE,CAAC,oBAAoB,EAAE,cAAc,EAAE,gBAAgB,CAAC;KACnE;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,6EAA6E;IAC7E,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACvF,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,OAAO;YAC1C,OAAO,EAAE,iBAAiB;SAC3B,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,MAAM,YAAY,GAAG,gBAAgB,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,aAAa,CAAC,QAAQ,CAAC,OAAO;YAC3C,OAAO,EAAE,YAAY;SACtB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACvE,CAAC"}

package/dist/core/hosts/detect.test.d.ts

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

package/dist/core/hosts/detect.test.d.ts.map

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

package/dist/core/hosts/detect.test.js

@@ -0,0 +1,17 @@
+import { describe, expect, it } from "vitest";
+import { detectHost } from "./detect.js";
+describe("detectHost", () => {
+    it("returns a valid host name and display string", () => {
+        const result = detectHost();
+        expect(["resolve", "premiere", "none"]).toContain(result.name);
+        expect(typeof result.displayName).toBe("string");
+        expect(result.displayName.length).toBeGreaterThan(0);
+    });
+    it("returns no matches when name is 'none'", () => {
+        const result = detectHost();
+        if (result.name === "none") {
+            expect(result.matched).toEqual([]);
+        }
+    });
+});
+//# sourceMappingURL=detect.test.js.map

package/dist/core/hosts/detect.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.test.js","sourceRoot":"","sources":["../../../src/core/hosts/detect.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,CAAC,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { HostName } from "../../types.js";
+import type { VideoHost } from "./types.js";
+export { detectHost } from "./detect.js";
+export { HostUnreachableError, HostUnsupportedError } from "./types.js";
+export type { VideoHost } from "./types.js";
+export { NoneAdapter } from "./none/adapter.js";
+export { PremiereAdapter } from "./premiere/adapter.js";
+export { ResolveAdapter } from "./resolve/adapter.js";
+/**
+ * Resolve a host adapter from an explicit name, or auto-detect if undefined.
+ */
+export declare function createHost(forced?: HostName): VideoHost;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/hosts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACxE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAcvD"}

package/dist/core/hosts/index.js

@@ -0,0 +1,30 @@
+import { detectHost } from "./detect.js";
+import { NoneAdapter } from "./none/adapter.js";
+import { PremiereAdapter } from "./premiere/adapter.js";
+import { ResolveAdapter } from "./resolve/adapter.js";
+export { detectHost } from "./detect.js";
+export { HostUnreachableError, HostUnsupportedError } from "./types.js";
+export { NoneAdapter } from "./none/adapter.js";
+export { PremiereAdapter } from "./premiere/adapter.js";
+export { ResolveAdapter } from "./resolve/adapter.js";
+/**
+ * Resolve a host adapter from an explicit name, or auto-detect if undefined.
+ */
+export function createHost(forced) {
+    if (forced === "resolve")
+        return new ResolveAdapter();
+    if (forced === "premiere")
+        return new PremiereAdapter();
+    if (forced === "none")
+        return new NoneAdapter();
+    const detected = detectHost();
+    switch (detected.name) {
+        case "resolve":
+            return new ResolveAdapter();
+        case "premiere":
+            return new PremiereAdapter();
+        default:
+            return new NoneAdapter();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/core/hosts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/hosts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAiB;IAC1C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,cAAc,EAAE,CAAC;IACtD,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,IAAI,eAAe,EAAE,CAAC;IACxD,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,WAAW,EAAE,CAAC;IAEhD,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAC9B,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,SAAS;YACZ,OAAO,IAAI,cAAc,EAAE,CAAC;QAC9B,KAAK,UAAU;YACb,OAAO,IAAI,eAAe,EAAE,CAAC;QAC/B;YACE,OAAO,IAAI,WAAW,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC"}