@dsh-libing/knowledge-base 0.1.0 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.3
+
+- 增加有容量上限的 manifest / 完整正文检索缓存，保持正文子串匹配与评分；每次检查文件变化，返回证据仍复读原文核验哈希。
+- 发布、回收、恢复、删除和卸载清空缓存；列表批量读取 registry，tree 复用快照，片段/图片关联使用 ID 集合校验，图片响应复用已核验字节。
+
+## 0.1.2
+
+- 图片解码、缩放、裁片与编码移至可取消 worker，进程级串行预处理与有界等待队列限制位图并发。
+- 裁片只复制目标区域，逐张编码/保存；增加预处理超时、尺寸硬上限和真实打包 worker 验证。
+
+## 0.1.1
+
+- 构建任务列表改为有上限的分页摘要，质量报告和用量记录展开后按需读取；关闭和卸载取消未完成的详情请求。
+- 使用 v2 小检查点，报告与历史用量独立保存；复用逐次调用收据核对崩溃时未结算用量，兼容旧任务首次迁移和回收恢复。
+- 增加 Host 模型预算上限与上传收据留存期，重试拒绝超限；启动时清理过期上传，独立任务输入和原件保留。
+
 ## 0.1.0
 
 - 图片复核改用宽幅双栏与窄屏上下布局，普通文字编辑描述和标识，按需展开类型及技术字段；原图可放大查看，补充各项操作影响，保持标题与底部按钮可见。

package/README.md

@@ -15,7 +15,7 @@ PDF 可以先预检：只抽样核对页数、书签及 OCR 可能性，不调
 
 ## 任务与复核
 
-任务、逐页收据、模型调用用量和已完成检查点保存在磁盘。取消后可重试；卸载时取消并等待任务退出，重载后继续队列。模型调用和已报告 tokens 受到预算限制，耗尽后暂停，只有明确提高额度才继续。重试复用可用缓存；供应商未报告的用量不能精确计入 tokens。
+任务、逐页收据、模型调用用量和已完成检查点保存在磁盘。列表每页默认 20 个任务、最多 50 个，活动任务优先；质量报告、阶段历史和用量记录只在展开后加载，用量记录单独分页。取消后可重试；卸载时取消并等待任务退出，重载后继续队列。模型调用和已报告 tokens 受到预算限制，耗尽后暂停，只有明确提高额度且不超过 Host 配置的硬上限才继续。重试复用可用缓存；供应商未报告的用量不能精确计入 tokens。新任务检查点采用格式 v2，仅保存状态、配置、累计用量与少量待结算调用编号；报告保存在任务目录的 `quality.json`，逐次调用仍使用 `calls/` 收据。退出后重载会补结算尚未写入检查点的已完成收据；已预留调用即使没有返回用量仍占用调用次数。旧格式在首次读取时迁移，报告和已有用量明细分别保留，不重新调用模型。v2 不能直接交给旧版插件读取，更新前应备份数据根。
 
 图片失败、扫描页无法恢复或文档覆盖缺口默认进入「待复核」，原来的已发布版本继续可用。草稿只允许在管理页面预览，Agent 工具不检索草稿。没有阻塞问题时自动发布，任务显示「已发布」；普通解析提示不一定阻止发布。「待复核」任务提供「查看待发布草稿」与「发布草稿」两个入口，后者须在弹窗中确认接受报告中的覆盖缺口。提交后仍需等待任务变为「已发布」；接受缺口不会补回遗漏的图片、扫描页或复杂对象，正式检索仍提示缺口。人工图片描述、装饰图确认、忽略一次引用、恢复和重新识别都生成新任务与新版本；保存时核对当前版本及旧复核哈希，防止并发覆盖。图片描述是生成内容，应结合原图核对。
 
@@ -61,6 +61,8 @@ PDF 可以先预检：只抽样核对页数、书签及 OCR 可能性，不调
 | `visionProvider` / `visionModel` | 空；两者成对配置 |
 | `summaryProvider` / `summaryModel` | 空；两者成对配置 |
 | `maxModelCalls` / `maxModelTokens` | 每任务 1000 / 2000000 |
+| `maxModelCallsLimit` / `maxModelTokensLimit` | Host 硬上限 10000 / 20000000；配置上限 100000 / 1000000000 |
+| `uploadRetentionDays` | 7 天；启动时清理过期上传收据及上传副本 |
 | `modelTimeoutMs` / `modelAttempts` | 90000 / 3 |
 | `maxInputBytes` / `maxUncompressedBytes` | 64 MiB / 256 MiB |
 | `maxArchiveEntries` | 10000 |
@@ -69,7 +71,7 @@ PDF 可以先预检：只抽样核对页数、书签及 OCR 可能性，不调
 
 DOCX 压缩包、上传流、图片和 PDF 渲染均有限制；PDF 在可取消的独立 worker 中解析。复杂版面、扫描文字和生成图片描述仍需人工核对；加密 PDF 需先解除密码。切分保留合并单元格、表头及图文组合，不强行截断不可分的超长结构，报告会列出超出目标的片段。
 
-同一个数据根只能运行一个任务服务，避免两个 profile 同时写入。浏览器通过 DSH 官方 Connection 认证，上传后只提交收据，不接收任意本机路径。原件/图片读取核对版本、路径边界和内容哈希。彻底删除仅限回收站中的库，需要完整名称和不可恢复确认；会删除该库原件、历史与关联任务，上传收据和其他库不受影响。
+同一个数据根只能运行一个任务服务，避免两个 profile 同时写入。浏览器通过 DSH 官方 Connection 认证，上传后只提交收据，不接收任意本机路径。原件/图片读取核对版本、路径边界和内容哈希。彻底删除仅限回收站中的库，需要完整名称和不可恢复确认；会删除该库原件、历史与关联任务，其他库不受影响。上传收据独立按留存期清理，过期后需重新上传；构建已复制到任务 input 的文件、原件和已发布版本不会随收据清理。
 
 本插件不需要向量数据库、Python、外部 PDF 命令或 CI。实际验证平台为 macOS、Node.js 24、DSH rc.2；Windows、LibreOffice `.doc` 转换与真实供应商识别质量需另行验收。
 
@@ -78,3 +80,7 @@ DOCX 压缩包、上传流、图片和 PDF 渲染均有限制；PDF 在可取消
 首页详情显示带说明的知识库 ID、创建时间和当前正式版本；最近操作一条一行，行间不再留空行。任务中模型调用与 tokens 为累计用量 / 预算上限，页、图片、片段分别表示对应阶段进度；未报告的 tokens 不能精确计入。质量报告区可用滚轮或键盘上下滚动，保留全部问题和技术明细，区分待处理问题与普通提示。
 
 图片复核使用双栏弹窗：左侧原图可在新窗口放大查看，右侧直接编辑描述和图中文字（每行一个标识）；窄屏改为上下排列。图片类型、不确定项与完整结构化信息按需展开，识别出的关联和技术字段在保存时保留。重新识别、装饰图确认、忽略及恢复分别提供影响说明；它们直接重建且不保存正在编辑的人工描述，未保存修改会提示确认放弃。弹窗正文可滚动，页头和 32px 底部按钮保持可见。
+
+图片预处理由独立 worker 执行，同一进程全部知识库与插件实例共用一个名额，最多 32 个等待者；等待和运行均可取消。每张图最多 32 MiB / 5000 万像素，单张输出最多 8 MiB；总览长边与裁片边长最多 4096，裁片最多 64（默认 12）。`imageTimeoutMs` 默认 60 秒、最多 120 秒，超时或卸载会终止 worker 后释放名额。worker 逐张输出并等待官方附件保存完成，裁片仅复制所需区域。该限制约束图片预处理的位图并发，不能作为整个宿主进程的 RSS 上限；PDF 引擎和模型调用仍有各自的生命周期与限制。
+
+检索保留原有完整正文的子串匹配与评分，包括只在正文出现的词。每个 runtime 使用 LRU 缓存（最多 256 个文件、估算载荷 32 MiB），复用 manifest 与完整正文的小写检索视图；超大文件不驻留，超出容量按需重新读盘。每次仍验证知识库可访问性、根路径及文件身份/大小/纳秒修改和变更时间；首次读正文核验哈希，返回候选证据时另外复读原文核验。解析后的 manifest 冻结，构建继承文档使用独立副本。当前 revision 指针不缓存，发布、回收、恢复、彻底删除和关闭会清空缓存。冷检索仍扫描所有片段，缓存载荷预算不是宿主进程总内存限制，也不替代可信本机权限边界。

package/lib/client-types/client/JobDetails.d.ts

@@ -0,0 +1,16 @@
+import type { PublicJob } from '../contract.ts';
+import type { T } from './common.ts';
+/** Closed disclosures perform neither network reads nor large JSON formatting. */
+export declare function JobDetails({ job, t }: {
+    job: PublicJob;
+    t: T;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function JsonDetails({ label, hint, value }: {
+    label: string;
+    hint: string;
+    value: unknown;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function JobReport({ job, t }: {
+    job: PublicJob;
+    t: T;
+}): import("react/jsx-runtime").JSX.Element;

package/lib/client-types/client/JobsPanel.d.ts

@@ -1,6 +1,11 @@
 import type { PublicJob } from '../contract.ts';
 import type { Actions } from './common.ts';
-export declare function JobsPanel({ jobs, t, busy, act, operationError, preview }: {
+export declare function JobsPanel({ jobs, t, busy, act, operationError, preview, pagination }: {
     jobs: PublicJob[];
+    pagination?: {
+        offset: number;
+        total: number;
+        page: (offset: number) => void;
+    };
     preview: (jobId: string) => void;
 } & Omit<Actions, 'dirty'>): import("react/jsx-runtime").JSX.Element;

package/lib/client-types/client/QualityReport.d.ts

@@ -1,6 +1,7 @@
 import type { PublicJob } from '../contract.ts';
 import type { T } from './common.ts';
-export declare function QualityReport({ report, t }: {
+export declare function QualityReport({ report, t, embedded }: {
     report: NonNullable<PublicJob['report']>;
     t: T;
-}): import("react/jsx-runtime").JSX.Element;
+    embedded?: boolean;
+}): false | import("react/jsx-runtime").JSX.Element;

package/lib/client-types/client/api.d.ts

@@ -1,7 +1,13 @@
 /** Bounded Host protocol. Browser imports contain no filesystem or Host services. */
 import { z } from 'zod';
-export type Endpoint = 'list' | 'create' | 'delete' | 'restore' | 'purge' | 'upload' | 'inspect-document' | 'source' | 'draft-source' | 'build' | 'job' | 'draft' | 'draft-read' | 'draft-asset' | 'catalog' | 'tree' | 'read' | 'search' | 'asset' | 'schema' | 'review' | 'models';
+export type Endpoint = 'job-details' | 'job-usage' | 'list' | 'create' | 'delete' | 'restore' | 'purge' | 'upload' | 'inspect-document' | 'source' | 'draft-source' | 'build' | 'job' | 'draft' | 'draft-read' | 'draft-asset' | 'catalog' | 'tree' | 'read' | 'search' | 'asset' | 'schema' | 'review' | 'models';
 export declare const responseSchemas: {
+    usagePage: z.ZodObject<{
+        records: z.ZodArray<z.ZodJSONSchema>;
+        offset: z.ZodNumber;
+        total: z.ZodNumber;
+        next: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
     state: z.ZodObject<{
         hostVersion: z.ZodString;
         kbs: z.ZodArray<z.ZodObject<{
@@ -60,31 +66,6 @@ export declare const responseSchemas: {
             pageEnd: z.ZodOptional<z.ZodNumber>;
             jobId: z.ZodString;
             revision: z.ZodOptional<z.ZodString>;
-            updatedAt: z.ZodOptional<z.ZodString>;
-            pdf: z.ZodOptional<z.ZodObject<{
-                pageCount: z.ZodNumber;
-                selectedPages: z.ZodObject<{
-                    start: z.ZodNumber;
-                    end: z.ZodNumber;
-                    count: z.ZodNumber;
-                    total: z.ZodNumber;
-                    partial: z.ZodBoolean;
-                }, z.core.$strip>;
-                outlineCount: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>;
-            sourceFormat: z.ZodDefault<z.ZodEnum<{
-                docx: "docx";
-                pdf: "pdf";
-            }>>;
-            parserVersion: z.ZodOptional<z.ZodString>;
-            sourceHash: z.ZodOptional<z.ZodString>;
-            filename: z.ZodString;
-            usage: z.ZodObject<{
-                calls: z.ZodNumber;
-                tokens: z.ZodNumber;
-                reportedCalls: z.ZodNumber;
-                records: z.ZodArray<z.ZodJSONSchema>;
-            }, z.core.$strip>;
             report: z.ZodOptional<z.ZodObject<{
                 revision: z.ZodString;
                 sourceHash: z.ZodString;
@@ -159,6 +140,31 @@ export declare const responseSchemas: {
                     }, z.core.$strip>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            pdf: z.ZodOptional<z.ZodObject<{
+                pageCount: z.ZodNumber;
+                selectedPages: z.ZodObject<{
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                    count: z.ZodNumber;
+                    total: z.ZodNumber;
+                    partial: z.ZodBoolean;
+                }, z.core.$strip>;
+                outlineCount: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            sourceFormat: z.ZodDefault<z.ZodEnum<{
+                docx: "docx";
+                pdf: "pdf";
+            }>>;
+            parserVersion: z.ZodOptional<z.ZodString>;
+            sourceHash: z.ZodOptional<z.ZodString>;
+            filename: z.ZodString;
+            usage: z.ZodObject<{
+                calls: z.ZodNumber;
+                tokens: z.ZodNumber;
+                reportedCalls: z.ZodNumber;
+                records: z.ZodArray<z.ZodJSONSchema>;
+            }, z.core.$strip>;
             buildKey: z.ZodString;
             createdAt: z.ZodString;
             config: z.ZodObject<{
@@ -173,8 +179,12 @@ export declare const responseSchemas: {
                 modelTimeoutMs: z.ZodDefault<z.ZodNumber>;
                 modelAttempts: z.ZodDefault<z.ZodNumber>;
                 visionConcurrency: z.ZodDefault<z.ZodNumber>;
+                maxModelCallsLimit: z.ZodDefault<z.ZodNumber>;
+                maxModelTokensLimit: z.ZodDefault<z.ZodNumber>;
+                uploadRetentionDays: z.ZodDefault<z.ZodNumber>;
                 maxModelCalls: z.ZodDefault<z.ZodNumber>;
                 maxModelTokens: z.ZodDefault<z.ZodNumber>;
+                imageTimeoutMs: z.ZodDefault<z.ZodNumber>;
                 visionMaxEdge: z.ZodDefault<z.ZodNumber>;
                 visionTileSize: z.ZodDefault<z.ZodNumber>;
                 visionMaxTiles: z.ZodDefault<z.ZodNumber>;
@@ -241,6 +251,13 @@ export declare const responseSchemas: {
                     chunkId: z.ZodString;
                 }, z.core.$strip>>;
             }, z.core.$strip>;
+            pendingCalls: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+            legacyUsageCount: z.ZodDefault<z.ZodNumber>;
+            legacyCallCount: z.ZodDefault<z.ZodNumber>;
+            reportSummary: z.ZodOptional<z.ZodObject<{
+                issues: z.ZodNumber;
+                blocking: z.ZodNumber;
+            }, z.core.$strip>>;
             failures: z.ZodArray<z.ZodObject<{
                 at: z.ZodString;
                 stage: z.ZodEnum<{
@@ -289,6 +306,9 @@ export declare const responseSchemas: {
             outputPath: z.ZodNullable<z.ZodString>;
             reused: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
+        jobTotal: z.ZodDefault<z.ZodNumber>;
+        jobOffset: z.ZodDefault<z.ZodNumber>;
+        activeJobs: z.ZodDefault<z.ZodNumber>;
         dataRoot: z.ZodString;
         config: z.ZodObject<{
             chunkTargetChars: z.ZodNumber;
@@ -491,8 +511,8 @@ export declare const responseSchemas: {
                 nodeId: z.ZodString;
                 keywords: z.ZodDefault<z.ZodArray<z.ZodString>>;
                 chunkId: z.ZodString;
-                summary: z.ZodDefault<z.ZodString>;
                 path: z.ZodString;
+                summary: z.ZodDefault<z.ZodString>;
                 headingPath: z.ZodArray<z.ZodString>;
                 oversizedReason: z.ZodOptional<z.ZodString>;
                 sourceFormat: z.ZodOptional<z.ZodEnum<{
@@ -656,31 +676,6 @@ export declare const responseSchemas: {
         pageEnd: z.ZodOptional<z.ZodNumber>;
         jobId: z.ZodString;
         revision: z.ZodOptional<z.ZodString>;
-        updatedAt: z.ZodOptional<z.ZodString>;
-        pdf: z.ZodOptional<z.ZodObject<{
-            pageCount: z.ZodNumber;
-            selectedPages: z.ZodObject<{
-                start: z.ZodNumber;
-                end: z.ZodNumber;
-                count: z.ZodNumber;
-                total: z.ZodNumber;
-                partial: z.ZodBoolean;
-            }, z.core.$strip>;
-            outlineCount: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        sourceFormat: z.ZodDefault<z.ZodEnum<{
-            docx: "docx";
-            pdf: "pdf";
-        }>>;
-        parserVersion: z.ZodOptional<z.ZodString>;
-        sourceHash: z.ZodOptional<z.ZodString>;
-        filename: z.ZodString;
-        usage: z.ZodObject<{
-            calls: z.ZodNumber;
-            tokens: z.ZodNumber;
-            reportedCalls: z.ZodNumber;
-            records: z.ZodArray<z.ZodJSONSchema>;
-        }, z.core.$strip>;
         report: z.ZodOptional<z.ZodObject<{
             revision: z.ZodString;
             sourceHash: z.ZodString;
@@ -755,6 +750,31 @@ export declare const responseSchemas: {
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        pdf: z.ZodOptional<z.ZodObject<{
+            pageCount: z.ZodNumber;
+            selectedPages: z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+                count: z.ZodNumber;
+                total: z.ZodNumber;
+                partial: z.ZodBoolean;
+            }, z.core.$strip>;
+            outlineCount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        sourceFormat: z.ZodDefault<z.ZodEnum<{
+            docx: "docx";
+            pdf: "pdf";
+        }>>;
+        parserVersion: z.ZodOptional<z.ZodString>;
+        sourceHash: z.ZodOptional<z.ZodString>;
+        filename: z.ZodString;
+        usage: z.ZodObject<{
+            calls: z.ZodNumber;
+            tokens: z.ZodNumber;
+            reportedCalls: z.ZodNumber;
+            records: z.ZodArray<z.ZodJSONSchema>;
+        }, z.core.$strip>;
         buildKey: z.ZodString;
         createdAt: z.ZodString;
         config: z.ZodObject<{
@@ -769,8 +789,12 @@ export declare const responseSchemas: {
             modelTimeoutMs: z.ZodDefault<z.ZodNumber>;
             modelAttempts: z.ZodDefault<z.ZodNumber>;
             visionConcurrency: z.ZodDefault<z.ZodNumber>;
+            maxModelCallsLimit: z.ZodDefault<z.ZodNumber>;
+            maxModelTokensLimit: z.ZodDefault<z.ZodNumber>;
+            uploadRetentionDays: z.ZodDefault<z.ZodNumber>;
             maxModelCalls: z.ZodDefault<z.ZodNumber>;
             maxModelTokens: z.ZodDefault<z.ZodNumber>;
+            imageTimeoutMs: z.ZodDefault<z.ZodNumber>;
             visionMaxEdge: z.ZodDefault<z.ZodNumber>;
             visionTileSize: z.ZodDefault<z.ZodNumber>;
             visionMaxTiles: z.ZodDefault<z.ZodNumber>;
@@ -837,6 +861,13 @@ export declare const responseSchemas: {
                 chunkId: z.ZodString;
             }, z.core.$strip>>;
         }, z.core.$strip>;
+        pendingCalls: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        legacyUsageCount: z.ZodDefault<z.ZodNumber>;
+        legacyCallCount: z.ZodDefault<z.ZodNumber>;
+        reportSummary: z.ZodOptional<z.ZodObject<{
+            issues: z.ZodNumber;
+            blocking: z.ZodNumber;
+        }, z.core.$strip>>;
         failures: z.ZodArray<z.ZodObject<{
             at: z.ZodString;
             stage: z.ZodEnum<{

package/lib/client-types/client/locales.d.ts

@@ -106,6 +106,8 @@ export declare const zh: {
     eventsHelp: string;
     failures: string;
     failuresHelp: string;
+    previousJobs: string;
+    nextJobs: string;
     usageRecords: string;
     usageRecordsHelp: string;
     reportSummary: string;

package/lib/client-types/client/useKnowledge.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
 /** One mutation at a time. A successful write followed by a failed refresh is never repeated. */
-export declare function useKnowledge(): {
+export declare function useKnowledge(kbId?: string): {
+    pageJobs: React.Dispatch<React.SetStateAction<number>>;
     state: {
         hostVersion: string;
         kbs: {
@@ -72,8 +73,12 @@ export declare function useKnowledge(): {
                 modelTimeoutMs: number;
                 modelAttempts: number;
                 visionConcurrency: number;
+                maxModelCallsLimit: number;
+                maxModelTokensLimit: number;
+                uploadRetentionDays: number;
                 maxModelCalls: number;
                 maxModelTokens: number;
+                imageTimeoutMs: number;
                 visionMaxEdge: number;
                 visionTileSize: number;
                 visionMaxTiles: number;
@@ -126,6 +131,9 @@ export declare function useKnowledge(): {
                     chunkId: string;
                 } | undefined;
             };
+            pendingCalls: number[];
+            legacyUsageCount: number;
+            legacyCallCount: number;
             failures: {
                 at: string;
                 stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
@@ -136,20 +144,6 @@ export declare function useKnowledge(): {
             pageStart?: number | undefined;
             pageEnd?: number | undefined;
             revision?: string | undefined;
-            updatedAt?: string | undefined;
-            pdf?: {
-                pageCount: number;
-                selectedPages: {
-                    start: number;
-                    end: number;
-                    count: number;
-                    total: number;
-                    partial: boolean;
-                };
-                outlineCount?: number | undefined;
-            } | undefined;
-            parserVersion?: string | undefined;
-            sourceHash?: string | undefined;
             report?: {
                 revision: string;
                 sourceHash: string;
@@ -219,6 +213,24 @@ export declare function useKnowledge(): {
                     }[];
                 } | undefined;
             } | undefined;
+            updatedAt?: string | undefined;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount?: number | undefined;
+            } | undefined;
+            parserVersion?: string | undefined;
+            sourceHash?: string | undefined;
+            reportSummary?: {
+                issues: number;
+                blocking: number;
+            } | undefined;
             events?: {
                 at: string;
                 state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
@@ -233,6 +245,9 @@ export declare function useKnowledge(): {
             cancelRequested?: boolean | undefined;
             reused?: boolean | undefined;
         }[];
+        jobTotal: number;
+        jobOffset: number;
+        activeJobs: number;
         dataRoot: string;
         config: {
             chunkTargetChars: number;

package/lib/client-types/contract.d.ts

@@ -10,31 +10,6 @@ export declare const publicJobSchema: z.ZodObject<{
     pageEnd: z.ZodOptional<z.ZodNumber>;
     jobId: z.ZodString;
     revision: z.ZodOptional<z.ZodString>;
-    updatedAt: z.ZodOptional<z.ZodString>;
-    pdf: z.ZodOptional<z.ZodObject<{
-        pageCount: z.ZodNumber;
-        selectedPages: z.ZodObject<{
-            start: z.ZodNumber;
-            end: z.ZodNumber;
-            count: z.ZodNumber;
-            total: z.ZodNumber;
-            partial: z.ZodBoolean;
-        }, z.core.$strip>;
-        outlineCount: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    sourceFormat: z.ZodDefault<z.ZodEnum<{
-        docx: "docx";
-        pdf: "pdf";
-    }>>;
-    parserVersion: z.ZodOptional<z.ZodString>;
-    sourceHash: z.ZodOptional<z.ZodString>;
-    filename: z.ZodString;
-    usage: z.ZodObject<{
-        calls: z.ZodNumber;
-        tokens: z.ZodNumber;
-        reportedCalls: z.ZodNumber;
-        records: z.ZodArray<z.ZodJSONSchema>;
-    }, z.core.$strip>;
     report: z.ZodOptional<z.ZodObject<{
         revision: z.ZodString;
         sourceHash: z.ZodString;
@@ -109,6 +84,31 @@ export declare const publicJobSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    pdf: z.ZodOptional<z.ZodObject<{
+        pageCount: z.ZodNumber;
+        selectedPages: z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            count: z.ZodNumber;
+            total: z.ZodNumber;
+            partial: z.ZodBoolean;
+        }, z.core.$strip>;
+        outlineCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    sourceFormat: z.ZodDefault<z.ZodEnum<{
+        docx: "docx";
+        pdf: "pdf";
+    }>>;
+    parserVersion: z.ZodOptional<z.ZodString>;
+    sourceHash: z.ZodOptional<z.ZodString>;
+    filename: z.ZodString;
+    usage: z.ZodObject<{
+        calls: z.ZodNumber;
+        tokens: z.ZodNumber;
+        reportedCalls: z.ZodNumber;
+        records: z.ZodArray<z.ZodJSONSchema>;
+    }, z.core.$strip>;
     buildKey: z.ZodString;
     createdAt: z.ZodString;
     config: z.ZodObject<{
@@ -123,8 +123,12 @@ export declare const publicJobSchema: z.ZodObject<{
         modelTimeoutMs: z.ZodDefault<z.ZodNumber>;
         modelAttempts: z.ZodDefault<z.ZodNumber>;
         visionConcurrency: z.ZodDefault<z.ZodNumber>;
+        maxModelCallsLimit: z.ZodDefault<z.ZodNumber>;
+        maxModelTokensLimit: z.ZodDefault<z.ZodNumber>;
+        uploadRetentionDays: z.ZodDefault<z.ZodNumber>;
         maxModelCalls: z.ZodDefault<z.ZodNumber>;
         maxModelTokens: z.ZodDefault<z.ZodNumber>;
+        imageTimeoutMs: z.ZodDefault<z.ZodNumber>;
         visionMaxEdge: z.ZodDefault<z.ZodNumber>;
         visionTileSize: z.ZodDefault<z.ZodNumber>;
         visionMaxTiles: z.ZodDefault<z.ZodNumber>;
@@ -191,6 +195,13 @@ export declare const publicJobSchema: z.ZodObject<{
             chunkId: z.ZodString;
         }, z.core.$strip>>;
     }, z.core.$strip>;
+    pendingCalls: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    legacyUsageCount: z.ZodDefault<z.ZodNumber>;
+    legacyCallCount: z.ZodDefault<z.ZodNumber>;
+    reportSummary: z.ZodOptional<z.ZodObject<{
+        issues: z.ZodNumber;
+        blocking: z.ZodNumber;
+    }, z.core.$strip>>;
     failures: z.ZodArray<z.ZodObject<{
         at: z.ZodString;
         stage: z.ZodEnum<{
@@ -328,31 +339,6 @@ export declare const stateSchema: z.ZodObject<{
         pageEnd: z.ZodOptional<z.ZodNumber>;
         jobId: z.ZodString;
         revision: z.ZodOptional<z.ZodString>;
-        updatedAt: z.ZodOptional<z.ZodString>;
-        pdf: z.ZodOptional<z.ZodObject<{
-            pageCount: z.ZodNumber;
-            selectedPages: z.ZodObject<{
-                start: z.ZodNumber;
-                end: z.ZodNumber;
-                count: z.ZodNumber;
-                total: z.ZodNumber;
-                partial: z.ZodBoolean;
-            }, z.core.$strip>;
-            outlineCount: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        sourceFormat: z.ZodDefault<z.ZodEnum<{
-            docx: "docx";
-            pdf: "pdf";
-        }>>;
-        parserVersion: z.ZodOptional<z.ZodString>;
-        sourceHash: z.ZodOptional<z.ZodString>;
-        filename: z.ZodString;
-        usage: z.ZodObject<{
-            calls: z.ZodNumber;
-            tokens: z.ZodNumber;
-            reportedCalls: z.ZodNumber;
-            records: z.ZodArray<z.ZodJSONSchema>;
-        }, z.core.$strip>;
         report: z.ZodOptional<z.ZodObject<{
             revision: z.ZodString;
             sourceHash: z.ZodString;
@@ -427,6 +413,31 @@ export declare const stateSchema: z.ZodObject<{
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        pdf: z.ZodOptional<z.ZodObject<{
+            pageCount: z.ZodNumber;
+            selectedPages: z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+                count: z.ZodNumber;
+                total: z.ZodNumber;
+                partial: z.ZodBoolean;
+            }, z.core.$strip>;
+            outlineCount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        sourceFormat: z.ZodDefault<z.ZodEnum<{
+            docx: "docx";
+            pdf: "pdf";
+        }>>;
+        parserVersion: z.ZodOptional<z.ZodString>;
+        sourceHash: z.ZodOptional<z.ZodString>;
+        filename: z.ZodString;
+        usage: z.ZodObject<{
+            calls: z.ZodNumber;
+            tokens: z.ZodNumber;
+            reportedCalls: z.ZodNumber;
+            records: z.ZodArray<z.ZodJSONSchema>;
+        }, z.core.$strip>;
         buildKey: z.ZodString;
         createdAt: z.ZodString;
         config: z.ZodObject<{
@@ -441,8 +452,12 @@ export declare const stateSchema: z.ZodObject<{
             modelTimeoutMs: z.ZodDefault<z.ZodNumber>;
             modelAttempts: z.ZodDefault<z.ZodNumber>;
             visionConcurrency: z.ZodDefault<z.ZodNumber>;
+            maxModelCallsLimit: z.ZodDefault<z.ZodNumber>;
+            maxModelTokensLimit: z.ZodDefault<z.ZodNumber>;
+            uploadRetentionDays: z.ZodDefault<z.ZodNumber>;
             maxModelCalls: z.ZodDefault<z.ZodNumber>;
             maxModelTokens: z.ZodDefault<z.ZodNumber>;
+            imageTimeoutMs: z.ZodDefault<z.ZodNumber>;
             visionMaxEdge: z.ZodDefault<z.ZodNumber>;
             visionTileSize: z.ZodDefault<z.ZodNumber>;
             visionMaxTiles: z.ZodDefault<z.ZodNumber>;
@@ -509,6 +524,13 @@ export declare const stateSchema: z.ZodObject<{
                 chunkId: z.ZodString;
             }, z.core.$strip>>;
         }, z.core.$strip>;
+        pendingCalls: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        legacyUsageCount: z.ZodDefault<z.ZodNumber>;
+        legacyCallCount: z.ZodDefault<z.ZodNumber>;
+        reportSummary: z.ZodOptional<z.ZodObject<{
+            issues: z.ZodNumber;
+            blocking: z.ZodNumber;
+        }, z.core.$strip>>;
         failures: z.ZodArray<z.ZodObject<{
             at: z.ZodString;
             stage: z.ZodEnum<{
@@ -557,6 +579,9 @@ export declare const stateSchema: z.ZodObject<{
         outputPath: z.ZodNullable<z.ZodString>;
         reused: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    jobTotal: z.ZodDefault<z.ZodNumber>;
+    jobOffset: z.ZodDefault<z.ZodNumber>;
+    activeJobs: z.ZodDefault<z.ZodNumber>;
     dataRoot: z.ZodString;
     config: z.ZodObject<{
         chunkTargetChars: z.ZodNumber;
@@ -675,8 +700,8 @@ export declare const treeDocumentSchema: z.ZodObject<{
         nodeId: z.ZodString;
         keywords: z.ZodDefault<z.ZodArray<z.ZodString>>;
         chunkId: z.ZodString;
-        summary: z.ZodDefault<z.ZodString>;
         path: z.ZodString;
+        summary: z.ZodDefault<z.ZodString>;
         headingPath: z.ZodArray<z.ZodString>;
         oversizedReason: z.ZodOptional<z.ZodString>;
         sourceFormat: z.ZodOptional<z.ZodEnum<{
@@ -978,8 +1003,8 @@ export declare const treeSchema: z.ZodObject<{
             nodeId: z.ZodString;
             keywords: z.ZodDefault<z.ZodArray<z.ZodString>>;
             chunkId: z.ZodString;
-            summary: z.ZodDefault<z.ZodString>;
             path: z.ZodString;
+            summary: z.ZodDefault<z.ZodString>;
             headingPath: z.ZodArray<z.ZodString>;
             oversizedReason: z.ZodOptional<z.ZodString>;
             sourceFormat: z.ZodOptional<z.ZodEnum<{
@@ -1195,3 +1220,9 @@ export declare const uploadResultSchema: z.ZodObject<{
     filename: z.ZodString;
     bytes: z.ZodNumber;
 }, z.core.$strip>;
+export declare const jobUsagePageSchema: z.ZodObject<{
+    records: z.ZodArray<z.ZodJSONSchema>;
+    offset: z.ZodNumber;
+    total: z.ZodNumber;
+    next: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;

package/lib/client-types/data.d.ts

@@ -1528,8 +1528,12 @@ export declare const jobSchema: z.ZodObject<{
         modelTimeoutMs: z.ZodDefault<z.ZodNumber>;
         modelAttempts: z.ZodDefault<z.ZodNumber>;
         visionConcurrency: z.ZodDefault<z.ZodNumber>;
+        maxModelCallsLimit: z.ZodDefault<z.ZodNumber>;
+        maxModelTokensLimit: z.ZodDefault<z.ZodNumber>;
+        uploadRetentionDays: z.ZodDefault<z.ZodNumber>;
         maxModelCalls: z.ZodDefault<z.ZodNumber>;
         maxModelTokens: z.ZodDefault<z.ZodNumber>;
+        imageTimeoutMs: z.ZodDefault<z.ZodNumber>;
         visionMaxEdge: z.ZodDefault<z.ZodNumber>;
         visionTileSize: z.ZodDefault<z.ZodNumber>;
         visionMaxTiles: z.ZodDefault<z.ZodNumber>;
@@ -1599,6 +1603,13 @@ export declare const jobSchema: z.ZodObject<{
             chunkId: z.ZodString;
         }, z.core.$strip>>;
     }, z.core.$strip>;
+    pendingCalls: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    legacyUsageCount: z.ZodDefault<z.ZodNumber>;
+    legacyCallCount: z.ZodDefault<z.ZodNumber>;
+    reportSummary: z.ZodOptional<z.ZodObject<{
+        issues: z.ZodNumber;
+        blocking: z.ZodNumber;
+    }, z.core.$strip>>;
     usage: z.ZodObject<{
         calls: z.ZodNumber;
         tokens: z.ZodNumber;