@okrapdf/cli 0.3.2 → 0.3.4

package/dist/lib/structured-output.js

@@ -0,0 +1,156 @@
+/**
+ * Structured output: resolve schemas from built-in presets, inline JSON, or files.
+ * The resolved JSON Schema is sent to the Claude Agent SDK via output_format
+ * for constrained decoding — no prompt engineering needed.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { z } from 'zod';
+// ── Built-in schema presets ───────────────────────────────────────────
+export const BUILTIN_SCHEMAS = {
+    summary: {
+        description: 'Document summary with title, description, and key points',
+        schema: z.object({
+            title: z.string(),
+            description: z.string(),
+            key_points: z.array(z.string()),
+            page_count: z.number(),
+            document_type: z.string().nullable().optional(),
+        }),
+    },
+    entities: {
+        description: 'People, organizations, dates, and monetary amounts found in the document',
+        schema: z.object({
+            people: z.array(z.string()),
+            organizations: z.array(z.string()),
+            dates: z.array(z.object({ date: z.string(), context: z.string() })),
+            amounts: z.array(z.object({
+                value: z.string(),
+                currency: z.string().nullable().optional(),
+                context: z.string(),
+            })),
+        }),
+    },
+    metadata: {
+        description: 'Document metadata including type, language, author, and structural info',
+        schema: z.object({
+            document_type: z.string(),
+            date: z.string().nullable().optional(),
+            language: z.string().nullable().optional(),
+            author: z.string().nullable().optional(),
+            page_count: z.number(),
+            has_tables: z.boolean(),
+        }),
+    },
+    tables: {
+        description: 'Table inventory with counts, page locations, and structure info',
+        schema: z.object({
+            table_count: z.number(),
+            tables: z.array(z.object({
+                page: z.number(),
+                description: z.string(),
+                row_count: z.number().nullable().optional(),
+                column_count: z.number().nullable().optional(),
+                key_headers: z.array(z.string()).nullable().optional(),
+            })),
+        }),
+    },
+};
+// ── Schema resolution ─────────────────────────────────────────────────
+/**
+ * Resolve a --schema value to a JSON Schema.
+ *
+ * Accepts:
+ *   - Built-in name: "summary", "entities", "metadata", "tables"
+ *   - Inline JSON:   '{"type":"object","properties":{"name":{"type":"string"}}}'
+ *   - File path:     "./my-schema.json" or "/abs/path/schema.json"
+ *
+ * Returns null + error message if invalid.
+ */
+export function resolveSchema(input) {
+    // 1. Built-in preset
+    if (input in BUILTIN_SCHEMAS) {
+        const builtin = BUILTIN_SCHEMAS[input];
+        return {
+            schema: {
+                jsonSchema: z.toJSONSchema(builtin.schema, { target: 'draft-2020-12' }),
+                zodSchema: builtin.schema,
+                source: `built-in:${input}`,
+            },
+        };
+    }
+    // 2. Inline JSON (starts with '{')
+    if (input.startsWith('{')) {
+        try {
+            const parsed = JSON.parse(input);
+            if (!parsed.type) {
+                return { error: 'Inline JSON schema must have a "type" field' };
+            }
+            return {
+                schema: {
+                    jsonSchema: parsed,
+                    source: 'inline',
+                },
+            };
+        }
+        catch (e) {
+            return { error: `Invalid inline JSON: ${e instanceof Error ? e.message : e}` };
+        }
+    }
+    // 3. File path
+    if (existsSync(input)) {
+        try {
+            const raw = readFileSync(input, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (!parsed.type) {
+                return { error: `Schema file ${input} must have a "type" field` };
+            }
+            return {
+                schema: {
+                    jsonSchema: parsed,
+                    source: `file:${input}`,
+                },
+            };
+        }
+        catch (e) {
+            return { error: `Failed to read schema file ${input}: ${e instanceof Error ? e.message : e}` };
+        }
+    }
+    // 4. Unknown
+    const presets = Object.keys(BUILTIN_SCHEMAS).join(', ');
+    return {
+        error: `Unknown schema "${input}". Use a built-in (${presets}), inline JSON, or a file path.`,
+    };
+}
+// ── JSON extraction (fallback for when SDK doesn't return structured_output) ──
+export function extractJson(text) {
+    const trimmed = text.trim();
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        // fall through
+    }
+    const match = trimmed.match(/\{[\s\S]*\}/);
+    if (match) {
+        try {
+            return JSON.parse(match[0]);
+        }
+        catch {
+            // fall through
+        }
+    }
+    return null;
+}
+// ── Prompt template (kept for system prompt hint) ─────────────────────
+export function structuredOutputInstructions(schema) {
+    return `\n<structured-output>
+RESPOND WITH ONLY A SINGLE JSON OBJECT matching the provided output_format schema.
+No markdown fences, no explanations, no preamble.
+Use null for unknown optional fields. Do NOT hallucinate values.
+</structured-output>`;
+}
+// ── Helpers ───────────────────────────────────────────────────────────
+export function listBuiltinNames() {
+    return Object.keys(BUILTIN_SCHEMAS);
+}
+//# sourceMappingURL=structured-output.js.map

package/dist/lib/structured-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.js","sourceRoot":"","sources":["../../src/lib/structured-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yEAAyE;AAEzE,MAAM,CAAC,MAAM,eAAe,GAA+D;IACzF,OAAO,EAAE;QACP,WAAW,EAAE,0DAA0D;QACvE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;YACvB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;YACtB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;SAChD,CAAC;KACH;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,0EAA0E;QACvF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC3B,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACnE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;gBACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;gBAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;aACpB,CAAC,CAAC;SACJ,CAAC;KACH;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,yEAAyE;QACtF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;YACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;YACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;YAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;YACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;YACtB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;SACxB,CAAC;KACH;IACD,MAAM,EAAE;QACN,WAAW,EAAE,iEAAiE;QAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;YACvB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;gBACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;gBAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;gBACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;gBAC3C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;gBAC9C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;aACvD,CAAC,CAAC;SACJ,CAAC;KACH;CACF,CAAC;AAaF,yEAAyE;AAEzE;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,qBAAqB;IACrB,IAAI,KAAK,IAAI,eAAe,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO;YACL,MAAM,EAAE;gBACN,UAAU,EAAE,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,CAA4B;gBAClG,SAAS,EAAE,OAAO,CAAC,MAAM;gBACzB,MAAM,EAAE,YAAY,KAAK,EAAE;aAC5B;SACF,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;YAClE,CAAC;YACD,OAAO;gBACL,MAAM,EAAE;oBACN,UAAU,EAAE,MAAM;oBAClB,MAAM,EAAE,QAAQ;iBACjB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,KAAK,EAAE,wBAAwB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACjF,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,eAAe,KAAK,2BAA2B,EAAE,CAAC;YACpE,CAAC;YACD,OAAO;gBACL,MAAM,EAAE;oBACN,UAAU,EAAE,MAAM;oBAClB,MAAM,EAAE,QAAQ,KAAK,EAAE;iBACxB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,KAAK,EAAE,8BAA8B,KAAK,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACjG,CAAC;IACH,CAAC;IAED,aAAa;IACb,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO;QACL,KAAK,EAAE,mBAAmB,KAAK,sBAAsB,OAAO,iCAAiC;KAC9F,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yEAAyE;AAEzE,MAAM,UAAU,4BAA4B,CAAC,MAAsB;IACjE,OAAO;;;;qBAIY,CAAC;AACtB,CAAC;AAED,yEAAyE;AAEzE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACtC,CAAC"}

package/dist/lib/structured-output.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=structured-output.test.d.ts.map

package/dist/lib/structured-output.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.test.d.ts","sourceRoot":"","sources":["../../src/lib/structured-output.test.ts"],"names":[],"mappings":""}

package/dist/lib/structured-output.test.js

@@ -0,0 +1,148 @@
+import { describe, it, expect } from 'vitest';
+import { extractJson, resolveSchema, listBuiltinNames, structuredOutputInstructions, } from './structured-output.js';
+import { writeFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+describe('extractJson', () => {
+    it('parses clean JSON', () => {
+        const result = extractJson('{"title":"Test","page_count":5}');
+        expect(result).toEqual({ title: 'Test', page_count: 5 });
+    });
+    it('extracts JSON from markdown fences', () => {
+        const input = 'Here is the result:\n```json\n{"title":"Test"}\n```\n';
+        expect(extractJson(input)).toEqual({ title: 'Test' });
+    });
+    it('extracts JSON with surrounding text', () => {
+        const input = 'Sure! Here is the summary:\n{"title":"Annual Report","page_count":10}\nHope that helps!';
+        expect(extractJson(input)).toEqual({ title: 'Annual Report', page_count: 10 });
+    });
+    it('returns null for non-JSON text', () => {
+        expect(extractJson('This is just plain text')).toBeNull();
+    });
+    it('returns null for empty string', () => {
+        expect(extractJson('')).toBeNull();
+    });
+    it('handles whitespace-padded JSON', () => {
+        expect(extractJson('  \n {"a":1}  \n ')).toEqual({ a: 1 });
+    });
+});
+describe('resolveSchema', () => {
+    it('resolves built-in schema by name', () => {
+        const result = resolveSchema('summary');
+        expect('schema' in result).toBe(true);
+        if ('schema' in result) {
+            expect(result.schema.source).toBe('built-in:summary');
+            expect(result.schema.jsonSchema).toBeDefined();
+            expect(result.schema.zodSchema).toBeDefined();
+        }
+    });
+    it('resolves all built-in schemas', () => {
+        for (const name of listBuiltinNames()) {
+            const result = resolveSchema(name);
+            expect('schema' in result).toBe(true);
+        }
+    });
+    it('resolves inline JSON schema', () => {
+        const input = '{"type":"object","properties":{"name":{"type":"string"}}}';
+        const result = resolveSchema(input);
+        expect('schema' in result).toBe(true);
+        if ('schema' in result) {
+            expect(result.schema.source).toBe('inline');
+            expect(result.schema.jsonSchema).toEqual(JSON.parse(input));
+            expect(result.schema.zodSchema).toBeUndefined();
+        }
+    });
+    it('rejects inline JSON without type field', () => {
+        const result = resolveSchema('{"properties":{"name":{"type":"string"}}}');
+        expect('error' in result).toBe(true);
+        if ('error' in result) {
+            expect(result.error).toContain('type');
+        }
+    });
+    it('rejects invalid inline JSON', () => {
+        const result = resolveSchema('{not valid json}');
+        expect('error' in result).toBe(true);
+    });
+    it('resolves schema from file', () => {
+        const tmpFile = join(tmpdir(), `test-schema-${Date.now()}.json`);
+        const schema = { type: 'object', properties: { age: { type: 'number' } } };
+        writeFileSync(tmpFile, JSON.stringify(schema));
+        try {
+            const result = resolveSchema(tmpFile);
+            expect('schema' in result).toBe(true);
+            if ('schema' in result) {
+                expect(result.schema.source).toBe(`file:${tmpFile}`);
+                expect(result.schema.jsonSchema).toEqual(schema);
+            }
+        }
+        finally {
+            unlinkSync(tmpFile);
+        }
+    });
+    it('returns error for unknown name', () => {
+        const result = resolveSchema('nonexistent');
+        expect('error' in result).toBe(true);
+        if ('error' in result) {
+            expect(result.error).toContain('Unknown schema');
+            expect(result.error).toContain('summary');
+        }
+    });
+});
+describe('listBuiltinNames', () => {
+    it('returns all schema names', () => {
+        const names = listBuiltinNames();
+        expect(names).toContain('summary');
+        expect(names).toContain('entities');
+        expect(names).toContain('metadata');
+        expect(names).toContain('tables');
+        expect(names).toHaveLength(4);
+    });
+});
+describe('structuredOutputInstructions', () => {
+    it('includes structured output block', () => {
+        const result = resolveSchema('summary');
+        expect('schema' in result).toBe(true);
+        if ('schema' in result) {
+            const instructions = structuredOutputInstructions(result.schema);
+            expect(instructions).toContain('<structured-output>');
+            expect(instructions).toContain('JSON');
+        }
+    });
+});
+describe('built-in schema validation', () => {
+    it('summary schema validates correct data', () => {
+        const result = resolveSchema('summary');
+        if ('schema' in result && result.schema.zodSchema) {
+            const data = {
+                title: 'Annual Report',
+                description: 'Financial summary',
+                key_points: ['Revenue grew'],
+                page_count: 42,
+                document_type: 'report',
+            };
+            const parsed = result.schema.zodSchema.safeParse(data);
+            expect(parsed.success).toBe(true);
+        }
+    });
+    it('summary schema rejects missing required fields', () => {
+        const result = resolveSchema('summary');
+        if ('schema' in result && result.schema.zodSchema) {
+            const parsed = result.schema.zodSchema.safeParse({ title: 'Test' });
+            expect(parsed.success).toBe(false);
+        }
+    });
+    it('entities schema validates correct data', () => {
+        const result = resolveSchema('entities');
+        if ('schema' in result && result.schema.zodSchema) {
+            const data = {
+                people: ['John'],
+                organizations: ['Acme'],
+                dates: [{ date: '2024-01-15', context: 'filed' }],
+                amounts: [{ value: '$1M', currency: 'USD', context: 'revenue' }],
+            };
+            const parsed = result.schema.zodSchema.safeParse(data);
+            expect(parsed.success).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=structured-output.test.js.map

package/dist/lib/structured-output.test.js.map

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

package/dist/lib/system-prompt.d.ts

@@ -1,5 +1,9 @@
 /**
  * Minimal system prompt for CLI agent chat (no UI/mention context)
  */
+import { type ResolvedSchema } from './structured-output.js';
+export declare function buildSystemPrompt(options?: {
+    schema?: ResolvedSchema;
+}): string;
 export declare const CLI_SYSTEM_PROMPT = "You are a helpful assistant that can help with document analysis and extraction. Your goal is to understand the one pdf given to you with tools like parse and whole suite of python libraries.\n\n<goal>\n  - To start, list, or grep for keywords inside derived folder directly. Most likely, you will find markdown files that are page-to-page extracted from the pdf.\n  - Try to cite from the derived folder when you try to answer a question or create a document.\n  - If there is no relevant information returned from searching the derived/ directory, offer to parse more pages.\n</goal>\n\n<environment>\n  OS: Linux (x86_64) in an ephemeral sandbox environment\n  Python: 3.12.3, fully functional\n</environment>\n\n<files>\n  - There is only one pdf that is in /mnt/data/*.pdf. When user talks about \"the document\", refer to this pdf.\n  - All the files you need are in /mnt/data/*\n  - Everything you create/extract from the source pdf, move them in the app/derived directory so we can save them for future use in this ephemeral sandbox\n</files>\n\n<derived-folder-structure>\n  The derived/ folder contains two parallel OCR outputs that match page-to-page:\n\n  <ocr-folder path=\"derived/ocr/\">\n    - Raw character extraction from Google DocAI without layout interpretation\n    - Use as GROUND TRUTH to detect hallucinations in pages/ output\n    - File format: page_001.md, page_002.md, ... + index.json\n  </ocr-folder>\n\n  <pages-folder path=\"derived/pages/\">\n    - AI-interpreted OCR with layout intelligence (VLM/OpenRouter)\n    - Structured output: markdown tables, proper column alignment, organized sections\n    - Use for QA, data extraction, and answering user questions\n    - File format: page_001.md, page_002.md, ... + index.json\n  </pages-folder>\n\n  <validation-workflow>\n    When answering questions or extracting data:\n    1. Use pages/ for structured extraction and user-facing answers\n    2. Cross-reference ocr/ to verify numbers/text are not hallucinated\n    3. If pages/ content differs significantly from ocr/, flag as potential hallucination\n  </validation-workflow>\n</derived-folder-structure>\n\n<parse-cli-reference>\n  The parse CLI extracts content from PDFs. Output goes to /mnt/data/parse/ directory.\n  parse document.pdf              # Parse entire PDF\n  parse -v document.pdf           # Verbose (show progress)\n  For specific page ranges: use pypdf to extract pages first, then parse the extracted PDF.\n</parse-cli-reference>\n\n<constraints>\n  - NEVER use the Read tool on PDF or image files directly - they will exceed buffer limits and crash.\n  - When you mention a file path, always use the full path, ie /mnt/data/derived/revenue.xlsx\n</constraints>";
 //# sourceMappingURL=system-prompt.d.ts.map

package/dist/lib/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/lib/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,oqFAqDf,CAAC"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/lib/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,cAAc,EAAgC,MAAM,wBAAwB,CAAC;AAE3F,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,GAAG,MAAM,CAM/E;AAED,eAAO,MAAM,iBAAiB,oqFAqDf,CAAC"}

package/dist/lib/system-prompt.js

@@ -1,6 +1,14 @@
 /**
  * Minimal system prompt for CLI agent chat (no UI/mention context)
  */
+import { structuredOutputInstructions } from './structured-output.js';
+export function buildSystemPrompt(options) {
+    let prompt = CLI_SYSTEM_PROMPT;
+    if (options?.schema) {
+        prompt += structuredOutputInstructions(options.schema);
+    }
+    return prompt;
+}
 export const CLI_SYSTEM_PROMPT = `You are a helpful assistant that can help with document analysis and extraction. Your goal is to understand the one pdf given to you with tools like parse and whole suite of python libraries.
 
 <goal>

package/dist/lib/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/lib/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAqDlB,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/lib/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAuB,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAE3F,MAAM,UAAU,iBAAiB,CAAC,OAAqC;IACrE,IAAI,MAAM,GAAG,iBAAiB,CAAC;IAC/B,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,4BAA4B,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAqDlB,CAAC"}

package/dist/templates/replay-viewer.html

@@ -0,0 +1,230 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>OkraPDF Chat Replay — {{SESSION_ID}}</title>
+<style>
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+    background: #0a0a0a; color: #e5e5e5;
+    line-height: 1.6; padding: 0;
+  }
+  .header {
+    position: sticky; top: 0; z-index: 10;
+    background: #141414; border-bottom: 1px solid #262626;
+    padding: 12px 24px; display: flex; align-items: center; gap: 16px;
+  }
+  .header h1 { font-size: 14px; font-weight: 600; color: #a3a3a3; }
+  .header .meta { font-size: 12px; color: #525252; }
+  .header .meta span { margin-right: 12px; }
+  .container { max-width: 860px; margin: 0 auto; padding: 24px; }
+  .event {
+    margin-bottom: 16px; padding: 12px 16px;
+    border-radius: 8px; position: relative;
+    border: 1px solid transparent;
+  }
+  .event.active { border-color: #555; }
+  .event-user {
+    background: #1a1a1a; border-left: 3px solid #888;
+  }
+  .event-assistant { background: #171717; }
+  .event-result {
+    background: #0c0c0c; border-left: 3px solid #22c55e;
+    font-size: 13px; color: #737373; padding: 8px 16px;
+  }
+  .event-error {
+    background: #1a0a0a; border-left: 3px solid #ef4444;
+  }
+  .event-system {
+    background: transparent; color: #525252;
+    font-size: 12px; padding: 4px 16px; text-align: center;
+  }
+  .role {
+    font-size: 11px; font-weight: 600; text-transform: uppercase;
+    letter-spacing: 0.05em; margin-bottom: 6px;
+  }
+  .role-user { color: #ccc; }
+  .role-assistant { color: #a3a3a3; }
+  .role-error { color: #f87171; }
+  .timestamp {
+    position: absolute; top: 12px; right: 16px;
+    font-size: 11px; color: #404040;
+  }
+  .content { white-space: pre-wrap; word-break: break-word; }
+  .content code {
+    background: #262626; padding: 1px 5px; border-radius: 3px;
+    font-family: 'SF Mono', 'Fira Code', monospace; font-size: 13px;
+  }
+  .tool-use {
+    margin: 8px 0; padding: 8px 12px;
+    background: #1a1a1a; border-radius: 6px;
+    border: 1px solid #333; cursor: pointer;
+  }
+  .tool-use summary {
+    font-size: 13px; color: #999; font-weight: 500;
+    list-style: none; display: flex; align-items: center; gap: 6px;
+  }
+  .tool-use summary::before { content: '▶'; font-size: 10px; transition: transform 0.15s; }
+  .tool-use[open] summary::before { transform: rotate(90deg); }
+  .tool-input {
+    margin-top: 8px; padding: 8px;
+    background: #111; border-radius: 4px;
+    font-family: 'SF Mono', monospace; font-size: 12px;
+    color: #a3a3a3; overflow-x: auto; white-space: pre;
+  }
+  .tool-result {
+    margin: 4px 0; padding: 6px 12px;
+    background: #111; border-radius: 4px;
+    font-size: 12px; color: #737373;
+    max-height: 200px; overflow-y: auto;
+    font-family: 'SF Mono', monospace; white-space: pre-wrap;
+  }
+  .nav-hint {
+    position: fixed; bottom: 16px; right: 16px;
+    background: #262626; padding: 8px 12px; border-radius: 6px;
+    font-size: 11px; color: #525252;
+  }
+  .nav-hint kbd {
+    background: #404040; padding: 2px 6px; border-radius: 3px;
+    font-family: monospace; color: #a3a3a3;
+  }
+  .cost { color: #22c55e; }
+  .duration { color: #a3a3a3; }
+</style>
+</head>
+<body>
+<div class="header">
+  <h1>OkraPDF Chat Replay</h1>
+  <div class="meta">
+    <span id="session-id"></span>
+    <span id="event-count"></span>
+    <span id="time-range"></span>
+  </div>
+</div>
+<div class="container" id="events"></div>
+<div class="nav-hint">
+  <kbd>↑</kbd><kbd>↓</kbd> navigate &nbsp;
+  <kbd>Home</kbd><kbd>End</kbd> jump
+</div>
+
+<script>
+const DATA = {{REPLAY_DATA}};
+const container = document.getElementById('events');
+let activeIndex = -1;
+const eventEls = [];
+
+// Metadata
+document.getElementById('session-id').textContent = '{{SESSION_ID}}';
+document.getElementById('event-count').textContent = DATA.length + ' events';
+if (DATA.length > 0) {
+  const first = DATA[0].timestamp;
+  const last = DATA[DATA.length - 1].timestamp;
+  if (first && last) {
+    document.getElementById('time-range').textContent =
+      new Date(first).toLocaleString() + ' → ' + new Date(last).toLocaleString();
+  }
+}
+
+function formatTs(ts) {
+  if (!ts) return '';
+  const d = new Date(ts);
+  return d.toLocaleTimeString();
+}
+
+function escapeHtml(s) {
+  if (typeof s !== 'string') return '';
+  return s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');
+}
+
+function renderContent(blocks) {
+  if (!Array.isArray(blocks)) return escapeHtml(String(blocks || ''));
+  let html = '';
+  for (const b of blocks) {
+    if (b.type === 'text') {
+      html += '<div class="content">' + escapeHtml(b.text) + '</div>';
+    } else if (b.type === 'tool_use') {
+      html += '<details class="tool-use"><summary>' + escapeHtml(b.name) + '</summary>';
+      html += '<div class="tool-input">' + escapeHtml(JSON.stringify(b.input, null, 2)) + '</div>';
+      html += '</details>';
+    } else if (b.type === 'tool_result') {
+      const text = typeof b.content === 'string' ? b.content : JSON.stringify(b.content);
+      const truncated = text && text.length > 500 ? text.slice(0, 500) + '...' : text;
+      html += '<div class="tool-result">' + escapeHtml(truncated || '') + '</div>';
+    }
+  }
+  return html;
+}
+
+for (let i = 0; i < DATA.length; i++) {
+  const evt = DATA[i];
+  const div = document.createElement('div');
+
+  switch (evt.type) {
+    case 'user':
+      div.className = 'event event-user';
+      div.innerHTML = '<div class="role role-user">User' +
+        (evt.author ? ' (' + escapeHtml(evt.author.name) + ')' : '') +
+        '</div>' +
+        '<span class="timestamp">' + formatTs(evt.timestamp) + '</span>' +
+        '<div class="content">' + escapeHtml(evt.message?.content || '') + '</div>';
+      break;
+    case 'assistant':
+      div.className = 'event event-assistant';
+      div.innerHTML = '<div class="role role-assistant">Assistant</div>' +
+        '<span class="timestamp">' + formatTs(evt.timestamp) + '</span>' +
+        renderContent(evt.message?.content || []);
+      break;
+    case 'result':
+      div.className = 'event event-result';
+      const parts = [];
+      if (evt.duration_ms != null) parts.push('<span class="duration">' + (evt.duration_ms / 1000).toFixed(1) + 's</span>');
+      if (evt.total_cost_usd != null) parts.push('<span class="cost">$' + evt.total_cost_usd.toFixed(4) + '</span>');
+      if (evt.exit_code != null) parts.push('exit ' + evt.exit_code);
+      div.innerHTML = parts.join(' · ') || 'done';
+      break;
+    case 'error':
+      div.className = 'event event-error';
+      div.innerHTML = '<div class="role role-error">Error</div>' +
+        '<div class="content">' + escapeHtml(evt.error) + '</div>';
+      break;
+    case 'system':
+      div.className = 'event event-system';
+      div.textContent = evt.message || '';
+      break;
+    default:
+      continue;
+  }
+
+  div.dataset.index = i;
+  container.appendChild(div);
+  eventEls.push(div);
+}
+
+function setActive(idx) {
+  if (idx < 0 || idx >= eventEls.length) return;
+  if (activeIndex >= 0) eventEls[activeIndex].classList.remove('active');
+  activeIndex = idx;
+  eventEls[activeIndex].classList.add('active');
+  eventEls[activeIndex].scrollIntoView({ block: 'nearest', behavior: 'smooth' });
+}
+
+document.addEventListener('keydown', (e) => {
+  if (e.key === 'ArrowDown' || e.key === 'j') {
+    e.preventDefault();
+    setActive(Math.min(activeIndex + 1, eventEls.length - 1));
+  } else if (e.key === 'ArrowUp' || e.key === 'k') {
+    e.preventDefault();
+    setActive(Math.max(activeIndex - 1, 0));
+  } else if (e.key === 'Home') {
+    e.preventDefault();
+    setActive(0);
+  } else if (e.key === 'End') {
+    e.preventDefault();
+    setActive(eventEls.length - 1);
+  }
+});
+</script>
+</body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okrapdf/cli",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "OkraPDF command-line interface for PDF extraction and document chat",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && cp -r src/templates dist/",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
     "test": "vitest run",
@@ -57,7 +57,8 @@
     "got": "^14.4.2",
     "ora": "^8.0.1",
     "pdfquery": "^0.1.2",
-    "ws": "^8.18.0"
+    "ws": "^8.18.0",
+    "zod": "^4.3.6"
   },
   "optionalDependencies": {
     "mupdf": "^0.3.0",