@okrapdf/cli 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,163 @@
+# @okrapdf/cli
+
+Command-line interface for [OkraPDF](https://okrapdf.com) - extract tables from PDFs.
+
+## Installation
+
+```bash
+npm install -g @okrapdf/cli
+```
+
+Or use with npx:
+
+```bash
+npx @okrapdf/cli jobs list
+```
+
+## Quick Start
+
+```bash
+# Create a .env file with your API key
+echo "OKRA_API_KEY=okra_xxxxxxxxxxxx" > .env
+
+# Or create ~/.okra for global config
+echo "OKRA_API_KEY=okra_xxxxxxxxxxxx" > ~/.okra
+
+# List your documents
+okra docs list
+
+# List extraction jobs  
+okra jobs list
+
+# Extract tables from a PDF
+okra extract invoice.pdf -o json
+```
+
+Get your API key from [okrapdf.com/settings/api-keys](https://okrapdf.com/settings/api-keys).
+
+## Configuration
+
+The CLI looks for your API key in this order:
+
+1. `OKRA_API_KEY` environment variable
+2. `.env` file in current directory
+3. `.okra` file in current directory
+4. `~/.okra` file in home directory
+5. `~/.config/okrapdf/config.json`
+
+Example `.env` or `.okra` file:
+
+```bash
+OKRA_API_KEY=okra_xxxxxxxxxxxx
+OKRA_BASE_URL=https://okrapdf.com
+```
+
+## Commands
+
+### Documents
+
+```bash
+okra docs list               # List all documents
+okra docs upload <file>      # Upload a PDF
+okra docs get <uuid>         # Get document details
+okra docs delete <uuid>      # Delete a document
+```
+
+### Jobs
+
+```bash
+okra jobs list               # List extraction jobs
+okra jobs create <file>      # Create extraction job
+okra jobs get <job-id>       # Get job status
+okra jobs wait <job-id>      # Wait for completion
+okra jobs results <job-id>   # Get extraction results
+```
+
+### Tables
+
+```bash
+okra tables list <doc-uuid>  # List extracted tables
+okra tables get <table-id>   # Get table content
+okra tables export <id>      # Export to CSV/JSON
+```
+
+### Shortcuts
+
+```bash
+okra extract <file>          # Upload + extract + wait (all-in-one)
+```
+
+## Output Formats
+
+All commands support `-o, --output`:
+
+- `table` (default) - Human-readable tables
+- `json` - Machine-readable JSON
+- `csv` - CSV format
+
+```bash
+# JSON for scripting
+okra jobs list -o json | jq '.[].id'
+
+# Quiet mode for piping
+okra extract doc.pdf -o json -q > results.json
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `OKRA_API_KEY` | API key (required) |
+| `OKRA_BASE_URL` | Custom API URL (for self-hosted) |
+| `OKRA_OUTPUT_FORMAT` | Default output format |
+
+## Examples
+
+### Batch Processing
+
+```bash
+for pdf in *.pdf; do
+  okra extract "$pdf" -o json > "${pdf%.pdf}.json"
+done
+```
+
+### CI/CD Integration
+
+```bash
+# Extract and check for tables
+RESULT=$(okra extract report.pdf -o json -q)
+TABLE_COUNT=$(echo "$RESULT" | jq '.tables | length')
+echo "Found $TABLE_COUNT tables"
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Invalid arguments |
+| 3 | Authentication error |
+| 4 | Resource not found |
+| 5 | Rate limited |
+
+## Development
+
+```bash
+git clone https://github.com/steventsao/okrapdf
+cd okrapdf/packages/cli
+npm install
+npm run build
+npm link
+okra --help
+```
+
+## License
+
+MIT
+
+## Links
+
+- [OkraPDF](https://okrapdf.com)
+- [API Docs](https://docs.okrapdf.com/api)
+- [GitHub](https://github.com/steventsao/okrapdf/tree/main/packages/cli)

package/dist/cli.d.ts

@@ -0,0 +1,19 @@
+/**
+ * CLI setup and configuration
+ *
+ * Designed for both human users and AI coding agents.
+ * - Predictable commands and flags
+ * - Machine-readable JSON output (-o json)
+ * - Composable with pipes (stdin/stdout)
+ * - Environment variable configuration
+ */
+import { Command } from 'commander';
+/**
+ * Create and configure the CLI program
+ */
+export declare function createProgram(): Command;
+/**
+ * Run the CLI with error handling
+ */
+export declare function run(argv?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA6GvC;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtE"}

package/dist/cli.js

@@ -0,0 +1,175 @@
+/**
+ * CLI setup and configuration
+ *
+ * Designed for both human users and AI coding agents.
+ * - Predictable commands and flags
+ * - Machine-readable JSON output (-o json)
+ * - Composable with pipes (stdin/stdout)
+ * - Environment variable configuration
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createAuthCommand } from './commands/auth.js';
+import { createDocsCommand } from './commands/docs.js';
+import { createJobsCommand } from './commands/jobs.js';
+import { createTablesCommand } from './commands/tables.js';
+import { createChatCommand } from './commands/chat.js';
+import { createExtractCommand, createRunCommand } from './commands/shortcuts.js';
+import { createProcessorsCommand } from './commands/processors.js';
+import { createTemplatesCommand } from './commands/templates.js';
+import { createLogsCommand } from './commands/logs.js';
+import { createReviewCommand } from './commands/review.js';
+import { OkraApiError, EXIT_CODES } from './lib/client.js';
+import { error } from './lib/output.js';
+// Package version
+const VERSION = '0.1.0';
+/**
+ * Create and configure the CLI program
+ */
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('okra')
+        .description('OkraPDF CLI - Extract tables and chat with PDF documents')
+        .version(VERSION, '-v, --version', 'Output the version number')
+        .option('-q, --quiet', 'Suppress non-essential output (ideal for piping)')
+        .option('--json', 'Shorthand for -o json (machine-readable output)')
+        .option('--no-color', 'Disable colored output');
+    // Core commands
+    program.addCommand(createAuthCommand());
+    program.addCommand(createDocsCommand());
+    program.addCommand(createJobsCommand());
+    program.addCommand(createTablesCommand());
+    program.addCommand(createReviewCommand());
+    program.addCommand(createChatCommand());
+    // Shortcut commands (most common workflows)
+    program.addCommand(createExtractCommand());
+    program.addCommand(createRunCommand());
+    // Introspection commands (vendor-agnostic architecture)
+    program.addCommand(createProcessorsCommand());
+    program.addCommand(createTemplatesCommand());
+    program.addCommand(createLogsCommand());
+    // Handle global --json flag
+    program.hook('preAction', (thisCommand) => {
+        const opts = thisCommand.opts();
+        if (opts.json) {
+            process.env.OKRA_OUTPUT_FORMAT = 'json';
+        }
+        if (opts.quiet) {
+            process.env.OKRA_QUIET = '1';
+        }
+    });
+    // Add examples to help
+    program.addHelpText('after', `
+${chalk.bold('Quick Start:')}
+
+  ${chalk.dim('# Set API key (or use OKRA_API_KEY env var)')}
+  $ export OKRA_API_KEY=okra_xxxx
+
+  ${chalk.dim('# Extract tables from a PDF')}
+  $ okra extract invoice.pdf
+
+  ${chalk.dim('# Ask a question about a document')}
+  $ okra run report.pdf "What is the total revenue?"
+
+${chalk.bold('For AI Agents (Machine-Readable Output):')}
+
+  ${chalk.dim('# Get tables as JSON (for building presentations, reports)')}
+  $ okra extract document.pdf --json --quiet
+
+  ${chalk.dim('# Get document list as JSON for processing')}
+  $ okra docs list -o json | jq '.[].uuid'
+
+  ${chalk.dim('# Extract with specific processor')}
+  $ okra jobs create document.pdf -p gemini --wait -o json
+
+  ${chalk.dim('# Pipe table data to other tools')}
+  $ okra tables get <table-id> -o csv | csvkit ...
+
+${chalk.bold('Common Workflows:')}
+
+  ${chalk.dim('# Upload + extract + get results')}
+  $ okra extract invoice.pdf -o json > results.json
+
+  ${chalk.dim('# Use a template for structured extraction')}
+  $ okra extract receipt.pdf --template receipt -o json
+
+  ${chalk.dim('# Interactive document chat')}
+  $ okra chat <document-uuid>
+
+  ${chalk.dim('# List available processors')}
+  $ okra processors list
+
+  ${chalk.dim('# View job history')}
+  $ okra logs
+
+${chalk.bold('Review & Verification:')}
+
+  ${chalk.dim('# List tables sorted by most tables')}
+  $ okra review docs --sort tables
+
+  ${chalk.dim('# List tables with filtering')}
+  $ okra review list <doc-uuid> --status pending --sort confidence
+
+  ${chalk.dim('# Open document in browser (like gh --web)')}
+  $ okra review list <doc-uuid> --web
+  $ okra review open <doc-uuid>
+
+${chalk.bold('Environment Variables:')}
+
+  OKRA_API_KEY        API key (required)
+  OKRA_BASE_URL       Base URL (default: https://okrapdf.com)
+  OKRA_OUTPUT_FORMAT  Default output: table, json, csv (default: table)
+
+${chalk.bold('More Information:')}
+
+  Documentation: ${chalk.cyan('https://docs.okrapdf.com/cli')}
+  API Reference: ${chalk.cyan('https://docs.okrapdf.com/api')}
+  GitHub: ${chalk.cyan('https://github.com/steventsao/okrapdf')}
+`);
+    return program;
+}
+/**
+ * Run the CLI with error handling
+ */
+export async function run(argv = process.argv) {
+    const program = createProgram();
+    try {
+        await program.parseAsync(argv);
+    }
+    catch (err) {
+        handleError(err);
+    }
+}
+/**
+ * Global error handler
+ */
+function handleError(err) {
+    if (err instanceof OkraApiError) {
+        error(err.message);
+        if (err.details) {
+            console.error(chalk.dim(JSON.stringify(err.details, null, 2)));
+        }
+        process.exit(err.exitCode);
+    }
+    if (err instanceof Error) {
+        // Check for common errors
+        if (err.message.includes('ENOTFOUND') || err.message.includes('ECONNREFUSED')) {
+            error('Unable to connect to OkraPDF. Check your internet connection.');
+            process.exit(EXIT_CODES.GENERAL_ERROR);
+        }
+        if (err.message.includes('ETIMEDOUT')) {
+            error('Request timed out. Try again later.');
+            process.exit(EXIT_CODES.GENERAL_ERROR);
+        }
+        error(err.message);
+        // Show stack trace in debug mode
+        if (process.env.DEBUG) {
+            console.error(err.stack);
+        }
+        process.exit(EXIT_CODES.GENERAL_ERROR);
+    }
+    error('An unexpected error occurred');
+    process.exit(EXIT_CODES.GENERAL_ERROR);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/auth.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Authentication commands
+ */
+import { Command } from 'commander';
+export declare function createAuthCommand(): Command;
+//# sourceMappingURL=auth.d.ts.map

package/dist/commands/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,iBAAiB,IAAI,OAAO,CAwJ3C"}

package/dist/commands/auth.js

@@ -0,0 +1,154 @@
+/**
+ * Authentication commands
+ */
+import { Command } from 'commander';
+import { prompt } from 'enquirer';
+import chalk from 'chalk';
+import { getApiKey, setApiKey, clearApiKey, getConfigPath, isAuthenticated, getBaseUrl, } from '../lib/config.js';
+import { get, OkraApiError } from '../lib/client.js';
+import { success, error, info } from '../lib/output.js';
+export function createAuthCommand() {
+    const auth = new Command('auth')
+        .description('Manage authentication');
+    // auth login
+    auth
+        .command('login')
+        .description('Authenticate with OkraPDF')
+        .option('-k, --key <key>', 'API key (or set OKRA_API_KEY env var)')
+        .action(async (options) => {
+        try {
+            let apiKey = options.key;
+            if (!apiKey) {
+                // Interactive prompt
+                console.log(chalk.bold('\nOkraPDF CLI Authentication\n'));
+                console.log('Get your API key from: ' + chalk.cyan('https://okrapdf.com/settings/api-keys'));
+                console.log();
+                const response = await prompt({
+                    type: 'password',
+                    name: 'key',
+                    message: 'Enter your API key:',
+                    validate: (value) => {
+                        if (!value)
+                            return 'API key is required';
+                        if (!value.startsWith('okra_'))
+                            return 'API key should start with "okra_"';
+                        return true;
+                    },
+                });
+                apiKey = response.key;
+            }
+            // Validate the key by making a test request
+            const tempKey = getApiKey();
+            setApiKey(apiKey);
+            try {
+                const user = await get('api/auth/me');
+                success(`Authenticated as ${chalk.bold(user.email)}`);
+                info(`Config saved to: ${getConfigPath()}`);
+            }
+            catch (err) {
+                // Restore previous key if validation failed
+                if (tempKey) {
+                    setApiKey(tempKey);
+                }
+                else {
+                    clearApiKey();
+                }
+                if (err instanceof OkraApiError && err.statusCode === 401) {
+                    error('Invalid API key');
+                    process.exit(3);
+                }
+                throw err;
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes('cancelled')) {
+                console.log('\nLogin cancelled');
+                process.exit(0);
+            }
+            throw err;
+        }
+    });
+    // auth logout
+    auth
+        .command('logout')
+        .description('Remove stored credentials')
+        .action(() => {
+        if (!isAuthenticated()) {
+            info('Not logged in');
+            return;
+        }
+        clearApiKey();
+        success('Logged out successfully');
+    });
+    // auth whoami
+    auth
+        .command('whoami')
+        .description('Show current authenticated user')
+        .action(async () => {
+        if (!isAuthenticated()) {
+            error('Not logged in. Run `okra auth login` first.');
+            process.exit(3);
+        }
+        try {
+            const user = await get('api/auth/me');
+            console.log(chalk.bold('Email:'), user.email);
+            if (user.name) {
+                console.log(chalk.bold('Name:'), user.name);
+            }
+            console.log(chalk.bold('User ID:'), user.id);
+            console.log(chalk.bold('API URL:'), getBaseUrl());
+        }
+        catch (err) {
+            if (err instanceof OkraApiError && err.statusCode === 401) {
+                error('Session expired. Run `okra auth login` again.');
+                process.exit(3);
+            }
+            throw err;
+        }
+    });
+    // auth token
+    auth
+        .command('token')
+        .description('Print current API token (for piping)')
+        .action(() => {
+        const key = getApiKey();
+        if (!key) {
+            process.stderr.write('Not logged in\n');
+            process.exit(3);
+        }
+        // Print only the token for easy piping
+        process.stdout.write(key);
+    });
+    // auth status
+    auth
+        .command('status')
+        .description('Check authentication status')
+        .action(async () => {
+        const key = getApiKey();
+        if (!key) {
+            console.log(chalk.yellow('Status:'), 'Not authenticated');
+            console.log(chalk.dim('Run `okra auth login` to authenticate'));
+            return;
+        }
+        const maskedKey = key.substring(0, 12) + '...' + key.substring(key.length - 4);
+        console.log(chalk.bold('API Key:'), maskedKey);
+        console.log(chalk.bold('API URL:'), getBaseUrl());
+        console.log(chalk.bold('Config:'), getConfigPath());
+        // Try to verify the key
+        try {
+            const user = await get('api/auth/me');
+            console.log(chalk.green('Status:'), 'Authenticated');
+            console.log(chalk.bold('User:'), user.email);
+        }
+        catch (err) {
+            if (err instanceof OkraApiError && err.statusCode === 401) {
+                console.log(chalk.red('Status:'), 'Invalid or expired key');
+            }
+            else {
+                console.log(chalk.yellow('Status:'), 'Unable to verify (network error)');
+            }
+        }
+    });
+    return auth;
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/chat.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Chat commands for interactive document conversations
+ */
+import { Command } from 'commander';
+export declare function createChatCommand(): Command;
+//# sourceMappingURL=chat.d.ts.map

package/dist/commands/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,iBAAiB,IAAI,OAAO,CAwC3C"}