meetscribe 1.0.0

package/README.md

@@ -0,0 +1,209 @@
+# MeetScribe CLI
+
+Command-line interface for MeetScribe - meeting transcription and protocol generation.
+
+## Installation
+
+```bash
+npm install -g meetscribe
+```
+
+Or use without installing:
+
+```bash
+npx meetscribe transcribe meeting.mp3
+```
+
+## Quick Start
+
+```bash
+# Authenticate
+meetscribe login
+
+# Transcribe a file
+meetscribe transcribe meeting.mp3
+
+# Get result as subtitles
+meetscribe transcribe interview.mp4 --format srt -o subtitles.srt
+
+# List your materials
+meetscribe list
+
+# Get meeting protocol
+meetscribe protocol <material_id>
+```
+
+## Authentication
+
+### Browser Login (recommended)
+
+```bash
+meetscribe login
+```
+
+Opens your browser for authentication via MeetScribe website.
+
+### API Key
+
+```bash
+# Enter key interactively
+meetscribe login --key
+
+# Or set directly
+meetscribe config set-key sk_live_xxx
+
+# Or use environment variable
+export MEETSCRIBE_API_KEY=sk_live_xxx
+```
+
+## Commands
+
+### Transcribe
+
+```bash
+meetscribe transcribe <file> [options]
+
+Options:
+  -l, --language <lang>  Language (ru, en, auto) [default: auto]
+  -s, --speakers <num>   Number of speakers for diarization
+  -o, --output <file>    Save output to file
+  -f, --format <format>  Output format (json, txt, srt, vtt) [default: json]
+  --no-wait              Return job ID immediately
+```
+
+Examples:
+
+```bash
+# Basic transcription
+meetscribe transcribe meeting.mp3
+
+# Russian language, 3 speakers
+meetscribe transcribe meeting.mp4 -l ru -s 3
+
+# Save as subtitles
+meetscribe transcribe interview.mp4 -f srt -o subtitles.srt
+
+# Non-blocking (for scripts)
+JOB_ID=$(meetscribe transcribe large-file.mp4 --no-wait)
+meetscribe status $JOB_ID
+```
+
+### List Materials
+
+```bash
+meetscribe list [options]
+
+Options:
+  -n, --limit <num>      Number of items [default: 20]
+  --status <status>      Filter by status
+  -f, --format <format>  Output format (table, json)
+```
+
+### Get Protocol
+
+```bash
+meetscribe protocol <material_id> [options]
+
+Options:
+  -f, --format <format>  Output format (json, markdown, txt)
+  -o, --output <file>    Save to file
+```
+
+### Configuration
+
+```bash
+# Show config
+meetscribe config show
+
+# Set API key
+meetscribe config set-key <key>
+
+# Set API URL
+meetscribe config set-url <url>
+
+# Set default language
+meetscribe config set-language <ru|en|auto>
+
+# Reset to defaults
+meetscribe config reset
+```
+
+### Account
+
+```bash
+# Show current user
+meetscribe whoami
+
+# Logout
+meetscribe logout
+```
+
+## SDK Usage
+
+```javascript
+import { MeetScribeClient } from 'meetscribe';
+
+const client = new MeetScribeClient({
+  apiKey: process.env.MEETSCRIBE_API_KEY
+});
+
+// Transcribe a file
+const job = await client.transcribe('./meeting.mp3', {
+  language: 'ru',
+  speakers: 3
+});
+
+// Wait for result
+const result = await client.waitForJob(job.data.job_id);
+console.log(result.data.transcript);
+
+// Get protocol
+const protocol = await client.getProtocol(result.data.material_id);
+console.log(protocol.data.action_items);
+```
+
+## CI/CD Example
+
+```yaml
+# GitHub Actions
+jobs:
+  transcribe:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install MeetScribe
+        run: npm install -g meetscribe
+
+      - name: Transcribe
+        env:
+          MEETSCRIBE_API_KEY: ${{ secrets.MEETSCRIBE_API_KEY }}
+        run: |
+          meetscribe transcribe recording.mp3 -f txt -o transcript.txt
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: transcript
+          path: transcript.txt
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Invalid arguments |
+| 3 | Authentication error |
+| 4 | API error |
+| 5 | File not found |
+
+## Links
+
+- [MeetScribe](https://meetscribe.ru)
+- [API Documentation](https://meetscribe.ru/api-docs)
+- [Support](https://t.me/meetscribe_bot)
+
+## License
+
+MIT

package/bin/meetscribe.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { cli } from '../src/cli/index.js';
+
+cli();

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "meetscribe",
+  "version": "1.0.0",
+  "description": "MeetScribe CLI - Meeting transcription and protocol generation",
+  "keywords": [
+    "meetscribe",
+    "transcription",
+    "meeting",
+    "protocol",
+    "speech-to-text",
+    "cli",
+    "whisper"
+  ],
+  "homepage": "https://meetscribe.ru",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/meetscribe/meetscribe-cli"
+  },
+  "license": "MIT",
+  "author": "MeetScribe Team",
+  "type": "module",
+  "main": "src/index.js",
+  "types": "types/index.d.ts",
+  "bin": {
+    "meetscribe": "./bin/meetscribe.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "test": "node --test",
+    "lint": "eslint src/",
+    "start": "node bin/meetscribe.js"
+  },
+  "dependencies": {
+    "axios": "^1.7.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "conf": "^13.0.0",
+    "form-data": "^4.0.0",
+    "mime-types": "^2.1.35",
+    "open": "^10.1.0",
+    "ora": "^8.0.0"
+  },
+  "devDependencies": {
+    "eslint": "^9.0.0"
+  }
+}

package/src/cli/commands/config.js

@@ -0,0 +1,88 @@
+/**
+ * Config command - manage CLI configuration
+ */
+
+import chalk from 'chalk';
+import config, { getAllConfig, setApiKey, clearConfig } from '../utils/config.js';
+import { success, error, info, table } from '../utils/output.js';
+
+export function configCommand(action, value) {
+  switch (action) {
+    case 'show': {
+      console.log();
+      console.log(chalk.bold('MeetScribe CLI Configuration'));
+      console.log();
+
+      const cfg = getAllConfig();
+
+      table(
+        ['Setting', 'Value'],
+        [
+          ['API Key', cfg.apiKey],
+          ['API URL', cfg.apiUrl],
+          ['Default Language', cfg.defaultLanguage],
+          ['Default Format', cfg.defaultFormat],
+          ['Config Path', cfg.configPath]
+        ]
+      );
+      console.log();
+      break;
+    }
+
+    case 'set-key': {
+      if (!value) {
+        error('API key is required');
+        process.exit(1);
+      }
+
+      if (!value.startsWith('sk_live_') && !value.startsWith('sk_test_')) {
+        error('Invalid API key format. Key should start with sk_live_ or sk_test_');
+        process.exit(1);
+      }
+
+      setApiKey(value);
+      success('API key saved');
+      break;
+    }
+
+    case 'set-url': {
+      if (!value) {
+        error('URL is required');
+        process.exit(1);
+      }
+
+      try {
+        new URL(value);
+      } catch {
+        error('Invalid URL format');
+        process.exit(1);
+      }
+
+      config.set('apiUrl', value);
+      success(`API URL set to ${value}`);
+      break;
+    }
+
+    case 'set-language': {
+      const allowed = ['ru', 'en', 'auto'];
+      if (!allowed.includes(value)) {
+        error(`Invalid language. Allowed: ${allowed.join(', ')}`);
+        process.exit(1);
+      }
+
+      config.set('defaultLanguage', value);
+      success(`Default language set to ${value}`);
+      break;
+    }
+
+    case 'reset': {
+      clearConfig();
+      success('Configuration reset to defaults');
+      break;
+    }
+
+    default:
+      error(`Unknown config action: ${action}`);
+      process.exit(1);
+  }
+}

package/src/cli/commands/list.js

@@ -0,0 +1,76 @@
+/**
+ * List command - list transcribed materials
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+
+import { getApiKey, getApiUrl } from '../utils/config.js';
+import { MeetScribeClient } from '../../sdk/client.js';
+import { error, json, table, statusBadge, formatDate } from '../utils/output.js';
+
+export async function listCommand(options, command) {
+  // Check auth
+  const apiKey = command?.parent?.opts()?.apiKey || getApiKey();
+  if (!apiKey) {
+    error('Not authenticated. Run `meetscribe login` first.');
+    process.exit(1);
+  }
+
+  const client = new MeetScribeClient({
+    apiKey,
+    baseUrl: command?.parent?.opts()?.apiUrl || getApiUrl()
+  });
+
+  const spinner = ora('Fetching materials...').start();
+
+  try {
+    const result = await client.listMaterials({
+      perPage: parseInt(options.limit) || 20,
+      status: options.status
+    });
+
+    spinner.stop();
+
+    const materials = result.data?.materials || [];
+    const pagination = result.data?.pagination || {};
+
+    if (options.format === 'json') {
+      json(result.data);
+      return;
+    }
+
+    console.log();
+
+    if (materials.length === 0) {
+      console.log(chalk.dim('No materials found'));
+      console.log();
+      return;
+    }
+
+    console.log(chalk.bold(`Materials (${pagination.total || materials.length} total)`));
+    console.log();
+
+    table(
+      ['ID', 'Title', 'Status', 'Created'],
+      materials.map(m => [
+        m.id?.slice(0, 12) + '...' || '-',
+        (m.title || 'Untitled').slice(0, 40),
+        m.status,
+        m.created_at ? formatDate(m.created_at) : '-'
+      ])
+    );
+
+    console.log();
+
+    if (pagination.total > materials.length) {
+      console.log(chalk.dim(`Showing ${materials.length} of ${pagination.total}. Use --limit to show more.`));
+      console.log();
+    }
+
+  } catch (err) {
+    spinner.fail('Failed to fetch materials');
+    error(err.message);
+    process.exit(1);
+  }
+}

package/src/cli/commands/login.js

@@ -0,0 +1,191 @@
+/**
+ * Login command - authenticate with MeetScribe
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import open from 'open';
+import readline from 'readline';
+
+import config, { setApiKey, getApiKey } from '../utils/config.js';
+import { MeetScribeClient } from '../../sdk/client.js';
+import { success, error, info } from '../utils/output.js';
+
+/**
+ * Interactive prompt for input
+ */
+async function prompt(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * Login via API key input
+ */
+async function loginWithKey() {
+  console.log();
+  info('Enter your API key from https://meetscribe.ru/api-settings');
+  console.log();
+
+  const key = await prompt('API Key: ');
+
+  if (!key) {
+    error('No API key provided');
+    process.exit(1);
+  }
+
+  // Validate key format
+  if (!key.startsWith('sk_live_') && !key.startsWith('sk_test_')) {
+    error('Invalid API key format. Key should start with sk_live_ or sk_test_');
+    process.exit(1);
+  }
+
+  // Test the key
+  const spinner = ora('Validating API key...').start();
+
+  try {
+    const client = new MeetScribeClient({ apiKey: key });
+    await client.getAccount();
+
+    setApiKey(key);
+    spinner.succeed('API key validated and saved');
+
+    console.log();
+    success(`Logged in successfully!`);
+    console.log(chalk.dim(`Config saved to: ${config.path}`));
+  } catch (err) {
+    spinner.fail('Invalid API key');
+    error(err.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Login via browser OAuth
+ */
+async function loginWithBrowser() {
+  const spinner = ora('Creating auth session...').start();
+
+  try {
+    // Create a temporary client without API key
+    const client = new MeetScribeClient({
+      baseUrl: config.get('apiUrl')
+    });
+
+    // Get session
+    const session = await client.createCliSession();
+    const authUrl = session.data?.auth_url;
+    const sessionId = session.data?.session_id;
+
+    if (!authUrl || !sessionId) {
+      spinner.fail('Failed to create auth session');
+      error('Server returned invalid response');
+      process.exit(1);
+    }
+
+    spinner.stop();
+
+    console.log();
+    info('Opening browser for authentication...');
+    console.log();
+    console.log(chalk.dim('If browser does not open, visit:'));
+    console.log(chalk.cyan(authUrl));
+    console.log();
+
+    // Open browser
+    await open(authUrl);
+
+    // Poll for token
+    const pollSpinner = ora('Waiting for authorization...').start();
+
+    const startTime = Date.now();
+    const timeout = 5 * 60 * 1000; // 5 minutes
+
+    while (true) {
+      try {
+        const result = await client.pollCliToken(sessionId);
+
+        if (result.data?.status === 'authorized' && result.data?.api_key) {
+          pollSpinner.succeed('Authorization successful');
+
+          setApiKey(result.data.api_key);
+
+          console.log();
+          success(`Logged in as ${result.data.user?.username || result.data.user?.name || 'user'}`);
+          console.log(chalk.dim(`Config saved to: ${config.path}`));
+
+          return;
+        }
+
+        if (result.data?.status === 'expired') {
+          pollSpinner.fail('Session expired');
+          error('Authorization session has expired. Please try again.');
+          process.exit(1);
+        }
+      } catch (err) {
+        // Ignore errors during polling, keep trying
+      }
+
+      if (Date.now() - startTime > timeout) {
+        pollSpinner.fail('Timeout');
+        error('Authorization timed out. Please try again.');
+        process.exit(1);
+      }
+
+      // Wait before next poll
+      await new Promise(resolve => setTimeout(resolve, 2000));
+    }
+  } catch (err) {
+    spinner.fail('Failed to start auth');
+    error(err.message);
+
+    // Fallback to key input
+    console.log();
+    info('Falling back to API key input...');
+    await loginWithKey();
+  }
+}
+
+/**
+ * Main login command handler
+ */
+export async function loginCommand(options) {
+  // Check if already logged in
+  const existingKey = getApiKey();
+  if (existingKey) {
+    console.log();
+    info('You are already logged in');
+    console.log(chalk.dim(`API Key: ${existingKey.slice(0, 8)}...${existingKey.slice(-4)}`));
+    console.log();
+
+    const answer = await prompt('Do you want to re-login? (y/N): ');
+    if (answer.toLowerCase() !== 'y') {
+      return;
+    }
+  }
+
+  console.log();
+  console.log(chalk.bold('MeetScribe CLI Login'));
+  console.log();
+
+  if (options.key) {
+    await loginWithKey();
+  } else if (options.device) {
+    // Device flow - show code for manual entry
+    console.log();
+    info('Device flow not yet implemented. Using API key input...');
+    await loginWithKey();
+  } else {
+    // Default: browser OAuth
+    await loginWithBrowser();
+  }
+}