@okrapdf/cli 0.1.0 → 0.1.2

package/dist/commands/templates.js

@@ -0,0 +1,202 @@
+/**
+ * Template management commands
+ *
+ * Create, list, and use extraction templates.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { listTemplates, loadTemplate, saveTemplate, deleteTemplate, formatTemplateInfo, getTemplatesDir, } from '../lib/templates.js';
+import { formatOutput, success, error, info } from '../lib/output.js';
+import { getDefaultFormat } from '../lib/config.js';
+export function createTemplatesCommand() {
+    const templates = new Command('templates')
+        .description('Manage extraction templates');
+    // templates list
+    templates
+        .command('list')
+        .alias('ls')
+        .description('List available templates')
+        .option('-o, --output <format>', 'Output format (table, json)', getDefaultFormat())
+        .option('-b, --builtin', 'Show only built-in templates')
+        .option('-c, --custom', 'Show only custom templates')
+        .action((options) => {
+        let tpls = listTemplates();
+        if (options.builtin) {
+            tpls = tpls.filter(t => t.builtin);
+        }
+        else if (options.custom) {
+            tpls = tpls.filter(t => !t.builtin);
+        }
+        if (options.output === 'json') {
+            console.log(formatOutput(tpls, 'json'));
+            return;
+        }
+        if (tpls.length === 0) {
+            console.log(chalk.dim('No templates found'));
+            return;
+        }
+        console.log(chalk.bold('\nAvailable Templates\n'));
+        for (const tpl of tpls) {
+            const badge = tpl.builtin ? chalk.gray(' (builtin)') : chalk.green(' (custom)');
+            const processor = tpl.processor ? chalk.dim(` [${tpl.processor}]`) : '';
+            console.log(`  ${chalk.cyan(tpl.id.padEnd(20))} ${tpl.name}${badge}${processor}`);
+            console.log(`  ${''.padEnd(20)} ${chalk.dim(tpl.description)}`);
+            console.log();
+        }
+        console.log(chalk.dim(`Templates directory: ${getTemplatesDir()}`));
+        console.log();
+    });
+    // templates show <id>
+    templates
+        .command('show <id>')
+        .description('Show template details')
+        .option('-o, --output <format>', 'Output format (text, json)', 'text')
+        .action((id, options) => {
+        const tpl = loadTemplate(id);
+        if (!tpl) {
+            error(`Template not found: ${id}`);
+            console.log(chalk.dim('Run `okra templates list` to see available templates'));
+            process.exit(1);
+        }
+        if (options.output === 'json') {
+            console.log(formatOutput(tpl, 'json'));
+            return;
+        }
+        console.log();
+        console.log(formatTemplateInfo(tpl));
+        console.log();
+    });
+    // templates create
+    templates
+        .command('create <id>')
+        .description('Create a new custom template')
+        .option('-n, --name <name>', 'Template name')
+        .option('-d, --description <desc>', 'Template description')
+        .option('-p, --processor <processor>', 'Preferred processor')
+        .option('--from <template>', 'Base on existing template')
+        .action(async (id, options) => {
+        // Check if template already exists
+        const existing = loadTemplate(id);
+        if (existing && existing.builtin) {
+            error(`Cannot override built-in template: ${id}`);
+            process.exit(1);
+        }
+        let template;
+        if (options.from) {
+            // Base on existing template
+            const base = loadTemplate(options.from);
+            if (!base) {
+                error(`Base template not found: ${options.from}`);
+                process.exit(1);
+            }
+            template = {
+                ...base,
+                id,
+                name: options.name || `${base.name} (copy)`,
+                description: options.description || base.description,
+                builtin: false,
+            };
+        }
+        else {
+            // Create new empty template
+            template = {
+                id,
+                name: options.name || id,
+                description: options.description || `Custom template: ${id}`,
+                documentType: 'custom',
+                processor: options.processor,
+                fields: [],
+                builtin: false,
+            };
+        }
+        if (options.processor) {
+            template.processor = options.processor;
+        }
+        saveTemplate(template);
+        success(`Template created: ${id}`);
+        info(`Edit at: ${getTemplatesDir()}/${id}.json`);
+    });
+    // templates edit <id>
+    templates
+        .command('edit <id>')
+        .description('Open template in editor')
+        .action(async (id) => {
+        const tpl = loadTemplate(id);
+        if (tpl?.builtin) {
+            error('Cannot edit built-in template. Use `okra templates create --from` to create a copy.');
+            process.exit(1);
+        }
+        if (!tpl) {
+            error(`Template not found: ${id}`);
+            process.exit(1);
+        }
+        const path = `${getTemplatesDir()}/${id}.json`;
+        const editor = process.env.EDITOR || 'vi';
+        console.log(chalk.dim(`Opening ${path} in ${editor}...`));
+        const { spawn } = await import('child_process');
+        const child = spawn(editor, [path], { stdio: 'inherit' });
+        child.on('exit', (code) => {
+            if (code === 0) {
+                success('Template saved');
+            }
+            process.exit(code || 0);
+        });
+    });
+    // templates delete <id>
+    templates
+        .command('delete <id>')
+        .alias('rm')
+        .description('Delete a custom template')
+        .option('-f, --force', 'Skip confirmation')
+        .action(async (id, options) => {
+        const tpl = loadTemplate(id);
+        if (!tpl) {
+            error(`Template not found: ${id}`);
+            process.exit(1);
+        }
+        if (tpl.builtin) {
+            error('Cannot delete built-in template');
+            process.exit(1);
+        }
+        if (!options.force) {
+            const { prompt } = await import('enquirer');
+            const response = await prompt({
+                type: 'confirm',
+                name: 'confirm',
+                message: `Delete template "${id}"?`,
+                initial: false,
+            });
+            if (!response.confirm) {
+                console.log('Cancelled');
+                return;
+            }
+        }
+        if (deleteTemplate(id)) {
+            success(`Template deleted: ${id}`);
+        }
+        else {
+            error('Failed to delete template');
+        }
+    });
+    // templates path
+    templates
+        .command('path')
+        .description('Show templates directory path')
+        .action(() => {
+        console.log(getTemplatesDir());
+    });
+    // Default action - same as list
+    templates.action(() => {
+        const tpls = listTemplates();
+        console.log(chalk.bold('\nAvailable Templates\n'));
+        for (const tpl of tpls) {
+            const badge = tpl.builtin ? chalk.gray(' (builtin)') : chalk.green(' (custom)');
+            console.log(`  ${chalk.cyan(tpl.id.padEnd(20))} ${tpl.name}${badge}`);
+        }
+        console.log();
+        console.log(chalk.dim('Use `okra templates show <id>` for details'));
+        console.log();
+    });
+    return templates;
+}
+//# sourceMappingURL=templates.js.map

package/dist/commands/templates.js.map

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

package/dist/index.d.ts

@@ -1,418 +1,20 @@
-import { OkraClient, VerificationPageStatus as VerificationPageStatus$1, EntityType as EntityType$1, VerificationTreeResponse, PageContentResponse, PageVersionsResponse as PageVersionsResponse$1, SearchResponse as SearchResponse$1, TablesResponse as TablesResponse$1, HistoryResponse as HistoryResponse$1 } from '@okrapdf/sdk';
-
+#!/usr/bin/env node
 /**
- * CLI Types for OkraPDF Review Operations
+ * OkraPDF CLI - Entry Point
  *
- * These types mirror the review page UI interactions:
- * - Left panel: Document tree (verification status, entity counts)
- * - Middle panel: PDF viewer (entities, overlays)
- * - Right panel: Page content (markdown, versions)
- */
-type VerificationPageStatus = 'complete' | 'partial' | 'flagged' | 'pending' | 'empty' | 'gap' | 'error';
-interface VerificationTreePage {
-    page: number;
-    status: VerificationPageStatus;
-    total: number;
-    verified: number;
-    pending: number;
-    flagged: number;
-    rejected: number;
-    avgConfidence: number;
-    hasOcr: boolean;
-    ocrLineCount: number;
-    hasCoverageGaps: boolean;
-    uncoveredCount: number;
-    resolution: string | null;
-    classification: string | null;
-    isStale: boolean;
-}
-interface VerificationTreeSummary {
-    complete: number;
-    partial: number;
-    flagged: number;
-    pending: number;
-    empty: number;
-    gap: number;
-    resolved?: number;
-    stale?: number;
-}
-interface VerificationTree {
-    jobId: string;
-    documentId: string;
-    totalPages: number;
-    summary: VerificationTreeSummary;
-    pages: VerificationTreePage[];
-}
-type EntityType = 'table' | 'figure' | 'footnote' | 'summary' | 'signature' | 'paragraph';
-interface EntityBBox {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-interface Entity {
-    id: string;
-    type: EntityType;
-    title: string | null;
-    page: number;
-    schema?: string[];
-    isComplete?: boolean;
-    bbox?: EntityBBox;
-    confidence?: number;
-    verificationStatus?: 'pending' | 'verified' | 'flagged' | 'rejected';
-}
-interface EntitiesResponse {
-    jobId: string;
-    entities: Entity[];
-    counts: {
-        tables: number;
-        figures: number;
-        footnotes: number;
-        summaries: number;
-        signatures?: number;
-    };
-    extractionStatus?: 'not_started' | 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'paused';
-    totalPages?: number;
-}
-interface TextBlock {
-    text: string;
-    bbox?: EntityBBox;
-    confidence?: number;
-}
-interface PageDimension {
-    width: number | null;
-    height: number | null;
-}
-interface PageContent {
-    page: number;
-    content: string;
-    version?: number;
-    blocks?: TextBlock[];
-    dimension?: PageDimension | null;
-}
-interface PageVersionInfo {
-    version: number;
-    editSource: 'ocr_extraction' | 'user_edit' | 'ai_correction';
-    createdAt: string | null;
-    preview: string;
-}
-interface PageVersionsResponse {
-    page: number;
-    currentVersion: number;
-    versions: PageVersionInfo[];
-}
-interface Table {
-    id: string;
-    pageNumber: number;
-    markdown: string;
-    bbox: {
-        xmin: number;
-        ymin: number;
-        xmax: number;
-        ymax: number;
-    };
-    confidence: number | null;
-    verificationStatus: 'pending' | 'verified' | 'flagged' | 'rejected';
-    verifiedBy: string | null;
-    verifiedAt: string | null;
-    wasCorrected?: boolean;
-    createdAt: string;
-}
-interface TablesResponse {
-    tables: Table[];
-    source: 'job_id' | 'document_uuid';
-}
-type MatchSource = 'content' | 'table_title' | 'table_schema' | 'table_row' | 'figure' | 'footnote' | 'summary' | 'signature' | 'paragraph';
-interface SearchResult {
-    page: number;
-    snippet: string;
-    matchCount: number;
-    matchSource?: MatchSource;
-}
-interface SearchResponse {
-    query: string;
-    totalMatches: number;
-    results: SearchResult[];
-}
-interface HistoryEntry {
-    id: string;
-    entityType: string;
-    entityId: string;
-    state: string;
-    previousState: string | null;
-    transitionName: string | null;
-    triggeredBy: string | null;
-    triggeredByName: string | null;
-    reason: string | null;
-    resolution: string | null;
-    classification: string | null;
-    pageNum: number | null;
-    createdAt: string;
-}
-interface HistoryResponse {
-    history: HistoryEntry[];
-}
-type OutputFormat = 'text' | 'json' | 'markdown';
-interface QueryConfig {
-    selector: string;
-    topK?: number;
-    minConfidence?: number;
-    pageRange?: [number, number];
-    sortBy?: 'confidence' | 'page' | 'type';
-}
-
-/**
- * Query Engine - jQuery-like entity selector
- *
- * Inspired by okra-jquery from ~/dev/okrapdf/lib/okra-jquery
- * Supports selectors like:
- * - Type: .table, .figure, .footnote
- * - ID: #entity_123
- * - Attributes: [confidence>0.9], [verified=true]
- * - Page: :page(5), :pages(1-10)
- * - Combinators: .table[confidence>0.9], .table, .figure
- */
-
-interface SelectorParts {
-    types: EntityType[];
-    id?: string;
-    pageFilter?: {
-        type: 'single' | 'range';
-        value: number | [number, number];
-    };
-    confidenceFilter?: {
-        op: '>' | '<' | '>=' | '<=';
-        value: number;
-    };
-    verificationFilter?: 'pending' | 'verified' | 'flagged' | 'rejected';
-    textContains?: string;
-}
-/**
- * Parse a jQuery-like selector string into parts.
- *
- * Examples:
- * - ".table" -> { types: ['table'] }
- * - ".table, .figure" -> { types: ['table', 'figure'] }
- * - ".table:page(5)" -> { types: ['table'], pageFilter: { type: 'single', value: 5 } }
- * - "[confidence>0.9]" -> { confidenceFilter: { op: '>', value: 0.9 } }
- * - ".table[confidence>=0.8]:page(1-10)" -> complex filter
- */
-declare function parseSelector(selector: string): SelectorParts;
-/**
- * Filter entities based on parsed selector parts.
- */
-declare function filterEntities(entities: Entity[], parts: SelectorParts): Entity[];
-interface QueryOptions {
-    topK?: number;
-    minConfidence?: number;
-    pageRange?: [number, number];
-    sortBy?: 'confidence' | 'page' | 'type';
-}
-interface QueryStats {
-    total: number;
-    byType: Record<string, number>;
-    byPage: Record<number, number>;
-    avgConfidence: number;
-    minConfidence: number;
-    maxConfidence: number;
-}
-interface QueryResult {
-    entities: Entity[];
-    total: number;
-    stats: QueryStats;
-}
-/**
- * Execute a query against entities.
- */
-declare function executeQuery(entities: Entity[], selector: string, options?: QueryOptions): QueryResult;
-/**
- * Calculate aggregate statistics for entities.
- */
-declare function calculateStats(entities: Entity[]): QueryStats;
-
-/**
- * okra tree - Document verification tree command
- *
- * Maps to: Left panel of review page
- * Shows page-level verification status and entity counts.
+ * A command-line interface for OkraPDF that provides:
+ * - Document management (upload, list, download, delete)
+ * - OCR job management (create, status, results, export)
+ * - Table extraction and export
+ * - Interactive document chat
  *
  * Usage:
- *   okra tree <jobId>
- *   okra tree <jobId> --status pending
- *   okra tree <jobId> --entity table
- *   okra tree <jobId> --format json
- */
-
-interface TreeOptions {
-    status?: VerificationPageStatus$1;
-    entity?: EntityType$1;
-    format?: 'text' | 'json' | 'markdown';
-}
-interface TreeResult {
-    tree: VerificationTreeResponse;
-    filteredPages: number[];
-}
-/**
- * Get the verification tree for a job.
- */
-declare function tree(client: OkraClient, jobId: string, options?: TreeOptions): Promise<TreeResult>;
-/**
- * Format tree result for output.
- */
-declare function formatTreeOutput(result: TreeResult, format?: 'text' | 'json' | 'markdown'): string;
-
-/**
- * okra find - Entity search with jQuery-like selectors
- *
- * Maps to: Middle panel of review page (entity overlays)
- * Find entities using CSS-like selectors.
- *
- * Usage:
- *   okra find <jobId> ".table"                    # Find all tables
- *   okra find <jobId> ".figure:page(5)"           # Figures on page 5
- *   okra find <jobId> "[confidence>0.9]"          # High confidence entities
- *   okra find <jobId> ".table, .figure"           # Tables OR figures
- *   okra find <jobId> "*" --stats                 # All entities with stats
- *   okra find <jobId> ".table" --top-k 10         # Top 10 tables
- */
-
-interface FindOptions extends QueryOptions {
-    stats?: boolean;
-    format?: 'text' | 'json' | 'entities' | 'ids';
-}
-/**
- * Find entities matching a selector.
- */
-declare function find(client: OkraClient, jobId: string, selector: string, options?: FindOptions): Promise<QueryResult>;
-/**
- * Format find result for output.
- */
-declare function formatFindOutput(result: QueryResult, format?: 'text' | 'json' | 'entities' | 'ids', showStats?: boolean): string;
-/**
- * Format stats only.
- */
-declare function formatStats(stats: QueryStats): string;
-
-/**
- * okra page - Page content operations
+ *   okra <command> [options]
  *
- * Maps to: Right panel of review page (markdown editor)
- * Get, edit, and resolve page content.
- *
- * Usage:
- *   okra page get <jobId> <pageNum>               # Get page markdown
- *   okra page get <jobId> <pageNum> --version 2   # Get specific version
- *   okra page edit <jobId> <pageNum> <content>    # Edit page content
- *   okra page resolve <jobId> <pageNum> reviewed  # Mark as reviewed
- *   okra page versions <jobId> <pageNum>          # List versions
- */
-
-interface PageGetOptions {
-    version?: number;
-    format?: 'text' | 'json' | 'markdown';
-}
-interface PageResolveOptions {
-    resolution: string;
-    classification?: string;
-    reason?: string;
-}
-/**
- * Get page content.
- */
-declare function pageGet(client: OkraClient, jobId: string, pageNum: number, options?: PageGetOptions): Promise<PageContentResponse>;
-/**
- * Edit page content.
- */
-declare function pageEdit(client: OkraClient, jobId: string, pageNum: number, content: string): Promise<{
-    success: boolean;
-    version: number;
-}>;
-/**
- * Resolve page verification status.
- */
-declare function pageResolve(client: OkraClient, jobId: string, pageNum: number, options: PageResolveOptions): Promise<{
-    success: boolean;
-}>;
-/**
- * List page versions.
- */
-declare function pageVersions(client: OkraClient, jobId: string, pageNum: number): Promise<PageVersionsResponse$1>;
-/**
- * Format page content for output.
- */
-declare function formatPageOutput(content: PageContentResponse, format?: 'text' | 'json' | 'markdown'): string;
-/**
- * Format versions list for output.
- */
-declare function formatVersionsOutput(versions: PageVersionsResponse$1, format?: 'text' | 'json'): string;
-
-/**
- * okra search - Full-text search command
- *
- * Search page content across all pages.
- *
- * Usage:
- *   okra search <jobId> "revenue"
- *   okra search <jobId> "total" --format json
- */
-
-interface SearchOptions {
-    format?: 'text' | 'json';
-    limit?: number;
-}
-/**
- * Search page content.
- */
-declare function search(client: OkraClient, jobId: string, query: string): Promise<SearchResponse$1>;
-/**
- * Format search results for output.
- */
-declare function formatSearchOutput(result: SearchResponse$1, format?: 'text' | 'json'): string;
-
-/**
- * okra tables - List and filter tables
- *
- * Usage:
- *   okra tables <jobId>
- *   okra tables <jobId> --page 5
- *   okra tables <jobId> --status pending
- *   okra tables <jobId> --format json
- */
-
-interface TablesOptions {
-    page?: number;
-    status?: 'pending' | 'verified' | 'flagged' | 'rejected';
-    format?: 'text' | 'json' | 'markdown';
-}
-/**
- * Get tables for a job.
- */
-declare function tables(client: OkraClient, jobId: string, options?: TablesOptions): Promise<TablesResponse$1>;
-/**
- * Format tables for output.
- */
-declare function formatTablesOutput(result: TablesResponse$1, format?: 'text' | 'json' | 'markdown'): string;
-
-/**
- * okra history - Verification audit trail
- *
- * Usage:
- *   okra history <jobId>
- *   okra history <jobId> --limit 20
- *   okra history <jobId> --format json
- */
-
-interface HistoryOptions {
-    limit?: number;
-    format?: 'text' | 'json';
-}
-/**
- * Get verification history.
- */
-declare function history(client: OkraClient, jobId: string, options?: HistoryOptions): Promise<HistoryResponse$1>;
-/**
- * Format history for output.
+ * Examples:
+ *   okra auth login
+ *   okra extract invoice.pdf
+ *   okra chat <document-uuid>
  */
-declare function formatHistoryOutput(result: HistoryResponse$1, format?: 'text' | 'json'): string;
-
-export { type EntitiesResponse, type Entity, type EntityBBox, type EntityType, type FindOptions, type HistoryEntry, type HistoryOptions, type HistoryResponse, type MatchSource, type OutputFormat, type PageContent, type PageDimension, type PageGetOptions, type PageResolveOptions, type PageVersionInfo, type PageVersionsResponse, type QueryConfig, type QueryOptions, type QueryResult, type QueryStats, type SearchOptions, type SearchResponse, type SearchResult, type SelectorParts, type Table, type TablesOptions, type TablesResponse, type TextBlock, type TreeOptions, type TreeResult, type VerificationPageStatus, type VerificationTree, type VerificationTreePage, type VerificationTreeSummary, calculateStats, executeQuery, filterEntities, find, formatFindOutput, formatHistoryOutput, formatPageOutput, formatSearchOutput, formatStats, formatTablesOutput, formatTreeOutput, formatVersionsOutput, history, pageEdit, pageGet, pageResolve, pageVersions, parseSelector, search, tables, tree };
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG"}