@okrapdf/cli 0.3.1 → 0.3.3

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -53,7 +53,8 @@ export function createProgram() {
         .version(VERSION, '-v, --version', 'Output the version number')
         .option('-q, --quiet', 'Suppress non-essential output (ideal for piping)')
         .option('-V, --verbose', 'Enable verbose diagnostics (retries and debug logging)')
-        .option('--json', 'Shorthand for -o json (machine-readable output)')
+        .option('--json [fields]', 'JSON output, optionally with comma-separated field names')
+        .option('--jq <expression>', 'Filter JSON output with a jq expression')
         .option('--no-color', 'Disable colored output');
     // Core commands
     program.addCommand(createAuthCommand());
@@ -75,12 +76,22 @@ export function createProgram() {
     program.addCommand(createLogsCommand());
     program.addCommand(createProvidersCommand());
     program.addCommand(createVlmCommand());
-    // Handle global --json flag
+    // Handle global --json / --jq flags
     program.hook('preAction', (thisCommand, actionCommand) => {
         const target = actionCommand || thisCommand;
         const opts = target.optsWithGlobals();
+        // --jq implies JSON mode
+        if (opts.jq) {
+            process.env.OKRA_JQ = opts.jq;
+            if (!opts.json)
+                opts.json = true;
+        }
         if (opts.json) {
             process.env.OKRA_OUTPUT_FORMAT = 'json';
+            // --json field1,field2 → store fields for filtering
+            if (typeof opts.json === 'string') {
+                process.env.OKRA_JSON_FIELDS = opts.json;
+            }
             const hasOutputOption = target.options.some((option) => option.attributeName() === 'output');
             if (hasOutputOption && target.getOptionValueSource('output') !== 'cli') {
                 target.setOptionValueWithSource('output', 'json', 'env');
@@ -111,8 +122,11 @@ ${chalk.bold('For AI Agents (Machine-Readable Output):')}
   ${chalk.dim('# Get tables as JSON (for building presentations, reports)')}
   $ okra extract document.pdf --json --quiet
 
-  ${chalk.dim('# Get job list as JSON for processing')}
-  $ okra jobs list -o json | jq '.[].job_id'
+  ${chalk.dim('# Get job list as JSON, select fields')}
+  $ okra jobs list --json job_id,status
+
+  ${chalk.dim('# Filter JSON output with jq')}
+  $ okra jobs list --jq '.[0].job_id'
 
   ${chalk.dim('# Extract with specific processor')}
   $ okra jobs create document.pdf -p gemini --wait -o json

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;AAE9B,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,0DAA0D,CAAC;SACvE,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,2BAA2B,CAAC;SAC9D,MAAM,CAAC,aAAa,EAAE,kDAAkD,CAAC;SACzE,MAAM,CAAC,eAAe,EAAE,wDAAwD,CAAC;SACjF,MAAM,CAAC,iBAAiB,EAAE,0DAA0D,CAAC;SACrF,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,CAAC;SACtE,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;IAElD,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAE7C,4CAA4C;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEvC,wDAAwD;IACxD,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEvC,oCAAoC;IACpC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE;QACvD,MAAM,MAAM,GAAG,aAAa,IAAI,WAAW,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,EAAgF,CAAC;QAEpH,yBAAyB;QACzB,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnC,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,MAAM,CAAC;YAExC,oDAAoD;YACpD,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC;YAC3C,CAAC;YAED,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,QAAQ,CAAC,CAAC;YAC7F,IAAI,eAAe,IAAI,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;gBACvE,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QAC/B,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE;EAC7B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC;;IAExB,KAAK,CAAC,GAAG,CAAC,6CAA6C,CAAC;;;IAGxD,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC;;;IAGxC,KAAK,CAAC,GAAG,CAAC,mCAAmC,CAAC;;;EAGhD,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC;;IAEpD,KAAK,CAAC,GAAG,CAAC,4DAA4D,CAAC;;;IAGvE,KAAK,CAAC,GAAG,CAAC,uCAAuC,CAAC;;;IAGlD,KAAK,CAAC,GAAG,CAAC,8BAA8B,CAAC;;;IAGzC,KAAK,CAAC,GAAG,CAAC,mCAAmC,CAAC;;;IAG9C,KAAK,CAAC,GAAG,CAAC,kCAAkC,CAAC;;;EAG/C,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC;;IAE7B,KAAK,CAAC,GAAG,CAAC,kCAAkC,CAAC;;;IAG7C,KAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC;;;IAGvD,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC;;;IAGxC,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC;;;IAGxC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC;;;EAGjC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC;;IAElC,KAAK,CAAC,GAAG,CAAC,6CAA6C,CAAC;;;IAGxD,KAAK,CAAC,GAAG,CAAC,uCAAuC,CAAC;;;IAGlD,KAAK,CAAC,GAAG,CAAC,mCAAmC,CAAC;;;IAG9C,KAAK,CAAC,GAAG,CAAC,mCAAmC,CAAC;;;EAGhD,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC;;IAEhC,KAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC;;;IAGhD,KAAK,CAAC,GAAG,CAAC,oDAAoD,CAAC;;;IAG/D,KAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC;;;EAGlD,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC;;;;;;;;EAQpC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC;;mBAEd,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC;mBAC1C,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC;CAC9D,CAAC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAiB,OAAO,CAAC,IAAI;IACrD,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;QAChC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEnB,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,cAAc,GAAI,GAAqC,CAAC,QAAQ,CAAC;QAEvE,0BAA0B;QAC1B,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC9E,KAAK,CAAC,+DAA+D,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,qCAAqC,CAAC,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEnB,iCAAiC;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAC/F,CAAC;IAED,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACzC,CAAC"}

package/dist/cli.test.js

@@ -1,35 +1,202 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+// Mock client module before importing anything that uses it
+vi.mock('./lib/client.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        get: vi.fn(),
+    };
+});
 import { createProgram } from './cli.js';
+import { get } from './lib/client.js';
+const mockedGet = vi.mocked(get);
 const ORIGINAL_ENV = process.env;
-describe('global output behavior', () => {
+const FAKE_JOBS_RESPONSE = {
+    items: [
+        {
+            job_id: 'ocr-abc123',
+            status: 'completed',
+            filename: 'invoice.pdf',
+            total_pages: 10,
+            pages_completed: 10,
+            error: null,
+            created_at: '2026-02-15T00:00:00Z',
+            updated_at: '2026-02-15T01:00:00Z',
+            viewer_url: 'https://app.okrapdf.com/ocr/ocr-abc123',
+        },
+        {
+            job_id: 'ocr-xyz789',
+            status: 'running',
+            filename: 'report.pdf',
+            total_pages: 5,
+            pages_completed: 2,
+            error: null,
+            created_at: '2026-02-16T00:00:00Z',
+            updated_at: '2026-02-16T01:00:00Z',
+            viewer_url: 'https://app.okrapdf.com/ocr/ocr-xyz789',
+        },
+    ],
+    pagination: { page: 1, totalPages: 1, total: 2 },
+};
+function cleanEnv() {
+    process.env = { ...ORIGINAL_ENV };
+    delete process.env.OKRA_OUTPUT_FORMAT;
+    delete process.env.OKRA_JSON_FIELDS;
+    delete process.env.OKRA_JQ;
+    delete process.env.OKRA_QUIET;
+    delete process.env.OKRA_VERBOSE;
+}
+describe('global --json flag', () => {
+    beforeEach(cleanEnv);
+    afterEach(() => {
+        process.env = ORIGINAL_ENV;
+        vi.restoreAllMocks();
+    });
+    it('--json exit_codes filters to only that field', async () => {
+        const out = [];
+        vi.spyOn(console, 'log').mockImplementation((...args) => {
+            out.push(args.join(' '));
+        });
+        const program = createProgram();
+        // --json takes 'exit_codes' as the field filter, 'exit-codes' is the subcommand
+        await program.parseAsync(['--json', 'exit_codes', 'exit-codes'], { from: 'user' });
+        const payload = JSON.parse(out.join('\n'));
+        expect(payload).toHaveProperty('exit_codes');
+        expect(Object.keys(payload)).toEqual(['exit_codes']);
+    });
+});
+describe('--json field filtering with jobs list', () => {
     beforeEach(() => {
-        process.env = { ...ORIGINAL_ENV };
-        delete process.env.OKRA_OUTPUT_FORMAT;
-        delete process.env.OKRA_QUIET;
-        delete process.env.OKRA_VERBOSE;
+        cleanEnv();
+        process.env.OKRA_API_KEY = 'test-key';
     });
     afterEach(() => {
         process.env = ORIGINAL_ENV;
         vi.restoreAllMocks();
+        mockedGet.mockReset();
+    });
+    it('--json filename (before subcommand) returns only filename', async () => {
+        mockedGet.mockResolvedValueOnce(FAKE_JOBS_RESPONSE);
+        const out = [];
+        vi.spyOn(console, 'log').mockImplementation((...args) => {
+            out.push(args.join(' '));
+        });
+        const program = createProgram();
+        await program.parseAsync(['--json', 'filename', 'jobs', 'list'], { from: 'user' });
+        const payload = JSON.parse(out.join('\n'));
+        expect(Array.isArray(payload)).toBe(true);
+        expect(payload).toHaveLength(2);
+        for (const item of payload) {
+            expect(Object.keys(item)).toEqual(['filename']);
+        }
+        expect(payload[0].filename).toBe('invoice.pdf');
+    });
+    it('--json job_id,status returns only those two fields', async () => {
+        mockedGet.mockResolvedValueOnce(FAKE_JOBS_RESPONSE);
+        const out = [];
+        vi.spyOn(console, 'log').mockImplementation((...args) => {
+            out.push(args.join(' '));
+        });
+        const program = createProgram();
+        await program.parseAsync(['--json', 'job_id,status', 'jobs', 'list'], { from: 'user' });
+        const payload = JSON.parse(out.join('\n'));
+        expect(Array.isArray(payload)).toBe(true);
+        for (const item of payload) {
+            expect(Object.keys(item).sort()).toEqual(['job_id', 'status']);
+        }
     });
-    it('applies global --json as output override when -o is not specified', async () => {
+    it('--json filename (after subcommand) also filters correctly', async () => {
+        mockedGet.mockResolvedValueOnce(FAKE_JOBS_RESPONSE);
         const out = [];
         vi.spyOn(console, 'log').mockImplementation((...args) => {
             out.push(args.join(' '));
         });
         const program = createProgram();
-        await program.parseAsync(['--json', 'exit-codes'], { from: 'user' });
+        await program.parseAsync(['jobs', 'list', '--json', 'filename', '-l', '5'], { from: 'user' });
         const payload = JSON.parse(out.join('\n'));
-        expect(payload.exit_codes.general_error).toBe(1);
+        expect(Array.isArray(payload)).toBe(true);
+        for (const item of payload) {
+            expect(Object.keys(item)).toEqual(['filename']);
+        }
     });
-    it('keeps explicit -o value over global --json', async () => {
+    it('full run() simulation with bootstrapGlobalEnv', async () => {
+        const { bootstrapGlobalEnv } = await import('./lib/runtime.js');
+        const argv = ['node', 'okra', 'jobs', 'list', '--json', 'filename', '-l', '5'];
+        bootstrapGlobalEnv(argv);
+        mockedGet.mockResolvedValueOnce(FAKE_JOBS_RESPONSE);
         const out = [];
         vi.spyOn(console, 'log').mockImplementation((...args) => {
             out.push(args.join(' '));
         });
         const program = createProgram();
-        await program.parseAsync(['--json', 'exit-codes', '-o', 'table'], { from: 'user' });
-        expect(() => JSON.parse(out.join('\n'))).toThrow();
+        await program.parseAsync(argv);
+        const payload = JSON.parse(out.join('\n'));
+        expect(Array.isArray(payload)).toBe(true);
+        for (const item of payload) {
+            expect(Object.keys(item)).toEqual(['filename']);
+        }
+    });
+});
+describe('JSON output cleanliness (gh CLI patterns)', () => {
+    beforeEach(() => {
+        cleanEnv();
+        process.env.OKRA_API_KEY = 'test-key';
+    });
+    afterEach(() => {
+        process.env = ORIGINAL_ENV;
+        vi.restoreAllMocks();
+        mockedGet.mockReset();
+    });
+    it('suppresses pagination footer in JSON mode', async () => {
+        const multiPageResponse = {
+            ...FAKE_JOBS_RESPONSE,
+            pagination: { page: 1, totalPages: 35, total: 699 },
+        };
+        mockedGet.mockResolvedValueOnce(multiPageResponse);
+        const out = [];
+        vi.spyOn(console, 'log').mockImplementation((...args) => {
+            out.push(args.join(' '));
+        });
+        const program = createProgram();
+        await program.parseAsync(['--json', 'job_id', 'jobs', 'list'], { from: 'user' });
+        const raw = out.join('\n');
+        // Should be valid JSON with no trailing "Page X of Y" text
+        expect(() => JSON.parse(raw)).not.toThrow();
+        expect(raw).not.toContain('Page');
+        expect(raw).not.toContain('total');
+    });
+    it('shows pagination footer in table mode', async () => {
+        const multiPageResponse = {
+            ...FAKE_JOBS_RESPONSE,
+            pagination: { page: 1, totalPages: 35, total: 699 },
+        };
+        mockedGet.mockResolvedValueOnce(multiPageResponse);
+        const out = [];
+        vi.spyOn(console, 'log').mockImplementation((...args) => {
+            out.push(args.join(' '));
+        });
+        const program = createProgram();
+        await program.parseAsync(['jobs', 'list'], { from: 'user' });
+        const raw = out.join('\n');
+        expect(raw).toContain('Page 1 of 35');
+        expect(raw).toContain('699 total');
+    });
+});
+describe('bootstrapGlobalEnv', () => {
+    beforeEach(cleanEnv);
+    afterEach(() => {
+        process.env = ORIGINAL_ENV;
+    });
+    it('--json sets OKRA_OUTPUT_FORMAT', async () => {
+        const { bootstrapGlobalEnv } = await import('./lib/runtime.js');
+        bootstrapGlobalEnv(['node', 'okra', 'jobs', 'list', '--json']);
+        expect(process.env.OKRA_OUTPUT_FORMAT).toBe('json');
+    });
+    it('--json=fields sets OKRA_JSON_FIELDS', async () => {
+        const { bootstrapGlobalEnv } = await import('./lib/runtime.js');
+        bootstrapGlobalEnv(['node', 'okra', 'jobs', 'list', '--json=filename,status']);
+        expect(process.env.OKRA_OUTPUT_FORMAT).toBe('json');
+        expect(process.env.OKRA_JSON_FIELDS).toBe('filename,status');
     });
 });
 //# sourceMappingURL=cli.test.js.map

package/dist/cli.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.test.js","sourceRoot":"","sources":["../src/cli.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;AAEjC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACtC,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,GAAG,GAAG,YAAY,CAAC;QAC3B,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE;YACtD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;QAChC,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAErE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAA2C,CAAC;QACrF,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE;YACtD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;QAChC,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAEpF,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.test.js","sourceRoot":"","sources":["../src/cli.test.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,uBAAuB,CAAC;AAE/B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,wBAAgB,iBAAiB,IAAI,OAAO,CAiM3C"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,uBAAuB,CAAC;AAE/B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,iBAAiB,IAAI,OAAO,CA6W3C"}

package/dist/commands/chat.js

@@ -22,22 +22,48 @@ import '../lib/ws-polyfill.js';
 import { Command } from 'commander';
 import { AgentSessionClient } from '@steventsao/agent-session';
 import { fetchBootstrap } from '../lib/bootstrap.js';
-import { AgentRenderer } from '../lib/agent-renderer.js';
-import { CLI_SYSTEM_PROMPT } from '../lib/system-prompt.js';
-import { getApiKey } from '../lib/config.js';
+import { AgentRenderer, SilentCollectorRenderer } from '../lib/agent-renderer.js';
+import { buildSystemPrompt } from '../lib/system-prompt.js';
+import { getApiKey, getAgentSessionUrl, getAgentSessionHttpUrl } from '../lib/config.js';
 import { error, info } from '../lib/output.js';
 import { createSpinner } from '../lib/progress.js';
 import { OkraApiError, EXIT_CODES } from '../lib/client.js';
-const WSS_URL = 'wss://agent-session.steventsao.workers.dev';
+import { resolveSchema, extractJson, listBuiltinNames, } from '../lib/structured-output.js';
+const WSS_URL = getAgentSessionUrl();
 const SANDBOX_TEMPLATE = 'okra-claude-agent-sdk';
 const SANDBOX_TIMEOUT_MS = 120_000;
 export function createChatCommand() {
     const chat = new Command('chat')
-        .description('Chat with a document via agent session')
+        .description('Chat with a document via agent session');
+    // Default subcommand: okra chat <jobId> -m "msg"
+    const send = new Command('send')
+        .description('Send a message to a document chat session')
         .argument('<jobId>', 'OCR job ID (e.g. ocr-Bvx9ire6wFEHbsjecW3FM)')
         .requiredOption('-m, --message <message>', 'Message to send')
         .option('-o, --output <format>', 'Output format (text, json)', 'text')
+        .option('-s, --schema <schema>', 'Structured output: built-in name, inline JSON, or file path')
         .action(async (jobId, options) => {
+        // Handle --schema help
+        if (options.schema === 'help') {
+            console.log('Built-in schemas:');
+            for (const name of listBuiltinNames()) {
+                console.log(`  ${name}`);
+            }
+            console.log('\nYou can also pass inline JSON or a file path:');
+            console.log('  --schema \'{"type":"object","properties":{"name":{"type":"string"}}}\'');
+            console.log('  --schema ./my-schema.json');
+            process.exit(0);
+        }
+        // Resolve schema (built-in name, inline JSON, or file path)
+        let resolvedSchema;
+        if (options.schema) {
+            const result = resolveSchema(options.schema);
+            if ('error' in result) {
+                error(result.error);
+                process.exit(EXIT_CODES.INVALID_ARGS);
+            }
+            resolvedSchema = result.schema;
+        }
         const apiKey = getApiKey();
         if (!apiKey) {
             error('Not authenticated. Run `okra auth login` first.');
@@ -68,7 +94,9 @@ export function createChatCommand() {
             process.exit(EXIT_CODES.GENERAL_ERROR);
         }
         // 2. Connect WebSocket
-        const renderer = new AgentRenderer();
+        const renderer = resolvedSchema
+            ? new SilentCollectorRenderer()
+            : new AgentRenderer();
         const client = new AgentSessionClient({
             url: WSS_URL,
             sessionId: jobId,
@@ -141,6 +169,8 @@ export function createChatCommand() {
                 return;
             renderer.onAgentStarted();
         });
+        // Capture structured_output from SDK result event
+        let structuredOutput = undefined;
         client.on('AGENT_MESSAGE', (event) => {
             if (!messageSent)
                 return;
@@ -151,6 +181,10 @@ export function createChatCommand() {
                 rejectAgent(new Error(String(errMsg)));
                 return;
             }
+            // Capture SDK structured_output from result event
+            if (event.subtype === 'result' && event.structured_output != null) {
+                structuredOutput = event.structured_output;
+            }
             renderer.onAgentMessage(event.message?.content);
         });
         client.on('AGENT_DONE', (event) => {
@@ -188,17 +222,27 @@ export function createChatCommand() {
         await replayDone;
         // 7. Send message — flip gate so subsequent events are rendered
         messageSent = true;
-        info(`Sending: ${options.message}`);
+        if (!resolvedSchema)
+            info(`Sending: ${options.message}`);
+        const systemPrompt = buildSystemPrompt({ schema: resolvedSchema });
         // Send raw AGENT_MESSAGE so author metadata is preserved across
         // older @steventsao/agent-session client versions used by the CLI.
-        client.send({
+        const wsMessage = {
             type: 'AGENT_MESSAGE',
             content: options.message,
             model: { id: 'claude-sonnet-4-20250514', provider: 'anthropic' },
-            systemPrompt: CLI_SYSTEM_PROMPT,
+            systemPrompt,
             agentType: 'claude-code',
             author: { name: 'okra-cli', clientType: 'cli' },
-        });
+        };
+        // Send JSON Schema for SDK-native structured output
+        if (resolvedSchema) {
+            wsMessage.outputFormat = {
+                type: 'json_schema',
+                schema: resolvedSchema.jsonSchema,
+            };
+        }
+        client.send(wsMessage);
         // 8. Wait for agent completion
         try {
             await agentDone;
@@ -207,10 +251,202 @@ export function createChatCommand() {
             error(err instanceof Error ? err.message : String(err));
             process.exitCode = EXIT_CODES.GENERAL_ERROR;
         }
+        // 8b. Structured output: prefer SDK structured_output, fall back to text extraction
+        if (resolvedSchema && !process.exitCode) {
+            let parsed = structuredOutput ?? null;
+            // Fallback: extract JSON from collected text if SDK didn't return structured_output
+            if (parsed === null) {
+                const raw = renderer.getCollectedText();
+                parsed = extractJson(raw);
+                if (parsed === null) {
+                    console.error('Failed to extract JSON from agent response.');
+                    console.error('Raw output:\n' + raw);
+                    process.exitCode = EXIT_CODES.VALIDATION_ERROR;
+                }
+            }
+            if (parsed !== null && !process.exitCode) {
+                // For built-in schemas, validate with Zod; for custom schemas, output as-is
+                if (resolvedSchema.zodSchema) {
+                    const result = resolvedSchema.zodSchema.safeParse(parsed);
+                    if (result.success) {
+                        console.log(JSON.stringify(result.data, null, 2));
+                    }
+                    else {
+                        console.error('Schema validation failed:');
+                        for (const issue of result.error.issues) {
+                            console.error(`  - ${issue.path.join('.')}: ${issue.message}`);
+                        }
+                        console.error('\nRaw JSON:\n' + JSON.stringify(parsed, null, 2));
+                        process.exitCode = EXIT_CODES.VALIDATION_ERROR;
+                    }
+                }
+                else {
+                    // Custom schema — SDK already validated via constrained decoding
+                    console.log(JSON.stringify(parsed, null, 2));
+                }
+            }
+        }
         // 9. Disconnect and exit
         client.disconnect();
         process.exit(process.exitCode ?? 0);
     });
+    // ── view subcommand ──────────────────────────────────────────────────
+    const view = new Command('view')
+        .description('View a past chat session (read-only replay)')
+        .argument('[sessionId]', 'Session ID to view')
+        .option('--file <path>', 'Read events from local JSONL file instead of server')
+        .option('--web', 'Open as static HTML in browser')
+        .option('--jsonl', 'Output raw JSONL to stdout')
+        .action(async (sessionId, opts) => {
+        const { readFileSync, writeFileSync } = await import('fs');
+        const { tmpdir } = await import('os');
+        const { join, dirname } = await import('path');
+        const { fileURLToPath } = await import('url');
+        const chalk = (await import('chalk')).default;
+        const got = (await import('got')).default;
+        const { openInBrowser } = await import('../lib/browser.js');
+        // Resolve events source
+        let events;
+        if (opts.file) {
+            try {
+                const raw = readFileSync(opts.file, 'utf8');
+                events = parseJsonl(raw);
+            }
+            catch (err) {
+                error(`Failed to read file: ${err instanceof Error ? err.message : err}`);
+                process.exit(EXIT_CODES.GENERAL_ERROR);
+            }
+        }
+        else if (sessionId) {
+            const apiKey = getApiKey();
+            if (!apiKey) {
+                error('Not authenticated. Run `okra auth login` first.');
+                process.exit(EXIT_CODES.AUTH_ERROR);
+            }
+            const spinner = createSpinner('Fetching session events...');
+            spinner.start();
+            try {
+                const url = `${getAgentSessionHttpUrl()}/session/${sessionId}/events`;
+                const response = await got(url, {
+                    headers: { Authorization: `Bearer ${apiKey}` },
+                    timeout: { request: 15_000 },
+                });
+                events = parseJsonl(response.body);
+                spinner.succeed(`${events.length} events loaded`);
+            }
+            catch (err) {
+                spinner.fail('Failed to fetch events');
+                error(err instanceof Error ? err.message : String(err));
+                process.exit(EXIT_CODES.GENERAL_ERROR);
+            }
+        }
+        else {
+            error('Provide a session ID or --file path');
+            process.exit(EXIT_CODES.INVALID_ARGS);
+            return;
+        }
+        if (events.length === 0) {
+            info('No events found');
+            process.exit(0);
+        }
+        // Output modes
+        if (opts.jsonl) {
+            for (const evt of events) {
+                console.log(JSON.stringify(evt));
+            }
+        }
+        else if (opts.web) {
+            const label = sessionId || opts.file || 'local';
+            const currentDir = dirname(fileURLToPath(import.meta.url));
+            const templatePath = join(currentDir, '..', 'templates', 'replay-viewer.html');
+            let template = readFileSync(templatePath, 'utf8');
+            template = template.replace(/\{\{SESSION_ID\}\}/g, label);
+            template = template.replace('{{REPLAY_DATA}}', JSON.stringify(events));
+            const safeId = label.replace(/[^a-zA-Z0-9_-]/g, '_');
+            const outPath = join(tmpdir(), `okra-replay-${safeId}.html`);
+            writeFileSync(outPath, template, 'utf8');
+            info(`Opening ${outPath}`);
+            await openInBrowser(`file://${outPath}`);
+        }
+        else {
+            renderTerminalTranscript(events, chalk);
+        }
+        process.exit(0);
+    });
+    chat.addCommand(send, { isDefault: true });
+    chat.addCommand(view);
     return chat;
 }
+function parseJsonl(raw) {
+    return raw
+        .split('\n')
+        .filter(line => line.trim())
+        .map(line => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter((e) => e !== null);
+}
+/* eslint-disable @typescript-eslint/no-explicit-any */
+function renderTerminalTranscript(events, chalk) {
+    for (const evt of events) {
+        const ts = evt.timestamp ? chalk.dim(new Date(evt.timestamp).toLocaleTimeString() + ' ') : '';
+        switch (evt.type) {
+            case 'user': {
+                const author = evt.author ? chalk.dim(` (${evt.author.name})`) : '';
+                console.log(`\n${ts}${chalk.blue.bold('User')}${author}`);
+                const content = typeof evt.message?.content === 'string'
+                    ? evt.message.content
+                    : '';
+                if (content)
+                    console.log(content);
+                break;
+            }
+            case 'assistant': {
+                console.log(`\n${ts}${chalk.bold('Assistant')}`);
+                const blocks = evt.message?.content;
+                if (Array.isArray(blocks)) {
+                    for (const b of blocks) {
+                        if (b.type === 'text' && b.text) {
+                            console.log(b.text);
+                        }
+                        else if (b.type === 'tool_use') {
+                            console.log(chalk.dim(`  ▸ ${b.name}(${JSON.stringify(b.input).slice(0, 120)})`));
+                        }
+                        else if (b.type === 'tool_result') {
+                            const text = typeof b.content === 'string' ? b.content : JSON.stringify(b.content);
+                            if (text) {
+                                const truncated = text.length > 200 ? text.slice(0, 200) + '...' : text;
+                                console.log(chalk.dim(`  ← ${truncated}`));
+                            }
+                        }
+                    }
+                }
+                break;
+            }
+            case 'result': {
+                const parts = [];
+                if (evt.duration_ms != null)
+                    parts.push(`${(evt.duration_ms / 1000).toFixed(1)}s`);
+                if (evt.total_cost_usd != null)
+                    parts.push(`$${evt.total_cost_usd.toFixed(4)}`);
+                if (evt.exit_code != null)
+                    parts.push(`exit ${evt.exit_code}`);
+                if (parts.length)
+                    console.log(chalk.dim(`\n${parts.join(' · ')}`));
+                break;
+            }
+            case 'error':
+                console.log(`\n${ts}${chalk.red('Error:')} ${evt.error || ''}`);
+                break;
+            case 'system':
+                console.log(chalk.dim(`  [system] ${evt.message || ''}`));
+                break;
+        }
+    }
+}
 //# sourceMappingURL=chat.js.map