@mevdragon/vidfarm-devcli 0.17.0 → 0.18.0

package/dist/src/app.js

@@ -30,7 +30,7 @@ import { renderReskinLibrary } from "./reskin/library-page.js";
 import { renderReskinDiscover } from "./reskin/discover-page.js";
 import { renderReskinChat } from "./reskin/chat-page.js";
 import { renderReskinCalendar } from "./reskin/calendar-page.js";
-import { renderReskinJobRuns } from "./reskin/job-runs-page.js";
+import { renderReskinInpaint } from "./reskin/inpaint-page.js";
 import { renderReskinAgency } from "./reskin/agency-page.js";
 import { renderReskinPricing } from "./reskin/pricing-page.js";
 import { renderReskinLogin } from "./reskin/login-page.js";
@@ -101,7 +101,10 @@ const COMPOSITIONS_PREFIX = `${API_PREFIX}/compositions`;
 const INSPIRATIONS_PREFIX = `${API_PREFIX}/inspirations`;
 const VIDEOS_PREFIX = `${API_PREFIX}/videos`;
 const PRIMITIVES_PREFIX = `${API_PREFIX}/primitives`;
-const CLIPS_PREFIX = "/clips";
+const RAWS_PREFIX = "/raws";
+// Back-compat: the clip library was renamed "raws". Old /clips callers are
+// transparently redispatched to /raws (see the alias registered below).
+const CLIPS_COMPAT_PREFIX = "/clips";
 // Temp folder ("My Files → temporary") hard-TTL. Keep in sync with the
 // tag-scoped S3 lifecycle rule (30 days) in the CDK stacks and the clip-scan
 // Lambda's TEMP_SOURCE_TTL_DAYS — records, sweeps, and object lifecycle must
@@ -3259,11 +3262,11 @@ async function buildClipsEditorChatBoot(input) {
     const directorSkill = readRootSkillFile("SKILL.director.md", "SKILL.user.md") || null;
     const availableProviders = (await normalizeEditorChatProviderRows(input.customer.id)).map((entry) => entry.provider);
     const docsRoutes = [
-        { method: "GET", path: `${CLIPS_PREFIX}/feed`, summary: "List the caller's reusable clip library (optional ?q, ?source, ?limit)." },
-        { method: "POST", path: `${CLIPS_PREFIX}/search`, summary: "Hybrid structured + semantic clip search. Body is { query } (natural language) or { criteria } (structured filter)." },
-        { method: "POST", path: `${CLIPS_PREFIX}/scan`, summary: "Import a source video and mine it into clips. Body accepts source_url (a public/durable video URL), raw_s3_uri, or s3_key, plus an optional prompt describing which scenes to keep (e.g. 'people with food, no on-screen text, vertical, 5-10s')." },
-        { method: "GET", path: `${CLIPS_PREFIX}/scan/:scanId`, summary: "Poll clip-scan status for an in-progress import." },
-        { method: "GET", path: `${CLIPS_PREFIX}/presets`, summary: "List the caller's saved clip-search presets." }
+        { method: "GET", path: `${RAWS_PREFIX}/feed`, summary: "List the caller's reusable clip library (optional ?q, ?source, ?limit)." },
+        { method: "POST", path: `${RAWS_PREFIX}/search`, summary: "Hybrid structured + semantic clip search. Body is { query } (natural language) or { criteria } (structured filter)." },
+        { method: "POST", path: `${RAWS_PREFIX}/scan`, summary: "Import a source video and mine it into clips. Body accepts source_url (a public/durable video URL), raw_s3_uri, or s3_key, plus an optional prompt describing which scenes to keep (e.g. 'people with food, no on-screen text, vertical, 5-10s')." },
+        { method: "GET", path: `${RAWS_PREFIX}/scan/:scanId`, summary: "Poll clip-scan status for an in-progress import." },
+        { method: "GET", path: `${RAWS_PREFIX}/presets`, summary: "List the caller's saved clip-search presets." }
     ];
     return {
         apiUrl: resolveEditorChatApiUrl(),
@@ -3627,7 +3630,7 @@ function normalizeEditorChatPath(input) {
         // and NEVER runs GhostCut on the long-form source — "no text" is a
         // scene-selection filter; caption removal stays a per-finished-clip
         // primitive (/api/v1/primitives/videos/remove-captions).
-        CLIPS_PREFIX,
+        RAWS_PREFIX,
         // Public skill knowledge: the vendored skill packs (load_skill fetches
         // these too) and per-template SKILL.md manifests. Read-only markdown.
         "/skill/",
@@ -4911,27 +4914,268 @@ app.get("/", async (c) => {
 // Each page is a standalone document with its own CSS; renders sample data so
 // it's viewable without auth. Ported pages are wired here one at a time.
 app.get("/reskin", (c) => c.html(renderReskinIndex()));
-app.get("/reskin/settings", (c) => c.html(renderReskinSettings()));
+app.get("/settings", async (c) => {
+    const customer = await requireBrowserCustomer(c);
+    if (!customer) {
+        setLoginReturnPath(c, currentPathWithSearch(c));
+        return redirect(c, "/login");
+    }
+    const flash = consumeSettingsFlash(c);
+    const flockPosterApiKey = customer.flockposterApiKey?.trim() || null;
+    const activeTab = flash?.tab === "wallet" || flash?.tab === "channels" || flash?.tab === "developer"
+        ? flash.tab
+        : c.req.query("tab") === "wallet" || c.req.query("tab") === "channels" || c.req.query("tab") === "developer"
+            ? c.req.query("tab")
+            : "profile";
+    const directorSkill = readRootSkillFile("SKILL.director.md", "SKILL.user.md");
+    const emailChannels = await getEmailPseudoChannels(customer.id, c);
+    const [wallet, walletEvents] = await Promise.all([
+        fetchBillingWalletSummary(customer.id).catch((error) => ({
+            balanceUsd: 0, totalFundsAddedUsd: 0, totalChargeUsd: 0, totalBaseCostUsd: 0,
+            totalEventCount: 0, updatedAtMs: 0,
+            unavailableReason: error instanceof Error ? error.message : "Unable to load wallet."
+        })),
+        fetchBillingWalletEvents({ customerId: customer.id, limit: 50 }).catch((error) => ({
+            events: [],
+            nextCursor: null,
+            unavailableReason: error instanceof Error ? error.message : "Unable to load billing history."
+        }))
+    ]);
+    return c.html(renderReskinSettings({
+        userId: customer.id,
+        currentAccountId: customer.id,
+        name: customer.name,
+        notice: flash?.notice ?? null,
+        error: flash?.error ?? null,
+        activeTab,
+        openFlockPosterDialog: c.req.query("connect") === "flockposter" || (activeTab === "channels" && !flockPosterApiKey),
+        email: customer.email,
+        isPaidPlan: customer.isPaidPlan,
+        isDeveloper: customer.isDeveloper,
+        about: customer.about,
+        groupchatUrl: customer.groupchatUrl,
+        flockposterApiKey: flockPosterApiKey,
+        emailChannelIconUrl: await getEmailChannelIconUrl(c),
+        emailChannels,
+        vidfarmApiKey: await getVisibleApiKey(customer.id),
+        billingUrl: config.VIDFARM_BILLING_URL?.trim() || null,
+        directorSkill,
+        wallet,
+        walletEvents,
+        flockposterChannels: [],
+        flockposterChannelsError: null,
+        providerKeys: (await listProviderKeysWithSecretsForCustomer(customer.id)).map((entry) => ({
+            id: String(entry.id),
+            provider: String(entry.provider),
+            label: entry.label ? String(entry.label) : null,
+            secret: readStoredSecret(String(entry.secret)),
+            status: String(entry.status),
+            created_at: String(entry.created_at),
+            last_used_at: entry.last_used_at ? String(entry.last_used_at) : null
+        })),
+        attachments: (await serverlessRecords.listUserAttachments(customer.id)).map((attachment) => serializeUserAttachment(c, attachment))
+    }));
+});
 // Library hosts two tabs at distinct URLs (approved projects + mined clips).
-app.get("/reskin/library", (c) => redirect(c, "/reskin/library/approved"));
-app.get("/reskin/library/approved", (c) => c.html(renderReskinLibrary("approved")));
-app.get("/reskin/library/clips", (c) => c.html(renderReskinLibrary("clips")));
-app.get("/reskin/clips", (c) => redirect(c, "/reskin/library/clips")); // merged into Library
-// Discover has three modes at distinct URLs (feed / swipe / categories).
-app.get("/reskin/discover", (c) => redirect(c, "/reskin/discover/feed"));
+app.get("/library", (c) => redirect(c, "/library/approved"));
+const reskinLibraryHandler = async (c, tab) => {
+    const customer = await getPreferredBrowserCustomer(c);
+    if (!customer) {
+        setLoginReturnPath(c, currentPathWithSearch(c));
+        return redirect(c, "/login");
+    }
+    const emailChannels = await getEmailPseudoChannels(customer.id, c);
+    const flockPoster = await getFlockPosterChannels(customer.flockposterApiKey?.trim() || null);
+    const scheduleChannels = [
+        ...emailChannels.map((channel) => ({ id: channel.id, name: channel.name, title: channel.title, handle: channel.handle, platform: channel.platform, status: channel.status, avatarUrl: channel.avatarUrl })),
+        ...flockPoster.channels.map((channel) => ({ id: channel.id, name: channel.title, title: channel.title, handle: channel.handle, platform: channel.platform, status: channel.status, avatarUrl: channel.avatarUrl }))
+    ];
+    const localPosts = await Promise.all((await serverlessRecords.listReadyPosts(customer.id))
+        .filter((post) => (post.source ?? "legacy") === "hyperframes")
+        .filter((post) => post.status === "ready" || post.status === "scheduled")
+        .map(async (post) => ({ ...serializeReadyPost(c, post, { includePrivate: true }), template_id: post.compositionId ?? null })));
+    const posts = await mergeUpstreamReadyPosts(localPosts);
+    return c.html(renderReskinLibrary(tab, {
+        userId: customer.id,
+        currentAccountId: customer.id,
+        name: customer.name,
+        email: customer.email,
+        posts,
+        schedule: { channels: scheduleChannels, connectHref: "/settings?tab=channels&connect=flockposter" },
+        editorChat: null
+    }));
+};
+app.get("/library/approved", (c) => reskinLibraryHandler(c, "approved"));
+app.get("/library/raws", (c) => reskinLibraryHandler(c, "raws"));
+app.get("/library/logs", (c) => reskinLibraryHandler(c, "logs")); // job-runs, folded in
+app.get("/library/clips", (c) => redirect(c, "/library/raws")); // renamed Clips → Raws
+// Discover has three modes selected via ?view= (feed default / swipe / categories).
+// Path segments are avoided because /discover/feed, /discover/swipe/* are JSON APIs.
+app.get("/discover", async (c) => {
+    const view = c.req.query("view");
+    const mode = view === "swipe" || view === "categories" ? view : "feed";
+    const customer = await getOptionalPreferredBrowserCustomer(c);
+    return c.html(renderReskinDiscover(mode, { accountId: customer?.id, isLoggedIn: Boolean(customer) }));
+});
+app.get("/chat", async (c) => {
+    const customer = await getPreferredBrowserCustomer(c);
+    if (!customer) {
+        setLoginReturnPath(c, currentPathWithSearch(c));
+        return redirect(c, "/login");
+    }
+    return c.html(renderReskinChat({
+        userId: customer.id,
+        currentAccountId: customer.id,
+        name: customer.name,
+        email: customer.email,
+        editorChat: await buildChatBrainstormEditorChatBoot({ customer })
+    }));
+});
+// /reskin/inpaint — the "Create Image" masked-image editor (reached from the
+// chat page's studio-mode select). Auth-gated like the other tools.
+app.get("/inpaint", async (c) => {
+    const customer = await getOptionalPreferredBrowserCustomer(c);
+    if (!customer) {
+        setLoginReturnPath(c, currentPathWithSearch(c));
+        return redirect(c, "/login");
+    }
+    return c.html(renderReskinInpaint({ accountId: customer.id, isLoggedIn: true }));
+});
+app.get("/calendar", async (c) => {
+    const customer = await requireBrowserCustomer(c);
+    if (!customer) {
+        setLoginReturnPath(c, currentPathWithSearch(c));
+        return redirect(c, "/login");
+    }
+    const flockPosterApiKey = customer.flockposterApiKey?.trim() || null;
+    const emailChannels = await getEmailPseudoChannels(customer.id, c);
+    return c.html(renderReskinCalendar({
+        userId: customer.id,
+        currentAccountId: customer.id,
+        name: customer.name,
+        email: customer.email,
+        channels: emailChannels.map((channel) => ({
+            id: channel.id,
+            name: channel.title,
+            handle: channel.handle,
+            platform: channel.platform,
+            avatarUrl: channel.avatarUrl,
+            platformIconUrl: channel.platformIconUrl
+        })),
+        posts: [],
+        loadEndpoint: withAccountQuery("/calendar/feed", customer.id),
+        hasFlockPosterKey: Boolean(flockPosterApiKey || emailChannels.length),
+        connectChannelsHref: "/settings?tab=channels&connect=flockposter"
+    }));
+});
+// Job runs were renamed and folded into the Library "Logs" tab.
+app.get("/job-runs", (c) => redirect(c, "/library/logs"));
+app.get("/agency", async (c) => {
+    const customer = await requireBrowserCustomer(c);
+    return c.html(renderReskinAgency({
+        userId: customer?.id ?? null,
+        currentAccountId: customer?.id ?? null,
+        name: customer?.name ?? null,
+        email: customer?.email ?? null,
+        loggedIn: Boolean(customer)
+    }));
+});
+app.get("/pricing", async (c) => {
+    const customer = await getOptionalPreferredBrowserCustomer(c);
+    return c.html(renderReskinPricing({ email: customer?.email ?? "" }));
+});
+app.get("/login", (c) => c.html(renderReskinLogin({ mode: getLoginMode(c.req.query("mode")), routePrefix: "/login" })));
+app.post("/login/password", async (c) => {
+    const mode = getLoginMode(c.req.query("mode"));
+    const routePrefix = "/login";
+    const parsed = passwordLoginSchema.safeParse(await parseFormBody(c));
+    if (!parsed.success)
+        return c.html(renderReskinLogin({ mode, routePrefix, error: "Enter a valid email and password." }), 400);
+    try {
+        const result = await auth.authenticateWithPassword(parsed.data.email, parsed.data.password);
+        if (result.status === "pricing")
+            return redirect(c, "/pricing");
+        setBrowserSession(c, result.customer);
+        return redirect(c, resolvePostLoginRedirect(c, result.customer));
+    }
+    catch (error) {
+        return c.html(renderReskinLogin({ mode, routePrefix, email: parsed.data.email, error: error instanceof Error ? error.message : "Unable to login." }), 401);
+    }
+});
+app.post("/login/otp/request", async (c) => {
+    const mode = getLoginMode(c.req.query("mode"));
+    const routePrefix = "/login";
+    const parsed = otpRequestSchema.safeParse(await parseFormBody(c));
+    if (!parsed.success)
+        return c.html(renderReskinLogin({ mode, routePrefix, error: "Enter a valid email address." }), 400);
+    try {
+        const result = await auth.requestOtp(parsed.data.email);
+        const message = result.delivery === "console" && result.code
+            ? `Local dev mode: OTP is ${result.code}.`
+            : "OTP sent. Enter the code to continue.";
+        return c.html(renderReskinLogin({ mode, routePrefix, email: parsed.data.email, otpSent: true, message }));
+    }
+    catch (error) {
+        return c.html(renderReskinLogin({ mode, routePrefix, email: parsed.data.email, error: error instanceof Error ? error.message : "Unable to send OTP." }), 502);
+    }
+});
+app.post("/login/otp/verify", async (c) => {
+    const mode = getLoginMode(c.req.query("mode"));
+    const routePrefix = "/login";
+    const parsed = otpVerifySchema.safeParse(await parseFormBody(c));
+    if (!parsed.success)
+        return c.html(renderReskinLogin({ mode, routePrefix, error: "Enter the email and 6-digit OTP." }), 400);
+    try {
+        const result = await auth.verifyOtpForBrowserLogin(parsed.data.email, parsed.data.code, parsed.data.name);
+        if (result.status === "pricing") {
+            clearBrowserSession(c, result.customer.id);
+            return redirect(c, "/pricing");
+        }
+        setBrowserSession(c, result.customer);
+        return redirect(c, resolvePostLoginRedirect(c, result.customer));
+    }
+    catch (error) {
+        return c.html(renderReskinLogin({ mode, routePrefix, email: parsed.data.email, otpSent: true, error: error instanceof Error ? error.message : "Unable to verify OTP." }), 401);
+    }
+});
+app.post("/logout", async (c) => {
+    const formBody = await parseFormBody(c);
+    const customer = await requireBrowserCustomer(c, formBody);
+    if (customer) {
+        clearBrowserSession(c, customer.id);
+    }
+    return redirect(c, "/login");
+});
+app.get("/help", async (c) => {
+    const customer = await getOptionalPreferredBrowserCustomer(c);
+    return c.html(renderReskinHelp({
+        account: { isLoggedIn: Boolean(customer), userId: customer?.id ?? null, displayName: customer?.name ?? null, email: customer?.email ?? null },
+        expand: c.req.query("expand") ?? null
+    }));
+});
+// The reskin IS the app now — every old /reskin/* URL 301/302s to its promoted
+// canonical route so existing bookmarks/links keep working. The /reskin gallery
+// (above) is kept as a dev reference; its cards link to the canonical routes.
+app.get("/reskin/settings", (c) => redirect(c, "/settings"));
+app.get("/reskin/library", (c) => redirect(c, "/library/approved"));
+app.get("/reskin/library/approved", (c) => redirect(c, "/library/approved"));
+app.get("/reskin/library/raws", (c) => redirect(c, "/library/raws"));
+app.get("/reskin/library/logs", (c) => redirect(c, "/library/logs"));
+app.get("/reskin/library/clips", (c) => redirect(c, "/library/raws"));
+app.get("/reskin/clips", (c) => redirect(c, "/library/raws"));
+app.get("/reskin/discover", (c) => redirect(c, "/discover"));
 app.get("/reskin/discover/:mode", (c) => {
-    const mode = c.req.param("mode");
-    if (mode !== "feed" && mode !== "swipe" && mode !== "categories")
-        return c.notFound();
-    return c.html(renderReskinDiscover(mode));
-});
-app.get("/reskin/chat", (c) => c.html(renderReskinChat()));
-app.get("/reskin/calendar", (c) => c.html(renderReskinCalendar()));
-app.get("/reskin/job-runs", (c) => c.html(renderReskinJobRuns()));
-app.get("/reskin/agency", (c) => c.html(renderReskinAgency()));
-app.get("/reskin/pricing", (c) => c.html(renderReskinPricing()));
-app.get("/reskin/login", (c) => c.html(renderReskinLogin()));
-app.get("/reskin/help", (c) => c.html(renderReskinHelp()));
+    const m = c.req.param("mode");
+    return redirect(c, m === "swipe" || m === "categories" ? `/discover?view=${m}` : "/discover");
+});
+app.get("/reskin/chat", (c) => redirect(c, "/chat"));
+app.get("/reskin/inpaint", (c) => redirect(c, "/inpaint"));
+app.get("/reskin/calendar", (c) => redirect(c, "/calendar"));
+app.get("/reskin/job-runs", (c) => redirect(c, "/library/logs"));
+app.get("/reskin/agency", (c) => redirect(c, "/agency"));
+app.get("/reskin/pricing", (c) => redirect(c, "/pricing"));
+app.get("/reskin/help", (c) => redirect(c, "/help"));
+app.get("/reskin/login", (c) => redirect(c, "/login"));
 app.get("/discover", async (c) => renderApprovedHomepage(c));
 app.get("/editor/:templateId", async (c) => {
     const templateId = c.req.param("templateId");
@@ -12134,9 +12378,21 @@ app.use(`${USER_PREFIX}/me/*`, requireAuth);
 // is the public HTML gallery page (like /discover vs /discover/feed). Hono's
 // `/clips/*` also matches the bare `/clips`, so let that one path through
 // unauthenticated.
-const isClipsGalleryPage = (c) => c.req.path === CLIPS_PREFIX || c.req.path === `${CLIPS_PREFIX}/`;
-app.use(`${CLIPS_PREFIX}/*`, (c, next) => (isClipsGalleryPage(c) ? next() : requireAuth(c, next)));
-app.use(`${CLIPS_PREFIX}/*`, (c, next) => (isClipsGalleryPage(c) ? next() : captureApiCallHistory(c, next)));
+const isClipsGalleryPage = (c) => c.req.path === RAWS_PREFIX || c.req.path === `${RAWS_PREFIX}/`;
+app.use(`${RAWS_PREFIX}/*`, (c, next) => (isClipsGalleryPage(c) ? next() : requireAuth(c, next)));
+app.use(`${RAWS_PREFIX}/*`, (c, next) => (isClipsGalleryPage(c) ? next() : captureApiCallHistory(c, next)));
+// Deprecated /clips/* → /raws/* alias: transparently redispatch legacy paths so
+// existing skills, editor-chat prompts, and the devcli keep working during the
+// clips→raws rename. Remove once all callers emit /raws.
+const rawsCompatAlias = (c) => {
+    const url = new URL(c.req.url);
+    url.pathname = RAWS_PREFIX + url.pathname.slice(CLIPS_COMPAT_PREFIX.length);
+    // Redispatch through the app with just the rewritten request — do NOT forward
+    // c.executionCtx (its getter throws in the Node adapter when absent).
+    return app.fetch(new Request(url.toString(), c.req.raw));
+};
+app.all(CLIPS_COMPAT_PREFIX, rawsCompatAlias);
+app.all(`${CLIPS_COMPAT_PREFIX}/*`, rawsCompatAlias);
 app.use(AGENCY_PREFIX, requireAuth);
 app.use(`${AGENCY_PREFIX}/*`, requireAuth);
 app.use(`${API_PREFIX}/rate-limit-status`, requireAuth);
@@ -17045,7 +17301,7 @@ function clipKeywordMatch(clip, q) {
 // GET /clips — the Clips gallery, rendered in the same shell as the rest of the
 // frontend and reached via the Library page's "Finished / Clips" toggle. The
 // client fetches /clips/feed with the session cookie (mirrors /discover vs /feed).
-app.get(CLIPS_PREFIX, async (c) => {
+app.get(RAWS_PREFIX, async (c) => {
     const customer = await getPreferredBrowserCustomer(c);
     if (!customer) {
         return redirect(c, "/login");
@@ -17059,7 +17315,7 @@ app.get(CLIPS_PREFIX, async (c) => {
     }));
 });
 // GET /clips/feed — the caller's clip library as JSON (optional ?source, ?q, ?limit).
-app.get(`${CLIPS_PREFIX}/feed`, async (c) => {
+app.get(`${RAWS_PREFIX}/feed`, async (c) => {
     const customer = requireCustomer(c);
     const limit = clampPageLimit(Number(c.req.query("limit") || "60"), 200);
     const q = c.req.query("q")?.trim();
@@ -17072,7 +17328,7 @@ app.get(`${CLIPS_PREFIX}/feed`, async (c) => {
     return c.json({ clips: await Promise.all(clips.map(serializeClip)) });
 });
 // POST /clips/search — hybrid structured + semantic search.
-app.post(`${CLIPS_PREFIX}/search`, async (c) => {
+app.post(`${RAWS_PREFIX}/search`, async (c) => {
     const customer = requireCustomer(c);
     try {
         const body = (await c.req.json().catch(() => ({})));
@@ -17120,7 +17376,7 @@ function normalizeMatchScene(s, index) {
 }
 // POST /clips/match — find the top library clips that could REPLACE one scene.
 // Body: a scene annotation, or {criteria, embedding_text|text, limit}.
-app.post(`${CLIPS_PREFIX}/match`, async (c) => {
+app.post(`${RAWS_PREFIX}/match`, async (c) => {
     const customer = requireCustomer(c);
     try {
         const body = (await c.req.json().catch(() => ({})));
@@ -17143,7 +17399,7 @@ app.post(`${CLIPS_PREFIX}/match`, async (c) => {
 // POST /clips/match-scenes — batch: take a decomposed video's scene annotations
 // and return the top replacement-clip matches per scene (one library read).
 // Body: { scenes | annotations: SceneAnnotation[], limit? }.
-app.post(`${CLIPS_PREFIX}/match-scenes`, async (c) => {
+app.post(`${RAWS_PREFIX}/match-scenes`, async (c) => {
     const customer = requireCustomer(c);
     try {
         const body = (await c.req.json());
@@ -17184,7 +17440,7 @@ app.post(`${CLIPS_PREFIX}/match-scenes`, async (c) => {
 // pipeline runs the hunt and GET /clips/scan/:scanId polls it. Billing is AWS
 // compute only (clip_scan_lambda + step_functions_standard) — the AI spend is
 // the caller's own provider key (BYOK) and is never wallet-billed.
-app.post(`${CLIPS_PREFIX}/scan`, async (c) => {
+app.post(`${RAWS_PREFIX}/scan`, async (c) => {
     const customer = requireCustomer(c);
     try {
         const body = (await c.req.json());
@@ -17503,7 +17759,7 @@ app.post(`${CLIPS_PREFIX}/scan`, async (c) => {
 // GET /clips/scan-options — what the Import Source modal can run a hunt with:
 // which BYOK providers have saved keys, whether a local agent CLI is available
 // (vidfarm serve boxes only), what "auto" resolves to, and where the hunt runs.
-app.get(`${CLIPS_PREFIX}/scan-options`, async (c) => {
+app.get(`${RAWS_PREFIX}/scan-options`, async (c) => {
     const customer = requireCustomer(c);
     const keys = await loadCustomerVisionKeys(customer.id);
     const cloudPipeline = Boolean(config.VIDFARM_CLIP_SCAN_STATE_MACHINE_ARN);
@@ -17748,7 +18004,7 @@ async function mirrorUpstreamClipsToLocal(input) {
     await clipRecords.putScan({ ...(current ?? scan), status: "complete", updated_at: nowIso() });
 }
 // GET /clips/scan/:scanId — poll scan status.
-app.get(`${CLIPS_PREFIX}/scan/:scanId`, async (c) => {
+app.get(`${RAWS_PREFIX}/scan/:scanId`, async (c) => {
     const customer = requireCustomer(c);
     let scan = await clipRecords.getScan(customer.id, c.req.param("scanId"));
     if (!scan)
@@ -17786,17 +18042,17 @@ app.get(`${CLIPS_PREFIX}/scan/:scanId`, async (c) => {
     return c.json({ scan, source });
 });
 // GET /clips/sources — scanned source videos.
-app.get(`${CLIPS_PREFIX}/sources`, async (c) => {
+app.get(`${RAWS_PREFIX}/sources`, async (c) => {
     const customer = requireCustomer(c);
     return c.json({ sources: await clipRecords.listSources(customer.id) });
 });
 // GET /clips/presets — built-in + saved presets.
-app.get(`${CLIPS_PREFIX}/presets`, async (c) => {
+app.get(`${RAWS_PREFIX}/presets`, async (c) => {
     const customer = requireCustomer(c);
     return c.json({ presets: await clipRecords.listPresets(customer.id) });
 });
 // POST /clips/presets — save a custom preset from criteria or a NL query.
-app.post(`${CLIPS_PREFIX}/presets`, async (c) => {
+app.post(`${RAWS_PREFIX}/presets`, async (c) => {
     const customer = requireCustomer(c);
     try {
         const body = (await c.req.json());
@@ -17824,7 +18080,7 @@ app.post(`${CLIPS_PREFIX}/presets`, async (c) => {
     }
 });
 // DELETE /clips/presets/:presetId — delete a saved (non-builtin) preset.
-app.delete(`${CLIPS_PREFIX}/presets/:presetId`, async (c) => {
+app.delete(`${RAWS_PREFIX}/presets/:presetId`, async (c) => {
     const customer = requireCustomer(c);
     const id = c.req.param("presetId");
     if (id.startsWith("preset_") && BUILTIN_CLIP_PRESET_IDS.has(id)) {
@@ -17834,7 +18090,7 @@ app.delete(`${CLIPS_PREFIX}/presets/:presetId`, async (c) => {
     return c.json({ ok: true });
 });
 // GET /clips/:clipId/download — presigned redirect to the clip mp4.
-app.get(`${CLIPS_PREFIX}/:clipId/download`, async (c) => {
+app.get(`${RAWS_PREFIX}/:clipId/download`, async (c) => {
     const customer = requireCustomer(c);
     const clip = await clipRecords.getClip(customer.id, c.req.param("clipId"));
     if (!clip)
@@ -17845,7 +18101,7 @@ app.get(`${CLIPS_PREFIX}/:clipId/download`, async (c) => {
     return redirect(c, url, 302);
 });
 // GET /clips/:clipId — one clip (+ presigned view/thumbnail urls).
-app.get(`${CLIPS_PREFIX}/:clipId`, async (c) => {
+app.get(`${RAWS_PREFIX}/:clipId`, async (c) => {
     const customer = requireCustomer(c);
     const clip = await clipRecords.getClip(customer.id, c.req.param("clipId"));
     if (!clip)
@@ -17853,7 +18109,7 @@ app.get(`${CLIPS_PREFIX}/:clipId`, async (c) => {
     return c.json({ clip: await serializeClip(clip) });
 });
 // DELETE /clips/:clipId — remove a clip record (+ vector).
-app.delete(`${CLIPS_PREFIX}/:clipId`, async (c) => {
+app.delete(`${RAWS_PREFIX}/:clipId`, async (c) => {
     const customer = requireCustomer(c);
     await clipRecords.deleteClip(customer.id, c.req.param("clipId"));
     return c.json({ ok: true });

package/dist/src/cli.js

@@ -168,22 +168,22 @@ Generate AI media and drop it on the timeline (for local coding agents):
                             original vs decomposed (caption-free),
                             non-billing (alias: ghostcut)
 
-Clip hunting (the third library — mine long-form video into a reusable clip store):
-  clips scan <video-path>   Hunt short clips out of a long video.        LOCAL-FIRST: local ffmpeg +
+Raws (the third library — mine long-form video into a reusable raws store):
+  raws scan <video-path>    Hunt short clips out of a long video.        LOCAL-FIRST: local ffmpeg +
                             Detect → tag/transcribe → embed → persist    your local claude/codex CLI
                             to ~/.vidfarm/clips.db.                      (keys are fallback)
     --range "MM:SS-MM:SS"     Only hunt these source windows (repeatable; big cost saver)
     --duration <sec>          Target clip length as a SOFT band (10→5-20s, 30→20-40s)
     --aspect 9:16|16:9|4:3|1:1  Crop clips (also: vertical/horizontal/square) [--crop-focus <f>]
     --no-text                 Prefer scenes WITHOUT captions/on-screen text (selection only)
-    --cloud [--url <url>]     BACKUP: run on the deployed pipeline       → POST /clips/scan (+ poll)
+    --cloud [--url <url>]     BACKUP: run on the deployed pipeline       → POST /raws/scan (+ poll)
                               (uploads to your temp folder — 30-day TTL — bills AWS compute only)
     --dry-run                 Show the estimated cost and stop (over $1 needs --yes/confirm)
-  clips list                List the local clip library                  → GET  /clips
-  clips search "<text>"     Hybrid structured + semantic search          → POST /clips/search
-  clips preset list|run <name>|save <name> --from-query '<...>'          → /clips/presets
-  clips export <ids...> --to <dir>   Copy clip mp4s + metadata out
-                            (run 'vidfarm clips' for the full clips help)
+  raws list                 List the local raws library                  → GET  /raws
+  raws search "<text>"      Hybrid structured + semantic search          → POST /raws/search
+  raws preset list|run <name>|save <name> --from-query '<...>'          → /raws/presets
+  raws export <ids...> --to <dir>   Copy raw mp4s + metadata out
+                            (run 'vidfarm raws' for the full raws help)
 
 Speech (TTS/STT) — LOCAL-FIRST on your own AI key; --cloud is the explicit backup:
   tts "<text>"              Text → narration audio file.                 LOCAL: your OPENAI/GEMINI/
@@ -528,6 +528,7 @@ async function main() {
         case "annotate-file":
             await runAnnotateFileCommand(rest);
             return;
+        case "raws":
         case "clips":
             await runClipsCommand(rest);
             return;
@@ -722,7 +723,7 @@ async function runServeCommand(argv) {
     // render_target="cloud" upstream handoff (the editor's "Render in Cloud").
     process.env.VIDFARM_JOB_STATE_MACHINE_ARN = "";
     // Same trap for clip hunts: a dev-shell .env carrying the staging clip-scan
-    // ARN would route this box's /clips/scan to the cloud Step Functions. serve
+    // ARN would route this box's /raws/scan to the cloud Step Functions. serve
     // hunts are LOCAL-FIRST (local agent CLI / BYOK keys); the upstream cloud is
     // the explicit backup inside the scan route itself.
     process.env.VIDFARM_CLIP_SCAN_STATE_MACHINE_ARN = "";
@@ -2256,7 +2257,7 @@ async function runGenerateCommand(argv) {
     }
 }
 // ── Speech: tts / stt ────────────────────────────────────────────────────────
-// LOCAL-FIRST like `clips scan`: both commands default to running on the
+// LOCAL-FIRST like `raws scan`: both commands default to running on the
 // user's OWN AI key (GEMINI_API_KEY / OPENAI_API_KEY / OPENROUTER_API_KEY or
 // the --*-key flags) via src/services/speech.ts — local ffmpeg demux, direct
 // provider call, no cloud job, no wallet. The REST primitive routes