studio-lumiere-cli 0.1.4 → 0.1.5

package/dist/studio/types.d.ts

@@ -0,0 +1,155 @@
+export interface Template {
+    id: string;
+    name: string;
+    description: string;
+    visualUrl: string;
+    basePrompt: string;
+    customizationLabel?: string;
+    customizationOptions?: Option[];
+    secondaryCustomizationLabel?: string;
+    secondaryCustomizationOptions?: Option[];
+    tertiaryCustomizationLabel?: string;
+    tertiaryCustomizationOptions?: Option[];
+    quaternaryCustomizationLabel?: string;
+    quaternaryCustomizationOptions?: Option[];
+    isAdminOnly?: boolean;
+}
+export interface Option {
+    id: string;
+    name: string;
+    value: string;
+    visualColor?: string;
+    visualImage?: string;
+    visualSvg?: string;
+}
+export interface Resolution {
+    id: string;
+    label: string;
+    aspectRatio: "1:1" | "3:4" | "4:3" | "9:16" | "16:9";
+    icon: string;
+    instagramUse: string;
+    description: string;
+}
+export interface GenerationState {
+    uploadedImages: File[];
+    selectedTemplate: string | null;
+    selectedDetailId: string | null;
+    selectedSecondaryDetailId: string | null;
+    selectedTertiaryDetailId: string | null;
+    selectedQuaternaryDetailId: string | null;
+    selectedEthnicity: string | null;
+    selectedSkinTone: string | null;
+    selectedHairColor: string | null;
+    selectedBackground: string | null;
+    selectedBackgroundType: string | null;
+    selectedVibe: string | null;
+    selectedResolution: string | null;
+    imageCount: number;
+    selectedOccasion: string | undefined;
+    generatedImages: {
+        id: string;
+        url: string;
+    }[];
+    isGenerating: boolean;
+    regeneratingIndices: number[];
+    upscalingIndices: number[];
+    upscaledIndices: number[];
+    error: string | null;
+    selectedMuseId: string | null;
+}
+export interface Muse {
+    id: string;
+    user_id: string;
+    name: string;
+    image_1_path: string;
+    image_2_path: string;
+    image_3_path: string;
+    source_template_id?: string;
+    source_image_id?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface MuseWithSignedUrls extends Muse {
+    image_1_url: string;
+    image_2_url: string;
+    image_3_url: string;
+    image_1_thumb_url?: string;
+    image_2_thumb_url?: string;
+    image_3_thumb_url?: string;
+}
+export interface MuseCreationState {
+    sourceImage: {
+        id: string;
+        url: string;
+        templateId: string;
+    } | null;
+    savedVariations: Array<{
+        id: string;
+        url: string;
+    }>;
+    currentBatch: Array<{
+        id: string;
+        url: string;
+    }>;
+    isGenerating: boolean;
+    error: string | null;
+}
+export interface EligibleCollectionImage {
+    id: string;
+    url: string;
+    thumbnailUrl?: string;
+    templateId: string;
+    templateName: string;
+    createdAt: string;
+}
+export interface VideoGeneration {
+    id: string;
+    user_id: string;
+    source_image_id: string;
+    source_image_path: string;
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    veo_operation_name?: string;
+    video_path?: string;
+    error_message?: string;
+    prompt: string;
+    parameters: Record<string, any>;
+    resolution: string;
+    aspect_ratio: string;
+    created_at: string;
+    completed_at?: string;
+}
+export interface VideoGenerationWithUrl extends VideoGeneration {
+    video_url?: string;
+}
+export interface TryOnLink {
+    id: string;
+    short_code: string;
+    user_id: string;
+    collection_log_id: string;
+    reference_image_path: string;
+    template_id: string;
+    generation_params: Record<string, any>;
+    click_count: number;
+    try_on_count: number;
+    is_active: boolean;
+    link_type: 'owner' | 'consumer';
+    requires_invite_code: boolean;
+    expires_at?: string;
+    store_url?: string;
+    store_name?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface TryOnLinkWithUrl extends TryOnLink {
+    reference_image_url: string;
+}
+export interface TryOnLinkPublicData {
+    short_code: string;
+    reference_image_url: string;
+    store_name?: string;
+    store_url?: string;
+    template_id: string;
+    is_active: boolean;
+    link_type: 'owner' | 'consumer';
+    requires_invite_code: boolean;
+}

package/dist/studio/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/studio/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/studio/types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -1,53 +1,6 @@
+export type { Template, Option, Resolution } from './studio/types.js';
+export type { OccasionTheme } from './studio/constants.js';
 export type AspectRatio = "1:1" | "3:4" | "4:3" | "9:16" | "16:9";
-export interface Option {
-    id: string;
-    name: string;
-    value: string;
-    visualColor?: string;
-    visualImage?: string;
-}
-export interface Template {
-    id: string;
-    name: string;
-    description: string;
-    visualUrl?: string;
-    basePrompt: string;
-    customizationLabel?: string;
-    customizationOptions?: Option[];
-    secondaryCustomizationLabel?: string;
-    secondaryCustomizationOptions?: Option[];
-    tertiaryCustomizationLabel?: string;
-    tertiaryCustomizationOptions?: Option[];
-    isAdminOnly?: boolean;
-    museEnabled?: boolean;
-    videoEnabled?: boolean;
-}
-export interface Resolution {
-    id: string;
-    label: string;
-    aspectRatio: AspectRatio;
-    icon?: string;
-    description: string;
-    instagramUse: string;
-}
-export interface OccasionTheme {
-    id: string;
-    name: string;
-    icon: string;
-    description: string;
-    autoConfig: {
-        vibe: string;
-        background: string;
-        backgroundType: string;
-    };
-    promptDetails?: {
-        setting: string;
-        atmosphere: string;
-        colorPalette: string;
-        culturalElements: string;
-        styling: string;
-    };
-}
 export interface GenerationSelections {
     templateId: string;
     detailId?: string;

package/package.json

@@ -1,14 +1,20 @@
 {
   "name": "studio-lumiere-cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Local SDK + CLI for Studio Lumiere image and video generation",
   "type": "module",
   "bin": {
     "lumiere": "dist/cli.js"
   },
+  "files": [
+    "dist",
+    "scripts"
+  ],
   "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/cli.ts",
+    "sync": "node scripts/sync-studio.mjs",
+    "build": "npm run sync && tsc",
+    "prepublishOnly": "npm run build",
+    "dev": "npm run sync && tsx src/cli.ts",
     "generate": "tsx examples/generate.ts",
     "muse": "tsx examples/muse.ts",
     "video": "tsx examples/video.ts"

package/scripts/sync-studio.mjs

@@ -0,0 +1,16 @@
+import { cpSync, mkdirSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const studioRoot = resolve(__dirname, "../../studio-lumiere");
+const destDir = resolve(__dirname, "../src/studio");
+
+mkdirSync(destDir, { recursive: true });
+
+const files = ["types.ts", "constants.ts", "promptBuilder.ts"];
+for (const file of files) {
+  cpSync(resolve(studioRoot, file), resolve(destDir, file));
+  console.log(`  synced ${file}`);
+}
+console.log("studio sync complete");

package/.agents/skills/generate-images/SKILL.md

@@ -1,121 +0,0 @@
----
-name: generate-images
-description: Generate images with the Studio Lumiere CLI (npx studio-lumiere-cli); inputs, outputs, and parameters.
----
-
-# Skill: Generate Images (CLI)
-
-This skill covers **CLI usage only** for image generation with Studio Lumiere.
-
----
-
-## Requirements
-
-- Set `GEMINI_API_KEY` in your environment.
-- Optional: set `LUMIERE_OUTPUT_DIR` to change the default output folder (defaults to `outputs`).
-
----
-
-## Quick Start
-
-```bash
-npx studio-lumiere-cli generate \
-  --images ./inputs/ring.jpg \
-  --template hand_model \
-  --detail nail_nude \
-  --ethnicity mena \
-  --skin-tone medium \
-  --hair-color brunette \
-  --background cream_silk \
-  --background-type studio \
-  --vibe clean \
-  --resolution portrait \
-  --quantity 1
-```
-
----
-
-## Inputs
-
-- `--images` (required): Comma-separated local file paths to jewelry images.
-- `--template` (required): Template ID.
-- Optional style/scene parameters (see below).
-- Optional Muse reference (either `--muse-id` or `--muse-images`).
-
----
-
-## Outputs
-
-- Generated images are written under:
-  - `outputs/generations/<timestamp>/` by default, or
-  - `LUMIERE_OUTPUT_DIR/generations/<timestamp>/` if configured.
-- Each run writes a `generation.json` log alongside the images.
-- The CLI prints a JSON result containing `outputImages` and `logPath`.
-
----
-
-## Parameters (generate)
-
-Required:
-- `--images <paths>`: Comma-separated list of input image paths.
-- `--template <id>`: Template ID.
-
-Optional:
-- `--detail <id>`
-- `--secondary-detail <id>`
-- `--tertiary-detail <id>`
-- `--ethnicity <id>`
-- `--skin-tone <id>`
-- `--hair-color <id>`
-- `--background <id>`
-- `--background-type <id>`
-- `--vibe <id>`
-- `--resolution <id>`
-- `--occasion <id>`
-- `--quantity <n>`: Number of outputs (default `1`).
-- `--muse-id <id>`: Use a stored Muse.
-- `--muse-images <paths>`: Comma-separated Muse image paths.
-- `--no-enhance`: Disable prompt enhancement.
-
----
-
-## Find Valid IDs (templates/options)
-
-Use the `list` command to see allowed IDs:
-
-```bash
-npx studio-lumiere-cli list templates
-npx studio-lumiere-cli list ethnicities
-npx studio-lumiere-cli list skin-tones
-npx studio-lumiere-cli list hair-colors
-npx studio-lumiere-cli list backgrounds
-npx studio-lumiere-cli list background-types
-npx studio-lumiere-cli list vibes
-npx studio-lumiere-cli list resolutions
-npx studio-lumiere-cli list occasions
-```
-
----
-
-## Example (multiple images + muse)
-
-```bash
-npx studio-lumiere-cli generate \
-  --images ./inputs/ring.jpg,./inputs/bracelet.jpg \
-  --template hand_model \
-  --detail nail_nude \
-  --resolution portrait \
-  --quantity 2 \
-  --muse-images ./muses/m1.png,./muses/m2.png
-```
-
-End of skill.
-
-## Related Skills
-
-- `C:\Users\karim\Documents\local-lumiere\.agents\skills\generate-video.md`
-- `C:\Users\karim\Documents\local-lumiere\.agents\skills\refine-images.md`
-- `C:\Users\karim\Documents\local-lumiere\.agents\skills\muse-management.md`
-- `C:\Users\karim\Documents\local-lumiere\.agents\skills\tired-girl.md`
-- `C:\Users\karim\Documents\local-lumiere\.agents\skills\image-grid.md`
-- `C:\Users\karim\Documents\local-lumiere\.agents\skills\config-troubleshooting.md`

package/.env.example

@@ -1,2 +0,0 @@
-GEMINI_API_KEY=your_key_here
-LUMIERE_OUTPUT_DIR=outputs

package/AGENTS.md

@@ -1,66 +0,0 @@
-# AI Agent Workflow & Standards
-
-This document outlines the mandatory workflow for all AI agents collaborating on this project. Strictly adhere to these procedures for every brand-new feature or significant task.
-
-## Image Overlay Defaults
-
-- Logo file: `logo-round.png`
-- Placement: `top-left`
-- Scale: `0.08`
-- Margin: `24`
-- Opacity: `0.75`
-- Script: `node .agents/skills/image-overlay/scripts/overlay-image.js`
-
-## 1. Workspace Preparation
-
-*   **Stories Directory:** All documentation and state tracking for a task must reside in the `stories/` folder.
-    *   *Action:* Check if the `stories/` folder exists. If not, create it immediately.
-*   **Git Branching:** All work must be performed on a dedicated feature branch.
-    *   *Naming Convention:* `story/<name-of-story>` (e.g., `story/mobile-ui-fix`).
-    *   *Action:* Create and switch to the new branch before writing any code.
-    *   *IMPORTANT:* all git commands should be executed one at a time. Don't try to chain them in one command. 
-
-## 2. The 5-Step Development Process
-
-We follow a strict iterative cycle. All outputs from these steps must be documented in a **single file** within the `stories/` folder.
-
-**Documentation File Details:**
-*   **Location:** `stories/`
-*   **Naming Convention:** `YYYY-MM-DD-short-descriptive-name.md` (e.g., `2026-01-25-mobile-ui-refactor.md`).
-*   **Format:** Markdown.
-
-### Step 1: Spec
-*   Analyze the user's request and requirements.
-*   Define the scope, goals, and technical constraints.
-*   Write this into the documentation file under a `## Spec` header.
-
-### Step 2: Plan
-*   Break down the implementation into actionable steps.
-*   Identify necessary file changes, dependencies, and architectural impacts.
-*   Write this into the documentation file under a `## Plan` header.
-
-### Step 3: Implement
-*   Write the code according to the approved plan.
-*   Adhere to existing project patterns, style guides, and tech stack conventions.
-*   Log significant actions or decisions in the documentation file under a `## Implementation Log` header.
-
-### Step 4: Review
-*   Self-critique the code.
-*   Run builds, linters, and tests (`npm run build`, `npx tsc --noEmit`, etc.) to verify correctness.
-*   Present the results and any findings to the user.
-*   Write findings in the documentation file under a `## Review` header.
-
-### Step 5: Fix (Iterative Loop)
-*   Address issues found in the Review step or feedback provided by the user.
-*   **Loop:** Repeat Steps 4 (Review) and 5 (Fix) until the user explicitly confirms the code works and is approved.
-*   Log fixes and subsequent reviews in the documentation file.
-
-## 3. Completion & Git Workflow
-
-Once the work is approved by the user (after the Review/Fix loop):
-
-1.  **Stage Files:** `git add` all relevant code files and the story documentation file.
-2.  **Review Changes:** Use the command `/git:review` to generate a summary of staged changes.
-3.  **Commit:** Use the command `/git:commit` to create the commit.
-4.  **Push & PR:** Use the command `/git:commit-push-pr` to push the branch and automatically create/open a Pull Request.
-5.  **Cleanup:** Use the command `/git:clean-gone` to clean up local branches and synchronize with the remote.

package/examples/generate.d.ts

@@ -1 +0,0 @@
-import "dotenv/config";

package/examples/generate.js

@@ -1,28 +0,0 @@
-import "dotenv/config";
-import { generateImages } from "../src/pipelines/generateImages";
-const config = {
-    apiKey: process.env.GEMINI_API_KEY || "",
-    outputDir: process.env.LUMIERE_OUTPUT_DIR || "outputs"
-};
-const run = async () => {
-    if (!config.apiKey)
-        throw new Error("Missing GEMINI_API_KEY");
-    const result = await generateImages(config, {
-        inputImages: ["./inputs/ring.jpg"],
-        quantity: 1,
-        selections: {
-            templateId: "hand_model",
-            detailId: "nail_nude",
-            ethnicityId: "mena",
-            skinToneId: "medium",
-            hairColorId: "brunette",
-            backgroundId: "cream_silk",
-            backgroundTypeId: "studio",
-            vibeId: "clean",
-            resolutionId: "portrait"
-        }
-    });
-    console.log(result);
-};
-run();
-//# sourceMappingURL=generate.js.map

package/examples/generate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate.js","sourceRoot":"","sources":["generate.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE,MAAM,MAAM,GAAkB;IAC5B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;IACxC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS;CACvD,CAAC;AAEF,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;IACrB,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE;QAC1C,WAAW,EAAE,CAAC,mBAAmB,CAAC;QAClC,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE;YACV,UAAU,EAAE,YAAY;YACxB,QAAQ,EAAE,WAAW;YACrB,WAAW,EAAE,MAAM;YACnB,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,UAAU;YACvB,YAAY,EAAE,YAAY;YAC1B,gBAAgB,EAAE,QAAQ;YAC1B,MAAM,EAAE,OAAO;YACf,YAAY,EAAE,UAAU;SACzB;KACF,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC,CAAC;AAEF,GAAG,EAAE,CAAC"}

package/examples/generate.ts

@@ -1,30 +0,0 @@
-import "dotenv/config";
-import { generateImages } from "../src/pipelines/generateImages";
-import { LumiereConfig } from "../src/types";
-
-const config: LumiereConfig = {
-  apiKey: process.env.GEMINI_API_KEY || "",
-  outputDir: process.env.LUMIERE_OUTPUT_DIR || "outputs"
-};
-
-const run = async () => {
-  if (!config.apiKey) throw new Error("Missing GEMINI_API_KEY");
-  const result = await generateImages(config, {
-    inputImages: ["./inputs/ring.jpg"],
-    quantity: 1,
-    selections: {
-      templateId: "hand_model",
-      detailId: "nail_nude",
-      ethnicityId: "mena",
-      skinToneId: "medium",
-      hairColorId: "brunette",
-      backgroundId: "cream_silk",
-      backgroundTypeId: "studio",
-      vibeId: "clean",
-      resolutionId: "portrait"
-    }
-  });
-  console.log(result);
-};
-
-run();

package/examples/muse.d.ts

@@ -1 +0,0 @@
-import "dotenv/config";

package/examples/muse.js

@@ -1,18 +0,0 @@
-import "dotenv/config";
-import { createMuse } from "../src/pipelines/createMuse";
-const config = {
-    apiKey: process.env.GEMINI_API_KEY || "",
-    outputDir: process.env.LUMIERE_OUTPUT_DIR || "outputs"
-};
-const run = async () => {
-    if (!config.apiKey)
-        throw new Error("Missing GEMINI_API_KEY");
-    const result = await createMuse(config, {
-        name: "Editorial Muse",
-        sourceImage: "./inputs/muse_source.jpg",
-        variations: 3
-    });
-    console.log(result);
-};
-run();
-//# sourceMappingURL=muse.js.map

package/examples/muse.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"muse.js","sourceRoot":"","sources":["muse.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,MAAM,MAAM,GAAkB;IAC5B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;IACxC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS;CACvD,CAAC;AAEF,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;IACrB,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;QACtC,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,0BAA0B;QACvC,UAAU,EAAE,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC,CAAC;AAEF,GAAG,EAAE,CAAC"}

package/examples/muse.ts

@@ -1,20 +0,0 @@
-import "dotenv/config";
-import { createMuse } from "../src/pipelines/createMuse";
-import { LumiereConfig } from "../src/types";
-
-const config: LumiereConfig = {
-  apiKey: process.env.GEMINI_API_KEY || "",
-  outputDir: process.env.LUMIERE_OUTPUT_DIR || "outputs"
-};
-
-const run = async () => {
-  if (!config.apiKey) throw new Error("Missing GEMINI_API_KEY");
-  const result = await createMuse(config, {
-    name: "Editorial Muse",
-    sourceImage: "./inputs/muse_source.jpg",
-    variations: 3
-  });
-  console.log(result);
-};
-
-run();

package/examples/video.d.ts

@@ -1 +0,0 @@
-import "dotenv/config";

package/examples/video.js

@@ -1,18 +0,0 @@
-import "dotenv/config";
-import { generateVideo } from "../src/pipelines/generateVideo";
-const config = {
-    apiKey: process.env.GEMINI_API_KEY || "",
-    outputDir: process.env.LUMIERE_OUTPUT_DIR || "outputs"
-};
-const run = async () => {
-    if (!config.apiKey)
-        throw new Error("Missing GEMINI_API_KEY");
-    const result = await generateVideo(config, {
-        prompt: "A cinematic close-up of a model gently turning her head, earrings catching soft light. High-end jewelry commercial aesthetic.",
-        aspectRatio: "9:16",
-        durationSeconds: 5
-    });
-    console.log(result);
-};
-run();
-//# sourceMappingURL=video.js.map

package/examples/video.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"video.js","sourceRoot":"","sources":["video.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,MAAM,MAAM,GAAkB;IAC5B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;IACxC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS;CACvD,CAAC;AAEF,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;IACrB,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE;QACzC,MAAM,EAAE,+HAA+H;QACvI,WAAW,EAAE,MAAM;QACnB,eAAe,EAAE,CAAC;KACnB,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC,CAAC;AAEF,GAAG,EAAE,CAAC"}

package/examples/video.ts

@@ -1,20 +0,0 @@
-import "dotenv/config";
-import { generateVideo } from "../src/pipelines/generateVideo";
-import { LumiereConfig } from "../src/types";
-
-const config: LumiereConfig = {
-  apiKey: process.env.GEMINI_API_KEY || "",
-  outputDir: process.env.LUMIERE_OUTPUT_DIR || "outputs"
-};
-
-const run = async () => {
-  if (!config.apiKey) throw new Error("Missing GEMINI_API_KEY");
-  const result = await generateVideo(config, {
-    prompt: "A cinematic close-up of a model gently turning her head, earrings catching soft light. High-end jewelry commercial aesthetic.",
-    aspectRatio: "9:16",
-    durationSeconds: 5
-  });
-  console.log(result);
-};
-
-run();