okrapdf 0.12.0 → 0.12.1

package/dist/cli/bin.js

@@ -2,12 +2,17 @@
 import {
   authLogin,
   authLogout,
+  authSetKey,
   authStatus,
+  authToken,
+  authWhoAmI,
+  collectionExport,
   collectionList,
   collectionQueryRaw,
   collectionSetVisibility,
   find,
   formatCollectionCsv,
+  formatCollectionExportFlat,
   formatCollectionList,
   formatCollectionTable,
   formatFindOutput,
@@ -35,16 +40,19 @@ import {
   tree,
   upload,
   writeOutput
-} from "../chunk-YY44NPDZ.js";
+} from "../chunk-XOHPZW3V.js";
 import {
   OkraClient
-} from "../chunk-XM4MS5WV.js";
+} from "../chunk-2HJPTW6S.js";
 import "../chunk-NIZM2ETT.js";
 
 // src/cli/bin.ts
 import { Command } from "commander";
+import { writeFileSync } from "fs";
 var program = new Command();
-program.name("okra").description("OkraPDF CLI \u2014 upload PDFs, query collections, extract data").version("0.9.0").option("-j, --json", "Output JSON (structured, machine-readable)").option("-q, --quiet", "Suppress progress and human-readable frills").option("-o, --output <file>", "Write output to file instead of stdout");
+program.showHelpAfterError();
+program.showSuggestionAfterError();
+program.name("okra").description("OkraPDF CLI \u2014 upload PDFs, query collections, extract data").version("0.12.1").option("-j, --json", "Output JSON (structured, machine-readable)").option("-q, --quiet", "Suppress progress and human-readable frills").option("-o, --output <file>", "Write output to file instead of stdout");
 function globals() {
   return program.opts();
 }
@@ -57,14 +65,14 @@ function getClient() {
       process.stderr.write(JSON.stringify({ error: "No API key found", code: 401 }) + "\n");
     } else {
       process.stderr.write(
-        'No API key found.\n\n  Get one: https://okrapdf.dev/api-keys\n  Then:    export OKRA_API_KEY="okra_xxx"\n  Or:      npx okra auth login\n\n  Docs:    https://okrapdf.dev/docs\n  Discord: https://discord.gg/BHNmbZVs\n'
+        'No API key found.\n\n  Get one: https://docs.okrapdf.com/api-keys\n  Then:    export OKRA_API_KEY="okra_xxx"\n  Or:      npx okra auth login\n\n  Docs:    https://docs.okrapdf.com\n  Discord: https://discord.gg/BHNmbZVs\n'
       );
     }
     process.exit(1);
   }
   return new OkraClient({ apiKey, baseUrl });
 }
-program.command("upload <source>").description("Upload a PDF (file path or URL), wait for processing").option("--no-wait", "Fire-and-forget (don't wait for processing)").action(async (source, options) => {
+async function runUploadCommand(source, options) {
   const g = globals();
   try {
     const client = getClient();
@@ -89,7 +97,35 @@ program.command("upload <source>").description("Upload a PDF (file path or URL),
         lines.push("    /v1/documents/{id}/d_shimmer/pg_{N}.png  page image");
         lines.push("    /v1/documents/{id}/full.md               full document");
         lines.push("");
-        lines.push("  Docs: https://okrapdf.dev/docs  Discord: https://discord.gg/BHNmbZVs");
+        lines.push("  Docs: https://docs.okrapdf.com  Discord: https://discord.gg/BHNmbZVs");
+      }
+      writeOutput(lines.join("\n"), g.output);
+    }
+  } catch (error) {
+    handleError(error, g.json);
+  }
+}
+function registerUploadCommand(commandName, description) {
+  program.command(`${commandName} <source>`).description(description).option("--no-wait", "Fire-and-forget (don't wait for processing)").action(async (source, options) => {
+    await runUploadCommand(source, options);
+  });
+}
+registerUploadCommand("upload", "Upload a PDF (file path or URL), wait for processing");
+registerUploadCommand("extract", "Alias for upload (compatibility)");
+program.command("status <docId>").description("Get document processing status").action(async (docId) => {
+  const g = globals();
+  try {
+    const client = getClient();
+    const status = await client.status(docId);
+    if (g.json) {
+      writeOutput(JSON.stringify(status), g.output);
+    } else {
+      const lines = [
+        `Document: ${docId}`,
+        `Phase: ${status.phase}`
+      ];
+      if (typeof status.pagesCompleted === "number" || typeof status.pagesTotal === "number") {
+        lines.push(`Pages: ${status.pagesCompleted ?? "?"} / ${status.pagesTotal ?? "?"}`);
       }
       writeOutput(lines.join("\n"), g.output);
     }
@@ -97,8 +133,22 @@ program.command("upload <source>").description("Upload a PDF (file path or URL),
     handleError(error, g.json);
   }
 });
-var collectionCmd = program.command("collection").description("Collection operations");
-collectionCmd.command("list").description("List available collections").action(async () => {
+program.command("chat <question>").description("Ask a question about a processed document").requiredOption("--doc <id>", "Document ID").option("--model <name>", "Override model").action(async (question, options) => {
+  const g = globals();
+  try {
+    const client = getClient();
+    const result = await client.generate(options.doc, question, options.model ? { model: options.model } : void 0);
+    if (g.json) {
+      writeOutput(JSON.stringify({ docId: options.doc, question, ...result }), g.output);
+    } else {
+      writeOutput(result.answer, g.output);
+    }
+  } catch (error) {
+    handleError(error, g.json);
+  }
+});
+var collectionCmd = program.command("collection").alias("collections").alias("col").description("Collection operations");
+collectionCmd.command("list").alias("ls").description("List available collections").action(async () => {
   const g = globals();
   try {
     const client = getClient();
@@ -167,10 +217,51 @@ collectionCmd.command("unpublish <nameOrId>").description("Make a collection pri
     handleError(error, g.json);
   }
 });
+collectionCmd.command("export <nameOrId>").description("Export pre-computed markdown for all documents in a collection").option("--flat", "Concatenated markdown with # headers + === separators").option("--zip", "One markdown file per document in a .zip archive").action(async (nameOrId, options) => {
+  const g = globals();
+  try {
+    const client = getClient();
+    if (options.flat && options.zip) {
+      throw new Error("Use either --flat or --zip, not both");
+    }
+    if (options.zip) {
+      const bytes = await collectionExport(client, nameOrId, { ...g, zip: true });
+      const safeBase = String(nameOrId).trim().replace(/[^A-Za-z0-9._-]+/g, "-").replace(/-{2,}/g, "-").replace(/^[-_.]+|[-_.]+$/g, "") || "collection-export";
+      const outputPath = g.output || `${safeBase}.zip`;
+      writeFileSync(outputPath, bytes);
+      progress(`Wrote \u2192 ${outputPath}`, g.quiet);
+      if (g.json) {
+        writeOutput(JSON.stringify({
+          format: "zip",
+          file: outputPath,
+          bytes: bytes.byteLength
+        }));
+      }
+      return;
+    }
+    const result = await collectionExport(client, nameOrId, { ...g, flat: options.flat });
+    if (options.flat) {
+      writeOutput(formatCollectionExportFlat(result), g.output);
+    } else if (g.json) {
+      writeOutput(JSON.stringify(result), g.output);
+    } else {
+      writeOutput(JSON.stringify(result, null, 2), g.output);
+    }
+  } catch (error) {
+    handleError(error, g.json);
+  }
+});
 var authCmd = program.command("auth").description("Manage authentication");
-authCmd.command("login").description("Save API key to global config").action(async () => {
+authCmd.command("login").description("Save API key to global config").option("-k, --key <apiKey>", "Set API key non-interactively").action(async (options) => {
   try {
-    await authLogin();
+    await authLogin(options.key);
+  } catch (error) {
+    handleError(error, globals().json);
+  }
+});
+authCmd.command("set-key <apiKey>").description("Save API key to global config (non-interactive)").action(async (apiKey) => {
+  try {
+    await authSetKey(apiKey);
   } catch (error) {
     handleError(error, globals().json);
   }
@@ -182,6 +273,20 @@ authCmd.command("status").description("Show authentication status").action(async
     handleError(error, globals().json);
   }
 });
+authCmd.command("whoami").description("Show current auth identity (alias for status)").action(async () => {
+  try {
+    await authWhoAmI();
+  } catch (error) {
+    handleError(error, globals().json);
+  }
+});
+authCmd.command("token").description("Print active API key to stdout").action(async () => {
+  try {
+    await authToken();
+  } catch (error) {
+    handleError(error, globals().json);
+  }
+});
 authCmd.command("logout").description("Remove API key from global config").action(async () => {
   try {
     await authLogout();

package/dist/cli/bin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * okra CLI — Agent-friendly PDF extraction and collection queries.\n *\n * Global flags:\n *   -j, --json       Structured JSON output\n *   -q, --quiet      Suppress progress (just data to stdout)\n *   -o, --output     Write output to file (CSV/JSON)\n *\n * Action commands (agent-grade):\n *   okra upload <source>                            # Upload + wait\n *   okra collection list                            # List collections\n *   okra collection query <name> \"<question>\"       # Fan-out → CSV\n *\n * Review commands (existing):\n *   okra tree / find / page / search / tables / history / toc\n *\n * Exit codes: 0=success, 1=client error, 2=server error\n */\n\nimport { Command } from 'commander';\nimport { OkraClient } from '../client';\nimport {\n  tree,\n  formatTreeOutput,\n  find,\n  formatFindOutput,\n  formatStats,\n  pageGet,\n  pageEdit,\n  pageResolve,\n  pageVersions,\n  formatPageOutput,\n  formatVersionsOutput,\n  search,\n  formatSearchOutput,\n  tables,\n  formatTablesOutput,\n  history,\n  formatHistoryOutput,\n  toc,\n  formatTocOutput,\n  authLogin,\n  authStatus,\n  authLogout,\n  upload,\n  collectionList,\n  collectionSetVisibility,\n  collectionQueryRaw,\n  formatCollectionList,\n  formatCollectionCsv,\n  formatCollectionTable,\n  formatQueryJsonl,\n} from './commands';\nimport { getApiKey, getBaseUrl } from './config';\nimport { handleError, writeOutput, progress } from './output';\nimport type { GlobalFlags } from './output';\n\nconst program = new Command();\n\nprogram\n  .name('okra')\n  .description('OkraPDF CLI — upload PDFs, query collections, extract data')\n  .version('0.9.0')\n  .option('-j, --json', 'Output JSON (structured, machine-readable)')\n  .option('-q, --quiet', 'Suppress progress and human-readable frills')\n  .option('-o, --output <file>', 'Write output to file instead of stdout');\n\n/** Read global flags from program.opts(). */\nfunction globals(): GlobalFlags {\n  return program.opts();\n}\n\n// Create client with proper config priority:\n// 1. Environment variable (OKRA_API_KEY)\n// 2. Project config (.okrarc, .okra.json)\n// 3. Global config (~/.okra/config.json)\nfunction getClient(): OkraClient {\n  const apiKey = getApiKey();\n  const baseUrl = getBaseUrl();\n\n  if (!apiKey) {\n    const g = globals();\n    if (g.json) {\n      process.stderr.write(JSON.stringify({ error: 'No API key found', code: 401 }) + '\\n');\n    } else {\n      process.stderr.write(\n        'No API key found.\\n\\n' +\n        '  Get one: https://okrapdf.dev/api-keys\\n' +\n        '  Then:    export OKRA_API_KEY=\"okra_xxx\"\\n' +\n        '  Or:      npx okra auth login\\n\\n' +\n        '  Docs:    https://okrapdf.dev/docs\\n' +\n        '  Discord: https://discord.gg/BHNmbZVs\\n',\n      );\n    }\n    process.exit(1);\n  }\n\n  return new OkraClient({ apiKey, baseUrl });\n}\n\n// ============================================================================\n// upload command\n// ============================================================================\nprogram\n  .command('upload <source>')\n  .description('Upload a PDF (file path or URL), wait for processing')\n  .option('--no-wait', 'Fire-and-forget (don\\'t wait for processing)')\n  .action(async (source, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const result = await upload(client, source, {\n        ...g,\n        noWait: options.wait === false,\n      });\n\n      if (g.json) {\n        writeOutput(JSON.stringify(result), g.output);\n      } else {\n        const lines = [`Done — ${result.pages ?? '?'} pages`, ''];\n        lines.push(`  ${result.id}`);\n        if (result.urls) {\n          const short = result.id.slice(0, 11) + '...';\n          lines.push('');\n          lines.push(`  Markdown:   ${result.urls.full_md.replace(result.id, short)}`);\n          lines.push(`  Page 1:     ${result.urls.page_png.replace(result.id, short).replace('{N}', '1')}`);\n          lines.push(`  Completion: ${result.urls.completion.replace(result.id, short)}`);\n          lines.push('');\n          lines.push('  URL patterns:');\n          lines.push('    /v1/documents/{id}/pg_{N}.md             page markdown');\n          lines.push('    /v1/documents/{id}/d_shimmer/pg_{N}.png  page image');\n          lines.push('    /v1/documents/{id}/full.md               full document');\n          lines.push('');\n          lines.push('  Docs: https://okrapdf.dev/docs  Discord: https://discord.gg/BHNmbZVs');\n        }\n        writeOutput(lines.join('\\n'), g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// collection command\n// ============================================================================\nconst collectionCmd = program.command('collection').description('Collection operations');\n\ncollectionCmd\n  .command('list')\n  .description('List available collections')\n  .action(async () => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const rows = await collectionList(client, g);\n      writeOutput(formatCollectionList(rows, g.json), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\ncollectionCmd\n  .command('query <nameOrId> <question>')\n  .description('Fan-out query across collection documents')\n  .option('--schema <file>', 'JSON Schema file for structured extraction')\n  .action(async (nameOrId, question, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const { results, summary } = await collectionQueryRaw(\n        client,\n        nameOrId,\n        question,\n        { ...g, schema: options.schema },\n      );\n\n      // Determine output format based on flags\n      if (g.json) {\n        // --json: JSONL events to stdout\n        writeOutput(formatQueryJsonl(results), g.output);\n      } else if (g.output && g.output.endsWith('.csv')) {\n        // -o file.csv → CSV\n        writeOutput(formatCollectionCsv(results), g.output);\n      } else if (g.output) {\n        // -o file.json or other → JSON\n        writeOutput(JSON.stringify({ results, summary }), g.output);\n      } else {\n        // Default: compact table to stdout\n        writeOutput(formatCollectionTable(results));\n      }\n\n      progress(\n        `${summary.completed} completed, ${summary.failed} failed — $${summary.total_cost_usd.toFixed(4)}`,\n        g.quiet,\n      );\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\ncollectionCmd\n  .command('publish <nameOrId>')\n  .description('Make a collection publicly queryable')\n  .action(async (nameOrId) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      await collectionSetVisibility(client, nameOrId, 'public');\n      if (g.json) {\n        writeOutput(JSON.stringify({ ok: true, visibility: 'public', collection: nameOrId }), g.output);\n      } else {\n        writeOutput(\n          `Published \"${nameOrId}\"\\n` +\n          `Share with: okra collection query ${nameOrId} \"your question\"`,\n          g.output,\n        );\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\ncollectionCmd\n  .command('unpublish <nameOrId>')\n  .description('Make a collection private (owner-only)')\n  .action(async (nameOrId) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      await collectionSetVisibility(client, nameOrId, 'private');\n      if (g.json) {\n        writeOutput(JSON.stringify({ ok: true, visibility: 'private', collection: nameOrId }), g.output);\n      } else {\n        writeOutput(`Unpublished \"${nameOrId}\" — now private`, g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// auth command - Authentication management\n// ============================================================================\nconst authCmd = program.command('auth').description('Manage authentication');\n\nauthCmd\n  .command('login')\n  .description('Save API key to global config')\n  .action(async () => {\n    try {\n      await authLogin();\n    } catch (error) {\n      handleError(error, globals().json);\n    }\n  });\n\nauthCmd\n  .command('status')\n  .description('Show authentication status')\n  .action(async () => {\n    try {\n      await authStatus();\n    } catch (error) {\n      handleError(error, globals().json);\n    }\n  });\n\nauthCmd\n  .command('logout')\n  .description('Remove API key from global config')\n  .action(async () => {\n    try {\n      await authLogout();\n    } catch (error) {\n      handleError(error, globals().json);\n    }\n  });\n\n// ============================================================================\n// tree command - Document verification tree\n// ============================================================================\nprogram\n  .command('tree <jobId>')\n  .description('Show document verification tree')\n  .option('-s, --status <status>', 'Filter by status (complete|partial|pending|flagged|empty|gap)')\n  .option('-e, --entity <type>', 'Filter by entity type (table|figure|footnote)')\n  .option('-f, --format <format>', 'Output format (text|json|markdown)', 'text')\n  .action(async (jobId, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const result = await tree(client, jobId, {\n        status: options.status,\n        entity: options.entity,\n      });\n      writeOutput(formatTreeOutput(result, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// find command - jQuery-like entity search\n// ============================================================================\nprogram\n  .command('find <jobId> <selector>')\n  .description('Find entities using jQuery-like selectors')\n  .option('-k, --top-k <n>', 'Limit results', parseInt)\n  .option('-c, --min-confidence <n>', 'Minimum confidence (0-1)', parseFloat)\n  .option('-p, --pages <range>', 'Page range (e.g., 1-10)')\n  .option('--sort <by>', 'Sort by (confidence|page|type)')\n  .option('--stats', 'Show aggregate statistics')\n  .option('-f, --format <format>', 'Output format (text|json|entities|ids)', 'text')\n  .action(async (jobId, selector, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const pageRange = options.pages\n        ? options.pages.split('-').map(Number) as [number, number]\n        : undefined;\n\n      const result = await find(client, jobId, selector, {\n        topK: options.topK,\n        minConfidence: options.minConfidence,\n        pageRange,\n        sortBy: options.sort,\n      });\n\n      if (options.stats && fmt === 'text') {\n        writeOutput(formatStats(result.stats), g.output);\n      } else {\n        writeOutput(formatFindOutput(result, fmt, options.stats), g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// page command - Page content operations\n// ============================================================================\nconst pageCmd = program.command('page').description('Page content operations');\n\npageCmd\n  .command('get <jobId> <pageNum>')\n  .description('Get page content')\n  .option('-v, --version <n>', 'Specific version', parseInt)\n  .option('-f, --format <format>', 'Output format (text|json|markdown)', 'markdown')\n  .action(async (jobId, pageNum, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const content = await pageGet(client, jobId, parseInt(pageNum), {\n        version: options.version,\n      });\n      writeOutput(formatPageOutput(content, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\npageCmd\n  .command('edit <jobId> <pageNum>')\n  .description('Edit page content (reads from stdin)')\n  .action(async (jobId, pageNum) => {\n    const g = globals();\n    try {\n      const chunks: Buffer[] = [];\n      for await (const chunk of process.stdin) {\n        chunks.push(chunk);\n      }\n      const content = Buffer.concat(chunks).toString('utf8');\n\n      const client = getClient();\n      const result = await pageEdit(client, jobId, parseInt(pageNum), content);\n      if (g.json) {\n        writeOutput(JSON.stringify({ version: result.version }), g.output);\n      } else {\n        writeOutput(`Saved as version ${result.version}`, g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\npageCmd\n  .command('resolve <jobId> <pageNum> <resolution>')\n  .description('Resolve page verification status')\n  .option('-c, --classification <class>', 'Classification')\n  .option('-r, --reason <reason>', 'Reason')\n  .action(async (jobId, pageNum, resolution, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const result = await pageResolve(client, jobId, parseInt(pageNum), {\n        resolution,\n        classification: options.classification,\n        reason: options.reason,\n      });\n      if (g.json) {\n        writeOutput(JSON.stringify({ success: result.success }), g.output);\n      } else {\n        writeOutput(result.success ? 'Resolved' : 'Failed', g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\npageCmd\n  .command('versions <jobId> <pageNum>')\n  .description('List page versions')\n  .option('-f, --format <format>', 'Output format (text|json)', 'text')\n  .action(async (jobId, pageNum, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const versions = await pageVersions(client, jobId, parseInt(pageNum));\n      writeOutput(formatVersionsOutput(versions, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// search command - Full-text search\n// ============================================================================\nprogram\n  .command('search <jobId> <query>')\n  .description('Search page content')\n  .option('-f, --format <format>', 'Output format (text|json)', 'text')\n  .action(async (jobId, query, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const result = await search(client, jobId, query);\n      writeOutput(formatSearchOutput(result, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// tables command - List tables\n// ============================================================================\nprogram\n  .command('tables <jobId>')\n  .description('List extracted tables')\n  .option('-p, --page <n>', 'Filter by page', parseInt)\n  .option('-s, --status <status>', 'Filter by status (pending|verified|flagged|rejected)')\n  .option('-f, --format <format>', 'Output format (text|json|markdown)', 'text')\n  .action(async (jobId, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const result = await tables(client, jobId, {\n        page: options.page,\n        status: options.status,\n      });\n      writeOutput(formatTablesOutput(result, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// history command - Verification audit trail\n// ============================================================================\nprogram\n  .command('history <jobId>')\n  .description('Show verification history')\n  .option('-l, --limit <n>', 'Limit entries', parseInt, 50)\n  .option('-f, --format <format>', 'Output format (text|json)', 'text')\n  .action(async (jobId, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const result = await history(client, jobId, { limit: options.limit });\n      writeOutput(formatHistoryOutput(result, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// toc command - Table of contents extraction\n// ============================================================================\nprogram\n  .command('toc <jobId>')\n  .description('Extract table of contents from PDF')\n  .option('--max-depth <n>', 'Maximum TOC depth', parseInt)\n  .option('-f, --format <format>', 'Output format (text|json|markdown)', 'text')\n  .option('--watch', 'Watch live extraction events via WebSocket')\n  .action(async (jobId, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const result = await toc(client, jobId, {\n        maxDepth: options.maxDepth,\n        watch: options.watch,\n      });\n      writeOutput(formatTocOutput(result, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\nprogram.parse();\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/cli/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * okra CLI — Agent-friendly PDF extraction and collection queries.\n *\n * Global flags:\n *   -j, --json       Structured JSON output\n *   -q, --quiet      Suppress progress (just data to stdout)\n *   -o, --output     Write output to file (CSV/JSON/ZIP)\n *\n * Action commands (agent-grade):\n *   okra upload <source>                            # Upload + wait\n *   okra collection list                            # List collections\n *   okra collection query <name> \"<question>\"       # Fan-out → CSV\n *\n * Review commands (existing):\n *   okra tree / find / page / search / tables / history / toc\n *\n * Exit codes: 0=success, 1=client error, 2=server error\n */\n\nimport { Command } from 'commander';\nimport { writeFileSync } from 'fs';\nimport { OkraClient } from '../client';\nimport {\n  tree,\n  formatTreeOutput,\n  find,\n  formatFindOutput,\n  formatStats,\n  pageGet,\n  pageEdit,\n  pageResolve,\n  pageVersions,\n  formatPageOutput,\n  formatVersionsOutput,\n  search,\n  formatSearchOutput,\n  tables,\n  formatTablesOutput,\n  history,\n  formatHistoryOutput,\n  toc,\n  formatTocOutput,\n  authLogin,\n  authSetKey,\n  authStatus,\n  authWhoAmI,\n  authToken,\n  authLogout,\n  upload,\n  collectionList,\n  collectionSetVisibility,\n  collectionQueryRaw,\n  collectionExport,\n  formatCollectionList,\n  formatCollectionCsv,\n  formatCollectionTable,\n  formatQueryJsonl,\n  formatCollectionExportFlat,\n} from './commands';\nimport { getApiKey, getBaseUrl } from './config';\nimport { handleError, writeOutput, progress } from './output';\nimport type { GlobalFlags } from './output';\n\nconst program = new Command();\nprogram.showHelpAfterError();\nprogram.showSuggestionAfterError();\n\nprogram\n  .name('okra')\n  .description('OkraPDF CLI — upload PDFs, query collections, extract data')\n  .version('0.12.1')\n  .option('-j, --json', 'Output JSON (structured, machine-readable)')\n  .option('-q, --quiet', 'Suppress progress and human-readable frills')\n  .option('-o, --output <file>', 'Write output to file instead of stdout');\n\n/** Read global flags from program.opts(). */\nfunction globals(): GlobalFlags {\n  return program.opts();\n}\n\n// Create client with proper config priority:\n// 1. Environment variable (OKRA_API_KEY)\n// 2. Project config (.okrarc, .okra.json)\n// 3. Global config (~/.okra/config.json)\nfunction getClient(): OkraClient {\n  const apiKey = getApiKey();\n  const baseUrl = getBaseUrl();\n\n  if (!apiKey) {\n    const g = globals();\n    if (g.json) {\n      process.stderr.write(JSON.stringify({ error: 'No API key found', code: 401 }) + '\\n');\n    } else {\n      process.stderr.write(\n        'No API key found.\\n\\n' +\n        '  Get one: https://docs.okrapdf.com/api-keys\\n' +\n        '  Then:    export OKRA_API_KEY=\"okra_xxx\"\\n' +\n        '  Or:      npx okra auth login\\n\\n' +\n        '  Docs:    https://docs.okrapdf.com\\n' +\n        '  Discord: https://discord.gg/BHNmbZVs\\n',\n      );\n    }\n    process.exit(1);\n  }\n\n  return new OkraClient({ apiKey, baseUrl });\n}\n\n// ============================================================================\n// upload command\n// ============================================================================\nasync function runUploadCommand(source: string, options: { wait?: boolean }): Promise<void> {\n  const g = globals();\n  try {\n    const client = getClient();\n    const result = await upload(client, source, {\n      ...g,\n      noWait: options.wait === false,\n    });\n\n    if (g.json) {\n      writeOutput(JSON.stringify(result), g.output);\n    } else {\n      const lines = [`Done — ${result.pages ?? '?'} pages`, ''];\n      lines.push(`  ${result.id}`);\n      if (result.urls) {\n        const short = result.id.slice(0, 11) + '...';\n        lines.push('');\n        lines.push(`  Markdown:   ${result.urls.full_md.replace(result.id, short)}`);\n        lines.push(`  Page 1:     ${result.urls.page_png.replace(result.id, short).replace('{N}', '1')}`);\n        lines.push(`  Completion: ${result.urls.completion.replace(result.id, short)}`);\n        lines.push('');\n        lines.push('  URL patterns:');\n        lines.push('    /v1/documents/{id}/pg_{N}.md             page markdown');\n        lines.push('    /v1/documents/{id}/d_shimmer/pg_{N}.png  page image');\n        lines.push('    /v1/documents/{id}/full.md               full document');\n        lines.push('');\n        lines.push('  Docs: https://docs.okrapdf.com  Discord: https://discord.gg/BHNmbZVs');\n      }\n      writeOutput(lines.join('\\n'), g.output);\n    }\n  } catch (error) {\n    handleError(error, g.json);\n  }\n}\n\nfunction registerUploadCommand(commandName: string, description: string): void {\n  program\n    .command(`${commandName} <source>`)\n    .description(description)\n    .option('--no-wait', 'Fire-and-forget (don\\'t wait for processing)')\n    .action(async (source, options) => {\n      await runUploadCommand(source, options);\n    });\n}\n\nregisterUploadCommand('upload', 'Upload a PDF (file path or URL), wait for processing');\nregisterUploadCommand('extract', 'Alias for upload (compatibility)');\n\n// ============================================================================\n// status command\n// ============================================================================\nprogram\n  .command('status <docId>')\n  .description('Get document processing status')\n  .action(async (docId) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const status = await client.status(docId);\n      if (g.json) {\n        writeOutput(JSON.stringify(status), g.output);\n      } else {\n        const lines = [\n          `Document: ${docId}`,\n          `Phase: ${status.phase}`,\n        ];\n        if (typeof status.pagesCompleted === 'number' || typeof status.pagesTotal === 'number') {\n          lines.push(`Pages: ${status.pagesCompleted ?? '?'} / ${status.pagesTotal ?? '?'}`);\n        }\n        writeOutput(lines.join('\\n'), g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// chat command\n// ============================================================================\nprogram\n  .command('chat <question>')\n  .description('Ask a question about a processed document')\n  .requiredOption('--doc <id>', 'Document ID')\n  .option('--model <name>', 'Override model')\n  .action(async (question, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const result = await client.generate(options.doc, question, options.model ? { model: options.model } : undefined);\n\n      if (g.json) {\n        writeOutput(JSON.stringify({ docId: options.doc, question, ...result }), g.output);\n      } else {\n        writeOutput(result.answer, g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// collection command\n// ============================================================================\nconst collectionCmd = program\n  .command('collection')\n  .alias('collections')\n  .alias('col')\n  .description('Collection operations');\n\ncollectionCmd\n  .command('list')\n  .alias('ls')\n  .description('List available collections')\n  .action(async () => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const rows = await collectionList(client, g);\n      writeOutput(formatCollectionList(rows, g.json), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\ncollectionCmd\n  .command('query <nameOrId> <question>')\n  .description('Fan-out query across collection documents')\n  .option('--schema <file>', 'JSON Schema file for structured extraction')\n  .action(async (nameOrId, question, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const { results, summary } = await collectionQueryRaw(\n        client,\n        nameOrId,\n        question,\n        { ...g, schema: options.schema },\n      );\n\n      // Determine output format based on flags\n      if (g.json) {\n        // --json: JSONL events to stdout\n        writeOutput(formatQueryJsonl(results), g.output);\n      } else if (g.output && g.output.endsWith('.csv')) {\n        // -o file.csv → CSV\n        writeOutput(formatCollectionCsv(results), g.output);\n      } else if (g.output) {\n        // -o file.json or other → JSON\n        writeOutput(JSON.stringify({ results, summary }), g.output);\n      } else {\n        // Default: compact table to stdout\n        writeOutput(formatCollectionTable(results));\n      }\n\n      progress(\n        `${summary.completed} completed, ${summary.failed} failed — $${summary.total_cost_usd.toFixed(4)}`,\n        g.quiet,\n      );\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\ncollectionCmd\n  .command('publish <nameOrId>')\n  .description('Make a collection publicly queryable')\n  .action(async (nameOrId) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      await collectionSetVisibility(client, nameOrId, 'public');\n      if (g.json) {\n        writeOutput(JSON.stringify({ ok: true, visibility: 'public', collection: nameOrId }), g.output);\n      } else {\n        writeOutput(\n          `Published \"${nameOrId}\"\\n` +\n          `Share with: okra collection query ${nameOrId} \"your question\"`,\n          g.output,\n        );\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\ncollectionCmd\n  .command('unpublish <nameOrId>')\n  .description('Make a collection private (owner-only)')\n  .action(async (nameOrId) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      await collectionSetVisibility(client, nameOrId, 'private');\n      if (g.json) {\n        writeOutput(JSON.stringify({ ok: true, visibility: 'private', collection: nameOrId }), g.output);\n      } else {\n        writeOutput(`Unpublished \"${nameOrId}\" — now private`, g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\ncollectionCmd\n  .command('export <nameOrId>')\n  .description('Export pre-computed markdown for all documents in a collection')\n  .option('--flat', 'Concatenated markdown with # headers + === separators')\n  .option('--zip', 'One markdown file per document in a .zip archive')\n  .action(async (nameOrId, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n\n      if (options.flat && options.zip) {\n        throw new Error('Use either --flat or --zip, not both');\n      }\n\n      if (options.zip) {\n        const bytes = await collectionExport(client, nameOrId, { ...g, zip: true });\n        const safeBase = String(nameOrId)\n          .trim()\n          .replace(/[^A-Za-z0-9._-]+/g, '-')\n          .replace(/-{2,}/g, '-')\n          .replace(/^[-_.]+|[-_.]+$/g, '') || 'collection-export';\n        const outputPath = g.output || `${safeBase}.zip`;\n        writeFileSync(outputPath, bytes);\n        progress(`Wrote → ${outputPath}`, g.quiet);\n\n        if (g.json) {\n          writeOutput(JSON.stringify({\n            format: 'zip',\n            file: outputPath,\n            bytes: bytes.byteLength,\n          }));\n        }\n        return;\n      }\n\n      const result = await collectionExport(client, nameOrId, { ...g, flat: options.flat });\n\n      if (options.flat) {\n        writeOutput(formatCollectionExportFlat(result), g.output);\n      } else if (g.json) {\n        writeOutput(JSON.stringify(result), g.output);\n      } else {\n        // Default: structured JSON\n        writeOutput(JSON.stringify(result, null, 2), g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// auth command - Authentication management\n// ============================================================================\nconst authCmd = program.command('auth').description('Manage authentication');\n\nauthCmd\n  .command('login')\n  .description('Save API key to global config')\n  .option('-k, --key <apiKey>', 'Set API key non-interactively')\n  .action(async (options) => {\n    try {\n      await authLogin(options.key);\n    } catch (error) {\n      handleError(error, globals().json);\n    }\n  });\n\nauthCmd\n  .command('set-key <apiKey>')\n  .description('Save API key to global config (non-interactive)')\n  .action(async (apiKey) => {\n    try {\n      await authSetKey(apiKey);\n    } catch (error) {\n      handleError(error, globals().json);\n    }\n  });\n\nauthCmd\n  .command('status')\n  .description('Show authentication status')\n  .action(async () => {\n    try {\n      await authStatus();\n    } catch (error) {\n      handleError(error, globals().json);\n    }\n  });\n\nauthCmd\n  .command('whoami')\n  .description('Show current auth identity (alias for status)')\n  .action(async () => {\n    try {\n      await authWhoAmI();\n    } catch (error) {\n      handleError(error, globals().json);\n    }\n  });\n\nauthCmd\n  .command('token')\n  .description('Print active API key to stdout')\n  .action(async () => {\n    try {\n      await authToken();\n    } catch (error) {\n      handleError(error, globals().json);\n    }\n  });\n\nauthCmd\n  .command('logout')\n  .description('Remove API key from global config')\n  .action(async () => {\n    try {\n      await authLogout();\n    } catch (error) {\n      handleError(error, globals().json);\n    }\n  });\n\n// ============================================================================\n// tree command - Document verification tree\n// ============================================================================\nprogram\n  .command('tree <jobId>')\n  .description('Show document verification tree')\n  .option('-s, --status <status>', 'Filter by status (complete|partial|pending|flagged|empty|gap)')\n  .option('-e, --entity <type>', 'Filter by entity type (table|figure|footnote)')\n  .option('-f, --format <format>', 'Output format (text|json|markdown)', 'text')\n  .action(async (jobId, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const result = await tree(client, jobId, {\n        status: options.status,\n        entity: options.entity,\n      });\n      writeOutput(formatTreeOutput(result, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// find command - jQuery-like entity search\n// ============================================================================\nprogram\n  .command('find <jobId> <selector>')\n  .description('Find entities using jQuery-like selectors')\n  .option('-k, --top-k <n>', 'Limit results', parseInt)\n  .option('-c, --min-confidence <n>', 'Minimum confidence (0-1)', parseFloat)\n  .option('-p, --pages <range>', 'Page range (e.g., 1-10)')\n  .option('--sort <by>', 'Sort by (confidence|page|type)')\n  .option('--stats', 'Show aggregate statistics')\n  .option('-f, --format <format>', 'Output format (text|json|entities|ids)', 'text')\n  .action(async (jobId, selector, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const pageRange = options.pages\n        ? options.pages.split('-').map(Number) as [number, number]\n        : undefined;\n\n      const result = await find(client, jobId, selector, {\n        topK: options.topK,\n        minConfidence: options.minConfidence,\n        pageRange,\n        sortBy: options.sort,\n      });\n\n      if (options.stats && fmt === 'text') {\n        writeOutput(formatStats(result.stats), g.output);\n      } else {\n        writeOutput(formatFindOutput(result, fmt, options.stats), g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// page command - Page content operations\n// ============================================================================\nconst pageCmd = program.command('page').description('Page content operations');\n\npageCmd\n  .command('get <jobId> <pageNum>')\n  .description('Get page content')\n  .option('-v, --version <n>', 'Specific version', parseInt)\n  .option('-f, --format <format>', 'Output format (text|json|markdown)', 'markdown')\n  .action(async (jobId, pageNum, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const content = await pageGet(client, jobId, parseInt(pageNum), {\n        version: options.version,\n      });\n      writeOutput(formatPageOutput(content, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\npageCmd\n  .command('edit <jobId> <pageNum>')\n  .description('Edit page content (reads from stdin)')\n  .action(async (jobId, pageNum) => {\n    const g = globals();\n    try {\n      const chunks: Buffer[] = [];\n      for await (const chunk of process.stdin) {\n        chunks.push(chunk);\n      }\n      const content = Buffer.concat(chunks).toString('utf8');\n\n      const client = getClient();\n      const result = await pageEdit(client, jobId, parseInt(pageNum), content);\n      if (g.json) {\n        writeOutput(JSON.stringify({ version: result.version }), g.output);\n      } else {\n        writeOutput(`Saved as version ${result.version}`, g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\npageCmd\n  .command('resolve <jobId> <pageNum> <resolution>')\n  .description('Resolve page verification status')\n  .option('-c, --classification <class>', 'Classification')\n  .option('-r, --reason <reason>', 'Reason')\n  .action(async (jobId, pageNum, resolution, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const result = await pageResolve(client, jobId, parseInt(pageNum), {\n        resolution,\n        classification: options.classification,\n        reason: options.reason,\n      });\n      if (g.json) {\n        writeOutput(JSON.stringify({ success: result.success }), g.output);\n      } else {\n        writeOutput(result.success ? 'Resolved' : 'Failed', g.output);\n      }\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\npageCmd\n  .command('versions <jobId> <pageNum>')\n  .description('List page versions')\n  .option('-f, --format <format>', 'Output format (text|json)', 'text')\n  .action(async (jobId, pageNum, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const versions = await pageVersions(client, jobId, parseInt(pageNum));\n      writeOutput(formatVersionsOutput(versions, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// search command - Full-text search\n// ============================================================================\nprogram\n  .command('search <jobId> <query>')\n  .description('Search page content')\n  .option('-f, --format <format>', 'Output format (text|json)', 'text')\n  .action(async (jobId, query, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const result = await search(client, jobId, query);\n      writeOutput(formatSearchOutput(result, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// tables command - List tables\n// ============================================================================\nprogram\n  .command('tables <jobId>')\n  .description('List extracted tables')\n  .option('-p, --page <n>', 'Filter by page', parseInt)\n  .option('-s, --status <status>', 'Filter by status (pending|verified|flagged|rejected)')\n  .option('-f, --format <format>', 'Output format (text|json|markdown)', 'text')\n  .action(async (jobId, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const result = await tables(client, jobId, {\n        page: options.page,\n        status: options.status,\n      });\n      writeOutput(formatTablesOutput(result, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// history command - Verification audit trail\n// ============================================================================\nprogram\n  .command('history <jobId>')\n  .description('Show verification history')\n  .option('-l, --limit <n>', 'Limit entries', parseInt, 50)\n  .option('-f, --format <format>', 'Output format (text|json)', 'text')\n  .action(async (jobId, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const result = await history(client, jobId, { limit: options.limit });\n      writeOutput(formatHistoryOutput(result, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\n// ============================================================================\n// toc command - Table of contents extraction\n// ============================================================================\nprogram\n  .command('toc <jobId>')\n  .description('Extract table of contents from PDF')\n  .option('--max-depth <n>', 'Maximum TOC depth', parseInt)\n  .option('-f, --format <format>', 'Output format (text|json|markdown)', 'text')\n  .option('--watch', 'Watch live extraction events via WebSocket')\n  .action(async (jobId, options) => {\n    const g = globals();\n    try {\n      const client = getClient();\n      const fmt = g.json ? 'json' : options.format;\n      const result = await toc(client, jobId, {\n        maxDepth: options.maxDepth,\n        watch: options.watch,\n      });\n      writeOutput(formatTocOutput(result, fmt), g.output);\n    } catch (error) {\n      handleError(error, g.json);\n    }\n  });\n\nprogram.parse();\n"],"mappings":"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","names":[]}

package/dist/cli/index.d.ts

@@ -1,5 +1,5 @@
-import { O as OkraClient } from '../client-CdCU6Div.js';
-import '../types-58dvD4Yj.js';
+import { O as OkraClient } from '../client-p82YcAs3.js';
+import '../types-DDm2eEL0.js';
 import 'zod';
 
 /**
@@ -471,11 +471,23 @@ declare function formatTocOutput(result: TocResult, format?: 'text' | 'json' | '
 /**
  * Login command - set API key in global config.
  */
-declare function authLogin(): Promise<void>;
+declare function authLogin(providedApiKey?: string): Promise<void>;
+/**
+ * Set API key non-interactively.
+ */
+declare function authSetKey(apiKey: string): Promise<void>;
 /**
  * Status command - show current auth status.
  */
 declare function authStatus(): Promise<void>;
+/**
+ * Print active API key to stdout (for piping).
+ */
+declare function authToken(): Promise<void>;
+/**
+ * WhoAmI command - currently aliases auth status.
+ */
+declare function authWhoAmI(): Promise<void>;
 /**
  * Logout command - remove API key from global config.
  */
@@ -533,4 +545,4 @@ declare function getBaseUrl(): string | undefined;
  */
 declare function getApiKeySource(): string;
 
-export { type EntitiesResponse, type Entity, type EntityBBox, type EntityType, type FindOptions, type HistoryEntry, type HistoryOptions, type HistoryResponse, type MatchSource, type OkraConfig, 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 TocOptions, type TreeOptions, type TreeResult, type VerificationPageStatus, type VerificationTree, type VerificationTreePage, type VerificationTreeSummary, authLogin, authLogout, authStatus, calculateStats, executeQuery, filterEntities, find, formatFindOutput, formatHistoryOutput, formatPageOutput, formatSearchOutput, formatStats, formatTablesOutput, formatTocOutput, formatTreeOutput, formatVersionsOutput, getApiKey, getApiKeySource, getBaseUrl, getGlobalConfigDir, getGlobalConfigPath, history, pageEdit, pageGet, pageResolve, pageVersions, parseSelector, readGlobalConfig, readProjectConfig, search, tables, toc, tree, writeGlobalConfig };
+export { type EntitiesResponse, type Entity, type EntityBBox, type EntityType, type FindOptions, type HistoryEntry, type HistoryOptions, type HistoryResponse, type MatchSource, type OkraConfig, 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 TocOptions, type TreeOptions, type TreeResult, type VerificationPageStatus, type VerificationTree, type VerificationTreePage, type VerificationTreeSummary, authLogin, authLogout, authSetKey, authStatus, authToken, authWhoAmI, calculateStats, executeQuery, filterEntities, find, formatFindOutput, formatHistoryOutput, formatPageOutput, formatSearchOutput, formatStats, formatTablesOutput, formatTocOutput, formatTreeOutput, formatVersionsOutput, getApiKey, getApiKeySource, getBaseUrl, getGlobalConfigDir, getGlobalConfigPath, history, pageEdit, pageGet, pageResolve, pageVersions, parseSelector, readGlobalConfig, readProjectConfig, search, tables, toc, tree, writeGlobalConfig };

package/dist/cli/index.js

@@ -1,7 +1,10 @@
 import {
   authLogin,
   authLogout,
+  authSetKey,
   authStatus,
+  authToken,
+  authWhoAmI,
   calculateStats,
   executeQuery,
   filterEntities,
@@ -33,12 +36,15 @@ import {
   toc,
   tree,
   writeGlobalConfig
-} from "../chunk-YY44NPDZ.js";
+} from "../chunk-XOHPZW3V.js";
 import "../chunk-NIZM2ETT.js";
 export {
   authLogin,
   authLogout,
+  authSetKey,
   authStatus,
+  authToken,
+  authWhoAmI,
   calculateStats,
   executeQuery,
   filterEntities,

package/dist/{client-CdCU6Div.d.ts → client-p82YcAs3.d.ts}

@@ -1,4 +1,4 @@
-import { b as UploadInput, S as SessionCreateOptions, O as OkraSession, c as SessionAttachOptions, C as CollectionSummary, d as Collection, e as CollectionQueryOptions, f as CollectionQueryStream, g as OkraClientOptions, h as UploadOptions, i as DocumentStatus, W as WaitOptions, P as Page, E as EntitiesResponse, Q as QueryResult, L as LogsOptions, j as LogEntry, k as CompletionOptions, l as CompletionEvent, G as GenerateOptions, m as GenerateResult, n as StructuredSchema, o as PublishResult, p as ShareLinkOptions, q as ShareLinkResult } from './types-58dvD4Yj.js';
+import { b as UploadInput, S as SessionCreateOptions, O as OkraSession, c as SessionAttachOptions, C as CollectionSummary, d as Collection, e as CollectionQueryOptions, f as CollectionQueryStream, g as CollectionExportOptions, h as CollectionMarkdownExport, i as OkraClientOptions, j as UploadOptions, k as DocumentConfigUpdate, l as DocumentConfigResult, R as ReparseOptions, m as ReparseResult, A as ApplyWorkflowOptions, n as ApplyWorkflowResult, o as ApiKeyWorkflowConfigResponse, p as DocumentStatus, W as WaitOptions, P as Page, E as EntitiesResponse, Q as QueryResult, L as LogsOptions, q as LogEntry, r as CompletionOptions, s as CompletionEvent, G as GenerateOptions, t as GenerateResult, u as StructuredSchema, v as PublishResult, w as ShareLinkOptions, x as ShareLinkResult } from './types-DDm2eEL0.js';
 
 declare class OkraClient {
     private readonly baseUrl;
@@ -13,12 +13,20 @@ declare class OkraClient {
         list: (signal?: AbortSignal) => Promise<CollectionSummary[]>;
         get: (collectionId: string, signal?: AbortSignal) => Promise<Collection>;
         query: <T = undefined>(collectionId: string, prompt: string, options?: CollectionQueryOptions<T>) => CollectionQueryStream<T>;
+        exportMarkdown: (collectionId: string, options?: AbortSignal | CollectionExportOptions) => Promise<CollectionMarkdownExport | Uint8Array>;
     };
     constructor(options: OkraClientOptions);
     private collectionList;
     private collectionGet;
     private collectionQuery;
+    private collectionExportPath;
+    private collectionExportMarkdown;
     upload(input: UploadInput, options?: UploadOptions): Promise<OkraSession>;
+    updateConfig(documentId: string, update: DocumentConfigUpdate, signal?: AbortSignal): Promise<DocumentConfigResult>;
+    reparse(documentId: string, options?: ReparseOptions): Promise<ReparseResult>;
+    applyWorkflow(documentId: string, options: ApplyWorkflowOptions): Promise<ApplyWorkflowResult>;
+    getKeyWorkflow(signal?: AbortSignal): Promise<ApiKeyWorkflowConfigResponse>;
+    setKeyWorkflow(defaultCapabilities: ApiKeyWorkflowConfigResponse['default_capabilities'], signal?: AbortSignal): Promise<ApiKeyWorkflowConfigResponse>;
     status(documentId: string, signal?: AbortSignal): Promise<DocumentStatus>;
     wait(documentId: string, options?: WaitOptions): Promise<DocumentStatus>;
     pages(documentId: string, options?: {

package/dist/index.d.ts

@@ -1,9 +1,18 @@
-import { O as OkraClient } from './client-CdCU6Div.js';
-import { g as OkraClientOptions, O as OkraSession, k as CompletionOptions, l as CompletionEvent, r as SessionState, i as DocumentStatus, W as WaitOptions, P as Page, E as EntitiesResponse, Q as QueryResult, L as LogsOptions, j as LogEntry, o as PublishResult, p as ShareLinkOptions, q as ShareLinkResult, G as GenerateOptions, m as GenerateResult, n as StructuredSchema, R as RuntimeErrorCode, s as StructuredOutputErrorCode } from './types-58dvD4Yj.js';
-export { d as Collection, t as CollectionDocument, u as CollectionQueryEvent, e as CollectionQueryOptions, v as CollectionQueryResult, f as CollectionQueryStream, C as CollectionSummary, D as DocUrlOptions, w as DocumentAnswer, x as Entity, J as JsonSchema, y as OkraCollections, z as PageBlock, A as PageEntity, c as SessionAttachOptions, S as SessionCreateOptions, B as ShareLinkCapabilities, F as ShareLinkLinks, H as StructuredOutputMeta, b as UploadInput, h as UploadOptions, I as UploadRedactOptions, K as UploadRedactPiiOptions, U as UrlBuilderOptions } from './types-58dvD4Yj.js';
+import { O as OkraClient } from './client-p82YcAs3.js';
+import { y as ProcessingCapabilities, i as OkraClientOptions, O as OkraSession, r as CompletionOptions, s as CompletionEvent, z as SessionState, p as DocumentStatus, W as WaitOptions, P as Page, E as EntitiesResponse, Q as QueryResult, L as LogsOptions, q as LogEntry, v as PublishResult, w as ShareLinkOptions, x as ShareLinkResult, G as GenerateOptions, t as GenerateResult, u as StructuredSchema, B as RuntimeErrorCode, F as StructuredOutputErrorCode } from './types-DDm2eEL0.js';
+export { o as ApiKeyWorkflowConfigResponse, A as ApplyWorkflowOptions, n as ApplyWorkflowResult, d as Collection, H as CollectionDocument, I as CollectionExportEvent, J as CollectionExportFormat, g as CollectionExportOptions, h as CollectionMarkdownExport, K as CollectionQueryEvent, e as CollectionQueryOptions, M as CollectionQueryResult, f as CollectionQueryStream, C as CollectionSummary, D as DocUrlOptions, N as DocumentAnswer, l as DocumentConfigResult, k as DocumentConfigUpdate, T as DocumentMarkdownExport, V as Entity, X as JsonSchema, Y as MarkdownPage, Z as OkraCollections, _ as PageBlock, $ as PageEntity, R as ReparseOptions, m as ReparseResult, c as SessionAttachOptions, S as SessionCreateOptions, a0 as ShareLinkCapabilities, a1 as ShareLinkLinks, a2 as StructuredOutputMeta, b as UploadInput, j as UploadOptions, a3 as UploadRedactOptions, a4 as UploadRedactPiiOptions, U as UrlBuilderOptions, a5 as WorkflowPhase, a6 as WorkflowPhaseConfig, a7 as WorkflowTier } from './types-DDm2eEL0.js';
 export { doc } from './url.js';
 import 'zod';
 
+type WorkflowPresetName = 'default' | 'llamaparse_ocr' | 'parse_proxy_ocr' | 'docling_ocr';
+declare const DEFAULT_WORKFLOW_CAPABILITIES: ProcessingCapabilities;
+declare const WORKFLOW_PRESETS: Record<WorkflowPresetName, ProcessingCapabilities>;
+/**
+ * Returns immutable capabilities for a named workflow preset.
+ * Optional overrides are deep-merged on top for per-app tuning.
+ */
+declare function workflowPreset(name: WorkflowPresetName, overrides?: ProcessingCapabilities): ProcessingCapabilities;
+
 type ExtractionPhase = 'ocr' | 'enhance' | 'metadata' | 'verify';
 interface OkraProvider {
     name: string;
@@ -17,7 +26,14 @@ interface CreateOkraOptions extends OkraClientOptions {
     providers?: Record<string, OkraProvider>;
     extraction?: Partial<Record<ExtractionPhase, string>>;
     middleware?: OkraMiddleware[];
+    /** Legacy default BYOK keys (prefer `workflow.vendorKeys`). */
     vendorKeys?: Record<string, string>;
+    /** General workflow defaults for all uploads from this client. */
+    workflow?: {
+        preset?: WorkflowPresetName;
+        capabilities?: ProcessingCapabilities;
+        vendorKeys?: Record<string, string>;
+    };
 }
 /**
  * Factory function — AI SDK-style provider abstraction.
@@ -120,4 +136,4 @@ declare class StructuredOutputError extends OkraRuntimeError {
     constructor(code: StructuredOutputErrorCode, message: string, status: number, details?: unknown);
 }
 
-export { type ChatStreamServerEvent, CompletionEvent, CompletionOptions, type CreateOkraOptions, DocumentStatus, EntitiesResponse, type ExtractionPhase, GenerateOptions, GenerateResult, LogEntry, LogsOptions, OkraClient, OkraClientOptions, type OkraMiddleware, type OkraProvider, OkraClient as OkraRuntime, OkraRuntimeError, OkraSession, Page, PublishResult, QueryResult, RuntimeErrorCode, SessionState, ShareLinkOptions, ShareLinkResult, StructuredOutputError, StructuredOutputErrorCode, StructuredSchema, WaitOptions, type WsSendFn, WsSession, type WsSessionOptions, type WsSubscribeFn, createOkra, withCache, withQualityScore, withSecret };
+export { type ChatStreamServerEvent, CompletionEvent, CompletionOptions, type CreateOkraOptions, DEFAULT_WORKFLOW_CAPABILITIES, DocumentStatus, EntitiesResponse, type ExtractionPhase, GenerateOptions, GenerateResult, LogEntry, LogsOptions, OkraClient, OkraClientOptions, type OkraMiddleware, type OkraProvider, OkraClient as OkraRuntime, OkraRuntimeError, OkraSession, Page, ProcessingCapabilities, PublishResult, QueryResult, RuntimeErrorCode, SessionState, ShareLinkOptions, ShareLinkResult, StructuredOutputError, StructuredOutputErrorCode, StructuredSchema, WORKFLOW_PRESETS, WaitOptions, type WorkflowPresetName, type WsSendFn, WsSession, type WsSessionOptions, type WsSubscribeFn, createOkra, withCache, withQualityScore, withSecret, workflowPreset };

package/dist/index.js

@@ -2,14 +2,17 @@ import {
   doc
 } from "./chunk-QKII53VN.js";
 import {
+  DEFAULT_WORKFLOW_CAPABILITIES,
+  WORKFLOW_PRESETS,
   createOkra,
   withCache,
   withQualityScore,
-  withSecret
-} from "./chunk-ADVWUO22.js";
+  withSecret,
+  workflowPreset
+} from "./chunk-YVUL6ZLA.js";
 import {
   OkraClient
-} from "./chunk-XM4MS5WV.js";
+} from "./chunk-2HJPTW6S.js";
 import {
   OkraRuntimeError,
   StructuredOutputError
@@ -145,15 +148,18 @@ var WsSession = class {
   }
 };
 export {
+  DEFAULT_WORKFLOW_CAPABILITIES,
   OkraClient,
   OkraClient as OkraRuntime,
   OkraRuntimeError,
   StructuredOutputError,
+  WORKFLOW_PRESETS,
   WsSession,
   createOkra,
   doc,
   withCache,
   withQualityScore,
-  withSecret
+  withSecret,
+  workflowPreset
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ws-session.ts"],"sourcesContent":["/**\n * WsSession — OkraSession adapter that routes `stream()` over an existing\n * WebSocket connection instead of HTTP SSE.\n *\n * All non-streaming methods delegate to the inner HTTP-backed session.\n * Only `stream()` is overridden to send CHAT_COMPLETION over WS and yield\n * CompletionEvents from CHAT_STREAM_* responses.\n *\n * Usage:\n *   const wsSession = new WsSession(httpSession, { send, subscribe });\n *   const chat = useChat({ session: wsSession });\n */\n\nimport type {\n  OkraSession,\n  CompletionEvent,\n  CompletionOptions,\n  DocumentStatus,\n  WaitOptions,\n  Page,\n  EntitiesResponse,\n  QueryResult,\n  PublishResult,\n  ShareLinkOptions,\n  ShareLinkResult,\n  GenerateOptions,\n  GenerateResult,\n  SessionState,\n  StructuredSchema,\n} from './types';\n\n// Chat stream event types — mirrors @okrapdf/schemas ChatStreamServerEvent\n// Inlined to avoid adding @okrapdf/schemas as a dependency of the published SDK.\n\nexport type ChatStreamServerEvent =\n  | { type: 'CHAT_STREAM_START'; requestId: string }\n  | { type: 'CHAT_STREAM_DELTA'; requestId: string; delta: string }\n  | { type: 'CHAT_STREAM_DONE'; requestId: string; usage?: { inputTokens: number; outputTokens: number; costUsd: number }; model?: string }\n  | { type: 'CHAT_STREAM_ERROR'; requestId: string; error: string };\n\n/** Function that sends a JSON string over the WebSocket. Returns false if WS is closed. */\nexport type WsSendFn = (message: string) => boolean;\n\n/** Subscribe to chat stream events. Returns unsubscribe function. */\nexport type WsSubscribeFn = (\n  requestId: string,\n  handler: (event: ChatStreamServerEvent) => void,\n) => () => void;\n\nexport interface WsSessionOptions {\n  /** Send JSON string over the existing WebSocket connection */\n  send: WsSendFn;\n  /** Subscribe to CHAT_STREAM_* events for a given requestId */\n  subscribe: WsSubscribeFn;\n}\n\nfunction uuid(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID();\n  }\n  return `${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport class WsSession implements OkraSession {\n  readonly id: string;\n  readonly modelEndpoint: string;\n  readonly model?: string;\n\n  #inner: OkraSession;\n  #opts: WsSessionOptions;\n\n  constructor(inner: OkraSession, opts: WsSessionOptions) {\n    this.#inner = inner;\n    this.#opts = opts;\n    this.id = inner.id;\n    this.modelEndpoint = inner.modelEndpoint;\n    this.model = inner.model;\n  }\n\n  // ── Overridden: stream via WebSocket ──────────────────────────────────────\n\n  async *stream(\n    query: string,\n    options?: CompletionOptions,\n  ): AsyncGenerator<CompletionEvent> {\n    const requestId = uuid();\n\n    // Build message history (single user message for now — matches HTTP path)\n    const messages = [{ role: 'user', content: query }];\n\n    const sent = this.#opts.send(JSON.stringify({\n      type: 'CHAT_COMPLETION',\n      requestId,\n      messages,\n    }));\n\n    if (!sent) {\n      yield { type: 'error', message: 'WebSocket not connected' };\n      return;\n    }\n\n    // Create a promise-based event queue\n    type QueueItem =\n      | { done: false; event: ChatStreamServerEvent }\n      | { done: true };\n\n    const queue: QueueItem[] = [];\n    let resolve: (() => void) | null = null;\n    let finished = false;\n\n    const unsubscribe = this.#opts.subscribe(requestId, (event) => {\n      if (finished) return;\n      queue.push({ done: false, event });\n      resolve?.();\n    });\n\n    const cleanup = () => {\n      finished = true;\n      unsubscribe();\n    };\n\n    // Handle abort signal\n    if (options?.signal) {\n      options.signal.addEventListener('abort', () => {\n        cleanup();\n        queue.push({ done: true });\n        resolve?.();\n      }, { once: true });\n    }\n\n    try {\n      let fullText = '';\n\n      while (true) {\n        if (queue.length === 0) {\n          await new Promise<void>((r) => { resolve = r; });\n          resolve = null;\n        }\n\n        const item = queue.shift();\n        if (!item || item.done) break;\n\n        const evt = item.event;\n\n        switch (evt.type) {\n          case 'CHAT_STREAM_START':\n            // No CompletionEvent for start — just skip\n            break;\n\n          case 'CHAT_STREAM_DELTA':\n            fullText += evt.delta;\n            yield { type: 'text_delta', text: evt.delta };\n            break;\n\n          case 'CHAT_STREAM_DONE':\n            yield { type: 'done', answer: fullText };\n            cleanup();\n            return;\n\n          case 'CHAT_STREAM_ERROR':\n            yield { type: 'error', message: evt.error };\n            cleanup();\n            return;\n        }\n      }\n    } finally {\n      cleanup();\n    }\n  }\n\n  // ── Delegated to inner HTTP session ───────────────────────────────────────\n\n  state(): SessionState { return this.#inner.state(); }\n  setModel(model: string): Promise<void> { return this.#inner.setModel(model); }\n  status(signal?: AbortSignal): Promise<DocumentStatus> { return this.#inner.status(signal); }\n  wait(options?: WaitOptions): Promise<DocumentStatus> { return this.#inner.wait(options); }\n  pages(options?: { range?: string; signal?: AbortSignal }): Promise<Page[]> { return this.#inner.pages(options); }\n  page(pageNumber: number, signal?: AbortSignal): Promise<Page> { return this.#inner.page(pageNumber, signal); }\n  entities(options?: { type?: string; limit?: number; offset?: number; signal?: AbortSignal }): Promise<EntitiesResponse> { return this.#inner.entities(options); }\n  downloadUrl(): string { return this.#inner.downloadUrl(); }\n  query(sql: string, signal?: AbortSignal): Promise<QueryResult> { return this.#inner.query(sql, signal); }\n  logs(options?: import('./types').LogsOptions): Promise<import('./types').LogEntry[]> { return this.#inner.logs(options); }\n  publish(signal?: AbortSignal): Promise<PublishResult> { return this.#inner.publish(signal); }\n  shareLink(options?: ShareLinkOptions): Promise<ShareLinkResult> { return this.#inner.shareLink(options); }\n\n  prompt(query: string, options?: GenerateOptions & { schema?: undefined }): Promise<GenerateResult>;\n  prompt<T>(query: string, options: GenerateOptions & { schema: StructuredSchema<T> }): Promise<GenerateResult<T>>;\n  prompt<T = undefined>(query: string, options?: GenerateOptions): Promise<GenerateResult<T>> {\n    if (options?.schema !== undefined) {\n      return this.#inner.prompt(query, options as GenerateOptions & { schema: StructuredSchema<unknown> }) as Promise<GenerateResult<T>>;\n    }\n    return this.#inner.prompt(query, options as GenerateOptions & { schema?: undefined }) as Promise<GenerateResult<T>>;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/ws-session.ts"],"sourcesContent":["/**\n * WsSession — OkraSession adapter that routes `stream()` over an existing\n * WebSocket connection instead of HTTP SSE.\n *\n * All non-streaming methods delegate to the inner HTTP-backed session.\n * Only `stream()` is overridden to send CHAT_COMPLETION over WS and yield\n * CompletionEvents from CHAT_STREAM_* responses.\n *\n * Usage:\n *   const wsSession = new WsSession(httpSession, { send, subscribe });\n *   const chat = useChat({ session: wsSession });\n */\n\nimport type {\n  OkraSession,\n  CompletionEvent,\n  CompletionOptions,\n  DocumentStatus,\n  WaitOptions,\n  Page,\n  EntitiesResponse,\n  QueryResult,\n  PublishResult,\n  ShareLinkOptions,\n  ShareLinkResult,\n  GenerateOptions,\n  GenerateResult,\n  SessionState,\n  StructuredSchema,\n} from './types';\n\n// Chat stream event types — mirrors @okrapdf/schemas ChatStreamServerEvent\n// Inlined to avoid adding @okrapdf/schemas as a dependency of the published SDK.\n\nexport type ChatStreamServerEvent =\n  | { type: 'CHAT_STREAM_START'; requestId: string }\n  | { type: 'CHAT_STREAM_DELTA'; requestId: string; delta: string }\n  | { type: 'CHAT_STREAM_DONE'; requestId: string; usage?: { inputTokens: number; outputTokens: number; costUsd: number }; model?: string }\n  | { type: 'CHAT_STREAM_ERROR'; requestId: string; error: string };\n\n/** Function that sends a JSON string over the WebSocket. Returns false if WS is closed. */\nexport type WsSendFn = (message: string) => boolean;\n\n/** Subscribe to chat stream events. Returns unsubscribe function. */\nexport type WsSubscribeFn = (\n  requestId: string,\n  handler: (event: ChatStreamServerEvent) => void,\n) => () => void;\n\nexport interface WsSessionOptions {\n  /** Send JSON string over the existing WebSocket connection */\n  send: WsSendFn;\n  /** Subscribe to CHAT_STREAM_* events for a given requestId */\n  subscribe: WsSubscribeFn;\n}\n\nfunction uuid(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID();\n  }\n  return `${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport class WsSession implements OkraSession {\n  readonly id: string;\n  readonly modelEndpoint: string;\n  readonly model?: string;\n\n  #inner: OkraSession;\n  #opts: WsSessionOptions;\n\n  constructor(inner: OkraSession, opts: WsSessionOptions) {\n    this.#inner = inner;\n    this.#opts = opts;\n    this.id = inner.id;\n    this.modelEndpoint = inner.modelEndpoint;\n    this.model = inner.model;\n  }\n\n  // ── Overridden: stream via WebSocket ──────────────────────────────────────\n\n  async *stream(\n    query: string,\n    options?: CompletionOptions,\n  ): AsyncGenerator<CompletionEvent> {\n    const requestId = uuid();\n\n    // Build message history (single user message for now — matches HTTP path)\n    const messages = [{ role: 'user', content: query }];\n\n    const sent = this.#opts.send(JSON.stringify({\n      type: 'CHAT_COMPLETION',\n      requestId,\n      messages,\n    }));\n\n    if (!sent) {\n      yield { type: 'error', message: 'WebSocket not connected' };\n      return;\n    }\n\n    // Create a promise-based event queue\n    type QueueItem =\n      | { done: false; event: ChatStreamServerEvent }\n      | { done: true };\n\n    const queue: QueueItem[] = [];\n    let resolve: (() => void) | null = null;\n    let finished = false;\n\n    const unsubscribe = this.#opts.subscribe(requestId, (event) => {\n      if (finished) return;\n      queue.push({ done: false, event });\n      resolve?.();\n    });\n\n    const cleanup = () => {\n      finished = true;\n      unsubscribe();\n    };\n\n    // Handle abort signal\n    if (options?.signal) {\n      options.signal.addEventListener('abort', () => {\n        cleanup();\n        queue.push({ done: true });\n        resolve?.();\n      }, { once: true });\n    }\n\n    try {\n      let fullText = '';\n\n      while (true) {\n        if (queue.length === 0) {\n          await new Promise<void>((r) => { resolve = r; });\n          resolve = null;\n        }\n\n        const item = queue.shift();\n        if (!item || item.done) break;\n\n        const evt = item.event;\n\n        switch (evt.type) {\n          case 'CHAT_STREAM_START':\n            // No CompletionEvent for start — just skip\n            break;\n\n          case 'CHAT_STREAM_DELTA':\n            fullText += evt.delta;\n            yield { type: 'text_delta', text: evt.delta };\n            break;\n\n          case 'CHAT_STREAM_DONE':\n            yield { type: 'done', answer: fullText };\n            cleanup();\n            return;\n\n          case 'CHAT_STREAM_ERROR':\n            yield { type: 'error', message: evt.error };\n            cleanup();\n            return;\n        }\n      }\n    } finally {\n      cleanup();\n    }\n  }\n\n  // ── Delegated to inner HTTP session ───────────────────────────────────────\n\n  state(): SessionState { return this.#inner.state(); }\n  setModel(model: string): Promise<void> { return this.#inner.setModel(model); }\n  status(signal?: AbortSignal): Promise<DocumentStatus> { return this.#inner.status(signal); }\n  wait(options?: WaitOptions): Promise<DocumentStatus> { return this.#inner.wait(options); }\n  pages(options?: { range?: string; signal?: AbortSignal }): Promise<Page[]> { return this.#inner.pages(options); }\n  page(pageNumber: number, signal?: AbortSignal): Promise<Page> { return this.#inner.page(pageNumber, signal); }\n  entities(options?: { type?: string; limit?: number; offset?: number; signal?: AbortSignal }): Promise<EntitiesResponse> { return this.#inner.entities(options); }\n  downloadUrl(): string { return this.#inner.downloadUrl(); }\n  query(sql: string, signal?: AbortSignal): Promise<QueryResult> { return this.#inner.query(sql, signal); }\n  logs(options?: import('./types').LogsOptions): Promise<import('./types').LogEntry[]> { return this.#inner.logs(options); }\n  publish(signal?: AbortSignal): Promise<PublishResult> { return this.#inner.publish(signal); }\n  shareLink(options?: ShareLinkOptions): Promise<ShareLinkResult> { return this.#inner.shareLink(options); }\n\n  prompt(query: string, options?: GenerateOptions & { schema?: undefined }): Promise<GenerateResult>;\n  prompt<T>(query: string, options: GenerateOptions & { schema: StructuredSchema<T> }): Promise<GenerateResult<T>>;\n  prompt<T = undefined>(query: string, options?: GenerateOptions): Promise<GenerateResult<T>> {\n    if (options?.schema !== undefined) {\n      return this.#inner.prompt(query, options as GenerateOptions & { schema: StructuredSchema<unknown> }) as Promise<GenerateResult<T>>;\n    }\n    return this.#inner.prompt(query, options as GenerateOptions & { schema?: undefined }) as Promise<GenerateResult<T>>;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/react/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
-import { O as OkraClient } from '../client-CdCU6Div.js';
-import { O as OkraSession, i as DocumentStatus, P as Page, n as StructuredSchema, m as GenerateResult } from '../types-58dvD4Yj.js';
-export { l as CompletionEvent } from '../types-58dvD4Yj.js';
+import { O as OkraClient } from '../client-p82YcAs3.js';
+import { O as OkraSession, p as DocumentStatus, P as Page, u as StructuredSchema, t as GenerateResult } from '../types-DDm2eEL0.js';
+export { s as CompletionEvent } from '../types-DDm2eEL0.js';
 import 'zod';
 
 interface OkraContextValue {

package/dist/react/index.js

@@ -1,7 +1,7 @@
 import {
   createOkra
-} from "../chunk-ADVWUO22.js";
-import "../chunk-XM4MS5WV.js";
+} from "../chunk-YVUL6ZLA.js";
+import "../chunk-2HJPTW6S.js";
 import "../chunk-NIZM2ETT.js";
 
 // src/react/provider.ts