varg.ai-sdk 0.1.1 → 0.4.0-alpha.1

package/cli/commands/which.ts

@@ -1,66 +0,0 @@
-/**
- * varg which command
- * inspect an action by scanning filesystem
- */
-
-import { defineCommand } from "citty";
-import { resolve } from "../discover";
-import { box, c, header, separator } from "../ui";
-
-export const whichCmd = defineCommand({
-  meta: {
-    name: "which",
-    description: "inspect what's behind an action",
-  },
-  args: {
-    name: {
-      type: "positional",
-      description: "action name",
-      required: true,
-    },
-  },
-  async run({ args }) {
-    const name = args.name;
-
-    if (!name) {
-      console.error(`${c.red("error:")} action name required`);
-      console.log(`\nusage: ${c.cyan("varg which <name>")}`);
-      process.exit(1);
-    }
-
-    const item = await resolve(name);
-
-    if (!item) {
-      console.error(`${c.red("error:")} '${name}' not found`);
-      console.log(`\nrun ${c.cyan("varg list")} to see available actions`);
-      process.exit(1);
-    }
-
-    const content: string[] = [];
-    content.push("");
-    content.push(`  ${item.description}`);
-    content.push("");
-
-    content.push(header("SCHEMA"));
-    content.push("");
-
-    for (const [key, prop] of Object.entries(item.schema.input.properties)) {
-      const required = item.schema.input.required.includes(key);
-      const reqTag = required ? c.yellow("*") : " ";
-      const defaultVal = prop.default
-        ? c.dim(` (default: ${prop.default})`)
-        : "";
-      content.push(
-        `  ${reqTag}${c.cyan(key.padEnd(12))}${prop.description}${defaultVal}`,
-      );
-    }
-
-    content.push("");
-    content.push(separator());
-    content.push("");
-    content.push(`  run ${c.cyan(`varg run ${name} --info`)} for full options`);
-    content.push("");
-
-    console.log(box(`action: ${name}`, content));
-  },
-});

package/cli/discover.ts

@@ -1,66 +0,0 @@
-/**
- * filesystem-based discovery for varg cli
- * scans action/ directory for modules with meta exports
- */
-
-import { readdir } from "node:fs/promises";
-import { join } from "node:path";
-import type { ActionMeta, Meta } from "./types";
-
-const ACTION_DIR = join(import.meta.dir, "..", "action");
-
-let cachedActions: ActionMeta[] | null = null;
-
-export async function discoverActions(): Promise<ActionMeta[]> {
-  if (cachedActions) return cachedActions;
-
-  const actions: ActionMeta[] = [];
-  const dirs = await readdir(ACTION_DIR);
-
-  for (const dir of dirs) {
-    try {
-      const mod = await import(`../action/${dir}`);
-      if (mod.meta && mod.meta.type === "action") {
-        actions.push(mod.meta);
-      }
-    } catch {
-      // skip directories without valid modules
-    }
-  }
-
-  cachedActions = actions;
-  return actions;
-}
-
-export async function resolve(name: string): Promise<Meta | null> {
-  const actions = await discoverActions();
-
-  // check explicit namespace
-  if (name.startsWith("action/")) {
-    const actionName = name.slice(7);
-    return actions.find((a) => a.name === actionName) || null;
-  }
-
-  // check actions
-  const action = actions.find((a) => a.name === name);
-  if (action) return action;
-
-  return null;
-}
-
-export async function search(query: string): Promise<Meta[]> {
-  const actions = await discoverActions();
-  const q = query.toLowerCase();
-
-  return actions.filter(
-    (a) =>
-      a.name.toLowerCase().includes(q) ||
-      a.description.toLowerCase().includes(q) ||
-      a.inputType.toLowerCase().includes(q) ||
-      a.outputType.toLowerCase().includes(q),
-  );
-}
-
-export async function list(): Promise<Meta[]> {
-  return discoverActions();
-}

package/cli/index.ts

@@ -1,33 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * varg cli
- * ai video infrastructure from your terminal
- */
-
-import { defineCommand, runMain } from "citty";
-import { findCmd } from "./commands/find";
-import { helpCmd } from "./commands/help";
-import { listCmd } from "./commands/list";
-import { runCmd } from "./commands/run";
-import { whichCmd } from "./commands/which";
-
-const main = defineCommand({
-  meta: {
-    name: "varg",
-    version: "0.1.0",
-    description: "ai video infrastructure from your terminal",
-  },
-  subCommands: {
-    run: runCmd,
-    list: listCmd,
-    ls: listCmd,
-    find: findCmd,
-    search: findCmd,
-    which: whichCmd,
-    inspect: whichCmd,
-    help: helpCmd,
-  },
-});
-
-runMain(main);

package/cli/runner.ts

@@ -1,65 +0,0 @@
-/**
- * shared cli runner for actions
- * parses args and calls meta.run()
- */
-
-import type { Meta } from "./types";
-
-export async function runCli(meta: Meta) {
-  const args = process.argv.slice(2);
-
-  if (args[0] === "help" || args[0] === "--help" || args.length === 0) {
-    console.log(`
-${meta.name} - ${meta.description}
-
-usage:
-  bun run action/${meta.name} [options]
-
-options:`);
-
-    for (const [key, prop] of Object.entries(meta.schema.input.properties)) {
-      const req = meta.schema.input.required.includes(key) ? " (required)" : "";
-      const def =
-        prop.default !== undefined ? ` [default: ${prop.default}]` : "";
-      console.log(`  --${key.padEnd(14)} ${prop.description}${req}${def}`);
-    }
-
-    console.log(`
-examples:
-  bun run action/${meta.name} --${meta.schema.input.required[0]} "value"
-`);
-    return;
-  }
-
-  // parse args
-  const options: Record<string, unknown> = {};
-  const firstRequired = meta.schema.input.required[0];
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg?.startsWith("--")) {
-      const key = arg.slice(2);
-      const value = args[++i];
-      options[key] = value;
-    } else if (arg && firstRequired && !options[firstRequired]) {
-      // first positional arg goes to first required field
-      options[firstRequired] = arg;
-    }
-  }
-
-  // validate required
-  for (const req of meta.schema.input.required) {
-    if (!options[req]) {
-      console.error(`error: --${req} is required`);
-      process.exit(1);
-    }
-  }
-
-  try {
-    const result = await meta.run(options);
-    console.log(JSON.stringify(result, null, 2));
-  } catch (err) {
-    console.error(`error: ${err instanceof Error ? err.message : err}`);
-    process.exit(1);
-  }
-}

package/cli/types.ts

@@ -1,49 +0,0 @@
-/**
- * shared types for varg cli
- * actions and models export meta objects conforming to these types
- */
-
-export interface SchemaProperty {
-  type: string;
-  description: string;
-  enum?: (string | number)[];
-  default?: unknown;
-  format?: string;
-}
-
-export interface Schema {
-  input: {
-    type: "object";
-    required: string[];
-    properties: Record<string, SchemaProperty>;
-  };
-  output: {
-    type: string;
-    format?: string;
-    description: string;
-  };
-}
-
-export interface ActionMeta {
-  name: string;
-  type: "action";
-  description: string;
-  inputType: string;
-  outputType: string;
-  schema: Schema;
-  run: (options: Record<string, unknown>) => Promise<unknown>;
-}
-
-export interface ModelMeta {
-  name: string;
-  type: "model";
-  description: string;
-  inputType: string;
-  outputType: string;
-  providers: string[];
-  defaultProvider: string;
-  schema: Schema;
-  run: (options: Record<string, unknown>) => Promise<unknown>;
-}
-
-export type Meta = ActionMeta | ModelMeta;

package/cli/ui.ts

@@ -1,185 +0,0 @@
-/**
- * terminal ui helpers for varg cli
- * beautiful boxes and formatting
- */
-
-const COLORS = {
-  reset: "\x1b[0m",
-  bold: "\x1b[1m",
-  dim: "\x1b[2m",
-  green: "\x1b[32m",
-  yellow: "\x1b[33m",
-  blue: "\x1b[34m",
-  magenta: "\x1b[35m",
-  cyan: "\x1b[36m",
-  red: "\x1b[31m",
-  gray: "\x1b[90m",
-};
-
-export const c = {
-  reset: (s: string) => `${COLORS.reset}${s}${COLORS.reset}`,
-  bold: (s: string) => `${COLORS.bold}${s}${COLORS.reset}`,
-  dim: (s: string) => `${COLORS.dim}${s}${COLORS.reset}`,
-  green: (s: string) => `${COLORS.green}${s}${COLORS.reset}`,
-  yellow: (s: string) => `${COLORS.yellow}${s}${COLORS.reset}`,
-  blue: (s: string) => `${COLORS.blue}${s}${COLORS.reset}`,
-  magenta: (s: string) => `${COLORS.magenta}${s}${COLORS.reset}`,
-  cyan: (s: string) => `${COLORS.cyan}${s}${COLORS.reset}`,
-  red: (s: string) => `${COLORS.red}${s}${COLORS.reset}`,
-  gray: (s: string) => `${COLORS.gray}${s}${COLORS.reset}`,
-};
-
-// strip ansi codes for length calculation
-// biome-ignore lint/complexity/useRegexLiterals: literal triggers noControlCharactersInRegex
-const ANSI_REGEX = new RegExp("\x1b\\[[0-9;]*m", "g");
-function stripAnsi(s: string): string {
-  return s.replace(ANSI_REGEX, "");
-}
-
-// box drawing characters
-const BOX = {
-  topLeft: "┌",
-  topRight: "┐",
-  bottomLeft: "└",
-  bottomRight: "┘",
-  horizontal: "─",
-  vertical: "│",
-  line: "─",
-};
-
-export const WIDTH = 71;
-
-export function box(title: string, content: string[]): string {
-  const lines: string[] = [];
-
-  // top border with title
-  const titlePart = title ? `${BOX.line} ${title} ` : "";
-  const remainingWidth = WIDTH - 2 - stripAnsi(titlePart).length;
-  lines.push(
-    `${BOX.topLeft}${titlePart}${BOX.horizontal.repeat(remainingWidth)}${BOX.topRight}`,
-  );
-
-  // content lines
-  for (const line of content) {
-    const stripped = stripAnsi(line);
-    const padding = WIDTH - 2 - stripped.length;
-    if (padding >= 0) {
-      lines.push(`${BOX.vertical}${line}${" ".repeat(padding)}${BOX.vertical}`);
-    } else {
-      // truncate if too long
-      lines.push(
-        `${BOX.vertical}${line.slice(0, WIDTH - 5)}...${BOX.vertical}`,
-      );
-    }
-  }
-
-  // bottom border
-  lines.push(
-    `${BOX.bottomLeft}${BOX.horizontal.repeat(WIDTH - 2)}${BOX.bottomRight}`,
-  );
-
-  return lines.join("\n");
-}
-
-export function separator(): string {
-  return `  ${c.dim(BOX.horizontal.repeat(WIDTH - 4))}`;
-}
-
-export function header(text: string): string {
-  return c.bold(c.dim(`  ${text}`));
-}
-
-export function row(label: string, value: string, indent = 2): string {
-  const spaces = " ".repeat(indent);
-  const labelWidth = 14;
-  const paddedLabel = label.padEnd(labelWidth);
-  return `${spaces}${c.dim(paddedLabel)}${value}`;
-}
-
-export function success(message: string): string {
-  return `  ${c.green("✓")} ${message}`;
-}
-
-export function error(message: string): string {
-  return `  ${c.red("✗")} ${message}`;
-}
-
-export function spinner(message: string): string {
-  return `  ${c.cyan("◐")} ${message}`;
-}
-
-export function formatDuration(ms: number): string {
-  if (ms < 1000) return `${ms}ms`;
-  const s = Math.round(ms / 1000);
-  return `${s}s`;
-}
-
-export function formatCost(dollars: number): string {
-  return `$${dollars.toFixed(3)}`;
-}
-
-// table formatting for list command
-export interface TableRow {
-  name: string;
-  description: string;
-  providers?: string;
-}
-
-export function table(rows: TableRow[], nameWidth = 16): string[] {
-  const lines: string[] = [];
-
-  for (const row of rows) {
-    const name = row.name.padEnd(nameWidth);
-    const desc = row.description;
-    const providers = row.providers ? c.dim(row.providers) : "";
-
-    if (providers) {
-      lines.push(`  ${c.cyan(name)}${desc.padEnd(30)}${providers}`);
-    } else {
-      lines.push(`  ${c.cyan(name)}${desc}`);
-    }
-  }
-
-  return lines;
-}
-
-// progress output for running commands
-export function runningBox(
-  name: string,
-  params: Record<string, string>,
-  status: "running" | "done" | "error",
-  result?: { output?: string; cost?: number; error?: string; time?: number },
-): string {
-  const content: string[] = [""];
-
-  // params
-  for (const [key, value] of Object.entries(params)) {
-    const displayValue =
-      value.length > 40 ? `"${value.slice(0, 37)}..."` : `"${value}"`;
-    content.push(row(key, displayValue));
-  }
-
-  content.push("");
-
-  // status
-  if (status === "running") {
-    content.push(spinner("generating..."));
-  } else if (status === "done" && result) {
-    content.push(success(`done in ${formatDuration(result.time || 0)}`));
-    content.push("");
-    if (result.output) {
-      content.push(row("output", result.output));
-    }
-    if (result.cost) {
-      content.push(row("cost", formatCost(result.cost)));
-    }
-  } else if (status === "error" && result?.error) {
-    content.push(error("failed"));
-    content.push("");
-    content.push(row("error", result.error));
-  }
-
-  content.push("");
-
-  return box(name, content);
-}

package/index.ts

@@ -1,75 +0,0 @@
-/**
- * varg.ai sdk
- * video generation and editing tools
- */
-
-// re-export external clients
-export { fal } from "@ai-sdk/fal";
-export { replicate } from "@ai-sdk/replicate";
-export { fal as falClient } from "@fal-ai/client";
-export { HiggsfieldClient } from "@higgsfield/client";
-// action exports (excluding meta to avoid conflicts)
-export {
-  type AddCaptionsOptions,
-  addCaptions,
-  type SubtitleStyle,
-} from "./action/captions";
-export {
-  type CreateMontageOptions,
-  createMontage,
-  type EditPipelineOptions,
-  type EditPipelineStep,
-  editPipeline,
-  mergeWithAudio,
-  type PrepareForSocialOptions,
-  prepareForSocial,
-  quickResize,
-  quickTrim,
-} from "./action/edit";
-export {
-  generateWithFal,
-  generateWithSoul,
-  type ImageGenerationResult,
-} from "./action/image";
-export {
-  type LipsyncOptions,
-  lipsync,
-  lipsyncOverlay,
-  lipsyncWav2Lip,
-  type Wav2LipOptions,
-} from "./action/sync";
-export {
-  type TranscribeOptions,
-  type TranscribeResult,
-  transcribe,
-} from "./action/transcribe";
-export {
-  generateVideoFromImage,
-  generateVideoFromText,
-  type VideoGenerationResult,
-} from "./action/video";
-export {
-  type GenerateVoiceOptions,
-  generateVoice,
-  type VoiceResult,
-} from "./action/voice";
-// lib exports - ai-sdk/fal (provider)
-export * as aiSdkFal from "./lib/ai-sdk/fal";
-// lib exports - ai-sdk/replicate (provider)
-export * as aiSdkReplicate from "./lib/ai-sdk/replicate";
-// lib exports - elevenlabs
-export * from "./lib/elevenlabs";
-// lib exports - fal (client)
-export * from "./lib/fal";
-// lib exports - ffmpeg
-export * from "./lib/ffmpeg";
-// lib exports - fireworks
-export * from "./lib/fireworks";
-// lib exports - groq
-export * from "./lib/groq";
-// lib exports - higgsfield
-export * from "./lib/higgsfield";
-// lib exports - replicate
-export * from "./lib/replicate";
-// utilities exports
-export * from "./utilities/s3";

package/lib/README.md

@@ -1,144 +0,0 @@
-# lib/ modules
-
-## two fal implementations
-
-### lib/ai-sdk/fal.ts - ai-sdk provider (recommended for images)
-
-uses `@ai-sdk/fal` with the vercel ai sdk's `experimental_generateImage`
-
-**benefits:**
-- clean, typed api via vercel ai sdk
-- automatic image format handling (uint8array)
-- consistent interface with other ai providers
-- built-in aspect ratio support
-- better for standard image generation
-
-**example:**
-```bash
-bun run lib/ai-sdk/fal.ts generate_image "cyberpunk city" "fal-ai/flux/dev" "16:9"
-```
-
-**code:**
-```typescript
-import { fal } from "@ai-sdk/fal"
-import { experimental_generateImage as generateImage } from "ai"
-
-const { image, providerMetadata } = await generateImage({
-  model: fal.image("fal-ai/flux/dev"),
-  prompt: "beautiful sunset",
-  aspectRatio: "16:9",
-})
-```
-
-### lib/fal.ts - fal client direct (for video & advanced features)
-
-uses `@fal-ai/client` directly with the raw fal api
-
-**benefits:**
-- access to all fal features (video, advanced params)
-- streaming/queue updates
-- full control over api parameters
-- required for video generation (no ai-sdk support yet)
-- **supports local images** - automatically uploads local files to fal storage
-
-**examples:**
-```bash
-# image generation
-bun run lib/fal.ts generate_image "aurora borealis" "fal-ai/flux-pro/v1.1"
-
-# video from url
-bun run lib/fal.ts image_to_video "person talking" "https://image.url" 5
-
-# video from local file (auto-uploads)
-bun run lib/fal.ts image_to_video "ocean waves" "./media/beach.jpg" 10
-```
-
-**code:**
-```typescript
-import { imageToVideo } from "./lib/fal"
-
-// works with both urls and local files
-const result = await imageToVideo({
-  prompt: "person talking",
-  imageUrl: "./local/image.jpg", // or "https://..."
-  duration: 5,
-})
-
-// local files are automatically uploaded to fal storage
-```
-
-## when to use which?
-
-| use case | approach |
-|----------|----------|
-| standard image generation | ai-sdk provider ✓ |
-| video generation | fal client direct ✓ |
-| advanced fal features | fal client direct ✓ |
-| multi-provider app | ai-sdk provider ✓ |
-| custom queue handling | fal client direct ✓ |
-
-## higgsfield.ts
-
-uses `@higgsfield/client` for soul character generation
-
-**features:**
-- generate soul images with custom styles
-- create and manage character references
-- list available soul styles
-- poll for job completion
-
-**example:**
-```bash
-HF_API_KEY=xxx HF_API_SECRET=xxx bun run lib/higgsfield.ts generate_soul "professional headshot"
-```
-
-## elevenlabs.ts
-
-uses `@elevenlabs/elevenlabs-js` for voice, music, and sound effects generation
-
-**features:**
-- text-to-speech with multiple voices
-- music generation from text prompts
-- sound effects generation
-- voice management
-
-**examples:**
-```bash
-# text-to-speech
-bun run lib/elevenlabs.ts tts "hello world" rachel output.mp3
-
-# music generation
-bun run lib/elevenlabs.ts music "upbeat electronic dance music" 30000 music.mp3
-
-# sound effects
-bun run lib/elevenlabs.ts sfx "ocean waves crashing" 5 waves.mp3
-
-# list voices
-bun run lib/elevenlabs.ts voices
-```
-
-**code:**
-```typescript
-import { textToSpeech, generateMusic, generateSoundEffect } from "./lib/elevenlabs"
-
-// voice
-const audio = await textToSpeech({
-  text: "hello world",
-  voiceId: "rachel",
-  outputPath: "output.mp3"
-})
-
-// music
-const music = await generateMusic({
-  prompt: "epic orchestral music",
-  musicLengthMs: 60000,
-  outputPath: "music.mp3"
-})
-
-// sound effects
-const sfx = await generateSoundEffect({
-  text: "thunder and rain",
-  durationSeconds: 10,
-  outputPath: "sfx.mp3"
-})
-```