@unlimiting/unlimitgen 0.1.0

package/dist/utils/auth.js

@@ -0,0 +1,73 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import inquirer from 'inquirer';
+const ENV_KEYS = {
+    gemini: ['GEMINI_API_KEY', 'GOOGLE_API_KEY'],
+    openai: ['OPENAI_API_KEY'],
+    grok: ['XAI_API_KEY']
+};
+const TOKEN_DIR = path.join(os.homedir(), '.config', 'unlimitgen');
+const TOKEN_FILE = path.join(TOKEN_DIR, 'tokens.json');
+export async function resolveApiKey(provider) {
+    const fromEnv = resolveFromEnv(provider);
+    if (fromEnv)
+        return fromEnv;
+    const stored = await getStoredToken(provider);
+    if (stored)
+        return stored;
+    return promptForToken(provider);
+}
+export async function authAndStoreToken(provider) {
+    const token = await promptForToken(provider);
+    await setStoredToken(provider, token);
+}
+export async function getStoredToken(provider) {
+    const store = await readTokenStore();
+    const token = store[provider];
+    return token && token.trim().length > 0 ? token : undefined;
+}
+export async function setStoredToken(provider, token) {
+    await fs.mkdir(TOKEN_DIR, { recursive: true });
+    const current = await readTokenStore();
+    current[provider] = token.trim();
+    await fs.writeFile(TOKEN_FILE, `${JSON.stringify(current, null, 2)}\n`, { mode: 0o600 });
+    await fs.chmod(TOKEN_FILE, 0o600);
+}
+export function getTokenFilePath() {
+    return TOKEN_FILE;
+}
+function resolveFromEnv(provider) {
+    const keys = ENV_KEYS[provider];
+    for (const key of keys) {
+        const value = process.env[key];
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+async function readTokenStore() {
+    try {
+        const raw = await fs.readFile(TOKEN_FILE, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return {};
+        }
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+async function promptForToken(provider) {
+    const answer = await inquirer.prompt([
+        {
+            type: 'password',
+            name: 'token',
+            message: `${provider.toUpperCase()} API 토큰을 입력하세요 (입력 내용 숨김):`,
+            mask: '*',
+            validate: (input) => (input.trim().length > 0 ? true : '토큰이 비어 있습니다.')
+        }
+    ]);
+    return answer.token.trim();
+}

package/dist/utils/io.js

@@ -0,0 +1,40 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function writeBase64File(base64, outDir, prefix, ext) {
+    await ensureDir(outDir);
+    const fileName = `${prefix}-${Date.now()}.${ext}`;
+    const fullPath = path.resolve(outDir, fileName);
+    await fs.writeFile(fullPath, Buffer.from(base64, 'base64'));
+    return fullPath;
+}
+export async function writeBufferFile(buf, outDir, prefix, ext) {
+    await ensureDir(outDir);
+    const fileName = `${prefix}-${Date.now()}.${ext}`;
+    const fullPath = path.resolve(outDir, fileName);
+    await fs.writeFile(fullPath, buf);
+    return fullPath;
+}
+export async function detectMimeTypeFromPath(filePath) {
+    const lower = filePath.toLowerCase();
+    if (lower.endsWith('.png'))
+        return 'image/png';
+    if (lower.endsWith('.jpg') || lower.endsWith('.jpeg'))
+        return 'image/jpeg';
+    if (lower.endsWith('.webp'))
+        return 'image/webp';
+    if (lower.endsWith('.mp4'))
+        return 'video/mp4';
+    throw new Error(`지원하지 않는 파일 확장자입니다: ${filePath}`);
+}

package/dist/utils/options.js

@@ -0,0 +1,39 @@
+export function parseOptionPairs(optionPairs = []) {
+    const out = {};
+    for (const pair of optionPairs) {
+        const idx = pair.indexOf('=');
+        if (idx <= 0) {
+            throw new Error(`잘못된 --option 형식입니다: ${pair}. 예: quality=high`);
+        }
+        const key = pair.slice(0, idx).trim();
+        const raw = pair.slice(idx + 1).trim();
+        out[key] = inferValue(raw);
+    }
+    return out;
+}
+function inferValue(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value === 'null')
+        return null;
+    if (/^-?\d+(\.\d+)?$/.test(value))
+        return Number(value);
+    return value;
+}
+export function mergeOptions(base, jsonString) {
+    if (!jsonString)
+        return base;
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonString);
+    }
+    catch {
+        throw new Error('--options-json 파싱 실패: 유효한 JSON 문자열을 입력해 주세요.');
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('--options-json은 JSON object 여야 합니다.');
+    }
+    return { ...base, ...parsed };
+}

package/dist/utils/parts.js

@@ -0,0 +1,33 @@
+export function parseParts(rawParts) {
+    const parsed = [];
+    for (const raw of rawParts) {
+        const idx = raw.indexOf(':');
+        if (idx <= 0) {
+            throw new Error(`잘못된 --part 형식입니다: ${raw}. 예: text:고양이, image:/tmp/cat.png`);
+        }
+        const type = raw.slice(0, idx).trim();
+        const value = raw.slice(idx + 1).trim();
+        if (!value) {
+            throw new Error(`빈 값은 허용되지 않습니다: ${raw}`);
+        }
+        if (type === 'text') {
+            parsed.push({ type: 'text', value });
+            continue;
+        }
+        if (type === 'image') {
+            parsed.push({ type: 'image', value });
+            continue;
+        }
+        throw new Error(`지원하지 않는 part 타입입니다: ${type}. text/image만 지원합니다.`);
+    }
+    if (parsed.length === 0) {
+        throw new Error('최소 1개의 --part가 필요합니다.');
+    }
+    return parsed;
+}
+export function joinTextParts(parts) {
+    return parts.filter((p) => p.type === 'text').map((p) => p.value).join('\n');
+}
+export function imageParts(parts) {
+    return parts.filter((p) => p.type === 'image').map((p) => p.value);
+}

package/eslint.config.js

@@ -0,0 +1,21 @@
+import tseslint from '@typescript-eslint/eslint-plugin';
+import parser from '@typescript-eslint/parser';
+
+export default [
+  {
+    files: ['src/**/*.ts'],
+    languageOptions: {
+      parser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module'
+      }
+    },
+    plugins: {
+      '@typescript-eslint': tseslint
+    },
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off'
+    }
+  }
+];

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@unlimiting/unlimitgen",
+  "version": "0.1.0",
+  "description": "Unified CLI for image/video generation via Gemini/OpenAI/Grok",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "lint": "eslint . --ext .ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unlimiting-studio/unlimitgen.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/unlimiting-studio/unlimitgen/issues"
+  },
+  "homepage": "https://github.com/unlimiting-studio/unlimitgen#readme",
+  "bin": {
+    "ugen": "dist/cli.js"
+  },
+  "dependencies": {
+    "@google/genai": "^1.42.0",
+    "commander": "^14.0.3",
+    "inquirer": "^13.2.5",
+    "openai": "^6.22.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "eslint": "^10.0.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/skills/ugen/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: ugen
+description: "Unified CLI workflow for generating images and videos with Gemini, OpenAI, and Grok(xAI) via `ugen`. Use for tasks that require model discovery (`ugen models`), ordered multi-input composition (`--part text:...` and `--part image:...`), provider-specific option tuning (`--option`, `--options-json`), secure token handling (env or password prompt), and troubleshooting generation failures/timeouts."
+---
+
+`ugen` 작업을 수행할 때 아래 순서를 그대로 따른다.
+
+## 목표
+
+- 실행 가능한 생성 명령을 빠르게 만든다.
+- 입력 순서를 보존한 멀티 파트 프롬프트를 구성한다.
+- 실패 시 원인을 분리하고 즉시 재시도 가능한 수정안을 만든다.
+
+## 표준 절차
+
+1. 모델과 모달리티를 확인한다.
+2. 토큰 제공 방식을 확정한다.
+3. 최소 입력으로 1회 성공시킨다.
+4. 옵션을 추가하며 품질을 튜닝한다.
+5. 실패 케이스를 점검하고 재현 가능한 해결 명령을 남긴다.
+
+## 1) 모델 확인
+
+먼저 모델 범위를 고정한다.
+
+```bash
+ugen models
+ugen models --provider gemini --modality image
+ugen models --provider openai --modality video
+```
+
+모델 ID는 출력된 값을 그대로 사용한다.
+
+## 2) 인증 처리
+
+환경변수가 있으면 자동 사용한다. 없으면 `password` 프롬프트로 입력한다.
+
+- Gemini: `GEMINI_API_KEY` 또는 `GOOGLE_API_KEY`
+- OpenAI: `OPENAI_API_KEY`
+- Grok(xAI): `XAI_API_KEY`
+
+예시:
+
+```bash
+export OPENAI_API_KEY="***"
+ugen models --provider openai
+```
+
+## 3) 입력 구성 규칙
+
+`--part`는 반복 가능하며 순서가 그대로 전달된다.
+
+- `text:...`
+- `image:/path/to/file.png`
+
+규칙:
+
+- 텍스트 지시는 짧은 단위로 분해한다.
+- 이미지 경로는 실행 전에 존재 여부를 확인한다.
+- 여러 입력이 필요한 경우 `text/image`를 의도한 순서대로 배치한다.
+
+예시:
+
+```bash
+--part text:"구도 유지" image:./ref1.png --part text:"색감만 반영" image:./ref2.jpg
+```
+
+## 4) 이미지 생성 기본 템플릿
+
+텍스트 기반:
+
+```bash
+ugen generate image \
+  --provider openai \
+  --model gpt-image-1.5 \
+  --part text:"눈 오는 밤 네온 거리의 고양이" \
+  --option size=1024x1024 quality=high
+```
+
+텍스트+이미지 기반:
+
+```bash
+ugen generate image \
+  --provider gemini \
+  --model gemini-2.5-flash-image-preview \
+  --part text:"구도를 유지" image:./ref.png text:"색감을 따뜻하게"
+```
+
+## 5) 비디오 생성 기본 템플릿
+
+```bash
+ugen generate video \
+  --provider openai \
+  --model sora-2 \
+  --part text:"비 오는 도시를 달리는 고양이" image:./first-frame.png \
+  --option seconds=8 size=1280x720
+```
+
+긴 작업은 타임아웃/폴링을 조정한다.
+
+```bash
+ugen generate video ... --timeout-ms 1800000 --poll-interval-ms 7000
+```
+
+## 6) 옵션 전달 규칙
+
+단순 키-값은 `--option`, 복잡한 구조는 `--options-json`을 사용한다.
+
+```bash
+ugen generate video \
+  --provider gemini \
+  --model veo-3.1-generate-preview \
+  --part text:"해변 일출 타임랩스" \
+  --option durationSeconds=8 aspectRatio=16:9 \
+  --options-json '{"numberOfVideos":1,"generateAudio":false}'
+```
+
+해석 규칙:
+
+- `true/false/null` 자동 타입 변환
+- 숫자 문자열 자동 숫자 변환
+- `--options-json` 값이 최종 병합값으로 적용
+
+## 7) 트러블슈팅
+
+### `지원하지 않는 provider`
+
+- `gemini|openai|grok` 중 하나로 수정한다.
+
+### `이미지 파일을 찾을 수 없습니다`
+
+- 파일 경로 오타를 수정한다.
+- 상대경로 대신 절대경로로 재시도한다.
+
+### 인증 실패 (`401`, `permission denied`)
+
+- provider와 토큰 종류를 다시 맞춘다.
+- 오래된 환경변수를 제거하고 다시 입력한다.
+
+### 비디오 생성 지연/타임아웃
+
+- `--timeout-ms`를 늘린다.
+- `seconds`, `size`, `resolution`을 낮춘다.
+
+### 모델이 입력 타입 거부
+
+- `ugen models --provider ... --modality ...`로 지원 입력을 재확인한다.
+- text-only 모델에는 이미지 파트를 제거한다.
+
+## 8) 결과 확인 체크리스트
+
+- 명령이 `완료: provider/modality/model`을 출력하는지 확인한다.
+- 출력 파일 경로가 `outputs/` 아래 생성됐는지 확인한다.
+- 실패 시 오류 메시지와 함께 재실행 가능한 명령을 남긴다.
+
+## 9) 빠른 치트시트
+
+```bash
+ugen models
+ugen generate image --provider openai --model gpt-image-1.5 --part text:"..."
+ugen generate video --provider openai --model sora-2 --part text:"..." image:./first.png
+ugen generate image --provider gemini --model imagen-4.0-generate-001 --part text:"..." --options-json '{"numberOfImages":2}'
+```

package/src/cli.ts

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { MODEL_CATALOG } from './core/catalog.js';
+import { generateImage, generateVideo } from './core/generate.js';
+import { Modality, Provider } from './core/types.js';
+import { authAndStoreToken, getTokenFilePath, resolveApiKey } from './utils/auth.js';
+import { mergeOptions, parseOptionPairs } from './utils/options.js';
+import { parseParts } from './utils/parts.js';
+
+const program = new Command();
+
+program
+  .name('ugen')
+  .description('Gemini/OpenAI/Grok 이미지/비디오 생성 CLI')
+  .version('0.1.0');
+
+program
+  .command('models')
+  .description('지원 모델과 옵션 확인')
+  .option('-p, --provider <provider>', 'provider 필터 (gemini|openai|grok)')
+  .option('-m, --modality <modality>', 'modality 필터 (image|video)')
+  .action((opts: { provider?: Provider; modality?: Modality }) => {
+    const items = MODEL_CATALOG.filter((item) => (!opts.provider || item.provider === opts.provider) && (!opts.modality || item.modality === opts.modality));
+
+    if (items.length === 0) {
+      console.log('조건에 맞는 모델이 없습니다.');
+      return;
+    }
+
+    for (const item of items) {
+      console.log(`- [${item.provider}/${item.modality}] ${item.model}`);
+      console.log(`  입력지원: text=${item.supportsText}, image=${item.supportsImageInput}`);
+      console.log(`  옵션: ${item.options.join(', ')}`);
+      if (item.notes) {
+        console.log(`  비고: ${item.notes}`);
+      }
+    }
+  });
+
+const generate = program.command('generate').description('콘텐츠 생성');
+
+program
+  .command('auth')
+  .description('provider 토큰을 비밀번호 입력으로 저장')
+  .requiredOption('-p, --provider <provider>', 'gemini|openai|grok')
+  .action(async (opts: { provider: Provider }) => {
+    const provider = assertProvider(opts.provider);
+    await authAndStoreToken(provider);
+    console.log(`저장 완료: ${provider} 토큰`);
+    console.log(`저장 위치: ${getTokenFilePath()}`);
+  });
+
+generate
+  .command('image')
+  .description('이미지 생성')
+  .requiredOption('-p, --provider <provider>', 'gemini|openai|grok')
+  .requiredOption('-m, --model <model>', '모델 ID')
+  .requiredOption('--part <part...>', '순서 보장 입력. 예: text:고양이 image:./cat.png text:배경은 숲')
+  .option('-o, --out <dir>', '출력 폴더', './outputs')
+  .option('--option <pair...>', '모델 옵션 key=value. 예: quality=high size=1024x1024')
+  .option('--options-json <json>', '모델 옵션 JSON 문자열')
+  .action(async (opts: { provider: Provider; model: string; part: string[]; out: string; option?: string[]; optionsJson?: string }) => {
+    const provider = assertProvider(opts.provider);
+    const apiKey = await resolveApiKey(provider);
+    const parts = parseParts(opts.part);
+    const options = mergeOptions(parseOptionPairs(opts.option), opts.optionsJson);
+
+    const result = await generateImage(
+      {
+        provider,
+        model: normalizeModel(opts.model),
+        parts,
+        outDir: opts.out,
+        options
+      },
+      apiKey
+    );
+
+    printResult(result);
+  });
+
+generate
+  .command('video')
+  .description('동영상 생성')
+  .requiredOption('-p, --provider <provider>', 'gemini|openai|grok')
+  .requiredOption('-m, --model <model>', '모델 ID')
+  .requiredOption('--part <part...>', '순서 보장 입력. 예: text:광고 영상 image:./first-frame.png')
+  .option('-o, --out <dir>', '출력 폴더', './outputs')
+  .option('--option <pair...>', '모델 옵션 key=value. 예: seconds=8 size=1280x720')
+  .option('--options-json <json>', '모델 옵션 JSON 문자열')
+  .option('--poll-interval-ms <ms>', '상태 폴링 주기(ms)', '5000')
+  .option('--timeout-ms <ms>', '타임아웃(ms)', '900000')
+  .action(async (opts: { provider: Provider; model: string; part: string[]; out: string; option?: string[]; optionsJson?: string; pollIntervalMs: string; timeoutMs: string }) => {
+    const provider = assertProvider(opts.provider);
+    const apiKey = await resolveApiKey(provider);
+    const parts = parseParts(opts.part);
+    const options = mergeOptions(parseOptionPairs(opts.option), opts.optionsJson);
+
+    const result = await generateVideo(
+      {
+        provider,
+        model: normalizeModel(opts.model),
+        parts,
+        outDir: opts.out,
+        options,
+        pollIntervalMs: Number(opts.pollIntervalMs),
+        timeoutMs: Number(opts.timeoutMs)
+      },
+      apiKey
+    );
+
+    printResult(result);
+  });
+
+program.parseAsync(process.argv).catch((error: unknown) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`오류: ${message}`);
+  process.exit(1);
+});
+
+function assertProvider(input: string): Provider {
+  if (input === 'gemini' || input === 'openai' || input === 'grok') {
+    return input;
+  }
+  throw new Error(`지원하지 않는 provider: ${input}`);
+}
+
+function printResult(result: { provider: string; model: string; modality: string; outputs: string[]; meta?: Record<string, unknown> }): void {
+  console.log(`완료: ${result.provider}/${result.modality}/${result.model}`);
+  if (result.outputs.length === 0) {
+    console.log('출력 파일이 없습니다. (모델 응답에 바이너리 결과 미포함)');
+  } else {
+    for (const output of result.outputs) {
+      console.log(`- ${output}`);
+    }
+  }
+  if (result.meta) {
+    console.log(`meta: ${JSON.stringify(result.meta)}`);
+  }
+}
+
+function normalizeModel(model: string): string {
+  const lowered = model.toLowerCase();
+  const fromCatalog = MODEL_CATALOG.find((item) => item.model.toLowerCase() === lowered);
+  return fromCatalog?.model ?? model;
+}