@vibeframe/cli 0.27.0

package/dist/utils/tty.js

@@ -0,0 +1,172 @@
+/**
+ * TTY Input Utilities
+ * Handles stdin fallback to /dev/tty for piped environments
+ */
+import { createInterface } from "node:readline";
+import { ReadStream } from "node:tty";
+let ttyStream = null;
+/**
+ * Get a TTY-capable input stream
+ * Falls back to /dev/tty when stdin is piped (e.g., from curl)
+ */
+export function getTTYInputStream() {
+    if (process.stdin.isTTY) {
+        return process.stdin;
+    }
+    // stdin is not a TTY (piped), open /dev/tty directly
+    if (!ttyStream) {
+        try {
+            // Open /dev/tty as a TTY stream
+            const fd = require("fs").openSync("/dev/tty", "r");
+            ttyStream = new ReadStream(fd);
+        }
+        catch {
+            // Fallback to stdin if /dev/tty is not available
+            console.warn("Warning: Cannot open /dev/tty, interactive input may not work");
+            return process.stdin;
+        }
+    }
+    return ttyStream;
+}
+/**
+ * Check if we have TTY input available
+ */
+export function hasTTY() {
+    if (process.stdin.isTTY)
+        return true;
+    // Try to actually open /dev/tty to verify it's accessible
+    try {
+        const fs = require("fs");
+        const fd = fs.openSync("/dev/tty", "r");
+        fs.closeSync(fd);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Close the TTY stream if we opened one
+ */
+export function closeTTYStream() {
+    if (ttyStream) {
+        ttyStream.destroy();
+        ttyStream = null;
+    }
+}
+/**
+ * Create a readline interface with TTY support
+ */
+export function createTTYInterface(options) {
+    const input = getTTYInputStream();
+    return createInterface({
+        input,
+        output: process.stdout,
+        terminal: true,
+        historySize: options?.historySize ?? 100,
+        prompt: options?.prompt ?? "> ",
+    });
+}
+/**
+ * Prompt for input (single line)
+ * Throws in non-TTY environments to prevent hanging.
+ */
+export async function prompt(question) {
+    if (!hasTTY()) {
+        throw new Error("Interactive input required but no TTY available. " +
+            "Use command flags to provide values non-interactively.");
+    }
+    const input = getTTYInputStream();
+    const rl = createInterface({
+        input,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+/**
+ * Prompt for hidden input (password/API key)
+ * Characters are not echoed to terminal
+ */
+export async function promptHidden(question) {
+    const input = getTTYInputStream();
+    return new Promise((resolve) => {
+        process.stdout.write(question);
+        let value = "";
+        // Check if we can use raw mode
+        if (typeof input.setRawMode === "function") {
+            input.setRawMode(true);
+            input.resume();
+            input.setEncoding("utf8");
+            const onData = (char) => {
+                if (char === "\n" || char === "\r" || char === "\u0004") {
+                    // Enter or EOF
+                    input.setRawMode(false);
+                    input.removeListener("data", onData);
+                    process.stdout.write("\n");
+                    resolve(value);
+                }
+                else if (char === "\u0003") {
+                    // Ctrl+C
+                    input.setRawMode(false);
+                    process.stdout.write("\n");
+                    process.exit(1);
+                }
+                else if (char === "\u007F" || char === "\b") {
+                    // Backspace
+                    if (value.length > 0) {
+                        value = value.slice(0, -1);
+                        // Clear character from display
+                        process.stdout.write("\b \b");
+                    }
+                }
+                else if (char >= " ") {
+                    // Printable character (may be multiple chars when pasting)
+                    value += char;
+                    process.stdout.write("*".repeat(char.length)); // Show asterisk for each char
+                }
+            };
+            input.on("data", onData);
+        }
+        else {
+            // Fallback: no raw mode available, input will be visible
+            const rl = createInterface({ input, output: process.stdout });
+            rl.question("", (answer) => {
+                rl.close();
+                resolve(answer);
+            });
+        }
+    });
+}
+/**
+ * Prompt for selection from a list (1-based index)
+ */
+export async function promptSelect(question, options, defaultIndex = 0) {
+    // Display options
+    for (let i = 0; i < options.length; i++) {
+        const marker = i === defaultIndex ? "→" : " ";
+        console.log(`   ${marker} ${i + 1}. ${options[i]}`);
+    }
+    console.log();
+    const answer = await prompt(question);
+    const index = parseInt(answer, 10) - 1;
+    if (isNaN(index) || index < 0 || index >= options.length) {
+        return defaultIndex;
+    }
+    return index;
+}
+/**
+ * Prompt for yes/no confirmation
+ */
+export async function promptConfirm(question, defaultYes = true) {
+    const hint = defaultYes ? "(Y/n)" : "(y/N)";
+    const answer = await prompt(`${question} ${hint}: `);
+    if (answer === "")
+        return defaultYes;
+    return answer.toLowerCase().startsWith("y");
+}
+//# sourceMappingURL=tty.js.map

package/dist/utils/tty.js.map

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

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@vibeframe/cli",
+  "version": "0.27.0",
+  "description": "VibeFrame CLI - natural language video editing from the terminal",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vericontext/vibeframe.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/vericontext/vibeframe/issues"
+  },
+  "keywords": [
+    "vibeframe",
+    "cli",
+    "video-editing",
+    "ai",
+    "ffmpeg",
+    "commander"
+  ],
+  "type": "module",
+  "bin": {
+    "vibe": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    },
+    "./engine": {
+      "import": "./src/engine/index.ts",
+      "types": "./src/engine/index.ts"
+    },
+    "./commands/export": {
+      "import": "./src/commands/export.ts",
+      "types": "./src/commands/export.ts"
+    },
+    "./commands/ai-edit": {
+      "import": "./src/commands/ai-edit.ts",
+      "types": "./src/commands/ai-edit.ts"
+    },
+    "./commands/ai-analyze": {
+      "import": "./src/commands/ai-analyze.ts",
+      "types": "./src/commands/ai-analyze.ts"
+    },
+    "./commands/ai-review": {
+      "import": "./src/commands/ai-review.ts",
+      "types": "./src/commands/ai-review.ts"
+    },
+    "./commands/ai-image": {
+      "import": "./src/commands/ai-image.ts",
+      "types": "./src/commands/ai-image.ts"
+    },
+    "./commands/ai-script-pipeline": {
+      "import": "./src/commands/ai-script-pipeline.ts",
+      "types": "./src/commands/ai-script-pipeline.ts"
+    },
+    "./commands/ai-highlights": {
+      "import": "./src/commands/ai-highlights.ts",
+      "types": "./src/commands/ai-highlights.ts"
+    },
+    "./commands/ai-narrate": {
+      "import": "./src/commands/ai-narrate.ts",
+      "types": "./src/commands/ai-narrate.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "tsx src/index.ts",
+    "lint": "eslint --ext .ts,.tsx src/",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@google/generative-ai": "^0.21.0",
+    "@vibeframe/ai-providers": "workspace:*",
+    "@vibeframe/core": "workspace:*",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "dotenv": "^17.2.3",
+    "image-size": "^2.0.2",
+    "music-metadata": "^11.11.1",
+    "openai": "^4.77.0",
+    "ora": "^8.0.1",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@vitest/coverage-v8": "1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.2"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/src/agent/adapters/claude.ts

@@ -0,0 +1,143 @@
+/**
+ * Claude LLM Adapter with tool_use
+ */
+
+import Anthropic from "@anthropic-ai/sdk";
+import type { LLMAdapter } from "./index.js";
+import type {
+  ToolDefinition,
+  LLMResponse,
+  AgentMessage,
+  ToolCall,
+  LLMProvider,
+} from "../types.js";
+
+export class ClaudeAdapter implements LLMAdapter {
+  readonly provider: LLMProvider = "claude";
+  private client: Anthropic | null = null;
+  private model: string = "claude-sonnet-4-6";
+
+  async initialize(apiKey: string): Promise<void> {
+    this.client = new Anthropic({ apiKey });
+  }
+
+  isInitialized(): boolean {
+    return this.client !== null;
+  }
+
+  setModel(model: string): void {
+    this.model = model;
+  }
+
+  async chat(
+    messages: AgentMessage[],
+    tools: ToolDefinition[]
+  ): Promise<LLMResponse> {
+    if (!this.client) {
+      throw new Error("Claude adapter not initialized");
+    }
+
+    // Extract system message
+    const systemMessage = messages.find((m) => m.role === "system");
+    const systemPrompt = systemMessage?.content || "";
+
+    // Convert messages to Claude format
+    const claudeMessages: Anthropic.MessageParam[] = [];
+
+    for (const msg of messages) {
+      if (msg.role === "system") continue;
+
+      if (msg.role === "user") {
+        claudeMessages.push({
+          role: "user",
+          content: msg.content,
+        });
+      } else if (msg.role === "assistant") {
+        const content: Anthropic.ContentBlockParam[] = [];
+
+        if (msg.content) {
+          content.push({ type: "text", text: msg.content });
+        }
+
+        if (msg.toolCalls) {
+          for (const tc of msg.toolCalls) {
+            content.push({
+              type: "tool_use",
+              id: tc.id,
+              name: tc.name,
+              input: tc.arguments,
+            });
+          }
+        }
+
+        if (content.length > 0) {
+          claudeMessages.push({
+            role: "assistant",
+            content,
+          });
+        }
+      } else if (msg.role === "tool") {
+        claudeMessages.push({
+          role: "user",
+          content: [
+            {
+              type: "tool_result",
+              tool_use_id: msg.toolCallId!,
+              content: msg.content,
+            },
+          ],
+        });
+      }
+    }
+
+    // Convert tools to Claude format
+    const claudeTools: Anthropic.Tool[] = tools.map((tool) => ({
+      name: tool.name,
+      description: tool.description,
+      input_schema: {
+        type: "object" as const,
+        properties: tool.parameters.properties as Record<string, unknown>,
+        required: tool.parameters.required,
+      },
+    }));
+
+    // Make API call
+    const response = await this.client.messages.create({
+      model: this.model,
+      max_tokens: 4096,
+      system: systemPrompt,
+      messages: claudeMessages,
+      tools: claudeTools.length > 0 ? claudeTools : undefined,
+    });
+
+    // Parse response
+    let textContent = "";
+    const toolCalls: ToolCall[] = [];
+
+    for (const block of response.content) {
+      if (block.type === "text") {
+        textContent += block.text;
+      } else if (block.type === "tool_use") {
+        toolCalls.push({
+          id: block.id,
+          name: block.name,
+          arguments: block.input as Record<string, unknown>,
+        });
+      }
+    }
+
+    // Map stop reason
+    let finishReason: LLMResponse["finishReason"] = "stop";
+    if (response.stop_reason === "tool_use") {
+      finishReason = "tool_calls";
+    } else if (response.stop_reason === "max_tokens") {
+      finishReason = "length";
+    }
+
+    return {
+      content: textContent,
+      toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+      finishReason,
+    };
+  }
+}

package/src/agent/adapters/gemini.ts

@@ -0,0 +1,159 @@
+/**
+ * Gemini LLM Adapter with Function Calling
+ */
+
+import { GoogleGenerativeAI, SchemaType, type Content, type Part, type Tool as GeminiTool, type FunctionDeclarationSchemaProperty } from "@google/generative-ai";
+import type { LLMAdapter } from "./index.js";
+import type {
+  ToolDefinition,
+  LLMResponse,
+  AgentMessage,
+  ToolCall,
+  LLMProvider,
+} from "../types.js";
+
+export class GeminiAdapter implements LLMAdapter {
+  readonly provider: LLMProvider = "gemini";
+  private client: GoogleGenerativeAI | null = null;
+  private model: string = "gemini-2.5-flash";
+
+  async initialize(apiKey: string): Promise<void> {
+    this.client = new GoogleGenerativeAI(apiKey);
+  }
+
+  isInitialized(): boolean {
+    return this.client !== null;
+  }
+
+  setModel(model: string): void {
+    this.model = model;
+  }
+
+  async chat(
+    messages: AgentMessage[],
+    tools: ToolDefinition[]
+  ): Promise<LLMResponse> {
+    if (!this.client) {
+      throw new Error("Gemini adapter not initialized");
+    }
+
+    // Extract system message
+    const systemMessage = messages.find((m) => m.role === "system");
+    const systemInstruction = systemMessage?.content;
+
+    // Convert tools to Gemini format
+    const geminiTools: GeminiTool[] = tools.length > 0 ? [{
+      functionDeclarations: tools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        parameters: {
+          type: SchemaType.OBJECT,
+          properties: tool.parameters.properties as Record<string, FunctionDeclarationSchemaProperty>,
+          required: tool.parameters.required,
+        },
+      })),
+    }] : [];
+
+    // Get model with tools
+    const model = this.client.getGenerativeModel({
+      model: this.model,
+      systemInstruction,
+      tools: geminiTools.length > 0 ? geminiTools : undefined,
+    });
+
+    // Convert messages to Gemini format
+    const geminiContents: Content[] = [];
+
+    for (const msg of messages) {
+      if (msg.role === "system") continue;
+
+      if (msg.role === "user") {
+        geminiContents.push({
+          role: "user",
+          parts: [{ text: msg.content }],
+        });
+      } else if (msg.role === "assistant") {
+        const parts: Part[] = [];
+
+        if (msg.content) {
+          parts.push({ text: msg.content });
+        }
+
+        if (msg.toolCalls) {
+          for (const tc of msg.toolCalls) {
+            parts.push({
+              functionCall: {
+                name: tc.name,
+                args: tc.arguments,
+              },
+            });
+          }
+        }
+
+        if (parts.length > 0) {
+          geminiContents.push({
+            role: "model",
+            parts,
+          });
+        }
+      } else if (msg.role === "tool") {
+        // Gemini expects function responses in user turn
+        geminiContents.push({
+          role: "user",
+          parts: [{
+            functionResponse: {
+              name: msg.toolCallId!.split(":::")[0] || "unknown", // Extract function name from id
+              response: { result: msg.content },
+            },
+          }],
+        });
+      }
+    }
+
+    // Make API call
+    const result = await model.generateContent({
+      contents: geminiContents,
+    });
+
+    const response = result.response;
+    const candidate = response.candidates?.[0];
+
+    if (!candidate) {
+      return {
+        content: "",
+        finishReason: "error",
+      };
+    }
+
+    // Parse response
+    let textContent = "";
+    const toolCalls: ToolCall[] = [];
+
+    for (const part of candidate.content.parts) {
+      if ("text" in part && part.text) {
+        textContent += part.text;
+      } else if ("functionCall" in part && part.functionCall) {
+        const fc = part.functionCall;
+        toolCalls.push({
+          id: `${fc.name}:::${Date.now()}`,
+          name: fc.name,
+          arguments: (fc.args || {}) as Record<string, unknown>,
+        });
+      }
+    }
+
+    // Map finish reason
+    let finishReason: LLMResponse["finishReason"] = "stop";
+    if (toolCalls.length > 0) {
+      finishReason = "tool_calls";
+    } else if (candidate.finishReason === "MAX_TOKENS") {
+      finishReason = "length";
+    }
+
+    return {
+      content: textContent,
+      toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+      finishReason,
+    };
+  }
+}

package/src/agent/adapters/index.ts

@@ -0,0 +1,61 @@
+/**
+ * LLM Adapter Interface and Factory
+ */
+
+import type { ToolDefinition, LLMResponse, AgentMessage, LLMProvider } from "../types.js";
+
+/**
+ * Abstract interface for LLM providers
+ */
+export interface LLMAdapter {
+  /** Provider name */
+  readonly provider: LLMProvider;
+
+  /** Initialize the adapter with API key */
+  initialize(apiKey: string): Promise<void>;
+
+  /** Check if adapter is initialized */
+  isInitialized(): boolean;
+
+  /** Send messages with tools and get response */
+  chat(
+    messages: AgentMessage[],
+    tools: ToolDefinition[]
+  ): Promise<LLMResponse>;
+}
+
+/**
+ * Factory for creating LLM adapters
+ */
+export async function createAdapter(provider: LLMProvider): Promise<LLMAdapter> {
+  switch (provider) {
+    case "openai": {
+      const { OpenAIAdapter } = await import("./openai.js");
+      return new OpenAIAdapter();
+    }
+    case "claude": {
+      const { ClaudeAdapter } = await import("./claude.js");
+      return new ClaudeAdapter();
+    }
+    case "gemini": {
+      const { GeminiAdapter } = await import("./gemini.js");
+      return new GeminiAdapter();
+    }
+    case "ollama": {
+      const { OllamaAdapter } = await import("./ollama.js");
+      return new OllamaAdapter();
+    }
+    case "xai": {
+      const { XAIAdapter } = await import("./xai.js");
+      return new XAIAdapter();
+    }
+    default:
+      throw new Error(`Unknown provider: ${provider}`);
+  }
+}
+
+export { OpenAIAdapter } from "./openai.js";
+export { ClaudeAdapter } from "./claude.js";
+export { GeminiAdapter } from "./gemini.js";
+export { OllamaAdapter } from "./ollama.js";
+export { XAIAdapter } from "./xai.js";